@useago/sdk 0.4.6 → 0.4.7

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"),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;
 }

package/dist/index.js

@@ -1,6 +1,6 @@
-import { a as w, c as h, d as A, f as y, i as C, l as E, n as S, o as b, r as v, s as k, t as d, u as M } from "./AgoClient-rvTz2thR.js";
-import { n as T, r as I, t as U } from "./createFormCollector-DON4vdJV.js";
-import { t as O } from "./createConversationSession-D-eq8VIo.js";
+import { a as w, c as h, d as A, f as y, i as C, l as E, n as S, o as b, r as v, s as k, t as d, u as M } from "./AgoClient-BrYhSO5M.js";
+import { n as T, r as I, t as U } from "./createFormCollector-CPS2phYq.js";
+import { t as O } from "./createConversationSession-Dmqd80DX.js";
 import { t as x } from "./createMockClient-DwdxNwEn.js";
 import { a as N, c as D, d as H, f as J, i as R, l as j, m as B, o as P, p as $, r as z, s as K, t as Q, u as V } from "./functions-C1-5vadY.js";
 function W(e) {