AlmondTill/G3N API

On this page

transitionConsultation

mutation · in the family Consultation

What it does

Archive a conversation (kept, read-only), reopen an archived one, or discard it (drop it from the lists).

One caller edge of the consultation FSM (archive · reopen · discard — the CsCase single-op class; the ruling). archive PARKS the record read-only (the consulted history stays listable; drafted plans remain takeable; the scheduler archives an idle conversation itself after 30 idle days, the reason on its history); reopen brings an archived conversation back to open (gated by the ≤10-open cap like a birth — the refusal names the cap and the cure); discard dooms it from open OR archived (lists drop; purge still owns deletion). The retired word close is refused typed. THE TURN TIER: 90 days after archiving the transcript moves to the archive bucket — consultationTurns reads it whole across the tier, a take then needs a reopen first, and reopen brings the rows back.

What happens

Archived conversations keep their transcript and summary, and drafted plans in them can still be taken; an open conversation idle for 30 days archives itself. After 90 days archived the transcript moves to cold storage: it still reads in full, taking a drafted plan then needs a reopen first, and reopen brings the rows back. Reopen counts against your 10 open conversations.

Careful

Discard is an endpoint — the record leaves the lists (it is only truly deleted by a purge).

Who may call it

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

Arguments

NameTypeRequiredNotes
idID ID!yesThe id of the record.
revisionID ID!yesThe revision id you read on the record; the change is refused if an edit landed in the meantime.
opConsultationTransitionOp ConsultationTransitionOp!yesNo further notes.
reasonStringnoNo further notes.

Returns

Consultation Consultation! — A Consultation: the VERBATIM TRANSCRIPT is the record (bounded turn rows — read via consultationTurns) and the MEMORY is the STORED rolling summary ON this record — auditable, purgeable, merchant-visible, never hidden model state. Each ask composes the summary + the last 12 turns verbatim + the asked materials' STORED extractions (EXTRACT-THEN-COMPOSE — raw content is read exactly once, at material confirm). Aldric may attach a DRAFTED PLAN to a reply; TAKING a drafted plan (takeConsultationPlan) mints a Scratchpad through the live spine (origin consultation) and the walk proceeds under the TAKER's own capability (the hardened-Aldric law — the chat holds ZERO mutation authority). Outgrowing the 200-turn transcript refuses HONESTLY naming the cure: a follow-on consultation linked via followOnOfId (never silent middle-loss). USER-parented (the consulter owns the chat), group-rooted. The ops event domain (at.ops.consultation.*).

Example request

mutation ExampleTransitionConsultation($id: ID!, $revision: ID!, $op: ConsultationTransitionOp!, $reason: String) {
  transitionConsultation(id: $id, revision: $revision, op: $op, reason: $reason) {
    id
    sysId
    type
    caption
    status
    parentId
    rootId
    createdAt
    updatedAt
    revisionNum
    revision
    turnCount
    summary
    summarizedThroughSeq
    followOnOfId
    idleArchiveAt
    turnsTierAt
    turnsTier
  }
}

Variables:

{
  "id": "01900000-0000-7000-8000-37386ae00000",
  "revision": "01900000-0000-7000-8000-b7960e180000",
  "op": "archive",
  "reason": "Correcting a miscount."
}

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

Example response

{
  "data": {
    "transitionConsultation": {
      "id": "01900000-0000-7000-8000-37386ae00000",
      "sysId": "CI-EXMP-0000-000F",
      "type": "Consultation",
      "caption": "Blue jeans",
      "status": "open",
      "parentId": "01900000-0000-7000-8000-065235280000",
      "rootId": "01900000-0000-7000-8000-a093dd800000",
      "createdAt": "2027-01-31T00:00:00.000Z",
      "updatedAt": "2027-01-31T00:00:00.000Z",
      "revisionNum": 1,
      "revision": "01900000-0000-7000-8000-b7960e180000",
      "turnCount": 1,
      "summary": "<summary>",
      "summarizedThroughSeq": 1,
      "followOnOfId": "01900000-0000-7000-8000-7d2662410000",
      "idleArchiveAt": "2027-01-31T00:00:00.000Z",
      "turnsTierAt": "2027-01-31T00:00:00.000Z",
      "turnsTier": "<turns tier>"
    }
  },
  "extensions": {
    "at": {
      "callId": "01EXAMPLE-CALL-ID",
      "version": {
        "requested": {
          "name": "genesis",
          "number": 0
        },
        "serviced": {
          "name": "genesis",
          "number": 0
        }
      }
    }
  }
}

Errors this call can answer