@useago/sdk 1.0.5 → 1.0.7

package/README.md

@@ -81,6 +81,59 @@ guards, auth and layouts keep working exactly as they do today.
 `react-router-dom` here is *your* router, not an SDK dependency:
 `useAgoNavigation` accepts any `(path: string) => void` function.
 
+## Turn a JavaScript function into an agent tool
+
+Keep your application logic as a regular JavaScript function, then describe its
+arguments with `defineFunction`. The description and JSON Schema tell the agent
+when and how to call it:
+
+```js
+import { defineFunction } from "@useago/sdk";
+
+async function getOrderStatus({ orderId }) {
+  const response = await fetch(`/api/orders/${orderId}`);
+  if (!response.ok) throw new Error("Order not found");
+
+  const order = await response.json();
+
+  return { orderId, status: order.status };
+}
+
+export const getOrderStatusTool = defineFunction({
+  name: "getOrderStatus",
+  description: "Get the current status of an order from its ID.",
+  parameters: {
+    type: "object",
+    properties: {
+      orderId: {
+        type: "string",
+        description: "The order ID shown to the user",
+      },
+    },
+    required: ["orderId"],
+  },
+  handler: getOrderStatus,
+});
+```
+
+Register the definition once to expose it to the agent. In React, pass it to
+the provider:
+
+```tsx
+<AgoProvider
+  baseUrl="https://api.example.com"
+  agent="support-agent"
+  tools={[getOrderStatusTool]}
+>
+  <ChatWidget />
+</AgoProvider>
+```
+
+With the core client, use `client.registerFunction(getOrderStatusTool)`.
+Whenever the agent calls the tool, the SDK runs your handler in the browser
+with the generated arguments and sends its return value back to the agent. Keep
+the return value small and structured so the agent can use it reliably.
+
 ## Show the source docs the agent retrieved
 
 Each assistant message carries the knowledge sources it used in `m.sources`

package/dist/angular.d.cts

@@ -544,6 +544,8 @@ declare interface FormCollectorDefinition<V = Record<string, unknown>> {
     schema: FormCollectorSchema;
     /** Server-stored submit target, if any. Absent means collect-only. */
     submit?: SubmitConfig<V>;
+    /** Server-stored default for auto-submitting once the form is complete. */
+    autoSubmit?: boolean;
 }
 
 /**

package/dist/angular.d.ts

@@ -544,6 +544,8 @@ declare interface FormCollectorDefinition<V = Record<string, unknown>> {
     schema: FormCollectorSchema;
     /** Server-stored submit target, if any. Absent means collect-only. */
     submit?: SubmitConfig<V>;
+    /** Server-stored default for auto-submitting once the form is complete. */
+    autoSubmit?: boolean;
 }
 
 /**

package/dist/{createConversationSession-lJWANT6T.cjs → createConversationSession-BuMXp0Ia.cjs}

@@ -1 +1 @@
-const d=require("./createFormCollector-CSG5ioym.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-DWzGKDwO.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-Boi0PjDU.js → createConversationSession-CCT1hCf8.js}

@@ -1,4 +1,4 @@
-import { i as d } from "./createFormCollector-BUqSA2Qw.js";
+import { i as d } from "./createFormCollector-BwM7qTrp.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-BwM7qTrp.js

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

package/dist/createFormCollector-DWzGKDwO.cjs

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

package/dist/devtools.d.cts

@@ -467,6 +467,8 @@ declare interface FormCollectorDefinition<V = Record<string, unknown>> {
     schema: FormCollectorSchema;
     /** Server-stored submit target, if any. Absent means collect-only. */
     submit?: SubmitConfig<V>;
+    /** Server-stored default for auto-submitting once the form is complete. */
+    autoSubmit?: boolean;
 }
 
 /**

package/dist/devtools.d.ts

@@ -467,6 +467,8 @@ declare interface FormCollectorDefinition<V = Record<string, unknown>> {
     schema: FormCollectorSchema;
     /** Server-stored submit target, if any. Absent means collect-only. */
     submit?: SubmitConfig<V>;
+    /** Server-stored default for auto-submitting once the form is complete. */
+    autoSubmit?: boolean;
 }
 
 /**

package/dist/{functions-C1-5vadY.js → functions-CApuQZ2b.js}

@@ -1,19 +1,26 @@
-import { n as s } from "./rolldown-runtime-DxmricAu.js";
-var S = /* @__PURE__ */ s({
-  copyToClipboard: () => p,
-  getLocalStorage: () => f,
-  getUserLocation: () => m,
-  highlightElement: () => g,
-  openUrl: () => l,
-  scrollToElement: () => h,
-  setLocalStorage: () => y,
-  setTheme: () => d,
-  showConfirmDialog: () => u,
-  showNotification: () => c,
-  showToast: () => a,
-  submitForm: () => v,
-  trackEvent: () => b
-}), a = {
+var n = Object.defineProperty, a = (e, t) => {
+  let r = {};
+  for (var o in e)
+    n(r, o, {
+      get: e[o],
+      enumerable: !0
+    });
+  return t || n(r, Symbol.toStringTag, { value: "Module" }), r;
+}, S = /* @__PURE__ */ a({
+  copyToClipboard: () => d,
+  getLocalStorage: () => g,
+  getUserLocation: () => h,
+  highlightElement: () => v,
+  openUrl: () => p,
+  scrollToElement: () => y,
+  setLocalStorage: () => f,
+  setTheme: () => u,
+  showConfirmDialog: () => m,
+  showNotification: () => l,
+  showToast: () => c,
+  submitForm: () => b,
+  trackEvent: () => w
+}), c = {
   name: "showToast",
   description: "Show a toast notification to the user. Use this to confirm actions or display brief messages.",
   parameters: {
@@ -44,7 +51,7 @@ var S = /* @__PURE__ */ s({
     shown: !1,
     error: "No toast handler configured"
   })
-}, c = {
+}, l = {
   name: "showNotification",
   description: "Show a browser notification to the user. Useful for important alerts even when the tab is not focused.",
   parameters: {
@@ -71,7 +78,7 @@ var S = /* @__PURE__ */ s({
     shown: !1,
     error: "Permission not granted"
   })
-}, l = {
+}, p = {
   name: "openUrl",
   description: "Open a URL in a new browser tab.",
   parameters: {
@@ -83,7 +90,7 @@ var S = /* @__PURE__ */ s({
     required: ["url"]
   },
   handler: async (e) => (window.open(e.url, "_blank", "noopener,noreferrer"), { opened: !0 })
-}, p = {
+}, d = {
   name: "copyToClipboard",
   description: "Copy text to the user's clipboard.",
   parameters: {
@@ -95,7 +102,7 @@ var S = /* @__PURE__ */ s({
     required: ["text"]
   },
   handler: async (e) => (await navigator.clipboard.writeText(e.text), { copied: !0 })
-}, d = {
+}, u = {
   name: "setTheme",
   description: "Change the application's color theme. Sets a data-theme attribute on the document element.",
   parameters: {
@@ -118,7 +125,7 @@ var S = /* @__PURE__ */ s({
       applied: !0
     };
   }
-}, u = {
+}, m = {
   name: "showConfirmDialog",
   description: "Show a confirmation dialog to the user and return their choice (true/false).",
   parameters: {
@@ -130,7 +137,7 @@ var S = /* @__PURE__ */ s({
     required: ["message"]
   },
   handler: async (e) => ({ confirmed: window.confirm(e.message) })
-}, m = {
+}, h = {
   name: "getUserLocation",
   description: "Get the user's current geographic location (requires permission).",
   parameters: {
@@ -144,7 +151,7 @@ var S = /* @__PURE__ */ s({
       accuracy: t.coords.accuracy
     }), (t) => e({ error: t.message }));
   }) : { error: "Geolocation not supported" }
-}, h = {
+}, y = {
   name: "scrollToElement",
   description: "Scroll the page to a specific element identified by CSS selector.",
   parameters: {
@@ -169,7 +176,7 @@ var S = /* @__PURE__ */ s({
       error: `Element not found: ${e.selector}`
     };
   }
-}, y = {
+}, f = {
   name: "setLocalStorage",
   description: "Store a value in the browser's localStorage.",
   parameters: {
@@ -187,7 +194,7 @@ var S = /* @__PURE__ */ s({
     required: ["key", "value"]
   },
   handler: async (e) => (localStorage.setItem(e.key, e.value), { stored: !0 })
-}, f = {
+}, g = {
   name: "getLocalStorage",
   description: "Retrieve a value from the browser's localStorage.",
   parameters: {
@@ -206,7 +213,7 @@ var S = /* @__PURE__ */ s({
       found: t !== null
     };
   }
-}, g = {
+}, v = {
   name: "highlightElement",
   description: "Highlight a DOM element to draw the user's attention (e.g. for onboarding).",
   parameters: {
@@ -237,7 +244,7 @@ var S = /* @__PURE__ */ s({
       t.style.outline = r, t.style.outlineOffset = "";
     }, 3e3), { highlighted: !0 };
   }
-}, v = {
+}, b = {
   name: "submitForm",
   description: "Fill and submit an HTML form on the page. Pass field values as key-value pairs.",
   parameters: {
@@ -262,14 +269,14 @@ var S = /* @__PURE__ */ s({
     };
     if (e.values) {
       const r = JSON.parse(e.values);
-      for (const [o, n] of Object.entries(r)) {
+      for (const [o, s] of Object.entries(r)) {
         const i = t.elements.namedItem(o);
-        i && (i.value = n);
+        i && (i.value = s);
       }
     }
     return t.requestSubmit(), { submitted: !0 };
   }
-}, b = {
+}, w = {
   name: "trackEvent",
   description: "Track a custom analytics event. Override the handler to wire up your analytics provider.",
   parameters: {
@@ -295,18 +302,18 @@ var S = /* @__PURE__ */ s({
   }
 };
 export {
-  g as a,
-  y as c,
-  c as d,
-  a as f,
-  m as i,
-  d as l,
-  b as m,
+  v as a,
+  f as c,
+  l as d,
+  c as f,
+  h as i,
+  u as l,
+  w as m,
   S as n,
-  l as o,
-  v as p,
-  f as r,
-  h as s,
-  p as t,
-  u
+  p as o,
+  b as p,
+  g as r,
+  y as s,
+  d as t,
+  m as u
 };

package/dist/{functions-DsmzgHjC.cjs → functions-Djnq-JAo.cjs}

@@ -1 +1 @@
-const v=require("./rolldown-runtime-CaekUdDJ.cjs");var w=v.__exportAll({copyToClipboard:()=>c,getLocalStorage:()=>f,getUserLocation:()=>p,highlightElement:()=>h,openUrl:()=>a,scrollToElement:()=>d,setLocalStorage:()=>m,setTheme:()=>l,showConfirmDialog:()=>u,showNotification:()=>s,showToast:()=>i,submitForm:()=>y,trackEvent:()=>g}),i={name:"showToast",description:"Show a toast notification to the user. Use this to confirm actions or display brief messages.",parameters:{type:"object",properties:{message:{type:"string",description:"The message to display"},type:{type:"string",description:"Toast type",enum:["success","error","warning","info"]},duration:{type:"number",description:"Duration in milliseconds (default 3000)"}},required:["message"]},handler:async()=>({shown:!1,error:"No toast handler configured"})},s={name:"showNotification",description:"Show a browser notification to the user. Useful for important alerts even when the tab is not focused.",parameters:{type:"object",properties:{title:{type:"string",description:"Notification title"},body:{type:"string",description:"Notification body text"}},required:["title"]},handler:async e=>typeof Notification>"u"?{shown:!1,error:"Notifications not supported"}:Notification.permission==="denied"?{shown:!1,error:"Notification permission denied"}:(Notification.permission!=="granted"&&await Notification.requestPermission(),Notification.permission==="granted"?(new Notification(e.title,{body:e.body}),{shown:!0}):{shown:!1,error:"Permission not granted"})},a={name:"openUrl",description:"Open a URL in a new browser tab.",parameters:{type:"object",properties:{url:{type:"string",description:"The URL to open"}},required:["url"]},handler:async e=>(window.open(e.url,"_blank","noopener,noreferrer"),{opened:!0})},c={name:"copyToClipboard",description:"Copy text to the user's clipboard.",parameters:{type:"object",properties:{text:{type:"string",description:"The text to copy"}},required:["text"]},handler:async e=>(await navigator.clipboard.writeText(e.text),{copied:!0})},l={name:"setTheme",description:"Change the application's color theme. Sets a data-theme attribute on the document element.",parameters:{type:"object",properties:{theme:{type:"string",description:"Theme to apply",enum:["light","dark","system"]}},required:["theme"]},handler:async e=>{const t=e.theme;return document.documentElement.setAttribute("data-theme",t),t==="dark"?document.documentElement.classList.add("dark"):document.documentElement.classList.remove("dark"),{theme:t,applied:!0}}},u={name:"showConfirmDialog",description:"Show a confirmation dialog to the user and return their choice (true/false).",parameters:{type:"object",properties:{message:{type:"string",description:"The confirmation message to display"}},required:["message"]},handler:async e=>({confirmed:window.confirm(e.message)})},p={name:"getUserLocation",description:"Get the user's current geographic location (requires permission).",parameters:{type:"object",properties:{}},handler:async()=>navigator.geolocation?new Promise(e=>{navigator.geolocation.getCurrentPosition(t=>e({latitude:t.coords.latitude,longitude:t.coords.longitude,accuracy:t.coords.accuracy}),t=>e({error:t.message}))}):{error:"Geolocation not supported"}},d={name:"scrollToElement",description:"Scroll the page to a specific element identified by CSS selector.",parameters:{type:"object",properties:{selector:{type:"string",description:"CSS selector of the element to scroll to (e.g. '#section-pricing')"},behavior:{type:"string",description:"Scroll behavior",enum:["smooth","instant"]}},required:["selector"]},handler:async e=>{const t=document.querySelector(e.selector);return t?(t.scrollIntoView({behavior:e.behavior||"smooth"}),{scrolled:!0}):{scrolled:!1,error:`Element not found: ${e.selector}`}}},m={name:"setLocalStorage",description:"Store a value in the browser's localStorage.",parameters:{type:"object",properties:{key:{type:"string",description:"Storage key"},value:{type:"string",description:"Value to store"}},required:["key","value"]},handler:async e=>(localStorage.setItem(e.key,e.value),{stored:!0})},f={name:"getLocalStorage",description:"Retrieve a value from the browser's localStorage.",parameters:{type:"object",properties:{key:{type:"string",description:"Storage key"}},required:["key"]},handler:async e=>{const t=localStorage.getItem(e.key);return{key:e.key,value:t,found:t!==null}}},h={name:"highlightElement",description:"Highlight a DOM element to draw the user's attention (e.g. for onboarding).",parameters:{type:"object",properties:{selector:{type:"string",description:"CSS selector of the element to highlight"},color:{type:"string",description:"Highlight border color (default: #3b82f6)"}},required:["selector"]},handler:async e=>{const t=document.querySelector(e.selector);if(!t)return{highlighted:!1,error:`Element not found: ${e.selector}`};const r=t.style.outline,o=e.color||"#3b82f6";return t.style.outline=`3px solid ${o}`,t.style.outlineOffset="2px",t.scrollIntoView({behavior:"smooth",block:"center"}),setTimeout(()=>{t.style.outline=r,t.style.outlineOffset=""},3e3),{highlighted:!0}}},y={name:"submitForm",description:"Fill and submit an HTML form on the page. Pass field values as key-value pairs.",parameters:{type:"object",properties:{selector:{type:"string",description:"CSS selector of the form element"},values:{type:"string",description:"JSON string of field name → value pairs"}},required:["selector"]},handler:async e=>{const t=document.querySelector(e.selector);if(!t)return{submitted:!1,error:`Form not found: ${e.selector}`};if(e.values){const r=JSON.parse(e.values);for(const[o,b]of Object.entries(r)){const n=t.elements.namedItem(o);n&&(n.value=b)}}return t.requestSubmit(),{submitted:!0}}},g={name:"trackEvent",description:"Track a custom analytics event. Override the handler to wire up your analytics provider.",parameters:{type:"object",properties:{event:{type:"string",description:"Event name"},properties:{type:"string",description:"JSON string of event properties"}},required:["event"]},handler:async e=>{const t=e.properties?JSON.parse(e.properties):{};return console.log(`[AGO Analytics] ${e.event}`,t),{tracked:!0,event:e.event}}};Object.defineProperty(exports,"copyToClipboard",{enumerable:!0,get:function(){return c}});Object.defineProperty(exports,"functions_exports",{enumerable:!0,get:function(){return w}});Object.defineProperty(exports,"getLocalStorage",{enumerable:!0,get:function(){return f}});Object.defineProperty(exports,"getUserLocation",{enumerable:!0,get:function(){return p}});Object.defineProperty(exports,"highlightElement",{enumerable:!0,get:function(){return h}});Object.defineProperty(exports,"openUrl",{enumerable:!0,get:function(){return a}});Object.defineProperty(exports,"scrollToElement",{enumerable:!0,get:function(){return d}});Object.defineProperty(exports,"setLocalStorage",{enumerable:!0,get:function(){return m}});Object.defineProperty(exports,"setTheme",{enumerable:!0,get:function(){return l}});Object.defineProperty(exports,"showConfirmDialog",{enumerable:!0,get:function(){return u}});Object.defineProperty(exports,"showNotification",{enumerable:!0,get:function(){return s}});Object.defineProperty(exports,"showToast",{enumerable:!0,get:function(){return i}});Object.defineProperty(exports,"submitForm",{enumerable:!0,get:function(){return y}});Object.defineProperty(exports,"trackEvent",{enumerable:!0,get:function(){return g}});
+const v=require("./rolldown-runtime-16Nf8qvH.cjs");var w=v.__exportAll({copyToClipboard:()=>c,getLocalStorage:()=>f,getUserLocation:()=>p,highlightElement:()=>h,openUrl:()=>a,scrollToElement:()=>d,setLocalStorage:()=>m,setTheme:()=>l,showConfirmDialog:()=>u,showNotification:()=>s,showToast:()=>i,submitForm:()=>y,trackEvent:()=>g}),i={name:"showToast",description:"Show a toast notification to the user. Use this to confirm actions or display brief messages.",parameters:{type:"object",properties:{message:{type:"string",description:"The message to display"},type:{type:"string",description:"Toast type",enum:["success","error","warning","info"]},duration:{type:"number",description:"Duration in milliseconds (default 3000)"}},required:["message"]},handler:async()=>({shown:!1,error:"No toast handler configured"})},s={name:"showNotification",description:"Show a browser notification to the user. Useful for important alerts even when the tab is not focused.",parameters:{type:"object",properties:{title:{type:"string",description:"Notification title"},body:{type:"string",description:"Notification body text"}},required:["title"]},handler:async e=>typeof Notification>"u"?{shown:!1,error:"Notifications not supported"}:Notification.permission==="denied"?{shown:!1,error:"Notification permission denied"}:(Notification.permission!=="granted"&&await Notification.requestPermission(),Notification.permission==="granted"?(new Notification(e.title,{body:e.body}),{shown:!0}):{shown:!1,error:"Permission not granted"})},a={name:"openUrl",description:"Open a URL in a new browser tab.",parameters:{type:"object",properties:{url:{type:"string",description:"The URL to open"}},required:["url"]},handler:async e=>(window.open(e.url,"_blank","noopener,noreferrer"),{opened:!0})},c={name:"copyToClipboard",description:"Copy text to the user's clipboard.",parameters:{type:"object",properties:{text:{type:"string",description:"The text to copy"}},required:["text"]},handler:async e=>(await navigator.clipboard.writeText(e.text),{copied:!0})},l={name:"setTheme",description:"Change the application's color theme. Sets a data-theme attribute on the document element.",parameters:{type:"object",properties:{theme:{type:"string",description:"Theme to apply",enum:["light","dark","system"]}},required:["theme"]},handler:async e=>{const t=e.theme;return document.documentElement.setAttribute("data-theme",t),t==="dark"?document.documentElement.classList.add("dark"):document.documentElement.classList.remove("dark"),{theme:t,applied:!0}}},u={name:"showConfirmDialog",description:"Show a confirmation dialog to the user and return their choice (true/false).",parameters:{type:"object",properties:{message:{type:"string",description:"The confirmation message to display"}},required:["message"]},handler:async e=>({confirmed:window.confirm(e.message)})},p={name:"getUserLocation",description:"Get the user's current geographic location (requires permission).",parameters:{type:"object",properties:{}},handler:async()=>navigator.geolocation?new Promise(e=>{navigator.geolocation.getCurrentPosition(t=>e({latitude:t.coords.latitude,longitude:t.coords.longitude,accuracy:t.coords.accuracy}),t=>e({error:t.message}))}):{error:"Geolocation not supported"}},d={name:"scrollToElement",description:"Scroll the page to a specific element identified by CSS selector.",parameters:{type:"object",properties:{selector:{type:"string",description:"CSS selector of the element to scroll to (e.g. '#section-pricing')"},behavior:{type:"string",description:"Scroll behavior",enum:["smooth","instant"]}},required:["selector"]},handler:async e=>{const t=document.querySelector(e.selector);return t?(t.scrollIntoView({behavior:e.behavior||"smooth"}),{scrolled:!0}):{scrolled:!1,error:`Element not found: ${e.selector}`}}},m={name:"setLocalStorage",description:"Store a value in the browser's localStorage.",parameters:{type:"object",properties:{key:{type:"string",description:"Storage key"},value:{type:"string",description:"Value to store"}},required:["key","value"]},handler:async e=>(localStorage.setItem(e.key,e.value),{stored:!0})},f={name:"getLocalStorage",description:"Retrieve a value from the browser's localStorage.",parameters:{type:"object",properties:{key:{type:"string",description:"Storage key"}},required:["key"]},handler:async e=>{const t=localStorage.getItem(e.key);return{key:e.key,value:t,found:t!==null}}},h={name:"highlightElement",description:"Highlight a DOM element to draw the user's attention (e.g. for onboarding).",parameters:{type:"object",properties:{selector:{type:"string",description:"CSS selector of the element to highlight"},color:{type:"string",description:"Highlight border color (default: #3b82f6)"}},required:["selector"]},handler:async e=>{const t=document.querySelector(e.selector);if(!t)return{highlighted:!1,error:`Element not found: ${e.selector}`};const r=t.style.outline,o=e.color||"#3b82f6";return t.style.outline=`3px solid ${o}`,t.style.outlineOffset="2px",t.scrollIntoView({behavior:"smooth",block:"center"}),setTimeout(()=>{t.style.outline=r,t.style.outlineOffset=""},3e3),{highlighted:!0}}},y={name:"submitForm",description:"Fill and submit an HTML form on the page. Pass field values as key-value pairs.",parameters:{type:"object",properties:{selector:{type:"string",description:"CSS selector of the form element"},values:{type:"string",description:"JSON string of field name → value pairs"}},required:["selector"]},handler:async e=>{const t=document.querySelector(e.selector);if(!t)return{submitted:!1,error:`Form not found: ${e.selector}`};if(e.values){const r=JSON.parse(e.values);for(const[o,b]of Object.entries(r)){const n=t.elements.namedItem(o);n&&(n.value=b)}}return t.requestSubmit(),{submitted:!0}}},g={name:"trackEvent",description:"Track a custom analytics event. Override the handler to wire up your analytics provider.",parameters:{type:"object",properties:{event:{type:"string",description:"Event name"},properties:{type:"string",description:"JSON string of event properties"}},required:["event"]},handler:async e=>{const t=e.properties?JSON.parse(e.properties):{};return console.log(`[AGO Analytics] ${e.event}`,t),{tracked:!0,event:e.event}}};Object.defineProperty(exports,"copyToClipboard",{enumerable:!0,get:function(){return c}});Object.defineProperty(exports,"functions_exports",{enumerable:!0,get:function(){return w}});Object.defineProperty(exports,"getLocalStorage",{enumerable:!0,get:function(){return f}});Object.defineProperty(exports,"getUserLocation",{enumerable:!0,get:function(){return p}});Object.defineProperty(exports,"highlightElement",{enumerable:!0,get:function(){return h}});Object.defineProperty(exports,"openUrl",{enumerable:!0,get:function(){return a}});Object.defineProperty(exports,"scrollToElement",{enumerable:!0,get:function(){return d}});Object.defineProperty(exports,"setLocalStorage",{enumerable:!0,get:function(){return m}});Object.defineProperty(exports,"setTheme",{enumerable:!0,get:function(){return l}});Object.defineProperty(exports,"showConfirmDialog",{enumerable:!0,get:function(){return u}});Object.defineProperty(exports,"showNotification",{enumerable:!0,get:function(){return s}});Object.defineProperty(exports,"showToast",{enumerable:!0,get:function(){return i}});Object.defineProperty(exports,"submitForm",{enumerable:!0,get:function(){return y}});Object.defineProperty(exports,"trackEvent",{enumerable:!0,get:function(){return g}});

package/dist/helpers.cjs

@@ -1 +1 @@
-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;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./functions-Djnq-JAo.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;

package/dist/helpers.js

@@ -1,4 +1,4 @@
-import { a, c as s, d as t, f as e, i as r, l as i, m as l, o as m, p as c, r as g, s as h, t as n, u as p } from "./functions-C1-5vadY.js";
+import { a, c as s, d as t, f as e, i as r, l as i, m as l, o as m, p as c, r as g, s as h, t as n, u as p } from "./functions-CApuQZ2b.js";
 export {
   n as copyToClipboard,
   g as getLocalStorage,