@useago/sdk 1.13.2 → 1.14.0

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./types-DNr6XEwI.cjs"),f=require("./errors-o1IB5fEu.cjs"),S=require("./autoContinue-C3UsCvT5.cjs"),p=require("./createConversationSession-Digvn0GQ.cjs"),A=require("./createFormCollector-Cq7HWjtU.cjs"),w=require("./createMockClient-BPt1gSve.cjs");require("./testing.cjs");const g=require("./functions-CPs7omgM.cjs");function F(e){return e}function _(e,t){return e.on("message:complete",t),()=>e.off("message:complete",t)}function y(e,t){return e.on("message:chunk",t),()=>e.off("message:chunk",t)}function M(e,t){return e.on("message:start",t),()=>e.off("message:start",t)}function v(e,t){return e.on("message:error",t),()=>e.off("message:error",t)}function T(e,t){return e.on("toolCall:received",t),()=>e.off("toolCall:received",t)}function R(e,t){return e.on("form:submitted",t),()=>e.off("form:submitted",t)}function b(e,t){return e.on("form:error",t),()=>e.off("form:error",t)}function q(e,t){return e.on("function:invoke",t),()=>e.off("function:invoke",t)}async function*I(e,t,l){const i=[];let n=null,a=!1;const c=s=>{i.push(s),n?.()},m=s=>c({type:"start",data:s}),d=s=>c({type:"chunk",data:s}),r=s=>{c({type:"complete",data:s}),a=!0,n?.()},u=s=>{c({type:"error",data:s}),a=!0,n?.()},E=s=>c({type:"toolCall",data:s}),h=()=>{a=!0,n?.()};e.on("message:start",m),e.on("message:chunk",d),e.on("message:complete",r),e.on("message:error",u),e.on("message:stopped",h),e.on("toolCall:received",E),e.sendMessage(t,l).catch(()=>{a=!0,n?.()});try{for(;!a||i.length>0;)i.length>0?yield i.shift():(await new Promise(s=>{n=s}),n=null)}finally{e.off("message:start",m),e.off("message:chunk",d),e.off("message:complete",r),e.off("message:error",u),e.off("message:stopped",h),e.off("toolCall:received",E)}}function C(e){let t,l,i,n,a,c,m;if(typeof window<"u"&&window.AGO){const r=window.AGO;t=r.basepath,l=r.widgetId,i=r.agent||r.defaultAgent,n=r.permission,a=r.email,c=r.jwt,m=r.metadata}if(typeof document<"u"){const r=u=>document.querySelector(`meta[name="${u}"]`)?.getAttribute("content")||void 0;t=t||r("ago-base-url"),l=l||r("ago-widget-id"),i=i||r("ago-agent")||r("ago-agent-id"),n=n||r("ago-permission"),a=a||r("ago-user-email")}if(typeof document<"u"){const r=[document.body,...Array.from(document.querySelectorAll("script[data-ago-base-url]"))].filter(Boolean);for(const u of r)u&&(t=t||u.getAttribute("data-ago-base-url")||void 0,l=l||u.getAttribute("data-ago-widget-id")||void 0,i=i||u.getAttribute("data-ago-agent")||u.getAttribute("data-ago-agent-id")||void 0,n=n||u.getAttribute("data-ago-permission")||void 0,a=a||u.getAttribute("data-ago-user-email")||void 0)}t=e?.baseUrl||t,l=e?.widgetId||l,i=e?.agent||e?.defaultAgentId||i,n=e?.permission||n,a=e?.userEmail||a,c=e?.userJwt||c,e?.metadata!==void 0&&(m=e.metadata);const d=e?.debug;return t?{baseUrl:t,widgetId:l,agent:i,permission:n,language:e?.language,userEmail:a,userJwt:c,metadata:m,debug:d}:null}function U(e){const t=C(e);if(!t)throw new f.AgoError('createAgo(): could not detect AGO configuration. Set window.AGO, add <meta name="ago-base-url">, or pass { baseUrl } explicitly.',"config_missing_base_url");return new o.AgoClient(t)}function D(e,t){return{...e,handler:t}}exports.ActivityLedger=o.ActivityLedger;exports.AgoApiError=f.AgoApiError;exports.AgoClient=o.AgoClient;exports.AgoError=f.AgoError;exports.AgoFunctionError=f.AgoFunctionError;exports.AgoNetworkError=f.AgoNetworkError;exports.AgoStreamError=f.AgoStreamError;exports.ClientContextRegistry=o.ClientContextRegistry;exports.DEFAULT_MAX_ACTIVITY_ENTRIES=o.DEFAULT_MAX_ACTIVITY_ENTRIES;exports.DEFAULT_MAX_ERRORS=o.DEFAULT_MAX_ERRORS;exports.DEFAULT_MAX_ERROR_AGE_MS=o.DEFAULT_MAX_ERROR_AGE_MS;exports.ErrorWatcher=o.ErrorWatcher;exports.EventEmitter=o.EventEmitter;exports.FEEDBACK_REASONS=o.FEEDBACK_REASONS;exports.FunctionRegistry=o.FunctionRegistry;exports.SSEHandler=o.SSEHandler;exports.SignalCollector=o.SignalCollector;exports.attachAutoContinueAfterNavigation=S.attachAutoContinueAfterNavigation;exports.autoDetectConfig=C;exports.canInlineImage=o.canInlineImage;exports.copyToClipboard=g.copyToClipboard;exports.createAgo=U;exports.createAgoProactive=o.createAgoProactive;exports.createConversationSession=p.createConversationSession;exports.createFormCollector=A.createFormCollector;exports.createMessageStream=I;exports.createMockClient=w.createMockClient;exports.createStore=o.createStore;exports.defineFunction=F;exports.deriveFormStatus=A.deriveFormStatus;exports.formatFileSize=o.formatFileSize;exports.getLocalStorage=g.getLocalStorage;exports.getUserLocation=g.getUserLocation;exports.highlightElement=g.highlightElement;exports.isStreamNetworkError=o.isStreamNetworkError;exports.loadFormCollector=A.loadFormCollector;exports.logger=o.logger;exports.matchesRoutePattern=o.matchesRoutePattern;exports.matchesWhen=o.matchesWhen;exports.onFormError=b;exports.onFormSubmitted=R;exports.onFunctionInvoke=q;exports.onMessage=_;exports.onMessageChunk=y;exports.onMessageError=v;exports.onMessageStart=M;exports.onToolCall=T;exports.openUrl=g.openUrl;exports.partialDeepMatch=o.partialDeepMatch;exports.safeAttachmentUrl=o.safeAttachmentUrl;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.validateConfig=o.validateConfig;exports.withHandler=D;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./types-PGXnhAmQ.cjs"),f=require("./errors-o1IB5fEu.cjs"),C=require("./autoContinue-C3UsCvT5.cjs"),p=require("./createConversationSession-jwSXhTLe.cjs"),A=require("./createFormCollector-B_hSKcLd.cjs"),w=require("./createMockClient-BPt1gSve.cjs");require("./testing.cjs");const g=require("./functions-CPs7omgM.cjs");function F(e){return e}function _(e,t){return e.on("message:complete",t),()=>e.off("message:complete",t)}function y(e,t){return e.on("message:chunk",t),()=>e.off("message:chunk",t)}function M(e,t){return e.on("message:start",t),()=>e.off("message:start",t)}function b(e,t){return e.on("message:error",t),()=>e.off("message:error",t)}function v(e,t){return e.on("toolCall:received",t),()=>e.off("toolCall:received",t)}function T(e,t){return e.on("form:submitted",t),()=>e.off("form:submitted",t)}function R(e,t){return e.on("form:error",t),()=>e.off("form:error",t)}function q(e,t){return e.on("function:invoke",t),()=>e.off("function:invoke",t)}async function*I(e,t,m){const i=[];let n=null,a=!1;const l=s=>{i.push(s),n?.()},c=s=>l({type:"start",data:s}),d=s=>l({type:"chunk",data:s}),r=s=>{l({type:"complete",data:s}),a=!0,n?.()},u=s=>{l({type:"error",data:s}),a=!0,n?.()},E=s=>l({type:"toolCall",data:s}),S=()=>{a=!0,n?.()};e.on("message:start",c),e.on("message:chunk",d),e.on("message:complete",r),e.on("message:error",u),e.on("message:stopped",S),e.on("toolCall:received",E),e.sendMessage(t,m).catch(()=>{a=!0,n?.()});try{for(;!a||i.length>0;)i.length>0?yield i.shift():(await new Promise(s=>{n=s}),n=null)}finally{e.off("message:start",c),e.off("message:chunk",d),e.off("message:complete",r),e.off("message:error",u),e.off("message:stopped",S),e.off("toolCall:received",E)}}function U(e,t){return e.on("form:submitting",t),()=>e.off("form:submitting",t)}function h(e){let t,m,i,n,a,l,c;if(typeof window<"u"&&window.AGO){const r=window.AGO;t=r.basepath,m=r.widgetId,i=r.agent||r.defaultAgent,n=r.permission,a=r.email,l=r.jwt,c=r.metadata}if(typeof document<"u"){const r=u=>document.querySelector(`meta[name="${u}"]`)?.getAttribute("content")||void 0;t=t||r("ago-base-url"),m=m||r("ago-widget-id"),i=i||r("ago-agent")||r("ago-agent-id"),n=n||r("ago-permission"),a=a||r("ago-user-email")}if(typeof document<"u"){const r=[document.body,...Array.from(document.querySelectorAll("script[data-ago-base-url]"))].filter(Boolean);for(const u of r)u&&(t=t||u.getAttribute("data-ago-base-url")||void 0,m=m||u.getAttribute("data-ago-widget-id")||void 0,i=i||u.getAttribute("data-ago-agent")||u.getAttribute("data-ago-agent-id")||void 0,n=n||u.getAttribute("data-ago-permission")||void 0,a=a||u.getAttribute("data-ago-user-email")||void 0)}t=e?.baseUrl||t,m=e?.widgetId||m,i=e?.agent||e?.defaultAgentId||i,n=e?.permission||n,a=e?.userEmail||a,l=e?.userJwt||l,e?.metadata!==void 0&&(c=e.metadata);const d=e?.debug;return t?{baseUrl:t,widgetId:m,agent:i,permission:n,language:e?.language,userEmail:a,userJwt:l,metadata:c,debug:d}:null}function D(e){const t=h(e);if(!t)throw new f.AgoError('createAgo(): could not detect AGO configuration. Set window.AGO, add <meta name="ago-base-url">, or pass { baseUrl } explicitly.',"config_missing_base_url");return new o.AgoClient(t)}function L(e,t){return{...e,handler:t}}exports.ActivityLedger=o.ActivityLedger;exports.AgoApiError=f.AgoApiError;exports.AgoClient=o.AgoClient;exports.AgoError=f.AgoError;exports.AgoFunctionError=f.AgoFunctionError;exports.AgoNetworkError=f.AgoNetworkError;exports.AgoStreamError=f.AgoStreamError;exports.ClientContextRegistry=o.ClientContextRegistry;exports.DEFAULT_MAX_ACTIVITY_ENTRIES=o.DEFAULT_MAX_ACTIVITY_ENTRIES;exports.DEFAULT_MAX_ERRORS=o.DEFAULT_MAX_ERRORS;exports.DEFAULT_MAX_ERROR_AGE_MS=o.DEFAULT_MAX_ERROR_AGE_MS;exports.ErrorWatcher=o.ErrorWatcher;exports.EventEmitter=o.EventEmitter;exports.FEEDBACK_REASONS=o.FEEDBACK_REASONS;exports.FunctionRegistry=o.FunctionRegistry;exports.SSEHandler=o.SSEHandler;exports.SignalCollector=o.SignalCollector;exports.attachAutoContinueAfterNavigation=C.attachAutoContinueAfterNavigation;exports.autoDetectConfig=h;exports.canInlineImage=o.canInlineImage;exports.copyToClipboard=g.copyToClipboard;exports.createAgo=D;exports.createAgoProactive=o.createAgoProactive;exports.createConversationSession=p.createConversationSession;exports.createFormCollector=A.createFormCollector;exports.createMessageStream=I;exports.createMockClient=w.createMockClient;exports.createStore=o.createStore;exports.defineFunction=F;exports.deriveFormStatus=A.deriveFormStatus;exports.formatFileSize=o.formatFileSize;exports.getLocalStorage=g.getLocalStorage;exports.getUserLocation=g.getUserLocation;exports.highlightElement=g.highlightElement;exports.isStreamNetworkError=o.isStreamNetworkError;exports.loadFormCollector=A.loadFormCollector;exports.logger=o.logger;exports.matchesRoutePattern=o.matchesRoutePattern;exports.matchesWhen=o.matchesWhen;exports.onFormError=R;exports.onFormSubmitted=T;exports.onFormSubmitting=U;exports.onFunctionInvoke=q;exports.onMessage=_;exports.onMessageChunk=y;exports.onMessageError=b;exports.onMessageStart=M;exports.onToolCall=v;exports.openUrl=g.openUrl;exports.partialDeepMatch=o.partialDeepMatch;exports.safeAttachmentUrl=o.safeAttachmentUrl;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.validateConfig=o.validateConfig;exports.withHandler=L;

package/dist/index.d.cts

@@ -284,6 +284,8 @@ export declare class AgoClient {
      * Show the returned text as a draft; call `sendMessage` when the user sends it.
      */
     transcribeAudio(file: File, options?: TranscribeAudioOptions): Promise<AudioTranscription>;
+    /** The requested language, before UI fallback. */
+    getLanguage(): string | null;
     /**
      * The tenant's SDK configuration (`GET /api/sdk/v1/config`): per-permission
      * agents, the ticket form the agent's `ago_ticketing` tool opens, and the
@@ -659,6 +661,9 @@ export declare class AgoClient {
  * SDK Events
  */
 export declare interface AgoClientEvents {
+    "config:changed": {
+        language: string | null;
+    };
     /**
      * The client-side context changed: a context entry or dynamic provider was
      * added/removed, or a stateful helper (e.g. `createFormCollector`) updated its
@@ -768,6 +773,11 @@ export declare interface AgoClientEvents {
         result: unknown;
         error?: string;
     };
+    /** A validated form collector submission is about to call its submit target. */
+    "form:submitting": {
+        name: string;
+        values: Record<string, unknown>;
+    };
     /**
      * A form collector submitted successfully. `result` is the raw submit response
      * (POST body / handler return value / backend relay result) — the third-party
@@ -2390,6 +2400,9 @@ export declare function onFormError(client: AgoClient, callback: (data: AgoClien
  */
 export declare function onFormSubmitted(client: AgoClient, callback: (data: AgoClientEvents["form:submitted"]) => void): () => void;
 
+/** Observe a validated form submission before its submit target runs. */
+export declare function onFormSubmitting(client: AgoClient, callback: (data: AgoClientEvents["form:submitting"]) => void): () => void;
+
 /**
  * Subscribe to client function invocations.
  */
@@ -3212,6 +3225,7 @@ export declare interface SubmitToolCallResult {
 
 /** A custom field of a ticket form. */
 declare interface TicketField {
+    prefillAliases?: string[];
     id: string;
     /** The key the ticketing backend expects; used as the submit key when set. */
     externalId?: string;
@@ -3258,6 +3272,7 @@ declare interface TicketFieldOption {
 
 /** The ticket form an agent's `ago_ticketing` tool opens in the conversation. */
 declare interface TicketForm {
+    embedDescription?: string;
     id: string;
     name?: string;
     /** `"form"` renders the SDK's own fields; `"embed"` hosts third-party HTML. */
@@ -3353,16 +3368,21 @@ export declare interface TranscribeAudioOptions {
  */
 export declare function validateConfig(config: unknown, context?: string): asserts config is AgoConfig;
 
-/** The MCP behavior hints AGO has no equivalent for. */
+/** Metadata for tools exposed through the WebMCP bridge. */
 export declare interface WebMCPToolMeta {
     /**
-     * Both default to `false`, so only set what is true: `readOnlyHint` marks a
-     * function that changes nothing, `untrustedContentHint` one whose result may
-     * carry third-party text.
+     * Optional WebMCP metadata; all fields default to `false` in WebMCP.
+     * These annotations do not affect AGO's in-app agent or approval behavior.
      */
     annotations?: {
+        /** The tool only reads data and does not change state. */
         readOnlyHint?: boolean;
+        /** The output contains content untrusted by the tool author. */
         untrustedContentHint?: boolean;
+        /** Significant, real-world, or irreversible effects; independent of requiresApproval. */
+        consequentialHint?: boolean;
+        /** Intended for debugging and developer tooling. */
+        debugging?: boolean;
     };
     /**
      * This function navigates. The WebMCP call is held open until the function

package/dist/index.d.ts

@@ -284,6 +284,8 @@ export declare class AgoClient {
      * Show the returned text as a draft; call `sendMessage` when the user sends it.
      */
     transcribeAudio(file: File, options?: TranscribeAudioOptions): Promise<AudioTranscription>;
+    /** The requested language, before UI fallback. */
+    getLanguage(): string | null;
     /**
      * The tenant's SDK configuration (`GET /api/sdk/v1/config`): per-permission
      * agents, the ticket form the agent's `ago_ticketing` tool opens, and the
@@ -659,6 +661,9 @@ export declare class AgoClient {
  * SDK Events
  */
 export declare interface AgoClientEvents {
+    "config:changed": {
+        language: string | null;
+    };
     /**
      * The client-side context changed: a context entry or dynamic provider was
      * added/removed, or a stateful helper (e.g. `createFormCollector`) updated its
@@ -768,6 +773,11 @@ export declare interface AgoClientEvents {
         result: unknown;
         error?: string;
     };
+    /** A validated form collector submission is about to call its submit target. */
+    "form:submitting": {
+        name: string;
+        values: Record<string, unknown>;
+    };
     /**
      * A form collector submitted successfully. `result` is the raw submit response
      * (POST body / handler return value / backend relay result) — the third-party
@@ -2390,6 +2400,9 @@ export declare function onFormError(client: AgoClient, callback: (data: AgoClien
  */
 export declare function onFormSubmitted(client: AgoClient, callback: (data: AgoClientEvents["form:submitted"]) => void): () => void;
 
+/** Observe a validated form submission before its submit target runs. */
+export declare function onFormSubmitting(client: AgoClient, callback: (data: AgoClientEvents["form:submitting"]) => void): () => void;
+
 /**
  * Subscribe to client function invocations.
  */
@@ -3212,6 +3225,7 @@ export declare interface SubmitToolCallResult {
 
 /** A custom field of a ticket form. */
 declare interface TicketField {
+    prefillAliases?: string[];
     id: string;
     /** The key the ticketing backend expects; used as the submit key when set. */
     externalId?: string;
@@ -3258,6 +3272,7 @@ declare interface TicketFieldOption {
 
 /** The ticket form an agent's `ago_ticketing` tool opens in the conversation. */
 declare interface TicketForm {
+    embedDescription?: string;
     id: string;
     name?: string;
     /** `"form"` renders the SDK's own fields; `"embed"` hosts third-party HTML. */
@@ -3353,16 +3368,21 @@ export declare interface TranscribeAudioOptions {
  */
 export declare function validateConfig(config: unknown, context?: string): asserts config is AgoConfig;
 
-/** The MCP behavior hints AGO has no equivalent for. */
+/** Metadata for tools exposed through the WebMCP bridge. */
 export declare interface WebMCPToolMeta {
     /**
-     * Both default to `false`, so only set what is true: `readOnlyHint` marks a
-     * function that changes nothing, `untrustedContentHint` one whose result may
-     * carry third-party text.
+     * Optional WebMCP metadata; all fields default to `false` in WebMCP.
+     * These annotations do not affect AGO's in-app agent or approval behavior.
      */
     annotations?: {
+        /** The tool only reads data and does not change state. */
         readOnlyHint?: boolean;
+        /** The output contains content untrusted by the tool author. */
         untrustedContentHint?: boolean;
+        /** Significant, real-world, or irreversible effects; independent of requiresApproval. */
+        consequentialHint?: boolean;
+        /** Intended for debugging and developer tooling. */
+        debugging?: boolean;
     };
     /**
      * This function navigates. The WebMCP call is held open until the function

package/dist/index.js

@@ -1,9 +1,9 @@
-import { a as w, c as E, d as C, f as S, i as y, l as b, m as F, o as v, p as _, r as M, s as T, t as R, u as I } from "./functions-tzyOZNp6.js";
-import { C as D, S as L, _ as O, b as k, c as N, d as G, f as x, g as q, h as P, i as X, l as B, m as H, n as c, o as J, p as W, r as j, s as z, t as K, u as V, v as Y, w as $, x as Q, y as Z } from "./types-D1ZrqVhr.js";
+import { a as w, c as E, d as S, f as C, i as y, l as b, m as F, o as v, p as _, r as M, s as T, t as R, u as I } from "./functions-tzyOZNp6.js";
+import { S as D, T as L, _ as O, b as N, c as k, d as G, f as x, g as q, h as P, i as X, l as B, m as H, n as c, o as J, p as W, r as j, s as z, t as K, u as V, v as Y, w as $, x as Q, y as Z } from "./types-C39MJUE3.js";
 import { a as te, i as oe, n as p, r as ae, t as re } from "./errors-BLfjXnLB.js";
 import { t as se } from "./autoContinue-Cb4_iEbO.js";
-import { t as ge } from "./createConversationSession-DrmOaZdO.js";
-import { n as me, r as fe, t as le } from "./createFormCollector-ki_GTlp9.js";
+import { t as ue } from "./createConversationSession-CybQdMpK.js";
+import { n as me, r as fe, t as de } from "./createFormCollector-DJjms78E.js";
 import { t as ce } from "./createMockClient-YoYr3pQr.js";
 import "./testing.js";
 function Ae(e) {
@@ -18,10 +18,10 @@ function we(e, t) {
 function Ee(e, t) {
   return e.on("message:start", t), () => e.off("message:start", t);
 }
-function Ce(e, t) {
+function Se(e, t) {
   return e.on("message:error", t), () => e.off("message:error", t);
 }
-function Se(e, t) {
+function Ce(e, t) {
   return e.on("toolCall:received", t), () => e.off("toolCall:received", t);
 }
 function ye(e, t) {
@@ -33,34 +33,34 @@ function be(e, t) {
 function Fe(e, t) {
   return e.on("function:invoke", t), () => e.off("function:invoke", t);
 }
-async function* ve(e, t, g) {
+async function* ve(e, t, u) {
   const n = [];
   let a = null, r = !1;
-  const u = (s) => {
+  const g = (s) => {
     n.push(s), a?.();
-  }, m = (s) => u({
+  }, m = (s) => g({
     type: "start",
     data: s
-  }), f = (s) => u({
+  }), f = (s) => g({
     type: "chunk",
     data: s
   }), o = (s) => {
-    u({
+    g({
       type: "complete",
       data: s
     }), r = !0, a?.();
   }, i = (s) => {
-    u({
+    g({
       type: "error",
       data: s
     }), r = !0, a?.();
-  }, l = (s) => u({
+  }, d = (s) => g({
     type: "toolCall",
     data: s
-  }), d = () => {
+  }), l = () => {
     r = !0, a?.();
   };
-  e.on("message:start", m), e.on("message:chunk", f), e.on("message:complete", o), e.on("message:error", i), e.on("message:stopped", d), e.on("toolCall:received", l), e.sendMessage(t, g).catch(() => {
+  e.on("message:start", m), e.on("message:chunk", f), e.on("message:complete", o), e.on("message:error", i), e.on("message:stopped", l), e.on("toolCall:received", d), e.sendMessage(t, u).catch(() => {
     r = !0, a?.();
   });
   try {
@@ -68,51 +68,54 @@ async function* ve(e, t, g) {
       a = s;
     }), a = null);
   } finally {
-    e.off("message:start", m), e.off("message:chunk", f), e.off("message:complete", o), e.off("message:error", i), e.off("message:stopped", d), e.off("toolCall:received", l);
+    e.off("message:start", m), e.off("message:chunk", f), e.off("message:complete", o), e.off("message:error", i), e.off("message:stopped", l), e.off("toolCall:received", d);
   }
 }
+function _e(e, t) {
+  return e.on("form:submitting", t), () => e.off("form:submitting", t);
+}
 function A(e) {
-  let t, g, n, a, r, u, m;
+  let t, u, n, a, r, g, m;
   if (typeof window < "u" && window.AGO) {
     const o = window.AGO;
-    t = o.basepath, g = o.widgetId, n = o.agent || o.defaultAgent, a = o.permission, r = o.email, u = o.jwt, m = o.metadata;
+    t = o.basepath, u = o.widgetId, n = o.agent || o.defaultAgent, a = o.permission, r = o.email, g = o.jwt, m = o.metadata;
   }
   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"), a = a || o("ago-permission"), r = r || o("ago-user-email");
+    t = t || o("ago-base-url"), u = u || o("ago-widget-id"), n = n || o("ago-agent") || o("ago-agent-id"), a = a || o("ago-permission"), r = r || 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, a = a || i.getAttribute("data-ago-permission") || void 0, r = r || i.getAttribute("data-ago-user-email") || void 0);
+      i && (t = t || i.getAttribute("data-ago-base-url") || void 0, u = u || i.getAttribute("data-ago-widget-id") || void 0, n = n || i.getAttribute("data-ago-agent") || i.getAttribute("data-ago-agent-id") || void 0, a = a || i.getAttribute("data-ago-permission") || void 0, r = r || i.getAttribute("data-ago-user-email") || void 0);
   }
-  t = e?.baseUrl || t, g = e?.widgetId || g, n = e?.agent || e?.defaultAgentId || n, a = e?.permission || a, r = e?.userEmail || r, u = e?.userJwt || u, e?.metadata !== void 0 && (m = e.metadata);
+  t = e?.baseUrl || t, u = e?.widgetId || u, n = e?.agent || e?.defaultAgentId || n, a = e?.permission || a, r = e?.userEmail || r, g = e?.userJwt || g, e?.metadata !== void 0 && (m = e.metadata);
   const f = e?.debug;
   return t ? {
     baseUrl: t,
-    widgetId: g,
+    widgetId: u,
     agent: n,
     permission: a,
     language: e?.language,
     userEmail: r,
-    userJwt: u,
+    userJwt: g,
     metadata: m,
     debug: f
   } : null;
 }
-function _e(e) {
+function Me(e) {
   const t = A(e);
   if (!t) throw new p('createAgo(): could not detect AGO configuration. Set window.AGO, add <meta name="ago-base-url">, or pass { baseUrl } explicitly.', "config_missing_base_url");
   return new c(t);
 }
-function Me(e, t) {
+function Te(e, t) {
   return {
     ...e,
     handler: t
   };
 }
 export {
-  D as ActivityLedger,
+  $ as ActivityLedger,
   re as AgoApiError,
   c as AgoClient,
   p as AgoError,
@@ -120,9 +123,9 @@ export {
   oe as AgoNetworkError,
   te as AgoStreamError,
   G as ClientContextRegistry,
-  $ as DEFAULT_MAX_ACTIVITY_ENTRIES,
+  L as DEFAULT_MAX_ACTIVITY_ENTRIES,
   Z as DEFAULT_MAX_ERRORS,
-  k as DEFAULT_MAX_ERROR_AGE_MS,
+  N as DEFAULT_MAX_ERROR_AGE_MS,
   Q as ErrorWatcher,
   X as EventEmitter,
   K as FEEDBACK_REASONS,
@@ -133,10 +136,10 @@ export {
   A as autoDetectConfig,
   J as canInlineImage,
   R as copyToClipboard,
-  _e as createAgo,
+  Me as createAgo,
   x as createAgoProactive,
-  ge as createConversationSession,
-  le as createFormCollector,
+  ue as createConversationSession,
+  de as createFormCollector,
   ve as createMessageStream,
   ce as createMockClient,
   q as createStore,
@@ -148,28 +151,29 @@ export {
   w as highlightElement,
   V as isStreamNetworkError,
   fe as loadFormCollector,
-  L as logger,
+  D as logger,
   W as matchesRoutePattern,
   H as matchesWhen,
   be as onFormError,
   ye as onFormSubmitted,
+  _e as onFormSubmitting,
   Fe as onFunctionInvoke,
   he as onMessage,
   we as onMessageChunk,
-  Ce as onMessageError,
+  Se as onMessageError,
   Ee as onMessageStart,
-  Se as onToolCall,
+  Ce as onToolCall,
   v as openUrl,
   P as partialDeepMatch,
-  N as safeAttachmentUrl,
+  k as safeAttachmentUrl,
   T as scrollToElement,
   E as setLocalStorage,
   b as setTheme,
   I as showConfirmDialog,
-  C as showNotification,
-  S as showToast,
+  S as showNotification,
+  C as showToast,
   _ as submitForm,
   F as trackEvent,
   j as validateConfig,
-  Me as withHandler
+  Te as withHandler
 };