@dudousxd/nestjs-agent-react 0.25.0 → 0.26.0

package/README.md

@@ -42,7 +42,7 @@ handlers passed. On top of the AI SDK chat it returns:
 | `quota` / `blocked` | `useQuota`'s state, and the window blocking sends (the `blocked` option overrides it). |
 | `approve` / `reject` / `answer` / `skip` | `({ toolCallId, … })` — the same object shape the transcript's handlers take. |
 | `fork` / `truncateFrom` / `promote` | `({ messageId, threadId? })` / `({ threadId? })`, defaulting to this chat's thread. |
-| `cancel`, `regenerate`, `getThreadId`, `backend`, `runId`, `activeRunId`, `isLoadingHistory`, `connection`, `background` | — |
+| `cancel`, `regenerate`, `getThreadId`, `backend`, `runId`, `activeRunId`, `isLoadingHistory`, `connection`, `background` | — `isLoadingHistory` is already `true` on the first render with a `threadId`, so a page can show a skeleton instead of flashing its empty state |
 
 Threads (list, rename, delete) are `useThreads()`; the granular hooks stay the escape hatch.
 
@@ -170,6 +170,8 @@ catalog to the transcript and every tool call carries a `description`, and every
 ```tsx
 const chat = useAgentChat();
 const { catalog } = useToolCatalog(); // the provider's backend; `{ backend, agent }` to override
+// Several agents on one surface: every tool the actor reaches through any of them.
+const all = useToolCatalog({ agent: ALL_AGENTS }); // GET /agent/tools?agent=*
 const transcript = useChatTranscript({ messages: chat.messages, status: chat.status, toolCatalog: catalog });
 
 // in a `tools` block:
@@ -253,11 +255,19 @@ ones a human actually decided. A settled set keeps its block (`isPending: false`
 `selected` showing what was chosen), so one piece of markup renders both states.
 
 Detection is structural rather than by tool name — an intake and an `ask` persist under whatever
-name their row holds — and lifting is opt-in on `onAnswer` for the same reason `sources` is: with
-nowhere to send an answer, a question set is still just a tool card.
-
-**A tool call awaiting approval.** Wire `onApprove`/`onReject` and every call in a `tools` block
-carries its own decision:
+name their row holds.
+
+**Decisions settle through the backend by default.** `onApprove`, `onReject`, `onAnswer` and
+`onSkip` left undefined are NOT "off": each defaults to the in-scope backend's call (the enclosing
+`<AgentProvider>`'s `approveToolCall` / `rejectToolCall` / `answerToolCall` / `skipToolCall`), so a
+parked approval or question set is actionable with no wiring. Pass your own handler to route it
+elsewhere, `null` to drop one affordance (`onAnswer: null` keeps question sets as plain tool
+cards), or `readOnly: true` for a surface nobody acts on — an audit view, a shared or archived
+conversation. `readOnly` keeps parked approvals and question sets rendered (with their outcome)
+but offers no approve / reject / answer / skip, edit, fork, regenerate or stop, whatever is in
+scope; `<MessageList readOnly>` and `useAgentChat({ transcript: { readOnly: true } })` take it too.
+
+**A tool call awaiting approval.** Every call in a `tools` block carries its own decision:
 
 ```tsx
 {block.calls.map((call) => (

package/dist/index.cjs

@@ -31,6 +31,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  ALL_AGENTS: () => import_nestjs_agent_core4.ALL_AGENTS,
   AgentBackendUnsupportedError: () => AgentBackendUnsupportedError,
   AgentChatTransport: () => AgentChatTransport,
   AgentClient: () => AgentClient,
@@ -3888,7 +3889,7 @@ function useChatTranscript(options) {
     },
     scroll,
     stop: {
-      available: isBusy && options.onStop !== void 0,
+      available: isBusy && options.readOnly !== true && options.onStop !== void 0,
       isStopping: stopRequested,
       stop
     }
@@ -4158,11 +4159,12 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
         ...options.toolCatalog !== void 0 ? {
           toolCatalog: options.toolCatalog
         } : {},
-        ...handlers.onAnswer !== void 0 ? {
+        // Read-only still lifts question sets into their block, so the outcome shows.
+        ...handlers.onAnswer !== void 0 || options.readOnly === true && options.onAnswer !== null ? {
           elicitation: {
             picked: /* @__PURE__ */ __name((toolCallId, questionId) => picks.get(pickKey(toolCallId, questionId)), "picked"),
             pick,
-            canAnswer: true,
+            canAnswer: handlers.onAnswer !== void 0,
             canSkip: handlers.onSkip !== void 0,
             answer,
             skip,
@@ -4190,7 +4192,7 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
         copy: callbacks.copy
       },
       edit: {
-        available: isUser && options.editable === true && options.onEditSubmit !== void 0,
+        available: isUser && options.readOnly !== true && options.editable === true && options.onEditSubmit !== void 0,
         isEditing,
         draft: draft ?? text,
         canSave: (draft ?? "").trim().length > 0,
@@ -4206,11 +4208,11 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
         }), "getTextareaProps")
       },
       fork: {
-        available: options.onFork !== void 0,
+        available: options.readOnly !== true && options.onFork !== void 0,
         run: callbacks.fork
       },
       regenerate: {
-        available: isLastAssistant && options.regeneratable === true && options.onRegenerate !== void 0,
+        available: isLastAssistant && options.readOnly !== true && options.regeneratable === true && options.onRegenerate !== void 0,
         run: callbacks.regenerate
       }
     });
@@ -4219,7 +4221,7 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
 }
 __name(useTranscriptItems, "useTranscriptItems");
 function settleHandlers(options, backend) {
-  const pick = /* @__PURE__ */ __name((own, fallback2) => own === null ? void 0 : own ?? fallback2, "pick");
+  const pick = /* @__PURE__ */ __name((own, fallback2) => options.readOnly === true || own === null ? void 0 : own ?? fallback2, "pick");
   return {
     onAnswer: pick(options.onAnswer, backend.answerToolCall ? async (input) => {
       await backend.answerToolCall?.(input);
@@ -4512,10 +4514,13 @@ function joinClasses(...entries) {
 __name(joinClasses, "joinClasses");
 
 // src/components/message-list.tsx
-function MessageList({ messages, status, renderToolPart, renderToolGroup, renderText, renderReasoning, renderFiles, renderUi, reasoningLabel, getMeta, onFork, editable, onEditSubmit, regeneratable, onRegenerate, getUsage, getCreatedAt, emptyState, typingIndicator, followUps, onFollowUpClick, error, onRetry, classNames }) {
+function MessageList({ messages, status, renderToolPart, renderToolGroup, renderText, renderReasoning, renderFiles, renderUi, reasoningLabel, getMeta, readOnly, onFork, editable, onEditSubmit, regeneratable, onRegenerate, getUsage, getCreatedAt, emptyState, typingIndicator, followUps, onFollowUpClick, error, onRetry, classNames }) {
   const transcript = useChatTranscript({
     messages,
     status,
+    ...readOnly !== void 0 ? {
+      readOnly
+    } : {},
     ...onFork ? {
       onFork
     } : {},
@@ -4980,6 +4985,7 @@ function isPromise(value) {
 __name(isPromise, "isPromise");
 
 // src/presentation/use-tool-catalog.ts
+var import_nestjs_agent_core4 = require("@dudousxd/nestjs-agent-core");
 var import_react20 = require("react");
 var shared2 = /* @__PURE__ */ new WeakMap();
 function load2(client, agent) {
@@ -5099,7 +5105,7 @@ function useApprovalCountdown(expiresAt, options = {}) {
 __name(useApprovalCountdown, "useApprovalCountdown");
 
 // src/stored-message-to-ui-message.ts
-var import_nestjs_agent_core4 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core5 = require("@dudousxd/nestjs-agent-core");
 function isRefusal(result) {
   if (result.denied === true) {
     return true;
@@ -5112,7 +5118,7 @@ function refusalReason(result) {
   const { output } = result;
   if (output !== null && typeof output === "object" && "reason" in output) {
     const reason = output.reason;
-    return typeof reason === "string" && reason !== import_nestjs_agent_core4.DEFAULT_REFUSAL_REASON ? reason : void 0;
+    return typeof reason === "string" && reason !== import_nestjs_agent_core5.DEFAULT_REFUSAL_REASON ? reason : void 0;
   }
   return void 0;
 }
@@ -5382,7 +5388,7 @@ function useAgentChat(options = {}) {
   const settlingRunIdRef = (0, import_react23.useRef)(void 0);
   const autoResumeRunIdRef = (0, import_react23.useRef)(void 0);
   const [activeRunId, setActiveRunId] = (0, import_react23.useState)(null);
-  const [isLoadingHistory, setIsLoadingHistory] = (0, import_react23.useState)(false);
+  const [historyFor, setHistoryFor] = (0, import_react23.useState)(void 0);
   const [historyError, setHistoryError] = (0, import_react23.useState)(null);
   const [threadModel, setThreadModel] = (0, import_react23.useState)(null);
   const [pickedModel, setPickedModel] = (0, import_react23.useState)(void 0);
@@ -5547,7 +5553,6 @@ function useAgentChat(options = {}) {
     const wantResume = current.resume !== false && current.resumeRunId === void 0;
     if (!wantHistory && !wantResume) return;
     let cancelled = false;
-    if (wantHistory) setIsLoadingHistory(true);
     client.getThread(threadId).then((thread) => {
       if (cancelled || thread == null) return;
       const active = thread.activeRunId ?? null;
@@ -5568,17 +5573,17 @@ function useAgentChat(options = {}) {
       if (cancelled) return;
       setHistoryError(error instanceof Error ? error : new Error(String(error)));
     }).finally(() => {
-      if (!cancelled) setIsLoadingHistory(false);
+      if (!cancelled) setHistoryFor(threadId);
     });
     return () => {
       cancelled = true;
-      setIsLoadingHistory(false);
     };
   }, [
     client,
     chatId,
     options.threadId
   ]);
+  const isLoadingHistory = options.threadId !== void 0 && options.threadId !== createdThreadId.current && options.history !== false && options.initialMessages === void 0 && historyFor !== options.threadId;
   const turnInFlight = (0, import_react23.useRef)(false);
   const isTurnInFlight = (0, import_react23.useCallback)(() => turnInFlight.current || transport.isAttemptLive, [
     transport
@@ -5989,6 +5994,7 @@ var QuotaBlockedError = class extends Error {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ALL_AGENTS,
   AgentBackendUnsupportedError,
   AgentChatTransport,
   AgentClient,