@athenaintel/react 0.18.0 → 0.20.0

package/dist/runtime/statewire-run-config.cjs

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const DEEP_AGENT_RUNTIME_MARKER = "athena_deep_agent";
+const STATEWIRE_START_CHANNEL = "web";
+const STATEWIRE_RUN_LABEL = "Athena SDK";
+const DEFAULT_STATEWIRE_MODEL = "claude-sonnet-5";
+const COLLAB_AGENT_REF_PREFIX = "collab_agent:";
+const COLLAB_AGENT_REF_SHAPE = "collab_agent:<asset_id>";
+function parseCollabAgentRef(agent) {
+  if (typeof agent !== "string" || !agent.startsWith(COLLAB_AGENT_REF_PREFIX)) return null;
+  const assetId = agent.slice(COLLAB_AGENT_REF_PREFIX.length).trim();
+  return assetId || null;
+}
+function resolveAgentProp({ agent }) {
+  if (agent === void 0 || agent === null || agent.trim() === "") return null;
+  const assetId = parseCollabAgentRef(agent.trim());
+  if (assetId) return assetId;
+  throw new Error(
+    `[AthenaSDK] Unsupported \`agent\` prop ${JSON.stringify(agent)}. The only accepted shape is '${COLLAB_AGENT_REF_SHAPE}' (the asset id of a published collab agent). Named agents are not supported — the statewire host always runs the Athena deep agent; omit \`agent\` to use it.`
+  );
+}
+function buildStatewireRunConfig(options = {}) {
+  var _a, _b, _c, _d, _e;
+  const collabAgentId = resolveAgentProp({ agent: options.agent });
+  const collabChannelId = collabAgentId && ((_a = options.channel) == null ? void 0 : _a.trim()) ? options.channel.trim() : void 0;
+  const model = options.model ?? (collabAgentId ? void 0 : DEFAULT_STATEWIRE_MODEL);
+  const panelModel = model ?? DEFAULT_STATEWIRE_MODEL;
+  const enabledTools = Array.from(
+    /* @__PURE__ */ new Set([...options.tools ?? [], ...options.frontendToolIds ?? []])
+  );
+  const systemPrompt = ((_b = options.systemPrompt) == null ? void 0 : _b.trim()) ?? "";
+  return {
+    custom: {
+      runtime: DEEP_AGENT_RUNTIME_MARKER,
+      // With a collab channel selected, omit the SDK's own 'web' stamp: the
+      // request's explicit start_channel would win over the backend overlay's
+      // kind-mapped provenance (a custom SMS channel must stamp 'sms').
+      ...collabChannelId ? {} : { start_channel: STATEWIRE_START_CHANNEL },
+      ...model ? { model } : {},
+      // An empty list is behavior-identical to an absent key for the parser
+      // (both coerce to []), but the collab-agent overlay merges request keys
+      // OVER the agent definition — so an explicit empty list would erase the
+      // agent's configured tools. Omit it when empty.
+      ...enabledTools.length > 0 ? { enabled_tools: enabledTools } : {},
+      panel_config: {
+        model: panelModel,
+        enabled_tools: enabledTools,
+        system_prompt: systemPrompt,
+        run_label: STATEWIRE_RUN_LABEL
+      },
+      ...collabAgentId ? { collab_agent_id: collabAgentId } : {},
+      ...collabChannelId ? { collab_channel_id: collabChannelId } : {},
+      ...systemPrompt ? { system_prompt: systemPrompt } : {},
+      ...((_c = options.workbench) == null ? void 0 : _c.length) ? { workbench: options.workbench } : {},
+      ...((_d = options.knowledgeBase) == null ? void 0 : _d.length) ? { knowledge_base: options.knowledgeBase } : {},
+      ...options.appId ? { app_id: options.appId } : {},
+      ...((_e = options.clientTools) == null ? void 0 : _e.length) ? { client_tools: options.clientTools } : {},
+      ...options.extraRunConfig ?? {}
+    }
+  };
+}
+exports.COLLAB_AGENT_REF_PREFIX = COLLAB_AGENT_REF_PREFIX;
+exports.COLLAB_AGENT_REF_SHAPE = COLLAB_AGENT_REF_SHAPE;
+exports.DEFAULT_STATEWIRE_MODEL = DEFAULT_STATEWIRE_MODEL;
+exports.buildStatewireRunConfig = buildStatewireRunConfig;
+exports.parseCollabAgentRef = parseCollabAgentRef;
+exports.resolveAgentProp = resolveAgentProp;
+//# sourceMappingURL=statewire-run-config.cjs.map

package/dist/runtime/statewire-run-config.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"statewire-run-config.cjs","sources":["../../src/runtime/statewire-run-config.ts"],"sourcesContent":["/** Runtime marker the deep-agent session substrate stamps on sessions. */\nconst DEEP_AGENT_RUNTIME_MARKER = 'athena_deep_agent';\n\n/** Session-origin channel. The backend clamps unknown values to 'web', which\n *  is how every SDK-started session has always classified. */\nconst STATEWIRE_START_CHANNEL = 'web';\n\n/** Session label persisted in the thread's panel config (mirrors\n *  'Athena Chrome' / 'Athena mobile' in the sibling statewire hosts). */\nconst STATEWIRE_RUN_LABEL = 'Athena SDK';\n\n/** Deep-agent default model — matches the Olympus and mobile statewire hosts. */\nexport const DEFAULT_STATEWIRE_MODEL = 'claude-sonnet-5';\n\n/** Agent-id namespace for collab agents (`collab_agent:<asset_id>`). */\nexport const COLLAB_AGENT_REF_PREFIX = 'collab_agent:';\n\n/** The only shape the `agent` prop accepts, for error messages and docs. */\nexport const COLLAB_AGENT_REF_SHAPE = 'collab_agent:<asset_id>';\n\n/** The asset id when `agent` is a `collab_agent:<asset_id>` ref, else null. */\nexport function parseCollabAgentRef(agent: string | undefined | null): string | null {\n  if (typeof agent !== 'string' || !agent.startsWith(COLLAB_AGENT_REF_PREFIX)) return null;\n  const assetId = agent.slice(COLLAB_AGENT_REF_PREFIX.length).trim();\n  return assetId || null;\n}\n\n/**\n * Resolve the provider's `agent` prop to a collab-agent asset id.\n *\n * An omitted or blank `agent` means \"no agent selected\" — the thread runs the\n * Athena deep agent — and resolves to `null`. A `collab_agent:<asset_id>` ref\n * resolves to the asset id. Any other non-blank value throws: the statewire\n * host cannot honour it, and a selector that is silently dropped would let a\n * misconfigured deployment ship answers from the wrong agent.\n */\nexport function resolveAgentProp({ agent }: { agent: string | undefined | null }): string | null {\n  if (agent === undefined || agent === null || agent.trim() === '') return null;\n  const assetId = parseCollabAgentRef(agent.trim());\n  if (assetId) return assetId;\n  throw new Error(\n    `[AthenaSDK] Unsupported \\`agent\\` prop ${JSON.stringify(agent)}. The only accepted shape is '${COLLAB_AGENT_REF_SHAPE}' (the asset id of a published collab agent). Named agents are not supported — the statewire host always runs the Athena deep agent; omit \\`agent\\` to use it.`,\n  );\n}\n\nexport interface StatewireRunConfigOptions {\n  /** LLM model identifier. Defaults to the deep-agent default model — unless a\n   *  collab agent is selected and its author set one (the backend overlay\n   *  applies the agent's model when the run sends none), in which case no\n   *  model is sent so the agent's choice wins. */\n  model?: string;\n  /** Agent selector. Only the `collab_agent:<asset_id>` shape is accepted: the\n   *  run executes AS that published collab agent (prompt, tools, model\n   *  default). Any other non-empty value throws (see {@link resolveAgentProp}). */\n  agent?: string;\n  /** Collab-agent channel id (built-in like `email`/`sms`, or a user-defined\n   *  custom channel id) selecting that channel's configuration overrides.\n   *  Sent as `collab_channel_id`; only meaningful with a collab `agent`. */\n  channel?: string;\n  /** Backend toolkit IDs to enable. */\n  tools?: string[];\n  /** Frontend tool IDs to include in enabled_tools. */\n  frontendToolIds?: string[];\n  /** Asset IDs to include in the workbench. */\n  workbench?: string[];\n  /** Knowledge base IDs for RAG context. */\n  knowledgeBase?: string[];\n  /** System prompt override. */\n  systemPrompt?: string;\n  /** Client app identifier, passed through as app_id. */\n  appId?: string;\n  /** Client-executed tool declarations, passed through as client_tools. The\n   *  deep-agent runtime binds each as an interrupt-backed tool the client\n   *  answers via the statewire client-tool bridge. */\n  clientTools?: Record<string, unknown>[];\n  /** Additional fields merged into runConfig.custom. */\n  extraRunConfig?: Record<string, unknown>;\n}\n\n/**\n * Build the `runConfig` a deep-agent statewire run is driven by. Commands\n * travel bare on the statewire channel, so this payload rides the ambient\n * model context (`config.runConfig`) instead of the request body.\n *\n * The flattened `custom` fields drive the run, while `panel_config` carries a\n * minimal panel state the backend persists per thread and replays on the\n * statewire snapshot — so a session started from the SDK stays configured\n * when reopened elsewhere.\n */\nexport function buildStatewireRunConfig(\n  options: StatewireRunConfigOptions = {},\n): Record<string, unknown> {\n  const collabAgentId = resolveAgentProp({ agent: options.agent });\n  const collabChannelId =\n    collabAgentId && options.channel?.trim() ? options.channel.trim() : undefined;\n  // With a collab agent selected and no explicit model, send NO model: the\n  // backend overlay then applies the model the agent's author configured\n  // instead of the SDK default overriding it.\n  const model = options.model ?? (collabAgentId ? undefined : DEFAULT_STATEWIRE_MODEL);\n  const panelModel = model ?? DEFAULT_STATEWIRE_MODEL;\n  const enabledTools = Array.from(\n    new Set([...(options.tools ?? []), ...(options.frontendToolIds ?? [])]),\n  );\n  const systemPrompt = options.systemPrompt?.trim() ?? '';\n\n  return {\n    custom: {\n      runtime: DEEP_AGENT_RUNTIME_MARKER,\n      // With a collab channel selected, omit the SDK's own 'web' stamp: the\n      // request's explicit start_channel would win over the backend overlay's\n      // kind-mapped provenance (a custom SMS channel must stamp 'sms').\n      ...(collabChannelId ? {} : { start_channel: STATEWIRE_START_CHANNEL }),\n      ...(model ? { model } : {}),\n      // An empty list is behavior-identical to an absent key for the parser\n      // (both coerce to []), but the collab-agent overlay merges request keys\n      // OVER the agent definition — so an explicit empty list would erase the\n      // agent's configured tools. Omit it when empty.\n      ...(enabledTools.length > 0 ? { enabled_tools: enabledTools } : {}),\n      panel_config: {\n        model: panelModel,\n        enabled_tools: enabledTools,\n        system_prompt: systemPrompt,\n        run_label: STATEWIRE_RUN_LABEL,\n      },\n      ...(collabAgentId ? { collab_agent_id: collabAgentId } : {}),\n      ...(collabChannelId ? { collab_channel_id: collabChannelId } : {}),\n      ...(systemPrompt ? { system_prompt: systemPrompt } : {}),\n      ...(options.workbench?.length ? { workbench: options.workbench } : {}),\n      ...(options.knowledgeBase?.length\n        ? { knowledge_base: options.knowledgeBase }\n        : {}),\n      ...(options.appId ? { app_id: options.appId } : {}),\n      ...(options.clientTools?.length ? { client_tools: options.clientTools } : {}),\n      ...(options.extraRunConfig ?? {}),\n    },\n  };\n}\n"],"names":[],"mappings":";;AACA,MAAM,4BAA4B;AAIlC,MAAM,0BAA0B;AAIhC,MAAM,sBAAsB;AAGrB,MAAM,0BAA0B;AAGhC,MAAM,0BAA0B;AAGhC,MAAM,yBAAyB;AAG/B,SAAS,oBAAoB,OAAiD;AACnF,MAAI,OAAO,UAAU,YAAY,CAAC,MAAM,WAAW,uBAAuB,EAAG,QAAO;AACpF,QAAM,UAAU,MAAM,MAAM,wBAAwB,MAAM,EAAE,KAAA;AAC5D,SAAO,WAAW;AACpB;AAWO,SAAS,iBAAiB,EAAE,SAA8D;AAC/F,MAAI,UAAU,UAAa,UAAU,QAAQ,MAAM,KAAA,MAAW,GAAI,QAAO;AACzE,QAAM,UAAU,oBAAoB,MAAM,KAAA,CAAM;AAChD,MAAI,QAAS,QAAO;AACpB,QAAM,IAAI;AAAA,IACR,0CAA0C,KAAK,UAAU,KAAK,CAAC,iCAAiC,sBAAsB;AAAA,EAAA;AAE1H;AA8CO,SAAS,wBACd,UAAqC,IACZ;;AACzB,QAAM,gBAAgB,iBAAiB,EAAE,OAAO,QAAQ,OAAO;AAC/D,QAAM,kBACJ,mBAAiB,aAAQ,YAAR,mBAAiB,UAAS,QAAQ,QAAQ,KAAA,IAAS;AAItE,QAAM,QAAQ,QAAQ,UAAU,gBAAgB,SAAY;AAC5D,QAAM,aAAa,SAAS;AAC5B,QAAM,eAAe,MAAM;AAAA,IACzB,oBAAI,IAAI,CAAC,GAAI,QAAQ,SAAS,CAAA,GAAK,GAAI,QAAQ,mBAAmB,EAAG,CAAC;AAAA,EAAA;AAExE,QAAM,iBAAe,aAAQ,iBAAR,mBAAsB,WAAU;AAErD,SAAO;AAAA,IACL,QAAQ;AAAA,MACN,SAAS;AAAA;AAAA;AAAA;AAAA,MAIT,GAAI,kBAAkB,CAAA,IAAK,EAAE,eAAe,wBAAA;AAAA,MAC5C,GAAI,QAAQ,EAAE,MAAA,IAAU,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAKxB,GAAI,aAAa,SAAS,IAAI,EAAE,eAAe,aAAA,IAAiB,CAAA;AAAA,MAChE,cAAc;AAAA,QACZ,OAAO;AAAA,QACP,eAAe;AAAA,QACf,eAAe;AAAA,QACf,WAAW;AAAA,MAAA;AAAA,MAEb,GAAI,gBAAgB,EAAE,iBAAiB,cAAA,IAAkB,CAAA;AAAA,MACzD,GAAI,kBAAkB,EAAE,mBAAmB,gBAAA,IAAoB,CAAA;AAAA,MAC/D,GAAI,eAAe,EAAE,eAAe,aAAA,IAAiB,CAAA;AAAA,MACrD,KAAI,aAAQ,cAAR,mBAAmB,UAAS,EAAE,WAAW,QAAQ,UAAA,IAAc,CAAA;AAAA,MACnE,KAAI,aAAQ,kBAAR,mBAAuB,UACvB,EAAE,gBAAgB,QAAQ,cAAA,IAC1B,CAAA;AAAA,MACJ,GAAI,QAAQ,QAAQ,EAAE,QAAQ,QAAQ,MAAA,IAAU,CAAA;AAAA,MAChD,KAAI,aAAQ,gBAAR,mBAAqB,UAAS,EAAE,cAAc,QAAQ,YAAA,IAAgB,CAAA;AAAA,MAC1E,GAAI,QAAQ,kBAAkB,CAAA;AAAA,IAAC;AAAA,EACjC;AAEJ;;;;;;;"}

package/dist/runtime/statewire-run-config.js

@@ -0,0 +1,68 @@
+const DEEP_AGENT_RUNTIME_MARKER = "athena_deep_agent";
+const STATEWIRE_START_CHANNEL = "web";
+const STATEWIRE_RUN_LABEL = "Athena SDK";
+const DEFAULT_STATEWIRE_MODEL = "claude-sonnet-5";
+const COLLAB_AGENT_REF_PREFIX = "collab_agent:";
+const COLLAB_AGENT_REF_SHAPE = "collab_agent:<asset_id>";
+function parseCollabAgentRef(agent) {
+  if (typeof agent !== "string" || !agent.startsWith(COLLAB_AGENT_REF_PREFIX)) return null;
+  const assetId = agent.slice(COLLAB_AGENT_REF_PREFIX.length).trim();
+  return assetId || null;
+}
+function resolveAgentProp({ agent }) {
+  if (agent === void 0 || agent === null || agent.trim() === "") return null;
+  const assetId = parseCollabAgentRef(agent.trim());
+  if (assetId) return assetId;
+  throw new Error(
+    `[AthenaSDK] Unsupported \`agent\` prop ${JSON.stringify(agent)}. The only accepted shape is '${COLLAB_AGENT_REF_SHAPE}' (the asset id of a published collab agent). Named agents are not supported — the statewire host always runs the Athena deep agent; omit \`agent\` to use it.`
+  );
+}
+function buildStatewireRunConfig(options = {}) {
+  var _a, _b, _c, _d, _e;
+  const collabAgentId = resolveAgentProp({ agent: options.agent });
+  const collabChannelId = collabAgentId && ((_a = options.channel) == null ? void 0 : _a.trim()) ? options.channel.trim() : void 0;
+  const model = options.model ?? (collabAgentId ? void 0 : DEFAULT_STATEWIRE_MODEL);
+  const panelModel = model ?? DEFAULT_STATEWIRE_MODEL;
+  const enabledTools = Array.from(
+    /* @__PURE__ */ new Set([...options.tools ?? [], ...options.frontendToolIds ?? []])
+  );
+  const systemPrompt = ((_b = options.systemPrompt) == null ? void 0 : _b.trim()) ?? "";
+  return {
+    custom: {
+      runtime: DEEP_AGENT_RUNTIME_MARKER,
+      // With a collab channel selected, omit the SDK's own 'web' stamp: the
+      // request's explicit start_channel would win over the backend overlay's
+      // kind-mapped provenance (a custom SMS channel must stamp 'sms').
+      ...collabChannelId ? {} : { start_channel: STATEWIRE_START_CHANNEL },
+      ...model ? { model } : {},
+      // An empty list is behavior-identical to an absent key for the parser
+      // (both coerce to []), but the collab-agent overlay merges request keys
+      // OVER the agent definition — so an explicit empty list would erase the
+      // agent's configured tools. Omit it when empty.
+      ...enabledTools.length > 0 ? { enabled_tools: enabledTools } : {},
+      panel_config: {
+        model: panelModel,
+        enabled_tools: enabledTools,
+        system_prompt: systemPrompt,
+        run_label: STATEWIRE_RUN_LABEL
+      },
+      ...collabAgentId ? { collab_agent_id: collabAgentId } : {},
+      ...collabChannelId ? { collab_channel_id: collabChannelId } : {},
+      ...systemPrompt ? { system_prompt: systemPrompt } : {},
+      ...((_c = options.workbench) == null ? void 0 : _c.length) ? { workbench: options.workbench } : {},
+      ...((_d = options.knowledgeBase) == null ? void 0 : _d.length) ? { knowledge_base: options.knowledgeBase } : {},
+      ...options.appId ? { app_id: options.appId } : {},
+      ...((_e = options.clientTools) == null ? void 0 : _e.length) ? { client_tools: options.clientTools } : {},
+      ...options.extraRunConfig ?? {}
+    }
+  };
+}
+export {
+  COLLAB_AGENT_REF_PREFIX,
+  COLLAB_AGENT_REF_SHAPE,
+  DEFAULT_STATEWIRE_MODEL,
+  buildStatewireRunConfig,
+  parseCollabAgentRef,
+  resolveAgentProp
+};
+//# sourceMappingURL=statewire-run-config.js.map

package/dist/runtime/statewire-run-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statewire-run-config.js","sources":["../../src/runtime/statewire-run-config.ts"],"sourcesContent":["/** Runtime marker the deep-agent session substrate stamps on sessions. */\nconst DEEP_AGENT_RUNTIME_MARKER = 'athena_deep_agent';\n\n/** Session-origin channel. The backend clamps unknown values to 'web', which\n *  is how every SDK-started session has always classified. */\nconst STATEWIRE_START_CHANNEL = 'web';\n\n/** Session label persisted in the thread's panel config (mirrors\n *  'Athena Chrome' / 'Athena mobile' in the sibling statewire hosts). */\nconst STATEWIRE_RUN_LABEL = 'Athena SDK';\n\n/** Deep-agent default model — matches the Olympus and mobile statewire hosts. */\nexport const DEFAULT_STATEWIRE_MODEL = 'claude-sonnet-5';\n\n/** Agent-id namespace for collab agents (`collab_agent:<asset_id>`). */\nexport const COLLAB_AGENT_REF_PREFIX = 'collab_agent:';\n\n/** The only shape the `agent` prop accepts, for error messages and docs. */\nexport const COLLAB_AGENT_REF_SHAPE = 'collab_agent:<asset_id>';\n\n/** The asset id when `agent` is a `collab_agent:<asset_id>` ref, else null. */\nexport function parseCollabAgentRef(agent: string | undefined | null): string | null {\n  if (typeof agent !== 'string' || !agent.startsWith(COLLAB_AGENT_REF_PREFIX)) return null;\n  const assetId = agent.slice(COLLAB_AGENT_REF_PREFIX.length).trim();\n  return assetId || null;\n}\n\n/**\n * Resolve the provider's `agent` prop to a collab-agent asset id.\n *\n * An omitted or blank `agent` means \"no agent selected\" — the thread runs the\n * Athena deep agent — and resolves to `null`. A `collab_agent:<asset_id>` ref\n * resolves to the asset id. Any other non-blank value throws: the statewire\n * host cannot honour it, and a selector that is silently dropped would let a\n * misconfigured deployment ship answers from the wrong agent.\n */\nexport function resolveAgentProp({ agent }: { agent: string | undefined | null }): string | null {\n  if (agent === undefined || agent === null || agent.trim() === '') return null;\n  const assetId = parseCollabAgentRef(agent.trim());\n  if (assetId) return assetId;\n  throw new Error(\n    `[AthenaSDK] Unsupported \\`agent\\` prop ${JSON.stringify(agent)}. The only accepted shape is '${COLLAB_AGENT_REF_SHAPE}' (the asset id of a published collab agent). Named agents are not supported — the statewire host always runs the Athena deep agent; omit \\`agent\\` to use it.`,\n  );\n}\n\nexport interface StatewireRunConfigOptions {\n  /** LLM model identifier. Defaults to the deep-agent default model — unless a\n   *  collab agent is selected and its author set one (the backend overlay\n   *  applies the agent's model when the run sends none), in which case no\n   *  model is sent so the agent's choice wins. */\n  model?: string;\n  /** Agent selector. Only the `collab_agent:<asset_id>` shape is accepted: the\n   *  run executes AS that published collab agent (prompt, tools, model\n   *  default). Any other non-empty value throws (see {@link resolveAgentProp}). */\n  agent?: string;\n  /** Collab-agent channel id (built-in like `email`/`sms`, or a user-defined\n   *  custom channel id) selecting that channel's configuration overrides.\n   *  Sent as `collab_channel_id`; only meaningful with a collab `agent`. */\n  channel?: string;\n  /** Backend toolkit IDs to enable. */\n  tools?: string[];\n  /** Frontend tool IDs to include in enabled_tools. */\n  frontendToolIds?: string[];\n  /** Asset IDs to include in the workbench. */\n  workbench?: string[];\n  /** Knowledge base IDs for RAG context. */\n  knowledgeBase?: string[];\n  /** System prompt override. */\n  systemPrompt?: string;\n  /** Client app identifier, passed through as app_id. */\n  appId?: string;\n  /** Client-executed tool declarations, passed through as client_tools. The\n   *  deep-agent runtime binds each as an interrupt-backed tool the client\n   *  answers via the statewire client-tool bridge. */\n  clientTools?: Record<string, unknown>[];\n  /** Additional fields merged into runConfig.custom. */\n  extraRunConfig?: Record<string, unknown>;\n}\n\n/**\n * Build the `runConfig` a deep-agent statewire run is driven by. Commands\n * travel bare on the statewire channel, so this payload rides the ambient\n * model context (`config.runConfig`) instead of the request body.\n *\n * The flattened `custom` fields drive the run, while `panel_config` carries a\n * minimal panel state the backend persists per thread and replays on the\n * statewire snapshot — so a session started from the SDK stays configured\n * when reopened elsewhere.\n */\nexport function buildStatewireRunConfig(\n  options: StatewireRunConfigOptions = {},\n): Record<string, unknown> {\n  const collabAgentId = resolveAgentProp({ agent: options.agent });\n  const collabChannelId =\n    collabAgentId && options.channel?.trim() ? options.channel.trim() : undefined;\n  // With a collab agent selected and no explicit model, send NO model: the\n  // backend overlay then applies the model the agent's author configured\n  // instead of the SDK default overriding it.\n  const model = options.model ?? (collabAgentId ? undefined : DEFAULT_STATEWIRE_MODEL);\n  const panelModel = model ?? DEFAULT_STATEWIRE_MODEL;\n  const enabledTools = Array.from(\n    new Set([...(options.tools ?? []), ...(options.frontendToolIds ?? [])]),\n  );\n  const systemPrompt = options.systemPrompt?.trim() ?? '';\n\n  return {\n    custom: {\n      runtime: DEEP_AGENT_RUNTIME_MARKER,\n      // With a collab channel selected, omit the SDK's own 'web' stamp: the\n      // request's explicit start_channel would win over the backend overlay's\n      // kind-mapped provenance (a custom SMS channel must stamp 'sms').\n      ...(collabChannelId ? {} : { start_channel: STATEWIRE_START_CHANNEL }),\n      ...(model ? { model } : {}),\n      // An empty list is behavior-identical to an absent key for the parser\n      // (both coerce to []), but the collab-agent overlay merges request keys\n      // OVER the agent definition — so an explicit empty list would erase the\n      // agent's configured tools. Omit it when empty.\n      ...(enabledTools.length > 0 ? { enabled_tools: enabledTools } : {}),\n      panel_config: {\n        model: panelModel,\n        enabled_tools: enabledTools,\n        system_prompt: systemPrompt,\n        run_label: STATEWIRE_RUN_LABEL,\n      },\n      ...(collabAgentId ? { collab_agent_id: collabAgentId } : {}),\n      ...(collabChannelId ? { collab_channel_id: collabChannelId } : {}),\n      ...(systemPrompt ? { system_prompt: systemPrompt } : {}),\n      ...(options.workbench?.length ? { workbench: options.workbench } : {}),\n      ...(options.knowledgeBase?.length\n        ? { knowledge_base: options.knowledgeBase }\n        : {}),\n      ...(options.appId ? { app_id: options.appId } : {}),\n      ...(options.clientTools?.length ? { client_tools: options.clientTools } : {}),\n      ...(options.extraRunConfig ?? {}),\n    },\n  };\n}\n"],"names":[],"mappings":"AACA,MAAM,4BAA4B;AAIlC,MAAM,0BAA0B;AAIhC,MAAM,sBAAsB;AAGrB,MAAM,0BAA0B;AAGhC,MAAM,0BAA0B;AAGhC,MAAM,yBAAyB;AAG/B,SAAS,oBAAoB,OAAiD;AACnF,MAAI,OAAO,UAAU,YAAY,CAAC,MAAM,WAAW,uBAAuB,EAAG,QAAO;AACpF,QAAM,UAAU,MAAM,MAAM,wBAAwB,MAAM,EAAE,KAAA;AAC5D,SAAO,WAAW;AACpB;AAWO,SAAS,iBAAiB,EAAE,SAA8D;AAC/F,MAAI,UAAU,UAAa,UAAU,QAAQ,MAAM,KAAA,MAAW,GAAI,QAAO;AACzE,QAAM,UAAU,oBAAoB,MAAM,KAAA,CAAM;AAChD,MAAI,QAAS,QAAO;AACpB,QAAM,IAAI;AAAA,IACR,0CAA0C,KAAK,UAAU,KAAK,CAAC,iCAAiC,sBAAsB;AAAA,EAAA;AAE1H;AA8CO,SAAS,wBACd,UAAqC,IACZ;AA1F3B;AA2FE,QAAM,gBAAgB,iBAAiB,EAAE,OAAO,QAAQ,OAAO;AAC/D,QAAM,kBACJ,mBAAiB,aAAQ,YAAR,mBAAiB,UAAS,QAAQ,QAAQ,KAAA,IAAS;AAItE,QAAM,QAAQ,QAAQ,UAAU,gBAAgB,SAAY;AAC5D,QAAM,aAAa,SAAS;AAC5B,QAAM,eAAe,MAAM;AAAA,IACzB,oBAAI,IAAI,CAAC,GAAI,QAAQ,SAAS,CAAA,GAAK,GAAI,QAAQ,mBAAmB,EAAG,CAAC;AAAA,EAAA;AAExE,QAAM,iBAAe,aAAQ,iBAAR,mBAAsB,WAAU;AAErD,SAAO;AAAA,IACL,QAAQ;AAAA,MACN,SAAS;AAAA;AAAA;AAAA;AAAA,MAIT,GAAI,kBAAkB,CAAA,IAAK,EAAE,eAAe,wBAAA;AAAA,MAC5C,GAAI,QAAQ,EAAE,MAAA,IAAU,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAKxB,GAAI,aAAa,SAAS,IAAI,EAAE,eAAe,aAAA,IAAiB,CAAA;AAAA,MAChE,cAAc;AAAA,QACZ,OAAO;AAAA,QACP,eAAe;AAAA,QACf,eAAe;AAAA,QACf,WAAW;AAAA,MAAA;AAAA,MAEb,GAAI,gBAAgB,EAAE,iBAAiB,cAAA,IAAkB,CAAA;AAAA,MACzD,GAAI,kBAAkB,EAAE,mBAAmB,gBAAA,IAAoB,CAAA;AAAA,MAC/D,GAAI,eAAe,EAAE,eAAe,aAAA,IAAiB,CAAA;AAAA,MACrD,KAAI,aAAQ,cAAR,mBAAmB,UAAS,EAAE,WAAW,QAAQ,UAAA,IAAc,CAAA;AAAA,MACnE,KAAI,aAAQ,kBAAR,mBAAuB,UACvB,EAAE,gBAAgB,QAAQ,cAAA,IAC1B,CAAA;AAAA,MACJ,GAAI,QAAQ,QAAQ,EAAE,QAAQ,QAAQ,MAAA,IAAU,CAAA;AAAA,MAChD,KAAI,aAAQ,gBAAR,mBAAqB,UAAS,EAAE,cAAc,QAAQ,YAAA,IAAgB,CAAA;AAAA,MAC1E,GAAI,QAAQ,kBAAkB,CAAA;AAAA,IAAC;AAAA,EACjC;AAEJ;"}

package/dist/runtime/statewire-session-key.cjs

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function statewireSessionKey({
+  syncUrl,
+  principal,
+  threadId
+}) {
+  return `${syncUrl}:${principal || "anon"}:${threadId}`;
+}
+exports.statewireSessionKey = statewireSessionKey;
+//# sourceMappingURL=statewire-session-key.cjs.map

package/dist/runtime/statewire-session-key.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"statewire-session-key.cjs","sources":["../../src/runtime/statewire-session-key.ts"],"sourcesContent":["/**\n * Scope of the persisted statewire command lane: the sync host, the signed-in\n * principal, and the thread. A thread id is only meaningful against the\n * backend that minted it, and a shared browser must never resend one user's\n * un-settled commands under the next user's token — so the key carries WHO is\n * signed in as well as where. The principal is a non-secret user id;\n * API-key-only hosts (no auth provider above) share one anonymous scope.\n */\nexport function statewireSessionKey({\n  syncUrl,\n  principal,\n  threadId,\n}: {\n  syncUrl: string;\n  principal: string;\n  threadId: string;\n}): string {\n  return `${syncUrl}:${principal || 'anon'}:${threadId}`;\n}\n"],"names":[],"mappings":";;AAQO,SAAS,oBAAoB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AACF,GAIW;AACT,SAAO,GAAG,OAAO,IAAI,aAAa,MAAM,IAAI,QAAQ;AACtD;;"}

package/dist/runtime/statewire-session-key.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Scope of the persisted statewire command lane: the sync host, the signed-in
+ * principal, and the thread. A thread id is only meaningful against the
+ * backend that minted it, and a shared browser must never resend one user's
+ * un-settled commands under the next user's token — so the key carries WHO is
+ * signed in as well as where. The principal is a non-secret user id;
+ * API-key-only hosts (no auth provider above) share one anonymous scope.
+ */
+export declare function statewireSessionKey({ syncUrl, principal, threadId, }: {
+    syncUrl: string;
+    principal: string;
+    threadId: string;
+}): string;

package/dist/runtime/statewire-session-key.js

@@ -0,0 +1,11 @@
+function statewireSessionKey({
+  syncUrl,
+  principal,
+  threadId
+}) {
+  return `${syncUrl}:${principal || "anon"}:${threadId}`;
+}
+export {
+  statewireSessionKey
+};
+//# sourceMappingURL=statewire-session-key.js.map

package/dist/runtime/statewire-session-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statewire-session-key.js","sources":["../../src/runtime/statewire-session-key.ts"],"sourcesContent":["/**\n * Scope of the persisted statewire command lane: the sync host, the signed-in\n * principal, and the thread. A thread id is only meaningful against the\n * backend that minted it, and a shared browser must never resend one user's\n * un-settled commands under the next user's token — so the key carries WHO is\n * signed in as well as where. The principal is a non-secret user id;\n * API-key-only hosts (no auth provider above) share one anonymous scope.\n */\nexport function statewireSessionKey({\n  syncUrl,\n  principal,\n  threadId,\n}: {\n  syncUrl: string;\n  principal: string;\n  threadId: string;\n}): string {\n  return `${syncUrl}:${principal || 'anon'}:${threadId}`;\n}\n"],"names":[],"mappings":"AAQO,SAAS,oBAAoB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AACF,GAIW;AACT,SAAO,GAAG,OAAO,IAAI,aAAa,MAAM,IAAI,QAAQ;AACtD;"}

package/dist/runtime/useAthenaStatewireRuntime.cjs

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react$1 = require("@assistant-ui/react");
+const runconfigContract = require("../packages/agent-runtime/src/generated/runconfig-contract.cjs");
+const react = require("react");
+require("@assistant-ui/tap");
+require("statewire");
+const errors = require("../packages/agent-runtime/src/errors.cjs");
+require("../packages/agent-runtime/src/statewire-suspended.cjs");
+require("@tanstack/react-query");
+require("../packages/agent-runtime/src/statewire-state.cjs");
+require("../packages/agent-runtime/src/messages.cjs");
+require("@assistant-ui/react-statewire");
+require("@assistant-ui/store");
+require("@assistant-ui/react-statewire/local-storage");
+require("../packages/agent-runtime/src/statewire-attach-observer.cjs");
+require("../packages/agent-runtime/src/thread-status.cjs");
+const useDeepAgentRuntime = require("../packages/agent-runtime/src/use-deep-agent-runtime.cjs");
+require("@assistant-ui/core");
+const AthenaAuthContext = require("../auth/AthenaAuthContext.cjs");
+const statewireClientTools = require("../chat/statewire-client-tools.cjs");
+const athenaDiagnostics = require("../diagnostics/athena-diagnostics.cjs");
+const statewireAuthHeaders = require("./statewire-auth-headers.cjs");
+const statewireSessionKey = require("./statewire-session-key.cjs");
+const statewireRunConfig = require("./statewire-run-config.cjs");
+const ATHENA_SDK_MESSAGE_WINDOW = {
+  size: runconfigContract.DEEP_AGENT_DEFAULT_MESSAGE_WINDOW
+};
+const EMPTY_TOOLKIT = {};
+const EMPTY_TOOL_IDS = [];
+function useStatewireClientTools(frontendToolkit) {
+  return react.useMemo(
+    () => statewireClientTools.collectStatewireClientTools(frontendToolkit ?? EMPTY_TOOLKIT),
+    [frontendToolkit]
+  );
+}
+function useAthenaStatewireRuntime(config) {
+  var _a;
+  const {
+    syncUrl,
+    threadId,
+    isNewChat = false,
+    apiKey,
+    token,
+    getToken,
+    model,
+    agent,
+    channel,
+    tools = EMPTY_TOOL_IDS,
+    frontendToolIds = EMPTY_TOOL_IDS,
+    frontendToolkit = EMPTY_TOOLKIT,
+    workbench,
+    knowledgeBase,
+    systemPrompt,
+    appId,
+    extraRunConfig,
+    snapshotCache,
+    messageWindow = ATHENA_SDK_MESSAGE_WINDOW,
+    toolOutputs,
+    onError,
+    onConnectionChange,
+    onRawConnectionChange,
+    onRunningChange
+  } = config;
+  statewireRunConfig.resolveAgentProp({ agent });
+  const clientTools = useStatewireClientTools(frontendToolkit);
+  const authContext = react.useContext(AthenaAuthContext.AthenaAuthContext);
+  const principal = ((_a = authContext == null ? void 0 : authContext.user) == null ? void 0 : _a.userId) ?? "";
+  const attachSpanRef = react.useRef(null);
+  const attachThreadRef = react.useRef(null);
+  if (attachThreadRef.current !== threadId) {
+    attachThreadRef.current = threadId;
+    attachSpanRef.current = athenaDiagnostics.athenaDiagnostics.span(
+      `statewire.attach:${threadId}`,
+      "statewire.attach.start",
+      { thread_id: threadId, is_new_chat: isNewChat }
+    );
+  }
+  const auiTools = react.useMemo(() => react$1.Tools({ toolkit: frontendToolkit }), [frontendToolkit]);
+  const useSdkClient = (thread) => react$1.useAui({ thread, tools: auiTools });
+  return useDeepAgentRuntime.useDeepAgentRuntime({
+    surface: "AthenaSDK",
+    threadId,
+    baseUrl: syncUrl,
+    // Option closures are re-read per render by the core, so credential
+    // rotation (new `token`/`getToken`/`apiKey` props) reaches the next
+    // request without remounting the thread. The transport's `staleAuth`
+    // (true right after a refused credential) is forwarded as `force`.
+    headers: (ctx) => statewireAuthHeaders.resolveStatewireAuthHeaders({ apiKey, token, getToken }, ctx),
+    isNewChat,
+    // Queued entries render in the SDK's queue panel, so only the steer lane
+    // projects into the message tail.
+    laneProjection: "steer-only",
+    // Durable session: a reload resumes the lane and resends whatever the
+    // server has not marked durable. Scoped by host AND principal — a thread
+    // id is only meaningful against the backend that minted it, and a stored
+    // lane must never resend against another signed-in user. (Consumers
+    // server-render this SDK; the core's availability probe keeps those
+    // sessions process-local, as before the seam existed.)
+    session: {
+      kind: "local-storage",
+      key: (id) => statewireSessionKey.statewireSessionKey({ syncUrl, principal, threadId: id })
+    },
+    snapshotCache,
+    // Windowed hello (see `ATHENA_SDK_MESSAGE_WINDOW`): the tail of the
+    // transcript instead of every message; the chat UI's history edge pages
+    // older ranges in and fetches cut tool outputs into `toolOutputs`.
+    messageWindow,
+    toolOutputs,
+    capabilities: { edit: true, reload: true, continue: true },
+    useClient: useSdkClient,
+    onStateChange: () => {
+      const endSpan = attachSpanRef.current;
+      if (endSpan) {
+        attachSpanRef.current = null;
+        endSpan("statewire.snapshot", { data: { thread_id: threadId } });
+      }
+    },
+    onConnectionChange: (connection) => {
+      athenaDiagnostics.athenaDiagnostics.gauge("statewire.connection", (connection == null ? void 0 : connection.status) ?? null);
+      if ((connection == null ? void 0 : connection.status) === "stopped") {
+        athenaDiagnostics.athenaDiagnostics.emit("statewire.connection", {
+          level: "warn",
+          data: {
+            status: connection.status,
+            reason: connection.reason,
+            message: connection.message
+          }
+        });
+      }
+      onConnectionChange == null ? void 0 : onConnectionChange(connection);
+    },
+    onRawConnectionChange,
+    onRunningChange,
+    // The runConfig getter is pulled at command-send time through the core's
+    // per-render ref, so it reads the latest props — consumers commonly pass
+    // fresh array literals per render, which must not thrash the registration
+    // (no `key`: the provider registers once per client).
+    runConfig: {
+      get: () => statewireRunConfig.buildStatewireRunConfig({
+        model,
+        agent,
+        channel,
+        tools,
+        frontendToolIds,
+        workbench,
+        knowledgeBase,
+        systemPrompt,
+        appId,
+        extraRunConfig,
+        clientTools: statewireClientTools.statewireClientToolWireEntries(clientTools)
+      })
+    },
+    onError: (error) => {
+      if (!errors.isStatewireChannelTeardown(error)) {
+        athenaDiagnostics.athenaDiagnostics.error(
+          "statewire.error",
+          error,
+          {
+            code: "statewire_rejected",
+            message: "The statewire host rejected a command",
+            hint: "Inspect error.detail — agora rejections carry a structured {code, message}."
+          },
+          { thread_id: threadId }
+        );
+      }
+      if (onError) {
+        onError(error);
+        return;
+      }
+      useDeepAgentRuntime.logUnhandledStatewireError("AthenaSDK", error);
+    }
+  });
+}
+exports.DEFAULT_STATEWIRE_MODEL = statewireRunConfig.DEFAULT_STATEWIRE_MODEL;
+exports.ATHENA_SDK_MESSAGE_WINDOW = ATHENA_SDK_MESSAGE_WINDOW;
+exports.useAthenaStatewireRuntime = useAthenaStatewireRuntime;
+exports.useStatewireClientTools = useStatewireClientTools;
+//# sourceMappingURL=useAthenaStatewireRuntime.cjs.map

package/dist/runtime/useAthenaStatewireRuntime.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAthenaStatewireRuntime.cjs","sources":["../../src/runtime/useAthenaStatewireRuntime.ts"],"sourcesContent":["import type { AssistantClient, Toolkit } from '@assistant-ui/react';\nimport { Tools, useAui } from '@assistant-ui/react';\nimport {\n  DEEP_AGENT_DEFAULT_MESSAGE_WINDOW,\n  type DeepAgentMessageWindowDeclaration,\n  type DeepAgentThreadElement,\n  type DeepAgentThreadSnapshotCache,\n  type DeepAgentToolOutputStore,\n  isStatewireChannelTeardown,\n  logUnhandledStatewireError,\n  type RegisteredClientTool,\n  useDeepAgentRuntime,\n  type UseDeepAgentThreadOptions,\n} from '@athenaintel/agent-runtime';\nimport { useContext, useMemo, useRef } from 'react';\nimport { AthenaAuthContext } from '../auth/AthenaAuthContext';\nimport {\n  collectStatewireClientTools,\n  statewireClientToolWireEntries,\n} from '../chat/statewire-client-tools';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport {\n  type AthenaStatewireTokenGetter,\n  resolveStatewireAuthHeaders,\n} from './statewire-auth-headers';\nimport { statewireSessionKey } from './statewire-session-key';\n\ntype AthenaDiagnosticsSpanStarter = typeof athenaDiagnostics.span;\nimport {\n  buildStatewireRunConfig,\n  DEFAULT_STATEWIRE_MODEL,\n  resolveAgentProp,\n} from './statewire-run-config';\n\nexport { DEFAULT_STATEWIRE_MODEL };\n\n/**\n * The message window every SDK attach declares (`x-athena-deep-agent-window`):\n * the hello carries the transcript's tail plus the `messagesWindow` lane\n * instead of every message — megabytes on long threads, over the 1 MiB frame\n * limit of stock websocket clients. Older pages load from the\n * `StatewireHistoryEdge` row the chat UI mounts above the messages, and cut\n * tool outputs are fetched back for the cards that show them.\n */\nexport const ATHENA_SDK_MESSAGE_WINDOW: DeepAgentMessageWindowDeclaration = {\n  size: DEEP_AGENT_DEFAULT_MESSAGE_WINDOW,\n};\n\nexport interface AthenaStatewireRuntimeConfig {\n  /** Base URL of the statewire sync host (the `…/v2/threads` mount). */\n  syncUrl: string;\n  /** Thread ID the statewire session attaches to. */\n  threadId: string;\n  /** True only for a never-started local chat. Existing (or pre-assigned)\n   *  threads load until their server snapshot arrives. */\n  isNewChat?: boolean;\n  /** API key for authentication. Used when no auth token is provided. */\n  apiKey?: string;\n  /** Auth token. Takes priority over apiKey. */\n  token?: string | null;\n  /** Resolve the latest token immediately before a request (for expiring\n   *  clients). Called with `{ force: true }` right after the host refused the\n   *  previous credential (the transport's `staleAuth`), so a caching getter\n   *  mints a fresh token instead of returning the refused one. */\n  getToken?: AthenaStatewireTokenGetter;\n  /**\n   * Per-provider LRU of each thread's last wire state. A switch back to a\n   * remembered thread mounts with that snapshot and projects ready on the\n   * first frame instead of a loading treatment; the attach snapshot then\n   * replaces it. Owned above the per-thread mount so it survives switches.\n   */\n  snapshotCache?: DeepAgentThreadSnapshotCache;\n  /**\n   * The message window declared on the attach (see\n   * {@link ATHENA_SDK_MESSAGE_WINDOW}, the default). `false` keeps the full\n   * snapshot for a host that renders no history loader.\n   */\n  messageWindow?: DeepAgentMessageWindowDeclaration | false;\n  /**\n   * Full tool outputs fetched back for a windowed wire's cut tool messages;\n   * the thread re-converts when one lands. `AthenaProvider` owns one per\n   * provider and hands the same store to `StatewireHistoryEdge`.\n   */\n  toolOutputs?: DeepAgentToolOutputStore;\n  /** LLM model identifier. Defaults to the deep-agent default model. */\n  model?: string;\n  /** Agent selector: only `collab_agent:<asset_id>` refs are accepted (the run\n   *  executes AS that published collab agent). Any other non-empty value\n   *  throws — see `resolveAgentProp`. */\n  agent?: string;\n  /** Collab-agent channel id selecting that channel's overrides. */\n  channel?: string;\n  /** Backend toolkit IDs to enable. */\n  tools?: string[];\n  /** Frontend tool IDs to include in enabled_tools. */\n  frontendToolIds?: string[];\n  /** Frontend tools registered on the assistant client. Tools with a local\n   *  `execute` are also declared as `client_tools` and executed through the\n   *  statewire client-tool bridge. */\n  frontendToolkit?: Toolkit;\n  /** Asset IDs to include in the workbench. */\n  workbench?: string[];\n  /** Knowledge base IDs for RAG context. */\n  knowledgeBase?: string[];\n  /** System prompt override. */\n  systemPrompt?: string;\n  /** Client app identifier for session filtering. Sent as app_id in runConfig.custom. */\n  appId?: string;\n  /** Additional fields merged into runConfig.custom. */\n  extraRunConfig?: Record<string, unknown>;\n  /** Called on statewire transport errors (send rejections, stream failures). */\n  onError?: (error: Error) => void;\n  /** Projected connection status changes (deduped; null on unmount). */\n  onConnectionChange?: UseDeepAgentThreadOptions['onConnectionChange'];\n  /** Raw connection observer — carries the transport's reconnect handle. */\n  onRawConnectionChange?: UseDeepAgentThreadOptions['onRawConnectionChange'];\n  /** Notified when a run starts/stops. */\n  onRunningChange?: UseDeepAgentThreadOptions['onRunningChange'];\n}\n\nconst EMPTY_TOOLKIT: Toolkit = {};\nconst EMPTY_TOOL_IDS: string[] = [];\n\n/** The client tools derived from the runtime's frontend toolkit — exposed so\n *  the provider can mount the client-tool bridge with the same set. */\nexport function useStatewireClientTools(\n  frontendToolkit: Toolkit | undefined,\n): RegisteredClientTool[] {\n  return useMemo(\n    () => collectStatewireClientTools(frontendToolkit ?? EMPTY_TOOLKIT),\n    [frontendToolkit],\n  );\n}\n\n/**\n * Statewire runtime for the Athena SDK — a thin shim over the shared\n * `@athenaintel/agent-runtime` `useDeepAgentRuntime`: it attaches to the\n * agora-hosted deep-agent thread at `${syncUrl}/${threadId}` and returns the\n * `AssistantClient` to mount via `AuiProvider` — the same integration shape as\n * the Olympus, Chrome extension, Office, and mobile statewire hosts.\n *\n * Auth: a token (resolved live through `getToken` when provided) rides\n * `Authorization: Bearer`, and an API key falls back to `X-API-KEY` — both\n * accepted by the statewire host.\n */\nexport function useAthenaStatewireRuntime(\n  config: AthenaStatewireRuntimeConfig,\n): AssistantClient {\n  const {\n    syncUrl,\n    threadId,\n    isNewChat = false,\n    apiKey,\n    token,\n    getToken,\n    model,\n    agent,\n    channel,\n    tools = EMPTY_TOOL_IDS,\n    frontendToolIds = EMPTY_TOOL_IDS,\n    frontendToolkit = EMPTY_TOOLKIT,\n    workbench,\n    knowledgeBase,\n    systemPrompt,\n    appId,\n    extraRunConfig,\n    snapshotCache,\n    messageWindow = ATHENA_SDK_MESSAGE_WINDOW,\n    toolOutputs,\n    onError,\n    onConnectionChange,\n    onRawConnectionChange,\n    onRunningChange,\n  } = config;\n\n  // Fail loud at mount, not at first send: the statewire host always runs the\n  // Athena deep agent, so an `agent` outside the collab_agent namespace can\n  // never apply. Throwing here (render time) is what makes a misconfigured\n  // integration visible instead of quietly answering as the wrong agent.\n  resolveAgentProp({ agent });\n\n  const clientTools = useStatewireClientTools(frontendToolkit);\n\n  // The persisted command lane is keyed by WHO is signed in as well as by host\n  // and thread (see `statewireSessionKey`).\n  const authContext = useContext(AthenaAuthContext);\n  const principal = authContext?.user?.userId ?? '';\n\n  // Attach → first server snapshot span, keyed per thread attach.\n  const attachSpanRef = useRef<ReturnType<AthenaDiagnosticsSpanStarter> | null>(null);\n  const attachThreadRef = useRef<string | null>(null);\n  if (attachThreadRef.current !== threadId) {\n    attachThreadRef.current = threadId;\n    attachSpanRef.current = athenaDiagnostics.span(\n      `statewire.attach:${threadId}`,\n      'statewire.attach.start',\n      { thread_id: threadId, is_new_chat: isNewChat },\n    );\n  }\n\n  const auiTools = useMemo(() => Tools({ toolkit: frontendToolkit }), [frontendToolkit]);\n  // Web client for the shared runtime core (a `use*` name so the\n  // rules-of-hooks lint sees the `useAui` call inside a custom hook; the core\n  // invokes it unconditionally every render).\n  const useSdkClient = (thread: DeepAgentThreadElement) => useAui({ thread, tools: auiTools });\n\n  return useDeepAgentRuntime({\n    surface: 'AthenaSDK',\n    threadId,\n    baseUrl: syncUrl,\n    // Option closures are re-read per render by the core, so credential\n    // rotation (new `token`/`getToken`/`apiKey` props) reaches the next\n    // request without remounting the thread. The transport's `staleAuth`\n    // (true right after a refused credential) is forwarded as `force`.\n    headers: (ctx) => resolveStatewireAuthHeaders({ apiKey, token, getToken }, ctx),\n    isNewChat,\n    // Queued entries render in the SDK's queue panel, so only the steer lane\n    // projects into the message tail.\n    laneProjection: 'steer-only',\n    // Durable session: a reload resumes the lane and resends whatever the\n    // server has not marked durable. Scoped by host AND principal — a thread\n    // id is only meaningful against the backend that minted it, and a stored\n    // lane must never resend against another signed-in user. (Consumers\n    // server-render this SDK; the core's availability probe keeps those\n    // sessions process-local, as before the seam existed.)\n    session: {\n      kind: 'local-storage',\n      key: (id) => statewireSessionKey({ syncUrl, principal, threadId: id }),\n    },\n    snapshotCache,\n    // Windowed hello (see `ATHENA_SDK_MESSAGE_WINDOW`): the tail of the\n    // transcript instead of every message; the chat UI's history edge pages\n    // older ranges in and fetches cut tool outputs into `toolOutputs`.\n    messageWindow,\n    toolOutputs,\n    capabilities: { edit: true, reload: true, continue: true },\n    useClient: useSdkClient,\n    onStateChange: () => {\n      // First snapshot for this attach ends the attach span (time-to-history).\n      const endSpan = attachSpanRef.current;\n      if (endSpan) {\n        attachSpanRef.current = null;\n        endSpan('statewire.snapshot', { data: { thread_id: threadId } });\n      }\n    },\n    onConnectionChange: (connection) => {\n      athenaDiagnostics.gauge('statewire.connection', connection?.status ?? null);\n      if (connection?.status === 'stopped') {\n        athenaDiagnostics.emit('statewire.connection', {\n          level: 'warn',\n          data: {\n            status: connection.status,\n            reason: connection.reason,\n            message: connection.message,\n          },\n        });\n      }\n      onConnectionChange?.(connection);\n    },\n    onRawConnectionChange,\n    onRunningChange,\n    // The runConfig getter is pulled at command-send time through the core's\n    // per-render ref, so it reads the latest props — consumers commonly pass\n    // fresh array literals per render, which must not thrash the registration\n    // (no `key`: the provider registers once per client).\n    runConfig: {\n      get: () =>\n        buildStatewireRunConfig({\n          model,\n          agent,\n          channel,\n          tools,\n          frontendToolIds,\n          workbench,\n          knowledgeBase,\n          systemPrompt,\n          appId,\n          extraRunConfig,\n          clientTools: statewireClientToolWireEntries(clientTools),\n        }),\n    },\n    onError: (error) => {\n      if (!isStatewireChannelTeardown(error)) {\n        athenaDiagnostics.error(\n          'statewire.error',\n          error,\n          {\n            code: 'statewire_rejected',\n            message: 'The statewire host rejected a command',\n            hint: 'Inspect error.detail — agora rejections carry a structured {code, message}.',\n          },\n          { thread_id: threadId },\n        );\n      }\n      if (onError) {\n        onError(error);\n        return;\n      }\n      logUnhandledStatewireError('AthenaSDK', error);\n    },\n  });\n}\n"],"names":["DEEP_AGENT_DEFAULT_MESSAGE_WINDOW","useMemo","collectStatewireClientTools","resolveAgentProp","useContext","AthenaAuthContext","useRef","athenaDiagnostics","Tools","useAui","useDeepAgentRuntime","resolveStatewireAuthHeaders","statewireSessionKey","buildStatewireRunConfig","statewireClientToolWireEntries","isStatewireChannelTeardown","logUnhandledStatewireError"],"mappings":"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"}

package/dist/runtime/useAthenaStatewireRuntime.d.ts

@@ -1,8 +1,17 @@
 import type { AssistantClient, Toolkit } from '@assistant-ui/react';
-import { type UseDeepAgentThreadOptions } from '@athenaintel/agent-runtime';
-import { type StatewireClientTool } from '../chat/statewire-client-tools';
+import { type DeepAgentMessageWindowDeclaration, type DeepAgentThreadSnapshotCache, type DeepAgentToolOutputStore, type RegisteredClientTool, type UseDeepAgentThreadOptions } from '@athenaintel/agent-runtime';
+import { type AthenaStatewireTokenGetter } from './statewire-auth-headers';
 import { DEFAULT_STATEWIRE_MODEL } from './statewire-run-config';
 export { DEFAULT_STATEWIRE_MODEL };
+/**
+ * The message window every SDK attach declares (`x-athena-deep-agent-window`):
+ * the hello carries the transcript's tail plus the `messagesWindow` lane
+ * instead of every message — megabytes on long threads, over the 1 MiB frame
+ * limit of stock websocket clients. Older pages load from the
+ * `StatewireHistoryEdge` row the chat UI mounts above the messages, and cut
+ * tool outputs are fetched back for the cards that show them.
+ */
+export declare const ATHENA_SDK_MESSAGE_WINDOW: DeepAgentMessageWindowDeclaration;
 export interface AthenaStatewireRuntimeConfig {
     /** Base URL of the statewire sync host (the `…/v2/threads` mount). */
     syncUrl: string;
@@ -15,8 +24,30 @@ export interface AthenaStatewireRuntimeConfig {
     apiKey?: string;
     /** Auth token. Takes priority over apiKey. */
     token?: string | null;
-    /** Resolve the latest token immediately before a request (for expiring clients). */
-    getToken?: () => string | null | Promise<string | null>;
+    /** Resolve the latest token immediately before a request (for expiring
+     *  clients). Called with `{ force: true }` right after the host refused the
+     *  previous credential (the transport's `staleAuth`), so a caching getter
+     *  mints a fresh token instead of returning the refused one. */
+    getToken?: AthenaStatewireTokenGetter;
+    /**
+     * Per-provider LRU of each thread's last wire state. A switch back to a
+     * remembered thread mounts with that snapshot and projects ready on the
+     * first frame instead of a loading treatment; the attach snapshot then
+     * replaces it. Owned above the per-thread mount so it survives switches.
+     */
+    snapshotCache?: DeepAgentThreadSnapshotCache;
+    /**
+     * The message window declared on the attach (see
+     * {@link ATHENA_SDK_MESSAGE_WINDOW}, the default). `false` keeps the full
+     * snapshot for a host that renders no history loader.
+     */
+    messageWindow?: DeepAgentMessageWindowDeclaration | false;
+    /**
+     * Full tool outputs fetched back for a windowed wire's cut tool messages;
+     * the thread re-converts when one lands. `AthenaProvider` owns one per
+     * provider and hands the same store to `StatewireHistoryEdge`.
+     */
+    toolOutputs?: DeepAgentToolOutputStore;
     /** LLM model identifier. Defaults to the deep-agent default model. */
     model?: string;
     /** Agent selector: only `collab_agent:<asset_id>` refs are accepted (the run
@@ -54,7 +85,7 @@ export interface AthenaStatewireRuntimeConfig {
 }
 /** The client tools derived from the runtime's frontend toolkit — exposed so
  *  the provider can mount the client-tool bridge with the same set. */
-export declare function useStatewireClientTools(frontendToolkit: Toolkit | undefined): StatewireClientTool[];
+export declare function useStatewireClientTools(frontendToolkit: Toolkit | undefined): RegisteredClientTool[];
 /**
  * Statewire runtime for the Athena SDK — a thin shim over the shared
  * `@athenaintel/agent-runtime` `useDeepAgentRuntime`: it attaches to the