@dudousxd/nestjs-agent-react 0.22.1 → 0.24.0

package/dist/index.js

@@ -203,6 +203,10 @@ var AgentClient = class {
   listAgents() {
     return this.request("GET", "/agents");
   }
+  /** `GET <path>/config` — attachment limits and upload mode, and which features are on. */
+  getConfig() {
+    return this.request("GET", "/config");
+  }
   /** `GET <path>/quota` — the caller's budget windows and the one blocking sends, if any. */
   getQuota() {
     return this.request("GET", "/quota");
@@ -860,6 +864,13 @@ var AgentChatTransport = class {
                 }
               });
               break;
+            case "message-metadata":
+              ensureStarted();
+              controller.enqueue({
+                type: "message-metadata",
+                messageMetadata: event.metadata
+              });
+              break;
             case "title":
             case "cancelled":
               forwardAsData(event, true);
@@ -1113,7 +1124,7 @@ function dragHasFiles(data) {
 __name(dragHasFiles, "dragHasFiles");
 
 // src/attachments/use-attachments.ts
-import { useCallback as useCallback2, useEffect as useEffect3, useMemo as useMemo4, useRef as useRef3, useState as useState3 } from "react";
+import { useCallback as useCallback2, useEffect as useEffect4, useMemo as useMemo4, useRef as useRef3, useState as useState4 } from "react";
 
 // src/backend.ts
 var AgentBackendUnsupportedError = class extends Error {
@@ -1135,6 +1146,9 @@ function requireBackendMethod(backend, name) {
 }
 __name(requireBackendMethod, "requireBackendMethod");
 
+// src/config/use-agent-config.ts
+import { useEffect as useEffect3, useState as useState3 } from "react";
+
 // src/provider.tsx
 import { useContext as useContext3, useMemo as useMemo3, useRef as useRef2 } from "react";
 
@@ -1699,6 +1713,59 @@ function useAgentBackend(own) {
 }
 __name(useAgentBackend, "useAgentBackend");
 
+// src/config/use-agent-config.ts
+var shared = /* @__PURE__ */ new WeakMap();
+function load(backend) {
+  const getConfig = backend.getConfig;
+  if (typeof getConfig !== "function") return void 0;
+  let pending = shared.get(backend);
+  if (pending === void 0) {
+    pending = getConfig.call(backend).catch((error) => {
+      shared.delete(backend);
+      throw error;
+    });
+    shared.set(backend, pending);
+  }
+  return pending;
+}
+__name(load, "load");
+function useAgentConfig(options = {}) {
+  const backend = useAgentBackend(options.backend);
+  const enabled = options.enabled !== false;
+  const [config, setConfig] = useState3(void 0);
+  const [isLoading, setLoading] = useState3(false);
+  const [error, setError] = useState3(null);
+  useEffect3(() => {
+    if (!enabled) return;
+    const pending = load(backend);
+    if (pending === void 0) return;
+    let cancelled = false;
+    setLoading(true);
+    pending.then((loaded) => {
+      if (cancelled) return;
+      setConfig(loaded !== null && typeof loaded === "object" ? loaded : void 0);
+      setError(null);
+      setLoading(false);
+    }, (failure) => {
+      if (cancelled) return;
+      setError(failure instanceof Error ? failure : new Error(String(failure)));
+      setLoading(false);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [
+    backend,
+    enabled
+  ]);
+  return {
+    config,
+    isLoading,
+    error
+  };
+}
+__name(useAgentConfig, "useAgentConfig");
+
 // src/attachments/use-attachments.ts
 var DEFAULT_REJECTION = {
   type: /* @__PURE__ */ __name((file) => `${file.name} is not a supported file type`, "type"),
@@ -1708,19 +1775,33 @@ var DEFAULT_REJECTION = {
 var sequence = 0;
 function useAttachments(options = {}) {
   const backend = useAgentBackend(options.backend);
-  const latest = useRef3({
-    ...options,
+  const { config } = useAgentConfig({
     backend
   });
-  latest.current = {
+  const limits = config?.attachments;
+  const accept = options.accept ?? limits?.allowedContentTypes;
+  const maxBytes = options.maxBytes ?? limits?.maxBytes;
+  const maxFiles = options.maxFiles ?? limits?.maxPerMessage;
+  const effective = {
     ...options,
-    backend
+    backend,
+    ...accept !== void 0 ? {
+      accept
+    } : {},
+    ...maxBytes !== void 0 ? {
+      maxBytes
+    } : {},
+    ...maxFiles !== void 0 ? {
+      maxFiles
+    } : {}
   };
-  const [items, setItems] = useState3([]);
+  const latest = useRef3(effective);
+  latest.current = effective;
+  const [items, setItems] = useState4([]);
   const itemsRef = useRef3(items);
   itemsRef.current = items;
   const controllers = useRef3(/* @__PURE__ */ new Map());
-  const [dragDepth, setDragDepth] = useState3(0);
+  const [dragDepth, setDragDepth] = useState4(0);
   const patch = useCallback2((id, change) => {
     setItems((current) => current.map((item) => item.id === id ? {
       ...item,
@@ -1765,9 +1846,9 @@ function useAttachments(options = {}) {
   ]);
   const add = useCallback2((files) => {
     if (files == null) return;
-    const { accept: accept2, maxBytes, maxFiles, describeRejection } = latest.current;
+    const { accept: accept2, maxBytes: maxBytes2, maxFiles: maxFiles2, describeRejection } = latest.current;
     const describe = /* @__PURE__ */ __name((reason, file) => describeRejection?.(reason, file) ?? DEFAULT_REJECTION[reason](file), "describe");
-    let room = maxFiles === void 0 ? Number.POSITIVE_INFINITY : maxFiles - itemsRef.current.filter((item) => item.status !== "rejected").length;
+    let room = maxFiles2 === void 0 ? Number.POSITIVE_INFINITY : maxFiles2 - itemsRef.current.filter((item) => item.status !== "rejected").length;
     const staged = [];
     for (const file of Array.from(files)) {
       sequence += 1;
@@ -1779,7 +1860,7 @@ function useAttachments(options = {}) {
         type: file.type,
         progress: 0
       };
-      const reason = !acceptsFile(accept2, file) ? "type" : maxBytes !== void 0 && file.size > maxBytes ? "size" : room <= 0 ? "count" : void 0;
+      const reason = !acceptsFile(accept2, file) ? "type" : maxBytes2 !== void 0 && file.size > maxBytes2 ? "size" : room <= 0 ? "count" : void 0;
       if (reason !== void 0) {
         staged.push({
           ...base,
@@ -1843,7 +1924,7 @@ function useAttachments(options = {}) {
   }, [
     start
   ]);
-  useEffect3(() => () => {
+  useEffect4(() => () => {
     for (const item of itemsRef.current) release(item);
   }, [
     release
@@ -1878,11 +1959,10 @@ function useAttachments(options = {}) {
   }), [
     add
   ]);
-  const accept = options.accept;
   const inputProps = useMemo4(() => ({
     type: "file",
     accept: typeof accept === "string" ? accept : accept?.join(","),
-    multiple: options.maxFiles === void 0 || options.maxFiles > 1,
+    multiple: maxFiles === void 0 || maxFiles > 1,
     onChange: /* @__PURE__ */ __name((event) => {
       const input = event.currentTarget;
       add(input.files);
@@ -1890,12 +1970,11 @@ function useAttachments(options = {}) {
     }, "onChange")
   }), [
     accept,
-    options.maxFiles,
+    maxFiles,
     add
   ]);
   return useMemo4(() => {
     const ready = items.filter((item) => item.status === "ready" && item.attachment !== void 0);
-    const attachments = ready.map((item) => item.attachment);
     return {
       items,
       add,
@@ -1903,9 +1982,8 @@ function useAttachments(options = {}) {
       retry,
       clear,
       isUploading: items.some((item) => item.status === "uploading"),
-      attachments,
-      refs: attachments.map((attachment) => ({
-        mediaId: attachment.mediaId
+      refs: ready.map((item) => ({
+        mediaId: item.attachment.mediaId
       })),
       inputProps,
       dropZoneProps,
@@ -1930,13 +2008,13 @@ __name(useAttachments, "useAttachments");
 import { useMemo as useMemo5 } from "react";
 
 // src/catalog/use-resource.ts
-import { useCallback as useCallback3, useEffect as useEffect4, useRef as useRef4, useState as useState4 } from "react";
-function useResource(load2, key, enabled) {
-  const [data, setData] = useState4(void 0);
-  const [isLoading, setIsLoading] = useState4(enabled);
-  const [error, setError] = useState4(null);
-  const loadRef = useRef4(load2);
-  loadRef.current = load2;
+import { useCallback as useCallback3, useEffect as useEffect5, useRef as useRef4, useState as useState5 } from "react";
+function useResource(load3, key, enabled) {
+  const [data, setData] = useState5(void 0);
+  const [isLoading, setIsLoading] = useState5(enabled);
+  const [error, setError] = useState5(null);
+  const loadRef = useRef4(load3);
+  loadRef.current = load3;
   const generation = useRef4(0);
   const refresh = useCallback3(async () => {
     const mine = ++generation.current;
@@ -1953,7 +2031,7 @@ function useResource(load2, key, enabled) {
       if (mine === generation.current) setIsLoading(false);
     }
   }, []);
-  useEffect4(() => {
+  useEffect5(() => {
     if (!enabled) return;
     void refresh();
   }, [
@@ -2029,7 +2107,7 @@ function useModels(options = {}) {
 __name(useModels, "useModels");
 
 // src/quota/use-quota.ts
-import { useEffect as useEffect5, useMemo as useMemo7 } from "react";
+import { useEffect as useEffect6, useMemo as useMemo7 } from "react";
 
 // src/threads/threads-events.ts
 var listeners = /* @__PURE__ */ new WeakMap();
@@ -2057,7 +2135,7 @@ function useQuota(options = {}) {
   const { enabled = true, pollMs } = options;
   const backend = useAgentBackend(options.backend);
   const { data, isLoading, error, refresh } = useResource(() => requireBackendMethod(backend, "getQuota")(), "", enabled);
-  useEffect5(() => {
+  useEffect6(() => {
     if (!enabled) return;
     return onThreadsEvent(backend, (event) => {
       if (event.type === "changed") void refresh();
@@ -2067,7 +2145,7 @@ function useQuota(options = {}) {
     enabled,
     refresh
   ]);
-  useEffect5(() => {
+  useEffect6(() => {
     if (!enabled || pollMs === void 0 || pollMs <= 0) return;
     const timer = setInterval(() => void refresh(), pollMs);
     return () => clearInterval(timer);
@@ -2098,7 +2176,7 @@ function useQuota(options = {}) {
 __name(useQuota, "useQuota");
 
 // src/feedback/use-message-feedback.ts
-import { useCallback as useCallback4, useRef as useRef5, useState as useState5 } from "react";
+import { useCallback as useCallback4, useRef as useRef5, useState as useState6 } from "react";
 function useMessageFeedback(options = {}) {
   const backend = useAgentBackend(options.backend);
   const latest = useRef5({
@@ -2109,9 +2187,9 @@ function useMessageFeedback(options = {}) {
     ...options,
     backend
   };
-  const [local, setLocal] = useState5(/* @__PURE__ */ new Map());
-  const [pending, setPending] = useState5(/* @__PURE__ */ new Set());
-  const [error, setError] = useState5(null);
+  const [local, setLocal] = useState6(/* @__PURE__ */ new Map());
+  const [pending, setPending] = useState6(/* @__PURE__ */ new Set());
+  const [error, setError] = useState6(null);
   const localRef = useRef5(local);
   localRef.current = local;
   const resolved = useRef5(/* @__PURE__ */ new Map());
@@ -2214,13 +2292,13 @@ function metadataOf(message) {
 __name(metadataOf, "metadataOf");
 
 // src/threads/use-threads.ts
-import { useCallback as useCallback5, useEffect as useEffect6, useRef as useRef6, useState as useState6 } from "react";
+import { useCallback as useCallback5, useEffect as useEffect7, useRef as useRef6, useState as useState7 } from "react";
 function useThreads(options = {}) {
   const { enabled = true } = options;
   const backend = useAgentBackend(options.backend);
-  const [threads, setThreads] = useState6([]);
-  const [isLoading, setIsLoading] = useState6(enabled);
-  const [error, setError] = useState6(null);
+  const [threads, setThreads] = useState7([]);
+  const [isLoading, setIsLoading] = useState7(enabled);
+  const [error, setError] = useState7(null);
   const threadsRef = useRef6(threads);
   threadsRef.current = threads;
   const generation = useRef6(0);
@@ -2241,7 +2319,7 @@ function useThreads(options = {}) {
   }, [
     backend
   ]);
-  useEffect6(() => {
+  useEffect7(() => {
     if (!enabled) return;
     void refresh();
     return onThreadsEvent(backend, (event) => {
@@ -2358,10 +2436,10 @@ function backgroundRunsFromThread(messages) {
 __name(backgroundRunsFromThread, "backgroundRunsFromThread");
 
 // src/components/chat-input.tsx
-import React2, { useEffect as useEffect8, useState as useState8 } from "react";
+import React2, { useEffect as useEffect9, useState as useState9 } from "react";
 
 // src/components/use-speech-recognition.ts
-import { useCallback as useCallback6, useEffect as useEffect7, useMemo as useMemo8, useRef as useRef7, useState as useState7 } from "react";
+import { useCallback as useCallback6, useEffect as useEffect8, useMemo as useMemo8, useRef as useRef7, useState as useState8 } from "react";
 function getRecognitionCtor() {
   if (typeof window === "undefined") return null;
   const scope = window;
@@ -2370,14 +2448,14 @@ function getRecognitionCtor() {
 __name(getRecognitionCtor, "getRecognitionCtor");
 function useSpeechRecognition({ lang = "en-US", onFinalTranscript, onInterimTranscript }) {
   const recognitionRef = useRef7(null);
-  const [isListening, setIsListening] = useState7(false);
+  const [isListening, setIsListening] = useState8(false);
   const ctor = useMemo8(() => getRecognitionCtor(), []);
   const isSupported = ctor !== null;
   const finalRef = useRef7(onFinalTranscript);
   const interimRef = useRef7(onInterimTranscript);
   finalRef.current = onFinalTranscript;
   interimRef.current = onInterimTranscript;
-  useEffect7(() => {
+  useEffect8(() => {
     if (!ctor) return;
     const recognition = new ctor();
     recognition.lang = lang;
@@ -2445,8 +2523,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] = useState8("");
-  const [interim, setInterim] = useState8("");
+  const [value, setValue] = useState9("");
+  const [interim, setInterim] = useState9("");
   const speech = useSpeechRecognition({
     lang: speechLang,
     onFinalTranscript: /* @__PURE__ */ __name((text) => {
@@ -2457,7 +2535,7 @@ function ChatInput({ onSubmit, disabled, placeholder, rows = 2, enableSpeech = t
     }, "onFinalTranscript"),
     onInterimTranscript: /* @__PURE__ */ __name((text) => setInterim(text), "onInterimTranscript")
   });
-  useEffect8(() => {
+  useEffect9(() => {
     if (!speech.isListening) setInterim("");
   }, [
     speech.isListening
@@ -2524,7 +2602,7 @@ __name(ChatInput, "ChatInput");
 import React3 from "react";
 
 // src/transcript/use-chat-transcript.ts
-import { useCallback as useCallback8, useEffect as useEffect10, useRef as useRef9, useState as useState10 } from "react";
+import { useCallback as useCallback8, useEffect as useEffect11, useRef as useRef9, useState as useState11 } from "react";
 
 // src/transcript/model.ts
 import { readElicitationInput, validateElicitationAnswer as validateElicitationAnswer2 } from "@dudousxd/nestjs-agent-core";
@@ -3501,10 +3579,10 @@ function formatCostUsd(cost) {
 __name(formatCostUsd, "formatCostUsd");
 
 // src/transcript/use-stick-to-bottom.ts
-import { useCallback as useCallback7, useEffect as useEffect9, useRef as useRef8, useState as useState9 } from "react";
+import { useCallback as useCallback7, useEffect as useEffect10, useRef as useRef8, useState as useState10 } from "react";
 function useStickToBottom({ contentKey, threshold = 32 }) {
   const containerRef = useRef8(null);
-  const [isAtBottom, setIsAtBottom] = useState9(true);
+  const [isAtBottom, setIsAtBottom] = useState10(true);
   const measure = useCallback7(() => {
     const element = containerRef.current;
     if (!element) {
@@ -3531,7 +3609,7 @@ function useStickToBottom({ contentKey, threshold = 32 }) {
   }, [
     measure
   ]);
-  useEffect9(() => {
+  useEffect10(() => {
     if (isAtBottom) {
       scrollToBottom();
     }
@@ -3564,12 +3642,12 @@ function useChatTranscript(options) {
   const { messages, status, initialVisibleCount = DEFAULT_VISIBLE_COUNT, loadEarlierStep = DEFAULT_LOAD_EARLIER_STEP, followUps, stickToBottomThreshold } = options;
   const latest = useRef9(options);
   latest.current = options;
-  const [visibleCount, setVisibleCount] = useState10(initialVisibleCount);
-  const [stopRequested, setStopRequested] = useState10(false);
+  const [visibleCount, setVisibleCount] = useState11(initialVisibleCount);
+  const [stopRequested, setStopRequested] = useState11(false);
   const isStreaming = status === "streaming" || status === "reconnecting";
   const isBusy = status === "submitted" || isStreaming;
   const isEmpty = messages.length === 0;
-  useEffect10(() => {
+  useEffect11(() => {
     if (!isBusy) {
       setStopRequested(false);
     }
@@ -3649,12 +3727,12 @@ function useTranscriptItem(options) {
 }
 __name(useTranscriptItem, "useTranscriptItem");
 function useTranscriptItems({ messages, visibleStart, streamingMessageId, options }) {
-  const [drafts, setDrafts] = useState10(() => /* @__PURE__ */ new Map());
-  const [copied, setCopied] = useState10(() => /* @__PURE__ */ new Set());
-  const [openReasoning, setOpenReasoning] = useState10(() => /* @__PURE__ */ new Map());
-  const [picks, setPicks] = useState10(() => /* @__PURE__ */ new Map());
-  const [settling, setSettling] = useState10(() => /* @__PURE__ */ new Map());
-  const [settleErrors, setSettleErrors] = useState10(() => /* @__PURE__ */ new Map());
+  const [drafts, setDrafts] = useState11(() => /* @__PURE__ */ new Map());
+  const [copied, setCopied] = useState11(() => /* @__PURE__ */ new Set());
+  const [openReasoning, setOpenReasoning] = useState11(() => /* @__PURE__ */ new Map());
+  const [picks, setPicks] = useState11(() => /* @__PURE__ */ new Map());
+  const [settling, setSettling] = useState11(() => /* @__PURE__ */ new Map());
+  const [settleErrors, setSettleErrors] = useState11(() => /* @__PURE__ */ new Map());
   const backend = useAgentBackend();
   const handlers = settleHandlers(options, backend);
   const latest = useRef9({
@@ -3672,7 +3750,7 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
     messages
   };
   const copyTimers = useRef9(/* @__PURE__ */ new Map());
-  useEffect10(() => () => {
+  useEffect11(() => () => {
     for (const timer of copyTimers.current.values()) {
       clearTimeout(timer);
     }
@@ -4476,18 +4554,18 @@ function toItem(entry) {
 __name(toItem, "toItem");
 
 // src/composer/use-composer-autocomplete.ts
-import { useCallback as useCallback9, useEffect as useEffect11, useId, useLayoutEffect, useMemo as useMemo9, useRef as useRef10, useState as useState11 } from "react";
+import { useCallback as useCallback9, useEffect as useEffect12, useId, useLayoutEffect, useMemo as useMemo9, useRef as useRef10, useState as useState12 } from "react";
 function useComposerAutocomplete(options) {
   const { value, sources, acceptOnTab = true } = options;
   const latest = useRef10(options);
   latest.current = options;
   const inputRef = useRef10(null);
-  const [caret, setCaret] = useState11(value.length);
-  const [items, setItems] = useState11([]);
-  const [isLoading, setLoading] = useState11(false);
-  const [error, setError] = useState11(null);
-  const [activeIndex, setActiveIndex] = useState11(0);
-  const [dismissedIndex, setDismissedIndex] = useState11(null);
+  const [caret, setCaret] = useState12(value.length);
+  const [items, setItems] = useState12([]);
+  const [isLoading, setLoading] = useState12(false);
+  const [error, setError] = useState12(null);
+  const [activeIndex, setActiveIndex] = useState12(0);
+  const [dismissedIndex, setDismissedIndex] = useState12(null);
   const safeCaret = Math.min(caret, value.length);
   const match = useMemo9(() => findActiveTrigger(value, safeCaret, sources), [
     value,
@@ -4504,7 +4582,7 @@ function useComposerAutocomplete(options) {
   const activeIndexRef = useRef10(activeIndex);
   activeIndexRef.current = activeIndex;
   const requestKey = isActive && match ? `${match.source.id}\0${match.query}` : null;
-  useEffect11(() => {
+  useEffect12(() => {
     const current = matchRef.current;
     if (requestKey === null || current === null) {
       setItems([]);
@@ -4714,13 +4792,13 @@ function isPromise(value) {
 __name(isPromise, "isPromise");
 
 // src/presentation/use-tool-catalog.ts
-import { useCallback as useCallback10, useEffect as useEffect12, useMemo as useMemo10, useState as useState12 } from "react";
-var shared = /* @__PURE__ */ new WeakMap();
-function load(client, agent) {
-  let byAgent = shared.get(client);
+import { useCallback as useCallback10, useEffect as useEffect13, useMemo as useMemo10, useState as useState13 } from "react";
+var shared2 = /* @__PURE__ */ new WeakMap();
+function load2(client, agent) {
+  let byAgent = shared2.get(client);
   if (byAgent === void 0) {
     byAgent = /* @__PURE__ */ new Map();
-    shared.set(client, byAgent);
+    shared2.set(client, byAgent);
   }
   const key = agent ?? "";
   const cached = byAgent.get(key);
@@ -4735,22 +4813,22 @@ function load(client, agent) {
   byAgent.set(key, request);
   return request;
 }
-__name(load, "load");
+__name(load2, "load");
 function useToolCatalog(options = {}) {
   const { agent, enabled = true } = options;
   const client = useAgentBackend(options.backend);
-  const [entries, setEntries] = useState12([]);
-  const [isLoading, setLoading] = useState12(enabled);
-  const [error, setError] = useState12(null);
-  const [generation, setGeneration] = useState12(0);
-  useEffect12(() => {
+  const [entries, setEntries] = useState13([]);
+  const [isLoading, setLoading] = useState13(enabled);
+  const [error, setError] = useState13(null);
+  const [generation, setGeneration] = useState13(0);
+  useEffect13(() => {
     if (!enabled) {
       setLoading(false);
       return;
     }
     let cancelled = false;
     setLoading(true);
-    load(client, agent).then((loaded) => {
+    load2(client, agent).then((loaded) => {
       if (cancelled) return;
       setEntries(Array.isArray(loaded) ? loaded : []);
       setError(null);
@@ -4770,7 +4848,7 @@ function useToolCatalog(options = {}) {
     generation
   ]);
   const refresh = useCallback10(() => {
-    shared.get(client)?.delete(agent ?? "");
+    shared2.get(client)?.delete(agent ?? "");
     setGeneration((current) => current + 1);
   }, [
     client,
@@ -4790,7 +4868,7 @@ function useToolCatalog(options = {}) {
 __name(useToolCatalog, "useToolCatalog");
 
 // src/approvals/countdown.ts
-import { useEffect as useEffect13, useRef as useRef11, useState as useState13 } from "react";
+import { useEffect as useEffect14, useRef as useRef11, useState as useState14 } from "react";
 function approvalCountdown(expiresAt, now = Date.now()) {
   const deadline = expiresAt == null ? Number.NaN : Date.parse(expiresAt);
   if (!Number.isFinite(deadline)) {
@@ -4810,8 +4888,8 @@ function useApprovalCountdown(expiresAt, options = {}) {
   const { intervalMs = 1e3 } = options;
   const nowRef = useRef11(options.now ?? Date.now);
   nowRef.current = options.now ?? Date.now;
-  const [state, setState] = useState13(() => approvalCountdown(expiresAt, nowRef.current()));
-  useEffect13(() => {
+  const [state, setState] = useState14(() => approvalCountdown(expiresAt, nowRef.current()));
+  useEffect14(() => {
     const read = /* @__PURE__ */ __name(() => approvalCountdown(expiresAt, nowRef.current()), "read");
     const first = read();
     setState(first);
@@ -4947,13 +5025,19 @@ function storedMessageToUiMessage(message) {
   for (const call of message.toolCalls ?? []) {
     const result = message.toolResults?.find((candidate) => candidate.id === call.id);
     const toolKind2 = call.kind;
+    const toolMetadata = {
+      ...toolKind2 !== void 0 ? {
+        toolKind: toolKind2
+      } : {},
+      ...call.parentId !== void 0 ? {
+        parentId: call.parentId
+      } : {}
+    };
     parts.push({
       type: `tool-${call.name}`,
       toolCallId: call.id,
-      ...toolKind2 !== void 0 ? {
-        toolMetadata: {
-          toolKind: toolKind2
-        }
+      ...Object.keys(toolMetadata).length > 0 ? {
+        toolMetadata
       } : {},
       ...result !== void 0 ? isRefusal(result) ? {
         // A declined action is NOT an available output. Reloading a thread used to bring one
@@ -4981,6 +5065,8 @@ function storedMessageToUiMessage(message) {
     parts.push(...pushedByCall.get(call.id) ?? []);
   }
   const metadata = {
+    // The host's own facts first: the library's keys win on a clash.
+    ...message.metadata,
     ...message.feedback !== void 0 ? {
       feedback: message.feedback
     } : {},
@@ -5040,6 +5126,8 @@ function mergeTurn(rows) {
   const feedback = lastRow.feedback;
   const createdAt = rows[0]?.createdAt;
   const metadata = {
+    // Host facts of every row, a later row's winning (the turn's final state), under the library's.
+    ...Object.assign({}, ...rows.map((row) => row.metadata ?? {})),
     ...usage !== void 0 ? {
       usage
     } : {},
@@ -5076,7 +5164,7 @@ __name(sumUsage, "sumUsage");
 
 // src/use-agent-chat.ts
 import { useChat } from "@ai-sdk/react";
-import { useCallback as useCallback11, useEffect as useEffect14, useMemo as useMemo11, useRef as useRef12, useState as useState14 } from "react";
+import { useCallback as useCallback11, useEffect as useEffect15, useMemo as useMemo11, useRef as useRef12, useState as useState15 } from "react";
 var localChatSequence = 0;
 function localChatId() {
   localChatSequence += 1;
@@ -5100,22 +5188,22 @@ function useAgentChat(options = {}) {
     }
   }
   const chatId = chatIdRef.current;
-  const [runId, setRunId] = useState14(options.resumeRunId);
+  const [runId, setRunId] = useState15(options.resumeRunId);
   const runIdRef = useRef12(runId);
   runIdRef.current = runId;
   const settlingRunIdRef = useRef12(void 0);
   const autoResumeRunIdRef = useRef12(void 0);
-  const [activeRunId, setActiveRunId] = useState14(null);
-  const [isLoadingHistory, setIsLoadingHistory] = useState14(false);
-  const [historyError, setHistoryError] = useState14(null);
-  const [threadModel, setThreadModel] = useState14(null);
-  const [pickedModel, setPickedModel] = useState14(void 0);
+  const [activeRunId, setActiveRunId] = useState15(null);
+  const [isLoadingHistory, setIsLoadingHistory] = useState15(false);
+  const [historyError, setHistoryError] = useState15(null);
+  const [threadModel, setThreadModel] = useState15(null);
+  const [pickedModel, setPickedModel] = useState15(void 0);
   const pickedModelRef = useRef12(pickedModel);
   pickedModelRef.current = pickedModel;
   const pendingPin = useRef12(void 0);
   const regenerateNext = useRef12(false);
   const currentThreadId = useCallback11(() => latest.current.threadId ?? createdThreadId.current, []);
-  const [connection, setConnection] = useState14({
+  const [connection, setConnection] = useState15({
     status: "live"
   });
   const resyncAfterSettle = useRef12(false);
@@ -5161,6 +5249,11 @@ function useAgentChat(options = {}) {
         const threadId = currentThreadId();
         const model = current.model ?? 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.
+          ...current.agent !== void 0 ? {
+            agent: current.agent
+          } : {},
           ...threadId !== void 0 ? {
             threadId
           } : {},
@@ -5242,7 +5335,7 @@ function useAgentChat(options = {}) {
   }
   __name(resyncFromThread, "resyncFromThread");
   const firstChatId = useRef12(chatId);
-  useEffect14(() => {
+  useEffect15(() => {
     if (chatId === firstChatId.current) return;
     firstChatId.current = chatId;
     setRunId(void 0);
@@ -5255,7 +5348,7 @@ function useAgentChat(options = {}) {
   }, [
     chatId
   ]);
-  useEffect14(() => {
+  useEffect15(() => {
     const threadId = options.threadId;
     if (threadId === void 0) return;
     if (threadId === createdThreadId.current) return;
@@ -5325,7 +5418,7 @@ function useAgentChat(options = {}) {
     toolCallId,
     output
   }), []);
-  const [backgroundRuns, setBackgroundRuns] = useState14([]);
+  const [backgroundRuns, setBackgroundRuns] = useState15([]);
   const refreshBackground = useCallback11(async () => {
     const threadId = currentThreadId();
     if (threadId === void 0) {
@@ -5352,7 +5445,7 @@ function useAgentChat(options = {}) {
   ]);
   backgroundRef.current = refreshBackground;
   const isWorking = backgroundRuns.some((run) => run.status === "running");
-  useEffect14(() => {
+  useEffect15(() => {
     if (options.background !== true || options.threadId === void 0) {
       return;
     }
@@ -5363,7 +5456,7 @@ function useAgentChat(options = {}) {
     chatId,
     refreshBackground
   ]);
-  useEffect14(() => {
+  useEffect15(() => {
     const every = latest.current.backgroundPollMs ?? 5e3;
     if (latest.current.background !== true || !isWorking || every <= 0) {
       return;
@@ -5489,7 +5582,7 @@ function useAgentChat(options = {}) {
     client,
     currentThreadId
   ]);
-  const [modelsWanted, setModelsWanted] = useState14(false);
+  const [modelsWanted, setModelsWanted] = useState15(false);
   const modelsWantedRef = useRef12(modelsWanted);
   modelsWantedRef.current = modelsWanted;
   const catalog = useModels({
@@ -5534,6 +5627,10 @@ function useAgentChat(options = {}) {
       return catalog.providers;
     },
     selected: options.model ?? pickedModel ?? threadModel ?? catalog.defaultModel ?? null,
+    get defaultModel() {
+      wantModels();
+      return catalog.defaultModel;
+    },
     select: selectModel,
     pinToThread,
     isLoading: modelsWanted && catalog.isLoading,
@@ -5545,8 +5642,8 @@ function useAgentChat(options = {}) {
     ...options.composer,
     backend: client
   });
-  const [text, setText] = useState14("");
-  const blockedBy = blocked != null ? "quota" : files.isUploading ? "uploading" : isBusy ? "busy" : text.trim().length === 0 && files.attachments.length === 0 ? "empty" : null;
+  const [text, setText] = useState15("");
+  const blockedBy = blocked != null ? "quota" : files.isUploading ? "uploading" : isBusy ? "busy" : text.trim().length === 0 && files.refs.length === 0 ? "empty" : null;
   const composerRef = useRef12({
     text,
     files,
@@ -5561,10 +5658,26 @@ function useAgentChat(options = {}) {
     const current = composerRef.current;
     if (current.blockedBy !== null) return;
     const refs = current.files.refs;
+    const files2 = current.files.items.flatMap((item) => item.status === "ready" && item.attachment !== void 0 ? [
+      {
+        type: "file",
+        mediaType: item.attachment.contentType,
+        filename: item.attachment.name,
+        url: item.attachment.url,
+        providerMetadata: {
+          agent: {
+            mediaId: item.attachment.mediaId
+          }
+        }
+      }
+    ] : []);
     const draft = current.text.trim();
     setText("");
     current.files.clear();
-    await sendMessage({
+    await sendMessage(files2.length > 0 ? {
+      text: draft,
+      files: files2
+    } : {
       text: draft
     }, refs.length > 0 ? {
       body: {
@@ -5722,6 +5835,7 @@ export {
   toolCatalogFrom,
   useAgentBackend,
   useAgentChat,
+  useAgentConfig,
   useAgents,
   useAmbientRenderUi,
   useApprovalCountdown,