@useago/sdk 0.3.4 → 0.4.1

package/dist/angular.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./AgoClient-bjN-z2ZQ.cjs");var n=class{constructor(e){this.client=new o.AgoClient(e),this.messages$=this.fromEvent("message:complete"),this.chunks$=this.fromEvent("message:chunk"),this.errors$=this.fromEvent("message:error"),this.messageStart$=this.fromEvent("message:start")}fromEvent(e){const t=this.client;return{subscribe(i){const s=r=>{i.next?.(r)};return t.on(e,s),{unsubscribe:()=>t.off(e,s)}}}}sendMessage(e,t){return this.client.sendMessage(e,t)}getConversations(){return this.client.getConversations()}getConversation(e){return this.client.getConversation(e)}getMessages(e){return this.client.getMessages(e)}submitToolCallForm(e,t){return this.client.submitToolCallForm(e,t)}confirmToolCall(e){return this.client.confirmToolCall(e)}rejectToolCall(e){return this.client.rejectToolCall(e)}submitFeedback(e,t){return this.client.submitFeedback(e,t)}registerFunction(e,t,i){typeof e=="object"?this.client.registerFunction(e):this.client.registerFunction(e,t,i)}unregisterFunction(e){return this.client.unregisterFunction(e)}registerNavigationFunction(e,t){this.client.registerNavigationFunction(e,t)}on(e,t){this.client.on(e,t)}off(e,t){this.client.off(e,t)}updateConfig(e){this.client.updateConfig(e)}getClient(){return this.client}destroy(){this.client.destroy()}};function c(e){return{provide:n,useValue:new n(e)}}exports.AgoService=n;exports.provideAgo=c;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./AgoClient-B6PsfMeg.cjs");var n=class{constructor(e){this.client=new o.AgoClient(e),this.messages$=this.fromEvent("message:complete"),this.chunks$=this.fromEvent("message:chunk"),this.errors$=this.fromEvent("message:error"),this.messageStart$=this.fromEvent("message:start")}fromEvent(e){const t=this.client;return{subscribe(i){const s=r=>{i.next?.(r)};return t.on(e,s),{unsubscribe:()=>t.off(e,s)}}}}sendMessage(e,t){return this.client.sendMessage(e,t)}getConversations(){return this.client.getConversations()}getConversation(e){return this.client.getConversation(e)}getMessages(e){return this.client.getMessages(e)}submitToolCallForm(e,t){return this.client.submitToolCallForm(e,t)}confirmToolCall(e){return this.client.confirmToolCall(e)}rejectToolCall(e){return this.client.rejectToolCall(e)}submitFeedback(e,t){return this.client.submitFeedback(e,t)}registerFunction(e,t,i){typeof e=="object"?this.client.registerFunction(e):this.client.registerFunction(e,t,i)}unregisterFunction(e){return this.client.unregisterFunction(e)}registerNavigationFunction(e,t){this.client.registerNavigationFunction(e,t)}on(e,t){this.client.on(e,t)}off(e,t){this.client.off(e,t)}updateConfig(e){this.client.updateConfig(e)}getClient(){return this.client}destroy(){this.client.destroy()}};function c(e){return{provide:n,useValue:new n(e)}}exports.AgoService=n;exports.provideAgo=c;

package/dist/angular.d.cts

@@ -31,6 +31,12 @@ declare class AgoClient {
      * Get a specific conversation with messages
      */
     getConversation(conversationId: string): Promise<Conversation>;
+    /**
+     * Map the backend's snake_case `tool_call_data` entries onto the camelCase
+     * {@link ToolCallData} shape used everywhere else in the SDK. Mirrors
+     * `SSEHandler.parseToolCall` so persisted and streamed tool calls match.
+     */
+    private static mapPersistedToolCalls;
     /**
      * Get messages for a conversation
      */
@@ -201,6 +207,12 @@ export declare interface AgoClientEvents {
         conversationId?: string;
         messageId?: string;
     };
+    /**
+     * A full conversation was loaded from the server (e.g. after a page reload).
+     * Carries the messages and their persisted tool calls so stateful helpers —
+     * notably `createFormCollector` — can replay them to restore their state.
+     */
+    "conversation:loaded": Conversation;
     "toolCall:received": ToolCallData;
     "toolCall:form": ToolCallData;
     "function:invoke": ClientFunctionInvocation;

package/dist/angular.d.ts

@@ -31,6 +31,12 @@ declare class AgoClient {
      * Get a specific conversation with messages
      */
     getConversation(conversationId: string): Promise<Conversation>;
+    /**
+     * Map the backend's snake_case `tool_call_data` entries onto the camelCase
+     * {@link ToolCallData} shape used everywhere else in the SDK. Mirrors
+     * `SSEHandler.parseToolCall` so persisted and streamed tool calls match.
+     */
+    private static mapPersistedToolCalls;
     /**
      * Get messages for a conversation
      */
@@ -201,6 +207,12 @@ export declare interface AgoClientEvents {
         conversationId?: string;
         messageId?: string;
     };
+    /**
+     * A full conversation was loaded from the server (e.g. after a page reload).
+     * Carries the messages and their persisted tool calls so stateful helpers —
+     * notably `createFormCollector` — can replay them to restore their state.
+     */
+    "conversation:loaded": Conversation;
     "toolCall:received": ToolCallData;
     "toolCall:form": ToolCallData;
     "function:invoke": ClientFunctionInvocation;

package/dist/angular.js

@@ -1,4 +1,4 @@
-import { t as o } from "./AgoClient-DF7M2WAz.js";
+import { t as o } from "./AgoClient-BerJvssl.js";
 var n = class {
   constructor(t) {
     this.client = new o(t), this.messages$ = this.fromEvent("message:complete"), this.chunks$ = this.fromEvent("message:chunk"), this.errors$ = this.fromEvent("message:error"), this.messageStart$ = this.fromEvent("message:start");

package/dist/createConversationSession-CLZvxyuu.js

@@ -0,0 +1,58 @@
+import { n as d } from "./createFormCollector-CD1rqRG4.js";
+var f = "ago_widget_id", g = "ago_last_thread", y = 7200 * 1e3;
+function v() {
+  return typeof crypto < "u" && typeof crypto.randomUUID == "function" ? crypto.randomUUID() : "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (e) => {
+    const r = Math.floor(Math.random() * 16);
+    return (e === "x" ? r : r & 3 | 8).toString(16);
+  });
+}
+function D(e = {}) {
+  const r = e.key ?? f, c = e.threadKey ?? g, u = e.ttlMs ?? y, l = e.storage ?? (typeof localStorage < "u" ? localStorage : void 0);
+  let n = e.widgetId ?? "";
+  if (!n && l) try {
+    n = l.getItem(r) ?? "";
+  } catch {
+  }
+  if (n || (n = v()), l) try {
+    l.setItem(r, n);
+  } catch {
+  }
+  const o = d({
+    value: null,
+    lastMessageAt: null
+  }, {
+    key: c,
+    storage: l
+  }), s = o.get();
+  s.value !== null && x(s.lastMessageAt) && o.set({
+    value: null,
+    lastMessageAt: null
+  });
+  function x(t) {
+    return t === null ? !0 : Number.isFinite(u) ? Date.now() - t > u : !1;
+  }
+  return {
+    widgetId: n,
+    key: r,
+    getLastActiveThread() {
+      const { value: t, lastMessageAt: a } = o.get();
+      return t === null || x(a) ? null : t;
+    },
+    setActiveThread(t, a) {
+      const i = a == null ? null : a instanceof Date ? a.getTime() : a;
+      o.set({
+        value: t,
+        lastMessageAt: i
+      });
+    },
+    clear() {
+      o.set({
+        value: null,
+        lastMessageAt: null
+      });
+    }
+  };
+}
+export {
+  D as t
+};

package/dist/createConversationSession-D3K5Gf1k.cjs

@@ -0,0 +1 @@
+const d=require("./createFormCollector-D1FfiSgA.cjs");var f="ago_widget_id",g="ago_last_thread",y=7200*1e3;function v(){return typeof crypto<"u"&&typeof crypto.randomUUID=="function"?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,e=>{const r=Math.floor(Math.random()*16);return(e==="x"?r:r&3|8).toString(16)})}function _(e={}){const r=e.key??f,i=e.threadKey??g,u=e.ttlMs??y,l=e.storage??(typeof localStorage<"u"?localStorage:void 0);let n=e.widgetId??"";if(!n&&l)try{n=l.getItem(r)??""}catch{}if(n||(n=v()),l)try{l.setItem(r,n)}catch{}const o=d.createStore({value:null,lastMessageAt:null},{key:i,storage:l}),c=o.get();c.value!==null&&s(c.lastMessageAt)&&o.set({value:null,lastMessageAt:null});function s(t){return t===null?!0:Number.isFinite(u)?Date.now()-t>u:!1}return{widgetId:n,key:r,getLastActiveThread(){const{value:t,lastMessageAt:a}=o.get();return t===null||s(a)?null:t},setActiveThread(t,a){const x=a==null?null:a instanceof Date?a.getTime():a;o.set({value:t,lastMessageAt:x})},clear(){o.set({value:null,lastMessageAt:null})}}}Object.defineProperty(exports,"createConversationSession",{enumerable:!0,get:function(){return _}});

package/dist/createFormCollector-CD1rqRG4.js

@@ -0,0 +1,208 @@
+import { s as I } from "./AgoClient-BerJvssl.js";
+function O(u, o) {
+  const m = o ? o.storage ?? (typeof localStorage < "u" ? localStorage : void 0) : void 0;
+  let c = u;
+  if (o && m) try {
+    const a = m.getItem(o.key);
+    a != null && (c = JSON.parse(a));
+  } catch {
+  }
+  const r = /* @__PURE__ */ new Set(), h = () => r.forEach((a) => a(c));
+  function y() {
+    if (o && m) try {
+      m.setItem(o.key, JSON.stringify(c));
+    } catch {
+    }
+  }
+  return {
+    get: () => c,
+    set: (a) => {
+      c = a, y(), h();
+    },
+    subscribe: (a) => (r.add(a), () => {
+      r.delete(a);
+    })
+  };
+}
+var T = /^[a-zA-Z0-9_-]{1,40}$/;
+function M(u) {
+  const { name: o, description: m, schema: c } = u;
+  if (!T.test(o)) throw new Error(`Invalid form collector name "${o}": must match ${T} (it becomes the update_/submit_ function names).`);
+  const r = typeof u.submit == "string" ? u.submit ? {
+    via: "client",
+    url: u.submit
+  } : !1 : u.submit ?? !1, h = c.properties ?? {}, y = c.required ?? [], a = (e) => e == null || e === "", p = (e) => y.filter((t) => a(e[t])), v = (e) => {
+    const t = {};
+    for (const [n, s] of Object.entries(e)) {
+      const i = h[n];
+      if (i)
+        if (s == null) t[n] = s;
+        else if (i.type === "number" || i.type === "integer") {
+          const g = typeof s == "number" ? s : Number(s);
+          t[n] = Number.isNaN(g) ? s : g;
+        } else i.type === "boolean" ? t[n] = typeof s == "boolean" ? s : s === "true" ? !0 : s === "false" ? !1 : !!s : t[n] = s;
+    }
+    return t;
+  }, f = u.initialValues ?? {}, $ = p(f), l = O({
+    values: f,
+    missing: $,
+    complete: $.length === 0,
+    submitted: !1
+  }), C = (e) => {
+    const t = l.get(), n = {
+      ...t.values,
+      ...e
+    }, s = p(n), i = {
+      ...t,
+      values: n,
+      missing: s,
+      complete: s.length === 0
+    };
+    return l.set(i), i;
+  };
+  let d = null;
+  const k = async () => {
+    const e = l.get();
+    if (!e.complete) return {
+      ok: !1,
+      missing: e.missing
+    };
+    if (!r) return {
+      ok: !1,
+      error: "No submit target configured for this form collector."
+    };
+    const t = e.values;
+    try {
+      let n;
+      if (r.via === "client") if ("handler" in r) n = await r.handler(t);
+      else {
+        const s = await fetch(r.url, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          credentials: "include",
+          body: JSON.stringify(t)
+        });
+        if (!s.ok) return {
+          ok: !1,
+          error: `Submit failed: HTTP ${s.status}`
+        };
+        n = await s.json().catch(() => {
+        });
+      }
+      else {
+        if (!d) return {
+          ok: !1,
+          error: "Backend submit requires install(client) (or useFormCollector) first."
+        };
+        n = await d.submitFormCollector(r.destination, t);
+      }
+      return l.set({
+        ...l.get(),
+        submitted: !0
+      }), {
+        ok: !0,
+        result: n
+      };
+    } catch (n) {
+      const s = n instanceof Error ? n.message : "Submit failed";
+      return I.error(`FormCollector "${o}" submit failed:`, n), {
+        ok: !1,
+        error: s
+      };
+    }
+  }, w = {
+    name: `update_${o}`,
+    description: `Fill or update fields of the "${o}" form. ${m} 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: {
+      ...c,
+      required: []
+    },
+    handler: (e) => {
+      const t = C(v(e));
+      return {
+        ok: !0,
+        values: t.values,
+        missing: t.missing,
+        complete: t.complete
+      };
+    }
+  }, b = [w];
+  r && b.push({
+    name: `submit_${o}`,
+    description: `Submit the completed "${o}" 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: () => k()
+  });
+  const q = "client__", S = r ? `submit_${o}` : null, x = (e) => {
+    const t = e.functionName ?? e.toolName;
+    if (t)
+      return t.startsWith(q) ? t.slice(8) : t;
+  }, _ = (e) => {
+    let t = { ...f }, n = !1;
+    for (const i of e) {
+      const g = x(i);
+      g === w.name ? i.arguments && (t = {
+        ...t,
+        ...v(i.arguments)
+      }) : S && g === S && i.status?.toLowerCase() === "done" && (n = !0);
+    }
+    const s = p(t);
+    l.set({
+      values: t,
+      missing: s,
+      complete: s.length === 0,
+      submitted: n
+    });
+  }, N = `form:${o}`, F = () => {
+    const e = l.get(), t = r ? ` When all required fields are present and the user confirms, call submit_${o}.` : "";
+    return {
+      name: `Form: ${o}`,
+      description: `Conversational form the assistant is helping fill. ${m} Use update_${o} to record fields; ask the user only for what is still missing.${t}`,
+      data: {
+        values: e.values,
+        missing: e.missing,
+        complete: e.complete,
+        submitted: e.submitted
+      }
+    };
+  }, E = (e) => {
+    _((e.messages ?? []).flatMap((t) => t.toolCalls ?? []));
+  };
+  return {
+    name: o,
+    store: l,
+    functions: b,
+    contextKey: N,
+    contextProvider: F,
+    install: (e) => {
+      d = e;
+      for (const t of b) e.register(t);
+      return e.addDynamicContext(N, F), e.on("conversation:loaded", E), () => {
+        for (const t of b) e.unregisterFunction(t.name);
+        e.removeDynamicContext(N), e.off("conversation:loaded", E), d === e && (d = null);
+      };
+    },
+    hydrate: _,
+    submit: k,
+    getValues: () => l.get().values,
+    setValues: (e) => {
+      C(v(e));
+    },
+    reset: () => {
+      const e = p(f);
+      l.set({
+        values: f,
+        missing: e,
+        complete: e.length === 0,
+        submitted: !1
+      });
+    }
+  };
+}
+export {
+  O as n,
+  M as t
+};

package/dist/createFormCollector-D1FfiSgA.cjs

@@ -0,0 +1 @@
+const I=require("./AgoClient-B6PsfMeg.cjs");function P(u,r){const m=r?r.storage??(typeof localStorage<"u"?localStorage:void 0):void 0;let c=u;if(r&&m)try{const a=m.getItem(r.key);a!=null&&(c=JSON.parse(a))}catch{}const o=new Set,h=()=>o.forEach(a=>a(c));function y(){if(r&&m)try{m.setItem(r.key,JSON.stringify(c))}catch{}}return{get:()=>c,set:a=>{c=a,y(),h()},subscribe:a=>(o.add(a),()=>{o.delete(a)})}}var O=/^[a-zA-Z0-9_-]{1,40}$/;function j(u){const{name:r,description:m,schema:c}=u;if(!O.test(r))throw new Error(`Invalid form collector name "${r}": must match ${O} (it becomes the update_/submit_ function names).`);const o=typeof u.submit=="string"?u.submit?{via:"client",url:u.submit}:!1:u.submit??!1,h=c.properties??{},y=c.required??[],a=e=>e==null||e==="",b=e=>y.filter(t=>a(e[t])),v=e=>{const t={};for(const[n,s]of Object.entries(e)){const i=h[n];if(i)if(s==null)t[n]=s;else if(i.type==="number"||i.type==="integer"){const g=typeof s=="number"?s:Number(s);t[n]=Number.isNaN(g)?s:g}else i.type==="boolean"?t[n]=typeof s=="boolean"?s:s==="true"?!0:s==="false"?!1:!!s:t[n]=s}return t},f=u.initialValues??{},N=b(f),l=P({values:f,missing:N,complete:N.length===0,submitted:!1}),$=e=>{const t=l.get(),n={...t.values,...e},s=b(n),i={...t,values:n,missing:s,complete:s.length===0};return l.set(i),i};let d=null;const S=async()=>{const e=l.get();if(!e.complete)return{ok:!1,missing:e.missing};if(!o)return{ok:!1,error:"No submit target configured for this form collector."};const t=e.values;try{let n;if(o.via==="client")if("handler"in o)n=await o.handler(t);else{const s=await fetch(o.url,{method:"POST",headers:{"Content-Type":"application/json"},credentials:"include",body:JSON.stringify(t)});if(!s.ok)return{ok:!1,error:`Submit failed: HTTP ${s.status}`};n=await s.json().catch(()=>{})}else{if(!d)return{ok:!1,error:"Backend submit requires install(client) (or useFormCollector) first."};n=await d.submitFormCollector(o.destination,t)}return l.set({...l.get(),submitted:!0}),{ok:!0,result:n}}catch(n){const s=n instanceof Error?n.message:"Submit failed";return I.logger.error(`FormCollector "${r}" submit failed:`,n),{ok:!1,error:s}}},_={name:`update_${r}`,description:`Fill or update fields of the "${r}" form. ${m} 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:{...c,required:[]},handler:e=>{const t=$(v(e));return{ok:!0,values:t.values,missing:t.missing,complete:t.complete}}},p=[_];o&&p.push({name:`submit_${r}`,description:`Submit the completed "${r}" 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:()=>S()});const E="client__",k=o?`submit_${r}`:null,T=e=>{const t=e.functionName??e.toolName;if(t)return t.startsWith(E)?t.slice(8):t},w=e=>{let t={...f},n=!1;for(const i of e){const g=T(i);g===_.name?i.arguments&&(t={...t,...v(i.arguments)}):k&&g===k&&i.status?.toLowerCase()==="done"&&(n=!0)}const s=b(t);l.set({values:t,missing:s,complete:s.length===0,submitted:n})},C=`form:${r}`,F=()=>{const e=l.get(),t=o?` When all required fields are present and the user confirms, call submit_${r}.`:"";return{name:`Form: ${r}`,description:`Conversational form the assistant is helping fill. ${m} Use update_${r} to record fields; ask the user only for what is still missing.${t}`,data:{values:e.values,missing:e.missing,complete:e.complete,submitted:e.submitted}}},q=e=>{w((e.messages??[]).flatMap(t=>t.toolCalls??[]))};return{name:r,store:l,functions:p,contextKey:C,contextProvider:F,install:e=>{d=e;for(const t of p)e.register(t);return e.addDynamicContext(C,F),e.on("conversation:loaded",q),()=>{for(const t of p)e.unregisterFunction(t.name);e.removeDynamicContext(C),e.off("conversation:loaded",q),d===e&&(d=null)}},hydrate:w,submit:S,getValues:()=>l.get().values,setValues:e=>{$(v(e))},reset:()=>{const e=b(f);l.set({values:f,missing:e,complete:e.length===0,submitted:!1})}}}Object.defineProperty(exports,"createFormCollector",{enumerable:!0,get:function(){return j}});Object.defineProperty(exports,"createStore",{enumerable:!0,get:function(){return P}});

package/dist/createMockClient-DMFGIOtc.cjs

@@ -0,0 +1 @@
+function w(u={}){const{overrides:g={}}=u,d={id:"mock-msg-1",conversationId:"mock-conv-1",content:"Mock response",role:"assistant",status:"DONE",createdAt:new Date},l={id:"mock-conv-1",title:"Mock Conversation",lastMessageDate:new Date},t=new Map,a=[],m={sendMessage:async()=>d,getConversations:async()=>[l],getConversation:async()=>l,getMessages:async()=>[d],submitToolCallForm:async()=>{},confirmToolCall:async()=>{},rejectToolCall:async()=>{},submitFeedback:async()=>{},registerFunction:()=>{},unregisterFunction:()=>!0,getRegisteredFunctions:()=>[],getContextSnapshot:()=>null,registerNavigationFunction:()=>{},on:(e,o)=>{t.has(e)||t.set(e,new Set),t.get(e).add(o)},off:(e,o)=>{t.get(e)?.delete(o)},once:(e,o)=>{const n=(...r)=>{t.get(e)?.delete(n),o(...r)};t.has(e)||t.set(e,new Set),t.get(e).add(n)},waitFor:(e,o)=>new Promise((n,r)=>{let i;const c=f=>{i&&clearTimeout(i),t.get(e)?.delete(c),n(f)};t.has(e)||t.set(e,new Set),t.get(e).add(c),o?.timeout&&(i=setTimeout(()=>{t.get(e)?.delete(c),r(new Error(`waitFor("${e}") timed out after ${o.timeout}ms`))},o.timeout))}),updateConfig:()=>{},destroy:()=>{t.clear()},...g},s={};for(const[e,o]of Object.entries(m))s[e]=(...n)=>(a.push({method:e,args:n}),o(...n));return s.__calls=a,s.__callsFor=e=>a.filter(o=>o.method===e),s.__emitEvent=(e,o)=>{const n=t.get(e);n&&[...n].forEach(r=>r(o))},s}Object.defineProperty(exports,"createMockClient",{enumerable:!0,get:function(){return w}});

package/dist/{createMockClient-C50gjV0b.js → createMockClient-tVsApEAh.js}

@@ -27,6 +27,7 @@ function w(g = {}) {
     },
     unregisterFunction: () => !0,
     getRegisteredFunctions: () => [],
+    getContextSnapshot: () => null,
     registerNavigationFunction: () => {
     },
     on: (e, o) => {

package/dist/devtools.cjs

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

package/dist/devtools.d.cts

@@ -31,6 +31,12 @@ declare class AgoClient {
      * Get a specific conversation with messages
      */
     getConversation(conversationId: string): Promise<Conversation>;
+    /**
+     * Map the backend's snake_case `tool_call_data` entries onto the camelCase
+     * {@link ToolCallData} shape used everywhere else in the SDK. Mirrors
+     * `SSEHandler.parseToolCall` so persisted and streamed tool calls match.
+     */
+    private static mapPersistedToolCalls;
     /**
      * Get messages for a conversation
      */
@@ -201,6 +207,12 @@ declare interface AgoClientEvents {
         conversationId?: string;
         messageId?: string;
     };
+    /**
+     * A full conversation was loaded from the server (e.g. after a page reload).
+     * Carries the messages and their persisted tool calls so stateful helpers —
+     * notably `createFormCollector` — can replay them to restore their state.
+     */
+    "conversation:loaded": Conversation;
     "toolCall:received": ToolCallData;
     "toolCall:form": ToolCallData;
     "function:invoke": ClientFunctionInvocation;
@@ -350,13 +362,12 @@ declare interface Conversation {
 
 /** Options for {@link initDevPanel}. */
 export declare interface DevPanelOptions {
-    /** The store whose state the panel renders live. */
-    store: Store<unknown>;
     /**
-     * Client to read registered functions from and listen to function events on.
-     * Typed structurally so a mock client works too.
+     * The AGO client to debug. The panel lists its registered functions, logs its
+     * function events, and renders its live context snapshot
+     * (`client.getContextSnapshot()`)
      */
-    client: Pick<AgoClient, "on" | "getRegisteredFunctions">;
+    client: Pick<AgoClient, "on" | "getRegisteredFunctions" | "getContextSnapshot">;
     /** Where to mount: a CSS selector, an Element, or `document.body` (default). */
     target?: string | Element;
 }
@@ -401,27 +412,6 @@ declare interface SendMessageOptions {
     files?: File[];
 }
 
-/**
- * A minimal observable store: one value, synchronous subscriptions, and
- * optional persistence via {@link PersistOptions} (localStorage by default).
- *
- * ```ts
- * const store = createStore({ count: 0 });
- * store.subscribe((state) => save(state));
- * store.set({ count: 1 }); // listeners fire synchronously
- *
- * const cart = createStore({ items: [] }, { key: "cart" }); // persisted
- * ```
- */
-declare interface Store<T> {
-    /** Current state. */
-    get(): T;
-    /** Replace the state and notify subscribers synchronously. */
-    set(next: T): void;
-    /** Register a listener; returns a function that removes it. */
-    subscribe(listener: (state: T) => void): () => void;
-}
-
 /**
  * Tool call data from SSE stream
  */

package/dist/devtools.d.ts

@@ -31,6 +31,12 @@ declare class AgoClient {
      * Get a specific conversation with messages
      */
     getConversation(conversationId: string): Promise<Conversation>;
+    /**
+     * Map the backend's snake_case `tool_call_data` entries onto the camelCase
+     * {@link ToolCallData} shape used everywhere else in the SDK. Mirrors
+     * `SSEHandler.parseToolCall` so persisted and streamed tool calls match.
+     */
+    private static mapPersistedToolCalls;
     /**
      * Get messages for a conversation
      */
@@ -201,6 +207,12 @@ declare interface AgoClientEvents {
         conversationId?: string;
         messageId?: string;
     };
+    /**
+     * A full conversation was loaded from the server (e.g. after a page reload).
+     * Carries the messages and their persisted tool calls so stateful helpers —
+     * notably `createFormCollector` — can replay them to restore their state.
+     */
+    "conversation:loaded": Conversation;
     "toolCall:received": ToolCallData;
     "toolCall:form": ToolCallData;
     "function:invoke": ClientFunctionInvocation;
@@ -350,13 +362,12 @@ declare interface Conversation {
 
 /** Options for {@link initDevPanel}. */
 export declare interface DevPanelOptions {
-    /** The store whose state the panel renders live. */
-    store: Store<unknown>;
     /**
-     * Client to read registered functions from and listen to function events on.
-     * Typed structurally so a mock client works too.
+     * The AGO client to debug. The panel lists its registered functions, logs its
+     * function events, and renders its live context snapshot
+     * (`client.getContextSnapshot()`)
      */
-    client: Pick<AgoClient, "on" | "getRegisteredFunctions">;
+    client: Pick<AgoClient, "on" | "getRegisteredFunctions" | "getContextSnapshot">;
     /** Where to mount: a CSS selector, an Element, or `document.body` (default). */
     target?: string | Element;
 }
@@ -401,27 +412,6 @@ declare interface SendMessageOptions {
     files?: File[];
 }
 
-/**
- * A minimal observable store: one value, synchronous subscriptions, and
- * optional persistence via {@link PersistOptions} (localStorage by default).
- *
- * ```ts
- * const store = createStore({ count: 0 });
- * store.subscribe((state) => save(state));
- * store.set({ count: 1 }); // listeners fire synchronously
- *
- * const cart = createStore({ items: [] }, { key: "cart" }); // persisted
- * ```
- */
-declare interface Store<T> {
-    /** Current state. */
-    get(): T;
-    /** Replace the state and notify subscribers synchronously. */
-    set(next: T): void;
-    /** Register a listener; returns a function that removes it. */
-    subscribe(listener: (state: T) => void): () => void;
-}
-
 /**
  * Tool call data from SSE stream
  */

package/dist/devtools.js

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

package/dist/helpers.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./functions-BH1X5kas.cjs");exports.copyToClipboard=o.copyToClipboard;exports.getLocalStorage=o.getLocalStorage;exports.getUserLocation=o.getUserLocation;exports.highlightElement=o.highlightElement;exports.openUrl=o.openUrl;exports.scrollToElement=o.scrollToElement;exports.setLocalStorage=o.setLocalStorage;exports.setTheme=o.setTheme;exports.showConfirmDialog=o.showConfirmDialog;exports.showNotification=o.showNotification;exports.showToast=o.showToast;exports.submitForm=o.submitForm;exports.trackEvent=o.trackEvent;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./functions-DsmzgHjC.cjs");exports.copyToClipboard=o.copyToClipboard;exports.getLocalStorage=o.getLocalStorage;exports.getUserLocation=o.getUserLocation;exports.highlightElement=o.highlightElement;exports.openUrl=o.openUrl;exports.scrollToElement=o.scrollToElement;exports.setLocalStorage=o.setLocalStorage;exports.setTheme=o.setTheme;exports.showConfirmDialog=o.showConfirmDialog;exports.showNotification=o.showNotification;exports.showToast=o.showToast;exports.submitForm=o.submitForm;exports.trackEvent=o.trackEvent;