@useago/sdk 1.7.1 → 1.9.0

package/dist/devtools.js

@@ -1,97 +1,204 @@
-function E(e, t, d) {
-  if (!e) return;
-  const a = document.createElement("div");
-  a.className = `dev-log-line dev-log-${d}`, a.textContent = `${(/* @__PURE__ */ new Date()).toLocaleTimeString()}  ${t}`, e.appendChild(a), e.scrollTop = e.scrollHeight;
-}
-function O(e) {
-  let t;
-  return e.type ? t = e.type : e.content !== void 0 ? t = "content" : e.full_content !== void 0 ? t = "full_content" : e.status ? t = `status:${e.status}` : t = "event", `${t}  ${JSON.stringify(e)}`;
-}
-var T = "ago_dev_panel_collapsed", N = "ago_dev_events_collapsed";
-function u(e, t, d, a) {
-  e.classList.toggle("collapsed", t);
-  const l = e.querySelector(".dev-toggle");
-  l && (l.textContent = t ? "▢" : "—", l.title = t ? `Expand ${a}` : `Collapse ${a}`, l.setAttribute("aria-expanded", String(!t)));
+import { n as te } from "./errors-BLfjXnLB.js";
+function Q(n, e, i) {
+  if (!n) return;
+  const r = document.createElement("div");
+  r.className = `dev-log-line dev-log-${i}`, r.textContent = `${(/* @__PURE__ */ new Date()).toLocaleTimeString()}  ${e}`, n.appendChild(r), n.scrollTop = n.scrollHeight;
+}
+function ne(n) {
+  let e;
+  return n.type ? e = n.type : n.content !== void 0 ? e = "content" : n.full_content !== void 0 ? e = "full_content" : n.status ? e = `status:${n.status}` : e = "event", `${e}  ${JSON.stringify(n)}`;
+}
+var oe = "ago_dev_panel_collapsed", ae = "ago_dev_events_collapsed";
+function _(n, e, i, r) {
+  n.classList.toggle("collapsed", e);
+  const v = n.querySelector(".dev-toggle");
+  v && (v.textContent = e ? "▢" : "—", v.title = e ? `Expand ${r}` : `Collapse ${r}`, v.setAttribute("aria-expanded", String(!e)));
   try {
-    localStorage.setItem(d, t ? "1" : "0");
+    localStorage.setItem(i, e ? "1" : "0");
   } catch {
   }
 }
-function $(e, t, d) {
-  e.querySelector(".dev-toggle")?.addEventListener("click", (l) => {
-    l.stopPropagation(), u(e, !e.classList.contains("collapsed"), t, d);
-  }), e.addEventListener("click", () => {
-    e.classList.contains("collapsed") && u(e, !1, t, d);
+function W(n, e, i) {
+  n.querySelector(".dev-toggle")?.addEventListener("click", (v) => {
+    v.stopPropagation(), _(n, !n.classList.contains("collapsed"), e, i);
+  }), n.addEventListener("click", () => {
+    n.classList.contains("collapsed") && _(n, !1, e, i);
   });
-  let a = !1;
+  let r = !1;
   try {
-    a = localStorage.getItem(t) === "1";
+    r = localStorage.getItem(e) === "1";
   } catch {
   }
-  u(e, a, t, d);
-}
-function z(e) {
-  const { client: t, target: d, label: a, side: l = "right" } = e, f = document.querySelectorAll("#ago-dev-panel").length, x = f === 0 ? "" : `-${f + 1}`, h = document.querySelectorAll(`#ago-dev-panel[data-ago-dev-side="${l}"]`).length, r = h > 0 ? `${16 + h * 376}px` : "";
-  let g = null, m = null, b = null;
-  const L = () => {
-    const o = t.getContextSnapshot()?.entries ?? {};
-    return Object.fromEntries(Object.entries(o).map(([n, { name: p, data: k }]) => [n, {
-      name: p,
-      data: k
+  _(n, r, e, i);
+}
+var re = 0;
+function ce(n) {
+  const { client: e, target: i, label: r, side: v = "right", enableFunctionRunner: F = !1 } = n;
+  if (F && typeof e.executeClientFunction != "function") throw new te("initDevPanel: enableFunctionRunner requires client.executeClientFunction. Pass a real AgoClient, not a mock that omits it.", "dev_panel_missing_capability");
+  let u = !1;
+  const P = re++, R = P === 0 ? "" : `-${P + 1}`, A = document.querySelectorAll(`#ago-dev-panel[data-ago-dev-side="${v}"]`).length, N = A > 0 ? `${16 + A * 376}px` : "";
+  let w = null, J = null, q = null;
+  const Z = () => {
+    const t = e.getContextSnapshot()?.entries ?? {};
+    return Object.fromEntries(Object.entries(t).map(([o, { name: d, data: a }]) => [o, {
+      name: d,
+      data: a
     }]));
-  }, c = () => {
-    g && (g.textContent = JSON.stringify(L(), null, 2));
-  }, v = (o, n) => {
-    E(m, o, n);
+  }, h = () => {
+    u || w && (w.textContent = JSON.stringify(Z(), null, 2));
+  }, k = (t, o) => {
+    u || Q(J, t, o);
   };
-  _();
-  const y = typeof d == "string" ? document.querySelector(d) : d instanceof Element ? d : document.body, S = (o) => {
-    o.dataset.agoDevSide = l, l === "left" ? (o.style.right = "auto", o.style.left = r || "16px") : r && (o.style.right = r);
-  }, s = document.createElement("aside");
-  s.id = "ago-dev-panel", s.className = "ago-dev-card", S(s), (y ?? document.body).appendChild(s);
-  const w = (t.getRegisteredFunctions?.() ?? []).map((o) => o.name).join(", ") || "—";
-  s.innerHTML = `
+  de();
+  const D = typeof i == "string" ? document.querySelector(i) : i instanceof Element ? i : document.body, I = (t) => {
+    t.dataset.agoDevSide = v, v === "left" ? (t.style.right = "auto", t.style.left = N || "16px") : N && (t.style.right = N);
+  }, p = document.createElement("aside");
+  p.id = "ago-dev-panel", p.className = "ago-dev-card", I(p), (D ?? document.body).appendChild(p), p.innerHTML = `
     <div class="dev-head">
       <span class="dev-badge">DEV</span>
-      <span class="dev-title">${a ? `DEV TOOLS · ${a}` : "DEV TOOLS · client-side function state — not for production"}</span>
+      <span class="dev-title">${r ? `DEV TOOLS · ${r}` : "DEV TOOLS · client-side function state — not for production"}</span>
       <button type="button" class="dev-toggle" aria-label="Toggle dev tools">—</button>
     </div>
     <div class="dev-body">
-      <div class="dev-fns">Registered functions: <code>${w}</code></div>
-      <div class="dev-section-label">JSON object (built by the agent)</div>
-      <pre class="dev-state" id="ago-dev-state"></pre>
-      <div class="dev-section-label">Function calls</div>
-      <div class="dev-log" id="ago-dev-log"></div>
+      <div class="dev-fns">Registered functions: <code></code></div>
+      <details class="dev-details" open>
+        <summary class="dev-section-label">JSON object (built by the agent)</summary>
+        <pre class="dev-state" id="ago-dev-state"></pre>
+      </details>
+      <details class="dev-details" open>
+        <summary class="dev-section-label">Function calls</summary>
+        <div class="dev-log" id="ago-dev-log"></div>
+      </details>
     </div>
-  `, g = s.querySelector(".dev-state"), m = s.querySelector(".dev-log"), $(s, T + x, "dev tools");
-  const i = document.createElement("aside");
-  i.id = "ago-dev-events", i.className = "ago-dev-card", S(i), (y ?? document.body).appendChild(i), i.innerHTML = `
+  `, w = p.querySelector(".dev-state"), J = p.querySelector(".dev-log");
+  const M = p.querySelector(".dev-fns code");
+  let b = null, L = null, $ = "";
+  const m = () => {
+    if (u) return;
+    const t = e.getRegisteredFunctions?.() ?? [], o = t.map((a) => a.name);
+    if (M && (M.textContent = o.join(", ") || "—"), !b) return;
+    let d = $;
+    if (o.includes(d) || (d = o.includes("setPageState") ? "setPageState" : o[0] ?? ""), $ = d, b.innerHTML = "", o.length === 0) {
+      const a = document.createElement("option");
+      a.textContent = "(no functions registered)", a.disabled = !0, b.appendChild(a);
+    }
+    for (const a of o) {
+      const s = document.createElement("option");
+      s.value = a, s.textContent = a, s.selected = a === d, b.appendChild(s);
+    }
+    if (L) {
+      const a = t.find((s) => s.name === d);
+      L.textContent = a ? JSON.stringify(a.parameters ?? {}, null, 2) : "";
+    }
+  };
+  W(p, oe + R, "dev tools");
+  const g = document.createElement("aside");
+  g.id = "ago-dev-events", g.className = "ago-dev-card", I(g), (D ?? document.body).appendChild(g), g.innerHTML = `
     <div class="dev-head">
       <span class="dev-badge">SSE</span>
-      <span class="dev-title">${a ? `SSE EVENT LOG · ${a}` : "SSE EVENT LOG · raw stream messages"}</span>
+      <span class="dev-title">${r ? `SSE EVENT LOG · ${r}` : "SSE EVENT LOG · raw stream messages"}</span>
       <button type="button" class="dev-toggle" aria-label="Toggle SSE event log">—</button>
     </div>
     <div class="dev-body">
       <div class="dev-log" id="ago-dev-event-log"></div>
     </div>
-  `, b = i.querySelector(".dev-log"), $(i, N + x, "SSE event log"), t.on("stream:message", (o) => {
-    E(b, O(o), "event");
-  }), t.on("function:invoke", ({ functionName: o, arguments: n }) => {
-    v(`→ ${o}(${JSON.stringify(n ?? {})})`, "invoke");
-  }), t.on("function:result", ({ result: o, error: n }) => {
-    v(n ? `✗ error: ${n}` : `← ${JSON.stringify(o)}`, n ? "error" : "result"), c();
-  }), t.on("context:changed", c), t.on("conversation:loaded", (o) => {
-    const n = (o.messages ?? []).flatMap((p) => p.toolCalls ?? []);
-    v(`⟳ hydrated "${o.title || o.id}" — replayed ${n.length} tool call${n.length === 1 ? "" : "s"}`, "hydrate"), c();
-  }), c();
-}
-var C = "ago-dev-panel-styles";
-function _() {
-  if (document.getElementById(C)) return;
-  const e = document.createElement("style");
-  e.id = C, e.textContent = q, document.head.appendChild(e);
-}
-var q = `
+  `, q = g.querySelector(".dev-log"), W(g, ae + R, "SSE event log");
+  function j(t) {
+    u || Q(q, ne(t), "event");
+  }
+  function V({ functionName: t, arguments: o }) {
+    u || (k(`→ ${t}(${JSON.stringify(o ?? {})})`, "invoke"), m());
+  }
+  function H({ result: t, error: o }) {
+    u || (k(o ? `✗ error: ${o}` : `← ${JSON.stringify(t)}`, o ? "error" : "result"), h(), m());
+  }
+  function U() {
+    u || (h(), m());
+  }
+  function B(t) {
+    if (u) return;
+    const o = (t.messages ?? []).flatMap((d) => d.toolCalls ?? []);
+    k(`⟳ hydrated "${t.title || t.id}" — replayed ${o.length} tool call${o.length === 1 ? "" : "s"}`, "hydrate"), h();
+  }
+  if (e.on("stream:message", j), e.on("function:invoke", V), e.on("function:result", H), e.on("context:changed", U), e.on("conversation:loaded", B), F) {
+    const t = document.createElement("div");
+    t.className = "dev-runner";
+    const o = document.createElement("div");
+    o.className = "dev-section-label", o.textContent = "LOCAL FUNCTION RUNNER", t.appendChild(o);
+    const d = document.createElement("div");
+    d.className = "dev-runner-warning", d.textContent = "Executes locally. Does not contact the agent backend.", t.appendChild(d);
+    const a = document.createElement("div");
+    a.className = "dev-runner-row";
+    const s = document.createElement("select");
+    s.className = "dev-runner-select", a.appendChild(s);
+    const y = document.createElement("button");
+    y.type = "button", y.className = "dev-runner-btn dev-runner-btn-sm", y.textContent = "Refresh", y.addEventListener("click", m), a.appendChild(y), t.appendChild(a), b = s;
+    const O = document.createElement("div");
+    O.className = "dev-section-label", O.textContent = "SCHEMA", t.appendChild(O);
+    const z = document.createElement("pre");
+    z.className = "dev-runner-schema", t.appendChild(z), L = z, s.addEventListener("change", () => {
+      $ = s.value, m();
+    });
+    const T = document.createElement("div");
+    T.className = "dev-section-label", T.textContent = "ARGUMENTS (JSON)", t.appendChild(T);
+    const C = document.createElement("textarea");
+    C.className = "dev-runner-args", C.value = "{}", C.spellcheck = !1, t.appendChild(C);
+    const f = document.createElement("button");
+    f.type = "button", f.className = "dev-runner-btn", f.textContent = "Run", t.appendChild(f);
+    const l = document.createElement("div");
+    l.className = "dev-runner-status", t.appendChild(l);
+    const x = document.createElement("pre");
+    x.className = "dev-runner-result", t.appendChild(x);
+    const E = document.createElement("div");
+    E.className = "dev-runner-bytes", t.appendChild(E);
+    const ee = e.executeClientFunction.bind(e);
+    f.addEventListener("click", async () => {
+      l.textContent = "", x.textContent = "", E.textContent = "";
+      let G;
+      try {
+        const c = JSON.parse(C.value);
+        if (c === null || Array.isArray(c) || typeof c != "object") {
+          l.textContent = "Error: arguments must be a JSON object.", l.className = "dev-runner-status dev-runner-error";
+          return;
+        }
+        G = c;
+      } catch (c) {
+        l.textContent = `Parse error: ${c instanceof Error ? c.message : String(c)}`, l.className = "dev-runner-status dev-runner-error";
+        return;
+      }
+      const Y = s.value;
+      if (!Y) return;
+      f.disabled = !0, l.textContent = "Running…", l.className = "dev-runner-status";
+      let S, K = !1;
+      try {
+        S = await ee(Y, G), K = !0;
+      } catch (c) {
+        if (u) return;
+        l.textContent = "Execution error", l.className = "dev-runner-status dev-runner-error", x.textContent = c instanceof Error ? `${c.constructor.name}: ${c.message}` : String(c);
+      }
+      if (!u) {
+        if (K)
+          if (l.textContent = "OK", l.className = "dev-runner-status dev-runner-ok", S === void 0) x.textContent = "(undefined)";
+          else try {
+            x.textContent = JSON.stringify(S, null, 2), E.textContent = `${new TextEncoder().encode(JSON.stringify(S)).length} bytes (UTF-8)`;
+          } catch {
+            x.textContent = "(result not serializable)";
+          }
+        f.disabled = !1, h(), m();
+      }
+    }), p.querySelector(".dev-body").appendChild(t);
+  }
+  return m(), h(), () => {
+    u || (u = !0, e.off("stream:message", j), e.off("function:invoke", V), e.off("function:result", H), e.off("context:changed", U), e.off("conversation:loaded", B), p.remove(), g.remove());
+  };
+}
+var X = "ago-dev-panel-styles";
+function de() {
+  if (document.getElementById(X)) return;
+  const n = document.createElement("style");
+  n.id = X, n.textContent = se, document.head.appendChild(n);
+}
+var se = `
 .ago-dev-card {
   position: fixed;
   right: 16px;
@@ -133,7 +240,7 @@ var q = `
   cursor: pointer;
 }
 .ago-dev-card .dev-toggle:hover { color: #d7e0e8; border-color: #3a4655; }
-.ago-dev-card .dev-body { display: flex; flex-direction: column; gap: 8px; }
+.ago-dev-card .dev-body { display: flex; flex-direction: column; gap: 8px; min-height: 0; overflow-y: auto; }
 
 /* Collapsed: shrink to a small clickable widget showing only the badge. */
 .ago-dev-card.collapsed {
@@ -156,6 +263,11 @@ var q = `
 .ago-dev-card .dev-title { color: #f59e0b; font-size: 11px; line-height: 1.3; }
 .ago-dev-card .dev-fns { color: #7c8a99; font-size: 11px; }
 .ago-dev-card .dev-fns code { color: #9ecbff; }
+.ago-dev-card .dev-details { margin: 0; }
+.ago-dev-card .dev-details > summary { list-style: none; cursor: pointer; }
+.ago-dev-card .dev-details > summary::-webkit-details-marker { display: none; }
+.ago-dev-card .dev-details > summary::before { content: "▸ "; }
+.ago-dev-card .dev-details[open] > summary::before { content: "▾ "; }
 .ago-dev-card .dev-section-label {
   color: #7c8a99;
   text-transform: uppercase;
@@ -191,7 +303,47 @@ var q = `
 .ago-dev-card .dev-log-error { color: #fca5a5; }
 .ago-dev-card .dev-log-hydrate { color: #d8b4fe; }
 .ago-dev-card .dev-log-event { color: #7c8a99; }
+/* Function runner */
+.ago-dev-card .dev-runner { border-top: 1px solid #2a3441; padding-top: 8px; margin-top: 4px; }
+.ago-dev-card .dev-runner-warning { color: #f59e0b; font-size: 10px; margin-bottom: 4px; }
+.ago-dev-card .dev-runner-row { display: flex; gap: 6px; align-items: center; }
+.ago-dev-card .dev-runner-select {
+  flex: 1;
+  background: #060a0e; color: #d7e0e8; border: 1px solid #2a3441;
+  border-radius: 6px; padding: 4px 6px; font: inherit; font-size: 11px;
+}
+.ago-dev-card .dev-runner-btn {
+  background: #1a2633; color: #9ecbff; border: 1px solid #2a3441;
+  border-radius: 6px; padding: 4px 10px; font: inherit; font-size: 11px;
+  cursor: pointer;
+}
+.ago-dev-card .dev-runner-btn:hover { background: #243040; }
+.ago-dev-card .dev-runner-btn:disabled { opacity: .5; cursor: default; }
+.ago-dev-card .dev-runner-btn-sm { padding: 4px 8px; }
+.ago-dev-card .dev-runner-schema {
+  margin: 0; padding: 6px 8px; background: #060a0e;
+  border-radius: 6px; overflow: auto; max-height: 16vh;
+  white-space: pre; color: #7c8a99; font-size: 11px;
+}
+.ago-dev-card .dev-runner-args {
+  width: 100%; box-sizing: border-box; min-height: 48px; max-height: 20vh;
+  resize: vertical; background: #060a0e; color: #d7e0e8;
+  border: 1px solid #2a3441; border-radius: 6px; padding: 6px 8px;
+  font: inherit; font-size: 11px;
+}
+.ago-dev-card .dev-runner-status { font-size: 11px; margin-top: 4px; }
+.ago-dev-card .dev-runner-ok { color: #86efac; }
+.ago-dev-card .dev-runner-error { color: #fca5a5; }
+.ago-dev-card .dev-runner-result {
+  margin: 0; padding: 6px 8px; background: #060a0e;
+  border-radius: 6px; overflow: auto; max-height: 24vh;
+  white-space: pre-wrap; word-break: break-word;
+  color: #c8e6c9; font-size: 11px;
+}
+.ago-dev-card .dev-runner-result:empty { display: none; }
+.ago-dev-card .dev-runner-bytes { color: #7c8a99; font-size: 10px; margin-top: 2px; }
+.ago-dev-card .dev-runner-bytes:empty { display: none; }
 `;
 export {
-  z as initDevPanel
+  ce as initDevPanel
 };

package/dist/errors-BLfjXnLB.js

@@ -0,0 +1,32 @@
+var t = class extends Error {
+  constructor(s, r, e) {
+    super(s), this.code = r, this.statusCode = e, this.name = "AgoError";
+  }
+}, u = class a extends t {
+  constructor(r, e, o, n, c, i) {
+    super(r, e, o), this.type = n, this.param = c, this.docUrl = i, this.name = "AgoApiError";
+  }
+  static fromResponse(r, e) {
+    const o = r.error;
+    return new a(o.doc_url ? `${o.message} See ${o.doc_url}` : o.message, o.code, e, o.type, o.param, o.doc_url);
+  }
+}, g = class extends t {
+  constructor(s, r) {
+    super(s, "network_error"), this.originalError = r, this.name = "AgoNetworkError";
+  }
+}, m = class extends t {
+  constructor(s, r = "stream_error") {
+    super(s, r), this.name = "AgoStreamError";
+  }
+}, p = class extends t {
+  constructor(s, r, e) {
+    super(s, "function_error"), this.functionName = r, this.originalError = e, this.name = "AgoFunctionError";
+  }
+};
+export {
+  m as a,
+  g as i,
+  t as n,
+  p as r,
+  u as t
+};

package/dist/errors-o1IB5fEu.cjs

@@ -0,0 +1 @@
+var n=class extends Error{constructor(o,r,t){super(o),this.code=r,this.statusCode=t,this.name="AgoError"}},a=class s extends n{constructor(r,t,e,u,c,i){super(r,t,e),this.type=u,this.param=c,this.docUrl=i,this.name="AgoApiError"}static fromResponse(r,t){const e=r.error;return new s(e.doc_url?`${e.message} See ${e.doc_url}`:e.message,e.code,t,e.type,e.param,e.doc_url)}},g=class extends n{constructor(o,r){super(o,"network_error"),this.originalError=r,this.name="AgoNetworkError"}},m=class extends n{constructor(o,r="stream_error"){super(o,r),this.name="AgoStreamError"}},A=class extends n{constructor(o,r,t){super(o,"function_error"),this.functionName=r,this.originalError=t,this.name="AgoFunctionError"}};Object.defineProperty(exports,"AgoApiError",{enumerable:!0,get:function(){return a}});Object.defineProperty(exports,"AgoError",{enumerable:!0,get:function(){return n}});Object.defineProperty(exports,"AgoFunctionError",{enumerable:!0,get:function(){return A}});Object.defineProperty(exports,"AgoNetworkError",{enumerable:!0,get:function(){return g}});Object.defineProperty(exports,"AgoStreamError",{enumerable:!0,get:function(){return m}});

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./AgoClient-B_u_d-XS.cjs"),p=require("./autoContinue-CP9pJR-V.cjs"),E=require("./createConversationSession-BCdwAhLF.cjs"),f=require("./createFormCollector-ssBP8u0p.cjs"),S=require("./createMockClient-BSNuN3ys.cjs");require("./testing.cjs");const g=require("./functions-CPs7omgM.cjs");function w(e){return e}function y(e,o){return e.on("message:complete",o),()=>e.off("message:complete",o)}function v(e,o){return e.on("message:chunk",o),()=>e.off("message:chunk",o)}function F(e,o){return e.on("message:start",o),()=>e.off("message:start",o)}function b(e,o){return e.on("message:error",o),()=>e.off("message:error",o)}function M(e,o){return e.on("toolCall:received",o),()=>e.off("toolCall:received",o)}function T(e,o){return e.on("form:submitted",o),()=>e.off("form:submitted",o)}function q(e,o){return e.on("form:error",o),()=>e.off("form:error",o)}function I(e,o){return e.on("function:invoke",o),()=>e.off("function:invoke",o)}async function*_(e,o,l){const i=[];let n=null,a=!1;const c=s=>{i.push(s),n?.()},m=s=>c({type:"start",data:s}),r=s=>c({type:"chunk",data:s}),u=s=>{c({type:"complete",data:s}),a=!0,n?.()},d=s=>{c({type:"error",data:s}),a=!0,n?.()},A=s=>c({type:"toolCall",data:s}),h=()=>{a=!0,n?.()};e.on("message:start",m),e.on("message:chunk",r),e.on("message:complete",u),e.on("message:error",d),e.on("message:stopped",h),e.on("toolCall:received",A),e.sendMessage(o,l).catch(()=>{a=!0,n?.()});try{for(;!a||i.length>0;)i.length>0?yield i.shift():(await new Promise(s=>{n=s}),n=null)}finally{e.off("message:start",m),e.off("message:chunk",r),e.off("message:complete",u),e.off("message:error",d),e.off("message:stopped",h),e.off("toolCall:received",A)}}function C(e){let o,l,i,n,a,c;if(typeof window<"u"&&window.AGO){const r=window.AGO;o=r.basepath,l=r.widgetId,i=r.agent||r.defaultAgent,n=r.permission,a=r.email,c=r.jwt}if(typeof document<"u"){const r=u=>document.querySelector(`meta[name="${u}"]`)?.getAttribute("content")||void 0;o=o||r("ago-base-url"),l=l||r("ago-widget-id"),i=i||r("ago-agent")||r("ago-agent-id"),n=n||r("ago-permission"),a=a||r("ago-user-email")}if(typeof document<"u"){const r=[document.body,...Array.from(document.querySelectorAll("script[data-ago-base-url]"))].filter(Boolean);for(const u of r)u&&(o=o||u.getAttribute("data-ago-base-url")||void 0,l=l||u.getAttribute("data-ago-widget-id")||void 0,i=i||u.getAttribute("data-ago-agent")||u.getAttribute("data-ago-agent-id")||void 0,n=n||u.getAttribute("data-ago-permission")||void 0,a=a||u.getAttribute("data-ago-user-email")||void 0)}o=e?.baseUrl||o,l=e?.widgetId||l,i=e?.agent||e?.defaultAgentId||i,n=e?.permission||n,a=e?.userEmail||a,c=e?.userJwt||c;const m=e?.debug;return o?{baseUrl:o,widgetId:l,agent:i,permission:n,userEmail:a,userJwt:c,debug:m}:null}function k(e){const o=C(e);if(!o)throw new t.AgoError('createAgo(): could not detect AGO configuration. Set window.AGO, add <meta name="ago-base-url">, or pass { baseUrl } explicitly.',"config_missing_base_url");return new t.AgoClient(o)}function U(e,o){return{...e,handler:o}}exports.ActivityLedger=t.ActivityLedger;exports.AgoApiError=t.AgoApiError;exports.AgoClient=t.AgoClient;exports.AgoError=t.AgoError;exports.AgoFunctionError=t.AgoFunctionError;exports.AgoNetworkError=t.AgoNetworkError;exports.AgoStreamError=t.AgoStreamError;exports.ClientContextRegistry=t.ClientContextRegistry;exports.DEFAULT_MAX_ACTIVITY_ENTRIES=t.DEFAULT_MAX_ACTIVITY_ENTRIES;exports.EventEmitter=t.EventEmitter;exports.FunctionRegistry=t.FunctionRegistry;exports.SSEHandler=t.SSEHandler;exports.SignalCollector=t.SignalCollector;exports.attachAutoContinueAfterNavigation=p.attachAutoContinueAfterNavigation;exports.autoDetectConfig=C;exports.canInlineImage=t.canInlineImage;exports.copyToClipboard=g.copyToClipboard;exports.createAgo=k;exports.createAgoProactive=t.createAgoProactive;exports.createConversationSession=E.createConversationSession;exports.createFormCollector=f.createFormCollector;exports.createMessageStream=_;exports.createMockClient=S.createMockClient;exports.createStore=t.createStore;exports.defineFunction=w;exports.deriveFormStatus=f.deriveFormStatus;exports.formatFileSize=t.formatFileSize;exports.getLocalStorage=g.getLocalStorage;exports.getUserLocation=g.getUserLocation;exports.highlightElement=g.highlightElement;exports.isStreamNetworkError=t.isStreamNetworkError;exports.loadFormCollector=f.loadFormCollector;exports.logger=t.logger;exports.matchesRoutePattern=t.matchesRoutePattern;exports.matchesWhen=t.matchesWhen;exports.onFormError=q;exports.onFormSubmitted=T;exports.onFunctionInvoke=I;exports.onMessage=y;exports.onMessageChunk=v;exports.onMessageError=b;exports.onMessageStart=F;exports.onToolCall=M;exports.openUrl=g.openUrl;exports.partialDeepMatch=t.partialDeepMatch;exports.safeAttachmentUrl=t.safeAttachmentUrl;exports.scrollToElement=g.scrollToElement;exports.setLocalStorage=g.setLocalStorage;exports.setTheme=g.setTheme;exports.showConfirmDialog=g.showConfirmDialog;exports.showNotification=g.showNotification;exports.showToast=g.showToast;exports.submitForm=g.submitForm;exports.trackEvent=g.trackEvent;exports.validateConfig=t.validateConfig;exports.withHandler=U;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./types-D3YQl1jx.cjs"),m=require("./errors-o1IB5fEu.cjs"),E=require("./autoContinue-CP9pJR-V.cjs"),S=require("./createConversationSession-CU0b-t1W.cjs"),d=require("./createFormCollector-DfN1xZBy.cjs"),w=require("./createMockClient-BZbOe-23.cjs");require("./testing.cjs");const g=require("./functions-CPs7omgM.cjs");function y(e){return e}function F(e,o){return e.on("message:complete",o),()=>e.off("message:complete",o)}function v(e,o){return e.on("message:chunk",o),()=>e.off("message:chunk",o)}function b(e,o){return e.on("message:start",o),()=>e.off("message:start",o)}function M(e,o){return e.on("message:error",o),()=>e.off("message:error",o)}function T(e,o){return e.on("toolCall:received",o),()=>e.off("toolCall:received",o)}function q(e,o){return e.on("form:submitted",o),()=>e.off("form:submitted",o)}function _(e,o){return e.on("form:error",o),()=>e.off("form:error",o)}function I(e,o){return e.on("function:invoke",o),()=>e.off("function:invoke",o)}async function*k(e,o,l){const i=[];let n=null,a=!1;const c=s=>{i.push(s),n?.()},f=s=>c({type:"start",data:s}),r=s=>c({type:"chunk",data:s}),u=s=>{c({type:"complete",data:s}),a=!0,n?.()},A=s=>{c({type:"error",data:s}),a=!0,n?.()},C=s=>c({type:"toolCall",data:s}),h=()=>{a=!0,n?.()};e.on("message:start",f),e.on("message:chunk",r),e.on("message:complete",u),e.on("message:error",A),e.on("message:stopped",h),e.on("toolCall:received",C),e.sendMessage(o,l).catch(()=>{a=!0,n?.()});try{for(;!a||i.length>0;)i.length>0?yield i.shift():(await new Promise(s=>{n=s}),n=null)}finally{e.off("message:start",f),e.off("message:chunk",r),e.off("message:complete",u),e.off("message:error",A),e.off("message:stopped",h),e.off("toolCall:received",C)}}function p(e){let o,l,i,n,a,c;if(typeof window<"u"&&window.AGO){const r=window.AGO;o=r.basepath,l=r.widgetId,i=r.agent||r.defaultAgent,n=r.permission,a=r.email,c=r.jwt}if(typeof document<"u"){const r=u=>document.querySelector(`meta[name="${u}"]`)?.getAttribute("content")||void 0;o=o||r("ago-base-url"),l=l||r("ago-widget-id"),i=i||r("ago-agent")||r("ago-agent-id"),n=n||r("ago-permission"),a=a||r("ago-user-email")}if(typeof document<"u"){const r=[document.body,...Array.from(document.querySelectorAll("script[data-ago-base-url]"))].filter(Boolean);for(const u of r)u&&(o=o||u.getAttribute("data-ago-base-url")||void 0,l=l||u.getAttribute("data-ago-widget-id")||void 0,i=i||u.getAttribute("data-ago-agent")||u.getAttribute("data-ago-agent-id")||void 0,n=n||u.getAttribute("data-ago-permission")||void 0,a=a||u.getAttribute("data-ago-user-email")||void 0)}o=e?.baseUrl||o,l=e?.widgetId||l,i=e?.agent||e?.defaultAgentId||i,n=e?.permission||n,a=e?.userEmail||a,c=e?.userJwt||c;const f=e?.debug;return o?{baseUrl:o,widgetId:l,agent:i,permission:n,userEmail:a,userJwt:c,debug:f}:null}function N(e){const o=p(e);if(!o)throw new m.AgoError('createAgo(): could not detect AGO configuration. Set window.AGO, add <meta name="ago-base-url">, or pass { baseUrl } explicitly.',"config_missing_base_url");return new t.AgoClient(o)}function U(e,o){return{...e,handler:o}}exports.ActivityLedger=t.ActivityLedger;exports.AgoApiError=m.AgoApiError;exports.AgoClient=t.AgoClient;exports.AgoError=m.AgoError;exports.AgoFunctionError=m.AgoFunctionError;exports.AgoNetworkError=m.AgoNetworkError;exports.AgoStreamError=m.AgoStreamError;exports.ClientContextRegistry=t.ClientContextRegistry;exports.DEFAULT_MAX_ACTIVITY_ENTRIES=t.DEFAULT_MAX_ACTIVITY_ENTRIES;exports.EventEmitter=t.EventEmitter;exports.FEEDBACK_REASONS=t.FEEDBACK_REASONS;exports.FunctionRegistry=t.FunctionRegistry;exports.SSEHandler=t.SSEHandler;exports.SignalCollector=t.SignalCollector;exports.attachAutoContinueAfterNavigation=E.attachAutoContinueAfterNavigation;exports.autoDetectConfig=p;exports.canInlineImage=t.canInlineImage;exports.copyToClipboard=g.copyToClipboard;exports.createAgo=N;exports.createAgoProactive=t.createAgoProactive;exports.createConversationSession=S.createConversationSession;exports.createFormCollector=d.createFormCollector;exports.createMessageStream=k;exports.createMockClient=w.createMockClient;exports.createStore=t.createStore;exports.defineFunction=y;exports.deriveFormStatus=d.deriveFormStatus;exports.formatFileSize=t.formatFileSize;exports.getLocalStorage=g.getLocalStorage;exports.getUserLocation=g.getUserLocation;exports.highlightElement=g.highlightElement;exports.isStreamNetworkError=t.isStreamNetworkError;exports.loadFormCollector=d.loadFormCollector;exports.logger=t.logger;exports.matchesRoutePattern=t.matchesRoutePattern;exports.matchesWhen=t.matchesWhen;exports.onFormError=_;exports.onFormSubmitted=q;exports.onFunctionInvoke=I;exports.onMessage=F;exports.onMessageChunk=v;exports.onMessageError=M;exports.onMessageStart=b;exports.onToolCall=T;exports.openUrl=g.openUrl;exports.partialDeepMatch=t.partialDeepMatch;exports.safeAttachmentUrl=t.safeAttachmentUrl;exports.scrollToElement=g.scrollToElement;exports.setLocalStorage=g.setLocalStorage;exports.setTheme=g.setTheme;exports.showConfirmDialog=g.showConfirmDialog;exports.showNotification=g.showNotification;exports.showToast=g.showToast;exports.submitForm=g.submitForm;exports.trackEvent=g.trackEvent;exports.validateConfig=t.validateConfig;exports.withHandler=U;

package/dist/index.d.cts

@@ -312,9 +312,40 @@ export declare class AgoClient {
      */
     submitFormCollector(name: string, values: Record<string, unknown>): Promise<unknown>;
     /**
-     * Submit feedback for a message
+     * Report an answer: thumbs up/down, optionally with what went wrong.
+     *
+     * ```ts
+     * await client.submitFeedback(message.id, "negative", {
+     *   reasons: ["inaccurate"],
+     *   comment: "The price it quoted is from last year.",
+     * });
+     * ```
+     *
+     * A bare rating is a reaction (the thumbs counted in the dashboard). Adding a
+     * reason or a comment also files it in the feedback list, the analytics and
+     * the CSV export, so someone can act on it.
+     */
+    submitFeedback(messageId: string, rating: FeedbackRating, details?: FeedbackDetails): Promise<void>;
+    /**
+     * Report a whole conversation ("this chat is not working").
+     *
+     * ```ts
+     * await client.submitConversationFeedback(conversationId, "negative", {
+     *   reasons: ["information_not_found"],
+     *   comment: "It never answered my question.",
+     * });
+     * ```
+     *
+     * Feedback is stored per message, so this attaches the report to the last
+     * answer of the conversation, which is the one the user is reacting to.
+     * Returns the message id it landed on.
+     *
+     * Pass `lastMessageId` when you already have it (the widget does) to skip the
+     * lookup round-trip.
      */
-    submitFeedback(messageId: string, rating: "positive" | "negative"): Promise<void>;
+    submitConversationFeedback(conversationId: string, rating: FeedbackRating, details?: FeedbackDetails & {
+        lastMessageId?: string;
+    }): Promise<string>;
     /**
      * Register a client-side function that AGO can call.
      * Accepts either a definition object or (name, handler, schema) args.
@@ -919,6 +950,14 @@ export declare interface AgoPageDataSource<T = unknown> {
     maxResultBytes?: number;
 }
 
+/** The verdict part of a setPageState answer, without the page snapshot. */
+export declare interface AgoPageStateEnvelope {
+    success: boolean;
+    applied: string[];
+    unchanged: string[];
+    rejected?: Record<string, string>;
+}
+
 /**
  * Options for {@link AgoClient.registerPageStateFunction}.
  */
@@ -949,6 +988,15 @@ export declare interface AgoPageStateOptions {
     settleTimeoutMs?: number;
 }
 
+/**
+ * What `setPageState` answers the agent. Every non-dropped field the agent sent
+ * is accounted for by name, so it can tell a change it made from one that was
+ * already true. Dropped placeholders are intentionally omitted.
+ */
+export declare interface AgoPageStateResult<TData = unknown> extends AgoPageStateEnvelope {
+    data?: TData;
+}
+
 /**
  * Knowledge source citation
  */
@@ -978,12 +1026,27 @@ export declare interface AgoStateControl<T = unknown> {
             enum?: (string | number)[];
         };
     };
+    /** String-only: `""` means "clear" instead of being dropped as filler. */
+    clearable?: boolean;
     /** Current value → pushed as dynamic context so the agent knows what to change. */
     get?: () => T;
     /** Apply the state change on the page. May be async. */
-    set: (value: T) => void | Promise<void>;
+    set: (value: T) => void | AgoStateSetResult | Promise<void | AgoStateSetResult>;
 }
 
+/**
+ * Tagged outcome a page setter may return to reject or mark unchanged.
+ *
+ * Returning nothing (void) means APPLY. Returning an unrecognized JS value
+ * (e.g. a string from an assignment expression) is also treated as APPLY.
+ */
+export declare type AgoStateSetResult = {
+    result: "rejected";
+    reason: string;
+} | {
+    result: "unchanged";
+};
+
 /**
  * SSE stream error
  *
@@ -1564,6 +1627,40 @@ export declare class EventEmitter<Events extends Record<string, any> = Record<st
 
 declare type EventHandler<T = unknown> = (data: T) => void;
 
+/** The four values of {@link FeedbackReason}, in dashboard order. */
+export declare const FEEDBACK_REASONS: readonly FeedbackReason[];
+
+/**
+ * Why the user is reporting a message (see `AgoClient.submitFeedback`).
+ *
+ * A rating on its own is a reaction (the thumbs count). Add a reason or a
+ * comment and the report also lands in the feedback dashboard, the analytics
+ * and the CSV export, where someone can act on it.
+ */
+export declare interface FeedbackDetails {
+    /** What went wrong. Several can apply at once. */
+    reasons?: FeedbackReason[];
+    /** The user's own words. Trimmed server-side; 5000 characters max. */
+    comment?: string;
+}
+
+/** Thumbs up / thumbs down on an answer. */
+export declare type FeedbackRating = "positive" | "negative";
+
+/**
+ * What went wrong with an answer. These are the four buckets the AGO feedback
+ * dashboard filters and charts on.
+ */
+export declare type FeedbackReason = 
+/** The answer states something false. */
+"inaccurate"
+/** The answer is right but stops short. */
+| "incomplete"
+/** The agent could not find the information. */
+| "information_not_found"
+/** Something broke: the widget, a tool call, the stream. */
+| "technical_issue";
+
 /** Human-readable file size (e.g. "12.3 KB"). Empty string when size is unknown. */
 export declare function formatFileSize(bytes?: number): string;