@useago/sdk 1.0.6 → 1.0.8

package/dist/react.d.ts

@@ -178,6 +178,7 @@ declare class AgoClient {
      * call it when their store updates so observers like the dev panel stay live.
      */
     notifyContextChanged(): void;
+    /* Excluded from this release type: emitFormEvent */
     /**
      * Enable automatic capture of the current browser page (URL + title).
      * Injected as a dynamic context entry named `browser-page`.
@@ -292,6 +293,27 @@ declare interface AgoClientEvents {
         result: unknown;
         error?: string;
     };
+    /**
+     * A form collector submitted successfully. `result` is the raw submit response
+     * (POST body / handler return value / backend relay result) — the third-party
+     * API's answer. `values` is the submitted field set, `name` the collector name.
+     */
+    "form:submitted": {
+        name: string;
+        values: Record<string, unknown>;
+        result: unknown;
+    };
+    /**
+     * A form collector submit was attempted and failed at the network/server level
+     * (HTTP non-2xx, or a thrown handler/fetch). `error` is the message. Validation
+     * pre-checks (missing required fields, no submit target) are NOT errors and do
+     * not fire this — they are returned to the caller as `{ ok: false }`.
+     */
+    "form:error": {
+        name: string;
+        values: Record<string, unknown>;
+        error: string;
+    };
     "connection:status": {
         connected: boolean;
     };
@@ -591,6 +613,16 @@ export declare interface CreateFormCollectorOptions<V = Record<string, unknown>>
     submit?: SubmitConfig<V>;
     /** Pre-filled values. */
     initialValues?: Partial<V>;
+    /**
+     * Submit on its own as soon as every required field is filled, without waiting
+     * for the agent or a UI button. The form submits at most once. Defaults to
+     * `true` whenever a `submit` target is set: when on, no `submit_<name>` function
+     * is exposed, the form submits itself, and the agent never confirms a submit.
+     * Pass `autoSubmit: false` to keep the manual flow (expose `submit_<name>` and
+     * submit only on an explicit call). Has no effect on a collect-only form (no
+     * `submit` target); setting it `true` there is ignored with a warning.
+     */
+    autoSubmit?: boolean;
 }
 
 /**
@@ -667,6 +699,8 @@ export 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;
 }
 
 /**
@@ -685,6 +719,13 @@ export declare interface FormCollectorState<V = Record<string, unknown>> {
     values: Partial<V>;
     /** True once a submit succeeded. */
     submitted: boolean;
+    /**
+     * The submit response, set once `submitted` is true: the resolved value of the
+     * client `handler`, the parsed JSON of a client `url` POST, or the backend
+     * relay result. Lets a UI surface a server-returned message. Undefined until
+     * a submit succeeds (and after `reset()`).
+     */
+    submitResult?: unknown;
 }
 
 /** Completeness status derived from values + schema — computed on read, never stored. */

package/dist/react.js

@@ -1,7 +1,7 @@
-import { t as J } from "./AgoClient-DYdIe_R4.js";
-import { i as q, n as Me, r as z, t as H } from "./createFormCollector-BUqSA2Qw.js";
+import { t as J } from "./AgoClient-QcTtrN7u.js";
+import { i as q, n as Me, r as z, t as H } from "./createFormCollector-QyojCH_-.js";
 import { t as Ee } from "./createMockClient-DwdxNwEn.js";
-import G, { createContext as V, useCallback as E, useContext as O, useEffect as k, useId as j, useMemo as F, useRef as T, useState as M, useSyncExternalStore as X } from "react";
+import G, { createContext as V, useCallback as E, useContext as O, useEffect as S, useId as j, useMemo as F, useRef as T, useState as M, useSyncExternalStore as X } from "react";
 import { Fragment as Y, jsx as s, jsxs as I } from "react/jsx-runtime";
 import Q from "react-markdown";
 import Z from "remark-gfm";
@@ -11,9 +11,9 @@ function ee(e) {
     const a = new J(e);
     return n.current = a, a;
   }, [e?.baseUrl, e?.widgetId]);
-  return k(() => (r(!0), () => {
+  return S(() => (r(!0), () => {
     n.current?.destroy(), n.current = null;
-  }), [o]), k(() => {
+  }), [o]), S(() => {
     n.current && e && n.current.updateConfig({
       agent: e.agent,
       defaultAgentId: e.defaultAgentId,
@@ -38,25 +38,25 @@ function ee(e) {
 }
 var D = V(null), Te = ({ children: e, client: t, tools: r, helpers: n, pageContext: o, ...a }) => {
   const { client: d } = ee(t ? null : a), i = t || d;
-  return k(() => {
+  return S(() => {
     if (!(!r || r.length === 0)) {
       for (const f of r) i.register(f);
       return () => {
         for (const f of r) i.unregisterFunction(f.name);
       };
     }
-  }, [i, r]), k(() => {
+  }, [i, r]), S(() => {
     if (!n) return;
     const f = [];
     return import("./functions-CApuQZ2b.js").then((c) => c.n).then((c) => {
       for (const [x, v] of Object.entries(n)) {
-        const S = c[x];
-        if (!S) {
+        const k = c[x];
+        if (!k) {
           console.warn(`[AGO] Unknown helper: "${x}"`);
           continue;
         }
-        const m = v === !0 ? S : {
-          ...S,
+        const m = v === !0 ? k : {
+          ...k,
           handler: v
         };
         i.register(m), f.push(m.name);
@@ -64,7 +64,7 @@ var D = V(null), Te = ({ children: e, client: t, tools: r, helpers: n, pageConte
     }), () => {
       for (const c of f) i.unregisterFunction(c);
     };
-  }, [i, n]), k(() => {
+  }, [i, n]), S(() => {
     o === "auto" && i.enableAutoPageContext();
   }, [i, o]), /* @__PURE__ */ s(D.Provider, {
     value: i,
@@ -83,17 +83,17 @@ function $({ client: e, conversationId: t } = {}) {
   const r = L(), n = e || r;
   if (!n) throw new Error("useMessages requires an AgoClient. Either pass it as options.client or wrap your app in <AgoProvider>.");
   const [o, a] = M([]), [d, i] = M(t), [f, c] = M(!1), [x, v] = M(null);
-  k(() => {
-    t && t !== d && (i(t), S(t));
+  S(() => {
+    t && t !== d && (i(t), k(t));
   }, [t]);
-  const S = async (m) => {
+  const k = async (m) => {
     try {
       a(await n.getMessages(m));
     } catch (b) {
       v(b instanceof Error ? b : /* @__PURE__ */ new Error("Failed to load messages"));
     }
   };
-  return k(() => {
+  return S(() => {
     const m = (g) => {
       d || i(g.conversationId);
     }, b = (g) => {
@@ -197,7 +197,7 @@ var te = ({ onSend: e, disabled: t = !1, placeholder: r = "Type a message...", a
     e
   ]), v = E((l) => {
     l.key === "Enter" && !l.shiftKey && (l.preventDefault(), x(l));
-  }, [x]), S = E((l) => {
+  }, [x]), k = E((l) => {
     const h = Array.from(l.target.files || []);
     f((p) => [...p, ...h]);
   }, []), m = E((l) => {
@@ -281,7 +281,7 @@ var te = ({ onSend: e, disabled: t = !1, placeholder: r = "Type a message...", a
           ref: c,
           type: "file",
           multiple: !0,
-          onChange: S,
+          onChange: k,
           style: { display: "none" }
         })] }),
         /* @__PURE__ */ s("textarea", {
@@ -299,7 +299,7 @@ var te = ({ onSend: e, disabled: t = !1, placeholder: r = "Type a message...", a
             resize: "none",
             outline: "none",
             fontFamily: "inherit",
-            fontSize: "14px",
+            fontSize: "16px",
             color: "#30373e",
             backgroundColor: "#f8f8f8",
             transition: "border-color 0.15s"
@@ -322,7 +322,7 @@ var te = ({ onSend: e, disabled: t = !1, placeholder: r = "Type a message...", a
             color: "#fff",
             cursor: t || !b ? "not-allowed" : "pointer",
             fontWeight: 500,
-            fontSize: "14px",
+            fontSize: "16px",
             transition: "background-color 0.15s"
           },
           children: "Send"
@@ -628,7 +628,7 @@ var te = ({ onSend: e, disabled: t = !1, placeholder: r = "Type a message...", a
           backgroundColor: a ? "#03182f" : "transparent",
           color: a ? "#fff" : "#30373e",
           wordBreak: "break-word",
-          fontSize: "14px",
+          fontSize: "16px",
           lineHeight: "1.6"
         },
         children: e.content ? /* @__PURE__ */ s(he, { content: e.content }) : d && /* @__PURE__ */ s(be, {})
@@ -667,12 +667,12 @@ var te = ({ onSend: e, disabled: t = !1, placeholder: r = "Type a message...", a
       })
     ]
   });
-}, _e = ({ client: e, conversationId: t, title: r = "Chat", welcomeMessage: n = "Hello! How can I help you today?", placeholder: o = "Type a message...", allowFiles: a = !1, height: d = 500, logoUrl: i, showAgentName: f = !1, forms: c, onFollowUpClick: x, className: v = "", onMessageSent: S, onMessageReceived: m }) => {
+}, _e = ({ client: e, conversationId: t, title: r = "Chat", welcomeMessage: n = "Hello! How can I help you today?", placeholder: o = "Type a message...", allowFiles: a = !1, height: d = 500, logoUrl: i, showAgentName: f = !1, forms: c, onFollowUpClick: x, className: v = "", onMessageSent: k, onMessageReceived: m }) => {
   const b = T(null), l = L(), h = e ?? l, { messages: p, isLoading: g, error: u, sendMessage: w } = $({
     client: e,
     conversationId: t
   });
-  k(() => {
+  S(() => {
     if (!h || !c || c.length === 0) return;
     let y = !1;
     const A = [];
@@ -688,9 +688,9 @@ var te = ({ onSend: e, disabled: t = !1, placeholder: r = "Type a message...", a
     y.schema ?? null,
     y.submit ?? !1,
     y.description ?? null
-  ])) : ""]), k(() => {
+  ])) : ""]), S(() => {
     b.current?.scrollIntoView({ behavior: "smooth" });
-  }, [p]), k(() => {
+  }, [p]), S(() => {
     const y = p[p.length - 1];
     y && y.role === "assistant" && y.status === "DONE" && m && m({
       id: y.id,
@@ -698,7 +698,7 @@ var te = ({ onSend: e, disabled: t = !1, placeholder: r = "Type a message...", a
     });
   }, [p, m]);
   const C = async (y, A) => {
-    S?.(y), await w(y, A);
+    k?.(y), await w(y, A);
   }, _ = p[p.length - 1], B = g && _?.role === "assistant" && _.status === "IN_PROGRESS", K = x === !1 ? void 0 : x ?? ((y) => C(y));
   return /* @__PURE__ */ I("div", {
     className: `ago-chat-widget ${v}`,
@@ -756,7 +756,7 @@ var te = ({ onSend: e, disabled: t = !1, placeholder: r = "Type a message...", a
               textAlign: "center",
               color: "#6b6d6f",
               padding: "24px 16px",
-              fontSize: "14px",
+              fontSize: "16px",
               lineHeight: "1.5"
             },
             children: n
@@ -793,7 +793,7 @@ var te = ({ onSend: e, disabled: t = !1, placeholder: r = "Type a message...", a
 function we({ client: e, autoLoad: t = !0 } = {}) {
   const r = L(), n = e || r;
   if (!n) throw new Error("useConversation requires an AgoClient. Either pass it as options.client or wrap your app in <AgoProvider>.");
-  const [o, a] = M([]), [d, i] = M(null), [f, c] = M(!1), [x, v] = M(null), S = E(async () => {
+  const [o, a] = M([]), [d, i] = M(null), [f, c] = M(!1), [x, v] = M(null), k = E(async () => {
     c(!0), v(null);
     try {
       a(await n.getConversations());
@@ -814,16 +814,16 @@ function we({ client: e, autoLoad: t = !0 } = {}) {
   }, [n]), b = E(() => {
     i(null);
   }, []);
-  return k(() => {
-    t && S();
-  }, [t, S]), {
+  return S(() => {
+    t && k();
+  }, [t, k]), {
     conversations: o,
     currentConversation: d,
     isLoading: f,
     error: x,
     selectConversation: m,
     startNewConversation: b,
-    refreshConversations: S
+    refreshConversations: k
   };
 }
 function Pe(e = {}) {
@@ -856,7 +856,7 @@ function Le(e, t) {
     name: e,
     ...t
   } : e, i = T(d);
-  i.current = d, k(() => {
+  i.current = d, S(() => {
     const f = (c) => i.current(c);
     return r.registerFunction(n, f, {
       description: o,
@@ -873,7 +873,7 @@ function Le(e, t) {
 }
 function De(e, t) {
   const r = P(), n = T(e);
-  n.current = e, k(() => (r.registerNavigationFunction((o) => n.current(o), t), () => {
+  n.current = e, S(() => (r.registerNavigationFunction((o) => n.current(o), t), () => {
     r.unregisterFunction("navigateToPage");
   }), [r, t]);
 }
@@ -881,7 +881,7 @@ function We(e, t) {
   const r = P(), n = j(), o = t ?? n, a = T(e);
   a.current = e;
   const d = typeof e == "function";
-  k(() => {
+  S(() => {
     if (typeof a.current == "function") {
       const i = () => a.current();
       return r.addDynamicContext(o, i), () => {
@@ -911,13 +911,14 @@ function ze(e) {
     e.name,
     n,
     a,
-    d
+    d,
+    e.autoSubmit
   ]), [f, c] = M({
     collector: null,
     loading: !r,
     error: null
   });
-  k(() => {
+  S(() => {
     if (r) return;
     let g = !1;
     return c({
@@ -944,10 +945,11 @@ function ze(e) {
     r,
     e.name,
     a,
-    d
+    d,
+    e.autoSubmit
   ]);
-  const x = r ? i : f.collector, v = r ? !1 : f.loading, S = r ? null : f.error;
-  k(() => {
+  const x = r ? i : f.collector, v = r ? !1 : f.loading, k = r ? null : f.error;
+  S(() => {
     if (x)
       return x.install(t);
   }, [t, x]);
@@ -985,7 +987,7 @@ function ze(e) {
     ...x ?? p,
     state: h,
     loading: v,
-    error: S
+    error: k
   };
 }
 export {

package/dist/testing.d.cts

@@ -176,6 +176,7 @@ declare class AgoClient {
      * call it when their store updates so observers like the dev panel stay live.
      */
     notifyContextChanged(): void;
+    /* Excluded from this release type: emitFormEvent */
     /**
      * Enable automatic capture of the current browser page (URL + title).
      * Injected as a dynamic context entry named `browser-page`.
@@ -290,6 +291,27 @@ declare interface AgoClientEvents {
         result: unknown;
         error?: string;
     };
+    /**
+     * A form collector submitted successfully. `result` is the raw submit response
+     * (POST body / handler return value / backend relay result) — the third-party
+     * API's answer. `values` is the submitted field set, `name` the collector name.
+     */
+    "form:submitted": {
+        name: string;
+        values: Record<string, unknown>;
+        result: unknown;
+    };
+    /**
+     * A form collector submit was attempted and failed at the network/server level
+     * (HTTP non-2xx, or a thrown handler/fetch). `error` is the message. Validation
+     * pre-checks (missing required fields, no submit target) are NOT errors and do
+     * not fire this — they are returned to the caller as `{ ok: false }`.
+     */
+    "form:error": {
+        name: string;
+        values: Record<string, unknown>;
+        error: string;
+    };
     "connection:status": {
         connected: boolean;
     };
@@ -468,6 +490,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/testing.d.ts

@@ -176,6 +176,7 @@ declare class AgoClient {
      * call it when their store updates so observers like the dev panel stay live.
      */
     notifyContextChanged(): void;
+    /* Excluded from this release type: emitFormEvent */
     /**
      * Enable automatic capture of the current browser page (URL + title).
      * Injected as a dynamic context entry named `browser-page`.
@@ -290,6 +291,27 @@ declare interface AgoClientEvents {
         result: unknown;
         error?: string;
     };
+    /**
+     * A form collector submitted successfully. `result` is the raw submit response
+     * (POST body / handler return value / backend relay result) — the third-party
+     * API's answer. `values` is the submitted field set, `name` the collector name.
+     */
+    "form:submitted": {
+        name: string;
+        values: Record<string, unknown>;
+        result: unknown;
+    };
+    /**
+     * A form collector submit was attempted and failed at the network/server level
+     * (HTTP non-2xx, or a thrown handler/fetch). `error` is the message. Validation
+     * pre-checks (missing required fields, no submit target) are NOT errors and do
+     * not fire this — they are returned to the caller as `{ ok: false }`.
+     */
+    "form:error": {
+        name: string;
+        values: Record<string, unknown>;
+        error: string;
+    };
     "connection:status": {
         connected: boolean;
     };
@@ -468,6 +490,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/vue.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const P=require("./rolldown-runtime-16Nf8qvH.cjs"),p=require("./AgoClient--y10UXUV.cjs");let t=require("vue");var I=Symbol("ago-client"),y={install(o,n){const e=new p.AgoClient(n);o.provide(I,e)}};function g(o){if(o)return new p.AgoClient(o);const n=(0,t.inject)(I);if(!n)throw new Error("useAgo(): no AgoClient found. Either pass config or install AgoPlugin.");return n}function E(o={}){const n=o.client??g(),e=(0,t.ref)([]),s=(0,t.ref)(o.conversationId),i=(0,t.ref)(!1),r=(0,t.ref)(null),c=a=>{s.value||(s.value=a.conversationId)},f=a=>{const u=e.value.findIndex(v=>v.id===a.messageId);u>=0&&(e.value[u]={...e.value[u],content:e.value[u].content+a.content})},m=a=>{const u=e.value.findIndex(v=>v.id===a.id);u>=0?e.value[u]=a:e.value.push(a),i.value=!1},C=a=>{r.value=new Error(a.error),i.value=!1};(0,t.onMounted)(()=>{n.on("message:start",c),n.on("message:chunk",f),n.on("message:complete",m),n.on("message:error",C)}),(0,t.onUnmounted)(()=>{n.off("message:start",c),n.off("message:chunk",f),n.off("message:complete",m),n.off("message:error",C)});async function d(a,u){i.value=!0,r.value=null;const v={id:`temp-${Date.now()}`,conversationId:s.value||"",content:a,role:"user",status:"DONE",createdAt:new Date},L={id:`temp-assistant-${Date.now()}`,conversationId:s.value||"",content:"",role:"assistant",status:"IN_PROGRESS",createdAt:new Date};e.value.push(v,L);try{const l=await n.sendMessage(a,{conversationId:s.value,files:u});l.conversationId&&!s.value&&(s.value=l.conversationId),e.value=e.value.filter(w=>!w.id.startsWith("temp-"));const A={...v,id:v.id.replace("temp-","user-"),conversationId:l.conversationId};return e.value.some(w=>w.id===l.id)?e.value.push(A):e.value.push(A,l),l}catch(l){return r.value=l instanceof Error?l:new Error("Failed to send"),i.value=!1,e.value=e.value.filter(A=>!A.id.startsWith("temp-")),null}}function h(){e.value=[],s.value=void 0,r.value=null}return{messages:e,isLoading:i,error:r,conversationId:s,sendMessage:d,clearMessages:h}}function M(o={}){const n=o.client??g(),e=o.autoLoad??!0,s=(0,t.ref)([]),i=(0,t.ref)(null),r=(0,t.ref)(!1),c=(0,t.ref)(null);async function f(){r.value=!0,c.value=null;try{s.value=await n.getConversations()}catch(d){c.value=d instanceof Error?d:new Error("Failed to load conversations")}finally{r.value=!1}}async function m(d){r.value=!0,c.value=null;try{i.value=await n.getConversation(d)}catch(h){c.value=h instanceof Error?h:new Error("Failed to load conversation")}finally{r.value=!1}}function C(){i.value=null}return(0,t.onMounted)(()=>{e&&f()}),{conversations:s,currentConversation:i,isLoading:r,error:c,selectConversation:m,startNewConversation:C,refreshConversations:f}}function N(o={}){const n=E({client:o.client,conversationId:o.conversationId}),e=M({client:o.client,autoLoad:o.autoLoad}),s=(0,t.computed)(()=>n.error.value||e.error.value);return{messages:n.messages,isLoading:n.isLoading,error:s,sendMessage:n.sendMessage,clearMessages:n.clearMessages,conversationId:n.conversationId,conversations:e.conversations,currentConversation:e.currentConversation,isConversationsLoading:e.isLoading,selectConversation:e.selectConversation,startNewConversation:e.startNewConversation,refreshConversations:e.refreshConversations}}function F(o,n){const e=g();(0,t.onMounted)(()=>{e.registerFunction(o,n.handler,{description:n.description,parameters:n.parameters})}),(0,t.onUnmounted)(()=>{e.unregisterFunction(o)})}function S(o,n){const e=g();(0,t.onMounted)(()=>{e.registerNavigationFunction(o,n)}),(0,t.onUnmounted)(()=>{e.unregisterFunction("navigateToPage")})}function _(o,n){const e=g();(0,t.onMounted)(()=>{e.on(o,n)}),(0,t.onUnmounted)(()=>{e.off(o,n)})}function D(o){const n=(0,t.shallowRef)(o.get());return(0,t.onScopeDispose)(o.subscribe(e=>{n.value=e})),n}exports.AGO_CLIENT_KEY=I;exports.AgoPlugin=y;exports.useAgo=g;exports.useAgoEvents=_;exports.useAgoFunction=F;exports.useAgoNavigation=S;exports.useAgoStore=D;exports.useChat=N;exports.useConversation=M;exports.useMessages=E;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const P=require("./rolldown-runtime-16Nf8qvH.cjs"),p=require("./AgoClient-B3-WGVne.cjs");let t=require("vue");var I=Symbol("ago-client"),y={install(o,n){const e=new p.AgoClient(n);o.provide(I,e)}};function g(o){if(o)return new p.AgoClient(o);const n=(0,t.inject)(I);if(!n)throw new Error("useAgo(): no AgoClient found. Either pass config or install AgoPlugin.");return n}function E(o={}){const n=o.client??g(),e=(0,t.ref)([]),s=(0,t.ref)(o.conversationId),i=(0,t.ref)(!1),r=(0,t.ref)(null),c=a=>{s.value||(s.value=a.conversationId)},f=a=>{const u=e.value.findIndex(v=>v.id===a.messageId);u>=0&&(e.value[u]={...e.value[u],content:e.value[u].content+a.content})},m=a=>{const u=e.value.findIndex(v=>v.id===a.id);u>=0?e.value[u]=a:e.value.push(a),i.value=!1},C=a=>{r.value=new Error(a.error),i.value=!1};(0,t.onMounted)(()=>{n.on("message:start",c),n.on("message:chunk",f),n.on("message:complete",m),n.on("message:error",C)}),(0,t.onUnmounted)(()=>{n.off("message:start",c),n.off("message:chunk",f),n.off("message:complete",m),n.off("message:error",C)});async function d(a,u){i.value=!0,r.value=null;const v={id:`temp-${Date.now()}`,conversationId:s.value||"",content:a,role:"user",status:"DONE",createdAt:new Date},L={id:`temp-assistant-${Date.now()}`,conversationId:s.value||"",content:"",role:"assistant",status:"IN_PROGRESS",createdAt:new Date};e.value.push(v,L);try{const l=await n.sendMessage(a,{conversationId:s.value,files:u});l.conversationId&&!s.value&&(s.value=l.conversationId),e.value=e.value.filter(w=>!w.id.startsWith("temp-"));const A={...v,id:v.id.replace("temp-","user-"),conversationId:l.conversationId};return e.value.some(w=>w.id===l.id)?e.value.push(A):e.value.push(A,l),l}catch(l){return r.value=l instanceof Error?l:new Error("Failed to send"),i.value=!1,e.value=e.value.filter(A=>!A.id.startsWith("temp-")),null}}function h(){e.value=[],s.value=void 0,r.value=null}return{messages:e,isLoading:i,error:r,conversationId:s,sendMessage:d,clearMessages:h}}function M(o={}){const n=o.client??g(),e=o.autoLoad??!0,s=(0,t.ref)([]),i=(0,t.ref)(null),r=(0,t.ref)(!1),c=(0,t.ref)(null);async function f(){r.value=!0,c.value=null;try{s.value=await n.getConversations()}catch(d){c.value=d instanceof Error?d:new Error("Failed to load conversations")}finally{r.value=!1}}async function m(d){r.value=!0,c.value=null;try{i.value=await n.getConversation(d)}catch(h){c.value=h instanceof Error?h:new Error("Failed to load conversation")}finally{r.value=!1}}function C(){i.value=null}return(0,t.onMounted)(()=>{e&&f()}),{conversations:s,currentConversation:i,isLoading:r,error:c,selectConversation:m,startNewConversation:C,refreshConversations:f}}function N(o={}){const n=E({client:o.client,conversationId:o.conversationId}),e=M({client:o.client,autoLoad:o.autoLoad}),s=(0,t.computed)(()=>n.error.value||e.error.value);return{messages:n.messages,isLoading:n.isLoading,error:s,sendMessage:n.sendMessage,clearMessages:n.clearMessages,conversationId:n.conversationId,conversations:e.conversations,currentConversation:e.currentConversation,isConversationsLoading:e.isLoading,selectConversation:e.selectConversation,startNewConversation:e.startNewConversation,refreshConversations:e.refreshConversations}}function F(o,n){const e=g();(0,t.onMounted)(()=>{e.registerFunction(o,n.handler,{description:n.description,parameters:n.parameters})}),(0,t.onUnmounted)(()=>{e.unregisterFunction(o)})}function S(o,n){const e=g();(0,t.onMounted)(()=>{e.registerNavigationFunction(o,n)}),(0,t.onUnmounted)(()=>{e.unregisterFunction("navigateToPage")})}function _(o,n){const e=g();(0,t.onMounted)(()=>{e.on(o,n)}),(0,t.onUnmounted)(()=>{e.off(o,n)})}function D(o){const n=(0,t.shallowRef)(o.get());return(0,t.onScopeDispose)(o.subscribe(e=>{n.value=e})),n}exports.AGO_CLIENT_KEY=I;exports.AgoPlugin=y;exports.useAgo=g;exports.useAgoEvents=_;exports.useAgoFunction=F;exports.useAgoNavigation=S;exports.useAgoStore=D;exports.useChat=N;exports.useConversation=M;exports.useMessages=E;

package/dist/vue.d.cts

@@ -184,6 +184,7 @@ declare class AgoClient {
      * call it when their store updates so observers like the dev panel stay live.
      */
     notifyContextChanged(): void;
+    /* Excluded from this release type: emitFormEvent */
     /**
      * Enable automatic capture of the current browser page (URL + title).
      * Injected as a dynamic context entry named `browser-page`.
@@ -298,6 +299,27 @@ declare interface AgoClientEvents {
         result: unknown;
         error?: string;
     };
+    /**
+     * A form collector submitted successfully. `result` is the raw submit response
+     * (POST body / handler return value / backend relay result) — the third-party
+     * API's answer. `values` is the submitted field set, `name` the collector name.
+     */
+    "form:submitted": {
+        name: string;
+        values: Record<string, unknown>;
+        result: unknown;
+    };
+    /**
+     * A form collector submit was attempted and failed at the network/server level
+     * (HTTP non-2xx, or a thrown handler/fetch). `error` is the message. Validation
+     * pre-checks (missing required fields, no submit target) are NOT errors and do
+     * not fire this — they are returned to the caller as `{ ok: false }`.
+     */
+    "form:error": {
+        name: string;
+        values: Record<string, unknown>;
+        error: string;
+    };
     "connection:status": {
         connected: boolean;
     };
@@ -484,6 +506,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/vue.d.ts

@@ -184,6 +184,7 @@ declare class AgoClient {
      * call it when their store updates so observers like the dev panel stay live.
      */
     notifyContextChanged(): void;
+    /* Excluded from this release type: emitFormEvent */
     /**
      * Enable automatic capture of the current browser page (URL + title).
      * Injected as a dynamic context entry named `browser-page`.
@@ -298,6 +299,27 @@ declare interface AgoClientEvents {
         result: unknown;
         error?: string;
     };
+    /**
+     * A form collector submitted successfully. `result` is the raw submit response
+     * (POST body / handler return value / backend relay result) — the third-party
+     * API's answer. `values` is the submitted field set, `name` the collector name.
+     */
+    "form:submitted": {
+        name: string;
+        values: Record<string, unknown>;
+        result: unknown;
+    };
+    /**
+     * A form collector submit was attempted and failed at the network/server level
+     * (HTTP non-2xx, or a thrown handler/fetch). `error` is the message. Validation
+     * pre-checks (missing required fields, no submit target) are NOT errors and do
+     * not fire this — they are returned to the caller as `{ ok: false }`.
+     */
+    "form:error": {
+        name: string;
+        values: Record<string, unknown>;
+        error: string;
+    };
     "connection:status": {
         connected: boolean;
     };
@@ -484,6 +506,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/vue.js

@@ -1,4 +1,4 @@
-import { t as A } from "./AgoClient-DYdIe_R4.js";
+import { t as A } from "./AgoClient-QcTtrN7u.js";
 import { computed as y, inject as F, onMounted as g, onScopeDispose as N, onUnmounted as I, ref as c, shallowRef as D } from "vue";
 var L = /* @__PURE__ */ Symbol("ago-client"), b = { install(t, n) {
   const e = new A(n);