@athenaintel/react 0.19.0 → 0.20.0

package/dist/packages/agent-runtime/src/protocol.cjs

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const runconfigContract = require("./generated/runconfig-contract.cjs");
+const isContractVersion = (value) => typeof value === "number" && Number.isInteger(value) && value >= 1;
+function readDeepAgentProtocol(state) {
+  if (typeof state !== "object" || state === null) return null;
+  const lane = state[runconfigContract.DEEP_AGENT_PROTOCOL_STATE_KEY];
+  if (typeof lane !== "object" || lane === null) return null;
+  const { version, minClientVersion } = lane;
+  if (!isContractVersion(version) || !isContractVersion(minClientVersion)) return null;
+  return { version, minClientVersion };
+}
+function projectDeepAgentProtocol(state) {
+  const lane = readDeepAgentProtocol(state);
+  if (lane === null) return null;
+  return {
+    protocolVersion: lane.version,
+    minClientVersion: lane.minClientVersion,
+    clientVersion: runconfigContract.DEEP_AGENT_PROTOCOL_VERSION,
+    serverRequiresUpgrade: lane.minClientVersion > runconfigContract.DEEP_AGENT_PROTOCOL_VERSION
+  };
+}
+function withDeclaredProtocolVersion(headers) {
+  if (runconfigContract.DEEP_AGENT_PROTOCOL_VERSION_HEADER in headers) return headers;
+  return {
+    ...headers,
+    [runconfigContract.DEEP_AGENT_PROTOCOL_VERSION_HEADER]: String(runconfigContract.DEEP_AGENT_PROTOCOL_VERSION)
+  };
+}
+exports.projectDeepAgentProtocol = projectDeepAgentProtocol;
+exports.readDeepAgentProtocol = readDeepAgentProtocol;
+exports.withDeclaredProtocolVersion = withDeclaredProtocolVersion;
+//# sourceMappingURL=protocol.cjs.map

package/dist/packages/agent-runtime/src/protocol.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.cjs","sources":["../../../../../agent-runtime/src/protocol.ts"],"sourcesContent":["import { statewireRejectionPayload } from './errors';\nimport {\n  DEEP_AGENT_PROTOCOL_STATE_KEY,\n  DEEP_AGENT_PROTOCOL_VERSION,\n  DEEP_AGENT_PROTOCOL_VERSION_HEADER,\n} from './generated/runconfig-contract';\n\n/**\n * Wire-contract version negotiation between the deep-agent statewire host and\n * this client build (the client half of agora's\n * `agora/graphs/athena_deep_agent/protocol_version.py`; upstream ask\n * assistant-ui/statewire #31506 would make this a library concern).\n *\n * - Declaration: {@link withDeclaredProtocolVersion} stamps the version this\n *   build speaks (`DEEP_AGENT_PROTOCOL_VERSION`, generated from the Python\n *   source of truth) onto the attach headers — they ride the first WS frame's\n *   mandatory `headers` field / the SSE request headers, so no statewire\n *   change is needed.\n * - Advertisement: the host publishes `{version, minClientVersion}` under the\n *   `protocol` state key in every attach snapshot;\n *   {@link readDeepAgentProtocol} / {@link projectDeepAgentProtocol} read it.\n *\n * Skew-tolerant on both sides: an old server advertises nothing (project\n * `null`, gate nothing), and a malformed lane reads as absent — the\n * negotiation must never brick a client that could otherwise talk.\n */\nexport interface DeepAgentWireProtocol {\n  /** The wire-contract version the server speaks. */\n  version: number;\n  /** The oldest declared client version the server accepts commands from. */\n  minClientVersion: number;\n}\n\n/** The negotiation result a host surface renders (\"update required\"). */\nexport interface DeepAgentProtocolStatus {\n  /** Server-advertised current contract version. */\n  protocolVersion: number;\n  /** Server-advertised minimum accepted client version. */\n  minClientVersion: number;\n  /** The contract version THIS client build declares. */\n  clientVersion: number;\n  /**\n   * True when the server's minimum exceeds this build's version: the server\n   * will answer commands with the structured `client_version_unsupported`\n   * rejection (426, `detail.required`/`detail.advertised`), so the host\n   * should surface an update affordance instead of letting sends fail.\n   */\n  serverRequiresUpgrade: boolean;\n}\n\nconst isContractVersion = (value: unknown): value is number =>\n  typeof value === 'number' && Number.isInteger(value) && value >= 1;\n\n/**\n * The server-advertised version lane off a raw statewire state, or `null`\n * while it is unreadable — pre-attach, a pre-negotiation server's snapshot\n * (no lane), or a malformed lane (tolerated as absent, never thrown on).\n */\nexport function readDeepAgentProtocol(state: unknown): DeepAgentWireProtocol | null {\n  if (typeof state !== 'object' || state === null) return null;\n  const lane = (state as Record<string, unknown>)[DEEP_AGENT_PROTOCOL_STATE_KEY];\n  if (typeof lane !== 'object' || lane === null) return null;\n  const { version, minClientVersion } = lane as Record<string, unknown>;\n  if (!isContractVersion(version) || !isContractVersion(minClientVersion)) return null;\n  return { version, minClientVersion };\n}\n\n/**\n * Project the negotiation status for a host surface, or `null` while the\n * server has not advertised (see {@link readDeepAgentProtocol}). Pure and\n * selector-safe, mirroring `readSessionPersisted`.\n */\nexport function projectDeepAgentProtocol(state: unknown): DeepAgentProtocolStatus | null {\n  const lane = readDeepAgentProtocol(state);\n  if (lane === null) return null;\n  return {\n    protocolVersion: lane.version,\n    minClientVersion: lane.minClientVersion,\n    clientVersion: DEEP_AGENT_PROTOCOL_VERSION,\n    serverRequiresUpgrade: lane.minClientVersion > DEEP_AGENT_PROTOCOL_VERSION,\n  };\n}\n\n/**\n * Attach headers with this build's contract version declared. Applied by\n * `useDeepAgentThread` to every resolved header set, so all surfaces declare\n * without per-host wiring; an explicit entry (tests, forced overrides) wins.\n */\nexport function withDeclaredProtocolVersion(\n  headers: Record<string, string>\n): Record<string, string> {\n  if (DEEP_AGENT_PROTOCOL_VERSION_HEADER in headers) return headers;\n  return {\n    ...headers,\n    [DEEP_AGENT_PROTOCOL_VERSION_HEADER]: String(DEEP_AGENT_PROTOCOL_VERSION),\n  };\n}\n\n/**\n * Whether a rejected command was refused by the server's wire-contract\n * version gate — the structured 426 `client_version_unsupported` envelope\n * (raised for a declared-below-minimum build, or for an undeclared one once\n * the server's fail-closed ratchet is on).\n *\n * This is the reactive counterpart of {@link projectDeepAgentProtocol}: the\n * advertised state lane warns proactively, but a ratchet that lands\n * mid-session (or a snapshot the surface never projected) still answers the\n * next command with this rejection — hosts route it to their \"update\n * required\" affordance instead of a generic send failure.\n */\nexport function isClientVersionUnsupportedRejection(error: unknown): boolean {\n  const payload = statewireRejectionPayload(error);\n  if (payload?.status !== 426) return false;\n  const detail = payload.detail as { code?: unknown } | undefined;\n  return detail?.code === 'client_version_unsupported';\n}\n"],"names":["DEEP_AGENT_PROTOCOL_STATE_KEY","DEEP_AGENT_PROTOCOL_VERSION","DEEP_AGENT_PROTOCOL_VERSION_HEADER"],"mappings":";;;AAkDA,MAAM,oBAAoB,CAAC,UACzB,OAAO,UAAU,YAAY,OAAO,UAAU,KAAK,KAAK,SAAS;AAO5D,SAAS,sBAAsB,OAA8C;AAClF,MAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;AACxD,QAAM,OAAQ,MAAkCA,+CAA6B;AAC7E,MAAI,OAAO,SAAS,YAAY,SAAS,KAAM,QAAO;AACtD,QAAM,EAAE,SAAS,iBAAA,IAAqB;AACtC,MAAI,CAAC,kBAAkB,OAAO,KAAK,CAAC,kBAAkB,gBAAgB,EAAG,QAAO;AAChF,SAAO,EAAE,SAAS,iBAAA;AACpB;AAOO,SAAS,yBAAyB,OAAgD;AACvF,QAAM,OAAO,sBAAsB,KAAK;AACxC,MAAI,SAAS,KAAM,QAAO;AAC1B,SAAO;AAAA,IACL,iBAAiB,KAAK;AAAA,IACtB,kBAAkB,KAAK;AAAA,IACvB,eAAeC,kBAAAA;AAAAA,IACf,uBAAuB,KAAK,mBAAmBA,kBAAAA;AAAAA,EAAA;AAEnD;AAOO,SAAS,4BACd,SACwB;AACxB,MAAIC,kBAAAA,sCAAsC,QAAS,QAAO;AAC1D,SAAO;AAAA,IACL,GAAG;AAAA,IACH,CAACA,kBAAAA,kCAAkC,GAAG,OAAOD,kBAAAA,2BAA2B;AAAA,EAAA;AAE5E;;;;"}

package/dist/packages/agent-runtime/src/protocol.js

@@ -0,0 +1,33 @@
+import { DEEP_AGENT_PROTOCOL_VERSION, DEEP_AGENT_PROTOCOL_STATE_KEY, DEEP_AGENT_PROTOCOL_VERSION_HEADER } from "./generated/runconfig-contract.js";
+const isContractVersion = (value) => typeof value === "number" && Number.isInteger(value) && value >= 1;
+function readDeepAgentProtocol(state) {
+  if (typeof state !== "object" || state === null) return null;
+  const lane = state[DEEP_AGENT_PROTOCOL_STATE_KEY];
+  if (typeof lane !== "object" || lane === null) return null;
+  const { version, minClientVersion } = lane;
+  if (!isContractVersion(version) || !isContractVersion(minClientVersion)) return null;
+  return { version, minClientVersion };
+}
+function projectDeepAgentProtocol(state) {
+  const lane = readDeepAgentProtocol(state);
+  if (lane === null) return null;
+  return {
+    protocolVersion: lane.version,
+    minClientVersion: lane.minClientVersion,
+    clientVersion: DEEP_AGENT_PROTOCOL_VERSION,
+    serverRequiresUpgrade: lane.minClientVersion > DEEP_AGENT_PROTOCOL_VERSION
+  };
+}
+function withDeclaredProtocolVersion(headers) {
+  if (DEEP_AGENT_PROTOCOL_VERSION_HEADER in headers) return headers;
+  return {
+    ...headers,
+    [DEEP_AGENT_PROTOCOL_VERSION_HEADER]: String(DEEP_AGENT_PROTOCOL_VERSION)
+  };
+}
+export {
+  projectDeepAgentProtocol,
+  readDeepAgentProtocol,
+  withDeclaredProtocolVersion
+};
+//# sourceMappingURL=protocol.js.map

package/dist/packages/agent-runtime/src/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sources":["../../../../../agent-runtime/src/protocol.ts"],"sourcesContent":["import { statewireRejectionPayload } from './errors';\nimport {\n  DEEP_AGENT_PROTOCOL_STATE_KEY,\n  DEEP_AGENT_PROTOCOL_VERSION,\n  DEEP_AGENT_PROTOCOL_VERSION_HEADER,\n} from './generated/runconfig-contract';\n\n/**\n * Wire-contract version negotiation between the deep-agent statewire host and\n * this client build (the client half of agora's\n * `agora/graphs/athena_deep_agent/protocol_version.py`; upstream ask\n * assistant-ui/statewire #31506 would make this a library concern).\n *\n * - Declaration: {@link withDeclaredProtocolVersion} stamps the version this\n *   build speaks (`DEEP_AGENT_PROTOCOL_VERSION`, generated from the Python\n *   source of truth) onto the attach headers — they ride the first WS frame's\n *   mandatory `headers` field / the SSE request headers, so no statewire\n *   change is needed.\n * - Advertisement: the host publishes `{version, minClientVersion}` under the\n *   `protocol` state key in every attach snapshot;\n *   {@link readDeepAgentProtocol} / {@link projectDeepAgentProtocol} read it.\n *\n * Skew-tolerant on both sides: an old server advertises nothing (project\n * `null`, gate nothing), and a malformed lane reads as absent — the\n * negotiation must never brick a client that could otherwise talk.\n */\nexport interface DeepAgentWireProtocol {\n  /** The wire-contract version the server speaks. */\n  version: number;\n  /** The oldest declared client version the server accepts commands from. */\n  minClientVersion: number;\n}\n\n/** The negotiation result a host surface renders (\"update required\"). */\nexport interface DeepAgentProtocolStatus {\n  /** Server-advertised current contract version. */\n  protocolVersion: number;\n  /** Server-advertised minimum accepted client version. */\n  minClientVersion: number;\n  /** The contract version THIS client build declares. */\n  clientVersion: number;\n  /**\n   * True when the server's minimum exceeds this build's version: the server\n   * will answer commands with the structured `client_version_unsupported`\n   * rejection (426, `detail.required`/`detail.advertised`), so the host\n   * should surface an update affordance instead of letting sends fail.\n   */\n  serverRequiresUpgrade: boolean;\n}\n\nconst isContractVersion = (value: unknown): value is number =>\n  typeof value === 'number' && Number.isInteger(value) && value >= 1;\n\n/**\n * The server-advertised version lane off a raw statewire state, or `null`\n * while it is unreadable — pre-attach, a pre-negotiation server's snapshot\n * (no lane), or a malformed lane (tolerated as absent, never thrown on).\n */\nexport function readDeepAgentProtocol(state: unknown): DeepAgentWireProtocol | null {\n  if (typeof state !== 'object' || state === null) return null;\n  const lane = (state as Record<string, unknown>)[DEEP_AGENT_PROTOCOL_STATE_KEY];\n  if (typeof lane !== 'object' || lane === null) return null;\n  const { version, minClientVersion } = lane as Record<string, unknown>;\n  if (!isContractVersion(version) || !isContractVersion(minClientVersion)) return null;\n  return { version, minClientVersion };\n}\n\n/**\n * Project the negotiation status for a host surface, or `null` while the\n * server has not advertised (see {@link readDeepAgentProtocol}). Pure and\n * selector-safe, mirroring `readSessionPersisted`.\n */\nexport function projectDeepAgentProtocol(state: unknown): DeepAgentProtocolStatus | null {\n  const lane = readDeepAgentProtocol(state);\n  if (lane === null) return null;\n  return {\n    protocolVersion: lane.version,\n    minClientVersion: lane.minClientVersion,\n    clientVersion: DEEP_AGENT_PROTOCOL_VERSION,\n    serverRequiresUpgrade: lane.minClientVersion > DEEP_AGENT_PROTOCOL_VERSION,\n  };\n}\n\n/**\n * Attach headers with this build's contract version declared. Applied by\n * `useDeepAgentThread` to every resolved header set, so all surfaces declare\n * without per-host wiring; an explicit entry (tests, forced overrides) wins.\n */\nexport function withDeclaredProtocolVersion(\n  headers: Record<string, string>\n): Record<string, string> {\n  if (DEEP_AGENT_PROTOCOL_VERSION_HEADER in headers) return headers;\n  return {\n    ...headers,\n    [DEEP_AGENT_PROTOCOL_VERSION_HEADER]: String(DEEP_AGENT_PROTOCOL_VERSION),\n  };\n}\n\n/**\n * Whether a rejected command was refused by the server's wire-contract\n * version gate — the structured 426 `client_version_unsupported` envelope\n * (raised for a declared-below-minimum build, or for an undeclared one once\n * the server's fail-closed ratchet is on).\n *\n * This is the reactive counterpart of {@link projectDeepAgentProtocol}: the\n * advertised state lane warns proactively, but a ratchet that lands\n * mid-session (or a snapshot the surface never projected) still answers the\n * next command with this rejection — hosts route it to their \"update\n * required\" affordance instead of a generic send failure.\n */\nexport function isClientVersionUnsupportedRejection(error: unknown): boolean {\n  const payload = statewireRejectionPayload(error);\n  if (payload?.status !== 426) return false;\n  const detail = payload.detail as { code?: unknown } | undefined;\n  return detail?.code === 'client_version_unsupported';\n}\n"],"names":[],"mappings":";AAkDA,MAAM,oBAAoB,CAAC,UACzB,OAAO,UAAU,YAAY,OAAO,UAAU,KAAK,KAAK,SAAS;AAO5D,SAAS,sBAAsB,OAA8C;AAClF,MAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;AACxD,QAAM,OAAQ,MAAkC,6BAA6B;AAC7E,MAAI,OAAO,SAAS,YAAY,SAAS,KAAM,QAAO;AACtD,QAAM,EAAE,SAAS,iBAAA,IAAqB;AACtC,MAAI,CAAC,kBAAkB,OAAO,KAAK,CAAC,kBAAkB,gBAAgB,EAAG,QAAO;AAChF,SAAO,EAAE,SAAS,iBAAA;AACpB;AAOO,SAAS,yBAAyB,OAAgD;AACvF,QAAM,OAAO,sBAAsB,KAAK;AACxC,MAAI,SAAS,KAAM,QAAO;AAC1B,SAAO;AAAA,IACL,iBAAiB,KAAK;AAAA,IACtB,kBAAkB,KAAK;AAAA,IACvB,eAAe;AAAA,IACf,uBAAuB,KAAK,mBAAmB;AAAA,EAAA;AAEnD;AAOO,SAAS,4BACd,SACwB;AACxB,MAAI,sCAAsC,QAAS,QAAO;AAC1D,SAAO;AAAA,IACL,GAAG;AAAA,IACH,CAAC,kCAAkC,GAAG,OAAO,2BAA2B;AAAA,EAAA;AAE5E;"}

package/dist/packages/agent-runtime/src/queue.cjs

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const messages = require("./messages.cjs");
+function queueEntryText(parts) {
+  return parts.flatMap(
+    (part) => part.type === "text" && typeof part.text === "string" ? [part.text] : []
+  ).join("\n\n");
+}
+function isQueueEntryUnsettled(entry) {
+  return entry.meta === void 0;
+}
+function readPrioritizedQueueIds(raw) {
+  return Array.isArray(raw) ? raw.filter((id) => typeof id === "string") : [];
+}
+function queueLaneFlags(status) {
+  return {
+    isRunning: status === "running",
+    isContinuable: status === "stopped" || status === "error"
+  };
+}
+function buildStatewireQueueRows(options) {
+  const { queue, steerQueue, isContinuable } = options;
+  return [
+    ...isContinuable ? steerQueue.map((item) => ({ item, lane: "steer" })) : [],
+    ...queue.map((item) => ({ item, lane: "queue" }))
+  ];
+}
+function showQueueRowSendNow(options) {
+  const { lane, index, isRunning, isContinuable } = options;
+  return lane === "queue" && (isContinuable || isRunning && index === 0);
+}
+function buildQueueEditCommand(options) {
+  const { item, lane, runId, text } = options;
+  if (!text.trim() || text === queueEntryText(item.parts) || runId === null) {
+    return null;
+  }
+  const message = {
+    id: item.id,
+    role: "user",
+    parts: [{ type: "text", text }, ...item.parts.filter((part) => part.type !== "text")],
+    ...item.metadata === void 0 ? {} : { metadata: item.metadata }
+  };
+  return lane === "steer" ? { type: "run/steer", runId, message } : { type: "run/enqueue", runId, message };
+}
+const QUEUE_AUTO_CONTINUE_DELAY_MS = 2e3;
+function userStopBlocksQueueAutoContinue(options) {
+  return options.marker === messages.ATHENA_RUN_MARKER_CANCELLED && !messages.isServerUpdateStopSource(options.source);
+}
+function describeQueueSendFailure(failure) {
+  const message = "message" in failure && failure.message !== void 0 ? `: ${failure.message}` : "";
+  return `${failure.fate} (${failure.cause})${message}`;
+}
+function isFailedSendEntryRace(error) {
+  return error instanceof Error && error.message.startsWith("statewire: unknown failed");
+}
+exports.QUEUE_AUTO_CONTINUE_DELAY_MS = QUEUE_AUTO_CONTINUE_DELAY_MS;
+exports.buildQueueEditCommand = buildQueueEditCommand;
+exports.buildStatewireQueueRows = buildStatewireQueueRows;
+exports.describeQueueSendFailure = describeQueueSendFailure;
+exports.isFailedSendEntryRace = isFailedSendEntryRace;
+exports.isQueueEntryUnsettled = isQueueEntryUnsettled;
+exports.queueEntryText = queueEntryText;
+exports.queueLaneFlags = queueLaneFlags;
+exports.readPrioritizedQueueIds = readPrioritizedQueueIds;
+exports.showQueueRowSendNow = showQueueRowSendNow;
+exports.userStopBlocksQueueAutoContinue = userStopBlocksQueueAutoContinue;
+//# sourceMappingURL=queue.cjs.map

package/dist/packages/agent-runtime/src/queue.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.cjs","sources":["../../../../../agent-runtime/src/queue.ts"],"sourcesContent":["/**\n * Derivations for the server-owned statewire queue and steer lanes, shared by\n * every queued-messages tray (Olympus, the React SDK, the Chrome extension).\n *\n * The queue is SERVER-owned: statewire surfaces it on the runs projection.\n * \"Send now\" moves an item into the steer lane (`run/steer` — the host stops\n * the run and dispatches it once the run settles; on a stopped/errored thread\n * the same move dispatches immediately as a stop-/error-continue run) and\n * remove issues `run/dequeue`. While the thread rests stopped/errored,\n * stranded steer-lane entries list ahead of the queue — they dispatch first,\n * as one batch, so they carry Remove but no per-row Send now.\n *\n * Pure helpers only: the host component reads `useStatewireRuns()` and\n * `useDeepAgentThreadStatus()` itself (both mockable per surface) and passes\n * the values in.\n */\n\nimport type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { ATHENA_RUN_MARKER_CANCELLED, isServerUpdateStopSource } from './messages';\nimport type { DeepAgentThreadStatus } from './thread-status';\n\n/** The text content of a queued entry (non-text parts render as fallbacks). */\nexport function queueEntryText(\n  parts: readonly { type: string; text?: string }[],\n): string {\n  return parts\n    .flatMap((part) =>\n      part.type === 'text' && typeof part.text === 'string' ? [part.text] : [],\n    )\n    .join('\\n\\n');\n}\n\n/**\n * Whether a lane entry is still awaiting its send's settle: the host stamps\n * `meta` on every entry it admits (`_op_meta` — submitter and contextSync\n * snapshot), so a meta-less entry is this client's own optimistic fold. The\n * send is still in flight and can still be refused (billing gate, auth,\n * reconnect), which the tray must not render as an accepted queue position.\n */\nexport function isQueueEntryUnsettled(entry: StatewireThread.RunsQueueEntry): boolean {\n  return entry.meta === undefined;\n}\n\n/**\n * The ids of queued entries the user prioritized (⚡ — `run/prioritize`), as\n * the host records them in its durable `prioritizedQueueIds` state. A\n * prioritized entry heads the queue lane and the live run ends at its next\n * model-call boundary to deliver it, so trays render these rows lit and offer\n * \"Remove priority\" instead of \"Prioritize\". Tolerates the key being absent\n * (a thread that never prioritized, a pre-feature host) and ignores anything\n * that is not a string id.\n */\nexport function readPrioritizedQueueIds(raw: unknown): readonly string[] {\n  return Array.isArray(raw)\n    ? raw.filter((id): id is string => typeof id === 'string')\n    : [];\n}\n\nexport interface QueueLaneFlags {\n  isRunning: boolean;\n  /** A stopped/errored thread can continue with its queued work. */\n  isContinuable: boolean;\n}\n\n/** The thread-status split every queue tray keys its affordances on. */\nexport function queueLaneFlags(status: DeepAgentThreadStatus): QueueLaneFlags {\n  return {\n    isRunning: status === 'running',\n    isContinuable: status === 'stopped' || status === 'error',\n  };\n}\n\nexport interface StatewireQueueRow {\n  item: StatewireThread.RunsQueueEntry;\n  lane: 'queue' | 'steer';\n}\n\n/**\n * The rows a queue tray renders, in dispatch order: stranded steer-lane\n * entries first (only while the thread rests continuable — during a run they\n * already render in the message list), then the queue lane.\n */\nexport function buildStatewireQueueRows(options: {\n  queue: readonly StatewireThread.RunsQueueEntry[];\n  steerQueue: readonly StatewireThread.RunsQueueEntry[];\n  isContinuable: boolean;\n}): StatewireQueueRow[] {\n  const { queue, steerQueue, isContinuable } = options;\n  return [\n    ...(isContinuable\n      ? steerQueue.map((item) => ({ item, lane: 'steer' as const }))\n      : []),\n    ...queue.map((item) => ({ item, lane: 'queue' as const })),\n  ];\n}\n\n/**\n * Whether a row offers \"Send now\": queue-lane rows only (steer entries already\n * dispatch first), every row while the thread rests continuable, and only the\n * head row while a run is live (later rows would jump the queue order).\n */\nexport function showQueueRowSendNow(options: {\n  lane: 'queue' | 'steer';\n  index: number;\n  isRunning: boolean;\n  isContinuable: boolean;\n}): boolean {\n  const { lane, index, isRunning, isContinuable } = options;\n  return lane === 'queue' && (isContinuable || (isRunning && index === 0));\n}\n\nexport type QueueEditCommand =\n  | { type: 'run/steer'; runId: string; message: StatewireThread.UserMessage }\n  | { type: 'run/enqueue'; runId: string; message: StatewireThread.UserMessage };\n\n/**\n * Re-send a queued entry under its own id on its own lane with edited text:\n * the host replaces the queued message's content in place, leaving its queue\n * position and lane untouched (a same-id send never dispatches). The built-in\n * queue client has no update command, so this goes straight to the runs\n * protocol. Returns `null` when there is nothing to send — blank or unchanged\n * text, or no live run entry to address.\n */\nexport function buildQueueEditCommand(options: {\n  item: StatewireThread.RunsQueueEntry;\n  lane: 'queue' | 'steer';\n  runId: string | null;\n  text: string;\n}): QueueEditCommand | null {\n  const { item, lane, runId, text } = options;\n  if (!text.trim() || text === queueEntryText(item.parts) || runId === null) {\n    return null;\n  }\n  const message: StatewireThread.UserMessage = {\n    id: item.id,\n    role: 'user',\n    parts: [{ type: 'text', text }, ...item.parts.filter((part) => part.type !== 'text')],\n    ...(item.metadata === undefined ? {} : { metadata: item.metadata }),\n  };\n  return lane === 'steer'\n    ? { type: 'run/steer', runId, message }\n    : { type: 'run/enqueue', runId, message };\n}\n\n/**\n * Grace between observing a stranded settle and auto-promoting the queue\n * head — long enough for the host's own settle bookkeeping (or a status flap\n * during reconnect) to resolve first, short enough to read as \"it just\n * continued\" rather than \"it hung\".\n */\nexport const QUEUE_AUTO_CONTINUE_DELAY_MS = 2_000;\n\n/** Whether the last cancellation marker records a user or client stop. */\nexport function userStopBlocksQueueAutoContinue(options: {\n  marker: string | undefined;\n  source: string | undefined;\n}): boolean {\n  return (\n    options.marker === ATHENA_RUN_MARKER_CANCELLED && !isServerUpdateStopSource(options.source)\n  );\n}\n\n/** `fate (cause)[: message]` — the detail a failed-send row carries. */\nexport function describeQueueSendFailure(\n  failure: StatewireThread.RunsFailedEntry['sendFailure'],\n): string {\n  const message =\n    'message' in failure && failure.message !== undefined ? `: ${failure.message}` : '';\n  return `${failure.fate} (${failure.cause})${message}`;\n}\n\n/**\n * Whether a `retryFailed` / `discardFailed` throw is the covered drop race:\n * statewire drops a failed entry on its own as soon as a canonical update\n * shows the message landed, and acting on a just-dropped entry throws. Both\n * the session record (\"unknown failed command\") and the adapter's projection\n * (\"unknown failed entry\") use this prefix. Nothing is lost in that race — the\n * message already made it and the row is about to disappear — so a tray\n * swallows it (keeping telemetry) instead of crashing the click handler.\n */\nexport function isFailedSendEntryRace(error: unknown): boolean {\n  return error instanceof Error && error.message.startsWith('statewire: unknown failed');\n}\n"],"names":["ATHENA_RUN_MARKER_CANCELLED","isServerUpdateStopSource"],"mappings":";;;AAsBO,SAAS,eACd,OACQ;AACR,SAAO,MACJ;AAAA,IAAQ,CAAC,SACR,KAAK,SAAS,UAAU,OAAO,KAAK,SAAS,WAAW,CAAC,KAAK,IAAI,IAAI,CAAA;AAAA,EAAC,EAExE,KAAK,MAAM;AAChB;AASO,SAAS,sBAAsB,OAAgD;AACpF,SAAO,MAAM,SAAS;AACxB;AAWO,SAAS,wBAAwB,KAAiC;AACvE,SAAO,MAAM,QAAQ,GAAG,IACpB,IAAI,OAAO,CAAC,OAAqB,OAAO,OAAO,QAAQ,IACvD,CAAA;AACN;AASO,SAAS,eAAe,QAA+C;AAC5E,SAAO;AAAA,IACL,WAAW,WAAW;AAAA,IACtB,eAAe,WAAW,aAAa,WAAW;AAAA,EAAA;AAEtD;AAYO,SAAS,wBAAwB,SAIhB;AACtB,QAAM,EAAE,OAAO,YAAY,cAAA,IAAkB;AAC7C,SAAO;AAAA,IACL,GAAI,gBACA,WAAW,IAAI,CAAC,UAAU,EAAE,MAAM,MAAM,UAAmB,IAC3D,CAAA;AAAA,IACJ,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,MAAM,MAAM,UAAmB;AAAA,EAAA;AAE7D;AAOO,SAAS,oBAAoB,SAKxB;AACV,QAAM,EAAE,MAAM,OAAO,WAAW,kBAAkB;AAClD,SAAO,SAAS,YAAY,iBAAkB,aAAa,UAAU;AACvE;AAcO,SAAS,sBAAsB,SAKV;AAC1B,QAAM,EAAE,MAAM,MAAM,OAAO,SAAS;AACpC,MAAI,CAAC,KAAK,KAAA,KAAU,SAAS,eAAe,KAAK,KAAK,KAAK,UAAU,MAAM;AACzE,WAAO;AAAA,EACT;AACA,QAAM,UAAuC;AAAA,IAC3C,IAAI,KAAK;AAAA,IACT,MAAM;AAAA,IACN,OAAO,CAAC,EAAE,MAAM,QAAQ,QAAQ,GAAG,KAAK,MAAM,OAAO,CAAC,SAAS,KAAK,SAAS,MAAM,CAAC;AAAA,IACpF,GAAI,KAAK,aAAa,SAAY,CAAA,IAAK,EAAE,UAAU,KAAK,SAAA;AAAA,EAAS;AAEnE,SAAO,SAAS,UACZ,EAAE,MAAM,aAAa,OAAO,QAAA,IAC5B,EAAE,MAAM,eAAe,OAAO,QAAA;AACpC;AAQO,MAAM,+BAA+B;AAGrC,SAAS,gCAAgC,SAGpC;AACV,SACE,QAAQ,WAAWA,SAAAA,+BAA+B,CAACC,SAAAA,yBAAyB,QAAQ,MAAM;AAE9F;AAGO,SAAS,yBACd,SACQ;AACR,QAAM,UACJ,aAAa,WAAW,QAAQ,YAAY,SAAY,KAAK,QAAQ,OAAO,KAAK;AACnF,SAAO,GAAG,QAAQ,IAAI,KAAK,QAAQ,KAAK,IAAI,OAAO;AACrD;AAWO,SAAS,sBAAsB,OAAyB;AAC7D,SAAO,iBAAiB,SAAS,MAAM,QAAQ,WAAW,2BAA2B;AACvF;;;;;;;;;;;;"}

package/dist/packages/agent-runtime/src/queue.js

@@ -0,0 +1,67 @@
+import { ATHENA_RUN_MARKER_CANCELLED, isServerUpdateStopSource } from "./messages.js";
+function queueEntryText(parts) {
+  return parts.flatMap(
+    (part) => part.type === "text" && typeof part.text === "string" ? [part.text] : []
+  ).join("\n\n");
+}
+function isQueueEntryUnsettled(entry) {
+  return entry.meta === void 0;
+}
+function readPrioritizedQueueIds(raw) {
+  return Array.isArray(raw) ? raw.filter((id) => typeof id === "string") : [];
+}
+function queueLaneFlags(status) {
+  return {
+    isRunning: status === "running",
+    isContinuable: status === "stopped" || status === "error"
+  };
+}
+function buildStatewireQueueRows(options) {
+  const { queue, steerQueue, isContinuable } = options;
+  return [
+    ...isContinuable ? steerQueue.map((item) => ({ item, lane: "steer" })) : [],
+    ...queue.map((item) => ({ item, lane: "queue" }))
+  ];
+}
+function showQueueRowSendNow(options) {
+  const { lane, index, isRunning, isContinuable } = options;
+  return lane === "queue" && (isContinuable || isRunning && index === 0);
+}
+function buildQueueEditCommand(options) {
+  const { item, lane, runId, text } = options;
+  if (!text.trim() || text === queueEntryText(item.parts) || runId === null) {
+    return null;
+  }
+  const message = {
+    id: item.id,
+    role: "user",
+    parts: [{ type: "text", text }, ...item.parts.filter((part) => part.type !== "text")],
+    ...item.metadata === void 0 ? {} : { metadata: item.metadata }
+  };
+  return lane === "steer" ? { type: "run/steer", runId, message } : { type: "run/enqueue", runId, message };
+}
+const QUEUE_AUTO_CONTINUE_DELAY_MS = 2e3;
+function userStopBlocksQueueAutoContinue(options) {
+  return options.marker === ATHENA_RUN_MARKER_CANCELLED && !isServerUpdateStopSource(options.source);
+}
+function describeQueueSendFailure(failure) {
+  const message = "message" in failure && failure.message !== void 0 ? `: ${failure.message}` : "";
+  return `${failure.fate} (${failure.cause})${message}`;
+}
+function isFailedSendEntryRace(error) {
+  return error instanceof Error && error.message.startsWith("statewire: unknown failed");
+}
+export {
+  QUEUE_AUTO_CONTINUE_DELAY_MS,
+  buildQueueEditCommand,
+  buildStatewireQueueRows,
+  describeQueueSendFailure,
+  isFailedSendEntryRace,
+  isQueueEntryUnsettled,
+  queueEntryText,
+  queueLaneFlags,
+  readPrioritizedQueueIds,
+  showQueueRowSendNow,
+  userStopBlocksQueueAutoContinue
+};
+//# sourceMappingURL=queue.js.map

package/dist/packages/agent-runtime/src/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sources":["../../../../../agent-runtime/src/queue.ts"],"sourcesContent":["/**\n * Derivations for the server-owned statewire queue and steer lanes, shared by\n * every queued-messages tray (Olympus, the React SDK, the Chrome extension).\n *\n * The queue is SERVER-owned: statewire surfaces it on the runs projection.\n * \"Send now\" moves an item into the steer lane (`run/steer` — the host stops\n * the run and dispatches it once the run settles; on a stopped/errored thread\n * the same move dispatches immediately as a stop-/error-continue run) and\n * remove issues `run/dequeue`. While the thread rests stopped/errored,\n * stranded steer-lane entries list ahead of the queue — they dispatch first,\n * as one batch, so they carry Remove but no per-row Send now.\n *\n * Pure helpers only: the host component reads `useStatewireRuns()` and\n * `useDeepAgentThreadStatus()` itself (both mockable per surface) and passes\n * the values in.\n */\n\nimport type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { ATHENA_RUN_MARKER_CANCELLED, isServerUpdateStopSource } from './messages';\nimport type { DeepAgentThreadStatus } from './thread-status';\n\n/** The text content of a queued entry (non-text parts render as fallbacks). */\nexport function queueEntryText(\n  parts: readonly { type: string; text?: string }[],\n): string {\n  return parts\n    .flatMap((part) =>\n      part.type === 'text' && typeof part.text === 'string' ? [part.text] : [],\n    )\n    .join('\\n\\n');\n}\n\n/**\n * Whether a lane entry is still awaiting its send's settle: the host stamps\n * `meta` on every entry it admits (`_op_meta` — submitter and contextSync\n * snapshot), so a meta-less entry is this client's own optimistic fold. The\n * send is still in flight and can still be refused (billing gate, auth,\n * reconnect), which the tray must not render as an accepted queue position.\n */\nexport function isQueueEntryUnsettled(entry: StatewireThread.RunsQueueEntry): boolean {\n  return entry.meta === undefined;\n}\n\n/**\n * The ids of queued entries the user prioritized (⚡ — `run/prioritize`), as\n * the host records them in its durable `prioritizedQueueIds` state. A\n * prioritized entry heads the queue lane and the live run ends at its next\n * model-call boundary to deliver it, so trays render these rows lit and offer\n * \"Remove priority\" instead of \"Prioritize\". Tolerates the key being absent\n * (a thread that never prioritized, a pre-feature host) and ignores anything\n * that is not a string id.\n */\nexport function readPrioritizedQueueIds(raw: unknown): readonly string[] {\n  return Array.isArray(raw)\n    ? raw.filter((id): id is string => typeof id === 'string')\n    : [];\n}\n\nexport interface QueueLaneFlags {\n  isRunning: boolean;\n  /** A stopped/errored thread can continue with its queued work. */\n  isContinuable: boolean;\n}\n\n/** The thread-status split every queue tray keys its affordances on. */\nexport function queueLaneFlags(status: DeepAgentThreadStatus): QueueLaneFlags {\n  return {\n    isRunning: status === 'running',\n    isContinuable: status === 'stopped' || status === 'error',\n  };\n}\n\nexport interface StatewireQueueRow {\n  item: StatewireThread.RunsQueueEntry;\n  lane: 'queue' | 'steer';\n}\n\n/**\n * The rows a queue tray renders, in dispatch order: stranded steer-lane\n * entries first (only while the thread rests continuable — during a run they\n * already render in the message list), then the queue lane.\n */\nexport function buildStatewireQueueRows(options: {\n  queue: readonly StatewireThread.RunsQueueEntry[];\n  steerQueue: readonly StatewireThread.RunsQueueEntry[];\n  isContinuable: boolean;\n}): StatewireQueueRow[] {\n  const { queue, steerQueue, isContinuable } = options;\n  return [\n    ...(isContinuable\n      ? steerQueue.map((item) => ({ item, lane: 'steer' as const }))\n      : []),\n    ...queue.map((item) => ({ item, lane: 'queue' as const })),\n  ];\n}\n\n/**\n * Whether a row offers \"Send now\": queue-lane rows only (steer entries already\n * dispatch first), every row while the thread rests continuable, and only the\n * head row while a run is live (later rows would jump the queue order).\n */\nexport function showQueueRowSendNow(options: {\n  lane: 'queue' | 'steer';\n  index: number;\n  isRunning: boolean;\n  isContinuable: boolean;\n}): boolean {\n  const { lane, index, isRunning, isContinuable } = options;\n  return lane === 'queue' && (isContinuable || (isRunning && index === 0));\n}\n\nexport type QueueEditCommand =\n  | { type: 'run/steer'; runId: string; message: StatewireThread.UserMessage }\n  | { type: 'run/enqueue'; runId: string; message: StatewireThread.UserMessage };\n\n/**\n * Re-send a queued entry under its own id on its own lane with edited text:\n * the host replaces the queued message's content in place, leaving its queue\n * position and lane untouched (a same-id send never dispatches). The built-in\n * queue client has no update command, so this goes straight to the runs\n * protocol. Returns `null` when there is nothing to send — blank or unchanged\n * text, or no live run entry to address.\n */\nexport function buildQueueEditCommand(options: {\n  item: StatewireThread.RunsQueueEntry;\n  lane: 'queue' | 'steer';\n  runId: string | null;\n  text: string;\n}): QueueEditCommand | null {\n  const { item, lane, runId, text } = options;\n  if (!text.trim() || text === queueEntryText(item.parts) || runId === null) {\n    return null;\n  }\n  const message: StatewireThread.UserMessage = {\n    id: item.id,\n    role: 'user',\n    parts: [{ type: 'text', text }, ...item.parts.filter((part) => part.type !== 'text')],\n    ...(item.metadata === undefined ? {} : { metadata: item.metadata }),\n  };\n  return lane === 'steer'\n    ? { type: 'run/steer', runId, message }\n    : { type: 'run/enqueue', runId, message };\n}\n\n/**\n * Grace between observing a stranded settle and auto-promoting the queue\n * head — long enough for the host's own settle bookkeeping (or a status flap\n * during reconnect) to resolve first, short enough to read as \"it just\n * continued\" rather than \"it hung\".\n */\nexport const QUEUE_AUTO_CONTINUE_DELAY_MS = 2_000;\n\n/** Whether the last cancellation marker records a user or client stop. */\nexport function userStopBlocksQueueAutoContinue(options: {\n  marker: string | undefined;\n  source: string | undefined;\n}): boolean {\n  return (\n    options.marker === ATHENA_RUN_MARKER_CANCELLED && !isServerUpdateStopSource(options.source)\n  );\n}\n\n/** `fate (cause)[: message]` — the detail a failed-send row carries. */\nexport function describeQueueSendFailure(\n  failure: StatewireThread.RunsFailedEntry['sendFailure'],\n): string {\n  const message =\n    'message' in failure && failure.message !== undefined ? `: ${failure.message}` : '';\n  return `${failure.fate} (${failure.cause})${message}`;\n}\n\n/**\n * Whether a `retryFailed` / `discardFailed` throw is the covered drop race:\n * statewire drops a failed entry on its own as soon as a canonical update\n * shows the message landed, and acting on a just-dropped entry throws. Both\n * the session record (\"unknown failed command\") and the adapter's projection\n * (\"unknown failed entry\") use this prefix. Nothing is lost in that race — the\n * message already made it and the row is about to disappear — so a tray\n * swallows it (keeping telemetry) instead of crashing the click handler.\n */\nexport function isFailedSendEntryRace(error: unknown): boolean {\n  return error instanceof Error && error.message.startsWith('statewire: unknown failed');\n}\n"],"names":[],"mappings":";AAsBO,SAAS,eACd,OACQ;AACR,SAAO,MACJ;AAAA,IAAQ,CAAC,SACR,KAAK,SAAS,UAAU,OAAO,KAAK,SAAS,WAAW,CAAC,KAAK,IAAI,IAAI,CAAA;AAAA,EAAC,EAExE,KAAK,MAAM;AAChB;AASO,SAAS,sBAAsB,OAAgD;AACpF,SAAO,MAAM,SAAS;AACxB;AAWO,SAAS,wBAAwB,KAAiC;AACvE,SAAO,MAAM,QAAQ,GAAG,IACpB,IAAI,OAAO,CAAC,OAAqB,OAAO,OAAO,QAAQ,IACvD,CAAA;AACN;AASO,SAAS,eAAe,QAA+C;AAC5E,SAAO;AAAA,IACL,WAAW,WAAW;AAAA,IACtB,eAAe,WAAW,aAAa,WAAW;AAAA,EAAA;AAEtD;AAYO,SAAS,wBAAwB,SAIhB;AACtB,QAAM,EAAE,OAAO,YAAY,cAAA,IAAkB;AAC7C,SAAO;AAAA,IACL,GAAI,gBACA,WAAW,IAAI,CAAC,UAAU,EAAE,MAAM,MAAM,UAAmB,IAC3D,CAAA;AAAA,IACJ,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,MAAM,MAAM,UAAmB;AAAA,EAAA;AAE7D;AAOO,SAAS,oBAAoB,SAKxB;AACV,QAAM,EAAE,MAAM,OAAO,WAAW,kBAAkB;AAClD,SAAO,SAAS,YAAY,iBAAkB,aAAa,UAAU;AACvE;AAcO,SAAS,sBAAsB,SAKV;AAC1B,QAAM,EAAE,MAAM,MAAM,OAAO,SAAS;AACpC,MAAI,CAAC,KAAK,KAAA,KAAU,SAAS,eAAe,KAAK,KAAK,KAAK,UAAU,MAAM;AACzE,WAAO;AAAA,EACT;AACA,QAAM,UAAuC;AAAA,IAC3C,IAAI,KAAK;AAAA,IACT,MAAM;AAAA,IACN,OAAO,CAAC,EAAE,MAAM,QAAQ,QAAQ,GAAG,KAAK,MAAM,OAAO,CAAC,SAAS,KAAK,SAAS,MAAM,CAAC;AAAA,IACpF,GAAI,KAAK,aAAa,SAAY,CAAA,IAAK,EAAE,UAAU,KAAK,SAAA;AAAA,EAAS;AAEnE,SAAO,SAAS,UACZ,EAAE,MAAM,aAAa,OAAO,QAAA,IAC5B,EAAE,MAAM,eAAe,OAAO,QAAA;AACpC;AAQO,MAAM,+BAA+B;AAGrC,SAAS,gCAAgC,SAGpC;AACV,SACE,QAAQ,WAAW,+BAA+B,CAAC,yBAAyB,QAAQ,MAAM;AAE9F;AAGO,SAAS,yBACd,SACQ;AACR,QAAM,UACJ,aAAa,WAAW,QAAQ,YAAY,SAAY,KAAK,QAAQ,OAAO,KAAK;AACnF,SAAO,GAAG,QAAQ,IAAI,KAAK,QAAQ,KAAK,IAAI,OAAO;AACrD;AAWO,SAAS,sBAAsB,OAAyB;AAC7D,SAAO,iBAAiB,SAAS,MAAM,QAAQ,WAAW,2BAA2B;AACvF;"}

package/dist/packages/agent-runtime/src/quota-safe-local-storage-session.cjs

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const localStorage = require("@assistant-ui/react-statewire/local-storage");
+const SESSION_PREFIX = "aui:statewire-session:";
+const LEGACY_PROTOCOL = { name: "athena", version: "2026-09-07" };
+const browserGlobals = globalThis;
+function readPersistedFailedSendStamps(sessionKey) {
+  const storage = browserGlobals.localStorage;
+  if (!storage) return null;
+  let record;
+  try {
+    const raw = storage.getItem(SESSION_PREFIX + sessionKey);
+    record = raw === null ? null : JSON.parse(raw);
+  } catch {
+    return null;
+  }
+  return readFailedSendStampsFromRecord(record);
+}
+function readFailedSendStampsFromRecord(record) {
+  var _a, _b, _c;
+  if (!record || typeof record !== "object") return null;
+  const stamps = /* @__PURE__ */ new Map();
+  if (!Array.isArray(record.failed)) return stamps;
+  for (const entry of record.failed) {
+    const failed = entry;
+    const messageId = (_c = (_b = (_a = failed == null ? void 0 : failed.params) == null ? void 0 : _a[0]) == null ? void 0 : _b.message) == null ? void 0 : _c.id;
+    if (typeof messageId === "string" && typeof (failed == null ? void 0 : failed.ts) === "number") {
+      stamps.set(messageId, failed.ts);
+    }
+  }
+  return stamps;
+}
+const QuotaSafeLocalStorageSession = ({
+  threadId,
+  key,
+  ttl = 7 * 24 * 60 * 60 * 1e3,
+  max = 50
+}) => localStorage.LocalStorageSession({
+  threadId,
+  ...key === void 0 ? {} : { key },
+  legacyProtocol: LEGACY_PROTOCOL,
+  retention: { maxAgeMs: ttl, maxEntries: max }
+});
+exports.QuotaSafeLocalStorageSession = QuotaSafeLocalStorageSession;
+exports.readFailedSendStampsFromRecord = readFailedSendStampsFromRecord;
+exports.readPersistedFailedSendStamps = readPersistedFailedSendStamps;
+//# sourceMappingURL=quota-safe-local-storage-session.cjs.map

package/dist/packages/agent-runtime/src/quota-safe-local-storage-session.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-safe-local-storage-session.cjs","sources":["../../../../../agent-runtime/src/quota-safe-local-storage-session.ts"],"sourcesContent":["import { LocalStorageSession } from \"@assistant-ui/react-statewire/local-storage\";\n\nconst SESSION_PREFIX = \"aui:statewire-session:\";\nconst LEGACY_PROTOCOL = { name: \"athena\", version: \"2026-09-07\" };\nconst browserGlobals = globalThis as {\n  localStorage?: { getItem(key: string): string | null };\n};\n\nexport function readPersistedFailedSendStamps(\n  sessionKey: string,\n): ReadonlyMap<string, number> | null {\n  const storage = browserGlobals.localStorage;\n  if (!storage) return null;\n  let record: { failed?: unknown } | null;\n  try {\n    const raw = storage.getItem(SESSION_PREFIX + sessionKey);\n    record =\n      raw === null ? null : (JSON.parse(raw) as { failed?: unknown } | null);\n  } catch {\n    return null;\n  }\n  return readFailedSendStampsFromRecord(record);\n}\n\n/**\n * Send stamps (message id → epoch ms of the original send) off an already\n * loaded session record's failed lane — the storage-agnostic half of\n * {@link readPersistedFailedSendStamps}, for hosts whose session store is not\n * localStorage (the React Native AsyncStorage-backed store reads its record\n * synchronously through `SessionStorage.load()`).\n *\n * Returns `null` for no record (every failed entry then counts as fresh) and\n * an empty map for a record without failures.\n */\nexport function readFailedSendStampsFromRecord(\n  record: { failed?: unknown } | null | undefined,\n): ReadonlyMap<string, number> | null {\n  if (!record || typeof record !== \"object\") return null;\n  const stamps = new Map<string, number>();\n  if (!Array.isArray(record.failed)) return stamps;\n  for (const entry of record.failed) {\n    const failed = entry as {\n      ts?: unknown;\n      params?: readonly { message?: { id?: unknown } }[];\n    } | null;\n    const messageId = failed?.params?.[0]?.message?.id;\n    if (typeof messageId === \"string\" && typeof failed?.ts === \"number\") {\n      stamps.set(messageId, failed.ts);\n    }\n  }\n  return stamps;\n}\n\n/** Athena's browser session keys and retention policy. */\nexport const QuotaSafeLocalStorageSession = ({\n  threadId,\n  key,\n  ttl = 7 * 24 * 60 * 60 * 1000,\n  max = 50,\n}: QuotaSafeLocalStorageSession.Options) =>\n  LocalStorageSession({\n    threadId,\n    ...(key === undefined ? {} : { key }),\n    legacyProtocol: LEGACY_PROTOCOL,\n    retention: { maxAgeMs: ttl, maxEntries: max },\n  });\n\nexport namespace QuotaSafeLocalStorageSession {\n  export type Options = {\n    threadId: string;\n    key?: (threadId: string) => string;\n    ttl?: number;\n    max?: number;\n  };\n}\n"],"names":["LocalStorageSession"],"mappings":";;;AAEA,MAAM,iBAAiB;AACvB,MAAM,kBAAkB,EAAE,MAAM,UAAU,SAAS,aAAA;AACnD,MAAM,iBAAiB;AAIhB,SAAS,8BACd,YACoC;AACpC,QAAM,UAAU,eAAe;AAC/B,MAAI,CAAC,QAAS,QAAO;AACrB,MAAI;AACJ,MAAI;AACF,UAAM,MAAM,QAAQ,QAAQ,iBAAiB,UAAU;AACvD,aACE,QAAQ,OAAO,OAAQ,KAAK,MAAM,GAAG;AAAA,EACzC,QAAQ;AACN,WAAO;AAAA,EACT;AACA,SAAO,+BAA+B,MAAM;AAC9C;AAYO,SAAS,+BACd,QACoC;;AACpC,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,QAAM,6BAAa,IAAA;AACnB,MAAI,CAAC,MAAM,QAAQ,OAAO,MAAM,EAAG,QAAO;AAC1C,aAAW,SAAS,OAAO,QAAQ;AACjC,UAAM,SAAS;AAIf,UAAM,aAAY,kDAAQ,WAAR,mBAAiB,OAAjB,mBAAqB,YAArB,mBAA8B;AAChD,QAAI,OAAO,cAAc,YAAY,QAAO,iCAAQ,QAAO,UAAU;AACnE,aAAO,IAAI,WAAW,OAAO,EAAE;AAAA,IACjC;AAAA,EACF;AACA,SAAO;AACT;AAGO,MAAM,+BAA+B,CAAC;AAAA,EAC3C;AAAA,EACA;AAAA,EACA,MAAM,IAAI,KAAK,KAAK,KAAK;AAAA,EACzB,MAAM;AACR,MACEA,iCAAoB;AAAA,EAClB;AAAA,EACA,GAAI,QAAQ,SAAY,CAAA,IAAK,EAAE,IAAA;AAAA,EAC/B,gBAAgB;AAAA,EAChB,WAAW,EAAE,UAAU,KAAK,YAAY,IAAA;AAC1C,CAAC;;;;"}

package/dist/packages/agent-runtime/src/quota-safe-local-storage-session.js

@@ -0,0 +1,47 @@
+import { LocalStorageSession } from "@assistant-ui/react-statewire/local-storage";
+const SESSION_PREFIX = "aui:statewire-session:";
+const LEGACY_PROTOCOL = { name: "athena", version: "2026-09-07" };
+const browserGlobals = globalThis;
+function readPersistedFailedSendStamps(sessionKey) {
+  const storage = browserGlobals.localStorage;
+  if (!storage) return null;
+  let record;
+  try {
+    const raw = storage.getItem(SESSION_PREFIX + sessionKey);
+    record = raw === null ? null : JSON.parse(raw);
+  } catch {
+    return null;
+  }
+  return readFailedSendStampsFromRecord(record);
+}
+function readFailedSendStampsFromRecord(record) {
+  var _a, _b, _c;
+  if (!record || typeof record !== "object") return null;
+  const stamps = /* @__PURE__ */ new Map();
+  if (!Array.isArray(record.failed)) return stamps;
+  for (const entry of record.failed) {
+    const failed = entry;
+    const messageId = (_c = (_b = (_a = failed == null ? void 0 : failed.params) == null ? void 0 : _a[0]) == null ? void 0 : _b.message) == null ? void 0 : _c.id;
+    if (typeof messageId === "string" && typeof (failed == null ? void 0 : failed.ts) === "number") {
+      stamps.set(messageId, failed.ts);
+    }
+  }
+  return stamps;
+}
+const QuotaSafeLocalStorageSession = ({
+  threadId,
+  key,
+  ttl = 7 * 24 * 60 * 60 * 1e3,
+  max = 50
+}) => LocalStorageSession({
+  threadId,
+  ...key === void 0 ? {} : { key },
+  legacyProtocol: LEGACY_PROTOCOL,
+  retention: { maxAgeMs: ttl, maxEntries: max }
+});
+export {
+  QuotaSafeLocalStorageSession,
+  readFailedSendStampsFromRecord,
+  readPersistedFailedSendStamps
+};
+//# sourceMappingURL=quota-safe-local-storage-session.js.map

package/dist/packages/agent-runtime/src/quota-safe-local-storage-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-safe-local-storage-session.js","sources":["../../../../../agent-runtime/src/quota-safe-local-storage-session.ts"],"sourcesContent":["import { LocalStorageSession } from \"@assistant-ui/react-statewire/local-storage\";\n\nconst SESSION_PREFIX = \"aui:statewire-session:\";\nconst LEGACY_PROTOCOL = { name: \"athena\", version: \"2026-09-07\" };\nconst browserGlobals = globalThis as {\n  localStorage?: { getItem(key: string): string | null };\n};\n\nexport function readPersistedFailedSendStamps(\n  sessionKey: string,\n): ReadonlyMap<string, number> | null {\n  const storage = browserGlobals.localStorage;\n  if (!storage) return null;\n  let record: { failed?: unknown } | null;\n  try {\n    const raw = storage.getItem(SESSION_PREFIX + sessionKey);\n    record =\n      raw === null ? null : (JSON.parse(raw) as { failed?: unknown } | null);\n  } catch {\n    return null;\n  }\n  return readFailedSendStampsFromRecord(record);\n}\n\n/**\n * Send stamps (message id → epoch ms of the original send) off an already\n * loaded session record's failed lane — the storage-agnostic half of\n * {@link readPersistedFailedSendStamps}, for hosts whose session store is not\n * localStorage (the React Native AsyncStorage-backed store reads its record\n * synchronously through `SessionStorage.load()`).\n *\n * Returns `null` for no record (every failed entry then counts as fresh) and\n * an empty map for a record without failures.\n */\nexport function readFailedSendStampsFromRecord(\n  record: { failed?: unknown } | null | undefined,\n): ReadonlyMap<string, number> | null {\n  if (!record || typeof record !== \"object\") return null;\n  const stamps = new Map<string, number>();\n  if (!Array.isArray(record.failed)) return stamps;\n  for (const entry of record.failed) {\n    const failed = entry as {\n      ts?: unknown;\n      params?: readonly { message?: { id?: unknown } }[];\n    } | null;\n    const messageId = failed?.params?.[0]?.message?.id;\n    if (typeof messageId === \"string\" && typeof failed?.ts === \"number\") {\n      stamps.set(messageId, failed.ts);\n    }\n  }\n  return stamps;\n}\n\n/** Athena's browser session keys and retention policy. */\nexport const QuotaSafeLocalStorageSession = ({\n  threadId,\n  key,\n  ttl = 7 * 24 * 60 * 60 * 1000,\n  max = 50,\n}: QuotaSafeLocalStorageSession.Options) =>\n  LocalStorageSession({\n    threadId,\n    ...(key === undefined ? {} : { key }),\n    legacyProtocol: LEGACY_PROTOCOL,\n    retention: { maxAgeMs: ttl, maxEntries: max },\n  });\n\nexport namespace QuotaSafeLocalStorageSession {\n  export type Options = {\n    threadId: string;\n    key?: (threadId: string) => string;\n    ttl?: number;\n    max?: number;\n  };\n}\n"],"names":[],"mappings":";AAEA,MAAM,iBAAiB;AACvB,MAAM,kBAAkB,EAAE,MAAM,UAAU,SAAS,aAAA;AACnD,MAAM,iBAAiB;AAIhB,SAAS,8BACd,YACoC;AACpC,QAAM,UAAU,eAAe;AAC/B,MAAI,CAAC,QAAS,QAAO;AACrB,MAAI;AACJ,MAAI;AACF,UAAM,MAAM,QAAQ,QAAQ,iBAAiB,UAAU;AACvD,aACE,QAAQ,OAAO,OAAQ,KAAK,MAAM,GAAG;AAAA,EACzC,QAAQ;AACN,WAAO;AAAA,EACT;AACA,SAAO,+BAA+B,MAAM;AAC9C;AAYO,SAAS,+BACd,QACoC;;AACpC,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,QAAM,6BAAa,IAAA;AACnB,MAAI,CAAC,MAAM,QAAQ,OAAO,MAAM,EAAG,QAAO;AAC1C,aAAW,SAAS,OAAO,QAAQ;AACjC,UAAM,SAAS;AAIf,UAAM,aAAY,kDAAQ,WAAR,mBAAiB,OAAjB,mBAAqB,YAArB,mBAA8B;AAChD,QAAI,OAAO,cAAc,YAAY,QAAO,iCAAQ,QAAO,UAAU;AACnE,aAAO,IAAI,WAAW,OAAO,EAAE;AAAA,IACjC;AAAA,EACF;AACA,SAAO;AACT;AAGO,MAAM,+BAA+B,CAAC;AAAA,EAC3C;AAAA,EACA;AAAA,EACA,MAAM,IAAI,KAAK,KAAK,KAAK;AAAA,EACzB,MAAM;AACR,MACE,oBAAoB;AAAA,EAClB;AAAA,EACA,GAAI,QAAQ,SAAY,CAAA,IAAK,EAAE,IAAA;AAAA,EAC/B,gBAAgB;AAAA,EAChB,WAAW,EAAE,UAAU,KAAK,YAAY,IAAA;AAC1C,CAAC;"}

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

@@ -0,0 +1,187 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const core = require("@assistant-ui/core");
+const messages = require("./messages.cjs");
+const MAX_STEPS_HINT = "Raise “Max steps” in the agent settings for longer runs.";
+function describeTerminationReason(kind, reason) {
+  switch (kind) {
+    case "paused":
+      return {
+        title: "Paused by a server update",
+        detail: "Progress up to this point is saved — send a message to continue."
+      };
+    case "stopped":
+      switch (reason) {
+        case "voice_steer":
+          return {
+            title: "Redirected by a spoken follow-up",
+            detail: "The voice conversation changed the request; the work continues with the new instructions."
+          };
+        case "transport_cancel":
+          return {
+            title: "Run cancelled",
+            detail: "Cancelled by a page reload, navigation, or closed view — not an explicit Stop. Send a follow-up to continue."
+          };
+        case "fence_lost":
+          return {
+            title: "Run superseded",
+            detail: "Another activation took over this thread."
+          };
+        case "instance_closed":
+          return {
+            title: "Run stopped",
+            detail: "The client that started it went away."
+          };
+        default:
+          return { title: "Conversation stopped", detail: void 0 };
+      }
+    case "failed":
+      switch (reason) {
+        case "recursion_limit":
+          return {
+            title: "Step limit reached",
+            detail: `The run was stopped before finishing; the work so far is saved. ${MAX_STEPS_HINT}`
+          };
+        case "abandoned":
+          return {
+            title: "Run stopped unexpectedly",
+            detail: "The server handling it went away mid-run (a crash, restart, or deploy). The work so far is saved."
+          };
+        default:
+          return { title: "Run failed", detail: void 0 };
+      }
+    case "handoff":
+      switch (reason) {
+        case "duplicate_call_guard":
+          return {
+            title: "Run ended by the runtime",
+            detail: "The same tool calls were repeating with identical arguments and no new progress, so the agent was asked to wrap up."
+          };
+        case "step_budget":
+          return {
+            title: "Run ended by the runtime",
+            detail: `The step budget ran out, so the agent was asked to wrap up. ${MAX_STEPS_HINT}`
+          };
+        default:
+          return {
+            title: "Run ended by the runtime",
+            detail: "The agent was asked to wrap up."
+          };
+      }
+  }
+}
+const SEVERITY = {
+  stopped: "info",
+  paused: "info",
+  failed: "error",
+  handoff: "warning"
+};
+function metadataOf(kwargs) {
+  const metadata = kwargs == null ? void 0 : kwargs.metadata;
+  return typeof metadata === "object" && metadata !== null ? metadata : void 0;
+}
+function readTerminationReason(kwargs) {
+  var _a;
+  const top = kwargs == null ? void 0 : kwargs[messages.ATHENA_TERMINATION_REASON_KEY];
+  if (typeof top === "string") return top;
+  const mirrored = (_a = metadataOf(kwargs)) == null ? void 0 : _a[messages.ATHENA_TERMINATION_REASON_KEY];
+  return typeof mirrored === "string" ? mirrored : void 0;
+}
+function readHandoff(kwargs) {
+  var _a;
+  return (kwargs == null ? void 0 : kwargs[messages.ATHENA_HANDOFF_KEY]) === true || ((_a = metadataOf(kwargs)) == null ? void 0 : _a[messages.ATHENA_HANDOFF_KEY]) === true;
+}
+function textOf(content) {
+  if (typeof content === "string") return content;
+  if (!Array.isArray(content)) return void 0;
+  const texts = content.map(
+    (block) => typeof block === "string" ? block : block && typeof block === "object" && block.type === "text" ? block.text : void 0
+  ).filter((text) => typeof text === "string" && text.length > 0);
+  return texts.length > 0 ? texts.join("\n") : void 0;
+}
+function fromMarker(marker, source, reason) {
+  if (marker === messages.ATHENA_RUN_MARKER_CANCELLED) {
+    const kind = messages.isServerUpdateStopSource(source) ? "paused" : "stopped";
+    return {
+      kind,
+      reason: reason ?? (source === "unattributed" ? "unattributed_stop" : source),
+      silent: source === messages.ATHENA_STOP_SOURCE_SEND_NOW
+    };
+  }
+  if (marker === messages.ATHENA_RUN_MARKER_FAILED) {
+    return { kind: "failed", reason: reason ?? "error", silent: false };
+  }
+  return void 0;
+}
+function build(partial, text, isSoleSourceMessage) {
+  const description = describeTerminationReason(partial.kind, partial.reason);
+  return {
+    kind: partial.kind,
+    reason: partial.reason,
+    severity: SEVERITY[partial.kind],
+    title: description.title,
+    detail: description.detail,
+    text,
+    silent: partial.silent,
+    isSoleSourceMessage
+  };
+}
+function readRuntimeMessageFromSourceMessages(message) {
+  var _a;
+  const sources = core.getExternalStoreMessages(message);
+  for (const source of sources) {
+    if ((source == null ? void 0 : source.type) !== "ai") continue;
+    const kwargs = source.additional_kwargs;
+    const marker = kwargs == null ? void 0 : kwargs[messages.ATHENA_RUN_MARKER_KEY];
+    const reason = readTerminationReason(kwargs);
+    const text = textOf(source.content);
+    if (typeof marker === "string") {
+      const markerSource = kwargs == null ? void 0 : kwargs[messages.ATHENA_RUN_MARKER_SOURCE_KEY];
+      const partial = fromMarker(
+        marker,
+        typeof markerSource === "string" ? markerSource : void 0,
+        reason
+      );
+      if (partial) return build(partial, text, sources.length === 1);
+    }
+    if (readHandoff(kwargs)) {
+      return build({ kind: "handoff", reason, silent: false }, text, sources.length === 1);
+    }
+  }
+  const custom = (_a = message.metadata) == null ? void 0 : _a.custom;
+  if (!custom) return void 0;
+  const parts = message.content;
+  const sole = Array.isArray(parts) ? parts.length <= 1 : true;
+  const joinedMarker = custom[messages.ATHENA_RUN_MARKER_KEY];
+  const joinedReason = readTerminationReason({ metadata: custom });
+  if (typeof joinedMarker === "string") {
+    const joinedSource = custom[messages.ATHENA_RUN_MARKER_SOURCE_KEY];
+    const partial = fromMarker(
+      joinedMarker,
+      typeof joinedSource === "string" ? joinedSource : void 0,
+      joinedReason
+    );
+    if (partial) return build(partial, void 0, sole);
+  }
+  if (custom[messages.ATHENA_HANDOFF_KEY] === true) {
+    return build({ kind: "handoff", reason: joinedReason, silent: false }, void 0, sole);
+  }
+  return void 0;
+}
+function runtimeMessageMarkerText(message) {
+  var _a;
+  if (message.kind !== "failed" || message.detail) return void 0;
+  const text = (_a = message.text) == null ? void 0 : _a.replace(/^(?:⏹️|⏸️|⚠️|\s)+/u, "").trim();
+  if (!text || text === message.title) return void 0;
+  return text;
+}
+function readSoleRuntimeMessageKind(message) {
+  const found = readRuntimeMessageFromSourceMessages(message);
+  return (found == null ? void 0 : found.isSoleSourceMessage) ? found.kind : void 0;
+}
+exports.describeTerminationReason = describeTerminationReason;
+exports.readRuntimeMessageFromSourceMessages = readRuntimeMessageFromSourceMessages;
+exports.readSoleRuntimeMessageKind = readSoleRuntimeMessageKind;
+exports.readTerminationReason = readTerminationReason;
+exports.runtimeMessageMarkerText = runtimeMessageMarkerText;
+//# sourceMappingURL=runtime-messages.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-messages.cjs","sources":["../../../../../agent-runtime/src/runtime-messages.ts"],"sourcesContent":["/**\n * Typed runtime messages — the one description of \"the runtime ended this run\"\n * that every chat surface renders from.\n *\n * The deep-agent backend records how a run ended in two shapes that ride\n * ordinary `ai` messages (a new LangChain message type would crash the shipped\n * converter, whose convertible set is closed):\n *\n * - a **run-lifecycle marker** (`athena_run_marker`: `cancelled` / `failed`,\n *   plus `athena_run_marker_source`) — see {@link readRunMarkerFromSourceMessages};\n * - a **handoff message** (`athena_handoff: true`) — the closing summary the\n *   runtime asked the model to write when a guard or the step budget ended the\n *   run, instead of fabricating an internal sentence.\n *\n * Both now carry the canonical `athena_termination_reason`\n * (`agora/graphs/athena_deep_agent/termination.py`). This module reads all of\n * that into one {@link AthenaRuntimeMessage} so Olympus, mobile, the Chrome\n * extension, and the Office add-in agree on kind, severity, copy, and the\n * sole-vs-grouped distinction — the last of which is load-bearing: a marker\n * appended after the assistant's own work is chunked into that message, and\n * replacing the whole row would hide completed prose and tool cards.\n */\n\nimport { getExternalStoreMessages } from '@assistant-ui/core';\nimport type { LangChainMessage } from '@assistant-ui/react-langgraph';\nimport {\n  ATHENA_HANDOFF_KEY,\n  ATHENA_RUN_MARKER_CANCELLED,\n  ATHENA_RUN_MARKER_FAILED,\n  ATHENA_RUN_MARKER_KEY,\n  ATHENA_RUN_MARKER_SOURCE_KEY,\n  ATHENA_STOP_SOURCE_SEND_NOW,\n  ATHENA_TERMINATION_REASON_KEY,\n  isServerUpdateStopSource,\n} from './messages';\n\n/** The backend's canonical reason vocabulary (`KNOWN_TERMINATION_REASONS`). */\nexport const TERMINATION_REASONS = [\n  'completed',\n  'user_stop',\n  'send_now',\n  'voice_steer',\n  'transport_cancel',\n  'pod_drain',\n  'fence_lost',\n  'instance_closed',\n  'unattributed_stop',\n  'recursion_limit',\n  'step_budget',\n  'duplicate_call_guard',\n  'synthetic_stop',\n  'ended_after_tools',\n  'error',\n  'model_refusal',\n  'abandoned',\n] as const;\n\nexport type AthenaTerminationReason = (typeof TERMINATION_REASONS)[number];\n\n/**\n * How a runtime ending renders:\n * - `stopped` — a cancellation the user (or a client action) asked for;\n * - `paused` — a pod-drain pause; the run resumes from its checkpoint;\n * - `failed` — the graph raised, hit the recursion limit, or was abandoned;\n * - `handoff` — the runtime ended the run and the model wrote a closing\n *   summary (the message text), which renders as prose under a banner.\n */\nexport type AthenaRuntimeMessageKind = 'stopped' | 'paused' | 'failed' | 'handoff';\n\nexport type AthenaRuntimeMessageSeverity = 'info' | 'warning' | 'error';\n\nexport interface TerminationDescription {\n  /** Short label for the banner / status row. */\n  title: string;\n  /** One sentence of reason-specific explanation, when it adds information. */\n  detail: string | undefined;\n}\n\nexport interface AthenaRuntimeMessage {\n  kind: AthenaRuntimeMessageKind;\n  /** Canonical reason (may be a value newer than this client knows). */\n  reason: string | undefined;\n  severity: AthenaRuntimeMessageSeverity;\n  title: string;\n  detail: string | undefined;\n  /** The message's own text: a marker's backend copy, or the handoff summary. */\n  text: string | undefined;\n  /**\n   * A `send_now` promotion cancels the live run as plumbing, not as a\n   * user-visible stop: keep it in the data, paint nothing.\n   */\n  silent: boolean;\n  /**\n   * True when the runtime message is the ONLY source message behind this\n   * thread message (it owns the whole row). False when the chunk also holds\n   * the assistant's own work, which must keep rendering.\n   */\n  isSoleSourceMessage: boolean;\n}\n\nconst MAX_STEPS_HINT = 'Raise “Max steps” in the agent settings for longer runs.';\n\n/**\n * Copy for a runtime ending. Reasons this client does not know fall back to\n * the kind's generic title, so a newer backend never renders as an empty row.\n */\nexport function describeTerminationReason(\n  kind: AthenaRuntimeMessageKind,\n  reason: string | undefined\n): TerminationDescription {\n  switch (kind) {\n    case 'paused':\n      return {\n        title: 'Paused by a server update',\n        detail: 'Progress up to this point is saved — send a message to continue.',\n      };\n    case 'stopped':\n      switch (reason) {\n        case 'voice_steer':\n          return {\n            title: 'Redirected by a spoken follow-up',\n            detail:\n              'The voice conversation changed the request; the work continues with the new instructions.',\n          };\n        case 'transport_cancel':\n          return {\n            title: 'Run cancelled',\n            detail:\n              'Cancelled by a page reload, navigation, or closed view — not an explicit Stop. Send a follow-up to continue.',\n          };\n        case 'fence_lost':\n          return {\n            title: 'Run superseded',\n            detail: 'Another activation took over this thread.',\n          };\n        case 'instance_closed':\n          return {\n            title: 'Run stopped',\n            detail: 'The client that started it went away.',\n          };\n        default:\n          return { title: 'Conversation stopped', detail: undefined };\n      }\n    case 'failed':\n      switch (reason) {\n        case 'recursion_limit':\n          return {\n            title: 'Step limit reached',\n            detail: `The run was stopped before finishing; the work so far is saved. ${MAX_STEPS_HINT}`,\n          };\n        case 'abandoned':\n          return {\n            title: 'Run stopped unexpectedly',\n            detail:\n              'The server handling it went away mid-run (a crash, restart, or deploy). The work so far is saved.',\n          };\n        default:\n          return { title: 'Run failed', detail: undefined };\n      }\n    case 'handoff':\n      switch (reason) {\n        case 'duplicate_call_guard':\n          return {\n            title: 'Run ended by the runtime',\n            detail:\n              'The same tool calls were repeating with identical arguments and no new progress, so the agent was asked to wrap up.',\n          };\n        case 'step_budget':\n          return {\n            title: 'Run ended by the runtime',\n            detail: `The step budget ran out, so the agent was asked to wrap up. ${MAX_STEPS_HINT}`,\n          };\n        default:\n          return {\n            title: 'Run ended by the runtime',\n            detail: 'The agent was asked to wrap up.',\n          };\n      }\n  }\n}\n\nconst SEVERITY: Record<AthenaRuntimeMessageKind, AthenaRuntimeMessageSeverity> = {\n  stopped: 'info',\n  paused: 'info',\n  failed: 'error',\n  handoff: 'warning',\n};\n\ntype Kwargs = Record<string, unknown> | undefined;\n\nfunction metadataOf(kwargs: Kwargs): Record<string, unknown> | undefined {\n  const metadata = kwargs?.metadata;\n  return typeof metadata === 'object' && metadata !== null\n    ? (metadata as Record<string, unknown>)\n    : undefined;\n}\n\n/** The termination reason stamped on `additional_kwargs` (top-level or mirror). */\nexport function readTerminationReason(kwargs: Kwargs): string | undefined {\n  const top = kwargs?.[ATHENA_TERMINATION_REASON_KEY];\n  if (typeof top === 'string') return top;\n  const mirrored = metadataOf(kwargs)?.[ATHENA_TERMINATION_REASON_KEY];\n  return typeof mirrored === 'string' ? mirrored : undefined;\n}\n\nfunction readHandoff(kwargs: Kwargs): boolean {\n  return kwargs?.[ATHENA_HANDOFF_KEY] === true || metadataOf(kwargs)?.[ATHENA_HANDOFF_KEY] === true;\n}\n\nfunction textOf(content: unknown): string | undefined {\n  if (typeof content === 'string') return content;\n  if (!Array.isArray(content)) return undefined;\n  const texts = content\n    .map((block) =>\n      typeof block === 'string'\n        ? block\n        : block && typeof block === 'object' && (block as { type?: unknown }).type === 'text'\n          ? (block as { text?: unknown }).text\n          : undefined\n    )\n    .filter((text): text is string => typeof text === 'string' && text.length > 0);\n  return texts.length > 0 ? texts.join('\\n') : undefined;\n}\n\nfunction fromMarker(\n  marker: string,\n  source: string | undefined,\n  reason: string | undefined\n): Pick<AthenaRuntimeMessage, 'kind' | 'reason' | 'silent'> | undefined {\n  if (marker === ATHENA_RUN_MARKER_CANCELLED) {\n    const kind: AthenaRuntimeMessageKind = isServerUpdateStopSource(source) ? 'paused' : 'stopped';\n    return {\n      kind,\n      reason: reason ?? (source === 'unattributed' ? 'unattributed_stop' : source),\n      silent: source === ATHENA_STOP_SOURCE_SEND_NOW,\n    };\n  }\n  if (marker === ATHENA_RUN_MARKER_FAILED) {\n    return { kind: 'failed', reason: reason ?? 'error', silent: false };\n  }\n  return undefined;\n}\n\nfunction build(\n  partial: Pick<AthenaRuntimeMessage, 'kind' | 'reason' | 'silent'>,\n  text: string | undefined,\n  isSoleSourceMessage: boolean\n): AthenaRuntimeMessage {\n  const description = describeTerminationReason(partial.kind, partial.reason);\n  return {\n    kind: partial.kind,\n    reason: partial.reason,\n    severity: SEVERITY[partial.kind],\n    title: description.title,\n    detail: description.detail,\n    text,\n    silent: partial.silent,\n    isSoleSourceMessage,\n  };\n}\n\n/**\n * Read the runtime ending behind a thread message, from its bound source\n * messages first (a marker or handoff chunked after the assistant's own turn\n * is never the first source, so the joined `metadata.custom` would miss it —\n * see {@link readRunMarkerFromSourceMessages}), then from joined metadata for\n * surfaces without bound sources.\n */\nexport function readRuntimeMessageFromSourceMessages(\n  message: Parameters<typeof getExternalStoreMessages>[0] & {\n    metadata?: { custom?: Record<string, unknown> | undefined } | undefined;\n    content?: unknown;\n  }\n): AthenaRuntimeMessage | undefined {\n  const sources = getExternalStoreMessages<LangChainMessage>(message);\n  for (const source of sources) {\n    if (source?.type !== 'ai') continue;\n    const kwargs = source.additional_kwargs as Kwargs;\n    const marker = kwargs?.[ATHENA_RUN_MARKER_KEY];\n    const reason = readTerminationReason(kwargs);\n    const text = textOf(source.content);\n    if (typeof marker === 'string') {\n      const markerSource = kwargs?.[ATHENA_RUN_MARKER_SOURCE_KEY];\n      const partial = fromMarker(\n        marker,\n        typeof markerSource === 'string' ? markerSource : undefined,\n        reason\n      );\n      if (partial) return build(partial, text, sources.length === 1);\n    }\n    if (readHandoff(kwargs)) {\n      return build({ kind: 'handoff', reason, silent: false }, text, sources.length === 1);\n    }\n  }\n  const custom = message.metadata?.custom;\n  if (!custom) return undefined;\n  const parts = message.content;\n  const sole = Array.isArray(parts) ? parts.length <= 1 : true;\n  const joinedMarker = custom[ATHENA_RUN_MARKER_KEY];\n  const joinedReason = readTerminationReason({ metadata: custom });\n  if (typeof joinedMarker === 'string') {\n    const joinedSource = custom[ATHENA_RUN_MARKER_SOURCE_KEY];\n    const partial = fromMarker(\n      joinedMarker,\n      typeof joinedSource === 'string' ? joinedSource : undefined,\n      joinedReason\n    );\n    if (partial) return build(partial, undefined, sole);\n  }\n  if (custom[ATHENA_HANDOFF_KEY] === true) {\n    return build({ kind: 'handoff', reason: joinedReason, silent: false }, undefined, sole);\n  }\n  return undefined;\n}\n\n/**\n * The backend marker copy worth showing under a runtime card, or `undefined`.\n *\n * A failure marker's text carries the specific error (\"The run failed:\n * provider returned 502\"), so it is shown when no reason-specific detail\n * exists. Stop/pause copy only restates the title, and a handoff's text is the\n * message body itself, so neither is repeated. Marker copy leads with an emoji\n * for raw-transcript readers; the card's icon plays that role, so it is\n * stripped. Shared by every presenter so mobile and DOM cannot drift.\n */\nexport function runtimeMessageMarkerText(message: AthenaRuntimeMessage): string | undefined {\n  if (message.kind !== 'failed' || message.detail) return undefined;\n  const text = message.text?.replace(/^(?:⏹️|⏸️|⚠️|\\s)+/u, '').trim();\n  if (!text || text === message.title) return undefined;\n  return text;\n}\n\n/**\n * The runtime message's kind when it owns the whole row, else `undefined`.\n *\n * Returns a primitive so it is safe as a `useAuiState` selector (the reader\n * above builds a fresh object per call; an object snapshot would loop the\n * render under `Object.is` comparison).\n */\nexport function readSoleRuntimeMessageKind(\n  message: Parameters<typeof readRuntimeMessageFromSourceMessages>[0]\n): AthenaRuntimeMessageKind | undefined {\n  const found = readRuntimeMessageFromSourceMessages(message);\n  return found?.isSoleSourceMessage ? found.kind : undefined;\n}\n"],"names":["ATHENA_TERMINATION_REASON_KEY","ATHENA_HANDOFF_KEY","ATHENA_RUN_MARKER_CANCELLED","isServerUpdateStopSource","ATHENA_STOP_SOURCE_SEND_NOW","ATHENA_RUN_MARKER_FAILED","getExternalStoreMessages","ATHENA_RUN_MARKER_KEY","ATHENA_RUN_MARKER_SOURCE_KEY"],"mappings":"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"}