@athenaintel/react 0.57.2 → 0.60.0

package/dist/agent-runtime/src/typed-interrupts.js

@@ -0,0 +1,48 @@
+import { isApprovalCardInterrupt, asHitlApproval } from "./interrupts.js";
+const TypedInterruptType = {
+  HITL: "hitl",
+  FORM_INPUT: "form_input",
+  CUSTOM: "custom"
+};
+const TYPED_INTERRUPT_TYPES = new Set(Object.values(TypedInterruptType));
+const TypedInterruptSource = {
+  ASK_QUESTIONNAIRE: "ask_questionnaire",
+  DEEP_RESEARCH_PENDING: "deep_research_pending",
+  PM_SCHEDULE_APPROVAL: "pm_schedule_approval",
+  WAIT_FOR_MINUTES: "wait_for_minutes",
+  BROWSE_PROFILE_APPROVAL: "browse_profile_approval",
+  TOOLKIT_SELECTION: "toolkit_selection",
+  REQUEST_FILE: "request_file"
+};
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isOptional(value, check) {
+  return value === void 0 || check(value);
+}
+const isString = (value) => typeof value === "string";
+const isBoolean = (value) => typeof value === "boolean";
+const isFiniteNumber = (value) => typeof value === "number" && Number.isFinite(value);
+function parseTypedInterruptPayload(value) {
+  if (!isRecord(value)) return null;
+  const { source, type, origin, message, timestamp, context } = value;
+  if (!isString(source) || !isString(type) || !TYPED_INTERRUPT_TYPES.has(type)) return null;
+  if (!isString(origin) || !isString(message) || !isFiniteNumber(timestamp)) return null;
+  if (!isOptional(value.requires_user_action, isBoolean) || !isOptional(value.timeout_seconds, isFiniteNumber) || !isOptional(value.timeout_at, isString) || !isOptional(value.timeout_default_value, isRecord) || !isOptional(value.interrupt_instance_id, isString)) {
+    return null;
+  }
+  return { ...value, context: isRecord(context) ? context : {} };
+}
+function isTypedInterruptRequest(request) {
+  if (!isApprovalCardInterrupt(request)) return false;
+  const payload = request.payload;
+  if (asHitlApproval(payload) !== null) return false;
+  return parseTypedInterruptPayload(payload) !== null;
+}
+export {
+  TypedInterruptSource,
+  TypedInterruptType,
+  isTypedInterruptRequest,
+  parseTypedInterruptPayload
+};
+//# sourceMappingURL=typed-interrupts.js.map

package/dist/agent-runtime/src/typed-interrupts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-interrupts.js","sources":["../../../../agent-runtime/src/typed-interrupts.ts"],"sourcesContent":["/**\n * The typed Athena interrupts: what a tool parks a run on through agora's\n * `raise_hitl_interrupt`, `raise_form_interrupt` and `raise_custom_interrupt`\n * (`agora/services/interrupts/utils.py`), each answered with the resume shape\n * its raiser validates (`agora/services/interrupts/definitions.py`). The\n * deepagents `hitl_approval` park is not one of them: the approval card\n * answers that (`asHitlApproval`).\n *\n * This module is the payload contract's selector, which every chat carries:\n * which parks are typed (`isTypedInterruptRequest`, the one selector) and the\n * payload they carry. What a card needs beyond it (each kind's reader and\n * resume, which answers approve, the stale-resume stamps, the timer) is\n * `typed-interrupt-kinds.ts`, kept apart so a host's startup bundle carries only\n * the selector while the cards load later. Both mirror Olympus's\n * `config/interruptDefinitions.ts` field for field (a payload either side calls\n * typed, the other does too) without zod, which the React SDK's published\n * bundle may not carry. Rendering stays with each surface.\n */\n\nimport type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { asHitlApproval, isApprovalCardInterrupt } from './interrupts';\n\n/** The three types the server raises (`InterruptType` in `definitions.py`). */\nexport const TypedInterruptType = {\n  HITL: 'hitl',\n  FORM_INPUT: 'form_input',\n  CUSTOM: 'custom',\n} as const;\n\nexport type TypedInterruptType = (typeof TypedInterruptType)[keyof typeof TypedInterruptType];\n\nconst TYPED_INTERRUPT_TYPES: ReadonlySet<string> = new Set(Object.values(TypedInterruptType));\n\n/** The `custom` sources a surface has a card of its own for (`interrupt_id` at the raise site). */\nexport const TypedInterruptSource = {\n  ASK_QUESTIONNAIRE: 'ask_questionnaire',\n  DEEP_RESEARCH_PENDING: 'deep_research_pending',\n  PM_SCHEDULE_APPROVAL: 'pm_schedule_approval',\n  WAIT_FOR_MINUTES: 'wait_for_minutes',\n  BROWSE_PROFILE_APPROVAL: 'browse_profile_approval',\n  TOOLKIT_SELECTION: 'toolkit_selection',\n  REQUEST_FILE: 'request_file',\n} as const;\n\nexport type TypedInterruptSource = (typeof TypedInterruptSource)[keyof typeof TypedInterruptSource];\n\n/** A parked typed interrupt, as the raiser published it. */\nexport interface TypedInterruptPayload {\n  /** The interrupt id: `ask_questionnaire`, `toolkit_selection`, `hitl_<tool>`, a form id… */\n  readonly source: string;\n  readonly type: TypedInterruptType;\n  /** Who raised it (`tool:ask`, `tool:toggle_toolkit`…). */\n  readonly origin: string;\n  readonly message: string;\n  /** The kind's own fields (questions, toolkits, the gated call…); `{}` when the raiser sent none. */\n  readonly context: Readonly<Record<string, unknown>>;\n  readonly timestamp: number;\n  /** The resume model's JSON Schema (a form's fields). */\n  readonly schema?: unknown;\n  /** `false` on a system pause nobody answers (a background research wait). */\n  readonly requires_user_action?: boolean;\n  readonly timeout_seconds?: number;\n  /** When the backend's timer answers for the person (ISO 8601 UTC). */\n  readonly timeout_at?: string;\n  readonly timeout_default_value?: Readonly<Record<string, unknown>>;\n  /** The instance the raiser's stale-resume check compares (HITL parks carry it). */\n  readonly interrupt_instance_id?: string;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isOptional<T>(value: unknown, check: (candidate: unknown) => candidate is T): boolean {\n  return value === undefined || check(value);\n}\n\nconst isString = (value: unknown): value is string => typeof value === 'string';\nconst isBoolean = (value: unknown): value is boolean => typeof value === 'boolean';\nconst isFiniteNumber = (value: unknown): value is number =>\n  typeof value === 'number' && Number.isFinite(value);\n\n/**\n * The payload as a typed interrupt, or `null` when it is not one. Reads what\n * Olympus's `InterruptPayloadSchema` reads, with the same required fields\n * (`source`, `type`, `origin`, `message`, `timestamp`) and the same optional\n * ones, so a park is typed on every surface or on none. A missing or malformed\n * `context` reads as `{}`, as the schema's `.catch({})` does.\n */\nexport function parseTypedInterruptPayload(value: unknown): TypedInterruptPayload | null {\n  if (!isRecord(value)) return null;\n  const { source, type, origin, message, timestamp, context } = value;\n  if (!isString(source) || !isString(type) || !TYPED_INTERRUPT_TYPES.has(type)) return null;\n  if (!isString(origin) || !isString(message) || !isFiniteNumber(timestamp)) return null;\n  if (\n    !isOptional(value.requires_user_action, isBoolean) ||\n    !isOptional(value.timeout_seconds, isFiniteNumber) ||\n    !isOptional(value.timeout_at, isString) ||\n    !isOptional(value.timeout_default_value, isRecord) ||\n    !isOptional(value.interrupt_instance_id, isString)\n  ) {\n    return null;\n  }\n  return { ...value, context: isRecord(context) ? context : {} } as unknown as TypedInterruptPayload;\n}\n\n/**\n * The one selector for \"a pending park a typed card answers\": an approval-card\n * interrupt (neither a client tool's park nor a system pause), not the\n * deepagents HITL approval the approval card answers, and parsing as a typed\n * interrupt. The card renders for the request this selects and its answer is\n * sent under that same request.\n */\nexport function isTypedInterruptRequest(\n  request: StatewireThread.InputRequestState,\n): request is StatewireThread.CustomInputRequest {\n  if (!isApprovalCardInterrupt(request)) return false;\n  const payload: unknown = (request as { payload?: unknown }).payload;\n  if (asHitlApproval(payload) !== null) return false;\n  return parseTypedInterruptPayload(payload) !== null;\n}\n"],"names":[],"mappings":";AAuBO,MAAM,qBAAqB;AAAA,EAChC,MAAM;AAAA,EACN,YAAY;AAAA,EACZ,QAAQ;AACV;AAIA,MAAM,wBAA6C,IAAI,IAAI,OAAO,OAAO,kBAAkB,CAAC;AAGrF,MAAM,uBAAuB;AAAA,EAClC,mBAAmB;AAAA,EACnB,uBAAuB;AAAA,EACvB,sBAAsB;AAAA,EACtB,kBAAkB;AAAA,EAClB,yBAAyB;AAAA,EACzB,mBAAmB;AAAA,EACnB,cAAc;AAChB;AA2BA,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,SAAS,WAAc,OAAgB,OAAwD;AAC7F,SAAO,UAAU,UAAa,MAAM,KAAK;AAC3C;AAEA,MAAM,WAAW,CAAC,UAAoC,OAAO,UAAU;AACvE,MAAM,YAAY,CAAC,UAAqC,OAAO,UAAU;AACzE,MAAM,iBAAiB,CAAC,UACtB,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK;AAS7C,SAAS,2BAA2B,OAA8C;AACvF,MAAI,CAAC,SAAS,KAAK,EAAG,QAAO;AAC7B,QAAM,EAAE,QAAQ,MAAM,QAAQ,SAAS,WAAW,YAAY;AAC9D,MAAI,CAAC,SAAS,MAAM,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,sBAAsB,IAAI,IAAI,EAAG,QAAO;AACrF,MAAI,CAAC,SAAS,MAAM,KAAK,CAAC,SAAS,OAAO,KAAK,CAAC,eAAe,SAAS,EAAG,QAAO;AAClF,MACE,CAAC,WAAW,MAAM,sBAAsB,SAAS,KACjD,CAAC,WAAW,MAAM,iBAAiB,cAAc,KACjD,CAAC,WAAW,MAAM,YAAY,QAAQ,KACtC,CAAC,WAAW,MAAM,uBAAuB,QAAQ,KACjD,CAAC,WAAW,MAAM,uBAAuB,QAAQ,GACjD;AACA,WAAO;AAAA,EACT;AACA,SAAO,EAAE,GAAG,OAAO,SAAS,SAAS,OAAO,IAAI,UAAU,GAAC;AAC7D;AASO,SAAS,wBACd,SAC+C;AAC/C,MAAI,CAAC,wBAAwB,OAAO,EAAG,QAAO;AAC9C,QAAM,UAAoB,QAAkC;AAC5D,MAAI,eAAe,OAAO,MAAM,KAAM,QAAO;AAC7C,SAAO,2BAA2B,OAAO,MAAM;AACjD;"}

package/dist/agent-runtime/src/types.d.ts

@@ -115,7 +115,7 @@ export interface DeepAgentStreamValues {
     /** The replicated run mounts (lib-owned; see `runs: true` on the thread options). */
     runs?: readonly StatewireThread.RunState[];
     /**
-     * The ids of queued entries the user prioritized (⚡, `run/prioritize`), as
+     * The ids of queued entries a backend delivery prioritized, as
      * the host records them durably: the live run ends at its next model-call
      * boundary while one of them heads the queue lane. Absent until a thread
      * first prioritizes; read through `readPrioritizedQueueIds`.

package/dist/agent-runtime/src/use-conversation-list.cjs

@@ -137,6 +137,7 @@ function useConversationList(options) {
     isLoading: firstPage.isLoading,
     isFetching: firstPage.isFetching || history.isFetching,
     hasResolvedFirstPage: firstPage.data !== void 0,
+    firstPageUpdatedAt: firstPage.data === void 0 ? 0 : firstPage.dataUpdatedAt,
     hasNextPage: hasLoadedHistory ? history.hasNextPage ?? false : ((_d = firstPage.data) == null ? void 0 : _d.hasMore) ?? false,
     isFetchingNextPage: history.isFetchingNextPage || !hasLoadedHistory && history.isFetching,
     isFetchNextPageError: history.isError,

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

@@ -1 +1 @@
-{"version":3,"file":"use-conversation-list.cjs","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  /**\n   * Whether the live first page's latest answer held the conversations with\n   * the filter's `homeAgentId` agent ({@link ConversationListPage.homeAgentApplied}).\n   * `false` until it answers, and wherever the server did not widen the list.\n   */\n  homeAgentApplied: boolean;\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    homeAgentApplied: firstPage.data?.homeAgentApplied === true,\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":["CONVERSATION_LIST_DEFAULT_SCOPE_KEY","useQueryClient","useRef","normalizeConversationListFilter","conversationListFilterKey","useMemo","conversationListQueryKeys","useQuery","useInfiniteQuery","mergeConversationPages","useCallback","invalidateConversationListCaches","prependConversationToPage","removeConversationFromPage","patchConversationsInPage"],"mappings":"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"}
+{"version":3,"file":"use-conversation-list.cjs","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  /**\n   * Whether the live first page's latest answer held the conversations with\n   * the filter's `homeAgentId` agent ({@link ConversationListPage.homeAgentApplied}).\n   * `false` until it answers, and wherever the server did not widen the list.\n   */\n  homeAgentApplied: boolean;\n  isLoading: boolean;\n  isFetching: boolean;\n  /** True once the live first page has resolved at least once. */\n  hasResolvedFirstPage: boolean;\n  /**\n   * When the live first page's data was last written (its query's `dataUpdatedAt`, ms since the\n   * epoch; 0 before it has any). A page painted from a copy kept on the device carries that\n   * copy's stamp and a failed refetch leaves it as it was, so a consumer that must act only on\n   * what the server said since it mounted compares this with its own mount time.\n   */\n  firstPageUpdatedAt: number;\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    homeAgentApplied: firstPage.data?.homeAgentApplied === true,\n    isLoading: firstPage.isLoading,\n    isFetching: firstPage.isFetching || history.isFetching,\n    hasResolvedFirstPage: firstPage.data !== undefined,\n    firstPageUpdatedAt: firstPage.data === undefined ? 0 : firstPage.dataUpdatedAt,\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":["CONVERSATION_LIST_DEFAULT_SCOPE_KEY","useQueryClient","useRef","normalizeConversationListFilter","conversationListFilterKey","useMemo","conversationListQueryKeys","useQuery","useInfiniteQuery","mergeConversationPages","useCallback","invalidateConversationListCaches","prependConversationToPage","removeConversationFromPage","patchConversationsInPage"],"mappings":"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"}

package/dist/agent-runtime/src/use-conversation-list.d.ts

@@ -48,6 +48,13 @@ export interface ConversationListController {
     isFetching: boolean;
     /** True once the live first page has resolved at least once. */
     hasResolvedFirstPage: boolean;
+    /**
+     * When the live first page's data was last written (its query's `dataUpdatedAt`, ms since the
+     * epoch; 0 before it has any). A page painted from a copy kept on the device carries that
+     * copy's stamp and a failed refetch leaves it as it was, so a consumer that must act only on
+     * what the server said since it mounted compares this with its own mount time.
+     */
+    firstPageUpdatedAt: number;
     hasNextPage: boolean;
     isFetchingNextPage: boolean;
     /** True while the last next-page request failed (cleared by a successful one). */

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

@@ -135,6 +135,7 @@ function useConversationList(options) {
     isLoading: firstPage.isLoading,
     isFetching: firstPage.isFetching || history.isFetching,
     hasResolvedFirstPage: firstPage.data !== void 0,
+    firstPageUpdatedAt: firstPage.data === void 0 ? 0 : firstPage.dataUpdatedAt,
     hasNextPage: hasLoadedHistory ? history.hasNextPage ?? false : ((_d = firstPage.data) == null ? void 0 : _d.hasMore) ?? false,
     isFetchingNextPage: history.isFetchingNextPage || !hasLoadedHistory && history.isFetching,
     isFetchNextPageError: history.isError,

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

@@ -1 +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  /**\n   * Whether the live first page's latest answer held the conversations with\n   * the filter's `homeAgentId` agent ({@link ConversationListPage.homeAgentApplied}).\n   * `false` until it answers, and wherever the server did not widen the list.\n   */\n  homeAgentApplied: boolean;\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    homeAgentApplied: firstPage.data?.homeAgentApplied === true,\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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"}
+{"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  /**\n   * Whether the live first page's latest answer held the conversations with\n   * the filter's `homeAgentId` agent ({@link ConversationListPage.homeAgentApplied}).\n   * `false` until it answers, and wherever the server did not widen the list.\n   */\n  homeAgentApplied: boolean;\n  isLoading: boolean;\n  isFetching: boolean;\n  /** True once the live first page has resolved at least once. */\n  hasResolvedFirstPage: boolean;\n  /**\n   * When the live first page's data was last written (its query's `dataUpdatedAt`, ms since the\n   * epoch; 0 before it has any). A page painted from a copy kept on the device carries that\n   * copy's stamp and a failed refetch leaves it as it was, so a consumer that must act only on\n   * what the server said since it mounted compares this with its own mount time.\n   */\n  firstPageUpdatedAt: number;\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    homeAgentApplied: firstPage.data?.homeAgentApplied === true,\n    isLoading: firstPage.isLoading,\n    isFetching: firstPage.isFetching || history.isFetching,\n    hasResolvedFirstPage: firstPage.data !== undefined,\n    firstPageUpdatedAt: firstPage.data === undefined ? 0 : firstPage.dataUpdatedAt,\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-chat-outbox.cjs

@@ -7,14 +7,14 @@ function useDeepAgentChatOutbox({
   client,
   threadId,
   isNewChat,
-  store,
+  directory,
+  legacy,
   reachability,
   foreground,
   restore,
   openThread,
   onEvent,
   checkAttachments,
-  sendGate,
   enabled = true,
   countdownMs
 }) {
@@ -30,9 +30,6 @@ function useDeepAgentChatOutbox({
   const checkAttachmentsRef = require$$0.useRef(checkAttachments);
   checkAttachmentsRef.current = checkAttachments;
   const checksAttachments = checkAttachments !== void 0;
-  const sendGateRef = require$$0.useRef(sendGate);
-  sendGateRef.current = sendGate;
-  const gatesSends = sendGate !== void 0;
   const reachabilityRef = require$$0.useRef(reachability);
   reachabilityRef.current = reachability;
   const foregroundRef = require$$0.useRef(foreground);
@@ -57,7 +54,11 @@ function useDeepAgentChatOutbox({
   const isNewChatRef = require$$0.useRef(isNewChat);
   isNewChatRef.current = isNewChat;
   const [outbox, setOutbox] = require$$0.useState(null);
+  const legacyRef = require$$0.useRef(legacy);
+  legacyRef.current = legacy;
+  const migrates = legacy !== void 0;
   require$$0.useEffect(() => {
+    var _a;
     if (!enabled || !threadId) {
       setOutbox(null);
       return void 0;
@@ -66,7 +67,39 @@ function useDeepAgentChatOutbox({
       threadId,
       // Read at each hold: a chat that starts while mounted stamps its later messages as started.
       isNewChat: () => isNewChatRef.current,
-      store,
+      ...directory && { directory },
+      ...migrates && {
+        legacy: {
+          reader: {
+            listAll: () => {
+              var _a2;
+              return ((_a2 = legacyRef.current) == null ? void 0 : _a2.reader.listAll()) ?? Promise.resolve([]);
+            },
+            list: (id) => {
+              var _a2;
+              return ((_a2 = legacyRef.current) == null ? void 0 : _a2.reader.list(id)) ?? Promise.resolve([]);
+            },
+            count: () => {
+              var _a2;
+              return ((_a2 = legacyRef.current) == null ? void 0 : _a2.reader.count()) ?? Promise.resolve(0);
+            },
+            remove: (id, messageId) => {
+              var _a2;
+              return ((_a2 = legacyRef.current) == null ? void 0 : _a2.reader.remove(id, messageId)) ?? Promise.resolve();
+            },
+            clear: () => {
+              var _a2;
+              return ((_a2 = legacyRef.current) == null ? void 0 : _a2.reader.clear()) ?? Promise.resolve();
+            }
+          },
+          ...((_a = legacyRef.current) == null ? void 0 : _a.isKept) !== void 0 && {
+            isKept: (id, messageId) => {
+              var _a2, _b;
+              return ((_b = (_a2 = legacyRef.current) == null ? void 0 : _a2.isKept) == null ? void 0 : _b.call(_a2, id, messageId)) ?? Promise.resolve(false);
+            }
+          }
+        }
+      },
       reachability: stableSignals.reachability,
       foreground: stableSignals.foreground,
       thread: {
@@ -81,34 +114,18 @@ function useDeepAgentChatOutbox({
       restore: (entry) => restoreRef.current(entry),
       ...canOpenThreads && {
         openThread: (target) => {
-          var _a;
-          return (_a = openThreadRef.current) == null ? void 0 : _a.call(openThreadRef, target);
+          var _a2;
+          return (_a2 = openThreadRef.current) == null ? void 0 : _a2.call(openThreadRef, target);
         }
       },
       onEvent: (event) => {
-        var _a;
-        return (_a = onEventRef.current) == null ? void 0 : _a.call(onEventRef, event);
+        var _a2;
+        return (_a2 = onEventRef.current) == null ? void 0 : _a2.call(onEventRef, event);
       },
       ...checksAttachments && {
         checkAttachments: (attachments) => {
-          var _a;
-          return ((_a = checkAttachmentsRef.current) == null ? void 0 : _a.call(checkAttachmentsRef, attachments)) ?? Promise.resolve("ok");
-        }
-      },
-      ...gatesSends && {
-        sendGate: {
-          keyOf: (entry) => {
-            var _a;
-            return ((_a = sendGateRef.current) == null ? void 0 : _a.keyOf(entry)) ?? "";
-          },
-          mayHandOff: (entry) => {
-            var _a;
-            return ((_a = sendGateRef.current) == null ? void 0 : _a.mayHandOff(entry)) ?? true;
-          },
-          subscribe: (listener) => {
-            var _a;
-            return ((_a = sendGateRef.current) == null ? void 0 : _a.subscribe(listener)) ?? (() => void 0);
-          }
+          var _a2;
+          return ((_a2 = checkAttachmentsRef.current) == null ? void 0 : _a2.call(checkAttachmentsRef, attachments)) ?? Promise.resolve("ok");
         }
       },
       ...countdownMs !== void 0 && { countdownMs }
@@ -118,7 +135,7 @@ function useDeepAgentChatOutbox({
       created.dispose();
       setOutbox((current) => current === created ? null : current);
     };
-  }, [enabled, threadId, store, countdownMs, canOpenThreads, checksAttachments, gatesSends]);
+  }, [enabled, threadId, directory, countdownMs, canOpenThreads, checksAttachments, migrates]);
   return outbox !== null && outbox.threadId === threadId ? outbox : null;
 }
 const EMPTY_SNAPSHOT = {

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

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

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

@@ -1,7 +1,8 @@
 import { type Context } from "react";
 import type { ChatOutboxAttachmentCheck } from "./chat-outbox-attachments";
-import { type ChatOutbox, type ChatOutboxCommandUpdate, type ChatOutboxEvent, type ChatOutboxSendGate, type ChatOutboxSignal, type ChatOutboxSnapshot } from "./chat-outbox";
-import type { ChatOutboxEntry, ChatOutboxStore } from "./chat-outbox-store";
+import { type ChatOutbox, type ChatOutboxEvent, type ChatOutboxLegacyOptions, type ChatOutboxSignal, type ChatOutboxSnapshot } from "./chat-outbox";
+import type { ChatOutboxEntry } from "./chat-outbox-entry";
+import type { ChatOutboxDirectory } from "./chat-outbox-storage";
 import { type ChatOutboxClientHost } from "./chat-outbox-thread";
 export interface UseDeepAgentChatOutboxOptions {
     /** The thread's assistant-ui client (`useDeepAgentRuntime`'s result). */
@@ -10,11 +11,12 @@ export interface UseDeepAgentChatOutboxOptions {
     /** The conversation has never started (a new chat). */
     isNewChat: boolean;
     /**
-     * This person's outbox store, one per person for the life of the page or app (a message the
-     * device cannot keep waits in its memory, across thread switches); `null` keeps waiting messages
-     * in this outbox alone.
+     * Every thread's waiting messages (`createChatOutboxDirectory`, one per person over the same
+     * backend, namespace and codec as the thread sessions): the tray's other conversations.
      */
-    store: ChatOutboxStore | null;
+    directory?: ChatOutboxDirectory;
+    /** The previous store (`createLegacyChatOutboxReader`): this thread's records move into its outbox. */
+    legacy?: ChatOutboxLegacyOptions;
     /** Athena's reachability (the host's own model: the browser online AND agora answering). */
     reachability: ChatOutboxSignal;
     /** The app is in front (a visible tab, an active app, a focused desktop window). */
@@ -35,25 +37,19 @@ export interface UseDeepAgentChatOutboxOptions {
      * (`createChatOutboxAttachmentCheck`); omitted, attachments go unchecked.
      */
     checkAttachments?: ChatOutboxAttachmentCheck;
-    /**
-     * Which waiting messages go together, and when (`ChatOutboxOptions.sendGate`): a host whose
-     * messages carry per-send settings keeps a message with other settings than a send the
-     * conversation has not taken yet waiting until it has. Read through a ref: a host may rebuild it.
-     */
-    sendGate?: ChatOutboxSendGate;
-    /** Off: no outbox (a read-only or suspended surface); sends behave as before. */
+    /** Off: no outbox (a read-only or suspended surface, a thread without a session); sends behave as before. */
     enabled?: boolean;
     /** The countdown before a waiting message is sent (tests); defaults to `CHAT_OUTBOX_COUNTDOWN_MS`. */
     countdownMs?: number;
 }
 /**
- * The chat outbox for the mounted thread (`chat-outbox.ts`), one per thread and store: a thread
- * switch disposes it and makes the next thread's. The host forwards statewire's command lifecycle
- * to {@link ChatOutbox.observeCommand} (its `useDeepAgentRuntime` `onCommandChange`), shares the
- * instance through {@link DeepAgentChatOutboxContext}, and has its composer call
+ * The chat outbox for the mounted thread (`chat-outbox.ts`), one per thread: a thread switch
+ * disposes it and makes the next thread's. It reads the thread's statewire outbox
+ * (`extras.outbox`), so the thread must mount a session (`useDeepAgentRuntime`'s `session`). The
+ * host shares the instance through {@link DeepAgentChatOutboxContext} and has its composer call
  * {@link ChatOutbox.shouldHold} / {@link ChatOutbox.hold} before sending.
  */
-export declare function useDeepAgentChatOutbox({ client, threadId, isNewChat, store, reachability, foreground, restore, openThread, onEvent, checkAttachments, sendGate, enabled, countdownMs, }: UseDeepAgentChatOutboxOptions): ChatOutbox | null;
+export declare function useDeepAgentChatOutbox({ client, threadId, isNewChat, directory, legacy, reachability, foreground, restore, openThread, onEvent, checkAttachments, enabled, countdownMs, }: UseDeepAgentChatOutboxOptions): ChatOutbox | null;
 /** The outbox's rows and countdown, re-rendering on every change (`null` outbox: nothing waits). */
 export declare function useChatOutboxSnapshot(outbox: ChatOutbox | null): ChatOutboxSnapshot;
 /**
@@ -65,7 +61,3 @@ export declare function useChatOutboxReachable(outbox: ChatOutbox | null): boole
 /** The mounted thread's chat outbox, shared from its runtime provider to its composer and tray. */
 export declare const DeepAgentChatOutboxContext: Context<ChatOutbox | null>;
 export declare function useDeepAgentChatOutboxContext(): ChatOutbox | null;
-/** Forward statewire's command lifecycle to an outbox held in a ref (the runtime is made first). */
-export declare function forwardChatOutboxCommand(outbox: {
-    current: ChatOutbox | null;
-}, update: ChatOutboxCommandUpdate): void;