@dudousxd/nestjs-agent-react 0.9.0 → 0.11.0

package/dist/index.cjs

@@ -41,27 +41,41 @@ __export(src_exports, {
   MessageList: () => MessageList,
   SPEECH_LANGUAGES: () => SPEECH_LANGUAGES,
   applyCompletion: () => applyCompletion,
+  approvalCountdown: () => approvalCountdown,
   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,
+  useApprovalCountdown: () => useApprovalCountdown,
   useChatTranscript: () => useChatTranscript,
   useComposerAutocomplete: () => useComposerAutocomplete,
   useElapsed: () => useElapsed,
   useSpeechRecognition: () => useSpeechRecognition,
   useStickToBottom: () => useStickToBottom,
+  useToolCatalog: () => useToolCatalog,
   useTranscriptItem: () => useTranscriptItem
 });
 module.exports = __toCommonJS(src_exports);
@@ -509,6 +523,10 @@ var AgentChatTransport = class {
                 });
               }
               break;
+            case "approval-settled":
+              ensureStep();
+              forwardAsData(event, false);
+              break;
             case "ui":
               ensureStep();
               closeRuns();
@@ -744,6 +762,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)}`);
   }
@@ -799,6 +826,10 @@ var AgentClient = class {
   cancelStream(runId) {
     return this.request("POST", `/agent/chat/${encodeURIComponent(runId)}/cancel`);
   }
+  /**
+  * `remember` approves later calls of the same tool in the same thread; `via` names the surface
+  * the decision came through (the server records `'web'` when omitted).
+  */
   approveToolCall(input) {
     return this.request("POST", "/agent/tool-call/approve", input);
   }
@@ -1026,7 +1057,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 +1347,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, approvalOf(approvals.get(part.toolCallId), part), 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 +1396,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,17 +1416,17 @@ 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);
       continue;
     }
-    if (part.type === APPROVAL_PART) {
+    if (part.type === APPROVAL_PART || part.type === SETTLED_PART) {
       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 +1437,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 +1446,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 +1508,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 +1523,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,23 +1556,28 @@ 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,
       isSubmitting: sending === "approve",
-      run: /* @__PURE__ */ __name(() => options?.approve(toolCallId), "run")
+      // Read by field, not passed through: `onClick={call.approve.run}` hands this a click event,
+      // and a host's handler must not receive that as its options.
+      run: /* @__PURE__ */ __name((approveOptions) => approveOptions?.remember === true ? options?.approve(toolCallId, {
+        remember: true
+      }) : options?.approve(toolCallId), "run")
     },
     reject: {
       available: awaiting && options?.canReject === true,
@@ -1275,17 +1590,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 +1625,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 = {};
@@ -1390,28 +1705,93 @@ function buildElicitationBlock(key, part, request, options) {
 __name(buildElicitationBlock, "buildElicitationBlock");
 var UI_PART = "data-ui";
 var APPROVAL_PART = "data-approval-requested";
+var SETTLED_PART = "data-approval-settled";
+var SETTLED_STATUSES = [
+  "approved",
+  "rejected",
+  "expired"
+];
 function readApprovals(parts) {
   const out = /* @__PURE__ */ new Map();
+  const entry = /* @__PURE__ */ __name((id) => {
+    let found = out.get(id);
+    if (found === void 0) {
+      found = {
+        approver: null,
+        expiresAt: null,
+        reason: null,
+        status: null,
+        remember: false,
+        decidedBy: null,
+        decidedVia: null,
+        decisionReason: null
+      };
+      out.set(id, found);
+    }
+    return found;
+  }, "entry");
   for (const part of parts) {
-    if (part.type !== APPROVAL_PART) {
+    if (part.type !== APPROVAL_PART && part.type !== SETTLED_PART) {
       continue;
     }
     const data = part.data;
-    if (!isRecord(data) || typeof data.id !== "string" || typeof data.approver !== "string") {
+    if (!isRecord2(data) || typeof data.id !== "string") {
       continue;
     }
-    out.set(data.id, {
-      approver: data.approver,
-      expiresAt: typeof data.expiresAt === "string" ? data.expiresAt : null,
-      reason: typeof data.reason === "string" ? data.reason : null
-    });
+    const approval = entry(data.id);
+    if (part.type === APPROVAL_PART) {
+      if (typeof data.approver !== "string") {
+        continue;
+      }
+      approval.approver = data.approver;
+      approval.expiresAt = typeof data.expiresAt === "string" ? data.expiresAt : null;
+      approval.reason = typeof data.reason === "string" ? data.reason : null;
+      continue;
+    }
+    if (typeof data.status !== "string" || !SETTLED_STATUSES.includes(data.status)) {
+      continue;
+    }
+    approval.status = data.status;
+    if (approval.approver === null && typeof data.approver === "string") {
+      approval.approver = data.approver;
+    }
+    approval.remember = data.remember === true;
+    approval.decidedBy = typeof data.decidedBy === "string" ? data.decidedBy : null;
+    approval.decidedVia = typeof data.decidedVia === "string" ? data.decidedVia : null;
+    approval.decisionReason = typeof data.reason === "string" ? data.reason : null;
   }
   return out;
 }
 __name(readApprovals, "readApprovals");
+function approvalOf(parts, call) {
+  if (parts === void 0 || parts.approver === null) {
+    return null;
+  }
+  return {
+    approver: parts.approver,
+    expiresAt: parts.expiresAt,
+    reason: parts.reason,
+    status: parts.status ?? statusFromPart(call),
+    remember: parts.remember,
+    decidedBy: parts.decidedBy,
+    decidedVia: parts.decidedVia,
+    decisionReason: parts.decisionReason
+  };
+}
+__name(approvalOf, "approvalOf");
+function statusFromPart(call) {
+  if (call.state === "output-denied") {
+    return "rejected";
+  }
+  if (call.state === "output-available" || call.state === "output-error") {
+    return "approved";
+  }
+  return "pending";
+}
+__name(statusFromPart, "statusFromPart");
 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 +1801,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 +1820,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 +1835,7 @@ function readPassages(part) {
       ...typeof candidate.source === "string" ? {
         source: candidate.source
       } : {},
-      ...isRecord(candidate.metadata) ? {
+      ...isRecord2(candidate.metadata) ? {
         metadata: candidate.metadata
       } : {}
     });
@@ -1466,7 +1846,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);
     }
   }
@@ -1794,10 +2174,10 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
   }, [
     settle
   ]);
-  const approve = (0, import_react5.useCallback)((toolCallId) => {
+  const approve = (0, import_react5.useCallback)((toolCallId, options2) => {
     const onApprove = latest.current.options.onApprove;
     if (onApprove) {
-      settle(toolCallId, "approve", () => onApprove(toolCallId));
+      settle(toolCallId, "approve", () => options2 === void 0 ? onApprove(toolCallId) : onApprove(toolCallId, options2));
     }
   }, [
     settle
@@ -1922,6 +2302,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 +3080,121 @@ 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/approvals/countdown.ts
+var import_react9 = require("react");
+function approvalCountdown(expiresAt, now = Date.now()) {
+  const deadline = expiresAt == null ? Number.NaN : Date.parse(expiresAt);
+  if (!Number.isFinite(deadline)) {
+    return {
+      remainingMs: null,
+      isExpired: false
+    };
+  }
+  const remainingMs = Math.max(0, deadline - now);
+  return {
+    remainingMs,
+    isExpired: remainingMs === 0
+  };
+}
+__name(approvalCountdown, "approvalCountdown");
+function useApprovalCountdown(expiresAt, options = {}) {
+  const { intervalMs = 1e3 } = options;
+  const nowRef = (0, import_react9.useRef)(options.now ?? Date.now);
+  nowRef.current = options.now ?? Date.now;
+  const [state, setState] = (0, import_react9.useState)(() => approvalCountdown(expiresAt, nowRef.current()));
+  (0, import_react9.useEffect)(() => {
+    const read = /* @__PURE__ */ __name(() => approvalCountdown(expiresAt, nowRef.current()), "read");
+    const first = read();
+    setState(first);
+    if (first.remainingMs === null || first.isExpired) {
+      return;
+    }
+    const timer = setInterval(() => {
+      const next = read();
+      setState(next);
+      if (next.isExpired) clearInterval(timer);
+    }, intervalMs);
+    return () => clearInterval(timer);
+  }, [
+    expiresAt,
+    intervalMs
+  ]);
+  return state;
+}
+__name(useApprovalCountdown, "useApprovalCountdown");
+
 // src/stored-message-to-ui-message.ts
 var import_nestjs_agent_core = require("@dudousxd/nestjs-agent-core");
 function isRefusal(result) {
@@ -2756,6 +3254,41 @@ function storedMessageToUiMessage(message) {
       }
     });
   }
+  for (const approval of message.approvals ?? []) {
+    parts.push({
+      type: "data-approval-requested",
+      id: approval.toolCallId,
+      data: {
+        id: approval.toolCallId,
+        approver: approval.approver,
+        ...approval.expiresAt !== void 0 ? {
+          expiresAt: approval.expiresAt
+        } : {}
+      }
+    });
+    if (approval.status !== "pending") {
+      parts.push({
+        type: "data-approval-settled",
+        id: approval.toolCallId,
+        data: {
+          id: approval.toolCallId,
+          status: approval.status,
+          ...approval.decidedBy !== void 0 ? {
+            decidedBy: approval.decidedBy
+          } : {},
+          ...approval.decidedVia !== void 0 ? {
+            decidedVia: approval.decidedVia
+          } : {},
+          ...approval.remember === true ? {
+            remember: true
+          } : {},
+          ...approval.reason !== void 0 ? {
+            reason: approval.reason
+          } : {}
+        }
+      });
+    }
+  }
   for (const call of message.toolCalls ?? []) {
     const result = message.toolResults?.find((candidate) => candidate.id === call.id);
     const toolKind2 = call.kind;
@@ -2857,21 +3390,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_react10 = require("@ai-sdk/react");
+var import_react11 = require("react");
 function useAgentChat(options) {
-  const latest = (0, import_react9.useRef)(options);
+  const latest = (0, import_react11.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_react11.useState)(options.resumeRunId);
+  const runIdRef = (0, import_react11.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_react11.useRef)(void 0);
+  const autoResumeRunIdRef = (0, import_react11.useRef)(void 0);
+  const [autoResume, setAutoResume] = (0, import_react11.useState)(false);
+  const [activeRunId, setActiveRunId] = (0, import_react11.useState)(null);
+  const regenerateNext = (0, import_react11.useRef)(false);
+  const createdThreadId = (0, import_react11.useRef)(void 0);
+  const client = (0, import_react11.useMemo)(() => {
     if (options.client) return options.client;
     return new AgentClient({
       ...options.baseUrl !== void 0 ? {
@@ -2886,7 +3419,7 @@ function useAgentChat(options) {
       getHeaders: /* @__PURE__ */ __name(async () => mergeHeaders(latest.current), "getHeaders")
     });
   }, []);
-  (0, import_react9.useEffect)(() => {
+  (0, import_react11.useEffect)(() => {
     if (!options.resume || options.threadId === void 0) return;
     let cancelled = false;
     const threadId = options.threadId;
@@ -2906,7 +3439,7 @@ function useAgentChat(options) {
     options.resume,
     options.threadId
   ]);
-  const transport = (0, import_react9.useMemo)(() => {
+  const transport = (0, import_react11.useMemo)(() => {
     function onMeta(meta) {
       settlingRunIdRef.current = meta.runId;
       setRunId(meta.runId);
@@ -2955,8 +3488,8 @@ function useAgentChat(options) {
       }, "onAttemptStart")
     });
   }, []);
-  const backgroundRef = (0, import_react9.useRef)(() => Promise.resolve());
-  const chat = (0, import_react8.useChat)({
+  const backgroundRef = (0, import_react11.useRef)(() => Promise.resolve());
+  const chat = (0, import_react10.useChat)({
     transport,
     resume: options.resumeRunId !== void 0 || autoResume,
     ...options.threadId !== void 0 ? {
@@ -2986,13 +3519,13 @@ function useAgentChat(options) {
       }
     }, "onFinish")
   });
-  const chatRef = (0, import_react9.useRef)(chat);
+  const chatRef = (0, import_react11.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_react11.useRef)(false);
+  const isTurnInFlight = (0, import_react11.useCallback)(() => turnInFlight.current || transport.isAttemptLive, [
     transport
   ]);
-  const sendMessage = (0, import_react9.useCallback)(async (...args) => {
+  const sendMessage = (0, import_react11.useCallback)(async (...args) => {
     if (isTurnInFlight()) return;
     turnInFlight.current = true;
     try {
@@ -3003,15 +3536,15 @@ function useAgentChat(options) {
   }, [
     isTurnInFlight
   ]);
-  const addToolResult = (0, import_react9.useCallback)(({ tool, toolCallId, output }) => chatRef.current.addToolResult({
+  const addToolResult = (0, import_react11.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_react11.useState)([]);
+  const [quota, setQuota] = (0, import_react11.useState)(null);
+  const [backgroundRuns, setBackgroundRuns] = (0, import_react11.useState)([]);
+  const refreshBackground = (0, import_react11.useCallback)(async () => {
     const threadId = latest.current.threadId ?? createdThreadId.current;
     if (threadId === void 0) {
       return;
@@ -3036,7 +3569,7 @@ function useAgentChat(options) {
   ]);
   backgroundRef.current = refreshBackground;
   const isWorking = backgroundRuns.some((run) => run.status === "running");
-  (0, import_react9.useEffect)(() => {
+  (0, import_react11.useEffect)(() => {
     if (options.background !== true || options.threadId === void 0) {
       return;
     }
@@ -3046,7 +3579,7 @@ function useAgentChat(options) {
     options.threadId,
     refreshBackground
   ]);
-  (0, import_react9.useEffect)(() => {
+  (0, import_react11.useEffect)(() => {
     const every = latest.current.backgroundPollMs ?? 5e3;
     if (latest.current.background !== true || !isWorking || every <= 0) {
       return;
@@ -3057,26 +3590,26 @@ function useAgentChat(options) {
     isWorking,
     refreshBackground
   ]);
-  const loadThreads = (0, import_react9.useCallback)(async () => {
+  const loadThreads = (0, import_react11.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_react11.useCallback)((id) => client.getThread(id), [
     client
   ]);
-  const deleteThread = (0, import_react9.useCallback)(async (id) => {
+  const deleteThread = (0, import_react11.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_react11.useCallback)((threadId, messageId) => client.forkFromMessage(threadId, messageId), [
     client
   ]);
-  const renameThread = (0, import_react9.useCallback)(async (id, title) => {
+  const renameThread = (0, import_react11.useCallback)(async (id, title) => {
     await client.renameThread(id, title);
     setThreads((current) => current.map((thread) => thread.id === id ? {
       ...thread,
@@ -3085,24 +3618,24 @@ function useAgentChat(options) {
   }, [
     client
   ]);
-  const promoteThread = (0, import_react9.useCallback)(async (id) => {
+  const promoteThread = (0, import_react11.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_react11.useCallback)((threadId, messageId) => client.truncateFromMessage(threadId, messageId).then(() => void 0), [
     client
   ]);
-  const loadQuota = (0, import_react9.useCallback)(async () => {
+  const loadQuota = (0, import_react11.useCallback)(async () => {
     const today = await client.getQuotaToday();
     setQuota(today);
     return today;
   }, [
     client
   ]);
-  const cancel = (0, import_react9.useCallback)(async () => {
+  const cancel = (0, import_react11.useCallback)(async () => {
     chatRef.current.stop();
     const activeRunId2 = runIdRef.current;
     if (activeRunId2) {
@@ -3114,24 +3647,33 @@ function useAgentChat(options) {
   }, [
     client
   ]);
-  const approve = (0, import_react9.useCallback)(async ({ toolCallId }) => {
+  const approve = (0, import_react11.useCallback)(async ({ toolCallId, remember, via }) => {
     await client.approveToolCall({
-      toolCallId
+      toolCallId,
+      ...remember === true ? {
+        remember: true
+      } : {},
+      ...via !== void 0 ? {
+        via
+      } : {}
     });
   }, [
     client
   ]);
-  const reject = (0, import_react9.useCallback)(async ({ toolCallId, reason }) => {
+  const reject = (0, import_react11.useCallback)(async ({ toolCallId, reason, via }) => {
     await client.rejectToolCall({
       toolCallId,
       ...reason !== void 0 ? {
         reason
+      } : {},
+      ...via !== void 0 ? {
+        via
       } : {}
     });
   }, [
     client
   ]);
-  const answer = (0, import_react9.useCallback)(async ({ toolCallId, answers }) => {
+  const answer = (0, import_react11.useCallback)(async ({ toolCallId, answers }) => {
     await client.answerToolCall({
       toolCallId,
       ...answers !== void 0 ? {
@@ -3141,14 +3683,14 @@ function useAgentChat(options) {
   }, [
     client
   ]);
-  const skip = (0, import_react9.useCallback)(async ({ toolCallId }) => {
+  const skip = (0, import_react11.useCallback)(async ({ toolCallId }) => {
     await client.skipToolCall({
       toolCallId
     });
   }, [
     client
   ]);
-  const regenerate = (0, import_react9.useCallback)(() => {
+  const regenerate = (0, import_react11.useCallback)(() => {
     if (isTurnInFlight()) return;
     regenerateNext.current = true;
     turnInFlight.current = true;
@@ -3212,27 +3754,41 @@ __name(mergeHeaders, "mergeHeaders");
   MessageList,
   SPEECH_LANGUAGES,
   applyCompletion,
+  approvalCountdown,
   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,
+  useApprovalCountdown,
   useChatTranscript,
   useComposerAutocomplete,
   useElapsed,
   useSpeechRecognition,
   useStickToBottom,
+  useToolCatalog,
   useTranscriptItem
 });
 //# sourceMappingURL=index.cjs.map