@dudousxd/nestjs-agent-react 0.25.0 → 0.26.0

package/dist/index.d.cts

@@ -3,7 +3,7 @@ import { ChatTransport, UIMessage, UIMessageChunk, DataUIPart, UIDataTypes } fro
 import { A as AgentBackend, U as UploadAttachmentOptions, H as HttpErrorListener, a as AttachmentUploadStrategy } from './client-D4ZSbZJ8.cjs';
 export { b as AgentBackendUnsupportedError, c as AgentClient, d as AgentClientOptions, e as AgentConnection, f as AgentHttpError, g as AgentRequestError, C as CancelResult, h as ChatStreamRequest, i as ChatStreamResponse, M as MessageFeedbackInput, R as ResumeStreamRequest, T as ThreadPatch, r as requireBackendMethod } from './client-D4ZSbZJ8.cjs';
 import { MessageAttachment, AgentClientConfig, AgentCatalogEntry, ModelCatalogEntry, ModelCatalogView, ModelCatalogLock, QuotaReport, QuotaWindow, QuotaBlock, QuotaWarning, MessageFeedback, MessageFeedbackValue, ThreadSummary, StoredMessage, ToolCatalogEntry } from '@dudousxd/nestjs-agent-core';
-export { ElicitationInput, ElicitationInputType, validateElicitationAnswer as validateAnswer, validateElicitationValue as validateAnswerValue } from '@dudousxd/nestjs-agent-core';
+export { ALL_AGENTS, ElicitationInput, ElicitationInputType, validateElicitationAnswer as validateAnswer, validateElicitationValue as validateAnswerValue } from '@dudousxd/nestjs-agent-core';
 import * as React from 'react';
 import React__default, { ReactNode, Context } from 'react';
 import { o as GenuiProviderValue, T as TranscriptUiBlock, A as ApproveOptions, t as TranscriptBlock, U as UsageSummary, v as TimestampInfo, C as ChatStatus, M as MessageUsageInfo, w as ToolCatalog, x as AnyToolUIPart, y as TranscriptFile } from './generative-ui-BejHxxbR.cjs';
@@ -761,6 +761,16 @@ interface RejectInput {
     via?: string;
 }
 interface TranscriptItemOptions {
+    /**
+     * A transcript nobody acts on (an audit view, a shared or archived conversation): no approve /
+     * reject, answer / skip, edit, fork, regenerate or stop — whatever handlers or backend are in
+     * scope. Parked approvals and question sets still render, with their actions unavailable.
+     *
+     * Without it the decision handlers DEFAULT to the in-scope backend (`<AgentProvider>`'s), so a
+     * parked call is actionable with no wiring; a read-only surface would otherwise have to pass
+     * `onApprove: null`, `onReject: null`, `onAnswer: null` and `onSkip: null` one by one.
+     */
+    readOnly?: boolean;
     /** User messages get an inline edit-and-resubmit machine. */
     editable?: boolean;
     onEditSubmit?: (input: EditSubmitInput) => void | Promise<void>;
@@ -987,6 +997,11 @@ interface MessageListProps {
     reasoningLabel?: React__default.ReactNode;
     /** Extra content for one message's action row — e.g. a badge naming which agent answered. */
     getMeta?: (message: UIMessage) => React__default.ReactNode;
+    /**
+     * Nobody acts on this list (an audit or shared view): parked approvals and question sets render
+     * without their actions, and no fork / edit / regenerate — see `useChatTranscript({ readOnly })`.
+     */
+    readOnly?: boolean;
     /** When set, every message gets a "Fork" affordance calling back with its id. */
     onFork?: (input: MessageActionInput) => void | Promise<void>;
     /** User messages get an inline edit-and-resubmit affordance. */
@@ -1019,7 +1034,7 @@ interface MessageListProps {
  * Every decision here comes from `useChatTranscript`; the file below it is markup. A host that
  * wants a different layout drives that hook directly and never imports this component.
  */
-declare 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, }: MessageListProps): React__default.JSX.Element;
+declare 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, }: MessageListProps): React__default.JSX.Element;
 
 /**
  * Languages the dictation mic offers. The Web Speech API expects a
@@ -1256,7 +1271,11 @@ interface UseToolCatalogOptions {
      * (the shared copy is keyed by it): a backend constructed inline refetches every render.
      */
     backend?: ToolsBackend;
-    /** The agent whose tools to list. Omitted → the server's default agent. */
+    /**
+     * The agent whose tools to list. Omitted → the server's default agent. {@link ALL_AGENTS} (`'*'`)
+     * → every tool the actor reaches through any agent, each once — for an app with several agents
+     * whose conversations one surface shows.
+     */
     agent?: string;
     /** `false` holds the request (e.g. until the user is signed in). Default `true`. */
     enabled?: boolean;

package/dist/index.d.ts

@@ -3,7 +3,7 @@ import { ChatTransport, UIMessage, UIMessageChunk, DataUIPart, UIDataTypes } fro
 import { A as AgentBackend, U as UploadAttachmentOptions, H as HttpErrorListener, a as AttachmentUploadStrategy } from './client-D4ZSbZJ8.js';
 export { b as AgentBackendUnsupportedError, c as AgentClient, d as AgentClientOptions, e as AgentConnection, f as AgentHttpError, g as AgentRequestError, C as CancelResult, h as ChatStreamRequest, i as ChatStreamResponse, M as MessageFeedbackInput, R as ResumeStreamRequest, T as ThreadPatch, r as requireBackendMethod } from './client-D4ZSbZJ8.js';
 import { MessageAttachment, AgentClientConfig, AgentCatalogEntry, ModelCatalogEntry, ModelCatalogView, ModelCatalogLock, QuotaReport, QuotaWindow, QuotaBlock, QuotaWarning, MessageFeedback, MessageFeedbackValue, ThreadSummary, StoredMessage, ToolCatalogEntry } from '@dudousxd/nestjs-agent-core';
-export { ElicitationInput, ElicitationInputType, validateElicitationAnswer as validateAnswer, validateElicitationValue as validateAnswerValue } from '@dudousxd/nestjs-agent-core';
+export { ALL_AGENTS, ElicitationInput, ElicitationInputType, validateElicitationAnswer as validateAnswer, validateElicitationValue as validateAnswerValue } from '@dudousxd/nestjs-agent-core';
 import * as React from 'react';
 import React__default, { ReactNode, Context } from 'react';
 import { o as GenuiProviderValue, T as TranscriptUiBlock, A as ApproveOptions, t as TranscriptBlock, U as UsageSummary, v as TimestampInfo, C as ChatStatus, M as MessageUsageInfo, w as ToolCatalog, x as AnyToolUIPart, y as TranscriptFile } from './generative-ui-BejHxxbR.js';
@@ -761,6 +761,16 @@ interface RejectInput {
     via?: string;
 }
 interface TranscriptItemOptions {
+    /**
+     * A transcript nobody acts on (an audit view, a shared or archived conversation): no approve /
+     * reject, answer / skip, edit, fork, regenerate or stop — whatever handlers or backend are in
+     * scope. Parked approvals and question sets still render, with their actions unavailable.
+     *
+     * Without it the decision handlers DEFAULT to the in-scope backend (`<AgentProvider>`'s), so a
+     * parked call is actionable with no wiring; a read-only surface would otherwise have to pass
+     * `onApprove: null`, `onReject: null`, `onAnswer: null` and `onSkip: null` one by one.
+     */
+    readOnly?: boolean;
     /** User messages get an inline edit-and-resubmit machine. */
     editable?: boolean;
     onEditSubmit?: (input: EditSubmitInput) => void | Promise<void>;
@@ -987,6 +997,11 @@ interface MessageListProps {
     reasoningLabel?: React__default.ReactNode;
     /** Extra content for one message's action row — e.g. a badge naming which agent answered. */
     getMeta?: (message: UIMessage) => React__default.ReactNode;
+    /**
+     * Nobody acts on this list (an audit or shared view): parked approvals and question sets render
+     * without their actions, and no fork / edit / regenerate — see `useChatTranscript({ readOnly })`.
+     */
+    readOnly?: boolean;
     /** When set, every message gets a "Fork" affordance calling back with its id. */
     onFork?: (input: MessageActionInput) => void | Promise<void>;
     /** User messages get an inline edit-and-resubmit affordance. */
@@ -1019,7 +1034,7 @@ interface MessageListProps {
  * Every decision here comes from `useChatTranscript`; the file below it is markup. A host that
  * wants a different layout drives that hook directly and never imports this component.
  */
-declare 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, }: MessageListProps): React__default.JSX.Element;
+declare 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, }: MessageListProps): React__default.JSX.Element;
 
 /**
  * Languages the dictation mic offers. The Web Speech API expects a
@@ -1256,7 +1271,11 @@ interface UseToolCatalogOptions {
      * (the shared copy is keyed by it): a backend constructed inline refetches every render.
      */
     backend?: ToolsBackend;
-    /** The agent whose tools to list. Omitted → the server's default agent. */
+    /**
+     * The agent whose tools to list. Omitted → the server's default agent. {@link ALL_AGENTS} (`'*'`)
+     * → every tool the actor reaches through any agent, each once — for an app with several agents
+     * whose conversations one surface shows.
+     */
     agent?: string;
     /** `false` holds the request (e.g. until the user is signed in). Default `true`. */
     enabled?: boolean;

package/dist/index.js

@@ -3785,7 +3785,7 @@ function useChatTranscript(options) {
     },
     scroll,
     stop: {
-      available: isBusy && options.onStop !== void 0,
+      available: isBusy && options.readOnly !== true && options.onStop !== void 0,
       isStopping: stopRequested,
       stop
     }
@@ -4055,11 +4055,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,
@@ -4087,7 +4088,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,
@@ -4103,11 +4104,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
       }
     });
@@ -4116,7 +4117,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);
@@ -4409,10 +4410,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
     } : {},
@@ -4877,6 +4881,7 @@ function isPromise(value) {
 __name(isPromise, "isPromise");
 
 // src/presentation/use-tool-catalog.ts
+import { ALL_AGENTS } from "@dudousxd/nestjs-agent-core";
 import { useCallback as useCallback10, useEffect as useEffect13, useMemo as useMemo10, useState as useState13 } from "react";
 var shared2 = /* @__PURE__ */ new WeakMap();
 function load2(client, agent) {
@@ -5279,7 +5284,7 @@ function useAgentChat(options = {}) {
   const settlingRunIdRef = useRef12(void 0);
   const autoResumeRunIdRef = useRef12(void 0);
   const [activeRunId, setActiveRunId] = useState15(null);
-  const [isLoadingHistory, setIsLoadingHistory] = useState15(false);
+  const [historyFor, setHistoryFor] = useState15(void 0);
   const [historyError, setHistoryError] = useState15(null);
   const [threadModel, setThreadModel] = useState15(null);
   const [pickedModel, setPickedModel] = useState15(void 0);
@@ -5444,7 +5449,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;
@@ -5465,17 +5469,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 = useRef12(false);
   const isTurnInFlight = useCallback11(() => turnInFlight.current || transport.isAttemptLive, [
     transport
@@ -5885,6 +5889,7 @@ var QuotaBlockedError = class extends Error {
   }
 };
 export {
+  ALL_AGENTS,
   AgentBackendUnsupportedError,
   AgentChatTransport,
   AgentClient,