@dudousxd/nestjs-agent-react 0.14.0 → 0.15.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, {
+  AgentBackendUnsupportedError: () => AgentBackendUnsupportedError,
   AgentChatTransport: () => AgentChatTransport,
   AgentClient: () => AgentClient,
   AgentHttpError: () => AgentHttpError,
@@ -60,10 +61,13 @@ __export(src_exports, {
   inferResultView: () => inferResultView,
   isActionCall: () => isActionCall,
   loadStoredSpeechLang: () => loadStoredSpeechLang,
+  notifyThreads: () => notifyThreads,
+  onThreadsEvent: () => onThreadsEvent,
   persistSpeechLang: () => persistSpeechLang,
   phraseFor: () => phraseFor,
   readPath: () => readPath,
   readReasoningMs: () => readReasoningMs,
+  requireBackendMethod: () => requireBackendMethod,
   resolveResultView: () => resolveResultView,
   storedMessageToUiMessage: () => storedMessageToUiMessage,
   storedThreadToUiMessages: () => storedThreadToUiMessages,
@@ -74,8 +78,10 @@ __export(src_exports, {
   useChatTranscript: () => useChatTranscript,
   useComposerAutocomplete: () => useComposerAutocomplete,
   useElapsed: () => useElapsed,
+  useMessageFeedback: () => useMessageFeedback,
   useSpeechRecognition: () => useSpeechRecognition,
   useStickToBottom: () => useStickToBottom,
+  useThreads: () => useThreads,
   useToolCatalog: () => useToolCatalog,
   useTranscriptItem: () => useTranscriptItem,
   validateAnswer: () => import_nestjs_agent_core.validateElicitationAnswer,
@@ -83,6 +89,246 @@ __export(src_exports, {
 });
 module.exports = __toCommonJS(src_exports);
 
+// src/client.ts
+var AgentHttpError = class 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;
+    this.name = "AgentHttpError";
+  }
+};
+var HEADER_RUN_ID = "x-agent-run-id";
+var HEADER_THREAD_ID = "x-agent-thread-id";
+var AgentClient = class {
+  static {
+    __name(this, "AgentClient");
+  }
+  options;
+  constructor(options = {}) {
+    this.options = options;
+  }
+  /** `POST /agent/chat` → the turn's SSE stream. Throws {@link AgentHttpError} on a non-2xx. */
+  async openChatStream(request) {
+    const response = await this.fetchImpl()(`${this.baseUrl()}/agent/chat`, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        accept: "text/event-stream",
+        ...await this.resolveHeaders(),
+        ...request.headers
+      },
+      body: JSON.stringify(request.body),
+      ...this.credentials(),
+      ...request.signal !== void 0 ? {
+        signal: request.signal
+      } : {}
+    });
+    if (!response.ok || !response.body) {
+      throw new AgentHttpError(response.status, "POST", "/agent/chat", response.statusText);
+    }
+    return streamResponse(response);
+  }
+  /**
+  * `GET /agent/chat/:runId/stream[?after=<seq>]` → the run's SSE stream, or `null` when nothing is
+  * streaming under that id (404).
+  */
+  async resumeChatStream(request) {
+    const path = `/agent/chat/${encodeURIComponent(request.runId)}/stream`;
+    const query = request.after !== void 0 && request.after > 0 ? `?after=${request.after}` : "";
+    const response = await this.fetchImpl()(`${this.baseUrl()}${path}${query}`, {
+      method: "GET",
+      headers: {
+        accept: "text/event-stream",
+        ...await this.resolveHeaders(),
+        ...request.headers
+      },
+      ...this.credentials(),
+      ...request.signal !== void 0 ? {
+        signal: request.signal
+      } : {}
+    });
+    if (response.status === 404) {
+      return null;
+    }
+    if (!response.ok || !response.body) {
+      throw new AgentHttpError(response.status, "GET", path, response.statusText);
+    }
+    return streamResponse(response);
+  }
+  /**
+  * Rate a message (`'up'`/`'down'`, optional comment) or clear its rating (`value: null`). Answers
+  * the stored rating.
+  */
+  setMessageFeedback(messageId, input) {
+    return this.request("POST", `/agent/messages/${encodeURIComponent(messageId)}/feedback`, input);
+  }
+  listThreads() {
+    return this.request("GET", "/agent/threads");
+  }
+  /**
+  * The skills this caller can invoke right now, scope-resolved — the same list, built by the same
+  * call, that the model is offered, so what a user can type after a `/` and what the agent can
+  * reach cannot drift apart. `threadId` reaches the host's own resolver, which may scope a skill to
+  * one conversation; omitted, the server reads it as a brand-new thread.
+  */
+  listSkills(threadId) {
+    const query = threadId === void 0 ? "" : `?threadId=${encodeURIComponent(threadId)}`;
+    return this.request("GET", `/agent/skills${query}`);
+  }
+  /**
+  * The tools this caller can reach through `agent` (the default agent when omitted), each with the
+  * server-declared `presentation` a chat narrates it by — the same list the model is offered.
+  * Prefer {@link useToolCatalog}, which fetches it once and shares it.
+  */
+  listTools(agent) {
+    const query = agent === void 0 ? "" : `?agent=${encodeURIComponent(agent)}`;
+    return this.request("GET", `/agent/tools${query}`);
+  }
+  getThread(id) {
+    return this.request("GET", `/agent/threads/${encodeURIComponent(id)}`);
+  }
+  deleteThread(id) {
+    return this.request("DELETE", `/agent/threads/${encodeURIComponent(id)}`);
+  }
+  forkFromMessage(threadId, messageId) {
+    return this.request("POST", `/agent/threads/${encodeURIComponent(threadId)}/fork-from/${encodeURIComponent(messageId)}`);
+  }
+  renameThread(id, title) {
+    return this.updateThread(id, {
+      title
+    });
+  }
+  /** General `PATCH /agent/threads/:threadId` — title and/or the thread's pinned default agent. */
+  updateThread(id, patch) {
+    return this.request("PATCH", `/agent/threads/${encodeURIComponent(id)}`, patch);
+  }
+  /**
+  * Uploads a file (image/PDF) for a vision-capable model turn. Multipart, field name `file` —
+  * mirrors the backend's `POST /agent/attachments`. The returned {@link MessageAttachment} is
+  * what a caller then rides on `sendMessage({ text }, { body: { attachments: [...] } })`.
+  */
+  async uploadAttachment(file, options = {}) {
+    const formData = new FormData();
+    formData.append("file", file);
+    const response = await this.fetchImpl()(`${this.baseUrl()}/agent/attachments`, {
+      method: "POST",
+      headers: {
+        accept: "application/json",
+        ...await this.resolveHeaders()
+      },
+      body: formData,
+      ...this.credentials(),
+      ...options.signal !== void 0 ? {
+        signal: options.signal
+      } : {}
+    });
+    return this.handleResponse(response, "POST", "/agent/attachments");
+  }
+  promoteThread(id) {
+    return this.request("POST", `/agent/threads/${encodeURIComponent(id)}/promote`);
+  }
+  truncateFromMessage(threadId, messageId) {
+    return this.request("DELETE", `/agent/threads/${encodeURIComponent(threadId)}/from/${encodeURIComponent(messageId)}`);
+  }
+  getQuotaToday() {
+    return this.request("GET", "/agent/quota/today");
+  }
+  cancelStream(runId) {
+    return this.request("POST", `/agent/chat/${encodeURIComponent(runId)}/cancel`);
+  }
+  /**
+  * `remember` approves later calls of the same tool in the same thread; `via` names the surface
+  * the decision came through (the server records `'web'` when omitted).
+  */
+  approveToolCall(input) {
+    return this.request("POST", "/agent/tool-call/approve", input);
+  }
+  rejectToolCall(input) {
+    return this.request("POST", "/agent/tool-call/reject", input);
+  }
+  /**
+  * Settle a parked question set. `answers` is questionId → chosen option values; a question left
+  * 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.
+  */
+  answerToolCall(input) {
+    return this.request("POST", "/agent/tool-call/answer", input);
+  }
+  /**
+  * Decline to answer and let the agent proceed on its own pre-picked values. Lands on the same
+  * values a confirmation would, and persists differently on purpose — only one of them is
+  * evidence the user chose them.
+  */
+  skipToolCall(input) {
+    return this.request("POST", "/agent/tool-call/skip", input);
+  }
+  fetchImpl() {
+    return this.options.fetch ?? globalThis.fetch;
+  }
+  baseUrl() {
+    return (this.options.baseUrl ?? "").replace(/\/$/, "");
+  }
+  async resolveHeaders() {
+    const dynamic = await this.options.getHeaders?.() ?? {};
+    return {
+      ...this.options.headers,
+      ...dynamic
+    };
+  }
+  credentials() {
+    return this.options.credentials !== void 0 ? {
+      credentials: this.options.credentials
+    } : {};
+  }
+  async request(method, path, body) {
+    const response = await this.fetchImpl()(`${this.baseUrl()}${path}`, {
+      method,
+      headers: {
+        accept: "application/json",
+        ...body !== void 0 ? {
+          "content-type": "application/json"
+        } : {},
+        ...await this.resolveHeaders()
+      },
+      ...body !== void 0 ? {
+        body: JSON.stringify(body)
+      } : {},
+      ...this.credentials()
+    });
+    return this.handleResponse(response, method, path);
+  }
+  async handleResponse(response, method, path) {
+    if (!response.ok) {
+      throw new AgentHttpError(response.status, method, path, response.statusText);
+    }
+    if (response.status === 204) return void 0;
+    const text = await response.text();
+    if (!text) return void 0;
+    return JSON.parse(text);
+  }
+};
+function streamResponse(response) {
+  const body = response.body;
+  const runId = response.headers?.get(HEADER_RUN_ID) ?? void 0;
+  const threadId = response.headers?.get(HEADER_THREAD_ID) ?? void 0;
+  return {
+    body,
+    ...runId ? {
+      runId
+    } : {},
+    ...threadId ? {
+      threadId
+    } : {}
+  };
+}
+__name(streamResponse, "streamResponse");
+
 // src/reasoning/timing.ts
 var import_react = require("react");
 var REASONING_METADATA_KEY = "agent";
@@ -143,8 +389,11 @@ function formatElapsed(ms) {
 __name(formatElapsed, "formatElapsed");
 
 // src/agent-chat-transport.ts
-var HEADER_RUN_ID = "x-agent-run-id";
-var HEADER_THREAD_ID = "x-agent-thread-id";
+var DEFAULT_RECONNECT = {
+  maxAttempts: 6,
+  baseDelayMs: 500,
+  maxDelayMs: 8e3
+};
 var ASK_TOOL_NAME = "ask";
 var AgentChatTransport = class {
   static {
@@ -161,8 +410,26 @@ var AgentChatTransport = class {
   * several entries under each id — which React renders as duplicate keys.
   */
   attemptLive = false;
+  backend;
   constructor(options = {}) {
     this.options = options;
+    this.backend = options.backend ?? new AgentClient({
+      ...options.baseUrl !== void 0 ? {
+        baseUrl: options.baseUrl
+      } : {},
+      ...options.headers !== void 0 ? {
+        headers: options.headers
+      } : {},
+      ...options.getHeaders !== void 0 ? {
+        getHeaders: options.getHeaders
+      } : {},
+      ...options.credentials !== void 0 ? {
+        credentials: options.credentials
+      } : {},
+      ...options.fetch !== void 0 ? {
+        fetch: options.fetch
+      } : {}
+    });
   }
   /** Run id of the most recent stream — HITL approve/reject target this. */
   get runId() {
@@ -195,26 +462,25 @@ var AgentChatTransport = class {
         ...options.body ?? {},
         message
       };
-      const response = await this.fetchImpl()(`${this.baseUrl()}/agent/chat`, {
-        method: "POST",
-        headers: {
-          "content-type": "application/json",
-          accept: "text/event-stream",
-          ...await this.resolveHeaders(options.headers)
-        },
-        body: JSON.stringify(body),
-        ...this.options.credentials !== void 0 ? {
-          credentials: this.options.credentials
+      const headers = headerRecord(options.headers);
+      const response = await this.backend.openChatStream({
+        body,
+        ...headers !== void 0 ? {
+          headers
+        } : {},
+        ...options.abortSignal ? {
+          signal: options.abortSignal
+        } : {}
+      });
+      this.captureHeaderMeta(response);
+      return this.toChunkStream(response, {
+        ...headers !== void 0 ? {
+          headers
         } : {},
         ...options.abortSignal ? {
           signal: options.abortSignal
         } : {}
       });
-      if (!response.ok || !response.body) {
-        throw new Error(`Agent chat request failed: ${response.status} ${response.statusText}`);
-      }
-      this.captureHeaderMeta(response.headers);
-      return this.toChunkStream(response.body);
     } catch (error) {
       this.attemptLive = false;
       throw error;
@@ -227,51 +493,41 @@ var AgentChatTransport = class {
     if (runId === void 0) return null;
     this.attemptLive = true;
     try {
-      const response = await this.fetchImpl()(`${this.baseUrl()}/agent/chat/${encodeURIComponent(runId)}/stream`, {
-        method: "GET",
-        headers: {
-          accept: "text/event-stream",
-          ...await this.resolveHeaders(options.headers)
-        },
-        ...this.options.credentials !== void 0 ? {
-          credentials: this.options.credentials
+      const headers = headerRecord(options.headers);
+      const response = await this.backend.resumeChatStream({
+        runId,
+        ...headers !== void 0 ? {
+          headers
         } : {}
       });
-      if (response.status === 404) {
+      if (response === null) {
         this.attemptLive = false;
         return null;
       }
-      if (!response.ok || !response.body) {
-        throw new Error(`Agent stream reconnect failed: ${response.status} ${response.statusText}`);
-      }
-      this.captureHeaderMeta(response.headers);
-      return this.toChunkStream(response.body);
+      this.captureHeaderMeta(response);
+      return this.toChunkStream(response, {
+        runId,
+        ...headers !== void 0 ? {
+          headers
+        } : {}
+      });
     } catch (error) {
       this.attemptLive = false;
       throw error;
     }
   }
-  fetchImpl() {
-    return this.options.fetch ?? globalThis.fetch;
+  captureHeaderMeta(response) {
+    if (response.runId) this.currentRunId = response.runId;
+    if (response.threadId) this.currentThreadId = response.threadId;
   }
-  baseUrl() {
-    return (this.options.baseUrl ?? "").replace(/\/$/, "");
-  }
-  async resolveHeaders(perRequest) {
-    const dynamic = await this.options.getHeaders?.() ?? {};
-    const extra = perRequest instanceof Headers ? Object.fromEntries(perRequest.entries()) : perRequest ?? {};
+  reconnectPolicy() {
+    const configured = this.options.reconnect;
+    if (configured === false) return null;
     return {
-      ...this.options.headers,
-      ...dynamic,
-      ...extra
+      ...DEFAULT_RECONNECT,
+      ...configured
     };
   }
-  captureHeaderMeta(headers) {
-    const runId = headers.get(HEADER_RUN_ID);
-    const threadId = headers.get(HEADER_THREAD_ID);
-    if (runId) this.currentRunId = runId;
-    if (threadId) this.currentThreadId = threadId;
-  }
   recordMeta(meta) {
     this.currentRunId = meta.runId;
     this.currentThreadId = meta.threadId;
@@ -290,10 +546,66 @@ var AgentChatTransport = class {
   * call plus its tool execution; text and reasoning open lazily and close at the step boundary, so
   * tool-call cards (input streaming → output) render live between the prose.
   */
-  toChunkStream(source) {
-    const reader = source.getReader();
-    const decoder = new TextDecoder();
+  toChunkStream(source, context) {
+    let reader = source.body.getReader();
+    let decoder = new TextDecoder();
     let buffer = "";
+    let streamRunId = source.runId ?? context.runId;
+    let lastSeq;
+    let cancelled = false;
+    const backend = this.backend;
+    const policy = this.reconnectPolicy();
+    const notify = /* @__PURE__ */ __name((state) => this.options.onConnectionChange?.(state), "notify");
+    const aborted = /* @__PURE__ */ __name(() => cancelled || context.signal?.aborted === true, "aborted");
+    const canResume = /* @__PURE__ */ __name(() => policy !== null && lastSeq !== void 0 && streamRunId !== void 0 && !aborted(), "canResume");
+    const resume = /* @__PURE__ */ __name(async () => {
+      const runId = streamRunId;
+      const after = lastSeq ?? 0;
+      const { maxAttempts, baseDelayMs, maxDelayMs } = policy;
+      for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+        notify({
+          status: "reconnecting",
+          runId,
+          attempt,
+          after
+        });
+        await delay(Math.min(maxDelayMs, baseDelayMs * 2 ** (attempt - 1)), context.signal);
+        if (aborted()) return "aborted";
+        try {
+          const next = await backend.resumeChatStream({
+            runId,
+            after,
+            ...context.headers !== void 0 ? {
+              headers: context.headers
+            } : {},
+            ...context.signal !== void 0 ? {
+              signal: context.signal
+            } : {}
+          });
+          if (next === null) {
+            notify({
+              status: "gone",
+              runId
+            });
+            return "gone";
+          }
+          reader = next.body.getReader();
+          decoder = new TextDecoder();
+          buffer = "";
+          notify({
+            status: "live"
+          });
+          return "resumed";
+        } catch {
+          if (aborted()) return "aborted";
+        }
+      }
+      notify({
+        status: "failed",
+        runId
+      });
+      return "failed";
+    }, "resume");
     let started = false;
     let stepOpen = false;
     let stepIndex = 0;
@@ -304,7 +616,10 @@ var AgentChatTransport = class {
     let reasoningSeq = 0;
     const announced = /* @__PURE__ */ new Set();
     const toolMetadata = /* @__PURE__ */ new Map();
-    const record = /* @__PURE__ */ __name((meta) => this.recordMeta(meta), "record");
+    const record = /* @__PURE__ */ __name((meta) => {
+      streamRunId = meta.runId;
+      this.recordMeta(meta);
+    }, "record");
     const endAttempt = /* @__PURE__ */ __name(() => {
       this.attemptLive = false;
     }, "endAttempt");
@@ -313,7 +628,12 @@ var AgentChatTransport = class {
         function ensureStarted() {
           if (started) return;
           started = true;
-          controller.enqueue({
+          controller.enqueue(streamRunId !== void 0 ? {
+            type: "start",
+            messageMetadata: {
+              runId: streamRunId
+            }
+          } : {
             type: "start"
           });
         }
@@ -569,33 +889,67 @@ var AgentChatTransport = class {
           endAttempt();
         }
         __name(finish, "finish");
+        function fail(errorText, start = true) {
+          if (start) ensureStarted();
+          controller.enqueue({
+            type: "error",
+            errorText
+          });
+          controller.close();
+          endAttempt();
+        }
+        __name(fail, "fail");
+        async function recover(error) {
+          if (!canResume()) {
+            if (error === void 0) {
+              finish();
+            } else {
+              fail(error instanceof Error ? error.message : "Agent stream error", false);
+            }
+            return false;
+          }
+          const outcome = await resume();
+          if (outcome === "resumed") return true;
+          if (outcome === "failed") {
+            fail("Lost the connection to the agent stream");
+          } else {
+            finish();
+          }
+          return false;
+        }
+        __name(recover, "recover");
         try {
           while (true) {
-            const { done, value } = await reader.read();
-            if (done) {
-              finish();
+            let result;
+            try {
+              result = await reader.read();
+            } catch (error) {
+              if (await recover(error)) continue;
+              return;
+            }
+            if (result.done) {
+              if (await recover(void 0)) continue;
               return;
             }
-            buffer += decoder.decode(value, {
+            buffer += decoder.decode(result.value, {
               stream: true
             });
             let separator = buffer.indexOf("\n\n");
             while (separator !== -1) {
               const rawEvent = buffer.slice(0, separator);
               buffer = buffer.slice(separator + 2);
+              separator = buffer.indexOf("\n\n");
               const frame = parseSseFrame(rawEvent);
+              if (frame.id !== void 0) {
+                if (lastSeq !== void 0 && frame.id <= lastSeq) continue;
+                lastSeq = frame.id;
+              }
               if (frame.event === "done") {
                 finish();
                 return;
               }
               if (frame.event === "error") {
-                ensureStarted();
-                controller.enqueue({
-                  type: "error",
-                  errorText: parseErrorText(frame.data)
-                });
-                controller.close();
-                endAttempt();
+                fail(parseErrorText(frame.data));
                 return;
               }
               if (frame.event === "meta") {
@@ -605,19 +959,14 @@ var AgentChatTransport = class {
                 const event = parseEvent(frame.data);
                 if (event) emit(event);
               }
-              separator = buffer.indexOf("\n\n");
             }
           }
         } catch (error) {
-          controller.enqueue({
-            type: "error",
-            errorText: error instanceof Error ? error.message : "Agent stream error"
-          });
-          controller.close();
-          endAttempt();
+          fail(error instanceof Error ? error.message : "Agent stream error", false);
         }
       },
       cancel() {
+        cancelled = true;
         void reader.cancel();
         endAttempt();
       }
@@ -626,17 +975,22 @@ var AgentChatTransport = class {
 };
 function parseSseFrame(raw) {
   let event;
+  let id;
   const dataLines = [];
   for (const line of raw.split("\n")) {
     if (line.startsWith("event:")) {
       event = line.slice("event:".length).trim();
+    } else if (line.startsWith("id:")) {
+      const parsed = Number(line.slice("id:".length).trim());
+      if (Number.isSafeInteger(parsed) && parsed > 0) id = parsed;
     } else if (line.startsWith("data:")) {
       dataLines.push(line.slice("data:".length).trimStart());
     }
   }
   return {
     event,
-    data: dataLines.length > 0 ? dataLines.join("\n") : void 0
+    data: dataLines.length > 0 ? dataLines.join("\n") : void 0,
+    id
   };
 }
 __name(parseSseFrame, "parseSseFrame");
@@ -677,15 +1031,282 @@ function parseEvent(data) {
   }
   return null;
 }
-__name(parseEvent, "parseEvent");
-function extractText(message) {
-  let text = "";
-  for (const part of message.parts ?? []) {
-    if (part.type === "text") text += part.text;
+__name(parseEvent, "parseEvent");
+function extractText(message) {
+  let text = "";
+  for (const part of message.parts ?? []) {
+    if (part.type === "text") text += part.text;
+  }
+  return text;
+}
+__name(extractText, "extractText");
+function headerRecord(headers) {
+  if (headers === void 0) return void 0;
+  return headers instanceof Headers ? Object.fromEntries(headers.entries()) : headers;
+}
+__name(headerRecord, "headerRecord");
+function delay(ms, signal) {
+  if (ms <= 0 || signal?.aborted) return Promise.resolve();
+  return new Promise((resolve) => {
+    const timer = setTimeout(done, ms);
+    function done() {
+      clearTimeout(timer);
+      signal?.removeEventListener("abort", done);
+      resolve();
+    }
+    __name(done, "done");
+    signal?.addEventListener("abort", done, {
+      once: true
+    });
+  });
+}
+__name(delay, "delay");
+
+// src/backend.ts
+var AgentBackendUnsupportedError = class extends Error {
+  static {
+    __name(this, "AgentBackendUnsupportedError");
+  }
+  method;
+  constructor(method) {
+    super(`The agent backend does not implement ${method}()`), this.method = method;
+    this.name = "AgentBackendUnsupportedError";
+  }
+};
+function requireBackendMethod(backend, name) {
+  const method = backend[name];
+  if (typeof method !== "function") {
+    throw new AgentBackendUnsupportedError(name);
+  }
+  return method.bind(backend);
+}
+__name(requireBackendMethod, "requireBackendMethod");
+
+// src/feedback/use-message-feedback.ts
+var import_react2 = require("react");
+function useMessageFeedback(options) {
+  const latest = (0, import_react2.useRef)(options);
+  latest.current = options;
+  const [local, setLocal] = (0, import_react2.useState)(/* @__PURE__ */ new Map());
+  const [pending, setPending] = (0, import_react2.useState)(/* @__PURE__ */ new Set());
+  const [error, setError] = (0, import_react2.useState)(null);
+  const localRef = (0, import_react2.useRef)(local);
+  localRef.current = local;
+  const resolved = (0, import_react2.useRef)(/* @__PURE__ */ new Map());
+  const feedbackOf = (0, import_react2.useCallback)((message) => {
+    const mine = local.get(message.id);
+    if (mine !== void 0) return mine.feedback;
+    return metadataOf(message).feedback ?? null;
+  }, [
+    local
+  ]);
+  const isPending = (0, import_react2.useCallback)((message) => pending.has(message.id), [
+    pending
+  ]);
+  const storedIdFor = (0, import_react2.useCallback)(async (message) => {
+    const runId = metadataOf(message).runId;
+    if (runId === void 0) return message.id;
+    const known = resolved.current.get(message.id);
+    if (known !== void 0) return known;
+    const { backend, threadId } = latest.current;
+    const thread = typeof threadId === "function" ? threadId() : threadId;
+    if (thread === void 0) {
+      throw new Error("useMessageFeedback: a streamed message needs `threadId` to be rated");
+    }
+    const detail = await backend.getThread(thread);
+    const row = [
+      ...detail.messages
+    ].reverse().find((candidate) => candidate.role === "assistant" && candidate.runId === runId);
+    if (row === void 0) {
+      throw new Error(`useMessageFeedback: run ${runId} has no persisted answer yet`);
+    }
+    resolved.current.set(message.id, row.id);
+    return row.id;
+  }, []);
+  const rate = (0, import_react2.useCallback)(async (message, value, comment) => {
+    const setFeedback = requireBackendMethod(latest.current.backend, "setMessageFeedback");
+    const had = localRef.current.get(message.id);
+    const optimistic = value === null ? null : {
+      value,
+      ...comment !== void 0 && comment.trim().length > 0 ? {
+        comment: comment.trim()
+      } : {},
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    setLocal((current) => new Map(current).set(message.id, {
+      feedback: optimistic
+    }));
+    setPending((current) => new Set(current).add(message.id));
+    try {
+      const storedId = await storedIdFor(message);
+      const { feedback } = await setFeedback(storedId, {
+        value,
+        ...comment !== void 0 ? {
+          comment
+        } : {}
+      });
+      setLocal((current) => new Map(current).set(message.id, {
+        feedback
+      }));
+      setError(null);
+    } catch (caught) {
+      setLocal((current) => {
+        const next = new Map(current);
+        if (had === void 0) next.delete(message.id);
+        else next.set(message.id, had);
+        return next;
+      });
+      const failure = caught instanceof Error ? caught : new Error(String(caught));
+      setError(failure);
+      throw failure;
+    } finally {
+      setPending((current) => {
+        const next = new Set(current);
+        next.delete(message.id);
+        return next;
+      });
+    }
+  }, [
+    storedIdFor
+  ]);
+  const toggle = (0, import_react2.useCallback)((message, value) => {
+    const mine = localRef.current.get(message.id);
+    const current = mine !== void 0 ? mine.feedback : metadataOf(message).feedback ?? null;
+    return rate(message, current?.value === value ? null : value);
+  }, [
+    rate
+  ]);
+  return {
+    feedbackOf,
+    isPending,
+    rate,
+    toggle,
+    error
+  };
+}
+__name(useMessageFeedback, "useMessageFeedback");
+function metadataOf(message) {
+  const metadata = message.metadata;
+  return metadata !== null && typeof metadata === "object" ? metadata : {};
+}
+__name(metadataOf, "metadataOf");
+
+// src/threads/threads-events.ts
+var listeners = /* @__PURE__ */ new WeakMap();
+function notifyThreads(backend, event) {
+  for (const listener of listeners.get(backend) ?? []) {
+    listener(event);
   }
-  return text;
 }
-__name(extractText, "extractText");
+__name(notifyThreads, "notifyThreads");
+function onThreadsEvent(backend, listener) {
+  let set = listeners.get(backend);
+  if (set === void 0) {
+    set = /* @__PURE__ */ new Set();
+    listeners.set(backend, set);
+  }
+  set.add(listener);
+  return () => {
+    set.delete(listener);
+  };
+}
+__name(onThreadsEvent, "onThreadsEvent");
+
+// src/threads/use-threads.ts
+var import_react3 = require("react");
+function useThreads(options) {
+  const { backend, enabled = true } = options;
+  const [threads, setThreads] = (0, import_react3.useState)([]);
+  const [isLoading, setIsLoading] = (0, import_react3.useState)(enabled);
+  const [error, setError] = (0, import_react3.useState)(null);
+  const threadsRef = (0, import_react3.useRef)(threads);
+  threadsRef.current = threads;
+  const generation = (0, import_react3.useRef)(0);
+  const refresh = (0, import_react3.useCallback)(async () => {
+    const mine = ++generation.current;
+    setIsLoading(true);
+    try {
+      const list = await backend.listThreads();
+      if (mine !== generation.current) return;
+      setThreads(list);
+      setError(null);
+    } catch (caught) {
+      if (mine !== generation.current) return;
+      setError(caught instanceof Error ? caught : new Error(String(caught)));
+    } finally {
+      if (mine === generation.current) setIsLoading(false);
+    }
+  }, [
+    backend
+  ]);
+  (0, import_react3.useEffect)(() => {
+    if (!enabled) return;
+    void refresh();
+    return onThreadsEvent(backend, (event) => {
+      if (event.type === "title") {
+        setThreads((current) => current.map((thread) => thread.id === event.threadId ? {
+          ...thread,
+          title: event.title
+        } : thread));
+      } else if (event.type === "removed") {
+        setThreads((current) => current.filter((thread) => thread.id !== event.threadId));
+      } else {
+        void refresh();
+      }
+    });
+  }, [
+    backend,
+    enabled,
+    refresh
+  ]);
+  const rename = (0, import_react3.useCallback)(async (id, title) => {
+    const before = threadsRef.current;
+    setThreads((current) => current.map((thread) => thread.id === id ? {
+      ...thread,
+      title
+    } : thread));
+    try {
+      await backend.updateThread(id, {
+        title
+      });
+      notifyThreads(backend, {
+        type: "title",
+        threadId: id,
+        title
+      });
+    } catch (caught) {
+      setThreads(before);
+      throw caught;
+    }
+  }, [
+    backend
+  ]);
+  const remove = (0, import_react3.useCallback)(async (id) => {
+    const before = threadsRef.current;
+    setThreads((current) => current.filter((thread) => thread.id !== id));
+    try {
+      await backend.deleteThread(id);
+      notifyThreads(backend, {
+        type: "removed",
+        threadId: id
+      });
+    } catch (caught) {
+      setThreads(before);
+      throw caught;
+    }
+  }, [
+    backend
+  ]);
+  return {
+    threads,
+    isLoading,
+    error,
+    refresh,
+    rename,
+    remove
+  };
+}
+__name(useThreads, "useThreads");
 
 // src/background-runs.ts
 function asReceipt(output) {
@@ -734,170 +1355,11 @@ function backgroundRunsFromThread(messages) {
 }
 __name(backgroundRunsFromThread, "backgroundRunsFromThread");
 
-// src/client.ts
-var AgentHttpError = class 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;
-    this.name = "AgentHttpError";
-  }
-};
-var AgentClient = class {
-  static {
-    __name(this, "AgentClient");
-  }
-  options;
-  constructor(options = {}) {
-    this.options = options;
-  }
-  listThreads() {
-    return this.request("GET", "/agent/threads");
-  }
-  /**
-  * The skills this caller can invoke right now, scope-resolved — the same list, built by the same
-  * call, that the model is offered, so what a user can type after a `/` and what the agent can
-  * reach cannot drift apart. `threadId` reaches the host's own resolver, which may scope a skill to
-  * one conversation; omitted, the server reads it as a brand-new thread.
-  */
-  listSkills(threadId) {
-    const query = threadId === void 0 ? "" : `?threadId=${encodeURIComponent(threadId)}`;
-    return this.request("GET", `/agent/skills${query}`);
-  }
-  /**
-  * The tools this caller can reach through `agent` (the default agent when omitted), each with the
-  * server-declared `presentation` a chat narrates it by — the same list the model is offered.
-  * Prefer {@link useToolCatalog}, which fetches it once and shares it.
-  */
-  listTools(agent) {
-    const query = agent === void 0 ? "" : `?agent=${encodeURIComponent(agent)}`;
-    return this.request("GET", `/agent/tools${query}`);
-  }
-  getThread(id) {
-    return this.request("GET", `/agent/threads/${encodeURIComponent(id)}`);
-  }
-  deleteThread(id) {
-    return this.request("DELETE", `/agent/threads/${encodeURIComponent(id)}`);
-  }
-  forkFromMessage(threadId, messageId) {
-    return this.request("POST", `/agent/threads/${encodeURIComponent(threadId)}/fork-from/${encodeURIComponent(messageId)}`);
-  }
-  renameThread(id, title) {
-    return this.updateThread(id, {
-      title
-    });
-  }
-  /** General `PATCH /agent/threads/:threadId` — title and/or the thread's pinned default agent. */
-  updateThread(id, patch) {
-    return this.request("PATCH", `/agent/threads/${encodeURIComponent(id)}`, patch);
-  }
-  /**
-  * Uploads a file (image/PDF) for a vision-capable model turn. Multipart, field name `file` —
-  * mirrors the backend's `POST /agent/attachments`. The returned {@link MessageAttachment} is
-  * what a caller then rides on `sendMessage({ text }, { body: { attachments: [...] } })`.
-  */
-  async uploadAttachment(file) {
-    const fetchImpl = this.options.fetch ?? globalThis.fetch;
-    const baseUrl = (this.options.baseUrl ?? "").replace(/\/$/, "");
-    const dynamic = await this.options.getHeaders?.() ?? {};
-    const formData = new FormData();
-    formData.append("file", file);
-    const response = await fetchImpl(`${baseUrl}/agent/attachments`, {
-      method: "POST",
-      headers: {
-        accept: "application/json",
-        ...this.options.headers,
-        ...dynamic
-      },
-      body: formData,
-      ...this.options.credentials !== void 0 ? {
-        credentials: this.options.credentials
-      } : {}
-    });
-    return this.handleResponse(response, "POST", "/agent/attachments");
-  }
-  promoteThread(id) {
-    return this.request("POST", `/agent/threads/${encodeURIComponent(id)}/promote`);
-  }
-  truncateFromMessage(threadId, messageId) {
-    return this.request("DELETE", `/agent/threads/${encodeURIComponent(threadId)}/from/${encodeURIComponent(messageId)}`);
-  }
-  getQuotaToday() {
-    return this.request("GET", "/agent/quota/today");
-  }
-  cancelStream(runId) {
-    return this.request("POST", `/agent/chat/${encodeURIComponent(runId)}/cancel`);
-  }
-  /**
-  * `remember` approves later calls of the same tool in the same thread; `via` names the surface
-  * the decision came through (the server records `'web'` when omitted).
-  */
-  approveToolCall(input) {
-    return this.request("POST", "/agent/tool-call/approve", input);
-  }
-  rejectToolCall(input) {
-    return this.request("POST", "/agent/tool-call/reject", input);
-  }
-  /**
-  * Settle a parked question set. `answers` is questionId → chosen option values; a question left
-  * 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.
-  */
-  answerToolCall(input) {
-    return this.request("POST", "/agent/tool-call/answer", input);
-  }
-  /**
-  * Decline to answer and let the agent proceed on its own pre-picked values. Lands on the same
-  * values a confirmation would, and persists differently on purpose — only one of them is
-  * evidence the user chose them.
-  */
-  skipToolCall(input) {
-    return this.request("POST", "/agent/tool-call/skip", input);
-  }
-  async request(method, path, body) {
-    const fetchImpl = this.options.fetch ?? globalThis.fetch;
-    const baseUrl = (this.options.baseUrl ?? "").replace(/\/$/, "");
-    const dynamic = await this.options.getHeaders?.() ?? {};
-    const response = await fetchImpl(`${baseUrl}${path}`, {
-      method,
-      headers: {
-        accept: "application/json",
-        ...body !== void 0 ? {
-          "content-type": "application/json"
-        } : {},
-        ...this.options.headers,
-        ...dynamic
-      },
-      ...body !== void 0 ? {
-        body: JSON.stringify(body)
-      } : {},
-      ...this.options.credentials !== void 0 ? {
-        credentials: this.options.credentials
-      } : {}
-    });
-    return this.handleResponse(response, method, path);
-  }
-  async handleResponse(response, method, path) {
-    if (!response.ok) {
-      throw new AgentHttpError(response.status, method, path, response.statusText);
-    }
-    if (response.status === 204) return void 0;
-    const text = await response.text();
-    if (!text) return void 0;
-    return JSON.parse(text);
-  }
-};
-
 // src/components/chat-input.tsx
-var import_react3 = __toESM(require("react"), 1);
+var import_react5 = __toESM(require("react"), 1);
 
 // src/components/use-speech-recognition.ts
-var import_react2 = require("react");
+var import_react4 = require("react");
 function getRecognitionCtor() {
   if (typeof window === "undefined") return null;
   const scope = window;
@@ -905,15 +1367,15 @@ function getRecognitionCtor() {
 }
 __name(getRecognitionCtor, "getRecognitionCtor");
 function useSpeechRecognition({ lang = "en-US", onFinalTranscript, onInterimTranscript }) {
-  const recognitionRef = (0, import_react2.useRef)(null);
-  const [isListening, setIsListening] = (0, import_react2.useState)(false);
-  const ctor = (0, import_react2.useMemo)(() => getRecognitionCtor(), []);
+  const recognitionRef = (0, import_react4.useRef)(null);
+  const [isListening, setIsListening] = (0, import_react4.useState)(false);
+  const ctor = (0, import_react4.useMemo)(() => getRecognitionCtor(), []);
   const isSupported = ctor !== null;
-  const finalRef = (0, import_react2.useRef)(onFinalTranscript);
-  const interimRef = (0, import_react2.useRef)(onInterimTranscript);
+  const finalRef = (0, import_react4.useRef)(onFinalTranscript);
+  const interimRef = (0, import_react4.useRef)(onInterimTranscript);
   finalRef.current = onFinalTranscript;
   interimRef.current = onInterimTranscript;
-  (0, import_react2.useEffect)(() => {
+  (0, import_react4.useEffect)(() => {
     if (!ctor) return;
     const recognition = new ctor();
     recognition.lang = lang;
@@ -952,7 +1414,7 @@ function useSpeechRecognition({ lang = "en-US", onFinalTranscript, onInterimTran
     ctor,
     lang
   ]);
-  const start = (0, import_react2.useCallback)(() => {
+  const start = (0, import_react4.useCallback)(() => {
     const recognition = recognitionRef.current;
     if (!recognition) return;
     try {
@@ -962,7 +1424,7 @@ function useSpeechRecognition({ lang = "en-US", onFinalTranscript, onInterimTran
       console.warn("SpeechRecognition start failed", error);
     }
   }, []);
-  const stop = (0, import_react2.useCallback)(() => {
+  const stop = (0, import_react4.useCallback)(() => {
     const recognition = recognitionRef.current;
     if (!recognition) return;
     try {
@@ -981,8 +1443,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] = (0, import_react3.useState)("");
-  const [interim, setInterim] = (0, import_react3.useState)("");
+  const [value, setValue] = (0, import_react5.useState)("");
+  const [interim, setInterim] = (0, import_react5.useState)("");
   const speech = useSpeechRecognition({
     lang: speechLang,
     onFinalTranscript: /* @__PURE__ */ __name((text) => {
@@ -993,7 +1455,7 @@ function ChatInput({ onSubmit, disabled, placeholder, rows = 2, enableSpeech = t
     }, "onFinalTranscript"),
     onInterimTranscript: /* @__PURE__ */ __name((text) => setInterim(text), "onInterimTranscript")
   });
-  (0, import_react3.useEffect)(() => {
+  (0, import_react5.useEffect)(() => {
     if (!speech.isListening) setInterim("");
   }, [
     speech.isListening
@@ -1021,9 +1483,9 @@ function ChatInput({ onSubmit, disabled, placeholder, rows = 2, enableSpeech = t
   const displayValue = speech.isListening && interim ? `${value}${value && !value.endsWith(" ") ? " " : ""}${interim}` : value;
   const showMic = enableSpeech && speech.isSupported;
   const showStop = isStreaming && onStop !== void 0;
-  return /* @__PURE__ */ import_react3.default.createElement("div", {
+  return /* @__PURE__ */ import_react5.default.createElement("div", {
     className
-  }, /* @__PURE__ */ import_react3.default.createElement("textarea", {
+  }, /* @__PURE__ */ import_react5.default.createElement("textarea", {
     className: textareaClassName,
     rows,
     value: displayValue,
@@ -1034,17 +1496,17 @@ function ChatInput({ onSubmit, disabled, placeholder, rows = 2, enableSpeech = t
     }, "onChange"),
     onKeyDown: handleKeyDown,
     placeholder: placeholder ?? "Ask something (Enter to send, Shift+Enter for newline)"
-  }), /* @__PURE__ */ import_react3.default.createElement("button", {
+  }), /* @__PURE__ */ import_react5.default.createElement("button", {
     type: "button",
     className: sendButtonClassName,
     onClick: submit,
     disabled: disabled || !value.trim()
-  }, sendLabel), showStop ? /* @__PURE__ */ import_react3.default.createElement("button", {
+  }, sendLabel), showStop ? /* @__PURE__ */ import_react5.default.createElement("button", {
     type: "button",
     className: stopButtonClassName,
     onClick: /* @__PURE__ */ __name(() => void onStop(), "onClick"),
     "aria-label": "Stop generating"
-  }, stopLabel) : null, showMic ? /* @__PURE__ */ import_react3.default.createElement("button", {
+  }, stopLabel) : null, showMic ? /* @__PURE__ */ import_react5.default.createElement("button", {
     type: "button",
     className: micButtonClassName,
     onClick: toggleMic,
@@ -1057,10 +1519,10 @@ function ChatInput({ onSubmit, disabled, placeholder, rows = 2, enableSpeech = t
 __name(ChatInput, "ChatInput");
 
 // src/components/message-item.tsx
-var import_react6 = __toESM(require("react"), 1);
+var import_react8 = __toESM(require("react"), 1);
 
 // src/transcript/use-chat-transcript.ts
-var import_react5 = require("react");
+var import_react7 = require("react");
 
 // src/transcript/model.ts
 var import_nestjs_agent_core2 = require("@dudousxd/nestjs-agent-core");
@@ -2037,11 +2499,11 @@ function formatCostUsd(cost) {
 __name(formatCostUsd, "formatCostUsd");
 
 // src/transcript/use-stick-to-bottom.ts
-var import_react4 = require("react");
+var import_react6 = require("react");
 function useStickToBottom({ contentKey, threshold = 32 }) {
-  const containerRef = (0, import_react4.useRef)(null);
-  const [isAtBottom, setIsAtBottom] = (0, import_react4.useState)(true);
-  const measure = (0, import_react4.useCallback)(() => {
+  const containerRef = (0, import_react6.useRef)(null);
+  const [isAtBottom, setIsAtBottom] = (0, import_react6.useState)(true);
+  const measure = (0, import_react6.useCallback)(() => {
     const element = containerRef.current;
     if (!element) {
       return;
@@ -2051,7 +2513,7 @@ function useStickToBottom({ contentKey, threshold = 32 }) {
   }, [
     threshold
   ]);
-  const scrollToBottom = (0, import_react4.useCallback)(() => {
+  const scrollToBottom = (0, import_react6.useCallback)(() => {
     const element = containerRef.current;
     if (!element) {
       return;
@@ -2059,7 +2521,7 @@ function useStickToBottom({ contentKey, threshold = 32 }) {
     element.scrollTop = element.scrollHeight;
     setIsAtBottom(true);
   }, []);
-  const setContainer = (0, import_react4.useCallback)((element) => {
+  const setContainer = (0, import_react6.useCallback)((element) => {
     containerRef.current = element;
     if (element) {
       measure();
@@ -2067,7 +2529,7 @@ function useStickToBottom({ contentKey, threshold = 32 }) {
   }, [
     measure
   ]);
-  (0, import_react4.useEffect)(() => {
+  (0, import_react6.useEffect)(() => {
     if (isAtBottom) {
       scrollToBottom();
     }
@@ -2076,7 +2538,7 @@ function useStickToBottom({ contentKey, threshold = 32 }) {
     isAtBottom,
     scrollToBottom
   ]);
-  const getContainerProps = (0, import_react4.useCallback)(() => ({
+  const getContainerProps = (0, import_react6.useCallback)(() => ({
     ref: setContainer,
     onScroll: measure
   }), [
@@ -2098,14 +2560,14 @@ var DEFAULT_LOAD_EARLIER_STEP = 50;
 var DEFAULT_COPY_RESET_MS = 1500;
 function useChatTranscript(options) {
   const { messages, status, initialVisibleCount = DEFAULT_VISIBLE_COUNT, loadEarlierStep = DEFAULT_LOAD_EARLIER_STEP, followUps, stickToBottomThreshold } = options;
-  const latest = (0, import_react5.useRef)(options);
+  const latest = (0, import_react7.useRef)(options);
   latest.current = options;
-  const [visibleCount, setVisibleCount] = (0, import_react5.useState)(initialVisibleCount);
-  const [stopRequested, setStopRequested] = (0, import_react5.useState)(false);
-  const isStreaming = status === "streaming";
+  const [visibleCount, setVisibleCount] = (0, import_react7.useState)(initialVisibleCount);
+  const [stopRequested, setStopRequested] = (0, import_react7.useState)(false);
+  const isStreaming = status === "streaming" || status === "reconnecting";
   const isBusy = status === "submitted" || isStreaming;
   const isEmpty = messages.length === 0;
-  (0, import_react5.useEffect)(() => {
+  (0, import_react7.useEffect)(() => {
     if (!isBusy) {
       setStopRequested(false);
     }
@@ -2122,16 +2584,16 @@ function useChatTranscript(options) {
     streamingMessageId,
     options
   });
-  const stop = (0, import_react5.useCallback)(() => {
+  const stop = (0, import_react7.useCallback)(() => {
     const current = latest.current;
-    if (current.status !== "submitted" && current.status !== "streaming") {
+    if (current.status !== "submitted" && current.status !== "streaming" && current.status !== "reconnecting") {
       return;
     }
     setStopRequested(true);
     void current.onStop?.();
   }, []);
-  const loadEarlier = (0, import_react5.useCallback)(() => setVisibleCount((count) => count + (latest.current.loadEarlierStep ?? DEFAULT_LOAD_EARLIER_STEP)), []);
-  const showAll = (0, import_react5.useCallback)(() => setVisibleCount(latest.current.messages.length), []);
+  const loadEarlier = (0, import_react7.useCallback)(() => setVisibleCount((count) => count + (latest.current.loadEarlierStep ?? DEFAULT_LOAD_EARLIER_STEP)), []);
+  const showAll = (0, import_react7.useCallback)(() => setVisibleCount(latest.current.messages.length), []);
   const scroll = useStickToBottom({
     contentKey: contentSignature(messages),
     ...stickToBottomThreshold !== void 0 ? {
@@ -2167,7 +2629,7 @@ function useChatTranscript(options) {
 __name(useChatTranscript, "useChatTranscript");
 function useTranscriptItem(options) {
   const { message, isStreaming = false } = options;
-  const messagesRef = (0, import_react5.useRef)([
+  const messagesRef = (0, import_react7.useRef)([
     message
   ]);
   if (messagesRef.current[0] !== message) {
@@ -2185,13 +2647,13 @@ function useTranscriptItem(options) {
 }
 __name(useTranscriptItem, "useTranscriptItem");
 function useTranscriptItems({ messages, visibleStart, streamingMessageId, options }) {
-  const [drafts, setDrafts] = (0, import_react5.useState)(() => /* @__PURE__ */ new Map());
-  const [copied, setCopied] = (0, import_react5.useState)(() => /* @__PURE__ */ new Set());
-  const [openReasoning, setOpenReasoning] = (0, import_react5.useState)(() => /* @__PURE__ */ new Map());
-  const [picks, setPicks] = (0, import_react5.useState)(() => /* @__PURE__ */ new Map());
-  const [settling, setSettling] = (0, import_react5.useState)(() => /* @__PURE__ */ new Map());
-  const [settleErrors, setSettleErrors] = (0, import_react5.useState)(() => /* @__PURE__ */ new Map());
-  const latest = (0, import_react5.useRef)({
+  const [drafts, setDrafts] = (0, import_react7.useState)(() => /* @__PURE__ */ new Map());
+  const [copied, setCopied] = (0, import_react7.useState)(() => /* @__PURE__ */ new Set());
+  const [openReasoning, setOpenReasoning] = (0, import_react7.useState)(() => /* @__PURE__ */ new Map());
+  const [picks, setPicks] = (0, import_react7.useState)(() => /* @__PURE__ */ new Map());
+  const [settling, setSettling] = (0, import_react7.useState)(() => /* @__PURE__ */ new Map());
+  const [settleErrors, setSettleErrors] = (0, import_react7.useState)(() => /* @__PURE__ */ new Map());
+  const latest = (0, import_react7.useRef)({
     options,
     drafts,
     picks,
@@ -2203,23 +2665,23 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
     picks,
     messages
   };
-  const copyTimers = (0, import_react5.useRef)(/* @__PURE__ */ new Map());
-  (0, import_react5.useEffect)(() => () => {
+  const copyTimers = (0, import_react7.useRef)(/* @__PURE__ */ new Map());
+  (0, import_react7.useEffect)(() => () => {
     for (const timer of copyTimers.current.values()) {
       clearTimeout(timer);
     }
     copyTimers.current.clear();
   }, []);
-  const callbackCache = (0, import_react5.useRef)(/* @__PURE__ */ new Map());
-  const reasoningToggleCache = (0, import_react5.useRef)(/* @__PURE__ */ new Map());
-  const toggleReasoning = (0, import_react5.useCallback)((key, open) => {
+  const callbackCache = (0, import_react7.useRef)(/* @__PURE__ */ new Map());
+  const reasoningToggleCache = (0, import_react7.useRef)(/* @__PURE__ */ new Map());
+  const toggleReasoning = (0, import_react7.useCallback)((key, open) => {
     setOpenReasoning((current) => {
       const next = new Map(current);
       next.set(key, open ?? !(current.get(key) ?? false));
       return next;
     });
   }, []);
-  const stableToggle = (0, import_react5.useCallback)((key) => {
+  const stableToggle = (0, import_react7.useCallback)((key) => {
     let cached = reasoningToggleCache.current.get(key);
     if (!cached) {
       cached = /* @__PURE__ */ __name((open) => toggleReasoning(key, open), "cached");
@@ -2229,10 +2691,10 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
   }, [
     toggleReasoning
   ]);
-  const pick = (0, import_react5.useCallback)((toolCallId, questionId, values) => {
+  const pick = (0, import_react7.useCallback)((toolCallId, questionId, values) => {
     setPicks((current) => new Map(current).set(pickKey(toolCallId, questionId), values));
   }, []);
-  const settle = (0, import_react5.useCallback)((toolCallId, action, send) => {
+  const settle = (0, import_react7.useCallback)((toolCallId, action, send) => {
     setSettleErrors((current) => {
       if (!current.has(toolCallId)) {
         return current;
@@ -2256,7 +2718,7 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
       failed(error);
     }
   }, []);
-  const answer = (0, import_react5.useCallback)((toolCallId) => {
+  const answer = (0, import_react7.useCallback)((toolCallId) => {
     const current = latest.current;
     const onAnswer = current.options.onAnswer;
     if (!onAnswer) {
@@ -2266,7 +2728,7 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
   }, [
     settle
   ]);
-  const skip = (0, import_react5.useCallback)((toolCallId) => {
+  const skip = (0, import_react7.useCallback)((toolCallId) => {
     const onSkip = latest.current.options.onSkip;
     if (onSkip) {
       settle(toolCallId, "skip", () => onSkip(toolCallId));
@@ -2274,7 +2736,7 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
   }, [
     settle
   ]);
-  const approve = (0, import_react5.useCallback)((toolCallId, options2) => {
+  const approve = (0, import_react7.useCallback)((toolCallId, options2) => {
     const onApprove = latest.current.options.onApprove;
     if (onApprove) {
       settle(toolCallId, "approve", () => options2 === void 0 ? onApprove(toolCallId) : onApprove(toolCallId, options2));
@@ -2282,7 +2744,7 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
   }, [
     settle
   ]);
-  const reject = (0, import_react5.useCallback)((toolCallId) => {
+  const reject = (0, import_react7.useCallback)((toolCallId) => {
     const onReject = latest.current.options.onReject;
     if (onReject) {
       settle(toolCallId, "reject", () => onReject(toolCallId));
@@ -2290,7 +2752,7 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
   }, [
     settle
   ]);
-  const callbacksFor = (0, import_react5.useCallback)((id) => {
+  const callbacksFor = (0, import_react7.useCallback)((id) => {
     const cached = callbackCache.current.get(id);
     if (cached) {
       return cached;
@@ -2532,7 +2994,7 @@ function MessageItem({ message, isStreaming = false, editable, onEditSubmit, reg
       getCreatedAt: /* @__PURE__ */ __name(() => createdAt, "getCreatedAt")
     } : {}
   });
-  return /* @__PURE__ */ import_react6.default.createElement(MessageItemView, {
+  return /* @__PURE__ */ import_react8.default.createElement(MessageItemView, {
     item,
     ...slots
   });
@@ -2540,51 +3002,51 @@ function MessageItem({ message, isStreaming = false, editable, onEditSubmit, reg
 __name(MessageItem, "MessageItem");
 function MessageItemView({ item, ...slots }) {
   const { classNames } = slots;
-  const actionRow = /* @__PURE__ */ import_react6.default.createElement("div", {
+  const actionRow = /* @__PURE__ */ import_react8.default.createElement("div", {
     className: classNames?.actions,
     "data-actions-for": item.role
-  }, item.copy.available ? /* @__PURE__ */ import_react6.default.createElement("button", {
+  }, item.copy.available ? /* @__PURE__ */ import_react8.default.createElement("button", {
     type: "button",
     onClick: item.copy.copy,
     className: classNames?.actionButton,
     title: item.copy.copied ? "Copied!" : "Copy message text"
-  }, item.copy.copied ? "Copied" : "Copy") : null, item.fork.available ? /* @__PURE__ */ import_react6.default.createElement("button", {
+  }, item.copy.copied ? "Copied" : "Copy") : null, item.fork.available ? /* @__PURE__ */ import_react8.default.createElement("button", {
     type: "button",
     onClick: item.fork.run,
     className: classNames?.actionButton,
     title: "Fork thread from this message"
-  }, "Fork") : null, item.regenerate.available ? /* @__PURE__ */ import_react6.default.createElement("button", {
+  }, "Fork") : null, item.regenerate.available ? /* @__PURE__ */ import_react8.default.createElement("button", {
     type: "button",
     onClick: item.regenerate.run,
     className: classNames?.actionButton,
     title: "Regenerate response"
-  }, "Regenerate") : null, slots.meta, !item.isUser && item.usage ? /* @__PURE__ */ import_react6.default.createElement("span", {
+  }, "Regenerate") : null, slots.meta, !item.isUser && item.usage ? /* @__PURE__ */ import_react8.default.createElement("span", {
     className: classNames?.usage,
     title: `Input ${item.usage.inputTokens.toLocaleString()} \xB7 Output ${item.usage.outputTokens.toLocaleString()} tokens`
-  }, item.usage.costLabel, " \xB7 ", item.usage.tokensLabel) : null, item.timestamp ? /* @__PURE__ */ import_react6.default.createElement("span", {
+  }, item.usage.costLabel, " \xB7 ", item.usage.tokensLabel) : null, item.timestamp ? /* @__PURE__ */ import_react8.default.createElement("span", {
     className: classNames?.timestamp,
     title: item.timestamp.absolute
   }, item.timestamp.relative) : null);
   if (item.edit.available) {
-    return /* @__PURE__ */ import_react6.default.createElement(EditableUserBubble, {
+    return /* @__PURE__ */ import_react8.default.createElement(EditableUserBubble, {
       item,
       slots,
       actions: actionRow
     });
   }
   const className = joinClasses(classNames?.root, classNames?.byRole?.[item.role]);
-  return /* @__PURE__ */ import_react6.default.createElement("div", {
+  return /* @__PURE__ */ import_react8.default.createElement("div", {
     className,
     "data-role": item.role,
     "data-streaming": item.isStreaming ? "true" : void 0
-  }, /* @__PURE__ */ import_react6.default.createElement("div", null, renderBlocks(item, slots)), actionRow);
+  }, /* @__PURE__ */ import_react8.default.createElement("div", null, renderBlocks(item, slots)), actionRow);
 }
 __name(MessageItemView, "MessageItemView");
 function renderBlocks(item, slots) {
   const nodes = [];
   for (const block of item.blocks) {
     if (block.kind === "text") {
-      nodes.push(/* @__PURE__ */ import_react6.default.createElement("div", {
+      nodes.push(/* @__PURE__ */ import_react8.default.createElement("div", {
         key: block.key,
         className: slots.classNames?.text
       }, slots.renderText ? slots.renderText(block.text, {
@@ -2605,7 +3067,7 @@ function renderBlocks(item, slots) {
       continue;
     }
     if (block.kind === "ui" && slots.renderUi) {
-      nodes.push(/* @__PURE__ */ import_react6.default.createElement("div", {
+      nodes.push(/* @__PURE__ */ import_react8.default.createElement("div", {
         key: block.key,
         "data-slot": "ui",
         "data-component": block.component
@@ -2616,18 +3078,18 @@ function renderBlocks(item, slots) {
 }
 __name(renderBlocks, "renderBlocks");
 function renderFilesBlock(block, slots) {
-  return /* @__PURE__ */ import_react6.default.createElement("div", {
+  return /* @__PURE__ */ import_react8.default.createElement("div", {
     key: block.key,
     className: slots.classNames?.files,
     "data-files": "true"
-  }, slots.renderFiles ? slots.renderFiles(block.files) : block.files.map((file) => /* @__PURE__ */ import_react6.default.createElement("a", {
+  }, slots.renderFiles ? slots.renderFiles(block.files) : block.files.map((file) => /* @__PURE__ */ import_react8.default.createElement("a", {
     key: file.url,
     href: file.url,
     target: "_blank",
     rel: "noreferrer",
     className: slots.classNames?.file,
     title: file.filename ?? file.mediaType
-  }, file.isImage ? /* @__PURE__ */ import_react6.default.createElement("img", {
+  }, file.isImage ? /* @__PURE__ */ import_react8.default.createElement("img", {
     src: file.url,
     alt: file.filename ?? "image",
     className: slots.classNames?.fileImage
@@ -2635,17 +3097,17 @@ function renderFilesBlock(block, slots) {
 }
 __name(renderFilesBlock, "renderFilesBlock");
 function renderReasoningBlock(block, slots) {
-  return /* @__PURE__ */ import_react6.default.createElement("div", {
+  return /* @__PURE__ */ import_react8.default.createElement("div", {
     key: block.key,
     className: slots.classNames?.reasoning,
     "data-reasoning": "true",
     "data-streaming": block.isStreaming ? "true" : void 0
-  }, /* @__PURE__ */ import_react6.default.createElement("button", {
+  }, /* @__PURE__ */ import_react8.default.createElement("button", {
     type: "button",
     className: slots.classNames?.reasoningToggle,
     onClick: /* @__PURE__ */ __name(() => block.toggle(), "onClick"),
     "aria-expanded": block.isOpen
-  }, slots.reasoningLabel ?? "Reasoning"), block.isOpen ? /* @__PURE__ */ import_react6.default.createElement("div", {
+  }, slots.reasoningLabel ?? "Reasoning"), block.isOpen ? /* @__PURE__ */ import_react8.default.createElement("div", {
     className: slots.classNames?.reasoningText
   }, slots.renderReasoning ? slots.renderReasoning(block.text, {
     isStreaming: block.isStreaming,
@@ -2656,7 +3118,7 @@ __name(renderReasoningBlock, "renderReasoningBlock");
 function renderToolBlock(item, block, slots) {
   if (slots.renderToolGroup) {
     return [
-      /* @__PURE__ */ import_react6.default.createElement(import_react6.default.Fragment, {
+      /* @__PURE__ */ import_react8.default.createElement(import_react8.default.Fragment, {
         key: block.key
       }, slots.renderToolGroup(block.parts, block.key))
     ];
@@ -2667,7 +3129,7 @@ function renderToolBlock(item, block, slots) {
   const renderToolPart = slots.renderToolPart;
   return block.parts.map((part) => {
     const partKey = `${item.id}-${part.toolCallId}`;
-    return /* @__PURE__ */ import_react6.default.createElement(import_react6.default.Fragment, {
+    return /* @__PURE__ */ import_react8.default.createElement(import_react8.default.Fragment, {
       key: partKey
     }, renderToolPart(part, partKey));
   });
@@ -2677,14 +3139,14 @@ function EditableUserBubble({ item, slots, actions }) {
   const { classNames } = slots;
   const { edit } = item;
   if (!edit.isEditing) {
-    return /* @__PURE__ */ import_react6.default.createElement("div", {
+    return /* @__PURE__ */ import_react8.default.createElement("div", {
       className: joinClasses(classNames?.root, classNames?.byRole?.user),
       "data-role": "user"
-    }, /* @__PURE__ */ import_react6.default.createElement("div", {
+    }, /* @__PURE__ */ import_react8.default.createElement("div", {
       className: classNames?.text
     }, slots.renderText ? slots.renderText(item.text, {
       isStreaming: false
-    }) : item.text), /* @__PURE__ */ import_react6.default.createElement("button", {
+    }) : item.text), /* @__PURE__ */ import_react8.default.createElement("button", {
       type: "button",
       onClick: edit.start,
       className: classNames?.actionButton,
@@ -2692,18 +3154,18 @@ function EditableUserBubble({ item, slots, actions }) {
     }, "Edit"), actions);
   }
   const textareaProps = edit.getTextareaProps();
-  return /* @__PURE__ */ import_react6.default.createElement("div", {
+  return /* @__PURE__ */ import_react8.default.createElement("div", {
     "data-editing": "true"
-  }, /* @__PURE__ */ import_react6.default.createElement("textarea", {
+  }, /* @__PURE__ */ import_react8.default.createElement("textarea", {
     ...textareaProps,
     rows: Math.min(8, edit.draft.split("\n").length + 1),
     className: classNames?.editTextarea
-  }), /* @__PURE__ */ import_react6.default.createElement("div", {
+  }), /* @__PURE__ */ import_react8.default.createElement("div", {
     className: classNames?.editActions
-  }, /* @__PURE__ */ import_react6.default.createElement("button", {
+  }, /* @__PURE__ */ import_react8.default.createElement("button", {
     type: "button",
     onClick: edit.cancel
-  }, "Cancel"), /* @__PURE__ */ import_react6.default.createElement("button", {
+  }, "Cancel"), /* @__PURE__ */ import_react8.default.createElement("button", {
     type: "button",
     onClick: edit.save,
     disabled: !edit.canSave
@@ -2913,7 +3375,11 @@ function createSkillsSource(options) {
       if (cached) {
         return cached;
       }
-      const pending = options.client.listSkills(threadId).then((entries) => entries.map(toItem)).catch((error) => {
+      const listSkills = options.client.listSkills;
+      if (listSkills === void 0) {
+        return Promise.reject(new AgentBackendUnsupportedError("listSkills"));
+      }
+      const pending = listSkills.call(options.client, threadId).then((entries) => entries.map(toItem)).catch((error) => {
         byThread.delete(key);
         throw error;
       });
@@ -2943,35 +3409,35 @@ function toItem(entry) {
 __name(toItem, "toItem");
 
 // src/composer/use-composer-autocomplete.ts
-var import_react7 = require("react");
+var import_react9 = require("react");
 function useComposerAutocomplete(options) {
   const { value, sources, acceptOnTab = true } = options;
-  const latest = (0, import_react7.useRef)(options);
+  const latest = (0, import_react9.useRef)(options);
   latest.current = options;
-  const inputRef = (0, import_react7.useRef)(null);
-  const [caret, setCaret] = (0, import_react7.useState)(value.length);
-  const [items, setItems] = (0, import_react7.useState)([]);
-  const [isLoading, setLoading] = (0, import_react7.useState)(false);
-  const [error, setError] = (0, import_react7.useState)(null);
-  const [activeIndex, setActiveIndex] = (0, import_react7.useState)(0);
-  const [dismissedIndex, setDismissedIndex] = (0, import_react7.useState)(null);
+  const inputRef = (0, import_react9.useRef)(null);
+  const [caret, setCaret] = (0, import_react9.useState)(value.length);
+  const [items, setItems] = (0, import_react9.useState)([]);
+  const [isLoading, setLoading] = (0, import_react9.useState)(false);
+  const [error, setError] = (0, import_react9.useState)(null);
+  const [activeIndex, setActiveIndex] = (0, import_react9.useState)(0);
+  const [dismissedIndex, setDismissedIndex] = (0, import_react9.useState)(null);
   const safeCaret = Math.min(caret, value.length);
-  const match = (0, import_react7.useMemo)(() => findActiveTrigger(value, safeCaret, sources), [
+  const match = (0, import_react9.useMemo)(() => findActiveTrigger(value, safeCaret, sources), [
     value,
     safeCaret,
     sources
   ]);
   const isActive = match !== null && dismissedIndex !== match.index;
-  const matchRef = (0, import_react7.useRef)(match);
+  const matchRef = (0, import_react9.useRef)(match);
   matchRef.current = match;
-  const caretRef = (0, import_react7.useRef)(safeCaret);
+  const caretRef = (0, import_react9.useRef)(safeCaret);
   caretRef.current = safeCaret;
-  const itemsRef = (0, import_react7.useRef)(items);
+  const itemsRef = (0, import_react9.useRef)(items);
   itemsRef.current = items;
-  const activeIndexRef = (0, import_react7.useRef)(activeIndex);
+  const activeIndexRef = (0, import_react9.useRef)(activeIndex);
   activeIndexRef.current = activeIndex;
   const requestKey = isActive && match ? `${match.source.id}\0${match.query}` : null;
-  (0, import_react7.useEffect)(() => {
+  (0, import_react9.useEffect)(() => {
     const current = matchRef.current;
     if (requestKey === null || current === null) {
       setItems([]);
@@ -3019,25 +3485,25 @@ function useComposerAutocomplete(options) {
   ]);
   const isOpen = isActive;
   const activeItem = isOpen ? items[activeIndex] ?? null : null;
-  const reactId = (0, import_react7.useId)();
+  const reactId = (0, import_react9.useId)();
   const listboxId = options.id ?? `agent-autocomplete-${reactId}`;
-  const optionId = (0, import_react7.useCallback)((index) => `${listboxId}-option-${index}`, [
+  const optionId = (0, import_react9.useCallback)((index) => `${listboxId}-option-${index}`, [
     listboxId
   ]);
-  const highlight = (0, import_react7.useCallback)((index) => {
+  const highlight = (0, import_react9.useCallback)((index) => {
     const total = itemsRef.current.length;
     if (total === 0) return;
     setActiveIndex((index % total + total) % total);
   }, []);
-  const moveHighlight = (0, import_react7.useCallback)((delta) => highlight(activeIndexRef.current + delta), [
+  const moveHighlight = (0, import_react9.useCallback)((delta) => highlight(activeIndexRef.current + delta), [
     highlight
   ]);
-  const dismiss = (0, import_react7.useCallback)(() => {
+  const dismiss = (0, import_react9.useCallback)(() => {
     const current = matchRef.current;
     if (current) setDismissedIndex(current.index);
   }, []);
-  const pendingCaret = (0, import_react7.useRef)(null);
-  const accept = (0, import_react7.useCallback)((item) => {
+  const pendingCaret = (0, import_react9.useRef)(null);
+  const accept = (0, import_react9.useCallback)((item) => {
     const current = matchRef.current;
     if (!current) return;
     const chosen = item ?? itemsRef.current[activeIndexRef.current];
@@ -3048,16 +3514,16 @@ function useComposerAutocomplete(options) {
     setDismissedIndex(null);
     pendingCaret.current = edit.caret;
   }, []);
-  (0, import_react7.useLayoutEffect)(() => {
+  (0, import_react9.useLayoutEffect)(() => {
     const position = pendingCaret.current;
     if (position === null) return;
     pendingCaret.current = null;
     inputRef.current?.setSelectionRange(position, position);
   });
-  const readCaret = (0, import_react7.useCallback)((element) => {
+  const readCaret = (0, import_react9.useCallback)((element) => {
     setCaret(element.selectionStart ?? element.value.length);
   }, []);
-  const onKeyDown = (0, import_react7.useCallback)((event) => {
+  const onKeyDown = (0, import_react9.useCallback)((event) => {
     if (!isOpen) return;
     const hasItems = itemsRef.current.length > 0;
     switch (event.key) {
@@ -3095,23 +3561,23 @@ function useComposerAutocomplete(options) {
     dismiss,
     moveHighlight
   ]);
-  const onChange = (0, import_react7.useCallback)((event) => {
+  const onChange = (0, import_react9.useCallback)((event) => {
     readCaret(event.target);
     const next = findActiveTrigger(event.target.value, event.target.selectionStart ?? event.target.value.length, latest.current.sources);
     setDismissedIndex((current) => current !== null && next?.index === current ? current : null);
   }, [
     readCaret
   ]);
-  const onSelect = (0, import_react7.useCallback)((event) => readCaret(event.currentTarget), [
+  const onSelect = (0, import_react9.useCallback)((event) => readCaret(event.currentTarget), [
     readCaret
   ]);
-  const onClick = (0, import_react7.useCallback)((event) => readCaret(event.currentTarget), [
+  const onClick = (0, import_react9.useCallback)((event) => readCaret(event.currentTarget), [
     readCaret
   ]);
-  const setInput = (0, import_react7.useCallback)((element) => {
+  const setInput = (0, import_react9.useCallback)((element) => {
     inputRef.current = element;
   }, []);
-  const getInputProps = (0, import_react7.useCallback)(() => ({
+  const getInputProps = (0, import_react9.useCallback)(() => ({
     ref: setInput,
     onChange,
     onKeyDown,
@@ -3139,7 +3605,7 @@ function useComposerAutocomplete(options) {
     activeIndex,
     optionId
   ]);
-  const getListboxProps = (0, import_react7.useCallback)(() => ({
+  const getListboxProps = (0, import_react9.useCallback)(() => ({
     id: listboxId,
     role: "listbox",
     "aria-label": match?.source.label ?? match?.source.id ?? "Suggestions"
@@ -3147,7 +3613,7 @@ function useComposerAutocomplete(options) {
     listboxId,
     match
   ]);
-  const getOptionProps = (0, import_react7.useCallback)((index) => ({
+  const getOptionProps = (0, import_react9.useCallback)((index) => ({
     id: optionId(index),
     role: "option",
     "aria-selected": index === activeIndex
@@ -3181,7 +3647,7 @@ function isPromise(value) {
 __name(isPromise, "isPromise");
 
 // src/presentation/use-tool-catalog.ts
-var import_react8 = require("react");
+var import_react10 = require("react");
 var shared = /* @__PURE__ */ new WeakMap();
 function load(client, agent) {
   let byAgent = shared.get(client);
@@ -3192,6 +3658,9 @@ function load(client, agent) {
   const key = agent ?? "";
   const cached = byAgent.get(key);
   if (cached !== void 0) return cached;
+  if (client.listTools === void 0) {
+    return Promise.reject(new AgentBackendUnsupportedError("listTools"));
+  }
   const request = client.listTools(agent).catch((error) => {
     byAgent.delete(key);
     throw error;
@@ -3202,11 +3671,11 @@ function load(client, agent) {
 __name(load, "load");
 function useToolCatalog(options) {
   const { client, agent, enabled = true } = options;
-  const [entries, setEntries] = (0, import_react8.useState)([]);
-  const [isLoading, setLoading] = (0, import_react8.useState)(enabled);
-  const [error, setError] = (0, import_react8.useState)(null);
-  const [generation, setGeneration] = (0, import_react8.useState)(0);
-  (0, import_react8.useEffect)(() => {
+  const [entries, setEntries] = (0, import_react10.useState)([]);
+  const [isLoading, setLoading] = (0, import_react10.useState)(enabled);
+  const [error, setError] = (0, import_react10.useState)(null);
+  const [generation, setGeneration] = (0, import_react10.useState)(0);
+  (0, import_react10.useEffect)(() => {
     if (!enabled) {
       setLoading(false);
       return;
@@ -3232,14 +3701,14 @@ function useToolCatalog(options) {
     enabled,
     generation
   ]);
-  const refresh = (0, import_react8.useCallback)(() => {
+  const refresh = (0, import_react10.useCallback)(() => {
     shared.get(client)?.delete(agent ?? "");
     setGeneration((current) => current + 1);
   }, [
     client,
     agent
   ]);
-  const catalog = (0, import_react8.useMemo)(() => toolCatalogFrom(entries), [
+  const catalog = (0, import_react10.useMemo)(() => toolCatalogFrom(entries), [
     entries
   ]);
   return {
@@ -3253,7 +3722,7 @@ function useToolCatalog(options) {
 __name(useToolCatalog, "useToolCatalog");
 
 // src/approvals/countdown.ts
-var import_react9 = require("react");
+var import_react11 = require("react");
 function approvalCountdown(expiresAt, now = Date.now()) {
   const deadline = expiresAt == null ? Number.NaN : Date.parse(expiresAt);
   if (!Number.isFinite(deadline)) {
@@ -3271,10 +3740,10 @@ function approvalCountdown(expiresAt, now = Date.now()) {
 __name(approvalCountdown, "approvalCountdown");
 function useApprovalCountdown(expiresAt, options = {}) {
   const { intervalMs = 1e3 } = options;
-  const nowRef = (0, import_react9.useRef)(options.now ?? Date.now);
+  const nowRef = (0, import_react11.useRef)(options.now ?? Date.now);
   nowRef.current = options.now ?? Date.now;
-  const [state, setState] = (0, import_react9.useState)(() => approvalCountdown(expiresAt, nowRef.current()));
-  (0, import_react9.useEffect)(() => {
+  const [state, setState] = (0, import_react11.useState)(() => approvalCountdown(expiresAt, nowRef.current()));
+  (0, import_react11.useEffect)(() => {
     const read = /* @__PURE__ */ __name(() => approvalCountdown(expiresAt, nowRef.current()), "read");
     const first = read();
     setState(first);
@@ -3440,7 +3909,12 @@ function storedMessageToUiMessage(message) {
   return {
     id: message.id,
     role: message.role,
-    parts
+    parts,
+    ...message.feedback !== void 0 ? {
+      metadata: {
+        feedback: message.feedback
+      }
+    } : {}
   };
 }
 __name(storedMessageToUiMessage, "storedMessageToUiMessage");
@@ -3476,14 +3950,21 @@ function mergeTurn(rows) {
   }
   const parts = rows.flatMap((row) => storedMessageToUiMessage(row).parts);
   const usage = sumUsage(rows);
+  const feedback = lastRow.feedback;
+  const metadata = {
+    ...usage !== void 0 ? {
+      usage
+    } : {},
+    ...feedback !== void 0 ? {
+      feedback
+    } : {}
+  };
   return {
     id: lastRow.id,
     role: lastRow.role,
     parts,
-    ...usage !== void 0 ? {
-      metadata: {
-        usage
-      }
+    ...Object.keys(metadata).length > 0 ? {
+      metadata
     } : {}
   };
 }
@@ -3503,21 +3984,22 @@ function sumUsage(rows) {
 __name(sumUsage, "sumUsage");
 
 // src/use-agent-chat.ts
-var import_react10 = require("@ai-sdk/react");
-var import_react11 = require("react");
+var import_react12 = require("@ai-sdk/react");
+var import_react13 = require("react");
 function useAgentChat(options) {
-  const latest = (0, import_react11.useRef)(options);
+  const latest = (0, import_react13.useRef)(options);
   latest.current = options;
-  const [runId, setRunId] = (0, import_react11.useState)(options.resumeRunId);
-  const runIdRef = (0, import_react11.useRef)(runId);
+  const [runId, setRunId] = (0, import_react13.useState)(options.resumeRunId);
+  const runIdRef = (0, import_react13.useRef)(runId);
   runIdRef.current = runId;
-  const settlingRunIdRef = (0, import_react11.useRef)(void 0);
-  const autoResumeRunIdRef = (0, import_react11.useRef)(void 0);
-  const [autoResume, setAutoResume] = (0, import_react11.useState)(false);
-  const [activeRunId, setActiveRunId] = (0, import_react11.useState)(null);
-  const regenerateNext = (0, import_react11.useRef)(false);
-  const createdThreadId = (0, import_react11.useRef)(void 0);
-  const client = (0, import_react11.useMemo)(() => {
+  const settlingRunIdRef = (0, import_react13.useRef)(void 0);
+  const autoResumeRunIdRef = (0, import_react13.useRef)(void 0);
+  const [autoResume, setAutoResume] = (0, import_react13.useState)(false);
+  const [activeRunId, setActiveRunId] = (0, import_react13.useState)(null);
+  const regenerateNext = (0, import_react13.useRef)(false);
+  const createdThreadId = (0, import_react13.useRef)(void 0);
+  const client = (0, import_react13.useMemo)(() => {
+    if (options.backend) return options.backend;
     if (options.client) return options.client;
     return new AgentClient({
       ...options.baseUrl !== void 0 ? {
@@ -3532,7 +4014,11 @@ function useAgentChat(options) {
       getHeaders: /* @__PURE__ */ __name(async () => mergeHeaders(latest.current), "getHeaders")
     });
   }, []);
-  (0, import_react11.useEffect)(() => {
+  const [connection, setConnection] = (0, import_react13.useState)({
+    status: "live"
+  });
+  const resyncAfterSettle = (0, import_react13.useRef)(false);
+  (0, import_react13.useEffect)(() => {
     if (!options.resume || options.threadId === void 0) return;
     let cancelled = false;
     const threadId = options.threadId;
@@ -3552,30 +4038,33 @@ function useAgentChat(options) {
     options.resume,
     options.threadId
   ]);
-  const transport = (0, import_react11.useMemo)(() => {
+  const transport = (0, import_react13.useMemo)(() => {
     function onMeta(meta) {
       settlingRunIdRef.current = meta.runId;
       setRunId(meta.runId);
       if (latest.current.threadId === void 0 && meta.threadId && createdThreadId.current !== meta.threadId) {
         createdThreadId.current = meta.threadId;
         latest.current.onThreadCreated?.(meta.threadId);
+        notifyThreads(client, {
+          type: "changed"
+        });
       }
     }
     __name(onMeta, "onMeta");
     return new AgentChatTransport({
-      ...options.baseUrl !== void 0 ? {
-        baseUrl: options.baseUrl
-      } : {},
-      ...options.credentials !== void 0 ? {
-        credentials: options.credentials
-      } : {},
-      ...options.fetch !== void 0 ? {
-        fetch: options.fetch
+      backend: client,
+      ...options.reconnect !== void 0 ? {
+        reconnect: options.reconnect
       } : {},
+      onConnectionChange: /* @__PURE__ */ __name((state) => {
+        if (state.status === "gone") resyncAfterSettle.current = true;
+        setConnection(state.status === "gone" ? {
+          status: "live"
+        } : state);
+      }, "onConnectionChange"),
       ...options.agent !== void 0 ? {
         agent: options.agent
       } : {},
-      getHeaders: /* @__PURE__ */ __name(async () => mergeHeaders(latest.current), "getHeaders"),
       getBody: /* @__PURE__ */ __name(() => {
         const current = latest.current;
         const pageContext = current.getPageContext?.() ?? null;
@@ -3601,8 +4090,8 @@ function useAgentChat(options) {
       }, "onAttemptStart")
     });
   }, []);
-  const backgroundRef = (0, import_react11.useRef)(() => Promise.resolve());
-  const chat = (0, import_react10.useChat)({
+  const backgroundRef = (0, import_react13.useRef)(() => Promise.resolve());
+  const chat = (0, import_react12.useChat)({
     transport,
     resume: options.resumeRunId !== void 0 || autoResume,
     ...options.threadId !== void 0 ? {
@@ -3615,7 +4104,15 @@ function useAgentChat(options) {
       latest.current.onData?.(part);
       if (part.type === "data-title") {
         const title = part.data?.title;
-        if (typeof title === "string") latest.current.onTitle?.(title);
+        if (typeof title === "string") {
+          latest.current.onTitle?.(title);
+          const threadId = latest.current.threadId ?? createdThreadId.current;
+          if (threadId !== void 0) notifyThreads(client, {
+            type: "title",
+            threadId,
+            title
+          });
+        }
       }
     }, "onData"),
     onFinish: /* @__PURE__ */ __name(({ isError }) => {
@@ -3629,16 +4126,36 @@ function useAgentChat(options) {
           runId: settledRunId,
           status: isError ? "failed" : "completed"
         });
+        notifyThreads(client, {
+          type: "changed"
+        });
+      }
+      setConnection({
+        status: "live"
+      });
+      if (resyncAfterSettle.current) {
+        resyncAfterSettle.current = false;
+        void resyncFromThread();
       }
     }, "onFinish")
   });
-  const chatRef = (0, import_react11.useRef)(chat);
+  const chatRef = (0, import_react13.useRef)(chat);
   chatRef.current = chat;
-  const turnInFlight = (0, import_react11.useRef)(false);
-  const isTurnInFlight = (0, import_react11.useCallback)(() => turnInFlight.current || transport.isAttemptLive, [
+  async function resyncFromThread() {
+    const threadId = latest.current.threadId ?? createdThreadId.current;
+    if (threadId === void 0) return;
+    try {
+      const thread = await client.getThread(threadId);
+      chatRef.current.setMessages(storedThreadToUiMessages(thread.messages));
+    } catch {
+    }
+  }
+  __name(resyncFromThread, "resyncFromThread");
+  const turnInFlight = (0, import_react13.useRef)(false);
+  const isTurnInFlight = (0, import_react13.useCallback)(() => turnInFlight.current || transport.isAttemptLive, [
     transport
   ]);
-  const sendMessage = (0, import_react11.useCallback)(async (...args) => {
+  const sendMessage = (0, import_react13.useCallback)(async (...args) => {
     if (isTurnInFlight()) return;
     turnInFlight.current = true;
     try {
@@ -3649,15 +4166,15 @@ function useAgentChat(options) {
   }, [
     isTurnInFlight
   ]);
-  const addToolResult = (0, import_react11.useCallback)(({ tool, toolCallId, output }) => chatRef.current.addToolResult({
+  const addToolResult = (0, import_react13.useCallback)(({ tool, toolCallId, output }) => chatRef.current.addToolResult({
     tool,
     toolCallId,
     output
   }), []);
-  const [threads, setThreads] = (0, import_react11.useState)([]);
-  const [quota, setQuota] = (0, import_react11.useState)(null);
-  const [backgroundRuns, setBackgroundRuns] = (0, import_react11.useState)([]);
-  const refreshBackground = (0, import_react11.useCallback)(async () => {
+  const [threads, setThreads] = (0, import_react13.useState)([]);
+  const [quota, setQuota] = (0, import_react13.useState)(null);
+  const [backgroundRuns, setBackgroundRuns] = (0, import_react13.useState)([]);
+  const refreshBackground = (0, import_react13.useCallback)(async () => {
     const threadId = latest.current.threadId ?? createdThreadId.current;
     if (threadId === void 0) {
       return;
@@ -3682,7 +4199,7 @@ function useAgentChat(options) {
   ]);
   backgroundRef.current = refreshBackground;
   const isWorking = backgroundRuns.some((run) => run.status === "running");
-  (0, import_react11.useEffect)(() => {
+  (0, import_react13.useEffect)(() => {
     if (options.background !== true || options.threadId === void 0) {
       return;
     }
@@ -3692,7 +4209,7 @@ function useAgentChat(options) {
     options.threadId,
     refreshBackground
   ]);
-  (0, import_react11.useEffect)(() => {
+  (0, import_react13.useEffect)(() => {
     const every = latest.current.backgroundPollMs ?? 5e3;
     if (latest.current.background !== true || !isWorking || every <= 0) {
       return;
@@ -3703,27 +4220,29 @@ function useAgentChat(options) {
     isWorking,
     refreshBackground
   ]);
-  const loadThreads = (0, import_react11.useCallback)(async () => {
+  const loadThreads = (0, import_react13.useCallback)(async () => {
     const list = await client.listThreads();
     setThreads(list);
     return list;
   }, [
     client
   ]);
-  const loadThread = (0, import_react11.useCallback)((id) => client.getThread(id), [
+  const loadThread = (0, import_react13.useCallback)((id) => client.getThread(id), [
     client
   ]);
-  const deleteThread = (0, import_react11.useCallback)(async (id) => {
+  const deleteThread = (0, import_react13.useCallback)(async (id) => {
     await client.deleteThread(id);
     setThreads((current) => current.filter((thread) => thread.id !== id));
   }, [
     client
   ]);
-  const forkThread = (0, import_react11.useCallback)((threadId, messageId) => client.forkFromMessage(threadId, messageId), [
+  const forkThread = (0, import_react13.useCallback)((threadId, messageId) => requireBackendMethod(client, "forkFromMessage")(threadId, messageId), [
     client
   ]);
-  const renameThread = (0, import_react11.useCallback)(async (id, title) => {
-    await client.renameThread(id, title);
+  const renameThread = (0, import_react13.useCallback)(async (id, title) => {
+    await client.updateThread(id, {
+      title
+    });
     setThreads((current) => current.map((thread) => thread.id === id ? {
       ...thread,
       title
@@ -3731,24 +4250,24 @@ function useAgentChat(options) {
   }, [
     client
   ]);
-  const promoteThread = (0, import_react11.useCallback)(async (id) => {
-    await client.promoteThread(id);
+  const promoteThread = (0, import_react13.useCallback)(async (id) => {
+    await requireBackendMethod(client, "promoteThread")(id);
     await loadThreads();
   }, [
     client,
     loadThreads
   ]);
-  const truncateFromMessage = (0, import_react11.useCallback)((threadId, messageId) => client.truncateFromMessage(threadId, messageId).then(() => void 0), [
+  const truncateFromMessage = (0, import_react13.useCallback)((threadId, messageId) => requireBackendMethod(client, "truncateFromMessage")(threadId, messageId).then(() => void 0), [
     client
   ]);
-  const loadQuota = (0, import_react11.useCallback)(async () => {
-    const today = await client.getQuotaToday();
+  const loadQuota = (0, import_react13.useCallback)(async () => {
+    const today = await requireBackendMethod(client, "getQuotaToday")();
     setQuota(today);
     return today;
   }, [
     client
   ]);
-  const cancel = (0, import_react11.useCallback)(async () => {
+  const cancel = (0, import_react13.useCallback)(async () => {
     chatRef.current.stop();
     const activeRunId2 = runIdRef.current;
     if (activeRunId2) {
@@ -3760,8 +4279,8 @@ function useAgentChat(options) {
   }, [
     client
   ]);
-  const approve = (0, import_react11.useCallback)(async ({ toolCallId, remember, via }) => {
-    await client.approveToolCall({
+  const approve = (0, import_react13.useCallback)(async ({ toolCallId, remember, via }) => {
+    await requireBackendMethod(client, "approveToolCall")({
       toolCallId,
       ...remember === true ? {
         remember: true
@@ -3773,8 +4292,8 @@ function useAgentChat(options) {
   }, [
     client
   ]);
-  const reject = (0, import_react11.useCallback)(async ({ toolCallId, reason, via }) => {
-    await client.rejectToolCall({
+  const reject = (0, import_react13.useCallback)(async ({ toolCallId, reason, via }) => {
+    await requireBackendMethod(client, "rejectToolCall")({
       toolCallId,
       ...reason !== void 0 ? {
         reason
@@ -3786,8 +4305,8 @@ function useAgentChat(options) {
   }, [
     client
   ]);
-  const answer = (0, import_react11.useCallback)(async ({ toolCallId, answers }) => {
-    await client.answerToolCall({
+  const answer = (0, import_react13.useCallback)(async ({ toolCallId, answers }) => {
+    await requireBackendMethod(client, "answerToolCall")({
       toolCallId,
       ...answers !== void 0 ? {
         answers
@@ -3796,14 +4315,14 @@ function useAgentChat(options) {
   }, [
     client
   ]);
-  const skip = (0, import_react11.useCallback)(async ({ toolCallId }) => {
-    await client.skipToolCall({
+  const skip = (0, import_react13.useCallback)(async ({ toolCallId }) => {
+    await requireBackendMethod(client, "skipToolCall")({
       toolCallId
     });
   }, [
     client
   ]);
-  const regenerate = (0, import_react11.useCallback)(() => {
+  const regenerate = (0, import_react13.useCallback)(() => {
     if (isTurnInFlight()) return;
     regenerateNext.current = true;
     turnInFlight.current = true;
@@ -3818,8 +4337,13 @@ function useAgentChat(options) {
     isWorking,
     refresh: refreshBackground
   };
+  const getThreadId = (0, import_react13.useCallback)(() => latest.current.threadId ?? createdThreadId.current, []);
+  const status = connection.status === "reconnecting" ? "reconnecting" : chat.status;
   return {
     ...chat,
+    status,
+    /** Where the live stream stands — see {@link StreamConnectionState}. */
+    connection,
     sendMessage,
     addToolResult,
     /** Sub-agents this conversation started and did not wait for. */
@@ -3827,6 +4351,14 @@ function useAgentChat(options) {
     runId,
     /** The `resume`-fetched thread's active run id, or `null` once resolved with none. */
     activeRunId,
+    /**
+    * The thread this chat is on right now: the `threadId` option, else the one the backend created
+    * on the first send. A getter, because the created id is learned mid-stream.
+    */
+    getThreadId,
+    /** The backend this chat talks to — pass it to `useThreads`, `useMessageFeedback`, … */
+    backend: client,
+    /** Same object as {@link backend}; kept for callers that read it under its old name. */
     client,
     threads,
     loadThreads,
@@ -3857,6 +4389,7 @@ async function mergeHeaders(options) {
 __name(mergeHeaders, "mergeHeaders");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AgentBackendUnsupportedError,
   AgentChatTransport,
   AgentClient,
   AgentHttpError,
@@ -3886,10 +4419,13 @@ __name(mergeHeaders, "mergeHeaders");
   inferResultView,
   isActionCall,
   loadStoredSpeechLang,
+  notifyThreads,
+  onThreadsEvent,
   persistSpeechLang,
   phraseFor,
   readPath,
   readReasoningMs,
+  requireBackendMethod,
   resolveResultView,
   storedMessageToUiMessage,
   storedThreadToUiMessages,
@@ -3900,8 +4436,10 @@ __name(mergeHeaders, "mergeHeaders");
   useChatTranscript,
   useComposerAutocomplete,
   useElapsed,
+  useMessageFeedback,
   useSpeechRecognition,
   useStickToBottom,
+  useThreads,
   useToolCatalog,
   useTranscriptItem,
   validateAnswer,