@runtypelabs/persona 3.1.0 → 3.1.1

package/dist/widget.css

@@ -1299,6 +1299,7 @@
 /* Ensure user message paragraphs and lists have proper styling too */
 .vanilla-message-user-bubble p {
   margin: 0;
+  color: inherit;
 }
 
 .vanilla-message-user-bubble p + p {
@@ -1322,6 +1323,12 @@
 .vanilla-message-user-bubble li {
   margin: 0.25rem 0;
   padding-left: 0.25rem;
+  color: inherit;
+}
+
+.vanilla-message-assistant-bubble p,
+.vanilla-message-assistant-bubble li {
+  color: inherit;
 }
 
 /* ============================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/persona",
-  "version": "3.1.0",
+  "version": "3.1.1",
   "description": "Themeable, pluggable streaming agent widget for websites, in plain JS with support for voice input and reasoning / tool output.",
   "type": "module",
   "main": "dist/index.cjs",

package/src/styles/widget.css

@@ -1299,6 +1299,7 @@
 /* Ensure user message paragraphs and lists have proper styling too */
 .vanilla-message-user-bubble p {
   margin: 0;
+  color: inherit;
 }
 
 .vanilla-message-user-bubble p + p {
@@ -1322,6 +1323,12 @@
 .vanilla-message-user-bubble li {
   margin: 0.25rem 0;
   padding-left: 0.25rem;
+  color: inherit;
+}
+
+.vanilla-message-assistant-bubble p,
+.vanilla-message-assistant-bubble li {
+  color: inherit;
 }
 
 /* ============================================

package/src/types.ts

@@ -2346,11 +2346,15 @@ export type AgentWidgetConfig = {
    *
    * This hook runs synchronously and must return the (potentially modified) state.
    *
+   * Returning `{ state, open: true }` also signals that the widget panel should
+   * open after initialization — useful when injecting a post-navigation message
+   * that the user should immediately see.
+   *
    * @example
    * ```typescript
+   * // Plain state transform (existing form, still supported)
    * config: {
    *   onStateLoaded: (state) => {
-   *     // Check for pending navigation message
    *     const navMessage = consumeNavigationFlag();
    *     if (navMessage) {
    *       return {
@@ -2367,8 +2371,34 @@ export type AgentWidgetConfig = {
    *   }
    * }
    * ```
+   *
+   * @example
+   * ```typescript
+   * // Return { state, open: true } to also open the panel
+   * config: {
+   *   onStateLoaded: (state) => {
+   *     const navMessage = consumeNavigationFlag();
+   *     if (navMessage) {
+   *       return {
+   *         state: {
+   *           ...state,
+   *           messages: [...(state.messages || []), {
+   *             id: `nav-${Date.now()}`,
+   *             role: 'assistant',
+   *             content: navMessage,
+   *             createdAt: new Date().toISOString()
+   *           }]
+   *         },
+   *         open: true
+   *       };
+   *     }
+   *     return state;
+   *   }
+   * }
+   * ```
    */
-  onStateLoaded?: (state: AgentWidgetStoredState) => AgentWidgetStoredState;
+  onStateLoaded?: (state: AgentWidgetStoredState) =>
+    AgentWidgetStoredState | { state: AgentWidgetStoredState; open?: boolean };
   /**
    * Registry of custom components that can be rendered from JSON directives.
    * Components are registered by name and can be invoked via JSON responses

package/src/ui.ts

@@ -412,11 +412,20 @@ export const createAgentExperience = (
   let persistentMetadata: Record<string, unknown> = {};
   let pendingStoredState: Promise<AgentWidgetStoredState | null> | null = null;
 
-  // Helper to apply onStateLoaded hook and extract state
+  let shouldOpenAfterStateLoaded = false;
+
+  // Helper to apply onStateLoaded hook and extract state.
+  // Supports both the legacy plain-state return and the new { state, open? } return.
   const applyStateLoadedHook = (state: AgentWidgetStoredState): AgentWidgetStoredState => {
     if (config.onStateLoaded) {
       try {
-        return config.onStateLoaded(state);
+        const result = config.onStateLoaded(state);
+        if (result && typeof result === 'object' && 'state' in result) {
+          const { state: processedState, open } = result as { state: AgentWidgetStoredState; open?: boolean };
+          if (open) shouldOpenAfterStateLoaded = true;
+          return processedState;
+        }
+        return result as AgentWidgetStoredState;
       } catch (error) {
         if (typeof console !== "undefined") {
           // eslint-disable-next-line no-console
@@ -5379,6 +5388,13 @@ export const createAgentExperience = (
     }
   }
 
+  // If onStateLoaded signalled open: true, open the panel after init.
+  // Mirrors the same setTimeout(0) pattern used by persistState restore so both
+  // can fire independently without interfering with each other.
+  if (shouldOpenAfterStateLoaded && launcherEnabled) {
+    setTimeout(() => { controller.open(); }, 0);
+  }
+
   return controller;
 };