@useago/sdk 1.5.6 → 1.7.0

package/dist/{AgoClient-B_R_qi2s.js → AgoClient-PWPaekcg.js}

@@ -1,34 +1,34 @@
-var Ut = 10, b = 1e3;
-function M(t) {
+var ie = 10, x = 1e3;
+function J(t) {
   if (typeof t != "object" || t === null) return !1;
   const e = Object.getPrototypeOf(t);
   return e === Object.prototype || e === null;
 }
-function A(t, e) {
+function b(t, e) {
   if (typeof t == "string") {
     if (t.length <= 1e3) return t;
-    const s = t.length - b;
-    return t.slice(0, b) + `…[truncated ${s} chars]`;
+    const s = t.length - x;
+    return t.slice(0, x) + `…[truncated ${s} chars]`;
   }
   if (Array.isArray(t)) {
     if (e.has(t)) return "…[circular]";
     e.add(t);
-    const s = t.slice(0, 50).map((i) => A(i, e));
+    const s = t.slice(0, 50).map((i) => b(i, e));
     return t.length > 50 && s.push(`…[+${t.length - 50} more]`), e.delete(t), s;
   }
-  if (M(t)) {
+  if (J(t)) {
     if (e.has(t)) return "…[circular]";
     e.add(t);
     const s = {};
-    for (const [i, n] of Object.entries(t)) s[i] = A(n, e);
+    for (const [i, n] of Object.entries(t)) s[i] = b(n, e);
     return e.delete(t), s;
   }
   return t;
 }
-function L(t) {
-  return A(t, /* @__PURE__ */ new WeakSet());
+function z(t) {
+  return b(t, /* @__PURE__ */ new WeakSet());
 }
-var j = class {
+var X = class {
   constructor(t = 10) {
     this.entries = [];
     const e = Math.floor(t);
@@ -40,7 +40,7 @@ var j = class {
       actor: t.actor ?? "user",
       name: t.name,
       summary: t.summary,
-      ...t.data !== void 0 ? { data: L(t.data) } : {}
+      ...t.data !== void 0 ? { data: z(t.data) } : {}
     };
     this.entries.push(e);
     const s = this.entries.length - this.maxEntries;
@@ -59,27 +59,27 @@ var j = class {
   constructor(t, e, s) {
     super(t), this.code = e, this.statusCode = s, this.name = "AgoError";
   }
-}, p = class P extends g {
-  constructor(e, s, i, n, o, a) {
-    super(e, s, i), this.type = n, this.param = o, this.docUrl = a, this.name = "AgoApiError";
+}, y = class K extends g {
+  constructor(e, s, i, n, r, c) {
+    super(e, s, i), this.type = n, this.param = r, this.docUrl = c, this.name = "AgoApiError";
   }
   static fromResponse(e, s) {
     const i = e.error;
-    return new P(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);
   }
-}, w = class extends g {
+}, S = class extends g {
   constructor(t, e) {
     super(t, "network_error"), this.originalError = e, this.name = "AgoNetworkError";
   }
-}, k = class extends g {
+}, F = class extends g {
   constructor(t, e = "stream_error") {
     super(t, e), this.name = "AgoStreamError";
   }
-}, R = class extends g {
+}, D = class extends g {
   constructor(t, e, s) {
     super(t, "function_error"), this.functionName = e, this.originalError = s, this.name = "AgoFunctionError";
   }
-}, B = class {
+}, Y = class {
   constructor(t = !1) {
     this.enabled = t;
   }
@@ -101,22 +101,25 @@ var j = class {
   debug(...t) {
     this.enabled && console.debug("[AGO SDK]", ...t);
   }
-}, c = new B(), I = "ago_widget_id";
-function G() {
+}, l = new Y(), $ = "ago_widget_id";
+function _(t) {
+  return typeof DOMException < "u" && t instanceof DOMException && t.name === "AbortError" || t instanceof Error && t.name === "AbortError";
+}
+function V() {
   if (typeof localStorage < "u") {
-    const e = localStorage.getItem(I);
+    const e = localStorage.getItem($);
     if (e) return e;
   }
   const t = 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(I, t);
+    localStorage.setItem($, t);
   } catch {
   }
   return t;
 }
-var K = class {
+var Q = class {
   constructor(t) {
-    this.baseUrl = t.baseUrl.replace(/\/$/, ""), this.headers = { "X-User-Anon-Id": t.widgetId || G() }, t.userEmail && (this.headers["X-User-Email"] = t.userEmail), t.userJwt && (this.headers.Authorization = `Bearer ${t.userJwt}`), t.permission && (this.headers["X-Widget-Permission"] = t.permission);
+    this.baseUrl = t.baseUrl.replace(/\/$/, ""), this.headers = { "X-User-Anon-Id": t.widgetId || V() }, t.userEmail && (this.headers["X-User-Email"] = t.userEmail), t.userJwt && (this.headers.Authorization = `Bearer ${t.userJwt}`), t.permission && (this.headers["X-Widget-Permission"] = t.permission);
   }
   updateConfig(t) {
     t.baseUrl && (this.baseUrl = t.baseUrl.replace(/\/$/, "")), t.widgetId && (this.headers["X-User-Anon-Id"] = t.widgetId), t.userEmail && (this.headers["X-User-Email"] = t.userEmail), t.userJwt && (this.headers.Authorization = `Bearer ${t.userJwt}`), t.permission !== void 0 && (t.permission ? this.headers["X-Widget-Permission"] = t.permission : delete this.headers["X-Widget-Permission"]);
@@ -127,43 +130,45 @@ var K = class {
   async post(t, e, s) {
     return this.request("POST", t, e, s);
   }
-  async postStream(t, e) {
-    const s = `${this.baseUrl}${t}`;
-    c.debug("POST (stream)", s, e);
+  async postStream(t, e, s) {
+    const i = `${this.baseUrl}${t}`;
+    l.debug("POST (stream)", i, e);
     try {
-      const i = await fetch(s, {
+      const n = await fetch(i, {
         method: "POST",
         headers: {
           ...this.headers,
           "Content-Type": "application/json"
         },
-        body: e ? JSON.stringify(e) : void 0
+        body: e ? JSON.stringify(e) : void 0,
+        signal: s?.signal
       });
-      return i.ok || await this.handleErrorResponse(i), i;
-    } catch (i) {
-      throw i instanceof p ? i : new w(`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);
+      return n.ok || await this.handleErrorResponse(n), n;
+    } catch (n) {
+      throw n instanceof y || _(n) ? n : new S(`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 postFormData(t, e) {
-    const s = `${this.baseUrl}${t}`;
-    c.debug("POST (formData)", s);
-    const i = { ...this.headers };
+  async postFormData(t, e, s) {
+    const i = `${this.baseUrl}${t}`;
+    l.debug("POST (formData)", i);
+    const n = { ...this.headers };
     try {
-      const n = await fetch(s, {
+      const r = await fetch(i, {
         method: "POST",
-        headers: i,
-        body: e
+        headers: n,
+        body: e,
+        signal: s?.signal
       });
-      return n.ok || await this.handleErrorResponse(n), n;
-    } catch (n) {
-      throw n instanceof p ? n : new w(`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);
+      return r.ok || await this.handleErrorResponse(r), r;
+    } catch (r) {
+      throw r instanceof y || _(r) ? r : new S(`Network error: ${r instanceof Error ? r.message : "Unknown error"}. Check that \`baseUrl\` is reachable and includes the protocol (https://).`, r instanceof Error ? r : void 0);
     }
   }
   async request(t, e, s, i) {
     const n = `${this.baseUrl}${e}`;
-    c.debug(t, n, s);
+    l.debug(t, n, s);
     try {
-      const o = await fetch(n, {
+      const r = await fetch(n, {
         method: t,
         headers: {
           ...this.headers,
@@ -172,9 +177,9 @@ var K = class {
         body: s ? JSON.stringify(s) : void 0,
         ...i?.keepalive ? { keepalive: !0 } : {}
       });
-      return o.ok || await this.handleErrorResponse(o), o.status === 204 ? void 0 : o.json();
-    } catch (o) {
-      throw o instanceof p ? o : new w(`Network error: ${o instanceof Error ? o.message : "Unknown error"}. Check that \`baseUrl\` is reachable and includes the protocol (https://).`, o instanceof Error ? o : void 0);
+      return r.ok || await this.handleErrorResponse(r), r.status === 204 ? void 0 : r.json();
+    } catch (r) {
+      throw r instanceof y ? r : new S(`Network error: ${r instanceof Error ? r.message : "Unknown error"}. Check that \`baseUrl\` is reachable and includes the protocol (https://).`, r instanceof Error ? r : void 0);
     }
   }
   async handleErrorResponse(t) {
@@ -183,44 +188,47 @@ var K = class {
       e = await t.json();
     } catch {
     }
-    if (e?.error) throw p.fromResponse(e, t.status);
+    if (e?.error) throw y.fromResponse(e, t.status);
     let s = "";
-    throw t.status === 401 || t.status === 403 ? s = " Check `userJwt` (and that it has not expired)." : t.status === 404 && (s = " Check that `baseUrl` points at your AGO API root."), new p(`HTTP ${t.status}: ${t.statusText}.${s}`, "http_error", t.status, "api_error");
+    throw t.status === 401 || t.status === 403 ? s = " Check `userJwt` (and that it has not expired)." : t.status === 404 && (s = " Check that `baseUrl` points at your AGO API root."), new y(`HTTP ${t.status}: ${t.statusText}.${s}`, "http_error", t.status, "api_error");
   }
-}, W = 5e4, q = 2e4, H = 2e3, z = class {
+}, Z = 5e4, tt = 2e4, et = 2e3, st = class {
   constructor(t) {
-    this.functions = /* @__PURE__ */ new Map(), this.defaultMaxResultBytes = t?.maxResultBytes ?? W;
+    this.functions = /* @__PURE__ */ new Map(), this.defaultMaxResultBytes = t?.maxResultBytes ?? Z;
   }
   setDefaultMaxResultBytes(t) {
     this.defaultMaxResultBytes = t;
   }
+  getDefaultMaxResultBytes() {
+    return this.defaultMaxResultBytes;
+  }
   register(t, e, s) {
     if (typeof t == "object") {
-      const { name: r, handler: l, description: h, parameters: u, maxResultBytes: d, requiresApproval: m } = t;
-      return this.register(r, l, {
+      const { name: o, handler: a, description: h, parameters: u, maxResultBytes: d, requiresApproval: f } = t;
+      return this.register(o, a, {
         description: h,
         parameters: u,
         maxResultBytes: d,
-        requiresApproval: m
+        requiresApproval: f
       });
     }
     const i = t;
     if (!e || !s) throw new g(`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) && c.warn(`Function "${i}" is being overwritten`);
-    const { maxResultBytes: n, requiresApproval: o, ...a } = s;
+    this.functions.has(i) && l.warn(`Function "${i}" is being overwritten`);
+    const { maxResultBytes: n, requiresApproval: r, ...c } = s;
     this.functions.set(i, {
       schema: {
-        ...a,
+        ...c,
         name: i
       },
       handler: e,
       maxResultBytes: n,
-      requiresApproval: o
-    }), c.log(`Registered function: ${i}`);
+      requiresApproval: r
+    }), l.log(`Registered function: ${i}`);
   }
   unregister(t) {
     const e = this.functions.delete(t);
-    return e && c.log(`Unregistered function: ${t}`), e;
+    return e && l.log(`Unregistered function: ${t}`), e;
   }
   get(t) {
     return this.functions.get(t);
@@ -233,13 +241,13 @@ var K = class {
   }
   async execute(t, e) {
     const s = this.functions.get(t);
-    if (!s) throw new R(`Function "${t}" is not registered`, t);
-    c.log(`Executing function: ${t}`, e);
+    if (!s) throw new D(`Function "${t}" is not registered`, t);
+    l.log(`Executing function: ${t}`, e);
     try {
       const i = await s.handler(e);
-      return c.log(`Function ${t} completed:`, i), this.guardResultSize(t, i, s.maxResultBytes);
+      return l.log(`Function ${t} completed:`, i), this.guardResultSize(t, i, s.maxResultBytes);
     } catch (i) {
-      throw c.error(`Function ${t} failed:`, i), new R(`Function "${t}" execution failed: ${i instanceof Error ? i.message : "Unknown error"}`, t, i instanceof Error ? i : void 0);
+      throw l.error(`Function ${t} failed:`, i), new D(`Function "${t}" execution failed: ${i instanceof Error ? i.message : "Unknown error"}`, t, i instanceof Error ? i : void 0);
     }
   }
   guardResultSize(t, e, s) {
@@ -250,47 +258,168 @@ var K = class {
       return e;
     }
     if (i === void 0) return e;
-    const n = new TextEncoder().encode(i).length, o = s ?? this.defaultMaxResultBytes;
-    return n > o ? (c.warn(`Function "${t}" 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.`), {
+    const n = new TextEncoder().encode(i).length, r = s ?? this.defaultMaxResultBytes;
+    return n > r ? (l.warn(`Function "${t}" result is ${n} bytes, over the ${r}-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, H),
-      hint: `The result of "${t}" 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 > q && c.warn(`Function "${t}" 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.`), e);
+      maxBytes: r,
+      preview: i.slice(0, et),
+      hint: `The result of "${t}" exceeded the ${r}-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 > tt && l.warn(`Function "${t}" 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.`), e);
   }
   clear() {
-    this.functions.clear(), c.log("Cleared all registered functions");
+    this.functions.clear(), l.log("Cleared all registered functions");
   }
   get size() {
     return this.functions.size;
   }
-}, J = 250, X = 3, Y = 1e3, V = 24, Q = 10, Z = 50, tt = [
+}, it = 50, nt = 2;
+var rt = 2e3, ot = new TextEncoder();
+function m(t) {
+  return ot.encode(t).length;
+}
+function v(t) {
+  try {
+    return JSON.stringify(t);
+  } catch {
+    return;
+  }
+}
+var I = /* @__PURE__ */ Symbol("ago.pageData.timeout");
+function at(t, e) {
+  return e <= 0 ? Promise.resolve(I) : new Promise((s, i) => {
+    const n = setTimeout(() => s(I), e);
+    t.then((r) => {
+      clearTimeout(n), s(r);
+    }, (r) => {
+      clearTimeout(n), i(r);
+    });
+  });
+}
+async function ct(t, e) {
+  const s = Date.now() + e;
+  let i = 0;
+  for (; Date.now() < s && i < nt; )
+    i = t().isLoading?.() ? 0 : i + 1, await new Promise((o) => setTimeout(o, it));
+  const n = t().get();
+  if (!P(n)) return n;
+  const r = await at(Promise.resolve(n), s - Date.now());
+  if (r !== I) return r;
+  l.warn("Page data did not resolve within the settle timeout; returning what the page has now. Raise settleTimeoutMs if the work legitimately takes longer.");
+  const c = t().get();
+  if (!P(c)) return c;
+  Promise.resolve(c).catch(() => {
+  });
+}
+function P(t) {
+  return typeof t == "object" && t !== null && typeof t.then == "function";
+}
+function lt(t) {
+  if (typeof t != "object" || t === null || Array.isArray(t)) return;
+  const e = t;
+  let s;
+  for (const i of Object.keys(e)) {
+    const n = e[i];
+    Array.isArray(n) && (s === void 0 || n.length > e[s].length) && (s = i);
+  }
+  return s;
+}
+function ut(t, e) {
+  let s = 2, i = 0;
+  for (const n of t) {
+    const r = m(v(n) ?? "null") + (i > 0 ? 1 : 0);
+    if (s + r > e) break;
+    s += r, i++;
+  }
+  return i;
+}
+function ht(t, e) {
+  if (e <= 0) return "";
+  const s = (r) => m(JSON.stringify(r)) - 2;
+  let i = t.slice(0, e), n = s(i);
+  for (; n > e && i.length > 0; )
+    i = i.slice(0, Math.max(0, Math.floor(i.length * e / n) - 1)), n = s(i);
+  return i;
+}
+function R(t) {
+  return `The page data returned by "${t}" was too large to send in full. Only the first items are included: ask for fewer rows or narrow the filters to see the rest.`;
+}
+function dt(t, e, s, i) {
+  const n = {
+    truncated: !0,
+    originalBytes: s,
+    maxBytes: i,
+    preview: "",
+    hint: R(t)
+  }, r = m(v(n) ?? "{}");
+  return {
+    ...n,
+    preview: ht(e, Math.min(rt, i - r))
+  };
+}
+function gt(t, e, s, i, n) {
+  const r = s === void 0 ? {} : { ...e }, c = s ?? "items", o = m(v({
+    ...r,
+    [c]: [],
+    truncation: {
+      truncated: !0,
+      returnedItems: i.length,
+      totalItems: i.length,
+      hint: R(t)
+    }
+  }) ?? "{}") - 2;
+  if (o >= n) return;
+  const a = i.slice(0, ut(i, n - o));
+  return {
+    ...r,
+    [c]: a,
+    truncation: {
+      truncated: !0,
+      returnedItems: a.length,
+      totalItems: i.length,
+      hint: R(t)
+    }
+  };
+}
+function N(t, e, s) {
+  const i = v(e);
+  if (i === void 0) return e;
+  const n = m(i);
+  if (n <= s) return e;
+  l.warn(`Page data for "${t}" is ${n} bytes, over the ${s}-byte limit; it was truncated to the first items that fit. Return fewer fields per item, paginate, or raise maxResultBytes on the data source.`);
+  const r = lt(e), c = Array.isArray(e) ? e : r !== void 0 ? e[r] : void 0;
+  if (c) {
+    const o = gt(t, e, r, c, s), a = m(v(o) ?? "");
+    if (o !== void 0 && a <= s) return o;
+  }
+  return dt(t, i, n, s);
+}
+var ft = 250, pt = 3, mt = 1e3, yt = 24, vt = 10, wt = 50, Ct = [
   "mousemove",
   "mousedown",
   "keydown",
   "scroll",
   "touchstart"
-], et = class {
+], St = class {
   constructor(t = {}) {
-    this.started = !1, this.teardowns = [], this.route = "", this.routeEnteredAt = 0, this.lastActivityAt = 0, this.lastHeavyActivityAt = 0, this.recentRoutes = [], this.routeBounces = 0, this.rageClicks = 0, this.fieldErrors = {}, this.recentClicks = [], this.signals = [], this.listeners = /* @__PURE__ */ new Set(), this.getPageState = t.getPageState, this.activityThrottleMs = t.activityThrottleMs ?? J, this.rageClickCount = t.rageClickCount ?? X, this.rageClickWindowMs = t.rageClickWindowMs ?? Y, this.rageClickRadiusPx = t.rageClickRadiusPx ?? V, this.maxRecentRoutes = t.maxRecentRoutes ?? Q, this.maxSignals = t.maxSignals ?? Z;
+    this.started = !1, this.teardowns = [], this.route = "", this.routeEnteredAt = 0, this.lastActivityAt = 0, this.lastHeavyActivityAt = 0, this.recentRoutes = [], this.routeBounces = 0, this.rageClicks = 0, this.fieldErrors = {}, this.recentClicks = [], this.signals = [], this.listeners = /* @__PURE__ */ new Set(), this.getPageState = t.getPageState, this.activityThrottleMs = t.activityThrottleMs ?? ft, this.rageClickCount = t.rageClickCount ?? pt, this.rageClickWindowMs = t.rageClickWindowMs ?? mt, this.rageClickRadiusPx = t.rageClickRadiusPx ?? yt, this.maxRecentRoutes = t.maxRecentRoutes ?? vt, this.maxSignals = t.maxSignals ?? wt;
   }
   start() {
     if (this.started || typeof window > "u" || typeof document > "u") return;
     this.started = !0;
     const t = Date.now();
     this.route = this.currentPathname(), this.routeEnteredAt = t, this.lastActivityAt = t, this.recentRoutes = [this.route];
-    const e = (i, n, o) => {
-      i.addEventListener(n, o, { passive: !0 }), this.teardowns.push(() => i.removeEventListener(n, o));
+    const e = (i, n, r) => {
+      i.addEventListener(n, r, { passive: !0 }), this.teardowns.push(() => i.removeEventListener(n, r));
     }, s = () => this.recordActivity();
-    for (const i of tt) e(window, i, s);
+    for (const i of Ct) e(window, i, s);
     e(document, "visibilitychange", () => {
       document.visibilityState === "visible" && this.recordActivity();
-    }), e(window, "popstate", () => this.checkRoute()), e(window, "hashchange", () => this.checkRoute()), e(window, "click", (i) => this.onClick(i)), c.log("SignalCollector started");
+    }), e(window, "popstate", () => this.checkRoute()), e(window, "hashchange", () => this.checkRoute()), e(window, "click", (i) => this.onClick(i)), l.log("SignalCollector started");
   }
   destroy() {
     for (const t of this.teardowns) t();
-    this.teardowns = [], this.listeners.clear(), this.recentClicks = [], this.started = !1, c.log("SignalCollector destroyed");
+    this.teardowns = [], this.listeners.clear(), this.recentClicks = [], this.started = !1, l.log("SignalCollector destroyed");
   }
   signalFieldError(t) {
     this.checkRoute();
@@ -333,7 +462,7 @@ var K = class {
     try {
       return this.getPageState() ?? null;
     } catch (t) {
-      return c.warn("SignalCollector getPageState threw:", t), null;
+      return l.warn("SignalCollector getPageState threw:", t), null;
     }
   }
   recordActivity() {
@@ -368,9 +497,9 @@ var K = class {
       y: t.clientY,
       stateKey: s
     };
-    this.recentClicks = this.recentClicks.filter((r) => e - r.at <= this.rageClickWindowMs);
-    const n = this.recentClicks[0], o = !n || Math.abs(i.x - n.x) <= this.rageClickRadiusPx && Math.abs(i.y - n.y) <= this.rageClickRadiusPx, a = !n || n.stateKey === s;
-    if (!o || !a) {
+    this.recentClicks = this.recentClicks.filter((o) => e - o.at <= this.rageClickWindowMs);
+    const n = this.recentClicks[0], r = !n || Math.abs(i.x - n.x) <= this.rageClickRadiusPx && Math.abs(i.y - n.y) <= this.rageClickRadiusPx, c = !n || n.stateKey === s;
+    if (!r || !c) {
       this.recentClicks = [i];
       return;
     }
@@ -395,20 +524,20 @@ var K = class {
     for (const e of this.listeners) try {
       e(t);
     } catch (s) {
-      c.error("Signal listener threw:", s);
+      l.error("Signal listener threw:", s);
     }
   }
 };
-function st(t, e) {
+function At(t, e) {
   const s = e ? e.storage ?? (typeof localStorage < "u" ? localStorage : void 0) : void 0;
   let i = t;
   if (e && s) try {
-    const r = s.getItem(e.key);
-    r != null && (i = JSON.parse(r));
+    const o = s.getItem(e.key);
+    o != null && (i = JSON.parse(o));
   } catch {
   }
-  const n = /* @__PURE__ */ new Set(), o = () => n.forEach((r) => r(i));
-  function a() {
+  const n = /* @__PURE__ */ new Set(), r = () => n.forEach((o) => o(i));
+  function c() {
     if (e && s) try {
       s.setItem(e.key, JSON.stringify(i));
     } catch {
@@ -416,31 +545,31 @@ function st(t, e) {
   }
   return {
     get: () => i,
-    set: (r) => {
-      i = r, a(), o();
+    set: (o) => {
+      i = o, c(), r();
     },
-    subscribe: (r) => (n.add(r), () => {
-      n.delete(r);
+    subscribe: (o) => (n.add(o), () => {
+      n.delete(o);
     })
   };
 }
-var it = 6e4, nt = 1440 * 60 * 1e3, rt = "ago_proactive";
-function C(t) {
+var Et = 6e4, bt = 1440 * 60 * 1e3, _t = "ago_proactive";
+function A(t) {
   const e = new Date(t), s = String(e.getMonth() + 1).padStart(2, "0"), i = String(e.getDate()).padStart(2, "0");
   return `${e.getFullYear()}-${s}-${i}`;
 }
-var ot = class {
+var It = class {
   constructor(t = {}) {
-    this.killSwitchEnabled = !1, this.engaged = !1, this.turnInFlight = !1, this.slotOccupied = !1, this.sessionCount = 0, this.perSessionCap = t.frequencyCap?.perSession, this.perDayCap = t.frequencyCap?.perDay, this.store = st({
+    this.killSwitchEnabled = !1, this.engaged = !1, this.turnInFlight = !1, this.slotOccupied = !1, this.sessionCount = 0, this.perSessionCap = t.frequencyCap?.perSession, this.perDayCap = t.frequencyCap?.perDay, this.store = At({
       optOut: !1,
       lastFiredAt: {},
       dismissedAt: {},
       day: {
-        date: C(Date.now()),
+        date: A(Date.now()),
         count: 0
       }
     }, {
-      key: t.storageKey ?? rt,
+      key: t.storageKey ?? _t,
       storage: t.storage
     });
   }
@@ -484,10 +613,10 @@ var ot = class {
     if (this.engaged) return this.deny(t, "user engaged (widget open)");
     if (this.turnInFlight) return this.deny(t, "message turn in flight");
     if (this.slotOccupied) return this.deny(t, "nudge slot occupied");
-    const i = s.lastFiredAt[t.id], n = t.cooldownMs ?? it;
+    const i = s.lastFiredAt[t.id], n = t.cooldownMs ?? Et;
     if (i !== void 0 && e - i < n) return this.deny(t, "cooldown");
-    const o = s.dismissedAt[t.id], a = t.resurfaceAfterMs ?? nt;
-    return o !== void 0 && e - o < a ? this.deny(t, "dismissed recently") : this.perSessionCap !== void 0 && this.sessionCount >= this.perSessionCap ? this.deny(t, "perSession cap") : this.perDayCap !== void 0 && this.dayCount(e) >= this.perDayCap ? this.deny(t, "perDay cap") : !0;
+    const r = s.dismissedAt[t.id], c = t.resurfaceAfterMs ?? bt;
+    return r !== void 0 && e - r < c ? this.deny(t, "dismissed recently") : this.perSessionCap !== void 0 && this.sessionCount >= this.perSessionCap ? this.deny(t, "perSession cap") : this.perDayCap !== void 0 && this.dayCount(e) >= this.perDayCap ? this.deny(t, "perDay cap") : !0;
   }
   recordFired(t, e = Date.now()) {
     const s = this.store.get();
@@ -501,7 +630,7 @@ var ot = class {
   }
   recordNudgeShown(t = Date.now()) {
     this.sessionCount += 1;
-    const e = this.store.get(), s = C(t), i = e.day.date === s ? {
+    const e = this.store.get(), s = A(t), i = e.day.date === s ? {
       date: s,
       count: e.day.count + 1
     } : {
@@ -525,53 +654,53 @@ var ot = class {
   }
   dayCount(t) {
     const e = this.store.get();
-    return e.day.date === C(t) ? e.day.count : 0;
+    return e.day.date === A(t) ? e.day.count : 0;
   }
   deny(t, e) {
-    return c.debug(`NudgeGovernor: trigger "${t.id}" blocked — ${e}`), !1;
+    return l.debug(`NudgeGovernor: trigger "${t.id}" blocked — ${e}`), !1;
   }
 };
-function x() {
+function M() {
   return typeof crypto < "u" && typeof crypto.randomUUID == "function" ? crypto.randomUUID() : "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (t) => {
     const e = Math.floor(Math.random() * 16);
     return (t === "x" ? e : e & 3 | 8).toString(16);
   });
 }
-function at(t) {
+function Rt(t) {
   return t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function ct(t, e) {
+function kt(t, e) {
   if (t === "*" || t === e) return !0;
-  const s = t.split("/"), i = s.map((n, o) => {
-    const a = o === s.length - 1;
-    return n === "*" ? a ? "[^/]+(?:/[^/]+)*" : "[^/]+" : n.startsWith(":") ? "[^/]+" : at(n);
+  const s = t.split("/"), i = s.map((n, r) => {
+    const c = r === s.length - 1;
+    return n === "*" ? c ? "[^/]+(?:/[^/]+)*" : "[^/]+" : n.startsWith(":") ? "[^/]+" : Rt(n);
   });
   return new RegExp("^" + i.join("/") + "/?$").test(e);
 }
-function O(t, e) {
-  return t === e ? !0 : t === null || e === null ? !1 : Array.isArray(t) ? !Array.isArray(e) || e.length !== t.length ? !1 : t.every((s, i) => E(s, e[i])) : typeof t == "object" ? typeof e != "object" || Array.isArray(e) ? !1 : Object.entries(t).every(([s, i]) => O(i, e[s])) : !1;
+function W(t, e) {
+  return t === e ? !0 : t === null || e === null ? !1 : Array.isArray(t) ? !Array.isArray(e) || e.length !== t.length ? !1 : t.every((s, i) => k(s, e[i])) : typeof t == "object" ? typeof e != "object" || Array.isArray(e) ? !1 : Object.entries(t).every(([s, i]) => W(i, e[s])) : !1;
 }
-function E(t, e) {
+function k(t, e) {
   if (t === e) return !0;
   if (t === null || e === null || typeof t != typeof e) return !1;
   if (Array.isArray(t))
-    return !Array.isArray(e) || t.length !== e.length ? !1 : t.every((s, i) => E(s, e[i]));
+    return !Array.isArray(e) || t.length !== e.length ? !1 : t.every((s, i) => k(s, e[i]));
   if (typeof t == "object") {
     const s = Object.keys(t), i = Object.keys(e);
-    return s.length !== i.length ? !1 : s.every((n) => E(t[n], e[n]));
+    return s.length !== i.length ? !1 : s.every((n) => k(t[n], e[n]));
   }
   return !1;
 }
-function lt(t, e) {
-  if (t.route !== void 0 && !ct(t.route, e.route) || t.idleMs !== void 0 && e.idleMs < t.idleMs || t.dwellMs !== void 0 && e.dwellMs < t.dwellMs || t.rageClicks !== void 0 && e.rageClicks < t.rageClicks || t.routeBounces !== void 0 && e.routeBounces < t.routeBounces) return !1;
+function Tt(t, e) {
+  if (t.route !== void 0 && !kt(t.route, e.route) || t.idleMs !== void 0 && e.idleMs < t.idleMs || t.dwellMs !== void 0 && e.dwellMs < t.dwellMs || t.rageClicks !== void 0 && e.rageClicks < t.rageClicks || t.routeBounces !== void 0 && e.routeBounces < t.routeBounces) return !1;
   if (t.fieldErrors !== void 0) {
     for (const [s, i] of Object.entries(t.fieldErrors)) if ((e.fieldErrors[s] ?? 0) < i) return !1;
   }
-  return !(t.pageState !== void 0 && !O(t.pageState, e.pageState ?? {}));
+  return !(t.pageState !== void 0 && !W(t.pageState, e.pageState ?? {}));
 }
-var ht = 1e3, ut = "/api/sdk/v1/config", dt = "/api/sdk/v1/proactive/evaluate", gt = class {
+var xt = 1e3, Ft = "/api/sdk/v1/config", Dt = "/api/sdk/v1/proactive/evaluate", $t = class {
   constructor(t) {
-    this.tickTimer = null, this.teardowns = [], this.started = !1, this.activeNudge = null, this.lastConversationId = null, this.shownIds = /* @__PURE__ */ new Set(), this.resolvedIds = /* @__PURE__ */ new Set(), this.lastEvaluationAt = 0, this.client = t.client, this.collector = t.collector, this.governor = t.governor, this.tracker = t.tracker, this.options = t.options, this.tickMs = t.options.tickMs ?? ht;
+    this.tickTimer = null, this.teardowns = [], this.started = !1, this.activeNudge = null, this.lastConversationId = null, this.shownIds = /* @__PURE__ */ new Set(), this.resolvedIds = /* @__PURE__ */ new Set(), this.lastEvaluationAt = 0, this.client = t.client, this.collector = t.collector, this.governor = t.governor, this.tracker = t.tracker, this.options = t.options, this.tickMs = t.options.tickMs ?? xt;
   }
   start() {
     if (this.started) return;
@@ -597,17 +726,17 @@ var ht = 1e3, ut = "/api/sdk/v1/config", dt = "/api/sdk/v1/proactive/evaluate",
   }
   async loadKillSwitch() {
     try {
-      const t = await this.client.getHttp().get(ut);
+      const t = await this.client.getHttp().get(Ft);
       this.governor.setKillSwitch(t?.proactive?.enabled === !0);
     } catch (t) {
-      c.debug("Proactive config fetch failed; staying disabled:", t), this.governor.setKillSwitch(!1);
+      l.debug("Proactive config fetch failed; staying disabled:", t), this.governor.setKillSwitch(!1);
     }
   }
   evaluate() {
     if (this.lastEvaluationAt = Date.now(), typeof document < "u" && document.visibilityState === "hidden" || this.governor.isSlotOccupied()) return;
     const t = this.collector.getSnapshot();
     for (const e of this.options.triggers)
-      if (lt(e.when, t) && this.governor.canFire(e)) {
+      if (Tt(e.when, t) && this.governor.canFire(e)) {
         this.fire(e);
         return;
       }
@@ -618,7 +747,7 @@ var ht = 1e3, ut = "/api/sdk/v1/config", dt = "/api/sdk/v1/proactive/evaluate",
       return;
     }
     this.setReady({
-      id: x(),
+      id: M(),
       triggerId: t.id,
       source: "static",
       message: t.intervene.message,
@@ -629,7 +758,7 @@ var ht = 1e3, ut = "/api/sdk/v1/config", dt = "/api/sdk/v1/proactive/evaluate",
     });
   }
   async evaluateWithAgent(t) {
-    const e = x(), s = {
+    const e = M(), s = {
       client_nudge_id: e,
       trigger_id: t.id,
       goal: t.goal ?? "",
@@ -640,9 +769,9 @@ var ht = 1e3, ut = "/api/sdk/v1/config", dt = "/api/sdk/v1/proactive/evaluate",
     };
     let i;
     try {
-      i = await this.client.getHttp().post(dt, s);
+      i = await this.client.getHttp().post(Dt, s);
     } catch (n) {
-      c.debug("Proactive evaluate failed (treated as no-intervene):", n), this.governor.releaseSlot();
+      l.debug("Proactive evaluate failed (treated as no-intervene):", n), this.governor.releaseSlot();
       return;
     }
     if (!i?.intervene || !i.message) {
@@ -654,7 +783,7 @@ var ht = 1e3, ut = "/api/sdk/v1/config", dt = "/api/sdk/v1/proactive/evaluate",
       triggerId: t.id,
       source: "agent",
       message: i.message,
-      action: ft(i.action),
+      action: Pt(i.action),
       goal: t.goal,
       kickoff: t.kickoff,
       createdAt: /* @__PURE__ */ new Date(),
@@ -690,10 +819,10 @@ var ht = 1e3, ut = "/api/sdk/v1/config", dt = "/api/sdk/v1/proactive/evaluate",
       source: t.source,
       type: "accepted",
       occurredAt: Date.now()
-    }), this.clearActive(t), this.client.emitProactiveEvent("nudge:accepted", { nudge: t }), (t.source === "agent" || t.goal) && (this.lastConversationId ? this.client.sendMessage(pt(t), {
+    }), this.clearActive(t), this.client.emitProactiveEvent("nudge:accepted", { nudge: t }), (t.source === "agent" || t.goal) && (this.lastConversationId ? this.client.sendMessage(Nt(t), {
       hidden: !0,
       conversationId: this.lastConversationId
-    }).catch((e) => c.debug("Nudge kickoff message failed:", e)) : t.kickoff ? this.client.sendMessage(t.kickoff).catch((e) => c.debug("Nudge kickoff message failed:", e)) : c.debug("Nudge accepted with no open conversation and no trigger.kickoff; skipping the chat pre-seed (a hidden message cannot open a conversation).")), t.action && await this.runAction(t.action));
+    }).catch((e) => l.debug("Nudge kickoff message failed:", e)) : t.kickoff ? this.client.sendMessage(t.kickoff).catch((e) => l.debug("Nudge kickoff message failed:", e)) : l.debug("Nudge accepted with no open conversation and no trigger.kickoff; skipping the chat pre-seed (a hidden message cannot open a conversation).")), t.action && await this.runAction(t.action));
   }
   markConverted(t) {
     this.tracker.track({
@@ -711,11 +840,11 @@ var ht = 1e3, ut = "/api/sdk/v1/config", dt = "/api/sdk/v1/proactive/evaluate",
     try {
       "functionName" in t ? await this.client.executeClientFunction(t.functionName, t.arguments ?? {}) : await this.client.executeClientFunction("setPageState", t.setPageState);
     } catch (e) {
-      c.warn("Nudge action failed:", e);
+      l.warn("Nudge action failed:", e);
     }
   }
 };
-function ft(t) {
+function Pt(t) {
   if (t)
     return {
       label: t.label,
@@ -723,13 +852,13 @@ function ft(t) {
       arguments: t.arguments
     };
 }
-function pt(t) {
+function Nt(t) {
   const e = t.goal ? ` Goal: ${t.goal}.` : "";
   return `The user accepted a proactive nudge that said: "${t.message}".${e} Recent friction signals are in the client context (friction_signals). Start helping with this now: briefly explain what you can do and take the first concrete step.`;
 }
-var mt = 5e3, yt = "/api/sdk/v1/proactive/events", vt = class {
+var Mt = 5e3, Ot = "/api/sdk/v1/proactive/events", Ut = class {
   constructor(t) {
-    if (this.queue = [], this.flushTimer = null, this.teardowns = [], this.destroyed = !1, this.post = t.post, this.agent = t.agent, this.flushIntervalMs = t.flushIntervalMs ?? mt, typeof document < "u") {
+    if (this.queue = [], this.flushTimer = null, this.teardowns = [], this.destroyed = !1, this.post = t.post, this.agent = t.agent, this.flushIntervalMs = t.flushIntervalMs ?? Mt, typeof document < "u") {
       const e = () => {
         document.visibilityState === "hidden" && this.flush({ keepalive: !0 });
       };
@@ -756,8 +885,8 @@ var mt = 5e3, yt = "/api/sdk/v1/proactive/events", vt = class {
       ...this.agent ? { agent: this.agent } : {},
       occurred_at: new Date(i.occurredAt).toISOString()
     })) };
-    this.post(yt, s, t).catch((i) => {
-      c.debug("Proactive event batch failed:", i);
+    this.post(Ot, s, t).catch((i) => {
+      l.debug("Proactive event batch failed:", i);
     });
   }
   destroy() {
@@ -767,77 +896,77 @@ var mt = 5e3, yt = "/api/sdk/v1/proactive/events", vt = class {
       this.teardowns = [];
     }
   }
-}, T = "friction_signals";
-function F(t, e) {
-  t.proactive && (c.warn("createAgoProactive: a proactive controller is already attached; replacing it."), t.proactive.destroy());
-  const s = new et({
+}, O = "friction_signals";
+function U(t, e) {
+  t.proactive && (l.warn("createAgoProactive: a proactive controller is already attached; replacing it."), t.proactive.destroy());
+  const s = new St({
     ...e.signals,
     getPageState: () => {
-      const r = t.getContextSnapshot();
-      if (!r) return null;
-      const l = {};
-      for (const [h, u] of Object.entries(r.entries)) h.startsWith("page-state:") && u.data && Object.assign(l, u.data);
-      return Object.keys(l).length > 0 ? l : null;
+      const o = t.getContextSnapshot();
+      if (!o) return null;
+      const a = {};
+      for (const [h, u] of Object.entries(o.entries)) h.startsWith("page-state:") && u.data && Object.assign(a, u.data);
+      return Object.keys(a).length > 0 ? a : null;
     }
   });
-  s.start(), t.addDynamicContext(T, () => {
-    const { pageState: r, ...l } = s.getSnapshot({ pageState: !1 });
+  s.start(), t.addDynamicContext(O, () => {
+    const { pageState: o, ...a } = s.getSnapshot({ pageState: !1 });
     return {
       name: "Friction signals",
       description: "Behavioral friction observed on the current page: dwell/idle times, rage clicks, route bounces, repeated field errors (names and counters only).",
-      data: l
+      data: a
     };
   });
-  const i = new ot({
+  const i = new It({
     frequencyCap: e.frequencyCap,
     storage: e.storage,
     storageKey: e.storageKey
-  }), n = new vt({
-    post: (r, l, h) => t.getHttp().post(r, l, h),
+  }), n = new Ut({
+    post: (o, a, h) => t.getHttp().post(o, a, h),
     agent: t.getConfiguredAgent()
-  }), o = new gt({
+  }), r = new $t({
     client: t,
     collector: s,
     governor: i,
     tracker: n,
     options: e
   });
-  o.start();
-  const a = {
+  r.start();
+  const c = {
     optOut: () => i.optOut(),
     optIn: () => i.optIn(),
     isOptedOut: () => i.isOptedOut(),
-    setEngaged: (r) => i.setEngaged(r),
-    signalFieldError: (r) => s.signalFieldError(r),
+    setEngaged: (o) => i.setEngaged(o),
+    signalFieldError: (o) => s.signalFieldError(o),
     getSignalsSnapshot: () => s.getSnapshot(),
-    getActiveNudge: () => o.getActiveNudge(),
-    shown: (r) => o.shown(r),
-    accept: (r) => o.accept(r),
-    dismiss: (r) => o.dismiss(r),
-    markConverted: (r) => o.markConverted(r),
+    getActiveNudge: () => r.getActiveNudge(),
+    shown: (o) => r.shown(o),
+    accept: (o) => r.accept(o),
+    dismiss: (o) => r.dismiss(o),
+    markConverted: (o) => r.markConverted(o),
     destroy: () => {
-      o.stop(), n.destroy(), s.destroy(), t.removeDynamicContext(T), t.proactive === a && (t.proactive = null);
+      r.stop(), n.destroy(), s.destroy(), t.removeDynamicContext(O), t.proactive === c && (t.proactive = null);
     }
   };
-  return t.proactive = a, a;
+  return t.proactive = c, c;
 }
-var wt = class {
+var Lt = class {
   constructor() {
     this.entries = /* @__PURE__ */ new Map(), this.dynamicProviders = /* @__PURE__ */ new Map();
   }
   set(t, e) {
-    this.entries.set(t, e), c.log(`ClientContext set: ${t}`);
+    this.entries.set(t, e), l.log(`ClientContext set: ${t}`);
   }
   remove(t) {
     const e = this.entries.delete(t);
-    return e && c.log(`ClientContext removed: ${t}`), e;
+    return e && l.log(`ClientContext removed: ${t}`), e;
   }
   addDynamicProvider(t, e) {
-    this.dynamicProviders.set(t, e), c.log(`DynamicContext provider added: ${t}`);
+    this.dynamicProviders.set(t, e), l.log(`DynamicContext provider added: ${t}`);
   }
   removeDynamicProvider(t) {
     const e = this.dynamicProviders.delete(t);
-    return e && c.log(`DynamicContext provider removed: ${t}`), e;
+    return e && l.log(`DynamicContext provider removed: ${t}`), e;
   }
   getSnapshot() {
     if (this.entries.size === 0 && this.dynamicProviders.size === 0) return null;
@@ -847,66 +976,68 @@ var wt = class {
       const i = s();
       i && (t[e] = i);
     } catch (i) {
-      c.error(`DynamicContext provider "${e}" threw:`, i);
+      l.error(`DynamicContext provider "${e}" threw:`, i);
     }
     return Object.keys(t).length === 0 ? null : { entries: t };
   }
   clear() {
-    this.entries.clear(), this.dynamicProviders.clear(), c.log("ClientContext cleared");
+    this.entries.clear(), this.dynamicProviders.clear(), l.log("ClientContext cleared");
   }
-}, Ct = "page-state:";
-function St(t) {
+}, jt = "page-state:";
+function Bt(t) {
   const e = {};
-  for (const [s, i] of Object.entries(t)) s.startsWith(Ct) && i.data && Object.assign(e, i.data);
+  for (const [s, i] of Object.entries(t)) s.startsWith(jt) && i.data && Object.assign(e, i.data);
   return e;
 }
-function At(t) {
+function qt(t) {
   const e = t["current-page"]?.data;
   return e?.page ? e.page : e?.url ? e.url : t["browser-page"]?.data?.url;
 }
-function Et(t, e) {
+function Gt(t, e) {
   return t === e ? !0 : JSON.stringify(t) === JSON.stringify(e);
 }
-function _t(t, e) {
+function Kt(t, e) {
   const s = [];
   for (const i of Object.keys(e))
-    i in t && (Et(t[i], e[i]) || s.push({
+    i in t && (Gt(t[i], e[i]) || s.push({
       field: i,
       from: t[i],
       to: e[i]
     }));
   return s;
 }
-function bt(t, e) {
-  const s = St(e), i = At(e);
+function Wt(t, e) {
+  const s = Bt(e), i = qt(e);
   return {
-    changes: t && t.page === i ? _t(t.state, s) : [],
+    changes: t && t.page === i ? Kt(t.state, s) : [],
     baseline: {
       page: i,
       state: s
     }
   };
 }
-function _(t) {
-  return t === null || typeof t != "object" ? JSON.stringify(t) ?? "null" : Array.isArray(t) ? `[${t.map(_).join(",")}]` : `{${Object.keys(t).sort().map((e) => `${JSON.stringify(e)}:${_(t[e])}`).join(",")}}`;
+function T(t) {
+  return t === null || typeof t != "object" ? JSON.stringify(t) ?? "null" : Array.isArray(t) ? `[${t.map(T).join(",")}]` : `{${Object.keys(t).sort().map((e) => `${JSON.stringify(e)}:${T(t[e])}`).join(",")}}`;
 }
-var kt = class {
-  constructor(t) {
-    this.callbacks = t, this.buffer = "", this.message = {}, this.toolCalls = [], this.sources = [], this.followUpReplies = [], this.isFirstChunk = !0, this.answerCompleteEmitted = !1, this.waitingClientEmitted = !1, this.firedClientFunctions = /* @__PURE__ */ new Set();
+var L = "", Ht = class {
+  constructor(t, e = {}) {
+    this.callbacks = t, this.options = e, this.buffer = "", this.message = {}, this.toolCalls = [], this.sources = [], this.followUpReplies = [], this.isFirstChunk = !0, this.answerCompleteEmitted = !1, this.waitingClientEmitted = !1, this.firedClientFunctions = /* @__PURE__ */ new Map();
   }
   async processStream(t) {
-    if (!t.body) throw new k("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 (!t.body) throw new F("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 e = t.body.getReader(), s = new TextDecoder();
     try {
       for (; ; ) {
         const { done: i, value: n } = await e.read();
         if (i) break;
-        const o = s.decode(n, { stream: !0 });
-        this.buffer += o, this.processBuffer();
+        const r = s.decode(n, { stream: !0 });
+        this.buffer += r, this.processBuffer();
       }
       return this.buffer.trim() && this.processBuffer(), this.buildFinalMessage();
     } catch (i) {
-      const n = i instanceof Error ? i : new k("Stream processing failed mid-flight. The connection may have dropped; retry the message.");
+      if (this.options.signal?.aborted)
+        return this.message.status = "CANCELED", this.buildFinalMessage();
+      const n = i instanceof Error ? i : new F("Stream processing failed mid-flight. The connection may have dropped; retry the message.");
       throw this.callbacks.onError?.(n), n;
     } finally {
       e.releaseLock();
@@ -925,10 +1056,10 @@ var kt = class {
         if (!i.startsWith(": ") && i.startsWith("data: ")) {
           const n = i.slice(6);
           try {
-            const o = JSON.parse(n);
-            this.handleChunk(o);
-          } catch (o) {
-            c.warn("Failed to parse SSE data:", n, o);
+            const r = JSON.parse(n);
+            this.handleChunk(r);
+          } catch (r) {
+            l.warn("Failed to parse SSE data:", n, r);
           }
         }
     }
@@ -956,13 +1087,14 @@ var kt = class {
         url: s.use_external_link ? s.external_link_url : s.internal_link_url
       };
     })), t.type === "client_function" && t.function_name) {
-      const e = `${t.function_name}::${_(t.arguments ?? {})}`;
-      this.firedClientFunctions.has(e) || (this.firedClientFunctions.add(e), this.callbacks.onClientFunction?.({
-        invocationId: t.id || "",
+      const e = `${t.function_name}::${T(t.arguments ?? {})}`, s = t.id || "", i = this.firedClientFunctions.get(e);
+      let n = !1;
+      i ? s && !i.has(s) && (i.has(L) ? (i.delete(L), i.add(s)) : (i.add(s), n = !0)) : (this.firedClientFunctions.set(e, /* @__PURE__ */ new Set([s])), n = !0), n && this.callbacks.onClientFunction?.({
+        invocationId: s,
         functionName: t.function_name,
         arguments: t.arguments || {},
         conversationId: this.message.conversationId || ""
-      }));
+      });
     }
     if (t.tool_call_data && t.type && t.type !== "client_function") {
       const e = this.parseToolCall(t);
@@ -1009,11 +1141,11 @@ var kt = class {
     return t.status !== "WAITING_CLIENT" && this.callbacks.onComplete?.(t), t;
   }
 };
-function Mt(t) {
+function ne(t) {
   const e = t.message.toLowerCase();
   return e.includes("load failed") || e.includes("failed to fetch") || e.includes("network") || e.includes("abort");
 }
-var Rt = /* @__PURE__ */ new Set([
+var Jt = /* @__PURE__ */ new Set([
   "image/jpeg",
   "image/png",
   "image/gif",
@@ -1021,7 +1153,7 @@ var Rt = /* @__PURE__ */ new Set([
   "image/bmp",
   "image/tiff"
 ]);
-function It(t) {
+function zt(t) {
   if (!t) return;
   const e = typeof window < "u" && window.location ? window.location.href : "https://ago.local/";
   try {
@@ -1030,16 +1162,16 @@ function It(t) {
   } catch {
   }
 }
-function Lt(t) {
-  return t.isSafeImage === !0 && typeof t.contentType == "string" && t.contentType.startsWith("image/") && It(t.url) !== void 0;
+function re(t) {
+  return t.isSafeImage === !0 && typeof t.contentType == "string" && t.contentType.startsWith("image/") && zt(t.url) !== void 0;
 }
-function jt(t) {
+function oe(t) {
   if (t == null || t < 0) return "";
   if (t < 1024) return `${t} B`;
   const e = t / 1024;
   return e < 1024 ? `${e.toFixed(1)} KB` : `${(e / 1024).toFixed(1)} MB`;
 }
-function xt(t) {
+function Xt(t) {
   return {
     id: String(t.id ?? ""),
     name: typeof t.name == "string" && t.name ? t.name : "file",
@@ -1049,17 +1181,17 @@ function xt(t) {
     isSafeImage: t.is_safe_image === !0
   };
 }
-function Bt(t) {
+function ae(t) {
   return t.map((e, s) => ({
     id: `local-${s}-${e.name}`,
     name: e.name,
     contentType: e.type || void 0,
     fileSize: e.size,
     url: typeof URL < "u" && URL.createObjectURL ? URL.createObjectURL(e) : void 0,
-    isSafeImage: Rt.has(e.type)
+    isSafeImage: Jt.has(e.type)
   }));
 }
-var Tt = class {
+var Yt = class {
   constructor() {
     this.handlers = /* @__PURE__ */ new Map();
   }
@@ -1089,113 +1221,205 @@ var Tt = class {
   waitFor(t, e) {
     return new Promise((s, i) => {
       let n;
-      const o = ((a) => {
-        n && clearTimeout(n), s(a);
+      const r = ((c) => {
+        n && clearTimeout(n), s(c);
       });
-      this.once(t, o), e?.timeout && (n = setTimeout(() => {
-        this.off(t, o), i(/* @__PURE__ */ new Error(`waitFor("${String(t)}") timed out after ${e.timeout}ms`));
+      this.once(t, r), e?.timeout && (n = setTimeout(() => {
+        this.off(t, r), i(/* @__PURE__ */ new Error(`waitFor("${String(t)}") timed out after ${e.timeout}ms`));
       }, e.timeout));
     });
   }
   removeAllListeners(t) {
     t ? this.handlers.delete(t) : this.handlers.clear();
   }
-}, $ = '`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).', Ft = /^[a-z][a-z0-9+.-]*:\/\//i, N = !1;
-function D(t, e = "AgoClient") {
-  if (typeof t != "object" || t === null) throw new g(`${e}: ${$}`, "config_missing_base_url");
+}, j = '`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).', Vt = /^[a-z][a-z0-9+.-]*:\/\//i, B = !1;
+function q(t, e = "AgoClient") {
+  if (typeof t != "object" || t === null) throw new g(`${e}: ${j}`, "config_missing_base_url");
   const s = t.baseUrl;
-  if (typeof s != "string" || s.trim() === "") throw new g(`${e}: ${$}`, "config_missing_base_url");
-  !s.startsWith("/") && !Ft.test(s) && (N || (N = !0, console.warn(`[AGO] ${e}: \`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 g(`${e}: ${j}`, "config_missing_base_url");
+  !s.startsWith("/") && !Vt.test(s) && (B || (B = !0, console.warn(`[AGO] ${e}: \`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 $t(t) {
+function Qt(t) {
   return t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function S(t) {
+function E(t) {
   return t.split("/").filter((e) => e.startsWith(":")).map((e) => e.slice(1));
 }
-function Nt(t, e) {
+function Zt(t, e) {
   const s = [];
   return {
     path: t.split("/").map((i) => {
       if (!i.startsWith(":")) return i;
-      const n = i.slice(1), o = e[n];
-      return o == null || o === "" ? (s.push(n), i) : encodeURIComponent(String(o));
+      const n = i.slice(1), r = e[n];
+      return r == null || r === "" ? (s.push(n), i) : encodeURIComponent(String(r));
     }).join("/"),
     missing: s
   };
 }
-function Dt(t, e) {
+function te(t, e) {
   const s = e.find((n) => n.path === t);
   if (s) return s;
   const i = e.find((n) => {
     if (!n.path.includes(":")) return !1;
-    const o = "^" + n.path.split("/").map((a) => a.startsWith(":") ? "[^/]+" : $t(a)).join("/") + "/?$";
-    return new RegExp(o).test(t);
+    const r = "^" + n.path.split("/").map((c) => c.startsWith(":") ? "[^/]+" : Qt(c)).join("/") + "/?$";
+    return new RegExp(r).test(t);
   });
-  return i || e.filter((n) => n.path !== "/" && t.startsWith(n.path)).sort((n, o) => o.path.length - n.path.length)[0];
+  return i || e.filter((n) => n.path !== "/" && t.startsWith(n.path)).sort((n, r) => r.path.length - n.path.length)[0];
+}
+var ee = "activity:recent", se = "state:delta";
+function G(t) {
+  return t === "setPageState" ? "readPageData" : `read${t.charAt(0).toUpperCase()}${t.slice(1)}Data`;
 }
-var Pt = "activity:recent", Ot = "state:delta", Gt = class U {
+var ce = class H {
   constructor(e) {
-    this.lastSentPageState = null, this.warnedEmptyConversations = /* @__PURE__ */ new Set(), this.pendingResumes = /* @__PURE__ */ new Map(), this.pendingApprovals = /* @__PURE__ */ new Map(), this.resumeGate = null, this.proactive = null, D(e, "AgoClient"), this.config = e, this.activityLedger = new j(e.maxActivityEntries), this.httpClient = new K(e), this.functionRegistry = new z({ maxResultBytes: e.maxFunctionResultBytes }), this.contextRegistry = new wt(), this.eventEmitter = new Tt(), this.registerActivityContext(), e.debug && c.enable(), e.proactive && F(this, e.proactive), c.log("AgoClient initialized");
+    this.lastSentPageState = null, this.warnedEmptyConversations = /* @__PURE__ */ new Set(), this.warnedPageDataPlaceholder = !1, this.pageDataCompanions = /* @__PURE__ */ new Set(), this.pendingResumes = /* @__PURE__ */ new Map(), this.pendingApprovals = /* @__PURE__ */ new Map(), this.resumeGate = null, this.activeTurn = null, this.pausedTurn = null, this.stoppedTurnIds = /* @__PURE__ */ new Set(), this.proactive = null, q(e, "AgoClient"), this.config = e, this.activityLedger = new X(e.maxActivityEntries), this.httpClient = new Q(e), this.functionRegistry = new st({ maxResultBytes: e.maxFunctionResultBytes }), this.contextRegistry = new Lt(), this.eventEmitter = new Yt(), this.registerActivityContext(), e.debug && l.enable(), e.proactive && U(this, e.proactive), l.log("AgoClient initialized");
   }
   async sendMessage(e, s) {
-    const i = this.functionRegistry.getSchemas(), n = this.buildSendContext(), o = this.config.agent || this.config.defaultAgentId, a = this.resolveClientFunctionsMode(s), r = {
+    const i = this.functionRegistry.getSchemas(), n = this.buildSendContext(), r = this.config.agent || this.config.defaultAgentId, c = this.resolveClientFunctionsMode(s), o = {
       content: e,
       conversation_id: s?.conversationId,
-      agent_id: s?.agentId || o
+      agent_id: s?.agentId || r
     };
-    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 l;
+    i.length > 0 && (o.client_functions = i, c === "pause" && (o.client_functions_mode = c)), n && (o.client_context = n), s?.hidden && (o.hidden = !0);
+    const a = this.beginTurn();
+    let h;
     if (s?.files && s.files.length > 0) {
-      const h = new FormData();
-      h.append("content", e), s.conversationId && h.append("conversation_id", s.conversationId), (s.agentId || o) && h.append("agent_id", s.agentId || o || ""), i.length > 0 && (h.append("client_functions", JSON.stringify(i)), a === "pause" && h.append("client_functions_mode", a)), n && h.append("client_context", JSON.stringify(n)), s.hidden && h.append("hidden", "true");
-      for (const u of s.files) h.append("files", u);
-      l = await this.httpClient.postFormData("/api/sdk/v1/messages", h);
-    } else l = await this.httpClient.postStream("/api/sdk/v1/messages", r);
-    return this.processSSEResponse(l);
-  }
-  async processSSEResponse(e) {
-    let s = !1;
-    const i = await new kt({
-      onRawChunk: (n) => {
-        this.eventEmitter.emit("stream:message", n);
+      const u = new FormData();
+      u.append("content", e), s.conversationId && u.append("conversation_id", s.conversationId), (s.agentId || r) && u.append("agent_id", s.agentId || r || ""), i.length > 0 && (u.append("client_functions", JSON.stringify(i)), c === "pause" && u.append("client_functions_mode", c)), n && u.append("client_context", JSON.stringify(n)), s.hidden && u.append("hidden", "true");
+      for (const d of s.files) u.append("files", d);
+      h = await this.sendRequest(a, () => this.httpClient.postFormData("/api/sdk/v1/messages", u, { signal: a.controller.signal }));
+    } else h = await this.sendRequest(a, () => this.httpClient.postStream("/api/sdk/v1/messages", o, { signal: a.controller.signal }));
+    return h ? this.processSSEResponse(h, a) : this.buildStoppedMessage(a);
+  }
+  async sendRequest(e, s) {
+    try {
+      return await s();
+    } catch (i) {
+      if (this.endTurn(e), _(i)) return null;
+      throw i;
+    }
+  }
+  async processSSEResponse(e, s) {
+    let i = !1;
+    const n = new Ht({
+      onRawChunk: (r) => {
+        s && (r.message_id && !s.messageId && (s.messageId = r.message_id), r.thread?.id && (s.conversationId = r.thread.id)), this.eventEmitter.emit("stream:message", r);
       },
-      onStart: (n) => {
-        this.eventEmitter.emit("message:start", n);
+      onStart: (r) => {
+        this.eventEmitter.emit("message:start", r);
       },
-      onChunk: (n) => {
-        this.eventEmitter.emit("message:chunk", n);
+      onChunk: (r) => {
+        this.eventEmitter.emit("message:chunk", r);
       },
-      onToolCall: (n) => {
-        this.eventEmitter.emit("toolCall:received", n), n.type === "form" && this.eventEmitter.emit("toolCall:form", n);
+      onToolCall: (r) => {
+        this.eventEmitter.emit("toolCall:received", r), r.type === "form" && this.eventEmitter.emit("toolCall:form", r);
       },
-      onClientFunction: async (n) => {
-        if (s = !0, this.eventEmitter.emit("function:invoke", n), this.recordAgentAction(n), n.invocationId && this.requiresApproval(n)) {
-          this.pendingApprovals.set(n.invocationId, n), this.eventEmitter.emit("function:awaiting-approval", n);
+      onClientFunction: async (r) => {
+        if (i = !0, this.eventEmitter.emit("function:invoke", r), this.recordAgentAction(r), r.invocationId && this.requiresApproval(r)) {
+          this.pendingApprovals.set(r.invocationId, r), this.eventEmitter.emit("function:awaiting-approval", r);
           return;
         }
-        await this.handleClientFunctionInvocation(n);
+        await this.handleClientFunctionInvocation(r);
       },
-      onTitle: (n) => {
-        this.eventEmitter.emit("conversation:title", n);
+      onTitle: (r) => {
+        this.eventEmitter.emit("conversation:title", r);
       },
-      onAnswerComplete: (n) => {
-        this.eventEmitter.emit("message:answer-complete", n);
+      onAnswerComplete: (r) => {
+        this.eventEmitter.emit("message:answer-complete", r);
       },
-      onWaitingClient: (n) => {
-        this.eventEmitter.emit("message:waiting-client", n), this.markResumeSignal(n.messageId, n.conversationId, "waitingConfirmed");
+      onWaitingClient: (r) => {
+        this.pausedTurn = {
+          messageId: r.messageId,
+          conversationId: r.conversationId
+        }, this.eventEmitter.emit("message:waiting-client", r), this.markResumeSignal(r.messageId, r.conversationId, "waitingConfirmed");
       },
-      onComplete: (n) => {
-        this.eventEmitter.emit("message:complete", n);
+      onComplete: (r) => {
+        s?.stopRequested && !r.id || this.eventEmitter.emit("message:complete", r);
       },
-      onError: (n) => {
+      onError: (r) => {
         this.eventEmitter.emit("message:error", {
-          error: n.message,
-          code: n instanceof g ? n.code : void 0
+          error: r.message,
+          code: r instanceof g ? r.code : void 0
         });
       }
-    }).processStream(e);
-    return i.status !== "WAITING_CLIENT" && this.maybeFlagEmptyReply(i, s), i;
+    }, { signal: s?.controller.signal });
+    try {
+      const r = await n.processStream(e);
+      return s?.stopRequested && (this.postStopForTurn(s, s.messageId ?? r.id), this.eventEmitter.emit("message:stopped", {
+        conversationId: s.conversationId ?? r.conversationId ?? "",
+        messageId: s.messageId ?? r.id ?? ""
+      })), r.status !== "WAITING_CLIENT" && this.maybeFlagEmptyReply(r, i), r;
+    } finally {
+      s && this.endTurn(s);
+    }
+  }
+  async stop() {
+    const e = this.activeTurn;
+    if (e) {
+      e.stopRequested = !0;
+      const n = e.messageId;
+      return e.controller.abort(), n ? this.postStopForTurn(e, n) : null;
+    }
+    const s = this.pausedTurn;
+    if (!s) return null;
+    this.pausedTurn = null, this.pendingResumes.delete(s.messageId), this.stoppedTurnIds.add(s.messageId);
+    let i = null;
+    try {
+      i = await this.stopMessage(s.messageId);
+    } catch (n) {
+      l.warn("Failed to stop the paused turn:", n);
+    }
+    return this.eventEmitter.emit("message:stopped", {
+      conversationId: s.conversationId,
+      messageId: s.messageId
+    }), i;
+  }
+  async stopMessage(e) {
+    const s = await this.httpClient.post(`/api/sdk/v1/messages/${e}/stop`);
+    return {
+      status: s.status,
+      messageStatus: s.message_status
+    };
+  }
+  isGenerating() {
+    return this.activeTurn !== null || this.pausedTurn !== null;
+  }
+  beginTurn() {
+    this.pausedTurn = null;
+    const e = {
+      controller: new AbortController(),
+      messageId: null,
+      conversationId: null,
+      stopRequested: !1,
+      stopPosted: !1
+    };
+    return this.activeTurn = e, e;
+  }
+  endTurn(e) {
+    this.activeTurn === e && (this.activeTurn = null);
+  }
+  async postStopForTurn(e, s) {
+    if (!s || e.stopPosted) return null;
+    e.stopPosted = !0;
+    try {
+      return await this.stopMessage(s);
+    } catch (i) {
+      return l.warn("Failed to stop the turn server-side:", i), null;
+    }
+  }
+  buildStoppedMessage(e) {
+    const s = {
+      id: e.messageId ?? "",
+      conversationId: e.conversationId ?? "",
+      content: "",
+      role: "assistant",
+      status: "CANCELED",
+      createdAt: /* @__PURE__ */ new Date()
+    };
+    return s.id && this.eventEmitter.emit("message:complete", s), this.eventEmitter.emit("message:stopped", {
+      conversationId: s.conversationId,
+      messageId: s.id
+    }), s;
   }
   resolveClientFunctionsMode(e) {
     return e?.clientFunctionsMode ?? this.config.clientFunctionsMode ?? "pause";
@@ -1208,8 +1432,10 @@ var Pt = "activity:recent", Ot = "state:delta", Gt = class U {
   async continueMessage(e) {
     const s = this.functionRegistry.getSchemas(), i = this.buildSendContext(), n = {};
     s.length > 0 && (n.client_functions = s), i && (n.client_context = i);
-    const o = await this.httpClient.postStream(`/api/sdk/v1/messages/${e}/continue`, n);
-    return this.processSSEResponse(o);
+    const r = this.beginTurn();
+    r.messageId = e;
+    const c = await this.sendRequest(r, () => this.httpClient.postStream(`/api/sdk/v1/messages/${e}/continue`, n, { signal: r.controller.signal }));
+    return c ? this.processSSEResponse(c, r) : this.buildStoppedMessage(r);
   }
   markResumeSignal(e, s, i) {
     if (!e) return;
@@ -1228,14 +1454,14 @@ var Pt = "activity:recent", Ot = "state:delta", Gt = class U {
         messageId: e
       });
     } catch (i) {
-      c.warn("Resume gate threw; resuming anyway:", i);
-    }
-    this.pendingResumes.delete(e);
-    try {
-      await this.continueMessage(e);
-    } catch (i) {
-      c.warn("Auto-resume of paused turn failed:", i);
+      l.warn("Resume gate threw; resuming anyway:", i);
     }
+    if (this.pendingResumes.delete(e), !this.stoppedTurnIds.delete(e))
+      try {
+        await this.continueMessage(e);
+      } catch (i) {
+        l.warn("Auto-resume of paused turn failed:", i);
+      }
   }
   maybeFlagEmptyReply(e, s) {
     e.status === "DONE" && (e.content ?? "").trim() === "" && !s && !(e.toolCalls && e.toolCalls.length > 0) && !(e.followUpReplies && e.followUpReplies.length > 0) && setTimeout(() => {
@@ -1255,7 +1481,7 @@ var Pt = "activity:recent", Ot = "state:delta", Gt = class U {
     try {
       s = await this.functionRegistry.execute(e.functionName, e.arguments);
     } catch (n) {
-      i = n instanceof Error ? n.message : "Unknown error", c.error("Client function execution failed:", n);
+      i = n instanceof Error ? n.message : "Unknown error", l.error("Client function execution failed:", n);
     }
     if (e.invocationId) try {
       const n = await this.submitToolCallForm(e.invocationId, {
@@ -1265,7 +1491,7 @@ var Pt = "activity:recent", Ot = "state:delta", Gt = class U {
       });
       n?.resume?.ready && this.markResumeSignal(n.resume.message_id, e.conversationId, "resultsReady");
     } catch (n) {
-      c.error("Failed to submit function result:", n);
+      l.error("Failed to submit function result:", n);
     }
     this.eventEmitter.emit("function:result", {
       invocationId: e.invocationId,
@@ -1278,7 +1504,7 @@ var Pt = "activity:recent", Ot = "state:delta", Gt = class U {
     if (s) try {
       if (s(e)) return !0;
     } catch (i) {
-      c.warn("approvalPolicy threw; not gating this call:", i);
+      l.warn("approvalPolicy threw; not gating this call:", i);
     }
     return this.functionRegistry.get(e.functionName)?.requiresApproval === !0;
   }
@@ -1301,7 +1527,7 @@ var Pt = "activity:recent", Ot = "state:delta", Gt = class U {
       });
       n?.resume?.ready && this.markResumeSignal(n.resume.message_id, s.conversationId, "resultsReady");
     } catch (n) {
-      c.error("Failed to submit function rejection:", n);
+      l.error("Failed to submit function rejection:", n);
     }
     this.eventEmitter.emit("function:result", {
       invocationId: e,
@@ -1311,15 +1537,15 @@ var Pt = "activity:recent", Ot = "state:delta", Gt = class U {
   async getConversations(e) {
     const s = new URLSearchParams();
     e?.page !== void 0 && s.set("page", String(e.page)), e?.pageSize !== void 0 && s.set("page_size", String(e.pageSize));
-    const i = s.toString(), n = await this.httpClient.get(`/api/sdk/v1/conversations${i ? `?${i}` : ""}`), o = (Array.isArray(n.data) ? n.data : []).map((a) => ({
-      id: String(a.id),
-      title: a.title ?? "",
-      lastMessageDate: new Date(a.last_message_at ?? a.created_at ?? 0)
+    const i = s.toString(), n = await this.httpClient.get(`/api/sdk/v1/conversations${i ? `?${i}` : ""}`), r = (Array.isArray(n.data) ? n.data : []).map((c) => ({
+      id: String(c.id),
+      title: c.title ?? "",
+      lastMessageDate: new Date(c.last_message_at ?? c.created_at ?? 0)
     }));
     return {
-      data: o,
+      data: r,
       hasMore: n.has_more ?? !1,
-      total: n.total ?? o.length
+      total: n.total ?? r.length
     };
   }
   async getConversation(e) {
@@ -1335,8 +1561,8 @@ var Pt = "activity:recent", Ot = "state:delta", Gt = class U {
         status: n.status,
         createdAt: new Date(n.created_at),
         hidden: n.hidden,
-        toolCalls: U.mapPersistedToolCalls(n.tool_call_data),
-        attachments: n.attachments && n.attachments.length > 0 ? n.attachments.map(xt) : void 0,
+        toolCalls: H.mapPersistedToolCalls(n.tool_call_data),
+        attachments: n.attachments && n.attachments.length > 0 ? n.attachments.map(Xt) : void 0,
         followUpReplies: n.follow_up_replies && n.follow_up_replies.length > 0 ? n.follow_up_replies : void 0
       }))
     };
@@ -1361,36 +1587,41 @@ var Pt = "activity:recent", Ot = "state:delta", Gt = class U {
     return (await this.getConversation(e)).messages || [];
   }
   async resumePendingClientFunctions(e) {
-    const s = [...e.messages ?? []].reverse().find((r) => r.role === "assistant" && r.status === "WAITING_CLIENT");
+    const s = [...e.messages ?? []].reverse().find((o) => o.role === "assistant" && o.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 c.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) {
-      const l = {
-        invocationId: r.id,
-        functionName: r.functionName,
-        arguments: r.arguments ?? {},
+    const i = (s.toolCalls ?? []).filter((o) => o.type === "client_function" && o.status === "waiting_input" && o.functionName), n = new Set(this.functionRegistry.getSchemas().map((o) => o.name)), r = i.filter((o) => !n.has(o.functionName));
+    if (r.length > 0)
+      return l.warn("Cannot resume paused turn: function(s) not registered on this page:", r.map((o) => o.functionName)), null;
+    let c = i.length === 0;
+    for (const o of i) {
+      const a = {
+        invocationId: o.id,
+        functionName: o.functionName,
+        arguments: o.arguments ?? {},
         conversationId: e.id
       };
-      if (this.requiresApproval(l)) {
-        this.pendingApprovals.set(r.id, l), this.markResumeSignal(s.id, e.id, "waitingConfirmed"), this.eventEmitter.emit("function:awaiting-approval", l), a = !1;
+      if (this.requiresApproval(a)) {
+        this.pendingApprovals.set(o.id, a), this.markResumeSignal(s.id, e.id, "waitingConfirmed"), this.eventEmitter.emit("function:awaiting-approval", a), c = !1;
         continue;
       }
+      this.eventEmitter.emit("function:invoke", a);
       let h, u;
       try {
-        h = await this.functionRegistry.execute(r.functionName, r.arguments ?? {});
+        h = await this.functionRegistry.execute(o.functionName, o.arguments ?? {});
       } catch (d) {
-        u = d instanceof Error ? d.message : "Unknown error", c.error("Client function execution failed:", d);
+        u = d instanceof Error ? d.message : "Unknown error", l.error("Client function execution failed:", d);
       }
-      a = (await this.submitToolCallForm(r.id, {
+      this.eventEmitter.emit("function:result", {
+        invocationId: o.id,
+        result: h,
+        error: u
+      }), c = (await this.submitToolCallForm(o.id, {
         result: h,
         error: u,
         _type: "client_function_result"
-      }))?.resume?.ready ?? a;
+      }))?.resume?.ready ?? c;
     }
-    return a ? this.continueMessage(s.id) : null;
+    return c ? this.continueMessage(s.id) : null;
   }
   async submitToolCallForm(e, s) {
     return this.httpClient.post(`/api/sdk/v1/tool-calls/${e}/submit`, { formData: s });
@@ -1436,65 +1667,65 @@ var Pt = "activity:recent", Ot = "state:delta", Gt = class U {
     return this.functionRegistry.execute(e, s);
   }
   registerNavigationFunction(e, s) {
-    const i = s.map((r) => r.name), n = s.map((r) => {
-      const l = S(r.path), h = l.length > 0 ? ` (requires ${l.map((u) => `"${u}"`).join(", ")})` : "";
-      return `- "${r.name}"${h}: ${r.description}`;
+    const i = s.map((o) => o.name), n = s.map((o) => {
+      const a = E(o.path), h = a.length > 0 ? ` (requires ${a.map((u) => `"${u}"`).join(", ")})` : "";
+      return `- "${o.name}"${h}: ${o.description}`;
     }).join(`
-`), o = /* @__PURE__ */ new Map();
-    for (const r of s) for (const l of S(r.path)) o.set(l, [...o.get(l) ?? [], r.name]);
-    const a = { page: {
+`), r = /* @__PURE__ */ new Map();
+    for (const o of s) for (const a of E(o.path)) r.set(a, [...r.get(a) ?? [], o.name]);
+    const c = { page: {
       type: "string",
       description: "The page to navigate to",
       enum: i
     } };
-    for (const [r, l] of o) {
-      if (r === "page") {
-        c.error('registerNavigationFunction: a ":page" placeholder collides with the "page" argument and is ignored. Rename the placeholder.');
+    for (const [o, a] of r) {
+      if (o === "page") {
+        l.error('registerNavigationFunction: a ":page" placeholder collides with the "page" argument and is ignored. Rename the placeholder.');
         continue;
       }
-      a[r] = {
+      c[o] = {
         type: "string",
-        description: `Value for ":${r}" in the page path. Required when page is ${l.map((h) => `"${h}"`).join(" or ")}.`
+        description: `Value for ":${o}" in the page path. Required when page is ${a.map((h) => `"${h}"`).join(" or ")}.`
       };
     }
-    this.registerFunction("navigateToPage", async (r) => {
-      const l = r.page, h = s.find((f) => f.name === l);
+    this.registerFunction("navigateToPage", async (o) => {
+      const a = o.page, h = s.find((p) => p.name === a);
       if (!h) return {
         success: !1,
-        error: `Unknown page: ${l}`
+        error: `Unknown page: ${a}`
       };
       let u = {};
-      if (typeof r.params == "string") try {
-        u = JSON.parse(r.params);
+      if (typeof o.params == "string") try {
+        u = JSON.parse(o.params);
       } catch {
       }
-      else r.params && typeof r.params == "object" && (u = r.params);
+      else o.params && typeof o.params == "object" && (u = o.params);
       const d = {};
-      for (const f of S(h.path)) d[f] = r[f] ?? u[f];
-      const { path: m, missing: y } = Nt(h.path, d);
-      if (y.length > 0) {
-        const f = y.map((v) => `"${v}": "..."`).join(", ");
+      for (const p of E(h.path)) d[p] = o[p] ?? u[p];
+      const { path: f, missing: w } = Zt(h.path, d);
+      if (w.length > 0) {
+        const p = w.map((C) => `"${C}": "..."`).join(", ");
         return {
           success: !1,
-          error: `Page "${l}" needs ${y.map((v) => `"${v}"`).join(", ")}. Retry with { "page": "${l}", ${f} }.`
+          error: `Page "${a}" needs ${w.map((C) => `"${C}"`).join(", ")}. Retry with { "page": "${a}", ${p} }.`
         };
       }
-      return e(m), {
+      return e(f), {
         success: !0,
-        navigatedTo: m
+        navigatedTo: f
       };
     }, {
       description: `Navigate the user to a page in the application. Available pages:
 ${n}`,
       parameters: {
         type: "object",
-        properties: a,
+        properties: c,
         required: ["page"]
       }
     }), this.addDynamicContext("current-page", () => {
       if (typeof window > "u" || !window.location) return null;
-      const r = window.location.href, l = typeof document < "u" ? document.title : void 0, h = Dt(window.location.pathname, s), u = { url: r };
-      return h && (u.page = h.name), l && (u.title = l), {
+      const o = window.location.href, a = typeof document < "u" ? document.title : void 0, h = te(window.location.pathname, s), u = { url: o };
+      return h && (u.page = h.name), a && (u.title = a), {
         name: "Current page",
         description: "The page the user is currently viewing.",
         data: u
@@ -1505,22 +1736,30 @@ ${n}`,
     this.unregisterFunction("navigateToPage"), this.removeDynamicContext("current-page");
   }
   registerPageStateFunction(e, s) {
-    const i = s?.functionName ?? "setPageState", n = new Map(e.map((a) => [a.name, a])), o = e.map((a) => `- "${a.name}": ${a.description}`).join(`
+    const i = s?.functionName ?? "setPageState", n = new Map(e.map((a) => [a.name, a])), r = s?.data, c = e.map((a) => `- "${a.name}": ${a.description}`).join(`
 `);
     this.registerFunction(i, async (a) => {
-      const r = {};
-      for (const [l, h] of Object.entries(a)) {
-        if (h === void 0) continue;
-        const u = n.get(l);
-        u && (await u.set(h), r[l] = h);
+      const h = {};
+      for (const [u, d] of Object.entries(a)) {
+        if (d === void 0) continue;
+        const f = n.get(u);
+        f && (await f.set(d), h[u] = d);
       }
-      return {
+      return r ? {
         success: !0,
-        applied: r
+        applied: h,
+        data: N(i, await this.readPageData(i, r, s), this.pageDataBudget(r) - this.envelopeBytes({
+          success: !0,
+          applied: h
+        }))
+      } : {
+        success: !0,
+        applied: h
       };
     }, {
       description: `Change the state of the current page. Set ONLY the controls the user explicitly asked for; leave the others unset. Available controls:
-${o}`,
+${c}` + (r ? `
+Returns the resulting page data once it has loaded: ${r.description}` : ""),
       parameters: {
         type: "object",
         properties: Object.fromEntries(e.map((a) => [a.name, {
@@ -1528,22 +1767,52 @@ ${o}`,
           description: a.description
         }]))
       },
-      requiresApproval: s?.requiresApproval
-    }), this.addDynamicContext(`page-state:${i}`, () => {
-      const a = e.filter((l) => typeof l.get == "function");
+      requiresApproval: s?.requiresApproval,
+      maxResultBytes: r?.maxResultBytes
+    });
+    const o = G(i);
+    r ? (this.warnIfPlaceholderMode(i), this.registerFunction(o, async () => ({ data: N(i, await this.readPageData(i, r, s), this.pageDataBudget(r) - this.envelopeBytes({})) }), {
+      description: `Read what the current page is displaying, without changing anything: ${r.description}`,
+      parameters: {
+        type: "object",
+        properties: {}
+      },
+      maxResultBytes: r.maxResultBytes
+    }), this.pageDataCompanions.add(o)) : this.pageDataCompanions.delete(o) && this.unregisterFunction(o), this.addDynamicContext(`page-state:${i}`, () => {
+      const a = e.filter((u) => typeof u.get == "function");
       if (a.length === 0) return null;
-      const r = {};
-      for (const l of a) r[l.name] = l.get();
+      const h = {};
+      for (const u of a) h[u.name] = u.get();
       return {
         name: "Page state",
         description: "Current, editable state of the page the user is viewing.",
-        data: r
+        data: h
       };
     });
   }
   unregisterPageStateFunction(e) {
     const s = e ?? "setPageState";
-    this.unregisterFunction(s), this.removeDynamicContext(`page-state:${s}`);
+    this.unregisterFunction(s);
+    const i = G(s);
+    this.pageDataCompanions.delete(i) && this.unregisterFunction(i), this.removeDynamicContext(`page-state:${s}`);
+  }
+  pageDataBudget(e) {
+    return e.maxResultBytes ?? this.functionRegistry.getDefaultMaxResultBytes();
+  }
+  envelopeBytes(e) {
+    return m(JSON.stringify({
+      ...e,
+      data: null
+    })) - 4;
+  }
+  readPageData(e, s, i) {
+    return ct(() => s, i?.settleTimeoutMs ?? 1e4).catch((n) => (l.warn(`Reading page data for "${e}" failed:`, n), {
+      error: "page_data_unavailable",
+      message: n instanceof Error ? n.message : String(n)
+    }));
+  }
+  warnIfPlaceholderMode(e) {
+    this.warnedPageDataPlaceholder || this.config.clientFunctionsMode === "placeholder" && (this.warnedPageDataPlaceholder = !0, l.warn(`"${e}" declares a data source, but clientFunctionsMode is "placeholder": the agent will not see that data during the turn it calls the function. Switch to "pause" (the default) for the data to come back as the result of its own call.`));
   }
   setContext(e, s) {
     this.contextRegistry.set(e, s), this.notifyContextChanged();
@@ -1591,10 +1860,10 @@ ${o}`,
     return this.contextRegistry.getSnapshot();
   }
   buildSendContext() {
-    const e = this.contextRegistry.getSnapshot(), s = e?.entries ?? {}, { changes: i, baseline: n } = bt(this.lastSentPageState, s);
+    const e = this.contextRegistry.getSnapshot(), s = e?.entries ?? {}, { changes: i, baseline: n } = Wt(this.lastSentPageState, s);
     return this.lastSentPageState = n, i.length === 0 ? e : { entries: {
       ...s,
-      [Ot]: {
+      [se]: {
         name: "State changes",
         description: "Fields in the page state that changed since your last message, as field: <old> -> <new>.",
         data: { changes: i }
@@ -1616,20 +1885,20 @@ ${o}`,
   }
   recordAgentAction(e) {
     const s = e.functionName, i = e.arguments;
-    let n, o;
+    let n, r;
     if (s === "navigateToPage") {
-      const a = i?.page;
-      n = "agent.navigate", o = a ? `Agent navigated to "${String(a)}"` : "Agent navigated";
-    } else s === "setPageState" ? (n = "agent.page_state", o = "Agent changed the page state") : (n = `agent.${s}`, o = `Agent ran "${s}"`);
+      const c = i?.page;
+      n = "agent.navigate", r = c ? `Agent navigated to "${String(c)}"` : "Agent navigated";
+    } else s === "setPageState" ? (n = "agent.page_state", r = "Agent changed the page state") : (n = `agent.${s}`, r = `Agent ran "${s}"`);
     this.addActivity({
       actor: "agent",
       name: n,
-      summary: o,
+      summary: r,
       ...i && Object.keys(i).length > 0 ? { data: { arguments: i } } : {}
     });
   }
   registerActivityContext() {
-    this.contextRegistry.addDynamicProvider(Pt, () => {
+    this.contextRegistry.addDynamicProvider(ee, () => {
       const e = this.activityLedger.getRecent();
       return e.length === 0 ? null : {
         name: "Recent activity",
@@ -1652,44 +1921,44 @@ ${o}`,
   }
   updateConfig(e) {
     const s = {};
-    for (const [n, o] of Object.entries(e)) o !== void 0 && (s[n] = o);
+    for (const [n, r] of Object.entries(e)) r !== void 0 && (s[n] = r);
     const i = {
       ...this.config,
       ...s
     };
-    D(i, "AgoClient.updateConfig"), this.config = i, this.httpClient.updateConfig(s), s.debug !== void 0 && (s.debug ? c.enable() : c.disable()), s.maxFunctionResultBytes !== void 0 && this.functionRegistry.setDefaultMaxResultBytes(s.maxFunctionResultBytes);
+    q(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.proactive?.destroy(), this.proactive = null, this.eventEmitter.removeAllListeners(), this.functionRegistry.clear(), this.contextRegistry.clear(), this.pendingResumes.clear(), this.pendingApprovals.clear(), this.resumeGate = null, c.log("AgoClient destroyed");
+    this.proactive?.destroy(), this.proactive = null, this.activeTurn?.controller.abort(), this.activeTurn = null, this.pausedTurn = null, this.stoppedTurnIds.clear(), this.eventEmitter.removeAllListeners(), this.functionRegistry.clear(), this.contextRegistry.clear(), this.pendingResumes.clear(), this.pendingApprovals.clear(), this.resumeGate = null, l.log("AgoClient destroyed");
   }
   reviveAfterDestroy() {
-    this.registerActivityContext(), this.config.proactive && !this.proactive && F(this, this.config.proactive);
+    this.registerActivityContext(), this.config.proactive && !this.proactive && U(this, this.config.proactive);
   }
 };
 export {
-  k as C,
-  w as S,
-  Ut as T,
-  z as _,
-  Lt as a,
+  F as C,
+  S,
+  ie as T,
+  st as _,
+  re as a,
   g as b,
-  kt as c,
-  F as d,
-  ct as f,
-  et as g,
-  st as h,
-  Bt as i,
-  Mt as l,
-  O as m,
-  D as n,
-  jt as o,
-  lt as p,
-  Tt as r,
-  It as s,
-  Gt as t,
-  wt as u,
-  c as v,
-  j as w,
-  R as x,
-  p as y
+  Ht as c,
+  U as d,
+  kt as f,
+  St as g,
+  At as h,
+  ae as i,
+  ne as l,
+  W as m,
+  q as n,
+  oe as o,
+  Tt as p,
+  Yt as r,
+  zt as s,
+  ce as t,
+  Lt as u,
+  l as v,
+  X as w,
+  D as x,
+  y
 };