@athenaintel/react 0.28.1 → 0.32.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sources":["../../../../agent-runtime/src/protocol.ts"],"sourcesContent":["import {\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 declaration 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. The host records it for attach telemetry and\n *   per-version behaviour selection only.\n * - Advertisement: the host publishes its own `version` under the `protocol`\n *   state key in every attach snapshot; {@link readDeepAgentProtocol} /\n *   {@link projectDeepAgentProtocol} read it.\n *\n * There is no minimum client version: the host refuses no command for the\n * version its client declared (or for declaring none), so nothing here\n * compares versions or gates a send. Hosts still publish a `minClientVersion`\n * key (the constant 1) for installed clients whose lane reader required it;\n * this reader ignores 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 * declaration 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}\n\n/** The advertised-lane projection a host surface reads. */\nexport interface DeepAgentProtocolStatus {\n  /** Server-advertised current contract version. */\n  protocolVersion: number;\n  /** The contract version THIS client build declares. */\n  clientVersion: number;\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 } = lane as Record<string, unknown>;\n  if (!isContractVersion(version)) return null;\n  return { version };\n}\n\n/**\n * Project the advertised version 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    clientVersion: 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"],"names":[],"mappings":";AA6CA,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,YAAY;AACpB,MAAI,CAAC,kBAAkB,OAAO,EAAG,QAAO;AACxC,SAAO,EAAE,QAAA;AACX;AAOO,SAAS,yBAAyB,OAAgD;AACvF,QAAM,OAAO,sBAAsB,KAAK;AACxC,MAAI,SAAS,KAAM,QAAO;AAC1B,SAAO;AAAA,IACL,iBAAiB,KAAK;AAAA,IACtB,eAAe;AAAA,EAAA;AAEnB;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 → agent-runtime}/src/queue.cjs

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const composerMarkdown = require("./composer-markdown.cjs");
 const messages = require("./messages.cjs");
 function queueEntryText(parts) {
   return parts.flatMap(
@@ -31,17 +32,37 @@ function showQueueRowSendNow(options) {
 }
 function buildQueueEditCommand(options) {
   const { item, lane, runId, text } = options;
-  if (!text.trim() || text === queueEntryText(item.parts) || runId === null) {
+  const textChanged = text !== queueEntryText(item.parts);
+  const previous = nonEmpty(item.metadata);
+  const next = nonEmpty(
+    options.metadata !== void 0 ? options.metadata : textChanged ? withoutComposerMarkdown(item.metadata) : item.metadata
+  );
+  if (!text.trim() || runId === null || !textChanged && stableJson(next ?? null) === stableJson(previous ?? null)) {
     return null;
   }
+  const metadata = next ?? (previous === void 0 ? void 0 : {});
   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 }
+    ...metadata === void 0 ? {} : { metadata: { ...metadata } }
   };
   return lane === "steer" ? { type: "run/steer", runId, message } : { type: "run/enqueue", runId, message };
 }
+function nonEmpty(metadata) {
+  return metadata !== void 0 && Object.keys(metadata).length > 0 ? metadata : void 0;
+}
+function stableJson(value) {
+  const sorted = (entry) => Array.isArray(entry) ? entry.map(sorted) : typeof entry === "object" && entry !== null ? Object.fromEntries(
+    Object.keys(entry).sort().map((key) => [key, sorted(entry[key])])
+  ) : entry;
+  return JSON.stringify(sorted(value));
+}
+function withoutComposerMarkdown(metadata) {
+  if (metadata === void 0 || !(composerMarkdown.DEEP_AGENT_COMPOSER_MARKDOWN_KEY in metadata)) return metadata;
+  const { [composerMarkdown.DEEP_AGENT_COMPOSER_MARKDOWN_KEY]: _stale, ...rest } = metadata;
+  return Object.keys(rest).length > 0 ? rest : void 0;
+}
 const QUEUE_AUTO_CONTINUE_DELAY_MS = 2e3;
 function userStopBlocksQueueAutoContinue(options) {
   return options.marker === messages.ATHENA_RUN_MARKER_CANCELLED && !messages.isServerUpdateStopSource(options.source);

package/dist/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 { DEEP_AGENT_COMPOSER_MARKDOWN_KEY } from './composer-markdown';\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  /**\n   * The edited message's metadata, replacing the entry's (the host replaces\n   * the queued message whole). Omitted, the entry's metadata is kept, minus a\n   * composer markdown that described the old text.\n   */\n  metadata?: Readonly<Record<string, unknown>> | undefined;\n}): QueueEditCommand | null {\n  const { item, lane, runId, text } = options;\n  const textChanged: boolean = text !== queueEntryText(item.parts);\n  const previous: Readonly<Record<string, unknown>> | undefined = nonEmpty(item.metadata);\n  const next: Readonly<Record<string, unknown>> | undefined = nonEmpty(\n    options.metadata !== undefined\n      ? options.metadata\n      : textChanged\n        ? withoutComposerMarkdown(item.metadata)\n        : item.metadata,\n  );\n  if (\n    !text.trim() ||\n    runId === null ||\n    (!textChanged && stableJson(next ?? null) === stableJson(previous ?? null))\n  ) {\n    return null;\n  }\n  // An entry that had metadata and keeps none sends an empty object: the\n  // optimistic lane keeps an entry's metadata when the command carries none,\n  // and would go on showing the old composer markdown until the host answers.\n  const metadata: Readonly<Record<string, unknown>> | undefined =\n    next ?? (previous === undefined ? undefined : {});\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    ...(metadata === undefined ? {} : { metadata: { ...metadata } }),\n  };\n  return lane === 'steer'\n    ? { type: 'run/steer', runId, message }\n    : { type: 'run/enqueue', runId, message };\n}\n\n/** `metadata` unless it is empty. */\nfunction nonEmpty(\n  metadata: Readonly<Record<string, unknown>> | undefined,\n): Readonly<Record<string, unknown>> | undefined {\n  return metadata !== undefined && Object.keys(metadata).length > 0 ? metadata : undefined;\n}\n\n/** JSON with object keys sorted, so equal metadata compares equal whatever its key order. */\nfunction stableJson(value: unknown): string {\n  const sorted = (entry: unknown): unknown =>\n    Array.isArray(entry)\n      ? entry.map(sorted)\n      : typeof entry === 'object' && entry !== null\n        ? Object.fromEntries(\n            Object.keys(entry)\n              .sort()\n              .map((key) => [key, sorted((entry as Record<string, unknown>)[key])]),\n          )\n        : entry;\n  return JSON.stringify(sorted(value));\n}\n\n/** Entry metadata without a composer markdown, `undefined` when nothing is left. */\nfunction withoutComposerMarkdown(\n  metadata: Readonly<Record<string, unknown>> | undefined,\n): Readonly<Record<string, unknown>> | undefined {\n  if (metadata === undefined || !(DEEP_AGENT_COMPOSER_MARKDOWN_KEY in metadata)) return metadata;\n  const { [DEEP_AGENT_COMPOSER_MARKDOWN_KEY]: _stale, ...rest } = metadata;\n  return Object.keys(rest).length > 0 ? rest : undefined;\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":["DEEP_AGENT_COMPOSER_MARKDOWN_KEY","ATHENA_RUN_MARKER_CANCELLED","isServerUpdateStopSource"],"mappings":"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"}

package/dist/{packages/agent-runtime → agent-runtime}/src/queue.js

@@ -1,3 +1,4 @@
+import { DEEP_AGENT_COMPOSER_MARKDOWN_KEY } from "./composer-markdown.js";
 import { ATHENA_RUN_MARKER_CANCELLED, isServerUpdateStopSource } from "./messages.js";
 function queueEntryText(parts) {
   return parts.flatMap(
@@ -29,17 +30,37 @@ function showQueueRowSendNow(options) {
 }
 function buildQueueEditCommand(options) {
   const { item, lane, runId, text } = options;
-  if (!text.trim() || text === queueEntryText(item.parts) || runId === null) {
+  const textChanged = text !== queueEntryText(item.parts);
+  const previous = nonEmpty(item.metadata);
+  const next = nonEmpty(
+    options.metadata !== void 0 ? options.metadata : textChanged ? withoutComposerMarkdown(item.metadata) : item.metadata
+  );
+  if (!text.trim() || runId === null || !textChanged && stableJson(next ?? null) === stableJson(previous ?? null)) {
     return null;
   }
+  const metadata = next ?? (previous === void 0 ? void 0 : {});
   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 }
+    ...metadata === void 0 ? {} : { metadata: { ...metadata } }
   };
   return lane === "steer" ? { type: "run/steer", runId, message } : { type: "run/enqueue", runId, message };
 }
+function nonEmpty(metadata) {
+  return metadata !== void 0 && Object.keys(metadata).length > 0 ? metadata : void 0;
+}
+function stableJson(value) {
+  const sorted = (entry) => Array.isArray(entry) ? entry.map(sorted) : typeof entry === "object" && entry !== null ? Object.fromEntries(
+    Object.keys(entry).sort().map((key) => [key, sorted(entry[key])])
+  ) : entry;
+  return JSON.stringify(sorted(value));
+}
+function withoutComposerMarkdown(metadata) {
+  if (metadata === void 0 || !(DEEP_AGENT_COMPOSER_MARKDOWN_KEY in metadata)) return metadata;
+  const { [DEEP_AGENT_COMPOSER_MARKDOWN_KEY]: _stale, ...rest } = metadata;
+  return Object.keys(rest).length > 0 ? rest : void 0;
+}
 const QUEUE_AUTO_CONTINUE_DELAY_MS = 2e3;
 function userStopBlocksQueueAutoContinue(options) {
   return options.marker === ATHENA_RUN_MARKER_CANCELLED && !isServerUpdateStopSource(options.source);

package/dist/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 { DEEP_AGENT_COMPOSER_MARKDOWN_KEY } from './composer-markdown';\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  /**\n   * The edited message's metadata, replacing the entry's (the host replaces\n   * the queued message whole). Omitted, the entry's metadata is kept, minus a\n   * composer markdown that described the old text.\n   */\n  metadata?: Readonly<Record<string, unknown>> | undefined;\n}): QueueEditCommand | null {\n  const { item, lane, runId, text } = options;\n  const textChanged: boolean = text !== queueEntryText(item.parts);\n  const previous: Readonly<Record<string, unknown>> | undefined = nonEmpty(item.metadata);\n  const next: Readonly<Record<string, unknown>> | undefined = nonEmpty(\n    options.metadata !== undefined\n      ? options.metadata\n      : textChanged\n        ? withoutComposerMarkdown(item.metadata)\n        : item.metadata,\n  );\n  if (\n    !text.trim() ||\n    runId === null ||\n    (!textChanged && stableJson(next ?? null) === stableJson(previous ?? null))\n  ) {\n    return null;\n  }\n  // An entry that had metadata and keeps none sends an empty object: the\n  // optimistic lane keeps an entry's metadata when the command carries none,\n  // and would go on showing the old composer markdown until the host answers.\n  const metadata: Readonly<Record<string, unknown>> | undefined =\n    next ?? (previous === undefined ? undefined : {});\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    ...(metadata === undefined ? {} : { metadata: { ...metadata } }),\n  };\n  return lane === 'steer'\n    ? { type: 'run/steer', runId, message }\n    : { type: 'run/enqueue', runId, message };\n}\n\n/** `metadata` unless it is empty. */\nfunction nonEmpty(\n  metadata: Readonly<Record<string, unknown>> | undefined,\n): Readonly<Record<string, unknown>> | undefined {\n  return metadata !== undefined && Object.keys(metadata).length > 0 ? metadata : undefined;\n}\n\n/** JSON with object keys sorted, so equal metadata compares equal whatever its key order. */\nfunction stableJson(value: unknown): string {\n  const sorted = (entry: unknown): unknown =>\n    Array.isArray(entry)\n      ? entry.map(sorted)\n      : typeof entry === 'object' && entry !== null\n        ? Object.fromEntries(\n            Object.keys(entry)\n              .sort()\n              .map((key) => [key, sorted((entry as Record<string, unknown>)[key])]),\n          )\n        : entry;\n  return JSON.stringify(sorted(value));\n}\n\n/** Entry metadata without a composer markdown, `undefined` when nothing is left. */\nfunction withoutComposerMarkdown(\n  metadata: Readonly<Record<string, unknown>> | undefined,\n): Readonly<Record<string, unknown>> | undefined {\n  if (metadata === undefined || !(DEEP_AGENT_COMPOSER_MARKDOWN_KEY in metadata)) return metadata;\n  const { [DEEP_AGENT_COMPOSER_MARKDOWN_KEY]: _stale, ...rest } = metadata;\n  return Object.keys(rest).length > 0 ? rest : undefined;\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":"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"}

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

@@ -29,7 +29,9 @@ function readFailedSendStampsFromRecord(record) {
   const lanes = record.lanes && typeof record.lanes === "object" ? record.lanes : {};
   const failed = [
     ...Array.isArray(record.failed) ? record.failed : [],
-    ...Object.values(lanes).flatMap((lane) => Array.isArray(lane == null ? void 0 : lane.failed) ? lane.failed : [])
+    ...Object.values(lanes).flatMap(
+      (lane) => Array.isArray(lane == null ? void 0 : lane.failed) ? lane.failed : []
+    )
   ];
   for (const entry of failed) {
     const failed2 = entry;
@@ -73,7 +75,11 @@ function parkIncompatibleSessionCommands(record, current, now = Date.now()) {
       });
     }
     parked += failed.length;
-    lanes[protocol] = failed.length === 0 ? lane : { ...lane, commands: kept, failed: [...lane.failed ?? [], ...failed] };
+    lanes[protocol] = failed.length === 0 ? lane : {
+      ...lane,
+      commands: kept,
+      failed: [...lane.failed ?? [], ...failed]
+    };
   }
   return parked === 0 ? { record, parked } : { record: { ...record, lanes }, parked };
 }
@@ -222,6 +228,36 @@ function quotaTolerantBackend({
     }
   };
 }
+function savedAtOf(raw) {
+  if (raw === null) return void 0;
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return void 0;
+  }
+  if (typeof parsed !== "object" || parsed === null) return void 0;
+  const { savedAt, updatedAt } = parsed;
+  const stamp = savedAt ?? updatedAt;
+  return typeof stamp === "number" && Number.isFinite(stamp) ? stamp : void 0;
+}
+async function retireExpiredSessionRecords({
+  backend,
+  mounted,
+  maxAgeMs,
+  now = Date.now()
+}) {
+  for (const key of backend.getAllKeys()) {
+    if (!key.startsWith(SESSION_PREFIX) || mounted.has(key)) continue;
+    const savedAt = savedAtOf(backend.getItem(key));
+    if (savedAt === void 0 || now - savedAt <= maxAgeMs) continue;
+    await backend.withUnused(key, async () => {
+      if (mounted.has(key) || savedAtOf(backend.getItem(key)) !== savedAt)
+        return;
+      backend.removeItem(key);
+    });
+  }
+}
 const sharedBackends = /* @__PURE__ */ new WeakMap();
 function sharedBackend({
   storage: storage2,
@@ -232,6 +268,7 @@ function sharedBackend({
     const listeners = /* @__PURE__ */ new Set();
     shared = {
       listeners,
+      mounted: /* @__PURE__ */ new Map(),
       backend: quotaTolerantBackend({
         inner: browserBackend({ storage: storage2, locks }),
         onDegraded: (degradation) => {
@@ -294,6 +331,22 @@ const useQuotaSafeLocalStorageSession = ({
       shared.listeners.delete(reportDegradation);
     };
   }, [shared, reportDegradation]);
+  react.useEffect(() => {
+    const { mounted } = shared;
+    mounted.set(storageKey, (mounted.get(storageKey) ?? 0) + 1);
+    retireExpiredSessionRecords({
+      backend: shared.backend,
+      mounted,
+      maxAgeMs: ttl
+    }).catch(
+      (error) => reportDegradation({ operation: "withUnused", key: storageKey, error })
+    );
+    return () => {
+      const count = (mounted.get(storageKey) ?? 1) - 1;
+      if (count === 0) mounted.delete(storageKey);
+      else mounted.set(storageKey, count);
+    };
+  }, [shared, storageKey, ttl, reportDegradation]);
   react.useEffect(() => {
     let release;
     let disposed = false;
@@ -316,23 +369,27 @@ const useQuotaSafeLocalStorageSession = ({
       release == null ? void 0 : release();
     };
   }, [locks, storageKey, reportDegradation]);
+  const migrate = react.useCallback(
+    (record, current) => {
+      const migrated = parkIncompatibleSessionCommands(record, current);
+      reportDegradation({
+        operation: "migrate",
+        key: storageKey,
+        error: new Error(
+          `${migrated.parked} queued statewire command(s) predate the current protocol range; parked as failed sends`
+        )
+      });
+      return migrated.record;
+    },
+    [reportDegradation, storageKey]
+  );
   const sessionStorage = tap.useResource(
     storage.KeyValueSessionStorage({
       backend: shared.backend,
       key: sessionKey,
       namespace: SESSION_PREFIX,
       protocol: statewireTransport.DEEP_AGENT_STATEWIRE_PROTOCOL,
-      migrate: (record, current) => {
-        const migrated = parkIncompatibleSessionCommands(record, current);
-        reportDegradation({
-          operation: "migrate",
-          key: storageKey,
-          error: new Error(
-            `${migrated.parked} queued statewire command(s) predate the current protocol range; parked as failed sends`
-          )
-        });
-        return migrated.record;
-      },
+      migrate,
       retention: { maxAgeMs: ttl, maxEntries: max },
       // A failure statewire raises itself (a structurally invalid stored
       // record) still stops the session; it is at least reported the same way.
@@ -379,4 +436,5 @@ exports.parkIncompatibleSessionCommands = parkIncompatibleSessionCommands;
 exports.quotaTolerantBackend = quotaTolerantBackend;
 exports.readFailedSendStampsFromRecord = readFailedSendStampsFromRecord;
 exports.readPersistedFailedSendStamps = readPersistedFailedSendStamps;
+exports.retireExpiredSessionRecords = retireExpiredSessionRecords;
 //# sourceMappingURL=quota-safe-local-storage-session.cjs.map

package/dist/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 { resource, useResource } from \"@assistant-ui/tap\";\nimport type { StatewireClient, StatewireProtocol } from \"statewire\";\nimport { KeyValueSessionStorage } from \"statewire/storage\";\nimport { useCallback, useEffect, useMemo, useRef } from \"react\";\nimport { DEEP_AGENT_STATEWIRE_PROTOCOL } from \"./statewire-transport\";\n\nconst SESSION_PREFIX = \"aui:statewire-session:\";\nconst SESSION_LOCK_PREFIX = \"aui:statewire-session-lock:\";\nconst SESSION_ACTIVE_PREFIX = \"aui:statewire-session-active:\";\nconst DAY_MS = 24 * 60 * 60 * 1000;\n/** The stored-record formats the statewire this build ships reads (it writes 3). */\nconst READABLE_STORAGE_VERSIONS: ReadonlySet<unknown> = new Set([1, 2, 3]);\n\n/** Structural view of the browser storage global — this package compiles\n * without the DOM lib (React Native honesty; see `globals.d.ts`). */\ntype StorageLike = {\n  getItem(key: string): string | null;\n  setItem(key: string, value: string): void;\n  removeItem(key: string): void;\n  key(index: number): string | null;\n  readonly length: number;\n};\n\ntype LockGrant = object | null;\n\n/** The Web Locks API surface the session uses (`navigator.locks`). */\ntype LockManagerLike = {\n  request<T>(\n    name: string,\n    callback: (lock: LockGrant) => T | Promise<T>\n  ): Promise<T>;\n  request<T>(\n    name: string,\n    options: { mode?: \"shared\" | \"exclusive\"; ifAvailable?: boolean },\n    callback: (lock: LockGrant) => T | Promise<T>\n  ): Promise<T>;\n};\n\ntype StorageEventLike = { key: string | null };\n\ntype BrowserGlobals = {\n  localStorage?: StorageLike;\n  navigator?: { locks?: LockManagerLike };\n  addEventListener?: (\n    type: \"storage\",\n    listener: (event: StorageEventLike) => void\n  ) => void;\n  removeEventListener?: (\n    type: \"storage\",\n    listener: (event: StorageEventLike) => void\n  ) => void;\n};\n\nconst browserGlobals = globalThis as BrowserGlobals;\n\n/** A persisted session record: per-lane failed entries (a pre-lane record carried them at the root). */\ntype SessionRecordLike = {\n  failed?: unknown;\n  lanes?: Record<string, { failed?: unknown } | null | undefined> | 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: SessionRecordLike | null;\n  try {\n    const raw = storage.getItem(SESSION_PREFIX + sessionKey);\n    record =\n      raw === null ? null : (JSON.parse(raw) as SessionRecordLike | 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: SessionRecordLike | null | undefined\n): ReadonlyMap<string, number> | null {\n  if (!record || typeof record !== \"object\") return null;\n  const stamps = new Map<string, number>();\n  const lanes =\n    record.lanes && typeof record.lanes === \"object\" ? record.lanes : {};\n  const failed = [\n    ...(Array.isArray(record.failed) ? record.failed : []),\n    ...Object.values(lanes).flatMap((lane) =>\n      Array.isArray(lane?.failed) ? lane.failed : []\n    ),\n  ];\n  for (const entry of 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/** A storage operation the session survived by degrading instead of failing. */\nexport type SessionStorageDegradation = {\n  operation:\n    | \"getItem\"\n    | \"setItem\"\n    | \"removeItem\"\n    | \"getAllKeys\"\n    | \"withUnused\"\n    /** The lock manager refused the transaction fence; it ran unfenced. */\n    | \"lock\"\n    /**\n     * The stored record is one this build cannot read (not JSON, or a newer\n     * storage version): served as absent, and the key is shielded from being\n     * overwritten so the record survives this tab.\n     */\n    | \"record\"\n    /** statewire's own storage failure (a structurally invalid stored record). */\n    | \"session\"\n    /**\n     * Queued commands persisted by an earlier statewire build no longer fit\n     * the current wire/protocol range: parked in the lane's failed list (the\n     * send-recovery sweep re-dispatches them) instead of blocking the mount.\n     */\n    | \"migrate\";\n  key: string;\n  error: unknown;\n};\n\ntype ProducedRange = NonNullable<StatewireClient.SessionCommand[\"produced\"]>;\n\nconst inRange = (value: string, range: StatewireProtocol.Range) =>\n  value >= (range.minVersion ?? range.version) && value <= range.version;\n\n/** Mirrors statewire's own stored-command compatibility check. */\nconst storedCommandCompatible = (\n  protocol: string,\n  command: StatewireClient.SessionCommand,\n  current: ProducedRange\n): boolean => {\n  if (\n    !command.produced ||\n    !inRange(command.produced.wire.version, current.wire)\n  )\n    return false;\n  if (current.protocols === \"*\") return true;\n  if (command.produced.protocols === \"*\") return false;\n  const produced = command.produced.protocols.find((p) => p.name === protocol);\n  const offer = current.protocols.find((p) => p.name === protocol);\n  return (\n    produced !== undefined &&\n    offer !== undefined &&\n    inRange(produced.version, offer)\n  );\n};\n\n/**\n * statewire's `migrate` for a record whose queued commands were produced by\n * an earlier build: every incompatible command leaves its lane's queue and is\n * retained as a `lost`/`session-lost` failed send re-stamped with the current\n * range. Client identity, lane clocks, compatible commands and existing failed\n * history are untouched, so the mount proceeds and the send-recovery sweep\n * (or the user, via the failed-send UI) re-dispatches the parked sends under\n * the negotiated format instead of the runtime throwing before it dials.\n *\n * Returns the record itself when nothing needed migrating, and the count of\n * parked commands otherwise.\n */\nexport function parkIncompatibleSessionCommands(\n  record: StatewireClient.SessionRecord,\n  current: ProducedRange,\n  now: number = Date.now()\n): { record: StatewireClient.SessionRecord; parked: number } {\n  let parked = 0;\n  const lanes: Record<string, StatewireClient.SessionLane> = {};\n  for (const [protocol, lane] of Object.entries(record.lanes)) {\n    const kept: StatewireClient.SessionCommand[] = [];\n    const failed: StatewireClient.FailedCommand[] = [];\n    for (const command of lane.commands) {\n      if (storedCommandCompatible(protocol, command, current)) {\n        kept.push(command);\n        continue;\n      }\n      failed.push({\n        protocol,\n        produced: current,\n        command: command.method,\n        params: command.params,\n        ...(command.meta !== undefined && { meta: command.meta }),\n        failure: { fate: \"lost\", cause: \"session-lost\" },\n        ts: now,\n        seq: command.seq,\n      });\n    }\n    parked += failed.length;\n    lanes[protocol] =\n      failed.length === 0\n        ? lane\n        : {\n            ...lane,\n            commands: kept,\n            failed: [...(lane.failed ?? []), ...failed],\n          };\n  }\n  return parked === 0\n    ? { record, parked }\n    : { record: { ...record, lanes }, parked };\n}\n\n/**\n * Whether `error` is the browser refusing a write for lack of room, under\n * every name the engines use — `QuotaExceededError` (Chromium, WebKit, current\n * Firefox), `NS_ERROR_DOM_QUOTA_REACHED` (older Firefox), the legacy\n * `DOMException` codes 22 (WebKit) and 1014 (Firefox) — or a plain error whose\n * message carries one of those (storage proxies and WebViews rewrap the\n * exception). Olympus's `isStorageQuotaError` recognises the same set; the two\n * stay in step.\n */\nexport function isStorageQuotaError(error: unknown): boolean {\n  if (typeof error !== \"object\" || error === null) return false;\n  const { name, code, message } = error as {\n    name?: unknown;\n    code?: unknown;\n    message?: unknown;\n  };\n  return (\n    name === \"QuotaExceededError\" ||\n    name === \"NS_ERROR_DOM_QUOTA_REACHED\" ||\n    code === 22 ||\n    code === 1014 ||\n    (typeof message === \"string\" &&\n      /exceeded the quota|quotaexceedederror|ns_error_dom_quota_reached/i.test(\n        message\n      ))\n  );\n}\n\n/** The one quota shape statewire's retention sweep recognises. */\nfunction asStatewireQuotaError(error: unknown): Error {\n  if (error instanceof Error && error.name === \"QuotaExceededError\")\n    return error;\n  const normalized = new Error(\n    error instanceof Error ? error.message : \"storage quota exceeded\"\n  );\n  normalized.name = \"QuotaExceededError\";\n  return normalized;\n}\n\n/**\n * Why `raw` is a stored record this build cannot read, or `undefined` when it\n * may be one. Mirrors the two decode failures statewire raises for a record it\n * cannot read — invalid JSON, and a `statewireStorageVersion` newer than the\n * ones this build's statewire decodes (a tab left open across a\n * statewire upgrade, reading the record a newer tab keeps) — because statewire\n * throws those out of the resource at mount instead of treating the record as\n * absent. A structurally invalid record of the right version still fails\n * inside statewire.\n */\nfunction unreadableRecord(raw: string): Error | undefined {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch (error) {\n    return error instanceof Error\n      ? error\n      : new Error(\"stored session record is not JSON\");\n  }\n  if (typeof parsed !== \"object\" || parsed === null) {\n    return new Error(\"stored session record is not an object\");\n  }\n  const version = (parsed as { statewireStorageVersion?: unknown })\n    .statewireStorageVersion;\n  if (version !== undefined && !READABLE_STORAGE_VERSIONS.has(version)) {\n    return new Error(\n      `stored session record uses storage version ${String(version)}`\n    );\n  }\n  return undefined;\n}\n\ntype SyncBackend = {\n  getItem: (key: string) => string | null;\n  setItem: (key: string, value: string) => void;\n  removeItem: (key: string) => void;\n  getAllKeys: () => readonly string[];\n  withUnused: (key: string, action: () => Promise<void>) => Promise<void>;\n};\n\n/**\n * The browser backend `@assistant-ui/react-statewire`'s `LocalStorageSession`\n * uses, reproduced here because that resource does not take a backend: raw\n * `localStorage`, with retention cleanup fenced by the same Web Locks so a\n * sweep never removes a record another tab is actively sharing.\n */\nfunction browserBackend({\n  storage,\n  locks,\n}: {\n  storage: StorageLike;\n  locks: LockManagerLike;\n}): SyncBackend {\n  return {\n    getItem: (key) => storage.getItem(key),\n    setItem: (key, value) => storage.setItem(key, value),\n    removeItem: (key) => storage.removeItem(key),\n    getAllKeys: () =>\n      Array.from({ length: storage.length }, (_, index) =>\n        storage.key(index)\n      ).filter((key): key is string => key !== null),\n    withUnused: async (key, action) => {\n      await locks.request(\n        SESSION_ACTIVE_PREFIX + key,\n        { ifAvailable: true },\n        async (active) => {\n          if (active === null) return;\n          await locks.request(\n            SESSION_LOCK_PREFIX + key.slice(SESSION_PREFIX.length),\n            { ifAvailable: true },\n            async (lock) => {\n              if (lock === null) return;\n              await action();\n            }\n          );\n        }\n      );\n    },\n  };\n}\n\n/**\n * Wraps a synchronous key-value backend so a failing origin degrades the\n * session to memory-only persistence instead of stopping the connection.\n *\n * statewire's session storage latches the first unrecognised write failure\n * and from then on rejects every send (`stopped/storage-error`, \"session\n * storage failed\" on the connection chip). It only recovers a\n * `QuotaExceededError` by that exact name — sweeping old session records and\n * retrying the write once — and latches again when the retry fails too. Here\n * the first quota failure per key is surfaced under that name so the sweep\n * runs; the retry that follows it and every other storage failure are absorbed\n * and reported through `onDegraded`, so chat keeps working.\n *\n * An absorbed write is kept in an in-memory overlay that `getItem` serves\n * first: statewire re-reads the record through `load()` on every shared-mode\n * transaction, so a stale persisted copy would otherwise win back its old\n * `nextSeq`, `clientId` and command journal. The overlay is per tab — another\n * tab sharing the thread still reads the last persisted copy, which is the\n * memory-only degradation this backend exists to allow. A later successful\n * write clears the overlay entry.\n *\n * A key whose read threw, or whose stored value this build cannot read (see\n * {@link unreadableRecord}), is served as absent and shielded: writes to it\n * stay in the overlay for good, so a fresh lane minted over an unreadable\n * record never overwrites what another tab or a newer build persisted.\n */\nexport function quotaTolerantBackend({\n  inner,\n  onDegraded,\n}: {\n  inner: SyncBackend;\n  onDegraded: (degradation: SessionStorageDegradation) => void;\n}): SyncBackend & KeyValueSessionStorage.Backend {\n  // Keys whose write already surfaced a quota error to statewire: until a\n  // write succeeds again, later failures on the key are absorbed instead of\n  // surfaced, or every save would re-run statewire's sweep (which evicts\n  // other threads' idle records) and the failure would latch on the retry.\n  const quotaSurfaced = new Set<string>();\n  // Absorbed writes, served ahead of the backend (see the function docs).\n  const overlay = new Map<string, string>();\n  // Keys served as absent and never written through (see the function docs).\n  const shielded = new Set<string>();\n  // statewire re-reads and re-decodes the record on every transaction; the\n  // readability check is memoised on the raw string so it costs one string\n  // comparison per read, not a second parse.\n  const checked = new Map<\n    string,\n    { raw: string; verdict: Error | undefined }\n  >();\n  const readable = (key: string, raw: string): Error | undefined => {\n    const previous = checked.get(key);\n    if (previous !== undefined && previous.raw === raw) return previous.verdict;\n    const verdict = unreadableRecord(raw);\n    checked.set(key, { raw, verdict });\n    return verdict;\n  };\n  return {\n    getItem: (key) => {\n      const shadowed = overlay.get(key);\n      if (shadowed !== undefined) return shadowed;\n      if (shielded.has(key)) return null;\n      let raw: string | null;\n      try {\n        raw = inner.getItem(key);\n      } catch (error) {\n        shielded.add(key);\n        onDegraded({ operation: \"getItem\", key, error });\n        return null;\n      }\n      if (raw === null) return null;\n      const unreadable = readable(key, raw);\n      if (unreadable === undefined) return raw;\n      shielded.add(key);\n      onDegraded({ operation: \"record\", key, error: unreadable });\n      return null;\n    },\n    setItem: (key, value) => {\n      if (shielded.has(key)) {\n        overlay.set(key, value);\n        return;\n      }\n      try {\n        inner.setItem(key, value);\n        overlay.delete(key);\n        quotaSurfaced.delete(key);\n      } catch (error) {\n        if (isStorageQuotaError(error) && !quotaSurfaced.has(key)) {\n          quotaSurfaced.add(key);\n          throw asStatewireQuotaError(error);\n        }\n        overlay.set(key, value);\n        onDegraded({ operation: \"setItem\", key, error });\n      }\n    },\n    removeItem: (key) => {\n      overlay.delete(key);\n      if (shielded.has(key)) return;\n      try {\n        inner.removeItem(key);\n      } catch (error) {\n        onDegraded({ operation: \"removeItem\", key, error });\n      }\n    },\n    getAllKeys: () => {\n      const keys = new Set<string>(overlay.keys());\n      try {\n        for (const key of inner.getAllKeys()) keys.add(key);\n      } catch (error) {\n        onDegraded({ operation: \"getAllKeys\", key: \"\", error });\n      }\n      return [...keys];\n    },\n    withUnused: async (key, action) => {\n      try {\n        await inner.withUnused(key, action);\n      } catch (error) {\n        onDegraded({ operation: \"withUnused\", key, error });\n      }\n    },\n  };\n}\n\n/** A stored record's save stamp, or `undefined` when it carries none. */\nfunction savedAtOf(raw: string | null): number | undefined {\n  if (raw === null) return undefined;\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    return undefined;\n  }\n  if (typeof parsed !== \"object\" || parsed === null) return undefined;\n  const { savedAt, updatedAt } = parsed as {\n    savedAt?: unknown;\n    updatedAt?: unknown;\n  };\n  const stamp = savedAt ?? updatedAt;\n  return typeof stamp === \"number\" && Number.isFinite(stamp)\n    ? stamp\n    : undefined;\n}\n\n/**\n * Removes session records last saved more than `maxAgeMs` ago, skipping the\n * keys mounted in this tab and, through `withUnused`, those another tab holds.\n *\n * statewire's own retention sweep only retires records with nothing queued and\n * nothing failed: a record still carrying an unconfirmed or failed send is\n * exempt from both its age and count bounds, so every thread left with one\n * kept its key forever. Past the TTL those sends are long out of send\n * recovery's auto-retry window, so the record goes the same way an empty one\n * does.\n */\nexport async function retireExpiredSessionRecords({\n  backend,\n  mounted,\n  maxAgeMs,\n  now = Date.now(),\n}: {\n  backend: Pick<\n    SyncBackend,\n    \"getItem\" | \"removeItem\" | \"getAllKeys\" | \"withUnused\"\n  >;\n  mounted: ReadonlyMap<string, number>;\n  maxAgeMs: number;\n  now?: number;\n}): Promise<void> {\n  for (const key of backend.getAllKeys()) {\n    if (!key.startsWith(SESSION_PREFIX) || mounted.has(key)) continue;\n    const savedAt = savedAtOf(backend.getItem(key));\n    if (savedAt === undefined || now - savedAt <= maxAgeMs) continue;\n    await backend.withUnused(key, async () => {\n      if (mounted.has(key) || savedAtOf(backend.getItem(key)) !== savedAt)\n        return;\n      backend.removeItem(key);\n    });\n  }\n}\n\ntype DegradationListener = (degradation: SessionStorageDegradation) => void;\n\ntype SharedBackend = {\n  backend: SyncBackend & KeyValueSessionStorage.Backend;\n  listeners: Set<DegradationListener>;\n  /** Storage keys of the sessions mounted in this tab, with mount counts. */\n  mounted: Map<string, number>;\n};\n\n/**\n * One backend per storage object — per origin, in a browser — shared by every\n * session mounted in the tab, exactly as the upstream resource's module-level\n * backend is. statewire keys its in-tab \"active\" bookkeeping by backend\n * identity, so a mount's retention sweep only skips the records of other\n * mounts on the *same* backend; and the absorbed-write overlay has to outlive\n * a remount of the same thread (a thread switch and back) or the remount would\n * read the stale persisted copy. Degradations fan out to every mounted\n * session's reporter.\n */\nconst sharedBackends = new WeakMap<StorageLike, SharedBackend>();\n\nfunction sharedBackend({\n  storage,\n  locks,\n}: {\n  storage: StorageLike;\n  locks: LockManagerLike;\n}): SharedBackend {\n  let shared = sharedBackends.get(storage);\n  if (shared === undefined) {\n    const listeners = new Set<DegradationListener>();\n    shared = {\n      listeners,\n      mounted: new Map(),\n      backend: quotaTolerantBackend({\n        inner: browserBackend({ storage, locks }),\n        onDegraded: (degradation) => {\n          for (const listener of listeners) listener(degradation);\n        },\n      }),\n    };\n    sharedBackends.set(storage, shared);\n  }\n  return shared;\n}\n\n/**\n * Athena's browser session store: `@assistant-ui/react-statewire`'s\n * `LocalStorageSession` contract (per-thread key under the shared prefix,\n * cross-tab Web Lock, storage-event subscription, retention) on top of\n * {@link quotaTolerantBackend}, with Athena's protocol lane and retention\n * policy.\n */\nconst useQuotaSafeLocalStorageSession = ({\n  threadId,\n  key = (id) => id,\n  ttl = 7 * DAY_MS,\n  max = 50,\n  onStorageDegraded,\n}: QuotaSafeLocalStorageSession.Options): StatewireClient.SessionStorage => {\n  const storage = browserGlobals.localStorage;\n  const locks = browserGlobals.navigator?.locks;\n  if (!storage)\n    throw new Error(\n      \"statewire: QuotaSafeLocalStorageSession requires localStorage\"\n    );\n  if (!locks)\n    throw new Error(\n      \"statewire: QuotaSafeLocalStorageSession requires the Web Locks API (navigator.locks)\"\n    );\n  const sessionKey = key(threadId);\n  const storageKey = SESSION_PREFIX + sessionKey;\n  const lockName = SESSION_LOCK_PREFIX + sessionKey;\n\n  const latestOnDegraded = useRef(onStorageDegraded);\n  latestOnDegraded.current = onStorageDegraded;\n  const reportDegradation = useMemo(() => {\n    const reported = new Set<string>();\n    return (degradation: SessionStorageDegradation) => {\n      const handler = latestOnDegraded.current;\n      if (handler) {\n        try {\n          handler(degradation);\n        } catch {\n          // Reporting runs inside the session's recovery path and must never\n          // become the failure it is reporting.\n        }\n        return;\n      }\n      const dedupeKey = `${degradation.operation}:${degradation.key}`;\n      if (reported.has(dedupeKey)) return;\n      reported.add(dedupeKey);\n      console.warn(\n        `[statewire] session storage degraded to memory only (${degradation.operation} ${degradation.key})`,\n        degradation.error\n      );\n    };\n  }, []);\n\n  const shared = sharedBackend({ storage, locks });\n  // Registered during render as well as in the effect: the read statewire\n  // makes while mounting below happens before any effect runs, and tap may\n  // clean an effect up and re-run it within one commit.\n  shared.listeners.add(reportDegradation);\n  useEffect(() => {\n    shared.listeners.add(reportDegradation);\n    return () => {\n      shared.listeners.delete(reportDegradation);\n    };\n  }, [shared, reportDegradation]);\n\n  useEffect(() => {\n    const { mounted } = shared;\n    mounted.set(storageKey, (mounted.get(storageKey) ?? 0) + 1);\n    retireExpiredSessionRecords({\n      backend: shared.backend,\n      mounted,\n      maxAgeMs: ttl,\n    }).catch((error: unknown) =>\n      reportDegradation({ operation: \"withUnused\", key: storageKey, error })\n    );\n    return () => {\n      const count = (mounted.get(storageKey) ?? 1) - 1;\n      if (count === 0) mounted.delete(storageKey);\n      else mounted.set(storageKey, count);\n    };\n  }, [shared, storageKey, ttl, reportDegradation]);\n\n  // Hold the record's shared \"active\" lock while mounted so another tab's\n  // retention sweep skips it (the same fence the upstream resource holds).\n  useEffect(() => {\n    let release: (() => void) | undefined;\n    let disposed = false;\n    Promise.resolve(\n      locks.request(\n        SESSION_ACTIVE_PREFIX + storageKey,\n        { mode: \"shared\" },\n        () => {\n          if (disposed) return;\n          return new Promise<void>((resolve) => {\n            release = resolve;\n          });\n        }\n      )\n    ).catch((error: unknown) =>\n      reportDegradation({ operation: \"lock\", key: storageKey, error })\n    );\n    return () => {\n      disposed = true;\n      release?.();\n    };\n  }, [locks, storageKey, reportDegradation]);\n\n  // The storage resource includes migrate in its identity. A fresh callback\n  // on every render replaces the store and prevents hydration from settling.\n  const migrate = useCallback<\n    NonNullable<StatewireClient.SessionStorage[\"migrate\"]>\n  >(\n    (record, current) => {\n      const migrated = parkIncompatibleSessionCommands(record, current);\n      reportDegradation({\n        operation: \"migrate\",\n        key: storageKey,\n        error: new Error(\n          `${migrated.parked} queued statewire command(s) predate the current protocol range; parked as failed sends`\n        ),\n      });\n      return migrated.record;\n    },\n    [reportDegradation, storageKey]\n  );\n\n  const sessionStorage = useResource(\n    KeyValueSessionStorage({\n      backend: shared.backend,\n      key: sessionKey,\n      namespace: SESSION_PREFIX,\n      protocol: DEEP_AGENT_STATEWIRE_PROTOCOL,\n      migrate,\n      retention: { maxAgeMs: ttl, maxEntries: max },\n      // A failure statewire raises itself (a structurally invalid stored\n      // record) still stops the session; it is at least reported the same way.\n      onError: (error) =>\n        reportDegradation({ operation: \"session\", key: storageKey, error }),\n    })\n  );\n\n  return useMemo(\n    () => ({\n      ...sessionStorage,\n      lock: async <T>(fn: () => T | Promise<T>): Promise<T> => {\n        let granted = false;\n        try {\n          return await locks.request(lockName, async () => {\n            granted = true;\n            return fn();\n          });\n        } catch (error) {\n          if (granted) throw error;\n          // The lock manager refused the request itself (a detached or\n          // back/forward-cached document, a lockdown-mode origin): the\n          // transaction runs unfenced rather than stopping the session.\n          reportDegradation({ operation: \"lock\", key: storageKey, error });\n          return fn();\n        }\n      },\n      subscribe: (listener: () => void) => {\n        const onStorage = (event: StorageEventLike) => {\n          if (event.key === storageKey) listener();\n        };\n        browserGlobals.addEventListener?.(\"storage\", onStorage);\n        return () => browserGlobals.removeEventListener?.(\"storage\", onStorage);\n      },\n    }),\n    [sessionStorage, locks, storageKey, lockName, reportDegradation]\n  );\n};\n\n/** Athena's browser session keys and retention policy. */\nexport const QuotaSafeLocalStorageSession = resource(\n  useQuotaSafeLocalStorageSession\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     * Called when a storage operation failed and the session carried on in\n     * memory. Defaults to one `console.warn` per operation and key.\n     */\n    onStorageDegraded?: (degradation: SessionStorageDegradation) => void;\n  };\n}\n"],"names":["storage","failed","useRef","useMemo","useEffect","useCallback","useResource","KeyValueSessionStorage","DEEP_AGENT_STATEWIRE_PROTOCOL","_a","resource"],"mappings":"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"}

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

@@ -1,6 +1,6 @@
 import { resource, useResource } from "@assistant-ui/tap";
 import { KeyValueSessionStorage } from "statewire/storage";
-import { useRef, useMemo, useEffect } from "react";
+import { useRef, useMemo, useEffect, useCallback } from "react";
 import { DEEP_AGENT_STATEWIRE_PROTOCOL } from "./statewire-transport.js";
 const SESSION_PREFIX = "aui:statewire-session:";
 const SESSION_LOCK_PREFIX = "aui:statewire-session-lock:";
@@ -27,7 +27,9 @@ function readFailedSendStampsFromRecord(record) {
   const lanes = record.lanes && typeof record.lanes === "object" ? record.lanes : {};
   const failed = [
     ...Array.isArray(record.failed) ? record.failed : [],
-    ...Object.values(lanes).flatMap((lane) => Array.isArray(lane == null ? void 0 : lane.failed) ? lane.failed : [])
+    ...Object.values(lanes).flatMap(
+      (lane) => Array.isArray(lane == null ? void 0 : lane.failed) ? lane.failed : []
+    )
   ];
   for (const entry of failed) {
     const failed2 = entry;
@@ -71,7 +73,11 @@ function parkIncompatibleSessionCommands(record, current, now = Date.now()) {
       });
     }
     parked += failed.length;
-    lanes[protocol] = failed.length === 0 ? lane : { ...lane, commands: kept, failed: [...lane.failed ?? [], ...failed] };
+    lanes[protocol] = failed.length === 0 ? lane : {
+      ...lane,
+      commands: kept,
+      failed: [...lane.failed ?? [], ...failed]
+    };
   }
   return parked === 0 ? { record, parked } : { record: { ...record, lanes }, parked };
 }
@@ -220,6 +226,36 @@ function quotaTolerantBackend({
     }
   };
 }
+function savedAtOf(raw) {
+  if (raw === null) return void 0;
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return void 0;
+  }
+  if (typeof parsed !== "object" || parsed === null) return void 0;
+  const { savedAt, updatedAt } = parsed;
+  const stamp = savedAt ?? updatedAt;
+  return typeof stamp === "number" && Number.isFinite(stamp) ? stamp : void 0;
+}
+async function retireExpiredSessionRecords({
+  backend,
+  mounted,
+  maxAgeMs,
+  now = Date.now()
+}) {
+  for (const key of backend.getAllKeys()) {
+    if (!key.startsWith(SESSION_PREFIX) || mounted.has(key)) continue;
+    const savedAt = savedAtOf(backend.getItem(key));
+    if (savedAt === void 0 || now - savedAt <= maxAgeMs) continue;
+    await backend.withUnused(key, async () => {
+      if (mounted.has(key) || savedAtOf(backend.getItem(key)) !== savedAt)
+        return;
+      backend.removeItem(key);
+    });
+  }
+}
 const sharedBackends = /* @__PURE__ */ new WeakMap();
 function sharedBackend({
   storage,
@@ -230,6 +266,7 @@ function sharedBackend({
     const listeners = /* @__PURE__ */ new Set();
     shared = {
       listeners,
+      mounted: /* @__PURE__ */ new Map(),
       backend: quotaTolerantBackend({
         inner: browserBackend({ storage, locks }),
         onDegraded: (degradation) => {
@@ -292,6 +329,22 @@ const useQuotaSafeLocalStorageSession = ({
       shared.listeners.delete(reportDegradation);
     };
   }, [shared, reportDegradation]);
+  useEffect(() => {
+    const { mounted } = shared;
+    mounted.set(storageKey, (mounted.get(storageKey) ?? 0) + 1);
+    retireExpiredSessionRecords({
+      backend: shared.backend,
+      mounted,
+      maxAgeMs: ttl
+    }).catch(
+      (error) => reportDegradation({ operation: "withUnused", key: storageKey, error })
+    );
+    return () => {
+      const count = (mounted.get(storageKey) ?? 1) - 1;
+      if (count === 0) mounted.delete(storageKey);
+      else mounted.set(storageKey, count);
+    };
+  }, [shared, storageKey, ttl, reportDegradation]);
   useEffect(() => {
     let release;
     let disposed = false;
@@ -314,23 +367,27 @@ const useQuotaSafeLocalStorageSession = ({
       release == null ? void 0 : release();
     };
   }, [locks, storageKey, reportDegradation]);
+  const migrate = useCallback(
+    (record, current) => {
+      const migrated = parkIncompatibleSessionCommands(record, current);
+      reportDegradation({
+        operation: "migrate",
+        key: storageKey,
+        error: new Error(
+          `${migrated.parked} queued statewire command(s) predate the current protocol range; parked as failed sends`
+        )
+      });
+      return migrated.record;
+    },
+    [reportDegradation, storageKey]
+  );
   const sessionStorage = useResource(
     KeyValueSessionStorage({
       backend: shared.backend,
       key: sessionKey,
       namespace: SESSION_PREFIX,
       protocol: DEEP_AGENT_STATEWIRE_PROTOCOL,
-      migrate: (record, current) => {
-        const migrated = parkIncompatibleSessionCommands(record, current);
-        reportDegradation({
-          operation: "migrate",
-          key: storageKey,
-          error: new Error(
-            `${migrated.parked} queued statewire command(s) predate the current protocol range; parked as failed sends`
-          )
-        });
-        return migrated.record;
-      },
+      migrate,
       retention: { maxAgeMs: ttl, maxEntries: max },
       // A failure statewire raises itself (a structurally invalid stored
       // record) still stops the session; it is at least reported the same way.
@@ -377,6 +434,7 @@ export {
   parkIncompatibleSessionCommands,
   quotaTolerantBackend,
   readFailedSendStampsFromRecord,
-  readPersistedFailedSendStamps
+  readPersistedFailedSendStamps,
+  retireExpiredSessionRecords
 };
 //# sourceMappingURL=quota-safe-local-storage-session.js.map

package/dist/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 { resource, useResource } from \"@assistant-ui/tap\";\nimport type { StatewireClient, StatewireProtocol } from \"statewire\";\nimport { KeyValueSessionStorage } from \"statewire/storage\";\nimport { useCallback, useEffect, useMemo, useRef } from \"react\";\nimport { DEEP_AGENT_STATEWIRE_PROTOCOL } from \"./statewire-transport\";\n\nconst SESSION_PREFIX = \"aui:statewire-session:\";\nconst SESSION_LOCK_PREFIX = \"aui:statewire-session-lock:\";\nconst SESSION_ACTIVE_PREFIX = \"aui:statewire-session-active:\";\nconst DAY_MS = 24 * 60 * 60 * 1000;\n/** The stored-record formats the statewire this build ships reads (it writes 3). */\nconst READABLE_STORAGE_VERSIONS: ReadonlySet<unknown> = new Set([1, 2, 3]);\n\n/** Structural view of the browser storage global — this package compiles\n * without the DOM lib (React Native honesty; see `globals.d.ts`). */\ntype StorageLike = {\n  getItem(key: string): string | null;\n  setItem(key: string, value: string): void;\n  removeItem(key: string): void;\n  key(index: number): string | null;\n  readonly length: number;\n};\n\ntype LockGrant = object | null;\n\n/** The Web Locks API surface the session uses (`navigator.locks`). */\ntype LockManagerLike = {\n  request<T>(\n    name: string,\n    callback: (lock: LockGrant) => T | Promise<T>\n  ): Promise<T>;\n  request<T>(\n    name: string,\n    options: { mode?: \"shared\" | \"exclusive\"; ifAvailable?: boolean },\n    callback: (lock: LockGrant) => T | Promise<T>\n  ): Promise<T>;\n};\n\ntype StorageEventLike = { key: string | null };\n\ntype BrowserGlobals = {\n  localStorage?: StorageLike;\n  navigator?: { locks?: LockManagerLike };\n  addEventListener?: (\n    type: \"storage\",\n    listener: (event: StorageEventLike) => void\n  ) => void;\n  removeEventListener?: (\n    type: \"storage\",\n    listener: (event: StorageEventLike) => void\n  ) => void;\n};\n\nconst browserGlobals = globalThis as BrowserGlobals;\n\n/** A persisted session record: per-lane failed entries (a pre-lane record carried them at the root). */\ntype SessionRecordLike = {\n  failed?: unknown;\n  lanes?: Record<string, { failed?: unknown } | null | undefined> | 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: SessionRecordLike | null;\n  try {\n    const raw = storage.getItem(SESSION_PREFIX + sessionKey);\n    record =\n      raw === null ? null : (JSON.parse(raw) as SessionRecordLike | 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: SessionRecordLike | null | undefined\n): ReadonlyMap<string, number> | null {\n  if (!record || typeof record !== \"object\") return null;\n  const stamps = new Map<string, number>();\n  const lanes =\n    record.lanes && typeof record.lanes === \"object\" ? record.lanes : {};\n  const failed = [\n    ...(Array.isArray(record.failed) ? record.failed : []),\n    ...Object.values(lanes).flatMap((lane) =>\n      Array.isArray(lane?.failed) ? lane.failed : []\n    ),\n  ];\n  for (const entry of 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/** A storage operation the session survived by degrading instead of failing. */\nexport type SessionStorageDegradation = {\n  operation:\n    | \"getItem\"\n    | \"setItem\"\n    | \"removeItem\"\n    | \"getAllKeys\"\n    | \"withUnused\"\n    /** The lock manager refused the transaction fence; it ran unfenced. */\n    | \"lock\"\n    /**\n     * The stored record is one this build cannot read (not JSON, or a newer\n     * storage version): served as absent, and the key is shielded from being\n     * overwritten so the record survives this tab.\n     */\n    | \"record\"\n    /** statewire's own storage failure (a structurally invalid stored record). */\n    | \"session\"\n    /**\n     * Queued commands persisted by an earlier statewire build no longer fit\n     * the current wire/protocol range: parked in the lane's failed list (the\n     * send-recovery sweep re-dispatches them) instead of blocking the mount.\n     */\n    | \"migrate\";\n  key: string;\n  error: unknown;\n};\n\ntype ProducedRange = NonNullable<StatewireClient.SessionCommand[\"produced\"]>;\n\nconst inRange = (value: string, range: StatewireProtocol.Range) =>\n  value >= (range.minVersion ?? range.version) && value <= range.version;\n\n/** Mirrors statewire's own stored-command compatibility check. */\nconst storedCommandCompatible = (\n  protocol: string,\n  command: StatewireClient.SessionCommand,\n  current: ProducedRange\n): boolean => {\n  if (\n    !command.produced ||\n    !inRange(command.produced.wire.version, current.wire)\n  )\n    return false;\n  if (current.protocols === \"*\") return true;\n  if (command.produced.protocols === \"*\") return false;\n  const produced = command.produced.protocols.find((p) => p.name === protocol);\n  const offer = current.protocols.find((p) => p.name === protocol);\n  return (\n    produced !== undefined &&\n    offer !== undefined &&\n    inRange(produced.version, offer)\n  );\n};\n\n/**\n * statewire's `migrate` for a record whose queued commands were produced by\n * an earlier build: every incompatible command leaves its lane's queue and is\n * retained as a `lost`/`session-lost` failed send re-stamped with the current\n * range. Client identity, lane clocks, compatible commands and existing failed\n * history are untouched, so the mount proceeds and the send-recovery sweep\n * (or the user, via the failed-send UI) re-dispatches the parked sends under\n * the negotiated format instead of the runtime throwing before it dials.\n *\n * Returns the record itself when nothing needed migrating, and the count of\n * parked commands otherwise.\n */\nexport function parkIncompatibleSessionCommands(\n  record: StatewireClient.SessionRecord,\n  current: ProducedRange,\n  now: number = Date.now()\n): { record: StatewireClient.SessionRecord; parked: number } {\n  let parked = 0;\n  const lanes: Record<string, StatewireClient.SessionLane> = {};\n  for (const [protocol, lane] of Object.entries(record.lanes)) {\n    const kept: StatewireClient.SessionCommand[] = [];\n    const failed: StatewireClient.FailedCommand[] = [];\n    for (const command of lane.commands) {\n      if (storedCommandCompatible(protocol, command, current)) {\n        kept.push(command);\n        continue;\n      }\n      failed.push({\n        protocol,\n        produced: current,\n        command: command.method,\n        params: command.params,\n        ...(command.meta !== undefined && { meta: command.meta }),\n        failure: { fate: \"lost\", cause: \"session-lost\" },\n        ts: now,\n        seq: command.seq,\n      });\n    }\n    parked += failed.length;\n    lanes[protocol] =\n      failed.length === 0\n        ? lane\n        : {\n            ...lane,\n            commands: kept,\n            failed: [...(lane.failed ?? []), ...failed],\n          };\n  }\n  return parked === 0\n    ? { record, parked }\n    : { record: { ...record, lanes }, parked };\n}\n\n/**\n * Whether `error` is the browser refusing a write for lack of room, under\n * every name the engines use — `QuotaExceededError` (Chromium, WebKit, current\n * Firefox), `NS_ERROR_DOM_QUOTA_REACHED` (older Firefox), the legacy\n * `DOMException` codes 22 (WebKit) and 1014 (Firefox) — or a plain error whose\n * message carries one of those (storage proxies and WebViews rewrap the\n * exception). Olympus's `isStorageQuotaError` recognises the same set; the two\n * stay in step.\n */\nexport function isStorageQuotaError(error: unknown): boolean {\n  if (typeof error !== \"object\" || error === null) return false;\n  const { name, code, message } = error as {\n    name?: unknown;\n    code?: unknown;\n    message?: unknown;\n  };\n  return (\n    name === \"QuotaExceededError\" ||\n    name === \"NS_ERROR_DOM_QUOTA_REACHED\" ||\n    code === 22 ||\n    code === 1014 ||\n    (typeof message === \"string\" &&\n      /exceeded the quota|quotaexceedederror|ns_error_dom_quota_reached/i.test(\n        message\n      ))\n  );\n}\n\n/** The one quota shape statewire's retention sweep recognises. */\nfunction asStatewireQuotaError(error: unknown): Error {\n  if (error instanceof Error && error.name === \"QuotaExceededError\")\n    return error;\n  const normalized = new Error(\n    error instanceof Error ? error.message : \"storage quota exceeded\"\n  );\n  normalized.name = \"QuotaExceededError\";\n  return normalized;\n}\n\n/**\n * Why `raw` is a stored record this build cannot read, or `undefined` when it\n * may be one. Mirrors the two decode failures statewire raises for a record it\n * cannot read — invalid JSON, and a `statewireStorageVersion` newer than the\n * ones this build's statewire decodes (a tab left open across a\n * statewire upgrade, reading the record a newer tab keeps) — because statewire\n * throws those out of the resource at mount instead of treating the record as\n * absent. A structurally invalid record of the right version still fails\n * inside statewire.\n */\nfunction unreadableRecord(raw: string): Error | undefined {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch (error) {\n    return error instanceof Error\n      ? error\n      : new Error(\"stored session record is not JSON\");\n  }\n  if (typeof parsed !== \"object\" || parsed === null) {\n    return new Error(\"stored session record is not an object\");\n  }\n  const version = (parsed as { statewireStorageVersion?: unknown })\n    .statewireStorageVersion;\n  if (version !== undefined && !READABLE_STORAGE_VERSIONS.has(version)) {\n    return new Error(\n      `stored session record uses storage version ${String(version)}`\n    );\n  }\n  return undefined;\n}\n\ntype SyncBackend = {\n  getItem: (key: string) => string | null;\n  setItem: (key: string, value: string) => void;\n  removeItem: (key: string) => void;\n  getAllKeys: () => readonly string[];\n  withUnused: (key: string, action: () => Promise<void>) => Promise<void>;\n};\n\n/**\n * The browser backend `@assistant-ui/react-statewire`'s `LocalStorageSession`\n * uses, reproduced here because that resource does not take a backend: raw\n * `localStorage`, with retention cleanup fenced by the same Web Locks so a\n * sweep never removes a record another tab is actively sharing.\n */\nfunction browserBackend({\n  storage,\n  locks,\n}: {\n  storage: StorageLike;\n  locks: LockManagerLike;\n}): SyncBackend {\n  return {\n    getItem: (key) => storage.getItem(key),\n    setItem: (key, value) => storage.setItem(key, value),\n    removeItem: (key) => storage.removeItem(key),\n    getAllKeys: () =>\n      Array.from({ length: storage.length }, (_, index) =>\n        storage.key(index)\n      ).filter((key): key is string => key !== null),\n    withUnused: async (key, action) => {\n      await locks.request(\n        SESSION_ACTIVE_PREFIX + key,\n        { ifAvailable: true },\n        async (active) => {\n          if (active === null) return;\n          await locks.request(\n            SESSION_LOCK_PREFIX + key.slice(SESSION_PREFIX.length),\n            { ifAvailable: true },\n            async (lock) => {\n              if (lock === null) return;\n              await action();\n            }\n          );\n        }\n      );\n    },\n  };\n}\n\n/**\n * Wraps a synchronous key-value backend so a failing origin degrades the\n * session to memory-only persistence instead of stopping the connection.\n *\n * statewire's session storage latches the first unrecognised write failure\n * and from then on rejects every send (`stopped/storage-error`, \"session\n * storage failed\" on the connection chip). It only recovers a\n * `QuotaExceededError` by that exact name — sweeping old session records and\n * retrying the write once — and latches again when the retry fails too. Here\n * the first quota failure per key is surfaced under that name so the sweep\n * runs; the retry that follows it and every other storage failure are absorbed\n * and reported through `onDegraded`, so chat keeps working.\n *\n * An absorbed write is kept in an in-memory overlay that `getItem` serves\n * first: statewire re-reads the record through `load()` on every shared-mode\n * transaction, so a stale persisted copy would otherwise win back its old\n * `nextSeq`, `clientId` and command journal. The overlay is per tab — another\n * tab sharing the thread still reads the last persisted copy, which is the\n * memory-only degradation this backend exists to allow. A later successful\n * write clears the overlay entry.\n *\n * A key whose read threw, or whose stored value this build cannot read (see\n * {@link unreadableRecord}), is served as absent and shielded: writes to it\n * stay in the overlay for good, so a fresh lane minted over an unreadable\n * record never overwrites what another tab or a newer build persisted.\n */\nexport function quotaTolerantBackend({\n  inner,\n  onDegraded,\n}: {\n  inner: SyncBackend;\n  onDegraded: (degradation: SessionStorageDegradation) => void;\n}): SyncBackend & KeyValueSessionStorage.Backend {\n  // Keys whose write already surfaced a quota error to statewire: until a\n  // write succeeds again, later failures on the key are absorbed instead of\n  // surfaced, or every save would re-run statewire's sweep (which evicts\n  // other threads' idle records) and the failure would latch on the retry.\n  const quotaSurfaced = new Set<string>();\n  // Absorbed writes, served ahead of the backend (see the function docs).\n  const overlay = new Map<string, string>();\n  // Keys served as absent and never written through (see the function docs).\n  const shielded = new Set<string>();\n  // statewire re-reads and re-decodes the record on every transaction; the\n  // readability check is memoised on the raw string so it costs one string\n  // comparison per read, not a second parse.\n  const checked = new Map<\n    string,\n    { raw: string; verdict: Error | undefined }\n  >();\n  const readable = (key: string, raw: string): Error | undefined => {\n    const previous = checked.get(key);\n    if (previous !== undefined && previous.raw === raw) return previous.verdict;\n    const verdict = unreadableRecord(raw);\n    checked.set(key, { raw, verdict });\n    return verdict;\n  };\n  return {\n    getItem: (key) => {\n      const shadowed = overlay.get(key);\n      if (shadowed !== undefined) return shadowed;\n      if (shielded.has(key)) return null;\n      let raw: string | null;\n      try {\n        raw = inner.getItem(key);\n      } catch (error) {\n        shielded.add(key);\n        onDegraded({ operation: \"getItem\", key, error });\n        return null;\n      }\n      if (raw === null) return null;\n      const unreadable = readable(key, raw);\n      if (unreadable === undefined) return raw;\n      shielded.add(key);\n      onDegraded({ operation: \"record\", key, error: unreadable });\n      return null;\n    },\n    setItem: (key, value) => {\n      if (shielded.has(key)) {\n        overlay.set(key, value);\n        return;\n      }\n      try {\n        inner.setItem(key, value);\n        overlay.delete(key);\n        quotaSurfaced.delete(key);\n      } catch (error) {\n        if (isStorageQuotaError(error) && !quotaSurfaced.has(key)) {\n          quotaSurfaced.add(key);\n          throw asStatewireQuotaError(error);\n        }\n        overlay.set(key, value);\n        onDegraded({ operation: \"setItem\", key, error });\n      }\n    },\n    removeItem: (key) => {\n      overlay.delete(key);\n      if (shielded.has(key)) return;\n      try {\n        inner.removeItem(key);\n      } catch (error) {\n        onDegraded({ operation: \"removeItem\", key, error });\n      }\n    },\n    getAllKeys: () => {\n      const keys = new Set<string>(overlay.keys());\n      try {\n        for (const key of inner.getAllKeys()) keys.add(key);\n      } catch (error) {\n        onDegraded({ operation: \"getAllKeys\", key: \"\", error });\n      }\n      return [...keys];\n    },\n    withUnused: async (key, action) => {\n      try {\n        await inner.withUnused(key, action);\n      } catch (error) {\n        onDegraded({ operation: \"withUnused\", key, error });\n      }\n    },\n  };\n}\n\n/** A stored record's save stamp, or `undefined` when it carries none. */\nfunction savedAtOf(raw: string | null): number | undefined {\n  if (raw === null) return undefined;\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    return undefined;\n  }\n  if (typeof parsed !== \"object\" || parsed === null) return undefined;\n  const { savedAt, updatedAt } = parsed as {\n    savedAt?: unknown;\n    updatedAt?: unknown;\n  };\n  const stamp = savedAt ?? updatedAt;\n  return typeof stamp === \"number\" && Number.isFinite(stamp)\n    ? stamp\n    : undefined;\n}\n\n/**\n * Removes session records last saved more than `maxAgeMs` ago, skipping the\n * keys mounted in this tab and, through `withUnused`, those another tab holds.\n *\n * statewire's own retention sweep only retires records with nothing queued and\n * nothing failed: a record still carrying an unconfirmed or failed send is\n * exempt from both its age and count bounds, so every thread left with one\n * kept its key forever. Past the TTL those sends are long out of send\n * recovery's auto-retry window, so the record goes the same way an empty one\n * does.\n */\nexport async function retireExpiredSessionRecords({\n  backend,\n  mounted,\n  maxAgeMs,\n  now = Date.now(),\n}: {\n  backend: Pick<\n    SyncBackend,\n    \"getItem\" | \"removeItem\" | \"getAllKeys\" | \"withUnused\"\n  >;\n  mounted: ReadonlyMap<string, number>;\n  maxAgeMs: number;\n  now?: number;\n}): Promise<void> {\n  for (const key of backend.getAllKeys()) {\n    if (!key.startsWith(SESSION_PREFIX) || mounted.has(key)) continue;\n    const savedAt = savedAtOf(backend.getItem(key));\n    if (savedAt === undefined || now - savedAt <= maxAgeMs) continue;\n    await backend.withUnused(key, async () => {\n      if (mounted.has(key) || savedAtOf(backend.getItem(key)) !== savedAt)\n        return;\n      backend.removeItem(key);\n    });\n  }\n}\n\ntype DegradationListener = (degradation: SessionStorageDegradation) => void;\n\ntype SharedBackend = {\n  backend: SyncBackend & KeyValueSessionStorage.Backend;\n  listeners: Set<DegradationListener>;\n  /** Storage keys of the sessions mounted in this tab, with mount counts. */\n  mounted: Map<string, number>;\n};\n\n/**\n * One backend per storage object — per origin, in a browser — shared by every\n * session mounted in the tab, exactly as the upstream resource's module-level\n * backend is. statewire keys its in-tab \"active\" bookkeeping by backend\n * identity, so a mount's retention sweep only skips the records of other\n * mounts on the *same* backend; and the absorbed-write overlay has to outlive\n * a remount of the same thread (a thread switch and back) or the remount would\n * read the stale persisted copy. Degradations fan out to every mounted\n * session's reporter.\n */\nconst sharedBackends = new WeakMap<StorageLike, SharedBackend>();\n\nfunction sharedBackend({\n  storage,\n  locks,\n}: {\n  storage: StorageLike;\n  locks: LockManagerLike;\n}): SharedBackend {\n  let shared = sharedBackends.get(storage);\n  if (shared === undefined) {\n    const listeners = new Set<DegradationListener>();\n    shared = {\n      listeners,\n      mounted: new Map(),\n      backend: quotaTolerantBackend({\n        inner: browserBackend({ storage, locks }),\n        onDegraded: (degradation) => {\n          for (const listener of listeners) listener(degradation);\n        },\n      }),\n    };\n    sharedBackends.set(storage, shared);\n  }\n  return shared;\n}\n\n/**\n * Athena's browser session store: `@assistant-ui/react-statewire`'s\n * `LocalStorageSession` contract (per-thread key under the shared prefix,\n * cross-tab Web Lock, storage-event subscription, retention) on top of\n * {@link quotaTolerantBackend}, with Athena's protocol lane and retention\n * policy.\n */\nconst useQuotaSafeLocalStorageSession = ({\n  threadId,\n  key = (id) => id,\n  ttl = 7 * DAY_MS,\n  max = 50,\n  onStorageDegraded,\n}: QuotaSafeLocalStorageSession.Options): StatewireClient.SessionStorage => {\n  const storage = browserGlobals.localStorage;\n  const locks = browserGlobals.navigator?.locks;\n  if (!storage)\n    throw new Error(\n      \"statewire: QuotaSafeLocalStorageSession requires localStorage\"\n    );\n  if (!locks)\n    throw new Error(\n      \"statewire: QuotaSafeLocalStorageSession requires the Web Locks API (navigator.locks)\"\n    );\n  const sessionKey = key(threadId);\n  const storageKey = SESSION_PREFIX + sessionKey;\n  const lockName = SESSION_LOCK_PREFIX + sessionKey;\n\n  const latestOnDegraded = useRef(onStorageDegraded);\n  latestOnDegraded.current = onStorageDegraded;\n  const reportDegradation = useMemo(() => {\n    const reported = new Set<string>();\n    return (degradation: SessionStorageDegradation) => {\n      const handler = latestOnDegraded.current;\n      if (handler) {\n        try {\n          handler(degradation);\n        } catch {\n          // Reporting runs inside the session's recovery path and must never\n          // become the failure it is reporting.\n        }\n        return;\n      }\n      const dedupeKey = `${degradation.operation}:${degradation.key}`;\n      if (reported.has(dedupeKey)) return;\n      reported.add(dedupeKey);\n      console.warn(\n        `[statewire] session storage degraded to memory only (${degradation.operation} ${degradation.key})`,\n        degradation.error\n      );\n    };\n  }, []);\n\n  const shared = sharedBackend({ storage, locks });\n  // Registered during render as well as in the effect: the read statewire\n  // makes while mounting below happens before any effect runs, and tap may\n  // clean an effect up and re-run it within one commit.\n  shared.listeners.add(reportDegradation);\n  useEffect(() => {\n    shared.listeners.add(reportDegradation);\n    return () => {\n      shared.listeners.delete(reportDegradation);\n    };\n  }, [shared, reportDegradation]);\n\n  useEffect(() => {\n    const { mounted } = shared;\n    mounted.set(storageKey, (mounted.get(storageKey) ?? 0) + 1);\n    retireExpiredSessionRecords({\n      backend: shared.backend,\n      mounted,\n      maxAgeMs: ttl,\n    }).catch((error: unknown) =>\n      reportDegradation({ operation: \"withUnused\", key: storageKey, error })\n    );\n    return () => {\n      const count = (mounted.get(storageKey) ?? 1) - 1;\n      if (count === 0) mounted.delete(storageKey);\n      else mounted.set(storageKey, count);\n    };\n  }, [shared, storageKey, ttl, reportDegradation]);\n\n  // Hold the record's shared \"active\" lock while mounted so another tab's\n  // retention sweep skips it (the same fence the upstream resource holds).\n  useEffect(() => {\n    let release: (() => void) | undefined;\n    let disposed = false;\n    Promise.resolve(\n      locks.request(\n        SESSION_ACTIVE_PREFIX + storageKey,\n        { mode: \"shared\" },\n        () => {\n          if (disposed) return;\n          return new Promise<void>((resolve) => {\n            release = resolve;\n          });\n        }\n      )\n    ).catch((error: unknown) =>\n      reportDegradation({ operation: \"lock\", key: storageKey, error })\n    );\n    return () => {\n      disposed = true;\n      release?.();\n    };\n  }, [locks, storageKey, reportDegradation]);\n\n  // The storage resource includes migrate in its identity. A fresh callback\n  // on every render replaces the store and prevents hydration from settling.\n  const migrate = useCallback<\n    NonNullable<StatewireClient.SessionStorage[\"migrate\"]>\n  >(\n    (record, current) => {\n      const migrated = parkIncompatibleSessionCommands(record, current);\n      reportDegradation({\n        operation: \"migrate\",\n        key: storageKey,\n        error: new Error(\n          `${migrated.parked} queued statewire command(s) predate the current protocol range; parked as failed sends`\n        ),\n      });\n      return migrated.record;\n    },\n    [reportDegradation, storageKey]\n  );\n\n  const sessionStorage = useResource(\n    KeyValueSessionStorage({\n      backend: shared.backend,\n      key: sessionKey,\n      namespace: SESSION_PREFIX,\n      protocol: DEEP_AGENT_STATEWIRE_PROTOCOL,\n      migrate,\n      retention: { maxAgeMs: ttl, maxEntries: max },\n      // A failure statewire raises itself (a structurally invalid stored\n      // record) still stops the session; it is at least reported the same way.\n      onError: (error) =>\n        reportDegradation({ operation: \"session\", key: storageKey, error }),\n    })\n  );\n\n  return useMemo(\n    () => ({\n      ...sessionStorage,\n      lock: async <T>(fn: () => T | Promise<T>): Promise<T> => {\n        let granted = false;\n        try {\n          return await locks.request(lockName, async () => {\n            granted = true;\n            return fn();\n          });\n        } catch (error) {\n          if (granted) throw error;\n          // The lock manager refused the request itself (a detached or\n          // back/forward-cached document, a lockdown-mode origin): the\n          // transaction runs unfenced rather than stopping the session.\n          reportDegradation({ operation: \"lock\", key: storageKey, error });\n          return fn();\n        }\n      },\n      subscribe: (listener: () => void) => {\n        const onStorage = (event: StorageEventLike) => {\n          if (event.key === storageKey) listener();\n        };\n        browserGlobals.addEventListener?.(\"storage\", onStorage);\n        return () => browserGlobals.removeEventListener?.(\"storage\", onStorage);\n      },\n    }),\n    [sessionStorage, locks, storageKey, lockName, reportDegradation]\n  );\n};\n\n/** Athena's browser session keys and retention policy. */\nexport const QuotaSafeLocalStorageSession = resource(\n  useQuotaSafeLocalStorageSession\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     * Called when a storage operation failed and the session carried on in\n     * memory. Defaults to one `console.warn` per operation and key.\n     */\n    onStorageDegraded?: (degradation: SessionStorageDegradation) => void;\n  };\n}\n"],"names":["failed","_a"],"mappings":"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"}