@athenaintel/react 0.32.0 → 0.35.0

package/dist/runtime/StatewireThreadConfigLaneSync.js

@@ -0,0 +1,125 @@
+import { useStatewireSendCommand } from "@assistant-ui/react-statewire";
+import { useRef, useState, useEffect } from "react";
+import { athenaDiagnostics } from "../diagnostics/athena-diagnostics.js";
+import { PROVIDER_THREAD_CONFIG_KEYS, sameThreadConfigValue, decideThreadConfigLanePatch, patchedThreadConfigKeys } from "./statewire-thread-config-lane.js";
+import { useDeepAgentConfigController, isConfigWriteForbiddenRejection, isConfigSyncUnavailableRejection } from "../agent-runtime/src/use-deep-agent-config.js";
+import { statewireTransportOutcome } from "../agent-runtime/src/errors.js";
+const MAX_PATCH_ATTEMPTS_PER_CHANGE = 3;
+const RETRY_BACKOFF_MS = [1e3, 4e3];
+function configWriteData({
+  threadId,
+  patch
+}) {
+  const otherKeys = patchedThreadConfigKeys(patch).filter((key) => key !== "model");
+  return {
+    thread_id: threadId,
+    ...Object.hasOwn(patch, "model") && { model: patch.model },
+    ...otherKeys.length > 0 && { config_keys: otherKeys }
+  };
+}
+function StatewireThreadConfigLaneSync({
+  threadId,
+  config,
+  lane,
+  channelLive
+}) {
+  const send = useStatewireSendCommand();
+  const sendCommand = (command) => Promise.resolve(send(command));
+  const { configVersion, custom, patchConfig } = useDeepAgentConfigController({
+    serverConfig: lane.config,
+    sendCommand
+  });
+  const seenRef = useRef(config);
+  const pendingRef = useRef(/* @__PURE__ */ new Set());
+  const attemptsRef = useRef(/* @__PURE__ */ new Map());
+  const closedRef = useRef(false);
+  const patchConfigRef = useRef(patchConfig);
+  patchConfigRef.current = patchConfig;
+  const [retryTick, setRetryTick] = useState(0);
+  const retryTimerRef = useRef(null);
+  useEffect(
+    () => () => {
+      if (retryTimerRef.current !== null) clearTimeout(retryTimerRef.current);
+    },
+    []
+  );
+  const landed = lane.landed;
+  useEffect(() => {
+    const pending = pendingRef.current;
+    const attempts = attemptsRef.current;
+    for (const key of PROVIDER_THREAD_CONFIG_KEYS) {
+      if (sameThreadConfigValue(config[key], seenRef.current[key])) continue;
+      pending.add(key);
+      attempts.set(key, 0);
+    }
+    seenRef.current = config;
+    if (pending.size === 0 || closedRef.current || !channelLive) return;
+    const decision = decideThreadConfigLanePatch({
+      desired: config,
+      keys: pending,
+      landed,
+      configVersion,
+      custom
+    });
+    if (decision.kind === "wait") return;
+    pending.clear();
+    if (decision.kind === "done") return;
+    const { patch } = decision;
+    const patchKeys = patchedThreadConfigKeys(patch);
+    for (const key of patchKeys) attempts.set(key, (attempts.get(key) ?? 0) + 1);
+    const modelOnly = patchKeys.length === 1 && patchKeys[0] === "model";
+    patchConfigRef.current(patch).catch((error) => {
+      const data = configWriteData({ threadId, patch });
+      if (isConfigWriteForbiddenRejection(error) || isConfigSyncUnavailableRejection(error)) {
+        closedRef.current = true;
+        athenaDiagnostics.emit("statewire.config", {
+          level: "warn",
+          data: {
+            ...data,
+            reason: isConfigWriteForbiddenRejection(error) ? "config_write_forbidden" : "config_sync_unavailable"
+          }
+        });
+        return;
+      }
+      const outcome = statewireTransportOutcome(error);
+      if (outcome !== null) {
+        athenaDiagnostics.emit("statewire.config", {
+          level: "debug",
+          data: { ...data, outcome }
+        });
+        if (outcome === "unmount") return;
+        const retryKeys = patchKeys.filter(
+          (key) => sameThreadConfigValue(seenRef.current[key], patch[key] ?? null) && (attempts.get(key) ?? 0) < MAX_PATCH_ATTEMPTS_PER_CHANGE
+        );
+        if (retryKeys.length === 0) return;
+        for (const key of retryKeys) pendingRef.current.add(key);
+        const written = Math.max(...retryKeys.map((key) => attempts.get(key) ?? 1));
+        const delay = RETRY_BACKOFF_MS[Math.min(written - 1, RETRY_BACKOFF_MS.length - 1)];
+        retryTimerRef.current = setTimeout(() => {
+          retryTimerRef.current = null;
+          setRetryTick((tick) => tick + 1);
+        }, delay);
+        return;
+      }
+      athenaDiagnostics.error(
+        "statewire.config",
+        error,
+        modelOnly ? {
+          code: "statewire_rejected",
+          message: "The statewire host refused the model change",
+          hint: "Inspect error.detail: agora rejections carry a structured {code, message}. The thread keeps running with the model its server config holds."
+        } : {
+          code: "statewire_rejected",
+          message: "The statewire host refused the thread config change",
+          hint: "Inspect error.detail: agora rejections carry a structured {code, message}. The thread keeps running with the config its server config holds."
+        },
+        data
+      );
+    });
+  }, [config, landed, configVersion, custom, channelLive, retryTick, threadId]);
+  return null;
+}
+export {
+  StatewireThreadConfigLaneSync
+};
+//# sourceMappingURL=StatewireThreadConfigLaneSync.js.map

package/dist/runtime/StatewireThreadConfigLaneSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatewireThreadConfigLaneSync.js","sources":["../../src/runtime/StatewireThreadConfigLaneSync.tsx"],"sourcesContent":["import { useStatewireSendCommand } from '@assistant-ui/react-statewire';\nimport {\n  type DeepAgentConfigControllerInputs,\n  isConfigSyncUnavailableRejection,\n  isConfigWriteForbiddenRejection,\n  statewireTransportOutcome,\n  useDeepAgentConfigController,\n} from '@athenaintel/agent-runtime';\nimport { useEffect, useRef, useState } from 'react';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport type { AthenaStatewireServerLane } from './statewire-server-lane-context';\nimport {\n  decideThreadConfigLanePatch,\n  PROVIDER_THREAD_CONFIG_KEYS,\n  type ProviderThreadConfig,\n  type ProviderThreadConfigKey,\n  type ProviderThreadConfigPatch,\n  patchedThreadConfigKeys,\n  sameThreadConfigValue,\n} from './statewire-thread-config-lane';\n\n/** Writes of one change, the first included, before the sync gives up on it. */\nconst MAX_PATCH_ATTEMPTS_PER_CHANGE = 3;\n\n/** Wait before re-writing a change the channel dropped: 1 s, then 4 s. */\nconst RETRY_BACKOFF_MS = [1_000, 4_000] as const;\n\n/**\n * What a `statewire.config` event says about a write: the thread, the model it\n * set (`null`: unset), and the other provider-owned keys it set\n * (`config_keys`), never their values (a system prompt is the host's text).\n */\nfunction configWriteData({\n  threadId,\n  patch,\n}: {\n  threadId: string;\n  patch: ProviderThreadConfigPatch;\n}): Record<string, unknown> {\n  const otherKeys = patchedThreadConfigKeys(patch).filter((key) => key !== 'model');\n  return {\n    thread_id: threadId,\n    ...(Object.hasOwn(patch, 'model') && { model: patch.model }),\n    ...(otherKeys.length > 0 && { config_keys: otherKeys }),\n  };\n}\n\n/**\n * Writes the provider-owned thread-config keys to the thread's server config\n * lane when the host changes the props that feed them during an attach:\n * `model`, `systemPrompt` (`system_prompt`), `tools` and `frontendTools`\n * (`enabled_tools`), `workbench` and `knowledgeBase` (`knowledge_base`).\n *\n * Once a thread has a lane (version > 0), agora composes every run from the\n * lane and drops the thread-config keys a send carries, so a model, prompt,\n * tool list or asset list changed after the thread's first turn would never\n * apply. A change of such a prop therefore becomes one `config/patch`\n * carrying exactly the changed keys, each with the value the send would carry\n * (`null` when the send carries none: the key is unset, so the collab agent's\n * own value, or the default, applies). An empty tool or asset list is `null`,\n * as the send omits it.\n *\n * Only a CHANGE is written. A prop's value when the attach starts is never\n * written, even when the lane holds another value: that value is another\n * client's (or an earlier session's) choice for this thread, and an SDK app's\n * global setting must not overwrite it just by opening the thread. Hosts that\n * want the picker to follow the thread read `useAthenaThreadModel`.\n *\n * Decisions read the lane the host itself sent on this attach (`lane`, from\n * the transport), never the rendered thread state: before the attach snapshot\n * lands that state is a placeholder without a lane, or a remembered snapshot\n * with an older one, and comparing a change against either would write over\n * the session's real config. A change made before the snapshot lands waits\n * for it.\n *\n * A version-0 thread needs no write: the next send carries the values and\n * agora's deferral seed persists them. A change stays pending until the lane\n * exists, so a lane an earlier send seeds with the previous values is\n * corrected when it lands. A refusal that can never succeed (a view-only\n * collaborator, a workspace without server config) stops the sync for the\n * attach and is reported on the diagnostics bus. A write the channel dropped\n * (a lost stream, the host's expired verdict) stays pending and is written\n * again after a backoff once the channel is live, at most\n * {@link MAX_PATCH_ATTEMPTS_PER_CHANGE} times per change.\n *\n * The writes go through the `config/*` command family, which agora gates on\n * EDIT on the thread's session asset (`_authorize_config_write`).\n *\n * Mounted under the runtime's `AuiProvider`, keyed by the thread, so each\n * attach starts with nothing pending.\n */\nexport function StatewireThreadConfigLaneSync({\n  threadId,\n  config,\n  lane,\n  channelLive,\n}: {\n  threadId: string;\n  /** The values this thread's sends carry, published with the thread (see the provider). */\n  config: ProviderThreadConfig;\n  lane: AthenaStatewireServerLane;\n  /** Whether the channel can take a command now; writes wait for it. */\n  channelLive: boolean;\n}): null {\n  const send = useStatewireSendCommand();\n  const sendCommand: DeepAgentConfigControllerInputs['sendCommand'] = (command) =>\n    Promise.resolve(send(command));\n  const { configVersion, custom, patchConfig } = useDeepAgentConfigController({\n    serverConfig: lane.config,\n    sendCommand,\n  });\n\n  const seenRef = useRef(config);\n  const pendingRef = useRef(new Set<ProviderThreadConfigKey>());\n  const attemptsRef = useRef(new Map<ProviderThreadConfigKey, number>());\n  const closedRef = useRef(false);\n  const patchConfigRef = useRef(patchConfig);\n  patchConfigRef.current = patchConfig;\n  // Bumped (after a backoff) to re-run the effect for a write the channel dropped.\n  const [retryTick, setRetryTick] = useState(0);\n  const retryTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  useEffect(\n    () => () => {\n      if (retryTimerRef.current !== null) clearTimeout(retryTimerRef.current);\n    },\n    [],\n  );\n  const landed = lane.landed;\n\n  useEffect(() => {\n    const pending = pendingRef.current;\n    const attempts = attemptsRef.current;\n    for (const key of PROVIDER_THREAD_CONFIG_KEYS) {\n      if (sameThreadConfigValue(config[key], seenRef.current[key])) continue;\n      pending.add(key);\n      attempts.set(key, 0);\n    }\n    seenRef.current = config;\n    if (pending.size === 0 || closedRef.current || !channelLive) return;\n    const decision = decideThreadConfigLanePatch({\n      desired: config,\n      keys: pending,\n      landed,\n      configVersion,\n      custom,\n    });\n    if (decision.kind === 'wait') return;\n    pending.clear();\n    if (decision.kind === 'done') return;\n\n    const { patch } = decision;\n    const patchKeys = patchedThreadConfigKeys(patch);\n    for (const key of patchKeys) attempts.set(key, (attempts.get(key) ?? 0) + 1);\n    const modelOnly = patchKeys.length === 1 && patchKeys[0] === 'model';\n    patchConfigRef.current(patch).catch((error: unknown) => {\n      const data = configWriteData({ threadId, patch });\n      if (isConfigWriteForbiddenRejection(error) || isConfigSyncUnavailableRejection(error)) {\n        closedRef.current = true;\n        athenaDiagnostics.emit('statewire.config', {\n          level: 'warn',\n          data: {\n            ...data,\n            reason: isConfigWriteForbiddenRejection(error)\n              ? 'config_write_forbidden'\n              : 'config_sync_unavailable',\n          },\n        });\n        return;\n      }\n      const outcome = statewireTransportOutcome(error);\n      if (outcome !== null) {\n        // Channel weather (a dropped stream, the host's expired verdict): keep\n        // each change pending and write it again after a backoff, once the\n        // channel is live, unless its prop has moved on or the attach is gone.\n        athenaDiagnostics.emit('statewire.config', {\n          level: 'debug',\n          data: { ...data, outcome },\n        });\n        if (outcome === 'unmount') return;\n        const retryKeys = patchKeys.filter(\n          (key) =>\n            sameThreadConfigValue(seenRef.current[key], patch[key] ?? null) &&\n            (attempts.get(key) ?? 0) < MAX_PATCH_ATTEMPTS_PER_CHANGE,\n        );\n        if (retryKeys.length === 0) return;\n        for (const key of retryKeys) pendingRef.current.add(key);\n        const written = Math.max(...retryKeys.map((key) => attempts.get(key) ?? 1));\n        const delay = RETRY_BACKOFF_MS[Math.min(written - 1, RETRY_BACKOFF_MS.length - 1)];\n        retryTimerRef.current = setTimeout(() => {\n          retryTimerRef.current = null;\n          setRetryTick((tick) => tick + 1);\n        }, delay);\n        return;\n      }\n      athenaDiagnostics.error(\n        'statewire.config',\n        error,\n        modelOnly\n          ? {\n              code: 'statewire_rejected',\n              message: 'The statewire host refused the model change',\n              hint: 'Inspect error.detail: agora rejections carry a structured {code, message}. The thread keeps running with the model its server config holds.',\n            }\n          : {\n              code: 'statewire_rejected',\n              message: 'The statewire host refused the thread config change',\n              hint: 'Inspect error.detail: agora rejections carry a structured {code, message}. The thread keeps running with the config its server config holds.',\n            },\n        data,\n      );\n    });\n  }, [config, landed, configVersion, custom, channelLive, retryTick, threadId]);\n\n  return null;\n}\n"],"names":[],"mappings":";;;;;;AAsBA,MAAM,gCAAgC;AAGtC,MAAM,mBAAmB,CAAC,KAAO,GAAK;AAOtC,SAAS,gBAAgB;AAAA,EACvB;AAAA,EACA;AACF,GAG4B;AAC1B,QAAM,YAAY,wBAAwB,KAAK,EAAE,OAAO,CAAC,QAAQ,QAAQ,OAAO;AAChF,SAAO;AAAA,IACL,WAAW;AAAA,IACX,GAAI,OAAO,OAAO,OAAO,OAAO,KAAK,EAAE,OAAO,MAAM,MAAA;AAAA,IACpD,GAAI,UAAU,SAAS,KAAK,EAAE,aAAa,UAAA;AAAA,EAAU;AAEzD;AA8CO,SAAS,8BAA8B;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAOS;AACP,QAAM,OAAO,wBAAA;AACb,QAAM,cAA8D,CAAC,YACnE,QAAQ,QAAQ,KAAK,OAAO,CAAC;AAC/B,QAAM,EAAE,eAAe,QAAQ,YAAA,IAAgB,6BAA6B;AAAA,IAC1E,cAAc,KAAK;AAAA,IACnB;AAAA,EAAA,CACD;AAED,QAAM,UAAU,OAAO,MAAM;AAC7B,QAAM,aAAa,OAAO,oBAAI,KAA8B;AAC5D,QAAM,cAAc,OAAO,oBAAI,KAAsC;AACrE,QAAM,YAAY,OAAO,KAAK;AAC9B,QAAM,iBAAiB,OAAO,WAAW;AACzC,iBAAe,UAAU;AAEzB,QAAM,CAAC,WAAW,YAAY,IAAI,SAAS,CAAC;AAC5C,QAAM,gBAAgB,OAA6C,IAAI;AACvE;AAAA,IACE,MAAM,MAAM;AACV,UAAI,cAAc,YAAY,KAAM,cAAa,cAAc,OAAO;AAAA,IACxE;AAAA,IACA,CAAA;AAAA,EAAC;AAEH,QAAM,SAAS,KAAK;AAEpB,YAAU,MAAM;AACd,UAAM,UAAU,WAAW;AAC3B,UAAM,WAAW,YAAY;AAC7B,eAAW,OAAO,6BAA6B;AAC7C,UAAI,sBAAsB,OAAO,GAAG,GAAG,QAAQ,QAAQ,GAAG,CAAC,EAAG;AAC9D,cAAQ,IAAI,GAAG;AACf,eAAS,IAAI,KAAK,CAAC;AAAA,IACrB;AACA,YAAQ,UAAU;AAClB,QAAI,QAAQ,SAAS,KAAK,UAAU,WAAW,CAAC,YAAa;AAC7D,UAAM,WAAW,4BAA4B;AAAA,MAC3C,SAAS;AAAA,MACT,MAAM;AAAA,MACN;AAAA,MACA;AAAA,MACA;AAAA,IAAA,CACD;AACD,QAAI,SAAS,SAAS,OAAQ;AAC9B,YAAQ,MAAA;AACR,QAAI,SAAS,SAAS,OAAQ;AAE9B,UAAM,EAAE,UAAU;AAClB,UAAM,YAAY,wBAAwB,KAAK;AAC/C,eAAW,OAAO,UAAW,UAAS,IAAI,MAAM,SAAS,IAAI,GAAG,KAAK,KAAK,CAAC;AAC3E,UAAM,YAAY,UAAU,WAAW,KAAK,UAAU,CAAC,MAAM;AAC7D,mBAAe,QAAQ,KAAK,EAAE,MAAM,CAAC,UAAmB;AACtD,YAAM,OAAO,gBAAgB,EAAE,UAAU,OAAO;AAChD,UAAI,gCAAgC,KAAK,KAAK,iCAAiC,KAAK,GAAG;AACrF,kBAAU,UAAU;AACpB,0BAAkB,KAAK,oBAAoB;AAAA,UACzC,OAAO;AAAA,UACP,MAAM;AAAA,YACJ,GAAG;AAAA,YACH,QAAQ,gCAAgC,KAAK,IACzC,2BACA;AAAA,UAAA;AAAA,QACN,CACD;AACD;AAAA,MACF;AACA,YAAM,UAAU,0BAA0B,KAAK;AAC/C,UAAI,YAAY,MAAM;AAIpB,0BAAkB,KAAK,oBAAoB;AAAA,UACzC,OAAO;AAAA,UACP,MAAM,EAAE,GAAG,MAAM,QAAA;AAAA,QAAQ,CAC1B;AACD,YAAI,YAAY,UAAW;AAC3B,cAAM,YAAY,UAAU;AAAA,UAC1B,CAAC,QACC,sBAAsB,QAAQ,QAAQ,GAAG,GAAG,MAAM,GAAG,KAAK,IAAI,MAC7D,SAAS,IAAI,GAAG,KAAK,KAAK;AAAA,QAAA;AAE/B,YAAI,UAAU,WAAW,EAAG;AAC5B,mBAAW,OAAO,UAAW,YAAW,QAAQ,IAAI,GAAG;AACvD,cAAM,UAAU,KAAK,IAAI,GAAG,UAAU,IAAI,CAAC,QAAQ,SAAS,IAAI,GAAG,KAAK,CAAC,CAAC;AAC1E,cAAM,QAAQ,iBAAiB,KAAK,IAAI,UAAU,GAAG,iBAAiB,SAAS,CAAC,CAAC;AACjF,sBAAc,UAAU,WAAW,MAAM;AACvC,wBAAc,UAAU;AACxB,uBAAa,CAAC,SAAS,OAAO,CAAC;AAAA,QACjC,GAAG,KAAK;AACR;AAAA,MACF;AACA,wBAAkB;AAAA,QAChB;AAAA,QACA;AAAA,QACA,YACI;AAAA,UACE,MAAM;AAAA,UACN,SAAS;AAAA,UACT,MAAM;AAAA,QAAA,IAER;AAAA,UACE,MAAM;AAAA,UACN,SAAS;AAAA,UACT,MAAM;AAAA,QAAA;AAAA,QAEZ;AAAA,MAAA;AAAA,IAEJ,CAAC;AAAA,EACH,GAAG,CAAC,QAAQ,QAAQ,eAAe,QAAQ,aAAa,WAAW,QAAQ,CAAC;AAE5E,SAAO;AACT;"}

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

@@ -11,18 +11,6 @@ function threadModelFromLane({
   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

@@ -1 +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;;;;"}
+{"version":3,"file":"statewire-model-lane.cjs","sources":["../../src/runtime/statewire-model-lane.ts"],"sourcesContent":["import type { DeepAgentServerConfig, ThreadConfigCustom } from '@athenaintel/agent-runtime';\nimport { decideThreadConfigLanePatch } from './statewire-thread-config-lane';\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 (the\n * `model` key of {@link decideThreadConfigLanePatch}, which decides every\n * provider-owned key the same way):\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  const desired = desiredModel === undefined || desiredModel === '' ? null : desiredModel;\n  const decision = decideThreadConfigLanePatch({\n    desired: {\n      model: desired,\n      system_prompt: null,\n      enabled_tools: null,\n      workbench: null,\n      knowledge_base: null,\n    },\n    keys: ['model'],\n    landed,\n    configVersion,\n    custom,\n  });\n  if (decision.kind !== 'patch') return decision;\n  return { kind: 'patch', patch: { model: desired } };\n}\n"],"names":[],"mappings":";;AA8BO,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;;;"}

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

@@ -32,7 +32,9 @@ export declare function threadModelFromLane({ lane, ready, }: {
     ready: boolean;
 }): AthenaThreadModel;
 /**
- * What to do with a `model` prop change the host made during an attach:
+ * What to do with a `model` prop change the host made during an attach (the
+ * `model` key of {@link decideThreadConfigLanePatch}, which decides every
+ * provider-owned key the same way):
  *
  * - `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:

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

@@ -9,19 +9,7 @@ function threadModelFromLane({
   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
 };

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

@@ -1 +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;"}
+{"version":3,"file":"statewire-model-lane.js","sources":["../../src/runtime/statewire-model-lane.ts"],"sourcesContent":["import type { DeepAgentServerConfig, ThreadConfigCustom } from '@athenaintel/agent-runtime';\nimport { decideThreadConfigLanePatch } from './statewire-thread-config-lane';\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 (the\n * `model` key of {@link decideThreadConfigLanePatch}, which decides every\n * provider-owned key the same way):\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  const desired = desiredModel === undefined || desiredModel === '' ? null : desiredModel;\n  const decision = decideThreadConfigLanePatch({\n    desired: {\n      model: desired,\n      system_prompt: null,\n      enabled_tools: null,\n      workbench: null,\n      knowledge_base: null,\n    },\n    keys: ['model'],\n    landed,\n    configVersion,\n    custom,\n  });\n  if (decision.kind !== 'patch') return decision;\n  return { kind: 'patch', patch: { model: desired } };\n}\n"],"names":[],"mappings":"AA8BO,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;"}

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

@@ -1 +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;;;;"}
+{"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\n * thread-config writes in `StatewireThreadConfigLaneSync`) 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

@@ -7,8 +7,8 @@ import type { DeepAgentServerConfig } from '@athenaintel/agent-runtime';
  * 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`.
+ * one. Anything that decides from the lane (`useAthenaThreadModel`, the
+ * thread-config writes in `StatewireThreadConfigLaneSync`) waits for `landed`.
  */
 export interface AthenaStatewireServerLane {
     /** `true` once this attach's snapshot from the host has arrived. */

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

@@ -1 +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;"}
+{"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\n * thread-config writes in `StatewireThreadConfigLaneSync`) 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;"}

package/dist/runtime/statewire-thread-config-lane.cjs

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const statewireRunConfig = require("./statewire-run-config.cjs");
+const PROVIDER_THREAD_CONFIG_KEYS = [
+  "model",
+  "system_prompt",
+  "enabled_tools",
+  "workbench",
+  "knowledge_base"
+];
+const nonBlankString = (value) => typeof value === "string" && value.trim() !== "" ? value : null;
+const stringItems = (value) => value.filter((item) => typeof item === "string");
+const propList = (value) => value !== void 0 && value.length > 0 ? value : null;
+const extraList = (value) => Array.isArray(value) ? stringItems(value) : null;
+function providerThreadConfig({
+  model,
+  systemPrompt,
+  tools,
+  frontendToolIds,
+  workbench,
+  knowledgeBase,
+  extraRunConfig
+}) {
+  const extra = extraRunConfig ?? {};
+  const overrides = (key) => Object.hasOwn(extra, key);
+  const enabledTools = Array.from(/* @__PURE__ */ new Set([...tools ?? [], ...frontendToolIds ?? []]));
+  const trimmedPrompt = (systemPrompt == null ? void 0 : systemPrompt.trim()) ?? "";
+  return {
+    model: statewireRunConfig.effectiveStatewireModel({ model, extraRunConfig }) ?? null,
+    system_prompt: overrides("system_prompt") ? nonBlankString(extra.system_prompt) : trimmedPrompt === "" ? null : trimmedPrompt,
+    enabled_tools: overrides("enabled_tools") ? extraList(extra.enabled_tools) : propList(enabledTools),
+    workbench: overrides("workbench") ? extraList(extra.workbench) : propList(workbench),
+    knowledge_base: overrides("knowledge_base") ? extraList(extra.knowledge_base) : propList(knowledgeBase)
+  };
+}
+function readLaneThreadConfigValue({
+  custom,
+  key
+}) {
+  const value = custom[key];
+  if (key === "model") return typeof value === "string" && value !== "" ? value : null;
+  if (key === "system_prompt") return nonBlankString(value);
+  return Array.isArray(value) ? stringItems(value) : null;
+}
+function sameThreadConfigValue(left, right) {
+  if (left === right) return true;
+  if (!Array.isArray(left) || !Array.isArray(right)) return false;
+  return left.length === right.length && left.every((item, index) => item === right[index]);
+}
+function decideThreadConfigLanePatch({
+  desired,
+  keys,
+  landed,
+  configVersion,
+  custom
+}) {
+  if (!landed || configVersion <= 0) return { kind: "wait" };
+  const pending = new Set(keys);
+  const patch = {};
+  for (const key of PROVIDER_THREAD_CONFIG_KEYS) {
+    if (!pending.has(key)) continue;
+    if (!sameThreadConfigValue(readLaneThreadConfigValue({ custom, key }), desired[key])) {
+      copyThreadConfigKey({ target: patch, source: desired, key });
+    }
+  }
+  return patchedThreadConfigKeys(patch).length === 0 ? { kind: "done" } : { kind: "patch", patch };
+}
+function copyThreadConfigKey({
+  target,
+  source,
+  key
+}) {
+  target[key] = source[key];
+}
+function patchedThreadConfigKeys(patch) {
+  return PROVIDER_THREAD_CONFIG_KEYS.filter((key) => Object.hasOwn(patch, key));
+}
+exports.PROVIDER_THREAD_CONFIG_KEYS = PROVIDER_THREAD_CONFIG_KEYS;
+exports.decideThreadConfigLanePatch = decideThreadConfigLanePatch;
+exports.patchedThreadConfigKeys = patchedThreadConfigKeys;
+exports.providerThreadConfig = providerThreadConfig;
+exports.readLaneThreadConfigValue = readLaneThreadConfigValue;
+exports.sameThreadConfigValue = sameThreadConfigValue;
+//# sourceMappingURL=statewire-thread-config-lane.cjs.map

package/dist/runtime/statewire-thread-config-lane.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"statewire-thread-config-lane.cjs","sources":["../../src/runtime/statewire-thread-config-lane.ts"],"sourcesContent":["import type { ThreadConfigCustom } from '@athenaintel/agent-runtime';\nimport { effectiveStatewireModel } from './statewire-run-config';\n\n/**\n * The thread-config keys the provider's props own, in the order a\n * `config/patch` lists them.\n *\n * Once a thread has a server config lane (version > 0), agora composes every\n * run from the lane and drops these keys from a send\n * (`merge_custom_over_server_config`), so a change of the prop that feeds one\n * is written to the lane instead (see `StatewireThreadConfigLaneSync`).\n */\nexport const PROVIDER_THREAD_CONFIG_KEYS = [\n  'model',\n  'system_prompt',\n  'enabled_tools',\n  'workbench',\n  'knowledge_base',\n] as const;\n\nexport type ProviderThreadConfigKey = (typeof PROVIDER_THREAD_CONFIG_KEYS)[number];\n\n/**\n * The provider-owned thread-config values as a send carries them and as the\n * lane stores them; `null` is \"the send carries none\": written to the lane it\n * unsets the key, so the collab agent's own value (or the default) applies.\n */\nexport interface ProviderThreadConfig {\n  model: string | null;\n  system_prompt: string | null;\n  enabled_tools: readonly string[] | null;\n  workbench: readonly string[] | null;\n  knowledge_base: readonly string[] | null;\n}\n\n/** A `config/patch` payload over provider-owned keys: exactly the keys to change. */\nexport type ProviderThreadConfigPatch = Partial<ProviderThreadConfig>;\n\nconst nonBlankString = (value: unknown): string | null =>\n  typeof value === 'string' && value.trim() !== '' ? value : null;\n\nconst stringItems = (value: readonly unknown[]): string[] =>\n  value.filter((item): item is string => typeof item === 'string');\n\n/** A list prop as the send carries it: omitted (`null`) when empty, as `buildStatewireRunConfig` does. */\nconst propList = (value: readonly string[] | undefined): readonly string[] | null =>\n  value !== undefined && value.length > 0 ? value : null;\n\n/**\n * An `extraRunConfig` list as the send carries it: `buildStatewireRunConfig`\n * merges `extraRunConfig` last and verbatim, so an explicit list (an empty one\n * included) is what the send holds.\n */\nconst extraList = (value: unknown): readonly string[] | null =>\n  Array.isArray(value) ? stringItems(value) : null;\n\n/**\n * The provider-owned thread-config values a send built from these props\n * carries, with `buildStatewireRunConfig`'s precedence: `extraRunConfig` is\n * merged last, so a key it holds wins over the prop that feeds it.\n *\n * - `model`: the explicit model only (`effectiveStatewireModel`); the SDK's\n *   own default is never a choice to write.\n * - `system_prompt`: the trimmed prompt, `null` when blank.\n * - `enabled_tools`: `tools` ∪ `frontendToolIds`; `null` when empty, since the\n *   send omits an empty list (it would erase a collab agent's own tools).\n * - `workbench`, `knowledge_base`: the list, `null` when empty.\n *\n * Pure.\n */\nexport function providerThreadConfig({\n  model,\n  systemPrompt,\n  tools,\n  frontendToolIds,\n  workbench,\n  knowledgeBase,\n  extraRunConfig,\n}: {\n  model: string | undefined;\n  systemPrompt: string | undefined;\n  tools: readonly string[] | undefined;\n  frontendToolIds: readonly string[] | undefined;\n  workbench: readonly string[] | undefined;\n  knowledgeBase: readonly string[] | undefined;\n  extraRunConfig: Record<string, unknown> | undefined;\n}): ProviderThreadConfig {\n  const extra = extraRunConfig ?? {};\n  const overrides = (key: ProviderThreadConfigKey) => Object.hasOwn(extra, key);\n  const enabledTools = Array.from(new Set([...(tools ?? []), ...(frontendToolIds ?? [])]));\n  const trimmedPrompt = systemPrompt?.trim() ?? '';\n  return {\n    model: effectiveStatewireModel({ model, extraRunConfig }) ?? null,\n    system_prompt: overrides('system_prompt')\n      ? nonBlankString(extra.system_prompt)\n      : trimmedPrompt === ''\n        ? null\n        : trimmedPrompt,\n    enabled_tools: overrides('enabled_tools')\n      ? extraList(extra.enabled_tools)\n      : propList(enabledTools),\n    workbench: overrides('workbench') ? extraList(extra.workbench) : propList(workbench),\n    knowledge_base: overrides('knowledge_base')\n      ? extraList(extra.knowledge_base)\n      : propList(knowledgeBase),\n  };\n}\n\n/**\n * A key of the lane (`state.config.custom`) read as a provider-owned value:\n * a text key is its non-blank string, a list key its string items (an\n * explicit empty list included), anything else `null` (unset).\n */\nexport function readLaneThreadConfigValue({\n  custom,\n  key,\n}: {\n  custom: ThreadConfigCustom;\n  key: ProviderThreadConfigKey;\n}): string | readonly string[] | null {\n  const value = custom[key];\n  // `model` keeps `readLaneModel`'s reading: any non-empty string.\n  if (key === 'model') return typeof value === 'string' && value !== '' ? value : null;\n  if (key === 'system_prompt') return nonBlankString(value);\n  return Array.isArray(value) ? stringItems(value) : null;\n}\n\n/** Whether two provider-owned values are the same (lists compared item by item, in order). */\nexport function sameThreadConfigValue(\n  left: string | readonly string[] | null,\n  right: string | readonly string[] | null,\n): boolean {\n  if (left === right) return true;\n  if (!Array.isArray(left) || !Array.isArray(right)) return false;\n  return left.length === right.length && left.every((item, index) => item === right[index]);\n}\n\n/**\n * What to do with the pending changes of provider-owned keys:\n *\n * - `wait`: keep them pending. The thread's snapshot has not landed, or the\n *   thread has no lane yet (version 0): the next send carries the values and\n *   agora's deferral seed persists the ones it keeps. They stay pending so that\n *   a lane an EARLIER send seeds (with the previous values) is corrected once\n *   it lands.\n * - `done`: the lane already holds every one of them (this client's own\n *   unacknowledged writes folded over); nothing to write.\n * - `patch`: issue one `config/patch` carrying exactly the keys whose lane\n *   value differs; `null` unsets a key so the agent's own value (or the\n *   default) applies.\n */\nexport type ThreadConfigLaneDecision =\n  | { kind: 'wait' }\n  | { kind: 'done' }\n  | { kind: 'patch'; patch: ProviderThreadConfigPatch };\n\nexport function decideThreadConfigLanePatch({\n  desired,\n  keys,\n  landed,\n  configVersion,\n  custom,\n}: {\n  /** The provider's values after the changes. */\n  desired: ProviderThreadConfig;\n  /** The keys whose prop changed during this attach and is not yet written. */\n  keys: Iterable<ProviderThreadConfigKey>;\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}): ThreadConfigLaneDecision {\n  if (!landed || configVersion <= 0) return { kind: 'wait' };\n  const pending = new Set(keys);\n  const patch: ProviderThreadConfigPatch = {};\n  for (const key of PROVIDER_THREAD_CONFIG_KEYS) {\n    if (!pending.has(key)) continue;\n    if (!sameThreadConfigValue(readLaneThreadConfigValue({ custom, key }), desired[key])) {\n      copyThreadConfigKey({ target: patch, source: desired, key });\n    }\n  }\n  return patchedThreadConfigKeys(patch).length === 0 ? { kind: 'done' } : { kind: 'patch', patch };\n}\n\nfunction copyThreadConfigKey<K extends ProviderThreadConfigKey>({\n  target,\n  source,\n  key,\n}: {\n  target: ProviderThreadConfigPatch;\n  source: ProviderThreadConfig;\n  key: K;\n}): void {\n  target[key] = source[key];\n}\n\n/** The keys a patch carries, in {@link PROVIDER_THREAD_CONFIG_KEYS} order. */\nexport function patchedThreadConfigKeys(patch: ProviderThreadConfigPatch): ProviderThreadConfigKey[] {\n  return PROVIDER_THREAD_CONFIG_KEYS.filter((key) => Object.hasOwn(patch, key));\n}\n"],"names":["effectiveStatewireModel"],"mappings":";;;AAYO,MAAM,8BAA8B;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAoBA,MAAM,iBAAiB,CAAC,UACtB,OAAO,UAAU,YAAY,MAAM,KAAA,MAAW,KAAK,QAAQ;AAE7D,MAAM,cAAc,CAAC,UACnB,MAAM,OAAO,CAAC,SAAyB,OAAO,SAAS,QAAQ;AAGjE,MAAM,WAAW,CAAC,UAChB,UAAU,UAAa,MAAM,SAAS,IAAI,QAAQ;AAOpD,MAAM,YAAY,CAAC,UACjB,MAAM,QAAQ,KAAK,IAAI,YAAY,KAAK,IAAI;AAgBvC,SAAS,qBAAqB;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAQyB;AACvB,QAAM,QAAQ,kBAAkB,CAAA;AAChC,QAAM,YAAY,CAAC,QAAiC,OAAO,OAAO,OAAO,GAAG;AAC5E,QAAM,eAAe,MAAM,KAAK,oBAAI,IAAI,CAAC,GAAI,SAAS,IAAK,GAAI,mBAAmB,CAAA,CAAG,CAAC,CAAC;AACvF,QAAM,iBAAgB,6CAAc,WAAU;AAC9C,SAAO;AAAA,IACL,OAAOA,mBAAAA,wBAAwB,EAAE,OAAO,eAAA,CAAgB,KAAK;AAAA,IAC7D,eAAe,UAAU,eAAe,IACpC,eAAe,MAAM,aAAa,IAClC,kBAAkB,KAChB,OACA;AAAA,IACN,eAAe,UAAU,eAAe,IACpC,UAAU,MAAM,aAAa,IAC7B,SAAS,YAAY;AAAA,IACzB,WAAW,UAAU,WAAW,IAAI,UAAU,MAAM,SAAS,IAAI,SAAS,SAAS;AAAA,IACnF,gBAAgB,UAAU,gBAAgB,IACtC,UAAU,MAAM,cAAc,IAC9B,SAAS,aAAa;AAAA,EAAA;AAE9B;AAOO,SAAS,0BAA0B;AAAA,EACxC;AAAA,EACA;AACF,GAGsC;AACpC,QAAM,QAAQ,OAAO,GAAG;AAExB,MAAI,QAAQ,QAAS,QAAO,OAAO,UAAU,YAAY,UAAU,KAAK,QAAQ;AAChF,MAAI,QAAQ,gBAAiB,QAAO,eAAe,KAAK;AACxD,SAAO,MAAM,QAAQ,KAAK,IAAI,YAAY,KAAK,IAAI;AACrD;AAGO,SAAS,sBACd,MACA,OACS;AACT,MAAI,SAAS,MAAO,QAAO;AAC3B,MAAI,CAAC,MAAM,QAAQ,IAAI,KAAK,CAAC,MAAM,QAAQ,KAAK,EAAG,QAAO;AAC1D,SAAO,KAAK,WAAW,MAAM,UAAU,KAAK,MAAM,CAAC,MAAM,UAAU,SAAS,MAAM,KAAK,CAAC;AAC1F;AAqBO,SAAS,4BAA4B;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAS6B;AAC3B,MAAI,CAAC,UAAU,iBAAiB,EAAG,QAAO,EAAE,MAAM,OAAA;AAClD,QAAM,UAAU,IAAI,IAAI,IAAI;AAC5B,QAAM,QAAmC,CAAA;AACzC,aAAW,OAAO,6BAA6B;AAC7C,QAAI,CAAC,QAAQ,IAAI,GAAG,EAAG;AACvB,QAAI,CAAC,sBAAsB,0BAA0B,EAAE,QAAQ,IAAA,CAAK,GAAG,QAAQ,GAAG,CAAC,GAAG;AACpF,0BAAoB,EAAE,QAAQ,OAAO,QAAQ,SAAS,KAAK;AAAA,IAC7D;AAAA,EACF;AACA,SAAO,wBAAwB,KAAK,EAAE,WAAW,IAAI,EAAE,MAAM,WAAW,EAAE,MAAM,SAAS,MAAA;AAC3F;AAEA,SAAS,oBAAuD;AAAA,EAC9D;AAAA,EACA;AAAA,EACA;AACF,GAIS;AACP,SAAO,GAAG,IAAI,OAAO,GAAG;AAC1B;AAGO,SAAS,wBAAwB,OAA6D;AACnG,SAAO,4BAA4B,OAAO,CAAC,QAAQ,OAAO,OAAO,OAAO,GAAG,CAAC;AAC9E;;;;;;;"}

package/dist/runtime/statewire-thread-config-lane.d.ts

@@ -0,0 +1,94 @@
+import type { ThreadConfigCustom } from '@athenaintel/agent-runtime';
+/**
+ * The thread-config keys the provider's props own, in the order a
+ * `config/patch` lists them.
+ *
+ * Once a thread has a server config lane (version > 0), agora composes every
+ * run from the lane and drops these keys from a send
+ * (`merge_custom_over_server_config`), so a change of the prop that feeds one
+ * is written to the lane instead (see `StatewireThreadConfigLaneSync`).
+ */
+export declare const PROVIDER_THREAD_CONFIG_KEYS: readonly ['model', 'system_prompt', 'enabled_tools', 'workbench', 'knowledge_base'];
+export type ProviderThreadConfigKey = (typeof PROVIDER_THREAD_CONFIG_KEYS)[number];
+/**
+ * The provider-owned thread-config values as a send carries them and as the
+ * lane stores them; `null` is "the send carries none": written to the lane it
+ * unsets the key, so the collab agent's own value (or the default) applies.
+ */
+export interface ProviderThreadConfig {
+    model: string | null;
+    system_prompt: string | null;
+    enabled_tools: readonly string[] | null;
+    workbench: readonly string[] | null;
+    knowledge_base: readonly string[] | null;
+}
+/** A `config/patch` payload over provider-owned keys: exactly the keys to change. */
+export type ProviderThreadConfigPatch = Partial<ProviderThreadConfig>;
+/**
+ * The provider-owned thread-config values a send built from these props
+ * carries, with `buildStatewireRunConfig`'s precedence: `extraRunConfig` is
+ * merged last, so a key it holds wins over the prop that feeds it.
+ *
+ * - `model`: the explicit model only (`effectiveStatewireModel`); the SDK's
+ *   own default is never a choice to write.
+ * - `system_prompt`: the trimmed prompt, `null` when blank.
+ * - `enabled_tools`: `tools` ∪ `frontendToolIds`; `null` when empty, since the
+ *   send omits an empty list (it would erase a collab agent's own tools).
+ * - `workbench`, `knowledge_base`: the list, `null` when empty.
+ *
+ * Pure.
+ */
+export declare function providerThreadConfig({ model, systemPrompt, tools, frontendToolIds, workbench, knowledgeBase, extraRunConfig, }: {
+    model: string | undefined;
+    systemPrompt: string | undefined;
+    tools: readonly string[] | undefined;
+    frontendToolIds: readonly string[] | undefined;
+    workbench: readonly string[] | undefined;
+    knowledgeBase: readonly string[] | undefined;
+    extraRunConfig: Record<string, unknown> | undefined;
+}): ProviderThreadConfig;
+/**
+ * A key of the lane (`state.config.custom`) read as a provider-owned value:
+ * a text key is its non-blank string, a list key its string items (an
+ * explicit empty list included), anything else `null` (unset).
+ */
+export declare function readLaneThreadConfigValue({ custom, key, }: {
+    custom: ThreadConfigCustom;
+    key: ProviderThreadConfigKey;
+}): string | readonly string[] | null;
+/** Whether two provider-owned values are the same (lists compared item by item, in order). */
+export declare function sameThreadConfigValue(left: string | readonly string[] | null, right: string | readonly string[] | null): boolean;
+/**
+ * What to do with the pending changes of provider-owned keys:
+ *
+ * - `wait`: keep them pending. The thread's snapshot has not landed, or the
+ *   thread has no lane yet (version 0): the next send carries the values and
+ *   agora's deferral seed persists the ones it keeps. They stay pending so that
+ *   a lane an EARLIER send seeds (with the previous values) is corrected once
+ *   it lands.
+ * - `done`: the lane already holds every one of them (this client's own
+ *   unacknowledged writes folded over); nothing to write.
+ * - `patch`: issue one `config/patch` carrying exactly the keys whose lane
+ *   value differs; `null` unsets a key so the agent's own value (or the
+ *   default) applies.
+ */
+export type ThreadConfigLaneDecision = {
+    kind: 'wait';
+} | {
+    kind: 'done';
+} | {
+    kind: 'patch';
+    patch: ProviderThreadConfigPatch;
+};
+export declare function decideThreadConfigLanePatch({ desired, keys, landed, configVersion, custom, }: {
+    /** The provider's values after the changes. */
+    desired: ProviderThreadConfig;
+    /** The keys whose prop changed during this attach and is not yet written. */
+    keys: Iterable<ProviderThreadConfigKey>;
+    landed: boolean;
+    configVersion: number;
+    /** The effective lane: the server config with this client's pending writes folded over. */
+    custom: ThreadConfigCustom;
+}): ThreadConfigLaneDecision;
+/** The keys a patch carries, in {@link PROVIDER_THREAD_CONFIG_KEYS} order. */
+export declare function patchedThreadConfigKeys(patch: ProviderThreadConfigPatch): ProviderThreadConfigKey[];

package/dist/runtime/statewire-thread-config-lane.js

@@ -0,0 +1,84 @@
+import { effectiveStatewireModel } from "./statewire-run-config.js";
+const PROVIDER_THREAD_CONFIG_KEYS = [
+  "model",
+  "system_prompt",
+  "enabled_tools",
+  "workbench",
+  "knowledge_base"
+];
+const nonBlankString = (value) => typeof value === "string" && value.trim() !== "" ? value : null;
+const stringItems = (value) => value.filter((item) => typeof item === "string");
+const propList = (value) => value !== void 0 && value.length > 0 ? value : null;
+const extraList = (value) => Array.isArray(value) ? stringItems(value) : null;
+function providerThreadConfig({
+  model,
+  systemPrompt,
+  tools,
+  frontendToolIds,
+  workbench,
+  knowledgeBase,
+  extraRunConfig
+}) {
+  const extra = extraRunConfig ?? {};
+  const overrides = (key) => Object.hasOwn(extra, key);
+  const enabledTools = Array.from(/* @__PURE__ */ new Set([...tools ?? [], ...frontendToolIds ?? []]));
+  const trimmedPrompt = (systemPrompt == null ? void 0 : systemPrompt.trim()) ?? "";
+  return {
+    model: effectiveStatewireModel({ model, extraRunConfig }) ?? null,
+    system_prompt: overrides("system_prompt") ? nonBlankString(extra.system_prompt) : trimmedPrompt === "" ? null : trimmedPrompt,
+    enabled_tools: overrides("enabled_tools") ? extraList(extra.enabled_tools) : propList(enabledTools),
+    workbench: overrides("workbench") ? extraList(extra.workbench) : propList(workbench),
+    knowledge_base: overrides("knowledge_base") ? extraList(extra.knowledge_base) : propList(knowledgeBase)
+  };
+}
+function readLaneThreadConfigValue({
+  custom,
+  key
+}) {
+  const value = custom[key];
+  if (key === "model") return typeof value === "string" && value !== "" ? value : null;
+  if (key === "system_prompt") return nonBlankString(value);
+  return Array.isArray(value) ? stringItems(value) : null;
+}
+function sameThreadConfigValue(left, right) {
+  if (left === right) return true;
+  if (!Array.isArray(left) || !Array.isArray(right)) return false;
+  return left.length === right.length && left.every((item, index) => item === right[index]);
+}
+function decideThreadConfigLanePatch({
+  desired,
+  keys,
+  landed,
+  configVersion,
+  custom
+}) {
+  if (!landed || configVersion <= 0) return { kind: "wait" };
+  const pending = new Set(keys);
+  const patch = {};
+  for (const key of PROVIDER_THREAD_CONFIG_KEYS) {
+    if (!pending.has(key)) continue;
+    if (!sameThreadConfigValue(readLaneThreadConfigValue({ custom, key }), desired[key])) {
+      copyThreadConfigKey({ target: patch, source: desired, key });
+    }
+  }
+  return patchedThreadConfigKeys(patch).length === 0 ? { kind: "done" } : { kind: "patch", patch };
+}
+function copyThreadConfigKey({
+  target,
+  source,
+  key
+}) {
+  target[key] = source[key];
+}
+function patchedThreadConfigKeys(patch) {
+  return PROVIDER_THREAD_CONFIG_KEYS.filter((key) => Object.hasOwn(patch, key));
+}
+export {
+  PROVIDER_THREAD_CONFIG_KEYS,
+  decideThreadConfigLanePatch,
+  patchedThreadConfigKeys,
+  providerThreadConfig,
+  readLaneThreadConfigValue,
+  sameThreadConfigValue
+};
+//# sourceMappingURL=statewire-thread-config-lane.js.map

package/dist/runtime/statewire-thread-config-lane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statewire-thread-config-lane.js","sources":["../../src/runtime/statewire-thread-config-lane.ts"],"sourcesContent":["import type { ThreadConfigCustom } from '@athenaintel/agent-runtime';\nimport { effectiveStatewireModel } from './statewire-run-config';\n\n/**\n * The thread-config keys the provider's props own, in the order a\n * `config/patch` lists them.\n *\n * Once a thread has a server config lane (version > 0), agora composes every\n * run from the lane and drops these keys from a send\n * (`merge_custom_over_server_config`), so a change of the prop that feeds one\n * is written to the lane instead (see `StatewireThreadConfigLaneSync`).\n */\nexport const PROVIDER_THREAD_CONFIG_KEYS = [\n  'model',\n  'system_prompt',\n  'enabled_tools',\n  'workbench',\n  'knowledge_base',\n] as const;\n\nexport type ProviderThreadConfigKey = (typeof PROVIDER_THREAD_CONFIG_KEYS)[number];\n\n/**\n * The provider-owned thread-config values as a send carries them and as the\n * lane stores them; `null` is \"the send carries none\": written to the lane it\n * unsets the key, so the collab agent's own value (or the default) applies.\n */\nexport interface ProviderThreadConfig {\n  model: string | null;\n  system_prompt: string | null;\n  enabled_tools: readonly string[] | null;\n  workbench: readonly string[] | null;\n  knowledge_base: readonly string[] | null;\n}\n\n/** A `config/patch` payload over provider-owned keys: exactly the keys to change. */\nexport type ProviderThreadConfigPatch = Partial<ProviderThreadConfig>;\n\nconst nonBlankString = (value: unknown): string | null =>\n  typeof value === 'string' && value.trim() !== '' ? value : null;\n\nconst stringItems = (value: readonly unknown[]): string[] =>\n  value.filter((item): item is string => typeof item === 'string');\n\n/** A list prop as the send carries it: omitted (`null`) when empty, as `buildStatewireRunConfig` does. */\nconst propList = (value: readonly string[] | undefined): readonly string[] | null =>\n  value !== undefined && value.length > 0 ? value : null;\n\n/**\n * An `extraRunConfig` list as the send carries it: `buildStatewireRunConfig`\n * merges `extraRunConfig` last and verbatim, so an explicit list (an empty one\n * included) is what the send holds.\n */\nconst extraList = (value: unknown): readonly string[] | null =>\n  Array.isArray(value) ? stringItems(value) : null;\n\n/**\n * The provider-owned thread-config values a send built from these props\n * carries, with `buildStatewireRunConfig`'s precedence: `extraRunConfig` is\n * merged last, so a key it holds wins over the prop that feeds it.\n *\n * - `model`: the explicit model only (`effectiveStatewireModel`); the SDK's\n *   own default is never a choice to write.\n * - `system_prompt`: the trimmed prompt, `null` when blank.\n * - `enabled_tools`: `tools` ∪ `frontendToolIds`; `null` when empty, since the\n *   send omits an empty list (it would erase a collab agent's own tools).\n * - `workbench`, `knowledge_base`: the list, `null` when empty.\n *\n * Pure.\n */\nexport function providerThreadConfig({\n  model,\n  systemPrompt,\n  tools,\n  frontendToolIds,\n  workbench,\n  knowledgeBase,\n  extraRunConfig,\n}: {\n  model: string | undefined;\n  systemPrompt: string | undefined;\n  tools: readonly string[] | undefined;\n  frontendToolIds: readonly string[] | undefined;\n  workbench: readonly string[] | undefined;\n  knowledgeBase: readonly string[] | undefined;\n  extraRunConfig: Record<string, unknown> | undefined;\n}): ProviderThreadConfig {\n  const extra = extraRunConfig ?? {};\n  const overrides = (key: ProviderThreadConfigKey) => Object.hasOwn(extra, key);\n  const enabledTools = Array.from(new Set([...(tools ?? []), ...(frontendToolIds ?? [])]));\n  const trimmedPrompt = systemPrompt?.trim() ?? '';\n  return {\n    model: effectiveStatewireModel({ model, extraRunConfig }) ?? null,\n    system_prompt: overrides('system_prompt')\n      ? nonBlankString(extra.system_prompt)\n      : trimmedPrompt === ''\n        ? null\n        : trimmedPrompt,\n    enabled_tools: overrides('enabled_tools')\n      ? extraList(extra.enabled_tools)\n      : propList(enabledTools),\n    workbench: overrides('workbench') ? extraList(extra.workbench) : propList(workbench),\n    knowledge_base: overrides('knowledge_base')\n      ? extraList(extra.knowledge_base)\n      : propList(knowledgeBase),\n  };\n}\n\n/**\n * A key of the lane (`state.config.custom`) read as a provider-owned value:\n * a text key is its non-blank string, a list key its string items (an\n * explicit empty list included), anything else `null` (unset).\n */\nexport function readLaneThreadConfigValue({\n  custom,\n  key,\n}: {\n  custom: ThreadConfigCustom;\n  key: ProviderThreadConfigKey;\n}): string | readonly string[] | null {\n  const value = custom[key];\n  // `model` keeps `readLaneModel`'s reading: any non-empty string.\n  if (key === 'model') return typeof value === 'string' && value !== '' ? value : null;\n  if (key === 'system_prompt') return nonBlankString(value);\n  return Array.isArray(value) ? stringItems(value) : null;\n}\n\n/** Whether two provider-owned values are the same (lists compared item by item, in order). */\nexport function sameThreadConfigValue(\n  left: string | readonly string[] | null,\n  right: string | readonly string[] | null,\n): boolean {\n  if (left === right) return true;\n  if (!Array.isArray(left) || !Array.isArray(right)) return false;\n  return left.length === right.length && left.every((item, index) => item === right[index]);\n}\n\n/**\n * What to do with the pending changes of provider-owned keys:\n *\n * - `wait`: keep them pending. The thread's snapshot has not landed, or the\n *   thread has no lane yet (version 0): the next send carries the values and\n *   agora's deferral seed persists the ones it keeps. They stay pending so that\n *   a lane an EARLIER send seeds (with the previous values) is corrected once\n *   it lands.\n * - `done`: the lane already holds every one of them (this client's own\n *   unacknowledged writes folded over); nothing to write.\n * - `patch`: issue one `config/patch` carrying exactly the keys whose lane\n *   value differs; `null` unsets a key so the agent's own value (or the\n *   default) applies.\n */\nexport type ThreadConfigLaneDecision =\n  | { kind: 'wait' }\n  | { kind: 'done' }\n  | { kind: 'patch'; patch: ProviderThreadConfigPatch };\n\nexport function decideThreadConfigLanePatch({\n  desired,\n  keys,\n  landed,\n  configVersion,\n  custom,\n}: {\n  /** The provider's values after the changes. */\n  desired: ProviderThreadConfig;\n  /** The keys whose prop changed during this attach and is not yet written. */\n  keys: Iterable<ProviderThreadConfigKey>;\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}): ThreadConfigLaneDecision {\n  if (!landed || configVersion <= 0) return { kind: 'wait' };\n  const pending = new Set(keys);\n  const patch: ProviderThreadConfigPatch = {};\n  for (const key of PROVIDER_THREAD_CONFIG_KEYS) {\n    if (!pending.has(key)) continue;\n    if (!sameThreadConfigValue(readLaneThreadConfigValue({ custom, key }), desired[key])) {\n      copyThreadConfigKey({ target: patch, source: desired, key });\n    }\n  }\n  return patchedThreadConfigKeys(patch).length === 0 ? { kind: 'done' } : { kind: 'patch', patch };\n}\n\nfunction copyThreadConfigKey<K extends ProviderThreadConfigKey>({\n  target,\n  source,\n  key,\n}: {\n  target: ProviderThreadConfigPatch;\n  source: ProviderThreadConfig;\n  key: K;\n}): void {\n  target[key] = source[key];\n}\n\n/** The keys a patch carries, in {@link PROVIDER_THREAD_CONFIG_KEYS} order. */\nexport function patchedThreadConfigKeys(patch: ProviderThreadConfigPatch): ProviderThreadConfigKey[] {\n  return PROVIDER_THREAD_CONFIG_KEYS.filter((key) => Object.hasOwn(patch, key));\n}\n"],"names":[],"mappings":"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"}

package/dist/runtime/useAthenaStatewireRuntime.cjs

@@ -157,8 +157,8 @@ function useAthenaStatewireRuntime(config) {
     // core's per-render ref; the value-stable key re-registers (and so
     // notifies) only when the built runConfig actually changed. On a thread
     // with a server config lane, agora keeps only the per-send keys of what
-    // this carries; `StatewireModelLaneSync` writes a changed `model` to the
-    // lane itself.
+    // this carries; `StatewireThreadConfigLaneSync` writes a changed model,
+    // system prompt, tool list, workbench or knowledge base to the lane itself.
     runConfig: {
       get: () => runConfigValue,
       key: runConfigKey