@useago/sdk 0.4.6 → 1.0.0

package/dist/{createFormCollector-DON4vdJV.js → createFormCollector-CPS2phYq.js}

@@ -1,23 +1,23 @@
-import { s as _ } from "./AgoClient-rvTz2thR.js";
+import { s as _ } from "./AgoClient-BrYhSO5M.js";
 function E(n, e) {
   const l = e ? e.storage ?? (typeof localStorage < "u" ? localStorage : void 0) : void 0;
-  let t = n;
+  let r = n;
   if (e && l) try {
     const c = l.getItem(e.key);
-    c != null && (t = JSON.parse(c));
+    c != null && (r = JSON.parse(c));
   } catch {
   }
-  const i = /* @__PURE__ */ new Set(), f = () => i.forEach((c) => c(t));
+  const i = /* @__PURE__ */ new Set(), f = () => i.forEach((c) => c(r));
   function m() {
     if (e && l) try {
-      l.setItem(e.key, JSON.stringify(t));
+      l.setItem(e.key, JSON.stringify(r));
     } catch {
     }
   }
   return {
-    get: () => t,
+    get: () => r,
     set: (c) => {
-      t = c, m(), f();
+      r = c, m(), f();
     },
     subscribe: (c) => (i.add(c), () => {
       i.delete(c);
@@ -30,29 +30,29 @@ function F(n, e) {
   if (O(l)) return !1;
   if (Array.isArray(n.value)) return n.value.some((f) => String(l) === String(f));
   if (!n.op) return String(l) === String(n.value);
-  const t = Number(l), i = Number(n.value);
-  if (Number.isNaN(t) || Number.isNaN(i)) return !1;
+  const r = Number(l), i = Number(n.value);
+  if (Number.isNaN(r) || Number.isNaN(i)) return !1;
   switch (n.op) {
     case ">=":
-      return t >= i;
+      return r >= i;
     case "<=":
-      return t <= i;
+      return r <= i;
     case ">":
-      return t > i;
+      return r > i;
     case "<":
-      return t < i;
+      return r < i;
     default:
       return _.warn(`Unknown requiredWhen op "${n.op}"; treating as not required.`), !1;
   }
 }
 function y(n, e) {
-  const l = n.properties ?? {}, t = /* @__PURE__ */ new Set();
+  const l = n.properties ?? {}, r = /* @__PURE__ */ new Set();
   for (const f of n.required ?? []) {
     const m = l[f]?.requiredWhen;
-    (!m || F(m, e)) && t.add(f);
+    (!m || F(m, e)) && r.add(f);
   }
-  for (const [f, m] of Object.entries(l)) m.requiredWhen && F(m.requiredWhen, e) && t.add(f);
-  const i = [...t].filter((f) => O(e[f]));
+  for (const [f, m] of Object.entries(l)) m.requiredWhen && F(m.requiredWhen, e) && r.add(f);
+  const i = [...r].filter((f) => O(e[f]));
   return {
     missing: i,
     complete: i.length === 0
@@ -60,11 +60,11 @@ function y(n, e) {
 }
 function P(n) {
   const e = {};
-  for (const [l, t] of Object.entries(n.properties ?? {})) e[l] = {
-    type: t.type,
-    ...t.description != null && { description: t.description },
-    ...t.enum && { enum: t.enum },
-    ...t.default !== void 0 && { default: t.default }
+  for (const [l, r] of Object.entries(n.properties ?? {})) e[l] = {
+    type: r.type,
+    ...r.description != null && { description: r.description },
+    ...r.enum && { enum: r.enum },
+    ...r.default !== void 0 && { default: r.default }
   };
   return {
     type: "object",
@@ -73,14 +73,14 @@ function P(n) {
   };
 }
 function I(n) {
-  const { name: e, description: l, schema: t } = n;
+  const { name: e, description: l, schema: r } = n;
   if (!q.test(e)) throw new Error(`Invalid form collector name "${e}": must match ${q} (it becomes the update_/submit_ function names).`);
   const i = typeof n.submit == "string" ? n.submit ? {
     via: "client",
     url: n.submit
-  } : !1 : n.submit ?? !1, f = t.properties ?? {}, m = (r) => {
+  } : !1 : n.submit ?? !1, f = r.properties ?? {}, m = (t) => {
     const s = {};
-    for (const [a, o] of Object.entries(r)) {
+    for (const [a, o] of Object.entries(t)) {
       const u = f[a];
       if (u)
         if (o == null) s[a] = o;
@@ -93,19 +93,19 @@ function I(n) {
   }, c = n.initialValues ?? {}, d = E({
     values: c,
     submitted: !1
-  }), v = (r) => {
+  }), v = (t) => {
     const s = d.get(), a = {
       ...s,
       values: {
         ...s.values,
-        ...r
+        ...t
       }
     };
     return d.set(a), a;
   };
   let h = null;
   const N = async () => {
-    const { values: r } = d.get(), { complete: s, missing: a } = y(t, r);
+    const { values: t } = d.get(), { complete: s, missing: a } = y(r, t);
     if (!s) return {
       ok: !1,
       missing: a
@@ -114,7 +114,7 @@ function I(n) {
       ok: !1,
       error: "No submit target configured for this form collector."
     };
-    const o = r;
+    const o = t;
     try {
       let u;
       if (i.via === "client") if ("handler" in i) u = await i.handler(o);
@@ -156,9 +156,9 @@ function I(n) {
   }, $ = {
     name: `update_${e}`,
     description: `Fill or update fields of the "${e}" form. ${l} Pass any subset of fields; call it repeatedly to fill the form as the user provides information. Returns the current values and which required fields are still missing.`,
-    parameters: P(t),
-    handler: (r) => {
-      const s = v(m(r)), { missing: a } = y(t, s.values);
+    parameters: P(r),
+    handler: (t) => {
+      const s = v(m(t)), { missing: a } = y(r, s.values);
       return {
         ok: !0,
         values: s.values,
@@ -175,13 +175,13 @@ function I(n) {
     },
     handler: () => N()
   });
-  const T = "client__", S = i ? `submit_${e}` : null, x = (r) => {
-    const s = r.functionName ?? r.toolName;
+  const T = "client__", S = i ? `submit_${e}` : null, x = (t) => {
+    const s = t.functionName ?? t.toolName;
     if (s)
       return s.startsWith(T) ? s.slice(8) : s;
-  }, w = (r) => {
+  }, w = (t) => {
     let s = { ...c }, a = !1;
-    for (const o of r) {
+    for (const o of t) {
       const u = x(o);
       u === $.name ? o.arguments && (s = {
         ...s,
@@ -193,18 +193,19 @@ function I(n) {
       submitted: a
     });
   }, g = `form:${e}`, C = () => {
-    const { values: r, submitted: s } = d.get(), { missing: a, complete: o } = y(t, r), u = i ? ` When nothing is missing and the user confirms, call submit_${e}.` : "", p = s ? `The "${e}" form has been submitted.` : `You are currently collecting information from the user to fill the "${e}" form.`;
+    const { values: t, submitted: s } = d.get(), { missing: a, complete: o } = y(r, t), u = i ? ` When nothing is missing and the user confirms, call submit_${e}.` : "", p = s ? `The "${e}" form has been submitted.` : `You are currently collecting information from the user to fill the "${e}" form.`;
     return {
       name: `Form: ${e}`,
-      description: `${p} ${l} There are conditionnals questions/values to collected, you can find this information with the requiredWhen field in the form. The form schema is the following: ${JSON.stringify(t)}. Data collected so far: ${JSON.stringify(r)}. Call update_${e} with any fields the user provides; ask only for what is still missing.${u}`,
+      description: `${p} ${l} There are conditionnals questions/values to collected, you can find this information with the requiredWhen field in the form. The form schema is the following: ${JSON.stringify(r)}. Data collected so far: ${JSON.stringify(t)}. Call update_${e} with any fields the user provides; ask only for what is still missing.${u}`,
       data: {
+        values: t,
         missing: a,
         complete: o,
         submitted: s
       }
     };
-  }, k = (r) => {
-    w((r.messages ?? []).flatMap((s) => s.toolCalls ?? []));
+  }, k = (t) => {
+    w((t.messages ?? []).flatMap((s) => s.toolCalls ?? []));
   };
   return {
     name: e,
@@ -212,22 +213,22 @@ function I(n) {
     functions: b,
     contextKey: g,
     contextProvider: C,
-    install: (r) => {
-      h = r;
-      for (const a of b) r.register(a);
-      r.addDynamicContext(g, C);
-      const s = d.subscribe(() => r.notifyContextChanged());
-      return r.on("conversation:loaded", k), () => {
+    install: (t) => {
+      h = t;
+      for (const a of b) t.register(a);
+      t.addDynamicContext(g, C);
+      const s = d.subscribe(() => t.notifyContextChanged());
+      return t.on("conversation:loaded", k), () => {
         s();
-        for (const a of b) r.unregisterFunction(a.name);
-        r.removeDynamicContext(g), r.off("conversation:loaded", k), h === r && (h = null);
+        for (const a of b) t.unregisterFunction(a.name);
+        t.removeDynamicContext(g), t.off("conversation:loaded", k), h === t && (h = null);
       };
     },
     hydrate: w,
     submit: N,
     getValues: () => d.get().values,
-    setValues: (r) => {
-      v(m(r));
+    setValues: (t) => {
+      v(m(t));
     },
     reset: () => {
       d.set({

package/dist/createFormCollector-DaWZsBsI.cjs

@@ -0,0 +1 @@
+const O=require("./AgoClient-CPqPT5s6.cjs");function _(o,e){const l=e?e.storage??(typeof localStorage<"u"?localStorage:void 0):void 0;let r=o;if(e&&l)try{const c=l.getItem(e.key);c!=null&&(r=JSON.parse(c))}catch{}const i=new Set,f=()=>i.forEach(c=>c(r));function m(){if(e&&l)try{l.setItem(e.key,JSON.stringify(r))}catch{}}return{get:()=>r,set:c=>{r=c,m(),f()},subscribe:c=>(i.add(c),()=>{i.delete(c)})}}var q=/^[a-zA-Z0-9_-]{1,40}$/,P=o=>o==null||o==="";function F(o,e){const l=e[o.property];if(P(l))return!1;if(Array.isArray(o.value))return o.value.some(f=>String(l)===String(f));if(!o.op)return String(l)===String(o.value);const r=Number(l),i=Number(o.value);if(Number.isNaN(r)||Number.isNaN(i))return!1;switch(o.op){case">=":return r>=i;case"<=":return r<=i;case">":return r>i;case"<":return r<i;default:return O.logger.warn(`Unknown requiredWhen op "${o.op}"; treating as not required.`),!1}}function g(o,e){const l=o.properties??{},r=new Set;for(const f of o.required??[]){const m=l[f]?.requiredWhen;(!m||F(m,e))&&r.add(f)}for(const[f,m]of Object.entries(l))m.requiredWhen&&F(m.requiredWhen,e)&&r.add(f);const i=[...r].filter(f=>P(e[f]));return{missing:i,complete:i.length===0}}function E(o){const e={};for(const[l,r]of Object.entries(o.properties??{}))e[l]={type:r.type,...r.description!=null&&{description:r.description},...r.enum&&{enum:r.enum},...r.default!==void 0&&{default:r.default}};return{type:"object",properties:e,required:[]}}function W(o){const{name:e,description:l,schema:r}=o;if(!q.test(e))throw new Error(`Invalid form collector name "${e}": must match ${q} (it becomes the update_/submit_ function names).`);const i=typeof o.submit=="string"?o.submit?{via:"client",url:o.submit}:!1:o.submit??!1,f=r.properties??{},m=t=>{const n={};for(const[a,s]of Object.entries(t)){const u=f[a];if(u)if(s==null)n[a]=s;else if(u.type==="number"||u.type==="integer"){const b=typeof s=="number"?s:Number(s);n[a]=Number.isNaN(b)?s:b}else u.type==="boolean"?n[a]=typeof s=="boolean"?s:s==="true"?!0:s==="false"?!1:!!s:n[a]=s}return n},c=o.initialValues??{},d=_({values:c,submitted:!1}),v=t=>{const n=d.get(),a={...n,values:{...n.values,...t}};return d.set(a),a};let p=null;const N=async()=>{const{values:t}=d.get(),{complete:n,missing:a}=g(r,t);if(!n)return{ok:!1,missing:a};if(!i)return{ok:!1,error:"No submit target configured for this form collector."};const s=t;try{let u;if(i.via==="client")if("handler"in i)u=await i.handler(s);else{const b=await fetch(i.url,{method:"POST",headers:{"Content-Type":"application/json"},credentials:"include",body:JSON.stringify(s)});if(!b.ok)return{ok:!1,error:`Submit failed: HTTP ${b.status}`};u=await b.json().catch(()=>{})}else{if(!p)return{ok:!1,error:"Backend submit requires install(client) (or useFormCollector) first."};u=await p.submitFormCollector(i.destination,s)}return d.set({...d.get(),submitted:!0}),{ok:!0,result:u}}catch(u){const b=u instanceof Error?u.message:"Submit failed";return O.logger.error(`FormCollector "${e}" submit failed:`,u),{ok:!1,error:b}}},S={name:`update_${e}`,description:`Fill or update fields of the "${e}" form. ${l} Pass any subset of fields; call it repeatedly to fill the form as the user provides information. Returns the current values and which required fields are still missing.`,parameters:E(r),handler:t=>{const n=v(m(t)),{missing:a}=g(r,n.values);return{ok:!0,values:n.values,missing:a}}},h=[S];i&&h.push({name:`submit_${e}`,description:`Submit the completed "${e}" form. Only call this once every required field is collected and the user has confirmed. If fields are missing it returns them instead of submitting.`,parameters:{type:"object",properties:{}},handler:()=>N()});const T="client__",$=i?`submit_${e}`:null,j=t=>{const n=t.functionName??t.toolName;if(n)return n.startsWith(T)?n.slice(8):n},w=t=>{let n={...c},a=!1;for(const s of t){const u=j(s);u===S.name?s.arguments&&(n={...n,...m(s.arguments)}):$&&u===$&&s.status?.toLowerCase()==="done"&&(a=!0)}d.set({values:n,submitted:a})},y=`form:${e}`,C=()=>{const{values:t,submitted:n}=d.get(),{missing:a,complete:s}=g(r,t),u=i?` When nothing is missing and the user confirms, call submit_${e}.`:"",b=n?`The "${e}" form has been submitted.`:`You are currently collecting information from the user to fill the "${e}" form.`;return{name:`Form: ${e}`,description:`${b} ${l} There are conditionnals questions/values to collected, you can find this information with the requiredWhen field in the form. The form schema is the following: ${JSON.stringify(r)}. Data collected so far: ${JSON.stringify(t)}. Call update_${e} with any fields the user provides; ask only for what is still missing.${u}`,data:{values:t,missing:a,complete:s,submitted:n}}},k=t=>{w((t.messages??[]).flatMap(n=>n.toolCalls??[]))};return{name:e,store:d,functions:h,contextKey:y,contextProvider:C,install:t=>{p=t;for(const a of h)t.register(a);t.addDynamicContext(y,C);const n=d.subscribe(()=>t.notifyContextChanged());return t.on("conversation:loaded",k),()=>{n();for(const a of h)t.unregisterFunction(a.name);t.removeDynamicContext(y),t.off("conversation:loaded",k),p===t&&(p=null)}},hydrate:w,submit:N,getValues:()=>d.get().values,setValues:t=>{v(m(t))},reset:()=>{d.set({values:c,submitted:!1})}}}Object.defineProperty(exports,"createFormCollector",{enumerable:!0,get:function(){return W}});Object.defineProperty(exports,"createStore",{enumerable:!0,get:function(){return _}});Object.defineProperty(exports,"deriveFormStatus",{enumerable:!0,get:function(){return g}});

package/dist/devtools.cjs

@@ -1,17 +1,17 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var c,d,v=()=>({});function i(){c&&(c.textContent=JSON.stringify(v(),null,2))}function s(l,e){if(!d)return;const o=document.createElement("div");o.className=`dev-log-line dev-log-${e}`,o.textContent=`${new Date().toLocaleTimeString()}  ${l}`,d.appendChild(o),d.scrollTop=d.scrollHeight}var x="ago_dev_panel_collapsed";function r(l,e){l.classList.toggle("collapsed",e);const o=l.querySelector(".dev-toggle");o&&(o.textContent=e?"▢":"—",o.title=e?"Expand dev tools":"Collapse dev tools",o.setAttribute("aria-expanded",String(!e)));try{localStorage.setItem(x,e?"1":"0")}catch{}}function h(l){const{client:e,target:o}=l;v=()=>e.getContextSnapshot()?.entries??{},b();const u=typeof o=="string"?document.querySelector(o):o instanceof Element?o:document.body,t=document.createElement("aside");t.id="ago-dev-panel",(u??document.body).appendChild(t),t.innerHTML=`
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var p,d,x=()=>({});function i(){p&&(p.textContent=JSON.stringify(x(),null,2))}function s(n,e){if(!d)return;const o=document.createElement("div");o.className=`dev-log-line dev-log-${e}`,o.textContent=`${new Date().toLocaleTimeString()}  ${n}`,d.appendChild(o),d.scrollTop=d.scrollHeight}var u="ago_dev_panel_collapsed";function c(n,e){n.classList.toggle("collapsed",e);const o=n.querySelector(".dev-toggle");o&&(o.textContent=e?"▢":"—",o.title=e?"Expand dev tools":"Collapse dev tools",o.setAttribute("aria-expanded",String(!e)));try{localStorage.setItem(u,e?"1":"0")}catch{}}function h(n){const{client:e,target:o}=n;x=()=>{const t=e.getContextSnapshot()?.entries??{};return Object.fromEntries(Object.entries(t).map(([l,{name:r,data:b}])=>[l,{name:r,data:b}]))},m();const f=typeof o=="string"?document.querySelector(o):o instanceof Element?o:document.body,a=document.createElement("aside");a.id="ago-dev-panel",(f??document.body).appendChild(a),a.innerHTML=`
     <div class="dev-head">
       <span class="dev-badge">DEV</span>
       <span class="dev-title">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>${(e.getRegisteredFunctions?.()??[]).map(a=>a.name).join(", ")||"—"}</code></div>
+      <div class="dev-fns">Registered functions: <code>${(e.getRegisteredFunctions?.()??[]).map(t=>t.name).join(", ")||"—"}</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>
-  `,c=t.querySelector("#ago-dev-state"),d=t.querySelector("#ago-dev-log"),t.querySelector(".dev-toggle")?.addEventListener("click",a=>{a.stopPropagation(),r(t,!t.classList.contains("collapsed"))}),t.addEventListener("click",()=>{t.classList.contains("collapsed")&&r(t,!1)});let p=!1;try{p=localStorage.getItem(x)==="1"}catch{}r(t,p),e.on("function:invoke",({functionName:a,arguments:n})=>{s(`→ ${a}(${JSON.stringify(n??{})})`,"invoke")}),e.on("function:result",({result:a,error:n})=>{s(n?`✗ error: ${n}`:`← ${JSON.stringify(a)}`,n?"error":"result"),i()}),e.on("context:changed",i),e.on("conversation:loaded",a=>{const n=(a.messages??[]).flatMap(f=>f.toolCalls??[]);s(`⟳ hydrated "${a.title||a.id}" — replayed ${n.length} tool call${n.length===1?"":"s"}`,"hydrate"),i()}),i()}var g="ago-dev-panel-styles";function b(){if(document.getElementById(g))return;const l=document.createElement("style");l.id=g,l.textContent=m,document.head.appendChild(l)}var m=`
+  `,p=a.querySelector("#ago-dev-state"),d=a.querySelector("#ago-dev-log"),a.querySelector(".dev-toggle")?.addEventListener("click",t=>{t.stopPropagation(),c(a,!a.classList.contains("collapsed"))}),a.addEventListener("click",()=>{a.classList.contains("collapsed")&&c(a,!1)});let g=!1;try{g=localStorage.getItem(u)==="1"}catch{}c(a,g),e.on("function:invoke",({functionName:t,arguments:l})=>{s(`→ ${t}(${JSON.stringify(l??{})})`,"invoke")}),e.on("function:result",({result:t,error:l})=>{s(l?`✗ error: ${l}`:`← ${JSON.stringify(t)}`,l?"error":"result"),i()}),e.on("context:changed",i),e.on("conversation:loaded",t=>{const l=(t.messages??[]).flatMap(r=>r.toolCalls??[]);s(`⟳ hydrated "${t.title||t.id}" — replayed ${l.length} tool call${l.length===1?"":"s"}`,"hydrate"),i()}),i()}var v="ago-dev-panel-styles";function m(){if(document.getElementById(v))return;const n=document.createElement("style");n.id=v,n.textContent=y,document.head.appendChild(n)}var y=`
 #ago-dev-panel {
   position: fixed;
   top: 16px;

package/dist/devtools.d.cts

@@ -216,6 +216,11 @@ declare interface AgoClientEvents {
         conversationId: string;
         messageId: string;
     };
+    /**
+     * The main answer text is done (backend emitted `status: "DONE"`), but follow-up
+     * replies may still be pending. Fires once, before `message:complete`.
+     */
+    "message:answer-complete": AgoMessage;
     "message:complete": AgoMessage;
     "message:error": {
         error: string;
@@ -379,8 +384,8 @@ declare interface Conversation {
 export declare interface DevPanelOptions {
     /**
      * The AGO client to debug. The panel lists its registered functions, logs its
-     * function events, and renders its live context snapshot
-     * (`client.getContextSnapshot()`)
+     * function events, and renders the name + data of each entry in its live context
+     * snapshot (`client.getContextSnapshot()`)
      */
     client: Pick<AgoClient, "on" | "getRegisteredFunctions" | "getContextSnapshot">;
     /** Where to mount: a CSS selector, an Element, or `document.body` (default). */

package/dist/devtools.d.ts

@@ -216,6 +216,11 @@ declare interface AgoClientEvents {
         conversationId: string;
         messageId: string;
     };
+    /**
+     * The main answer text is done (backend emitted `status: "DONE"`), but follow-up
+     * replies may still be pending. Fires once, before `message:complete`.
+     */
+    "message:answer-complete": AgoMessage;
     "message:complete": AgoMessage;
     "message:error": {
         error: string;
@@ -379,8 +384,8 @@ declare interface Conversation {
 export declare interface DevPanelOptions {
     /**
      * The AGO client to debug. The panel lists its registered functions, logs its
-     * function events, and renders its live context snapshot
-     * (`client.getContextSnapshot()`)
+     * function events, and renders the name + data of each entry in its live context
+     * snapshot (`client.getContextSnapshot()`)
      */
     client: Pick<AgoClient, "on" | "getRegisteredFunctions" | "getContextSnapshot">;
     /** Where to mount: a CSS selector, an Element, or `document.body` (default). */

package/dist/devtools.js

@@ -1,65 +1,71 @@
-var c, d, v = () => ({});
+var p, d, x = () => ({});
 function i() {
-  c && (c.textContent = JSON.stringify(v(), null, 2));
+  p && (p.textContent = JSON.stringify(x(), null, 2));
 }
-function s(l, e) {
+function r(n, e) {
   if (!d) return;
   const o = document.createElement("div");
-  o.className = `dev-log-line dev-log-${e}`, o.textContent = `${(/* @__PURE__ */ new Date()).toLocaleTimeString()}  ${l}`, d.appendChild(o), d.scrollTop = d.scrollHeight;
+  o.className = `dev-log-line dev-log-${e}`, o.textContent = `${(/* @__PURE__ */ new Date()).toLocaleTimeString()}  ${n}`, d.appendChild(o), d.scrollTop = d.scrollHeight;
 }
-var x = "ago_dev_panel_collapsed";
-function r(l, e) {
-  l.classList.toggle("collapsed", e);
-  const o = l.querySelector(".dev-toggle");
+var f = "ago_dev_panel_collapsed";
+function c(n, e) {
+  n.classList.toggle("collapsed", e);
+  const o = n.querySelector(".dev-toggle");
   o && (o.textContent = e ? "▢" : "—", o.title = e ? "Expand dev tools" : "Collapse dev tools", o.setAttribute("aria-expanded", String(!e)));
   try {
-    localStorage.setItem(x, e ? "1" : "0");
+    localStorage.setItem(f, e ? "1" : "0");
   } catch {
   }
 }
-function m(l) {
-  const { client: e, target: o } = l;
-  v = () => e.getContextSnapshot()?.entries ?? {}, h();
-  const f = typeof o == "string" ? document.querySelector(o) : o instanceof Element ? o : document.body, t = document.createElement("aside");
-  t.id = "ago-dev-panel", (f ?? document.body).appendChild(t), t.innerHTML = `
+function y(n) {
+  const { client: e, target: o } = n;
+  x = () => {
+    const t = e.getContextSnapshot()?.entries ?? {};
+    return Object.fromEntries(Object.entries(t).map(([l, { name: s, data: h }]) => [l, {
+      name: s,
+      data: h
+    }]));
+  }, b();
+  const u = typeof o == "string" ? document.querySelector(o) : o instanceof Element ? o : document.body, a = document.createElement("aside");
+  a.id = "ago-dev-panel", (u ?? document.body).appendChild(a), a.innerHTML = `
     <div class="dev-head">
       <span class="dev-badge">DEV</span>
       <span class="dev-title">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>${(e.getRegisteredFunctions?.() ?? []).map((a) => a.name).join(", ") || "—"}</code></div>
+      <div class="dev-fns">Registered functions: <code>${(e.getRegisteredFunctions?.() ?? []).map((t) => t.name).join(", ") || "—"}</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>
-  `, c = t.querySelector("#ago-dev-state"), d = t.querySelector("#ago-dev-log"), t.querySelector(".dev-toggle")?.addEventListener("click", (a) => {
-    a.stopPropagation(), r(t, !t.classList.contains("collapsed"));
-  }), t.addEventListener("click", () => {
-    t.classList.contains("collapsed") && r(t, !1);
+  `, p = a.querySelector("#ago-dev-state"), d = a.querySelector("#ago-dev-log"), a.querySelector(".dev-toggle")?.addEventListener("click", (t) => {
+    t.stopPropagation(), c(a, !a.classList.contains("collapsed"));
+  }), a.addEventListener("click", () => {
+    a.classList.contains("collapsed") && c(a, !1);
   });
-  let p = !1;
+  let g = !1;
   try {
-    p = localStorage.getItem(x) === "1";
+    g = localStorage.getItem(f) === "1";
   } catch {
   }
-  r(t, p), e.on("function:invoke", ({ functionName: a, arguments: n }) => {
-    s(`→ ${a}(${JSON.stringify(n ?? {})})`, "invoke");
-  }), e.on("function:result", ({ result: a, error: n }) => {
-    s(n ? `✗ error: ${n}` : `← ${JSON.stringify(a)}`, n ? "error" : "result"), i();
-  }), e.on("context:changed", i), e.on("conversation:loaded", (a) => {
-    const n = (a.messages ?? []).flatMap((u) => u.toolCalls ?? []);
-    s(`⟳ hydrated "${a.title || a.id}" — replayed ${n.length} tool call${n.length === 1 ? "" : "s"}`, "hydrate"), i();
+  c(a, g), e.on("function:invoke", ({ functionName: t, arguments: l }) => {
+    r(`→ ${t}(${JSON.stringify(l ?? {})})`, "invoke");
+  }), e.on("function:result", ({ result: t, error: l }) => {
+    r(l ? `✗ error: ${l}` : `← ${JSON.stringify(t)}`, l ? "error" : "result"), i();
+  }), e.on("context:changed", i), e.on("conversation:loaded", (t) => {
+    const l = (t.messages ?? []).flatMap((s) => s.toolCalls ?? []);
+    r(`⟳ hydrated "${t.title || t.id}" — replayed ${l.length} tool call${l.length === 1 ? "" : "s"}`, "hydrate"), i();
   }), i();
 }
-var g = "ago-dev-panel-styles";
-function h() {
-  if (document.getElementById(g)) return;
-  const l = document.createElement("style");
-  l.id = g, l.textContent = b, document.head.appendChild(l);
+var v = "ago-dev-panel-styles";
+function b() {
+  if (document.getElementById(v)) return;
+  const n = document.createElement("style");
+  n.id = v, n.textContent = m, document.head.appendChild(n);
 }
-var b = `
+var m = `
 #ago-dev-panel {
   position: fixed;
   top: 16px;
@@ -156,5 +162,5 @@ var b = `
 #ago-dev-panel .dev-log-hydrate { color: #d8b4fe; }
 `;
 export {
-  m as initDevPanel
+  y as initDevPanel
 };

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("./AgoClient-D4EL6nva.cjs"),m=require("./createFormCollector-IO6bfPQx.cjs"),A=require("./createConversationSession-DGcM_Z3f.cjs"),C=require("./createMockClient-zHQ0cjUH.cjs"),g=require("./functions-DsmzgHjC.cjs");function h(e){return e}function E(e,o){return e.on("message:complete",o),()=>e.off("message:complete",o)}function S(e,o){return e.on("message:chunk",o),()=>e.off("message:chunk",o)}function y(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 v(e,o){return e.on("toolCall:received",o),()=>e.off("toolCall:received",o)}function M(e,o){return e.on("function:invoke",o),()=>e.off("function:invoke",o)}async function*k(e,o,l){const n=[];let r=null,a=!1;const c=s=>{n.push(s),r?.()},f=s=>c({type:"start",data:s}),t=s=>c({type:"chunk",data:s}),u=s=>{c({type:"complete",data:s}),a=!0,r?.()},d=s=>{c({type:"error",data:s}),a=!0,r?.()},p=s=>c({type:"toolCall",data:s});e.on("message:start",f),e.on("message:chunk",t),e.on("message:complete",u),e.on("message:error",d),e.on("toolCall:received",p),e.sendMessage(o,l).catch(()=>{a=!0,r?.()});try{for(;!a||n.length>0;)n.length>0?yield n.shift():(await new Promise(s=>{r=s}),r=null)}finally{e.off("message:start",f),e.off("message:chunk",t),e.off("message:complete",u),e.off("message:error",d),e.off("toolCall:received",p)}}function w(e){let o,l,n,r,a,c;if(typeof window<"u"&&window.AGO){const t=window.AGO;o=t.basepath,l=t.widgetId,n=t.agent||t.defaultAgent,r=t.permission,a=t.email,c=t.jwt}if(typeof document<"u"){const t=u=>document.querySelector(`meta[name="${u}"]`)?.getAttribute("content")||void 0;o=o||t("ago-base-url"),l=l||t("ago-widget-id"),n=n||t("ago-agent")||t("ago-agent-id"),r=r||t("ago-permission"),a=a||t("ago-user-email")}if(typeof document<"u"){const t=[document.body,...Array.from(document.querySelectorAll("script[data-ago-base-url]"))].filter(Boolean);for(const u of t)u&&(o=o||u.getAttribute("data-ago-base-url")||void 0,l=l||u.getAttribute("data-ago-widget-id")||void 0,n=n||u.getAttribute("data-ago-agent")||u.getAttribute("data-ago-agent-id")||void 0,r=r||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,n=e?.agent||e?.defaultAgentId||n,r=e?.permission||r,a=e?.userEmail||a,c=e?.userJwt||c;const f=e?.debug;return o?{baseUrl:o,widgetId:l,agent:n,permission:r,userEmail:a,userJwt:c,debug:f}:null}function F(e){const o=w(e);if(!o)throw new Error('createAgo(): could not detect AGO configuration. Set window.AGO, add <meta name="ago-base-url">, or pass { baseUrl } explicitly.');return new i.AgoClient(o)}function q(e,o){return{...e,handler:o}}exports.AgoApiError=i.AgoApiError;exports.AgoClient=i.AgoClient;exports.AgoError=i.AgoError;exports.AgoFunctionError=i.AgoFunctionError;exports.AgoNetworkError=i.AgoNetworkError;exports.AgoStreamError=i.AgoStreamError;exports.ClientContextRegistry=i.ClientContextRegistry;exports.EventEmitter=i.EventEmitter;exports.FunctionRegistry=i.FunctionRegistry;exports.SSEHandler=i.SSEHandler;exports.autoDetectConfig=w;exports.copyToClipboard=g.copyToClipboard;exports.createAgo=F;exports.createConversationSession=A.createConversationSession;exports.createFormCollector=m.createFormCollector;exports.createMessageStream=k;exports.createMockClient=C.createMockClient;exports.createStore=m.createStore;exports.defineFunction=h;exports.deriveFormStatus=m.deriveFormStatus;exports.getLocalStorage=g.getLocalStorage;exports.getUserLocation=g.getUserLocation;exports.highlightElement=g.highlightElement;exports.isStreamNetworkError=i.isStreamNetworkError;exports.logger=i.logger;exports.onFunctionInvoke=M;exports.onMessage=E;exports.onMessageChunk=S;exports.onMessageError=b;exports.onMessageStart=y;exports.onToolCall=v;exports.openUrl=g.openUrl;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.withHandler=q;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("./AgoClient-CPqPT5s6.cjs"),m=require("./createFormCollector-DaWZsBsI.cjs"),A=require("./createConversationSession-CGRO0bs2.cjs"),C=require("./createMockClient-zHQ0cjUH.cjs");require("./testing.cjs");const g=require("./functions-DsmzgHjC.cjs");function h(e){return e}function E(e,o){return e.on("message:complete",o),()=>e.off("message:complete",o)}function S(e,o){return e.on("message:chunk",o),()=>e.off("message:chunk",o)}function y(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 v(e,o){return e.on("toolCall:received",o),()=>e.off("toolCall:received",o)}function M(e,o){return e.on("function:invoke",o),()=>e.off("function:invoke",o)}async function*k(e,o,l){const n=[];let r=null,a=!1;const c=s=>{n.push(s),r?.()},f=s=>c({type:"start",data:s}),t=s=>c({type:"chunk",data:s}),u=s=>{c({type:"complete",data:s}),a=!0,r?.()},d=s=>{c({type:"error",data:s}),a=!0,r?.()},p=s=>c({type:"toolCall",data:s});e.on("message:start",f),e.on("message:chunk",t),e.on("message:complete",u),e.on("message:error",d),e.on("toolCall:received",p),e.sendMessage(o,l).catch(()=>{a=!0,r?.()});try{for(;!a||n.length>0;)n.length>0?yield n.shift():(await new Promise(s=>{r=s}),r=null)}finally{e.off("message:start",f),e.off("message:chunk",t),e.off("message:complete",u),e.off("message:error",d),e.off("toolCall:received",p)}}function w(e){let o,l,n,r,a,c;if(typeof window<"u"&&window.AGO){const t=window.AGO;o=t.basepath,l=t.widgetId,n=t.agent||t.defaultAgent,r=t.permission,a=t.email,c=t.jwt}if(typeof document<"u"){const t=u=>document.querySelector(`meta[name="${u}"]`)?.getAttribute("content")||void 0;o=o||t("ago-base-url"),l=l||t("ago-widget-id"),n=n||t("ago-agent")||t("ago-agent-id"),r=r||t("ago-permission"),a=a||t("ago-user-email")}if(typeof document<"u"){const t=[document.body,...Array.from(document.querySelectorAll("script[data-ago-base-url]"))].filter(Boolean);for(const u of t)u&&(o=o||u.getAttribute("data-ago-base-url")||void 0,l=l||u.getAttribute("data-ago-widget-id")||void 0,n=n||u.getAttribute("data-ago-agent")||u.getAttribute("data-ago-agent-id")||void 0,r=r||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,n=e?.agent||e?.defaultAgentId||n,r=e?.permission||r,a=e?.userEmail||a,c=e?.userJwt||c;const f=e?.debug;return o?{baseUrl:o,widgetId:l,agent:n,permission:r,userEmail:a,userJwt:c,debug:f}:null}function F(e){const o=w(e);if(!o)throw new Error('createAgo(): could not detect AGO configuration. Set window.AGO, add <meta name="ago-base-url">, or pass { baseUrl } explicitly.');return new i.AgoClient(o)}function q(e,o){return{...e,handler:o}}exports.AgoApiError=i.AgoApiError;exports.AgoClient=i.AgoClient;exports.AgoError=i.AgoError;exports.AgoFunctionError=i.AgoFunctionError;exports.AgoNetworkError=i.AgoNetworkError;exports.AgoStreamError=i.AgoStreamError;exports.ClientContextRegistry=i.ClientContextRegistry;exports.EventEmitter=i.EventEmitter;exports.FunctionRegistry=i.FunctionRegistry;exports.SSEHandler=i.SSEHandler;exports.autoDetectConfig=w;exports.copyToClipboard=g.copyToClipboard;exports.createAgo=F;exports.createConversationSession=A.createConversationSession;exports.createFormCollector=m.createFormCollector;exports.createMessageStream=k;exports.createMockClient=C.createMockClient;exports.createStore=m.createStore;exports.defineFunction=h;exports.deriveFormStatus=m.deriveFormStatus;exports.getLocalStorage=g.getLocalStorage;exports.getUserLocation=g.getUserLocation;exports.highlightElement=g.highlightElement;exports.isStreamNetworkError=i.isStreamNetworkError;exports.logger=i.logger;exports.onFunctionInvoke=M;exports.onMessage=E;exports.onMessageChunk=S;exports.onMessageError=b;exports.onMessageStart=y;exports.onToolCall=v;exports.openUrl=g.openUrl;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.withHandler=q;

package/dist/index.d.cts

@@ -227,6 +227,11 @@ export declare interface AgoClientEvents {
         conversationId: string;
         messageId: string;
     };
+    /**
+     * The main answer text is done (backend emitted `status: "DONE"`), but follow-up
+     * replies may still be pending. Fires once, before `message:complete`.
+     */
+    "message:answer-complete": AgoMessage;
     "message:complete": AgoMessage;
     "message:error": {
         error: string;
@@ -1194,6 +1199,7 @@ export declare class SSEHandler {
     private sources;
     private followUpReplies;
     private isFirstChunk;
+    private answerCompleteEmitted;
     constructor(callbacks: SSEHandlerCallbacks);
     /**
      * Process a streaming response
@@ -1202,6 +1208,8 @@ export declare class SSEHandler {
     private processBuffer;
     private handleChunk;
     private parseToolCall;
+    /** Snapshot the accumulated message. Shared by the answer-complete and final builds. */
+    private buildMessage;
     private buildFinalMessage;
 }
 
@@ -1222,6 +1230,12 @@ declare interface SSEHandlerCallbacks {
         arguments: Record<string, unknown>;
         conversationId: string;
     }) => void;
+    /**
+     * The main answer text is finished (the backend emitted `status: "DONE"`) but
+     * follow-up replies may still be streaming. Fires once, before {@link onComplete},
+     * with the message as it stands at that moment (no `followUpReplies` yet).
+     */
+    onAnswerComplete?: (message: AgoMessage) => void;
     onComplete?: (message: AgoMessage) => void;
     onError?: (error: Error) => void;
 }

package/dist/index.d.ts

@@ -227,6 +227,11 @@ export declare interface AgoClientEvents {
         conversationId: string;
         messageId: string;
     };
+    /**
+     * The main answer text is done (backend emitted `status: "DONE"`), but follow-up
+     * replies may still be pending. Fires once, before `message:complete`.
+     */
+    "message:answer-complete": AgoMessage;
     "message:complete": AgoMessage;
     "message:error": {
         error: string;
@@ -1194,6 +1199,7 @@ export declare class SSEHandler {
     private sources;
     private followUpReplies;
     private isFirstChunk;
+    private answerCompleteEmitted;
     constructor(callbacks: SSEHandlerCallbacks);
     /**
      * Process a streaming response
@@ -1202,6 +1208,8 @@ export declare class SSEHandler {
     private processBuffer;
     private handleChunk;
     private parseToolCall;
+    /** Snapshot the accumulated message. Shared by the answer-complete and final builds. */
+    private buildMessage;
     private buildFinalMessage;
 }
 
@@ -1222,6 +1230,12 @@ declare interface SSEHandlerCallbacks {
         arguments: Record<string, unknown>;
         conversationId: string;
     }) => void;
+    /**
+     * The main answer text is finished (the backend emitted `status: "DONE"`) but
+     * follow-up replies may still be streaming. Fires once, before {@link onComplete},
+     * with the message as it stands at that moment (no `followUpReplies` yet).
+     */
+    onAnswerComplete?: (message: AgoMessage) => void;
     onComplete?: (message: AgoMessage) => void;
     onError?: (error: Error) => void;
 }