@athenaintel/react 0.39.0 → 0.40.1

package/README.md

@@ -561,7 +561,25 @@ the loaded unread rows; **Dismiss** uses
 session — a dismissed session comes back with its next message).
 `InboxButton` is a bell with the unread count (`useAthenaInboxUnreadCount`,
 the Unread tab's first page: `50+` past one page) that opens the inbox in a
-popover.
+popover. Each tab shows its count once its list has answered, and nothing
+before.
+
+### What counts as read
+
+`AthenaChat` marks the session it shows read for the viewer, as Athena's own
+chat does, wherever the session was opened from (`SessionList`, the inbox, a
+`?session_id=` link): once the chat is in front of the person (its window,
+a pop-out's included, visible and focused, and the chat itself on screen, not
+hidden behind a maximized workbench), the session's history is on screen, no
+run is going and its row is unread, for a second.
+The write is the provider's `setReadState` with the row's `updatedAt`, so
+every list under the provider flips at once and the next message shows the
+session unread again. A message that arrives while the person watches is
+marked too (a running session is marked when its run ends, never per
+streamed chunk); a read session is never written; and a session the person
+marks unread from a list stays unread until something new arrives or they
+open it again. A host that draws its own transcript instead of `AthenaChat`
+calls `setReadState` itself.
 
 ### Server filters and older servers
 
@@ -789,6 +807,24 @@ Both use the same bearer / API key as session creation. The full recipe
 template skill `voice-session-guide.md`. `createAthenaVoiceSession` is also
 exported if you hold the bridge state yourself.
 
+## What's new in 0.40.1
+
+**The session you are looking at is marked read.** In `enableThreadList` mode, `AthenaChat` now writes the viewer's read receipt for the session it shows, as Athena's own chat does: once the chat is in front of the person (its window, a pop-out's included, visible and focused, and the chat itself on screen, not hidden behind a maximized workbench), the session's history is on screen, no run is going and its row is unread, for a second. A session opened from `SessionList`, the inbox or a `?session_id=` link used to stay unread for good (only the inbox's own open, its Mark all read and the sessions page toggle wrote the receipt), so unread dots and the inbox's Unread count only grew. The write is the provider's `setReadState` (`POST /api/conversations/threads/read-state`, the route the inbox already used) with the row's `updatedAt`, so every list flips at once and the next message shows the session unread again. A message that arrives while the person watches is marked too, with at most one write per message; nothing polls, a read session is never written, and a session the person marks unread stays unread until something new arrives or they open it again. See [What counts as read](#what-counts-as-read).
+
+**The inbox shows a tab's count once it has one.** The All and Unread tabs counted their rows before their first page answered ("All 0 · Unread 14" for a moment). A tab now shows no count until its list has answered.
+
+**A running tool is never called stalled.** While the agent runs a long command, a build or a test suite (or a tool such as Python execution that shows only its streaming placeholder while it works), the turn header no longer adds "Nothing new for 1m 00s" in amber, and the line under an ungrouped turn keeps the tool's verb with a neutral counter ("Running a command… · 1m 04s") instead of "Still working — nothing new". The stall tone stays for a quiet stream that waits on the model.
+
+Nothing to change in your app.
+
+## What's new in 0.40.0
+
+**`AthenaChat` shows an agent's UI test recording.** When an agent with the UI Testing toolkit checks a change in its computer's browser, `test_recording_stop` now renders a report card: the recording's title, "N passed · M failed" (with "· K untested" when a test was never checked), each test with its ✓ / ✗ assertions and what the agent saw (a failed assertion is tinted red, a test with no assertion reads "Not checked"), the summary, and the edited video. Every test's start time is a chapter: click it and the video plays from there (an assertion's time works the same way). A **Watch in Athena** link opens the asset in Athena. The card stays in the conversation instead of folding into the turn's collapsed steps. `test_recording_start` and `test_recording_mark` each render one compact row ("Recording started", "Test", "Pass", "Fail", "Note" with the time in the recording), and their collapsed steps read "Started recording "…"", "Started test: It should …", "Passed: …", "Failed: …".
+
+**The video plays with the signed-in user's own credential.** It is read only when the person presses play or picks a chapter, from `GET /api/asset/content/{asset_id}` with the provider's `Authorization` / `X-API-KEY` header. Agora checks the asset's permission on that read, and the bytes play from an object URL that only this page holds. No presigned storage URL or embed link is minted, so there is no link that works without the credential. Each card reads its own copy and drops it when it unmounts, so a card mounted later (perhaps for another account behind your `getToken`) reads through the permission check again instead of reusing bytes. A failed read says why ("You don't have access to this recording", "The recording could not be loaded") and offers **Try again** and the Athena link. Outside an `AthenaProvider` the card shows the report and the link, without a player. The same read is exported for your own UI: `useAthenaAssetContent({ assetId, enabled })` (TanStack Query, a `Blob`, one copy per mounted hook), `fetchAthenaAssetContent`, and `useObjectUrl(blob)`. A failed read is an `AthenaSdkError` with the new code `asset_content_failed` (a network failure, a credential that cannot be resolved, a download cut off, a 404), or `auth_rejected` for a 401 / 403.
+
+New exports: `TestRecordingStopToolUI`, `TestRecordingStartToolUI`, `TestRecordingMarkToolUI`, `TestRecordingReportCard`, `parseTestRecordingStopResult` and the result types, and `isSdkInlineTool` (the default `isInlineTool` of `SuperGroupingTranscript` and `SuperGroupingCard`: the shared registry's inline tools plus `test_recording_stop`). Nothing to change in your app; override any of the three with `toolUIs` as before.
+
 ## What's new in 0.38.1
 
 **`AthenaChat`'s composer stays put while the transcript scrolls.** The composer is a sticky footer inside the transcript's scroll viewport, so whatever moved the viewport's content moved the composer with it. The viewport is now `overflow-x-hidden` (was `overflow-x-auto`): anything wider than the message column made the whole transcript, composer included, scroll sideways under a trackpad. Wide tables and code blocks scroll inside their own boxes, as before. It is also `overscroll-y-none`: a fling that reaches the top or bottom no longer chains into the page or starts the macOS elastic bounce, either of which carried the composer off its place before it settled. Olympus's own chat thread has the same two guards. Nothing to change in your app.
@@ -1926,11 +1962,11 @@ Your own portals can read the same context: `usePortalContainer()` returns the p
 
 - **The agent's sentences stay visible.** Every text part the agent writes before its last tool call ("I'll find your workstation, then check origin/staging.", "Started. Now I'll compare.") renders in the transcript, in order, as it streams. Only the work between two sentences folds: each run of tool calls and reasoning becomes one collapsed step row. The answer (the text after the last tool call) renders below, as before; no text renders twice.
 - **Each step says what it did.** A collapsed row names the step in progress, else the last one it took — "Ran `git log -1 origin/staging`", "Read `live_audio.py`", "Edited `upstream.py`" with "+4 −1", "Found 3 assets for "workstation"", "jevin-box is running", "Viewed pull request #43093", "Updated plan (3/7 done)" — with "+2 more" when the row folds several. Opening it lists every step, and "Show tool details" reveals that row's tool UIs.
-- **The header counts the turn.** "Working for 1m 12s" while it runs, "Worked for 2m 30s · Used 7 tools" once done (from the messages' own server stamps), "Waiting for you" on an approval. After thirty seconds without a streamed change the header adds "Nothing new for 42s" in amber.
+- **The header counts the turn.** "Working for 1m 12s" while it runs, "Worked for 2m 30s · Used 7 tools" once done (from the messages' own server stamps), "Waiting for you" on an approval. After thirty seconds in which the model has streamed nothing the header adds "Nothing new for 42s" in amber — but never while a tool call is still running: a command, a build or a test run streams nothing for minutes while it works, so its step row says it is running and the header goes on counting the turn. With `groupToolCalls={false}` the line under the turn keeps the running tool's verb and a neutral counter ("Running a command… · 1m 04s") the same way.
 
 The transcript is `SuperGroupingTranscript` from `@athenaintel/react/super-grouping`; it takes the same renderer and host slots as `SuperGroupingCard` (which keeps the single-card layout for hosts that mount it). `splitTurnSegments`, `readTurnTiming` and `formatWorkDuration` are exported for hosts that lay a turn out themselves.
 
-Every step row and every thread tool card reads one summary registry, `summarizeToolCall({ toolName, args, result, status })` → `{ label, detail?, meta?, code? }` (also on `@athenaintel/react/tools`). It has rules for the deep agent's core tools (`execute`, the workspace file tools, `search_assets`, the computer and GitHub tools, web search and browse, `read_asset`, `write_todos`, `task`); other tools read the shared display registry, and a tool neither knows falls back to a host catalog name (`resolveToolDisplayName`), else its sentence-cased name. A call that targets a machine or document by id (`sandbox_asset_id`, `computer_asset_id`) is named by its title when an earlier result in the turn carried one (`collectAssetTitles`); nothing is fetched.
+Every step row and every thread tool card reads one summary registry, `summarizeToolCall({ toolName, args, result, status })` → `{ label, detail?, meta?, code? }` (also on `@athenaintel/react/tools`). It has rules for the deep agent's core tools (`execute`, the workspace file tools, `search_assets`, the computer and GitHub tools, web search and browse, `read_asset`, `write_todos`, `task`, and the UI Testing toolkit's `test_recording_start` / `_mark` / `_stop`); other tools read the shared display registry, and a tool neither knows falls back to a host catalog name (`resolveToolDisplayName`), else its sentence-cased name. A call that targets a machine or document by id (`sandbox_asset_id`, `computer_asset_id`) is named by its title when an earlier result in the turn carried one (`collectAssetTitles`); nothing is fetched.
 
 Every tool call it renders — the generic `ToolFallback`, the built-in tool UIs, nested sub-calls — shares one row anatomy: a status glyph (spinner / check / x / alert), the verb and its target on one line, a running call's elapsed seconds after three, a failed call tinted red, and a disclosure for the arguments and result.
 

package/dist/agent-runtime/src/errors.cjs

@@ -49,6 +49,11 @@ function readRetryableCommandRejection(error) {
   const payload = statewireRejectionPayload(error);
   return payload === null ? null : readRetryableDetail(payload.detail);
 }
+const CONVERSATION_ARCHIVED = "conversation_archived";
+const CONVERSATION_ARCHIVED_MESSAGE = "This conversation is archived. Restore it to continue.";
+function isConversationArchivedRejection(error) {
+  return statewireRejectionCode(error) === CONVERSATION_ARCHIVED;
+}
 function isLegacyThreadReadOnlyRejection(error) {
   const payload = statewireRejectionPayload(error);
   if ((payload == null ? void 0 : payload.status) !== 409) return false;
@@ -122,6 +127,9 @@ function unknownConnectionStatus(connection) {
   );
 }
 exports.COLLAB_AGENT_CHANNEL_SESSION_MISMATCH = COLLAB_AGENT_CHANNEL_SESSION_MISMATCH;
+exports.CONVERSATION_ARCHIVED = CONVERSATION_ARCHIVED;
+exports.CONVERSATION_ARCHIVED_MESSAGE = CONVERSATION_ARCHIVED_MESSAGE;
+exports.isConversationArchivedRejection = isConversationArchivedRejection;
 exports.isLegacyThreadReadOnlyRejection = isLegacyThreadReadOnlyRejection;
 exports.isStatewireChannelTeardown = isStatewireChannelTeardown;
 exports.isStatewireExpiredVerdict = isStatewireExpiredVerdict;

package/dist/agent-runtime/src/errors.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.cjs","sources":["../../../../agent-runtime/src/errors.ts"],"sourcesContent":["import type { StatewireClient } from 'statewire';\nimport type { DeepAgentConnectionState } from './types';\n\n/** Structured payload attached to a server-rejected Statewire command. */\nexport interface StatewireRejectionPayload {\n  status: number;\n  detail: unknown;\n}\n\n/** Return a rejected command's structured `{ status, detail }` payload. */\nexport function statewireRejectionPayload(error: unknown): StatewireRejectionPayload | null {\n  const failure = (error as { failure?: { fate?: unknown; payload?: unknown } } | null)?.failure;\n  if (failure?.fate !== 'rejected') return null;\n\n  const payload = failure.payload as { status?: unknown; detail?: unknown } | undefined;\n  if (typeof payload?.status !== 'number') return null;\n  return { status: payload.status, detail: payload.detail };\n}\n\n/**\n * The server's human-readable reason for a rejected command — `detail.message`\n * (or a plain-string `detail`) — else `null`. Hosts surface it as send\n * feedback so the user sees the actionable cause instead of the generic\n * client-side `command rejected (<status>)`.\n */\nexport function statewireRejectionDetailMessage(error: unknown): string | null {\n  const detail = statewireRejectionPayload(error)?.detail;\n  if (typeof detail === 'string') return detail.length > 0 ? detail : null;\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const message = (detail as { message?: unknown }).message;\n  return typeof message === 'string' && message.length > 0 ? message : null;\n}\n\n/**\n * A structured, retryable refusal the host recorded as the run error\n * (`runs.error`): the dispatch never started — the pod or instance was\n * closing (`pod_draining`) — and the entries stayed in their lanes for the\n * thread's next placement. Distinct from a rejected COMMAND\n * ({@link statewireRejectionPayload}): this is the shape harness-sdk writes\n * when the run executor raises the rejection, so it lives on the replicated\n * run entry, not on a command settle.\n */\nexport interface RetryableRunRefusal {\n  /** The structured `detail.code` (`pod_draining`). */\n  code: string;\n  /** The server's human-readable reason, when it sent one. */\n  message: string | null;\n}\n\n/** The `{ code, message, retryable: true }` detail of a structured refusal, or `null`. */\nfunction readRetryableDetail(detail: unknown): { code: string; message: string | null } | null {\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const { code, message, retryable } = detail as {\n    code?: unknown;\n    message?: unknown;\n    retryable?: unknown;\n  };\n  if (retryable !== true || typeof code !== 'string' || code.length === 0) return null;\n  return { code, message: typeof message === 'string' && message.length > 0 ? message : null };\n}\n\nexport function readRetryableRunRefusal(error: unknown): RetryableRunRefusal | null {\n  if (error === null || typeof error !== 'object' || Array.isArray(error)) return null;\n  return readRetryableDetail((error as { detail?: unknown }).detail);\n}\n\n/**\n * The `detail.code` agora answers when a send names another channel of the\n * collab agent a session started on (`collab_agent_bridge.py`): a session\n * keeps its channel — the SDK app's Agent / Ask mode — for its lifetime, and\n * the way to the other mode is a new session. Wire-frozen.\n */\nexport const COLLAB_AGENT_CHANNEL_SESSION_MISMATCH = 'collab_agent_channel_session_mismatch';\n\n/**\n * A structured refusal the host recorded as the run error when the run could\n * not START: the run executor raised the gate's `{status, detail: {code,\n * message}}` envelope (agora's `_status_reject`) before it accepted the\n * dispatched input, so the message went back to its lane and the thread rests\n * `error` with it still queued. Unlike a retryable refusal\n * ({@link readRetryableRunRefusal}) nothing will dispatch it later: resending\n * the same input is refused the same way, so the server's message is the only\n * explanation the person gets.\n */\nexport interface RunStartRefusal {\n  /** The structured `detail.code` (`collab_agent_channel_session_mismatch`, …). */\n  code: string;\n  /** The server's human-readable reason, when it sent one. */\n  message: string | null;\n  /** The HTTP-style status the gate raised with, when recorded. */\n  status: number | null;\n}\n\n/**\n * The non-retryable structured refusal off a replicated run error\n * (`runs.error`), or `null` — for a run that failed while it was running (a\n * plain `{message}`), a retryable refusal, or no error at all.\n */\nexport function readRunStartRefusal(error: unknown): RunStartRefusal | null {\n  if (error === null || typeof error !== 'object' || Array.isArray(error)) return null;\n  const { detail, status } = error as { detail?: unknown; status?: unknown };\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const { code, message, retryable } = detail as {\n    code?: unknown;\n    message?: unknown;\n    retryable?: unknown;\n  };\n  if (retryable === true || typeof code !== 'string' || code.length === 0) return null;\n  return {\n    code,\n    message: typeof message === 'string' && message.length > 0 ? message : null,\n    status: typeof status === 'number' ? status : null,\n  };\n}\n\n/** The structured `detail.code` of a rejected command, or `null`. */\nexport function statewireRejectionCode(error: unknown): string | null {\n  const detail = statewireRejectionPayload(error)?.detail;\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const code = (detail as { code?: unknown }).code;\n  return typeof code === 'string' && code.length > 0 ? code : null;\n}\n\n/**\n * A structured, retryable refusal of a COMMAND, read off its rejection\n * ({@link statewireRejectionPayload}): the host's `_structured_reject(...,\n * retryable=True)` envelope — `command_auth_context_expired` when a pod\n * replacement dropped the socket-scoped auth a replayed command needed,\n * `pod_draining` when the host was closing. The command never ran, and the\n * host itself says a resend after the reconnect will; `detail.code` is the\n * wire-frozen contract clients classify on. Same shape as\n * {@link readRetryableRunRefusal}, which reads it off a replicated run entry.\n */\nexport interface RetryableCommandRejection {\n  /** The structured `detail.code`. */\n  code: string;\n  /** The server's human-readable reason, when it sent one. */\n  message: string | null;\n}\n\nexport function readRetryableCommandRejection(error: unknown): RetryableCommandRejection | null {\n  const payload = statewireRejectionPayload(error);\n  return payload === null ? null : readRetryableDetail(payload.detail);\n}\n\n/** The host's `detail.code` for a command replayed onto a pod that could not restore its auth context. */\nexport const STATEWIRE_COMMAND_AUTH_CONTEXT_EXPIRED = 'command_auth_context_expired';\n\n/**\n * Whether a rejected command hit the host's fail-closed auth recovery: the\n * command was replayed onto a replacement pod that could not restore the\n * attach's auth context, so it was refused unrun (503, retryable). The\n * reconnect already under way restores the context; a single resend after it\n * is the recovery, not a failure to report.\n */\nexport function isStatewireCommandAuthContextExpired(error: unknown): boolean {\n  const payload = statewireRejectionPayload(error);\n  return (\n    payload?.status === 503 &&\n    readRetryableDetail(payload.detail)?.code === STATEWIRE_COMMAND_AUTH_CONTEXT_EXPIRED\n  );\n}\n\n/**\n * Whether a rejected command hit the legacy-thread dispatch fence: the\n * structured 409 the server answers when an out-of-band run is writing a\n * pre-cutover thread (or its adoption failed). A per-send failure — the\n * snapshot never carries a standing read-only flag.\n */\nexport function isLegacyThreadReadOnlyRejection(error: unknown): boolean {\n  const payload = statewireRejectionPayload(error);\n  if (payload?.status !== 409) return false;\n\n  const detail = payload.detail as { code?: unknown } | undefined;\n  return detail?.code === 'legacy_thread_read_only';\n}\n\n/**\n * Whether a rejected command was refused because its rewind anchor no longer\n * matches the host's parent for the edited message (`wrong-anchor`).\n *\n * A retry/edit resubmit is dispatched optimistically, so this rejection lands\n * after the UI already cleared its edit affordances: the turn simply never\n * re-runs. Callers use this to tell the user the resubmit was dropped instead\n * of leaving a console-only failure.\n */\nexport function isStatewireRewindAnchorRejection(error: unknown): boolean {\n  const failure = (error as { failure?: { fate?: unknown; payload?: unknown } } | null | undefined)\n    ?.failure;\n  if (failure?.fate !== 'rejected') return false;\n  return (failure.payload as { reason?: unknown } | undefined)?.reason === 'wrong-anchor';\n}\n\n/**\n * Whether a statewire send failure is the host's `expired` verdict\n * (`result-unavailable`): the command's seq was at or below the host's\n * admitted watermark and no retained result was left for it. Either the\n * command ran and settled but the client re-asked for the answer (a resend\n * after the stream came back) only after the host had let the retained result\n * go, or the seq was already admitted and the command was absorbed as a\n * duplicate without ever running — a client whose shared session record fell\n * behind the watermark stays there until a reconnect re-syncs it. The library\n * never reruns the command on replay, so for an idempotent read the answer is\n * simply gone — asking again is the correct reaction, not reporting a failure;\n * a write cannot assume it was applied.\n */\nexport function isStatewireExpiredVerdict(error: unknown): boolean {\n  const failure = (error as { failure?: { fate?: unknown; cause?: unknown } | null | undefined })\n    ?.failure;\n  return failure?.fate === 'expired' && failure.cause === 'server';\n}\n\n/**\n * Whether a statewire send failure is a local channel death rather than a\n * command error.\n *\n * The library's contract for `SendFailure.cause`: `\"server\"` is the server's\n * own answer; every other cause is \"a channel death the client settled\n * locally\" — `unmount`, `stream-gone`, and `session-lost`. A thread switch\n * settles every in-flight command that way, so logging these at error level\n * reports two failures for an ordinary switch and buries the ones that mean\n * something.\n *\n * Channel health is already surfaced where it belongs: the connection\n * indicator renders the connection state. This\n * predicate only decides the log level.\n */\nexport function isStatewireChannelTeardown(error: unknown): boolean {\n  const cause = (error as { failure?: { cause?: unknown } } | null | undefined)?.failure?.cause;\n  return typeof cause === 'string' && cause !== 'server';\n}\n\n/**\n * The low-cardinality reason a statewire send settled as transport weather\n * rather than a defect, or `null` when the failure is a real error.\n *\n * Three families qualify: a channel death the client settled locally\n * ({@link isStatewireChannelTeardown} — the cause: `unmount`, `stream-gone`,\n * `session-lost`), the host's `expired` verdict\n * ({@link isStatewireExpiredVerdict} — the answer outlived the host's\n * retention before the post-reconnect resend collected it), and a retryable\n * structured rejection ({@link readRetryableCommandRejection} — its code: the\n * host asked for a resend). In every case the sender's own retry or poll is\n * the recovery and the connection indicator already shows the channel, so\n * error reporting counts the outcome instead of paging on it. Handler\n * failures, crashes, and non-retryable rejections stay `null`: those are\n * defects to page on.\n */\nexport function statewireTransportOutcome(error: unknown): string | null {\n  const cause = (error as { failure?: { cause?: unknown } } | null | undefined)?.failure?.cause;\n  if (typeof cause === 'string' && cause !== 'server') return cause;\n  if (isStatewireExpiredVerdict(error)) return 'expired';\n  return readRetryableCommandRejection(error)?.code ?? null;\n}\n\nconst sanitizeConnectionMessage = (message: string): string | undefined => {\n  const printable = Array.from(message, (character) => {\n    const code = character.charCodeAt(0);\n    return code < 32 || code === 127 ? ' ' : character;\n  })\n    .join('')\n    .replace(/\\s+/g, ' ')\n    .trim();\n  return printable ? printable.slice(0, 200) : undefined;\n};\n\n/** Preserve the Statewire lifecycle and sanitize host detail for display. */\nexport function projectDeepAgentConnection(\n  connection: StatewireClient.ConnectionState\n): DeepAgentConnectionState {\n  const message =\n    'message' in connection && typeof connection.message === 'string'\n      ? sanitizeConnectionMessage(connection.message)\n      : undefined;\n  switch (connection.status) {\n    case 'standby':\n      return {\n        status: connection.status,\n        reason: connection.reason,\n        degraded: connection.degraded,\n        ...(message !== undefined && { message }),\n      };\n    case 'connecting':\n    case 'connected':\n      return { status: connection.status, degraded: connection.degraded };\n    case 'retrying':\n      return {\n        status: connection.status,\n        degraded: connection.degraded,\n        attempt: connection.attempt,\n        ...(connection.cause !== undefined && { cause: connection.cause }),\n        ...(connection.code !== undefined && { code: connection.code }),\n        ...(connection.nextRetryAt !== undefined && { nextRetryAt: connection.nextRetryAt }),\n        ...(connection.lastError !== undefined && { lastError: connection.lastError }),\n        ...(message !== undefined && { message }),\n      };\n    case 'stopped':\n      return {\n        status: connection.status,\n        degraded: connection.degraded,\n        reason: connection.reason,\n        ...(connection.payload !== undefined && { payload: connection.payload }),\n        ...(message !== undefined && { message }),\n      };\n    default:\n      return unknownConnectionStatus(connection);\n  }\n}\n\n/** Compile-time exhaustiveness: reachable only when the library grows a status this build does not project. */\nfunction unknownConnectionStatus(connection: never): never {\n  throw new Error(\n    `statewire: unknown connection status ${JSON.stringify(\n      (connection as { status?: unknown }).status\n    )}`\n  );\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.cjs","sources":["../../../../agent-runtime/src/errors.ts"],"sourcesContent":["import type { StatewireClient } from 'statewire';\nimport type { DeepAgentConnectionState } from './types';\n\n/** Structured payload attached to a server-rejected Statewire command. */\nexport interface StatewireRejectionPayload {\n  status: number;\n  detail: unknown;\n}\n\n/** Return a rejected command's structured `{ status, detail }` payload. */\nexport function statewireRejectionPayload(error: unknown): StatewireRejectionPayload | null {\n  const failure = (error as { failure?: { fate?: unknown; payload?: unknown } } | null)?.failure;\n  if (failure?.fate !== 'rejected') return null;\n\n  const payload = failure.payload as { status?: unknown; detail?: unknown } | undefined;\n  if (typeof payload?.status !== 'number') return null;\n  return { status: payload.status, detail: payload.detail };\n}\n\n/**\n * The server's human-readable reason for a rejected command — `detail.message`\n * (or a plain-string `detail`) — else `null`. Hosts surface it as send\n * feedback so the user sees the actionable cause instead of the generic\n * client-side `command rejected (<status>)`.\n */\nexport function statewireRejectionDetailMessage(error: unknown): string | null {\n  const detail = statewireRejectionPayload(error)?.detail;\n  if (typeof detail === 'string') return detail.length > 0 ? detail : null;\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const message = (detail as { message?: unknown }).message;\n  return typeof message === 'string' && message.length > 0 ? message : null;\n}\n\n/**\n * A structured, retryable refusal the host recorded as the run error\n * (`runs.error`): the dispatch never started — the pod or instance was\n * closing (`pod_draining`) — and the entries stayed in their lanes for the\n * thread's next placement. Distinct from a rejected COMMAND\n * ({@link statewireRejectionPayload}): this is the shape harness-sdk writes\n * when the run executor raises the rejection, so it lives on the replicated\n * run entry, not on a command settle.\n */\nexport interface RetryableRunRefusal {\n  /** The structured `detail.code` (`pod_draining`). */\n  code: string;\n  /** The server's human-readable reason, when it sent one. */\n  message: string | null;\n}\n\n/** The `{ code, message, retryable: true }` detail of a structured refusal, or `null`. */\nfunction readRetryableDetail(detail: unknown): { code: string; message: string | null } | null {\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const { code, message, retryable } = detail as {\n    code?: unknown;\n    message?: unknown;\n    retryable?: unknown;\n  };\n  if (retryable !== true || typeof code !== 'string' || code.length === 0) return null;\n  return { code, message: typeof message === 'string' && message.length > 0 ? message : null };\n}\n\nexport function readRetryableRunRefusal(error: unknown): RetryableRunRefusal | null {\n  if (error === null || typeof error !== 'object' || Array.isArray(error)) return null;\n  return readRetryableDetail((error as { detail?: unknown }).detail);\n}\n\n/**\n * The `detail.code` agora answers when a send names another channel of the\n * collab agent a session started on (`collab_agent_bridge.py`): a session\n * keeps its channel — the SDK app's Agent / Ask mode — for its lifetime, and\n * the way to the other mode is a new session. Wire-frozen.\n */\nexport const COLLAB_AGENT_CHANNEL_SESSION_MISMATCH = 'collab_agent_channel_session_mismatch';\n\n/**\n * A structured refusal the host recorded as the run error when the run could\n * not START: the run executor raised the gate's `{status, detail: {code,\n * message}}` envelope (agora's `_status_reject`) before it accepted the\n * dispatched input, so the message went back to its lane and the thread rests\n * `error` with it still queued. Unlike a retryable refusal\n * ({@link readRetryableRunRefusal}) nothing will dispatch it later: resending\n * the same input is refused the same way, so the server's message is the only\n * explanation the person gets.\n */\nexport interface RunStartRefusal {\n  /** The structured `detail.code` (`collab_agent_channel_session_mismatch`, …). */\n  code: string;\n  /** The server's human-readable reason, when it sent one. */\n  message: string | null;\n  /** The HTTP-style status the gate raised with, when recorded. */\n  status: number | null;\n}\n\n/**\n * The non-retryable structured refusal off a replicated run error\n * (`runs.error`), or `null` — for a run that failed while it was running (a\n * plain `{message}`), a retryable refusal, or no error at all.\n */\nexport function readRunStartRefusal(error: unknown): RunStartRefusal | null {\n  if (error === null || typeof error !== 'object' || Array.isArray(error)) return null;\n  const { detail, status } = error as { detail?: unknown; status?: unknown };\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const { code, message, retryable } = detail as {\n    code?: unknown;\n    message?: unknown;\n    retryable?: unknown;\n  };\n  if (retryable === true || typeof code !== 'string' || code.length === 0) return null;\n  return {\n    code,\n    message: typeof message === 'string' && message.length > 0 ? message : null,\n    status: typeof status === 'number' ? status : null,\n  };\n}\n\n/** The structured `detail.code` of a rejected command, or `null`. */\nexport function statewireRejectionCode(error: unknown): string | null {\n  const detail = statewireRejectionPayload(error)?.detail;\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const code = (detail as { code?: unknown }).code;\n  return typeof code === 'string' && code.length > 0 ? code : null;\n}\n\n/**\n * A structured, retryable refusal of a COMMAND, read off its rejection\n * ({@link statewireRejectionPayload}): the host's `_structured_reject(...,\n * retryable=True)` envelope — `command_auth_context_expired` when a pod\n * replacement dropped the socket-scoped auth a replayed command needed,\n * `pod_draining` when the host was closing. The command never ran, and the\n * host itself says a resend after the reconnect will; `detail.code` is the\n * wire-frozen contract clients classify on. Same shape as\n * {@link readRetryableRunRefusal}, which reads it off a replicated run entry.\n */\nexport interface RetryableCommandRejection {\n  /** The structured `detail.code`. */\n  code: string;\n  /** The server's human-readable reason, when it sent one. */\n  message: string | null;\n}\n\nexport function readRetryableCommandRejection(error: unknown): RetryableCommandRejection | null {\n  const payload = statewireRejectionPayload(error);\n  return payload === null ? null : readRetryableDetail(payload.detail);\n}\n\n/** The host's `detail.code` for a command replayed onto a pod that could not restore its auth context. */\nexport const STATEWIRE_COMMAND_AUTH_CONTEXT_EXPIRED = 'command_auth_context_expired';\n\n/**\n * Whether a rejected command hit the host's fail-closed auth recovery: the\n * command was replayed onto a replacement pod that could not restore the\n * attach's auth context, so it was refused unrun (503, retryable). The\n * reconnect already under way restores the context; a single resend after it\n * is the recovery, not a failure to report.\n */\nexport function isStatewireCommandAuthContextExpired(error: unknown): boolean {\n  const payload = statewireRejectionPayload(error);\n  return (\n    payload?.status === 503 &&\n    readRetryableDetail(payload.detail)?.code === STATEWIRE_COMMAND_AUTH_CONTEXT_EXPIRED\n  );\n}\n\n/**\n * The `detail.code` agora answers for a write to an archived (trashed)\n * conversation (`host_rejects._conversation_archived_reject`, a 409): it\n * takes no new turns, config writes or approval answers until it is\n * restored, and stopping still works. Wire-frozen.\n */\nexport const CONVERSATION_ARCHIVED = 'conversation_archived';\n\n/** What a person is told when that refusal comes back (the server says the same). */\nexport const CONVERSATION_ARCHIVED_MESSAGE =\n  'This conversation is archived. Restore it to continue.';\n\n/**\n * Whether a rejected command was refused because the conversation is archived\n * ({@link CONVERSATION_ARCHIVED}). Not retriable: nothing changes until a\n * restore, so callers show {@link CONVERSATION_ARCHIVED_MESSAGE} rather than a\n * \"try again\".\n */\nexport function isConversationArchivedRejection(error: unknown): boolean {\n  return statewireRejectionCode(error) === CONVERSATION_ARCHIVED;\n}\n\n/**\n * Whether a rejected command hit the legacy-thread dispatch fence: the\n * structured 409 the server answers when an out-of-band run is writing a\n * pre-cutover thread (or its adoption failed). A per-send failure — the\n * snapshot never carries a standing read-only flag.\n */\nexport function isLegacyThreadReadOnlyRejection(error: unknown): boolean {\n  const payload = statewireRejectionPayload(error);\n  if (payload?.status !== 409) return false;\n\n  const detail = payload.detail as { code?: unknown } | undefined;\n  return detail?.code === 'legacy_thread_read_only';\n}\n\n/**\n * Whether a rejected command was refused because its rewind anchor no longer\n * matches the host's parent for the edited message (`wrong-anchor`).\n *\n * A retry/edit resubmit is dispatched optimistically, so this rejection lands\n * after the UI already cleared its edit affordances: the turn simply never\n * re-runs. Callers use this to tell the user the resubmit was dropped instead\n * of leaving a console-only failure.\n */\nexport function isStatewireRewindAnchorRejection(error: unknown): boolean {\n  const failure = (error as { failure?: { fate?: unknown; payload?: unknown } } | null | undefined)\n    ?.failure;\n  if (failure?.fate !== 'rejected') return false;\n  return (failure.payload as { reason?: unknown } | undefined)?.reason === 'wrong-anchor';\n}\n\n/**\n * Whether a statewire send failure is the host's `expired` verdict\n * (`result-unavailable`): the command's seq was at or below the host's\n * admitted watermark and no retained result was left for it. Either the\n * command ran and settled but the client re-asked for the answer (a resend\n * after the stream came back) only after the host had let the retained result\n * go, or the seq was already admitted and the command was absorbed as a\n * duplicate without ever running — a client whose shared session record fell\n * behind the watermark stays there until a reconnect re-syncs it. The library\n * never reruns the command on replay, so for an idempotent read the answer is\n * simply gone — asking again is the correct reaction, not reporting a failure;\n * a write cannot assume it was applied.\n */\nexport function isStatewireExpiredVerdict(error: unknown): boolean {\n  const failure = (error as { failure?: { fate?: unknown; cause?: unknown } | null | undefined })\n    ?.failure;\n  return failure?.fate === 'expired' && failure.cause === 'server';\n}\n\n/**\n * Whether a statewire send failure is a local channel death rather than a\n * command error.\n *\n * The library's contract for `SendFailure.cause`: `\"server\"` is the server's\n * own answer; every other cause is \"a channel death the client settled\n * locally\" — `unmount`, `stream-gone`, and `session-lost`. A thread switch\n * settles every in-flight command that way, so logging these at error level\n * reports two failures for an ordinary switch and buries the ones that mean\n * something.\n *\n * Channel health is already surfaced where it belongs: the connection\n * indicator renders the connection state. This\n * predicate only decides the log level.\n */\nexport function isStatewireChannelTeardown(error: unknown): boolean {\n  const cause = (error as { failure?: { cause?: unknown } } | null | undefined)?.failure?.cause;\n  return typeof cause === 'string' && cause !== 'server';\n}\n\n/**\n * The low-cardinality reason a statewire send settled as transport weather\n * rather than a defect, or `null` when the failure is a real error.\n *\n * Three families qualify: a channel death the client settled locally\n * ({@link isStatewireChannelTeardown} — the cause: `unmount`, `stream-gone`,\n * `session-lost`), the host's `expired` verdict\n * ({@link isStatewireExpiredVerdict} — the answer outlived the host's\n * retention before the post-reconnect resend collected it), and a retryable\n * structured rejection ({@link readRetryableCommandRejection} — its code: the\n * host asked for a resend). In every case the sender's own retry or poll is\n * the recovery and the connection indicator already shows the channel, so\n * error reporting counts the outcome instead of paging on it. Handler\n * failures, crashes, and non-retryable rejections stay `null`: those are\n * defects to page on.\n */\nexport function statewireTransportOutcome(error: unknown): string | null {\n  const cause = (error as { failure?: { cause?: unknown } } | null | undefined)?.failure?.cause;\n  if (typeof cause === 'string' && cause !== 'server') return cause;\n  if (isStatewireExpiredVerdict(error)) return 'expired';\n  return readRetryableCommandRejection(error)?.code ?? null;\n}\n\nconst sanitizeConnectionMessage = (message: string): string | undefined => {\n  const printable = Array.from(message, (character) => {\n    const code = character.charCodeAt(0);\n    return code < 32 || code === 127 ? ' ' : character;\n  })\n    .join('')\n    .replace(/\\s+/g, ' ')\n    .trim();\n  return printable ? printable.slice(0, 200) : undefined;\n};\n\n/** Preserve the Statewire lifecycle and sanitize host detail for display. */\nexport function projectDeepAgentConnection(\n  connection: StatewireClient.ConnectionState\n): DeepAgentConnectionState {\n  const message =\n    'message' in connection && typeof connection.message === 'string'\n      ? sanitizeConnectionMessage(connection.message)\n      : undefined;\n  switch (connection.status) {\n    case 'standby':\n      return {\n        status: connection.status,\n        reason: connection.reason,\n        degraded: connection.degraded,\n        ...(message !== undefined && { message }),\n      };\n    case 'connecting':\n    case 'connected':\n      return { status: connection.status, degraded: connection.degraded };\n    case 'retrying':\n      return {\n        status: connection.status,\n        degraded: connection.degraded,\n        attempt: connection.attempt,\n        ...(connection.cause !== undefined && { cause: connection.cause }),\n        ...(connection.code !== undefined && { code: connection.code }),\n        ...(connection.nextRetryAt !== undefined && { nextRetryAt: connection.nextRetryAt }),\n        ...(connection.lastError !== undefined && { lastError: connection.lastError }),\n        ...(message !== undefined && { message }),\n      };\n    case 'stopped':\n      return {\n        status: connection.status,\n        degraded: connection.degraded,\n        reason: connection.reason,\n        ...(connection.payload !== undefined && { payload: connection.payload }),\n        ...(message !== undefined && { message }),\n      };\n    default:\n      return unknownConnectionStatus(connection);\n  }\n}\n\n/** Compile-time exhaustiveness: reachable only when the library grows a status this build does not project. */\nfunction unknownConnectionStatus(connection: never): never {\n  throw new Error(\n    `statewire: unknown connection status ${JSON.stringify(\n      (connection as { status?: unknown }).status\n    )}`\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/agent-runtime/src/errors.js

@@ -47,6 +47,11 @@ function readRetryableCommandRejection(error) {
   const payload = statewireRejectionPayload(error);
   return payload === null ? null : readRetryableDetail(payload.detail);
 }
+const CONVERSATION_ARCHIVED = "conversation_archived";
+const CONVERSATION_ARCHIVED_MESSAGE = "This conversation is archived. Restore it to continue.";
+function isConversationArchivedRejection(error) {
+  return statewireRejectionCode(error) === CONVERSATION_ARCHIVED;
+}
 function isLegacyThreadReadOnlyRejection(error) {
   const payload = statewireRejectionPayload(error);
   if ((payload == null ? void 0 : payload.status) !== 409) return false;
@@ -121,6 +126,9 @@ function unknownConnectionStatus(connection) {
 }
 export {
   COLLAB_AGENT_CHANNEL_SESSION_MISMATCH,
+  CONVERSATION_ARCHIVED,
+  CONVERSATION_ARCHIVED_MESSAGE,
+  isConversationArchivedRejection,
   isLegacyThreadReadOnlyRejection,
   isStatewireChannelTeardown,
   isStatewireExpiredVerdict,

package/dist/agent-runtime/src/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sources":["../../../../agent-runtime/src/errors.ts"],"sourcesContent":["import type { StatewireClient } from 'statewire';\nimport type { DeepAgentConnectionState } from './types';\n\n/** Structured payload attached to a server-rejected Statewire command. */\nexport interface StatewireRejectionPayload {\n  status: number;\n  detail: unknown;\n}\n\n/** Return a rejected command's structured `{ status, detail }` payload. */\nexport function statewireRejectionPayload(error: unknown): StatewireRejectionPayload | null {\n  const failure = (error as { failure?: { fate?: unknown; payload?: unknown } } | null)?.failure;\n  if (failure?.fate !== 'rejected') return null;\n\n  const payload = failure.payload as { status?: unknown; detail?: unknown } | undefined;\n  if (typeof payload?.status !== 'number') return null;\n  return { status: payload.status, detail: payload.detail };\n}\n\n/**\n * The server's human-readable reason for a rejected command — `detail.message`\n * (or a plain-string `detail`) — else `null`. Hosts surface it as send\n * feedback so the user sees the actionable cause instead of the generic\n * client-side `command rejected (<status>)`.\n */\nexport function statewireRejectionDetailMessage(error: unknown): string | null {\n  const detail = statewireRejectionPayload(error)?.detail;\n  if (typeof detail === 'string') return detail.length > 0 ? detail : null;\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const message = (detail as { message?: unknown }).message;\n  return typeof message === 'string' && message.length > 0 ? message : null;\n}\n\n/**\n * A structured, retryable refusal the host recorded as the run error\n * (`runs.error`): the dispatch never started — the pod or instance was\n * closing (`pod_draining`) — and the entries stayed in their lanes for the\n * thread's next placement. Distinct from a rejected COMMAND\n * ({@link statewireRejectionPayload}): this is the shape harness-sdk writes\n * when the run executor raises the rejection, so it lives on the replicated\n * run entry, not on a command settle.\n */\nexport interface RetryableRunRefusal {\n  /** The structured `detail.code` (`pod_draining`). */\n  code: string;\n  /** The server's human-readable reason, when it sent one. */\n  message: string | null;\n}\n\n/** The `{ code, message, retryable: true }` detail of a structured refusal, or `null`. */\nfunction readRetryableDetail(detail: unknown): { code: string; message: string | null } | null {\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const { code, message, retryable } = detail as {\n    code?: unknown;\n    message?: unknown;\n    retryable?: unknown;\n  };\n  if (retryable !== true || typeof code !== 'string' || code.length === 0) return null;\n  return { code, message: typeof message === 'string' && message.length > 0 ? message : null };\n}\n\nexport function readRetryableRunRefusal(error: unknown): RetryableRunRefusal | null {\n  if (error === null || typeof error !== 'object' || Array.isArray(error)) return null;\n  return readRetryableDetail((error as { detail?: unknown }).detail);\n}\n\n/**\n * The `detail.code` agora answers when a send names another channel of the\n * collab agent a session started on (`collab_agent_bridge.py`): a session\n * keeps its channel — the SDK app's Agent / Ask mode — for its lifetime, and\n * the way to the other mode is a new session. Wire-frozen.\n */\nexport const COLLAB_AGENT_CHANNEL_SESSION_MISMATCH = 'collab_agent_channel_session_mismatch';\n\n/**\n * A structured refusal the host recorded as the run error when the run could\n * not START: the run executor raised the gate's `{status, detail: {code,\n * message}}` envelope (agora's `_status_reject`) before it accepted the\n * dispatched input, so the message went back to its lane and the thread rests\n * `error` with it still queued. Unlike a retryable refusal\n * ({@link readRetryableRunRefusal}) nothing will dispatch it later: resending\n * the same input is refused the same way, so the server's message is the only\n * explanation the person gets.\n */\nexport interface RunStartRefusal {\n  /** The structured `detail.code` (`collab_agent_channel_session_mismatch`, …). */\n  code: string;\n  /** The server's human-readable reason, when it sent one. */\n  message: string | null;\n  /** The HTTP-style status the gate raised with, when recorded. */\n  status: number | null;\n}\n\n/**\n * The non-retryable structured refusal off a replicated run error\n * (`runs.error`), or `null` — for a run that failed while it was running (a\n * plain `{message}`), a retryable refusal, or no error at all.\n */\nexport function readRunStartRefusal(error: unknown): RunStartRefusal | null {\n  if (error === null || typeof error !== 'object' || Array.isArray(error)) return null;\n  const { detail, status } = error as { detail?: unknown; status?: unknown };\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const { code, message, retryable } = detail as {\n    code?: unknown;\n    message?: unknown;\n    retryable?: unknown;\n  };\n  if (retryable === true || typeof code !== 'string' || code.length === 0) return null;\n  return {\n    code,\n    message: typeof message === 'string' && message.length > 0 ? message : null,\n    status: typeof status === 'number' ? status : null,\n  };\n}\n\n/** The structured `detail.code` of a rejected command, or `null`. */\nexport function statewireRejectionCode(error: unknown): string | null {\n  const detail = statewireRejectionPayload(error)?.detail;\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const code = (detail as { code?: unknown }).code;\n  return typeof code === 'string' && code.length > 0 ? code : null;\n}\n\n/**\n * A structured, retryable refusal of a COMMAND, read off its rejection\n * ({@link statewireRejectionPayload}): the host's `_structured_reject(...,\n * retryable=True)` envelope — `command_auth_context_expired` when a pod\n * replacement dropped the socket-scoped auth a replayed command needed,\n * `pod_draining` when the host was closing. The command never ran, and the\n * host itself says a resend after the reconnect will; `detail.code` is the\n * wire-frozen contract clients classify on. Same shape as\n * {@link readRetryableRunRefusal}, which reads it off a replicated run entry.\n */\nexport interface RetryableCommandRejection {\n  /** The structured `detail.code`. */\n  code: string;\n  /** The server's human-readable reason, when it sent one. */\n  message: string | null;\n}\n\nexport function readRetryableCommandRejection(error: unknown): RetryableCommandRejection | null {\n  const payload = statewireRejectionPayload(error);\n  return payload === null ? null : readRetryableDetail(payload.detail);\n}\n\n/** The host's `detail.code` for a command replayed onto a pod that could not restore its auth context. */\nexport const STATEWIRE_COMMAND_AUTH_CONTEXT_EXPIRED = 'command_auth_context_expired';\n\n/**\n * Whether a rejected command hit the host's fail-closed auth recovery: the\n * command was replayed onto a replacement pod that could not restore the\n * attach's auth context, so it was refused unrun (503, retryable). The\n * reconnect already under way restores the context; a single resend after it\n * is the recovery, not a failure to report.\n */\nexport function isStatewireCommandAuthContextExpired(error: unknown): boolean {\n  const payload = statewireRejectionPayload(error);\n  return (\n    payload?.status === 503 &&\n    readRetryableDetail(payload.detail)?.code === STATEWIRE_COMMAND_AUTH_CONTEXT_EXPIRED\n  );\n}\n\n/**\n * Whether a rejected command hit the legacy-thread dispatch fence: the\n * structured 409 the server answers when an out-of-band run is writing a\n * pre-cutover thread (or its adoption failed). A per-send failure — the\n * snapshot never carries a standing read-only flag.\n */\nexport function isLegacyThreadReadOnlyRejection(error: unknown): boolean {\n  const payload = statewireRejectionPayload(error);\n  if (payload?.status !== 409) return false;\n\n  const detail = payload.detail as { code?: unknown } | undefined;\n  return detail?.code === 'legacy_thread_read_only';\n}\n\n/**\n * Whether a rejected command was refused because its rewind anchor no longer\n * matches the host's parent for the edited message (`wrong-anchor`).\n *\n * A retry/edit resubmit is dispatched optimistically, so this rejection lands\n * after the UI already cleared its edit affordances: the turn simply never\n * re-runs. Callers use this to tell the user the resubmit was dropped instead\n * of leaving a console-only failure.\n */\nexport function isStatewireRewindAnchorRejection(error: unknown): boolean {\n  const failure = (error as { failure?: { fate?: unknown; payload?: unknown } } | null | undefined)\n    ?.failure;\n  if (failure?.fate !== 'rejected') return false;\n  return (failure.payload as { reason?: unknown } | undefined)?.reason === 'wrong-anchor';\n}\n\n/**\n * Whether a statewire send failure is the host's `expired` verdict\n * (`result-unavailable`): the command's seq was at or below the host's\n * admitted watermark and no retained result was left for it. Either the\n * command ran and settled but the client re-asked for the answer (a resend\n * after the stream came back) only after the host had let the retained result\n * go, or the seq was already admitted and the command was absorbed as a\n * duplicate without ever running — a client whose shared session record fell\n * behind the watermark stays there until a reconnect re-syncs it. The library\n * never reruns the command on replay, so for an idempotent read the answer is\n * simply gone — asking again is the correct reaction, not reporting a failure;\n * a write cannot assume it was applied.\n */\nexport function isStatewireExpiredVerdict(error: unknown): boolean {\n  const failure = (error as { failure?: { fate?: unknown; cause?: unknown } | null | undefined })\n    ?.failure;\n  return failure?.fate === 'expired' && failure.cause === 'server';\n}\n\n/**\n * Whether a statewire send failure is a local channel death rather than a\n * command error.\n *\n * The library's contract for `SendFailure.cause`: `\"server\"` is the server's\n * own answer; every other cause is \"a channel death the client settled\n * locally\" — `unmount`, `stream-gone`, and `session-lost`. A thread switch\n * settles every in-flight command that way, so logging these at error level\n * reports two failures for an ordinary switch and buries the ones that mean\n * something.\n *\n * Channel health is already surfaced where it belongs: the connection\n * indicator renders the connection state. This\n * predicate only decides the log level.\n */\nexport function isStatewireChannelTeardown(error: unknown): boolean {\n  const cause = (error as { failure?: { cause?: unknown } } | null | undefined)?.failure?.cause;\n  return typeof cause === 'string' && cause !== 'server';\n}\n\n/**\n * The low-cardinality reason a statewire send settled as transport weather\n * rather than a defect, or `null` when the failure is a real error.\n *\n * Three families qualify: a channel death the client settled locally\n * ({@link isStatewireChannelTeardown} — the cause: `unmount`, `stream-gone`,\n * `session-lost`), the host's `expired` verdict\n * ({@link isStatewireExpiredVerdict} — the answer outlived the host's\n * retention before the post-reconnect resend collected it), and a retryable\n * structured rejection ({@link readRetryableCommandRejection} — its code: the\n * host asked for a resend). In every case the sender's own retry or poll is\n * the recovery and the connection indicator already shows the channel, so\n * error reporting counts the outcome instead of paging on it. Handler\n * failures, crashes, and non-retryable rejections stay `null`: those are\n * defects to page on.\n */\nexport function statewireTransportOutcome(error: unknown): string | null {\n  const cause = (error as { failure?: { cause?: unknown } } | null | undefined)?.failure?.cause;\n  if (typeof cause === 'string' && cause !== 'server') return cause;\n  if (isStatewireExpiredVerdict(error)) return 'expired';\n  return readRetryableCommandRejection(error)?.code ?? null;\n}\n\nconst sanitizeConnectionMessage = (message: string): string | undefined => {\n  const printable = Array.from(message, (character) => {\n    const code = character.charCodeAt(0);\n    return code < 32 || code === 127 ? ' ' : character;\n  })\n    .join('')\n    .replace(/\\s+/g, ' ')\n    .trim();\n  return printable ? printable.slice(0, 200) : undefined;\n};\n\n/** Preserve the Statewire lifecycle and sanitize host detail for display. */\nexport function projectDeepAgentConnection(\n  connection: StatewireClient.ConnectionState\n): DeepAgentConnectionState {\n  const message =\n    'message' in connection && typeof connection.message === 'string'\n      ? sanitizeConnectionMessage(connection.message)\n      : undefined;\n  switch (connection.status) {\n    case 'standby':\n      return {\n        status: connection.status,\n        reason: connection.reason,\n        degraded: connection.degraded,\n        ...(message !== undefined && { message }),\n      };\n    case 'connecting':\n    case 'connected':\n      return { status: connection.status, degraded: connection.degraded };\n    case 'retrying':\n      return {\n        status: connection.status,\n        degraded: connection.degraded,\n        attempt: connection.attempt,\n        ...(connection.cause !== undefined && { cause: connection.cause }),\n        ...(connection.code !== undefined && { code: connection.code }),\n        ...(connection.nextRetryAt !== undefined && { nextRetryAt: connection.nextRetryAt }),\n        ...(connection.lastError !== undefined && { lastError: connection.lastError }),\n        ...(message !== undefined && { message }),\n      };\n    case 'stopped':\n      return {\n        status: connection.status,\n        degraded: connection.degraded,\n        reason: connection.reason,\n        ...(connection.payload !== undefined && { payload: connection.payload }),\n        ...(message !== undefined && { message }),\n      };\n    default:\n      return unknownConnectionStatus(connection);\n  }\n}\n\n/** Compile-time exhaustiveness: reachable only when the library grows a status this build does not project. */\nfunction unknownConnectionStatus(connection: never): never {\n  throw new Error(\n    `statewire: unknown connection status ${JSON.stringify(\n      (connection as { status?: unknown }).status\n    )}`\n  );\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sources":["../../../../agent-runtime/src/errors.ts"],"sourcesContent":["import type { StatewireClient } from 'statewire';\nimport type { DeepAgentConnectionState } from './types';\n\n/** Structured payload attached to a server-rejected Statewire command. */\nexport interface StatewireRejectionPayload {\n  status: number;\n  detail: unknown;\n}\n\n/** Return a rejected command's structured `{ status, detail }` payload. */\nexport function statewireRejectionPayload(error: unknown): StatewireRejectionPayload | null {\n  const failure = (error as { failure?: { fate?: unknown; payload?: unknown } } | null)?.failure;\n  if (failure?.fate !== 'rejected') return null;\n\n  const payload = failure.payload as { status?: unknown; detail?: unknown } | undefined;\n  if (typeof payload?.status !== 'number') return null;\n  return { status: payload.status, detail: payload.detail };\n}\n\n/**\n * The server's human-readable reason for a rejected command — `detail.message`\n * (or a plain-string `detail`) — else `null`. Hosts surface it as send\n * feedback so the user sees the actionable cause instead of the generic\n * client-side `command rejected (<status>)`.\n */\nexport function statewireRejectionDetailMessage(error: unknown): string | null {\n  const detail = statewireRejectionPayload(error)?.detail;\n  if (typeof detail === 'string') return detail.length > 0 ? detail : null;\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const message = (detail as { message?: unknown }).message;\n  return typeof message === 'string' && message.length > 0 ? message : null;\n}\n\n/**\n * A structured, retryable refusal the host recorded as the run error\n * (`runs.error`): the dispatch never started — the pod or instance was\n * closing (`pod_draining`) — and the entries stayed in their lanes for the\n * thread's next placement. Distinct from a rejected COMMAND\n * ({@link statewireRejectionPayload}): this is the shape harness-sdk writes\n * when the run executor raises the rejection, so it lives on the replicated\n * run entry, not on a command settle.\n */\nexport interface RetryableRunRefusal {\n  /** The structured `detail.code` (`pod_draining`). */\n  code: string;\n  /** The server's human-readable reason, when it sent one. */\n  message: string | null;\n}\n\n/** The `{ code, message, retryable: true }` detail of a structured refusal, or `null`. */\nfunction readRetryableDetail(detail: unknown): { code: string; message: string | null } | null {\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const { code, message, retryable } = detail as {\n    code?: unknown;\n    message?: unknown;\n    retryable?: unknown;\n  };\n  if (retryable !== true || typeof code !== 'string' || code.length === 0) return null;\n  return { code, message: typeof message === 'string' && message.length > 0 ? message : null };\n}\n\nexport function readRetryableRunRefusal(error: unknown): RetryableRunRefusal | null {\n  if (error === null || typeof error !== 'object' || Array.isArray(error)) return null;\n  return readRetryableDetail((error as { detail?: unknown }).detail);\n}\n\n/**\n * The `detail.code` agora answers when a send names another channel of the\n * collab agent a session started on (`collab_agent_bridge.py`): a session\n * keeps its channel — the SDK app's Agent / Ask mode — for its lifetime, and\n * the way to the other mode is a new session. Wire-frozen.\n */\nexport const COLLAB_AGENT_CHANNEL_SESSION_MISMATCH = 'collab_agent_channel_session_mismatch';\n\n/**\n * A structured refusal the host recorded as the run error when the run could\n * not START: the run executor raised the gate's `{status, detail: {code,\n * message}}` envelope (agora's `_status_reject`) before it accepted the\n * dispatched input, so the message went back to its lane and the thread rests\n * `error` with it still queued. Unlike a retryable refusal\n * ({@link readRetryableRunRefusal}) nothing will dispatch it later: resending\n * the same input is refused the same way, so the server's message is the only\n * explanation the person gets.\n */\nexport interface RunStartRefusal {\n  /** The structured `detail.code` (`collab_agent_channel_session_mismatch`, …). */\n  code: string;\n  /** The server's human-readable reason, when it sent one. */\n  message: string | null;\n  /** The HTTP-style status the gate raised with, when recorded. */\n  status: number | null;\n}\n\n/**\n * The non-retryable structured refusal off a replicated run error\n * (`runs.error`), or `null` — for a run that failed while it was running (a\n * plain `{message}`), a retryable refusal, or no error at all.\n */\nexport function readRunStartRefusal(error: unknown): RunStartRefusal | null {\n  if (error === null || typeof error !== 'object' || Array.isArray(error)) return null;\n  const { detail, status } = error as { detail?: unknown; status?: unknown };\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const { code, message, retryable } = detail as {\n    code?: unknown;\n    message?: unknown;\n    retryable?: unknown;\n  };\n  if (retryable === true || typeof code !== 'string' || code.length === 0) return null;\n  return {\n    code,\n    message: typeof message === 'string' && message.length > 0 ? message : null,\n    status: typeof status === 'number' ? status : null,\n  };\n}\n\n/** The structured `detail.code` of a rejected command, or `null`. */\nexport function statewireRejectionCode(error: unknown): string | null {\n  const detail = statewireRejectionPayload(error)?.detail;\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const code = (detail as { code?: unknown }).code;\n  return typeof code === 'string' && code.length > 0 ? code : null;\n}\n\n/**\n * A structured, retryable refusal of a COMMAND, read off its rejection\n * ({@link statewireRejectionPayload}): the host's `_structured_reject(...,\n * retryable=True)` envelope — `command_auth_context_expired` when a pod\n * replacement dropped the socket-scoped auth a replayed command needed,\n * `pod_draining` when the host was closing. The command never ran, and the\n * host itself says a resend after the reconnect will; `detail.code` is the\n * wire-frozen contract clients classify on. Same shape as\n * {@link readRetryableRunRefusal}, which reads it off a replicated run entry.\n */\nexport interface RetryableCommandRejection {\n  /** The structured `detail.code`. */\n  code: string;\n  /** The server's human-readable reason, when it sent one. */\n  message: string | null;\n}\n\nexport function readRetryableCommandRejection(error: unknown): RetryableCommandRejection | null {\n  const payload = statewireRejectionPayload(error);\n  return payload === null ? null : readRetryableDetail(payload.detail);\n}\n\n/** The host's `detail.code` for a command replayed onto a pod that could not restore its auth context. */\nexport const STATEWIRE_COMMAND_AUTH_CONTEXT_EXPIRED = 'command_auth_context_expired';\n\n/**\n * Whether a rejected command hit the host's fail-closed auth recovery: the\n * command was replayed onto a replacement pod that could not restore the\n * attach's auth context, so it was refused unrun (503, retryable). The\n * reconnect already under way restores the context; a single resend after it\n * is the recovery, not a failure to report.\n */\nexport function isStatewireCommandAuthContextExpired(error: unknown): boolean {\n  const payload = statewireRejectionPayload(error);\n  return (\n    payload?.status === 503 &&\n    readRetryableDetail(payload.detail)?.code === STATEWIRE_COMMAND_AUTH_CONTEXT_EXPIRED\n  );\n}\n\n/**\n * The `detail.code` agora answers for a write to an archived (trashed)\n * conversation (`host_rejects._conversation_archived_reject`, a 409): it\n * takes no new turns, config writes or approval answers until it is\n * restored, and stopping still works. Wire-frozen.\n */\nexport const CONVERSATION_ARCHIVED = 'conversation_archived';\n\n/** What a person is told when that refusal comes back (the server says the same). */\nexport const CONVERSATION_ARCHIVED_MESSAGE =\n  'This conversation is archived. Restore it to continue.';\n\n/**\n * Whether a rejected command was refused because the conversation is archived\n * ({@link CONVERSATION_ARCHIVED}). Not retriable: nothing changes until a\n * restore, so callers show {@link CONVERSATION_ARCHIVED_MESSAGE} rather than a\n * \"try again\".\n */\nexport function isConversationArchivedRejection(error: unknown): boolean {\n  return statewireRejectionCode(error) === CONVERSATION_ARCHIVED;\n}\n\n/**\n * Whether a rejected command hit the legacy-thread dispatch fence: the\n * structured 409 the server answers when an out-of-band run is writing a\n * pre-cutover thread (or its adoption failed). A per-send failure — the\n * snapshot never carries a standing read-only flag.\n */\nexport function isLegacyThreadReadOnlyRejection(error: unknown): boolean {\n  const payload = statewireRejectionPayload(error);\n  if (payload?.status !== 409) return false;\n\n  const detail = payload.detail as { code?: unknown } | undefined;\n  return detail?.code === 'legacy_thread_read_only';\n}\n\n/**\n * Whether a rejected command was refused because its rewind anchor no longer\n * matches the host's parent for the edited message (`wrong-anchor`).\n *\n * A retry/edit resubmit is dispatched optimistically, so this rejection lands\n * after the UI already cleared its edit affordances: the turn simply never\n * re-runs. Callers use this to tell the user the resubmit was dropped instead\n * of leaving a console-only failure.\n */\nexport function isStatewireRewindAnchorRejection(error: unknown): boolean {\n  const failure = (error as { failure?: { fate?: unknown; payload?: unknown } } | null | undefined)\n    ?.failure;\n  if (failure?.fate !== 'rejected') return false;\n  return (failure.payload as { reason?: unknown } | undefined)?.reason === 'wrong-anchor';\n}\n\n/**\n * Whether a statewire send failure is the host's `expired` verdict\n * (`result-unavailable`): the command's seq was at or below the host's\n * admitted watermark and no retained result was left for it. Either the\n * command ran and settled but the client re-asked for the answer (a resend\n * after the stream came back) only after the host had let the retained result\n * go, or the seq was already admitted and the command was absorbed as a\n * duplicate without ever running — a client whose shared session record fell\n * behind the watermark stays there until a reconnect re-syncs it. The library\n * never reruns the command on replay, so for an idempotent read the answer is\n * simply gone — asking again is the correct reaction, not reporting a failure;\n * a write cannot assume it was applied.\n */\nexport function isStatewireExpiredVerdict(error: unknown): boolean {\n  const failure = (error as { failure?: { fate?: unknown; cause?: unknown } | null | undefined })\n    ?.failure;\n  return failure?.fate === 'expired' && failure.cause === 'server';\n}\n\n/**\n * Whether a statewire send failure is a local channel death rather than a\n * command error.\n *\n * The library's contract for `SendFailure.cause`: `\"server\"` is the server's\n * own answer; every other cause is \"a channel death the client settled\n * locally\" — `unmount`, `stream-gone`, and `session-lost`. A thread switch\n * settles every in-flight command that way, so logging these at error level\n * reports two failures for an ordinary switch and buries the ones that mean\n * something.\n *\n * Channel health is already surfaced where it belongs: the connection\n * indicator renders the connection state. This\n * predicate only decides the log level.\n */\nexport function isStatewireChannelTeardown(error: unknown): boolean {\n  const cause = (error as { failure?: { cause?: unknown } } | null | undefined)?.failure?.cause;\n  return typeof cause === 'string' && cause !== 'server';\n}\n\n/**\n * The low-cardinality reason a statewire send settled as transport weather\n * rather than a defect, or `null` when the failure is a real error.\n *\n * Three families qualify: a channel death the client settled locally\n * ({@link isStatewireChannelTeardown} — the cause: `unmount`, `stream-gone`,\n * `session-lost`), the host's `expired` verdict\n * ({@link isStatewireExpiredVerdict} — the answer outlived the host's\n * retention before the post-reconnect resend collected it), and a retryable\n * structured rejection ({@link readRetryableCommandRejection} — its code: the\n * host asked for a resend). In every case the sender's own retry or poll is\n * the recovery and the connection indicator already shows the channel, so\n * error reporting counts the outcome instead of paging on it. Handler\n * failures, crashes, and non-retryable rejections stay `null`: those are\n * defects to page on.\n */\nexport function statewireTransportOutcome(error: unknown): string | null {\n  const cause = (error as { failure?: { cause?: unknown } } | null | undefined)?.failure?.cause;\n  if (typeof cause === 'string' && cause !== 'server') return cause;\n  if (isStatewireExpiredVerdict(error)) return 'expired';\n  return readRetryableCommandRejection(error)?.code ?? null;\n}\n\nconst sanitizeConnectionMessage = (message: string): string | undefined => {\n  const printable = Array.from(message, (character) => {\n    const code = character.charCodeAt(0);\n    return code < 32 || code === 127 ? ' ' : character;\n  })\n    .join('')\n    .replace(/\\s+/g, ' ')\n    .trim();\n  return printable ? printable.slice(0, 200) : undefined;\n};\n\n/** Preserve the Statewire lifecycle and sanitize host detail for display. */\nexport function projectDeepAgentConnection(\n  connection: StatewireClient.ConnectionState\n): DeepAgentConnectionState {\n  const message =\n    'message' in connection && typeof connection.message === 'string'\n      ? sanitizeConnectionMessage(connection.message)\n      : undefined;\n  switch (connection.status) {\n    case 'standby':\n      return {\n        status: connection.status,\n        reason: connection.reason,\n        degraded: connection.degraded,\n        ...(message !== undefined && { message }),\n      };\n    case 'connecting':\n    case 'connected':\n      return { status: connection.status, degraded: connection.degraded };\n    case 'retrying':\n      return {\n        status: connection.status,\n        degraded: connection.degraded,\n        attempt: connection.attempt,\n        ...(connection.cause !== undefined && { cause: connection.cause }),\n        ...(connection.code !== undefined && { code: connection.code }),\n        ...(connection.nextRetryAt !== undefined && { nextRetryAt: connection.nextRetryAt }),\n        ...(connection.lastError !== undefined && { lastError: connection.lastError }),\n        ...(message !== undefined && { message }),\n      };\n    case 'stopped':\n      return {\n        status: connection.status,\n        degraded: connection.degraded,\n        reason: connection.reason,\n        ...(connection.payload !== undefined && { payload: connection.payload }),\n        ...(message !== undefined && { message }),\n      };\n    default:\n      return unknownConnectionStatus(connection);\n  }\n}\n\n/** Compile-time exhaustiveness: reachable only when the library grows a status this build does not project. */\nfunction unknownConnectionStatus(connection: never): never {\n  throw new Error(\n    `statewire: unknown connection status ${JSON.stringify(\n      (connection as { status?: unknown }).status\n    )}`\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/agent-runtime/src/messages.cjs

@@ -33,7 +33,8 @@ class DeepAgentMessageConversionCache {
   /**
    * Convert one pass's LangChain messages. Returns the previous pass's array
    * itself when every converted message is unchanged, so a packet that moved
-   * no message re-renders no message; a re-converted turn keeps the previous
+   * no message re-renders no message; a re-converted turn keeps the row key
+   * of the row it continues (see {@link deepAgentRowKey}) and the previous
    * pass's part objects for the parts that did not change
    * (see {@link keepUnchangedParts}).
    */
@@ -70,36 +71,94 @@ function sameMessagePart(previous, next) {
   }
   return true;
 }
+const ROW_KEY = Symbol.for("@athenaintel/agent-runtime/row-key");
+function deepAgentRowKey(message) {
+  const key = Reflect.get(message, ROW_KEY);
+  return typeof key === "string" ? key : message.id;
+}
 function keepUnchangedParts({
   previous,
   previousConverted,
   converted
 }) {
   let previousByConverted = null;
+  let previousBySource = null;
   let previousById = null;
+  let rowIds = null;
+  const continuedKeys = /* @__PURE__ */ new Set();
+  const continuedRow = (message, index) => {
+    const atIndex = previous[index];
+    if ((atIndex == null ? void 0 : atIndex.id) === message.id) return atIndex;
+    previousBySource ?? (previousBySource = rowsBySourceMessage(previous));
+    for (const source of core.getExternalStoreMessages(message)) {
+      const row = previousBySource.get(source);
+      if (row !== void 0) return row;
+    }
+    previousById ?? (previousById = new Map(previous.map((row) => [row.id, row])));
+    return previousById.get(message.id);
+  };
   return converted.map((message, index) => {
     if (message === previousConverted[index]) return previous[index] ?? message;
     previousByConverted ?? (previousByConverted = new Map(
-      previousConverted.map((row, rowIndex) => [row, previous[rowIndex] ?? row])
+      previousConverted.map((row2, rowIndex) => [row2, previous[rowIndex] ?? row2])
     ));
     const unchanged = previousByConverted.get(message);
     if (unchanged !== void 0) return unchanged;
-    let before = previous[index];
-    if ((before == null ? void 0 : before.id) !== message.id) {
-      previousById ?? (previousById = new Map(previous.map((row) => [row.id, row])));
-      before = previousById.get(message.id);
+    const before = continuedRow(message, index);
+    const row = (before == null ? void 0 : before.role) === "assistant" && message.role === "assistant" ? withUnchangedParts({ before, message }) : message;
+    const key = before === void 0 ? message.id : deepAgentRowKey(before);
+    if (key === message.id) return row;
+    rowIds ?? (rowIds = new Set(converted.map((candidate) => candidate.id)));
+    if (rowIds.has(key) || continuedKeys.has(key)) return row;
+    continuedKeys.add(key);
+    const keyed = { ...row };
+    Reflect.set(keyed, ROW_KEY, key);
+    return keyed;
+  });
+}
+function rowsBySourceMessage(rows) {
+  const bySource = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    for (const source of core.getExternalStoreMessages(row)) {
+      if (!bySource.has(source)) bySource.set(source, row);
+    }
+  }
+  return bySource;
+}
+function withUnchangedParts({
+  before,
+  message
+}) {
+  const toolCalls = /* @__PURE__ */ new Map();
+  const bySource = /* @__PURE__ */ new Map();
+  for (const part of before.content) {
+    if (part.type === "tool-call") {
+      toolCalls.set(part.toolCallId, part);
+      continue;
+    }
+    const source = core.getExternalStoreMessages(part)[0];
+    const parts = bySource.get(source);
+    if (parts === void 0) bySource.set(source, [part]);
+    else parts.push(part);
+  }
+  const placesBySource = /* @__PURE__ */ new Map();
+  let kept = 0;
+  const content = message.content.map((part) => {
+    var _a;
+    let candidate;
+    if (part.type === "tool-call") {
+      candidate = toolCalls.get(part.toolCallId);
+    } else {
+      const source = core.getExternalStoreMessages(part)[0];
+      const place = placesBySource.get(source) ?? 0;
+      placesBySource.set(source, place + 1);
+      candidate = (_a = bySource.get(source)) == null ? void 0 : _a[place];
     }
-    if ((before == null ? void 0 : before.role) !== "assistant" || message.role !== "assistant") return message;
-    const beforeContent = before.content;
-    let kept = 0;
-    const content = message.content.map((part, partIndex) => {
-      const candidate = beforeContent[partIndex];
-      if (candidate === void 0 || !sameMessagePart(candidate, part)) return part;
-      kept += 1;
-      return candidate;
-    });
-    return kept === 0 ? message : { ...message, content };
+    if (candidate === void 0 || !sameMessagePart(candidate, part)) return part;
+    kept += 1;
+    return candidate;
   });
+  return kept === 0 ? message : { ...message, content };
 }
 function createDeepAgentMessageConversionCache() {
   return new DeepAgentMessageConversionCache();
@@ -594,6 +653,7 @@ exports.PENDING_ASSISTANT_MESSAGE_ID = PENDING_ASSISTANT_MESSAGE_ID;
 exports.convertDeepAgentState = convertDeepAgentState;
 exports.createDeepAgentMaterialize = createDeepAgentMaterialize;
 exports.createDeepAgentMessageConversionCache = createDeepAgentMessageConversionCache;
+exports.deepAgentRowKey = deepAgentRowKey;
 exports.isConvertibleChatMessage = isConvertibleChatMessage;
 exports.isLangGraphState = isLangGraphState;
 exports.isMessageHiddenFromFrontend = isMessageHiddenFromFrontend;