@useago/sdk 1.0.1 → 1.0.2

package/dist/angular.d.cts

@@ -16,12 +16,26 @@ declare class AgoClient {
     private contextRegistry;
     private eventEmitter;
     private config;
+    /** Conversations already warned about an empty reply (one warning each). */
+    private warnedEmptyConversations;
     constructor(config: AgoConfig);
     /**
      * Send a message and receive a streaming response
      */
     sendMessage(content: string, options?: SendMessageOptions): Promise<AgoMessage>;
     private processSSEResponse;
+    /**
+     * Detect a reply that completed as DONE with no content and no activity —
+     * today's backend answers an unknown `agent` slug with an empty 200, which
+     * otherwise fails silently. Emits `message:empty` (always) and warns on the
+     * console once per conversation (unless `warnOnEmptyReply: false`).
+     *
+     * Deferred with setTimeout(0) so both land AFTER `sendMessage` resolves:
+     * `await client.sendMessage(...)` followed by `client.waitFor("message:empty")`
+     * must not race. TEMPORARY heuristic: remove once the backend returns an
+     * explicit error for unknown agents (see TODOS.md, backend issue).
+     */
+    private maybeFlagEmptyReply;
     private handleClientFunctionInvocation;
     /**
      * Get list of conversations
@@ -194,6 +208,11 @@ declare class AgoClient {
     }): Promise<AgoClientEvents[K]>;
     /**
      * Update client configuration
+     *
+     * Validates the MERGED config before committing: omitting a key (or passing
+     * it as `undefined`, common with spread-built partials) keeps the current
+     * value; an explicit empty/non-string `baseUrl` throws `config_missing_base_url`
+     * and leaves the client unchanged (no half-updated state).
      */
     updateConfig(config: Partial<AgoConfig>): void;
     /**
@@ -229,8 +248,23 @@ export declare interface AgoClientEvents {
      */
     "message:answer-complete": AgoMessage;
     "message:complete": AgoMessage;
+    /**
+     * A reply finished as `DONE` with empty content and no tool calls, client
+     * functions, or follow-up replies — usually an unknown `agent` slug (the
+     * backend currently answers those with an empty 200). Fires after
+     * `message:complete` AND after `sendMessage` resolves, so subscribing right
+     * after `await sendMessage(...)` still catches it. `messageId` and
+     * `conversationId` are empty strings when the stream completed without any
+     * message data at all (e.g. a proxy stripped the SSE stream).
+     */
+    "message:empty": {
+        conversationId: string;
+        messageId: string;
+    };
     "message:error": {
         error: string;
+        /** Stable error code (see configuration.md#error-codes) when the failure was an AgoError. */
+        code?: string;
         conversationId?: string;
         messageId?: string;
     };
@@ -259,7 +293,7 @@ export declare interface AgoClientEvents {
 export declare interface AgoConfig {
     /** API base URL (e.g., https://YOUR-DOMAIN.useago.com) */
     baseUrl: string;
-    /** Widget ID (X-Widget-Id header). Auto-generated if not provided. */
+    /** Per-visitor anonymous ID (X-User-Anon-Id header). Auto-generated if not provided. */
     widgetId?: string;
     /** Default agent (id or slug) for new conversations. Shorthand for `defaultAgentId`. */
     agent?: string;
@@ -273,6 +307,13 @@ export declare interface AgoConfig {
     userJwt?: string;
     /** Enable debug logging */
     debug?: boolean;
+    /**
+     * Warn on the console when a reply completes with empty content and no tool
+     * calls (the usual cause is an unknown `agent` slug, which the backend
+     * currently answers with an empty 200). Default `true`. The `message:empty`
+     * event fires regardless of this setting.
+     */
+    warnOnEmptyReply?: boolean;
 }
 
 declare type AgoEventHandler<K extends AgoEventName> = (data: AgoClientEvents[K]) => void;

package/dist/angular.d.ts

@@ -16,12 +16,26 @@ declare class AgoClient {
     private contextRegistry;
     private eventEmitter;
     private config;
+    /** Conversations already warned about an empty reply (one warning each). */
+    private warnedEmptyConversations;
     constructor(config: AgoConfig);
     /**
      * Send a message and receive a streaming response
      */
     sendMessage(content: string, options?: SendMessageOptions): Promise<AgoMessage>;
     private processSSEResponse;
+    /**
+     * Detect a reply that completed as DONE with no content and no activity —
+     * today's backend answers an unknown `agent` slug with an empty 200, which
+     * otherwise fails silently. Emits `message:empty` (always) and warns on the
+     * console once per conversation (unless `warnOnEmptyReply: false`).
+     *
+     * Deferred with setTimeout(0) so both land AFTER `sendMessage` resolves:
+     * `await client.sendMessage(...)` followed by `client.waitFor("message:empty")`
+     * must not race. TEMPORARY heuristic: remove once the backend returns an
+     * explicit error for unknown agents (see TODOS.md, backend issue).
+     */
+    private maybeFlagEmptyReply;
     private handleClientFunctionInvocation;
     /**
      * Get list of conversations
@@ -194,6 +208,11 @@ declare class AgoClient {
     }): Promise<AgoClientEvents[K]>;
     /**
      * Update client configuration
+     *
+     * Validates the MERGED config before committing: omitting a key (or passing
+     * it as `undefined`, common with spread-built partials) keeps the current
+     * value; an explicit empty/non-string `baseUrl` throws `config_missing_base_url`
+     * and leaves the client unchanged (no half-updated state).
      */
     updateConfig(config: Partial<AgoConfig>): void;
     /**
@@ -229,8 +248,23 @@ export declare interface AgoClientEvents {
      */
     "message:answer-complete": AgoMessage;
     "message:complete": AgoMessage;
+    /**
+     * A reply finished as `DONE` with empty content and no tool calls, client
+     * functions, or follow-up replies — usually an unknown `agent` slug (the
+     * backend currently answers those with an empty 200). Fires after
+     * `message:complete` AND after `sendMessage` resolves, so subscribing right
+     * after `await sendMessage(...)` still catches it. `messageId` and
+     * `conversationId` are empty strings when the stream completed without any
+     * message data at all (e.g. a proxy stripped the SSE stream).
+     */
+    "message:empty": {
+        conversationId: string;
+        messageId: string;
+    };
     "message:error": {
         error: string;
+        /** Stable error code (see configuration.md#error-codes) when the failure was an AgoError. */
+        code?: string;
         conversationId?: string;
         messageId?: string;
     };
@@ -259,7 +293,7 @@ export declare interface AgoClientEvents {
 export declare interface AgoConfig {
     /** API base URL (e.g., https://YOUR-DOMAIN.useago.com) */
     baseUrl: string;
-    /** Widget ID (X-Widget-Id header). Auto-generated if not provided. */
+    /** Per-visitor anonymous ID (X-User-Anon-Id header). Auto-generated if not provided. */
     widgetId?: string;
     /** Default agent (id or slug) for new conversations. Shorthand for `defaultAgentId`. */
     agent?: string;
@@ -273,6 +307,13 @@ export declare interface AgoConfig {
     userJwt?: string;
     /** Enable debug logging */
     debug?: boolean;
+    /**
+     * Warn on the console when a reply completes with empty content and no tool
+     * calls (the usual cause is an unknown `agent` slug, which the backend
+     * currently answers with an empty 200). Default `true`. The `message:empty`
+     * event fires regardless of this setting.
+     */
+    warnOnEmptyReply?: boolean;
 }
 
 declare type AgoEventHandler<K extends AgoEventName> = (data: AgoClientEvents[K]) => void;

package/dist/angular.js

@@ -1,4 +1,4 @@
-import { t as o } from "./AgoClient-CZYNL25R.js";
+import { t as o } from "./AgoClient-bQozE6-A.js";
 var n = class {
   constructor(t) {
     this.client = new o(t), this.messages$ = this.fromEvent("message:complete"), this.chunks$ = this.fromEvent("message:chunk"), this.errors$ = this.fromEvent("message:error"), this.messageStart$ = this.fromEvent("message:start");

package/dist/{createConversationSession-Bmqj2rSS.js → createConversationSession-BbK3ou1k.js}

@@ -1,4 +1,4 @@
-import { i as d } from "./createFormCollector-Bk0DRhUf.js";
+import { i as d } from "./createFormCollector-D-TpSd9x.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/{createConversationSession-BLZvXMmM.cjs → createConversationSession-DJUFgOXy.cjs}

@@ -1 +1 @@
-const d=require("./createFormCollector-Ca8wRrxc.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-CdQjGAl_.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/{createFormCollector-Ca8wRrxc.cjs → createFormCollector-CdQjGAl_.cjs}

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

package/dist/{createFormCollector-Bk0DRhUf.js → createFormCollector-D-TpSd9x.js}

@@ -1,4 +1,4 @@
-import { s as _ } from "./AgoClient-CZYNL25R.js";
+import { c as _ } from "./AgoClient-bQozE6-A.js";
 function E(n, e) {
   const i = e ? e.storage ?? (typeof localStorage < "u" ? localStorage : void 0) : void 0;
   let t = n;

package/dist/devtools.d.cts

@@ -16,12 +16,26 @@ declare class AgoClient {
     private contextRegistry;
     private eventEmitter;
     private config;
+    /** Conversations already warned about an empty reply (one warning each). */
+    private warnedEmptyConversations;
     constructor(config: AgoConfig);
     /**
      * Send a message and receive a streaming response
      */
     sendMessage(content: string, options?: SendMessageOptions): Promise<AgoMessage>;
     private processSSEResponse;
+    /**
+     * Detect a reply that completed as DONE with no content and no activity —
+     * today's backend answers an unknown `agent` slug with an empty 200, which
+     * otherwise fails silently. Emits `message:empty` (always) and warns on the
+     * console once per conversation (unless `warnOnEmptyReply: false`).
+     *
+     * Deferred with setTimeout(0) so both land AFTER `sendMessage` resolves:
+     * `await client.sendMessage(...)` followed by `client.waitFor("message:empty")`
+     * must not race. TEMPORARY heuristic: remove once the backend returns an
+     * explicit error for unknown agents (see TODOS.md, backend issue).
+     */
+    private maybeFlagEmptyReply;
     private handleClientFunctionInvocation;
     /**
      * Get list of conversations
@@ -194,6 +208,11 @@ declare class AgoClient {
     }): Promise<AgoClientEvents[K]>;
     /**
      * Update client configuration
+     *
+     * Validates the MERGED config before committing: omitting a key (or passing
+     * it as `undefined`, common with spread-built partials) keeps the current
+     * value; an explicit empty/non-string `baseUrl` throws `config_missing_base_url`
+     * and leaves the client unchanged (no half-updated state).
      */
     updateConfig(config: Partial<AgoConfig>): void;
     /**
@@ -229,8 +248,23 @@ declare interface AgoClientEvents {
      */
     "message:answer-complete": AgoMessage;
     "message:complete": AgoMessage;
+    /**
+     * A reply finished as `DONE` with empty content and no tool calls, client
+     * functions, or follow-up replies — usually an unknown `agent` slug (the
+     * backend currently answers those with an empty 200). Fires after
+     * `message:complete` AND after `sendMessage` resolves, so subscribing right
+     * after `await sendMessage(...)` still catches it. `messageId` and
+     * `conversationId` are empty strings when the stream completed without any
+     * message data at all (e.g. a proxy stripped the SSE stream).
+     */
+    "message:empty": {
+        conversationId: string;
+        messageId: string;
+    };
     "message:error": {
         error: string;
+        /** Stable error code (see configuration.md#error-codes) when the failure was an AgoError. */
+        code?: string;
         conversationId?: string;
         messageId?: string;
     };
@@ -259,7 +293,7 @@ declare interface AgoClientEvents {
 declare interface AgoConfig {
     /** API base URL (e.g., https://YOUR-DOMAIN.useago.com) */
     baseUrl: string;
-    /** Widget ID (X-Widget-Id header). Auto-generated if not provided. */
+    /** Per-visitor anonymous ID (X-User-Anon-Id header). Auto-generated if not provided. */
     widgetId?: string;
     /** Default agent (id or slug) for new conversations. Shorthand for `defaultAgentId`. */
     agent?: string;
@@ -273,6 +307,13 @@ declare interface AgoConfig {
     userJwt?: string;
     /** Enable debug logging */
     debug?: boolean;
+    /**
+     * Warn on the console when a reply completes with empty content and no tool
+     * calls (the usual cause is an unknown `agent` slug, which the backend
+     * currently answers with an empty 200). Default `true`. The `message:empty`
+     * event fires regardless of this setting.
+     */
+    warnOnEmptyReply?: boolean;
 }
 
 declare type AgoEventHandler<K extends AgoEventName> = (data: AgoClientEvents[K]) => void;

package/dist/devtools.d.ts

@@ -16,12 +16,26 @@ declare class AgoClient {
     private contextRegistry;
     private eventEmitter;
     private config;
+    /** Conversations already warned about an empty reply (one warning each). */
+    private warnedEmptyConversations;
     constructor(config: AgoConfig);
     /**
      * Send a message and receive a streaming response
      */
     sendMessage(content: string, options?: SendMessageOptions): Promise<AgoMessage>;
     private processSSEResponse;
+    /**
+     * Detect a reply that completed as DONE with no content and no activity —
+     * today's backend answers an unknown `agent` slug with an empty 200, which
+     * otherwise fails silently. Emits `message:empty` (always) and warns on the
+     * console once per conversation (unless `warnOnEmptyReply: false`).
+     *
+     * Deferred with setTimeout(0) so both land AFTER `sendMessage` resolves:
+     * `await client.sendMessage(...)` followed by `client.waitFor("message:empty")`
+     * must not race. TEMPORARY heuristic: remove once the backend returns an
+     * explicit error for unknown agents (see TODOS.md, backend issue).
+     */
+    private maybeFlagEmptyReply;
     private handleClientFunctionInvocation;
     /**
      * Get list of conversations
@@ -194,6 +208,11 @@ declare class AgoClient {
     }): Promise<AgoClientEvents[K]>;
     /**
      * Update client configuration
+     *
+     * Validates the MERGED config before committing: omitting a key (or passing
+     * it as `undefined`, common with spread-built partials) keeps the current
+     * value; an explicit empty/non-string `baseUrl` throws `config_missing_base_url`
+     * and leaves the client unchanged (no half-updated state).
      */
     updateConfig(config: Partial<AgoConfig>): void;
     /**
@@ -229,8 +248,23 @@ declare interface AgoClientEvents {
      */
     "message:answer-complete": AgoMessage;
     "message:complete": AgoMessage;
+    /**
+     * A reply finished as `DONE` with empty content and no tool calls, client
+     * functions, or follow-up replies — usually an unknown `agent` slug (the
+     * backend currently answers those with an empty 200). Fires after
+     * `message:complete` AND after `sendMessage` resolves, so subscribing right
+     * after `await sendMessage(...)` still catches it. `messageId` and
+     * `conversationId` are empty strings when the stream completed without any
+     * message data at all (e.g. a proxy stripped the SSE stream).
+     */
+    "message:empty": {
+        conversationId: string;
+        messageId: string;
+    };
     "message:error": {
         error: string;
+        /** Stable error code (see configuration.md#error-codes) when the failure was an AgoError. */
+        code?: string;
         conversationId?: string;
         messageId?: string;
     };
@@ -259,7 +293,7 @@ declare interface AgoClientEvents {
 declare interface AgoConfig {
     /** API base URL (e.g., https://YOUR-DOMAIN.useago.com) */
     baseUrl: string;
-    /** Widget ID (X-Widget-Id header). Auto-generated if not provided. */
+    /** Per-visitor anonymous ID (X-User-Anon-Id header). Auto-generated if not provided. */
     widgetId?: string;
     /** Default agent (id or slug) for new conversations. Shorthand for `defaultAgentId`. */
     agent?: string;
@@ -273,6 +307,13 @@ declare interface AgoConfig {
     userJwt?: string;
     /** Enable debug logging */
     debug?: boolean;
+    /**
+     * Warn on the console when a reply completes with empty content and no tool
+     * calls (the usual cause is an unknown `agent` slug, which the backend
+     * currently answers with an empty 200). Default `true`. The `message:empty`
+     * event fires regardless of this setting.
+     */
+    warnOnEmptyReply?: boolean;
 }
 
 declare type AgoEventHandler<K extends AgoEventName> = (data: AgoClientEvents[K]) => void;

package/dist/index.cjs

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

package/dist/index.d.cts

@@ -27,12 +27,26 @@ export declare class AgoClient {
     private contextRegistry;
     private eventEmitter;
     private config;
+    /** Conversations already warned about an empty reply (one warning each). */
+    private warnedEmptyConversations;
     constructor(config: AgoConfig);
     /**
      * Send a message and receive a streaming response
      */
     sendMessage(content: string, options?: SendMessageOptions): Promise<AgoMessage>;
     private processSSEResponse;
+    /**
+     * Detect a reply that completed as DONE with no content and no activity —
+     * today's backend answers an unknown `agent` slug with an empty 200, which
+     * otherwise fails silently. Emits `message:empty` (always) and warns on the
+     * console once per conversation (unless `warnOnEmptyReply: false`).
+     *
+     * Deferred with setTimeout(0) so both land AFTER `sendMessage` resolves:
+     * `await client.sendMessage(...)` followed by `client.waitFor("message:empty")`
+     * must not race. TEMPORARY heuristic: remove once the backend returns an
+     * explicit error for unknown agents (see TODOS.md, backend issue).
+     */
+    private maybeFlagEmptyReply;
     private handleClientFunctionInvocation;
     /**
      * Get list of conversations
@@ -205,6 +219,11 @@ export declare class AgoClient {
     }): Promise<AgoClientEvents[K]>;
     /**
      * Update client configuration
+     *
+     * Validates the MERGED config before committing: omitting a key (or passing
+     * it as `undefined`, common with spread-built partials) keeps the current
+     * value; an explicit empty/non-string `baseUrl` throws `config_missing_base_url`
+     * and leaves the client unchanged (no half-updated state).
      */
     updateConfig(config: Partial<AgoConfig>): void;
     /**
@@ -240,8 +259,23 @@ export declare interface AgoClientEvents {
      */
     "message:answer-complete": AgoMessage;
     "message:complete": AgoMessage;
+    /**
+     * A reply finished as `DONE` with empty content and no tool calls, client
+     * functions, or follow-up replies — usually an unknown `agent` slug (the
+     * backend currently answers those with an empty 200). Fires after
+     * `message:complete` AND after `sendMessage` resolves, so subscribing right
+     * after `await sendMessage(...)` still catches it. `messageId` and
+     * `conversationId` are empty strings when the stream completed without any
+     * message data at all (e.g. a proxy stripped the SSE stream).
+     */
+    "message:empty": {
+        conversationId: string;
+        messageId: string;
+    };
     "message:error": {
         error: string;
+        /** Stable error code (see configuration.md#error-codes) when the failure was an AgoError. */
+        code?: string;
         conversationId?: string;
         messageId?: string;
     };
@@ -270,7 +304,7 @@ export declare interface AgoClientEvents {
 export declare interface AgoConfig {
     /** API base URL (e.g., https://YOUR-DOMAIN.useago.com) */
     baseUrl: string;
-    /** Widget ID (X-Widget-Id header). Auto-generated if not provided. */
+    /** Per-visitor anonymous ID (X-User-Anon-Id header). Auto-generated if not provided. */
     widgetId?: string;
     /** Default agent (id or slug) for new conversations. Shorthand for `defaultAgentId`. */
     agent?: string;
@@ -284,10 +318,23 @@ export declare interface AgoConfig {
     userJwt?: string;
     /** Enable debug logging */
     debug?: boolean;
+    /**
+     * Warn on the console when a reply completes with empty content and no tool
+     * calls (the usual cause is an unknown `agent` slug, which the backend
+     * currently answers with an empty 200). Default `true`. The `message:empty`
+     * event fires regardless of this setting.
+     */
+    warnOnEmptyReply?: boolean;
 }
 
 /**
  * Base error class for AGO SDK
+ *
+ * Error convention: every throw carries a stable `code` (snake_case), a
+ * one-line fix hint in the message, and a doc URL/anchor when one exists.
+ * `code` is the compatibility surface — match on it, never on message text,
+ * which may be reworded in any release. The code registry lives in
+ * docs/general/configuration.md#error-codes.
  */
 export declare class AgoError extends Error {
     code: string;
@@ -343,9 +390,14 @@ export declare interface AgoSource {
 
 /**
  * SSE stream error
+ *
+ * `code` distinguishes failure classes without message parsing:
+ * - `stream_no_body`: the response had no streamable body (usually a
+ *   misconfigured endpoint or a proxy stripping the SSE stream)
+ * - `stream_error` (default): the stream failed mid-flight
  */
 export declare class AgoStreamError extends AgoError {
-    constructor(message: string);
+    constructor(message: string, code?: string);
 }
 
 /**
@@ -623,8 +675,8 @@ export declare const copyToClipboard: ClientFunctionDefinition;
 export declare function createAgo(overrides?: Partial<AgoConfig>): AgoClient;
 
 /**
- * Identify a returning visitor with a single, stable widget id — the same model as
- * the frontend's `getOrGenerateWidgetId` — and resume their last active thread.
+ * Identify a returning visitor with a single, stable anon id (one id, generated
+ * once and reused forever) and resume their last active thread.
  *
  * There is no per-agent conversation id: the widget id is the identity, and the last
  * active thread (its id + the time of its last message) is cached locally so resuming
@@ -1361,6 +1413,29 @@ export declare type ToolCallType = "form" | "confirmation_input" | "status_messa
  */
 export declare const trackEvent: ClientFunctionDefinition;
 
+/**
+ * Validate an AgoConfig at the public API boundary.
+ *
+ * Rules:
+ * - nullish / non-object config, or a missing/empty/non-string `baseUrl`,
+ *   throws `AgoError` with the stable code `config_missing_base_url`.
+ * - Values starting with `/` are allowed (same-origin proxy paths like
+ *   `/ago-proxy` are a supported embed pattern).
+ * - Values with any `scheme://` are allowed.
+ * - Anything else (no scheme, no leading slash, e.g. "ago.api.useago.com")
+ *   warns once per process — it usually means a forgotten protocol. It does
+ *   not throw: the request fails at send time with a runtime-specific error
+ *   (Node: URL parse error; browser: relative fetch), and a hard throw here
+ *   could break embeds we cannot foresee.
+ *
+ * The warning never echoes the configured value: misconfigured baseUrls
+ * sometimes carry credentials (e.g. `https://user:token@host`).
+ *
+ * @param context Prefix for the error message, naming the API the developer
+ *   actually called (e.g. "AgoClient", "createAgo()").
+ */
+export declare function validateConfig(config: unknown, context?: string): asserts config is AgoConfig;
+
 /**
  * Attach a handler to a pre-built function definition.
  *