Skip to main content
GET
Live goal state of one Mnemom Agent session

Authorizations

Authorization
string
header
required

Supabase JWT token in Authorization: Bearer header

Path Parameters

conversationId
string
required

The conversation id the CLI launched the session with.

Query Parameters

agent_id
string
required

The agent record id (agents.id) the session ran as.

org_id
string

Target organization (defaults to the caller's primary org).

Response

The session's live goal state. Every gateway-owned section is nullable — a session that never sealed a goal contract returns sealed: null, verdict: null, turn: null, guardrails: null.

conversation_id
string
required
agent
object
required
org_id
string
required
sealed
object | null
required

What the gateway sealed for this conversation.

verdict
object | null
required

The latest goal-alignment verdict.

turn
integer | null
required

Turns the gateway has counted for this conversation.

guardrails
object | null
required
seal
object
required

The seal's lifecycle. live: a sealed contract currently governs. expired: the prior seal lapsed (24h idle) and the next engaged request will seal afresh. null normally means no seal has ever been made for this conversation, but the API also returns null if the gateway sent a seal payload out of contract (an unknown state, or a required subfield missing/mistyped) — a malformed seal is dropped rather than relayed half-trusted, since mode (nudge vs enforce) is conformance-relevant. The two cases are distinguished in the API's own logs (component: "agent-session", event: "seal_dropped"), not in this field.

verdict_trail
object[]
required

The last 50 verdicts, oldest first; empty when none judged yet. Under enforce, a request refused at a ceiling (429, not counted as a turn) is on the trail too, as a refused entry whose turn is the turn it would have been.

unjudged_turns
integer | null
required

Assistant turns under the current seal with no verdict (a cut-off/aborted response, a judge that failed or never ran, a non-streamed final turn). null when no judge ledger counts under the current seal.

memoised_turns
integer | null
required

Turns the judge memo graded without re-running the judge — inherited from a prior turn judged aligned under the same contract version with a matching tool-call shape and text. null alongside unjudged_turns.