@useago/sdk 0.4.2 → 0.4.4

package/dist/{createConversationSession-DtaeA418.cjs → createConversationSession-DibXdxoC.cjs}

@@ -1 +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 _}});
+const d=require("./createFormCollector-DLwgDX24.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/{createConversationSession-D9FesBQS.js → createConversationSession-XkiOGAUT.js}

@@ -1,4 +1,4 @@
-import { n as d } from "./createFormCollector-BwvkKi48.js";
+import { r as d } from "./createFormCollector-D4-yZh1i.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) => {

package/dist/createFormCollector-D4-yZh1i.js

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

package/dist/createFormCollector-DLwgDX24.cjs

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

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("./AgoClient-D4EL6nva.cjs"),p=require("./createFormCollector-Wb8Rr-U2.cjs"),A=require("./createConversationSession-DtaeA418.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?.()},m=s=>{c({type:"error",data:s}),a=!0,r?.()},d=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",m),e.on("toolCall:received",d),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",m),e.off("toolCall:received",d)}}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 q(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 F(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=q;exports.createConversationSession=A.createConversationSession;exports.createFormCollector=p.createFormCollector;exports.createMessageStream=k;exports.createMockClient=C.createMockClient;exports.createStore=p.createStore;exports.defineFunction=h;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=F;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("./AgoClient-D4EL6nva.cjs"),m=require("./createFormCollector-DLwgDX24.cjs"),A=require("./createConversationSession-DibXdxoC.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

@@ -740,6 +740,14 @@ export declare function createStore<T>(initial: T, persist?: PersistOptions): St
  */
 export declare function defineFunction(definition: ClientFunctionDefinition): ClientFunctionDefinition;
 
+/**
+ * Compute which required fields are still empty and whether the form is complete.
+ * Pure — the single home for the "required + non-empty" rule, shared by the update
+ * handler, submit, the dynamic context, and the React hook. Derived on read so the
+ * store only ever holds canonical state ({@link FormCollectorState}).
+ */
+export declare function deriveFormStatus(schema: FormCollectorSchema, values: Partial<Record<string, unknown>>): FormCollectorStatus;
+
 /**
  * A function that returns a fresh context entry on demand.
  * Evaluated every time a message is sent — use it to pull data from stores,
@@ -805,16 +813,20 @@ export declare interface FormCollector<V = Record<string, unknown>> {
  */
 export declare type FormCollectorSchema = ClientFunctionSchema["parameters"];
 
-/** Live state held in the collector's store. */
+/** Canonical, source-of-truth state held in the collector's store. */
 export declare interface FormCollectorState<V = Record<string, unknown>> {
     /** Field values collected so far. */
     values: Partial<V>;
+    /** True once a submit succeeded. */
+    submitted: boolean;
+}
+
+/** Completeness status derived from values + schema — computed on read, never stored. */
+export declare interface FormCollectorStatus {
     /** Required field names still empty. */
     missing: string[];
     /** True when no required field is missing. */
     complete: boolean;
-    /** True once a submit succeeded. */
-    submitted: boolean;
 }
 
 export declare interface FormField {

package/dist/index.d.ts

@@ -740,6 +740,14 @@ export declare function createStore<T>(initial: T, persist?: PersistOptions): St
  */
 export declare function defineFunction(definition: ClientFunctionDefinition): ClientFunctionDefinition;
 
+/**
+ * Compute which required fields are still empty and whether the form is complete.
+ * Pure — the single home for the "required + non-empty" rule, shared by the update
+ * handler, submit, the dynamic context, and the React hook. Derived on read so the
+ * store only ever holds canonical state ({@link FormCollectorState}).
+ */
+export declare function deriveFormStatus(schema: FormCollectorSchema, values: Partial<Record<string, unknown>>): FormCollectorStatus;
+
 /**
  * A function that returns a fresh context entry on demand.
  * Evaluated every time a message is sent — use it to pull data from stores,
@@ -805,16 +813,20 @@ export declare interface FormCollector<V = Record<string, unknown>> {
  */
 export declare type FormCollectorSchema = ClientFunctionSchema["parameters"];
 
-/** Live state held in the collector's store. */
+/** Canonical, source-of-truth state held in the collector's store. */
 export declare interface FormCollectorState<V = Record<string, unknown>> {
     /** Field values collected so far. */
     values: Partial<V>;
+    /** True once a submit succeeded. */
+    submitted: boolean;
+}
+
+/** Completeness status derived from values + schema — computed on read, never stored. */
+export declare interface FormCollectorStatus {
     /** Required field names still empty. */
     missing: string[];
     /** True when no required field is missing. */
     complete: boolean;
-    /** True once a submit succeeded. */
-    submitted: boolean;
 }
 
 export declare interface FormField {

package/dist/index.js

@@ -1,34 +1,34 @@
-import { a as w, c as h, d as A, f as y, i as C, l as E, n as b, o as S, r as v, s as k, t as d, u as M } from "./AgoClient-rvTz2thR.js";
-import { n as T, t as I } from "./createFormCollector-BwvkKi48.js";
-import { t as G } from "./createConversationSession-D9FesBQS.js";
-import { t as q } from "./createMockClient-DwdxNwEn.js";
-import { a as L, c as N, d as D, f as H, i as J, l as R, m as j, o as B, p as P, r as $, s as z, t as K, u as Q } from "./functions-C1-5vadY.js";
-function V(e) {
+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-D4-yZh1i.js";
+import { t as O } from "./createConversationSession-XkiOGAUT.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) {
   return e;
 }
-function W(e, t) {
+function X(e, t) {
   return e.on("message:complete", t), () => e.off("message:complete", t);
 }
-function X(e, t) {
+function Y(e, t) {
   return e.on("message:chunk", t), () => e.off("message:chunk", t);
 }
-function Y(e, t) {
+function Z(e, t) {
   return e.on("message:start", t), () => e.off("message:start", t);
 }
-function Z(e, t) {
+function _(e, t) {
   return e.on("message:error", t), () => e.off("message:error", t);
 }
-function _(e, t) {
+function ee(e, t) {
   return e.on("toolCall:received", t), () => e.off("toolCall:received", t);
 }
-function ee(e, t) {
+function te(e, t) {
   return e.on("function:invoke", t), () => e.off("function:invoke", t);
 }
-async function* te(e, t, g) {
-  const n = [];
-  let r = null, a = !1;
+async function* oe(e, t, g) {
+  const a = [];
+  let r = null, n = !1;
   const u = (s) => {
-    n.push(s), r?.();
+    a.push(s), r?.();
   }, f = (s) => u({
     type: "start",
     data: s
@@ -39,21 +39,21 @@ async function* te(e, t, g) {
     u({
       type: "complete",
       data: s
-    }), a = !0, r?.();
+    }), n = !0, r?.();
   }, m = (s) => {
     u({
       type: "error",
       data: s
-    }), a = !0, r?.();
+    }), n = !0, r?.();
   }, l = (s) => u({
     type: "toolCall",
     data: s
   });
   e.on("message:start", f), e.on("message:chunk", o), e.on("message:complete", i), e.on("message:error", m), e.on("toolCall:received", l), e.sendMessage(t, g).catch(() => {
-    a = !0, r?.();
+    n = !0, r?.();
   });
   try {
-    for (; !a || n.length > 0; ) n.length > 0 ? yield n.shift() : (await new Promise((s) => {
+    for (; !n || a.length > 0; ) a.length > 0 ? yield a.shift() : (await new Promise((s) => {
       r = s;
     }), r = null);
   } finally {
@@ -61,38 +61,38 @@ async function* te(e, t, g) {
   }
 }
 function c(e) {
-  let t, g, n, r, a, u;
+  let t, g, a, r, n, u;
   if (typeof window < "u" && window.AGO) {
     const o = window.AGO;
-    t = o.basepath, g = o.widgetId, n = o.agent || o.defaultAgent, r = o.permission, a = o.email, u = o.jwt;
+    t = o.basepath, g = o.widgetId, a = o.agent || o.defaultAgent, r = o.permission, n = o.email, u = o.jwt;
   }
   if (typeof document < "u") {
     const o = (i) => document.querySelector(`meta[name="${i}"]`)?.getAttribute("content") || void 0;
-    t = t || o("ago-base-url"), g = g || o("ago-widget-id"), n = n || o("ago-agent") || o("ago-agent-id"), r = r || o("ago-permission"), a = a || o("ago-user-email");
+    t = t || o("ago-base-url"), g = g || o("ago-widget-id"), a = a || o("ago-agent") || o("ago-agent-id"), r = r || o("ago-permission"), n = n || o("ago-user-email");
   }
   if (typeof document < "u") {
     const o = [document.body, ...Array.from(document.querySelectorAll("script[data-ago-base-url]"))].filter(Boolean);
     for (const i of o)
-      i && (t = t || i.getAttribute("data-ago-base-url") || void 0, g = g || i.getAttribute("data-ago-widget-id") || void 0, n = n || i.getAttribute("data-ago-agent") || i.getAttribute("data-ago-agent-id") || void 0, r = r || i.getAttribute("data-ago-permission") || void 0, a = a || i.getAttribute("data-ago-user-email") || void 0);
+      i && (t = t || i.getAttribute("data-ago-base-url") || void 0, g = g || i.getAttribute("data-ago-widget-id") || void 0, a = a || i.getAttribute("data-ago-agent") || i.getAttribute("data-ago-agent-id") || void 0, r = r || i.getAttribute("data-ago-permission") || void 0, n = n || i.getAttribute("data-ago-user-email") || void 0);
   }
-  t = e?.baseUrl || t, g = e?.widgetId || g, n = e?.agent || e?.defaultAgentId || n, r = e?.permission || r, a = e?.userEmail || a, u = e?.userJwt || u;
+  t = e?.baseUrl || t, g = e?.widgetId || g, a = e?.agent || e?.defaultAgentId || a, r = e?.permission || r, n = e?.userEmail || n, u = e?.userJwt || u;
   const f = e?.debug;
   return t ? {
     baseUrl: t,
     widgetId: g,
-    agent: n,
+    agent: a,
     permission: r,
-    userEmail: a,
+    userEmail: n,
     userJwt: u,
     debug: f
   } : null;
 }
-function oe(e) {
+function re(e) {
   const t = c(e);
   if (!t) throw new Error('createAgo(): could not detect AGO configuration. Set window.AGO, add <meta name="ago-base-url">, or pass { baseUrl } explicitly.');
   return new d(t);
 }
-function re(e, t) {
+function ae(e, t) {
   return {
     ...e,
     handler: t
@@ -106,37 +106,38 @@ export {
   A as AgoNetworkError,
   y as AgoStreamError,
   w as ClientContextRegistry,
-  b as EventEmitter,
-  S as FunctionRegistry,
+  S as EventEmitter,
+  b as FunctionRegistry,
   v as SSEHandler,
   c as autoDetectConfig,
-  K as copyToClipboard,
-  oe as createAgo,
-  G as createConversationSession,
-  I as createFormCollector,
-  te as createMessageStream,
-  q as createMockClient,
-  T as createStore,
-  V as defineFunction,
-  $ as getLocalStorage,
-  J as getUserLocation,
-  L as highlightElement,
+  Q as copyToClipboard,
+  re as createAgo,
+  O as createConversationSession,
+  U as createFormCollector,
+  oe as createMessageStream,
+  x as createMockClient,
+  I as createStore,
+  W as defineFunction,
+  T as deriveFormStatus,
+  z as getLocalStorage,
+  R as getUserLocation,
+  N as highlightElement,
   C as isStreamNetworkError,
   k as logger,
-  ee as onFunctionInvoke,
-  W as onMessage,
-  X as onMessageChunk,
-  Z as onMessageError,
-  Y as onMessageStart,
-  _ as onToolCall,
-  B as openUrl,
-  z as scrollToElement,
-  N as setLocalStorage,
-  R as setTheme,
-  Q as showConfirmDialog,
-  D as showNotification,
-  H as showToast,
-  P as submitForm,
-  j as trackEvent,
-  re as withHandler
+  te as onFunctionInvoke,
+  X as onMessage,
+  Y as onMessageChunk,
+  _ as onMessageError,
+  Z as onMessageStart,
+  ee as onToolCall,
+  P as openUrl,
+  K as scrollToElement,
+  D as setLocalStorage,
+  j as setTheme,
+  V as showConfirmDialog,
+  H as showNotification,
+  J as showToast,
+  $ as submitForm,
+  B as trackEvent,
+  ae as withHandler
 };