@dudousxd/nestjs-agent-react 0.8.0 → 0.10.0

package/dist/index.js

@@ -1,6 +1,65 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
+// src/reasoning/timing.ts
+import { useEffect, useRef, useState } from "react";
+var REASONING_METADATA_KEY = "agent";
+function reasoningDurationMetadata(reasoningMs) {
+  return {
+    [REASONING_METADATA_KEY]: {
+      reasoningMs
+    }
+  };
+}
+__name(reasoningDurationMetadata, "reasoningDurationMetadata");
+function readReasoningMs(part) {
+  const metadata = part.providerMetadata;
+  if (typeof metadata !== "object" || metadata === null) return null;
+  const scoped = metadata[REASONING_METADATA_KEY];
+  if (typeof scoped !== "object" || scoped === null) return null;
+  const value = scoped.reasoningMs;
+  return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : null;
+}
+__name(readReasoningMs, "readReasoningMs");
+function useElapsed(running, options = {}) {
+  const { intervalMs = 1e3 } = options;
+  const nowRef = useRef(options.now ?? Date.now);
+  nowRef.current = options.now ?? Date.now;
+  const startedAt = useRef(null);
+  const [elapsed, setElapsed] = useState(0);
+  useEffect(() => {
+    if (!running) {
+      if (startedAt.current !== null) {
+        setElapsed(nowRef.current() - startedAt.current);
+        startedAt.current = null;
+      }
+      return;
+    }
+    startedAt.current = nowRef.current();
+    setElapsed(0);
+    const timer = setInterval(() => {
+      if (startedAt.current !== null) setElapsed(nowRef.current() - startedAt.current);
+    }, intervalMs);
+    return () => clearInterval(timer);
+  }, [
+    running,
+    intervalMs
+  ]);
+  return elapsed;
+}
+__name(useElapsed, "useElapsed");
+function formatElapsed(ms) {
+  if (!Number.isFinite(ms) || ms < 1e3) return "<1s";
+  const totalSeconds = Math.floor(ms / 1e3);
+  const hours = Math.floor(totalSeconds / 3600);
+  const minutes = Math.floor(totalSeconds % 3600 / 60);
+  const seconds = totalSeconds % 60;
+  if (hours > 0) return minutes > 0 ? `${hours}h ${minutes}m` : `${hours}h`;
+  if (minutes > 0) return seconds > 0 ? `${minutes}m ${seconds}s` : `${minutes}m`;
+  return `${seconds}s`;
+}
+__name(formatElapsed, "formatElapsed");
+
 // src/agent-chat-transport.ts
 var HEADER_RUN_ID = "x-agent-run-id";
 var HEADER_THREAD_ID = "x-agent-thread-id";
@@ -158,6 +217,7 @@ var AgentChatTransport = class {
     let stepIndex = 0;
     let textId = null;
     let reasoningId = null;
+    let reasoningStartedAt = 0;
     let textSeq = 0;
     let reasoningSeq = 0;
     const announced = /* @__PURE__ */ new Set();
@@ -194,7 +254,7 @@ var AgentChatTransport = class {
           if (!stepOpen) openStep();
         }
         __name(ensureStep, "ensureStep");
-        function closeRuns() {
+        function closeRuns(reasoningMs) {
           if (textId !== null) {
             controller.enqueue({
               type: "text-end",
@@ -205,15 +265,16 @@ var AgentChatTransport = class {
           if (reasoningId !== null) {
             controller.enqueue({
               type: "reasoning-end",
-              id: reasoningId
+              id: reasoningId,
+              providerMetadata: reasoningDurationMetadata(reasoningMs ?? Math.max(0, Date.now() - reasoningStartedAt))
             });
             reasoningId = null;
           }
         }
         __name(closeRuns, "closeRuns");
-        function closeStep() {
+        function closeStep(reasoningMs) {
           if (!stepOpen) return;
-          closeRuns();
+          closeRuns(reasoningMs);
           controller.enqueue({
             type: "finish-step"
           });
@@ -252,7 +313,7 @@ var AgentChatTransport = class {
               openStep();
               break;
             case "step-finish":
-              closeStep();
+              closeStep(event.reasoningMs);
               if (event.costUsd !== void 0) {
                 controller.enqueue({
                   type: "message-metadata",
@@ -283,6 +344,7 @@ var AgentChatTransport = class {
               if (reasoningId === null) {
                 reasoningId = reasoningSeq === 0 ? `rsn-${stepIndex}` : `rsn-${stepIndex}.${reasoningSeq}`;
                 reasoningSeq += 1;
+                reasoningStartedAt = Date.now();
                 controller.enqueue({
                   type: "reasoning-start",
                   id: reasoningId
@@ -617,6 +679,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)}`);
   }
@@ -730,10 +801,10 @@ var AgentClient = class {
 };
 
 // src/components/chat-input.tsx
-import React2, { useEffect as useEffect2, useState as useState2 } from "react";
+import React2, { useEffect as useEffect3, useState as useState3 } from "react";
 
 // src/components/use-speech-recognition.ts
-import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { useCallback, useEffect as useEffect2, useMemo, useRef as useRef2, useState as useState2 } from "react";
 function getRecognitionCtor() {
   if (typeof window === "undefined") return null;
   const scope = window;
@@ -741,15 +812,15 @@ function getRecognitionCtor() {
 }
 __name(getRecognitionCtor, "getRecognitionCtor");
 function useSpeechRecognition({ lang = "en-US", onFinalTranscript, onInterimTranscript }) {
-  const recognitionRef = useRef(null);
-  const [isListening, setIsListening] = useState(false);
+  const recognitionRef = useRef2(null);
+  const [isListening, setIsListening] = useState2(false);
   const ctor = useMemo(() => getRecognitionCtor(), []);
   const isSupported = ctor !== null;
-  const finalRef = useRef(onFinalTranscript);
-  const interimRef = useRef(onInterimTranscript);
+  const finalRef = useRef2(onFinalTranscript);
+  const interimRef = useRef2(onInterimTranscript);
   finalRef.current = onFinalTranscript;
   interimRef.current = onInterimTranscript;
-  useEffect(() => {
+  useEffect2(() => {
     if (!ctor) return;
     const recognition = new ctor();
     recognition.lang = lang;
@@ -817,8 +888,8 @@ __name(useSpeechRecognition, "useSpeechRecognition");
 
 // src/components/chat-input.tsx
 function ChatInput({ onSubmit, disabled, placeholder, rows = 2, enableSpeech = true, speechLang = "en-US", sendLabel = "Send", onStop, isStreaming = false, stopLabel = "Stop generating", className, textareaClassName, sendButtonClassName, micButtonClassName, stopButtonClassName, renderMic }) {
-  const [value, setValue] = useState2("");
-  const [interim, setInterim] = useState2("");
+  const [value, setValue] = useState3("");
+  const [interim, setInterim] = useState3("");
   const speech = useSpeechRecognition({
     lang: speechLang,
     onFinalTranscript: /* @__PURE__ */ __name((text) => {
@@ -829,7 +900,7 @@ function ChatInput({ onSubmit, disabled, placeholder, rows = 2, enableSpeech = t
     }, "onFinalTranscript"),
     onInterimTranscript: /* @__PURE__ */ __name((text) => setInterim(text), "onInterimTranscript")
   });
-  useEffect2(() => {
+  useEffect3(() => {
     if (!speech.isListening) setInterim("");
   }, [
     speech.isListening
@@ -896,10 +967,283 @@ __name(ChatInput, "ChatInput");
 import React3 from "react";
 
 // src/transcript/use-chat-transcript.ts
-import { useCallback as useCallback3, useEffect as useEffect4, useRef as useRef3, useState as useState4 } from "react";
+import { useCallback as useCallback3, useEffect as useEffect5, useRef as useRef4, useState as useState5 } from "react";
+
+// src/transcript/model.ts
+import { getToolName as getToolName2, isDataUIPart, isFileUIPart, isReasoningUIPart, isTextUIPart, isToolUIPart } from "ai";
+
+// src/presentation/tool-activity.ts
+import { getToolName } from "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(getToolName(part), index);
+    }
+  });
+  parts.forEach((part, index) => {
+    const successAt = lastSuccessByTool.get(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?.[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
-import { getToolName, isDataUIPart, isFileUIPart, isReasoningUIPart, isTextUIPart, isToolUIPart } from "ai";
 function buildTranscriptBlocks(message, options) {
   const blocks = [];
   let toolBuffer = [];
@@ -916,13 +1260,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 = [];
   }
@@ -1017,6 +1367,7 @@ function buildTranscriptBlocks(message, options) {
         key,
         text: part.text,
         isStreaming,
+        durationMs: readReasoningMs(part),
         isOpen: options.isReasoningOpen(key, isStreaming),
         toggle: /* @__PURE__ */ __name((open) => options.toggleReasoning(key, open), "toggle")
       });
@@ -1070,7 +1421,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) {
@@ -1085,7 +1436,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) {
@@ -1118,18 +1469,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: getToolName(part),
+    name: getToolName2(part),
     toolKind: toolKind(part) ?? null,
     parentId: toolParentId(part),
     children: [],
     approval,
+    description: describeToolCall(part, catalog),
     isAwaitingApproval: awaiting,
     approve: {
       available: awaiting && options?.canApprove === true,
@@ -1147,17 +1499,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({
@@ -1182,7 +1534,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 = {};
@@ -1269,7 +1621,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, {
@@ -1283,7 +1635,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;
@@ -1293,18 +1645,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;
@@ -1312,12 +1664,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({
@@ -1327,7 +1679,7 @@ function readPassages(part) {
       ...typeof candidate.source === "string" ? {
         source: candidate.source
       } : {},
-      ...isRecord(candidate.metadata) ? {
+      ...isRecord2(candidate.metadata) ? {
         metadata: candidate.metadata
       } : {}
     });
@@ -1429,10 +1781,10 @@ function formatCostUsd(cost) {
 __name(formatCostUsd, "formatCostUsd");
 
 // src/transcript/use-stick-to-bottom.ts
-import { useCallback as useCallback2, useEffect as useEffect3, useRef as useRef2, useState as useState3 } from "react";
+import { useCallback as useCallback2, useEffect as useEffect4, useRef as useRef3, useState as useState4 } from "react";
 function useStickToBottom({ contentKey, threshold = 32 }) {
-  const containerRef = useRef2(null);
-  const [isAtBottom, setIsAtBottom] = useState3(true);
+  const containerRef = useRef3(null);
+  const [isAtBottom, setIsAtBottom] = useState4(true);
   const measure = useCallback2(() => {
     const element = containerRef.current;
     if (!element) {
@@ -1459,7 +1811,7 @@ function useStickToBottom({ contentKey, threshold = 32 }) {
   }, [
     measure
   ]);
-  useEffect3(() => {
+  useEffect4(() => {
     if (isAtBottom) {
       scrollToBottom();
     }
@@ -1490,14 +1842,14 @@ var DEFAULT_LOAD_EARLIER_STEP = 50;
 var DEFAULT_COPY_RESET_MS = 1500;
 function useChatTranscript(options) {
   const { messages, status, initialVisibleCount = DEFAULT_VISIBLE_COUNT, loadEarlierStep = DEFAULT_LOAD_EARLIER_STEP, followUps, stickToBottomThreshold } = options;
-  const latest = useRef3(options);
+  const latest = useRef4(options);
   latest.current = options;
-  const [visibleCount, setVisibleCount] = useState4(initialVisibleCount);
-  const [stopRequested, setStopRequested] = useState4(false);
+  const [visibleCount, setVisibleCount] = useState5(initialVisibleCount);
+  const [stopRequested, setStopRequested] = useState5(false);
   const isStreaming = status === "streaming";
   const isBusy = status === "submitted" || isStreaming;
   const isEmpty = messages.length === 0;
-  useEffect4(() => {
+  useEffect5(() => {
     if (!isBusy) {
       setStopRequested(false);
     }
@@ -1559,7 +1911,7 @@ function useChatTranscript(options) {
 __name(useChatTranscript, "useChatTranscript");
 function useTranscriptItem(options) {
   const { message, isStreaming = false } = options;
-  const messagesRef = useRef3([
+  const messagesRef = useRef4([
     message
   ]);
   if (messagesRef.current[0] !== message) {
@@ -1577,13 +1929,13 @@ function useTranscriptItem(options) {
 }
 __name(useTranscriptItem, "useTranscriptItem");
 function useTranscriptItems({ messages, visibleStart, streamingMessageId, options }) {
-  const [drafts, setDrafts] = useState4(() => /* @__PURE__ */ new Map());
-  const [copied, setCopied] = useState4(() => /* @__PURE__ */ new Set());
-  const [openReasoning, setOpenReasoning] = useState4(() => /* @__PURE__ */ new Map());
-  const [picks, setPicks] = useState4(() => /* @__PURE__ */ new Map());
-  const [settling, setSettling] = useState4(() => /* @__PURE__ */ new Map());
-  const [settleErrors, setSettleErrors] = useState4(() => /* @__PURE__ */ new Map());
-  const latest = useRef3({
+  const [drafts, setDrafts] = useState5(() => /* @__PURE__ */ new Map());
+  const [copied, setCopied] = useState5(() => /* @__PURE__ */ new Set());
+  const [openReasoning, setOpenReasoning] = useState5(() => /* @__PURE__ */ new Map());
+  const [picks, setPicks] = useState5(() => /* @__PURE__ */ new Map());
+  const [settling, setSettling] = useState5(() => /* @__PURE__ */ new Map());
+  const [settleErrors, setSettleErrors] = useState5(() => /* @__PURE__ */ new Map());
+  const latest = useRef4({
     options,
     drafts,
     picks,
@@ -1595,15 +1947,15 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
     picks,
     messages
   };
-  const copyTimers = useRef3(/* @__PURE__ */ new Map());
-  useEffect4(() => () => {
+  const copyTimers = useRef4(/* @__PURE__ */ new Map());
+  useEffect5(() => () => {
     for (const timer of copyTimers.current.values()) {
       clearTimeout(timer);
     }
     copyTimers.current.clear();
   }, []);
-  const callbackCache = useRef3(/* @__PURE__ */ new Map());
-  const reasoningToggleCache = useRef3(/* @__PURE__ */ new Map());
+  const callbackCache = useRef4(/* @__PURE__ */ new Map());
+  const reasoningToggleCache = useRef4(/* @__PURE__ */ new Map());
   const toggleReasoning = useCallback3((key, open) => {
     setOpenReasoning((current) => {
       const next = new Map(current);
@@ -1794,6 +2146,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"),
@@ -2332,18 +2687,18 @@ function toItem(entry) {
 __name(toItem, "toItem");
 
 // src/composer/use-composer-autocomplete.ts
-import { useCallback as useCallback4, useEffect as useEffect5, useId, useLayoutEffect, useMemo as useMemo2, useRef as useRef4, useState as useState5 } from "react";
+import { useCallback as useCallback4, useEffect as useEffect6, useId, useLayoutEffect, useMemo as useMemo2, useRef as useRef5, useState as useState6 } from "react";
 function useComposerAutocomplete(options) {
   const { value, sources, acceptOnTab = true } = options;
-  const latest = useRef4(options);
+  const latest = useRef5(options);
   latest.current = options;
-  const inputRef = useRef4(null);
-  const [caret, setCaret] = useState5(value.length);
-  const [items, setItems] = useState5([]);
-  const [isLoading, setLoading] = useState5(false);
-  const [error, setError] = useState5(null);
-  const [activeIndex, setActiveIndex] = useState5(0);
-  const [dismissedIndex, setDismissedIndex] = useState5(null);
+  const inputRef = useRef5(null);
+  const [caret, setCaret] = useState6(value.length);
+  const [items, setItems] = useState6([]);
+  const [isLoading, setLoading] = useState6(false);
+  const [error, setError] = useState6(null);
+  const [activeIndex, setActiveIndex] = useState6(0);
+  const [dismissedIndex, setDismissedIndex] = useState6(null);
   const safeCaret = Math.min(caret, value.length);
   const match = useMemo2(() => findActiveTrigger(value, safeCaret, sources), [
     value,
@@ -2351,16 +2706,16 @@ function useComposerAutocomplete(options) {
     sources
   ]);
   const isActive = match !== null && dismissedIndex !== match.index;
-  const matchRef = useRef4(match);
+  const matchRef = useRef5(match);
   matchRef.current = match;
-  const caretRef = useRef4(safeCaret);
+  const caretRef = useRef5(safeCaret);
   caretRef.current = safeCaret;
-  const itemsRef = useRef4(items);
+  const itemsRef = useRef5(items);
   itemsRef.current = items;
-  const activeIndexRef = useRef4(activeIndex);
+  const activeIndexRef = useRef5(activeIndex);
   activeIndexRef.current = activeIndex;
   const requestKey = isActive && match ? `${match.source.id}\0${match.query}` : null;
-  useEffect5(() => {
+  useEffect6(() => {
     const current = matchRef.current;
     if (requestKey === null || current === null) {
       setItems([]);
@@ -2425,7 +2780,7 @@ function useComposerAutocomplete(options) {
     const current = matchRef.current;
     if (current) setDismissedIndex(current.index);
   }, []);
-  const pendingCaret = useRef4(null);
+  const pendingCaret = useRef5(null);
   const accept = useCallback4((item) => {
     const current = matchRef.current;
     if (!current) return;
@@ -2569,6 +2924,78 @@ function isPromise(value) {
 }
 __name(isPromise, "isPromise");
 
+// src/presentation/use-tool-catalog.ts
+import { useCallback as useCallback5, useEffect as useEffect7, useMemo as useMemo3, useState as useState7 } from "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] = useState7([]);
+  const [isLoading, setLoading] = useState7(enabled);
+  const [error, setError] = useState7(null);
+  const [generation, setGeneration] = useState7(0);
+  useEffect7(() => {
+    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 = useCallback5(() => {
+    shared.get(client)?.delete(agent ?? "");
+    setGeneration((current) => current + 1);
+  }, [
+    client,
+    agent
+  ]);
+  const catalog = useMemo3(() => toolCatalogFrom(entries), [
+    entries
+  ]);
+  return {
+    catalog,
+    entries,
+    isLoading,
+    error,
+    refresh
+  };
+}
+__name(useToolCatalog, "useToolCatalog");
+
 // src/stored-message-to-ui-message.ts
 import { DEFAULT_REFUSAL_REASON } from "@dudousxd/nestjs-agent-core";
 function isRefusal(result) {
@@ -2590,6 +3017,16 @@ function refusalReason(result) {
 __name(refusalReason, "refusalReason");
 function storedMessageToUiMessage(message) {
   const parts = [];
+  if (message.reasoning) {
+    parts.push({
+      type: "reasoning",
+      text: message.reasoning,
+      state: "done",
+      ...message.reasoningMs !== void 0 ? {
+        providerMetadata: reasoningDurationMetadata(message.reasoningMs)
+      } : {}
+    });
+  }
   if (message.content) {
     parts.push({
       type: "text",
@@ -2604,6 +3041,20 @@ function storedMessageToUiMessage(message) {
       url: attachment.url
     });
   }
+  for (const component of message.ui ?? []) {
+    parts.push({
+      type: "data-ui",
+      id: component.id,
+      data: {
+        id: component.id,
+        component: component.component,
+        props: component.props,
+        ...component.version !== void 0 ? {
+          version: component.version
+        } : {}
+      }
+    });
+  }
   for (const call of message.toolCalls ?? []) {
     const result = message.toolResults?.find((candidate) => candidate.id === call.id);
     const toolKind2 = call.kind;
@@ -2706,20 +3157,20 @@ __name(sumUsage, "sumUsage");
 
 // src/use-agent-chat.ts
 import { useChat } from "@ai-sdk/react";
-import { useCallback as useCallback5, useEffect as useEffect6, useMemo as useMemo3, useRef as useRef5, useState as useState6 } from "react";
+import { useCallback as useCallback6, useEffect as useEffect8, useMemo as useMemo4, useRef as useRef6, useState as useState8 } from "react";
 function useAgentChat(options) {
-  const latest = useRef5(options);
+  const latest = useRef6(options);
   latest.current = options;
-  const [runId, setRunId] = useState6(options.resumeRunId);
-  const runIdRef = useRef5(runId);
+  const [runId, setRunId] = useState8(options.resumeRunId);
+  const runIdRef = useRef6(runId);
   runIdRef.current = runId;
-  const settlingRunIdRef = useRef5(void 0);
-  const autoResumeRunIdRef = useRef5(void 0);
-  const [autoResume, setAutoResume] = useState6(false);
-  const [activeRunId, setActiveRunId] = useState6(null);
-  const regenerateNext = useRef5(false);
-  const createdThreadId = useRef5(void 0);
-  const client = useMemo3(() => {
+  const settlingRunIdRef = useRef6(void 0);
+  const autoResumeRunIdRef = useRef6(void 0);
+  const [autoResume, setAutoResume] = useState8(false);
+  const [activeRunId, setActiveRunId] = useState8(null);
+  const regenerateNext = useRef6(false);
+  const createdThreadId = useRef6(void 0);
+  const client = useMemo4(() => {
     if (options.client) return options.client;
     return new AgentClient({
       ...options.baseUrl !== void 0 ? {
@@ -2734,7 +3185,7 @@ function useAgentChat(options) {
       getHeaders: /* @__PURE__ */ __name(async () => mergeHeaders(latest.current), "getHeaders")
     });
   }, []);
-  useEffect6(() => {
+  useEffect8(() => {
     if (!options.resume || options.threadId === void 0) return;
     let cancelled = false;
     const threadId = options.threadId;
@@ -2754,7 +3205,7 @@ function useAgentChat(options) {
     options.resume,
     options.threadId
   ]);
-  const transport = useMemo3(() => {
+  const transport = useMemo4(() => {
     function onMeta(meta) {
       settlingRunIdRef.current = meta.runId;
       setRunId(meta.runId);
@@ -2803,7 +3254,7 @@ function useAgentChat(options) {
       }, "onAttemptStart")
     });
   }, []);
-  const backgroundRef = useRef5(() => Promise.resolve());
+  const backgroundRef = useRef6(() => Promise.resolve());
   const chat = useChat({
     transport,
     resume: options.resumeRunId !== void 0 || autoResume,
@@ -2834,13 +3285,13 @@ function useAgentChat(options) {
       }
     }, "onFinish")
   });
-  const chatRef = useRef5(chat);
+  const chatRef = useRef6(chat);
   chatRef.current = chat;
-  const turnInFlight = useRef5(false);
-  const isTurnInFlight = useCallback5(() => turnInFlight.current || transport.isAttemptLive, [
+  const turnInFlight = useRef6(false);
+  const isTurnInFlight = useCallback6(() => turnInFlight.current || transport.isAttemptLive, [
     transport
   ]);
-  const sendMessage = useCallback5(async (...args) => {
+  const sendMessage = useCallback6(async (...args) => {
     if (isTurnInFlight()) return;
     turnInFlight.current = true;
     try {
@@ -2851,15 +3302,15 @@ function useAgentChat(options) {
   }, [
     isTurnInFlight
   ]);
-  const addToolResult = useCallback5(({ tool, toolCallId, output }) => chatRef.current.addToolResult({
+  const addToolResult = useCallback6(({ tool, toolCallId, output }) => chatRef.current.addToolResult({
     tool,
     toolCallId,
     output
   }), []);
-  const [threads, setThreads] = useState6([]);
-  const [quota, setQuota] = useState6(null);
-  const [backgroundRuns, setBackgroundRuns] = useState6([]);
-  const refreshBackground = useCallback5(async () => {
+  const [threads, setThreads] = useState8([]);
+  const [quota, setQuota] = useState8(null);
+  const [backgroundRuns, setBackgroundRuns] = useState8([]);
+  const refreshBackground = useCallback6(async () => {
     const threadId = latest.current.threadId ?? createdThreadId.current;
     if (threadId === void 0) {
       return;
@@ -2884,7 +3335,7 @@ function useAgentChat(options) {
   ]);
   backgroundRef.current = refreshBackground;
   const isWorking = backgroundRuns.some((run) => run.status === "running");
-  useEffect6(() => {
+  useEffect8(() => {
     if (options.background !== true || options.threadId === void 0) {
       return;
     }
@@ -2894,7 +3345,7 @@ function useAgentChat(options) {
     options.threadId,
     refreshBackground
   ]);
-  useEffect6(() => {
+  useEffect8(() => {
     const every = latest.current.backgroundPollMs ?? 5e3;
     if (latest.current.background !== true || !isWorking || every <= 0) {
       return;
@@ -2905,26 +3356,26 @@ function useAgentChat(options) {
     isWorking,
     refreshBackground
   ]);
-  const loadThreads = useCallback5(async () => {
+  const loadThreads = useCallback6(async () => {
     const list = await client.listThreads();
     setThreads(list);
     return list;
   }, [
     client
   ]);
-  const loadThread = useCallback5((id) => client.getThread(id), [
+  const loadThread = useCallback6((id) => client.getThread(id), [
     client
   ]);
-  const deleteThread = useCallback5(async (id) => {
+  const deleteThread = useCallback6(async (id) => {
     await client.deleteThread(id);
     setThreads((current) => current.filter((thread) => thread.id !== id));
   }, [
     client
   ]);
-  const forkThread = useCallback5((threadId, messageId) => client.forkFromMessage(threadId, messageId), [
+  const forkThread = useCallback6((threadId, messageId) => client.forkFromMessage(threadId, messageId), [
     client
   ]);
-  const renameThread = useCallback5(async (id, title) => {
+  const renameThread = useCallback6(async (id, title) => {
     await client.renameThread(id, title);
     setThreads((current) => current.map((thread) => thread.id === id ? {
       ...thread,
@@ -2933,24 +3384,24 @@ function useAgentChat(options) {
   }, [
     client
   ]);
-  const promoteThread = useCallback5(async (id) => {
+  const promoteThread = useCallback6(async (id) => {
     await client.promoteThread(id);
     await loadThreads();
   }, [
     client,
     loadThreads
   ]);
-  const truncateFromMessage = useCallback5((threadId, messageId) => client.truncateFromMessage(threadId, messageId).then(() => void 0), [
+  const truncateFromMessage = useCallback6((threadId, messageId) => client.truncateFromMessage(threadId, messageId).then(() => void 0), [
     client
   ]);
-  const loadQuota = useCallback5(async () => {
+  const loadQuota = useCallback6(async () => {
     const today = await client.getQuotaToday();
     setQuota(today);
     return today;
   }, [
     client
   ]);
-  const cancel = useCallback5(async () => {
+  const cancel = useCallback6(async () => {
     chatRef.current.stop();
     const activeRunId2 = runIdRef.current;
     if (activeRunId2) {
@@ -2962,14 +3413,14 @@ function useAgentChat(options) {
   }, [
     client
   ]);
-  const approve = useCallback5(async ({ toolCallId }) => {
+  const approve = useCallback6(async ({ toolCallId }) => {
     await client.approveToolCall({
       toolCallId
     });
   }, [
     client
   ]);
-  const reject = useCallback5(async ({ toolCallId, reason }) => {
+  const reject = useCallback6(async ({ toolCallId, reason }) => {
     await client.rejectToolCall({
       toolCallId,
       ...reason !== void 0 ? {
@@ -2979,7 +3430,7 @@ function useAgentChat(options) {
   }, [
     client
   ]);
-  const answer = useCallback5(async ({ toolCallId, answers }) => {
+  const answer = useCallback6(async ({ toolCallId, answers }) => {
     await client.answerToolCall({
       toolCallId,
       ...answers !== void 0 ? {
@@ -2989,14 +3440,14 @@ function useAgentChat(options) {
   }, [
     client
   ]);
-  const skip = useCallback5(async ({ toolCallId }) => {
+  const skip = useCallback6(async ({ toolCallId }) => {
     await client.skipToolCall({
       toolCallId
     });
   }, [
     client
   ]);
-  const regenerate = useCallback5(() => {
+  const regenerate = useCallback6(() => {
     if (isTurnInFlight()) return;
     regenerateNext.current = true;
     turnInFlight.current = true;
@@ -3061,22 +3512,37 @@ export {
   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.js.map