@useago/sdk 1.0.5 → 1.0.7

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("./AgoClient--y10UXUV.cjs"),m=require("./createFormCollector-CSG5ioym.cjs"),p=require("./createConversationSession-lJWANT6T.cjs"),w=require("./createMockClient-zHQ0cjUH.cjs");require("./testing.cjs");const g=require("./functions-DsmzgHjC.cjs");function h(e){return e}function E(e,o){return e.on("message:complete",o),()=>e.off("message:complete",o)}function S(e,o){return e.on("message:chunk",o),()=>e.off("message:chunk",o)}function y(e,o){return e.on("message:start",o),()=>e.off("message:start",o)}function v(e,o){return e.on("message:error",o),()=>e.off("message:error",o)}function b(e,o){return e.on("toolCall:received",o),()=>e.off("toolCall:received",o)}function F(e,o){return e.on("function:invoke",o),()=>e.off("function:invoke",o)}async function*M(e,o,l){const a=[];let r=null,s=!1;const c=i=>{a.push(i),r?.()},f=i=>c({type:"start",data:i}),t=i=>c({type:"chunk",data:i}),u=i=>{c({type:"complete",data:i}),s=!0,r?.()},d=i=>{c({type:"error",data:i}),s=!0,r?.()},C=i=>c({type:"toolCall",data:i});e.on("message:start",f),e.on("message:chunk",t),e.on("message:complete",u),e.on("message:error",d),e.on("toolCall:received",C),e.sendMessage(o,l).catch(()=>{s=!0,r?.()});try{for(;!s||a.length>0;)a.length>0?yield a.shift():(await new Promise(i=>{r=i}),r=null)}finally{e.off("message:start",f),e.off("message:chunk",t),e.off("message:complete",u),e.off("message:error",d),e.off("toolCall:received",C)}}function A(e){let o,l,a,r,s,c;if(typeof window<"u"&&window.AGO){const t=window.AGO;o=t.basepath,l=t.widgetId,a=t.agent||t.defaultAgent,r=t.permission,s=t.email,c=t.jwt}if(typeof document<"u"){const t=u=>document.querySelector(`meta[name="${u}"]`)?.getAttribute("content")||void 0;o=o||t("ago-base-url"),l=l||t("ago-widget-id"),a=a||t("ago-agent")||t("ago-agent-id"),r=r||t("ago-permission"),s=s||t("ago-user-email")}if(typeof document<"u"){const t=[document.body,...Array.from(document.querySelectorAll("script[data-ago-base-url]"))].filter(Boolean);for(const u of t)u&&(o=o||u.getAttribute("data-ago-base-url")||void 0,l=l||u.getAttribute("data-ago-widget-id")||void 0,a=a||u.getAttribute("data-ago-agent")||u.getAttribute("data-ago-agent-id")||void 0,r=r||u.getAttribute("data-ago-permission")||void 0,s=s||u.getAttribute("data-ago-user-email")||void 0)}o=e?.baseUrl||o,l=e?.widgetId||l,a=e?.agent||e?.defaultAgentId||a,r=e?.permission||r,s=e?.userEmail||s,c=e?.userJwt||c;const f=e?.debug;return o?{baseUrl:o,widgetId:l,agent:a,permission:r,userEmail:s,userJwt:c,debug:f}:null}function k(e){const o=A(e);if(!o)throw new n.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 n.AgoClient(o)}function q(e,o){return{...e,handler:o}}exports.AgoApiError=n.AgoApiError;exports.AgoClient=n.AgoClient;exports.AgoError=n.AgoError;exports.AgoFunctionError=n.AgoFunctionError;exports.AgoNetworkError=n.AgoNetworkError;exports.AgoStreamError=n.AgoStreamError;exports.ClientContextRegistry=n.ClientContextRegistry;exports.EventEmitter=n.EventEmitter;exports.FunctionRegistry=n.FunctionRegistry;exports.SSEHandler=n.SSEHandler;exports.autoDetectConfig=A;exports.copyToClipboard=g.copyToClipboard;exports.createAgo=k;exports.createConversationSession=p.createConversationSession;exports.createFormCollector=m.createFormCollector;exports.createMessageStream=M;exports.createMockClient=w.createMockClient;exports.createStore=m.createStore;exports.defineFunction=h;exports.deriveFormStatus=m.deriveFormStatus;exports.getLocalStorage=g.getLocalStorage;exports.getUserLocation=g.getUserLocation;exports.highlightElement=g.highlightElement;exports.isStreamNetworkError=n.isStreamNetworkError;exports.loadFormCollector=m.loadFormCollector;exports.logger=n.logger;exports.onFunctionInvoke=F;exports.onMessage=E;exports.onMessageChunk=S;exports.onMessageError=v;exports.onMessageStart=y;exports.onToolCall=b;exports.openUrl=g.openUrl;exports.scrollToElement=g.scrollToElement;exports.setLocalStorage=g.setLocalStorage;exports.setTheme=g.setTheme;exports.showConfirmDialog=g.showConfirmDialog;exports.showNotification=g.showNotification;exports.showToast=g.showToast;exports.submitForm=g.submitForm;exports.trackEvent=g.trackEvent;exports.validateConfig=n.validateConfig;exports.withHandler=q;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("./AgoClient--y10UXUV.cjs"),m=require("./createFormCollector-DWzGKDwO.cjs"),p=require("./createConversationSession-BuMXp0Ia.cjs"),w=require("./createMockClient-zHQ0cjUH.cjs");require("./testing.cjs");const g=require("./functions-Djnq-JAo.cjs");function h(e){return e}function E(e,o){return e.on("message:complete",o),()=>e.off("message:complete",o)}function S(e,o){return e.on("message:chunk",o),()=>e.off("message:chunk",o)}function y(e,o){return e.on("message:start",o),()=>e.off("message:start",o)}function v(e,o){return e.on("message:error",o),()=>e.off("message:error",o)}function b(e,o){return e.on("toolCall:received",o),()=>e.off("toolCall:received",o)}function F(e,o){return e.on("function:invoke",o),()=>e.off("function:invoke",o)}async function*M(e,o,l){const a=[];let r=null,s=!1;const c=i=>{a.push(i),r?.()},f=i=>c({type:"start",data:i}),t=i=>c({type:"chunk",data:i}),u=i=>{c({type:"complete",data:i}),s=!0,r?.()},d=i=>{c({type:"error",data:i}),s=!0,r?.()},C=i=>c({type:"toolCall",data:i});e.on("message:start",f),e.on("message:chunk",t),e.on("message:complete",u),e.on("message:error",d),e.on("toolCall:received",C),e.sendMessage(o,l).catch(()=>{s=!0,r?.()});try{for(;!s||a.length>0;)a.length>0?yield a.shift():(await new Promise(i=>{r=i}),r=null)}finally{e.off("message:start",f),e.off("message:chunk",t),e.off("message:complete",u),e.off("message:error",d),e.off("toolCall:received",C)}}function A(e){let o,l,a,r,s,c;if(typeof window<"u"&&window.AGO){const t=window.AGO;o=t.basepath,l=t.widgetId,a=t.agent||t.defaultAgent,r=t.permission,s=t.email,c=t.jwt}if(typeof document<"u"){const t=u=>document.querySelector(`meta[name="${u}"]`)?.getAttribute("content")||void 0;o=o||t("ago-base-url"),l=l||t("ago-widget-id"),a=a||t("ago-agent")||t("ago-agent-id"),r=r||t("ago-permission"),s=s||t("ago-user-email")}if(typeof document<"u"){const t=[document.body,...Array.from(document.querySelectorAll("script[data-ago-base-url]"))].filter(Boolean);for(const u of t)u&&(o=o||u.getAttribute("data-ago-base-url")||void 0,l=l||u.getAttribute("data-ago-widget-id")||void 0,a=a||u.getAttribute("data-ago-agent")||u.getAttribute("data-ago-agent-id")||void 0,r=r||u.getAttribute("data-ago-permission")||void 0,s=s||u.getAttribute("data-ago-user-email")||void 0)}o=e?.baseUrl||o,l=e?.widgetId||l,a=e?.agent||e?.defaultAgentId||a,r=e?.permission||r,s=e?.userEmail||s,c=e?.userJwt||c;const f=e?.debug;return o?{baseUrl:o,widgetId:l,agent:a,permission:r,userEmail:s,userJwt:c,debug:f}:null}function k(e){const o=A(e);if(!o)throw new n.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 n.AgoClient(o)}function q(e,o){return{...e,handler:o}}exports.AgoApiError=n.AgoApiError;exports.AgoClient=n.AgoClient;exports.AgoError=n.AgoError;exports.AgoFunctionError=n.AgoFunctionError;exports.AgoNetworkError=n.AgoNetworkError;exports.AgoStreamError=n.AgoStreamError;exports.ClientContextRegistry=n.ClientContextRegistry;exports.EventEmitter=n.EventEmitter;exports.FunctionRegistry=n.FunctionRegistry;exports.SSEHandler=n.SSEHandler;exports.autoDetectConfig=A;exports.copyToClipboard=g.copyToClipboard;exports.createAgo=k;exports.createConversationSession=p.createConversationSession;exports.createFormCollector=m.createFormCollector;exports.createMessageStream=M;exports.createMockClient=w.createMockClient;exports.createStore=m.createStore;exports.defineFunction=h;exports.deriveFormStatus=m.deriveFormStatus;exports.getLocalStorage=g.getLocalStorage;exports.getUserLocation=g.getUserLocation;exports.highlightElement=g.highlightElement;exports.isStreamNetworkError=n.isStreamNetworkError;exports.loadFormCollector=m.loadFormCollector;exports.logger=n.logger;exports.onFunctionInvoke=F;exports.onMessage=E;exports.onMessageChunk=S;exports.onMessageError=v;exports.onMessageStart=y;exports.onToolCall=b;exports.openUrl=g.openUrl;exports.scrollToElement=g.scrollToElement;exports.setLocalStorage=g.setLocalStorage;exports.setTheme=g.setTheme;exports.showConfirmDialog=g.showConfirmDialog;exports.showNotification=g.showNotification;exports.showToast=g.showToast;exports.submitForm=g.submitForm;exports.trackEvent=g.trackEvent;exports.validateConfig=n.validateConfig;exports.withHandler=q;

package/dist/index.d.cts

@@ -742,6 +742,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;
 }
 
 /**
@@ -897,6 +907,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;
 }
 
 /**
@@ -915,6 +927,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/index.d.ts

@@ -742,6 +742,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;
 }
 
 /**
@@ -897,6 +907,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;
 }
 
 /**
@@ -915,6 +927,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/index.js

@@ -1,9 +1,9 @@
-import { a as h, c as A, d as y, f as C, i as E, l as b, n as S, o as v, p as k, r as F, s as M, t as d, u as c } from "./AgoClient-DYdIe_R4.js";
-import { i as I, n as U, r as G, t as O } from "./createFormCollector-BUqSA2Qw.js";
-import { t as x } from "./createConversationSession-Boi0PjDU.js";
-import { t as N } from "./createMockClient-DwdxNwEn.js";
+import { a as h, c as A, d as y, f as C, i as E, l as b, m as S, o as v, p as k, r as F, s as M, t as T, u as I } from "./functions-CApuQZ2b.js";
+import { a as G, c as O, d as q, f as x, i as L, l as N, n as _, o as D, p as H, r as J, s as R, t as d, u as c } from "./AgoClient-DYdIe_R4.js";
+import { i as B, n as P, r as $, t as z } from "./createFormCollector-BwM7qTrp.js";
+import { t as Q } from "./createConversationSession-CCT1hCf8.js";
+import { t as W } from "./createMockClient-DwdxNwEn.js";
 import "./testing.js";
-import { a as H, c as J, d as R, f as j, i as B, l as P, m as $, o as z, p as K, r as Q, s as V, t as W, u as X } from "./functions-C1-5vadY.js";
 function Y(e) {
   return e;
 }
@@ -100,47 +100,47 @@ function ie(e, o) {
   };
 }
 export {
-  b as AgoApiError,
+  N as AgoApiError,
   d as AgoClient,
   c as AgoError,
-  y as AgoFunctionError,
-  C as AgoNetworkError,
-  k as AgoStreamError,
-  v as ClientContextRegistry,
-  F as EventEmitter,
-  M as FunctionRegistry,
-  E as SSEHandler,
+  q as AgoFunctionError,
+  x as AgoNetworkError,
+  H as AgoStreamError,
+  D as ClientContextRegistry,
+  J as EventEmitter,
+  R as FunctionRegistry,
+  L as SSEHandler,
   p as autoDetectConfig,
-  W as copyToClipboard,
+  T as copyToClipboard,
   se as createAgo,
-  x as createConversationSession,
-  O as createFormCollector,
+  Q as createConversationSession,
+  z as createFormCollector,
   ne as createMessageStream,
-  N as createMockClient,
-  I as createStore,
+  W as createMockClient,
+  B as createStore,
   Y as defineFunction,
-  U as deriveFormStatus,
-  Q as getLocalStorage,
-  B as getUserLocation,
-  H as highlightElement,
-  h as isStreamNetworkError,
-  G as loadFormCollector,
-  A as logger,
+  P as deriveFormStatus,
+  F as getLocalStorage,
+  E as getUserLocation,
+  h as highlightElement,
+  G as isStreamNetworkError,
+  $ as loadFormCollector,
+  O as logger,
   re as onFunctionInvoke,
   Z as onMessage,
   ee as onMessageChunk,
   te as onMessageError,
   oe as onMessageStart,
   ae as onToolCall,
-  z as openUrl,
-  V as scrollToElement,
-  J as setLocalStorage,
-  P as setTheme,
-  X as showConfirmDialog,
-  R as showNotification,
-  j as showToast,
-  K as submitForm,
-  $ as trackEvent,
-  S as validateConfig,
+  v as openUrl,
+  M as scrollToElement,
+  A as setLocalStorage,
+  b as setTheme,
+  I as showConfirmDialog,
+  y as showNotification,
+  C as showToast,
+  k as submitForm,
+  S as trackEvent,
+  _ as validateConfig,
   ie as withHandler
 };