@dudousxd/nestjs-agent-react 0.24.0 → 0.26.0

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,
@@ -99,22 +100,87 @@ __export(src_exports, {
   useThreads: () => useThreads,
   useToolCatalog: () => useToolCatalog,
   useTranscriptItem: () => useTranscriptItem,
-  validateAnswer: () => import_nestjs_agent_core.validateElicitationAnswer,
-  validateAnswerValue: () => import_nestjs_agent_core.validateElicitationValue
+  validateAnswer: () => import_nestjs_agent_core2.validateElicitationAnswer,
+  validateAnswerValue: () => import_nestjs_agent_core2.validateElicitationValue
 });
 module.exports = __toCommonJS(src_exports);
 
+// src/http-error.ts
+function readErrorAnswer(text) {
+  if (text == null || text === "") return {
+    body: void 0,
+    message: void 0,
+    code: void 0
+  };
+  let body = text;
+  try {
+    body = JSON.parse(text);
+  } catch {
+    return {
+      body: text,
+      message: void 0,
+      code: void 0
+    };
+  }
+  if (body === null || typeof body !== "object") return {
+    body,
+    message: void 0,
+    code: void 0
+  };
+  const record = body;
+  const message = typeof record.message === "string" && record.message !== "" ? record.message : Array.isArray(record.message) && record.message.length > 0 && record.message.every((each) => typeof each === "string") ? record.message.join("; ") : void 0;
+  const code = typeof record.code === "string" && record.code !== "" ? record.code : void 0;
+  return {
+    body,
+    message,
+    code
+  };
+}
+__name(readErrorAnswer, "readErrorAnswer");
+async function readErrorResponse(response) {
+  let text;
+  try {
+    text = await response.text();
+  } catch {
+    text = void 0;
+  }
+  return readErrorAnswer(text);
+}
+__name(readErrorResponse, "readErrorResponse");
+function reportHttpError(listener, error) {
+  if (listener === void 0) return;
+  try {
+    listener(error);
+  } catch {
+  }
+}
+__name(reportHttpError, "reportHttpError");
+
 // src/client.ts
-var AgentHttpError = class extends Error {
+var AgentHttpError = class _AgentHttpError extends Error {
   static {
     __name(this, "AgentHttpError");
   }
   status;
   method;
   path;
-  constructor(status, method, path, statusText) {
-    super(`Agent request failed: ${method} ${path} \u2192 ${status} ${statusText}`), this.status = status, this.method = method, this.path = path;
+  /** The answer's body: parsed JSON, else its text; `undefined` when empty. */
+  body;
+  /** The body's `code` (`quota_exceeded`, …), when the server sent one. */
+  code;
+  constructor(status, method, path, statusText, answer = {
+    body: void 0,
+    message: void 0,
+    code: void 0
+  }) {
+    super(answer.message ?? `Agent request failed: ${method} ${path} \u2192 ${status} ${statusText}`), this.status = status, this.method = method, this.path = path;
     this.name = "AgentHttpError";
+    this.body = answer.body;
+    this.code = answer.code;
+  }
+  /** Read a refused `response`'s body into an error. */
+  static async from(response, method, path) {
+    return new _AgentHttpError(response.status, method, path, response.statusText, await readErrorResponse(response));
   }
 };
 function normalizeAgentPath(path) {
@@ -149,7 +215,7 @@ var AgentClient = class {
       } : {}
     });
     if (!response.ok || !response.body) {
-      throw new AgentHttpError(response.status, "POST", `${this.agentPath()}/chat`, response.statusText);
+      throw await this.failure(response, "POST", `${this.agentPath()}/chat`);
     }
     return streamResponse(response);
   }
@@ -176,7 +242,7 @@ var AgentClient = class {
       return null;
     }
     if (!response.ok || !response.body) {
-      throw new AgentHttpError(response.status, "GET", `${this.agentPath()}${path}`, response.statusText);
+      throw await this.failure(response, "GET", `${this.agentPath()}${path}`);
     }
     return streamResponse(response);
   }
@@ -269,7 +335,9 @@ var AgentClient = class {
       };
       xhr.onload = () => {
         if (xhr.status < 200 || xhr.status >= 300) {
-          reject(new AgentHttpError(xhr.status, "POST", `${this.agentPath()}/attachments`, xhr.statusText));
+          const error = new AgentHttpError(xhr.status, "POST", `${this.agentPath()}/attachments`, xhr.statusText, readErrorAnswer(xhr.responseText));
+          reportHttpError(this.options.onHttpError, error);
+          reject(error);
           return;
         }
         onProgress?.(1);
@@ -332,6 +400,7 @@ var AgentClient = class {
   * out takes the pre-picked default the request carried, resolved server-side against the request
   * the run already holds. Omit the whole object and the user has confirmed every pre-picked
   * answer — which is the point of the surface, so it is a valid submission rather than a blank.
+  * `via` names the surface the answer came through (the server records `'web'` when omitted).
   */
   answerToolCall(input) {
     return this.request("POST", "/tool-call/answer", input);
@@ -354,7 +423,10 @@ var AgentClient = class {
       path: this.agentPath(),
       headers: /* @__PURE__ */ __name(() => this.resolveHeaders(), "headers"),
       fetch: this.fetchImpl(),
-      ...this.credentials()
+      ...this.credentials(),
+      ...this.options.onHttpError !== void 0 ? {
+        onHttpError: this.options.onHttpError
+      } : {}
     };
   }
   baseUrl() {
@@ -397,9 +469,15 @@ var AgentClient = class {
     });
     return this.handleResponse(response, method, path);
   }
+  /** The error for a refused `response`, already reported to `onHttpError`. */
+  async failure(response, method, path) {
+    const error = await AgentHttpError.from(response, method, path);
+    reportHttpError(this.options.onHttpError, error);
+    return error;
+  }
   async handleResponse(response, method, path) {
     if (!response.ok) {
-      throw new AgentHttpError(response.status, method, path, response.statusText);
+      throw await this.failure(response, method, path);
     }
     if (response.status === 204) return void 0;
     const text = await response.text();
@@ -1754,14 +1832,16 @@ __name(GenerativeUI, "GenerativeUI");
 
 // src/provider.tsx
 var AgentBackendContext = sharedContext("@dudousxd/nestjs-agent-react:agent-backend");
-function AgentProvider({ backend, baseUrl, path, headers, getHeaders, credentials, fetch, attachments, genui, children }) {
+function AgentProvider({ backend, baseUrl, path, headers, getHeaders, credentials, fetch, onHttpError, attachments, genui, children }) {
   const latestHeaders = (0, import_react5.useRef)({
     headers,
-    getHeaders
+    getHeaders,
+    onHttpError
   });
   latestHeaders.current = {
     headers,
-    getHeaders
+    getHeaders,
+    onHttpError
   };
   const upload = attachments?.upload;
   const value = (0, import_react5.useMemo)(() => backend ?? new AgentClient({
@@ -1782,6 +1862,7 @@ function AgentProvider({ backend, baseUrl, path, headers, getHeaders, credential
         upload
       }
     } : {},
+    onHttpError: /* @__PURE__ */ __name((error) => latestHeaders.current.onHttpError?.(error), "onHttpError"),
     getHeaders: /* @__PURE__ */ __name(async () => {
       const current = latestHeaders.current;
       const dynamic = await current.getHeaders?.() ?? {};
@@ -2195,6 +2276,7 @@ function useModels(options = {}) {
       providers,
       models,
       defaultModel: data?.default ?? null,
+      locked: data?.locked ?? null,
       find: /* @__PURE__ */ __name((id) => id == null ? void 0 : byId.get(id), "find"),
       isLoading,
       error,
@@ -2210,6 +2292,7 @@ function useModels(options = {}) {
 __name(useModels, "useModels");
 
 // src/quota/use-quota.ts
+var import_nestjs_agent_core = require("@dudousxd/nestjs-agent-core");
 var import_react11 = require("react");
 
 // src/threads/threads-events.ts
@@ -2265,6 +2348,7 @@ function useQuota(options = {}) {
       day: windows.find((window2) => window2.period === "day"),
       month: windows.find((window2) => window2.period === "month"),
       blocked: data?.blocked ?? null,
+      warning: data === void 0 || data.blocked !== void 0 ? null : data.warning ?? (0, import_nestjs_agent_core.quotaWarning)(windows) ?? null,
       isLoading,
       error,
       refresh
@@ -2708,11 +2792,11 @@ var import_react18 = __toESM(require("react"), 1);
 var import_react17 = require("react");
 
 // src/transcript/model.ts
-var import_nestjs_agent_core2 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core3 = require("@dudousxd/nestjs-agent-core");
 var import_ai2 = require("ai");
 
 // src/elicitation/answers.ts
-var import_nestjs_agent_core = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core2 = require("@dudousxd/nestjs-agent-core");
 function pad(value) {
   return String(value).padStart(2, "0");
 }
@@ -3307,7 +3391,7 @@ function readElicitationRequest(part) {
     if (!isRecord3(candidate) || typeof candidate.id !== "string" || typeof candidate.prompt !== "string") {
       return null;
     }
-    const input2 = (0, import_nestjs_agent_core2.readElicitationInput)(candidate.input) ?? null;
+    const input2 = (0, import_nestjs_agent_core3.readElicitationInput)(candidate.input) ?? null;
     const rawOptions = Array.isArray(candidate.options) ? candidate.options : [];
     if (rawOptions.length === 0 && (input2 === null || input2.type === "select")) {
       return null;
@@ -3353,7 +3437,9 @@ function readElicitationOutcome(part) {
     answers,
     skipped: output.skipped,
     defaulted: Array.isArray(output.defaulted) ? output.defaulted.filter((id) => typeof id === "string") : [],
-    summary: typeof output.summary === "string" ? output.summary : null
+    summary: typeof output.summary === "string" ? output.summary : null,
+    answeredBy: typeof output.answeredBy === "string" ? output.answeredBy : null,
+    answeredVia: typeof output.answeredVia === "string" ? output.answeredVia : null
   };
 }
 __name(readElicitationOutcome, "readElicitationOutcome");
@@ -3365,7 +3451,7 @@ function buildElicitationBlock(key, part, request, options) {
     const picked = isPending ? options.picked(toolCallId, question.id) : void 0;
     const selected = picked ?? outcome?.answers[question.id] ?? question.defaults;
     const pick = /* @__PURE__ */ __name((values) => options.pick(toolCallId, question.id, values), "pick");
-    const error = isPending ? (0, import_nestjs_agent_core2.validateElicitationAnswer)({
+    const error = isPending ? (0, import_nestjs_agent_core3.validateElicitationAnswer)({
       id: question.id,
       prompt: question.prompt,
       options: question.options.map(({ value, label }) => ({
@@ -3803,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
     }
@@ -4073,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,
@@ -4105,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,
@@ -4121,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
       }
     });
@@ -4134,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);
@@ -4427,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
     } : {},
@@ -4895,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) {
@@ -5014,7 +5105,7 @@ function useApprovalCountdown(expiresAt, options = {}) {
 __name(useApprovalCountdown, "useApprovalCountdown");
 
 // src/stored-message-to-ui-message.ts
-var import_nestjs_agent_core3 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core5 = require("@dudousxd/nestjs-agent-core");
 function isRefusal(result) {
   if (result.denied === true) {
     return true;
@@ -5027,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_core3.DEFAULT_REFUSAL_REASON ? reason : void 0;
+    return typeof reason === "string" && reason !== import_nestjs_agent_core5.DEFAULT_REFUSAL_REASON ? reason : void 0;
   }
   return void 0;
 }
@@ -5297,12 +5388,13 @@ 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);
   const pickedModelRef = (0, import_react23.useRef)(pickedModel);
   pickedModelRef.current = pickedModel;
+  const lockedRef = (0, import_react23.useRef)(false);
   const pendingPin = (0, import_react23.useRef)(void 0);
   const regenerateNext = (0, import_react23.useRef)(false);
   const currentThreadId = (0, import_react23.useCallback)(() => latest.current.threadId ?? createdThreadId.current, []);
@@ -5350,7 +5442,7 @@ function useAgentChat(options = {}) {
         const regenerate2 = regenerateNext.current;
         regenerateNext.current = false;
         const threadId = currentThreadId();
-        const model = current.model ?? pickedModelRef.current;
+        const model = current.model ?? (lockedRef.current ? void 0 : pickedModelRef.current);
         return {
           // Read per send: a host that switches agents before the first message (a picker on a
           // new chat) sends the one picked now, not the one this chat mounted with.
@@ -5444,6 +5536,7 @@ function useAgentChat(options = {}) {
     setRunId(void 0);
     setActiveRunId(null);
     setThreadModel(null);
+    setPickedModel(void 0);
     setBackgroundRuns([]);
     setHistoryError(null);
     autoResumeRunIdRef.current = void 0;
@@ -5460,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;
@@ -5481,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
@@ -5608,19 +5700,25 @@ function useAgentChat(options = {}) {
   }, [
     client
   ]);
-  const answer = (0, import_react23.useCallback)(async ({ toolCallId, answers }) => {
+  const answer = (0, import_react23.useCallback)(async ({ toolCallId, answers, via }) => {
     await requireBackendMethod(client, "answerToolCall")({
       toolCallId,
       ...answers !== void 0 ? {
         answers
+      } : {},
+      ...via !== void 0 ? {
+        via
       } : {}
     });
   }, [
     client
   ]);
-  const skip = (0, import_react23.useCallback)(async ({ toolCallId }) => {
+  const skip = (0, import_react23.useCallback)(async ({ toolCallId, via }) => {
     await requireBackendMethod(client, "skipToolCall")({
-      toolCallId
+      toolCallId,
+      ...via !== void 0 ? {
+        via
+      } : {}
     });
   }, [
     client
@@ -5700,10 +5798,14 @@ function useAgentChat(options = {}) {
     modelsWantedRef.current = true;
     queueMicrotask(() => setModelsWanted(true));
   }, []);
-  const selectModel = (0, import_react23.useCallback)((id) => setPickedModel(id), []);
+  lockedRef.current = catalog.locked !== null;
+  const selectModel = (0, import_react23.useCallback)((id) => {
+    if (!lockedRef.current) setPickedModel(id);
+  }, []);
   const pinToThread = (0, import_react23.useCallback)(async (model) => {
     const threadId = currentThreadId();
     setThreadModel(model);
+    setPickedModel(void 0);
     if (threadId === void 0) {
       pendingPin.current = {
         model
@@ -5729,11 +5831,16 @@ function useAgentChat(options = {}) {
       wantModels();
       return catalog.providers;
     },
-    selected: options.model ?? pickedModel ?? threadModel ?? catalog.defaultModel ?? null,
+    selected: catalog.locked?.model ?? options.model ?? pickedModel ?? threadModel ?? catalog.defaultModel ?? null,
+    pinned: threadModel,
     get defaultModel() {
       wantModels();
       return catalog.defaultModel;
     },
+    get locked() {
+      wantModels();
+      return catalog.locked;
+    },
     select: selectModel,
     pinToThread,
     isLoading: modelsWanted && catalog.isLoading,
@@ -5887,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,