@athenaintel/react 0.43.0 → 0.50.0

package/dist/agent-runtime/src/use-deep-agent-chat-outbox.d.ts

@@ -1,5 +1,6 @@
+import { type Context } from "react";
 import type { ChatOutboxAttachmentCheck } from "./chat-outbox-attachments";
-import { type ChatOutbox, type ChatOutboxCommandUpdate, type ChatOutboxEvent, type ChatOutboxSignal, type ChatOutboxSnapshot } from "./chat-outbox";
+import { type ChatOutbox, type ChatOutboxCommandUpdate, type ChatOutboxEvent, type ChatOutboxSendGate, type ChatOutboxSignal, type ChatOutboxSnapshot } from "./chat-outbox";
 import type { ChatOutboxEntry, ChatOutboxStore } from "./chat-outbox-store";
 import { type ChatOutboxClientHost } from "./chat-outbox-thread";
 export interface UseDeepAgentChatOutboxOptions {
@@ -34,6 +35,12 @@ export interface UseDeepAgentChatOutboxOptions {
      * (`createChatOutboxAttachmentCheck`); omitted, attachments go unchecked.
      */
     checkAttachments?: ChatOutboxAttachmentCheck;
+    /**
+     * Which waiting messages go together, and when (`ChatOutboxOptions.sendGate`): a host whose
+     * messages carry per-send settings keeps a message with other settings than a send the
+     * conversation has not taken yet waiting until it has. Read through a ref: a host may rebuild it.
+     */
+    sendGate?: ChatOutboxSendGate;
     /** Off: no outbox (a read-only or suspended surface); sends behave as before. */
     enabled?: boolean;
     /** The countdown before a waiting message is sent (tests); defaults to `CHAT_OUTBOX_COUNTDOWN_MS`. */
@@ -46,7 +53,7 @@ export interface UseDeepAgentChatOutboxOptions {
  * instance through {@link DeepAgentChatOutboxContext}, and has its composer call
  * {@link ChatOutbox.shouldHold} / {@link ChatOutbox.hold} before sending.
  */
-export declare function useDeepAgentChatOutbox({ client, threadId, isNewChat, store, reachability, foreground, restore, openThread, onEvent, checkAttachments, enabled, countdownMs, }: UseDeepAgentChatOutboxOptions): ChatOutbox | null;
+export declare function useDeepAgentChatOutbox({ client, threadId, isNewChat, store, reachability, foreground, restore, openThread, onEvent, checkAttachments, sendGate, enabled, countdownMs, }: UseDeepAgentChatOutboxOptions): ChatOutbox | null;
 /** The outbox's rows and countdown, re-rendering on every change (`null` outbox: nothing waits). */
 export declare function useChatOutboxSnapshot(outbox: ChatOutbox | null): ChatOutboxSnapshot;
 /**
@@ -56,7 +63,7 @@ export declare function useChatOutboxSnapshot(outbox: ChatOutbox | null): ChatOu
  */
 export declare function useChatOutboxReachable(outbox: ChatOutbox | null): boolean;
 /** The mounted thread's chat outbox, shared from its runtime provider to its composer and tray. */
-export declare const DeepAgentChatOutboxContext: import("react").Context<ChatOutbox | null>;
+export declare const DeepAgentChatOutboxContext: Context<ChatOutbox | null>;
 export declare function useDeepAgentChatOutboxContext(): ChatOutbox | null;
 /** Forward statewire's command lifecycle to an outbox held in a ref (the runtime is made first). */
 export declare function forwardChatOutboxCommand(outbox: {

package/dist/agent-runtime/src/use-deep-agent-chat-outbox.js

@@ -12,6 +12,7 @@ function useDeepAgentChatOutbox({
   openThread,
   onEvent,
   checkAttachments,
+  sendGate,
   enabled = true,
   countdownMs
 }) {
@@ -27,6 +28,9 @@ function useDeepAgentChatOutbox({
   const checkAttachmentsRef = useRef(checkAttachments);
   checkAttachmentsRef.current = checkAttachments;
   const checksAttachments = checkAttachments !== void 0;
+  const sendGateRef = useRef(sendGate);
+  sendGateRef.current = sendGate;
+  const gatesSends = sendGate !== void 0;
   const reachabilityRef = useRef(reachability);
   reachabilityRef.current = reachability;
   const foregroundRef = useRef(foreground);
@@ -89,6 +93,22 @@ function useDeepAgentChatOutbox({
           return ((_a = checkAttachmentsRef.current) == null ? void 0 : _a.call(checkAttachmentsRef, attachments)) ?? Promise.resolve("ok");
         }
       },
+      ...gatesSends && {
+        sendGate: {
+          keyOf: (entry) => {
+            var _a;
+            return ((_a = sendGateRef.current) == null ? void 0 : _a.keyOf(entry)) ?? "";
+          },
+          mayHandOff: (entry) => {
+            var _a;
+            return ((_a = sendGateRef.current) == null ? void 0 : _a.mayHandOff(entry)) ?? true;
+          },
+          subscribe: (listener) => {
+            var _a;
+            return ((_a = sendGateRef.current) == null ? void 0 : _a.subscribe(listener)) ?? (() => void 0);
+          }
+        }
+      },
       ...countdownMs !== void 0 && { countdownMs }
     });
     setOutbox(created);
@@ -96,7 +116,7 @@ function useDeepAgentChatOutbox({
       created.dispose();
       setOutbox((current) => current === created ? null : current);
     };
-  }, [enabled, threadId, store, countdownMs, canOpenThreads, checksAttachments]);
+  }, [enabled, threadId, store, countdownMs, canOpenThreads, checksAttachments, gatesSends]);
   return outbox !== null && outbox.threadId === threadId ? outbox : null;
 }
 const EMPTY_SNAPSHOT = {
@@ -122,7 +142,12 @@ function useChatOutboxReachable(outbox) {
   const reachable = () => (outbox == null ? void 0 : outbox.reachability.get()) ?? true;
   return useSyncExternalStore(subscribe, reachable, reachable);
 }
-const DeepAgentChatOutboxContext = createContext(null);
+const CHAT_OUTBOX_CONTEXT = Symbol.for("@athenaintel/agent-runtime/deep-agent-chat-outbox-context");
+function sharedChatOutboxContext() {
+  const host = globalThis;
+  return host[CHAT_OUTBOX_CONTEXT] ?? (host[CHAT_OUTBOX_CONTEXT] = createContext(null));
+}
+const DeepAgentChatOutboxContext = sharedChatOutboxContext();
 function useDeepAgentChatOutboxContext() {
   return useContext(DeepAgentChatOutboxContext);
 }

package/dist/agent-runtime/src/use-deep-agent-chat-outbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-deep-agent-chat-outbox.js","sources":["../../../../agent-runtime/src/use-deep-agent-chat-outbox.ts"],"sourcesContent":["import { createContext, useCallback, useContext, useEffect, useRef, useState, useSyncExternalStore } from \"react\";\nimport type { ChatOutboxAttachmentCheck } from \"./chat-outbox-attachments\";\nimport {\n  type ChatOutbox,\n  type ChatOutboxCommandUpdate,\n  type ChatOutboxEvent,\n  type ChatOutboxSignal,\n  type ChatOutboxSnapshot,\n  createChatOutbox,\n} from \"./chat-outbox\";\nimport type { ChatOutboxEntry, ChatOutboxStore } from \"./chat-outbox-store\";\nimport { type ChatOutboxClientHost, createStatewireChatOutboxPort } from \"./chat-outbox-thread\";\n\nexport interface UseDeepAgentChatOutboxOptions {\n  /** The thread's assistant-ui client (`useDeepAgentRuntime`'s result). */\n  client: ChatOutboxClientHost;\n  threadId: string;\n  /** The conversation has never started (a new chat). */\n  isNewChat: boolean;\n  /**\n   * This person's outbox store, one per person for the life of the page or app (a message the\n   * device cannot keep waits in its memory, across thread switches); `null` keeps waiting messages\n   * in this outbox alone.\n   */\n  store: ChatOutboxStore | null;\n  /** Athena's reachability (the host's own model: the browser online AND agora answering). */\n  reachability: ChatOutboxSignal;\n  /** The app is in front (a visible tab, an active app, a focused desktop window). */\n  foreground: ChatOutboxSignal;\n  /** Give a cancelled message's text back to the composer. */\n  restore: (entry: ChatOutboxEntry) => void;\n  /**\n   * Open another of the person's conversations holding waiting messages (the tray's Open); omit\n   * it where the host cannot switch conversations.\n   */\n  openThread?: (target: { threadId: string; newChat: boolean }) => void;\n  onEvent?: (event: ChatOutboxEvent) => void;\n  /**\n   * Asks Athena whether a waiting message's attachments can still be opened, right before it goes\n   * (`createChatOutboxAttachmentCheck`); omitted, attachments go unchecked.\n   */\n  checkAttachments?: ChatOutboxAttachmentCheck;\n  /** Off: no outbox (a read-only or suspended surface); sends behave as before. */\n  enabled?: boolean;\n  /** The countdown before a waiting message is sent (tests); defaults to `CHAT_OUTBOX_COUNTDOWN_MS`. */\n  countdownMs?: number;\n}\n\n/**\n * The chat outbox for the mounted thread (`chat-outbox.ts`), one per thread and store: a thread\n * switch disposes it and makes the next thread's. The host forwards statewire's command lifecycle\n * to {@link ChatOutbox.observeCommand} (its `useDeepAgentRuntime` `onCommandChange`), shares the\n * instance through {@link DeepAgentChatOutboxContext}, and has its composer call\n * {@link ChatOutbox.shouldHold} / {@link ChatOutbox.hold} before sending.\n */\nexport function useDeepAgentChatOutbox({\n  client,\n  threadId,\n  isNewChat,\n  store,\n  reachability,\n  foreground,\n  restore,\n  openThread,\n  onEvent,\n  checkAttachments,\n  enabled = true,\n  countdownMs,\n}: UseDeepAgentChatOutboxOptions): ChatOutbox | null {\n  const clientRef = useRef(client);\n  clientRef.current = client;\n  const restoreRef = useRef(restore);\n  restoreRef.current = restore;\n  const openThreadRef = useRef(openThread);\n  openThreadRef.current = openThread;\n  const canOpenThreads = openThread !== undefined;\n  const onEventRef = useRef(onEvent);\n  onEventRef.current = onEvent;\n  const checkAttachmentsRef = useRef(checkAttachments);\n  checkAttachmentsRef.current = checkAttachments;\n  const checksAttachments = checkAttachments !== undefined;\n  const reachabilityRef = useRef(reachability);\n  reachabilityRef.current = reachability;\n  const foregroundRef = useRef(foreground);\n  foregroundRef.current = foreground;\n  // The client's notifications reach the port through this set, so a client whose identity\n  // changes mid-thread is followed without remaking the outbox (and losing its countdown).\n  const [threadListeners] = useState(() => new Set<() => void>());\n  // A host without an outbox (`enabled` false) is never subscribed to.\n  useEffect(() => {\n    if (!enabled) return undefined;\n    return client.subscribe(() => {\n      for (const listener of threadListeners) listener();\n    });\n  }, [client, threadListeners, enabled]);\n  // Signals read through refs for the same reason: a host rebuilding its signal objects per render\n  // never remakes the outbox.\n  const [stableSignals] = useState(() => {\n    const forward = (pick: () => ChatOutboxSignal): ChatOutboxSignal => ({\n      get: () => pick().get(),\n      subscribe: (listener) => pick().subscribe(listener),\n    });\n    return {\n      reachability: forward(() => reachabilityRef.current),\n      foreground: forward(() => foregroundRef.current),\n    };\n  });\n  const isNewChatRef = useRef(isNewChat);\n  isNewChatRef.current = isNewChat;\n\n  const [outbox, setOutbox] = useState<ChatOutbox | null>(null);\n  // Made in an effect, not during render: the outbox subscribes to its signals and reads its\n  // store, and a render React throws away must not leave those behind.\n  // biome-ignore lint/correctness/useExhaustiveDependencies: one outbox per thread and store; everything else is read through refs.\n  useEffect(() => {\n    if (!enabled || !threadId) {\n      setOutbox(null);\n      return undefined;\n    }\n    const created = createChatOutbox({\n      threadId,\n      // Read at each hold: a chat that starts while mounted stamps its later messages as started.\n      isNewChat: () => isNewChatRef.current,\n      store,\n      reachability: stableSignals.reachability,\n      foreground: stableSignals.foreground,\n      thread: {\n        ...createStatewireChatOutboxPort({ client: () => clientRef.current }),\n        subscribe: (listener) => {\n          threadListeners.add(listener);\n          return () => {\n            threadListeners.delete(listener);\n          };\n        },\n      },\n      restore: (entry) => restoreRef.current(entry),\n      ...(canOpenThreads && {\n        openThread: (target: { threadId: string; newChat: boolean }) => openThreadRef.current?.(target),\n      }),\n      onEvent: (event) => onEventRef.current?.(event),\n      ...(checksAttachments && {\n        checkAttachments: (attachments: Parameters<ChatOutboxAttachmentCheck>[0]) =>\n          checkAttachmentsRef.current?.(attachments) ?? Promise.resolve(\"ok\" as const),\n      }),\n      ...(countdownMs !== undefined && { countdownMs }),\n    });\n    setOutbox(created);\n    return () => {\n      created.dispose();\n      setOutbox((current) => (current === created ? null : current));\n    };\n  }, [enabled, threadId, store, countdownMs, canOpenThreads, checksAttachments]);\n  // During a thread switch's first render the previous thread's outbox is still in state.\n  return outbox !== null && outbox.threadId === threadId ? outbox : null;\n}\n\nconst EMPTY_SNAPSHOT: ChatOutboxSnapshot = {\n  rows: [],\n  countdownEndsAt: null,\n  durable: true,\n  loaded: true,\n  elsewhere: [],\n};\nconst noopSubscribe = () => () => undefined;\n\n/** The outbox's rows and countdown, re-rendering on every change (`null` outbox: nothing waits). */\nexport function useChatOutboxSnapshot(outbox: ChatOutbox | null): ChatOutboxSnapshot {\n  return useSyncExternalStore(\n    outbox ? outbox.subscribe : noopSubscribe,\n    () => outbox?.getSnapshot() ?? EMPTY_SNAPSHOT,\n    () => outbox?.getSnapshot() ?? EMPTY_SNAPSHOT,\n  );\n}\n\n/**\n * Whether Athena can be reached, as the thread's outbox reads it: `true` without an outbox (a host\n * that keeps none sends and edits as before). What a sent message's Edit is offered on; a boolean,\n * so a reader re-renders only when it flips.\n */\nexport function useChatOutboxReachable(outbox: ChatOutbox | null): boolean {\n  const subscribe = useCallback(\n    (listener: () => void) => (outbox ? outbox.reachability.subscribe(listener) : () => undefined),\n    [outbox],\n  );\n  const reachable = () => outbox?.reachability.get() ?? true;\n  return useSyncExternalStore(subscribe, reachable, reachable);\n}\n\n/** The mounted thread's chat outbox, shared from its runtime provider to its composer and tray. */\nexport const DeepAgentChatOutboxContext = createContext<ChatOutbox | null>(null);\n\nexport function useDeepAgentChatOutboxContext(): ChatOutbox | null {\n  return useContext(DeepAgentChatOutboxContext);\n}\n\n/** Forward statewire's command lifecycle to an outbox held in a ref (the runtime is made first). */\nexport function forwardChatOutboxCommand(\n  outbox: { current: ChatOutbox | null },\n  update: ChatOutboxCommandUpdate,\n): void {\n  outbox.current?.observeCommand(update);\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-deep-agent-chat-outbox.js","sources":["../../../../agent-runtime/src/use-deep-agent-chat-outbox.ts"],"sourcesContent":["import {\n  type Context,\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useRef,\n  useState,\n  useSyncExternalStore,\n} from \"react\";\nimport type { ChatOutboxAttachmentCheck } from \"./chat-outbox-attachments\";\nimport {\n  type ChatOutbox,\n  type ChatOutboxCommandUpdate,\n  type ChatOutboxEvent,\n  type ChatOutboxSendGate,\n  type ChatOutboxSignal,\n  type ChatOutboxSnapshot,\n  createChatOutbox,\n} from \"./chat-outbox\";\nimport type { ChatOutboxEntry, ChatOutboxStore } from \"./chat-outbox-store\";\nimport { type ChatOutboxClientHost, createStatewireChatOutboxPort } from \"./chat-outbox-thread\";\n\nexport interface UseDeepAgentChatOutboxOptions {\n  /** The thread's assistant-ui client (`useDeepAgentRuntime`'s result). */\n  client: ChatOutboxClientHost;\n  threadId: string;\n  /** The conversation has never started (a new chat). */\n  isNewChat: boolean;\n  /**\n   * This person's outbox store, one per person for the life of the page or app (a message the\n   * device cannot keep waits in its memory, across thread switches); `null` keeps waiting messages\n   * in this outbox alone.\n   */\n  store: ChatOutboxStore | null;\n  /** Athena's reachability (the host's own model: the browser online AND agora answering). */\n  reachability: ChatOutboxSignal;\n  /** The app is in front (a visible tab, an active app, a focused desktop window). */\n  foreground: ChatOutboxSignal;\n  /** Give a cancelled message's text back to the composer. */\n  restore: (entry: ChatOutboxEntry) => void;\n  /**\n   * Open another of the person's conversations holding waiting messages (the tray's Open); omit\n   * it where the host cannot switch conversations.\n   */\n  openThread?: (target: { threadId: string; newChat: boolean }) => void;\n  onEvent?: (event: ChatOutboxEvent) => void;\n  /**\n   * Asks Athena whether a waiting message's attachments can still be opened, right before it goes\n   * (`createChatOutboxAttachmentCheck`); omitted, attachments go unchecked.\n   */\n  checkAttachments?: ChatOutboxAttachmentCheck;\n  /**\n   * Which waiting messages go together, and when (`ChatOutboxOptions.sendGate`): a host whose\n   * messages carry per-send settings keeps a message with other settings than a send the\n   * conversation has not taken yet waiting until it has. Read through a ref: a host may rebuild it.\n   */\n  sendGate?: ChatOutboxSendGate;\n  /** Off: no outbox (a read-only or suspended surface); sends behave as before. */\n  enabled?: boolean;\n  /** The countdown before a waiting message is sent (tests); defaults to `CHAT_OUTBOX_COUNTDOWN_MS`. */\n  countdownMs?: number;\n}\n\n/**\n * The chat outbox for the mounted thread (`chat-outbox.ts`), one per thread and store: a thread\n * switch disposes it and makes the next thread's. The host forwards statewire's command lifecycle\n * to {@link ChatOutbox.observeCommand} (its `useDeepAgentRuntime` `onCommandChange`), shares the\n * instance through {@link DeepAgentChatOutboxContext}, and has its composer call\n * {@link ChatOutbox.shouldHold} / {@link ChatOutbox.hold} before sending.\n */\nexport function useDeepAgentChatOutbox({\n  client,\n  threadId,\n  isNewChat,\n  store,\n  reachability,\n  foreground,\n  restore,\n  openThread,\n  onEvent,\n  checkAttachments,\n  sendGate,\n  enabled = true,\n  countdownMs,\n}: UseDeepAgentChatOutboxOptions): ChatOutbox | null {\n  const clientRef = useRef(client);\n  clientRef.current = client;\n  const restoreRef = useRef(restore);\n  restoreRef.current = restore;\n  const openThreadRef = useRef(openThread);\n  openThreadRef.current = openThread;\n  const canOpenThreads = openThread !== undefined;\n  const onEventRef = useRef(onEvent);\n  onEventRef.current = onEvent;\n  const checkAttachmentsRef = useRef(checkAttachments);\n  checkAttachmentsRef.current = checkAttachments;\n  const checksAttachments = checkAttachments !== undefined;\n  const sendGateRef = useRef(sendGate);\n  sendGateRef.current = sendGate;\n  const gatesSends = sendGate !== undefined;\n  const reachabilityRef = useRef(reachability);\n  reachabilityRef.current = reachability;\n  const foregroundRef = useRef(foreground);\n  foregroundRef.current = foreground;\n  // The client's notifications reach the port through this set, so a client whose identity\n  // changes mid-thread is followed without remaking the outbox (and losing its countdown).\n  const [threadListeners] = useState(() => new Set<() => void>());\n  // A host without an outbox (`enabled` false) is never subscribed to.\n  useEffect(() => {\n    if (!enabled) return undefined;\n    return client.subscribe(() => {\n      for (const listener of threadListeners) listener();\n    });\n  }, [client, threadListeners, enabled]);\n  // Signals read through refs for the same reason: a host rebuilding its signal objects per render\n  // never remakes the outbox.\n  const [stableSignals] = useState(() => {\n    const forward = (pick: () => ChatOutboxSignal): ChatOutboxSignal => ({\n      get: () => pick().get(),\n      subscribe: (listener) => pick().subscribe(listener),\n    });\n    return {\n      reachability: forward(() => reachabilityRef.current),\n      foreground: forward(() => foregroundRef.current),\n    };\n  });\n  const isNewChatRef = useRef(isNewChat);\n  isNewChatRef.current = isNewChat;\n\n  const [outbox, setOutbox] = useState<ChatOutbox | null>(null);\n  // Made in an effect, not during render: the outbox subscribes to its signals and reads its\n  // store, and a render React throws away must not leave those behind.\n  // biome-ignore lint/correctness/useExhaustiveDependencies: one outbox per thread and store; everything else is read through refs.\n  useEffect(() => {\n    if (!enabled || !threadId) {\n      setOutbox(null);\n      return undefined;\n    }\n    const created = createChatOutbox({\n      threadId,\n      // Read at each hold: a chat that starts while mounted stamps its later messages as started.\n      isNewChat: () => isNewChatRef.current,\n      store,\n      reachability: stableSignals.reachability,\n      foreground: stableSignals.foreground,\n      thread: {\n        ...createStatewireChatOutboxPort({ client: () => clientRef.current }),\n        subscribe: (listener) => {\n          threadListeners.add(listener);\n          return () => {\n            threadListeners.delete(listener);\n          };\n        },\n      },\n      restore: (entry) => restoreRef.current(entry),\n      ...(canOpenThreads && {\n        openThread: (target: { threadId: string; newChat: boolean }) => openThreadRef.current?.(target),\n      }),\n      onEvent: (event) => onEventRef.current?.(event),\n      ...(checksAttachments && {\n        checkAttachments: (attachments: Parameters<ChatOutboxAttachmentCheck>[0]) =>\n          checkAttachmentsRef.current?.(attachments) ?? Promise.resolve(\"ok\" as const),\n      }),\n      ...(gatesSends && {\n        sendGate: {\n          keyOf: (entry: ChatOutboxEntry) => sendGateRef.current?.keyOf(entry) ?? \"\",\n          mayHandOff: (entry: ChatOutboxEntry) => sendGateRef.current?.mayHandOff(entry) ?? true,\n          subscribe: (listener: () => void) => sendGateRef.current?.subscribe(listener) ?? (() => undefined),\n        },\n      }),\n      ...(countdownMs !== undefined && { countdownMs }),\n    });\n    setOutbox(created);\n    return () => {\n      created.dispose();\n      setOutbox((current) => (current === created ? null : current));\n    };\n  }, [enabled, threadId, store, countdownMs, canOpenThreads, checksAttachments, gatesSends]);\n  // During a thread switch's first render the previous thread's outbox is still in state.\n  return outbox !== null && outbox.threadId === threadId ? outbox : null;\n}\n\nconst EMPTY_SNAPSHOT: ChatOutboxSnapshot = {\n  rows: [],\n  countdownEndsAt: null,\n  durable: true,\n  loaded: true,\n  elsewhere: [],\n};\nconst noopSubscribe = () => () => undefined;\n\n/** The outbox's rows and countdown, re-rendering on every change (`null` outbox: nothing waits). */\nexport function useChatOutboxSnapshot(outbox: ChatOutbox | null): ChatOutboxSnapshot {\n  return useSyncExternalStore(\n    outbox ? outbox.subscribe : noopSubscribe,\n    () => outbox?.getSnapshot() ?? EMPTY_SNAPSHOT,\n    () => outbox?.getSnapshot() ?? EMPTY_SNAPSHOT,\n  );\n}\n\n/**\n * Whether Athena can be reached, as the thread's outbox reads it: `true` without an outbox (a host\n * that keeps none sends and edits as before). What a sent message's Edit is offered on; a boolean,\n * so a reader re-renders only when it flips.\n */\nexport function useChatOutboxReachable(outbox: ChatOutbox | null): boolean {\n  const subscribe = useCallback(\n    (listener: () => void) => (outbox ? outbox.reachability.subscribe(listener) : () => undefined),\n    [outbox],\n  );\n  const reachable = () => outbox?.reachability.get() ?? true;\n  return useSyncExternalStore(subscribe, reachable, reachable);\n}\n\n/**\n * The context lives on `globalThis`, not in module scope, because two copies of this module can\n * run in one page: the SDK bundles agent-runtime into its dist while a host such as Olympus imports\n * agent-runtime directly. The host provides its thread's outbox through its own copy and mounts the\n * SDK's queue tray, which reads it through the SDK's copy: one context per copy, and the tray would\n * never see a waiting message (`asset-attachment.ts` shares its registry the same way).\n */\nconst CHAT_OUTBOX_CONTEXT = Symbol.for(\"@athenaintel/agent-runtime/deep-agent-chat-outbox-context\");\n\ntype ChatOutboxContextHost = typeof globalThis & {\n  [CHAT_OUTBOX_CONTEXT]?: Context<ChatOutbox | null>;\n};\n\nfunction sharedChatOutboxContext(): Context<ChatOutbox | null> {\n  const host = globalThis as ChatOutboxContextHost;\n  return (host[CHAT_OUTBOX_CONTEXT] ??= createContext<ChatOutbox | null>(null));\n}\n\n/** The mounted thread's chat outbox, shared from its runtime provider to its composer and tray. */\nexport const DeepAgentChatOutboxContext: Context<ChatOutbox | null> = sharedChatOutboxContext();\n\nexport function useDeepAgentChatOutboxContext(): ChatOutbox | null {\n  return useContext(DeepAgentChatOutboxContext);\n}\n\n/** Forward statewire's command lifecycle to an outbox held in a ref (the runtime is made first). */\nexport function forwardChatOutboxCommand(\n  outbox: { current: ChatOutbox | null },\n  update: ChatOutboxCommandUpdate,\n): void {\n  outbox.current?.observeCommand(update);\n}\n"],"names":[],"mappings":"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"}

package/dist/agent-runtime/src/use-deep-agent-config.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("@assistant-ui/react-statewire");
-const react = require("react");
+const require$$0 = require("react");
 const configMutations = require("./config-mutations.cjs");
 const errors = require("./errors.cjs");
 const runconfigContract = require("./generated/runconfig-contract.cjs");
@@ -45,17 +45,17 @@ function useDeepAgentConfigController({
   sendCommand,
   onServerConfig
 }) {
-  const [ops, setOps] = react.useState([]);
-  const nextOpIdRef = react.useRef(1);
-  const sendCommandRef = react.useRef(sendCommand);
+  const [ops, setOps] = require$$0.useState([]);
+  const nextOpIdRef = require$$0.useRef(1);
+  const sendCommandRef = require$$0.useRef(sendCommand);
   sendCommandRef.current = sendCommand;
-  const onServerConfigRef = react.useRef(onServerConfig);
+  const onServerConfigRef = require$$0.useRef(onServerConfig);
   onServerConfigRef.current = onServerConfig;
-  const custom = react.useMemo(() => foldPendingConfigOps(serverConfig, ops), [serverConfig, ops]);
+  const custom = require$$0.useMemo(() => foldPendingConfigOps(serverConfig, ops), [serverConfig, ops]);
   const serverVersion = (serverConfig == null ? void 0 : serverConfig.version) ?? 0;
-  const serverVersionRef = react.useRef(serverVersion);
+  const serverVersionRef = require$$0.useRef(serverVersion);
   serverVersionRef.current = serverVersion;
-  react.useEffect(() => {
+  require$$0.useEffect(() => {
     setOps((current) => {
       const kept = current.filter(
         (op) => op.settledVersion === null || op.settledVersion > serverVersion
@@ -63,14 +63,14 @@ function useDeepAgentConfigController({
       return kept.length === current.length ? current : kept;
     });
   }, [serverVersion]);
-  const lastNotifiedRef = react.useRef(null);
-  react.useEffect(() => {
+  const lastNotifiedRef = require$$0.useRef(null);
+  require$$0.useEffect(() => {
     var _a;
     if (serverConfig === null || serverConfig === lastNotifiedRef.current) return;
     lastNotifiedRef.current = serverConfig;
     (_a = onServerConfigRef.current) == null ? void 0 : _a.call(onServerConfigRef, { version: serverConfig.version, custom });
   }, [serverConfig, custom]);
-  const run = react.useCallback(
+  const run = require$$0.useCallback(
     async (command, apply) => {
       const id = nextOpIdRef.current++;
       setOps((current) => [...current, { id, apply, settledVersion: null }]);
@@ -91,21 +91,21 @@ function useDeepAgentConfigController({
     },
     []
   );
-  const patchConfig = react.useCallback(
+  const patchConfig = require$$0.useCallback(
     (patch) => run(
       { type: runconfigContract.DEEP_AGENT_CONFIG_COMMANDS.patch, patch },
       (base) => configMutations.applyConfigPatch(base, patch)
     ),
     [run]
   );
-  const enableTools = react.useCallback(
+  const enableTools = require$$0.useCallback(
     (toolIds) => run(
       { type: runconfigContract.DEEP_AGENT_CONFIG_COMMANDS.toolsEnable, toolIds: [...toolIds] },
       (base) => configMutations.applyToolsEnable(base, toolIds)
     ),
     [run]
   );
-  const disableTools = react.useCallback(
+  const disableTools = require$$0.useCallback(
     (toolIds) => run(
       { type: runconfigContract.DEEP_AGENT_CONFIG_COMMANDS.toolsDisable, toolIds: [...toolIds] },
       (base) => configMutations.applyToolsDisable(base, toolIds)

package/dist/agent-runtime/src/use-deep-agent-config.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-deep-agent-config.cjs","sources":["../../../../agent-runtime/src/use-deep-agent-config.ts"],"sourcesContent":["import { useStatewireSendCommand, useStatewireState } from '@assistant-ui/react-statewire';\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport {\n  applyConfigPatch,\n  applyToolsDisable,\n  applyToolsEnable,\n  type ThreadConfigCustom,\n  type ThreadConfigPatch,\n} from './config-mutations';\nimport { statewireRejectionPayload } from './errors';\nimport { DEEP_AGENT_CONFIG_COMMANDS } from './generated/runconfig-contract';\nimport { readDeepAgentStateThreadId } from './statewire-state';\n\ndeclare module '@assistant-ui/core' {\n  namespace Assistant {\n    interface Commands {\n      /** Set / unset top-level keys of the thread's server config (`null` unsets). */\n      configPatch: {\n        type: typeof DEEP_AGENT_CONFIG_COMMANDS.patch;\n        patch: Record<string, unknown>;\n      };\n      /** Append ids to the thread's `enabled_tools`. */\n      configToolsEnable: {\n        type: typeof DEEP_AGENT_CONFIG_COMMANDS.toolsEnable;\n        toolIds: string[];\n      };\n      /** Remove ids from the thread's `enabled_tools`. */\n      configToolsDisable: {\n        type: typeof DEEP_AGENT_CONFIG_COMMANDS.toolsDisable;\n        toolIds: string[];\n      };\n    }\n  }\n}\n\n/**\n * The replicated `state.config` lane of a thread with server-authoritative\n * run config. Absent — and `readServerConfig` returns `null` — while the\n * thread has never been configured (version 0: a brand-new thread, or one\n * created by a client predating the lane).\n */\nexport interface DeepAgentServerConfig {\n  /** Monotonic server-incremented version; always >= 1 when the lane exists. */\n  version: number;\n  /** The thread-config keys every run on this thread uses as its base. */\n  custom: ThreadConfigCustom;\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\n/**\n * Read the server-config lane off a raw statewire state.\n *\n * Identity-preserving (returns the raw `state.config` reference), so it is\n * safe as a `useStatewireState` selector: the reference only changes when the\n * server writes the lane.\n */\nexport function readServerConfig(state: unknown): DeepAgentServerConfig | null {\n  const config = (state as { config?: unknown } | null | undefined)?.config;\n  if (!isRecord(config)) return null;\n  const version = config.version;\n  if (typeof version !== 'number' || !Number.isInteger(version) || version <= 0) return null;\n  if (!isRecord(config.custom)) return null;\n  return config as unknown as DeepAgentServerConfig;\n}\n\n/** The thread's server config version: 0 while the thread has never been configured. */\nexport function readConfigVersion(state: unknown): number {\n  return readServerConfig(state)?.version ?? 0;\n}\n\n/**\n * {@link readServerConfig}, but only from a state `threadId`'s own attach\n * produced (`readDeepAgentStateThreadId`); any other state reads as\n * unconfigured. With no `threadId` it is {@link readServerConfig} unchanged.\n *\n * Identity-preserving like {@link readServerConfig}, so it is safe as a\n * `useStatewireState` selector.\n */\nexport function readThreadServerConfig({\n  state,\n  threadId,\n}: {\n  state: unknown;\n  threadId: string | undefined;\n}): DeepAgentServerConfig | null {\n  if (threadId !== undefined && readDeepAgentStateThreadId(state) !== threadId) return null;\n  return readServerConfig(state);\n}\n\n/**\n * The 403 rejection codes a view-only collaborator's `config/*` write can\n * come back with: `config_write_forbidden` from the config host's own gate,\n * or `thread_write_forbidden` from the host-wide mutation gate that runs\n * ahead of it and refuses every thread-mutating command on a view grant.\n */\nconst CONFIG_WRITE_FORBIDDEN_CODES: ReadonlySet<string> = new Set([\n  'config_write_forbidden',\n  'thread_write_forbidden',\n]);\n\n/**\n * Whether a rejected `config/*` command was refused because the submitter\n * only has view access to the session, or because the conversation is\n * archived (`conversation_archived`, a 409: read-only until it is restored).\n * The write is not retriable by that user; hosts disable their config\n * controls.\n */\nexport function isConfigWriteForbiddenRejection(error: unknown): boolean {\n  const payload = statewireRejectionPayload(error);\n  const detail = payload?.detail as { code?: unknown } | undefined;\n  if (payload?.status === 409) return detail?.code === 'conversation_archived';\n  if (payload?.status !== 403) return false;\n  return typeof detail?.code === 'string' && CONFIG_WRITE_FORBIDDEN_CODES.has(detail.code);\n}\n\n/**\n * Whether a rejected `config/*` command was refused because the thread's\n * workspace cannot hold server config at all (`config_sync_unavailable`, a\n * regionally-pinned workspace). No write will ever succeed on the thread;\n * hosts stop issuing them and send their full config per run instead.\n */\nexport function isConfigSyncUnavailableRejection(error: unknown): boolean {\n  const payload = statewireRejectionPayload(error);\n  if (payload?.status !== 400) return false;\n  const detail = payload.detail as { code?: unknown } | undefined;\n  return detail?.code === 'config_sync_unavailable';\n}\n\n/** The settled result of a `config/*` command: the new server config. */\nexport interface DeepAgentConfigWriteResult {\n  version: number;\n  custom: ThreadConfigCustom;\n}\n\n/** An observed server-config version, delivered to the host callback. */\nexport interface DeepAgentServerConfigEvent {\n  version: number;\n  /** The server config with this client's still-pending writes folded over. */\n  custom: ThreadConfigCustom;\n}\n\ninterface PendingOp {\n  id: number;\n  apply: (custom: ThreadConfigCustom) => ThreadConfigCustom;\n  /** The version the server assigned this op; retired once the lane reaches it. */\n  settledVersion: number | null;\n}\n\n/**\n * Fold the pending optimistic ops over the server config — the effective\n * config a client shows and sends against. Pure, for the tests.\n */\nexport function foldPendingConfigOps(\n  serverConfig: DeepAgentServerConfig | null,\n  ops: readonly Pick<PendingOp, 'apply' | 'settledVersion'>[]\n): ThreadConfigCustom {\n  const version = serverConfig?.version ?? 0;\n  let custom: ThreadConfigCustom = serverConfig?.custom ?? {};\n  for (const op of ops) {\n    if (op.settledVersion !== null && op.settledVersion <= version) continue;\n    custom = op.apply(custom);\n  }\n  return custom;\n}\n\nexport interface UseDeepAgentConfigOptions {\n  /**\n   * Fired whenever the server writes a new version of the lane (another\n   * device, the seed, or the echo of our own command), with this client's\n   * still-pending writes folded over — hosts mirror it into their local\n   * store; nothing is ever clobbered because pending edits stay on top.\n   */\n  onServerConfig?: (event: DeepAgentServerConfigEvent) => void;\n  /**\n   * The thread this binding serves. When set, the lane is read only from a\n   * state that thread's own attach produced ({@link readThreadServerConfig}):\n   * for the first render after a thread switch the client still projects the\n   * previous thread's state, and adopting its lane would report the previous\n   * thread's config and version as this thread's.\n   */\n  threadId?: string;\n}\n\nexport interface UseDeepAgentConfigResult {\n  /** Reactive server config version (0 while the thread has never been configured). */\n  configVersion: number;\n  /** Reactive server-config lane, or `null` at version 0. */\n  serverConfig: DeepAgentServerConfig | null;\n  /**\n   * The effective thread config: the server lane with this client's pending\n   * writes folded over. `{}` at version 0 with nothing pending.\n   */\n  custom: ThreadConfigCustom;\n  /** `true` while at least one `config/*` command is unacknowledged by the server. */\n  hasPendingWrites: boolean;\n  /** `config/patch` — set / unset top-level keys; `null` unsets. */\n  patchConfig: (patch: ThreadConfigPatch) => Promise<DeepAgentConfigWriteResult>;\n  /** `config/tools/enable`. */\n  enableTools: (toolIds: readonly string[]) => Promise<DeepAgentConfigWriteResult>;\n  /** `config/tools/disable`. */\n  disableTools: (toolIds: readonly string[]) => Promise<DeepAgentConfigWriteResult>;\n}\n\ntype ConfigCommand =\n  | { type: typeof DEEP_AGENT_CONFIG_COMMANDS.patch; patch: Record<string, unknown> }\n  | { type: typeof DEEP_AGENT_CONFIG_COMMANDS.toolsEnable; toolIds: string[] }\n  | { type: typeof DEEP_AGENT_CONFIG_COMMANDS.toolsDisable; toolIds: string[] };\n\n/**\n * The server-authoritative thread config of a deep-agent thread.\n *\n * Every capability a run depends on — model, agent binding, enabled tools,\n * sandbox, environment, … — lives on the thread's server config lane and is\n * changed only through the `config/*` commands. Sends carry per-send keys\n * only (`pickPerSendCustom`). The commands are applied optimistically: each\n * one folds its transform over the server config the moment it is issued\n * (`custom`), and retires once the lane reaches the version the server\n * assigned it; a rejection drops it, so the UI snaps back to the truth.\n *\n * Must be mounted under the thread's statewire context (an `AuiProvider`\n * holding `useDeepAgentThread`'s element), keyed by the thread identity so a\n * thread switch remounts it with an empty pending set. A binding that persists\n * what it reads per thread passes `threadId`, so the render that still sees\n * the previous thread's state after a switch reads no lane at all.\n */\nexport function useDeepAgentConfig({\n  threadId,\n  ...options\n}: UseDeepAgentConfigOptions = {}): UseDeepAgentConfigResult {\n  const sendCommand = useStatewireSendCommand();\n  const selectServerConfig = useCallback(\n    (state: unknown) => readThreadServerConfig({ state, threadId }),\n    [threadId]\n  );\n  const serverConfig = useStatewireState(selectServerConfig);\n  return useDeepAgentConfigController({\n    serverConfig,\n    sendCommand: (command) => Promise.resolve(sendCommand(command as never)),\n    ...options,\n  });\n}\n\nexport interface DeepAgentConfigControllerInputs extends UseDeepAgentConfigOptions {\n  serverConfig: DeepAgentServerConfig | null;\n  sendCommand: (command: ConfigCommand) => Promise<unknown>;\n}\n\n/**\n * The transport-agnostic body of {@link useDeepAgentConfig}, with the reactive\n * inputs injected — so the optimistic-overlay behavior is testable without a\n * statewire session.\n */\nexport function useDeepAgentConfigController({\n  serverConfig,\n  sendCommand,\n  onServerConfig,\n}: DeepAgentConfigControllerInputs): UseDeepAgentConfigResult {\n  const [ops, setOps] = useState<readonly PendingOp[]>([]);\n  const nextOpIdRef = useRef(1);\n  const sendCommandRef = useRef(sendCommand);\n  sendCommandRef.current = sendCommand;\n  const onServerConfigRef = useRef(onServerConfig);\n  onServerConfigRef.current = onServerConfig;\n\n  const custom = useMemo(() => foldPendingConfigOps(serverConfig, ops), [serverConfig, ops]);\n\n  // Retire ops the lane has caught up with (their transform is now part of\n  // the server config itself).\n  const serverVersion = serverConfig?.version ?? 0;\n  const serverVersionRef = useRef(serverVersion);\n  serverVersionRef.current = serverVersion;\n  useEffect(() => {\n    setOps((current) => {\n      const kept = current.filter(\n        (op) => op.settledVersion === null || op.settledVersion > serverVersion\n      );\n      return kept.length === current.length ? current : kept;\n    });\n  }, [serverVersion]);\n\n  const lastNotifiedRef = useRef<DeepAgentServerConfig | null>(null);\n  useEffect(() => {\n    if (serverConfig === null || serverConfig === lastNotifiedRef.current) return;\n    lastNotifiedRef.current = serverConfig;\n    onServerConfigRef.current?.({ version: serverConfig.version, custom });\n  }, [serverConfig, custom]);\n\n  const run = useCallback(\n    async (\n      command: ConfigCommand,\n      apply: PendingOp['apply']\n    ): Promise<DeepAgentConfigWriteResult> => {\n      const id = nextOpIdRef.current++;\n      setOps((current) => [...current, { id, apply, settledVersion: null }]);\n      try {\n        const raw = (await sendCommandRef.current(command)) as\n          | { version?: unknown; custom?: unknown }\n          | null\n          | undefined;\n        const version = typeof raw?.version === 'number' ? raw.version : Number.POSITIVE_INFINITY;\n        // The lane echo may have landed before the acknowledgement: retire\n        // now if so, otherwise stamp the version for the retire effect.\n        setOps((current) =>\n          version <= serverVersionRef.current\n            ? current.filter((op) => op.id !== id)\n            : current.map((op) => (op.id === id ? { ...op, settledVersion: version } : op))\n        );\n        return {\n          version: Number.isFinite(version) ? version : 0,\n          custom: isRecord(raw?.custom) ? raw.custom : apply({}),\n        };\n      } catch (error) {\n        setOps((current) => current.filter((op) => op.id !== id));\n        throw error;\n      }\n    },\n    []\n  );\n\n  const patchConfig = useCallback(\n    (patch: ThreadConfigPatch) =>\n      run({ type: DEEP_AGENT_CONFIG_COMMANDS.patch, patch }, (base) =>\n        applyConfigPatch(base, patch)\n      ),\n    [run]\n  );\n  const enableTools = useCallback(\n    (toolIds: readonly string[]) =>\n      run({ type: DEEP_AGENT_CONFIG_COMMANDS.toolsEnable, toolIds: [...toolIds] }, (base) =>\n        applyToolsEnable(base, toolIds)\n      ),\n    [run]\n  );\n  const disableTools = useCallback(\n    (toolIds: readonly string[]) =>\n      run({ type: DEEP_AGENT_CONFIG_COMMANDS.toolsDisable, toolIds: [...toolIds] }, (base) =>\n        applyToolsDisable(base, toolIds)\n      ),\n    [run]\n  );\n\n  return {\n    configVersion: serverVersion,\n    serverConfig,\n    custom,\n    hasPendingWrites: ops.some((op) => op.settledVersion === null),\n    patchConfig,\n    enableTools,\n    disableTools,\n  };\n}\n"],"names":["statewireRejectionPayload","useState","useRef","useMemo","useEffect","useCallback","DEEP_AGENT_CONFIG_COMMANDS","applyConfigPatch","applyToolsEnable","applyToolsDisable"],"mappings":";;;;;;;AAgDA,MAAM,WAAW,CAAC,UAChB,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAS9D,SAAS,iBAAiB,OAA8C;AAC7E,QAAM,SAAU,+BAAmD;AACnE,MAAI,CAAC,SAAS,MAAM,EAAG,QAAO;AAC9B,QAAM,UAAU,OAAO;AACvB,MAAI,OAAO,YAAY,YAAY,CAAC,OAAO,UAAU,OAAO,KAAK,WAAW,EAAG,QAAO;AACtF,MAAI,CAAC,SAAS,OAAO,MAAM,EAAG,QAAO;AACrC,SAAO;AACT;AAgCA,MAAM,mDAAwD,IAAI;AAAA,EAChE;AAAA,EACA;AACF,CAAC;AASM,SAAS,gCAAgC,OAAyB;AACvE,QAAM,UAAUA,OAAAA,0BAA0B,KAAK;AAC/C,QAAM,SAAS,mCAAS;AACxB,OAAI,mCAAS,YAAW,IAAK,SAAO,iCAAQ,UAAS;AACrD,OAAI,mCAAS,YAAW,IAAK,QAAO;AACpC,SAAO,QAAO,iCAAQ,UAAS,YAAY,6BAA6B,IAAI,OAAO,IAAI;AACzF;AAQO,SAAS,iCAAiC,OAAyB;AACxE,QAAM,UAAUA,OAAAA,0BAA0B,KAAK;AAC/C,OAAI,mCAAS,YAAW,IAAK,QAAO;AACpC,QAAM,SAAS,QAAQ;AACvB,UAAO,iCAAQ,UAAS;AAC1B;AA0BO,SAAS,qBACd,cACA,KACoB;AACpB,QAAM,WAAU,6CAAc,YAAW;AACzC,MAAI,UAA6B,6CAAc,WAAU,CAAA;AACzD,aAAW,MAAM,KAAK;AACpB,QAAI,GAAG,mBAAmB,QAAQ,GAAG,kBAAkB,QAAS;AAChE,aAAS,GAAG,MAAM,MAAM;AAAA,EAC1B;AACA,SAAO;AACT;AAyFO,SAAS,6BAA6B;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AACF,GAA8D;AAC5D,QAAM,CAAC,KAAK,MAAM,IAAIC,MAAAA,SAA+B,CAAA,CAAE;AACvD,QAAM,cAAcC,MAAAA,OAAO,CAAC;AAC5B,QAAM,iBAAiBA,MAAAA,OAAO,WAAW;AACzC,iBAAe,UAAU;AACzB,QAAM,oBAAoBA,MAAAA,OAAO,cAAc;AAC/C,oBAAkB,UAAU;AAE5B,QAAM,SAASC,cAAQ,MAAM,qBAAqB,cAAc,GAAG,GAAG,CAAC,cAAc,GAAG,CAAC;AAIzF,QAAM,iBAAgB,6CAAc,YAAW;AAC/C,QAAM,mBAAmBD,MAAAA,OAAO,aAAa;AAC7C,mBAAiB,UAAU;AAC3BE,QAAAA,UAAU,MAAM;AACd,WAAO,CAAC,YAAY;AAClB,YAAM,OAAO,QAAQ;AAAA,QACnB,CAAC,OAAO,GAAG,mBAAmB,QAAQ,GAAG,iBAAiB;AAAA,MAAA;AAE5D,aAAO,KAAK,WAAW,QAAQ,SAAS,UAAU;AAAA,IACpD,CAAC;AAAA,EACH,GAAG,CAAC,aAAa,CAAC;AAElB,QAAM,kBAAkBF,MAAAA,OAAqC,IAAI;AACjEE,QAAAA,UAAU,MAAM;;AACd,QAAI,iBAAiB,QAAQ,iBAAiB,gBAAgB,QAAS;AACvE,oBAAgB,UAAU;AAC1B,4BAAkB,YAAlB,2CAA4B,EAAE,SAAS,aAAa,SAAS;EAC/D,GAAG,CAAC,cAAc,MAAM,CAAC;AAEzB,QAAM,MAAMC,MAAAA;AAAAA,IACV,OACE,SACA,UACwC;AACxC,YAAM,KAAK,YAAY;AACvB,aAAO,CAAC,YAAY,CAAC,GAAG,SAAS,EAAE,IAAI,OAAO,gBAAgB,KAAA,CAAM,CAAC;AACrE,UAAI;AACF,cAAM,MAAO,MAAM,eAAe,QAAQ,OAAO;AAIjD,cAAM,UAAU,QAAO,2BAAK,aAAY,WAAW,IAAI,UAAU,OAAO;AAGxE;AAAA,UAAO,CAAC,YACN,WAAW,iBAAiB,UACxB,QAAQ,OAAO,CAAC,OAAO,GAAG,OAAO,EAAE,IACnC,QAAQ,IAAI,CAAC,OAAQ,GAAG,OAAO,KAAK,EAAE,GAAG,IAAI,gBAAgB,QAAA,IAAY,EAAG;AAAA,QAAA;AAElF,eAAO;AAAA,UACL,SAAS,OAAO,SAAS,OAAO,IAAI,UAAU;AAAA,UAC9C,QAAQ,SAAS,2BAAK,MAAM,IAAI,IAAI,SAAS,MAAM,CAAA,CAAE;AAAA,QAAA;AAAA,MAEzD,SAAS,OAAO;AACd,eAAO,CAAC,YAAY,QAAQ,OAAO,CAAC,OAAO,GAAG,OAAO,EAAE,CAAC;AACxD,cAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,CAAA;AAAA,EAAC;AAGH,QAAM,cAAcA,MAAAA;AAAAA,IAClB,CAAC,UACC;AAAA,MAAI,EAAE,MAAMC,kBAAAA,2BAA2B,OAAO,MAAA;AAAA,MAAS,CAAC,SACtDC,iCAAiB,MAAM,KAAK;AAAA,IAAA;AAAA,IAEhC,CAAC,GAAG;AAAA,EAAA;AAEN,QAAM,cAAcF,MAAAA;AAAAA,IAClB,CAAC,YACC;AAAA,MAAI,EAAE,MAAMC,kBAAAA,2BAA2B,aAAa,SAAS,CAAC,GAAG,OAAO,EAAA;AAAA,MAAK,CAAC,SAC5EE,iCAAiB,MAAM,OAAO;AAAA,IAAA;AAAA,IAElC,CAAC,GAAG;AAAA,EAAA;AAEN,QAAM,eAAeH,MAAAA;AAAAA,IACnB,CAAC,YACC;AAAA,MAAI,EAAE,MAAMC,kBAAAA,2BAA2B,cAAc,SAAS,CAAC,GAAG,OAAO,EAAA;AAAA,MAAK,CAAC,SAC7EG,kCAAkB,MAAM,OAAO;AAAA,IAAA;AAAA,IAEnC,CAAC,GAAG;AAAA,EAAA;AAGN,SAAO;AAAA,IACL,eAAe;AAAA,IACf;AAAA,IACA;AAAA,IACA,kBAAkB,IAAI,KAAK,CAAC,OAAO,GAAG,mBAAmB,IAAI;AAAA,IAC7D;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;;;;;;"}
+{"version":3,"file":"use-deep-agent-config.cjs","sources":["../../../../agent-runtime/src/use-deep-agent-config.ts"],"sourcesContent":["import { useStatewireSendCommand, useStatewireState } from '@assistant-ui/react-statewire';\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport {\n  applyConfigPatch,\n  applyToolsDisable,\n  applyToolsEnable,\n  type ThreadConfigCustom,\n  type ThreadConfigPatch,\n} from './config-mutations';\nimport { statewireRejectionPayload } from './errors';\nimport { DEEP_AGENT_CONFIG_COMMANDS } from './generated/runconfig-contract';\nimport { readDeepAgentStateThreadId } from './statewire-state';\n\ndeclare module '@assistant-ui/core' {\n  namespace Assistant {\n    interface Commands {\n      /** Set / unset top-level keys of the thread's server config (`null` unsets). */\n      configPatch: {\n        type: typeof DEEP_AGENT_CONFIG_COMMANDS.patch;\n        patch: Record<string, unknown>;\n      };\n      /** Append ids to the thread's `enabled_tools`. */\n      configToolsEnable: {\n        type: typeof DEEP_AGENT_CONFIG_COMMANDS.toolsEnable;\n        toolIds: string[];\n      };\n      /** Remove ids from the thread's `enabled_tools`. */\n      configToolsDisable: {\n        type: typeof DEEP_AGENT_CONFIG_COMMANDS.toolsDisable;\n        toolIds: string[];\n      };\n    }\n  }\n}\n\n/**\n * The replicated `state.config` lane of a thread with server-authoritative\n * run config. Absent — and `readServerConfig` returns `null` — while the\n * thread has never been configured (version 0: a brand-new thread, or one\n * created by a client predating the lane).\n */\nexport interface DeepAgentServerConfig {\n  /** Monotonic server-incremented version; always >= 1 when the lane exists. */\n  version: number;\n  /** The thread-config keys every run on this thread uses as its base. */\n  custom: ThreadConfigCustom;\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\n/**\n * Read the server-config lane off a raw statewire state.\n *\n * Identity-preserving (returns the raw `state.config` reference), so it is\n * safe as a `useStatewireState` selector: the reference only changes when the\n * server writes the lane.\n */\nexport function readServerConfig(state: unknown): DeepAgentServerConfig | null {\n  const config = (state as { config?: unknown } | null | undefined)?.config;\n  if (!isRecord(config)) return null;\n  const version = config.version;\n  if (typeof version !== 'number' || !Number.isInteger(version) || version <= 0) return null;\n  if (!isRecord(config.custom)) return null;\n  return config as unknown as DeepAgentServerConfig;\n}\n\n/** The thread's server config version: 0 while the thread has never been configured. */\nexport function readConfigVersion(state: unknown): number {\n  return readServerConfig(state)?.version ?? 0;\n}\n\n/**\n * {@link readServerConfig}, but only from a state `threadId`'s own attach\n * produced (`readDeepAgentStateThreadId`); any other state reads as\n * unconfigured. With no `threadId` it is {@link readServerConfig} unchanged.\n *\n * Identity-preserving like {@link readServerConfig}, so it is safe as a\n * `useStatewireState` selector.\n */\nexport function readThreadServerConfig({\n  state,\n  threadId,\n}: {\n  state: unknown;\n  threadId: string | undefined;\n}): DeepAgentServerConfig | null {\n  if (threadId !== undefined && readDeepAgentStateThreadId(state) !== threadId) return null;\n  return readServerConfig(state);\n}\n\n/**\n * The 403 rejection codes a view-only collaborator's `config/*` write can\n * come back with: `config_write_forbidden` from the config host's own gate,\n * or `thread_write_forbidden` from the host-wide mutation gate that runs\n * ahead of it and refuses every thread-mutating command on a view grant.\n */\nconst CONFIG_WRITE_FORBIDDEN_CODES: ReadonlySet<string> = new Set([\n  'config_write_forbidden',\n  'thread_write_forbidden',\n]);\n\n/**\n * Whether a rejected `config/*` command was refused because the submitter\n * only has view access to the session, or because the conversation is\n * archived (`conversation_archived`, a 409: read-only until it is restored).\n * The write is not retriable by that user; hosts disable their config\n * controls.\n */\nexport function isConfigWriteForbiddenRejection(error: unknown): boolean {\n  const payload = statewireRejectionPayload(error);\n  const detail = payload?.detail as { code?: unknown } | undefined;\n  if (payload?.status === 409) return detail?.code === 'conversation_archived';\n  if (payload?.status !== 403) return false;\n  return typeof detail?.code === 'string' && CONFIG_WRITE_FORBIDDEN_CODES.has(detail.code);\n}\n\n/**\n * Whether a rejected `config/*` command was refused because the thread's\n * workspace cannot hold server config at all (`config_sync_unavailable`, a\n * regionally-pinned workspace). No write will ever succeed on the thread;\n * hosts stop issuing them and send their full config per run instead.\n */\nexport function isConfigSyncUnavailableRejection(error: unknown): boolean {\n  const payload = statewireRejectionPayload(error);\n  if (payload?.status !== 400) return false;\n  const detail = payload.detail as { code?: unknown } | undefined;\n  return detail?.code === 'config_sync_unavailable';\n}\n\n/** The settled result of a `config/*` command: the new server config. */\nexport interface DeepAgentConfigWriteResult {\n  version: number;\n  custom: ThreadConfigCustom;\n}\n\n/** An observed server-config version, delivered to the host callback. */\nexport interface DeepAgentServerConfigEvent {\n  version: number;\n  /** The server config with this client's still-pending writes folded over. */\n  custom: ThreadConfigCustom;\n}\n\ninterface PendingOp {\n  id: number;\n  apply: (custom: ThreadConfigCustom) => ThreadConfigCustom;\n  /** The version the server assigned this op; retired once the lane reaches it. */\n  settledVersion: number | null;\n}\n\n/**\n * Fold the pending optimistic ops over the server config — the effective\n * config a client shows and sends against. Pure, for the tests.\n */\nexport function foldPendingConfigOps(\n  serverConfig: DeepAgentServerConfig | null,\n  ops: readonly Pick<PendingOp, 'apply' | 'settledVersion'>[]\n): ThreadConfigCustom {\n  const version = serverConfig?.version ?? 0;\n  let custom: ThreadConfigCustom = serverConfig?.custom ?? {};\n  for (const op of ops) {\n    if (op.settledVersion !== null && op.settledVersion <= version) continue;\n    custom = op.apply(custom);\n  }\n  return custom;\n}\n\nexport interface UseDeepAgentConfigOptions {\n  /**\n   * Fired whenever the server writes a new version of the lane (another\n   * device, the seed, or the echo of our own command), with this client's\n   * still-pending writes folded over — hosts mirror it into their local\n   * store; nothing is ever clobbered because pending edits stay on top.\n   */\n  onServerConfig?: (event: DeepAgentServerConfigEvent) => void;\n  /**\n   * The thread this binding serves. When set, the lane is read only from a\n   * state that thread's own attach produced ({@link readThreadServerConfig}):\n   * for the first render after a thread switch the client still projects the\n   * previous thread's state, and adopting its lane would report the previous\n   * thread's config and version as this thread's.\n   */\n  threadId?: string;\n}\n\nexport interface UseDeepAgentConfigResult {\n  /** Reactive server config version (0 while the thread has never been configured). */\n  configVersion: number;\n  /** Reactive server-config lane, or `null` at version 0. */\n  serverConfig: DeepAgentServerConfig | null;\n  /**\n   * The effective thread config: the server lane with this client's pending\n   * writes folded over. `{}` at version 0 with nothing pending.\n   */\n  custom: ThreadConfigCustom;\n  /** `true` while at least one `config/*` command is unacknowledged by the server. */\n  hasPendingWrites: boolean;\n  /** `config/patch` — set / unset top-level keys; `null` unsets. */\n  patchConfig: (patch: ThreadConfigPatch) => Promise<DeepAgentConfigWriteResult>;\n  /** `config/tools/enable`. */\n  enableTools: (toolIds: readonly string[]) => Promise<DeepAgentConfigWriteResult>;\n  /** `config/tools/disable`. */\n  disableTools: (toolIds: readonly string[]) => Promise<DeepAgentConfigWriteResult>;\n}\n\ntype ConfigCommand =\n  | { type: typeof DEEP_AGENT_CONFIG_COMMANDS.patch; patch: Record<string, unknown> }\n  | { type: typeof DEEP_AGENT_CONFIG_COMMANDS.toolsEnable; toolIds: string[] }\n  | { type: typeof DEEP_AGENT_CONFIG_COMMANDS.toolsDisable; toolIds: string[] };\n\n/**\n * The server-authoritative thread config of a deep-agent thread.\n *\n * Every capability a run depends on — model, agent binding, enabled tools,\n * sandbox, environment, … — lives on the thread's server config lane and is\n * changed only through the `config/*` commands. Sends carry per-send keys\n * only (`pickPerSendCustom`). The commands are applied optimistically: each\n * one folds its transform over the server config the moment it is issued\n * (`custom`), and retires once the lane reaches the version the server\n * assigned it; a rejection drops it, so the UI snaps back to the truth.\n *\n * Must be mounted under the thread's statewire context (an `AuiProvider`\n * holding `useDeepAgentThread`'s element), keyed by the thread identity so a\n * thread switch remounts it with an empty pending set. A binding that persists\n * what it reads per thread passes `threadId`, so the render that still sees\n * the previous thread's state after a switch reads no lane at all.\n */\nexport function useDeepAgentConfig({\n  threadId,\n  ...options\n}: UseDeepAgentConfigOptions = {}): UseDeepAgentConfigResult {\n  const sendCommand = useStatewireSendCommand();\n  const selectServerConfig = useCallback(\n    (state: unknown) => readThreadServerConfig({ state, threadId }),\n    [threadId]\n  );\n  const serverConfig = useStatewireState(selectServerConfig);\n  return useDeepAgentConfigController({\n    serverConfig,\n    sendCommand: (command) => Promise.resolve(sendCommand(command as never)),\n    ...options,\n  });\n}\n\nexport interface DeepAgentConfigControllerInputs extends UseDeepAgentConfigOptions {\n  serverConfig: DeepAgentServerConfig | null;\n  sendCommand: (command: ConfigCommand) => Promise<unknown>;\n}\n\n/**\n * The transport-agnostic body of {@link useDeepAgentConfig}, with the reactive\n * inputs injected — so the optimistic-overlay behavior is testable without a\n * statewire session.\n */\nexport function useDeepAgentConfigController({\n  serverConfig,\n  sendCommand,\n  onServerConfig,\n}: DeepAgentConfigControllerInputs): UseDeepAgentConfigResult {\n  const [ops, setOps] = useState<readonly PendingOp[]>([]);\n  const nextOpIdRef = useRef(1);\n  const sendCommandRef = useRef(sendCommand);\n  sendCommandRef.current = sendCommand;\n  const onServerConfigRef = useRef(onServerConfig);\n  onServerConfigRef.current = onServerConfig;\n\n  const custom = useMemo(() => foldPendingConfigOps(serverConfig, ops), [serverConfig, ops]);\n\n  // Retire ops the lane has caught up with (their transform is now part of\n  // the server config itself).\n  const serverVersion = serverConfig?.version ?? 0;\n  const serverVersionRef = useRef(serverVersion);\n  serverVersionRef.current = serverVersion;\n  useEffect(() => {\n    setOps((current) => {\n      const kept = current.filter(\n        (op) => op.settledVersion === null || op.settledVersion > serverVersion\n      );\n      return kept.length === current.length ? current : kept;\n    });\n  }, [serverVersion]);\n\n  const lastNotifiedRef = useRef<DeepAgentServerConfig | null>(null);\n  useEffect(() => {\n    if (serverConfig === null || serverConfig === lastNotifiedRef.current) return;\n    lastNotifiedRef.current = serverConfig;\n    onServerConfigRef.current?.({ version: serverConfig.version, custom });\n  }, [serverConfig, custom]);\n\n  const run = useCallback(\n    async (\n      command: ConfigCommand,\n      apply: PendingOp['apply']\n    ): Promise<DeepAgentConfigWriteResult> => {\n      const id = nextOpIdRef.current++;\n      setOps((current) => [...current, { id, apply, settledVersion: null }]);\n      try {\n        const raw = (await sendCommandRef.current(command)) as\n          | { version?: unknown; custom?: unknown }\n          | null\n          | undefined;\n        const version = typeof raw?.version === 'number' ? raw.version : Number.POSITIVE_INFINITY;\n        // The lane echo may have landed before the acknowledgement: retire\n        // now if so, otherwise stamp the version for the retire effect.\n        setOps((current) =>\n          version <= serverVersionRef.current\n            ? current.filter((op) => op.id !== id)\n            : current.map((op) => (op.id === id ? { ...op, settledVersion: version } : op))\n        );\n        return {\n          version: Number.isFinite(version) ? version : 0,\n          custom: isRecord(raw?.custom) ? raw.custom : apply({}),\n        };\n      } catch (error) {\n        setOps((current) => current.filter((op) => op.id !== id));\n        throw error;\n      }\n    },\n    []\n  );\n\n  const patchConfig = useCallback(\n    (patch: ThreadConfigPatch) =>\n      run({ type: DEEP_AGENT_CONFIG_COMMANDS.patch, patch }, (base) =>\n        applyConfigPatch(base, patch)\n      ),\n    [run]\n  );\n  const enableTools = useCallback(\n    (toolIds: readonly string[]) =>\n      run({ type: DEEP_AGENT_CONFIG_COMMANDS.toolsEnable, toolIds: [...toolIds] }, (base) =>\n        applyToolsEnable(base, toolIds)\n      ),\n    [run]\n  );\n  const disableTools = useCallback(\n    (toolIds: readonly string[]) =>\n      run({ type: DEEP_AGENT_CONFIG_COMMANDS.toolsDisable, toolIds: [...toolIds] }, (base) =>\n        applyToolsDisable(base, toolIds)\n      ),\n    [run]\n  );\n\n  return {\n    configVersion: serverVersion,\n    serverConfig,\n    custom,\n    hasPendingWrites: ops.some((op) => op.settledVersion === null),\n    patchConfig,\n    enableTools,\n    disableTools,\n  };\n}\n"],"names":["statewireRejectionPayload","useState","useRef","useMemo","useEffect","useCallback","DEEP_AGENT_CONFIG_COMMANDS","applyConfigPatch","applyToolsEnable","applyToolsDisable"],"mappings":"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"}

package/dist/agent-runtime/src/use-deep-agent-edit-submit.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const store = require("@assistant-ui/store");
-const react = require("react");
+const require$$0 = require("react");
 const chatOutbox = require("./chat-outbox.cjs");
 const editCommand = require("./edit-command.cjs");
 const useDeepAgentChatOutbox = require("./use-deep-agent-chat-outbox.cjs");
@@ -10,17 +10,17 @@ function useDeepAgentMessageEditSubmit() {
   useHistoricalEditAttachments.useHistoricalEditAttachments();
   const aui = store.useAui();
   const outbox = useDeepAgentChatOutbox.useDeepAgentChatOutboxContext();
-  const outboxRef = react.useRef(outbox);
+  const outboxRef = require$$0.useRef(outbox);
   outboxRef.current = outbox;
-  const alive = react.useRef(true);
-  const submitting = react.useRef(false);
-  react.useEffect(() => {
+  const alive = require$$0.useRef(true);
+  const submitting = require$$0.useRef(false);
+  require$$0.useEffect(() => {
     alive.current = true;
     return () => {
       alive.current = false;
     };
   }, []);
-  return react.useCallback(async () => {
+  return require$$0.useCallback(async () => {
     var _a, _b, _c;
     if (submitting.current) return false;
     const composer = aui.message().composer();

package/dist/agent-runtime/src/use-deep-agent-edit-submit.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-deep-agent-edit-submit.cjs","sources":["../../../../agent-runtime/src/use-deep-agent-edit-submit.ts"],"sourcesContent":["import { useAui } from '@assistant-ui/store';\nimport type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { useCallback, useEffect, useRef } from 'react';\nimport { ChatEditUnreachableError } from './chat-outbox';\nimport { readDeepAgentStatewireExtras, resolveDeepAgentEditCommand } from './edit-command';\nimport { useDeepAgentChatOutboxContext } from './use-deep-agent-chat-outbox';\nimport { useHistoricalEditAttachments } from './use-historical-edit-attachments';\n\n/**\n * The submit handler of a message's edit composer on a deep-agent thread: the\n * edited text leaves as a `run/edit` anchored on the host's own parent of the\n * message (see `edit-command.ts`) — older pages stated first for a message at\n * or below the loaded window's edge — instead of the library's\n * converted-message anchor, which the host rejects `wrong-anchor` after a\n * chunked assistant turn and at the window edge.\n *\n * Read inside the message scope (`aui.message()`): the library's optimistic\n * fold shows the edited bubble and rewinds the visible history the moment the\n * command is dispatched, so the edit composer closes right away. Falls back\n * to the composer's own `send()` when the thread is not a statewire thread or\n * the host has not settled the message yet. Resolves `false` for an empty\n * draft, a duplicate submission, or an edit cancelled during preparation.\n *\n * While the thread's chat outbox (a host that keeps one) says Athena can't be\n * reached, it rejects with {@link ChatEditUnreachableError} and sends nothing:\n * an edit rewinds and re-runs the conversation, and statewire would replay a\n * journaled one the moment its connection returns, from a hidden window too.\n * The draft stays in the edit composer, which says why.\n */\nexport function useDeepAgentMessageEditSubmit(): () => Promise<boolean> {\n  useHistoricalEditAttachments();\n  const aui = useAui();\n  const outbox = useDeepAgentChatOutboxContext();\n  const outboxRef = useRef(outbox);\n  outboxRef.current = outbox;\n  const alive = useRef(true);\n  const submitting = useRef(false);\n  useEffect(() => {\n    alive.current = true;\n    return () => {\n      alive.current = false;\n    };\n  }, []);\n  return useCallback(async () => {\n    if (submitting.current) return false;\n    const composer = aui.message().composer();\n    const draft = composer.getState();\n    const text = draft.text.trim();\n    if (!text && draft.attachments.length === 0) return false;\n    // Read at the submit (an edit begun while Athena answered and sent after it went is refused\n    // too) and again right before anything is sent: preparing an edit can page older history in.\n    const refuseWhileUnreachable = (): void => {\n      const reachability = outboxRef.current?.reachability;\n      if (reachability && !reachability.get()) throw new ChatEditUnreachableError();\n    };\n    refuseWhileUnreachable();\n    const files: StatewireThread.FilePart[] = [];\n    const texts = text ? [text] : [];\n    // beginEdit lifts original inline images/files into completed composer\n    // attachments. The anchored command must carry those too: a text-only\n    // reconstruction silently deleted them when editing a cross-device turn.\n    for (const attachment of draft.attachments) {\n      if (attachment.status.type !== 'complete')\n        throw new Error('Wait for attachments to finish before sending your edit.');\n      for (const part of attachment.content ?? []) {\n        if (part.type === 'text') texts.push(part.text);\n        else if (part.type === 'image')\n          files.push({ type: 'file', mediaType: 'image/*', url: part.image });\n        else if (part.type === 'file')\n          files.push({\n            type: 'file',\n            mediaType: part.mimeType,\n            url: part.data,\n            ...(part.filename && { filename: part.filename }),\n          });\n        else throw new Error('This attachment cannot be edited here.');\n      }\n    }\n    submitting.current = true;\n    try {\n      const sourceId = aui.message().getState().id;\n      const readExtras = () =>\n        alive.current ? readDeepAgentStatewireExtras(aui.thread().getState().extras) : null;\n      const extras = readExtras();\n      if (extras) {\n        const preparedMetadata = extras.prepareMessageMetadata?.();\n        try {\n          const command = await resolveDeepAgentEditCommand({\n            readExtras,\n            sourceId,\n            text,\n          });\n          if (!alive.current || !composer.getState().isEditing) {\n            if (preparedMetadata) extras.discardPreparedMessageMetadata?.(preparedMetadata);\n            return false;\n          }\n          // Athena can have gone while older history was paged in: the edit stays a draft (the\n          // catch below lets its prepared metadata go).\n          refuseWhileUnreachable();\n          if (command) {\n            void Promise.resolve(\n              extras.sendCommand(\n                {\n                  ...command,\n                  message: {\n                    ...command.message,\n                    parts: [\n                      ...files,\n                      ...(texts.length\n                        ? [{ type: 'text' as const, text: texts.join('\\n\\n') }]\n                        : []),\n                    ],\n                  },\n                },\n                preparedMetadata === undefined ? undefined : { preparedMetadata },\n              ),\n            ).catch(() => undefined);\n            composer.cancel();\n            return true;\n          }\n          if (preparedMetadata && extras.sendPreparedEdit) {\n            extras.sendPreparedEdit(sourceId, preparedMetadata);\n            return true;\n          }\n        } catch (error) {\n          if (preparedMetadata) extras.discardPreparedMessageMetadata?.(preparedMetadata);\n          throw error;\n        }\n      }\n      refuseWhileUnreachable();\n      composer.send();\n      return true;\n    } finally {\n      submitting.current = false;\n    }\n  }, [aui]);\n}\n"],"names":["useHistoricalEditAttachments","useAui","useDeepAgentChatOutboxContext","useRef","useEffect","useCallback","_a","ChatEditUnreachableError","readDeepAgentStatewireExtras","resolveDeepAgentEditCommand"],"mappings":"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"}
+{"version":3,"file":"use-deep-agent-edit-submit.cjs","sources":["../../../../agent-runtime/src/use-deep-agent-edit-submit.ts"],"sourcesContent":["import { useAui } from '@assistant-ui/store';\nimport type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { useCallback, useEffect, useRef } from 'react';\nimport { ChatEditUnreachableError } from './chat-outbox';\nimport { readDeepAgentStatewireExtras, resolveDeepAgentEditCommand } from './edit-command';\nimport { useDeepAgentChatOutboxContext } from './use-deep-agent-chat-outbox';\nimport { useHistoricalEditAttachments } from './use-historical-edit-attachments';\n\n/**\n * The submit handler of a message's edit composer on a deep-agent thread: the\n * edited text leaves as a `run/edit` anchored on the host's own parent of the\n * message (see `edit-command.ts`) — older pages stated first for a message at\n * or below the loaded window's edge — instead of the library's\n * converted-message anchor, which the host rejects `wrong-anchor` after a\n * chunked assistant turn and at the window edge.\n *\n * Read inside the message scope (`aui.message()`): the library's optimistic\n * fold shows the edited bubble and rewinds the visible history the moment the\n * command is dispatched, so the edit composer closes right away. Falls back\n * to the composer's own `send()` when the thread is not a statewire thread or\n * the host has not settled the message yet. Resolves `false` for an empty\n * draft, a duplicate submission, or an edit cancelled during preparation.\n *\n * While the thread's chat outbox (a host that keeps one) says Athena can't be\n * reached, it rejects with {@link ChatEditUnreachableError} and sends nothing:\n * an edit rewinds and re-runs the conversation, and statewire would replay a\n * journaled one the moment its connection returns, from a hidden window too.\n * The draft stays in the edit composer, which says why.\n */\nexport function useDeepAgentMessageEditSubmit(): () => Promise<boolean> {\n  useHistoricalEditAttachments();\n  const aui = useAui();\n  const outbox = useDeepAgentChatOutboxContext();\n  const outboxRef = useRef(outbox);\n  outboxRef.current = outbox;\n  const alive = useRef(true);\n  const submitting = useRef(false);\n  useEffect(() => {\n    alive.current = true;\n    return () => {\n      alive.current = false;\n    };\n  }, []);\n  return useCallback(async () => {\n    if (submitting.current) return false;\n    const composer = aui.message().composer();\n    const draft = composer.getState();\n    const text = draft.text.trim();\n    if (!text && draft.attachments.length === 0) return false;\n    // Read at the submit (an edit begun while Athena answered and sent after it went is refused\n    // too) and again right before anything is sent: preparing an edit can page older history in.\n    const refuseWhileUnreachable = (): void => {\n      const reachability = outboxRef.current?.reachability;\n      if (reachability && !reachability.get()) throw new ChatEditUnreachableError();\n    };\n    refuseWhileUnreachable();\n    const files: StatewireThread.FilePart[] = [];\n    const texts = text ? [text] : [];\n    // beginEdit lifts original inline images/files into completed composer\n    // attachments. The anchored command must carry those too: a text-only\n    // reconstruction silently deleted them when editing a cross-device turn.\n    for (const attachment of draft.attachments) {\n      if (attachment.status.type !== 'complete')\n        throw new Error('Wait for attachments to finish before sending your edit.');\n      for (const part of attachment.content ?? []) {\n        if (part.type === 'text') texts.push(part.text);\n        else if (part.type === 'image')\n          files.push({ type: 'file', mediaType: 'image/*', url: part.image });\n        else if (part.type === 'file')\n          files.push({\n            type: 'file',\n            mediaType: part.mimeType,\n            url: part.data,\n            ...(part.filename && { filename: part.filename }),\n          });\n        else throw new Error('This attachment cannot be edited here.');\n      }\n    }\n    submitting.current = true;\n    try {\n      const sourceId = aui.message().getState().id;\n      const readExtras = () =>\n        alive.current ? readDeepAgentStatewireExtras(aui.thread().getState().extras) : null;\n      const extras = readExtras();\n      if (extras) {\n        const preparedMetadata = extras.prepareMessageMetadata?.();\n        try {\n          const command = await resolveDeepAgentEditCommand({\n            readExtras,\n            sourceId,\n            text,\n          });\n          if (!alive.current || !composer.getState().isEditing) {\n            if (preparedMetadata) extras.discardPreparedMessageMetadata?.(preparedMetadata);\n            return false;\n          }\n          // Athena can have gone while older history was paged in: the edit stays a draft (the\n          // catch below lets its prepared metadata go).\n          refuseWhileUnreachable();\n          if (command) {\n            void Promise.resolve(\n              extras.sendCommand(\n                {\n                  ...command,\n                  message: {\n                    ...command.message,\n                    parts: [\n                      ...files,\n                      ...(texts.length\n                        ? [{ type: 'text' as const, text: texts.join('\\n\\n') }]\n                        : []),\n                    ],\n                  },\n                },\n                preparedMetadata === undefined ? undefined : { preparedMetadata },\n              ),\n            ).catch(() => undefined);\n            composer.cancel();\n            return true;\n          }\n          if (preparedMetadata && extras.sendPreparedEdit) {\n            extras.sendPreparedEdit(sourceId, preparedMetadata);\n            return true;\n          }\n        } catch (error) {\n          if (preparedMetadata) extras.discardPreparedMessageMetadata?.(preparedMetadata);\n          throw error;\n        }\n      }\n      refuseWhileUnreachable();\n      composer.send();\n      return true;\n    } finally {\n      submitting.current = false;\n    }\n  }, [aui]);\n}\n"],"names":["useHistoricalEditAttachments","useAui","useDeepAgentChatOutboxContext","useRef","useEffect","useCallback","_a","ChatEditUnreachableError","readDeepAgentStatewireExtras","resolveDeepAgentEditCommand"],"mappings":"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"}

package/dist/agent-runtime/src/use-deep-agent-runtime.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const react = require("react");
+const require$$0 = require("react");
 const errors = require("./errors.cjs");
 const modelContext = require("./model-context.cjs");
 const quotaSafeLocalStorageSession = require("./quota-safe-local-storage-session.cjs");
@@ -55,31 +55,34 @@ function useDeepAgentRuntime(options) {
     session = false,
     useClient,
     runConfig,
+    onBeforeSendRetry,
     onError,
     onStateChange,
     onCommandChange,
     ...threadOptions
   } = options;
-  const [canPersistLocalSession] = react.useState(canPersistDeepAgentSession);
-  const onErrorRef = react.useRef(onError);
+  const [canPersistLocalSession] = require$$0.useState(canPersistDeepAgentSession);
+  const onErrorRef = require$$0.useRef(onError);
   onErrorRef.current = onError;
-  const surfaceRef = react.useRef(surface);
+  const surfaceRef = require$$0.useRef(surface);
   surfaceRef.current = surface;
-  const onStateChangeRef = react.useRef(onStateChange);
+  const onStateChangeRef = require$$0.useRef(onStateChange);
   onStateChangeRef.current = onStateChange;
-  const onCommandChangeRef = react.useRef(onCommandChange);
+  const onCommandChangeRef = require$$0.useRef(onCommandChange);
   onCommandChangeRef.current = onCommandChange;
-  const diagnosticsRef = react.useRef(threadOptions.diagnostics);
+  const diagnosticsRef = require$$0.useRef(threadOptions.diagnostics);
   diagnosticsRef.current = threadOptions.diagnostics;
-  const clientRef = react.useRef(null);
-  const failureStampsRef = react.useRef(
+  const onBeforeSendRetryRef = require$$0.useRef(onBeforeSendRetry);
+  onBeforeSendRetryRef.current = onBeforeSendRetry;
+  const clientRef = require$$0.useRef(null);
+  const failureStampsRef = require$$0.useRef(
     void 0
   );
   failureStampsRef.current = session === false || session.kind === "pending" ? void 0 : session.kind === "local-storage" ? canPersistLocalSession ? () => quotaSafeLocalStorageSession.readPersistedFailedSendStamps(session.key(threadOptions.threadId)) : void 0 : () => quotaSafeLocalStorageSession.readFailedSendStampsFromRecord(loadSessionRecord(session.store));
   const sessionPending = session !== false && session.kind === "pending";
   const attachKey = sessionPending ? pendingSessionAttachKey(threadOptions.attachKey) : threadOptions.attachKey;
   const laneKey = session !== false && session.kind === "local-storage" ? session.key : null;
-  const [laneEpochState, setLaneEpochState] = react.useState(
+  const [laneEpochState, setLaneEpochState] = require$$0.useState(
     () => sessionLaneScope.nextSessionLaneEpoch({
       previous: sessionLaneScope.INITIAL_SESSION_LANE_EPOCH,
       threadId: threadOptions.threadId,
@@ -94,7 +97,7 @@ function useDeepAgentRuntime(options) {
   if (nextLaneEpochState !== laneEpochState) setLaneEpochState(nextLaneEpochState);
   const laneEpoch = nextLaneEpochState.epoch;
   const attachId = useDeepAgentThread.deepAgentAttachId({ threadId: threadOptions.threadId, attachKey, laneEpoch });
-  const sendRecovery$1 = react.useMemo(
+  const sendRecovery$1 = require$$0.useMemo(
     () => sendRecovery.createDeepAgentSendRecovery({
       lane: () => {
         const client2 = clientRef.current;
@@ -105,12 +108,16 @@ function useDeepAgentRuntime(options) {
         var _a;
         return ((_a = failureStampsRef.current) == null ? void 0 : _a.call(failureStampsRef)) ?? null;
       },
-      diagnostics: () => diagnosticsRef.current
+      diagnostics: () => diagnosticsRef.current,
+      beforeRetry: (messageId) => {
+        var _a;
+        return (_a = onBeforeSendRetryRef.current) == null ? void 0 : _a.call(onBeforeSendRetryRef, messageId);
+      }
     }),
     [attachId]
   );
-  react.useEffect(() => () => sendRecovery$1.dispose(), [sendRecovery$1]);
-  const sendRecoveryRef = react.useRef(sendRecovery$1);
+  require$$0.useEffect(() => () => sendRecovery$1.dispose(), [sendRecovery$1]);
+  const sendRecoveryRef = require$$0.useRef(sendRecovery$1);
   sendRecoveryRef.current = sendRecovery$1;
   const thread = useDeepAgentThread.useDeepAgentThread({
     ...threadOptions,
@@ -158,22 +165,33 @@ function useDeepAgentRuntime(options) {
   });
   const client = useClient(thread);
   clientRef.current = client;
-  react.useEffect(() => {
+  require$$0.useEffect(() => {
     const unsubscribe = client.subscribe(() => sendRecovery$1.observeFailedLaneChange());
     sendRecovery$1.observeFailedLaneChange();
     return unsubscribe;
   }, [client, sendRecovery$1]);
-  const getRunConfigRef = react.useRef(runConfig == null ? void 0 : runConfig.get);
+  const getRunConfigRef = require$$0.useRef(runConfig == null ? void 0 : runConfig.get);
   getRunConfigRef.current = runConfig == null ? void 0 : runConfig.get;
   const hasRunConfig = runConfig !== void 0;
   const runConfigKey = runConfig == null ? void 0 : runConfig.key;
-  react.useEffect(() => {
+  const subscribeRunConfigRef = require$$0.useRef(runConfig == null ? void 0 : runConfig.subscribe);
+  subscribeRunConfigRef.current = runConfig == null ? void 0 : runConfig.subscribe;
+  const hasRunConfigSubscribe = (runConfig == null ? void 0 : runConfig.subscribe) !== void 0;
+  require$$0.useEffect(() => {
     if (!hasRunConfig) return void 0;
-    return modelContext.registerDeepAgentRunConfig(client, () => {
-      var _a;
-      return ((_a = getRunConfigRef.current) == null ? void 0 : _a.call(getRunConfigRef)) ?? {};
-    });
-  }, [client, hasRunConfig, runConfigKey]);
+    return modelContext.registerDeepAgentRunConfig(
+      client,
+      () => {
+        var _a;
+        return ((_a = getRunConfigRef.current) == null ? void 0 : _a.call(getRunConfigRef)) ?? {};
+      },
+      hasRunConfigSubscribe ? (listener) => {
+        var _a;
+        return ((_a = subscribeRunConfigRef.current) == null ? void 0 : _a.call(subscribeRunConfigRef, listener)) ?? (() => {
+        });
+      } : void 0
+    );
+  }, [client, hasRunConfig, runConfigKey, hasRunConfigSubscribe]);
   return client;
 }
 exports.canPersistDeepAgentSession = canPersistDeepAgentSession;