vanilla-agent 1.31.0 → 1.32.0

package/dist/index.d.cts

@@ -1090,6 +1090,37 @@ type AgentWidgetConfig = {
      * ```
      */
     onSessionExpired?: () => void;
+    /**
+     * Get stored session ID for session resumption (client token mode only).
+     * Called when initializing a new session to check if there's a previous session_id
+     * that should be passed to /client/init to resume the same conversation record.
+     *
+     * @example
+     * ```typescript
+     * config: {
+     *   getStoredSessionId: () => {
+     *     const stored = localStorage.getItem('session_id');
+     *     return stored || null;
+     *   }
+     * }
+     * ```
+     */
+    getStoredSessionId?: () => string | null;
+    /**
+     * Store session ID for session resumption (client token mode only).
+     * Called when a new session is initialized to persist the session_id
+     * so it can be used to resume the conversation later.
+     *
+     * @example
+     * ```typescript
+     * config: {
+     *   setStoredSessionId: (sessionId) => {
+     *     localStorage.setItem('session_id', sessionId);
+     *   }
+     * }
+     * ```
+     */
+    setStoredSessionId?: (sessionId: string) => void;
     /**
      * Static headers to include with each request.
      * For dynamic headers (e.g., auth tokens), use `getHeaders` instead.
@@ -1771,8 +1802,8 @@ type ActionManagerProcessContext = {
 type ActionManagerOptions = {
     parsers: AgentWidgetActionParser[];
     handlers: AgentWidgetActionHandler[];
-    getMetadata: () => Record<string, unknown>;
-    updateMetadata: (updater: (prev: Record<string, unknown>) => Record<string, unknown>) => void;
+    getSessionMetadata: () => Record<string, unknown>;
+    updateSessionMetadata: (updater: (prev: Record<string, unknown>) => Record<string, unknown>) => void;
     emit: <K extends keyof AgentWidgetControllerEventMap>(event: K, payload: AgentWidgetControllerEventMap[K]) => void;
     documentRef: Document | null;
 };

package/dist/index.d.ts

@@ -1090,6 +1090,37 @@ type AgentWidgetConfig = {
      * ```
      */
     onSessionExpired?: () => void;
+    /**
+     * Get stored session ID for session resumption (client token mode only).
+     * Called when initializing a new session to check if there's a previous session_id
+     * that should be passed to /client/init to resume the same conversation record.
+     *
+     * @example
+     * ```typescript
+     * config: {
+     *   getStoredSessionId: () => {
+     *     const stored = localStorage.getItem('session_id');
+     *     return stored || null;
+     *   }
+     * }
+     * ```
+     */
+    getStoredSessionId?: () => string | null;
+    /**
+     * Store session ID for session resumption (client token mode only).
+     * Called when a new session is initialized to persist the session_id
+     * so it can be used to resume the conversation later.
+     *
+     * @example
+     * ```typescript
+     * config: {
+     *   setStoredSessionId: (sessionId) => {
+     *     localStorage.setItem('session_id', sessionId);
+     *   }
+     * }
+     * ```
+     */
+    setStoredSessionId?: (sessionId: string) => void;
     /**
      * Static headers to include with each request.
      * For dynamic headers (e.g., auth tokens), use `getHeaders` instead.
@@ -1771,8 +1802,8 @@ type ActionManagerProcessContext = {
 type ActionManagerOptions = {
     parsers: AgentWidgetActionParser[];
     handlers: AgentWidgetActionHandler[];
-    getMetadata: () => Record<string, unknown>;
-    updateMetadata: (updater: (prev: Record<string, unknown>) => Record<string, unknown>) => void;
+    getSessionMetadata: () => Record<string, unknown>;
+    updateSessionMetadata: (updater: (prev: Record<string, unknown>) => Record<string, unknown>) => void;
     emit: <K extends keyof AgentWidgetControllerEventMap>(event: K, payload: AgentWidgetControllerEventMap[K]) => void;
     documentRef: Document | null;
 };