@useago/sdk 0.3.4 → 0.4.1

package/dist/helpers.js

@@ -1,4 +1,4 @@
-import { a, c as s, d as t, f as e, i as r, l as i, m as l, o as m, p as c, r as g, s as h, t as n, u as p } from "./functions-CWSRi3xv.js";
+import { a, c as s, d as t, f as e, i as r, l as i, m as l, o as m, p as c, r as g, s as h, t as n, u as p } from "./functions-C1-5vadY.js";
 export {
   n as copyToClipboard,
   g as getLocalStorage,

package/dist/index.cjs

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

package/dist/index.d.cts

@@ -42,6 +42,12 @@ export declare class AgoClient {
      * Get a specific conversation with messages
      */
     getConversation(conversationId: string): Promise<Conversation>;
+    /**
+     * Map the backend's snake_case `tool_call_data` entries onto the camelCase
+     * {@link ToolCallData} shape used everywhere else in the SDK. Mirrors
+     * `SSEHandler.parseToolCall` so persisted and streamed tool calls match.
+     */
+    private static mapPersistedToolCalls;
     /**
      * Get messages for a conversation
      */
@@ -212,6 +218,12 @@ export declare interface AgoClientEvents {
         conversationId?: string;
         messageId?: string;
     };
+    /**
+     * A full conversation was loaded from the server (e.g. after a page reload).
+     * Carries the messages and their persisted tool calls so stateful helpers —
+     * notably `createFormCollector` — can replay them to restore their state.
+     */
+    "conversation:loaded": Conversation;
     "toolCall:received": ToolCallData;
     "toolCall:form": ToolCallData;
     "function:invoke": ClientFunctionInvocation;
@@ -498,6 +510,60 @@ export declare interface Conversation {
     messages?: AgoMessage[];
 }
 
+export declare interface ConversationSession {
+    /**
+     * The stable widget id identifying this visitor. Generated once and persisted
+     * forever, so a returning visitor keeps the same id (and therefore the same
+     * server-side conversation history) across reloads.
+     */
+    readonly widgetId: string;
+    /**
+     * The last active thread id, decided **entirely on the front** so a reload costs
+     * no backend round-trip. Returns `null` when there is no cached thread, when its
+     * last message time is unknown, or when it has been idle longer than `ttlMs`.
+     */
+    getLastActiveThread(): string | null;
+    /**
+     * Record (and refresh) the active thread together with the time of its last
+     * message — call it once per turn. The `lastMessageAt` drives the sliding TTL;
+     * omit it and the thread won't be resumed (no time → not displayed).
+     */
+    setActiveThread(conversationId: string, lastMessageAt?: Date | number): void;
+    /** Forget the cached thread — e.g. on "new chat". */
+    clear(): void;
+    /** The resolved storage key holding the widget id — handy for debugging. */
+    readonly key: string;
+}
+
+export declare interface ConversationSessionOptions {
+    /**
+     * Storage backend. Defaults to `localStorage`, degrading to an in-memory store
+     * when storage is unavailable (SSR / disabled). Pass `sessionStorage` for a
+     * tab-scoped session, or any `{ getItem, setItem }` for a custom backend.
+     */
+    storage?: StorageLike;
+    /**
+     * Storage key for the widget id. Default `"ago_widget_id"` — the same key the
+     * HTTP client reads, so the visitor's id is shared across the SDK.
+     */
+    key?: string;
+    /**
+     * Explicit widget id to adopt (and persist) instead of reading or generating
+     * one — e.g. when the host app already has a stable visitor identifier.
+     */
+    widgetId?: string;
+    /** Storage key for the cached last active thread. Default `"ago_last_thread"`. */
+    threadKey?: string;
+    /**
+     * Maximum idle age of a thread to still resume it, in milliseconds, compared
+     * against the recorded time of its last message. Checked entirely on the front
+     * (no backend call): a thread idle longer than this — or one with no recorded
+     * last-message time — is not resumed (`getLastActiveThread` returns `null`).
+     * Default 2h. Pass `Infinity` to never expire.
+     */
+    ttlMs?: number;
+}
+
 /**
  * Copy text to clipboard.
  */
@@ -529,6 +595,33 @@ export declare const copyToClipboard: ClientFunctionDefinition;
  */
 export declare function createAgo(overrides?: Partial<AgoConfig>): AgoClient;
 
+/**
+ * Identify a returning visitor with a single, stable widget id — the same model as
+ * the frontend's `getOrGenerateWidgetId` — and resume their last active thread.
+ *
+ * There is no per-agent conversation id: the widget id is the identity, and the last
+ * active thread (its id + the time of its last message) is cached locally so resuming
+ * is a pure front-side decision — **no backend call** just to know whether the thread
+ * is still fresh. A thread idle longer than `ttlMs` (default 2h, sliding — refreshed
+ * by `setActiveThread`), or one with no recorded last-message time, is not resumed.
+ *
+ * ```ts
+ * const session = createConversationSession();
+ *
+ * // resume on load (front-only — no request):
+ * const conversationId = session.getLastActiveThread() ?? undefined;
+ *
+ * // record the thread once a turn completes:
+ * session.setActiveThread(reply.conversationId, reply.createdAt);
+ *
+ * session.clear(); // forget it — e.g. a "new chat" button
+ * ```
+ *
+ * Persistence is opt-in by storage backend: it defaults to `localStorage`, but pass
+ * `sessionStorage` for a tab-scoped session or omit storage in environments without it.
+ */
+export declare function createConversationSession(options?: ConversationSessionOptions): ConversationSession;
+
 /**
  * Wire one schema into a conversational form: an observable store, an
  * `update_<name>` client function the agent calls to fill fields, a dynamic-context
@@ -675,6 +768,14 @@ export declare interface FormCollector<V = Record<string, unknown>> {
     contextProvider: () => ContextEntry;
     /** Register the functions + dynamic context on a client. Returns an uninstall fn. */
     install: (client: AgoClient) => () => void;
+    /**
+     * Rebuild the state by replaying the persisted `update_<name>` / `submit_<name>`
+     * tool-call arguments of a loaded conversation — restoring what the agent had
+     * collected after a page reload. Replays from the initial values, so it is
+     * idempotent. `install` wires this to the client's `conversation:loaded` event,
+     * so a custom front rarely needs to call it directly.
+     */
+    hydrate: (toolCalls: readonly ToolCallData[]) => void;
     /** Submit the form now (e.g. from a UI button). Blocks until required fields are filled. */
     submit: () => Promise<FormSubmitResult>;
     getValues: () => Partial<V>;
@@ -1054,7 +1155,7 @@ declare interface SSEHandlerCallbacks {
 }
 
 /** The slice of the Web Storage API that {@link createStore} relies on. */
-declare type StorageLike = Pick<Storage, "getItem" | "setItem">;
+export declare type StorageLike = Pick<Storage, "getItem" | "setItem">;
 
 /**
  * A minimal observable store: one value, synchronous subscriptions, and

package/dist/index.d.ts

@@ -42,6 +42,12 @@ export declare class AgoClient {
      * Get a specific conversation with messages
      */
     getConversation(conversationId: string): Promise<Conversation>;
+    /**
+     * Map the backend's snake_case `tool_call_data` entries onto the camelCase
+     * {@link ToolCallData} shape used everywhere else in the SDK. Mirrors
+     * `SSEHandler.parseToolCall` so persisted and streamed tool calls match.
+     */
+    private static mapPersistedToolCalls;
     /**
      * Get messages for a conversation
      */
@@ -212,6 +218,12 @@ export declare interface AgoClientEvents {
         conversationId?: string;
         messageId?: string;
     };
+    /**
+     * A full conversation was loaded from the server (e.g. after a page reload).
+     * Carries the messages and their persisted tool calls so stateful helpers —
+     * notably `createFormCollector` — can replay them to restore their state.
+     */
+    "conversation:loaded": Conversation;
     "toolCall:received": ToolCallData;
     "toolCall:form": ToolCallData;
     "function:invoke": ClientFunctionInvocation;
@@ -498,6 +510,60 @@ export declare interface Conversation {
     messages?: AgoMessage[];
 }
 
+export declare interface ConversationSession {
+    /**
+     * The stable widget id identifying this visitor. Generated once and persisted
+     * forever, so a returning visitor keeps the same id (and therefore the same
+     * server-side conversation history) across reloads.
+     */
+    readonly widgetId: string;
+    /**
+     * The last active thread id, decided **entirely on the front** so a reload costs
+     * no backend round-trip. Returns `null` when there is no cached thread, when its
+     * last message time is unknown, or when it has been idle longer than `ttlMs`.
+     */
+    getLastActiveThread(): string | null;
+    /**
+     * Record (and refresh) the active thread together with the time of its last
+     * message — call it once per turn. The `lastMessageAt` drives the sliding TTL;
+     * omit it and the thread won't be resumed (no time → not displayed).
+     */
+    setActiveThread(conversationId: string, lastMessageAt?: Date | number): void;
+    /** Forget the cached thread — e.g. on "new chat". */
+    clear(): void;
+    /** The resolved storage key holding the widget id — handy for debugging. */
+    readonly key: string;
+}
+
+export declare interface ConversationSessionOptions {
+    /**
+     * Storage backend. Defaults to `localStorage`, degrading to an in-memory store
+     * when storage is unavailable (SSR / disabled). Pass `sessionStorage` for a
+     * tab-scoped session, or any `{ getItem, setItem }` for a custom backend.
+     */
+    storage?: StorageLike;
+    /**
+     * Storage key for the widget id. Default `"ago_widget_id"` — the same key the
+     * HTTP client reads, so the visitor's id is shared across the SDK.
+     */
+    key?: string;
+    /**
+     * Explicit widget id to adopt (and persist) instead of reading or generating
+     * one — e.g. when the host app already has a stable visitor identifier.
+     */
+    widgetId?: string;
+    /** Storage key for the cached last active thread. Default `"ago_last_thread"`. */
+    threadKey?: string;
+    /**
+     * Maximum idle age of a thread to still resume it, in milliseconds, compared
+     * against the recorded time of its last message. Checked entirely on the front
+     * (no backend call): a thread idle longer than this — or one with no recorded
+     * last-message time — is not resumed (`getLastActiveThread` returns `null`).
+     * Default 2h. Pass `Infinity` to never expire.
+     */
+    ttlMs?: number;
+}
+
 /**
  * Copy text to clipboard.
  */
@@ -529,6 +595,33 @@ export declare const copyToClipboard: ClientFunctionDefinition;
  */
 export declare function createAgo(overrides?: Partial<AgoConfig>): AgoClient;
 
+/**
+ * Identify a returning visitor with a single, stable widget id — the same model as
+ * the frontend's `getOrGenerateWidgetId` — and resume their last active thread.
+ *
+ * There is no per-agent conversation id: the widget id is the identity, and the last
+ * active thread (its id + the time of its last message) is cached locally so resuming
+ * is a pure front-side decision — **no backend call** just to know whether the thread
+ * is still fresh. A thread idle longer than `ttlMs` (default 2h, sliding — refreshed
+ * by `setActiveThread`), or one with no recorded last-message time, is not resumed.
+ *
+ * ```ts
+ * const session = createConversationSession();
+ *
+ * // resume on load (front-only — no request):
+ * const conversationId = session.getLastActiveThread() ?? undefined;
+ *
+ * // record the thread once a turn completes:
+ * session.setActiveThread(reply.conversationId, reply.createdAt);
+ *
+ * session.clear(); // forget it — e.g. a "new chat" button
+ * ```
+ *
+ * Persistence is opt-in by storage backend: it defaults to `localStorage`, but pass
+ * `sessionStorage` for a tab-scoped session or omit storage in environments without it.
+ */
+export declare function createConversationSession(options?: ConversationSessionOptions): ConversationSession;
+
 /**
  * Wire one schema into a conversational form: an observable store, an
  * `update_<name>` client function the agent calls to fill fields, a dynamic-context
@@ -675,6 +768,14 @@ export declare interface FormCollector<V = Record<string, unknown>> {
     contextProvider: () => ContextEntry;
     /** Register the functions + dynamic context on a client. Returns an uninstall fn. */
     install: (client: AgoClient) => () => void;
+    /**
+     * Rebuild the state by replaying the persisted `update_<name>` / `submit_<name>`
+     * tool-call arguments of a loaded conversation — restoring what the agent had
+     * collected after a page reload. Replays from the initial values, so it is
+     * idempotent. `install` wires this to the client's `conversation:loaded` event,
+     * so a custom front rarely needs to call it directly.
+     */
+    hydrate: (toolCalls: readonly ToolCallData[]) => void;
     /** Submit the form now (e.g. from a UI button). Blocks until required fields are filled. */
     submit: () => Promise<FormSubmitResult>;
     getValues: () => Partial<V>;
@@ -1054,7 +1155,7 @@ declare interface SSEHandlerCallbacks {
 }
 
 /** The slice of the Web Storage API that {@link createStore} relies on. */
-declare type StorageLike = Pick<Storage, "getItem" | "setItem">;
+export declare type StorageLike = Pick<Storage, "getItem" | "setItem">;
 
 /**
  * A minimal observable store: one value, synchronous subscriptions, and

package/dist/index.js

@@ -1,29 +1,30 @@
-import { a as w, c as h, d as A, f as y, i as C, l as E, n as b, o as S, r as v, s as k, t as d, u as M } from "./AgoClient-DF7M2WAz.js";
-import { n as T, t as I } from "./createFormCollector-ClzHfaBd.js";
-import { t as G } from "./createMockClient-C50gjV0b.js";
-import { a as q, c as x, d as L, f as N, i as D, l as H, m as J, o as R, p as j, r as B, s as P, t as $, u as z } from "./functions-CWSRi3xv.js";
-function K(e) {
+import { a as w, c as h, d as A, f as y, i as C, l as E, n as b, o as S, r as v, s as k, t as d, u as M } from "./AgoClient-BerJvssl.js";
+import { n as T, t as I } from "./createFormCollector-CD1rqRG4.js";
+import { t as G } from "./createConversationSession-CLZvxyuu.js";
+import { t as q } from "./createMockClient-tVsApEAh.js";
+import { a as L, c as N, d as D, f as H, i as J, l as R, m as j, o as B, p as P, r as $, s as z, t as K, u as Q } from "./functions-C1-5vadY.js";
+function V(e) {
   return e;
 }
-function Q(e, t) {
+function W(e, t) {
   return e.on("message:complete", t), () => e.off("message:complete", t);
 }
-function V(e, t) {
+function X(e, t) {
   return e.on("message:chunk", t), () => e.off("message:chunk", t);
 }
-function W(e, t) {
+function Y(e, t) {
   return e.on("message:start", t), () => e.off("message:start", t);
 }
-function X(e, t) {
+function Z(e, t) {
   return e.on("message:error", t), () => e.off("message:error", t);
 }
-function Y(e, t) {
+function _(e, t) {
   return e.on("toolCall:received", t), () => e.off("toolCall:received", t);
 }
-function Z(e, t) {
+function ee(e, t) {
   return e.on("function:invoke", t), () => e.off("function:invoke", t);
 }
-async function* _(e, t, g) {
+async function* te(e, t, g) {
   const n = [];
   let r = null, a = !1;
   const u = (s) => {
@@ -39,16 +40,16 @@ async function* _(e, t, g) {
       type: "complete",
       data: s
     }), a = !0, r?.();
-  }, l = (s) => {
+  }, m = (s) => {
     u({
       type: "error",
       data: s
     }), a = !0, r?.();
-  }, m = (s) => u({
+  }, l = (s) => u({
     type: "toolCall",
     data: s
   });
-  e.on("message:start", f), e.on("message:chunk", o), e.on("message:complete", i), e.on("message:error", l), e.on("toolCall:received", m), e.sendMessage(t, g).catch(() => {
+  e.on("message:start", f), e.on("message:chunk", o), e.on("message:complete", i), e.on("message:error", m), e.on("toolCall:received", l), e.sendMessage(t, g).catch(() => {
     a = !0, r?.();
   });
   try {
@@ -56,7 +57,7 @@ async function* _(e, t, g) {
       r = s;
     }), r = null);
   } finally {
-    e.off("message:start", f), e.off("message:chunk", o), e.off("message:complete", i), e.off("message:error", l), e.off("toolCall:received", m);
+    e.off("message:start", f), e.off("message:chunk", o), e.off("message:complete", i), e.off("message:error", m), e.off("toolCall:received", l);
   }
 }
 function c(e) {
@@ -86,12 +87,12 @@ function c(e) {
     debug: f
   } : null;
 }
-function ee(e) {
+function oe(e) {
   const t = c(e);
   if (!t) throw new Error('createAgo(): could not detect AGO configuration. Set window.AGO, add <meta name="ago-base-url">, or pass { baseUrl } explicitly.');
   return new d(t);
 }
-function te(e, t) {
+function re(e, t) {
   return {
     ...e,
     handler: t
@@ -109,32 +110,33 @@ export {
   S as FunctionRegistry,
   v as SSEHandler,
   c as autoDetectConfig,
-  $ as copyToClipboard,
-  ee as createAgo,
+  K as copyToClipboard,
+  oe as createAgo,
+  G as createConversationSession,
   I as createFormCollector,
-  _ as createMessageStream,
-  G as createMockClient,
+  te as createMessageStream,
+  q as createMockClient,
   T as createStore,
-  K as defineFunction,
-  B as getLocalStorage,
-  D as getUserLocation,
-  q as highlightElement,
+  V as defineFunction,
+  $ as getLocalStorage,
+  J as getUserLocation,
+  L as highlightElement,
   C as isStreamNetworkError,
   k as logger,
-  Z as onFunctionInvoke,
-  Q as onMessage,
-  V as onMessageChunk,
-  X as onMessageError,
-  W as onMessageStart,
-  Y as onToolCall,
-  R as openUrl,
-  P as scrollToElement,
-  x as setLocalStorage,
-  H as setTheme,
-  z as showConfirmDialog,
-  L as showNotification,
-  N as showToast,
-  j as submitForm,
-  J as trackEvent,
-  te as withHandler
+  ee as onFunctionInvoke,
+  W as onMessage,
+  X as onMessageChunk,
+  Z as onMessageError,
+  Y as onMessageStart,
+  _ as onToolCall,
+  B as openUrl,
+  z as scrollToElement,
+  N as setLocalStorage,
+  R as setTheme,
+  Q as showConfirmDialog,
+  D as showNotification,
+  H as showToast,
+  P as submitForm,
+  j as trackEvent,
+  re as withHandler
 };