@athenaintel/react 0.57.1 → 0.59.0

package/dist/runtime/StatewirePlanModeLaneSync.cjs

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const reactStatewire = require("@assistant-ui/react-statewire");
+const require$$0 = require("react");
+const athenaDiagnostics = require("../diagnostics/athena-diagnostics.cjs");
+const statewirePlanMode = require("./statewire-plan-mode.cjs");
+const StatewireThreadConfigLaneSync = require("./StatewireThreadConfigLaneSync.cjs");
+const useDeepAgentConfig = require("../agent-runtime/src/use-deep-agent-config.cjs");
+const errors = require("../agent-runtime/src/errors.cjs");
+function StatewirePlanModeLaneSync({
+  threadId,
+  planMode,
+  lane,
+  channelLive
+}) {
+  const send = reactStatewire.useStatewireSendCommand();
+  const sendCommand = (command) => Promise.resolve(send(command));
+  const { configVersion, custom, patchConfig } = useDeepAgentConfig.useDeepAgentConfigController({
+    serverConfig: lane.config,
+    sendCommand
+  });
+  const seenRef = require$$0.useRef(planMode);
+  const pendingRef = require$$0.useRef(false);
+  const attemptsRef = require$$0.useRef(0);
+  const closedRef = require$$0.useRef(false);
+  const patchConfigRef = require$$0.useRef(patchConfig);
+  patchConfigRef.current = patchConfig;
+  const [retryTick, setRetryTick] = require$$0.useState(0);
+  const retryTimerRef = require$$0.useRef(null);
+  require$$0.useEffect(
+    () => () => {
+      if (retryTimerRef.current !== null) clearTimeout(retryTimerRef.current);
+    },
+    []
+  );
+  const landed = lane.landed;
+  require$$0.useEffect(() => {
+    if (planMode !== seenRef.current) {
+      seenRef.current = planMode;
+      pendingRef.current = planMode !== null;
+      attemptsRef.current = 0;
+    }
+    if (!pendingRef.current || planMode === null || closedRef.current || !channelLive) return;
+    const decision = statewirePlanMode.decidePlanModeLanePatch({ planMode, landed, configVersion, custom });
+    if (decision.kind === "wait") return;
+    pendingRef.current = false;
+    if (decision.kind === "done") return;
+    const { patch } = decision;
+    attemptsRef.current += 1;
+    const data = { thread_id: threadId, plan_mode: planMode, config_keys: Object.keys(patch) };
+    patchConfigRef.current(patch).catch((error) => {
+      if (useDeepAgentConfig.isConfigWriteForbiddenRejection(error) || useDeepAgentConfig.isConfigSyncUnavailableRejection(error)) {
+        closedRef.current = true;
+        athenaDiagnostics.athenaDiagnostics.emit("statewire.config", {
+          level: "warn",
+          data: {
+            ...data,
+            reason: useDeepAgentConfig.isConfigWriteForbiddenRejection(error) ? "config_write_forbidden" : "config_sync_unavailable"
+          }
+        });
+        return;
+      }
+      const outcome = errors.statewireTransportOutcome(error);
+      if (outcome !== null) {
+        athenaDiagnostics.athenaDiagnostics.emit("statewire.config", { level: "debug", data: { ...data, outcome } });
+        if (outcome === "unmount") return;
+        if (seenRef.current !== planMode) return;
+        const written = attemptsRef.current;
+        if (written >= StatewireThreadConfigLaneSync.MAX_PATCH_ATTEMPTS_PER_CHANGE) return;
+        pendingRef.current = true;
+        const delay = StatewireThreadConfigLaneSync.RETRY_BACKOFF_MS[Math.min(written - 1, StatewireThreadConfigLaneSync.RETRY_BACKOFF_MS.length - 1)];
+        retryTimerRef.current = setTimeout(() => {
+          retryTimerRef.current = null;
+          setRetryTick((tick) => tick + 1);
+        }, delay);
+        return;
+      }
+      athenaDiagnostics.athenaDiagnostics.error(
+        "statewire.config",
+        error,
+        {
+          code: "statewire_rejected",
+          message: "The statewire host refused the plan mode change",
+          hint: "Inspect error.detail: agora rejections carry a structured {code, message}. The thread keeps running with the plan mode its server config holds."
+        },
+        data
+      );
+    });
+  }, [planMode, landed, configVersion, custom, channelLive, retryTick, threadId]);
+  return null;
+}
+exports.StatewirePlanModeLaneSync = StatewirePlanModeLaneSync;
+//# sourceMappingURL=StatewirePlanModeLaneSync.cjs.map

package/dist/runtime/StatewirePlanModeLaneSync.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatewirePlanModeLaneSync.cjs","sources":["../../src/runtime/StatewirePlanModeLaneSync.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 { decidePlanModeLanePatch } from './statewire-plan-mode';\nimport type { AthenaStatewireServerLane } from './statewire-server-lane-context';\nimport { MAX_PATCH_ATTEMPTS_PER_CHANGE, RETRY_BACKOFF_MS } from './StatewireThreadConfigLaneSync';\n\n/**\n * Writes the provider's `planMode` to the thread's server config lane when the\n * host changes it during an attach, under the contract\n * `StatewireThreadConfigLaneSync` keeps for `model` and the other\n * provider-owned keys:\n *\n * - Only a CHANGE is written. The value an attach starts with is never written:\n *   a thread opened elsewhere keeps the plan mode its own config holds.\n * - A change waits for the attach's snapshot and for the lane (version > 0). A\n *   thread without a lane needs no write (the next send carries plan mode); the\n *   change stays pending until a lane exists, so a lane an earlier send seeded\n *   is corrected once it lands.\n * - The write is one `config/patch` of the exclusion lists that change,\n *   computed from the lane's own lists (this client's pending writes folded\n *   over), so a tool or middleware another client excluded stays excluded.\n * - A refusal that can never succeed (a view-only collaborator, a workspace\n *   without server config) stops the writes for the attach and is reported on\n *   the diagnostics bus; a write the channel dropped is written again after a\n *   backoff, at most {@link MAX_PATCH_ATTEMPTS_PER_CHANGE} times per change.\n *\n * agora gates every `config/*` write on EDIT on the thread's session asset\n * (`_authorize_config_write`). Mounted beside `StatewireThreadConfigLaneSync`\n * under the runtime's `AuiProvider`, keyed by the thread, so each attach starts\n * with nothing pending.\n */\nexport function StatewirePlanModeLaneSync({\n  threadId,\n  planMode,\n  lane,\n  channelLive,\n}: {\n  threadId: string;\n  /** The provider's `planMode`, published with the thread it applies to; `null`: it sets none. */\n  planMode: boolean | null;\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(planMode);\n  const pendingRef = useRef(false);\n  const attemptsRef = useRef(0);\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    if (planMode !== seenRef.current) {\n      seenRef.current = planMode;\n      // A host that stops setting plan mode leaves the thread's own as it is.\n      pendingRef.current = planMode !== null;\n      attemptsRef.current = 0;\n    }\n    if (!pendingRef.current || planMode === null || closedRef.current || !channelLive) return;\n    const decision = decidePlanModeLanePatch({ planMode, landed, configVersion, custom });\n    if (decision.kind === 'wait') return;\n    pendingRef.current = false;\n    if (decision.kind === 'done') return;\n\n    const { patch } = decision;\n    attemptsRef.current += 1;\n    const data = { thread_id: threadId, plan_mode: planMode, config_keys: Object.keys(patch) };\n    patchConfigRef.current(patch).catch((error: unknown) => {\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): write\n        // the change again after a backoff, once the channel is live, unless the\n        // host has moved on, the attach is gone or it was written enough.\n        athenaDiagnostics.emit('statewire.config', { level: 'debug', data: { ...data, outcome } });\n        if (outcome === 'unmount') return;\n        if (seenRef.current !== planMode) return;\n        const written = attemptsRef.current;\n        if (written >= MAX_PATCH_ATTEMPTS_PER_CHANGE) return;\n        pendingRef.current = true;\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        {\n          code: 'statewire_rejected',\n          message: 'The statewire host refused the plan mode change',\n          hint: 'Inspect error.detail: agora rejections carry a structured {code, message}. The thread keeps running with the plan mode its server config holds.',\n        },\n        data,\n      );\n    });\n  }, [planMode, landed, configVersion, custom, channelLive, retryTick, threadId]);\n\n  return null;\n}\n"],"names":["useStatewireSendCommand","useDeepAgentConfigController","useRef","useState","useEffect","decidePlanModeLanePatch","isConfigWriteForbiddenRejection","isConfigSyncUnavailableRejection","athenaDiagnostics","statewireTransportOutcome","MAX_PATCH_ATTEMPTS_PER_CHANGE","RETRY_BACKOFF_MS"],"mappings":";;;;;;;;;AAuCO,SAAS,0BAA0B;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAOS;AACP,QAAM,OAAOA,eAAAA,wBAAA;AACb,QAAM,cAA8D,CAAC,YACnE,QAAQ,QAAQ,KAAK,OAAO,CAAC;AAC/B,QAAM,EAAE,eAAe,QAAQ,YAAA,IAAgBC,mBAAAA,6BAA6B;AAAA,IAC1E,cAAc,KAAK;AAAA,IACnB;AAAA,EAAA,CACD;AAED,QAAM,UAAUC,WAAAA,OAAO,QAAQ;AAC/B,QAAM,aAAaA,WAAAA,OAAO,KAAK;AAC/B,QAAM,cAAcA,WAAAA,OAAO,CAAC;AAC5B,QAAM,YAAYA,WAAAA,OAAO,KAAK;AAC9B,QAAM,iBAAiBA,WAAAA,OAAO,WAAW;AACzC,iBAAe,UAAU;AAEzB,QAAM,CAAC,WAAW,YAAY,IAAIC,WAAAA,SAAS,CAAC;AAC5C,QAAM,gBAAgBD,WAAAA,OAA6C,IAAI;AACvEE,aAAAA;AAAAA,IACE,MAAM,MAAM;AACV,UAAI,cAAc,YAAY,KAAM,cAAa,cAAc,OAAO;AAAA,IACxE;AAAA,IACA,CAAA;AAAA,EAAC;AAEH,QAAM,SAAS,KAAK;AAEpBA,aAAAA,UAAU,MAAM;AACd,QAAI,aAAa,QAAQ,SAAS;AAChC,cAAQ,UAAU;AAElB,iBAAW,UAAU,aAAa;AAClC,kBAAY,UAAU;AAAA,IACxB;AACA,QAAI,CAAC,WAAW,WAAW,aAAa,QAAQ,UAAU,WAAW,CAAC,YAAa;AACnF,UAAM,WAAWC,kBAAAA,wBAAwB,EAAE,UAAU,QAAQ,eAAe,QAAQ;AACpF,QAAI,SAAS,SAAS,OAAQ;AAC9B,eAAW,UAAU;AACrB,QAAI,SAAS,SAAS,OAAQ;AAE9B,UAAM,EAAE,UAAU;AAClB,gBAAY,WAAW;AACvB,UAAM,OAAO,EAAE,WAAW,UAAU,WAAW,UAAU,aAAa,OAAO,KAAK,KAAK,EAAA;AACvF,mBAAe,QAAQ,KAAK,EAAE,MAAM,CAAC,UAAmB;AACtD,UAAIC,mBAAAA,gCAAgC,KAAK,KAAKC,mBAAAA,iCAAiC,KAAK,GAAG;AACrF,kBAAU,UAAU;AACpBC,0BAAAA,kBAAkB,KAAK,oBAAoB;AAAA,UACzC,OAAO;AAAA,UACP,MAAM;AAAA,YACJ,GAAG;AAAA,YACH,QAAQF,mBAAAA,gCAAgC,KAAK,IACzC,2BACA;AAAA,UAAA;AAAA,QACN,CACD;AACD;AAAA,MACF;AACA,YAAM,UAAUG,OAAAA,0BAA0B,KAAK;AAC/C,UAAI,YAAY,MAAM;AAIpBD,0BAAAA,kBAAkB,KAAK,oBAAoB,EAAE,OAAO,SAAS,MAAM,EAAE,GAAG,MAAM,QAAA,GAAW;AACzF,YAAI,YAAY,UAAW;AAC3B,YAAI,QAAQ,YAAY,SAAU;AAClC,cAAM,UAAU,YAAY;AAC5B,YAAI,WAAWE,8BAAAA,8BAA+B;AAC9C,mBAAW,UAAU;AACrB,cAAM,QAAQC,+CAAiB,KAAK,IAAI,UAAU,GAAGA,8BAAAA,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;AACAH,wBAAAA,kBAAkB;AAAA,QAChB;AAAA,QACA;AAAA,QACA;AAAA,UACE,MAAM;AAAA,UACN,SAAS;AAAA,UACT,MAAM;AAAA,QAAA;AAAA,QAER;AAAA,MAAA;AAAA,IAEJ,CAAC;AAAA,EACH,GAAG,CAAC,UAAU,QAAQ,eAAe,QAAQ,aAAa,WAAW,QAAQ,CAAC;AAE9E,SAAO;AACT;;"}

package/dist/runtime/StatewirePlanModeLaneSync.d.ts

@@ -0,0 +1,34 @@
+import type { AthenaStatewireServerLane } from './statewire-server-lane-context';
+/**
+ * Writes the provider's `planMode` to the thread's server config lane when the
+ * host changes it during an attach, under the contract
+ * `StatewireThreadConfigLaneSync` keeps for `model` and the other
+ * provider-owned keys:
+ *
+ * - Only a CHANGE is written. The value an attach starts with is never written:
+ *   a thread opened elsewhere keeps the plan mode its own config holds.
+ * - A change waits for the attach's snapshot and for the lane (version > 0). A
+ *   thread without a lane needs no write (the next send carries plan mode); the
+ *   change stays pending until a lane exists, so a lane an earlier send seeded
+ *   is corrected once it lands.
+ * - The write is one `config/patch` of the exclusion lists that change,
+ *   computed from the lane's own lists (this client's pending writes folded
+ *   over), so a tool or middleware another client excluded stays excluded.
+ * - A refusal that can never succeed (a view-only collaborator, a workspace
+ *   without server config) stops the writes for the attach and is reported on
+ *   the diagnostics bus; a write the channel dropped is written again after a
+ *   backoff, at most {@link MAX_PATCH_ATTEMPTS_PER_CHANGE} times per change.
+ *
+ * agora gates every `config/*` write on EDIT on the thread's session asset
+ * (`_authorize_config_write`). Mounted beside `StatewireThreadConfigLaneSync`
+ * under the runtime's `AuiProvider`, keyed by the thread, so each attach starts
+ * with nothing pending.
+ */
+export declare function StatewirePlanModeLaneSync({ threadId, planMode, lane, channelLive, }: {
+    threadId: string;
+    /** The provider's `planMode`, published with the thread it applies to; `null`: it sets none. */
+    planMode: boolean | null;
+    lane: AthenaStatewireServerLane;
+    /** Whether the channel can take a command now; writes wait for it. */
+    channelLive: boolean;
+}): null;

package/dist/runtime/StatewirePlanModeLaneSync.js

@@ -0,0 +1,93 @@
+import { useStatewireSendCommand } from "@assistant-ui/react-statewire";
+import { useRef, useState, useEffect } from "react";
+import { athenaDiagnostics } from "../diagnostics/athena-diagnostics.js";
+import { decidePlanModeLanePatch } from "./statewire-plan-mode.js";
+import { MAX_PATCH_ATTEMPTS_PER_CHANGE, RETRY_BACKOFF_MS } from "./StatewireThreadConfigLaneSync.js";
+import { useDeepAgentConfigController, isConfigWriteForbiddenRejection, isConfigSyncUnavailableRejection } from "../agent-runtime/src/use-deep-agent-config.js";
+import { statewireTransportOutcome } from "../agent-runtime/src/errors.js";
+function StatewirePlanModeLaneSync({
+  threadId,
+  planMode,
+  lane,
+  channelLive
+}) {
+  const send = useStatewireSendCommand();
+  const sendCommand = (command) => Promise.resolve(send(command));
+  const { configVersion, custom, patchConfig } = useDeepAgentConfigController({
+    serverConfig: lane.config,
+    sendCommand
+  });
+  const seenRef = useRef(planMode);
+  const pendingRef = useRef(false);
+  const attemptsRef = useRef(0);
+  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(() => {
+    if (planMode !== seenRef.current) {
+      seenRef.current = planMode;
+      pendingRef.current = planMode !== null;
+      attemptsRef.current = 0;
+    }
+    if (!pendingRef.current || planMode === null || closedRef.current || !channelLive) return;
+    const decision = decidePlanModeLanePatch({ planMode, landed, configVersion, custom });
+    if (decision.kind === "wait") return;
+    pendingRef.current = false;
+    if (decision.kind === "done") return;
+    const { patch } = decision;
+    attemptsRef.current += 1;
+    const data = { thread_id: threadId, plan_mode: planMode, config_keys: Object.keys(patch) };
+    patchConfigRef.current(patch).catch((error) => {
+      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;
+        if (seenRef.current !== planMode) return;
+        const written = attemptsRef.current;
+        if (written >= MAX_PATCH_ATTEMPTS_PER_CHANGE) return;
+        pendingRef.current = true;
+        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,
+        {
+          code: "statewire_rejected",
+          message: "The statewire host refused the plan mode change",
+          hint: "Inspect error.detail: agora rejections carry a structured {code, message}. The thread keeps running with the plan mode its server config holds."
+        },
+        data
+      );
+    });
+  }, [planMode, landed, configVersion, custom, channelLive, retryTick, threadId]);
+  return null;
+}
+export {
+  StatewirePlanModeLaneSync
+};
+//# sourceMappingURL=StatewirePlanModeLaneSync.js.map

package/dist/runtime/StatewirePlanModeLaneSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatewirePlanModeLaneSync.js","sources":["../../src/runtime/StatewirePlanModeLaneSync.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 { decidePlanModeLanePatch } from './statewire-plan-mode';\nimport type { AthenaStatewireServerLane } from './statewire-server-lane-context';\nimport { MAX_PATCH_ATTEMPTS_PER_CHANGE, RETRY_BACKOFF_MS } from './StatewireThreadConfigLaneSync';\n\n/**\n * Writes the provider's `planMode` to the thread's server config lane when the\n * host changes it during an attach, under the contract\n * `StatewireThreadConfigLaneSync` keeps for `model` and the other\n * provider-owned keys:\n *\n * - Only a CHANGE is written. The value an attach starts with is never written:\n *   a thread opened elsewhere keeps the plan mode its own config holds.\n * - A change waits for the attach's snapshot and for the lane (version > 0). A\n *   thread without a lane needs no write (the next send carries plan mode); the\n *   change stays pending until a lane exists, so a lane an earlier send seeded\n *   is corrected once it lands.\n * - The write is one `config/patch` of the exclusion lists that change,\n *   computed from the lane's own lists (this client's pending writes folded\n *   over), so a tool or middleware another client excluded stays excluded.\n * - A refusal that can never succeed (a view-only collaborator, a workspace\n *   without server config) stops the writes for the attach and is reported on\n *   the diagnostics bus; a write the channel dropped is written again after a\n *   backoff, at most {@link MAX_PATCH_ATTEMPTS_PER_CHANGE} times per change.\n *\n * agora gates every `config/*` write on EDIT on the thread's session asset\n * (`_authorize_config_write`). Mounted beside `StatewireThreadConfigLaneSync`\n * under the runtime's `AuiProvider`, keyed by the thread, so each attach starts\n * with nothing pending.\n */\nexport function StatewirePlanModeLaneSync({\n  threadId,\n  planMode,\n  lane,\n  channelLive,\n}: {\n  threadId: string;\n  /** The provider's `planMode`, published with the thread it applies to; `null`: it sets none. */\n  planMode: boolean | null;\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(planMode);\n  const pendingRef = useRef(false);\n  const attemptsRef = useRef(0);\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    if (planMode !== seenRef.current) {\n      seenRef.current = planMode;\n      // A host that stops setting plan mode leaves the thread's own as it is.\n      pendingRef.current = planMode !== null;\n      attemptsRef.current = 0;\n    }\n    if (!pendingRef.current || planMode === null || closedRef.current || !channelLive) return;\n    const decision = decidePlanModeLanePatch({ planMode, landed, configVersion, custom });\n    if (decision.kind === 'wait') return;\n    pendingRef.current = false;\n    if (decision.kind === 'done') return;\n\n    const { patch } = decision;\n    attemptsRef.current += 1;\n    const data = { thread_id: threadId, plan_mode: planMode, config_keys: Object.keys(patch) };\n    patchConfigRef.current(patch).catch((error: unknown) => {\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): write\n        // the change again after a backoff, once the channel is live, unless the\n        // host has moved on, the attach is gone or it was written enough.\n        athenaDiagnostics.emit('statewire.config', { level: 'debug', data: { ...data, outcome } });\n        if (outcome === 'unmount') return;\n        if (seenRef.current !== planMode) return;\n        const written = attemptsRef.current;\n        if (written >= MAX_PATCH_ATTEMPTS_PER_CHANGE) return;\n        pendingRef.current = true;\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        {\n          code: 'statewire_rejected',\n          message: 'The statewire host refused the plan mode change',\n          hint: 'Inspect error.detail: agora rejections carry a structured {code, message}. The thread keeps running with the plan mode its server config holds.',\n        },\n        data,\n      );\n    });\n  }, [planMode, landed, configVersion, custom, channelLive, retryTick, threadId]);\n\n  return null;\n}\n"],"names":[],"mappings":";;;;;;;AAuCO,SAAS,0BAA0B;AAAA,EACxC;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,QAAQ;AAC/B,QAAM,aAAa,OAAO,KAAK;AAC/B,QAAM,cAAc,OAAO,CAAC;AAC5B,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,QAAI,aAAa,QAAQ,SAAS;AAChC,cAAQ,UAAU;AAElB,iBAAW,UAAU,aAAa;AAClC,kBAAY,UAAU;AAAA,IACxB;AACA,QAAI,CAAC,WAAW,WAAW,aAAa,QAAQ,UAAU,WAAW,CAAC,YAAa;AACnF,UAAM,WAAW,wBAAwB,EAAE,UAAU,QAAQ,eAAe,QAAQ;AACpF,QAAI,SAAS,SAAS,OAAQ;AAC9B,eAAW,UAAU;AACrB,QAAI,SAAS,SAAS,OAAQ;AAE9B,UAAM,EAAE,UAAU;AAClB,gBAAY,WAAW;AACvB,UAAM,OAAO,EAAE,WAAW,UAAU,WAAW,UAAU,aAAa,OAAO,KAAK,KAAK,EAAA;AACvF,mBAAe,QAAQ,KAAK,EAAE,MAAM,CAAC,UAAmB;AACtD,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,EAAE,OAAO,SAAS,MAAM,EAAE,GAAG,MAAM,QAAA,GAAW;AACzF,YAAI,YAAY,UAAW;AAC3B,YAAI,QAAQ,YAAY,SAAU;AAClC,cAAM,UAAU,YAAY;AAC5B,YAAI,WAAW,8BAA+B;AAC9C,mBAAW,UAAU;AACrB,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;AAAA,UACE,MAAM;AAAA,UACN,SAAS;AAAA,UACT,MAAM;AAAA,QAAA;AAAA,QAER;AAAA,MAAA;AAAA,IAEJ,CAAC;AAAA,EACH,GAAG,CAAC,UAAU,QAAQ,eAAe,QAAQ,aAAa,WAAW,QAAQ,CAAC;AAE9E,SAAO;AACT;"}

package/dist/runtime/StatewireThreadConfigLaneSync.cjs

@@ -121,5 +121,7 @@ function StatewireThreadConfigLaneSync({
   }, [config, landed, configVersion, custom, channelLive, retryTick, threadId]);
   return null;
 }
+exports.MAX_PATCH_ATTEMPTS_PER_CHANGE = MAX_PATCH_ATTEMPTS_PER_CHANGE;
+exports.RETRY_BACKOFF_MS = RETRY_BACKOFF_MS;
 exports.StatewireThreadConfigLaneSync = StatewireThreadConfigLaneSync;
 //# sourceMappingURL=StatewireThreadConfigLaneSync.cjs.map

package/dist/runtime/StatewireThreadConfigLaneSync.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"StatewireThreadConfigLaneSync.cjs","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":["patchedThreadConfigKeys","useStatewireSendCommand","useDeepAgentConfigController","useRef","useState","useEffect","PROVIDER_THREAD_CONFIG_KEYS","sameThreadConfigValue","decideThreadConfigLanePatch","isConfigWriteForbiddenRejection","isConfigSyncUnavailableRejection","athenaDiagnostics","statewireTransportOutcome"],"mappings":";;;;;;;;AAsBA,MAAM,gCAAgC;AAGtC,MAAM,mBAAmB,CAAC,KAAO,GAAK;AAOtC,SAAS,gBAAgB;AAAA,EACvB;AAAA,EACA;AACF,GAG4B;AAC1B,QAAM,YAAYA,0BAAAA,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,OAAOC,eAAAA,wBAAA;AACb,QAAM,cAA8D,CAAC,YACnE,QAAQ,QAAQ,KAAK,OAAO,CAAC;AAC/B,QAAM,EAAE,eAAe,QAAQ,YAAA,IAAgBC,mBAAAA,6BAA6B;AAAA,IAC1E,cAAc,KAAK;AAAA,IACnB;AAAA,EAAA,CACD;AAED,QAAM,UAAUC,WAAAA,OAAO,MAAM;AAC7B,QAAM,aAAaA,WAAAA,OAAO,oBAAI,KAA8B;AAC5D,QAAM,cAAcA,WAAAA,OAAO,oBAAI,KAAsC;AACrE,QAAM,YAAYA,WAAAA,OAAO,KAAK;AAC9B,QAAM,iBAAiBA,WAAAA,OAAO,WAAW;AACzC,iBAAe,UAAU;AAEzB,QAAM,CAAC,WAAW,YAAY,IAAIC,WAAAA,SAAS,CAAC;AAC5C,QAAM,gBAAgBD,WAAAA,OAA6C,IAAI;AACvEE,aAAAA;AAAAA,IACE,MAAM,MAAM;AACV,UAAI,cAAc,YAAY,KAAM,cAAa,cAAc,OAAO;AAAA,IACxE;AAAA,IACA,CAAA;AAAA,EAAC;AAEH,QAAM,SAAS,KAAK;AAEpBA,aAAAA,UAAU,MAAM;AACd,UAAM,UAAU,WAAW;AAC3B,UAAM,WAAW,YAAY;AAC7B,eAAW,OAAOC,uDAA6B;AAC7C,UAAIC,0BAAAA,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,WAAWC,0BAAAA,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,YAAYR,0BAAAA,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,UAAIS,mBAAAA,gCAAgC,KAAK,KAAKC,mBAAAA,iCAAiC,KAAK,GAAG;AACrF,kBAAU,UAAU;AACpBC,0BAAAA,kBAAkB,KAAK,oBAAoB;AAAA,UACzC,OAAO;AAAA,UACP,MAAM;AAAA,YACJ,GAAG;AAAA,YACH,QAAQF,mBAAAA,gCAAgC,KAAK,IACzC,2BACA;AAAA,UAAA;AAAA,QACN,CACD;AACD;AAAA,MACF;AACA,YAAM,UAAUG,OAAAA,0BAA0B,KAAK;AAC/C,UAAI,YAAY,MAAM;AAIpBD,0BAAAA,kBAAkB,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,QACCJ,0BAAAA,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;AACAI,wBAAAA,kBAAkB;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;;"}
+{"version":3,"file":"StatewireThreadConfigLaneSync.cjs","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. */\nexport const MAX_PATCH_ATTEMPTS_PER_CHANGE = 3;\n\n/** Wait before re-writing a change the channel dropped: 1 s, then 4 s. */\nexport const 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":["patchedThreadConfigKeys","useStatewireSendCommand","useDeepAgentConfigController","useRef","useState","useEffect","PROVIDER_THREAD_CONFIG_KEYS","sameThreadConfigValue","decideThreadConfigLanePatch","isConfigWriteForbiddenRejection","isConfigSyncUnavailableRejection","athenaDiagnostics","statewireTransportOutcome"],"mappings":"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"}

package/dist/runtime/StatewireThreadConfigLaneSync.d.ts

@@ -1,5 +1,9 @@
 import type { AthenaStatewireServerLane } from './statewire-server-lane-context';
 import { type ProviderThreadConfig } from './statewire-thread-config-lane';
+/** Writes of one change, the first included, before the sync gives up on it. */
+export declare const MAX_PATCH_ATTEMPTS_PER_CHANGE = 3;
+/** Wait before re-writing a change the channel dropped: 1 s, then 4 s. */
+export declare const RETRY_BACKOFF_MS: readonly [1000, 4000];
 /**
  * Writes the provider-owned thread-config keys to the thread's server config
  * lane when the host changes the props that feed them during an attach:

package/dist/runtime/StatewireThreadConfigLaneSync.js

@@ -120,6 +120,8 @@ function StatewireThreadConfigLaneSync({
   return null;
 }
 export {
+  MAX_PATCH_ATTEMPTS_PER_CHANGE,
+  RETRY_BACKOFF_MS,
   StatewireThreadConfigLaneSync
 };
 //# sourceMappingURL=StatewireThreadConfigLaneSync.js.map

package/dist/runtime/StatewireThreadConfigLaneSync.js.map

@@ -1 +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":"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"}
+{"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. */\nexport const MAX_PATCH_ATTEMPTS_PER_CHANGE = 3;\n\n/** Wait before re-writing a change the channel dropped: 1 s, then 4 s. */\nexport const 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":"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"}

package/dist/runtime/statewire-plan-mode.cjs

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const PLAN_MODE_TOOL = "write_todos";
+const PLAN_MODE_MIDDLEWARE = "TodoListMiddleware";
+const EXCLUDED_TOOLS = "excluded_tools";
+const EXCLUDED_MIDDLEWARE = "excluded_middleware";
+const PLAN_MODE_EXCLUSIONS = [
+  { key: EXCLUDED_TOOLS, name: PLAN_MODE_TOOL },
+  { key: EXCLUDED_MIDDLEWARE, name: PLAN_MODE_MIDDLEWARE }
+];
+const stringItems = (value) => Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+function planModeOf(custom) {
+  return PLAN_MODE_EXCLUSIONS.every(({ key, name }) => !stringItems(custom[key]).includes(name));
+}
+function planModeListEdits({
+  custom,
+  planMode
+}) {
+  const edits = {};
+  if (planModeOf(custom) === planMode) return edits;
+  for (const { key, name } of PLAN_MODE_EXCLUSIONS) {
+    const items = stringItems(custom[key]);
+    const excluded = items.includes(name);
+    if (planMode && excluded) {
+      const kept = items.filter((item) => item !== name);
+      edits[key] = kept.length > 0 ? kept : null;
+    } else if (!planMode && !excluded) {
+      edits[key] = [...items, name];
+    }
+  }
+  return edits;
+}
+function withPlanMode({
+  custom,
+  planMode
+}) {
+  if (planMode === void 0) return custom;
+  const edits = planModeListEdits({ custom, planMode });
+  if (Object.keys(edits).length === 0) return custom;
+  const next = { ...custom };
+  for (const [key, value] of Object.entries(edits)) {
+    if (value === null) delete next[key];
+    else next[key] = value;
+  }
+  return next;
+}
+function threadPlanModeFromLane({
+  lane,
+  ready
+}) {
+  if (!ready || lane === null) return { planMode: null, configured: false, ready };
+  return { planMode: planModeOf(lane.custom), configured: true, ready };
+}
+function decidePlanModeLanePatch({
+  planMode,
+  landed,
+  configVersion,
+  custom
+}) {
+  if (!landed || configVersion <= 0) return { kind: "wait" };
+  const patch = planModeListEdits({ custom, planMode });
+  return Object.keys(patch).length === 0 ? { kind: "done" } : { kind: "patch", patch };
+}
+exports.PLAN_MODE_MIDDLEWARE = PLAN_MODE_MIDDLEWARE;
+exports.PLAN_MODE_TOOL = PLAN_MODE_TOOL;
+exports.decidePlanModeLanePatch = decidePlanModeLanePatch;
+exports.planModeListEdits = planModeListEdits;
+exports.planModeOf = planModeOf;
+exports.threadPlanModeFromLane = threadPlanModeFromLane;
+exports.withPlanMode = withPlanMode;
+//# sourceMappingURL=statewire-plan-mode.cjs.map

package/dist/runtime/statewire-plan-mode.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"statewire-plan-mode.cjs","sources":["../../src/runtime/statewire-plan-mode.ts"],"sourcesContent":["import type {\n  DeepAgentServerConfig,\n  ThreadConfigCustom,\n  ThreadConfigPatch,\n} from '@athenaintel/agent-runtime';\n\n/**\n * Plan mode: the deep agent keeps a to-do plan for multi-step work and checks\n * its steps off as it goes. That is the `write_todos` tool and the\n * `TodoListMiddleware` that provides it with its planning prompt, which agora\n * binds on every run unless the run's config excludes either one\n * (`excluded_tools`, `excluded_middleware`). The two go together, as Olympus's\n * Plan Mode switch flips them (`applyPlanningEnabled`): a config plans unless\n * it excludes either.\n */\nexport const PLAN_MODE_TOOL = 'write_todos';\n\n/** The middleware that provides {@link PLAN_MODE_TOOL} and its planning prompt. */\nexport const PLAN_MODE_MIDDLEWARE = 'TodoListMiddleware';\n\nconst EXCLUDED_TOOLS = 'excluded_tools';\nconst EXCLUDED_MIDDLEWARE = 'excluded_middleware';\n\n/** The two lists plan mode edits, each with the one name plan mode owns in it. */\nconst PLAN_MODE_EXCLUSIONS = [\n  { key: EXCLUDED_TOOLS, name: PLAN_MODE_TOOL },\n  { key: EXCLUDED_MIDDLEWARE, name: PLAN_MODE_MIDDLEWARE },\n] as const;\n\nconst stringItems = (value: unknown): string[] =>\n  Array.isArray(value) ? value.filter((item): item is string => typeof item === 'string') : [];\n\n/** Whether a config (a send's `runConfig.custom`, or a thread's server config) plans. Pure. */\nexport function planModeOf(custom: ThreadConfigCustom): boolean {\n  return PLAN_MODE_EXCLUSIONS.every(({ key, name }) => !stringItems(custom[key]).includes(name));\n}\n\n/**\n * The exclusion lists that put `custom` in plan mode `planMode`, keyed as a\n * config carries them, and only those that change: plan mode off adds\n * `write_todos` to `excluded_tools` and `TodoListMiddleware` to\n * `excluded_middleware` after what each already lists; on takes them out, and\n * a list left empty is `null` (a `config/patch` unsets it). Every other name in\n * either list stays where it is. `{}` when `custom` is in that plan mode\n * already (off: it excludes either one). Pure.\n */\nexport function planModeListEdits({\n  custom,\n  planMode,\n}: {\n  custom: ThreadConfigCustom;\n  planMode: boolean;\n}): ThreadConfigPatch {\n  const edits: ThreadConfigPatch = {};\n  if (planModeOf(custom) === planMode) return edits;\n  for (const { key, name } of PLAN_MODE_EXCLUSIONS) {\n    const items = stringItems(custom[key]);\n    const excluded = items.includes(name);\n    if (planMode && excluded) {\n      const kept = items.filter((item) => item !== name);\n      edits[key] = kept.length > 0 ? kept : null;\n    } else if (!planMode && !excluded) {\n      edits[key] = [...items, name];\n    }\n  }\n  return edits;\n}\n\n/**\n * A send's `runConfig.custom` in plan mode `planMode`, after everything else\n * (the host's `extraRunConfig` included) is merged: `undefined` leaves it as it\n * is; otherwise {@link planModeListEdits}, an emptied list omitted. Pure.\n */\nexport function withPlanMode({\n  custom,\n  planMode,\n}: {\n  custom: Record<string, unknown>;\n  planMode: boolean | undefined;\n}): Record<string, unknown> {\n  if (planMode === undefined) return custom;\n  const edits = planModeListEdits({ custom, planMode });\n  if (Object.keys(edits).length === 0) return custom;\n  const next: Record<string, unknown> = { ...custom };\n  for (const [key, value] of Object.entries(edits)) {\n    if (value === null) delete next[key];\n    else next[key] = value;\n  }\n  return next;\n}\n\n/** A thread's plan mode, read from its server config lane. */\nexport interface AthenaThreadPlanMode {\n  /**\n   * Whether the thread's server config plans (`true`) or not (`false`); `null`\n   * while it has none, when every turn runs with what the send carries (the\n   * provider's `planMode`, and a plan when the provider sets none).\n   */\n  planMode: boolean | 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 may carry\n   * no lane, or an older one). Before that `planMode` is `null`.\n   */\n  ready: boolean;\n}\n\n/** {@link AthenaThreadPlanMode} from the lane and the landed flag. Pure. */\nexport function threadPlanModeFromLane({\n  lane,\n  ready,\n}: {\n  lane: DeepAgentServerConfig | null;\n  ready: boolean;\n}): AthenaThreadPlanMode {\n  if (!ready || lane === null) return { planMode: null, configured: false, ready };\n  return { planMode: planModeOf(lane.custom), configured: true, ready };\n}\n\n/**\n * What to do with a `planMode` change the host made during an attach, decided\n * as every provider-owned thread-config key is (`decideThreadConfigLanePatch`):\n *\n * - `wait`: keep it pending. The thread's snapshot has not landed, or the\n *   thread has no lane yet (version 0), where the next send carries plan mode.\n *   It stays pending so that a lane an EARLIER send seeds is corrected once it\n *   lands.\n * - `done`: the lane already plans that way (this client's own unacknowledged\n *   writes folded over); nothing to write.\n * - `patch`: issue one `config/patch` carrying the exclusion lists that change,\n *   computed from the lane's own, so a name another client excluded stays.\n */\nexport type PlanModeLaneDecision =\n  | { kind: 'wait' }\n  | { kind: 'done' }\n  | { kind: 'patch'; patch: ThreadConfigPatch };\n\nexport function decidePlanModeLanePatch({\n  planMode,\n  landed,\n  configVersion,\n  custom,\n}: {\n  /** The provider's `planMode` after the change. */\n  planMode: boolean;\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}): PlanModeLaneDecision {\n  if (!landed || configVersion <= 0) return { kind: 'wait' };\n  const patch = planModeListEdits({ custom, planMode });\n  return Object.keys(patch).length === 0 ? { kind: 'done' } : { kind: 'patch', patch };\n}\n"],"names":[],"mappings":";;AAeO,MAAM,iBAAiB;AAGvB,MAAM,uBAAuB;AAEpC,MAAM,iBAAiB;AACvB,MAAM,sBAAsB;AAG5B,MAAM,uBAAuB;AAAA,EAC3B,EAAE,KAAK,gBAAgB,MAAM,eAAA;AAAA,EAC7B,EAAE,KAAK,qBAAqB,MAAM,qBAAA;AACpC;AAEA,MAAM,cAAc,CAAC,UACnB,MAAM,QAAQ,KAAK,IAAI,MAAM,OAAO,CAAC,SAAyB,OAAO,SAAS,QAAQ,IAAI,CAAA;AAGrF,SAAS,WAAW,QAAqC;AAC9D,SAAO,qBAAqB,MAAM,CAAC,EAAE,KAAK,KAAA,MAAW,CAAC,YAAY,OAAO,GAAG,CAAC,EAAE,SAAS,IAAI,CAAC;AAC/F;AAWO,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AACF,GAGsB;AACpB,QAAM,QAA2B,CAAA;AACjC,MAAI,WAAW,MAAM,MAAM,SAAU,QAAO;AAC5C,aAAW,EAAE,KAAK,KAAA,KAAU,sBAAsB;AAChD,UAAM,QAAQ,YAAY,OAAO,GAAG,CAAC;AACrC,UAAM,WAAW,MAAM,SAAS,IAAI;AACpC,QAAI,YAAY,UAAU;AACxB,YAAM,OAAO,MAAM,OAAO,CAAC,SAAS,SAAS,IAAI;AACjD,YAAM,GAAG,IAAI,KAAK,SAAS,IAAI,OAAO;AAAA,IACxC,WAAW,CAAC,YAAY,CAAC,UAAU;AACjC,YAAM,GAAG,IAAI,CAAC,GAAG,OAAO,IAAI;AAAA,IAC9B;AAAA,EACF;AACA,SAAO;AACT;AAOO,SAAS,aAAa;AAAA,EAC3B;AAAA,EACA;AACF,GAG4B;AAC1B,MAAI,aAAa,OAAW,QAAO;AACnC,QAAM,QAAQ,kBAAkB,EAAE,QAAQ,UAAU;AACpD,MAAI,OAAO,KAAK,KAAK,EAAE,WAAW,EAAG,QAAO;AAC5C,QAAM,OAAgC,EAAE,GAAG,OAAA;AAC3C,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,QAAI,UAAU,KAAM,QAAO,KAAK,GAAG;AAAA,QAC9B,MAAK,GAAG,IAAI;AAAA,EACnB;AACA,SAAO;AACT;AAqBO,SAAS,uBAAuB;AAAA,EACrC;AAAA,EACA;AACF,GAGyB;AACvB,MAAI,CAAC,SAAS,SAAS,KAAM,QAAO,EAAE,UAAU,MAAM,YAAY,OAAO,MAAA;AACzE,SAAO,EAAE,UAAU,WAAW,KAAK,MAAM,GAAG,YAAY,MAAM,MAAA;AAChE;AAoBO,SAAS,wBAAwB;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAOyB;AACvB,MAAI,CAAC,UAAU,iBAAiB,EAAG,QAAO,EAAE,MAAM,OAAA;AAClD,QAAM,QAAQ,kBAAkB,EAAE,QAAQ,UAAU;AACpD,SAAO,OAAO,KAAK,KAAK,EAAE,WAAW,IAAI,EAAE,MAAM,OAAA,IAAW,EAAE,MAAM,SAAS,MAAA;AAC/E;;;;;;;;"}

package/dist/runtime/statewire-plan-mode.d.ts

@@ -0,0 +1,88 @@
+import type { DeepAgentServerConfig, ThreadConfigCustom, ThreadConfigPatch } from '../agent-runtime/src/index';
+/**
+ * Plan mode: the deep agent keeps a to-do plan for multi-step work and checks
+ * its steps off as it goes. That is the `write_todos` tool and the
+ * `TodoListMiddleware` that provides it with its planning prompt, which agora
+ * binds on every run unless the run's config excludes either one
+ * (`excluded_tools`, `excluded_middleware`). The two go together, as Olympus's
+ * Plan Mode switch flips them (`applyPlanningEnabled`): a config plans unless
+ * it excludes either.
+ */
+export declare const PLAN_MODE_TOOL = "write_todos";
+/** The middleware that provides {@link PLAN_MODE_TOOL} and its planning prompt. */
+export declare const PLAN_MODE_MIDDLEWARE = "TodoListMiddleware";
+/** Whether a config (a send's `runConfig.custom`, or a thread's server config) plans. Pure. */
+export declare function planModeOf(custom: ThreadConfigCustom): boolean;
+/**
+ * The exclusion lists that put `custom` in plan mode `planMode`, keyed as a
+ * config carries them, and only those that change: plan mode off adds
+ * `write_todos` to `excluded_tools` and `TodoListMiddleware` to
+ * `excluded_middleware` after what each already lists; on takes them out, and
+ * a list left empty is `null` (a `config/patch` unsets it). Every other name in
+ * either list stays where it is. `{}` when `custom` is in that plan mode
+ * already (off: it excludes either one). Pure.
+ */
+export declare function planModeListEdits({ custom, planMode, }: {
+    custom: ThreadConfigCustom;
+    planMode: boolean;
+}): ThreadConfigPatch;
+/**
+ * A send's `runConfig.custom` in plan mode `planMode`, after everything else
+ * (the host's `extraRunConfig` included) is merged: `undefined` leaves it as it
+ * is; otherwise {@link planModeListEdits}, an emptied list omitted. Pure.
+ */
+export declare function withPlanMode({ custom, planMode, }: {
+    custom: Record<string, unknown>;
+    planMode: boolean | undefined;
+}): Record<string, unknown>;
+/** A thread's plan mode, read from its server config lane. */
+export interface AthenaThreadPlanMode {
+    /**
+     * Whether the thread's server config plans (`true`) or not (`false`); `null`
+     * while it has none, when every turn runs with what the send carries (the
+     * provider's `planMode`, and a plan when the provider sets none).
+     */
+    planMode: boolean | 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 may carry
+     * no lane, or an older one). Before that `planMode` is `null`.
+     */
+    ready: boolean;
+}
+/** {@link AthenaThreadPlanMode} from the lane and the landed flag. Pure. */
+export declare function threadPlanModeFromLane({ lane, ready, }: {
+    lane: DeepAgentServerConfig | null;
+    ready: boolean;
+}): AthenaThreadPlanMode;
+/**
+ * What to do with a `planMode` change the host made during an attach, decided
+ * as every provider-owned thread-config key is (`decideThreadConfigLanePatch`):
+ *
+ * - `wait`: keep it pending. The thread's snapshot has not landed, or the
+ *   thread has no lane yet (version 0), where the next send carries plan mode.
+ *   It stays pending so that a lane an EARLIER send seeds is corrected once it
+ *   lands.
+ * - `done`: the lane already plans that way (this client's own unacknowledged
+ *   writes folded over); nothing to write.
+ * - `patch`: issue one `config/patch` carrying the exclusion lists that change,
+ *   computed from the lane's own, so a name another client excluded stays.
+ */
+export type PlanModeLaneDecision = {
+    kind: 'wait';
+} | {
+    kind: 'done';
+} | {
+    kind: 'patch';
+    patch: ThreadConfigPatch;
+};
+export declare function decidePlanModeLanePatch({ planMode, landed, configVersion, custom, }: {
+    /** The provider's `planMode` after the change. */
+    planMode: boolean;
+    landed: boolean;
+    configVersion: number;
+    /** The effective lane: the server config with this client's pending writes folded over. */
+    custom: ThreadConfigCustom;
+}): PlanModeLaneDecision;