@useago/sdk 1.3.2 → 1.4.0

package/README.md

@@ -92,6 +92,46 @@ guards, auth and layouts keep working exactly as they do today.
 `react-router-dom` here is *your* router, not an SDK dependency:
 `useAgoNavigation` accepts any `(path: string) => void` function.
 
+## Let the agent change the page
+
+The mirror of navigation. Same idea, applied to the page the user is already on:
+describe its editable state (filters, sort, view mode…) and *"show me only the
+overdue ones, newest first"* actually updates the view. The agent also reads the
+current state, so it knows what to change.
+
+```tsx
+import { useAgoPageState } from "@useago/sdk/react";
+
+function InvoiceList() {
+  const [status, setStatus] = useState("all");
+  const [sort, setSort] = useState("newest");
+
+  useAgoPageState([
+    {
+      name: "statusFilter",
+      description: "Filter invoices by status",
+      schema: { type: "string", enum: ["all", "paid", "overdue"] },
+      get: () => status,   // current value → the agent sees it
+      set: setStatus,      // the agent changes it
+    },
+    {
+      name: "sort",
+      description: "Sort order of the list",
+      schema: { type: "string", enum: ["newest", "oldest"] },
+      get: () => sort,
+      set: setSort,
+    },
+  ]);
+
+  return /* your existing list, driven by status + sort */;
+}
+```
+
+Each control becomes one optional property of a single `setPageState` function,
+so the agent changes only what the user asked for. The current value from each
+`get()` is sent with every message, so the agent knows the state before it
+changes it. Vue and Angular have the same helper.
+
 ## Turn a JavaScript function into an agent tool
 
 Keep your application logic as a regular JavaScript function, then describe its
@@ -215,6 +255,7 @@ react-router navigation), Vue, Angular, plain TypeScript, and no-build HTML.
 - [**Events & streaming**](docs/general/events-and-streaming.md): low-level hooks into the message stream
 - [**Testing**](docs/general/testing.md): mock client for unit tests
 - [**Configuration & auth**](docs/general/configuration.md): every `AgoConfig` option, headers, errors
+- [**Custom domain (reverse proxy)**](docs/general/custom-domain.md): serve AGO from your own domain, same-origin
 
 Full documentation: [ago.mintlify.app](https://ago.mintlify.app/)
 

package/dist/AgoClient-B2BU8tfB.cjs

@@ -0,0 +1,8 @@
+var h=class extends Error{constructor(e,t,n){super(e),this.code=t,this.statusCode=n,this.name="AgoError"}},u=class E extends h{constructor(t,n,r,s,i,o){super(t,n,r),this.type=s,this.param=i,this.docUrl=o,this.name="AgoApiError"}static fromResponse(t,n){const r=t.error;return new E(r.doc_url?`${r.message} See ${r.doc_url}`:r.message,r.code,n,r.type,r.param,r.doc_url)}},m=class extends h{constructor(e,t){super(e,"network_error"),this.originalError=t,this.name="AgoNetworkError"}},f=class extends h{constructor(e,t="stream_error"){super(e,t),this.name="AgoStreamError"}},g=class extends h{constructor(e,t,n){super(e,"function_error"),this.functionName=t,this.originalError=n,this.name="AgoFunctionError"}},R=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)}},a=new R,v="ago_widget_id";function x(){if(typeof localStorage<"u"){const t=localStorage.getItem(v);if(t)return t}const e=typeof crypto<"u"&&typeof crypto.randomUUID=="function"?crypto.randomUUID():`ago-${Date.now().toString(36)}-${Math.random().toString(36).slice(2,12)}`;if(typeof localStorage<"u")try{localStorage.setItem(v,e)}catch{}return e}var I=class{constructor(e){this.baseUrl=e.baseUrl.replace(/\/$/,""),this.headers={"X-User-Anon-Id":e.widgetId||x()},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-User-Anon-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 n=`${this.baseUrl}${e}`;a.debug("POST (stream)",n,t);try{const r=await fetch(n,{method:"POST",headers:{...this.headers,"Content-Type":"application/json"},body:t?JSON.stringify(t):void 0});return r.ok||await this.handleErrorResponse(r),r}catch(r){throw r instanceof u?r:new m(`Network error: ${r instanceof Error?r.message:"Unknown error"}. Check that \`baseUrl\` is reachable and includes the protocol (https://).`,r instanceof Error?r:void 0)}}async postFormData(e,t){const n=`${this.baseUrl}${e}`;a.debug("POST (formData)",n);const r={...this.headers};try{const s=await fetch(n,{method:"POST",headers:r,body:t});return s.ok||await this.handleErrorResponse(s),s}catch(s){throw s instanceof u?s:new m(`Network error: ${s instanceof Error?s.message:"Unknown error"}. Check that \`baseUrl\` is reachable and includes the protocol (https://).`,s instanceof Error?s:void 0)}}async request(e,t,n){const r=`${this.baseUrl}${t}`;a.debug(e,r,n);try{const s=await fetch(r,{method:e,headers:{...this.headers,"Content-Type":"application/json"},body:n?JSON.stringify(n):void 0});return s.ok||await this.handleErrorResponse(s),s.status===204?void 0:s.json()}catch(s){throw s instanceof u?s:new m(`Network error: ${s instanceof Error?s.message:"Unknown error"}. Check that \`baseUrl\` is reachable and includes the protocol (https://).`,s instanceof Error?s:void 0)}}async handleErrorResponse(e){let t;try{t=await e.json()}catch{}if(t?.error)throw u.fromResponse(t,e.status);let n="";throw e.status===401||e.status===403?n=" Check `userJwt` (and that it has not expired).":e.status===404&&(n=" Check that `baseUrl` points at your AGO API root."),new u(`HTTP ${e.status}: ${e.statusText}.${n}`,"http_error",e.status,"api_error")}},_=class{constructor(){this.functions=new Map}register(e,t,n){if(typeof e=="object"){const{name:s,handler:i,description:o,parameters:l}=e;return this.register(s,i,{description:o,parameters:l})}const r=e;if(!t||!n)throw new h(`registerFunction("${r}"): both a handler and a schema are required. Pass them as arguments or use the single-object form: registerFunction({ name, parameters, handler }).`,"function_invalid_registration");this.functions.has(r)&&a.warn(`Function "${r}" is being overwritten`),this.functions.set(r,{schema:{...n,name:r},handler:t}),a.log(`Registered function: ${r}`)}unregister(e){const t=this.functions.delete(e);return t&&a.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 n=this.functions.get(e);if(!n)throw new g(`Function "${e}" is not registered`,e);a.log(`Executing function: ${e}`,t);try{const r=await n.handler(t);return a.log(`Function ${e} completed:`,r),r}catch(r){throw a.error(`Function ${e} failed:`,r),new g(`Function "${e}" execution failed: ${r instanceof Error?r.message:"Unknown error"}`,e,r instanceof Error?r:void 0)}}clear(){this.functions.clear(),a.log("Cleared all registered functions")}get size(){return this.functions.size}},S=class{constructor(){this.entries=new Map,this.dynamicProviders=new Map}set(e,t){this.entries.set(e,t),a.log(`ClientContext set: ${e}`)}remove(e){const t=this.entries.delete(e);return t&&a.log(`ClientContext removed: ${e}`),t}addDynamicProvider(e,t){this.dynamicProviders.set(e,t),a.log(`DynamicContext provider added: ${e}`)}removeDynamicProvider(e){const t=this.dynamicProviders.delete(e);return t&&a.log(`DynamicContext provider removed: ${e}`),t}getSnapshot(){if(this.entries.size===0&&this.dynamicProviders.size===0)return null;const e={};for(const[t,n]of this.entries)e[t]=n;for(const[t,n]of this.dynamicProviders)try{const r=n();r&&(e[t]=r)}catch(r){a.error(`DynamicContext provider "${t}" threw:`,r)}return Object.keys(e).length===0?null:{entries:e}}clear(){this.entries.clear(),this.dynamicProviders.clear(),a.log("ClientContext cleared")}};function p(e){return e===null||typeof e!="object"?JSON.stringify(e)??"null":Array.isArray(e)?`[${e.map(p).join(",")}]`:`{${Object.keys(e).sort().map(t=>`${JSON.stringify(t)}:${p(e[t])}`).join(",")}}`}var k=class{constructor(e){this.callbacks=e,this.buffer="",this.message={},this.toolCalls=[],this.sources=[],this.followUpReplies=[],this.isFirstChunk=!0,this.answerCompleteEmitted=!1,this.firedClientFunctions=new Set}async processStream(e){if(!e.body)throw new f("Response has no body. The endpoint did not return a stream: check that `baseUrl` points at an AGO API and nothing (proxy, mock) strips the SSE body.","stream_no_body");const t=e.body.getReader(),n=new TextDecoder;try{for(;;){const{done:r,value:s}=await t.read();if(r)break;const i=n.decode(s,{stream:!0});this.buffer+=i,this.processBuffer()}return this.buffer.trim()&&this.processBuffer(),this.buildFinalMessage()}catch(r){const s=r instanceof Error?r:new f("Stream processing failed mid-flight. The connection may have dropped; retry the message.");throw this.callbacks.onError?.(s),s}finally{t.releaseLock()}}processBuffer(){const e=this.buffer.split(`
+
+`);this.buffer=e.pop()||"";for(const t of e){if(!t.trim())continue;const n=t.split(`
+`);for(const r of n)if(!r.startsWith(": ")&&r.startsWith("data: ")){const s=r.slice(6);try{const i=JSON.parse(s);this.handleChunk(i)}catch(i){a.warn("Failed to parse SSE data:",s,i)}}}}handleChunk(e){if(this.callbacks.onRawChunk?.(e),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 n=t.knowledge_document;return{id:n.id,title:n.title,url:n.use_external_link?n.external_link_url:n.internal_link_url}})),e.type==="client_function"&&e.function_name){const t=`${e.function_name}::${p(e.arguments??{})}`;this.firedClientFunctions.has(t)||(this.firedClientFunctions.add(t),this.callbacks.onClientFunction?.({invocationId:e.id||"",functionName:e.function_name,arguments:e.arguments||{},conversationId:this.message.conversationId||""}))}if(e.tool_call_data&&e.type&&e.type!=="client_function"){const t=this.parseToolCall(e);this.callbacks.onToolCall?.(t);const n=this.toolCalls.findIndex(r=>r.id===t.id);n>=0?this.toolCalls[n]=t:this.toolCalls.push(t)}e.follow_up_replies&&(this.followUpReplies=e.follow_up_replies),this.message.status==="DONE"&&!this.answerCompleteEmitted&&this.message.id&&(this.answerCompleteEmitted=!0,this.callbacks.onAnswerComplete?.(this.buildMessage()))}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}}buildMessage(){return{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}}buildFinalMessage(){const e=this.buildMessage();return this.callbacks.onComplete?.(e),e}};function U(e){const t=e.message.toLowerCase();return t.includes("load failed")||t.includes("failed to fetch")||t.includes("network")||t.includes("abort")}var P=new Set(["image/jpeg","image/png","image/gif","image/webp","image/bmp","image/tiff"]);function A(e){if(!e)return;const t=typeof window<"u"&&window.location?window.location.href:"https://ago.local/";try{const n=new URL(e,t);if(n.protocol==="http:"||n.protocol==="https:"||n.protocol==="blob:")return e}catch{}}function O(e){return e.isSafeImage===!0&&typeof e.contentType=="string"&&e.contentType.startsWith("image/")&&A(e.url)!==void 0}function j(e){if(e==null||e<0)return"";if(e<1024)return`${e} B`;const t=e/1024;return t<1024?`${t.toFixed(1)} KB`:`${(t/1024).toFixed(1)} MB`}function N(e){return{id:String(e.id??""),name:typeof e.name=="string"&&e.name?e.name:"file",contentType:typeof e.content_type=="string"?e.content_type:void 0,fileSize:typeof e.file_size=="number"?e.file_size:void 0,url:typeof e.file_url=="string"?e.file_url:void 0,isSafeImage:e.is_safe_image===!0}}function T(e){return e.map((t,n)=>({id:`local-${n}-${t.name}`,name:t.name,contentType:t.type||void 0,fileSize:t.size,url:typeof URL<"u"&&URL.createObjectURL?URL.createObjectURL(t):void 0,isSafeImage:P.has(t.type)}))}var $=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 n=this.handlers.get(e);n&&n.delete(t)}emit(e,t){const n=this.handlers.get(e);n&&n.forEach(r=>{try{r(t)}catch(s){console.error(`Error in event handler for ${String(e)}:`,s)}})}once(e,t){const n=(r=>{this.off(e,n),t(r)});this.on(e,n)}waitFor(e,t){return new Promise((n,r)=>{let s;const i=(o=>{s&&clearTimeout(s),n(o)});this.once(e,i),t?.timeout&&(s=setTimeout(()=>{this.off(e,i),r(new Error(`waitFor("${String(e)}") timed out after ${t.timeout}ms`))},t.timeout))})}removeAllListeners(e){e?this.handlers.delete(e):this.handlers.clear()}},b='`baseUrl` is required, e.g. new AgoClient({ baseUrl: "https://YOUR-DOMAIN.api.useago.com" }). Try the live demo endpoint https://playground.api.useago.com. See docs/general/configuration.md#error-codes (config_missing_base_url).',D=/^[a-z][a-z0-9+.-]*:\/\//i,C=!1;function y(e,t="AgoClient"){if(typeof e!="object"||e===null)throw new h(`${t}: ${b}`,"config_missing_base_url");const n=e.baseUrl;if(typeof n!="string"||n.trim()==="")throw new h(`${t}: ${b}`,"config_missing_base_url");!n.startsWith("/")&&!D.test(n)&&(C||(C=!0,console.warn(`[AGO] ${t}: \`baseUrl\` has no protocol and is not a relative path (config_suspect_base_url). Requests will fail: Node throws a URL parse error, browsers fetch it as a relative path. Use "https://..." (or a "/path" for a same-origin proxy).`)))}var M=class F{constructor(t){this.warnedEmptyConversations=new Set,y(t,"AgoClient"),this.config=t,this.httpClient=new I(t),this.functionRegistry=new _,this.contextRegistry=new S,this.eventEmitter=new $,t.debug&&a.enable(),a.log("AgoClient initialized")}async sendMessage(t,n){const r=this.functionRegistry.getSchemas(),s=this.contextRegistry.getSnapshot(),i=this.config.agent||this.config.defaultAgentId,o={content:t,conversation_id:n?.conversationId,agent_id:n?.agentId||i};r.length>0&&(o.client_functions=r),s&&(o.client_context=s),n?.hidden&&(o.hidden=!0);let l;if(n?.files&&n.files.length>0){const c=new FormData;c.append("content",t),n.conversationId&&c.append("conversation_id",n.conversationId),(n.agentId||i)&&c.append("agent_id",n.agentId||i||""),r.length>0&&c.append("client_functions",JSON.stringify(r)),s&&c.append("client_context",JSON.stringify(s)),n.hidden&&c.append("hidden","true");for(const d of n.files)c.append("files",d);l=await this.httpClient.postFormData("/api/sdk/v1/messages",c)}else l=await this.httpClient.postStream("/api/sdk/v1/messages",o);return this.processSSEResponse(l)}async processSSEResponse(t){let n=!1;const r=await new k({onRawChunk:s=>{this.eventEmitter.emit("stream:message",s)},onStart:s=>{this.eventEmitter.emit("message:start",s)},onChunk:s=>{this.eventEmitter.emit("message:chunk",s)},onToolCall:s=>{this.eventEmitter.emit("toolCall:received",s),s.type==="form"&&this.eventEmitter.emit("toolCall:form",s)},onClientFunction:async s=>{n=!0,this.eventEmitter.emit("function:invoke",s),await this.handleClientFunctionInvocation(s)},onAnswerComplete:s=>{this.eventEmitter.emit("message:answer-complete",s)},onComplete:s=>{this.eventEmitter.emit("message:complete",s)},onError:s=>{this.eventEmitter.emit("message:error",{error:s.message,code:s instanceof h?s.code:void 0})}}).processStream(t);return this.maybeFlagEmptyReply(r,n),r}maybeFlagEmptyReply(t,n){t.status==="DONE"&&(t.content??"").trim()===""&&!n&&!(t.toolCalls&&t.toolCalls.length>0)&&!(t.followUpReplies&&t.followUpReplies.length>0)&&setTimeout(()=>{if(this.eventEmitter.emit("message:empty",{conversationId:t.conversationId??"",messageId:t.id??""}),this.config.warnOnEmptyReply===!1)return;const r=t.conversationId||"(no conversation)";if(this.warnedEmptyConversations.has(r))return;this.warnedEmptyConversations.add(r);const s=this.config.agent||this.config.defaultAgentId;t.id?console.warn("[AGO] Reply completed with empty content. Possible causes: "+(s?`the agent "${s}" may not exist for this tenant, `:"an unknown `agent` slug, ")+"or the agent replied with no text. Listen for the `message:empty` event to handle this in your app; silence this warning with `warnOnEmptyReply: false`."):console.warn("[AGO] The stream completed without any message data. Possible causes: "+(s?`the agent "${s}" may not exist for this tenant, or `:"")+"`baseUrl` does not point at an AGO endpoint that returns server-sent events. Listen for the `message:empty` event to handle this in your app; silence this warning with `warnOnEmptyReply: false`.")},0)}async handleClientFunctionInvocation(t){let n,r;try{n=await this.functionRegistry.execute(t.functionName,t.arguments)}catch(s){r=s instanceof Error?s.message:"Unknown error",a.error("Client function execution failed:",s)}if(t.invocationId)try{await this.submitToolCallForm(t.invocationId,{result:n,error:r,_type:"client_function_result"})}catch(s){a.error("Failed to submit function result:",s)}this.eventEmitter.emit("function:result",{invocationId:t.invocationId,result:n,error:r})}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 n=await this.httpClient.get(`/api/sdk/v1/conversations/${t}`),r={id:n.id,title:n.title,lastMessageDate:new Date(n.last_message_date),messages:n.messages.map(s=>({id:s.id,conversationId:n.id,content:s.content,role:s.role,status:s.status,createdAt:new Date(s.created_at),hidden:s.hidden,toolCalls:F.mapPersistedToolCalls(s.tool_call_data),attachments:s.attachments&&s.attachments.length>0?s.attachments.map(N):void 0}))};return this.eventEmitter.emit("conversation:loaded",r),r}static mapPersistedToolCalls(t){if(!(!t||t.length===0))return t.map(n=>({id:String(n.id??""),type:n.type??"status_message",status:String(n.status??"unknown"),toolName:n.tool_name??"",toolDisplayName:n.tool_display_name,message:n.message,formSchema:n.form_schema,data:n.data,functionName:n.function_name,arguments:n.arguments}))}async getMessages(t){return(await this.getConversation(t)).messages||[]}async submitToolCallForm(t,n){await this.httpClient.post(`/api/sdk/v1/tool-calls/${t}/submit`,{formData:n})}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 getFormCollector(t){const n=await this.httpClient.get(`/api/sdk/v1/forms/${encodeURIComponent(t)}`);return{name:n.name,description:n.description,schema:n.schema,submit:n.submit??void 0}}async submitFormCollector(t,n){return this.httpClient.post("/api/sdk/v1/forms/submit",{name:t,values:n})}async submitFeedback(t,n){await this.httpClient.post(`/api/sdk/v1/messages/${t}/feedback`,{rating:n})}registerFunction(t,n,r){typeof t=="object"?this.functionRegistry.register(t):this.functionRegistry.register(t,n,r)}register(t){if(Array.isArray(t))for(const n of t)this.functionRegistry.register(n);else this.functionRegistry.register(t)}unregisterFunction(t){return this.functionRegistry.unregister(t)}getRegisteredFunctions(){return this.functionRegistry.getSchemas()}registerNavigationFunction(t,n){const r=n.map(i=>i.name),s=n.map(i=>`- "${i.name}": ${i.description}`).join(`
+`);this.registerFunction("navigateToPage",async i=>{const o=i.page,l=n.find(c=>c.name===o);return l?(t(l.path),{success:!0,navigatedTo:l.path}):{success:!1,error:`Unknown page: ${o}`}},{description:`Navigate the user to a page in the application. Available pages:
+${s}`,parameters:{type:"object",properties:{page:{type:"string",description:"The page to navigate to",enum:r}},required:["page"]}})}registerPageStateFunction(t,n){const r=n?.functionName??"setPageState",s=new Map(t.map(o=>[o.name,o])),i=t.map(o=>`- "${o.name}": ${o.description}`).join(`
+`);this.registerFunction(r,async o=>{const l={};for(const[c,d]of Object.entries(o)){if(d===void 0)continue;const w=s.get(c);w&&(await w.set(d),l[c]=d)}return{success:!0,applied:l}},{description:`Change the state of the current page. Set ONLY the controls the user explicitly asked for; leave the others unset. Available controls:
+${i}`,parameters:{type:"object",properties:Object.fromEntries(t.map(o=>[o.name,{...o.schema,description:o.description}]))}}),this.addDynamicContext(`page-state:${r}`,()=>{const o=t.filter(c=>typeof c.get=="function");if(o.length===0)return null;const l={};for(const c of o)l[c.name]=c.get();return{name:"Page state",description:"Current, editable state of the page the user is viewing.",data:l}})}unregisterPageStateFunction(t){const n=t??"setPageState";this.unregisterFunction(n),this.removeDynamicContext(`page-state:${n}`)}setContext(t,n){this.contextRegistry.set(t,n),this.notifyContextChanged()}removeContext(t){const n=this.contextRegistry.remove(t);return n&&this.notifyContextChanged(),n}addDynamicContext(t,n){this.contextRegistry.addDynamicProvider(t,n),this.notifyContextChanged()}removeDynamicContext(t){const n=this.contextRegistry.removeDynamicProvider(t);return n&&this.notifyContextChanged(),n}notifyContextChanged(){this.eventEmitter.emit("context:changed",this.contextRegistry.getSnapshot())}emitFormEvent(t,n){this.eventEmitter.emit(t,n)}enableAutoPageContext(){this.addDynamicContext("browser-page",()=>{const t=typeof window<"u"?window.location.href:void 0,n=typeof document<"u"?document.title:void 0;return!t&&!n?null:{name:"Browser page",description:"Current page the user is viewing",data:{url:t,title:n}}})}getContextSnapshot(){return this.contextRegistry.getSnapshot()}on(t,n){this.eventEmitter.on(t,n)}off(t,n){this.eventEmitter.off(t,n)}once(t,n){this.eventEmitter.once(t,n)}waitFor(t,n){return this.eventEmitter.waitFor(t,n)}updateConfig(t){const n={};for(const[s,i]of Object.entries(t))i!==void 0&&(n[s]=i);const r={...this.config,...n};y(r,"AgoClient.updateConfig"),this.config=r,this.httpClient.updateConfig(n),n.debug!==void 0&&(n.debug?a.enable():a.disable())}destroy(){this.eventEmitter.removeAllListeners(),this.functionRegistry.clear(),this.contextRegistry.clear(),a.log("AgoClient destroyed")}};Object.defineProperty(exports,"AgoApiError",{enumerable:!0,get:function(){return u}});Object.defineProperty(exports,"AgoClient",{enumerable:!0,get:function(){return M}});Object.defineProperty(exports,"AgoError",{enumerable:!0,get:function(){return h}});Object.defineProperty(exports,"AgoFunctionError",{enumerable:!0,get:function(){return g}});Object.defineProperty(exports,"AgoNetworkError",{enumerable:!0,get:function(){return m}});Object.defineProperty(exports,"AgoStreamError",{enumerable:!0,get:function(){return f}});Object.defineProperty(exports,"ClientContextRegistry",{enumerable:!0,get:function(){return S}});Object.defineProperty(exports,"EventEmitter",{enumerable:!0,get:function(){return $}});Object.defineProperty(exports,"FunctionRegistry",{enumerable:!0,get:function(){return _}});Object.defineProperty(exports,"SSEHandler",{enumerable:!0,get:function(){return k}});Object.defineProperty(exports,"attachmentsFromFiles",{enumerable:!0,get:function(){return T}});Object.defineProperty(exports,"canInlineImage",{enumerable:!0,get:function(){return O}});Object.defineProperty(exports,"formatFileSize",{enumerable:!0,get:function(){return j}});Object.defineProperty(exports,"isStreamNetworkError",{enumerable:!0,get:function(){return U}});Object.defineProperty(exports,"logger",{enumerable:!0,get:function(){return a}});Object.defineProperty(exports,"safeAttachmentUrl",{enumerable:!0,get:function(){return A}});Object.defineProperty(exports,"validateConfig",{enumerable:!0,get:function(){return y}});

package/dist/{AgoClient-Cwx_eYSu.js → AgoClient-BrhKkDWt.js}

@@ -2,27 +2,27 @@ var h = class extends Error {
   constructor(e, t, s) {
     super(e), this.code = t, this.statusCode = s, this.name = "AgoError";
   }
-}, d = class C extends h {
-  constructor(t, s, i, n, r, a) {
-    super(t, s, i), this.type = n, this.param = r, this.docUrl = a, this.name = "AgoApiError";
+}, u = class E extends h {
+  constructor(t, s, i, n, r, o) {
+    super(t, s, i), this.type = n, this.param = r, this.docUrl = o, this.name = "AgoApiError";
   }
   static fromResponse(t, s) {
     const i = t.error;
-    return new C(i.doc_url ? `${i.message} See ${i.doc_url}` : i.message, i.code, s, i.type, i.param, i.doc_url);
+    return new E(i.doc_url ? `${i.message} See ${i.doc_url}` : i.message, i.code, s, i.type, i.param, i.doc_url);
   }
-}, u = class extends h {
+}, m = class extends h {
   constructor(e, t) {
     super(e, "network_error"), this.originalError = t, this.name = "AgoNetworkError";
   }
-}, g = class extends h {
+}, p = class extends h {
   constructor(e, t = "stream_error") {
     super(e, t), this.name = "AgoStreamError";
   }
-}, f = class extends h {
+}, y = class extends h {
   constructor(e, t, s) {
     super(e, "function_error"), this.functionName = t, this.originalError = s, this.name = "AgoFunctionError";
   }
-}, E = class {
+}, S = class {
   constructor(e = !1) {
     this.enabled = e;
   }
@@ -44,22 +44,22 @@ var h = class extends Error {
   debug(...e) {
     this.enabled && console.debug("[AGO SDK]", ...e);
   }
-}, o = new E(), p = "ago_widget_id";
-function S() {
+}, a = new S(), w = "ago_widget_id";
+function $() {
   if (typeof localStorage < "u") {
-    const t = localStorage.getItem(p);
+    const t = localStorage.getItem(w);
     if (t) return t;
   }
   const e = typeof crypto < "u" && typeof crypto.randomUUID == "function" ? crypto.randomUUID() : `ago-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 12)}`;
   if (typeof localStorage < "u") try {
-    localStorage.setItem(p, e);
+    localStorage.setItem(w, e);
   } catch {
   }
   return e;
 }
 var k = class {
   constructor(e) {
-    this.baseUrl = e.baseUrl.replace(/\/$/, ""), this.headers = { "X-User-Anon-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);
+    this.baseUrl = e.baseUrl.replace(/\/$/, ""), this.headers = { "X-User-Anon-Id": e.widgetId || $() }, 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-User-Anon-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"]);
@@ -72,7 +72,7 @@ var k = class {
   }
   async postStream(e, t) {
     const s = `${this.baseUrl}${e}`;
-    o.debug("POST (stream)", s, t);
+    a.debug("POST (stream)", s, t);
     try {
       const i = await fetch(s, {
         method: "POST",
@@ -84,12 +84,12 @@ var k = class {
       });
       return i.ok || await this.handleErrorResponse(i), i;
     } catch (i) {
-      throw i instanceof d ? i : new u(`Network error: ${i instanceof Error ? i.message : "Unknown error"}. Check that \`baseUrl\` is reachable and includes the protocol (https://).`, i instanceof Error ? i : void 0);
+      throw i instanceof u ? i : new m(`Network error: ${i instanceof Error ? i.message : "Unknown error"}. Check that \`baseUrl\` is reachable and includes the protocol (https://).`, i instanceof Error ? i : void 0);
     }
   }
   async postFormData(e, t) {
     const s = `${this.baseUrl}${e}`;
-    o.debug("POST (formData)", s);
+    a.debug("POST (formData)", s);
     const i = { ...this.headers };
     try {
       const n = await fetch(s, {
@@ -99,12 +99,12 @@ var k = class {
       });
       return n.ok || await this.handleErrorResponse(n), n;
     } catch (n) {
-      throw n instanceof d ? n : new u(`Network error: ${n instanceof Error ? n.message : "Unknown error"}. Check that \`baseUrl\` is reachable and includes the protocol (https://).`, n instanceof Error ? n : void 0);
+      throw n instanceof u ? n : new m(`Network error: ${n instanceof Error ? n.message : "Unknown error"}. Check that \`baseUrl\` is reachable and includes the protocol (https://).`, n instanceof Error ? n : void 0);
     }
   }
   async request(e, t, s) {
     const i = `${this.baseUrl}${t}`;
-    o.debug(e, i, s);
+    a.debug(e, i, s);
     try {
       const n = await fetch(i, {
         method: e,
@@ -116,7 +116,7 @@ var k = class {
       });
       return n.ok || await this.handleErrorResponse(n), n.status === 204 ? void 0 : n.json();
     } catch (n) {
-      throw n instanceof d ? n : new u(`Network error: ${n instanceof Error ? n.message : "Unknown error"}. Check that \`baseUrl\` is reachable and includes the protocol (https://).`, n instanceof Error ? n : void 0);
+      throw n instanceof u ? n : new m(`Network error: ${n instanceof Error ? n.message : "Unknown error"}. Check that \`baseUrl\` is reachable and includes the protocol (https://).`, n instanceof Error ? n : void 0);
     }
   }
   async handleErrorResponse(e) {
@@ -125,35 +125,35 @@ var k = class {
       t = await e.json();
     } catch {
     }
-    if (t?.error) throw d.fromResponse(t, e.status);
+    if (t?.error) throw u.fromResponse(t, e.status);
     let s = "";
-    throw e.status === 401 || e.status === 403 ? s = " Check `userJwt` (and that it has not expired)." : e.status === 404 && (s = " Check that `baseUrl` points at your AGO API root."), new d(`HTTP ${e.status}: ${e.statusText}.${s}`, "http_error", e.status, "api_error");
+    throw e.status === 401 || e.status === 403 ? s = " Check `userJwt` (and that it has not expired)." : e.status === 404 && (s = " Check that `baseUrl` points at your AGO API root."), new u(`HTTP ${e.status}: ${e.statusText}.${s}`, "http_error", e.status, "api_error");
   }
-}, $ = class {
+}, A = class {
   constructor() {
     this.functions = /* @__PURE__ */ new Map();
   }
   register(e, t, s) {
     if (typeof e == "object") {
-      const { name: n, handler: r, description: a, parameters: l } = e;
+      const { name: n, handler: r, description: o, parameters: l } = e;
       return this.register(n, r, {
-        description: a,
+        description: o,
         parameters: l
       });
     }
     const i = e;
     if (!t || !s) throw new h(`registerFunction("${i}"): both a handler and a schema are required. Pass them as arguments or use the single-object form: registerFunction({ name, parameters, handler }).`, "function_invalid_registration");
-    this.functions.has(i) && o.warn(`Function "${i}" is being overwritten`), this.functions.set(i, {
+    this.functions.has(i) && a.warn(`Function "${i}" is being overwritten`), this.functions.set(i, {
       schema: {
         ...s,
         name: i
       },
       handler: t
-    }), o.log(`Registered function: ${i}`);
+    }), a.log(`Registered function: ${i}`);
   }
   unregister(e) {
     const t = this.functions.delete(e);
-    return t && o.log(`Unregistered function: ${e}`), t;
+    return t && a.log(`Unregistered function: ${e}`), t;
   }
   get(e) {
     return this.functions.get(e);
@@ -166,38 +166,38 @@ var k = class {
   }
   async execute(e, t) {
     const s = this.functions.get(e);
-    if (!s) throw new f(`Function "${e}" is not registered`, e);
-    o.log(`Executing function: ${e}`, t);
+    if (!s) throw new y(`Function "${e}" is not registered`, e);
+    a.log(`Executing function: ${e}`, t);
     try {
       const i = await s.handler(t);
-      return o.log(`Function ${e} completed:`, i), i;
+      return a.log(`Function ${e} completed:`, i), i;
     } catch (i) {
-      throw o.error(`Function ${e} failed:`, i), new f(`Function "${e}" execution failed: ${i instanceof Error ? i.message : "Unknown error"}`, e, i instanceof Error ? i : void 0);
+      throw a.error(`Function ${e} failed:`, i), new y(`Function "${e}" execution failed: ${i instanceof Error ? i.message : "Unknown error"}`, e, i instanceof Error ? i : void 0);
     }
   }
   clear() {
-    this.functions.clear(), o.log("Cleared all registered functions");
+    this.functions.clear(), a.log("Cleared all registered functions");
   }
   get size() {
     return this.functions.size;
   }
-}, A = class {
+}, x = class {
   constructor() {
     this.entries = /* @__PURE__ */ new Map(), this.dynamicProviders = /* @__PURE__ */ new Map();
   }
   set(e, t) {
-    this.entries.set(e, t), o.log(`ClientContext set: ${e}`);
+    this.entries.set(e, t), a.log(`ClientContext set: ${e}`);
   }
   remove(e) {
     const t = this.entries.delete(e);
-    return t && o.log(`ClientContext removed: ${e}`), t;
+    return t && a.log(`ClientContext removed: ${e}`), t;
   }
   addDynamicProvider(e, t) {
-    this.dynamicProviders.set(e, t), o.log(`DynamicContext provider added: ${e}`);
+    this.dynamicProviders.set(e, t), a.log(`DynamicContext provider added: ${e}`);
   }
   removeDynamicProvider(e) {
     const t = this.dynamicProviders.delete(e);
-    return t && o.log(`DynamicContext provider removed: ${e}`), t;
+    return t && a.log(`DynamicContext provider removed: ${e}`), t;
   }
   getSnapshot() {
     if (this.entries.size === 0 && this.dynamicProviders.size === 0) return null;
@@ -207,23 +207,23 @@ var k = class {
       const i = s();
       i && (e[t] = i);
     } catch (i) {
-      o.error(`DynamicContext provider "${t}" threw:`, i);
+      a.error(`DynamicContext provider "${t}" threw:`, i);
     }
     return Object.keys(e).length === 0 ? null : { entries: e };
   }
   clear() {
-    this.entries.clear(), this.dynamicProviders.clear(), o.log("ClientContext cleared");
+    this.entries.clear(), this.dynamicProviders.clear(), a.log("ClientContext cleared");
   }
 };
-function m(e) {
-  return e === null || typeof e != "object" ? JSON.stringify(e) ?? "null" : Array.isArray(e) ? `[${e.map(m).join(",")}]` : `{${Object.keys(e).sort().map((t) => `${JSON.stringify(t)}:${m(e[t])}`).join(",")}}`;
+function g(e) {
+  return e === null || typeof e != "object" ? JSON.stringify(e) ?? "null" : Array.isArray(e) ? `[${e.map(g).join(",")}]` : `{${Object.keys(e).sort().map((t) => `${JSON.stringify(t)}:${g(e[t])}`).join(",")}}`;
 }
 var R = class {
   constructor(e) {
     this.callbacks = e, this.buffer = "", this.message = {}, this.toolCalls = [], this.sources = [], this.followUpReplies = [], this.isFirstChunk = !0, this.answerCompleteEmitted = !1, this.firedClientFunctions = /* @__PURE__ */ new Set();
   }
   async processStream(e) {
-    if (!e.body) throw new g("Response has no body. The endpoint did not return a stream: check that `baseUrl` points at an AGO API and nothing (proxy, mock) strips the SSE body.", "stream_no_body");
+    if (!e.body) throw new p("Response has no body. The endpoint did not return a stream: check that `baseUrl` points at an AGO API and nothing (proxy, mock) strips the SSE body.", "stream_no_body");
     const t = e.body.getReader(), s = new TextDecoder();
     try {
       for (; ; ) {
@@ -234,7 +234,7 @@ var R = class {
       }
       return this.buffer.trim() && this.processBuffer(), this.buildFinalMessage();
     } catch (i) {
-      const n = i instanceof Error ? i : new g("Stream processing failed mid-flight. The connection may have dropped; retry the message.");
+      const n = i instanceof Error ? i : new p("Stream processing failed mid-flight. The connection may have dropped; retry the message.");
       throw this.callbacks.onError?.(n), n;
     } finally {
       t.releaseLock();
@@ -256,7 +256,7 @@ var R = class {
             const r = JSON.parse(n);
             this.handleChunk(r);
           } catch (r) {
-            o.warn("Failed to parse SSE data:", n, r);
+            a.warn("Failed to parse SSE data:", n, r);
           }
         }
     }
@@ -281,7 +281,7 @@ var R = class {
         url: s.use_external_link ? s.external_link_url : s.internal_link_url
       };
     })), e.type === "client_function" && e.function_name) {
-      const t = `${e.function_name}::${m(e.arguments ?? {})}`;
+      const t = `${e.function_name}::${g(e.arguments ?? {})}`;
       this.firedClientFunctions.has(t) || (this.firedClientFunctions.add(t), this.callbacks.onClientFunction?.({
         invocationId: e.id || "",
         functionName: e.function_name,
@@ -330,11 +330,11 @@ var R = class {
     return this.callbacks.onComplete?.(e), e;
   }
 };
-function D(e) {
+function N(e) {
   const t = e.message.toLowerCase();
   return t.includes("load failed") || t.includes("failed to fetch") || t.includes("network") || t.includes("abort");
 }
-var x = /* @__PURE__ */ new Set([
+var I = /* @__PURE__ */ new Set([
   "image/jpeg",
   "image/png",
   "image/gif",
@@ -342,7 +342,7 @@ var x = /* @__PURE__ */ new Set([
   "image/bmp",
   "image/tiff"
 ]);
-function I(e) {
+function F(e) {
   if (!e) return;
   const t = typeof window < "u" && window.location ? window.location.href : "https://ago.local/";
   try {
@@ -351,8 +351,8 @@ function I(e) {
   } catch {
   }
 }
-function N(e) {
-  return e.isSafeImage === !0 && typeof e.contentType == "string" && e.contentType.startsWith("image/") && I(e.url) !== void 0;
+function P(e) {
+  return e.isSafeImage === !0 && typeof e.contentType == "string" && e.contentType.startsWith("image/") && F(e.url) !== void 0;
 }
 function O(e) {
   if (e == null || e < 0) return "";
@@ -370,17 +370,17 @@ function U(e) {
     isSafeImage: e.is_safe_image === !0
   };
 }
-function P(e) {
+function j(e) {
   return e.map((t, s) => ({
     id: `local-${s}-${t.name}`,
     name: t.name,
     contentType: t.type || void 0,
     fileSize: t.size,
     url: typeof URL < "u" && URL.createObjectURL ? URL.createObjectURL(t) : void 0,
-    isSafeImage: x.has(t.type)
+    isSafeImage: I.has(t.type)
   }));
 }
-var F = class {
+var T = class {
   constructor() {
     this.handlers = /* @__PURE__ */ new Map();
   }
@@ -410,8 +410,8 @@ var F = class {
   waitFor(e, t) {
     return new Promise((s, i) => {
       let n;
-      const r = ((a) => {
-        n && clearTimeout(n), s(a);
+      const r = ((o) => {
+        n && clearTimeout(n), s(o);
       });
       this.once(e, r), t?.timeout && (n = setTimeout(() => {
         this.off(e, r), i(/* @__PURE__ */ new Error(`waitFor("${String(e)}") timed out after ${t.timeout}ms`));
@@ -421,31 +421,31 @@ var F = class {
   removeAllListeners(e) {
     e ? this.handlers.delete(e) : this.handlers.clear();
   }
-}, y = '`baseUrl` is required, e.g. new AgoClient({ baseUrl: "https://YOUR-DOMAIN.api.useago.com" }). Try the live demo endpoint https://playground.api.useago.com. See docs/general/configuration.md#error-codes (config_missing_base_url).', T = /^[a-z][a-z0-9+.-]*:\/\//i, w = !1;
-function v(e, t = "AgoClient") {
-  if (typeof e != "object" || e === null) throw new h(`${t}: ${y}`, "config_missing_base_url");
+}, v = '`baseUrl` is required, e.g. new AgoClient({ baseUrl: "https://YOUR-DOMAIN.api.useago.com" }). Try the live demo endpoint https://playground.api.useago.com. See docs/general/configuration.md#error-codes (config_missing_base_url).', D = /^[a-z][a-z0-9+.-]*:\/\//i, C = !1;
+function b(e, t = "AgoClient") {
+  if (typeof e != "object" || e === null) throw new h(`${t}: ${v}`, "config_missing_base_url");
   const s = e.baseUrl;
-  if (typeof s != "string" || s.trim() === "") throw new h(`${t}: ${y}`, "config_missing_base_url");
-  !s.startsWith("/") && !T.test(s) && (w || (w = !0, console.warn(`[AGO] ${t}: \`baseUrl\` has no protocol and is not a relative path (config_suspect_base_url). Requests will fail: Node throws a URL parse error, browsers fetch it as a relative path. Use "https://..." (or a "/path" for a same-origin proxy).`)));
+  if (typeof s != "string" || s.trim() === "") throw new h(`${t}: ${v}`, "config_missing_base_url");
+  !s.startsWith("/") && !D.test(s) && (C || (C = !0, console.warn(`[AGO] ${t}: \`baseUrl\` has no protocol and is not a relative path (config_suspect_base_url). Requests will fail: Node throws a URL parse error, browsers fetch it as a relative path. Use "https://..." (or a "/path" for a same-origin proxy).`)));
 }
-var j = class b {
+var M = class _ {
   constructor(t) {
-    this.warnedEmptyConversations = /* @__PURE__ */ new Set(), v(t, "AgoClient"), this.config = t, this.httpClient = new k(t), this.functionRegistry = new $(), this.contextRegistry = new A(), this.eventEmitter = new F(), t.debug && o.enable(), o.log("AgoClient initialized");
+    this.warnedEmptyConversations = /* @__PURE__ */ new Set(), b(t, "AgoClient"), this.config = t, this.httpClient = new k(t), this.functionRegistry = new A(), this.contextRegistry = new x(), this.eventEmitter = new T(), t.debug && a.enable(), a.log("AgoClient initialized");
   }
   async sendMessage(t, s) {
-    const i = this.functionRegistry.getSchemas(), n = this.contextRegistry.getSnapshot(), r = this.config.agent || this.config.defaultAgentId, a = {
+    const i = this.functionRegistry.getSchemas(), n = this.contextRegistry.getSnapshot(), r = this.config.agent || this.config.defaultAgentId, o = {
       content: t,
       conversation_id: s?.conversationId,
       agent_id: s?.agentId || r
     };
-    i.length > 0 && (a.client_functions = i), n && (a.client_context = n);
+    i.length > 0 && (o.client_functions = i), n && (o.client_context = n), s?.hidden && (o.hidden = !0);
     let l;
     if (s?.files && s.files.length > 0) {
       const c = new FormData();
-      c.append("content", t), s.conversationId && c.append("conversation_id", s.conversationId), (s.agentId || r) && c.append("agent_id", s.agentId || r || ""), i.length > 0 && c.append("client_functions", JSON.stringify(i)), n && c.append("client_context", JSON.stringify(n));
-      for (const _ of s.files) c.append("files", _);
+      c.append("content", t), s.conversationId && c.append("conversation_id", s.conversationId), (s.agentId || r) && c.append("agent_id", s.agentId || r || ""), i.length > 0 && c.append("client_functions", JSON.stringify(i)), n && c.append("client_context", JSON.stringify(n)), s.hidden && c.append("hidden", "true");
+      for (const d of s.files) c.append("files", d);
       l = await this.httpClient.postFormData("/api/sdk/v1/messages", c);
-    } else l = await this.httpClient.postStream("/api/sdk/v1/messages", a);
+    } else l = await this.httpClient.postStream("/api/sdk/v1/messages", o);
     return this.processSSEResponse(l);
   }
   async processSSEResponse(t) {
@@ -499,7 +499,7 @@ var j = class b {
     try {
       s = await this.functionRegistry.execute(t.functionName, t.arguments);
     } catch (n) {
-      i = n instanceof Error ? n.message : "Unknown error", o.error("Client function execution failed:", n);
+      i = n instanceof Error ? n.message : "Unknown error", a.error("Client function execution failed:", n);
     }
     if (t.invocationId) try {
       await this.submitToolCallForm(t.invocationId, {
@@ -508,7 +508,7 @@ var j = class b {
         _type: "client_function_result"
       });
     } catch (n) {
-      o.error("Failed to submit function result:", n);
+      a.error("Failed to submit function result:", n);
     }
     this.eventEmitter.emit("function:result", {
       invocationId: t.invocationId,
@@ -535,7 +535,8 @@ var j = class b {
         role: n.role,
         status: n.status,
         createdAt: new Date(n.created_at),
-        toolCalls: b.mapPersistedToolCalls(n.tool_call_data),
+        hidden: n.hidden,
+        toolCalls: _.mapPersistedToolCalls(n.tool_call_data),
         attachments: n.attachments && n.attachments.length > 0 ? n.attachments.map(U) : void 0
       }))
     };
@@ -603,13 +604,13 @@ var j = class b {
     const i = s.map((r) => r.name), n = s.map((r) => `- "${r.name}": ${r.description}`).join(`
 `);
     this.registerFunction("navigateToPage", async (r) => {
-      const a = r.page, l = s.find((c) => c.name === a);
+      const o = r.page, l = s.find((c) => c.name === o);
       return l ? (t(l.path), {
         success: !0,
         navigatedTo: l.path
       }) : {
         success: !1,
-        error: `Unknown page: ${a}`
+        error: `Unknown page: ${o}`
       };
     }, {
       description: `Navigate the user to a page in the application. Available pages:
@@ -625,6 +626,46 @@ ${n}`,
       }
     });
   }
+  registerPageStateFunction(t, s) {
+    const i = s?.functionName ?? "setPageState", n = new Map(t.map((o) => [o.name, o])), r = t.map((o) => `- "${o.name}": ${o.description}`).join(`
+`);
+    this.registerFunction(i, async (o) => {
+      const l = {};
+      for (const [c, d] of Object.entries(o)) {
+        if (d === void 0) continue;
+        const f = n.get(c);
+        f && (await f.set(d), l[c] = d);
+      }
+      return {
+        success: !0,
+        applied: l
+      };
+    }, {
+      description: `Change the state of the current page. Set ONLY the controls the user explicitly asked for; leave the others unset. Available controls:
+${r}`,
+      parameters: {
+        type: "object",
+        properties: Object.fromEntries(t.map((o) => [o.name, {
+          ...o.schema,
+          description: o.description
+        }]))
+      }
+    }), this.addDynamicContext(`page-state:${i}`, () => {
+      const o = t.filter((c) => typeof c.get == "function");
+      if (o.length === 0) return null;
+      const l = {};
+      for (const c of o) l[c.name] = c.get();
+      return {
+        name: "Page state",
+        description: "Current, editable state of the page the user is viewing.",
+        data: l
+      };
+    });
+  }
+  unregisterPageStateFunction(t) {
+    const s = t ?? "setPageState";
+    this.unregisterFunction(s), this.removeDynamicContext(`page-state:${s}`);
+  }
   setContext(t, s) {
     this.contextRegistry.set(t, s), this.notifyContextChanged();
   }
@@ -680,28 +721,28 @@ ${n}`,
       ...this.config,
       ...s
     };
-    v(i, "AgoClient.updateConfig"), this.config = i, this.httpClient.updateConfig(s), s.debug !== void 0 && (s.debug ? o.enable() : o.disable());
+    b(i, "AgoClient.updateConfig"), this.config = i, this.httpClient.updateConfig(s), s.debug !== void 0 && (s.debug ? a.enable() : a.disable());
   }
   destroy() {
-    this.eventEmitter.removeAllListeners(), this.functionRegistry.clear(), this.contextRegistry.clear(), o.log("AgoClient destroyed");
+    this.eventEmitter.removeAllListeners(), this.functionRegistry.clear(), this.contextRegistry.clear(), a.log("AgoClient destroyed");
   }
 };
 export {
-  g as _,
-  N as a,
+  p as _,
+  P as a,
   R as c,
-  $ as d,
-  o as f,
-  u as g,
-  f as h,
-  P as i,
-  D as l,
+  A as d,
+  a as f,
+  m as g,
+  y as h,
+  j as i,
+  N as l,
   h as m,
-  v as n,
+  b as n,
   O as o,
-  d as p,
-  F as r,
-  I as s,
-  j as t,
-  A as u
+  u as p,
+  T as r,
+  F as s,
+  M as t,
+  x as u
 };

package/dist/angular.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./AgoClient-CzSmJQxl.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-B2BU8tfB.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)}registerPageStateFunction(e,t){this.client.registerPageStateFunction(e,t)}unregisterPageStateFunction(e){this.client.unregisterPageStateFunction(e)}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;