@useago/sdk 0.3.4 → 0.4.2

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-D4EL6nva.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
      */
@@ -141,6 +147,13 @@ declare class AgoClient {
      * Remove a dynamic context provider.
      */
     removeDynamicContext(key: string): boolean;
+    /**
+     * Broadcast that the client-side context changed by emitting `context:changed`
+     * with the fresh snapshot. The context-mutating methods call this automatically;
+     * stateful helpers whose context lives in a store (e.g. `createFormCollector`)
+     * call it when their store updates so observers like the dev panel stay live.
+     */
+    notifyContextChanged(): void;
     /**
      * Enable automatic capture of the current browser page (URL + title).
      * Injected as a dynamic context entry named `browser-page`.
@@ -186,6 +199,14 @@ declare class AgoClient {
  * SDK Events
  */
 export declare interface AgoClientEvents {
+    /**
+     * The client-side context changed: a context entry or dynamic provider was
+     * added/removed, or a stateful helper (e.g. `createFormCollector`) updated its
+     * store. Carries the fresh snapshot so observers — notably the dev panel — can
+     * repaint without waiting for the next message. Fires for the form collector's
+     * initial install too, so its missing fields show from the start of a conversation.
+     */
+    "context:changed": ContextSnapshot | null;
     "message:start": {
         conversationId: string;
         messageId: string;
@@ -201,6 +222,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
      */
@@ -141,6 +147,13 @@ declare class AgoClient {
      * Remove a dynamic context provider.
      */
     removeDynamicContext(key: string): boolean;
+    /**
+     * Broadcast that the client-side context changed by emitting `context:changed`
+     * with the fresh snapshot. The context-mutating methods call this automatically;
+     * stateful helpers whose context lives in a store (e.g. `createFormCollector`)
+     * call it when their store updates so observers like the dev panel stay live.
+     */
+    notifyContextChanged(): void;
     /**
      * Enable automatic capture of the current browser page (URL + title).
      * Injected as a dynamic context entry named `browser-page`.
@@ -186,6 +199,14 @@ declare class AgoClient {
  * SDK Events
  */
 export declare interface AgoClientEvents {
+    /**
+     * The client-side context changed: a context entry or dynamic provider was
+     * added/removed, or a stateful helper (e.g. `createFormCollector`) updated its
+     * store. Carries the fresh snapshot so observers — notably the dev panel — can
+     * repaint without waiting for the next message. Fires for the form collector's
+     * initial install too, so its missing fields show from the start of a conversation.
+     */
+    "context:changed": ContextSnapshot | null;
     "message:start": {
         conversationId: string;
         messageId: string;
@@ -201,6 +222,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-rvTz2thR.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-D9FesBQS.js

@@ -0,0 +1,58 @@
+import { n as d } from "./createFormCollector-BwvkKi48.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-DtaeA418.cjs

@@ -0,0 +1 @@
+const d=require("./createFormCollector-Wb8Rr-U2.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-BwvkKi48.js

@@ -0,0 +1,211 @@
+import { s as I } from "./AgoClient-rvTz2thR.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(), p = () => 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(), p();
+    },
+    subscribe: (a) => (r.add(a), () => {
+      r.delete(a);
+    })
+  };
+}
+var E = /^[a-zA-Z0-9_-]{1,40}$/;
+function M(u) {
+  const { name: o, description: m, schema: c } = u;
+  if (!E.test(o)) throw new Error(`Invalid form collector name "${o}": must match ${E} (it becomes the update_/submit_ function names).`);
+  const r = typeof u.submit == "string" ? u.submit ? {
+    via: "client",
+    url: u.submit
+  } : !1 : u.submit ?? !1, p = 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 = p[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 = O({
+    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 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 = $(v(e));
+      return {
+        ok: !0,
+        values: t.values,
+        missing: t.missing,
+        complete: t.complete
+      };
+    }
+  }, h = [w];
+  r && h.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 T = "client__", S = r ? `submit_${o}` : null, q = (e) => {
+    const t = e.functionName ?? e.toolName;
+    if (t)
+      return t.startsWith(T) ? t.slice(8) : t;
+  }, _ = (e) => {
+    let t = { ...f }, n = !1;
+    for (const i of e) {
+      const g = q(i);
+      g === w.name ? i.arguments && (t = {
+        ...t,
+        ...v(i.arguments)
+      }) : S && g === S && i.status?.toLowerCase() === "done" && (n = !0);
+    }
+    const s = b(t);
+    l.set({
+      values: t,
+      missing: s,
+      complete: s.length === 0,
+      submitted: n
+    });
+  }, C = `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
+      }
+    };
+  }, x = (e) => {
+    _((e.messages ?? []).flatMap((t) => t.toolCalls ?? []));
+  };
+  return {
+    name: o,
+    store: l,
+    functions: h,
+    contextKey: C,
+    contextProvider: F,
+    install: (e) => {
+      d = e;
+      for (const n of h) e.register(n);
+      e.addDynamicContext(C, F);
+      const t = l.subscribe(() => e.notifyContextChanged());
+      return e.on("conversation:loaded", x), () => {
+        t();
+        for (const n of h) e.unregisterFunction(n.name);
+        e.removeDynamicContext(C), e.off("conversation:loaded", x), d === e && (d = null);
+      };
+    },
+    hydrate: _,
+    submit: k,
+    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
+      });
+    }
+  };
+}
+export {
+  O as n,
+  M as t
+};

package/dist/createFormCollector-Wb8Rr-U2.cjs

@@ -0,0 +1 @@
+const x=require("./AgoClient-D4EL6nva.cjs");function P(u,n){const m=n?n.storage??(typeof localStorage<"u"?localStorage:void 0):void 0;let c=u;if(n&&m)try{const a=m.getItem(n.key);a!=null&&(c=JSON.parse(a))}catch{}const o=new Set,p=()=>o.forEach(a=>a(c));function y(){if(n&&m)try{m.setItem(n.key,JSON.stringify(c))}catch{}}return{get:()=>c,set:a=>{c=a,y(),p()},subscribe:a=>(o.add(a),()=>{o.delete(a)})}}var O=/^[a-zA-Z0-9_-]{1,40}$/;function I(u){const{name:n,description:m,schema:c}=u;if(!O.test(n))throw new Error(`Invalid form collector name "${n}": 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,p=c.properties??{},y=c.required??[],a=e=>e==null||e==="",b=e=>y.filter(t=>a(e[t])),v=e=>{const t={};for(const[r,s]of Object.entries(e)){const i=p[r];if(i)if(s==null)t[r]=s;else if(i.type==="number"||i.type==="integer"){const g=typeof s=="number"?s:Number(s);t[r]=Number.isNaN(g)?s:g}else i.type==="boolean"?t[r]=typeof s=="boolean"?s:s==="true"?!0:s==="false"?!1:!!s:t[r]=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(),r={...t.values,...e},s=b(r),i={...t,values:r,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 r;if(o.via==="client")if("handler"in o)r=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}`};r=await s.json().catch(()=>{})}else{if(!d)return{ok:!1,error:"Backend submit requires install(client) (or useFormCollector) first."};r=await d.submitFormCollector(o.destination,t)}return l.set({...l.get(),submitted:!0}),{ok:!0,result:r}}catch(r){const s=r instanceof Error?r.message:"Submit failed";return x.logger.error(`FormCollector "${n}" submit failed:`,r),{ok:!1,error:s}}},_={name:`update_${n}`,description:`Fill or update fields of the "${n}" 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}}},h=[_];o&&h.push({name:`submit_${n}`,description:`Submit the completed "${n}" 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_${n}`:null,T=e=>{const t=e.functionName??e.toolName;if(t)return t.startsWith(E)?t.slice(8):t},w=e=>{let t={...f},r=!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"&&(r=!0)}const s=b(t);l.set({values:t,missing:s,complete:s.length===0,submitted:r})},C=`form:${n}`,F=()=>{const e=l.get(),t=o?` When all required fields are present and the user confirms, call submit_${n}.`:"";return{name:`Form: ${n}`,description:`Conversational form the assistant is helping fill. ${m} Use update_${n} 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:n,store:l,functions:h,contextKey:C,contextProvider:F,install:e=>{d=e;for(const r of h)e.register(r);e.addDynamicContext(C,F);const t=l.subscribe(()=>e.notifyContextChanged());return e.on("conversation:loaded",q),()=>{t();for(const r of h)e.unregisterFunction(r.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 I}});Object.defineProperty(exports,"createStore",{enumerable:!0,get:function(){return P}});

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

@@ -1,4 +1,4 @@
-function w(g = {}) {
+function C(g = {}) {
   const { overrides: m = {} } = g, d = {
     id: "mock-msg-1",
     conversationId: "mock-conv-1",
@@ -27,6 +27,9 @@ function w(g = {}) {
     },
     unregisterFunction: () => !0,
     getRegisteredFunctions: () => [],
+    getContextSnapshot: () => null,
+    notifyContextChanged: () => {
+    },
     registerNavigationFunction: () => {
     },
     on: (e, o) => {
@@ -67,5 +70,5 @@ function w(g = {}) {
   }, n;
 }
 export {
-  w as t
+  C as t
 };

package/dist/createMockClient-zHQ0cjUH.cjs

@@ -0,0 +1 @@
+function C(g={}){const{overrides:u={}}=g,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,r=[],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,notifyContextChanged:()=>{},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=(...i)=>{t.get(e)?.delete(n),o(...i)};t.has(e)||t.set(e,new Set),t.get(e).add(n)},waitFor:(e,o)=>new Promise((n,i)=>{let a;const c=f=>{a&&clearTimeout(a),t.get(e)?.delete(c),n(f)};t.has(e)||t.set(e,new Set),t.get(e).add(c),o?.timeout&&(a=setTimeout(()=>{t.get(e)?.delete(c),i(new Error(`waitFor("${e}") timed out after ${o.timeout}ms`))},o.timeout))}),updateConfig:()=>{},destroy:()=>{t.clear()},...u},s={};for(const[e,o]of Object.entries(m))s[e]=(...n)=>(r.push({method:e,args:n}),o(...n));return s.__calls=r,s.__callsFor=e=>r.filter(o=>o.method===e),s.__emitEvent=(e,o)=>{const n=t.get(e);n&&[...n].forEach(i=>i(o))},s}Object.defineProperty(exports,"createMockClient",{enumerable:!0,get:function(){return C}});

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 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=`
     <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>${(e.getRegisteredFunctions?.()??[]).map(a=>a.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=`
+  `,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=`
 #ago-dev-panel {
   position: fixed;
   top: 16px;
@@ -105,4 +105,5 @@ 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;
+#ago-dev-panel .dev-log-hydrate { color: #d8b4fe; }
+`;exports.initDevPanel=h;

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
      */
@@ -141,6 +147,13 @@ declare class AgoClient {
      * Remove a dynamic context provider.
      */
     removeDynamicContext(key: string): boolean;
+    /**
+     * Broadcast that the client-side context changed by emitting `context:changed`
+     * with the fresh snapshot. The context-mutating methods call this automatically;
+     * stateful helpers whose context lives in a store (e.g. `createFormCollector`)
+     * call it when their store updates so observers like the dev panel stay live.
+     */
+    notifyContextChanged(): void;
     /**
      * Enable automatic capture of the current browser page (URL + title).
      * Injected as a dynamic context entry named `browser-page`.
@@ -186,6 +199,14 @@ declare class AgoClient {
  * SDK Events
  */
 declare interface AgoClientEvents {
+    /**
+     * The client-side context changed: a context entry or dynamic provider was
+     * added/removed, or a stateful helper (e.g. `createFormCollector`) updated its
+     * store. Carries the fresh snapshot so observers — notably the dev panel — can
+     * repaint without waiting for the next message. Fires for the form collector's
+     * initial install too, so its missing fields show from the start of a conversation.
+     */
+    "context:changed": ContextSnapshot | null;
     "message:start": {
         conversationId: string;
         messageId: string;
@@ -201,6 +222,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 +377,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 +427,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
  */