AlmondTill/G3N API

On this page

talkFillDraft

mutation · in the family Work and notes

What it does

Tell the assistant what to change on one of your ready wizard drafts — it answers in plain words and hands back the whole revised sheet, in the background.

Tell the assistant what to change on ONE of YOUR READY wizard drafts: your message (say) and optionally more of your documents go in; your turn is appended and the draft flips back to drafting while the assistant answers in the background — briefly, in plain words — and hands back the WHOLE revised sheet (every value you did not ask about kept; a value you rejected removed); the draft flips ready again and the fill_draft_finished notice tells you. When the conversation outgrows 12 un-summarized turns the older turns FOLD into the stored summary first. The assistant cannot look anything up — it asks you for facts it lacks. THE ORDER OF THE GATES: the draft must be yours and ready (CONFLICT/REF_STATE naming another state; an expired draft refuses too) with its current revision (CONFLICT/REVISION_STALE) · at most 24 turns per draft and 30 messages an hour (VALIDATION/INVALID) · the assistant offline or the machine unwired refuses INTEGRATION/UNAVAILABLE loudly · ONE draft is worked on at a time per person (CONFLICT/FILL_DRAFT_ACTIVE naming the holder) · a document that is not yours or not on this wizard word is NOT_FOUND. A failed answer is TOLD on the transcript (outcome failed) and the sheet stays as it was. DRAFTS ONLY — nothing is created or applied. A JSON null on an optional input field reads as absent. Requires the unrestricted capability on a USER session. Template class (universal staff work).

What happens

It runs as you on your own draft only: the draft must be ready, at most 30 messages an hour, at most 12 exchanges per draft, and one draft at a time per person. Documents must be ones you shared for the same wizard. The assistant cannot look anything up — it asks you for facts it lacks. Nothing is created — the revised sheet is still a draft you review; the calls are charged to your group’s wallet like every assist.

Who may call it

Capability area: Work and notes — Tasks, notes, messages, dashboards and the everyday tools every staff member keeps.

Arguments

NameTypeRequiredNotes
inputTalkFillDraftInput TalkFillDraftInput!yesNo further notes.

Returns

TalkFillDraftResult TalkFillDraftResult! — The talkFillDraft answer — the draft (now drafting; activeTurnId names your turn) + your turn as appended. The assistant's turn lands in the background — poll the draft or read fillDraftTurns when it is ready again.

Example request

mutation ExampleTalkFillDraft($input: TalkFillDraftInput!) {
  talkFillDraft(input: $input) {
    draft {
      id
      sysId
      type
      caption
      status
      parentId
      rootId
      revision
      revisionNum
      createdAt
      updatedAt
      wizardType
      brief
      materialIds
      filled
      questions
      advice
      understood
      turnCount
      summary
      summarizedThroughSeq
      activeTurnId
      activeTurnStartedAt
      failReason
      sfExecutionArn
      startRequestId
      startedAt
      readyAt
      takenAt
      takenRef
      expiresAt
    }
  }
}

Variables:

{
  "input": {
    "id": "01900000-0000-7000-8000-37386ae00000",
    "revision": "01900000-0000-7000-8000-b7960e180000",
    "say": "<say>",
    "materialIds": [
      "01900000-0000-7000-8000-a36392ca0000"
    ]
  }
}

Send it with the envelope naming the version: "extensions": {"at": {"version": {"name":"genesis","number":0}}}.

Example response

{
  "data": {
    "talkFillDraft": {
      "draft": {
        "id": "01900000-0000-7000-8000-37386ae00000",
        "sysId": "FL-EXMP-0000-000F",
        "type": "FillDraft",
        "caption": "Blue jeans",
        "status": "drafting",
        "parentId": "01900000-0000-7000-8000-065235280000",
        "rootId": "01900000-0000-7000-8000-a093dd800000",
        "revision": "01900000-0000-7000-8000-b7960e180000",
        "revisionNum": 1,
        "createdAt": "2027-01-31T00:00:00.000Z",
        "updatedAt": "2027-01-31T00:00:00.000Z",
        "wizardType": "<wizard type>",
        "brief": "<brief>",
        "materialIds": [
          "01900000-0000-7000-8000-a36392ca0000"
        ],
        "filled": "<filled>",
        "questions": [
          "<questions>"
        ],
        "advice": "<advice>",
        "understood": "<understood>",
        "turnCount": 1,
        "summary": "<summary>",
        "summarizedThroughSeq": 1,
        "activeTurnId": "01900000-0000-7000-8000-770cb7810000",
        "activeTurnStartedAt": "2027-01-31T00:00:00.000Z",
        "failReason": "<fail reason>",
        "sfExecutionArn": "<sf execution arn>",
        "startRequestId": "01900000-0000-7000-8000-c154ec1d0000",
        "startedAt": "2027-01-31T00:00:00.000Z",
        "readyAt": "2027-01-31T00:00:00.000Z",
        "takenAt": "2027-01-31T00:00:00.000Z",
        "takenRef": "<taken ref>",
        "expiresAt": 1
      }
    }
  },
  "extensions": {
    "at": {
      "callId": "01EXAMPLE-CALL-ID",
      "version": {
        "requested": {
          "name": "genesis",
          "number": 0
        },
        "serviced": {
          "name": "genesis",
          "number": 0
        }
      }
    }
  }
}

Errors this call can answer