@useago/sdk 1.13.1 → 1.13.3

package/dist/{types-fX-VoHfa.js → types-D1ZrqVhr.js}

@@ -398,13 +398,13 @@ var Pe = 5e4, Ne = 2e4, Oe = 2e3, Le = class {
   }
   register(e, t, s) {
     if (typeof e == "object") {
-      const { name: d, handler: f, description: m, parameters: v, maxResultBytes: p, requiresApproval: h, webmcp: g } = e;
-      return this.register(d, f, {
-        description: m,
+      const { name: u, handler: g, description: f, parameters: v, maxResultBytes: y, requiresApproval: h, webmcp: p } = e;
+      return this.register(u, g, {
+        description: f,
         parameters: v,
-        maxResultBytes: p,
+        maxResultBytes: y,
         requiresApproval: h,
-        webmcp: g
+        webmcp: p
       });
     }
     const i = e;
@@ -421,8 +421,8 @@ var Pe = 5e4, Ne = 2e4, Oe = 2e3, Le = class {
       requiresApproval: r,
       webmcp: o
     });
-    const u = Me(l);
-    u.length > 0 && c.warn(`Function "${i}" is over the per-tool budget on ${u.join(", ")}.`), c.log(`Registered function: ${i}`), this.emitChange();
+    const d = Me(l);
+    d.length > 0 && c.warn(`Function "${i}" is over the per-tool budget on ${d.join(", ")}.`), c.log(`Registered function: ${i}`), this.emitChange();
   }
   unregister(e) {
     const t = this.functions.delete(e);
@@ -479,11 +479,11 @@ var Pe = 5e4, Ne = 2e4, Oe = 2e3, Le = class {
     return this.functions.size;
   }
 }, je = new TextEncoder();
-function E(e) {
+function b(e) {
   return je.encode(e).length;
 }
 function j(e) {
-  return E(JSON.stringify(e)) - 2;
+  return b(JSON.stringify(e)) - 2;
 }
 function ye(e, t) {
   if (t <= 0) return "";
@@ -546,7 +546,7 @@ function Ke(e) {
 function Je(e, t) {
   let s = 2, i = 0;
   for (const n of e) {
-    const r = E(A(n) ?? "null") + (i > 0 ? 1 : 0);
+    const r = b(A(n) ?? "null") + (i > 0 ? 1 : 0);
     if (s + r > t) break;
     s += r, i++;
   }
@@ -562,14 +562,14 @@ function He(e, t, s, i) {
     maxBytes: i,
     preview: "",
     hint: W(e)
-  }, r = E(A(n) ?? "{}");
+  }, r = b(A(n) ?? "{}");
   return {
     ...n,
     preview: ye(t, Math.min(Be, i - r))
   };
 }
 function ze(e, t, s, i, n) {
-  const r = s === void 0 ? {} : { ...t }, o = s ?? "items", a = E(A({
+  const r = s === void 0 ? {} : { ...t }, o = s ?? "items", a = b(A({
     ...r,
     [o]: [],
     truncation: {
@@ -595,12 +595,12 @@ function ze(e, t, s, i, n) {
 function te(e, t, s) {
   const i = A(t);
   if (i === void 0) return t;
-  const n = E(i);
+  const n = b(i);
   if (n <= s) return t;
   c.warn(`Page data for "${e}" 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 = Ke(t), o = Array.isArray(t) ? t : r !== void 0 ? t[r] : void 0;
   if (o) {
-    const a = ze(e, t, r, o, s), l = E(A(a) ?? "");
+    const a = ze(e, t, r, o, s), l = b(A(a) ?? "");
     if (a !== void 0 && l <= s) return a;
   }
   return He(e, i, n, s);
@@ -643,63 +643,63 @@ function Qe(e) {
 function Ze(e, t, s) {
   const i = s?.catalogue === "onDemand", n = ve(t);
   !i && n.length > 0 && c.log('registerNavigationFunction: routes declare "section" but catalogue is "inline", so it is unused. Set catalogue: "onDemand" to use it.');
-  const r = i ? `Navigate the user to a page. Call ${T} for what a page name means.` : `Navigate the user to a page in the application. Available pages:
+  const r = "Available functions depend on the current page. After navigation, you will receive the destination page’s available functions and current state. Use them to complete any remaining actions in the user’s request.", o = i ? `Navigate the user to a page. Call ${T} for what a page name means. ${r}` : `Navigate the user to a page in the application. ${r} Available pages:
 ${t.map(Qe).join(`
-`)}`, o = /* @__PURE__ */ new Map();
-  for (const u of t) for (const d of B(u.path)) o.set(d, [...o.get(d) ?? [], u.name]);
-  const a = t.map((u) => u.name), l = { page: {
+`)}`, a = /* @__PURE__ */ new Map();
+  for (const u of t) for (const g of B(u.path)) a.set(g, [...a.get(g) ?? [], u.name]);
+  const l = t.map((u) => u.name), d = { page: {
     type: "string",
     description: "The page to navigate to",
-    enum: a
+    enum: l
   } };
-  for (const [u, d] of o) {
+  for (const [u, g] of a) {
     if (u === "page") {
       c.error('registerNavigationFunction: a ":page" placeholder collides with the "page" argument and is ignored. Rename the placeholder.');
       continue;
     }
-    l[u] = {
+    d[u] = {
       type: "string",
-      description: `Value for ":${u}" in the page path. Required when page is ${d.map((f) => `"${f}"`).join(" or ")}.`
+      description: `Value for ":${u}" in the page path. Required when page is ${g.map((f) => `"${f}"`).join(" or ")}.`
     };
   }
   return {
     name: J,
-    description: r,
+    description: o,
     parameters: {
       type: "object",
-      properties: l,
+      properties: d,
       required: ["page"]
     },
     webmcp: { navigates: !0 },
     handler: async (u) => {
-      const d = u.page, f = t.find((g) => g.name === d);
+      const g = u.page, f = t.find((m) => m.name === g);
       if (!f) return i ? {
         success: !1,
-        error: `Unknown page: ${d}`,
-        pages: a
+        error: `Unknown page: ${g}`,
+        pages: l
       } : {
         success: !1,
-        error: `Unknown page: ${d}`
+        error: `Unknown page: ${g}`
       };
-      let m = {};
+      let v = {};
       if (typeof u.params == "string") try {
-        m = JSON.parse(u.params);
+        v = JSON.parse(u.params);
       } catch {
       }
-      else u.params && typeof u.params == "object" && (m = u.params);
-      const v = {};
-      for (const g of B(f.path)) v[g] = u[g] ?? m[g];
-      const { path: p, missing: h } = Ve(f.path, v);
-      if (h.length > 0) {
-        const g = h.map((y) => `"${y}": "..."`).join(", ");
+      else u.params && typeof u.params == "object" && (v = u.params);
+      const y = {};
+      for (const m of B(f.path)) y[m] = u[m] ?? v[m];
+      const { path: h, missing: p } = Ve(f.path, y);
+      if (p.length > 0) {
+        const m = p.map((w) => `"${w}": "..."`).join(", ");
         return {
           success: !1,
-          error: `Page "${d}" needs ${h.map((y) => `"${y}"`).join(", ")}. Retry with { "page": "${d}", ${g} }.`
+          error: `Page "${g}" needs ${p.map((w) => `"${w}"`).join(", ")}. Retry with { "page": "${g}", ${m} }.`
         };
       }
-      return e(p), {
+      return e(h), {
         success: !0,
-        navigatedTo: p
+        navigatedTo: h
       };
     }
   };
@@ -741,9 +741,9 @@ function I(e, t) {
   const s = Object.keys(e), i = Object.keys(t);
   return s.length !== i.length ? !1 : s.every((n) => n in t && I(e[n], t[n]));
 }
-var se = 100, $ = " … [truncated]", we = { truncated: !0 }, tt = E(',"data":' + JSON.stringify(we));
+var se = 100, $ = " … [truncated]", we = { truncated: !0 }, tt = b(',"data":' + JSON.stringify(we));
 function G(e) {
-  return E(JSON.stringify(e));
+  return b(JSON.stringify(e));
 }
 function ie(e, t) {
   if (G(e) <= t || !e.rejected) return e;
@@ -755,12 +755,12 @@ function ie(e, t) {
   if (r > t) return n;
   const o = j($);
   for (const [a, l] of s) {
-    const u = j(l), d = t - r + o;
-    if (u <= d) {
-      i[a] = l, r += u - o;
+    const d = j(l), u = t - r + o;
+    if (d <= u) {
+      i[a] = l, r += d - o;
       continue;
     }
-    i[a] = ye(l, d - o) + $;
+    i[a] = ye(l, u - o) + $;
     break;
   }
   return n;
@@ -776,7 +776,7 @@ function Ee(e) {
   return s > 0 ? `${t.join(", ")} (${s} more not shown)` : t.join(", ");
 }
 function re(e, t) {
-  return t.includes(e) ? null : `${JSON.stringify(e)} is not an allowed value. Allowed values: ${Ee(t)}.`;
+  return t.includes(e) ? null : t.length === 0 ? "No values are currently allowed." : `${JSON.stringify(e)} is not an allowed value. Allowed values: ${Ee(t)}.`;
 }
 function st(e, t) {
   const { schema: s } = t;
@@ -813,11 +813,12 @@ function be(e) {
 function it(e) {
   const t = {
     ...e.schema,
+    ...e.schema.items ? { items: { ...e.schema.items } } : {},
     description: e.description
   };
-  H(e) && (t.description = `${e.description} Pass "" to clear it.`);
+  t.enum?.length === 0 && delete t.enum, t.items?.enum?.length === 0 && delete t.items.enum, H(e) && (t.description = `${e.description} Pass "" to clear it.`);
   const s = be(e);
-  return s && (t.enum = s), t;
+  return s?.length && (t.enum = s), t;
 }
 function nt(e, t) {
   const s = new Map(e.map((r) => [r.name, r])), i = e.map((r) => r.name), n = e.map((r) => `- "${r.name}": ${r.description}`).join(`
@@ -826,38 +827,38 @@ function nt(e, t) {
     name: t.name,
     handler: async (r) => {
       const o = [], a = [], l = {};
-      for (const [h, g] of Object.entries(r)) {
-        const y = s.get(h);
-        if (!y) {
+      for (const [h, p] of Object.entries(r)) {
+        const m = s.get(h);
+        if (!m) {
           l[h] = `"${h}" is not a registered control. Available controls: ${Ee(i)}.`;
           continue;
         }
-        if (g == null || g === "" && !H(y)) continue;
-        const b = st(g, y);
-        if (b) {
-          l[h] = b;
+        if (p == null || p === "" && !H(m)) continue;
+        const w = st(p, m);
+        if (w) {
+          l[h] = w;
           continue;
         }
-        if (y.get && I(g, y.get())) {
+        if (m.get && I(p, m.get())) {
           a.push(h);
           continue;
         }
-        const w = await y.set(g);
-        w ? w.result === "rejected" ? l[h] = w.reason || "The page rejected this field's update." : w.result === "unchanged" ? a.push(h) : o.push(h) : o.push(h);
+        const E = await m.set(p);
+        E ? E.result === "rejected" ? l[h] = E.reason || "The page rejected this field's update." : E.result === "unchanged" ? a.push(h) : o.push(h) : o.push(h);
       }
-      const u = Object.keys(l).length > 0, d = {
-        success: !u,
+      const d = Object.keys(l).length > 0, u = {
+        success: !d,
         applied: o,
         unchanged: a,
-        ...u ? { rejected: l } : {}
-      }, f = t.getResultBudget();
-      if (!t.data) return ie(d, f);
-      const m = ie(d, f - tt), v = await t.data.read(m), p = {
-        ...m,
+        ...d ? { rejected: l } : {}
+      }, g = t.getResultBudget();
+      if (!t.data) return ie(u, g);
+      const f = ie(u, g - tt), v = await t.data.read(f), y = {
+        ...f,
         data: v
       };
-      return G(p) <= f ? p : {
-        ...m,
+      return G(y) <= g ? y : {
+        ...f,
         data: we
       };
     },
@@ -1382,9 +1383,9 @@ function ae(e, t) {
     getPageState: () => {
       const l = e.getContextSnapshot();
       if (!l) return null;
-      const u = {};
-      for (const [d, f] of Object.entries(l.entries)) d.startsWith("page-state:") && f.data && Object.assign(u, f.data);
-      return Object.keys(u).length > 0 ? u : null;
+      const d = {};
+      for (const [u, g] of Object.entries(l.entries)) u.startsWith("page-state:") && g.data && Object.assign(d, g.data);
+      return Object.keys(d).length > 0 ? d : null;
     }
   });
   s.start();
@@ -1392,11 +1393,11 @@ function ae(e, t) {
     s.signalJsError(l.type);
   };
   e.on("error:captured", i), e.addDynamicContext(oe, () => {
-    const { pageState: l, ...u } = s.getSnapshot({ pageState: !1 });
+    const { pageState: l, ...d } = 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, JavaScript error count (names and counters only).",
-      data: u
+      data: d
     };
   });
   const n = new yt({
@@ -1404,7 +1405,7 @@ function ae(e, t) {
     storage: t.storage,
     storageKey: t.storageKey
   }), r = new It({
-    post: (l, u, d) => e.getHttp().post(l, u, d),
+    post: (l, d, u) => e.getHttp().post(l, d, u),
     agent: e.getConfiguredAgent()
   }), o = new Ct({
     client: e,
@@ -1733,15 +1734,15 @@ function Jt(e, t) {
     const r = () => {
       if (!n) {
         n = !0, clearTimeout(i), clearTimeout(l), clearTimeout(a);
-        for (const d of t) d?.removeEventListener("abort", r);
-        u(), s();
+        for (const u of t) u?.removeEventListener("abort", r);
+        d(), s();
       }
     }, o = () => {
       clearTimeout(l), clearTimeout(i), i = setTimeout(r, Gt);
-    }, a = setTimeout(r, Bt), l = setTimeout(r, qt), u = e(o);
-    for (const d of t) {
-      if (d?.aborted) return r();
-      d?.addEventListener("abort", r);
+    }, a = setTimeout(r, Bt), l = setTimeout(r, qt), d = e(o);
+    for (const u of t) {
+      if (u?.aborted) return r();
+      u?.addEventListener("abort", r);
     }
   });
 }
@@ -1752,67 +1753,67 @@ function Ht(e) {
     };
   const s = t, i = /* @__PURE__ */ new Map(), n = /* @__PURE__ */ new Set(), r = new AbortController();
   let o = !1, a = !1;
-  function l(p) {
+  function l(y) {
     return JSON.stringify([
-      p.description,
-      p.inputSchema,
-      p.annotations
+      y.description,
+      y.inputSchema,
+      y.annotations
     ]);
   }
-  function u(p, h) {
-    const g = e.getFunctionRegistrations().find((y) => y.name === p)?.webmcp;
-    return !g || !g.navigates ? !1 : h?.success !== !1;
+  function d(y, h) {
+    const p = e.getFunctionRegistrations().find((m) => m.name === y)?.webmcp;
+    return !p || !p.navigates ? !1 : h?.success !== !1;
   }
-  function d() {
-    const p = /* @__PURE__ */ new Map();
+  function u() {
+    const y = /* @__PURE__ */ new Map();
     for (const h of e.getFunctionRegistrations()) {
       if (h.webmcp === !1) continue;
-      const g = h.webmcp || void 0, y = h.name, b = {
-        name: y,
+      const p = h.webmcp || void 0, m = h.name, w = {
+        name: m,
         description: h.schema.description,
         inputSchema: h.schema.parameters,
-        annotations: g?.annotations,
-        execute: async (w, _e) => {
-          const z = await e.runExternalFunction(y, w ?? {});
-          return !o && u(y, z) && await Jt((Ce) => e.onFunctionsChanged(Ce), [_e?.signal, r.signal]), z;
+        annotations: p?.annotations,
+        execute: async (E, _e) => {
+          const z = await e.runExternalFunction(m, E ?? {});
+          return !o && d(m, z) && await Jt((Ce) => e.onFunctionsChanged(Ce), [_e?.signal, r.signal]), z;
         }
       };
-      p.set(y, {
-        tool: b,
-        signature: l(b)
+      y.set(m, {
+        tool: w,
+        signature: l(w)
       });
     }
-    return p;
+    return y;
   }
-  function f() {
+  function g() {
     o || a || (a = !0, queueMicrotask(() => {
-      a = !1, m();
+      a = !1, f();
     }));
   }
-  function m() {
+  function f() {
     if (o) return;
-    const p = d();
-    for (const [h, g] of i)
-      p.get(h)?.signature !== g.signature && (g.controller.abort(), i.delete(h));
-    for (const [h, g] of p) {
+    const y = u();
+    for (const [h, p] of i)
+      y.get(h)?.signature !== p.signature && (p.controller.abort(), i.delete(h));
+    for (const [h, p] of y) {
       if (i.has(h)) continue;
-      const y = new AbortController();
+      const m = new AbortController();
       i.set(h, {
-        signature: g.signature,
-        controller: y
-      }), Promise.resolve(s.registerTool(g.tool, { signal: y.signal })).catch((b) => {
-        if (c.error(`WebMCP rejected the tool "${h}":`, b), i.get(h)?.controller !== y) return;
+        signature: p.signature,
+        controller: m
+      }), Promise.resolve(s.registerTool(p.tool, { signal: m.signal })).catch((w) => {
+        if (c.error(`WebMCP rejected the tool "${h}":`, w), i.get(h)?.controller !== m) return;
         i.delete(h);
-        const w = JSON.stringify([h, g.signature]);
-        n.has(w) || (n.add(w), f());
+        const E = JSON.stringify([h, p.signature]);
+        n.has(E) || (n.add(E), g());
       });
     }
   }
-  const v = e.onFunctionsChanged(f);
-  return m(), c.log("WebMCP bridge attached"), () => {
+  const v = e.onFunctionsChanged(g);
+  return f(), c.log("WebMCP bridge attached"), () => {
     if (!o) {
       o = !0, r.abort(), v();
-      for (const p of i.values()) p.controller.abort();
+      for (const y of i.values()) y.controller.abort();
       i.clear(), c.log("WebMCP bridge detached");
     }
   };
@@ -1866,21 +1867,21 @@ var cs = class R {
   }
   async sendMessage(t, s) {
     if (typeof t != "string" || !t.trim()) throw new S("Add message text before sending, including when attaching files. See docs/general/core.md#file-attachments.", "message_empty_content");
-    const i = this.functionRegistry.getSchemas(), n = this.buildSendContext(), r = this.config.agent || this.config.defaultAgentId, o = this.resolveClientFunctionsMode(s), a = s?.metadata !== void 0 ? s.metadata : this.config.metadata, l = a != null ? JSON.stringify(a) : void 0, u = {
+    const i = this.functionRegistry.getSchemas(), n = this.buildSendContext(), r = this.config.agent || this.config.defaultAgentId, o = this.resolveClientFunctionsMode(s), a = s?.metadata !== void 0 ? s.metadata : this.config.metadata, l = a != null ? JSON.stringify(a) : void 0, d = {
       content: t,
       conversation_id: s?.conversationId,
       agent_id: s?.agentId || r
     };
-    a != null && (u.metadata = a), i.length > 0 && (u.client_functions = i, o === "pause" && (u.client_functions_mode = o)), n && (u.client_context = n), s?.hidden && (u.hidden = !0);
-    const d = this.beginTurn();
-    let f;
+    a != null && (d.metadata = a), i.length > 0 && (d.client_functions = i, o === "pause" && (d.client_functions_mode = o)), n && (d.client_context = n), s?.hidden && (d.hidden = !0);
+    const u = this.beginTurn();
+    let g;
     if (s?.files && s.files.length > 0) {
-      const m = new FormData();
-      m.append("content", t), l !== void 0 && m.append("metadata", l), s.conversationId && m.append("conversation_id", s.conversationId), (s.agentId || r) && m.append("agent_id", s.agentId || r || ""), i.length > 0 && (m.append("client_functions", JSON.stringify(i)), o === "pause" && m.append("client_functions_mode", o)), n && m.append("client_context", JSON.stringify(n)), s.hidden && m.append("hidden", "true");
-      for (const v of s.files) m.append("files", v);
-      f = await this.sendRequest(d, () => this.httpClient.postFormData("/api/sdk/v1/messages", m, { signal: d.controller.signal }));
-    } else f = await this.sendRequest(d, () => this.httpClient.postStream("/api/sdk/v1/messages", u, { signal: d.controller.signal }));
-    return f ? this.processSSEResponse(f, d) : this.buildStoppedMessage(d);
+      const f = new FormData();
+      f.append("content", t), l !== void 0 && f.append("metadata", l), s.conversationId && f.append("conversation_id", s.conversationId), (s.agentId || r) && f.append("agent_id", s.agentId || r || ""), i.length > 0 && (f.append("client_functions", JSON.stringify(i)), o === "pause" && f.append("client_functions_mode", o)), n && f.append("client_context", JSON.stringify(n)), s.hidden && f.append("hidden", "true");
+      for (const v of s.files) f.append("files", v);
+      g = await this.sendRequest(u, () => this.httpClient.postFormData("/api/sdk/v1/messages", f, { signal: u.controller.signal }));
+    } else g = await this.sendRequest(u, () => this.httpClient.postStream("/api/sdk/v1/messages", d, { signal: u.controller.signal }));
+    return g ? this.processSSEResponse(g, u) : this.buildStoppedMessage(u);
   }
   async sendRequest(t, s) {
     try {
@@ -2344,19 +2345,19 @@ var cs = class R {
         continue;
       }
       this.eventEmitter.emit("function:invoke", l);
-      let u, d;
+      let d, u;
       try {
-        u = await this.functionRegistry.execute(a.functionName, a.arguments ?? {});
-      } catch (f) {
-        d = f instanceof Error ? f.message : "Unknown error", c.error("Client function execution failed:", f);
+        d = await this.functionRegistry.execute(a.functionName, a.arguments ?? {});
+      } catch (g) {
+        u = g instanceof Error ? g.message : "Unknown error", c.error("Client function execution failed:", g);
       }
       this.eventEmitter.emit("function:result", {
         invocationId: a.id,
-        result: u,
-        error: d
+        result: d,
+        error: u
       }), o = (await this.submitToolCallForm(a.id, {
-        result: u,
-        error: d,
+        result: d,
+        error: u,
         _type: "client_function_result"
       }))?.resume?.ready ?? o;
     }
@@ -2428,11 +2429,11 @@ var cs = class R {
   registerNavigationFunction(t, s, i) {
     this.registerFunction(Ze(t, s, i)), i?.catalogue === "onDemand" ? (this.registerFunction(et(s)), this.listPagesRegistered = !0) : this.listPagesRegistered && (this.unregisterFunction(T), this.listPagesRegistered = !1), this.addDynamicContext("current-page", () => {
       if (typeof window > "u" || !window.location) return null;
-      const n = window.location.href, r = typeof document < "u" ? document.title : void 0, o = Ye(window.location.pathname, s), a = { url: n };
-      return o && (a.page = o.name), r && (a.title = r), {
+      const n = window.location.href, r = Ye(window.location.pathname, s), o = { url: n };
+      return r && (o.page = r.name), {
         name: "Current page",
         description: "The page the user is currently viewing.",
-        data: a
+        data: o
       };
     });
   }
@@ -2481,7 +2482,7 @@ var cs = class R {
     return t.maxResultBytes ?? this.functionRegistry.getDefaultMaxResultBytes();
   }
   envelopeBytes(t) {
-    return E(JSON.stringify({
+    return b(JSON.stringify({
       ...t,
       data: null
     })) - 4;
@@ -2589,7 +2590,7 @@ var cs = class R {
       const t = this.activityLedger.getRecent();
       return t.length === 0 ? null : {
         name: "Recent activity",
-        description: "Recent actions by the user and the agent in the app, oldest first. Use this to understand what just happened before this message.",
+        description: "Recent actions by the user and the agent in the app, oldest first. Use this to understand what just happened before this message. Use current-page for the user’s current location.",
         data: { events: t }
       };
     });