@useago/sdk 0.4.1 → 0.4.3

package/dist/{AgoClient-B6PsfMeg.cjs → AgoClient-D4EL6nva.cjs}

@@ -1,6 +1,6 @@
-var h=class extends Error{constructor(e,t,r){super(e),this.code=t,this.statusCode=r,this.name="AgoError"}},u=class p extends h{constructor(t,r,s,n,o,a){super(t,r,s),this.type=n,this.param=o,this.docUrl=a,this.name="AgoApiError"}static fromResponse(t,r){const s=t.error;return new p(s.message,s.code,r,s.type,s.param,s.doc_url)}},d=class extends h{constructor(e,t){super(e,"network_error"),this.originalError=t,this.name="AgoNetworkError"}},g=class extends h{constructor(e){super(e,"stream_error"),this.name="AgoStreamError"}},m=class extends h{constructor(e,t,r){super(e,"function_error"),this.functionName=t,this.originalError=r,this.name="AgoFunctionError"}},_=class{constructor(e=!1){this.enabled=e}enable(){this.enabled=!0}disable(){this.enabled=!1}log(...e){this.enabled&&console.log("[AGO SDK]",...e)}warn(...e){this.enabled&&console.warn("[AGO SDK]",...e)}error(...e){console.error("[AGO SDK]",...e)}debug(...e){this.enabled&&console.debug("[AGO SDK]",...e)}},i=new _,f="ago_widget_id";function S(){if(typeof localStorage<"u"){const t=localStorage.getItem(f);if(t)return t}const e=crypto.randomUUID();if(typeof localStorage<"u")try{localStorage.setItem(f,e)}catch{}return e}var k=class{constructor(e){this.baseUrl=e.baseUrl.replace(/\/$/,""),this.headers={"X-Widget-Id":e.widgetId||S()},e.userEmail&&(this.headers["X-User-Email"]=e.userEmail),e.userJwt&&(this.headers.Authorization=`Bearer ${e.userJwt}`),e.permission&&(this.headers["X-Widget-Permission"]=e.permission)}updateConfig(e){e.baseUrl&&(this.baseUrl=e.baseUrl.replace(/\/$/,"")),e.widgetId&&(this.headers["X-Widget-Id"]=e.widgetId),e.userEmail&&(this.headers["X-User-Email"]=e.userEmail),e.userJwt&&(this.headers.Authorization=`Bearer ${e.userJwt}`),e.permission!==void 0&&(e.permission?this.headers["X-Widget-Permission"]=e.permission:delete this.headers["X-Widget-Permission"])}async get(e){return this.request("GET",e)}async post(e,t){return this.request("POST",e,t)}async postStream(e,t){const r=`${this.baseUrl}${e}`;i.debug("POST (stream)",r,t);try{const s=await fetch(r,{method:"POST",headers:{...this.headers,"Content-Type":"application/json"},body:t?JSON.stringify(t):void 0});return s.ok||await this.handleErrorResponse(s),s}catch(s){throw s instanceof u?s:new d(`Network error: ${s instanceof Error?s.message:"Unknown error"}`,s instanceof Error?s:void 0)}}async postFormData(e,t){const r=`${this.baseUrl}${e}`;i.debug("POST (formData)",r);const s={...this.headers};try{const n=await fetch(r,{method:"POST",headers:s,body:t});return n.ok||await this.handleErrorResponse(n),n}catch(n){throw n instanceof u?n:new d(`Network error: ${n instanceof Error?n.message:"Unknown error"}`,n instanceof Error?n:void 0)}}async request(e,t,r){const s=`${this.baseUrl}${t}`;i.debug(e,s,r);try{const n=await fetch(s,{method:e,headers:{...this.headers,"Content-Type":"application/json"},body:r?JSON.stringify(r):void 0});return n.ok||await this.handleErrorResponse(n),n.status===204?void 0:n.json()}catch(n){throw n instanceof u?n:new d(`Network error: ${n instanceof Error?n.message:"Unknown error"}`,n instanceof Error?n:void 0)}}async handleErrorResponse(e){let t;try{t=await e.json()}catch{}throw t?.error?u.fromResponse(t,e.status):new u(`HTTP ${e.status}: ${e.statusText}`,"http_error",e.status,"api_error")}},y=class{constructor(){this.functions=new Map}register(e,t,r){if(typeof e=="object"){const{name:n,handler:o,description:a,parameters:c}=e;return this.register(n,o,{description:a,parameters:c})}const s=e;if(!t||!r)throw new Error("handler and schema are required");this.functions.has(s)&&i.warn(`Function "${s}" is being overwritten`),this.functions.set(s,{schema:{...r,name:s},handler:t}),i.log(`Registered function: ${s}`)}unregister(e){const t=this.functions.delete(e);return t&&i.log(`Unregistered function: ${e}`),t}get(e){return this.functions.get(e)}has(e){return this.functions.has(e)}getSchemas(){return Array.from(this.functions.values()).map(e=>e.schema)}async execute(e,t){const r=this.functions.get(e);if(!r)throw new m(`Function "${e}" is not registered`,e);i.log(`Executing function: ${e}`,t);try{const s=await r.handler(t);return i.log(`Function ${e} completed:`,s),s}catch(s){throw i.error(`Function ${e} failed:`,s),new m(`Function "${e}" execution failed: ${s instanceof Error?s.message:"Unknown error"}`,e,s instanceof Error?s:void 0)}}clear(){this.functions.clear(),i.log("Cleared all registered functions")}get size(){return this.functions.size}},v=class{constructor(){this.entries=new Map,this.dynamicProviders=new Map}set(e,t){this.entries.set(e,t),i.log(`ClientContext set: ${e}`)}remove(e){const t=this.entries.delete(e);return t&&i.log(`ClientContext removed: ${e}`),t}addDynamicProvider(e,t){this.dynamicProviders.set(e,t),i.log(`DynamicContext provider added: ${e}`)}removeDynamicProvider(e){const t=this.dynamicProviders.delete(e);return t&&i.log(`DynamicContext provider removed: ${e}`),t}getSnapshot(){if(this.entries.size===0&&this.dynamicProviders.size===0)return null;const e={};for(const[t,r]of this.entries)e[t]=r;for(const[t,r]of this.dynamicProviders)try{const s=r();s&&(e[t]=s)}catch(s){i.error(`DynamicContext provider "${t}" threw:`,s)}return Object.keys(e).length===0?null:{entries:e}}clear(){this.entries.clear(),this.dynamicProviders.clear(),i.log("ClientContext cleared")}},w=class{constructor(e){this.callbacks=e,this.buffer="",this.message={},this.toolCalls=[],this.sources=[],this.followUpReplies=[],this.isFirstChunk=!0}async processStream(e){if(!e.body)throw new g("Response has no body");const t=e.body.getReader(),r=new TextDecoder;try{for(;;){const{done:s,value:n}=await t.read();if(s)break;const o=r.decode(n,{stream:!0});this.buffer+=o,this.processBuffer()}return this.buffer.trim()&&this.processBuffer(),this.buildFinalMessage()}catch(s){const n=s instanceof Error?s:new g("Stream processing failed");throw this.callbacks.onError?.(n),n}finally{t.releaseLock()}}processBuffer(){const e=this.buffer.split(`
+var u=class extends Error{constructor(e,t,r){super(e),this.code=t,this.statusCode=r,this.name="AgoError"}},h=class p extends u{constructor(t,r,s,n,o,a){super(t,r,s),this.type=n,this.param=o,this.docUrl=a,this.name="AgoApiError"}static fromResponse(t,r){const s=t.error;return new p(s.message,s.code,r,s.type,s.param,s.doc_url)}},d=class extends u{constructor(e,t){super(e,"network_error"),this.originalError=t,this.name="AgoNetworkError"}},g=class extends u{constructor(e){super(e,"stream_error"),this.name="AgoStreamError"}},f=class extends u{constructor(e,t,r){super(e,"function_error"),this.functionName=t,this.originalError=r,this.name="AgoFunctionError"}},_=class{constructor(e=!1){this.enabled=e}enable(){this.enabled=!0}disable(){this.enabled=!1}log(...e){this.enabled&&console.log("[AGO SDK]",...e)}warn(...e){this.enabled&&console.warn("[AGO SDK]",...e)}error(...e){console.error("[AGO SDK]",...e)}debug(...e){this.enabled&&console.debug("[AGO SDK]",...e)}},i=new _,m="ago_widget_id";function S(){if(typeof localStorage<"u"){const t=localStorage.getItem(m);if(t)return t}const e=crypto.randomUUID();if(typeof localStorage<"u")try{localStorage.setItem(m,e)}catch{}return e}var k=class{constructor(e){this.baseUrl=e.baseUrl.replace(/\/$/,""),this.headers={"X-Widget-Id":e.widgetId||S()},e.userEmail&&(this.headers["X-User-Email"]=e.userEmail),e.userJwt&&(this.headers.Authorization=`Bearer ${e.userJwt}`),e.permission&&(this.headers["X-Widget-Permission"]=e.permission)}updateConfig(e){e.baseUrl&&(this.baseUrl=e.baseUrl.replace(/\/$/,"")),e.widgetId&&(this.headers["X-Widget-Id"]=e.widgetId),e.userEmail&&(this.headers["X-User-Email"]=e.userEmail),e.userJwt&&(this.headers.Authorization=`Bearer ${e.userJwt}`),e.permission!==void 0&&(e.permission?this.headers["X-Widget-Permission"]=e.permission:delete this.headers["X-Widget-Permission"])}async get(e){return this.request("GET",e)}async post(e,t){return this.request("POST",e,t)}async postStream(e,t){const r=`${this.baseUrl}${e}`;i.debug("POST (stream)",r,t);try{const s=await fetch(r,{method:"POST",headers:{...this.headers,"Content-Type":"application/json"},body:t?JSON.stringify(t):void 0});return s.ok||await this.handleErrorResponse(s),s}catch(s){throw s instanceof h?s:new d(`Network error: ${s instanceof Error?s.message:"Unknown error"}`,s instanceof Error?s:void 0)}}async postFormData(e,t){const r=`${this.baseUrl}${e}`;i.debug("POST (formData)",r);const s={...this.headers};try{const n=await fetch(r,{method:"POST",headers:s,body:t});return n.ok||await this.handleErrorResponse(n),n}catch(n){throw n instanceof h?n:new d(`Network error: ${n instanceof Error?n.message:"Unknown error"}`,n instanceof Error?n:void 0)}}async request(e,t,r){const s=`${this.baseUrl}${t}`;i.debug(e,s,r);try{const n=await fetch(s,{method:e,headers:{...this.headers,"Content-Type":"application/json"},body:r?JSON.stringify(r):void 0});return n.ok||await this.handleErrorResponse(n),n.status===204?void 0:n.json()}catch(n){throw n instanceof h?n:new d(`Network error: ${n instanceof Error?n.message:"Unknown error"}`,n instanceof Error?n:void 0)}}async handleErrorResponse(e){let t;try{t=await e.json()}catch{}throw t?.error?h.fromResponse(t,e.status):new h(`HTTP ${e.status}: ${e.statusText}`,"http_error",e.status,"api_error")}},y=class{constructor(){this.functions=new Map}register(e,t,r){if(typeof e=="object"){const{name:n,handler:o,description:a,parameters:c}=e;return this.register(n,o,{description:a,parameters:c})}const s=e;if(!t||!r)throw new Error("handler and schema are required");this.functions.has(s)&&i.warn(`Function "${s}" is being overwritten`),this.functions.set(s,{schema:{...r,name:s},handler:t}),i.log(`Registered function: ${s}`)}unregister(e){const t=this.functions.delete(e);return t&&i.log(`Unregistered function: ${e}`),t}get(e){return this.functions.get(e)}has(e){return this.functions.has(e)}getSchemas(){return Array.from(this.functions.values()).map(e=>e.schema)}async execute(e,t){const r=this.functions.get(e);if(!r)throw new f(`Function "${e}" is not registered`,e);i.log(`Executing function: ${e}`,t);try{const s=await r.handler(t);return i.log(`Function ${e} completed:`,s),s}catch(s){throw i.error(`Function ${e} failed:`,s),new f(`Function "${e}" execution failed: ${s instanceof Error?s.message:"Unknown error"}`,e,s instanceof Error?s:void 0)}}clear(){this.functions.clear(),i.log("Cleared all registered functions")}get size(){return this.functions.size}},v=class{constructor(){this.entries=new Map,this.dynamicProviders=new Map}set(e,t){this.entries.set(e,t),i.log(`ClientContext set: ${e}`)}remove(e){const t=this.entries.delete(e);return t&&i.log(`ClientContext removed: ${e}`),t}addDynamicProvider(e,t){this.dynamicProviders.set(e,t),i.log(`DynamicContext provider added: ${e}`)}removeDynamicProvider(e){const t=this.dynamicProviders.delete(e);return t&&i.log(`DynamicContext provider removed: ${e}`),t}getSnapshot(){if(this.entries.size===0&&this.dynamicProviders.size===0)return null;const e={};for(const[t,r]of this.entries)e[t]=r;for(const[t,r]of this.dynamicProviders)try{const s=r();s&&(e[t]=s)}catch(s){i.error(`DynamicContext provider "${t}" threw:`,s)}return Object.keys(e).length===0?null:{entries:e}}clear(){this.entries.clear(),this.dynamicProviders.clear(),i.log("ClientContext cleared")}},w=class{constructor(e){this.callbacks=e,this.buffer="",this.message={},this.toolCalls=[],this.sources=[],this.followUpReplies=[],this.isFirstChunk=!0}async processStream(e){if(!e.body)throw new g("Response has no body");const t=e.body.getReader(),r=new TextDecoder;try{for(;;){const{done:s,value:n}=await t.read();if(s)break;const o=r.decode(n,{stream:!0});this.buffer+=o,this.processBuffer()}return this.buffer.trim()&&this.processBuffer(),this.buildFinalMessage()}catch(s){const n=s instanceof Error?s:new g("Stream processing failed");throw this.callbacks.onError?.(n),n}finally{t.releaseLock()}}processBuffer(){const e=this.buffer.split(`
 
 `);this.buffer=e.pop()||"";for(const t of e){if(!t.trim())continue;const r=t.split(`
-`);for(const s of r)if(!s.startsWith(": ")&&s.startsWith("data: ")){const n=s.slice(6);try{const o=JSON.parse(n);this.handleChunk(o)}catch(o){i.warn("Failed to parse SSE data:",n,o)}}}}handleChunk(e){if(e.message_id&&!this.message.id&&(this.message.id=e.message_id),e.thread?.id&&(this.message.conversationId=e.thread.id,this.isFirstChunk&&this.message.id&&(this.isFirstChunk=!1,this.callbacks.onStart?.({conversationId:this.message.conversationId,messageId:this.message.id}))),e.content!==void 0&&(this.message.content=(this.message.content||"")+e.content,this.message.conversationId&&this.message.id&&this.callbacks.onChunk?.({content:e.content,conversationId:this.message.conversationId,messageId:this.message.id})),e.full_content!==void 0&&(this.message.content=e.full_content),e.status&&(this.message.status=e.status),e.agent&&(this.message.agent={id:e.agent.id,name:e.agent.name,displayName:e.agent.display_name}),e.knowledge_sources&&(this.sources=e.knowledge_sources.map(t=>{const r=t.knowledge_document;return{id:r.id,title:r.title,url:r.use_external_link?r.external_link_url:r.internal_link_url}})),e.type==="client_function"&&e.function_name&&this.callbacks.onClientFunction?.({invocationId:e.id||"",functionName:e.function_name,arguments:e.arguments||{},conversationId:this.message.conversationId||""}),e.tool_call_data&&e.type&&e.type!=="client_function"){const t=this.parseToolCall(e);this.callbacks.onToolCall?.(t);const r=this.toolCalls.findIndex(s=>s.id===t.id);r>=0?this.toolCalls[r]=t:this.toolCalls.push(t)}e.follow_up_replies&&(this.followUpReplies=e.follow_up_replies)}parseToolCall(e){return{id:e.id||"",type:e.type||"status_message",status:e.status||"unknown",toolName:e.tool_name||"",toolDisplayName:e.tool_display_name,message:e.message,formSchema:e.form_schema,data:e.data,functionName:e.function_name,arguments:e.arguments}}buildFinalMessage(){const e={id:this.message.id||"",conversationId:this.message.conversationId||"",content:this.message.content||"",role:"assistant",status:this.message.status||"DONE",agent:this.message.agent,sources:this.sources.length>0?this.sources:void 0,toolCalls:this.toolCalls.length>0?this.toolCalls:void 0,followUpReplies:this.followUpReplies.length>0?this.followUpReplies:void 0,createdAt:new Date};return this.callbacks.onComplete?.(e),e}};function x(e){const t=e.message.toLowerCase();return t.includes("load failed")||t.includes("failed to fetch")||t.includes("network")||t.includes("abort")}var b=class{constructor(){this.handlers=new Map}on(e,t){this.handlers.has(e)||this.handlers.set(e,new Set),this.handlers.get(e).add(t)}off(e,t){const r=this.handlers.get(e);r&&r.delete(t)}emit(e,t){const r=this.handlers.get(e);r&&r.forEach(s=>{try{s(t)}catch(n){console.error(`Error in event handler for ${String(e)}:`,n)}})}once(e,t){const r=(s=>{this.off(e,r),t(s)});this.on(e,r)}waitFor(e,t){return new Promise((r,s)=>{let n;const o=(a=>{n&&clearTimeout(n),r(a)});this.once(e,o),t?.timeout&&(n=setTimeout(()=>{this.off(e,o),s(new Error(`waitFor("${String(e)}") timed out after ${t.timeout}ms`))},t.timeout))})}removeAllListeners(e){e?this.handlers.delete(e):this.handlers.clear()}},A=class C{constructor(t){this.config=t,this.httpClient=new k(t),this.functionRegistry=new y,this.contextRegistry=new v,this.eventEmitter=new b,t.debug&&i.enable(),i.log("AgoClient initialized")}async sendMessage(t,r){const s=this.functionRegistry.getSchemas(),n=this.contextRegistry.getSnapshot(),o=this.config.agent||this.config.defaultAgentId,a={content:t,conversation_id:r?.conversationId,agent_id:r?.agentId||o};s.length>0&&(a.client_functions=s),n&&(a.client_context=n);let c;if(r?.files&&r.files.length>0){const l=new FormData;l.append("content",t),r.conversationId&&l.append("conversation_id",r.conversationId),(r.agentId||o)&&l.append("agent_id",r.agentId||o||""),s.length>0&&l.append("client_functions",JSON.stringify(s)),n&&l.append("client_context",JSON.stringify(n));for(const E of r.files)l.append("files",E);c=await this.httpClient.postFormData("/api/sdk/v1/messages",l)}else c=await this.httpClient.postStream("/api/sdk/v1/messages",a);return this.processSSEResponse(c)}async processSSEResponse(t){return new w({onStart:r=>{this.eventEmitter.emit("message:start",r)},onChunk:r=>{this.eventEmitter.emit("message:chunk",r)},onToolCall:r=>{this.eventEmitter.emit("toolCall:received",r),r.type==="form"&&this.eventEmitter.emit("toolCall:form",r)},onClientFunction:async r=>{this.eventEmitter.emit("function:invoke",r),await this.handleClientFunctionInvocation(r)},onComplete:r=>{this.eventEmitter.emit("message:complete",r)},onError:r=>{this.eventEmitter.emit("message:error",{error:r.message})}}).processStream(t)}async handleClientFunctionInvocation(t){let r,s;try{r=await this.functionRegistry.execute(t.functionName,t.arguments)}catch(n){s=n instanceof Error?n.message:"Unknown error",i.error("Client function execution failed:",n)}if(t.invocationId)try{await this.submitToolCallForm(t.invocationId,{result:r,error:s,_type:"client_function_result"})}catch(n){i.error("Failed to submit function result:",n)}this.eventEmitter.emit("function:result",{invocationId:t.invocationId,result:r,error:s})}async getConversations(){return(await this.httpClient.get("/api/sdk/v1/conversations")).items.map(t=>({id:t.id,title:t.title,lastMessageDate:new Date(t.last_message_date)}))}async getConversation(t){const r=await this.httpClient.get(`/api/sdk/v1/conversations/${t}`),s={id:r.id,title:r.title,lastMessageDate:new Date(r.last_message_date),messages:r.messages.map(n=>({id:n.id,conversationId:r.id,content:n.content,role:n.role,status:n.status,createdAt:new Date(n.created_at),toolCalls:C.mapPersistedToolCalls(n.tool_call_data)}))};return this.eventEmitter.emit("conversation:loaded",s),s}static mapPersistedToolCalls(t){if(!(!t||t.length===0))return t.map(r=>({id:String(r.id??""),type:r.type??"status_message",status:String(r.status??"unknown"),toolName:r.tool_name??"",toolDisplayName:r.tool_display_name,message:r.message,formSchema:r.form_schema,data:r.data,functionName:r.function_name,arguments:r.arguments}))}async getMessages(t){return(await this.getConversation(t)).messages||[]}async submitToolCallForm(t,r){await this.httpClient.post(`/api/sdk/v1/tool-calls/${t}/submit`,{formData:r})}async confirmToolCall(t){await this.httpClient.post(`/api/tool-calls/${t}/confirm/`)}async rejectToolCall(t){await this.httpClient.post(`/api/tool-calls/${t}/reject/`)}async submitFormCollector(t,r){return this.httpClient.post("/api/sdk/v1/forms/submit",{destination:t,values:r})}async submitFeedback(t,r){await this.httpClient.post(`/api/sdk/v1/messages/${t}/feedback`,{rating:r})}registerFunction(t,r,s){typeof t=="object"?this.functionRegistry.register(t):this.functionRegistry.register(t,r,s)}register(t){if(Array.isArray(t))for(const r of t)this.functionRegistry.register(r);else this.functionRegistry.register(t)}unregisterFunction(t){return this.functionRegistry.unregister(t)}getRegisteredFunctions(){return this.functionRegistry.getSchemas()}registerNavigationFunction(t,r){const s=r.map(o=>o.name),n=r.map(o=>`- "${o.name}": ${o.description}`).join(`
+`);for(const s of r)if(!s.startsWith(": ")&&s.startsWith("data: ")){const n=s.slice(6);try{const o=JSON.parse(n);this.handleChunk(o)}catch(o){i.warn("Failed to parse SSE data:",n,o)}}}}handleChunk(e){if(e.message_id&&!this.message.id&&(this.message.id=e.message_id),e.thread?.id&&(this.message.conversationId=e.thread.id,this.isFirstChunk&&this.message.id&&(this.isFirstChunk=!1,this.callbacks.onStart?.({conversationId:this.message.conversationId,messageId:this.message.id}))),e.content!==void 0&&(this.message.content=(this.message.content||"")+e.content,this.message.conversationId&&this.message.id&&this.callbacks.onChunk?.({content:e.content,conversationId:this.message.conversationId,messageId:this.message.id})),e.full_content!==void 0&&(this.message.content=e.full_content),e.status&&(this.message.status=e.status),e.agent&&(this.message.agent={id:e.agent.id,name:e.agent.name,displayName:e.agent.display_name}),e.knowledge_sources&&(this.sources=e.knowledge_sources.map(t=>{const r=t.knowledge_document;return{id:r.id,title:r.title,url:r.use_external_link?r.external_link_url:r.internal_link_url}})),e.type==="client_function"&&e.function_name&&this.callbacks.onClientFunction?.({invocationId:e.id||"",functionName:e.function_name,arguments:e.arguments||{},conversationId:this.message.conversationId||""}),e.tool_call_data&&e.type&&e.type!=="client_function"){const t=this.parseToolCall(e);this.callbacks.onToolCall?.(t);const r=this.toolCalls.findIndex(s=>s.id===t.id);r>=0?this.toolCalls[r]=t:this.toolCalls.push(t)}e.follow_up_replies&&(this.followUpReplies=e.follow_up_replies)}parseToolCall(e){return{id:e.id||"",type:e.type||"status_message",status:e.status||"unknown",toolName:e.tool_name||"",toolDisplayName:e.tool_display_name,message:e.message,formSchema:e.form_schema,data:e.data,functionName:e.function_name,arguments:e.arguments}}buildFinalMessage(){const e={id:this.message.id||"",conversationId:this.message.conversationId||"",content:this.message.content||"",role:"assistant",status:this.message.status||"DONE",agent:this.message.agent,sources:this.sources.length>0?this.sources:void 0,toolCalls:this.toolCalls.length>0?this.toolCalls:void 0,followUpReplies:this.followUpReplies.length>0?this.followUpReplies:void 0,createdAt:new Date};return this.callbacks.onComplete?.(e),e}};function x(e){const t=e.message.toLowerCase();return t.includes("load failed")||t.includes("failed to fetch")||t.includes("network")||t.includes("abort")}var C=class{constructor(){this.handlers=new Map}on(e,t){this.handlers.has(e)||this.handlers.set(e,new Set),this.handlers.get(e).add(t)}off(e,t){const r=this.handlers.get(e);r&&r.delete(t)}emit(e,t){const r=this.handlers.get(e);r&&r.forEach(s=>{try{s(t)}catch(n){console.error(`Error in event handler for ${String(e)}:`,n)}})}once(e,t){const r=(s=>{this.off(e,r),t(s)});this.on(e,r)}waitFor(e,t){return new Promise((r,s)=>{let n;const o=(a=>{n&&clearTimeout(n),r(a)});this.once(e,o),t?.timeout&&(n=setTimeout(()=>{this.off(e,o),s(new Error(`waitFor("${String(e)}") timed out after ${t.timeout}ms`))},t.timeout))})}removeAllListeners(e){e?this.handlers.delete(e):this.handlers.clear()}},A=class b{constructor(t){this.config=t,this.httpClient=new k(t),this.functionRegistry=new y,this.contextRegistry=new v,this.eventEmitter=new C,t.debug&&i.enable(),i.log("AgoClient initialized")}async sendMessage(t,r){const s=this.functionRegistry.getSchemas(),n=this.contextRegistry.getSnapshot(),o=this.config.agent||this.config.defaultAgentId,a={content:t,conversation_id:r?.conversationId,agent_id:r?.agentId||o};s.length>0&&(a.client_functions=s),n&&(a.client_context=n);let c;if(r?.files&&r.files.length>0){const l=new FormData;l.append("content",t),r.conversationId&&l.append("conversation_id",r.conversationId),(r.agentId||o)&&l.append("agent_id",r.agentId||o||""),s.length>0&&l.append("client_functions",JSON.stringify(s)),n&&l.append("client_context",JSON.stringify(n));for(const E of r.files)l.append("files",E);c=await this.httpClient.postFormData("/api/sdk/v1/messages",l)}else c=await this.httpClient.postStream("/api/sdk/v1/messages",a);return this.processSSEResponse(c)}async processSSEResponse(t){return new w({onStart:r=>{this.eventEmitter.emit("message:start",r)},onChunk:r=>{this.eventEmitter.emit("message:chunk",r)},onToolCall:r=>{this.eventEmitter.emit("toolCall:received",r),r.type==="form"&&this.eventEmitter.emit("toolCall:form",r)},onClientFunction:async r=>{this.eventEmitter.emit("function:invoke",r),await this.handleClientFunctionInvocation(r)},onComplete:r=>{this.eventEmitter.emit("message:complete",r)},onError:r=>{this.eventEmitter.emit("message:error",{error:r.message})}}).processStream(t)}async handleClientFunctionInvocation(t){let r,s;try{r=await this.functionRegistry.execute(t.functionName,t.arguments)}catch(n){s=n instanceof Error?n.message:"Unknown error",i.error("Client function execution failed:",n)}if(t.invocationId)try{await this.submitToolCallForm(t.invocationId,{result:r,error:s,_type:"client_function_result"})}catch(n){i.error("Failed to submit function result:",n)}this.eventEmitter.emit("function:result",{invocationId:t.invocationId,result:r,error:s})}async getConversations(){return(await this.httpClient.get("/api/sdk/v1/conversations")).items.map(t=>({id:t.id,title:t.title,lastMessageDate:new Date(t.last_message_date)}))}async getConversation(t){const r=await this.httpClient.get(`/api/sdk/v1/conversations/${t}`),s={id:r.id,title:r.title,lastMessageDate:new Date(r.last_message_date),messages:r.messages.map(n=>({id:n.id,conversationId:r.id,content:n.content,role:n.role,status:n.status,createdAt:new Date(n.created_at),toolCalls:b.mapPersistedToolCalls(n.tool_call_data)}))};return this.eventEmitter.emit("conversation:loaded",s),s}static mapPersistedToolCalls(t){if(!(!t||t.length===0))return t.map(r=>({id:String(r.id??""),type:r.type??"status_message",status:String(r.status??"unknown"),toolName:r.tool_name??"",toolDisplayName:r.tool_display_name,message:r.message,formSchema:r.form_schema,data:r.data,functionName:r.function_name,arguments:r.arguments}))}async getMessages(t){return(await this.getConversation(t)).messages||[]}async submitToolCallForm(t,r){await this.httpClient.post(`/api/sdk/v1/tool-calls/${t}/submit`,{formData:r})}async confirmToolCall(t){await this.httpClient.post(`/api/tool-calls/${t}/confirm/`)}async rejectToolCall(t){await this.httpClient.post(`/api/tool-calls/${t}/reject/`)}async submitFormCollector(t,r){return this.httpClient.post("/api/sdk/v1/forms/submit",{destination:t,values:r})}async submitFeedback(t,r){await this.httpClient.post(`/api/sdk/v1/messages/${t}/feedback`,{rating:r})}registerFunction(t,r,s){typeof t=="object"?this.functionRegistry.register(t):this.functionRegistry.register(t,r,s)}register(t){if(Array.isArray(t))for(const r of t)this.functionRegistry.register(r);else this.functionRegistry.register(t)}unregisterFunction(t){return this.functionRegistry.unregister(t)}getRegisteredFunctions(){return this.functionRegistry.getSchemas()}registerNavigationFunction(t,r){const s=r.map(o=>o.name),n=r.map(o=>`- "${o.name}": ${o.description}`).join(`
 `);this.registerFunction("navigateToPage",async o=>{const a=o.page,c=r.find(l=>l.name===a);return c?(t(c.path),{success:!0,navigatedTo:c.path}):{success:!1,error:`Unknown page: ${a}`}},{description:`Navigate the user to a page in the application. Available pages:
-${n}`,parameters:{type:"object",properties:{page:{type:"string",description:"The page to navigate to",enum:s}},required:["page"]}})}setContext(t,r){this.contextRegistry.set(t,r)}removeContext(t){return this.contextRegistry.remove(t)}addDynamicContext(t,r){this.contextRegistry.addDynamicProvider(t,r)}removeDynamicContext(t){return this.contextRegistry.removeDynamicProvider(t)}enableAutoPageContext(){this.contextRegistry.addDynamicProvider("browser-page",()=>{const t=typeof window<"u"?window.location.href:void 0,r=typeof document<"u"?document.title:void 0;return!t&&!r?null:{name:"Browser page",description:"Current page the user is viewing",data:{url:t,title:r}}})}getContextSnapshot(){return this.contextRegistry.getSnapshot()}on(t,r){this.eventEmitter.on(t,r)}off(t,r){this.eventEmitter.off(t,r)}once(t,r){this.eventEmitter.once(t,r)}waitFor(t,r){return this.eventEmitter.waitFor(t,r)}updateConfig(t){this.config={...this.config,...t},this.httpClient.updateConfig(t),t.debug!==void 0&&(t.debug?i.enable():i.disable())}destroy(){this.eventEmitter.removeAllListeners(),this.functionRegistry.clear(),this.contextRegistry.clear(),i.log("AgoClient destroyed")}};Object.defineProperty(exports,"AgoApiError",{enumerable:!0,get:function(){return u}});Object.defineProperty(exports,"AgoClient",{enumerable:!0,get:function(){return A}});Object.defineProperty(exports,"AgoError",{enumerable:!0,get:function(){return h}});Object.defineProperty(exports,"AgoFunctionError",{enumerable:!0,get:function(){return m}});Object.defineProperty(exports,"AgoNetworkError",{enumerable:!0,get:function(){return d}});Object.defineProperty(exports,"AgoStreamError",{enumerable:!0,get:function(){return g}});Object.defineProperty(exports,"ClientContextRegistry",{enumerable:!0,get:function(){return v}});Object.defineProperty(exports,"EventEmitter",{enumerable:!0,get:function(){return b}});Object.defineProperty(exports,"FunctionRegistry",{enumerable:!0,get:function(){return y}});Object.defineProperty(exports,"SSEHandler",{enumerable:!0,get:function(){return w}});Object.defineProperty(exports,"isStreamNetworkError",{enumerable:!0,get:function(){return x}});Object.defineProperty(exports,"logger",{enumerable:!0,get:function(){return i}});
+${n}`,parameters:{type:"object",properties:{page:{type:"string",description:"The page to navigate to",enum:s}},required:["page"]}})}setContext(t,r){this.contextRegistry.set(t,r),this.notifyContextChanged()}removeContext(t){const r=this.contextRegistry.remove(t);return r&&this.notifyContextChanged(),r}addDynamicContext(t,r){this.contextRegistry.addDynamicProvider(t,r),this.notifyContextChanged()}removeDynamicContext(t){const r=this.contextRegistry.removeDynamicProvider(t);return r&&this.notifyContextChanged(),r}notifyContextChanged(){this.eventEmitter.emit("context:changed",this.contextRegistry.getSnapshot())}enableAutoPageContext(){this.addDynamicContext("browser-page",()=>{const t=typeof window<"u"?window.location.href:void 0,r=typeof document<"u"?document.title:void 0;return!t&&!r?null:{name:"Browser page",description:"Current page the user is viewing",data:{url:t,title:r}}})}getContextSnapshot(){return this.contextRegistry.getSnapshot()}on(t,r){this.eventEmitter.on(t,r)}off(t,r){this.eventEmitter.off(t,r)}once(t,r){this.eventEmitter.once(t,r)}waitFor(t,r){return this.eventEmitter.waitFor(t,r)}updateConfig(t){this.config={...this.config,...t},this.httpClient.updateConfig(t),t.debug!==void 0&&(t.debug?i.enable():i.disable())}destroy(){this.eventEmitter.removeAllListeners(),this.functionRegistry.clear(),this.contextRegistry.clear(),i.log("AgoClient destroyed")}};Object.defineProperty(exports,"AgoApiError",{enumerable:!0,get:function(){return h}});Object.defineProperty(exports,"AgoClient",{enumerable:!0,get:function(){return A}});Object.defineProperty(exports,"AgoError",{enumerable:!0,get:function(){return u}});Object.defineProperty(exports,"AgoFunctionError",{enumerable:!0,get:function(){return f}});Object.defineProperty(exports,"AgoNetworkError",{enumerable:!0,get:function(){return d}});Object.defineProperty(exports,"AgoStreamError",{enumerable:!0,get:function(){return g}});Object.defineProperty(exports,"ClientContextRegistry",{enumerable:!0,get:function(){return v}});Object.defineProperty(exports,"EventEmitter",{enumerable:!0,get:function(){return C}});Object.defineProperty(exports,"FunctionRegistry",{enumerable:!0,get:function(){return y}});Object.defineProperty(exports,"SSEHandler",{enumerable:!0,get:function(){return w}});Object.defineProperty(exports,"isStreamNetworkError",{enumerable:!0,get:function(){return x}});Object.defineProperty(exports,"logger",{enumerable:!0,get:function(){return i}});

package/dist/{AgoClient-BerJvssl.js → AgoClient-rvTz2thR.js}

@@ -22,7 +22,7 @@ var d = class extends Error {
   constructor(e, t, s) {
     super(e, "function_error"), this.functionName = t, this.originalError = s, this.name = "AgoFunctionError";
   }
-}, y = class {
+}, w = class {
   constructor(e = !1) {
     this.enabled = e;
   }
@@ -44,7 +44,7 @@ var d = class extends Error {
   debug(...e) {
     this.enabled && console.debug("[AGO SDK]", ...e);
   }
-}, n = new y(), f = "ago_widget_id";
+}, n = new w(), f = "ago_widget_id";
 function C() {
   if (typeof localStorage < "u") {
     const t = localStorage.getItem(f);
@@ -212,7 +212,7 @@ var E = class {
   clear() {
     this.entries.clear(), this.dynamicProviders.clear(), n.log("ClientContext cleared");
   }
-}, k = class {
+}, S = class {
   constructor(e) {
     this.callbacks = e, this.buffer = "", this.message = {}, this.toolCalls = [], this.sources = [], this.followUpReplies = [], this.isFirstChunk = !0;
   }
@@ -321,7 +321,7 @@ function x(e) {
   const t = e.message.toLowerCase();
   return t.includes("load failed") || t.includes("failed to fetch") || t.includes("network") || t.includes("abort");
 }
-var S = class {
+var k = class {
   constructor() {
     this.handlers = /* @__PURE__ */ new Map();
   }
@@ -364,7 +364,7 @@ var S = class {
   }
 }, $ = class v {
   constructor(t) {
-    this.config = t, this.httpClient = new E(t), this.functionRegistry = new b(), this.contextRegistry = new _(), this.eventEmitter = new S(), t.debug && n.enable(), n.log("AgoClient initialized");
+    this.config = t, this.httpClient = new E(t), this.functionRegistry = new b(), this.contextRegistry = new _(), this.eventEmitter = new k(), t.debug && n.enable(), n.log("AgoClient initialized");
   }
   async sendMessage(t, s) {
     const r = this.functionRegistry.getSchemas(), i = this.contextRegistry.getSnapshot(), o = this.config.agent || this.config.defaultAgentId, a = {
@@ -377,13 +377,13 @@ var S = class {
     if (s?.files && s.files.length > 0) {
       const l = new FormData();
       l.append("content", t), s.conversationId && l.append("conversation_id", s.conversationId), (s.agentId || o) && l.append("agent_id", s.agentId || o || ""), r.length > 0 && l.append("client_functions", JSON.stringify(r)), i && l.append("client_context", JSON.stringify(i));
-      for (const w of s.files) l.append("files", w);
+      for (const y of s.files) l.append("files", y);
       c = await this.httpClient.postFormData("/api/sdk/v1/messages", l);
     } else c = await this.httpClient.postStream("/api/sdk/v1/messages", a);
     return this.processSSEResponse(c);
   }
   async processSSEResponse(t) {
-    return new k({
+    return new S({
       onStart: (s) => {
         this.eventEmitter.emit("message:start", s);
       },
@@ -526,19 +526,24 @@ ${i}`,
     });
   }
   setContext(t, s) {
-    this.contextRegistry.set(t, s);
+    this.contextRegistry.set(t, s), this.notifyContextChanged();
   }
   removeContext(t) {
-    return this.contextRegistry.remove(t);
+    const s = this.contextRegistry.remove(t);
+    return s && this.notifyContextChanged(), s;
   }
   addDynamicContext(t, s) {
-    this.contextRegistry.addDynamicProvider(t, s);
+    this.contextRegistry.addDynamicProvider(t, s), this.notifyContextChanged();
   }
   removeDynamicContext(t) {
-    return this.contextRegistry.removeDynamicProvider(t);
+    const s = this.contextRegistry.removeDynamicProvider(t);
+    return s && this.notifyContextChanged(), s;
+  }
+  notifyContextChanged() {
+    this.eventEmitter.emit("context:changed", this.contextRegistry.getSnapshot());
   }
   enableAutoPageContext() {
-    this.contextRegistry.addDynamicProvider("browser-page", () => {
+    this.addDynamicContext("browser-page", () => {
       const t = typeof window < "u" ? window.location.href : void 0, s = typeof document < "u" ? document.title : void 0;
       return !t && !s ? null : {
         name: "Browser page",
@@ -582,9 +587,9 @@ export {
   g as f,
   x as i,
   d as l,
-  S as n,
+  k as n,
   b as o,
-  k as r,
+  S as r,
   n as s,
   $ as t,
   m as u

package/dist/angular.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./AgoClient-B6PsfMeg.cjs");var n=class{constructor(e){this.client=new o.AgoClient(e),this.messages$=this.fromEvent("message:complete"),this.chunks$=this.fromEvent("message:chunk"),this.errors$=this.fromEvent("message:error"),this.messageStart$=this.fromEvent("message:start")}fromEvent(e){const t=this.client;return{subscribe(i){const s=r=>{i.next?.(r)};return t.on(e,s),{unsubscribe:()=>t.off(e,s)}}}}sendMessage(e,t){return this.client.sendMessage(e,t)}getConversations(){return this.client.getConversations()}getConversation(e){return this.client.getConversation(e)}getMessages(e){return this.client.getMessages(e)}submitToolCallForm(e,t){return this.client.submitToolCallForm(e,t)}confirmToolCall(e){return this.client.confirmToolCall(e)}rejectToolCall(e){return this.client.rejectToolCall(e)}submitFeedback(e,t){return this.client.submitFeedback(e,t)}registerFunction(e,t,i){typeof e=="object"?this.client.registerFunction(e):this.client.registerFunction(e,t,i)}unregisterFunction(e){return this.client.unregisterFunction(e)}registerNavigationFunction(e,t){this.client.registerNavigationFunction(e,t)}on(e,t){this.client.on(e,t)}off(e,t){this.client.off(e,t)}updateConfig(e){this.client.updateConfig(e)}getClient(){return this.client}destroy(){this.client.destroy()}};function c(e){return{provide:n,useValue:new n(e)}}exports.AgoService=n;exports.provideAgo=c;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./AgoClient-D4EL6nva.cjs");var n=class{constructor(e){this.client=new o.AgoClient(e),this.messages$=this.fromEvent("message:complete"),this.chunks$=this.fromEvent("message:chunk"),this.errors$=this.fromEvent("message:error"),this.messageStart$=this.fromEvent("message:start")}fromEvent(e){const t=this.client;return{subscribe(i){const s=r=>{i.next?.(r)};return t.on(e,s),{unsubscribe:()=>t.off(e,s)}}}}sendMessage(e,t){return this.client.sendMessage(e,t)}getConversations(){return this.client.getConversations()}getConversation(e){return this.client.getConversation(e)}getMessages(e){return this.client.getMessages(e)}submitToolCallForm(e,t){return this.client.submitToolCallForm(e,t)}confirmToolCall(e){return this.client.confirmToolCall(e)}rejectToolCall(e){return this.client.rejectToolCall(e)}submitFeedback(e,t){return this.client.submitFeedback(e,t)}registerFunction(e,t,i){typeof e=="object"?this.client.registerFunction(e):this.client.registerFunction(e,t,i)}unregisterFunction(e){return this.client.unregisterFunction(e)}registerNavigationFunction(e,t){this.client.registerNavigationFunction(e,t)}on(e,t){this.client.on(e,t)}off(e,t){this.client.off(e,t)}updateConfig(e){this.client.updateConfig(e)}getClient(){return this.client}destroy(){this.client.destroy()}};function c(e){return{provide:n,useValue:new n(e)}}exports.AgoService=n;exports.provideAgo=c;

package/dist/angular.d.cts

@@ -147,6 +147,13 @@ declare class AgoClient {
      * Remove a dynamic context provider.
      */
     removeDynamicContext(key: string): boolean;
+    /**
+     * Broadcast that the client-side context changed by emitting `context:changed`
+     * with the fresh snapshot. The context-mutating methods call this automatically;
+     * stateful helpers whose context lives in a store (e.g. `createFormCollector`)
+     * call it when their store updates so observers like the dev panel stay live.
+     */
+    notifyContextChanged(): void;
     /**
      * Enable automatic capture of the current browser page (URL + title).
      * Injected as a dynamic context entry named `browser-page`.
@@ -192,6 +199,14 @@ declare class AgoClient {
  * SDK Events
  */
 export declare interface AgoClientEvents {
+    /**
+     * The client-side context changed: a context entry or dynamic provider was
+     * added/removed, or a stateful helper (e.g. `createFormCollector`) updated its
+     * store. Carries the fresh snapshot so observers — notably the dev panel — can
+     * repaint without waiting for the next message. Fires for the form collector's
+     * initial install too, so its missing fields show from the start of a conversation.
+     */
+    "context:changed": ContextSnapshot | null;
     "message:start": {
         conversationId: string;
         messageId: string;

package/dist/angular.d.ts

@@ -147,6 +147,13 @@ declare class AgoClient {
      * Remove a dynamic context provider.
      */
     removeDynamicContext(key: string): boolean;
+    /**
+     * Broadcast that the client-side context changed by emitting `context:changed`
+     * with the fresh snapshot. The context-mutating methods call this automatically;
+     * stateful helpers whose context lives in a store (e.g. `createFormCollector`)
+     * call it when their store updates so observers like the dev panel stay live.
+     */
+    notifyContextChanged(): void;
     /**
      * Enable automatic capture of the current browser page (URL + title).
      * Injected as a dynamic context entry named `browser-page`.
@@ -192,6 +199,14 @@ declare class AgoClient {
  * SDK Events
  */
 export declare interface AgoClientEvents {
+    /**
+     * The client-side context changed: a context entry or dynamic provider was
+     * added/removed, or a stateful helper (e.g. `createFormCollector`) updated its
+     * store. Carries the fresh snapshot so observers — notably the dev panel — can
+     * repaint without waiting for the next message. Fires for the form collector's
+     * initial install too, so its missing fields show from the start of a conversation.
+     */
+    "context:changed": ContextSnapshot | null;
     "message:start": {
         conversationId: string;
         messageId: string;

package/dist/angular.js

@@ -1,4 +1,4 @@
-import { t as o } from "./AgoClient-BerJvssl.js";
+import { t as o } from "./AgoClient-rvTz2thR.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-CLZvxyuu.js → createConversationSession-D9FesBQS.js}

@@ -1,4 +1,4 @@
-import { n as d } from "./createFormCollector-CD1rqRG4.js";
+import { n as d } from "./createFormCollector-BwvkKi48.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-D3K5Gf1k.cjs → createConversationSession-DtaeA418.cjs}

@@ -1 +1 @@
-const d=require("./createFormCollector-D1FfiSgA.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-Wb8Rr-U2.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-CD1rqRG4.js → createFormCollector-BwvkKi48.js}

@@ -1,4 +1,4 @@
-import { s as I } from "./AgoClient-BerJvssl.js";
+import { s as I } from "./AgoClient-rvTz2thR.js";
 function O(u, o) {
   const m = o ? o.storage ?? (typeof localStorage < "u" ? localStorage : void 0) : void 0;
   let c = u;
@@ -7,7 +7,7 @@ function O(u, o) {
     a != null && (c = JSON.parse(a));
   } catch {
   }
-  const r = /* @__PURE__ */ new Set(), h = () => r.forEach((a) => a(c));
+  const r = /* @__PURE__ */ new Set(), p = () => r.forEach((a) => a(c));
   function y() {
     if (o && m) try {
       m.setItem(o.key, JSON.stringify(c));
@@ -17,24 +17,24 @@ function O(u, o) {
   return {
     get: () => c,
     set: (a) => {
-      c = a, y(), h();
+      c = a, y(), p();
     },
     subscribe: (a) => (r.add(a), () => {
       r.delete(a);
     })
   };
 }
-var T = /^[a-zA-Z0-9_-]{1,40}$/;
+var E = /^[a-zA-Z0-9_-]{1,40}$/;
 function M(u) {
   const { name: o, description: m, schema: c } = u;
-  if (!T.test(o)) throw new Error(`Invalid form collector name "${o}": must match ${T} (it becomes the update_/submit_ function names).`);
+  if (!E.test(o)) throw new Error(`Invalid form collector name "${o}": must match ${E} (it becomes the update_/submit_ function names).`);
   const r = typeof u.submit == "string" ? u.submit ? {
     via: "client",
     url: u.submit
-  } : !1 : u.submit ?? !1, h = c.properties ?? {}, y = c.required ?? [], a = (e) => e == null || e === "", p = (e) => y.filter((t) => a(e[t])), v = (e) => {
+  } : !1 : u.submit ?? !1, p = c.properties ?? {}, y = c.required ?? [], a = (e) => e == null || e === "", b = (e) => y.filter((t) => a(e[t])), v = (e) => {
     const t = {};
     for (const [n, s] of Object.entries(e)) {
-      const i = h[n];
+      const i = p[n];
       if (i)
         if (s == null) t[n] = s;
         else if (i.type === "number" || i.type === "integer") {
@@ -43,16 +43,16 @@ function M(u) {
         } else i.type === "boolean" ? t[n] = typeof s == "boolean" ? s : s === "true" ? !0 : s === "false" ? !1 : !!s : t[n] = s;
     }
     return t;
-  }, f = u.initialValues ?? {}, $ = p(f), l = O({
+  }, f = u.initialValues ?? {}, N = b(f), l = O({
     values: f,
-    missing: $,
-    complete: $.length === 0,
+    missing: N,
+    complete: N.length === 0,
     submitted: !1
-  }), C = (e) => {
+  }), $ = (e) => {
     const t = l.get(), n = {
       ...t.values,
       ...e
-    }, s = p(n), i = {
+    }, s = b(n), i = {
       ...t,
       values: n,
       missing: s,
@@ -118,7 +118,7 @@ function M(u) {
       required: []
     },
     handler: (e) => {
-      const t = C(v(e));
+      const t = $(v(e));
       return {
         ok: !0,
         values: t.values,
@@ -126,8 +126,8 @@ function M(u) {
         complete: t.complete
       };
     }
-  }, b = [w];
-  r && b.push({
+  }, h = [w];
+  r && h.push({
     name: `submit_${o}`,
     description: `Submit the completed "${o}" 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: {
@@ -136,27 +136,27 @@ function M(u) {
     },
     handler: () => k()
   });
-  const q = "client__", S = r ? `submit_${o}` : null, x = (e) => {
+  const T = "client__", S = r ? `submit_${o}` : null, q = (e) => {
     const t = e.functionName ?? e.toolName;
     if (t)
-      return t.startsWith(q) ? t.slice(8) : t;
+      return t.startsWith(T) ? t.slice(8) : t;
   }, _ = (e) => {
     let t = { ...f }, n = !1;
     for (const i of e) {
-      const g = x(i);
+      const g = q(i);
       g === w.name ? i.arguments && (t = {
         ...t,
         ...v(i.arguments)
       }) : S && g === S && i.status?.toLowerCase() === "done" && (n = !0);
     }
-    const s = p(t);
+    const s = b(t);
     l.set({
       values: t,
       missing: s,
       complete: s.length === 0,
       submitted: n
     });
-  }, N = `form:${o}`, F = () => {
+  }, C = `form:${o}`, F = () => {
     const e = l.get(), t = r ? ` When all required fields are present and the user confirms, call submit_${o}.` : "";
     return {
       name: `Form: ${o}`,
@@ -168,31 +168,34 @@ function M(u) {
         submitted: e.submitted
       }
     };
-  }, E = (e) => {
+  }, x = (e) => {
     _((e.messages ?? []).flatMap((t) => t.toolCalls ?? []));
   };
   return {
     name: o,
     store: l,
-    functions: b,
-    contextKey: N,
+    functions: h,
+    contextKey: C,
     contextProvider: F,
     install: (e) => {
       d = e;
-      for (const t of b) e.register(t);
-      return e.addDynamicContext(N, F), e.on("conversation:loaded", E), () => {
-        for (const t of b) e.unregisterFunction(t.name);
-        e.removeDynamicContext(N), e.off("conversation:loaded", E), d === e && (d = null);
+      for (const n of h) e.register(n);
+      e.addDynamicContext(C, F);
+      const t = l.subscribe(() => e.notifyContextChanged());
+      return e.on("conversation:loaded", x), () => {
+        t();
+        for (const n of h) e.unregisterFunction(n.name);
+        e.removeDynamicContext(C), e.off("conversation:loaded", x), d === e && (d = null);
       };
     },
     hydrate: _,
     submit: k,
     getValues: () => l.get().values,
     setValues: (e) => {
-      C(v(e));
+      $(v(e));
     },
     reset: () => {
-      const e = p(f);
+      const e = b(f);
       l.set({
         values: f,
         missing: e,

package/dist/createFormCollector-Wb8Rr-U2.cjs

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

package/dist/{createMockClient-tVsApEAh.js → createMockClient-DwdxNwEn.js}

@@ -1,4 +1,4 @@
-function w(g = {}) {
+function C(g = {}) {
   const { overrides: m = {} } = g, d = {
     id: "mock-msg-1",
     conversationId: "mock-conv-1",
@@ -28,6 +28,8 @@ function w(g = {}) {
     unregisterFunction: () => !0,
     getRegisteredFunctions: () => [],
     getContextSnapshot: () => null,
+    notifyContextChanged: () => {
+    },
     registerNavigationFunction: () => {
     },
     on: (e, o) => {
@@ -68,5 +70,5 @@ function w(g = {}) {
   }, n;
 }
 export {
-  w as t
+  C as t
 };

package/dist/createMockClient-zHQ0cjUH.cjs

@@ -0,0 +1 @@
+function C(g={}){const{overrides:u={}}=g,d={id:"mock-msg-1",conversationId:"mock-conv-1",content:"Mock response",role:"assistant",status:"DONE",createdAt:new Date},l={id:"mock-conv-1",title:"Mock Conversation",lastMessageDate:new Date},t=new Map,r=[],m={sendMessage:async()=>d,getConversations:async()=>[l],getConversation:async()=>l,getMessages:async()=>[d],submitToolCallForm:async()=>{},confirmToolCall:async()=>{},rejectToolCall:async()=>{},submitFeedback:async()=>{},registerFunction:()=>{},unregisterFunction:()=>!0,getRegisteredFunctions:()=>[],getContextSnapshot:()=>null,notifyContextChanged:()=>{},registerNavigationFunction:()=>{},on:(e,o)=>{t.has(e)||t.set(e,new Set),t.get(e).add(o)},off:(e,o)=>{t.get(e)?.delete(o)},once:(e,o)=>{const n=(...i)=>{t.get(e)?.delete(n),o(...i)};t.has(e)||t.set(e,new Set),t.get(e).add(n)},waitFor:(e,o)=>new Promise((n,i)=>{let a;const c=f=>{a&&clearTimeout(a),t.get(e)?.delete(c),n(f)};t.has(e)||t.set(e,new Set),t.get(e).add(c),o?.timeout&&(a=setTimeout(()=>{t.get(e)?.delete(c),i(new Error(`waitFor("${e}") timed out after ${o.timeout}ms`))},o.timeout))}),updateConfig:()=>{},destroy:()=>{t.clear()},...u},s={};for(const[e,o]of Object.entries(m))s[e]=(...n)=>(r.push({method:e,args:n}),o(...n));return s.__calls=r,s.__callsFor=e=>r.filter(o=>o.method===e),s.__emitEvent=(e,o)=>{const n=t.get(e);n&&[...n].forEach(i=>i(o))},s}Object.defineProperty(exports,"createMockClient",{enumerable:!0,get:function(){return C}});

package/dist/devtools.cjs

@@ -1,17 +1,17 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var r,d,v=()=>({});function c(){r&&(r.textContent=JSON.stringify(v(),null,2))}function p(a,o){if(!d)return;const e=document.createElement("div");e.className=`dev-log-line dev-log-${o}`,e.textContent=`${new Date().toLocaleTimeString()}  ${a}`,d.appendChild(e),d.scrollTop=d.scrollHeight}var x="ago_dev_panel_collapsed";function i(a,o){a.classList.toggle("collapsed",o);const e=a.querySelector(".dev-toggle");e&&(e.textContent=o?"▢":"—",e.title=o?"Expand dev tools":"Collapse dev tools",e.setAttribute("aria-expanded",String(!o)));try{localStorage.setItem(x,o?"1":"0")}catch{}}function f(a){const{client:o,target:e}=a;v=()=>o.getContextSnapshot()?.entries??{},b();const u=typeof e=="string"?document.querySelector(e):e instanceof Element?e:document.body,t=document.createElement("aside");t.id="ago-dev-panel",(u??document.body).appendChild(t),t.innerHTML=`
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var c,d,v=()=>({});function i(){c&&(c.textContent=JSON.stringify(v(),null,2))}function s(l,e){if(!d)return;const o=document.createElement("div");o.className=`dev-log-line dev-log-${e}`,o.textContent=`${new Date().toLocaleTimeString()}  ${l}`,d.appendChild(o),d.scrollTop=d.scrollHeight}var x="ago_dev_panel_collapsed";function r(l,e){l.classList.toggle("collapsed",e);const o=l.querySelector(".dev-toggle");o&&(o.textContent=e?"▢":"—",o.title=e?"Expand dev tools":"Collapse dev tools",o.setAttribute("aria-expanded",String(!e)));try{localStorage.setItem(x,e?"1":"0")}catch{}}function h(l){const{client:e,target:o}=l;v=()=>e.getContextSnapshot()?.entries??{},b();const u=typeof o=="string"?document.querySelector(o):o instanceof Element?o:document.body,t=document.createElement("aside");t.id="ago-dev-panel",(u??document.body).appendChild(t),t.innerHTML=`
     <div class="dev-head">
       <span class="dev-badge">DEV</span>
       <span class="dev-title">DEV TOOLS · client-side function state — not for production</span>
       <button type="button" class="dev-toggle" aria-label="Toggle dev tools">—</button>
     </div>
     <div class="dev-body">
-      <div class="dev-fns">Registered functions: <code>${(o.getRegisteredFunctions?.()??[]).map(n=>n.name).join(", ")||"—"}</code></div>
+      <div class="dev-fns">Registered functions: <code>${(e.getRegisteredFunctions?.()??[]).map(a=>a.name).join(", ")||"—"}</code></div>
       <div class="dev-section-label">JSON object (built by the agent)</div>
       <pre class="dev-state" id="ago-dev-state"></pre>
       <div class="dev-section-label">Function calls</div>
       <div class="dev-log" id="ago-dev-log"></div>
     </div>
-  `,r=t.querySelector("#ago-dev-state"),d=t.querySelector("#ago-dev-log"),t.querySelector(".dev-toggle")?.addEventListener("click",n=>{n.stopPropagation(),i(t,!t.classList.contains("collapsed"))}),t.addEventListener("click",()=>{t.classList.contains("collapsed")&&i(t,!1)});let s=!1;try{s=localStorage.getItem(x)==="1"}catch{}i(t,s),o.on("function:invoke",({functionName:n,arguments:l})=>{p(`→ ${n}(${JSON.stringify(l??{})})`,"invoke")}),o.on("function:result",({result:n,error:l})=>{p(l?`✗ error: ${l}`:`← ${JSON.stringify(n)}`,l?"error":"result"),c()}),c()}var g="ago-dev-panel-styles";function b(){if(document.getElementById(g))return;const a=document.createElement("style");a.id=g,a.textContent=h,document.head.appendChild(a)}var h=`
+  `,c=t.querySelector("#ago-dev-state"),d=t.querySelector("#ago-dev-log"),t.querySelector(".dev-toggle")?.addEventListener("click",a=>{a.stopPropagation(),r(t,!t.classList.contains("collapsed"))}),t.addEventListener("click",()=>{t.classList.contains("collapsed")&&r(t,!1)});let p=!1;try{p=localStorage.getItem(x)==="1"}catch{}r(t,p),e.on("function:invoke",({functionName:a,arguments:n})=>{s(`→ ${a}(${JSON.stringify(n??{})})`,"invoke")}),e.on("function:result",({result:a,error:n})=>{s(n?`✗ error: ${n}`:`← ${JSON.stringify(a)}`,n?"error":"result"),i()}),e.on("context:changed",i),e.on("conversation:loaded",a=>{const n=(a.messages??[]).flatMap(f=>f.toolCalls??[]);s(`⟳ hydrated "${a.title||a.id}" — replayed ${n.length} tool call${n.length===1?"":"s"}`,"hydrate"),i()}),i()}var g="ago-dev-panel-styles";function b(){if(document.getElementById(g))return;const l=document.createElement("style");l.id=g,l.textContent=m,document.head.appendChild(l)}var m=`
 #ago-dev-panel {
   position: fixed;
   top: 16px;
@@ -105,4 +105,5 @@ Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var r,d,v=()=
 #ago-dev-panel .dev-log-invoke { color: #9ecbff; }
 #ago-dev-panel .dev-log-result { color: #86efac; }
 #ago-dev-panel .dev-log-error { color: #fca5a5; }
-`;exports.initDevPanel=f;
+#ago-dev-panel .dev-log-hydrate { color: #d8b4fe; }
+`;exports.initDevPanel=h;

package/dist/devtools.d.cts

@@ -147,6 +147,13 @@ declare class AgoClient {
      * Remove a dynamic context provider.
      */
     removeDynamicContext(key: string): boolean;
+    /**
+     * Broadcast that the client-side context changed by emitting `context:changed`
+     * with the fresh snapshot. The context-mutating methods call this automatically;
+     * stateful helpers whose context lives in a store (e.g. `createFormCollector`)
+     * call it when their store updates so observers like the dev panel stay live.
+     */
+    notifyContextChanged(): void;
     /**
      * Enable automatic capture of the current browser page (URL + title).
      * Injected as a dynamic context entry named `browser-page`.
@@ -192,6 +199,14 @@ declare class AgoClient {
  * SDK Events
  */
 declare interface AgoClientEvents {
+    /**
+     * The client-side context changed: a context entry or dynamic provider was
+     * added/removed, or a stateful helper (e.g. `createFormCollector`) updated its
+     * store. Carries the fresh snapshot so observers — notably the dev panel — can
+     * repaint without waiting for the next message. Fires for the form collector's
+     * initial install too, so its missing fields show from the start of a conversation.
+     */
+    "context:changed": ContextSnapshot | null;
     "message:start": {
         conversationId: string;
         messageId: string;

package/dist/devtools.d.ts

@@ -147,6 +147,13 @@ declare class AgoClient {
      * Remove a dynamic context provider.
      */
     removeDynamicContext(key: string): boolean;
+    /**
+     * Broadcast that the client-side context changed by emitting `context:changed`
+     * with the fresh snapshot. The context-mutating methods call this automatically;
+     * stateful helpers whose context lives in a store (e.g. `createFormCollector`)
+     * call it when their store updates so observers like the dev panel stay live.
+     */
+    notifyContextChanged(): void;
     /**
      * Enable automatic capture of the current browser page (URL + title).
      * Injected as a dynamic context entry named `browser-page`.
@@ -192,6 +199,14 @@ declare class AgoClient {
  * SDK Events
  */
 declare interface AgoClientEvents {
+    /**
+     * The client-side context changed: a context entry or dynamic provider was
+     * added/removed, or a stateful helper (e.g. `createFormCollector`) updated its
+     * store. Carries the fresh snapshot so observers — notably the dev panel — can
+     * repaint without waiting for the next message. Fires for the form collector's
+     * initial install too, so its missing fields show from the start of a conversation.
+     */
+    "context:changed": ContextSnapshot | null;
     "message:start": {
         conversationId: string;
         messageId: string;