@dudousxd/nestjs-agent-react 0.9.0 → 0.10.0

package/dist/index.cjs

@@ -43,25 +43,37 @@ __export(src_exports, {
   applyCompletion: () => applyCompletion,
   backgroundRunsFromThread: () => backgroundRunsFromThread,
   buildTranscriptBlocks: () => buildTranscriptBlocks,
+  correctedCallIds: () => correctedCallIds,
   createSkillsSource: () => createSkillsSource,
   describeTimestamp: () => describeTimestamp,
+  describeToolCall: () => describeToolCall,
   describeUsage: () => describeUsage,
   extractMessageText: () => extractMessageText,
+  fillTemplate: () => fillTemplate,
   filterAutocompleteItems: () => filterAutocompleteItems,
   findActiveTrigger: () => findActiveTrigger,
   formatElapsed: () => formatElapsed,
   formatRelativeTime: () => formatRelativeTime,
+  groupToolActivity: () => groupToolActivity,
+  inferResultView: () => inferResultView,
+  isActionCall: () => isActionCall,
   loadStoredSpeechLang: () => loadStoredSpeechLang,
   persistSpeechLang: () => persistSpeechLang,
+  phraseFor: () => phraseFor,
+  readPath: () => readPath,
   readReasoningMs: () => readReasoningMs,
+  resolveResultView: () => resolveResultView,
   storedMessageToUiMessage: () => storedMessageToUiMessage,
   storedThreadToUiMessages: () => storedThreadToUiMessages,
+  toolCallState: () => toolCallState,
+  toolCatalogFrom: () => toolCatalogFrom,
   useAgentChat: () => useAgentChat,
   useChatTranscript: () => useChatTranscript,
   useComposerAutocomplete: () => useComposerAutocomplete,
   useElapsed: () => useElapsed,
   useSpeechRecognition: () => useSpeechRecognition,
   useStickToBottom: () => useStickToBottom,
+  useToolCatalog: () => useToolCatalog,
   useTranscriptItem: () => useTranscriptItem
 });
 module.exports = __toCommonJS(src_exports);
@@ -744,6 +756,15 @@ var AgentClient = class {
     const query = threadId === void 0 ? "" : `?threadId=${encodeURIComponent(threadId)}`;
     return this.request("GET", `/agent/skills${query}`);
   }
+  /**
+  * The tools this caller can reach through `agent` (the default agent when omitted), each with the
+  * server-declared `presentation` a chat narrates it by — the same list the model is offered.
+  * Prefer {@link useToolCatalog}, which fetches it once and shares it.
+  */
+  listTools(agent) {
+    const query = agent === void 0 ? "" : `?agent=${encodeURIComponent(agent)}`;
+    return this.request("GET", `/agent/tools${query}`);
+  }
   getThread(id) {
     return this.request("GET", `/agent/threads/${encodeURIComponent(id)}`);
   }
@@ -1026,7 +1047,280 @@ var import_react6 = __toESM(require("react"), 1);
 var import_react5 = require("react");
 
 // src/transcript/model.ts
+var import_ai2 = require("ai");
+
+// src/presentation/tool-activity.ts
 var import_ai = require("ai");
+
+// src/presentation/phrasing.ts
+function toolCatalogFrom(entries) {
+  const catalog = {};
+  for (const entry of entries) {
+    if (entry.presentation !== void 0) catalog[entry.name] = entry.presentation;
+  }
+  return catalog;
+}
+__name(toolCatalogFrom, "toolCatalogFrom");
+function readPath(value, path) {
+  return path.split(".").reduce((current, key) => {
+    if (current === null || typeof current !== "object") return void 0;
+    return current[key];
+  }, value);
+}
+__name(readPath, "readPath");
+function renderValue(value) {
+  if (value === null || value === void 0) return "";
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  if (Array.isArray(value)) return value.map(renderValue).filter(Boolean).join(", ");
+  return "";
+}
+__name(renderValue, "renderValue");
+function fillTemplate(template, context) {
+  return template.replace(/(\s*)\{([\w.]+)\}/g, (_match, space, path) => {
+    const rendered = renderValue(readPath(context, path));
+    return rendered === "" ? "" : `${space}${rendered}`;
+  }).replace(/\s{2,}/g, " ").trim();
+}
+__name(fillTemplate, "fillTemplate");
+function phraseFor(presentation, input, isSettled2, fallback = {
+  running: "Working",
+  done: "Done"
+}) {
+  if (presentation === void 0) return isSettled2 ? fallback.done : fallback.running;
+  const filled = fillTemplate(isSettled2 ? presentation.done : presentation.running, input);
+  return filled === "" ? presentation.label : filled;
+}
+__name(phraseFor, "phraseFor");
+
+// src/presentation/result-view.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+__name(isRecord, "isRecord");
+function toText(value) {
+  if (value === null || value === void 0) return "\u2014";
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+    return String(value);
+  }
+  if (Array.isArray(value)) return value.map(toText).join(", ");
+  return "\u2014";
+}
+__name(toText, "toText");
+function inferResultView(output) {
+  if (!isRecord(output)) return void 0;
+  for (const [key, value] of Object.entries(output)) {
+    if (!Array.isArray(value) || value.length === 0) continue;
+    if (value.every((entry) => typeof entry === "string")) {
+      return {
+        kind: "log",
+        lines: key
+      };
+    }
+    if (value.every(isRecord)) {
+      const first = value[0];
+      return {
+        kind: "table",
+        rows: key,
+        columns: Object.keys(first).filter((column) => !isRecord(first[column])).map((column) => ({
+          path: column,
+          label: column
+        }))
+      };
+    }
+  }
+  const fields = Object.entries(output).filter(([, value]) => [
+    "string",
+    "number",
+    "boolean"
+  ].includes(typeof value)).map(([key]) => ({
+    path: key,
+    label: key
+  }));
+  return fields.length > 0 ? {
+    kind: "metrics",
+    fields
+  } : void 0;
+}
+__name(inferResultView, "inferResultView");
+function resolveResultView(output, view, options = {}) {
+  const resolved = view ?? (options.infer === true ? inferResultView(output) : void 0);
+  if (resolved === void 0 || resolved.kind === "elsewhere") return null;
+  switch (resolved.kind) {
+    case "note": {
+      const text = fillTemplate(resolved.text, output);
+      return text === "" ? null : {
+        kind: "note",
+        text
+      };
+    }
+    case "metrics": {
+      const readings = resolved.fields.map((field) => ({
+        field,
+        value: readPath(output, field.path)
+      })).filter((entry) => entry.value !== void 0 && entry.value !== null).map(({ field, value }) => ({
+        label: field.label,
+        value: toText(value),
+        unit: field.unit ?? null
+      }));
+      return readings.length === 0 ? null : {
+        kind: "metrics",
+        readings
+      };
+    }
+    case "log": {
+      const lines = readPath(output, resolved.lines);
+      if (!Array.isArray(lines) || lines.length === 0) return null;
+      return {
+        kind: "log",
+        lines: lines.map(toText)
+      };
+    }
+    case "table": {
+      const rows = readPath(output, resolved.rows);
+      if (!Array.isArray(rows)) return null;
+      return {
+        kind: "table",
+        columns: resolved.columns,
+        rows: rows.map((row) => resolved.columns.map((column) => toText(readPath(row, column.path)))),
+        empty: rows.length === 0 ? resolved.empty ?? null : null
+      };
+    }
+  }
+}
+__name(resolveResultView, "resolveResultView");
+
+// src/presentation/tool-activity.ts
+function isActionCall(part) {
+  const metadata = part.toolMetadata;
+  return typeof metadata === "object" && metadata !== null && metadata.toolKind === "action";
+}
+__name(isActionCall, "isActionCall");
+function toolCallState(part) {
+  const output = "output" in part ? part.output : void 0;
+  const errorText = "errorText" in part ? part.errorText : void 0;
+  const outputError = output !== null && typeof output === "object" && "error" in output ? String(output.error) : void 0;
+  const isDenied = part.state === "output-denied";
+  const isFailed = part.state === "output-error" || outputError !== void 0 && !isDenied;
+  const isSettled2 = part.state === "output-available" || part.state === "output-error" || isDenied;
+  const isAwaiting = part.state === "approval-requested" || part.state === "input-available" && isActionCall(part);
+  const status = isDenied ? "denied" : isFailed ? "failed" : isSettled2 ? "done" : isAwaiting ? "awaiting-approval" : "running";
+  return {
+    status,
+    isSettled: isSettled2,
+    isFailed,
+    isDenied,
+    output,
+    error: errorText ?? outputError ?? null
+  };
+}
+__name(toolCallState, "toolCallState");
+function correctedCallIds(parts) {
+  const corrected = /* @__PURE__ */ new Set();
+  const lastSuccessByTool = /* @__PURE__ */ new Map();
+  parts.forEach((part, index) => {
+    if (part.state === "output-available" && !toolCallState(part).isFailed) {
+      lastSuccessByTool.set((0, import_ai.getToolName)(part), index);
+    }
+  });
+  parts.forEach((part, index) => {
+    const successAt = lastSuccessByTool.get((0, import_ai.getToolName)(part));
+    if (successAt !== void 0 && index < successAt && toolCallState(part).isFailed) {
+      corrected.add(part.toolCallId);
+    }
+  });
+  return corrected;
+}
+__name(correctedCallIds, "correctedCallIds");
+function describeToolCall(part, catalog, options = {}) {
+  const presentation = catalog?.[(0, import_ai.getToolName)(part)];
+  const state = toolCallState(part);
+  const input = part.input;
+  const confirm = presentation?.confirm;
+  return {
+    status: state.status,
+    phrase: phraseFor(presentation, input, state.isSettled, options.fallback),
+    label: presentation?.label ?? null,
+    icon: presentation?.icon ?? null,
+    tone: presentation?.tone ?? "neutral",
+    detail: presentation?.detail ?? null,
+    confirm: confirm === void 0 ? null : {
+      title: fillTemplate(confirm.title, input),
+      verb: confirm.verb,
+      detail: confirm.detail !== void 0 ? fillTemplate(confirm.detail, input) : null
+    },
+    result: state.status === "done" ? resolveResultView(state.output, presentation?.result, {
+      ...options.inferResult !== void 0 ? {
+        infer: options.inferResult
+      } : {}
+    }) : null,
+    error: state.error,
+    presentation: presentation ?? null
+  };
+}
+__name(describeToolCall, "describeToolCall");
+var STATUS_WEIGHT = {
+  running: 4,
+  "awaiting-approval": 3,
+  failed: 2,
+  denied: 1,
+  done: 0
+};
+function descendants(call) {
+  return call.children.flatMap((child) => [
+    child,
+    ...descendants(child)
+  ]);
+}
+__name(descendants, "descendants");
+function leaves(call) {
+  return call.children.length === 0 ? [
+    call
+  ] : call.children.flatMap(leaves);
+}
+__name(leaves, "leaves");
+function groupToolActivity(calls, options = {}) {
+  const expanded = options.expandNested === true ? calls.flatMap(leaves) : [
+    ...calls
+  ];
+  const corrected = options.hideCorrected === true ? correctedCallIds(expanded.map((call) => call.part)) : /* @__PURE__ */ new Set();
+  const groups = /* @__PURE__ */ new Map();
+  for (const call of expanded) {
+    if (corrected.has(call.toolCallId)) continue;
+    const presentation = options.catalog?.[call.name];
+    const key = options.keyOf?.(call, presentation) ?? presentation?.label ?? call.name;
+    const status = toolCallState(call.part).status;
+    const phrase = phraseFor(presentation, call.part.input, status !== "running" && status !== "awaiting-approval", options.fallback);
+    const inner = options.expandNested === true ? 0 : descendants(call).length;
+    const existing = groups.get(key);
+    if (existing === void 0) {
+      groups.set(key, {
+        key,
+        label: presentation?.label ?? null,
+        icon: presentation?.icon ?? null,
+        status,
+        count: 1,
+        phrase,
+        calls: [
+          call
+        ],
+        innerCount: inner
+      });
+      continue;
+    }
+    existing.count += 1;
+    existing.calls.push(call);
+    existing.phrase = phrase;
+    existing.innerCount += inner;
+    if (STATUS_WEIGHT[status] > STATUS_WEIGHT[existing.status]) existing.status = status;
+  }
+  return [
+    ...groups.values()
+  ];
+}
+__name(groupToolActivity, "groupToolActivity");
+
+// src/transcript/model.ts
 function buildTranscriptBlocks(message, options) {
   const blocks = [];
   let toolBuffer = [];
@@ -1043,13 +1337,19 @@ function buildTranscriptBlocks(message, options) {
     if (toolBuffer.length === 0) {
       return;
     }
-    const calls = toolBuffer.map((part) => buildToolCall(part, options.approval, approvals.get(part.toolCallId) ?? null));
+    const calls = toolBuffer.map((part) => buildToolCall(part, options.approval, approvals.get(part.toolCallId) ?? null, options.toolCatalog));
+    const roots = nestToolCalls(calls);
     blocks.push({
       kind: "tools",
       key: `${message.id}-tools-${toolCounter++}`,
       parts: toolBuffer,
       calls,
-      roots: nestToolCalls(calls)
+      roots,
+      activity: groupToolActivity(roots, {
+        ...options.toolCatalog !== void 0 ? {
+          catalog: options.toolCatalog
+        } : {}
+      })
     });
     toolBuffer = [];
   }
@@ -1086,7 +1386,7 @@ function buildTranscriptBlocks(message, options) {
   }
   __name(flushAll, "flushAll");
   for (const part of message.parts ?? []) {
-    if ((0, import_ai.isToolUIPart)(part)) {
+    if ((0, import_ai2.isToolUIPart)(part)) {
       const elicitation = options.elicitation;
       if (elicitation !== void 0) {
         const request = readElicitationRequest(part);
@@ -1106,7 +1406,7 @@ function buildTranscriptBlocks(message, options) {
       toolBuffer.push(part);
       continue;
     }
-    if ((0, import_ai.isFileUIPart)(part)) {
+    if ((0, import_ai2.isFileUIPart)(part)) {
       flushTools();
       flushSources();
       fileBuffer.push(part);
@@ -1116,7 +1416,7 @@ function buildTranscriptBlocks(message, options) {
       continue;
     }
     flushAll();
-    if ((0, import_ai.isDataUIPart)(part)) {
+    if ((0, import_ai2.isDataUIPart)(part)) {
       const ui = part.type === UI_PART ? readUiComponent(part) : null;
       if (ui !== null) {
         blocks.push({
@@ -1127,7 +1427,7 @@ function buildTranscriptBlocks(message, options) {
       }
       continue;
     }
-    if ((0, import_ai.isTextUIPart)(part)) {
+    if ((0, import_ai2.isTextUIPart)(part)) {
       blocks.push({
         kind: "text",
         key: `${message.id}-text-${textCounter++}`,
@@ -1136,7 +1436,7 @@ function buildTranscriptBlocks(message, options) {
       });
       continue;
     }
-    if ((0, import_ai.isReasoningUIPart)(part)) {
+    if ((0, import_ai2.isReasoningUIPart)(part)) {
       const key = `${message.id}-reasoning-${reasoningCounter++}`;
       const isStreaming = part.state === "streaming";
       blocks.push({
@@ -1198,7 +1498,7 @@ function isSettled(state) {
 __name(isSettled, "isSettled");
 function toolKind(part) {
   const metadata = part.toolMetadata;
-  return isRecord(metadata) && typeof metadata.toolKind === "string" ? metadata.toolKind : void 0;
+  return isRecord2(metadata) && typeof metadata.toolKind === "string" ? metadata.toolKind : void 0;
 }
 __name(toolKind, "toolKind");
 function isAwaitingApproval(part) {
@@ -1213,7 +1513,7 @@ function isAwaitingApproval(part) {
 __name(isAwaitingApproval, "isAwaitingApproval");
 function toolParentId(part) {
   const metadata = part.toolMetadata;
-  return isRecord(metadata) && typeof metadata.parentId === "string" ? metadata.parentId : null;
+  return isRecord2(metadata) && typeof metadata.parentId === "string" ? metadata.parentId : null;
 }
 __name(toolParentId, "toolParentId");
 function nestToolCalls(calls) {
@@ -1246,18 +1546,19 @@ function isAncestor(call, candidate, byId) {
   return false;
 }
 __name(isAncestor, "isAncestor");
-function buildToolCall(part, options, approval) {
+function buildToolCall(part, options, approval, catalog) {
   const toolCallId = part.toolCallId;
   const awaiting = isAwaitingApproval(part);
   const sending = awaiting ? options?.submitting(toolCallId) ?? null : null;
   return {
     part,
     toolCallId,
-    name: (0, import_ai.getToolName)(part),
+    name: (0, import_ai2.getToolName)(part),
     toolKind: toolKind(part) ?? null,
     parentId: toolParentId(part),
     children: [],
     approval,
+    description: describeToolCall(part, catalog),
     isAwaitingApproval: awaiting,
     approve: {
       available: awaiting && options?.canApprove === true,
@@ -1275,17 +1576,17 @@ function buildToolCall(part, options, approval) {
 __name(buildToolCall, "buildToolCall");
 function readElicitationRequest(part) {
   const input = part.input;
-  if (!isRecord(input) || !Array.isArray(input.questions) || input.questions.length === 0) {
+  if (!isRecord2(input) || !Array.isArray(input.questions) || input.questions.length === 0) {
     return null;
   }
   const questions = [];
   for (const candidate of input.questions) {
-    if (!isRecord(candidate) || typeof candidate.id !== "string" || typeof candidate.prompt !== "string" || !Array.isArray(candidate.options) || candidate.options.length === 0) {
+    if (!isRecord2(candidate) || typeof candidate.id !== "string" || typeof candidate.prompt !== "string" || !Array.isArray(candidate.options) || candidate.options.length === 0) {
       return null;
     }
     const options = [];
     for (const option of candidate.options) {
-      if (!isRecord(option) || typeof option.value !== "string" || typeof option.label !== "string") {
+      if (!isRecord2(option) || typeof option.value !== "string" || typeof option.label !== "string") {
         return null;
       }
       options.push({
@@ -1310,7 +1611,7 @@ function readElicitationRequest(part) {
 __name(readElicitationRequest, "readElicitationRequest");
 function readElicitationOutcome(part) {
   const output = part.output;
-  if (!isRecord(output) || !isRecord(output.answers) || typeof output.skipped !== "boolean") {
+  if (!isRecord2(output) || !isRecord2(output.answers) || typeof output.skipped !== "boolean") {
     return null;
   }
   const answers = {};
@@ -1397,7 +1698,7 @@ function readApprovals(parts) {
       continue;
     }
     const data = part.data;
-    if (!isRecord(data) || typeof data.id !== "string" || typeof data.approver !== "string") {
+    if (!isRecord2(data) || typeof data.id !== "string" || typeof data.approver !== "string") {
       continue;
     }
     out.set(data.id, {
@@ -1411,7 +1712,7 @@ function readApprovals(parts) {
 __name(readApprovals, "readApprovals");
 function readUiComponent(part) {
   const data = part.data;
-  if (!isRecord(data) || typeof data.component !== "string") {
+  if (!isRecord2(data) || typeof data.component !== "string") {
     return null;
   }
   const id = typeof data.id === "string" ? data.id : part.id;
@@ -1421,18 +1722,18 @@ function readUiComponent(part) {
   return {
     id,
     component: data.component,
-    props: isRecord(data.props) ? data.props : {},
+    props: isRecord2(data.props) ? data.props : {},
     version: typeof data.version === "number" ? data.version : null
   };
 }
 __name(readUiComponent, "readUiComponent");
-function isRecord(value) {
+function isRecord2(value) {
   return typeof value === "object" && value !== null;
 }
-__name(isRecord, "isRecord");
+__name(isRecord2, "isRecord");
 function readQuery(part) {
   const input = part.input;
-  if (!isRecord(input) || typeof input.query !== "string") {
+  if (!isRecord2(input) || typeof input.query !== "string") {
     return null;
   }
   return input.query;
@@ -1440,12 +1741,12 @@ function readQuery(part) {
 __name(readQuery, "readQuery");
 function readPassages(part) {
   const output = part.output;
-  if (!isRecord(output) || !Array.isArray(output.passages) || output.passages.length === 0) {
+  if (!isRecord2(output) || !Array.isArray(output.passages) || output.passages.length === 0) {
     return null;
   }
   const passages = [];
   for (const candidate of output.passages) {
-    if (!isRecord(candidate) || typeof candidate.id !== "string" || typeof candidate.text !== "string") {
+    if (!isRecord2(candidate) || typeof candidate.id !== "string" || typeof candidate.text !== "string") {
       return null;
     }
     passages.push({
@@ -1455,7 +1756,7 @@ function readPassages(part) {
       ...typeof candidate.source === "string" ? {
         source: candidate.source
       } : {},
-      ...isRecord(candidate.metadata) ? {
+      ...isRecord2(candidate.metadata) ? {
         metadata: candidate.metadata
       } : {}
     });
@@ -1466,7 +1767,7 @@ __name(readPassages, "readPassages");
 function extractMessageText(parts) {
   const out = [];
   for (const part of parts ?? []) {
-    if ((0, import_ai.isTextUIPart)(part)) {
+    if ((0, import_ai2.isTextUIPart)(part)) {
       out.push(part.text);
     }
   }
@@ -1922,6 +2223,9 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
         ...options.sources !== void 0 ? {
           sources: options.sources
         } : {},
+        ...options.toolCatalog !== void 0 ? {
+          toolCatalog: options.toolCatalog
+        } : {},
         ...options.onAnswer !== void 0 ? {
           elicitation: {
             picked: /* @__PURE__ */ __name((toolCallId, questionId) => picks.get(pickKey(toolCallId, questionId)), "picked"),
@@ -2697,6 +3001,78 @@ function isPromise(value) {
 }
 __name(isPromise, "isPromise");
 
+// src/presentation/use-tool-catalog.ts
+var import_react8 = require("react");
+var shared = /* @__PURE__ */ new WeakMap();
+function load(client, agent) {
+  let byAgent = shared.get(client);
+  if (byAgent === void 0) {
+    byAgent = /* @__PURE__ */ new Map();
+    shared.set(client, byAgent);
+  }
+  const key = agent ?? "";
+  const cached = byAgent.get(key);
+  if (cached !== void 0) return cached;
+  const request = client.listTools(agent).catch((error) => {
+    byAgent.delete(key);
+    throw error;
+  });
+  byAgent.set(key, request);
+  return request;
+}
+__name(load, "load");
+function useToolCatalog(options) {
+  const { client, agent, enabled = true } = options;
+  const [entries, setEntries] = (0, import_react8.useState)([]);
+  const [isLoading, setLoading] = (0, import_react8.useState)(enabled);
+  const [error, setError] = (0, import_react8.useState)(null);
+  const [generation, setGeneration] = (0, import_react8.useState)(0);
+  (0, import_react8.useEffect)(() => {
+    if (!enabled) {
+      setLoading(false);
+      return;
+    }
+    let cancelled = false;
+    setLoading(true);
+    load(client, agent).then((loaded) => {
+      if (cancelled) return;
+      setEntries(loaded);
+      setError(null);
+      setLoading(false);
+    }, (failure) => {
+      if (cancelled) return;
+      setError(failure instanceof Error ? failure : new Error(String(failure)));
+      setLoading(false);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [
+    client,
+    agent,
+    enabled,
+    generation
+  ]);
+  const refresh = (0, import_react8.useCallback)(() => {
+    shared.get(client)?.delete(agent ?? "");
+    setGeneration((current) => current + 1);
+  }, [
+    client,
+    agent
+  ]);
+  const catalog = (0, import_react8.useMemo)(() => toolCatalogFrom(entries), [
+    entries
+  ]);
+  return {
+    catalog,
+    entries,
+    isLoading,
+    error,
+    refresh
+  };
+}
+__name(useToolCatalog, "useToolCatalog");
+
 // src/stored-message-to-ui-message.ts
 var import_nestjs_agent_core = require("@dudousxd/nestjs-agent-core");
 function isRefusal(result) {
@@ -2857,21 +3233,21 @@ function sumUsage(rows) {
 __name(sumUsage, "sumUsage");
 
 // src/use-agent-chat.ts
-var import_react8 = require("@ai-sdk/react");
-var import_react9 = require("react");
+var import_react9 = require("@ai-sdk/react");
+var import_react10 = require("react");
 function useAgentChat(options) {
-  const latest = (0, import_react9.useRef)(options);
+  const latest = (0, import_react10.useRef)(options);
   latest.current = options;
-  const [runId, setRunId] = (0, import_react9.useState)(options.resumeRunId);
-  const runIdRef = (0, import_react9.useRef)(runId);
+  const [runId, setRunId] = (0, import_react10.useState)(options.resumeRunId);
+  const runIdRef = (0, import_react10.useRef)(runId);
   runIdRef.current = runId;
-  const settlingRunIdRef = (0, import_react9.useRef)(void 0);
-  const autoResumeRunIdRef = (0, import_react9.useRef)(void 0);
-  const [autoResume, setAutoResume] = (0, import_react9.useState)(false);
-  const [activeRunId, setActiveRunId] = (0, import_react9.useState)(null);
-  const regenerateNext = (0, import_react9.useRef)(false);
-  const createdThreadId = (0, import_react9.useRef)(void 0);
-  const client = (0, import_react9.useMemo)(() => {
+  const settlingRunIdRef = (0, import_react10.useRef)(void 0);
+  const autoResumeRunIdRef = (0, import_react10.useRef)(void 0);
+  const [autoResume, setAutoResume] = (0, import_react10.useState)(false);
+  const [activeRunId, setActiveRunId] = (0, import_react10.useState)(null);
+  const regenerateNext = (0, import_react10.useRef)(false);
+  const createdThreadId = (0, import_react10.useRef)(void 0);
+  const client = (0, import_react10.useMemo)(() => {
     if (options.client) return options.client;
     return new AgentClient({
       ...options.baseUrl !== void 0 ? {
@@ -2886,7 +3262,7 @@ function useAgentChat(options) {
       getHeaders: /* @__PURE__ */ __name(async () => mergeHeaders(latest.current), "getHeaders")
     });
   }, []);
-  (0, import_react9.useEffect)(() => {
+  (0, import_react10.useEffect)(() => {
     if (!options.resume || options.threadId === void 0) return;
     let cancelled = false;
     const threadId = options.threadId;
@@ -2906,7 +3282,7 @@ function useAgentChat(options) {
     options.resume,
     options.threadId
   ]);
-  const transport = (0, import_react9.useMemo)(() => {
+  const transport = (0, import_react10.useMemo)(() => {
     function onMeta(meta) {
       settlingRunIdRef.current = meta.runId;
       setRunId(meta.runId);
@@ -2955,8 +3331,8 @@ function useAgentChat(options) {
       }, "onAttemptStart")
     });
   }, []);
-  const backgroundRef = (0, import_react9.useRef)(() => Promise.resolve());
-  const chat = (0, import_react8.useChat)({
+  const backgroundRef = (0, import_react10.useRef)(() => Promise.resolve());
+  const chat = (0, import_react9.useChat)({
     transport,
     resume: options.resumeRunId !== void 0 || autoResume,
     ...options.threadId !== void 0 ? {
@@ -2986,13 +3362,13 @@ function useAgentChat(options) {
       }
     }, "onFinish")
   });
-  const chatRef = (0, import_react9.useRef)(chat);
+  const chatRef = (0, import_react10.useRef)(chat);
   chatRef.current = chat;
-  const turnInFlight = (0, import_react9.useRef)(false);
-  const isTurnInFlight = (0, import_react9.useCallback)(() => turnInFlight.current || transport.isAttemptLive, [
+  const turnInFlight = (0, import_react10.useRef)(false);
+  const isTurnInFlight = (0, import_react10.useCallback)(() => turnInFlight.current || transport.isAttemptLive, [
     transport
   ]);
-  const sendMessage = (0, import_react9.useCallback)(async (...args) => {
+  const sendMessage = (0, import_react10.useCallback)(async (...args) => {
     if (isTurnInFlight()) return;
     turnInFlight.current = true;
     try {
@@ -3003,15 +3379,15 @@ function useAgentChat(options) {
   }, [
     isTurnInFlight
   ]);
-  const addToolResult = (0, import_react9.useCallback)(({ tool, toolCallId, output }) => chatRef.current.addToolResult({
+  const addToolResult = (0, import_react10.useCallback)(({ tool, toolCallId, output }) => chatRef.current.addToolResult({
     tool,
     toolCallId,
     output
   }), []);
-  const [threads, setThreads] = (0, import_react9.useState)([]);
-  const [quota, setQuota] = (0, import_react9.useState)(null);
-  const [backgroundRuns, setBackgroundRuns] = (0, import_react9.useState)([]);
-  const refreshBackground = (0, import_react9.useCallback)(async () => {
+  const [threads, setThreads] = (0, import_react10.useState)([]);
+  const [quota, setQuota] = (0, import_react10.useState)(null);
+  const [backgroundRuns, setBackgroundRuns] = (0, import_react10.useState)([]);
+  const refreshBackground = (0, import_react10.useCallback)(async () => {
     const threadId = latest.current.threadId ?? createdThreadId.current;
     if (threadId === void 0) {
       return;
@@ -3036,7 +3412,7 @@ function useAgentChat(options) {
   ]);
   backgroundRef.current = refreshBackground;
   const isWorking = backgroundRuns.some((run) => run.status === "running");
-  (0, import_react9.useEffect)(() => {
+  (0, import_react10.useEffect)(() => {
     if (options.background !== true || options.threadId === void 0) {
       return;
     }
@@ -3046,7 +3422,7 @@ function useAgentChat(options) {
     options.threadId,
     refreshBackground
   ]);
-  (0, import_react9.useEffect)(() => {
+  (0, import_react10.useEffect)(() => {
     const every = latest.current.backgroundPollMs ?? 5e3;
     if (latest.current.background !== true || !isWorking || every <= 0) {
       return;
@@ -3057,26 +3433,26 @@ function useAgentChat(options) {
     isWorking,
     refreshBackground
   ]);
-  const loadThreads = (0, import_react9.useCallback)(async () => {
+  const loadThreads = (0, import_react10.useCallback)(async () => {
     const list = await client.listThreads();
     setThreads(list);
     return list;
   }, [
     client
   ]);
-  const loadThread = (0, import_react9.useCallback)((id) => client.getThread(id), [
+  const loadThread = (0, import_react10.useCallback)((id) => client.getThread(id), [
     client
   ]);
-  const deleteThread = (0, import_react9.useCallback)(async (id) => {
+  const deleteThread = (0, import_react10.useCallback)(async (id) => {
     await client.deleteThread(id);
     setThreads((current) => current.filter((thread) => thread.id !== id));
   }, [
     client
   ]);
-  const forkThread = (0, import_react9.useCallback)((threadId, messageId) => client.forkFromMessage(threadId, messageId), [
+  const forkThread = (0, import_react10.useCallback)((threadId, messageId) => client.forkFromMessage(threadId, messageId), [
     client
   ]);
-  const renameThread = (0, import_react9.useCallback)(async (id, title) => {
+  const renameThread = (0, import_react10.useCallback)(async (id, title) => {
     await client.renameThread(id, title);
     setThreads((current) => current.map((thread) => thread.id === id ? {
       ...thread,
@@ -3085,24 +3461,24 @@ function useAgentChat(options) {
   }, [
     client
   ]);
-  const promoteThread = (0, import_react9.useCallback)(async (id) => {
+  const promoteThread = (0, import_react10.useCallback)(async (id) => {
     await client.promoteThread(id);
     await loadThreads();
   }, [
     client,
     loadThreads
   ]);
-  const truncateFromMessage = (0, import_react9.useCallback)((threadId, messageId) => client.truncateFromMessage(threadId, messageId).then(() => void 0), [
+  const truncateFromMessage = (0, import_react10.useCallback)((threadId, messageId) => client.truncateFromMessage(threadId, messageId).then(() => void 0), [
     client
   ]);
-  const loadQuota = (0, import_react9.useCallback)(async () => {
+  const loadQuota = (0, import_react10.useCallback)(async () => {
     const today = await client.getQuotaToday();
     setQuota(today);
     return today;
   }, [
     client
   ]);
-  const cancel = (0, import_react9.useCallback)(async () => {
+  const cancel = (0, import_react10.useCallback)(async () => {
     chatRef.current.stop();
     const activeRunId2 = runIdRef.current;
     if (activeRunId2) {
@@ -3114,14 +3490,14 @@ function useAgentChat(options) {
   }, [
     client
   ]);
-  const approve = (0, import_react9.useCallback)(async ({ toolCallId }) => {
+  const approve = (0, import_react10.useCallback)(async ({ toolCallId }) => {
     await client.approveToolCall({
       toolCallId
     });
   }, [
     client
   ]);
-  const reject = (0, import_react9.useCallback)(async ({ toolCallId, reason }) => {
+  const reject = (0, import_react10.useCallback)(async ({ toolCallId, reason }) => {
     await client.rejectToolCall({
       toolCallId,
       ...reason !== void 0 ? {
@@ -3131,7 +3507,7 @@ function useAgentChat(options) {
   }, [
     client
   ]);
-  const answer = (0, import_react9.useCallback)(async ({ toolCallId, answers }) => {
+  const answer = (0, import_react10.useCallback)(async ({ toolCallId, answers }) => {
     await client.answerToolCall({
       toolCallId,
       ...answers !== void 0 ? {
@@ -3141,14 +3517,14 @@ function useAgentChat(options) {
   }, [
     client
   ]);
-  const skip = (0, import_react9.useCallback)(async ({ toolCallId }) => {
+  const skip = (0, import_react10.useCallback)(async ({ toolCallId }) => {
     await client.skipToolCall({
       toolCallId
     });
   }, [
     client
   ]);
-  const regenerate = (0, import_react9.useCallback)(() => {
+  const regenerate = (0, import_react10.useCallback)(() => {
     if (isTurnInFlight()) return;
     regenerateNext.current = true;
     turnInFlight.current = true;
@@ -3214,25 +3590,37 @@ __name(mergeHeaders, "mergeHeaders");
   applyCompletion,
   backgroundRunsFromThread,
   buildTranscriptBlocks,
+  correctedCallIds,
   createSkillsSource,
   describeTimestamp,
+  describeToolCall,
   describeUsage,
   extractMessageText,
+  fillTemplate,
   filterAutocompleteItems,
   findActiveTrigger,
   formatElapsed,
   formatRelativeTime,
+  groupToolActivity,
+  inferResultView,
+  isActionCall,
   loadStoredSpeechLang,
   persistSpeechLang,
+  phraseFor,
+  readPath,
   readReasoningMs,
+  resolveResultView,
   storedMessageToUiMessage,
   storedThreadToUiMessages,
+  toolCallState,
+  toolCatalogFrom,
   useAgentChat,
   useChatTranscript,
   useComposerAutocomplete,
   useElapsed,
   useSpeechRecognition,
   useStickToBottom,
+  useToolCatalog,
   useTranscriptItem
 });
 //# sourceMappingURL=index.cjs.map