@useago/sdk 1.4.2 → 1.4.4

package/dist/{AgoClient-BdtuHX7k.js → AgoClient-Ozz2b1dQ.js}

@@ -1,28 +1,28 @@
-var h = class extends Error {
+var d = class extends Error {
   constructor(e, t, s) {
     super(e), this.code = t, this.statusCode = s, this.name = "AgoError";
   }
-}, u = class E extends h {
-  constructor(t, s, i, n, r, o) {
-    super(t, s, i), this.type = n, this.param = r, this.docUrl = o, this.name = "AgoApiError";
+}, f = class k extends d {
+  constructor(t, s, i, n, o, a) {
+    super(t, s, i), this.type = n, this.param = o, this.docUrl = a, this.name = "AgoApiError";
   }
   static fromResponse(t, s) {
     const i = t.error;
-    return new E(i.doc_url ? `${i.message} See ${i.doc_url}` : i.message, i.code, s, i.type, i.param, i.doc_url);
+    return new k(i.doc_url ? `${i.message} See ${i.doc_url}` : i.message, i.code, s, i.type, i.param, i.doc_url);
   }
-}, m = class extends h {
+}, y = class extends d {
   constructor(e, t) {
     super(e, "network_error"), this.originalError = t, this.name = "AgoNetworkError";
   }
-}, p = class extends h {
+}, _ = class extends d {
   constructor(e, t = "stream_error") {
     super(e, t), this.name = "AgoStreamError";
   }
-}, y = class extends h {
+}, E = class extends d {
   constructor(e, t, s) {
     super(e, "function_error"), this.functionName = t, this.originalError = s, this.name = "AgoFunctionError";
   }
-}, S = class {
+}, I = class {
   constructor(e = !1) {
     this.enabled = e;
   }
@@ -44,22 +44,22 @@ var h = class extends Error {
   debug(...e) {
     this.enabled && console.debug("[AGO SDK]", ...e);
   }
-}, a = new S(), w = "ago_widget_id";
-function $() {
+}, l = new I(), R = "ago_widget_id";
+function F() {
   if (typeof localStorage < "u") {
-    const t = localStorage.getItem(w);
+    const t = localStorage.getItem(R);
     if (t) return t;
   }
   const e = typeof crypto < "u" && typeof crypto.randomUUID == "function" ? crypto.randomUUID() : `ago-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 12)}`;
   if (typeof localStorage < "u") try {
-    localStorage.setItem(w, e);
+    localStorage.setItem(R, e);
   } catch {
   }
   return e;
 }
-var k = class {
+var U = class {
   constructor(e) {
-    this.baseUrl = e.baseUrl.replace(/\/$/, ""), this.headers = { "X-User-Anon-Id": e.widgetId || $() }, e.userEmail && (this.headers["X-User-Email"] = e.userEmail), e.userJwt && (this.headers.Authorization = `Bearer ${e.userJwt}`), e.permission && (this.headers["X-Widget-Permission"] = e.permission);
+    this.baseUrl = e.baseUrl.replace(/\/$/, ""), this.headers = { "X-User-Anon-Id": e.widgetId || F() }, e.userEmail && (this.headers["X-User-Email"] = e.userEmail), e.userJwt && (this.headers.Authorization = `Bearer ${e.userJwt}`), e.permission && (this.headers["X-Widget-Permission"] = e.permission);
   }
   updateConfig(e) {
     e.baseUrl && (this.baseUrl = e.baseUrl.replace(/\/$/, "")), e.widgetId && (this.headers["X-User-Anon-Id"] = e.widgetId), e.userEmail && (this.headers["X-User-Email"] = e.userEmail), e.userJwt && (this.headers.Authorization = `Bearer ${e.userJwt}`), e.permission !== void 0 && (e.permission ? this.headers["X-Widget-Permission"] = e.permission : delete this.headers["X-Widget-Permission"]);
@@ -72,7 +72,7 @@ var k = class {
   }
   async postStream(e, t) {
     const s = `${this.baseUrl}${e}`;
-    a.debug("POST (stream)", s, t);
+    l.debug("POST (stream)", s, t);
     try {
       const i = await fetch(s, {
         method: "POST",
@@ -84,12 +84,12 @@ var k = class {
       });
       return i.ok || await this.handleErrorResponse(i), i;
     } catch (i) {
-      throw i instanceof u ? i : new m(`Network error: ${i instanceof Error ? i.message : "Unknown error"}. Check that \`baseUrl\` is reachable and includes the protocol (https://).`, i instanceof Error ? i : void 0);
+      throw i instanceof f ? i : new y(`Network error: ${i instanceof Error ? i.message : "Unknown error"}. Check that \`baseUrl\` is reachable and includes the protocol (https://).`, i instanceof Error ? i : void 0);
     }
   }
   async postFormData(e, t) {
     const s = `${this.baseUrl}${e}`;
-    a.debug("POST (formData)", s);
+    l.debug("POST (formData)", s);
     const i = { ...this.headers };
     try {
       const n = await fetch(s, {
@@ -99,12 +99,12 @@ var k = class {
       });
       return n.ok || await this.handleErrorResponse(n), n;
     } catch (n) {
-      throw n instanceof u ? n : new m(`Network error: ${n instanceof Error ? n.message : "Unknown error"}. Check that \`baseUrl\` is reachable and includes the protocol (https://).`, n instanceof Error ? n : void 0);
+      throw n instanceof f ? n : new y(`Network error: ${n instanceof Error ? n.message : "Unknown error"}. Check that \`baseUrl\` is reachable and includes the protocol (https://).`, n instanceof Error ? n : void 0);
     }
   }
   async request(e, t, s) {
     const i = `${this.baseUrl}${t}`;
-    a.debug(e, i, s);
+    l.debug(e, i, s);
     try {
       const n = await fetch(i, {
         method: e,
@@ -116,7 +116,7 @@ var k = class {
       });
       return n.ok || await this.handleErrorResponse(n), n.status === 204 ? void 0 : n.json();
     } catch (n) {
-      throw n instanceof u ? n : new m(`Network error: ${n instanceof Error ? n.message : "Unknown error"}. Check that \`baseUrl\` is reachable and includes the protocol (https://).`, n instanceof Error ? n : void 0);
+      throw n instanceof f ? n : new y(`Network error: ${n instanceof Error ? n.message : "Unknown error"}. Check that \`baseUrl\` is reachable and includes the protocol (https://).`, n instanceof Error ? n : void 0);
     }
   }
   async handleErrorResponse(e) {
@@ -125,35 +125,42 @@ var k = class {
       t = await e.json();
     } catch {
     }
-    if (t?.error) throw u.fromResponse(t, e.status);
+    if (t?.error) throw f.fromResponse(t, e.status);
     let s = "";
-    throw e.status === 401 || e.status === 403 ? s = " Check `userJwt` (and that it has not expired)." : e.status === 404 && (s = " Check that `baseUrl` points at your AGO API root."), new u(`HTTP ${e.status}: ${e.statusText}.${s}`, "http_error", e.status, "api_error");
+    throw e.status === 401 || e.status === 403 ? s = " Check `userJwt` (and that it has not expired)." : e.status === 404 && (s = " Check that `baseUrl` points at your AGO API root."), new f(`HTTP ${e.status}: ${e.statusText}.${s}`, "http_error", e.status, "api_error");
   }
-}, x = class {
-  constructor() {
-    this.functions = /* @__PURE__ */ new Map();
+}, T = 5e4, N = 2e4, D = 2e3, P = class {
+  constructor(e) {
+    this.functions = /* @__PURE__ */ new Map(), this.defaultMaxResultBytes = e?.maxResultBytes ?? T;
+  }
+  setDefaultMaxResultBytes(e) {
+    this.defaultMaxResultBytes = e;
   }
   register(e, t, s) {
     if (typeof e == "object") {
-      const { name: n, handler: r, description: o, parameters: l } = e;
-      return this.register(n, r, {
-        description: o,
-        parameters: l
+      const { name: a, handler: r, description: c, parameters: u, maxResultBytes: h } = e;
+      return this.register(a, r, {
+        description: c,
+        parameters: u,
+        maxResultBytes: h
       });
     }
     const i = e;
-    if (!t || !s) throw new h(`registerFunction("${i}"): both a handler and a schema are required. Pass them as arguments or use the single-object form: registerFunction({ name, parameters, handler }).`, "function_invalid_registration");
-    this.functions.has(i) && a.warn(`Function "${i}" is being overwritten`), this.functions.set(i, {
+    if (!t || !s) throw new d(`registerFunction("${i}"): both a handler and a schema are required. Pass them as arguments or use the single-object form: registerFunction({ name, parameters, handler }).`, "function_invalid_registration");
+    this.functions.has(i) && l.warn(`Function "${i}" is being overwritten`);
+    const { maxResultBytes: n, ...o } = s;
+    this.functions.set(i, {
       schema: {
-        ...s,
+        ...o,
         name: i
       },
-      handler: t
-    }), a.log(`Registered function: ${i}`);
+      handler: t,
+      maxResultBytes: n
+    }), l.log(`Registered function: ${i}`);
   }
   unregister(e) {
     const t = this.functions.delete(e);
-    return t && a.log(`Unregistered function: ${e}`), t;
+    return t && l.log(`Unregistered function: ${e}`), t;
   }
   get(e) {
     return this.functions.get(e);
@@ -166,38 +173,55 @@ var k = class {
   }
   async execute(e, t) {
     const s = this.functions.get(e);
-    if (!s) throw new y(`Function "${e}" is not registered`, e);
-    a.log(`Executing function: ${e}`, t);
+    if (!s) throw new E(`Function "${e}" is not registered`, e);
+    l.log(`Executing function: ${e}`, t);
     try {
       const i = await s.handler(t);
-      return a.log(`Function ${e} completed:`, i), i;
+      return l.log(`Function ${e} completed:`, i), this.guardResultSize(e, i, s.maxResultBytes);
     } catch (i) {
-      throw a.error(`Function ${e} failed:`, i), new y(`Function "${e}" execution failed: ${i instanceof Error ? i.message : "Unknown error"}`, e, i instanceof Error ? i : void 0);
+      throw l.error(`Function ${e} failed:`, i), new E(`Function "${e}" execution failed: ${i instanceof Error ? i.message : "Unknown error"}`, e, i instanceof Error ? i : void 0);
     }
   }
+  guardResultSize(e, t, s) {
+    let i;
+    try {
+      i = JSON.stringify(t);
+    } catch {
+      return t;
+    }
+    if (i === void 0) return t;
+    const n = new TextEncoder().encode(i).length, o = s ?? this.defaultMaxResultBytes;
+    return n > o ? (l.warn(`Function "${e}" result is ${n} bytes, over the ${o}-byte limit; a truncated preview was sent to the agent instead. Return fewer fields, paginate, or raise maxResultBytes for this function.`), {
+      truncated: !0,
+      originalBytes: n,
+      maxBytes: o,
+      preview: i.slice(0, D),
+      hint: `The result of "${e}" exceeded the ${o}-byte limit and was truncated. Request less data (use limit or filter parameters if available), or tell the user the result is too large to process.`
+    }) : (n > N && l.warn(`Function "${e}" returned a large result (${Math.round(n / 1024)} KB). Large results consume LLM context: return fewer fields, paginate, or push the data to the UI and return a summary.`), t);
+  }
   clear() {
-    this.functions.clear(), a.log("Cleared all registered functions");
+    this.functions.clear(), l.log("Cleared all registered functions");
   }
   get size() {
     return this.functions.size;
   }
-}, A = class {
+}, M = class {
   constructor() {
     this.entries = /* @__PURE__ */ new Map(), this.dynamicProviders = /* @__PURE__ */ new Map();
   }
   set(e, t) {
-    this.entries.set(e, t), a.log(`ClientContext set: ${e}`);
+    this.entries.set(e, t), l.log(`ClientContext set: ${e}`);
   }
   remove(e) {
     const t = this.entries.delete(e);
-    return t && a.log(`ClientContext removed: ${e}`), t;
+    return t && l.log(`ClientContext removed: ${e}`), t;
   }
   addDynamicProvider(e, t) {
-    this.dynamicProviders.set(e, t), a.log(`DynamicContext provider added: ${e}`);
+    this.dynamicProviders.set(e, t), l.log(`DynamicContext provider added: ${e}`);
   }
   removeDynamicProvider(e) {
     const t = this.dynamicProviders.delete(e);
-    return t && a.log(`DynamicContext provider removed: ${e}`), t;
+    return t && l.log(`DynamicContext provider removed: ${e}`), t;
   }
   getSnapshot() {
     if (this.entries.size === 0 && this.dynamicProviders.size === 0) return null;
@@ -207,34 +231,34 @@ var k = class {
       const i = s();
       i && (e[t] = i);
     } catch (i) {
-      a.error(`DynamicContext provider "${t}" threw:`, i);
+      l.error(`DynamicContext provider "${t}" threw:`, i);
     }
     return Object.keys(e).length === 0 ? null : { entries: e };
   }
   clear() {
-    this.entries.clear(), this.dynamicProviders.clear(), a.log("ClientContext cleared");
+    this.entries.clear(), this.dynamicProviders.clear(), l.log("ClientContext cleared");
   }
 };
-function f(e) {
-  return e === null || typeof e != "object" ? JSON.stringify(e) ?? "null" : Array.isArray(e) ? `[${e.map(f).join(",")}]` : `{${Object.keys(e).sort().map((t) => `${JSON.stringify(t)}:${f(e[t])}`).join(",")}}`;
+function v(e) {
+  return e === null || typeof e != "object" ? JSON.stringify(e) ?? "null" : Array.isArray(e) ? `[${e.map(v).join(",")}]` : `{${Object.keys(e).sort().map((t) => `${JSON.stringify(t)}:${v(e[t])}`).join(",")}}`;
 }
-var R = class {
+var O = class {
   constructor(e) {
-    this.callbacks = e, this.buffer = "", this.message = {}, this.toolCalls = [], this.sources = [], this.followUpReplies = [], this.isFirstChunk = !0, this.answerCompleteEmitted = !1, this.firedClientFunctions = /* @__PURE__ */ new Set();
+    this.callbacks = e, this.buffer = "", this.message = {}, this.toolCalls = [], this.sources = [], this.followUpReplies = [], this.isFirstChunk = !0, this.answerCompleteEmitted = !1, this.waitingClientEmitted = !1, this.firedClientFunctions = /* @__PURE__ */ new Set();
   }
   async processStream(e) {
-    if (!e.body) throw new p("Response has no body. The endpoint did not return a stream: check that `baseUrl` points at an AGO API and nothing (proxy, mock) strips the SSE body.", "stream_no_body");
+    if (!e.body) throw new _("Response has no body. The endpoint did not return a stream: check that `baseUrl` points at an AGO API and nothing (proxy, mock) strips the SSE body.", "stream_no_body");
     const t = e.body.getReader(), s = new TextDecoder();
     try {
       for (; ; ) {
         const { done: i, value: n } = await t.read();
         if (i) break;
-        const r = s.decode(n, { stream: !0 });
-        this.buffer += r, this.processBuffer();
+        const o = s.decode(n, { stream: !0 });
+        this.buffer += o, this.processBuffer();
       }
       return this.buffer.trim() && this.processBuffer(), this.buildFinalMessage();
     } catch (i) {
-      const n = i instanceof Error ? i : new p("Stream processing failed mid-flight. The connection may have dropped; retry the message.");
+      const n = i instanceof Error ? i : new _("Stream processing failed mid-flight. The connection may have dropped; retry the message.");
       throw this.callbacks.onError?.(n), n;
     } finally {
       t.releaseLock();
@@ -253,10 +277,10 @@ var R = class {
         if (!i.startsWith(": ") && i.startsWith("data: ")) {
           const n = i.slice(6);
           try {
-            const r = JSON.parse(n);
-            this.handleChunk(r);
-          } catch (r) {
-            a.warn("Failed to parse SSE data:", n, r);
+            const o = JSON.parse(n);
+            this.handleChunk(o);
+          } catch (o) {
+            l.warn("Failed to parse SSE data:", n, o);
           }
         }
     }
@@ -281,7 +305,7 @@ var R = class {
         url: s.use_external_link ? s.external_link_url : s.internal_link_url
       };
     })), e.type === "client_function" && e.function_name) {
-      const t = `${e.function_name}::${f(e.arguments ?? {})}`;
+      const t = `${e.function_name}::${v(e.arguments ?? {})}`;
       this.firedClientFunctions.has(t) || (this.firedClientFunctions.add(t), this.callbacks.onClientFunction?.({
         invocationId: e.id || "",
         functionName: e.function_name,
@@ -295,7 +319,11 @@ var R = class {
       const s = this.toolCalls.findIndex((i) => i.id === t.id);
       s >= 0 ? this.toolCalls[s] = t : this.toolCalls.push(t);
     }
-    e.follow_up_replies && (this.followUpReplies = e.follow_up_replies), this.message.status === "DONE" && !this.answerCompleteEmitted && this.message.id && (this.answerCompleteEmitted = !0, this.callbacks.onAnswerComplete?.(this.buildMessage()));
+    e.follow_up_replies && (this.followUpReplies = e.follow_up_replies), this.message.status === "DONE" && !this.answerCompleteEmitted && this.message.id && (this.answerCompleteEmitted = !0, this.callbacks.onAnswerComplete?.(this.buildMessage())), this.message.status === "WAITING_CLIENT" && !this.waitingClientEmitted && this.message.id && (this.waitingClientEmitted = !0, this.callbacks.onWaitingClient?.({
+      conversationId: this.message.conversationId || "",
+      messageId: this.message.id,
+      waitingToolCallIds: e.waiting_tool_call_ids ?? []
+    }));
   }
   parseToolCall(e) {
     return {
@@ -327,14 +355,14 @@ var R = class {
   }
   buildFinalMessage() {
     const e = this.buildMessage();
-    return this.callbacks.onComplete?.(e), e;
+    return e.status !== "WAITING_CLIENT" && this.callbacks.onComplete?.(e), e;
   }
 };
-function O(e) {
+function H(e) {
   const t = e.message.toLowerCase();
   return t.includes("load failed") || t.includes("failed to fetch") || t.includes("network") || t.includes("abort");
 }
-var F = /* @__PURE__ */ new Set([
+var j = /* @__PURE__ */ new Set([
   "image/jpeg",
   "image/png",
   "image/gif",
@@ -342,7 +370,7 @@ var F = /* @__PURE__ */ new Set([
   "image/bmp",
   "image/tiff"
 ]);
-function I(e) {
+function B(e) {
   if (!e) return;
   const t = typeof window < "u" && window.location ? window.location.href : "https://ago.local/";
   try {
@@ -351,16 +379,16 @@ function I(e) {
   } catch {
   }
 }
-function j(e) {
-  return e.isSafeImage === !0 && typeof e.contentType == "string" && e.contentType.startsWith("image/") && I(e.url) !== void 0;
+function K(e) {
+  return e.isSafeImage === !0 && typeof e.contentType == "string" && e.contentType.startsWith("image/") && B(e.url) !== void 0;
 }
-function M(e) {
+function X(e) {
   if (e == null || e < 0) return "";
   if (e < 1024) return `${e} B`;
   const t = e / 1024;
   return t < 1024 ? `${t.toFixed(1)} KB` : `${(t / 1024).toFixed(1)} MB`;
 }
-function U(e) {
+function L(e) {
   return {
     id: String(e.id ?? ""),
     name: typeof e.name == "string" && e.name ? e.name : "file",
@@ -370,17 +398,17 @@ function U(e) {
     isSafeImage: e.is_safe_image === !0
   };
 }
-function L(e) {
+function Y(e) {
   return e.map((t, s) => ({
     id: `local-${s}-${t.name}`,
     name: t.name,
     contentType: t.type || void 0,
     fileSize: t.size,
     url: typeof URL < "u" && URL.createObjectURL ? URL.createObjectURL(t) : void 0,
-    isSafeImage: F.has(t.type)
+    isSafeImage: j.has(t.type)
   }));
 }
-var T = class {
+var G = class {
   constructor() {
     this.handlers = /* @__PURE__ */ new Map();
   }
@@ -410,60 +438,74 @@ var T = class {
   waitFor(e, t) {
     return new Promise((s, i) => {
       let n;
-      const r = ((o) => {
-        n && clearTimeout(n), s(o);
+      const o = ((a) => {
+        n && clearTimeout(n), s(a);
       });
-      this.once(e, r), t?.timeout && (n = setTimeout(() => {
-        this.off(e, r), i(/* @__PURE__ */ new Error(`waitFor("${String(e)}") timed out after ${t.timeout}ms`));
+      this.once(e, o), t?.timeout && (n = setTimeout(() => {
+        this.off(e, o), i(/* @__PURE__ */ new Error(`waitFor("${String(e)}") timed out after ${t.timeout}ms`));
       }, t.timeout));
     });
   }
   removeAllListeners(e) {
     e ? this.handlers.delete(e) : this.handlers.clear();
   }
-}, v = '`baseUrl` is required, e.g. new AgoClient({ baseUrl: "https://YOUR-DOMAIN.api.useago.com" }). Try the live demo endpoint https://playground.api.useago.com. See docs/general/configuration.md#error-codes (config_missing_base_url).', D = /^[a-z][a-z0-9+.-]*:\/\//i, C = !1;
-function b(e, t = "AgoClient") {
-  if (typeof e != "object" || e === null) throw new h(`${t}: ${v}`, "config_missing_base_url");
+}, S = '`baseUrl` is required, e.g. new AgoClient({ baseUrl: "https://YOUR-DOMAIN.api.useago.com" }). Try the live demo endpoint https://playground.api.useago.com. See docs/general/configuration.md#error-codes (config_missing_base_url).', W = /^[a-z][a-z0-9+.-]*:\/\//i, $ = !1;
+function x(e, t = "AgoClient") {
+  if (typeof e != "object" || e === null) throw new d(`${t}: ${S}`, "config_missing_base_url");
   const s = e.baseUrl;
-  if (typeof s != "string" || s.trim() === "") throw new h(`${t}: ${v}`, "config_missing_base_url");
-  !s.startsWith("/") && !D.test(s) && (C || (C = !0, console.warn(`[AGO] ${t}: \`baseUrl\` has no protocol and is not a relative path (config_suspect_base_url). Requests will fail: Node throws a URL parse error, browsers fetch it as a relative path. Use "https://..." (or a "/path" for a same-origin proxy).`)));
+  if (typeof s != "string" || s.trim() === "") throw new d(`${t}: ${S}`, "config_missing_base_url");
+  !s.startsWith("/") && !W.test(s) && ($ || ($ = !0, console.warn(`[AGO] ${t}: \`baseUrl\` has no protocol and is not a relative path (config_suspect_base_url). Requests will fail: Node throws a URL parse error, browsers fetch it as a relative path. Use "https://..." (or a "/path" for a same-origin proxy).`)));
 }
-function N(e) {
+function z(e) {
   return e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function P(e, t) {
+function w(e) {
+  return e.split("/").filter((t) => t.startsWith(":")).map((t) => t.slice(1));
+}
+function J(e, t) {
+  const s = [];
+  return {
+    path: e.split("/").map((i) => {
+      if (!i.startsWith(":")) return i;
+      const n = i.slice(1), o = t[n];
+      return o == null || o === "" ? (s.push(n), i) : encodeURIComponent(String(o));
+    }).join("/"),
+    missing: s
+  };
+}
+function q(e, t) {
   const s = t.find((n) => n.path === e);
   if (s) return s;
   const i = t.find((n) => {
     if (!n.path.includes(":")) return !1;
-    const r = "^" + n.path.split("/").map((o) => o.startsWith(":") ? "[^/]+" : N(o)).join("/") + "/?$";
-    return new RegExp(r).test(e);
+    const o = "^" + n.path.split("/").map((a) => a.startsWith(":") ? "[^/]+" : z(a)).join("/") + "/?$";
+    return new RegExp(o).test(e);
   });
-  return i || t.filter((n) => n.path !== "/" && e.startsWith(n.path)).sort((n, r) => r.path.length - n.path.length)[0];
+  return i || t.filter((n) => n.path !== "/" && e.startsWith(n.path)).sort((n, o) => o.path.length - n.path.length)[0];
 }
-var z = class _ {
+var V = class A {
   constructor(t) {
-    this.warnedEmptyConversations = /* @__PURE__ */ new Set(), b(t, "AgoClient"), this.config = t, this.httpClient = new k(t), this.functionRegistry = new x(), this.contextRegistry = new A(), this.eventEmitter = new T(), t.debug && a.enable(), a.log("AgoClient initialized");
+    this.warnedEmptyConversations = /* @__PURE__ */ new Set(), this.pendingResumes = /* @__PURE__ */ new Map(), this.resumeGate = null, x(t, "AgoClient"), this.config = t, this.httpClient = new U(t), this.functionRegistry = new P({ maxResultBytes: t.maxFunctionResultBytes }), this.contextRegistry = new M(), this.eventEmitter = new G(), t.debug && l.enable(), l.log("AgoClient initialized");
   }
   async sendMessage(t, s) {
-    const i = this.functionRegistry.getSchemas(), n = this.contextRegistry.getSnapshot(), r = this.config.agent || this.config.defaultAgentId, o = {
+    const i = this.functionRegistry.getSchemas(), n = this.contextRegistry.getSnapshot(), o = this.config.agent || this.config.defaultAgentId, a = this.resolveClientFunctionsMode(s), r = {
       content: t,
       conversation_id: s?.conversationId,
-      agent_id: s?.agentId || r
+      agent_id: s?.agentId || o
     };
-    i.length > 0 && (o.client_functions = i), n && (o.client_context = n), s?.hidden && (o.hidden = !0);
-    let l;
+    i.length > 0 && (r.client_functions = i, a === "pause" && (r.client_functions_mode = a)), n && (r.client_context = n), s?.hidden && (r.hidden = !0);
+    let c;
     if (s?.files && s.files.length > 0) {
-      const c = new FormData();
-      c.append("content", t), s.conversationId && c.append("conversation_id", s.conversationId), (s.agentId || r) && c.append("agent_id", s.agentId || r || ""), i.length > 0 && c.append("client_functions", JSON.stringify(i)), n && c.append("client_context", JSON.stringify(n)), s.hidden && c.append("hidden", "true");
-      for (const d of s.files) c.append("files", d);
-      l = await this.httpClient.postFormData("/api/sdk/v1/messages", c);
-    } else l = await this.httpClient.postStream("/api/sdk/v1/messages", o);
-    return this.processSSEResponse(l);
+      const u = new FormData();
+      u.append("content", t), s.conversationId && u.append("conversation_id", s.conversationId), (s.agentId || o) && u.append("agent_id", s.agentId || o || ""), i.length > 0 && (u.append("client_functions", JSON.stringify(i)), a === "pause" && u.append("client_functions_mode", a)), n && u.append("client_context", JSON.stringify(n)), s.hidden && u.append("hidden", "true");
+      for (const h of s.files) u.append("files", h);
+      c = await this.httpClient.postFormData("/api/sdk/v1/messages", u);
+    } else c = await this.httpClient.postStream("/api/sdk/v1/messages", r);
+    return this.processSSEResponse(c);
   }
   async processSSEResponse(t) {
     let s = !1;
-    const i = await new R({
+    const i = await new O({
       onRawChunk: (n) => {
         this.eventEmitter.emit("stream:message", n);
       },
@@ -482,17 +524,60 @@ var z = class _ {
       onAnswerComplete: (n) => {
         this.eventEmitter.emit("message:answer-complete", n);
       },
+      onWaitingClient: (n) => {
+        this.eventEmitter.emit("message:waiting-client", n), this.markResumeSignal(n.messageId, n.conversationId, "waitingConfirmed");
+      },
       onComplete: (n) => {
         this.eventEmitter.emit("message:complete", n);
       },
       onError: (n) => {
         this.eventEmitter.emit("message:error", {
           error: n.message,
-          code: n instanceof h ? n.code : void 0
+          code: n instanceof d ? n.code : void 0
         });
       }
     }).processStream(t);
-    return this.maybeFlagEmptyReply(i, s), i;
+    return i.status !== "WAITING_CLIENT" && this.maybeFlagEmptyReply(i, s), i;
+  }
+  resolveClientFunctionsMode(t) {
+    return t?.clientFunctionsMode ?? this.config.clientFunctionsMode ?? "placeholder";
+  }
+  registerResumeGate(t) {
+    return this.resumeGate = t, () => {
+      this.resumeGate === t && (this.resumeGate = null);
+    };
+  }
+  async continueMessage(t) {
+    const s = this.functionRegistry.getSchemas(), i = this.contextRegistry.getSnapshot(), n = {};
+    s.length > 0 && (n.client_functions = s), i && (n.client_context = i);
+    const o = await this.httpClient.postStream(`/api/sdk/v1/messages/${t}/continue`, n);
+    return this.processSSEResponse(o);
+  }
+  markResumeSignal(t, s, i) {
+    if (!t) return;
+    const n = this.pendingResumes.get(t) ?? {
+      conversationId: s,
+      waitingConfirmed: !1,
+      resultsReady: !1,
+      started: !1
+    };
+    n[i] = !0, s && (n.conversationId = s), this.pendingResumes.set(t, n), !(!n.waitingConfirmed || !n.resultsReady || n.started) && (n.started = !0, this.runAutoResume(t, n.conversationId));
+  }
+  async runAutoResume(t, s) {
+    try {
+      this.resumeGate && await this.resumeGate({
+        conversationId: s,
+        messageId: t
+      });
+    } catch (i) {
+      l.warn("Resume gate threw; resuming anyway:", i);
+    }
+    this.pendingResumes.delete(t);
+    try {
+      await this.continueMessage(t);
+    } catch (i) {
+      l.warn("Auto-resume of paused turn failed:", i);
+    }
   }
   maybeFlagEmptyReply(t, s) {
     t.status === "DONE" && (t.content ?? "").trim() === "" && !s && !(t.toolCalls && t.toolCalls.length > 0) && !(t.followUpReplies && t.followUpReplies.length > 0) && setTimeout(() => {
@@ -512,16 +597,17 @@ var z = class _ {
     try {
       s = await this.functionRegistry.execute(t.functionName, t.arguments);
     } catch (n) {
-      i = n instanceof Error ? n.message : "Unknown error", a.error("Client function execution failed:", n);
+      i = n instanceof Error ? n.message : "Unknown error", l.error("Client function execution failed:", n);
     }
     if (t.invocationId) try {
-      await this.submitToolCallForm(t.invocationId, {
+      const n = await this.submitToolCallForm(t.invocationId, {
         result: s,
         error: i,
         _type: "client_function_result"
       });
+      n?.resume?.ready && this.markResumeSignal(n.resume.message_id, t.conversationId, "resultsReady");
     } catch (n) {
-      a.error("Failed to submit function result:", n);
+      l.error("Failed to submit function result:", n);
     }
     this.eventEmitter.emit("function:result", {
       invocationId: t.invocationId,
@@ -549,8 +635,8 @@ var z = class _ {
         status: n.status,
         createdAt: new Date(n.created_at),
         hidden: n.hidden,
-        toolCalls: _.mapPersistedToolCalls(n.tool_call_data),
-        attachments: n.attachments && n.attachments.length > 0 ? n.attachments.map(U) : void 0
+        toolCalls: A.mapPersistedToolCalls(n.tool_call_data),
+        attachments: n.attachments && n.attachments.length > 0 ? n.attachments.map(L) : void 0
       }))
     };
     return this.eventEmitter.emit("conversation:loaded", i), i;
@@ -573,8 +659,30 @@ var z = class _ {
   async getMessages(t) {
     return (await this.getConversation(t)).messages || [];
   }
+  async resumePendingClientFunctions(t) {
+    const s = [...t.messages ?? []].reverse().find((r) => r.role === "assistant" && r.status === "WAITING_CLIENT");
+    if (!s) return null;
+    const i = (s.toolCalls ?? []).filter((r) => r.type === "client_function" && r.status === "waiting_input" && r.functionName), n = new Set(this.functionRegistry.getSchemas().map((r) => r.name)), o = i.filter((r) => !n.has(r.functionName));
+    if (o.length > 0)
+      return l.warn("Cannot resume paused turn: function(s) not registered on this page:", o.map((r) => r.functionName)), null;
+    let a = i.length === 0;
+    for (const r of i) {
+      let c, u;
+      try {
+        c = await this.functionRegistry.execute(r.functionName, r.arguments ?? {});
+      } catch (h) {
+        u = h instanceof Error ? h.message : "Unknown error", l.error("Client function execution failed:", h);
+      }
+      a = (await this.submitToolCallForm(r.id, {
+        result: c,
+        error: u,
+        _type: "client_function_result"
+      }))?.resume?.ready ?? a;
+    }
+    return a ? this.continueMessage(s.id) : null;
+  }
   async submitToolCallForm(t, s) {
-    await this.httpClient.post(`/api/sdk/v1/tool-calls/${t}/submit`, { formData: s });
+    return this.httpClient.post(`/api/sdk/v1/tool-calls/${t}/submit`, { formData: s });
   }
   async confirmToolCall(t) {
     await this.httpClient.post(`/api/tool-calls/${t}/confirm/`);
@@ -614,36 +722,68 @@ var z = class _ {
     return this.functionRegistry.getSchemas();
   }
   registerNavigationFunction(t, s) {
-    const i = s.map((r) => r.name), n = s.map((r) => `- "${r.name}": ${r.description}`).join(`
-`);
+    const i = s.map((r) => r.name), n = s.map((r) => {
+      const c = w(r.path), u = c.length > 0 ? ` (requires ${c.map((h) => `"${h}"`).join(", ")})` : "";
+      return `- "${r.name}"${u}: ${r.description}`;
+    }).join(`
+`), o = /* @__PURE__ */ new Map();
+    for (const r of s) for (const c of w(r.path)) o.set(c, [...o.get(c) ?? [], r.name]);
+    const a = { page: {
+      type: "string",
+      description: "The page to navigate to",
+      enum: i
+    } };
+    for (const [r, c] of o) {
+      if (r === "page") {
+        l.error('registerNavigationFunction: a ":page" placeholder collides with the "page" argument and is ignored. Rename the placeholder.');
+        continue;
+      }
+      a[r] = {
+        type: "string",
+        description: `Value for ":${r}" in the page path. Required when page is ${c.map((u) => `"${u}"`).join(" or ")}.`
+      };
+    }
     this.registerFunction("navigateToPage", async (r) => {
-      const o = r.page, l = s.find((c) => c.name === o);
-      return l ? (t(l.path), {
-        success: !0,
-        navigatedTo: l.path
-      }) : {
+      const c = r.page, u = s.find((m) => m.name === c);
+      if (!u) return {
         success: !1,
-        error: `Unknown page: ${o}`
+        error: `Unknown page: ${c}`
+      };
+      let h = {};
+      if (typeof r.params == "string") try {
+        h = JSON.parse(r.params);
+      } catch {
+      }
+      else r.params && typeof r.params == "object" && (h = r.params);
+      const C = {};
+      for (const m of w(u.path)) C[m] = r[m] ?? h[m];
+      const { path: b, missing: g } = J(u.path, C);
+      if (g.length > 0) {
+        const m = g.map((p) => `"${p}": "..."`).join(", ");
+        return {
+          success: !1,
+          error: `Page "${c}" needs ${g.map((p) => `"${p}"`).join(", ")}. Retry with { "page": "${c}", ${m} }.`
+        };
+      }
+      return t(b), {
+        success: !0,
+        navigatedTo: b
       };
     }, {
       description: `Navigate the user to a page in the application. Available pages:
 ${n}`,
       parameters: {
         type: "object",
-        properties: { page: {
-          type: "string",
-          description: "The page to navigate to",
-          enum: i
-        } },
+        properties: a,
         required: ["page"]
       }
     }), this.addDynamicContext("current-page", () => {
       if (typeof window > "u" || !window.location) return null;
-      const r = window.location.href, o = typeof document < "u" ? document.title : void 0, l = P(window.location.pathname, s), c = { url: r };
-      return l && (c.page = l.name), o && (c.title = o), {
+      const r = window.location.href, c = typeof document < "u" ? document.title : void 0, u = q(window.location.pathname, s), h = { url: r };
+      return u && (h.page = u.name), c && (h.title = c), {
         name: "Current page",
         description: "The page the user is currently viewing.",
-        data: c
+        data: h
       };
     });
   }
@@ -651,38 +791,38 @@ ${n}`,
     this.unregisterFunction("navigateToPage"), this.removeDynamicContext("current-page");
   }
   registerPageStateFunction(t, s) {
-    const i = s?.functionName ?? "setPageState", n = new Map(t.map((o) => [o.name, o])), r = t.map((o) => `- "${o.name}": ${o.description}`).join(`
+    const i = s?.functionName ?? "setPageState", n = new Map(t.map((a) => [a.name, a])), o = t.map((a) => `- "${a.name}": ${a.description}`).join(`
 `);
-    this.registerFunction(i, async (o) => {
-      const l = {};
-      for (const [c, d] of Object.entries(o)) {
-        if (d === void 0) continue;
-        const g = n.get(c);
-        g && (await g.set(d), l[c] = d);
+    this.registerFunction(i, async (a) => {
+      const r = {};
+      for (const [c, u] of Object.entries(a)) {
+        if (u === void 0) continue;
+        const h = n.get(c);
+        h && (await h.set(u), r[c] = u);
       }
       return {
         success: !0,
-        applied: l
+        applied: r
       };
     }, {
       description: `Change the state of the current page. Set ONLY the controls the user explicitly asked for; leave the others unset. Available controls:
-${r}`,
+${o}`,
       parameters: {
         type: "object",
-        properties: Object.fromEntries(t.map((o) => [o.name, {
-          ...o.schema,
-          description: o.description
+        properties: Object.fromEntries(t.map((a) => [a.name, {
+          ...a.schema,
+          description: a.description
         }]))
       }
     }), this.addDynamicContext(`page-state:${i}`, () => {
-      const o = t.filter((c) => typeof c.get == "function");
-      if (o.length === 0) return null;
-      const l = {};
-      for (const c of o) l[c.name] = c.get();
+      const a = t.filter((c) => typeof c.get == "function");
+      if (a.length === 0) return null;
+      const r = {};
+      for (const c of a) r[c.name] = c.get();
       return {
         name: "Page state",
         description: "Current, editable state of the page the user is viewing.",
-        data: l
+        data: r
       };
     });
   }
@@ -740,33 +880,33 @@ ${r}`,
   }
   updateConfig(t) {
     const s = {};
-    for (const [n, r] of Object.entries(t)) r !== void 0 && (s[n] = r);
+    for (const [n, o] of Object.entries(t)) o !== void 0 && (s[n] = o);
     const i = {
       ...this.config,
       ...s
     };
-    b(i, "AgoClient.updateConfig"), this.config = i, this.httpClient.updateConfig(s), s.debug !== void 0 && (s.debug ? a.enable() : a.disable());
+    x(i, "AgoClient.updateConfig"), this.config = i, this.httpClient.updateConfig(s), s.debug !== void 0 && (s.debug ? l.enable() : l.disable()), s.maxFunctionResultBytes !== void 0 && this.functionRegistry.setDefaultMaxResultBytes(s.maxFunctionResultBytes);
   }
   destroy() {
-    this.eventEmitter.removeAllListeners(), this.functionRegistry.clear(), this.contextRegistry.clear(), a.log("AgoClient destroyed");
+    this.eventEmitter.removeAllListeners(), this.functionRegistry.clear(), this.contextRegistry.clear(), this.pendingResumes.clear(), this.resumeGate = null, l.log("AgoClient destroyed");
   }
 };
 export {
-  p as _,
-  j as a,
-  R as c,
-  x as d,
-  a as f,
-  m as g,
-  y as h,
-  L as i,
-  O as l,
-  h as m,
-  b as n,
-  M as o,
-  u as p,
-  T as r,
-  I as s,
-  z as t,
-  A as u
+  _,
+  K as a,
+  O as c,
+  P as d,
+  l as f,
+  y as g,
+  E as h,
+  Y as i,
+  H as l,
+  d as m,
+  x as n,
+  X as o,
+  f as p,
+  G as r,
+  B as s,
+  V as t,
+  M as u
 };