@athenaintel/react 0.28.1 → 0.32.0

package/dist/{packages/agent-runtime → agent-runtime}/src/use-conversation-list.js

@@ -1,6 +1,6 @@
 import { useQueryClient, useQuery, useInfiniteQuery } from "@tanstack/react-query";
 import { useRef, useMemo, useCallback } from "react";
-import { normalizeConversationListFilter, conversationListFilterKey, conversationListQueryKeys, CONVERSATION_LIST_DEFAULT_SCOPE_KEY, mergeConversationPages, invalidateConversationListCaches, prependConversationToPage, removeConversationFromPage, patchConversationsInPage } from "./conversation-list.js";
+import { CONVERSATION_LIST_DEFAULT_SCOPE_KEY, normalizeConversationListFilter, conversationListFilterKey, conversationListQueryKeys, mergeConversationPages, invalidateConversationListCaches, prependConversationToPage, removeConversationFromPage, patchConversationsInPage } from "./conversation-list.js";
 const DEFAULT_PAGE_SIZE = 20;
 const DEFAULT_STALE_TIME_MS = 3e4;
 const DEFAULT_GC_TIME_MS = 10 * 60 * 1e3;
@@ -18,7 +18,7 @@ function useConversationList(options) {
     refetchInterval = false,
     retry
   } = options;
-  const queryClient = useQueryClient();
+  const queryClient = useQueryClient(options.queryClient);
   const fetchPageRef = useRef(options.fetchPage);
   fetchPageRef.current = options.fetchPage;
   const normalizedFilter = normalizeConversationListFilter(filter ?? {});
@@ -37,27 +37,38 @@ function useConversationList(options) {
     ...refetchOnWindowFocus !== void 0 ? { refetchOnWindowFocus } : {},
     ...retry !== void 0 ? { retry } : {}
   };
-  const firstPage = useQuery({
-    queryKey: firstPageKey,
-    queryFn: ({ signal }) => fetchPageRef.current({ limit: pageSize, offset: 0, filter: normalizedFilter, signal }),
-    staleTime,
-    gcTime,
-    refetchInterval,
-    ...passthrough
-  });
-  const history = useInfiniteQuery({
-    queryKey: historyKey,
-    initialPageParam: pageSize,
-    gcTime,
-    queryFn: ({ pageParam, signal }) => fetchPageRef.current({ limit: pageSize, offset: pageParam, filter: normalizedFilter, signal }),
-    getNextPageParam: (lastPage, _allPages, lastOffset) => lastPage.hasMore ? lastOffset + pageSize : void 0,
-    ...passthrough,
-    // fetchNextPage/refetch still perform explicit fetches for disabled
-    // queries. Keeping this observer disabled prevents focus, invalidation,
-    // and polling from replaying every retained historical page. This must
-    // win over `passthrough.enabled`, so it is spread last.
-    enabled: false
-  });
+  const firstPage = useQuery(
+    {
+      queryKey: firstPageKey,
+      queryFn: ({ signal }) => fetchPageRef.current({ limit: pageSize, offset: 0, filter: normalizedFilter, signal }),
+      staleTime,
+      gcTime,
+      refetchInterval,
+      ...passthrough
+    },
+    queryClient
+  );
+  const history = useInfiniteQuery(
+    {
+      queryKey: historyKey,
+      initialPageParam: pageSize,
+      gcTime,
+      queryFn: ({ pageParam, signal }) => fetchPageRef.current({
+        limit: pageSize,
+        offset: pageParam,
+        filter: normalizedFilter,
+        signal
+      }),
+      getNextPageParam: (lastPage, _allPages, lastOffset) => lastPage.hasMore ? lastOffset + pageSize : void 0,
+      ...passthrough,
+      // fetchNextPage/refetch still perform explicit fetches for disabled
+      // queries. Keeping this observer disabled prevents focus, invalidation,
+      // and polling from replaying every retained historical page. This must
+      // win over `passthrough.enabled`, so it is spread last.
+      enabled: false
+    },
+    queryClient
+  );
   const historyPages = (_a = history.data) == null ? void 0 : _a.pages;
   const hasLoadedHistory = ((historyPages == null ? void 0 : historyPages.length) ?? 0) > 0;
   const conversations = useMemo(

package/dist/agent-runtime/src/use-conversation-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversation-list.js","sources":["../../../../agent-runtime/src/use-conversation-list.ts"],"sourcesContent":["import {\n  type InfiniteData,\n  type QueryClient,\n  useInfiniteQuery,\n  useQuery,\n  useQueryClient,\n} from '@tanstack/react-query';\nimport { useCallback, useMemo, useRef } from 'react';\nimport {\n  CONVERSATION_LIST_DEFAULT_SCOPE_KEY,\n  type ConversationListFetcher,\n  type ConversationListFilter,\n  type ConversationListPage,\n  type ConversationSummary,\n  conversationListFilterKey,\n  conversationListQueryKeys,\n  invalidateConversationListCaches,\n  mergeConversationPages,\n  normalizeConversationListFilter,\n  patchConversationsInPage,\n  prependConversationToPage,\n  removeConversationFromPage,\n} from './conversation-list';\n\nconst DEFAULT_PAGE_SIZE = 20;\nconst DEFAULT_STALE_TIME_MS = 30_000;\nconst DEFAULT_GC_TIME_MS = 10 * 60 * 1000;\n\nexport interface UseConversationListOptions {\n  /**\n   * Transport adapter for one page (GraphQL `listConversations`, the REST\n   * thread list, …). Captured in a ref — identity changes do not re-key the\n   * cache, so pair a changing fetcher with a changing `scopeKey`.\n   */\n  fetchPage: ConversationListFetcher;\n  filter?: ConversationListFilter;\n  pageSize?: number;\n  /**\n   * Cache identity beyond the filter. MUST include everything that changes\n   * whose list this is — principal/user id, backend base URL — so a\n   * credential swap can never serve another identity's rows from the cache.\n   */\n  scopeKey?: string;\n  enabled?: boolean;\n  staleTime?: number;\n  gcTime?: number;\n  refetchOnMount?: boolean | 'always';\n  refetchOnWindowFocus?: boolean;\n  /**\n   * Newest-page freshness is push-based by default (the conversation-index\n   * statewire invalidates these caches), so no timer runs unless asked.\n   */\n  refetchInterval?: number | false;\n  retry?: boolean | number | ((failureCount: number, error: Error) => boolean);\n  /**\n   * The client to cache in. Defaults to the one in context; a hook that may\n   * render outside any `QueryClientProvider` (and stays disabled there)\n   * passes its own.\n   */\n  queryClient?: QueryClient;\n}\n\nexport interface ConversationListController {\n  /** Merged newest-first rows: live first page + retained history pages. */\n  conversations: ConversationSummary[];\n  /** Advisory total from the live first page, when the transport counts. */\n  totalCount: number | null;\n  isLoading: boolean;\n  isFetching: boolean;\n  /** True once the live first page has resolved at least once. */\n  hasResolvedFirstPage: boolean;\n  hasNextPage: boolean;\n  isFetchingNextPage: boolean;\n  /** True while the last next-page request failed (cleared by a successful one). */\n  isFetchNextPageError: boolean;\n  fetchNextPage: () => Promise<unknown>;\n  /** Refetch the live first page (history pages stay frozen). */\n  refresh: () => Promise<unknown>;\n  /** Invalidate every conversation-list cache in this scope (all filters). */\n  invalidate: () => Promise<void>;\n  /** Optimistically show a new conversation at the top of THIS filter view. */\n  prependConversation: (item: ConversationSummary) => void;\n  /** Optimistically drop a conversation from THIS filter view. */\n  removeConversation: (threadId: string) => void;\n  /** Optimistically patch a conversation's row in THIS filter view. */\n  patchConversation: (threadId: string, patch: Partial<ConversationSummary>) => void;\n}\n\n/**\n * The shared headless conversation-list pager (chat-stack unification —\n * thread-list-contract-convergence).\n *\n * Implements, once, the two-tier TanStack Query pattern Olympus and mobile\n * each hand-rolled:\n *\n * - a LIVE first-page query — the only observer that refetches on\n *   invalidation/focus, so push-driven freshness costs one page, and\n * - a permanently-disabled infinite \"history\" query whose pages are fetched\n *   only by explicit `fetchNextPage()` calls and retained without replay\n *   (invalidation/polling never refetches every loaded page).\n *\n * Rows merge newest-first with the live page winning duplicate threads.\n */\nexport function useConversationList(options: UseConversationListOptions): ConversationListController {\n  const {\n    filter,\n    pageSize = DEFAULT_PAGE_SIZE,\n    scopeKey = CONVERSATION_LIST_DEFAULT_SCOPE_KEY,\n    enabled,\n    staleTime = DEFAULT_STALE_TIME_MS,\n    gcTime = DEFAULT_GC_TIME_MS,\n    refetchOnMount,\n    refetchOnWindowFocus,\n    refetchInterval = false,\n    retry,\n  } = options;\n  const queryClient = useQueryClient(options.queryClient);\n\n  const fetchPageRef = useRef(options.fetchPage);\n  fetchPageRef.current = options.fetchPage;\n\n  // The normalized filter is both the cache identity (via the key) and what\n  // queryFn closures fetch, so a cache entry holds exactly what it claims —\n  // fresh-but-equal filter objects from the caller never re-key or refetch.\n  // (Plain per-render values: only the serialized key participates in\n  // identity, so object freshness here is irrelevant.)\n  const normalizedFilter = normalizeConversationListFilter(filter ?? {});\n  const filterKey = conversationListFilterKey(normalizedFilter);\n\n  const firstPageKey = useMemo(\n    () => conversationListQueryKeys.firstPage(scopeKey, filterKey, pageSize),\n    [scopeKey, filterKey, pageSize]\n  );\n  const historyKey = useMemo(\n    () => conversationListQueryKeys.history(scopeKey, filterKey, pageSize),\n    [scopeKey, filterKey, pageSize]\n  );\n\n  // React Query merges per-query options OVER the client's defaultOptions with\n  // Object.assign, which copies explicitly-`undefined` keys — so passing\n  // `refetchOnWindowFocus: undefined` CLOBBERS a consumer's\n  // `refetchOnWindowFocus: false` default and silently re-enables focus\n  // refetching. Options the caller did not set must therefore be omitted, not\n  // forwarded as undefined, so they fall through to the consuming app's client.\n  const passthrough = {\n    ...(enabled !== undefined ? { enabled } : {}),\n    ...(refetchOnMount !== undefined ? { refetchOnMount } : {}),\n    ...(refetchOnWindowFocus !== undefined ? { refetchOnWindowFocus } : {}),\n    ...(retry !== undefined ? { retry } : {}),\n  };\n\n  const firstPage = useQuery(\n    {\n      queryKey: firstPageKey,\n      queryFn: ({ signal }) =>\n        fetchPageRef.current({ limit: pageSize, offset: 0, filter: normalizedFilter, signal }),\n      staleTime,\n      gcTime,\n      refetchInterval,\n      ...passthrough,\n    },\n    queryClient\n  );\n\n  const history = useInfiniteQuery(\n    {\n      queryKey: historyKey,\n      initialPageParam: pageSize,\n      gcTime,\n      queryFn: ({ pageParam, signal }) =>\n        fetchPageRef.current({\n          limit: pageSize,\n          offset: pageParam,\n          filter: normalizedFilter,\n          signal,\n        }),\n      getNextPageParam: (lastPage, _allPages, lastOffset) =>\n        lastPage.hasMore ? lastOffset + pageSize : undefined,\n      ...passthrough,\n      // fetchNextPage/refetch still perform explicit fetches for disabled\n      // queries. Keeping this observer disabled prevents focus, invalidation,\n      // and polling from replaying every retained historical page. This must\n      // win over `passthrough.enabled`, so it is spread last.\n      enabled: false,\n    },\n    queryClient\n  );\n\n  const historyPages = history.data?.pages;\n  const hasLoadedHistory = (historyPages?.length ?? 0) > 0;\n\n  const conversations = useMemo(\n    () =>\n      mergeConversationPages([\n        ...(firstPage.data ? [firstPage.data] : []),\n        ...(historyPages ?? []),\n      ]),\n    [firstPage.data, historyPages]\n  );\n\n  const fetchNextHistoryPage = history.fetchNextPage;\n  const refetchHistoryFirstPage = history.refetch;\n  const fetchNextPage = useCallback(\n    () => (hasLoadedHistory ? fetchNextHistoryPage() : refetchHistoryFirstPage()),\n    [hasLoadedHistory, fetchNextHistoryPage, refetchHistoryFirstPage]\n  );\n\n  const refresh = useCallback(() => firstPage.refetch(), [firstPage.refetch]);\n\n  const invalidate = useCallback(\n    () => invalidateConversationListCaches(queryClient, { scopeKey }),\n    [queryClient, scopeKey]\n  );\n\n  const prependConversation = useCallback(\n    (item: ConversationSummary) => {\n      queryClient.setQueryData<ConversationListPage>(firstPageKey, (page) =>\n        page ? prependConversationToPage(page, item) : page\n      );\n    },\n    [queryClient, firstPageKey]\n  );\n\n  const removeConversation = useCallback(\n    (threadId: string) => {\n      queryClient.setQueryData<ConversationListPage>(firstPageKey, (page) =>\n        page ? removeConversationFromPage(page, threadId) : page\n      );\n      queryClient.setQueryData<InfiniteData<ConversationListPage, number>>(historyKey, (data) =>\n        data\n          ? { ...data, pages: data.pages.map((page) => removeConversationFromPage(page, threadId)) }\n          : data\n      );\n    },\n    [queryClient, firstPageKey, historyKey]\n  );\n\n  const patchConversation = useCallback(\n    (threadId: string, patch: Partial<ConversationSummary>) => {\n      const match = (item: ConversationSummary) => item.threadId === threadId;\n      queryClient.setQueryData<ConversationListPage>(firstPageKey, (page) =>\n        page ? patchConversationsInPage(page, match, patch) : page\n      );\n      queryClient.setQueryData<InfiniteData<ConversationListPage, number>>(historyKey, (data) =>\n        data\n          ? {\n              ...data,\n              pages: data.pages.map((page) => patchConversationsInPage(page, match, patch)),\n            }\n          : data\n      );\n    },\n    [queryClient, firstPageKey, historyKey]\n  );\n\n  return {\n    conversations,\n    totalCount: firstPage.data?.totalCount ?? null,\n    isLoading: firstPage.isLoading,\n    isFetching: firstPage.isFetching || history.isFetching,\n    hasResolvedFirstPage: firstPage.data !== undefined,\n    hasNextPage: hasLoadedHistory\n      ? (history.hasNextPage ?? false)\n      : (firstPage.data?.hasMore ?? false),\n    isFetchingNextPage: history.isFetchingNextPage || (!hasLoadedHistory && history.isFetching),\n    isFetchNextPageError: history.isError,\n    fetchNextPage,\n    refresh,\n    invalidate,\n    prependConversation,\n    removeConversation,\n    patchConversation,\n  };\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("@assistant-ui/react-statewire");
+const react = require("react");
+const configMutations = require("./config-mutations.cjs");
+const errors = require("./errors.cjs");
+const runconfigContract = require("./generated/runconfig-contract.cjs");
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function readServerConfig(state) {
+  const config = state == null ? void 0 : state.config;
+  if (!isRecord(config)) return null;
+  const version = config.version;
+  if (typeof version !== "number" || !Number.isInteger(version) || version <= 0) return null;
+  if (!isRecord(config.custom)) return null;
+  return config;
+}
+const CONFIG_WRITE_FORBIDDEN_CODES = /* @__PURE__ */ new Set([
+  "config_write_forbidden",
+  "thread_write_forbidden"
+]);
+function isConfigWriteForbiddenRejection(error) {
+  const payload = errors.statewireRejectionPayload(error);
+  if ((payload == null ? void 0 : payload.status) !== 403) return false;
+  const detail = payload.detail;
+  return typeof (detail == null ? void 0 : detail.code) === "string" && CONFIG_WRITE_FORBIDDEN_CODES.has(detail.code);
+}
+function isConfigSyncUnavailableRejection(error) {
+  const payload = errors.statewireRejectionPayload(error);
+  if ((payload == null ? void 0 : payload.status) !== 400) return false;
+  const detail = payload.detail;
+  return (detail == null ? void 0 : detail.code) === "config_sync_unavailable";
+}
+function foldPendingConfigOps(serverConfig, ops) {
+  const version = (serverConfig == null ? void 0 : serverConfig.version) ?? 0;
+  let custom = (serverConfig == null ? void 0 : serverConfig.custom) ?? {};
+  for (const op of ops) {
+    if (op.settledVersion !== null && op.settledVersion <= version) continue;
+    custom = op.apply(custom);
+  }
+  return custom;
+}
+function useDeepAgentConfigController({
+  serverConfig,
+  sendCommand,
+  onServerConfig
+}) {
+  const [ops, setOps] = react.useState([]);
+  const nextOpIdRef = react.useRef(1);
+  const sendCommandRef = react.useRef(sendCommand);
+  sendCommandRef.current = sendCommand;
+  const onServerConfigRef = react.useRef(onServerConfig);
+  onServerConfigRef.current = onServerConfig;
+  const custom = react.useMemo(() => foldPendingConfigOps(serverConfig, ops), [serverConfig, ops]);
+  const serverVersion = (serverConfig == null ? void 0 : serverConfig.version) ?? 0;
+  const serverVersionRef = react.useRef(serverVersion);
+  serverVersionRef.current = serverVersion;
+  react.useEffect(() => {
+    setOps((current) => {
+      const kept = current.filter(
+        (op) => op.settledVersion === null || op.settledVersion > serverVersion
+      );
+      return kept.length === current.length ? current : kept;
+    });
+  }, [serverVersion]);
+  const lastNotifiedRef = react.useRef(null);
+  react.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(
+    async (command, apply) => {
+      const id = nextOpIdRef.current++;
+      setOps((current) => [...current, { id, apply, settledVersion: null }]);
+      try {
+        const raw = await sendCommandRef.current(command);
+        const version = typeof (raw == null ? void 0 : raw.version) === "number" ? raw.version : Number.POSITIVE_INFINITY;
+        setOps(
+          (current) => version <= serverVersionRef.current ? current.filter((op) => op.id !== id) : current.map((op) => op.id === id ? { ...op, settledVersion: version } : op)
+        );
+        return {
+          version: Number.isFinite(version) ? version : 0,
+          custom: isRecord(raw == null ? void 0 : raw.custom) ? raw.custom : apply({})
+        };
+      } catch (error) {
+        setOps((current) => current.filter((op) => op.id !== id));
+        throw error;
+      }
+    },
+    []
+  );
+  const patchConfig = react.useCallback(
+    (patch) => run(
+      { type: runconfigContract.DEEP_AGENT_CONFIG_COMMANDS.patch, patch },
+      (base) => configMutations.applyConfigPatch(base, patch)
+    ),
+    [run]
+  );
+  const enableTools = react.useCallback(
+    (toolIds) => run(
+      { type: runconfigContract.DEEP_AGENT_CONFIG_COMMANDS.toolsEnable, toolIds: [...toolIds] },
+      (base) => configMutations.applyToolsEnable(base, toolIds)
+    ),
+    [run]
+  );
+  const disableTools = react.useCallback(
+    (toolIds) => run(
+      { type: runconfigContract.DEEP_AGENT_CONFIG_COMMANDS.toolsDisable, toolIds: [...toolIds] },
+      (base) => configMutations.applyToolsDisable(base, toolIds)
+    ),
+    [run]
+  );
+  return {
+    configVersion: serverVersion,
+    serverConfig,
+    custom,
+    hasPendingWrites: ops.some((op) => op.settledVersion === null),
+    patchConfig,
+    enableTools,
+    disableTools
+  };
+}
+exports.foldPendingConfigOps = foldPendingConfigOps;
+exports.isConfigSyncUnavailableRejection = isConfigSyncUnavailableRejection;
+exports.isConfigWriteForbiddenRejection = isConfigWriteForbiddenRejection;
+exports.readServerConfig = readServerConfig;
+exports.useDeepAgentConfigController = useDeepAgentConfigController;
+//# sourceMappingURL=use-deep-agent-config.cjs.map

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

@@ -0,0 +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. The write is not retriable by that\n * user; hosts disable their config controls.\n */\nexport function isConfigWriteForbiddenRejection(error: unknown): boolean {\n  const payload = statewireRejectionPayload(error);\n  if (payload?.status !== 403) return false;\n  const detail = payload.detail as { code?: unknown } | undefined;\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-config.js

@@ -0,0 +1,129 @@
+import "@assistant-ui/react-statewire";
+import { useState, useRef, useMemo, useEffect, useCallback } from "react";
+import { applyConfigPatch, applyToolsEnable, applyToolsDisable } from "./config-mutations.js";
+import { statewireRejectionPayload } from "./errors.js";
+import { DEEP_AGENT_CONFIG_COMMANDS } from "./generated/runconfig-contract.js";
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function readServerConfig(state) {
+  const config = state == null ? void 0 : state.config;
+  if (!isRecord(config)) return null;
+  const version = config.version;
+  if (typeof version !== "number" || !Number.isInteger(version) || version <= 0) return null;
+  if (!isRecord(config.custom)) return null;
+  return config;
+}
+const CONFIG_WRITE_FORBIDDEN_CODES = /* @__PURE__ */ new Set([
+  "config_write_forbidden",
+  "thread_write_forbidden"
+]);
+function isConfigWriteForbiddenRejection(error) {
+  const payload = statewireRejectionPayload(error);
+  if ((payload == null ? void 0 : payload.status) !== 403) return false;
+  const detail = payload.detail;
+  return typeof (detail == null ? void 0 : detail.code) === "string" && CONFIG_WRITE_FORBIDDEN_CODES.has(detail.code);
+}
+function isConfigSyncUnavailableRejection(error) {
+  const payload = statewireRejectionPayload(error);
+  if ((payload == null ? void 0 : payload.status) !== 400) return false;
+  const detail = payload.detail;
+  return (detail == null ? void 0 : detail.code) === "config_sync_unavailable";
+}
+function foldPendingConfigOps(serverConfig, ops) {
+  const version = (serverConfig == null ? void 0 : serverConfig.version) ?? 0;
+  let custom = (serverConfig == null ? void 0 : serverConfig.custom) ?? {};
+  for (const op of ops) {
+    if (op.settledVersion !== null && op.settledVersion <= version) continue;
+    custom = op.apply(custom);
+  }
+  return custom;
+}
+function useDeepAgentConfigController({
+  serverConfig,
+  sendCommand,
+  onServerConfig
+}) {
+  const [ops, setOps] = useState([]);
+  const nextOpIdRef = useRef(1);
+  const sendCommandRef = useRef(sendCommand);
+  sendCommandRef.current = sendCommand;
+  const onServerConfigRef = useRef(onServerConfig);
+  onServerConfigRef.current = onServerConfig;
+  const custom = useMemo(() => foldPendingConfigOps(serverConfig, ops), [serverConfig, ops]);
+  const serverVersion = (serverConfig == null ? void 0 : serverConfig.version) ?? 0;
+  const serverVersionRef = useRef(serverVersion);
+  serverVersionRef.current = serverVersion;
+  useEffect(() => {
+    setOps((current) => {
+      const kept = current.filter(
+        (op) => op.settledVersion === null || op.settledVersion > serverVersion
+      );
+      return kept.length === current.length ? current : kept;
+    });
+  }, [serverVersion]);
+  const lastNotifiedRef = useRef(null);
+  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 = useCallback(
+    async (command, apply) => {
+      const id = nextOpIdRef.current++;
+      setOps((current) => [...current, { id, apply, settledVersion: null }]);
+      try {
+        const raw = await sendCommandRef.current(command);
+        const version = typeof (raw == null ? void 0 : raw.version) === "number" ? raw.version : Number.POSITIVE_INFINITY;
+        setOps(
+          (current) => version <= serverVersionRef.current ? current.filter((op) => op.id !== id) : current.map((op) => op.id === id ? { ...op, settledVersion: version } : op)
+        );
+        return {
+          version: Number.isFinite(version) ? version : 0,
+          custom: isRecord(raw == null ? void 0 : raw.custom) ? raw.custom : apply({})
+        };
+      } catch (error) {
+        setOps((current) => current.filter((op) => op.id !== id));
+        throw error;
+      }
+    },
+    []
+  );
+  const patchConfig = useCallback(
+    (patch) => run(
+      { type: DEEP_AGENT_CONFIG_COMMANDS.patch, patch },
+      (base) => applyConfigPatch(base, patch)
+    ),
+    [run]
+  );
+  const enableTools = useCallback(
+    (toolIds) => run(
+      { type: DEEP_AGENT_CONFIG_COMMANDS.toolsEnable, toolIds: [...toolIds] },
+      (base) => applyToolsEnable(base, toolIds)
+    ),
+    [run]
+  );
+  const disableTools = useCallback(
+    (toolIds) => run(
+      { type: DEEP_AGENT_CONFIG_COMMANDS.toolsDisable, toolIds: [...toolIds] },
+      (base) => applyToolsDisable(base, toolIds)
+    ),
+    [run]
+  );
+  return {
+    configVersion: serverVersion,
+    serverConfig,
+    custom,
+    hasPendingWrites: ops.some((op) => op.settledVersion === null),
+    patchConfig,
+    enableTools,
+    disableTools
+  };
+}
+export {
+  foldPendingConfigOps,
+  isConfigSyncUnavailableRejection,
+  isConfigWriteForbiddenRejection,
+  readServerConfig,
+  useDeepAgentConfigController
+};
+//# sourceMappingURL=use-deep-agent-config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-deep-agent-config.js","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. The write is not retriable by that\n * user; hosts disable their config controls.\n */\nexport function isConfigWriteForbiddenRejection(error: unknown): boolean {\n  const payload = statewireRejectionPayload(error);\n  if (payload?.status !== 403) return false;\n  const detail = payload.detail as { code?: unknown } | undefined;\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":[],"mappings":"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"}

package/dist/{packages/agent-runtime → agent-runtime}/src/use-deep-agent-edit-submit.cjs

@@ -3,7 +3,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const store = require("@assistant-ui/store");
 const react = require("react");
 const editCommand = require("./edit-command.cjs");
+const useHistoricalEditAttachments = require("./use-historical-edit-attachments.cjs");
 function useDeepAgentMessageEditSubmit() {
+  useHistoricalEditAttachments.useHistoricalEditAttachments();
   const aui = store.useAui();
   const alive = react.useRef(true);
   const submitting = react.useRef(false);

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

@@ -0,0 +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 { readDeepAgentStatewireExtras, resolveDeepAgentEditCommand } from './edit-command';\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 */\nexport function useDeepAgentMessageEditSubmit(): () => Promise<boolean> {\n  useHistoricalEditAttachments();\n  const aui = useAui();\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    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          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      composer.send();\n      return true;\n    } finally {\n      submitting.current = false;\n    }\n  }, [aui]);\n}\n"],"names":["useHistoricalEditAttachments","useAui","useRef","useEffect","useCallback","readDeepAgentStatewireExtras","resolveDeepAgentEditCommand"],"mappings":";;;;;;AAqBO,SAAS,gCAAwD;AACtEA,4DAAA;AACA,QAAM,MAAMC,MAAAA,OAAA;AACZ,QAAM,QAAQC,MAAAA,OAAO,IAAI;AACzB,QAAM,aAAaA,MAAAA,OAAO,KAAK;AAC/BC,QAAAA,UAAU,MAAM;AACd,UAAM,UAAU;AAChB,WAAO,MAAM;AACX,YAAM,UAAU;AAAA,IAClB;AAAA,EACF,GAAG,CAAA,CAAE;AACL,SAAOC,MAAAA,YAAY,YAAY;;AAC7B,QAAI,WAAW,QAAS,QAAO;AAC/B,UAAM,WAAW,IAAI,QAAA,EAAU,SAAA;AAC/B,UAAM,QAAQ,SAAS,SAAA;AACvB,UAAM,OAAO,MAAM,KAAK,KAAA;AACxB,QAAI,CAAC,QAAQ,MAAM,YAAY,WAAW,EAAG,QAAO;AACpD,UAAM,QAAoC,CAAA;AAC1C,UAAM,QAAQ,OAAO,CAAC,IAAI,IAAI,CAAA;AAI9B,eAAW,cAAc,MAAM,aAAa;AAC1C,UAAI,WAAW,OAAO,SAAS;AAC7B,cAAM,IAAI,MAAM,0DAA0D;AAC5E,iBAAW,QAAQ,WAAW,WAAW,CAAA,GAAI;AAC3C,YAAI,KAAK,SAAS,OAAQ,OAAM,KAAK,KAAK,IAAI;AAAA,iBACrC,KAAK,SAAS;AACrB,gBAAM,KAAK,EAAE,MAAM,QAAQ,WAAW,WAAW,KAAK,KAAK,OAAO;AAAA,iBAC3D,KAAK,SAAS;AACrB,gBAAM,KAAK;AAAA,YACT,MAAM;AAAA,YACN,WAAW,KAAK;AAAA,YAChB,KAAK,KAAK;AAAA,YACV,GAAI,KAAK,YAAY,EAAE,UAAU,KAAK,SAAA;AAAA,UAAS,CAChD;AAAA,YACE,OAAM,IAAI,MAAM,wCAAwC;AAAA,MAC/D;AAAA,IACF;AACA,eAAW,UAAU;AACrB,QAAI;AACF,YAAM,WAAW,IAAI,QAAA,EAAU,WAAW;AAC1C,YAAM,aAAa,MACjB,MAAM,UAAUC,YAAAA,6BAA6B,IAAI,SAAS,WAAW,MAAM,IAAI;AACjF,YAAM,SAAS,WAAA;AACf,UAAI,QAAQ;AACV,cAAM,oBAAmB,YAAO,2BAAP;AACzB,YAAI;AACF,gBAAM,UAAU,MAAMC,wCAA4B;AAAA,YAChD;AAAA,YACA;AAAA,YACA;AAAA,UAAA,CACD;AACD,cAAI,CAAC,MAAM,WAAW,CAAC,SAAS,SAAA,EAAW,WAAW;AACpD,gBAAI,iBAAkB,cAAO,mCAAP,gCAAwC;AAC9D,mBAAO;AAAA,UACT;AACA,cAAI,SAAS;AACX,iBAAK,QAAQ;AAAA,cACX,OAAO;AAAA,gBACL;AAAA,kBACE,GAAG;AAAA,kBACH,SAAS;AAAA,oBACP,GAAG,QAAQ;AAAA,oBACX,OAAO;AAAA,sBACL,GAAG;AAAA,sBACH,GAAI,MAAM,SACN,CAAC,EAAE,MAAM,QAAiB,MAAM,MAAM,KAAK,MAAM,EAAA,CAAG,IACpD,CAAA;AAAA,oBAAC;AAAA,kBACP;AAAA,gBACF;AAAA,gBAEF,qBAAqB,SAAY,SAAY,EAAE,iBAAA;AAAA,cAAiB;AAAA,YAClE,EACA,MAAM,MAAM,MAAS;AACvB,qBAAS,OAAA;AACT,mBAAO;AAAA,UACT;AACA,cAAI,oBAAoB,OAAO,kBAAkB;AAC/C,mBAAO,iBAAiB,UAAU,gBAAgB;AAClD,mBAAO;AAAA,UACT;AAAA,QACF,SAAS,OAAO;AACd,cAAI,iBAAkB,cAAO,mCAAP,gCAAwC;AAC9D,gBAAM;AAAA,QACR;AAAA,MACF;AACA,eAAS,KAAA;AACT,aAAO;AAAA,IACT,UAAA;AACE,iBAAW,UAAU;AAAA,IACvB;AAAA,EACF,GAAG,CAAC,GAAG,CAAC;AACV;;"}

package/dist/{packages/agent-runtime → agent-runtime}/src/use-deep-agent-edit-submit.js

@@ -1,7 +1,9 @@
 import { useAui } from "@assistant-ui/store";
 import { useRef, useEffect, useCallback } from "react";
 import { readDeepAgentStatewireExtras, resolveDeepAgentEditCommand } from "./edit-command.js";
+import { useHistoricalEditAttachments } from "./use-historical-edit-attachments.js";
 function useDeepAgentMessageEditSubmit() {
+  useHistoricalEditAttachments();
   const aui = useAui();
   const alive = useRef(true);
   const submitting = useRef(false);

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-deep-agent-edit-submit.js","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 { readDeepAgentStatewireExtras, resolveDeepAgentEditCommand } from './edit-command';\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 */\nexport function useDeepAgentMessageEditSubmit(): () => Promise<boolean> {\n  useHistoricalEditAttachments();\n  const aui = useAui();\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    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          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      composer.send();\n      return true;\n    } finally {\n      submitting.current = false;\n    }\n  }, [aui]);\n}\n"],"names":[],"mappings":";;;;AAqBO,SAAS,gCAAwD;AACtE,+BAAA;AACA,QAAM,MAAM,OAAA;AACZ,QAAM,QAAQ,OAAO,IAAI;AACzB,QAAM,aAAa,OAAO,KAAK;AAC/B,YAAU,MAAM;AACd,UAAM,UAAU;AAChB,WAAO,MAAM;AACX,YAAM,UAAU;AAAA,IAClB;AAAA,EACF,GAAG,CAAA,CAAE;AACL,SAAO,YAAY,YAAY;;AAC7B,QAAI,WAAW,QAAS,QAAO;AAC/B,UAAM,WAAW,IAAI,QAAA,EAAU,SAAA;AAC/B,UAAM,QAAQ,SAAS,SAAA;AACvB,UAAM,OAAO,MAAM,KAAK,KAAA;AACxB,QAAI,CAAC,QAAQ,MAAM,YAAY,WAAW,EAAG,QAAO;AACpD,UAAM,QAAoC,CAAA;AAC1C,UAAM,QAAQ,OAAO,CAAC,IAAI,IAAI,CAAA;AAI9B,eAAW,cAAc,MAAM,aAAa;AAC1C,UAAI,WAAW,OAAO,SAAS;AAC7B,cAAM,IAAI,MAAM,0DAA0D;AAC5E,iBAAW,QAAQ,WAAW,WAAW,CAAA,GAAI;AAC3C,YAAI,KAAK,SAAS,OAAQ,OAAM,KAAK,KAAK,IAAI;AAAA,iBACrC,KAAK,SAAS;AACrB,gBAAM,KAAK,EAAE,MAAM,QAAQ,WAAW,WAAW,KAAK,KAAK,OAAO;AAAA,iBAC3D,KAAK,SAAS;AACrB,gBAAM,KAAK;AAAA,YACT,MAAM;AAAA,YACN,WAAW,KAAK;AAAA,YAChB,KAAK,KAAK;AAAA,YACV,GAAI,KAAK,YAAY,EAAE,UAAU,KAAK,SAAA;AAAA,UAAS,CAChD;AAAA,YACE,OAAM,IAAI,MAAM,wCAAwC;AAAA,MAC/D;AAAA,IACF;AACA,eAAW,UAAU;AACrB,QAAI;AACF,YAAM,WAAW,IAAI,QAAA,EAAU,WAAW;AAC1C,YAAM,aAAa,MACjB,MAAM,UAAU,6BAA6B,IAAI,SAAS,WAAW,MAAM,IAAI;AACjF,YAAM,SAAS,WAAA;AACf,UAAI,QAAQ;AACV,cAAM,oBAAmB,YAAO,2BAAP;AACzB,YAAI;AACF,gBAAM,UAAU,MAAM,4BAA4B;AAAA,YAChD;AAAA,YACA;AAAA,YACA;AAAA,UAAA,CACD;AACD,cAAI,CAAC,MAAM,WAAW,CAAC,SAAS,SAAA,EAAW,WAAW;AACpD,gBAAI,iBAAkB,cAAO,mCAAP,gCAAwC;AAC9D,mBAAO;AAAA,UACT;AACA,cAAI,SAAS;AACX,iBAAK,QAAQ;AAAA,cACX,OAAO;AAAA,gBACL;AAAA,kBACE,GAAG;AAAA,kBACH,SAAS;AAAA,oBACP,GAAG,QAAQ;AAAA,oBACX,OAAO;AAAA,sBACL,GAAG;AAAA,sBACH,GAAI,MAAM,SACN,CAAC,EAAE,MAAM,QAAiB,MAAM,MAAM,KAAK,MAAM,EAAA,CAAG,IACpD,CAAA;AAAA,oBAAC;AAAA,kBACP;AAAA,gBACF;AAAA,gBAEF,qBAAqB,SAAY,SAAY,EAAE,iBAAA;AAAA,cAAiB;AAAA,YAClE,EACA,MAAM,MAAM,MAAS;AACvB,qBAAS,OAAA;AACT,mBAAO;AAAA,UACT;AACA,cAAI,oBAAoB,OAAO,kBAAkB;AAC/C,mBAAO,iBAAiB,UAAU,gBAAgB;AAClD,mBAAO;AAAA,UACT;AAAA,QACF,SAAS,OAAO;AACd,cAAI,iBAAkB,cAAO,mCAAP,gCAAwC;AAC9D,gBAAM;AAAA,QACR;AAAA,MACF;AACA,eAAS,KAAA;AACT,aAAO;AAAA,IACT,UAAA;AACE,iBAAW,UAAU;AAAA,IACvB;AAAA,EACF,GAAG,CAAC,GAAG,CAAC;AACV;"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-deep-agent-runtime.cjs","sources":["../../../../agent-runtime/src/use-deep-agent-runtime.ts"],"sourcesContent":["import { useEffect, useMemo, useRef, useState } from 'react';\nimport { isStatewireChannelTeardown } from './errors';\nimport { type DeepAgentModelContextHost, registerDeepAgentRunConfig } from './model-context';\nimport {\n  isStorageQuotaError,\n  QuotaSafeLocalStorageSession,\n  readFailedSendStampsFromRecord,\n  readPersistedFailedSendStamps,\n  type SessionStorageDegradation,\n} from './quota-safe-local-storage-session';\nimport { createDeepAgentSendRecovery } from './send-recovery';\nimport type { StatewireTransportOptions } from './statewire-transport';\nimport { readStatewireFailedSendLane } from './thread-extras';\nimport { isConfigSyncUnavailableRejection } from './use-deep-agent-config';\nimport { useDeepAgentThread, type UseDeepAgentThreadOptions } from './use-deep-agent-thread';\n\n/** The thread element `useDeepAgentThread` produces — what the host's `useAui`\n * consumes (`useAui({ thread })`). */\nexport type DeepAgentThreadElement = ReturnType<typeof useDeepAgentThread>;\n\n/**\n * Durable command-lane persistence for the thread — where the lane identity and\n * the commands still awaiting a durable verdict live, so a reload resumes the\n * lane instead of minting a new client.\n *\n * - `local-storage`: browser hosts. Backed by {@link QuotaSafeLocalStorageSession}\n *   (the upstream `LocalStorageSession` contract with Athena keys, legacy\n *   metadata, and retention). A storage failure after mounting — the origin\n *   out of quota after statewire's own sweep, a lockdown-mode write refusal —\n *   degrades the session to memory-only persistence and is reported through\n *   `onStorageDegraded` (default: one console warning); it never stops the\n *   connection. Guarded by a shared availability probe: SSR, storage-blocked\n *   iframes, and locked-down browsers keep the session process-local, exactly\n *   as before the seam existed, while an origin that is merely full mounts the\n *   session and lets it degrade. `key` scopes the stored lane — a thread id is\n *   only meaningful against the backend (and, where relevant, principal) that\n *   minted it, so include the sync-host URL.\n * - `session-store`: React Native hosts pass a hydrated library store backed\n *   by AsyncStorage. Its synchronous `load()` is\n *   also the send-recovery freshness gate's view of the persisted failed lane,\n *   so a store that persists `failed` gets the same 24 h staleness rule as the\n *   browser hosts.\n * - `false`: process-local session (a reload mints a new client).\n */\nexport type DeepAgentSessionPersistence =\n  | {\n      kind: 'local-storage';\n      key: (threadId: string) => string;\n      onStorageDegraded?: (degradation: SessionStorageDegradation) => void;\n    }\n  | { kind: 'session-store'; store: NonNullable<StatewireTransportOptions['sessionStore']> }\n  | false;\n\n/** Structural view of the browser storage global — this package compiles\n * without the DOM lib (React Native honesty; see `globals.d.ts`). */\ntype StorageGlobals = {\n  localStorage?: {\n    setItem(key: string, value: string): void;\n    removeItem(key: string): void;\n  };\n  navigator?: { locks?: unknown };\n};\n\n/**\n * Whether a localStorage-backed session can persist here. A write probe, not a\n * `typeof` check: storage-blocked iframes (SDK embeds under third-party-storage\n * blocking) throw from the `localStorage` accessor itself, and lockdown-mode\n * origins throw from `setItem` — each of those must mean \"stay process-local\",\n * never a crash at mount. An origin that is merely out of quota still reads\n * and takes locks, so it mounts the session: {@link QuotaSafeLocalStorageSession}\n * degrades that to memory-only persistence and recovers when room frees,\n * where staying process-local would give up cross-tab sharing for the whole\n * page load over a condition that clears.\n *\n * The Web Locks API is probed too: the session storage serializes the shared\n * record across tabs through `navigator.locks` and refuses to mount without it\n * (the same precondition as the vendor `LocalStorageSession`), so an origin\n * with localStorage but no Web Locks — older WebViews, Safari before 15.4 —\n * must also stay process-local instead of throwing at mount.\n */\nexport function canPersistDeepAgentSession(): boolean {\n  try {\n    const globals = globalThis as StorageGlobals;\n    if (!globals.navigator?.locks) return false;\n    const storage = globals.localStorage;\n    if (!storage) return false;\n    const probeKey = '__athena_statewire_session_probe__';\n    try {\n      storage.setItem(probeKey, probeKey);\n      storage.removeItem(probeKey);\n    } catch (error) {\n      return isStorageQuotaError(error);\n    }\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/** A host session store's current record, or `null` when the read throws —\n * the recovery gate must never take the runtime down over a storage fault. */\nfunction loadSessionRecord(\n  store: NonNullable<StatewireTransportOptions['sessionStore']>\n): ReturnType<NonNullable<StatewireTransportOptions['sessionStore']>['load']> | null {\n  try {\n    return store.load();\n  } catch {\n    return null;\n  }\n}\n\n/**\n * The shared tail of every surface's transport error policy: channel teardown\n * is lifecycle noise (logged at debug), as is `config_sync_unavailable` — only\n * `config/*` writes emit it, and the host's config sync already handles it\n * through its own command promise (regionally-pinned workspaces run on\n * local-only config); everything else is a real transport error. Hosts with their own error chain\n * (paywall, telemetry, send-failure stores) end it with this so the fallback\n * logging stays uniform per surface.\n */\nexport function logUnhandledStatewireError(surface: string, error: Error): void {\n  if (isStatewireChannelTeardown(error)) {\n    console.debug(`[${surface}] statewire channel teardown:`, error);\n    return;\n  }\n  if (isConfigSyncUnavailableRejection(error)) {\n    console.debug(`[${surface}] config sync unavailable (handled by config sync):`, error);\n    return;\n  }\n  console.error(`[${surface}] statewire transport error:`, error);\n}\n\n/**\n * The imperative thread-state slice of an assistant-ui client — structural so\n * web and native `useAui` results both satisfy it. The send-recovery layer\n * reads the statewire thread extras through it (the sanctioned imperative\n * pattern: `aui.thread().getState()` inside callbacks/effects, never render).\n */\nexport interface DeepAgentThreadStateClientHost {\n  thread: () => { getState: () => { extras?: unknown } };\n  subscribe: (listener: () => void) => () => void;\n}\n\n/** Deep-agent runConfig registration on the ambient model context (see\n * {@link registerDeepAgentRunConfig}). */\nexport interface DeepAgentRunConfigRegistration {\n  /**\n   * Builds the `runConfig` that drives the run. The core pulls it when the\n   * model context notifies (mount and each key change); the server reads that\n   * synced value at command admission. The per-render ref makes each pull use\n   * the latest closure but does not trigger a pull itself.\n   */\n  get: () => Record<string, unknown>;\n  /**\n   * Re-registers the provider and notifies model-context sync when this value\n   * changes (reference equality). Include getter inputs that can change while\n   * mounted; they reach the server only after a key change triggers a pull.\n   */\n  key?: unknown;\n}\n\nexport interface UseDeepAgentRuntimeOptions<\n  TClient extends DeepAgentModelContextHost & DeepAgentThreadStateClientHost,\n> extends Omit<UseDeepAgentThreadOptions, 'storage' | 'sessionStore'> {\n  /** Host surface tag for the shared fallback error logging (e.g.\n   * `'AthenaDeepAgent'`, `'AthenaSDK'`, `'ChromeStatewire'`). */\n  surface: string;\n  /** Durable command-lane persistence; defaults to process-local. */\n  session?: DeepAgentSessionPersistence;\n  /**\n   * Builds the host's assistant-ui client from the thread element — pass the\n   * platform `useAui` (web hosts from `@assistant-ui/react`, React Native\n   * hosts from `@assistant-ui/react-native`; this package imports neither).\n   * Called unconditionally on every render, so it MUST be (or call) a hook\n   * following the rules of hooks — define it at module scope with a `use*`\n   * name: `const useHostClient = (thread: DeepAgentThreadElement) =>\n   * useAui({ thread })`.\n   */\n  useClient: (thread: DeepAgentThreadElement) => TClient;\n  /** Registers the deep-agent runConfig on the client's model context. Hosts\n   * that register elsewhere (e.g. a bridge component mounted under the\n   * provider) omit it. */\n  runConfig?: DeepAgentRunConfigRegistration;\n}\n\n/**\n * The configurable deep-agent statewire runtime — the one hook every Athena\n * chat surface (Olympus, `@athenaintel/react` SDK, Chrome extension, Office\n * add-in, mobile) mounts its assistant-ui client through.\n *\n * Composes the pieces every surface previously wired by hand:\n * `useDeepAgentThread` (attach lifecycle, auth parking, lane projection,\n * connection/running observers), durable session persistence with the shared\n * availability guard, transport-level send recovery (failed sends the server\n * never judged auto-retry under their original message id — `send-recovery.ts`),\n * the platform client via `useClient`, and the\n * runConfig model-context registration on provider notifications. Everything\n * host-specific — auth headers, run-config building, error policy, adapters,\n * diagnostics recorders — stays an option, so per-surface behavior is\n * configuration, not a fork.\n */\nexport function useDeepAgentRuntime<\n  TClient extends DeepAgentModelContextHost & DeepAgentThreadStateClientHost,\n>(options: UseDeepAgentRuntimeOptions<TClient>): TClient {\n  const {\n    surface,\n    session = false,\n    useClient,\n    runConfig,\n    onError,\n    onStateChange,\n    onCommandChange,\n    ...threadOptions\n  } = options;\n\n  // Probed once per mount, like every browser host did individually: an origin\n  // that cannot persist stays process-local for the mount's lifetime.\n  const [canPersistLocalSession] = useState(canPersistDeepAgentSession);\n\n  // Per-render refs so the transport never remounts on a new closure identity\n  // and always reads the latest policy.\n  const onErrorRef = useRef(onError);\n  onErrorRef.current = onError;\n  const surfaceRef = useRef(surface);\n  surfaceRef.current = surface;\n  const onStateChangeRef = useRef(onStateChange);\n  onStateChangeRef.current = onStateChange;\n  const onCommandChangeRef = useRef(onCommandChange);\n  onCommandChangeRef.current = onCommandChange;\n  const diagnosticsRef = useRef(threadOptions.diagnostics);\n  diagnosticsRef.current = threadOptions.diagnostics;\n  const clientRef = useRef<TClient | null>(null);\n\n  // Where the persisted session record lives, for the recovery freshness gate\n  // (read per sweep — undefined means \"no persistence, everything is fresh\").\n  const failureStampsRef = useRef<(() => ReadonlyMap<string, number> | null) | undefined>(\n    undefined\n  );\n  failureStampsRef.current =\n    session === false\n      ? undefined\n      : session.kind === 'local-storage'\n        ? canPersistLocalSession\n          ? () => readPersistedFailedSendStamps(session.key(threadOptions.threadId))\n          : undefined\n        : () => readFailedSendStampsFromRecord(loadSessionRecord(session.store));\n\n  // Send recovery, keyed by attach identity exactly like the thread's session\n  // (a switch or re-attach gets fresh hydration gating and retry budgets). The\n  // controller re-dispatches failed sends the server never judged; see\n  // `send-recovery.ts` for the contract.\n  const attachId =\n    threadOptions.attachKey === undefined\n      ? threadOptions.threadId\n      : `${threadOptions.threadId}:${threadOptions.attachKey}`;\n  // biome-ignore lint/correctness/useExhaustiveDependencies: keyed by attach identity on purpose; every other input is read through a per-render ref.\n  const sendRecovery = useMemo(\n    () =>\n      createDeepAgentSendRecovery({\n        lane: () => {\n          const client = clientRef.current;\n          if (!client) return null;\n          return readStatewireFailedSendLane(client.thread().getState().extras);\n        },\n        failureStamps: () => failureStampsRef.current?.() ?? null,\n        diagnostics: () => diagnosticsRef.current,\n      }),\n    [attachId]\n  );\n  useEffect(() => () => sendRecovery.dispose(), [sendRecovery]);\n  const sendRecoveryRef = useRef(sendRecovery);\n  sendRecoveryRef.current = sendRecovery;\n\n  const thread = useDeepAgentThread({\n    ...threadOptions,\n    ...(session !== false &&\n      session.kind === 'local-storage' &&\n      canPersistLocalSession && {\n        storage: {\n          session: QuotaSafeLocalStorageSession({\n            threadId: threadOptions.threadId,\n            key: session.key,\n            ...(session.onStorageDegraded === undefined\n              ? {}\n              : { onStorageDegraded: session.onStorageDegraded }),\n          }),\n        },\n      }),\n    ...(session !== false && session.kind === 'session-store' && { sessionStore: session.store }),\n    onStateChange: (state, ctx) => {\n      sendRecoveryRef.current.observeStateChange(state);\n      onStateChangeRef.current?.(state, ctx);\n    },\n    onCommandChange: (update, ctx) => {\n      sendRecoveryRef.current.observeCommand(update);\n      onCommandChangeRef.current?.(update, ctx);\n    },\n    onError: (error) => {\n      const handler = onErrorRef.current;\n      if (handler) {\n        handler(error);\n        return;\n      }\n      logUnhandledStatewireError(surfaceRef.current, error);\n    },\n  });\n\n  const client = useClient(thread);\n  clientRef.current = client;\n\n  // A locked shared journal can publish failed history after onCommandChange,\n  // with no canonical state change to wake recovery. Observe the client that\n  // owns the visible failed lane; the controller guards in-flight retries.\n  useEffect(() => {\n    const unsubscribe = client.subscribe(() => sendRecovery.observeFailedLaneChange());\n    sendRecovery.observeFailedLaneChange();\n    return unsubscribe;\n  }, [client, sendRecovery]);\n\n  // Commands travel bare, so the runConfig that drives the run rides the\n  // ambient model context: `contextSync: 'command-send'` mirrors it to the\n  // server, which reads `config.runConfig` at command admission. The core pulls\n  // on model-context notifications; the per-render ref ensures each pull uses\n  // the latest closure but does not trigger a pull itself.\n  const getRunConfigRef = useRef(runConfig?.get);\n  getRunConfigRef.current = runConfig?.get;\n  const hasRunConfig = runConfig !== undefined;\n  const runConfigKey = runConfig?.key;\n  useEffect(() => {\n    if (!hasRunConfig) return undefined;\n    return registerDeepAgentRunConfig(client, () => getRunConfigRef.current?.() ?? {});\n  }, [client, hasRunConfig, runConfigKey]);\n\n  return client;\n}\n\n"],"names":["isStorageQuotaError","isStatewireChannelTeardown","isConfigSyncUnavailableRejection","useState","useRef","readPersistedFailedSendStamps","readFailedSendStampsFromRecord","sendRecovery","useMemo","createDeepAgentSendRecovery","client","readStatewireFailedSendLane","useEffect","useDeepAgentThread","QuotaSafeLocalStorageSession","registerDeepAgentRunConfig"],"mappings":";;;;;;;;;;AAgFO,SAAS,6BAAsC;;AACpD,MAAI;AACF,UAAM,UAAU;AAChB,QAAI,GAAC,aAAQ,cAAR,mBAAmB,OAAO,QAAO;AACtC,UAAM,UAAU,QAAQ;AACxB,QAAI,CAAC,QAAS,QAAO;AACrB,UAAM,WAAW;AACjB,QAAI;AACF,cAAQ,QAAQ,UAAU,QAAQ;AAClC,cAAQ,WAAW,QAAQ;AAAA,IAC7B,SAAS,OAAO;AACd,aAAOA,6BAAAA,oBAAoB,KAAK;AAAA,IAClC;AACA,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAIA,SAAS,kBACP,OACmF;AACnF,MAAI;AACF,WAAO,MAAM,KAAA;AAAA,EACf,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAWO,SAAS,2BAA2B,SAAiB,OAAoB;AAC9E,MAAIC,OAAAA,2BAA2B,KAAK,GAAG;AACrC,YAAQ,MAAM,IAAI,OAAO,iCAAiC,KAAK;AAC/D;AAAA,EACF;AACA,MAAIC,mBAAAA,iCAAiC,KAAK,GAAG;AAC3C,YAAQ,MAAM,IAAI,OAAO,uDAAuD,KAAK;AACrF;AAAA,EACF;AACA,UAAQ,MAAM,IAAI,OAAO,gCAAgC,KAAK;AAChE;AAuEO,SAAS,oBAEd,SAAuD;AACvD,QAAM;AAAA,IACJ;AAAA,IACA,UAAU;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAG;AAAA,EAAA,IACD;AAIJ,QAAM,CAAC,sBAAsB,IAAIC,MAAAA,SAAS,0BAA0B;AAIpE,QAAM,aAAaC,MAAAA,OAAO,OAAO;AACjC,aAAW,UAAU;AACrB,QAAM,aAAaA,MAAAA,OAAO,OAAO;AACjC,aAAW,UAAU;AACrB,QAAM,mBAAmBA,MAAAA,OAAO,aAAa;AAC7C,mBAAiB,UAAU;AAC3B,QAAM,qBAAqBA,MAAAA,OAAO,eAAe;AACjD,qBAAmB,UAAU;AAC7B,QAAM,iBAAiBA,MAAAA,OAAO,cAAc,WAAW;AACvD,iBAAe,UAAU,cAAc;AACvC,QAAM,YAAYA,MAAAA,OAAuB,IAAI;AAI7C,QAAM,mBAAmBA,MAAAA;AAAAA,IACvB;AAAA,EAAA;AAEF,mBAAiB,UACf,YAAY,QACR,SACA,QAAQ,SAAS,kBACf,yBACE,MAAMC,6BAAAA,8BAA8B,QAAQ,IAAI,cAAc,QAAQ,CAAC,IACvE,SACF,MAAMC,6BAAAA,+BAA+B,kBAAkB,QAAQ,KAAK,CAAC;AAM7E,QAAM,WACJ,cAAc,cAAc,SACxB,cAAc,WACd,GAAG,cAAc,QAAQ,IAAI,cAAc,SAAS;AAE1D,QAAMC,iBAAeC,MAAAA;AAAAA,IACnB,MACEC,yCAA4B;AAAA,MAC1B,MAAM,MAAM;AACV,cAAMC,UAAS,UAAU;AACzB,YAAI,CAACA,QAAQ,QAAO;AACpB,eAAOC,aAAAA,4BAA4BD,QAAO,OAAA,EAAS,SAAA,EAAW,MAAM;AAAA,MACtE;AAAA,MACA,eAAe,MAAA;;AAAM,uCAAiB,YAAjB,8CAAgC;AAAA;AAAA,MACrD,aAAa,MAAM,eAAe;AAAA,IAAA,CACnC;AAAA,IACH,CAAC,QAAQ;AAAA,EAAA;AAEXE,QAAAA,UAAU,MAAM,MAAML,eAAa,WAAW,CAACA,cAAY,CAAC;AAC5D,QAAM,kBAAkBH,MAAAA,OAAOG,cAAY;AAC3C,kBAAgB,UAAUA;AAE1B,QAAM,SAASM,mBAAAA,mBAAmB;AAAA,IAChC,GAAG;AAAA,IACH,GAAI,YAAY,SACd,QAAQ,SAAS,mBACjB,0BAA0B;AAAA,MACxB,SAAS;AAAA,QACP,SAASC,6BAAAA,6BAA6B;AAAA,UACpC,UAAU,cAAc;AAAA,UACxB,KAAK,QAAQ;AAAA,UACb,GAAI,QAAQ,sBAAsB,SAC9B,CAAA,IACA,EAAE,mBAAmB,QAAQ,kBAAA;AAAA,QAAkB,CACpD;AAAA,MAAA;AAAA,IACH;AAAA,IAEJ,GAAI,YAAY,SAAS,QAAQ,SAAS,mBAAmB,EAAE,cAAc,QAAQ,MAAA;AAAA,IACrF,eAAe,CAAC,OAAO,QAAQ;;AAC7B,sBAAgB,QAAQ,mBAAmB,KAAK;AAChD,6BAAiB,YAAjB,0CAA2B,OAAO;AAAA,IACpC;AAAA,IACA,iBAAiB,CAAC,QAAQ,QAAQ;;AAChC,sBAAgB,QAAQ,eAAe,MAAM;AAC7C,+BAAmB,YAAnB,4CAA6B,QAAQ;AAAA,IACvC;AAAA,IACA,SAAS,CAAC,UAAU;AAClB,YAAM,UAAU,WAAW;AAC3B,UAAI,SAAS;AACX,gBAAQ,KAAK;AACb;AAAA,MACF;AACA,iCAA2B,WAAW,SAAS,KAAK;AAAA,IACtD;AAAA,EAAA,CACD;AAED,QAAM,SAAS,UAAU,MAAM;AAC/B,YAAU,UAAU;AAKpBF,QAAAA,UAAU,MAAM;AACd,UAAM,cAAc,OAAO,UAAU,MAAML,eAAa,yBAAyB;AACjFA,mBAAa,wBAAA;AACb,WAAO;AAAA,EACT,GAAG,CAAC,QAAQA,cAAY,CAAC;AAOzB,QAAM,kBAAkBH,MAAAA,OAAO,uCAAW,GAAG;AAC7C,kBAAgB,UAAU,uCAAW;AACrC,QAAM,eAAe,cAAc;AACnC,QAAM,eAAe,uCAAW;AAChCQ,QAAAA,UAAU,MAAM;AACd,QAAI,CAAC,aAAc,QAAO;AAC1B,WAAOG,aAAAA,2BAA2B,QAAQ,MAAA;;AAAM,oCAAgB,YAAhB,6CAA+B,CAAA;AAAA,KAAE;AAAA,EACnF,GAAG,CAAC,QAAQ,cAAc,YAAY,CAAC;AAEvC,SAAO;AACT;;;;"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-deep-agent-runtime.js","sources":["../../../../agent-runtime/src/use-deep-agent-runtime.ts"],"sourcesContent":["import { useEffect, useMemo, useRef, useState } from 'react';\nimport { isStatewireChannelTeardown } from './errors';\nimport { type DeepAgentModelContextHost, registerDeepAgentRunConfig } from './model-context';\nimport {\n  isStorageQuotaError,\n  QuotaSafeLocalStorageSession,\n  readFailedSendStampsFromRecord,\n  readPersistedFailedSendStamps,\n  type SessionStorageDegradation,\n} from './quota-safe-local-storage-session';\nimport { createDeepAgentSendRecovery } from './send-recovery';\nimport type { StatewireTransportOptions } from './statewire-transport';\nimport { readStatewireFailedSendLane } from './thread-extras';\nimport { isConfigSyncUnavailableRejection } from './use-deep-agent-config';\nimport { useDeepAgentThread, type UseDeepAgentThreadOptions } from './use-deep-agent-thread';\n\n/** The thread element `useDeepAgentThread` produces — what the host's `useAui`\n * consumes (`useAui({ thread })`). */\nexport type DeepAgentThreadElement = ReturnType<typeof useDeepAgentThread>;\n\n/**\n * Durable command-lane persistence for the thread — where the lane identity and\n * the commands still awaiting a durable verdict live, so a reload resumes the\n * lane instead of minting a new client.\n *\n * - `local-storage`: browser hosts. Backed by {@link QuotaSafeLocalStorageSession}\n *   (the upstream `LocalStorageSession` contract with Athena keys, legacy\n *   metadata, and retention). A storage failure after mounting — the origin\n *   out of quota after statewire's own sweep, a lockdown-mode write refusal —\n *   degrades the session to memory-only persistence and is reported through\n *   `onStorageDegraded` (default: one console warning); it never stops the\n *   connection. Guarded by a shared availability probe: SSR, storage-blocked\n *   iframes, and locked-down browsers keep the session process-local, exactly\n *   as before the seam existed, while an origin that is merely full mounts the\n *   session and lets it degrade. `key` scopes the stored lane — a thread id is\n *   only meaningful against the backend (and, where relevant, principal) that\n *   minted it, so include the sync-host URL.\n * - `session-store`: React Native hosts pass a hydrated library store backed\n *   by AsyncStorage. Its synchronous `load()` is\n *   also the send-recovery freshness gate's view of the persisted failed lane,\n *   so a store that persists `failed` gets the same 24 h staleness rule as the\n *   browser hosts.\n * - `false`: process-local session (a reload mints a new client).\n */\nexport type DeepAgentSessionPersistence =\n  | {\n      kind: 'local-storage';\n      key: (threadId: string) => string;\n      onStorageDegraded?: (degradation: SessionStorageDegradation) => void;\n    }\n  | { kind: 'session-store'; store: NonNullable<StatewireTransportOptions['sessionStore']> }\n  | false;\n\n/** Structural view of the browser storage global — this package compiles\n * without the DOM lib (React Native honesty; see `globals.d.ts`). */\ntype StorageGlobals = {\n  localStorage?: {\n    setItem(key: string, value: string): void;\n    removeItem(key: string): void;\n  };\n  navigator?: { locks?: unknown };\n};\n\n/**\n * Whether a localStorage-backed session can persist here. A write probe, not a\n * `typeof` check: storage-blocked iframes (SDK embeds under third-party-storage\n * blocking) throw from the `localStorage` accessor itself, and lockdown-mode\n * origins throw from `setItem` — each of those must mean \"stay process-local\",\n * never a crash at mount. An origin that is merely out of quota still reads\n * and takes locks, so it mounts the session: {@link QuotaSafeLocalStorageSession}\n * degrades that to memory-only persistence and recovers when room frees,\n * where staying process-local would give up cross-tab sharing for the whole\n * page load over a condition that clears.\n *\n * The Web Locks API is probed too: the session storage serializes the shared\n * record across tabs through `navigator.locks` and refuses to mount without it\n * (the same precondition as the vendor `LocalStorageSession`), so an origin\n * with localStorage but no Web Locks — older WebViews, Safari before 15.4 —\n * must also stay process-local instead of throwing at mount.\n */\nexport function canPersistDeepAgentSession(): boolean {\n  try {\n    const globals = globalThis as StorageGlobals;\n    if (!globals.navigator?.locks) return false;\n    const storage = globals.localStorage;\n    if (!storage) return false;\n    const probeKey = '__athena_statewire_session_probe__';\n    try {\n      storage.setItem(probeKey, probeKey);\n      storage.removeItem(probeKey);\n    } catch (error) {\n      return isStorageQuotaError(error);\n    }\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/** A host session store's current record, or `null` when the read throws —\n * the recovery gate must never take the runtime down over a storage fault. */\nfunction loadSessionRecord(\n  store: NonNullable<StatewireTransportOptions['sessionStore']>\n): ReturnType<NonNullable<StatewireTransportOptions['sessionStore']>['load']> | null {\n  try {\n    return store.load();\n  } catch {\n    return null;\n  }\n}\n\n/**\n * The shared tail of every surface's transport error policy: channel teardown\n * is lifecycle noise (logged at debug), as is `config_sync_unavailable` — only\n * `config/*` writes emit it, and the host's config sync already handles it\n * through its own command promise (regionally-pinned workspaces run on\n * local-only config); everything else is a real transport error. Hosts with their own error chain\n * (paywall, telemetry, send-failure stores) end it with this so the fallback\n * logging stays uniform per surface.\n */\nexport function logUnhandledStatewireError(surface: string, error: Error): void {\n  if (isStatewireChannelTeardown(error)) {\n    console.debug(`[${surface}] statewire channel teardown:`, error);\n    return;\n  }\n  if (isConfigSyncUnavailableRejection(error)) {\n    console.debug(`[${surface}] config sync unavailable (handled by config sync):`, error);\n    return;\n  }\n  console.error(`[${surface}] statewire transport error:`, error);\n}\n\n/**\n * The imperative thread-state slice of an assistant-ui client — structural so\n * web and native `useAui` results both satisfy it. The send-recovery layer\n * reads the statewire thread extras through it (the sanctioned imperative\n * pattern: `aui.thread().getState()` inside callbacks/effects, never render).\n */\nexport interface DeepAgentThreadStateClientHost {\n  thread: () => { getState: () => { extras?: unknown } };\n  subscribe: (listener: () => void) => () => void;\n}\n\n/** Deep-agent runConfig registration on the ambient model context (see\n * {@link registerDeepAgentRunConfig}). */\nexport interface DeepAgentRunConfigRegistration {\n  /**\n   * Builds the `runConfig` that drives the run. The core pulls it when the\n   * model context notifies (mount and each key change); the server reads that\n   * synced value at command admission. The per-render ref makes each pull use\n   * the latest closure but does not trigger a pull itself.\n   */\n  get: () => Record<string, unknown>;\n  /**\n   * Re-registers the provider and notifies model-context sync when this value\n   * changes (reference equality). Include getter inputs that can change while\n   * mounted; they reach the server only after a key change triggers a pull.\n   */\n  key?: unknown;\n}\n\nexport interface UseDeepAgentRuntimeOptions<\n  TClient extends DeepAgentModelContextHost & DeepAgentThreadStateClientHost,\n> extends Omit<UseDeepAgentThreadOptions, 'storage' | 'sessionStore'> {\n  /** Host surface tag for the shared fallback error logging (e.g.\n   * `'AthenaDeepAgent'`, `'AthenaSDK'`, `'ChromeStatewire'`). */\n  surface: string;\n  /** Durable command-lane persistence; defaults to process-local. */\n  session?: DeepAgentSessionPersistence;\n  /**\n   * Builds the host's assistant-ui client from the thread element — pass the\n   * platform `useAui` (web hosts from `@assistant-ui/react`, React Native\n   * hosts from `@assistant-ui/react-native`; this package imports neither).\n   * Called unconditionally on every render, so it MUST be (or call) a hook\n   * following the rules of hooks — define it at module scope with a `use*`\n   * name: `const useHostClient = (thread: DeepAgentThreadElement) =>\n   * useAui({ thread })`.\n   */\n  useClient: (thread: DeepAgentThreadElement) => TClient;\n  /** Registers the deep-agent runConfig on the client's model context. Hosts\n   * that register elsewhere (e.g. a bridge component mounted under the\n   * provider) omit it. */\n  runConfig?: DeepAgentRunConfigRegistration;\n}\n\n/**\n * The configurable deep-agent statewire runtime — the one hook every Athena\n * chat surface (Olympus, `@athenaintel/react` SDK, Chrome extension, Office\n * add-in, mobile) mounts its assistant-ui client through.\n *\n * Composes the pieces every surface previously wired by hand:\n * `useDeepAgentThread` (attach lifecycle, auth parking, lane projection,\n * connection/running observers), durable session persistence with the shared\n * availability guard, transport-level send recovery (failed sends the server\n * never judged auto-retry under their original message id — `send-recovery.ts`),\n * the platform client via `useClient`, and the\n * runConfig model-context registration on provider notifications. Everything\n * host-specific — auth headers, run-config building, error policy, adapters,\n * diagnostics recorders — stays an option, so per-surface behavior is\n * configuration, not a fork.\n */\nexport function useDeepAgentRuntime<\n  TClient extends DeepAgentModelContextHost & DeepAgentThreadStateClientHost,\n>(options: UseDeepAgentRuntimeOptions<TClient>): TClient {\n  const {\n    surface,\n    session = false,\n    useClient,\n    runConfig,\n    onError,\n    onStateChange,\n    onCommandChange,\n    ...threadOptions\n  } = options;\n\n  // Probed once per mount, like every browser host did individually: an origin\n  // that cannot persist stays process-local for the mount's lifetime.\n  const [canPersistLocalSession] = useState(canPersistDeepAgentSession);\n\n  // Per-render refs so the transport never remounts on a new closure identity\n  // and always reads the latest policy.\n  const onErrorRef = useRef(onError);\n  onErrorRef.current = onError;\n  const surfaceRef = useRef(surface);\n  surfaceRef.current = surface;\n  const onStateChangeRef = useRef(onStateChange);\n  onStateChangeRef.current = onStateChange;\n  const onCommandChangeRef = useRef(onCommandChange);\n  onCommandChangeRef.current = onCommandChange;\n  const diagnosticsRef = useRef(threadOptions.diagnostics);\n  diagnosticsRef.current = threadOptions.diagnostics;\n  const clientRef = useRef<TClient | null>(null);\n\n  // Where the persisted session record lives, for the recovery freshness gate\n  // (read per sweep — undefined means \"no persistence, everything is fresh\").\n  const failureStampsRef = useRef<(() => ReadonlyMap<string, number> | null) | undefined>(\n    undefined\n  );\n  failureStampsRef.current =\n    session === false\n      ? undefined\n      : session.kind === 'local-storage'\n        ? canPersistLocalSession\n          ? () => readPersistedFailedSendStamps(session.key(threadOptions.threadId))\n          : undefined\n        : () => readFailedSendStampsFromRecord(loadSessionRecord(session.store));\n\n  // Send recovery, keyed by attach identity exactly like the thread's session\n  // (a switch or re-attach gets fresh hydration gating and retry budgets). The\n  // controller re-dispatches failed sends the server never judged; see\n  // `send-recovery.ts` for the contract.\n  const attachId =\n    threadOptions.attachKey === undefined\n      ? threadOptions.threadId\n      : `${threadOptions.threadId}:${threadOptions.attachKey}`;\n  // biome-ignore lint/correctness/useExhaustiveDependencies: keyed by attach identity on purpose; every other input is read through a per-render ref.\n  const sendRecovery = useMemo(\n    () =>\n      createDeepAgentSendRecovery({\n        lane: () => {\n          const client = clientRef.current;\n          if (!client) return null;\n          return readStatewireFailedSendLane(client.thread().getState().extras);\n        },\n        failureStamps: () => failureStampsRef.current?.() ?? null,\n        diagnostics: () => diagnosticsRef.current,\n      }),\n    [attachId]\n  );\n  useEffect(() => () => sendRecovery.dispose(), [sendRecovery]);\n  const sendRecoveryRef = useRef(sendRecovery);\n  sendRecoveryRef.current = sendRecovery;\n\n  const thread = useDeepAgentThread({\n    ...threadOptions,\n    ...(session !== false &&\n      session.kind === 'local-storage' &&\n      canPersistLocalSession && {\n        storage: {\n          session: QuotaSafeLocalStorageSession({\n            threadId: threadOptions.threadId,\n            key: session.key,\n            ...(session.onStorageDegraded === undefined\n              ? {}\n              : { onStorageDegraded: session.onStorageDegraded }),\n          }),\n        },\n      }),\n    ...(session !== false && session.kind === 'session-store' && { sessionStore: session.store }),\n    onStateChange: (state, ctx) => {\n      sendRecoveryRef.current.observeStateChange(state);\n      onStateChangeRef.current?.(state, ctx);\n    },\n    onCommandChange: (update, ctx) => {\n      sendRecoveryRef.current.observeCommand(update);\n      onCommandChangeRef.current?.(update, ctx);\n    },\n    onError: (error) => {\n      const handler = onErrorRef.current;\n      if (handler) {\n        handler(error);\n        return;\n      }\n      logUnhandledStatewireError(surfaceRef.current, error);\n    },\n  });\n\n  const client = useClient(thread);\n  clientRef.current = client;\n\n  // A locked shared journal can publish failed history after onCommandChange,\n  // with no canonical state change to wake recovery. Observe the client that\n  // owns the visible failed lane; the controller guards in-flight retries.\n  useEffect(() => {\n    const unsubscribe = client.subscribe(() => sendRecovery.observeFailedLaneChange());\n    sendRecovery.observeFailedLaneChange();\n    return unsubscribe;\n  }, [client, sendRecovery]);\n\n  // Commands travel bare, so the runConfig that drives the run rides the\n  // ambient model context: `contextSync: 'command-send'` mirrors it to the\n  // server, which reads `config.runConfig` at command admission. The core pulls\n  // on model-context notifications; the per-render ref ensures each pull uses\n  // the latest closure but does not trigger a pull itself.\n  const getRunConfigRef = useRef(runConfig?.get);\n  getRunConfigRef.current = runConfig?.get;\n  const hasRunConfig = runConfig !== undefined;\n  const runConfigKey = runConfig?.key;\n  useEffect(() => {\n    if (!hasRunConfig) return undefined;\n    return registerDeepAgentRunConfig(client, () => getRunConfigRef.current?.() ?? {});\n  }, [client, hasRunConfig, runConfigKey]);\n\n  return client;\n}\n\n"],"names":["client"],"mappings":"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"}

package/dist/{packages/agent-runtime → agent-runtime}/src/use-deep-agent-thread.cjs

@@ -251,6 +251,7 @@ function useDeepAgentThread({
       const messages2 = (window == null ? void 0 : window.messages) ?? values.messages ?? held ?? [];
       if (window !== null || messages2.length > 0) lastMessagesRef.current = { attachId, messages: messages2 };
       const state = { ...values, messages: [...messages2] };
+      statewireState.pairDeepAgentStateWithThread({ state, threadId });
       materialize(state);
       const joined = state.messages ?? [];
       const previousJoined = lastStateMessagesRef.current;