@athenaintel/react 0.30.0 → 0.32.0

package/dist/runtime/statewire-lifecycle.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"statewire-lifecycle.cjs","sources":["../../src/runtime/statewire-lifecycle.ts"],"sourcesContent":["import {\n  COLLAB_AGENT_CHANNEL_SESSION_MISMATCH,\n  isLegacyThreadReadOnlyRejection,\n  isStatewireChannelTeardown,\n  statewireRejectionCode,\n  statewireRejectionDetailMessage,\n  statewireRejectionPayload,\n} from '@athenaintel/agent-runtime';\nimport type { DeepAgentConnectionState } from '@athenaintel/agent-runtime';\n\n/** A user-visible notice mapped from a statewire transport error. */\nexport interface AthenaStatewireErrorNotice {\n  kind: 'paywall' | 'read-only' | 'command';\n  title: string;\n  message: string;\n  /**\n   * The server's structured `detail.code` (`collab_agent_channel_session_mismatch`,\n   * `legacy_thread_read_only`, …), when the rejection carried one — what a\n   * host matches on to offer the right next step.\n   */\n  code?: string;\n}\n\n/**\n * Map the statewire failure envelope to a concise, actionable notice.\n * Returns null for expected channel teardowns (thread switch, unmount),\n * which must not surface as errors.\n */\nexport function athenaStatewireErrorNotice(\n  error: unknown,\n): AthenaStatewireErrorNotice | null {\n  if (isStatewireChannelTeardown(error)) return null;\n  const rejection = statewireRejectionPayload(error);\n  // The server's own detail names the actionable reason; the Error message is\n  // generic client-side text like `command rejected (500)`.\n  const detail = statewireRejectionDetailMessage(error);\n\n  if (rejection?.status === 402) {\n    return {\n      kind: 'paywall',\n      title: 'Usage limit reached',\n      message:\n        detail ?? 'Athena could not start this run. Review usage or billing to continue.',\n    };\n  }\n\n  const code = statewireRejectionCode(error);\n  const withCode = code === null ? {} : { code };\n\n  // Legacy-thread dispatch fence: an out-of-band run is writing this\n  // pre-cutover thread (or its adoption failed). A per-send failure, not a\n  // standing state — the server's detail names the actionable reason (wait\n  // for the run vs. start a new chat).\n  if (isLegacyThreadReadOnlyRejection(error)) {\n    return {\n      kind: 'read-only',\n      title: 'Message was not sent',\n      message:\n        detail ??\n        'This conversation cannot take new messages right now. Try again shortly, or start a new chat.',\n      ...withCode,\n    };\n  }\n\n  // A session keeps the collab-agent channel (the app's mode) it started on:\n  // the send asked for another one. Nothing about the chat is broken — the\n  // way on is a new session — so it reads as the amber \"not sent\", not red.\n  if (code === COLLAB_AGENT_CHANNEL_SESSION_MISMATCH) {\n    return {\n      kind: 'read-only',\n      title: 'Message was not sent',\n      message: detail ?? 'This session runs in another mode. Start a new session to use this one.',\n      code,\n    };\n  }\n\n  return {\n    kind: 'command',\n    title: 'Message was not sent',\n    message:\n      detail ??\n      (error instanceof Error && error.message.length > 0\n        ? error.message\n        : 'The chat runtime rejected the command. Please try again.'),\n    ...withCode,\n  };\n}\n\n/** Shared lifecycle state for the statewire transport, provided by\n *  `AthenaProvider` in statewire mode and read by the chat banners. */\nexport interface AthenaStatewireLifecycleState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n  dismissError: () => void;\n}\n\n/** The provider's reducer state behind {@link AthenaStatewireLifecycleState}. */\nexport interface StatewireLifecycleReducerState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n}\n\nexport type StatewireLifecycleAction =\n  | { type: 'connection'; connection: DeepAgentConnectionState | null }\n  | { type: 'error'; error: AthenaStatewireErrorNotice | null }\n  | { type: 'raw-connection'; reconnect: () => void };\n\nexport const initialStatewireLifecycle: StatewireLifecycleReducerState = {\n  connection: null,\n  error: null,\n  reconnect: null,\n};\n\n/**\n * Folds the runtime's lifecycle observations into the banner state. A healthy\n * channel — connected, or disconnected only because the instance is quiet\n * (`idle`) or the chat has not sent yet (`deferred`) — clears a stale\n * send/transport error: leaving it up tells the user the chat is broken after\n * it has come back.\n */\nexport function statewireLifecycleReducer(\n  state: StatewireLifecycleReducerState,\n  action: StatewireLifecycleAction,\n): StatewireLifecycleReducerState {\n  switch (action.type) {\n    case 'connection': {\n      const healthy =\n        action.connection?.status === 'connected' ||\n        action.connection?.status === 'standby';\n      return {\n        ...state,\n        connection: action.connection,\n        error: healthy ? null : state.error,\n      };\n    }\n    case 'error':\n      return { ...state, error: action.error };\n    case 'raw-connection':\n      return { ...state, reconnect: action.reconnect };\n  }\n}\n"],"names":["isStatewireChannelTeardown","statewireRejectionPayload","statewireRejectionDetailMessage","statewireRejectionCode","isLegacyThreadReadOnlyRejection","COLLAB_AGENT_CHANNEL_SESSION_MISMATCH"],"mappings":";;;AA4BO,SAAS,2BACd,OACmC;AACnC,MAAIA,OAAAA,2BAA2B,KAAK,EAAG,QAAO;AAC9C,QAAM,YAAYC,OAAAA,0BAA0B,KAAK;AAGjD,QAAM,SAASC,OAAAA,gCAAgC,KAAK;AAEpD,OAAI,uCAAW,YAAW,KAAK;AAC7B,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UAAU;AAAA,IAAA;AAAA,EAEhB;AAEA,QAAM,OAAOC,OAAAA,uBAAuB,KAAK;AACzC,QAAM,WAAW,SAAS,OAAO,CAAA,IAAK,EAAE,KAAA;AAMxC,MAAIC,OAAAA,gCAAgC,KAAK,GAAG;AAC1C,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UACA;AAAA,MACF,GAAG;AAAA,IAAA;AAAA,EAEP;AAKA,MAAI,SAASC,OAAAA,uCAAuC;AAClD,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SAAS,UAAU;AAAA,MACnB;AAAA,IAAA;AAAA,EAEJ;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,IACP,SACE,WACC,iBAAiB,SAAS,MAAM,QAAQ,SAAS,IAC9C,MAAM,UACN;AAAA,IACN,GAAG;AAAA,EAAA;AAEP;AAuBO,MAAM,4BAA4D;AAAA,EACvE,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,WAAW;AACb;AASO,SAAS,0BACd,OACA,QACgC;;AAChC,UAAQ,OAAO,MAAA;AAAA,IACb,KAAK,cAAc;AACjB,YAAM,YACJ,YAAO,eAAP,mBAAmB,YAAW,iBAC9B,YAAO,eAAP,mBAAmB,YAAW;AAChC,aAAO;AAAA,QACL,GAAG;AAAA,QACH,YAAY,OAAO;AAAA,QACnB,OAAO,UAAU,OAAO,MAAM;AAAA,MAAA;AAAA,IAElC;AAAA,IACA,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,OAAO,OAAO,MAAA;AAAA,IACnC,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,WAAW,OAAO,UAAA;AAAA,EAAU;AAErD;;;;"}
+{"version":3,"file":"statewire-lifecycle.cjs","sources":["../../src/runtime/statewire-lifecycle.ts"],"sourcesContent":["import {\n  COLLAB_AGENT_CHANNEL_SESSION_MISMATCH,\n  isLegacyThreadReadOnlyRejection,\n  isStatewireChannelTeardown,\n  statewireRejectionCode,\n  statewireRejectionDetailMessage,\n  statewireRejectionPayload,\n} from '@athenaintel/agent-runtime';\nimport type { DeepAgentConnectionState } from '@athenaintel/agent-runtime';\n\n/** A user-visible notice mapped from a statewire transport error. */\nexport interface AthenaStatewireErrorNotice {\n  kind: 'paywall' | 'read-only' | 'command';\n  title: string;\n  message: string;\n  /**\n   * The server's structured `detail.code` (`collab_agent_channel_session_mismatch`,\n   * `legacy_thread_read_only`, …), when the rejection carried one — what a\n   * host matches on to offer the right next step.\n   */\n  code?: string;\n}\n\n/**\n * Map the statewire failure envelope to a concise, actionable notice.\n * Returns null for expected channel teardowns (thread switch, unmount),\n * which must not surface as errors.\n */\nexport function athenaStatewireErrorNotice(\n  error: unknown,\n): AthenaStatewireErrorNotice | null {\n  if (isStatewireChannelTeardown(error)) return null;\n  const rejection = statewireRejectionPayload(error);\n  // The server's own detail names the actionable reason; the Error message is\n  // generic client-side text like `command rejected (500)`.\n  const detail = statewireRejectionDetailMessage(error);\n\n  if (rejection?.status === 402) {\n    return {\n      kind: 'paywall',\n      title: 'Usage limit reached',\n      message:\n        detail ?? 'Athena could not start this run. Review usage or billing to continue.',\n    };\n  }\n\n  const code = statewireRejectionCode(error);\n  const withCode = code === null ? {} : { code };\n\n  // Legacy-thread dispatch fence: an out-of-band run is writing this\n  // pre-cutover thread (or its adoption failed). A per-send failure, not a\n  // standing state — the server's detail names the actionable reason (wait\n  // for the run vs. start a new chat).\n  if (isLegacyThreadReadOnlyRejection(error)) {\n    return {\n      kind: 'read-only',\n      title: 'Message was not sent',\n      message:\n        detail ??\n        'This conversation cannot take new messages right now. Try again shortly, or start a new chat.',\n      ...withCode,\n    };\n  }\n\n  // A session keeps the collab-agent channel (the app's mode) it started on:\n  // the send asked for another one. Nothing about the chat is broken — the\n  // way on is a new session — so it reads as the amber \"not sent\", not red.\n  if (code === COLLAB_AGENT_CHANNEL_SESSION_MISMATCH) {\n    return {\n      kind: 'read-only',\n      title: 'Message was not sent',\n      message: detail ?? 'This session runs in another mode. Start a new session to use this one.',\n      code,\n    };\n  }\n\n  return {\n    kind: 'command',\n    title: 'Message was not sent',\n    message:\n      detail ??\n      (error instanceof Error && error.message.length > 0\n        ? error.message\n        : 'The chat runtime rejected the command. Please try again.'),\n    ...withCode,\n  };\n}\n\n/** Shared lifecycle state for the statewire transport, provided by\n *  `AthenaProvider` in statewire mode and read by the chat banners. */\nexport interface AthenaStatewireLifecycleState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n  dismissError: () => void;\n}\n\n/** The provider's reducer state behind {@link AthenaStatewireLifecycleState}. */\nexport interface StatewireLifecycleReducerState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n}\n\nexport type StatewireLifecycleAction =\n  | { type: 'connection'; connection: DeepAgentConnectionState | null }\n  | { type: 'error'; error: AthenaStatewireErrorNotice | null }\n  | { type: 'raw-connection'; reconnect: () => void };\n\nexport const initialStatewireLifecycle: StatewireLifecycleReducerState = {\n  connection: null,\n  error: null,\n  reconnect: null,\n};\n\n/**\n * Folds the runtime's lifecycle observations into the banner state. A healthy\n * channel — connected, or disconnected only because the instance is quiet\n * (`idle`) or the chat has not sent yet (`deferred`) — clears a stale\n * send/transport error: leaving it up tells the user the chat is broken after\n * it has come back.\n */\n/**\n * Whether the statewire channel can take a command now: connected, or on\n * standby (attached and idle). `null` (no connection observed yet) is not.\n */\nexport function isStatewireChannelLive(connection: DeepAgentConnectionState | null): boolean {\n  return connection?.status === 'connected' || connection?.status === 'standby';\n}\n\nexport function statewireLifecycleReducer(\n  state: StatewireLifecycleReducerState,\n  action: StatewireLifecycleAction,\n): StatewireLifecycleReducerState {\n  switch (action.type) {\n    case 'connection': {\n      const healthy = isStatewireChannelLive(action.connection);\n      return {\n        ...state,\n        connection: action.connection,\n        error: healthy ? null : state.error,\n      };\n    }\n    case 'error':\n      return { ...state, error: action.error };\n    case 'raw-connection':\n      return { ...state, reconnect: action.reconnect };\n  }\n}\n"],"names":["isStatewireChannelTeardown","statewireRejectionPayload","statewireRejectionDetailMessage","statewireRejectionCode","isLegacyThreadReadOnlyRejection","COLLAB_AGENT_CHANNEL_SESSION_MISMATCH"],"mappings":";;;AA4BO,SAAS,2BACd,OACmC;AACnC,MAAIA,OAAAA,2BAA2B,KAAK,EAAG,QAAO;AAC9C,QAAM,YAAYC,OAAAA,0BAA0B,KAAK;AAGjD,QAAM,SAASC,OAAAA,gCAAgC,KAAK;AAEpD,OAAI,uCAAW,YAAW,KAAK;AAC7B,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UAAU;AAAA,IAAA;AAAA,EAEhB;AAEA,QAAM,OAAOC,OAAAA,uBAAuB,KAAK;AACzC,QAAM,WAAW,SAAS,OAAO,CAAA,IAAK,EAAE,KAAA;AAMxC,MAAIC,OAAAA,gCAAgC,KAAK,GAAG;AAC1C,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UACA;AAAA,MACF,GAAG;AAAA,IAAA;AAAA,EAEP;AAKA,MAAI,SAASC,OAAAA,uCAAuC;AAClD,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SAAS,UAAU;AAAA,MACnB;AAAA,IAAA;AAAA,EAEJ;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,IACP,SACE,WACC,iBAAiB,SAAS,MAAM,QAAQ,SAAS,IAC9C,MAAM,UACN;AAAA,IACN,GAAG;AAAA,EAAA;AAEP;AAuBO,MAAM,4BAA4D;AAAA,EACvE,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,WAAW;AACb;AAaO,SAAS,uBAAuB,YAAsD;AAC3F,UAAO,yCAAY,YAAW,gBAAe,yCAAY,YAAW;AACtE;AAEO,SAAS,0BACd,OACA,QACgC;AAChC,UAAQ,OAAO,MAAA;AAAA,IACb,KAAK,cAAc;AACjB,YAAM,UAAU,uBAAuB,OAAO,UAAU;AACxD,aAAO;AAAA,QACL,GAAG;AAAA,QACH,YAAY,OAAO;AAAA,QACnB,OAAO,UAAU,OAAO,MAAM;AAAA,MAAA;AAAA,IAElC;AAAA,IACA,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,OAAO,OAAO,MAAA;AAAA,IACnC,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,WAAW,OAAO,UAAA;AAAA,EAAU;AAErD;;;;;"}

package/dist/runtime/statewire-lifecycle.d.ts

@@ -49,4 +49,9 @@ export declare const initialStatewireLifecycle: StatewireLifecycleReducerState;
  * send/transport error: leaving it up tells the user the chat is broken after
  * it has come back.
  */
+/**
+ * Whether the statewire channel can take a command now: connected, or on
+ * standby (attached and idle). `null` (no connection observed yet) is not.
+ */
+export declare function isStatewireChannelLive(connection: DeepAgentConnectionState | null): boolean;
 export declare function statewireLifecycleReducer(state: StatewireLifecycleReducerState, action: StatewireLifecycleAction): StatewireLifecycleReducerState;

package/dist/runtime/statewire-lifecycle.js

@@ -40,11 +40,13 @@ const initialStatewireLifecycle = {
   error: null,
   reconnect: null
 };
+function isStatewireChannelLive(connection) {
+  return (connection == null ? void 0 : connection.status) === "connected" || (connection == null ? void 0 : connection.status) === "standby";
+}
 function statewireLifecycleReducer(state, action) {
-  var _a, _b;
   switch (action.type) {
     case "connection": {
-      const healthy = ((_a = action.connection) == null ? void 0 : _a.status) === "connected" || ((_b = action.connection) == null ? void 0 : _b.status) === "standby";
+      const healthy = isStatewireChannelLive(action.connection);
       return {
         ...state,
         connection: action.connection,
@@ -60,6 +62,7 @@ function statewireLifecycleReducer(state, action) {
 export {
   athenaStatewireErrorNotice,
   initialStatewireLifecycle,
+  isStatewireChannelLive,
   statewireLifecycleReducer
 };
 //# sourceMappingURL=statewire-lifecycle.js.map

package/dist/runtime/statewire-lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"statewire-lifecycle.js","sources":["../../src/runtime/statewire-lifecycle.ts"],"sourcesContent":["import {\n  COLLAB_AGENT_CHANNEL_SESSION_MISMATCH,\n  isLegacyThreadReadOnlyRejection,\n  isStatewireChannelTeardown,\n  statewireRejectionCode,\n  statewireRejectionDetailMessage,\n  statewireRejectionPayload,\n} from '@athenaintel/agent-runtime';\nimport type { DeepAgentConnectionState } from '@athenaintel/agent-runtime';\n\n/** A user-visible notice mapped from a statewire transport error. */\nexport interface AthenaStatewireErrorNotice {\n  kind: 'paywall' | 'read-only' | 'command';\n  title: string;\n  message: string;\n  /**\n   * The server's structured `detail.code` (`collab_agent_channel_session_mismatch`,\n   * `legacy_thread_read_only`, …), when the rejection carried one — what a\n   * host matches on to offer the right next step.\n   */\n  code?: string;\n}\n\n/**\n * Map the statewire failure envelope to a concise, actionable notice.\n * Returns null for expected channel teardowns (thread switch, unmount),\n * which must not surface as errors.\n */\nexport function athenaStatewireErrorNotice(\n  error: unknown,\n): AthenaStatewireErrorNotice | null {\n  if (isStatewireChannelTeardown(error)) return null;\n  const rejection = statewireRejectionPayload(error);\n  // The server's own detail names the actionable reason; the Error message is\n  // generic client-side text like `command rejected (500)`.\n  const detail = statewireRejectionDetailMessage(error);\n\n  if (rejection?.status === 402) {\n    return {\n      kind: 'paywall',\n      title: 'Usage limit reached',\n      message:\n        detail ?? 'Athena could not start this run. Review usage or billing to continue.',\n    };\n  }\n\n  const code = statewireRejectionCode(error);\n  const withCode = code === null ? {} : { code };\n\n  // Legacy-thread dispatch fence: an out-of-band run is writing this\n  // pre-cutover thread (or its adoption failed). A per-send failure, not a\n  // standing state — the server's detail names the actionable reason (wait\n  // for the run vs. start a new chat).\n  if (isLegacyThreadReadOnlyRejection(error)) {\n    return {\n      kind: 'read-only',\n      title: 'Message was not sent',\n      message:\n        detail ??\n        'This conversation cannot take new messages right now. Try again shortly, or start a new chat.',\n      ...withCode,\n    };\n  }\n\n  // A session keeps the collab-agent channel (the app's mode) it started on:\n  // the send asked for another one. Nothing about the chat is broken — the\n  // way on is a new session — so it reads as the amber \"not sent\", not red.\n  if (code === COLLAB_AGENT_CHANNEL_SESSION_MISMATCH) {\n    return {\n      kind: 'read-only',\n      title: 'Message was not sent',\n      message: detail ?? 'This session runs in another mode. Start a new session to use this one.',\n      code,\n    };\n  }\n\n  return {\n    kind: 'command',\n    title: 'Message was not sent',\n    message:\n      detail ??\n      (error instanceof Error && error.message.length > 0\n        ? error.message\n        : 'The chat runtime rejected the command. Please try again.'),\n    ...withCode,\n  };\n}\n\n/** Shared lifecycle state for the statewire transport, provided by\n *  `AthenaProvider` in statewire mode and read by the chat banners. */\nexport interface AthenaStatewireLifecycleState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n  dismissError: () => void;\n}\n\n/** The provider's reducer state behind {@link AthenaStatewireLifecycleState}. */\nexport interface StatewireLifecycleReducerState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n}\n\nexport type StatewireLifecycleAction =\n  | { type: 'connection'; connection: DeepAgentConnectionState | null }\n  | { type: 'error'; error: AthenaStatewireErrorNotice | null }\n  | { type: 'raw-connection'; reconnect: () => void };\n\nexport const initialStatewireLifecycle: StatewireLifecycleReducerState = {\n  connection: null,\n  error: null,\n  reconnect: null,\n};\n\n/**\n * Folds the runtime's lifecycle observations into the banner state. A healthy\n * channel — connected, or disconnected only because the instance is quiet\n * (`idle`) or the chat has not sent yet (`deferred`) — clears a stale\n * send/transport error: leaving it up tells the user the chat is broken after\n * it has come back.\n */\nexport function statewireLifecycleReducer(\n  state: StatewireLifecycleReducerState,\n  action: StatewireLifecycleAction,\n): StatewireLifecycleReducerState {\n  switch (action.type) {\n    case 'connection': {\n      const healthy =\n        action.connection?.status === 'connected' ||\n        action.connection?.status === 'standby';\n      return {\n        ...state,\n        connection: action.connection,\n        error: healthy ? null : state.error,\n      };\n    }\n    case 'error':\n      return { ...state, error: action.error };\n    case 'raw-connection':\n      return { ...state, reconnect: action.reconnect };\n  }\n}\n"],"names":[],"mappings":";AA4BO,SAAS,2BACd,OACmC;AACnC,MAAI,2BAA2B,KAAK,EAAG,QAAO;AAC9C,QAAM,YAAY,0BAA0B,KAAK;AAGjD,QAAM,SAAS,gCAAgC,KAAK;AAEpD,OAAI,uCAAW,YAAW,KAAK;AAC7B,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UAAU;AAAA,IAAA;AAAA,EAEhB;AAEA,QAAM,OAAO,uBAAuB,KAAK;AACzC,QAAM,WAAW,SAAS,OAAO,CAAA,IAAK,EAAE,KAAA;AAMxC,MAAI,gCAAgC,KAAK,GAAG;AAC1C,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UACA;AAAA,MACF,GAAG;AAAA,IAAA;AAAA,EAEP;AAKA,MAAI,SAAS,uCAAuC;AAClD,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SAAS,UAAU;AAAA,MACnB;AAAA,IAAA;AAAA,EAEJ;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,IACP,SACE,WACC,iBAAiB,SAAS,MAAM,QAAQ,SAAS,IAC9C,MAAM,UACN;AAAA,IACN,GAAG;AAAA,EAAA;AAEP;AAuBO,MAAM,4BAA4D;AAAA,EACvE,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,WAAW;AACb;AASO,SAAS,0BACd,OACA,QACgC;;AAChC,UAAQ,OAAO,MAAA;AAAA,IACb,KAAK,cAAc;AACjB,YAAM,YACJ,YAAO,eAAP,mBAAmB,YAAW,iBAC9B,YAAO,eAAP,mBAAmB,YAAW;AAChC,aAAO;AAAA,QACL,GAAG;AAAA,QACH,YAAY,OAAO;AAAA,QACnB,OAAO,UAAU,OAAO,MAAM;AAAA,MAAA;AAAA,IAElC;AAAA,IACA,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,OAAO,OAAO,MAAA;AAAA,IACnC,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,WAAW,OAAO,UAAA;AAAA,EAAU;AAErD;"}
+{"version":3,"file":"statewire-lifecycle.js","sources":["../../src/runtime/statewire-lifecycle.ts"],"sourcesContent":["import {\n  COLLAB_AGENT_CHANNEL_SESSION_MISMATCH,\n  isLegacyThreadReadOnlyRejection,\n  isStatewireChannelTeardown,\n  statewireRejectionCode,\n  statewireRejectionDetailMessage,\n  statewireRejectionPayload,\n} from '@athenaintel/agent-runtime';\nimport type { DeepAgentConnectionState } from '@athenaintel/agent-runtime';\n\n/** A user-visible notice mapped from a statewire transport error. */\nexport interface AthenaStatewireErrorNotice {\n  kind: 'paywall' | 'read-only' | 'command';\n  title: string;\n  message: string;\n  /**\n   * The server's structured `detail.code` (`collab_agent_channel_session_mismatch`,\n   * `legacy_thread_read_only`, …), when the rejection carried one — what a\n   * host matches on to offer the right next step.\n   */\n  code?: string;\n}\n\n/**\n * Map the statewire failure envelope to a concise, actionable notice.\n * Returns null for expected channel teardowns (thread switch, unmount),\n * which must not surface as errors.\n */\nexport function athenaStatewireErrorNotice(\n  error: unknown,\n): AthenaStatewireErrorNotice | null {\n  if (isStatewireChannelTeardown(error)) return null;\n  const rejection = statewireRejectionPayload(error);\n  // The server's own detail names the actionable reason; the Error message is\n  // generic client-side text like `command rejected (500)`.\n  const detail = statewireRejectionDetailMessage(error);\n\n  if (rejection?.status === 402) {\n    return {\n      kind: 'paywall',\n      title: 'Usage limit reached',\n      message:\n        detail ?? 'Athena could not start this run. Review usage or billing to continue.',\n    };\n  }\n\n  const code = statewireRejectionCode(error);\n  const withCode = code === null ? {} : { code };\n\n  // Legacy-thread dispatch fence: an out-of-band run is writing this\n  // pre-cutover thread (or its adoption failed). A per-send failure, not a\n  // standing state — the server's detail names the actionable reason (wait\n  // for the run vs. start a new chat).\n  if (isLegacyThreadReadOnlyRejection(error)) {\n    return {\n      kind: 'read-only',\n      title: 'Message was not sent',\n      message:\n        detail ??\n        'This conversation cannot take new messages right now. Try again shortly, or start a new chat.',\n      ...withCode,\n    };\n  }\n\n  // A session keeps the collab-agent channel (the app's mode) it started on:\n  // the send asked for another one. Nothing about the chat is broken — the\n  // way on is a new session — so it reads as the amber \"not sent\", not red.\n  if (code === COLLAB_AGENT_CHANNEL_SESSION_MISMATCH) {\n    return {\n      kind: 'read-only',\n      title: 'Message was not sent',\n      message: detail ?? 'This session runs in another mode. Start a new session to use this one.',\n      code,\n    };\n  }\n\n  return {\n    kind: 'command',\n    title: 'Message was not sent',\n    message:\n      detail ??\n      (error instanceof Error && error.message.length > 0\n        ? error.message\n        : 'The chat runtime rejected the command. Please try again.'),\n    ...withCode,\n  };\n}\n\n/** Shared lifecycle state for the statewire transport, provided by\n *  `AthenaProvider` in statewire mode and read by the chat banners. */\nexport interface AthenaStatewireLifecycleState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n  dismissError: () => void;\n}\n\n/** The provider's reducer state behind {@link AthenaStatewireLifecycleState}. */\nexport interface StatewireLifecycleReducerState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n}\n\nexport type StatewireLifecycleAction =\n  | { type: 'connection'; connection: DeepAgentConnectionState | null }\n  | { type: 'error'; error: AthenaStatewireErrorNotice | null }\n  | { type: 'raw-connection'; reconnect: () => void };\n\nexport const initialStatewireLifecycle: StatewireLifecycleReducerState = {\n  connection: null,\n  error: null,\n  reconnect: null,\n};\n\n/**\n * Folds the runtime's lifecycle observations into the banner state. A healthy\n * channel — connected, or disconnected only because the instance is quiet\n * (`idle`) or the chat has not sent yet (`deferred`) — clears a stale\n * send/transport error: leaving it up tells the user the chat is broken after\n * it has come back.\n */\n/**\n * Whether the statewire channel can take a command now: connected, or on\n * standby (attached and idle). `null` (no connection observed yet) is not.\n */\nexport function isStatewireChannelLive(connection: DeepAgentConnectionState | null): boolean {\n  return connection?.status === 'connected' || connection?.status === 'standby';\n}\n\nexport function statewireLifecycleReducer(\n  state: StatewireLifecycleReducerState,\n  action: StatewireLifecycleAction,\n): StatewireLifecycleReducerState {\n  switch (action.type) {\n    case 'connection': {\n      const healthy = isStatewireChannelLive(action.connection);\n      return {\n        ...state,\n        connection: action.connection,\n        error: healthy ? null : state.error,\n      };\n    }\n    case 'error':\n      return { ...state, error: action.error };\n    case 'raw-connection':\n      return { ...state, reconnect: action.reconnect };\n  }\n}\n"],"names":[],"mappings":";AA4BO,SAAS,2BACd,OACmC;AACnC,MAAI,2BAA2B,KAAK,EAAG,QAAO;AAC9C,QAAM,YAAY,0BAA0B,KAAK;AAGjD,QAAM,SAAS,gCAAgC,KAAK;AAEpD,OAAI,uCAAW,YAAW,KAAK;AAC7B,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UAAU;AAAA,IAAA;AAAA,EAEhB;AAEA,QAAM,OAAO,uBAAuB,KAAK;AACzC,QAAM,WAAW,SAAS,OAAO,CAAA,IAAK,EAAE,KAAA;AAMxC,MAAI,gCAAgC,KAAK,GAAG;AAC1C,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UACA;AAAA,MACF,GAAG;AAAA,IAAA;AAAA,EAEP;AAKA,MAAI,SAAS,uCAAuC;AAClD,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SAAS,UAAU;AAAA,MACnB;AAAA,IAAA;AAAA,EAEJ;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,IACP,SACE,WACC,iBAAiB,SAAS,MAAM,QAAQ,SAAS,IAC9C,MAAM,UACN;AAAA,IACN,GAAG;AAAA,EAAA;AAEP;AAuBO,MAAM,4BAA4D;AAAA,EACvE,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,WAAW;AACb;AAaO,SAAS,uBAAuB,YAAsD;AAC3F,UAAO,yCAAY,YAAW,gBAAe,yCAAY,YAAW;AACtE;AAEO,SAAS,0BACd,OACA,QACgC;AAChC,UAAQ,OAAO,MAAA;AAAA,IACb,KAAK,cAAc;AACjB,YAAM,UAAU,uBAAuB,OAAO,UAAU;AACxD,aAAO;AAAA,QACL,GAAG;AAAA,QACH,YAAY,OAAO;AAAA,QACnB,OAAO,UAAU,OAAO,MAAM;AAAA,MAAA;AAAA,IAElC;AAAA,IACA,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,OAAO,OAAO,MAAA;AAAA,IACnC,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,WAAW,OAAO,UAAA;AAAA,EAAU;AAErD;"}

package/dist/runtime/statewire-model-lane.cjs

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function readLaneModel(custom) {
+  const model = custom.model;
+  return typeof model === "string" && model !== "" ? model : null;
+}
+function threadModelFromLane({
+  lane,
+  ready
+}) {
+  if (!ready || lane === null) return { model: null, configured: false, ready };
+  return { model: readLaneModel(lane.custom), configured: true, ready };
+}
+function decideModelLanePatch({
+  desiredModel,
+  landed,
+  configVersion,
+  custom
+}) {
+  if (!landed || configVersion <= 0) return { kind: "wait" };
+  const desired = desiredModel === void 0 || desiredModel === "" ? null : desiredModel;
+  if (readLaneModel(custom) === desired) return { kind: "done" };
+  return { kind: "patch", patch: { model: desired } };
+}
+exports.decideModelLanePatch = decideModelLanePatch;
+exports.readLaneModel = readLaneModel;
+exports.threadModelFromLane = threadModelFromLane;
+//# sourceMappingURL=statewire-model-lane.cjs.map

package/dist/runtime/statewire-model-lane.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"statewire-model-lane.cjs","sources":["../../src/runtime/statewire-model-lane.ts"],"sourcesContent":["import type { DeepAgentServerConfig, ThreadConfigCustom } from '@athenaintel/agent-runtime';\n\n/**\n * The model a thread's server config lane (`state.config.custom`) pins, as the\n * host app should read it, plus whether there is a lane at all.\n *\n * Once a thread has a lane (version > 0), agora runs every turn with the lane's\n * thread-config keys and drops the ones a send carries, `model` included: the\n * lane, not the provider's `model` prop, decides which model a turn uses.\n */\nexport interface AthenaThreadModel {\n  /**\n   * The model the lane pins, or `null` when it pins none: the run then uses the\n   * selected collab agent's own model, or the deployment default.\n   */\n  model: string | null;\n  /** `true` once the thread has a server config lane (version > 0). */\n  configured: boolean;\n  /**\n   * `true` once the statewire host's snapshot of this thread has arrived (the\n   * placeholder or remembered snapshot a thread shows while it loads does not\n   * count: it may carry no lane, or an older one). Before that `model` is\n   * `null` and `configured` is `false` whatever the thread holds, so wait for\n   * `ready` before treating \"no model\" as an answer.\n   */\n  ready: boolean;\n}\n\n/** The lane's `model` key, or `null` when it carries none (or a non-string). */\nexport function readLaneModel(custom: ThreadConfigCustom): string | null {\n  const model = custom.model;\n  return typeof model === 'string' && model !== '' ? model : null;\n}\n\n/** {@link AthenaThreadModel} from the lane and the landed flag. Pure. */\nexport function threadModelFromLane({\n  lane,\n  ready,\n}: {\n  lane: DeepAgentServerConfig | null;\n  ready: boolean;\n}): AthenaThreadModel {\n  if (!ready || lane === null) return { model: null, configured: false, ready };\n  return { model: readLaneModel(lane.custom), configured: true, ready };\n}\n\n/**\n * What to do with a `model` prop change the host made during an attach:\n *\n * - `wait`: keep the change pending. The thread's snapshot has not landed, or\n *   the thread has no lane yet (version 0). A version-0 thread needs nothing:\n *   the next send carries the model and agora's deferral seed persists it. The\n *   change stays pending only so that a lane an EARLIER send seeds (with the\n *   previous model) is corrected once it lands.\n * - `done`: the lane already holds the model (this client's own unacknowledged\n *   writes folded over); nothing to write.\n * - `patch`: issue `config/patch {model}`; `null` unsets the lane's model so\n *   the agent's own model (or the deployment default) applies.\n */\nexport type ModelLaneDecision =\n  | { kind: 'wait' }\n  | { kind: 'done' }\n  | { kind: 'patch'; patch: { model: string | null } };\n\nexport function decideModelLanePatch({\n  desiredModel,\n  landed,\n  configVersion,\n  custom,\n}: {\n  /** The provider's `model` prop after the change (`undefined` = no explicit model). */\n  desiredModel: string | undefined;\n  landed: boolean;\n  configVersion: number;\n  /** The effective lane: the server config with this client's pending writes folded over. */\n  custom: ThreadConfigCustom;\n}): ModelLaneDecision {\n  if (!landed || configVersion <= 0) return { kind: 'wait' };\n  const desired = desiredModel === undefined || desiredModel === '' ? null : desiredModel;\n  if (readLaneModel(custom) === desired) return { kind: 'done' };\n  return { kind: 'patch', patch: { model: desired } };\n}\n"],"names":[],"mappings":";;AA6BO,SAAS,cAAc,QAA2C;AACvE,QAAM,QAAQ,OAAO;AACrB,SAAO,OAAO,UAAU,YAAY,UAAU,KAAK,QAAQ;AAC7D;AAGO,SAAS,oBAAoB;AAAA,EAClC;AAAA,EACA;AACF,GAGsB;AACpB,MAAI,CAAC,SAAS,SAAS,KAAM,QAAO,EAAE,OAAO,MAAM,YAAY,OAAO,MAAA;AACtE,SAAO,EAAE,OAAO,cAAc,KAAK,MAAM,GAAG,YAAY,MAAM,MAAA;AAChE;AAoBO,SAAS,qBAAqB;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAOsB;AACpB,MAAI,CAAC,UAAU,iBAAiB,EAAG,QAAO,EAAE,MAAM,OAAA;AAClD,QAAM,UAAU,iBAAiB,UAAa,iBAAiB,KAAK,OAAO;AAC3E,MAAI,cAAc,MAAM,MAAM,QAAS,QAAO,EAAE,MAAM,OAAA;AACtD,SAAO,EAAE,MAAM,SAAS,OAAO,EAAE,OAAO,UAAQ;AAClD;;;;"}

package/dist/runtime/statewire-model-lane.d.ts

@@ -0,0 +1,64 @@
+import type { DeepAgentServerConfig, ThreadConfigCustom } from '@athenaintel/agent-runtime';
+/**
+ * The model a thread's server config lane (`state.config.custom`) pins, as the
+ * host app should read it, plus whether there is a lane at all.
+ *
+ * Once a thread has a lane (version > 0), agora runs every turn with the lane's
+ * thread-config keys and drops the ones a send carries, `model` included: the
+ * lane, not the provider's `model` prop, decides which model a turn uses.
+ */
+export interface AthenaThreadModel {
+    /**
+     * The model the lane pins, or `null` when it pins none: the run then uses the
+     * selected collab agent's own model, or the deployment default.
+     */
+    model: string | null;
+    /** `true` once the thread has a server config lane (version > 0). */
+    configured: boolean;
+    /**
+     * `true` once the statewire host's snapshot of this thread has arrived (the
+     * placeholder or remembered snapshot a thread shows while it loads does not
+     * count: it may carry no lane, or an older one). Before that `model` is
+     * `null` and `configured` is `false` whatever the thread holds, so wait for
+     * `ready` before treating "no model" as an answer.
+     */
+    ready: boolean;
+}
+/** The lane's `model` key, or `null` when it carries none (or a non-string). */
+export declare function readLaneModel(custom: ThreadConfigCustom): string | null;
+/** {@link AthenaThreadModel} from the lane and the landed flag. Pure. */
+export declare function threadModelFromLane({ lane, ready, }: {
+    lane: DeepAgentServerConfig | null;
+    ready: boolean;
+}): AthenaThreadModel;
+/**
+ * What to do with a `model` prop change the host made during an attach:
+ *
+ * - `wait`: keep the change pending. The thread's snapshot has not landed, or
+ *   the thread has no lane yet (version 0). A version-0 thread needs nothing:
+ *   the next send carries the model and agora's deferral seed persists it. The
+ *   change stays pending only so that a lane an EARLIER send seeds (with the
+ *   previous model) is corrected once it lands.
+ * - `done`: the lane already holds the model (this client's own unacknowledged
+ *   writes folded over); nothing to write.
+ * - `patch`: issue `config/patch {model}`; `null` unsets the lane's model so
+ *   the agent's own model (or the deployment default) applies.
+ */
+export type ModelLaneDecision = {
+    kind: 'wait';
+} | {
+    kind: 'done';
+} | {
+    kind: 'patch';
+    patch: {
+        model: string | null;
+    };
+};
+export declare function decideModelLanePatch({ desiredModel, landed, configVersion, custom, }: {
+    /** The provider's `model` prop after the change (`undefined` = no explicit model). */
+    desiredModel: string | undefined;
+    landed: boolean;
+    configVersion: number;
+    /** The effective lane: the server config with this client's pending writes folded over. */
+    custom: ThreadConfigCustom;
+}): ModelLaneDecision;

package/dist/runtime/statewire-model-lane.js

@@ -0,0 +1,28 @@
+function readLaneModel(custom) {
+  const model = custom.model;
+  return typeof model === "string" && model !== "" ? model : null;
+}
+function threadModelFromLane({
+  lane,
+  ready
+}) {
+  if (!ready || lane === null) return { model: null, configured: false, ready };
+  return { model: readLaneModel(lane.custom), configured: true, ready };
+}
+function decideModelLanePatch({
+  desiredModel,
+  landed,
+  configVersion,
+  custom
+}) {
+  if (!landed || configVersion <= 0) return { kind: "wait" };
+  const desired = desiredModel === void 0 || desiredModel === "" ? null : desiredModel;
+  if (readLaneModel(custom) === desired) return { kind: "done" };
+  return { kind: "patch", patch: { model: desired } };
+}
+export {
+  decideModelLanePatch,
+  readLaneModel,
+  threadModelFromLane
+};
+//# sourceMappingURL=statewire-model-lane.js.map

package/dist/runtime/statewire-model-lane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statewire-model-lane.js","sources":["../../src/runtime/statewire-model-lane.ts"],"sourcesContent":["import type { DeepAgentServerConfig, ThreadConfigCustom } from '@athenaintel/agent-runtime';\n\n/**\n * The model a thread's server config lane (`state.config.custom`) pins, as the\n * host app should read it, plus whether there is a lane at all.\n *\n * Once a thread has a lane (version > 0), agora runs every turn with the lane's\n * thread-config keys and drops the ones a send carries, `model` included: the\n * lane, not the provider's `model` prop, decides which model a turn uses.\n */\nexport interface AthenaThreadModel {\n  /**\n   * The model the lane pins, or `null` when it pins none: the run then uses the\n   * selected collab agent's own model, or the deployment default.\n   */\n  model: string | null;\n  /** `true` once the thread has a server config lane (version > 0). */\n  configured: boolean;\n  /**\n   * `true` once the statewire host's snapshot of this thread has arrived (the\n   * placeholder or remembered snapshot a thread shows while it loads does not\n   * count: it may carry no lane, or an older one). Before that `model` is\n   * `null` and `configured` is `false` whatever the thread holds, so wait for\n   * `ready` before treating \"no model\" as an answer.\n   */\n  ready: boolean;\n}\n\n/** The lane's `model` key, or `null` when it carries none (or a non-string). */\nexport function readLaneModel(custom: ThreadConfigCustom): string | null {\n  const model = custom.model;\n  return typeof model === 'string' && model !== '' ? model : null;\n}\n\n/** {@link AthenaThreadModel} from the lane and the landed flag. Pure. */\nexport function threadModelFromLane({\n  lane,\n  ready,\n}: {\n  lane: DeepAgentServerConfig | null;\n  ready: boolean;\n}): AthenaThreadModel {\n  if (!ready || lane === null) return { model: null, configured: false, ready };\n  return { model: readLaneModel(lane.custom), configured: true, ready };\n}\n\n/**\n * What to do with a `model` prop change the host made during an attach:\n *\n * - `wait`: keep the change pending. The thread's snapshot has not landed, or\n *   the thread has no lane yet (version 0). A version-0 thread needs nothing:\n *   the next send carries the model and agora's deferral seed persists it. The\n *   change stays pending only so that a lane an EARLIER send seeds (with the\n *   previous model) is corrected once it lands.\n * - `done`: the lane already holds the model (this client's own unacknowledged\n *   writes folded over); nothing to write.\n * - `patch`: issue `config/patch {model}`; `null` unsets the lane's model so\n *   the agent's own model (or the deployment default) applies.\n */\nexport type ModelLaneDecision =\n  | { kind: 'wait' }\n  | { kind: 'done' }\n  | { kind: 'patch'; patch: { model: string | null } };\n\nexport function decideModelLanePatch({\n  desiredModel,\n  landed,\n  configVersion,\n  custom,\n}: {\n  /** The provider's `model` prop after the change (`undefined` = no explicit model). */\n  desiredModel: string | undefined;\n  landed: boolean;\n  configVersion: number;\n  /** The effective lane: the server config with this client's pending writes folded over. */\n  custom: ThreadConfigCustom;\n}): ModelLaneDecision {\n  if (!landed || configVersion <= 0) return { kind: 'wait' };\n  const desired = desiredModel === undefined || desiredModel === '' ? null : desiredModel;\n  if (readLaneModel(custom) === desired) return { kind: 'done' };\n  return { kind: 'patch', patch: { model: desired } };\n}\n"],"names":[],"mappings":"AA6BO,SAAS,cAAc,QAA2C;AACvE,QAAM,QAAQ,OAAO;AACrB,SAAO,OAAO,UAAU,YAAY,UAAU,KAAK,QAAQ;AAC7D;AAGO,SAAS,oBAAoB;AAAA,EAClC;AAAA,EACA;AACF,GAGsB;AACpB,MAAI,CAAC,SAAS,SAAS,KAAM,QAAO,EAAE,OAAO,MAAM,YAAY,OAAO,MAAA;AACtE,SAAO,EAAE,OAAO,cAAc,KAAK,MAAM,GAAG,YAAY,MAAM,MAAA;AAChE;AAoBO,SAAS,qBAAqB;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAOsB;AACpB,MAAI,CAAC,UAAU,iBAAiB,EAAG,QAAO,EAAE,MAAM,OAAA;AAClD,QAAM,UAAU,iBAAiB,UAAa,iBAAiB,KAAK,OAAO;AAC3E,MAAI,cAAc,MAAM,MAAM,QAAS,QAAO,EAAE,MAAM,OAAA;AACtD,SAAO,EAAE,MAAM,SAAS,OAAO,EAAE,OAAO,UAAQ;AAClD;"}

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

@@ -19,12 +19,21 @@ function resolveAgentProp({ agent }) {
     `[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 effectiveStatewireModel({
+  model,
+  extraRunConfig
+}) {
+  if (extraRunConfig !== void 0 && Object.hasOwn(extraRunConfig, "model")) {
+    const override = extraRunConfig.model;
+    return typeof override === "string" && override !== "" ? override : void 0;
+  }
+  return model === "" ? void 0 : model;
+}
 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 ?? []])
   );
@@ -43,7 +52,11 @@ function buildStatewireRunConfig(options = {}) {
       // agent's configured tools. Omit it when empty.
       ...enabledTools.length > 0 ? { enabled_tools: enabledTools } : {},
       panel_config: {
-        model: panelModel,
+        // A collab agent's thread with no explicit model names none here
+        // either: agora stores this panel on the thread's first run and
+        // replays it to every client, and a stored SDK default would show as
+        // the session's model while the agent's own model runs.
+        ...model ? { model } : {},
         enabled_tools: enabledTools,
         system_prompt: systemPrompt,
         run_label: STATEWIRE_RUN_LABEL
@@ -63,6 +76,7 @@ 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.effectiveStatewireModel = effectiveStatewireModel;
 exports.parseCollabAgentRef = parseCollabAgentRef;
 exports.resolveAgentProp = resolveAgentProp;
 //# sourceMappingURL=statewire-run-config.cjs.map

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

@@ -1 +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-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;;;;;;;"}
+{"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-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 * The model a send carries for the host's `model` and `extraRunConfig`, with\n * the precedence {@link buildStatewireRunConfig} applies: `extraRunConfig` is\n * merged last, so its `model` key (when it has one) wins over the `model`\n * prop. `undefined` when the send carries no explicit model.\n */\nexport function effectiveStatewireModel({\n  model,\n  extraRunConfig,\n}: {\n  model: string | undefined;\n  extraRunConfig: Record<string, unknown> | undefined;\n}): string | undefined {\n  if (extraRunConfig !== undefined && Object.hasOwn(extraRunConfig, 'model')) {\n    const override = extraRunConfig.model;\n    return typeof override === 'string' && override !== '' ? override : undefined;\n  }\n  return model === '' ? undefined : model;\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 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        // A collab agent's thread with no explicit model names none here\n        // either: agora stores this panel on the thread's first run and\n        // replays it to every client, and a stored SDK default would show as\n        // the session's model while the agent's own model runs.\n        ...(model ? { model } : {}),\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;AA0CO,SAAS,wBAAwB;AAAA,EACtC;AAAA,EACA;AACF,GAGuB;AACrB,MAAI,mBAAmB,UAAa,OAAO,OAAO,gBAAgB,OAAO,GAAG;AAC1E,UAAM,WAAW,eAAe;AAChC,WAAO,OAAO,aAAa,YAAY,aAAa,KAAK,WAAW;AAAA,EACtE;AACA,SAAO,UAAU,KAAK,SAAY;AACpC;AAYO,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,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;AAAA;AAAA;AAAA;AAAA,QAKZ,GAAI,QAAQ,EAAE,MAAA,IAAU,CAAA;AAAA,QACxB,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.d.ts

@@ -51,6 +51,16 @@ export interface StatewireRunConfigOptions {
     /** Additional fields merged into runConfig.custom. */
     extraRunConfig?: Record<string, unknown>;
 }
+/**
+ * The model a send carries for the host's `model` and `extraRunConfig`, with
+ * the precedence {@link buildStatewireRunConfig} applies: `extraRunConfig` is
+ * merged last, so its `model` key (when it has one) wins over the `model`
+ * prop. `undefined` when the send carries no explicit model.
+ */
+export declare function effectiveStatewireModel({ model, extraRunConfig, }: {
+    model: string | undefined;
+    extraRunConfig: Record<string, unknown> | undefined;
+}): string | undefined;
 /**
  * Build the `runConfig` a deep-agent statewire run is driven by. Commands
  * travel bare on the statewire channel, so this payload rides the ambient

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

@@ -17,12 +17,21 @@ function resolveAgentProp({ agent }) {
     `[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 effectiveStatewireModel({
+  model,
+  extraRunConfig
+}) {
+  if (extraRunConfig !== void 0 && Object.hasOwn(extraRunConfig, "model")) {
+    const override = extraRunConfig.model;
+    return typeof override === "string" && override !== "" ? override : void 0;
+  }
+  return model === "" ? void 0 : model;
+}
 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 ?? []])
   );
@@ -41,7 +50,11 @@ function buildStatewireRunConfig(options = {}) {
       // agent's configured tools. Omit it when empty.
       ...enabledTools.length > 0 ? { enabled_tools: enabledTools } : {},
       panel_config: {
-        model: panelModel,
+        // A collab agent's thread with no explicit model names none here
+        // either: agora stores this panel on the thread's first run and
+        // replays it to every client, and a stored SDK default would show as
+        // the session's model while the agent's own model runs.
+        ...model ? { model } : {},
         enabled_tools: enabledTools,
         system_prompt: systemPrompt,
         run_label: STATEWIRE_RUN_LABEL
@@ -62,6 +75,7 @@ export {
   COLLAB_AGENT_REF_SHAPE,
   DEFAULT_STATEWIRE_MODEL,
   buildStatewireRunConfig,
+  effectiveStatewireModel,
   parseCollabAgentRef,
   resolveAgentProp
 };

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

@@ -1 +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-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;"}
+{"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-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 * The model a send carries for the host's `model` and `extraRunConfig`, with\n * the precedence {@link buildStatewireRunConfig} applies: `extraRunConfig` is\n * merged last, so its `model` key (when it has one) wins over the `model`\n * prop. `undefined` when the send carries no explicit model.\n */\nexport function effectiveStatewireModel({\n  model,\n  extraRunConfig,\n}: {\n  model: string | undefined;\n  extraRunConfig: Record<string, unknown> | undefined;\n}): string | undefined {\n  if (extraRunConfig !== undefined && Object.hasOwn(extraRunConfig, 'model')) {\n    const override = extraRunConfig.model;\n    return typeof override === 'string' && override !== '' ? override : undefined;\n  }\n  return model === '' ? undefined : model;\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 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        // A collab agent's thread with no explicit model names none here\n        // either: agora stores this panel on the thread's first run and\n        // replays it to every client, and a stored SDK default would show as\n        // the session's model while the agent's own model runs.\n        ...(model ? { model } : {}),\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;AA0CO,SAAS,wBAAwB;AAAA,EACtC;AAAA,EACA;AACF,GAGuB;AACrB,MAAI,mBAAmB,UAAa,OAAO,OAAO,gBAAgB,OAAO,GAAG;AAC1E,UAAM,WAAW,eAAe;AAChC,WAAO,OAAO,aAAa,YAAY,aAAa,KAAK,WAAW;AAAA,EACtE;AACA,SAAO,UAAU,KAAK,SAAY;AACpC;AAYO,SAAS,wBACd,UAAqC,IACZ;AA9G3B;AA+GE,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,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;AAAA;AAAA;AAAA;AAAA,QAKZ,GAAI,QAAQ,EAAE,MAAA,IAAU,CAAA;AAAA,QACxB,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-server-lane-context.cjs

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+const STATEWIRE_SERVER_LANE_PENDING = Object.freeze({
+  landed: false,
+  config: null
+});
+const AthenaStatewireServerLaneContext = react.createContext(
+  null
+);
+function nextServerLane({
+  previous,
+  config
+}) {
+  var _a;
+  if (previous.landed && (((_a = previous.config) == null ? void 0 : _a.version) ?? 0) === ((config == null ? void 0 : config.version) ?? 0)) {
+    return previous;
+  }
+  return { landed: true, config };
+}
+exports.AthenaStatewireServerLaneContext = AthenaStatewireServerLaneContext;
+exports.STATEWIRE_SERVER_LANE_PENDING = STATEWIRE_SERVER_LANE_PENDING;
+exports.nextServerLane = nextServerLane;
+//# sourceMappingURL=statewire-server-lane-context.cjs.map

package/dist/runtime/statewire-server-lane-context.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"statewire-server-lane-context.cjs","sources":["../../src/runtime/statewire-server-lane-context.ts"],"sourcesContent":["import type { DeepAgentServerConfig } from '@athenaintel/agent-runtime';\nimport { createContext } from 'react';\n\n/**\n * The thread's server config lane as the statewire host last sent it on this\n * attach, read off the transport's own state (`onStateChange`) rather than the\n * thread state the chat renders.\n *\n * The rendered state starts as a placeholder (or a remembered snapshot) before\n * the attach snapshot lands, and neither says what the server holds: a\n * placeholder has no lane at all and a remembered snapshot may carry an older\n * one. Anything that decides from the lane (`useAthenaThreadModel`, the model\n * write in `StatewireModelLaneSync`) waits for `landed`.\n */\nexport interface AthenaStatewireServerLane {\n  /** `true` once this attach's snapshot from the host has arrived. */\n  landed: boolean;\n  /** The lane in that snapshot (and every later host frame), `null` at version 0. */\n  config: DeepAgentServerConfig | null;\n}\n\nexport const STATEWIRE_SERVER_LANE_PENDING: AthenaStatewireServerLane = Object.freeze({\n  landed: false,\n  config: null,\n});\n\n/** Provided by `AthenaProvider` around the host's children, per attached thread. */\nexport const AthenaStatewireServerLaneContext = createContext<AthenaStatewireServerLane | null>(\n  null,\n);\n\n/**\n * The next lane value for a host frame: the same object while the lane's\n * version is unchanged, so a frame that moved only messages (every streamed\n * token) re-renders nothing.\n */\nexport function nextServerLane({\n  previous,\n  config,\n}: {\n  previous: AthenaStatewireServerLane;\n  config: DeepAgentServerConfig | null;\n}): AthenaStatewireServerLane {\n  if (previous.landed && (previous.config?.version ?? 0) === (config?.version ?? 0)) {\n    return previous;\n  }\n  return { landed: true, config };\n}\n"],"names":["createContext"],"mappings":";;;AAqBO,MAAM,gCAA2D,OAAO,OAAO;AAAA,EACpF,QAAQ;AAAA,EACR,QAAQ;AACV,CAAC;AAGM,MAAM,mCAAmCA,MAAAA;AAAAA,EAC9C;AACF;AAOO,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AACF,GAG8B;;AAC5B,MAAI,SAAS,aAAW,cAAS,WAAT,mBAAiB,YAAW,SAAQ,iCAAQ,YAAW,IAAI;AACjF,WAAO;AAAA,EACT;AACA,SAAO,EAAE,QAAQ,MAAM,OAAA;AACzB;;;;"}

package/dist/runtime/statewire-server-lane-context.d.ts

@@ -0,0 +1,30 @@
+import type { DeepAgentServerConfig } from '@athenaintel/agent-runtime';
+/**
+ * The thread's server config lane as the statewire host last sent it on this
+ * attach, read off the transport's own state (`onStateChange`) rather than the
+ * thread state the chat renders.
+ *
+ * The rendered state starts as a placeholder (or a remembered snapshot) before
+ * the attach snapshot lands, and neither says what the server holds: a
+ * placeholder has no lane at all and a remembered snapshot may carry an older
+ * one. Anything that decides from the lane (`useAthenaThreadModel`, the model
+ * write in `StatewireModelLaneSync`) waits for `landed`.
+ */
+export interface AthenaStatewireServerLane {
+    /** `true` once this attach's snapshot from the host has arrived. */
+    landed: boolean;
+    /** The lane in that snapshot (and every later host frame), `null` at version 0. */
+    config: DeepAgentServerConfig | null;
+}
+export declare const STATEWIRE_SERVER_LANE_PENDING: AthenaStatewireServerLane;
+/** Provided by `AthenaProvider` around the host's children, per attached thread. */
+export declare const AthenaStatewireServerLaneContext: import("react").Context<AthenaStatewireServerLane | null>;
+/**
+ * The next lane value for a host frame: the same object while the lane's
+ * version is unchanged, so a frame that moved only messages (every streamed
+ * token) re-renders nothing.
+ */
+export declare function nextServerLane({ previous, config, }: {
+    previous: AthenaStatewireServerLane;
+    config: DeepAgentServerConfig | null;
+}): AthenaStatewireServerLane;

package/dist/runtime/statewire-server-lane-context.js

@@ -0,0 +1,24 @@
+import { createContext } from "react";
+const STATEWIRE_SERVER_LANE_PENDING = Object.freeze({
+  landed: false,
+  config: null
+});
+const AthenaStatewireServerLaneContext = createContext(
+  null
+);
+function nextServerLane({
+  previous,
+  config
+}) {
+  var _a;
+  if (previous.landed && (((_a = previous.config) == null ? void 0 : _a.version) ?? 0) === ((config == null ? void 0 : config.version) ?? 0)) {
+    return previous;
+  }
+  return { landed: true, config };
+}
+export {
+  AthenaStatewireServerLaneContext,
+  STATEWIRE_SERVER_LANE_PENDING,
+  nextServerLane
+};
+//# sourceMappingURL=statewire-server-lane-context.js.map

package/dist/runtime/statewire-server-lane-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statewire-server-lane-context.js","sources":["../../src/runtime/statewire-server-lane-context.ts"],"sourcesContent":["import type { DeepAgentServerConfig } from '@athenaintel/agent-runtime';\nimport { createContext } from 'react';\n\n/**\n * The thread's server config lane as the statewire host last sent it on this\n * attach, read off the transport's own state (`onStateChange`) rather than the\n * thread state the chat renders.\n *\n * The rendered state starts as a placeholder (or a remembered snapshot) before\n * the attach snapshot lands, and neither says what the server holds: a\n * placeholder has no lane at all and a remembered snapshot may carry an older\n * one. Anything that decides from the lane (`useAthenaThreadModel`, the model\n * write in `StatewireModelLaneSync`) waits for `landed`.\n */\nexport interface AthenaStatewireServerLane {\n  /** `true` once this attach's snapshot from the host has arrived. */\n  landed: boolean;\n  /** The lane in that snapshot (and every later host frame), `null` at version 0. */\n  config: DeepAgentServerConfig | null;\n}\n\nexport const STATEWIRE_SERVER_LANE_PENDING: AthenaStatewireServerLane = Object.freeze({\n  landed: false,\n  config: null,\n});\n\n/** Provided by `AthenaProvider` around the host's children, per attached thread. */\nexport const AthenaStatewireServerLaneContext = createContext<AthenaStatewireServerLane | null>(\n  null,\n);\n\n/**\n * The next lane value for a host frame: the same object while the lane's\n * version is unchanged, so a frame that moved only messages (every streamed\n * token) re-renders nothing.\n */\nexport function nextServerLane({\n  previous,\n  config,\n}: {\n  previous: AthenaStatewireServerLane;\n  config: DeepAgentServerConfig | null;\n}): AthenaStatewireServerLane {\n  if (previous.landed && (previous.config?.version ?? 0) === (config?.version ?? 0)) {\n    return previous;\n  }\n  return { landed: true, config };\n}\n"],"names":[],"mappings":";AAqBO,MAAM,gCAA2D,OAAO,OAAO;AAAA,EACpF,QAAQ;AAAA,EACR,QAAQ;AACV,CAAC;AAGM,MAAM,mCAAmC;AAAA,EAC9C;AACF;AAOO,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AACF,GAG8B;;AAC5B,MAAI,SAAS,aAAW,cAAS,WAAT,mBAAiB,YAAW,SAAQ,iCAAQ,YAAW,IAAI;AACjF,WAAO;AAAA,EACT;AACA,SAAO,EAAE,QAAQ,MAAM,OAAA;AACzB;"}