@dudousxd/nestjs-agent-react 0.24.0 → 0.26.0

package/dist/index.js

@@ -1,17 +1,82 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
+// 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) {
@@ -46,7 +111,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);
   }
@@ -73,7 +138,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);
   }
@@ -166,7 +231,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);
@@ -229,6 +296,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);
@@ -251,7 +319,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() {
@@ -294,9 +365,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();
@@ -1651,14 +1728,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 = useRef2({
     headers,
-    getHeaders
+    getHeaders,
+    onHttpError
   });
   latestHeaders.current = {
     headers,
-    getHeaders
+    getHeaders,
+    onHttpError
   };
   const upload = attachments?.upload;
   const value = useMemo3(() => backend ?? new AgentClient({
@@ -1679,6 +1758,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?.() ?? {};
@@ -2092,6 +2172,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,
@@ -2107,6 +2188,7 @@ function useModels(options = {}) {
 __name(useModels, "useModels");
 
 // src/quota/use-quota.ts
+import { quotaWarning } from "@dudousxd/nestjs-agent-core";
 import { useEffect as useEffect6, useMemo as useMemo7 } from "react";
 
 // src/threads/threads-events.ts
@@ -2162,6 +2244,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 ?? quotaWarning(windows) ?? null,
       isLoading,
       error,
       refresh
@@ -3250,7 +3333,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");
@@ -3700,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
     }
@@ -3970,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,
@@ -4002,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,
@@ -4018,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
       }
     });
@@ -4031,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);
@@ -4324,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
     } : {},
@@ -4792,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) {
@@ -5194,12 +5284,13 @@ 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);
   const pickedModelRef = useRef12(pickedModel);
   pickedModelRef.current = pickedModel;
+  const lockedRef = useRef12(false);
   const pendingPin = useRef12(void 0);
   const regenerateNext = useRef12(false);
   const currentThreadId = useCallback11(() => latest.current.threadId ?? createdThreadId.current, []);
@@ -5247,7 +5338,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.
@@ -5341,6 +5432,7 @@ function useAgentChat(options = {}) {
     setRunId(void 0);
     setActiveRunId(null);
     setThreadModel(null);
+    setPickedModel(void 0);
     setBackgroundRuns([]);
     setHistoryError(null);
     autoResumeRunIdRef.current = void 0;
@@ -5357,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;
@@ -5378,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
@@ -5505,19 +5596,25 @@ function useAgentChat(options = {}) {
   }, [
     client
   ]);
-  const answer = useCallback11(async ({ toolCallId, answers }) => {
+  const answer = useCallback11(async ({ toolCallId, answers, via }) => {
     await requireBackendMethod(client, "answerToolCall")({
       toolCallId,
       ...answers !== void 0 ? {
         answers
+      } : {},
+      ...via !== void 0 ? {
+        via
       } : {}
     });
   }, [
     client
   ]);
-  const skip = useCallback11(async ({ toolCallId }) => {
+  const skip = useCallback11(async ({ toolCallId, via }) => {
     await requireBackendMethod(client, "skipToolCall")({
-      toolCallId
+      toolCallId,
+      ...via !== void 0 ? {
+        via
+      } : {}
     });
   }, [
     client
@@ -5597,10 +5694,14 @@ function useAgentChat(options = {}) {
     modelsWantedRef.current = true;
     queueMicrotask(() => setModelsWanted(true));
   }, []);
-  const selectModel = useCallback11((id) => setPickedModel(id), []);
+  lockedRef.current = catalog.locked !== null;
+  const selectModel = useCallback11((id) => {
+    if (!lockedRef.current) setPickedModel(id);
+  }, []);
   const pinToThread = useCallback11(async (model) => {
     const threadId = currentThreadId();
     setThreadModel(model);
+    setPickedModel(void 0);
     if (threadId === void 0) {
       pendingPin.current = {
         model
@@ -5626,11 +5727,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,
@@ -5783,6 +5889,7 @@ var QuotaBlockedError = class extends Error {
   }
 };
 export {
+  ALL_AGENTS,
   AgentBackendUnsupportedError,
   AgentChatTransport,
   AgentClient,