@athenaintel/react 0.18.0 → 0.20.0

package/dist/packages/agent-runtime/src/tool-result.js

@@ -0,0 +1,151 @@
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseJsonRecord(value) {
+  try {
+    const parsed = JSON.parse(value);
+    return isRecord(parsed) ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function resultRecord(result) {
+  if (typeof result === "string") return parseJsonRecord(result);
+  return isRecord(result) ? result : null;
+}
+function stringField(record, keys) {
+  if (!record) return null;
+  for (const key of keys) {
+    const value = record[key];
+    if (typeof value === "string" && value.trim()) return value;
+  }
+  return null;
+}
+function resultMessage(result) {
+  return stringField(resultRecord(result), ["message"]);
+}
+const FAILURE_DETAIL_KEYS = ["error", "errorCode", "error_code"];
+const INTERVENTION_DETAIL_KEYS = ["message", "reason", "errorCode", "error_code"];
+const FAILURE_CODE_KEYS = ["errorCode", "error_code", "code"];
+const FAILURE_MESSAGE_KEYS = ["error", "message", "reason"];
+function batchReportFailure(trimmed) {
+  var _a;
+  const lines = trimmed.split("\n");
+  const header = ((_a = lines[0]) == null ? void 0 : _a.trim()) ?? "";
+  if (!/^[\w.-]*batch: \d+\/\d+ ok — STOPPED at step \d+/.test(header)) {
+    return null;
+  }
+  const stepError = lines.map((line) => line.trim()).find(
+    (line) => /^\d+\.\s/.test(line) && (line.includes(" ERROR — ") || line.endsWith(" ERROR"))
+  );
+  return stepError ? `${header}
+${stepError}` : header;
+}
+const STRING_ERROR_PREFIX = /^(?:Error:|Tool execution failed\b|Failed to route tool call\b)\s*/;
+function plainStringError(result) {
+  if (typeof result !== "string") return null;
+  const trimmed = result.trim();
+  if (!trimmed || parseJsonRecord(trimmed)) return null;
+  if (STRING_ERROR_PREFIX.test(trimmed)) {
+    return trimmed.replace(STRING_ERROR_PREFIX, "").trim() || trimmed;
+  }
+  return batchReportFailure(trimmed);
+}
+function pausedNotice(result) {
+  if (typeof result !== "string") return null;
+  const trimmed = result.trim();
+  return /^⏸️?\s*Interrupted —/.test(trimmed) ? trimmed : null;
+}
+function stringifyUnknown(value) {
+  if (value == null) return null;
+  if (typeof value === "string") return value;
+  if (value instanceof Error) return value.message;
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return String(value);
+  }
+}
+function toolFailure({
+  status,
+  result,
+  isError,
+  passThroughPayload = false
+}) {
+  if ((status == null ? void 0 : status.type) === "incomplete") {
+    const errorText = stringifyUnknown(status.error);
+    return {
+      message: errorText ?? (status.reason === "cancelled" ? "Cancelled" : `Tool stopped: ${status.reason}`)
+    };
+  }
+  const record = resultRecord(result);
+  const data = isRecord(record == null ? void 0 : record.data) ? record.data : null;
+  const humanIntervention = isRecord(data == null ? void 0 : data.humanIntervention) ? data.humanIntervention : null;
+  const failureDetail = stringField(record, FAILURE_DETAIL_KEYS) ?? stringField(humanIntervention, INTERVENTION_DETAIL_KEYS);
+  const flagged = (record == null ? void 0 : record.success) === false || (record == null ? void 0 : record.ok) === false;
+  const flaggedFailure = flagged && (!passThroughPayload || failureDetail !== null);
+  const errorField = stringField(record, ["error"]) !== null;
+  const stringError = plainStringError(result);
+  if (!isError && !flaggedFailure && !errorField && !stringError) return null;
+  const code = stringField(record, FAILURE_CODE_KEYS) ?? stringField(humanIntervention, FAILURE_CODE_KEYS) ?? void 0;
+  const message = stringField(record, FAILURE_MESSAGE_KEYS) ?? stringField(humanIntervention, FAILURE_MESSAGE_KEYS) ?? stringError ?? (typeof result === "string" && !parseJsonRecord(result) ? result : null) ?? "Tool execution failed";
+  return { message, code };
+}
+function classifyToolResult({
+  status,
+  result,
+  isError,
+  passThroughPayload
+}) {
+  const notice = pausedNotice(result);
+  if (notice) return { state: "paused", notice };
+  const rejection = passThroughPayload ? null : readRejectedToolResult(result);
+  if (rejection) return { state: "rejected", rejection };
+  const failure = toolFailure({ status, result, isError, passThroughPayload });
+  if (failure) return { state: "error", failure };
+  if ((status == null ? void 0 : status.type) === "requires-action") return { state: "requires-action" };
+  if (result === void 0 && (status == null ? void 0 : status.type) !== "complete") {
+    return { state: "running" };
+  }
+  return { state: "complete" };
+}
+function isToolResultSuccess(result) {
+  return classifyToolResult({ status: { type: "complete" }, result }).state === "complete";
+}
+const USER_REJECTION_PATTERNS = [/rejected by (?:the )?user/i, /user rejected/i];
+const USER_REJECTION_LEAD_CHARS = 100;
+function opensWithUserRejection(result) {
+  const firstLine = result.trimStart().split("\n", 1)[0] ?? "";
+  return USER_REJECTION_PATTERNS.some((pattern) => {
+    const index = firstLine.search(pattern);
+    return index !== -1 && index < USER_REJECTION_LEAD_CHARS;
+  });
+}
+const NO_REASON = "no reason provided";
+const TRAILING_GUIDANCE = /\s*Acknowledge in one short sentence\..*$/i;
+function readRejectedToolResult(result) {
+  var _a, _b;
+  if (typeof result === "string") {
+    if (!opensWithUserRejection(result)) return null;
+    const reason = (_b = (_a = result.match(/Reason:\s*(.+)/i)) == null ? void 0 : _a[1]) == null ? void 0 : _b.replace(TRAILING_GUIDANCE, "").trim();
+    if (!reason || reason.toLowerCase() === NO_REASON) return { reason: null };
+    return { reason };
+  }
+  if (!isRecord(result)) return null;
+  if (result.status === "rejected" || result.action === "reject" || result.decision === "rejected") {
+    return { reason: stringField(result, ["reason"]) };
+  }
+  return null;
+}
+export {
+  classifyToolResult,
+  isRecord,
+  isToolResultSuccess,
+  parseJsonRecord,
+  readRejectedToolResult,
+  resultMessage,
+  resultRecord,
+  stringField,
+  toolFailure
+};
+//# sourceMappingURL=tool-result.js.map

package/dist/packages/agent-runtime/src/tool-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result.js","sources":["../../../../../agent-runtime/src/tool-result.ts"],"sourcesContent":["/**\n * Tool-result classification shared by every tool card and activity timeline\n * (the React SDK fallback, Olympus, the Chrome extension, the Office add-in,\n * mobile). One rule set for \"did this call succeed?\", so a result that reads\n * as a failure on one surface cannot read as a success on another.\n *\n * The rules, in order:\n *\n * 1. An `incomplete` status is a failure; a `cancelled` reason reads as\n *    \"Cancelled\".\n * 2. A string result opening with \"⏸️ Interrupted —\" is a **paused** call (the\n *    runtime parked it), not a failure.\n * 2b. A result that records the user's refusal at the approval gate (see\n *    {@link readRejectedToolResult}) is a **rejected** call — neither a success\n *    nor a failure. It is read before the failure rules because the HITL\n *    runtime answers a refused call with an error-status tool message whose\n *    content is the refusal, which would otherwise read as a plain failure.\n *    Never applied to a pass-through payload: page JavaScript relays whatever\n *    the page returned, and a `{ status: \"rejected\" }` from a fetched API is\n *    the page's business, not a human decision.\n * 3. A result record whose `success` or `ok` is `false` is a failure, with\n *    the best message available (`error`, `message`, `reason`, or a\n *    `data.humanIntervention` detail). Athena tools report failures this way\n *    — the sheet tools answer `{ success: false, message: \"…\" }` — so a bare\n *    flag must read as a failure. The one exception is a **pass-through\n *    payload** (`passThroughPayload: true`): page JavaScript relays whatever\n *    the page returned, and `{ success: false, message: \"Payment required\" }`\n *    from a fetched API is the page's business, not the tool failing, so there\n *    the flag counts only alongside an error detail (`error`, `errorCode`,\n *    `error_code`, or a `humanIntervention` message / reason / code). The\n *    Chrome extension opts its `chrome_javascript` tool in; everything else\n *    takes the default.\n * 4. A result record with a non-empty `error` string is a failure regardless\n *    of flags — every Athena tool contract uses that field only on failure.\n * 5. A plain-string result opening with an explicit error prefix (`Error:`,\n *    `Tool execution failed`, `Failed to route tool call`) is a failure —\n *    device-tunnel failures arrive in successful ToolMessages, so the prefix\n *    is the authoritative signal there. A bare leading \"Error\" word is not\n *    (an \"Error handling guide\" is content). A batch report that stopped at a\n *    step reads its header and failing step.\n * 6. assistant-ui's own `isError` flag is a failure with the best message\n *    available.\n * 7. `requires-action` and a result-less non-complete status read as such;\n *    everything else is a success.\n */\n\n/** The status shape a tool-call message part carries (structurally typed so this module stays UI-library-free). */\nexport interface ToolCallStatusLike {\n  type: 'running' | 'complete' | 'incomplete' | 'requires-action';\n  reason?: string;\n  error?: unknown;\n}\n\nexport interface ToolFailure {\n  message: string;\n  code?: string;\n}\n\nexport type ToolResultClassification =\n  | { state: 'running' }\n  | { state: 'complete' }\n  | { state: 'requires-action' }\n  | { state: 'paused'; notice: string }\n  | { state: 'rejected'; rejection: RejectedToolResult }\n  | { state: 'error'; failure: ToolFailure };\n\nexport type ToolResultState = ToolResultClassification['state'];\n\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/** Parse a JSON string into a record, or `null` when it is not one. */\nexport function parseJsonRecord(value: string): Record<string, unknown> | null {\n  try {\n    const parsed: unknown = JSON.parse(value);\n    return isRecord(parsed) ? parsed : null;\n  } catch {\n    return null;\n  }\n}\n\n/** The result as a record: parsed when it arrived as a JSON string. */\nexport function resultRecord(result: unknown): Record<string, unknown> | null {\n  if (typeof result === 'string') return parseJsonRecord(result);\n  return isRecord(result) ? result : null;\n}\n\n/** The first non-blank string among `keys` on `record`, or `null`. */\nexport function stringField(\n  record: Record<string, unknown> | null | undefined,\n  keys: readonly string[],\n): string | null {\n  if (!record) return null;\n  for (const key of keys) {\n    const value = record[key];\n    if (typeof value === 'string' && value.trim()) return value;\n  }\n  return null;\n}\n\n/** The `message` a result carries, when it does (the row's completion summary). */\nexport function resultMessage(result: unknown): string | null {\n  return stringField(resultRecord(result), ['message']);\n}\n\nconst FAILURE_DETAIL_KEYS = ['error', 'errorCode', 'error_code'] as const;\nconst INTERVENTION_DETAIL_KEYS = ['message', 'reason', 'errorCode', 'error_code'] as const;\nconst FAILURE_CODE_KEYS = ['errorCode', 'error_code', 'code'] as const;\nconst FAILURE_MESSAGE_KEYS = ['error', 'message', 'reason'] as const;\n\nfunction batchReportFailure(trimmed: string): string | null {\n  const lines = trimmed.split('\\n');\n  const header = lines[0]?.trim() ?? '';\n  if (!/^[\\w.-]*batch: \\d+\\/\\d+ ok — STOPPED at step \\d+/.test(header)) {\n    return null;\n  }\n  const stepError = lines\n    .map((line) => line.trim())\n    .find(\n      (line) =>\n        /^\\d+\\.\\s/.test(line) && (line.includes(' ERROR — ') || line.endsWith(' ERROR')),\n    );\n  return stepError ? `${header}\\n${stepError}` : header;\n}\n\nconst STRING_ERROR_PREFIX = /^(?:Error:|Tool execution failed\\b|Failed to route tool call\\b)\\s*/;\n\nfunction plainStringError(result: unknown): string | null {\n  if (typeof result !== 'string') return null;\n  const trimmed = result.trim();\n  if (!trimmed || parseJsonRecord(trimmed)) return null;\n  if (STRING_ERROR_PREFIX.test(trimmed)) {\n    return trimmed.replace(STRING_ERROR_PREFIX, '').trim() || trimmed;\n  }\n  return batchReportFailure(trimmed);\n}\n\nfunction pausedNotice(result: unknown): string | null {\n  if (typeof result !== 'string') return null;\n  const trimmed = result.trim();\n  return /^⏸️?\\s*Interrupted —/.test(trimmed) ? trimmed : null;\n}\n\nfunction stringifyUnknown(value: unknown): string | null {\n  if (value == null) return null;\n  if (typeof value === 'string') return value;\n  if (value instanceof Error) return value.message;\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n}\n\n/** The failure a tool call reports, or `null` when it succeeded (rules 1, 3-6). */\nexport function toolFailure({\n  status,\n  result,\n  isError,\n  passThroughPayload = false,\n}: {\n  status?: ToolCallStatusLike;\n  result?: unknown;\n  isError?: boolean;\n  /** The result is an application payload relayed verbatim (rule 3): a flag needs an error detail to count. */\n  passThroughPayload?: boolean;\n}): ToolFailure | null {\n  if (status?.type === 'incomplete') {\n    const errorText = stringifyUnknown(status.error);\n    return {\n      message:\n        errorText ??\n        (status.reason === 'cancelled' ? 'Cancelled' : `Tool stopped: ${status.reason}`),\n    };\n  }\n\n  const record = resultRecord(result);\n  const data = isRecord(record?.data) ? record.data : null;\n  const humanIntervention = isRecord(data?.humanIntervention) ? data.humanIntervention : null;\n  const failureDetail =\n    stringField(record, FAILURE_DETAIL_KEYS) ??\n    stringField(humanIntervention, INTERVENTION_DETAIL_KEYS);\n  const flagged = record?.success === false || record?.ok === false;\n  const flaggedFailure = flagged && (!passThroughPayload || failureDetail !== null);\n  const errorField = stringField(record, ['error']) !== null;\n  const stringError = plainStringError(result);\n\n  if (!isError && !flaggedFailure && !errorField && !stringError) return null;\n\n  const code =\n    stringField(record, FAILURE_CODE_KEYS) ??\n    stringField(humanIntervention, FAILURE_CODE_KEYS) ??\n    undefined;\n  const message =\n    stringField(record, FAILURE_MESSAGE_KEYS) ??\n    stringField(humanIntervention, FAILURE_MESSAGE_KEYS) ??\n    stringError ??\n    (typeof result === 'string' && !parseJsonRecord(result) ? result : null) ??\n    'Tool execution failed';\n\n  return { message, code };\n}\n\n/** Classify a tool call for rendering (see the module docs for the rules). */\nexport function classifyToolResult({\n  status,\n  result,\n  isError,\n  passThroughPayload,\n}: {\n  status?: ToolCallStatusLike;\n  result?: unknown;\n  isError?: boolean;\n  /** The result is an application payload relayed verbatim (rule 3): a flag needs an error detail to count. */\n  passThroughPayload?: boolean;\n}): ToolResultClassification {\n  const notice = pausedNotice(result);\n  if (notice) return { state: 'paused', notice };\n\n  const rejection = passThroughPayload ? null : readRejectedToolResult(result);\n  if (rejection) return { state: 'rejected', rejection };\n\n  const failure = toolFailure({ status, result, isError, passThroughPayload });\n  if (failure) return { state: 'error', failure };\n  if (status?.type === 'requires-action') return { state: 'requires-action' };\n  if (result === undefined && status?.type !== 'complete') {\n    return { state: 'running' };\n  }\n  return { state: 'complete' };\n}\n\n/** True when a completed call reads as a success under the shared rules. */\nexport function isToolResultSuccess(result: unknown): boolean {\n  return classifyToolResult({ status: { type: 'complete' }, result }).state === 'complete';\n}\n\n/**\n * A gated tool call the user rejected still \"completes\": both HITL runtimes\n * answer the rejected call with a `ToolMessage` whose text is the rejection\n * (\"Tool call rejected by user. Reason: …\"), and device tools may answer with\n * a structured decision (`{ status: 'rejected' }`, `{ action: 'reject' }`,\n * `{ decision: 'rejected' }`). Anything that labels a finished call has to\n * read that, or a rejected email send reports itself as sent. The read is\n * content-based, so it is scoped to where a rejection can appear: the opening\n * of a string result, never deep inside returned content, and never a\n * pass-through page payload (see {@link classifyToolResult}).\n */\nexport interface RejectedToolResult {\n  /** The feedback the user typed, when they gave one. */\n  reason: string | null;\n}\n\n/**\n * Phrasings the HITL runtimes use for a *human* rejection. Matching on these\n * rather than the word \"reject\" keeps deterministic failures out — argument\n * validation answers a call with \"Tool call rejected — ValidationError: …\",\n * which never involved the user and stays a plain failure.\n */\nconst USER_REJECTION_PATTERNS: readonly RegExp[] = [/rejected by (?:the )?user/i, /user rejected/i];\n\n/**\n * A rejection IS the tool message, so the phrasing opens it: \"The user rejected\n * this action. …\" (`hitl_bridge.py`), \"Tool call rejected by user. Reason: …\",\n * \"Tool 'x' execution rejected by user. …\", \"[INTERRUPT] Custom interrupt\n * '<uuid>' rejected by user. …\". Content a tool merely *returned* — a page read\n * or a document whose text happens to say a user rejected something — carries\n * the phrase deeper in, so only a match starting within this many characters\n * of the first line counts.\n */\nconst USER_REJECTION_LEAD_CHARS = 100;\n\n/** Whether `result` opens with a human-rejection phrasing (see {@link USER_REJECTION_LEAD_CHARS}). */\nfunction opensWithUserRejection(result: string): boolean {\n  const firstLine = result.trimStart().split('\\n', 1)[0] ?? '';\n  return USER_REJECTION_PATTERNS.some((pattern) => {\n    const index = firstLine.search(pattern);\n    return index !== -1 && index < USER_REJECTION_LEAD_CHARS;\n  });\n}\n\n/** Reject-with-no-feedback placeholder the legacy approval editor sends. */\nconst NO_REASON = 'no reason provided';\n\n/**\n * Model-facing guidance the legacy HITL node appends on the same line after\n * the reason (\"… Reason: <reason> Acknowledge in one short sentence. Do not\n * retry…\"). It is instruction for the model, not the user's feedback.\n */\nconst TRAILING_GUIDANCE = /\\s*Acknowledge in one short sentence\\..*$/i;\n\n/**\n * Read a rejection out of a completed tool call's result, or `null` when the\n * call actually ran (or failed for a non-approval reason).\n */\nexport function readRejectedToolResult(result: unknown): RejectedToolResult | null {\n  if (typeof result === 'string') {\n    if (!opensWithUserRejection(result)) return null;\n    const reason = result\n      .match(/Reason:\\s*(.+)/i)?.[1]\n      ?.replace(TRAILING_GUIDANCE, '')\n      .trim();\n    if (!reason || reason.toLowerCase() === NO_REASON) return { reason: null };\n    return { reason };\n  }\n  if (!isRecord(result)) return null;\n  if (result.status === 'rejected' || result.action === 'reject' || result.decision === 'rejected') {\n    return { reason: stringField(result, ['reason']) };\n  }\n  return null;\n}\n\n/** True when a completed call's result records that the user rejected it. */\nexport function isRejectedToolResult(result: unknown): boolean {\n  return readRejectedToolResult(result) !== null;\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const reactQuery = require("@tanstack/react-query");
+const react = require("react");
+const conversationList = require("./conversation-list.cjs");
+const DEFAULT_PAGE_SIZE = 20;
+const DEFAULT_STALE_TIME_MS = 3e4;
+const DEFAULT_GC_TIME_MS = 10 * 60 * 1e3;
+function useConversationList(options) {
+  var _a, _b, _c;
+  const {
+    filter,
+    pageSize = DEFAULT_PAGE_SIZE,
+    scopeKey = conversationList.CONVERSATION_LIST_DEFAULT_SCOPE_KEY,
+    enabled,
+    staleTime = DEFAULT_STALE_TIME_MS,
+    gcTime = DEFAULT_GC_TIME_MS,
+    refetchOnMount,
+    refetchOnWindowFocus,
+    refetchInterval = false,
+    retry
+  } = options;
+  const queryClient = reactQuery.useQueryClient();
+  const fetchPageRef = react.useRef(options.fetchPage);
+  fetchPageRef.current = options.fetchPage;
+  const normalizedFilter = conversationList.normalizeConversationListFilter(filter ?? {});
+  const filterKey = conversationList.conversationListFilterKey(normalizedFilter);
+  const firstPageKey = react.useMemo(
+    () => conversationList.conversationListQueryKeys.firstPage(scopeKey, filterKey, pageSize),
+    [scopeKey, filterKey, pageSize]
+  );
+  const historyKey = react.useMemo(
+    () => conversationList.conversationListQueryKeys.history(scopeKey, filterKey, pageSize),
+    [scopeKey, filterKey, pageSize]
+  );
+  const passthrough = {
+    ...enabled !== void 0 ? { enabled } : {},
+    ...refetchOnMount !== void 0 ? { refetchOnMount } : {},
+    ...refetchOnWindowFocus !== void 0 ? { refetchOnWindowFocus } : {},
+    ...retry !== void 0 ? { retry } : {}
+  };
+  const firstPage = reactQuery.useQuery({
+    queryKey: firstPageKey,
+    queryFn: ({ signal }) => fetchPageRef.current({ limit: pageSize, offset: 0, filter: normalizedFilter, signal }),
+    staleTime,
+    gcTime,
+    refetchInterval,
+    ...passthrough
+  });
+  const history = reactQuery.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 historyPages = (_a = history.data) == null ? void 0 : _a.pages;
+  const hasLoadedHistory = ((historyPages == null ? void 0 : historyPages.length) ?? 0) > 0;
+  const conversations = react.useMemo(
+    () => conversationList.mergeConversationPages([
+      ...firstPage.data ? [firstPage.data] : [],
+      ...historyPages ?? []
+    ]),
+    [firstPage.data, historyPages]
+  );
+  const fetchNextHistoryPage = history.fetchNextPage;
+  const refetchHistoryFirstPage = history.refetch;
+  const fetchNextPage = react.useCallback(
+    () => hasLoadedHistory ? fetchNextHistoryPage() : refetchHistoryFirstPage(),
+    [hasLoadedHistory, fetchNextHistoryPage, refetchHistoryFirstPage]
+  );
+  const refresh = react.useCallback(() => firstPage.refetch(), [firstPage.refetch]);
+  const invalidate = react.useCallback(
+    () => conversationList.invalidateConversationListCaches(queryClient, { scopeKey }),
+    [queryClient, scopeKey]
+  );
+  const prependConversation = react.useCallback(
+    (item) => {
+      queryClient.setQueryData(
+        firstPageKey,
+        (page) => page ? conversationList.prependConversationToPage(page, item) : page
+      );
+    },
+    [queryClient, firstPageKey]
+  );
+  const removeConversation = react.useCallback(
+    (threadId) => {
+      queryClient.setQueryData(
+        firstPageKey,
+        (page) => page ? conversationList.removeConversationFromPage(page, threadId) : page
+      );
+      queryClient.setQueryData(
+        historyKey,
+        (data) => data ? { ...data, pages: data.pages.map((page) => conversationList.removeConversationFromPage(page, threadId)) } : data
+      );
+    },
+    [queryClient, firstPageKey, historyKey]
+  );
+  const patchConversation = react.useCallback(
+    (threadId, patch) => {
+      const match = (item) => item.threadId === threadId;
+      queryClient.setQueryData(
+        firstPageKey,
+        (page) => page ? conversationList.patchConversationsInPage(page, match, patch) : page
+      );
+      queryClient.setQueryData(
+        historyKey,
+        (data) => data ? {
+          ...data,
+          pages: data.pages.map((page) => conversationList.patchConversationsInPage(page, match, patch))
+        } : data
+      );
+    },
+    [queryClient, firstPageKey, historyKey]
+  );
+  return {
+    conversations,
+    totalCount: ((_b = firstPage.data) == null ? void 0 : _b.totalCount) ?? null,
+    isLoading: firstPage.isLoading,
+    isFetching: firstPage.isFetching || history.isFetching,
+    hasResolvedFirstPage: firstPage.data !== void 0,
+    hasNextPage: hasLoadedHistory ? history.hasNextPage ?? false : ((_c = firstPage.data) == null ? void 0 : _c.hasMore) ?? false,
+    isFetchingNextPage: history.isFetchingNextPage || !hasLoadedHistory && history.isFetching,
+    fetchNextPage,
+    refresh,
+    invalidate,
+    prependConversation,
+    removeConversation,
+    patchConversation
+  };
+}
+exports.useConversationList = useConversationList;
+//# sourceMappingURL=use-conversation-list.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversation-list.cjs","sources":["../../../../../agent-runtime/src/use-conversation-list.ts"],"sourcesContent":["import {\n  type InfiniteData,\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\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  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();\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    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\n  const history = useInfiniteQuery({\n    queryKey: historyKey,\n    initialPageParam: pageSize,\n    gcTime,\n    queryFn: ({ pageParam, signal }) =>\n      fetchPageRef.current({ limit: pageSize, offset: pageParam, filter: normalizedFilter, signal }),\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\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    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/packages/agent-runtime/src/use-conversation-list.js

@@ -0,0 +1,139 @@
+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";
+const DEFAULT_PAGE_SIZE = 20;
+const DEFAULT_STALE_TIME_MS = 3e4;
+const DEFAULT_GC_TIME_MS = 10 * 60 * 1e3;
+function useConversationList(options) {
+  var _a, _b, _c;
+  const {
+    filter,
+    pageSize = DEFAULT_PAGE_SIZE,
+    scopeKey = CONVERSATION_LIST_DEFAULT_SCOPE_KEY,
+    enabled,
+    staleTime = DEFAULT_STALE_TIME_MS,
+    gcTime = DEFAULT_GC_TIME_MS,
+    refetchOnMount,
+    refetchOnWindowFocus,
+    refetchInterval = false,
+    retry
+  } = options;
+  const queryClient = useQueryClient();
+  const fetchPageRef = useRef(options.fetchPage);
+  fetchPageRef.current = options.fetchPage;
+  const normalizedFilter = normalizeConversationListFilter(filter ?? {});
+  const filterKey = conversationListFilterKey(normalizedFilter);
+  const firstPageKey = useMemo(
+    () => conversationListQueryKeys.firstPage(scopeKey, filterKey, pageSize),
+    [scopeKey, filterKey, pageSize]
+  );
+  const historyKey = useMemo(
+    () => conversationListQueryKeys.history(scopeKey, filterKey, pageSize),
+    [scopeKey, filterKey, pageSize]
+  );
+  const passthrough = {
+    ...enabled !== void 0 ? { enabled } : {},
+    ...refetchOnMount !== void 0 ? { refetchOnMount } : {},
+    ...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 historyPages = (_a = history.data) == null ? void 0 : _a.pages;
+  const hasLoadedHistory = ((historyPages == null ? void 0 : historyPages.length) ?? 0) > 0;
+  const conversations = useMemo(
+    () => mergeConversationPages([
+      ...firstPage.data ? [firstPage.data] : [],
+      ...historyPages ?? []
+    ]),
+    [firstPage.data, historyPages]
+  );
+  const fetchNextHistoryPage = history.fetchNextPage;
+  const refetchHistoryFirstPage = history.refetch;
+  const fetchNextPage = useCallback(
+    () => hasLoadedHistory ? fetchNextHistoryPage() : refetchHistoryFirstPage(),
+    [hasLoadedHistory, fetchNextHistoryPage, refetchHistoryFirstPage]
+  );
+  const refresh = useCallback(() => firstPage.refetch(), [firstPage.refetch]);
+  const invalidate = useCallback(
+    () => invalidateConversationListCaches(queryClient, { scopeKey }),
+    [queryClient, scopeKey]
+  );
+  const prependConversation = useCallback(
+    (item) => {
+      queryClient.setQueryData(
+        firstPageKey,
+        (page) => page ? prependConversationToPage(page, item) : page
+      );
+    },
+    [queryClient, firstPageKey]
+  );
+  const removeConversation = useCallback(
+    (threadId) => {
+      queryClient.setQueryData(
+        firstPageKey,
+        (page) => page ? removeConversationFromPage(page, threadId) : page
+      );
+      queryClient.setQueryData(
+        historyKey,
+        (data) => data ? { ...data, pages: data.pages.map((page) => removeConversationFromPage(page, threadId)) } : data
+      );
+    },
+    [queryClient, firstPageKey, historyKey]
+  );
+  const patchConversation = useCallback(
+    (threadId, patch) => {
+      const match = (item) => item.threadId === threadId;
+      queryClient.setQueryData(
+        firstPageKey,
+        (page) => page ? patchConversationsInPage(page, match, patch) : page
+      );
+      queryClient.setQueryData(
+        historyKey,
+        (data) => data ? {
+          ...data,
+          pages: data.pages.map((page) => patchConversationsInPage(page, match, patch))
+        } : data
+      );
+    },
+    [queryClient, firstPageKey, historyKey]
+  );
+  return {
+    conversations,
+    totalCount: ((_b = firstPage.data) == null ? void 0 : _b.totalCount) ?? null,
+    isLoading: firstPage.isLoading,
+    isFetching: firstPage.isFetching || history.isFetching,
+    hasResolvedFirstPage: firstPage.data !== void 0,
+    hasNextPage: hasLoadedHistory ? history.hasNextPage ?? false : ((_c = firstPage.data) == null ? void 0 : _c.hasMore) ?? false,
+    isFetchingNextPage: history.isFetchingNextPage || !hasLoadedHistory && history.isFetching,
+    fetchNextPage,
+    refresh,
+    invalidate,
+    prependConversation,
+    removeConversation,
+    patchConversation
+  };
+}
+export {
+  useConversationList
+};
+//# sourceMappingURL=use-conversation-list.js.map

package/dist/packages/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  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\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  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();\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    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\n  const history = useInfiniteQuery({\n    queryKey: historyKey,\n    initialPageParam: pageSize,\n    gcTime,\n    queryFn: ({ pageParam, signal }) =>\n      fetchPageRef.current({ limit: pageSize, offset: pageParam, filter: normalizedFilter, signal }),\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\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    fetchNextPage,\n    refresh,\n    invalidate,\n    prependConversation,\n    removeConversation,\n    patchConversation,\n  };\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const store = require("@assistant-ui/store");
+const react = require("react");
+const editCommand = require("./edit-command.cjs");
+function useDeepAgentMessageEditSubmit() {
+  const aui = store.useAui();
+  return react.useCallback(async () => {
+    const composer = aui.message().composer();
+    const text = composer.getState().text.trim();
+    if (!text) return false;
+    const sourceId = aui.message().getState().id;
+    const readExtras = () => editCommand.readDeepAgentStatewireExtras(aui.thread().getState().extras);
+    const extras = readExtras();
+    if (extras) {
+      const command = await editCommand.resolveDeepAgentEditCommand({ readExtras, sourceId, text });
+      if (command) {
+        void extras.sendCommand(command);
+        composer.cancel();
+        return true;
+      }
+    }
+    composer.send();
+    return true;
+  }, [aui]);
+}
+exports.useDeepAgentMessageEditSubmit = useDeepAgentMessageEditSubmit;
+//# sourceMappingURL=use-deep-agent-edit-submit.cjs.map

package/dist/packages/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 { useCallback } from 'react';\nimport { readDeepAgentStatewireExtras, resolveDeepAgentEditCommand } from './edit-command';\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`) — on a windowed wire the lane's\n * `anchorBefore` at the window edge, and older pages loaded first for a\n * message below the loaded range — instead of the library's converted-message\n * anchor, which the host rejects `wrong-anchor` after a chunked assistant turn\n * 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` only for an\n * empty draft.\n */\nexport function useDeepAgentMessageEditSubmit(): () => Promise<boolean> {\n  const aui = useAui();\n  return useCallback(async () => {\n    const composer = aui.message().composer();\n    const text = composer.getState().text.trim();\n    if (!text) return false;\n    const sourceId = aui.message().getState().id;\n    const readExtras = () => readDeepAgentStatewireExtras(aui.thread().getState().extras);\n    const extras = readExtras();\n    if (extras) {\n      const command = await resolveDeepAgentEditCommand({ readExtras, sourceId, text });\n      if (command) {\n        void extras.sendCommand(command);\n        composer.cancel();\n        return true;\n      }\n    }\n    composer.send();\n    return true;\n  }, [aui]);\n}\n"],"names":["useAui","useCallback","readDeepAgentStatewireExtras","resolveDeepAgentEditCommand"],"mappings":";;;;;AAoBO,SAAS,gCAAwD;AACtE,QAAM,MAAMA,MAAAA,OAAA;AACZ,SAAOC,MAAAA,YAAY,YAAY;AAC7B,UAAM,WAAW,IAAI,QAAA,EAAU,SAAA;AAC/B,UAAM,OAAO,SAAS,SAAA,EAAW,KAAK,KAAA;AACtC,QAAI,CAAC,KAAM,QAAO;AAClB,UAAM,WAAW,IAAI,QAAA,EAAU,WAAW;AAC1C,UAAM,aAAa,MAAMC,yCAA6B,IAAI,SAAS,SAAA,EAAW,MAAM;AACpF,UAAM,SAAS,WAAA;AACf,QAAI,QAAQ;AACV,YAAM,UAAU,MAAMC,YAAAA,4BAA4B,EAAE,YAAY,UAAU,MAAM;AAChF,UAAI,SAAS;AACX,aAAK,OAAO,YAAY,OAAO;AAC/B,iBAAS,OAAA;AACT,eAAO;AAAA,MACT;AAAA,IACF;AACA,aAAS,KAAA;AACT,WAAO;AAAA,EACT,GAAG,CAAC,GAAG,CAAC;AACV;;"}

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

@@ -0,0 +1,28 @@
+import { useAui } from "@assistant-ui/store";
+import { useCallback } from "react";
+import { resolveDeepAgentEditCommand, readDeepAgentStatewireExtras } from "./edit-command.js";
+function useDeepAgentMessageEditSubmit() {
+  const aui = useAui();
+  return useCallback(async () => {
+    const composer = aui.message().composer();
+    const text = composer.getState().text.trim();
+    if (!text) return false;
+    const sourceId = aui.message().getState().id;
+    const readExtras = () => readDeepAgentStatewireExtras(aui.thread().getState().extras);
+    const extras = readExtras();
+    if (extras) {
+      const command = await resolveDeepAgentEditCommand({ readExtras, sourceId, text });
+      if (command) {
+        void extras.sendCommand(command);
+        composer.cancel();
+        return true;
+      }
+    }
+    composer.send();
+    return true;
+  }, [aui]);
+}
+export {
+  useDeepAgentMessageEditSubmit
+};
+//# sourceMappingURL=use-deep-agent-edit-submit.js.map

package/dist/packages/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 { useCallback } from 'react';\nimport { readDeepAgentStatewireExtras, resolveDeepAgentEditCommand } from './edit-command';\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`) — on a windowed wire the lane's\n * `anchorBefore` at the window edge, and older pages loaded first for a\n * message below the loaded range — instead of the library's converted-message\n * anchor, which the host rejects `wrong-anchor` after a chunked assistant turn\n * 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` only for an\n * empty draft.\n */\nexport function useDeepAgentMessageEditSubmit(): () => Promise<boolean> {\n  const aui = useAui();\n  return useCallback(async () => {\n    const composer = aui.message().composer();\n    const text = composer.getState().text.trim();\n    if (!text) return false;\n    const sourceId = aui.message().getState().id;\n    const readExtras = () => readDeepAgentStatewireExtras(aui.thread().getState().extras);\n    const extras = readExtras();\n    if (extras) {\n      const command = await resolveDeepAgentEditCommand({ readExtras, sourceId, text });\n      if (command) {\n        void extras.sendCommand(command);\n        composer.cancel();\n        return true;\n      }\n    }\n    composer.send();\n    return true;\n  }, [aui]);\n}\n"],"names":[],"mappings":";;;AAoBO,SAAS,gCAAwD;AACtE,QAAM,MAAM,OAAA;AACZ,SAAO,YAAY,YAAY;AAC7B,UAAM,WAAW,IAAI,QAAA,EAAU,SAAA;AAC/B,UAAM,OAAO,SAAS,SAAA,EAAW,KAAK,KAAA;AACtC,QAAI,CAAC,KAAM,QAAO;AAClB,UAAM,WAAW,IAAI,QAAA,EAAU,WAAW;AAC1C,UAAM,aAAa,MAAM,6BAA6B,IAAI,SAAS,SAAA,EAAW,MAAM;AACpF,UAAM,SAAS,WAAA;AACf,QAAI,QAAQ;AACV,YAAM,UAAU,MAAM,4BAA4B,EAAE,YAAY,UAAU,MAAM;AAChF,UAAI,SAAS;AACX,aAAK,OAAO,YAAY,OAAO;AAC/B,iBAAS,OAAA;AACT,eAAO;AAAA,MACT;AAAA,IACF;AACA,aAAS,KAAA;AACT,WAAO;AAAA,EACT,GAAG,CAAC,GAAG,CAAC;AACV;"}