@luzmo/analytics-components-kit 1.0.3-beta.5 → 1.0.3-beta.7

package/custom-elements.json

@@ -4,70 +4,181 @@
   "modules": [
     {
       "kind": "javascript-module",
-      "path": "src/components/ai-chat/ai-chat-streaming.ts",
+      "path": "src/components/ai-chat/ai-chat-request.ts",
       "declarations": [
         {
           "kind": "function",
-          "name": "createInitialProgress",
+          "name": "getAiPromptUrl",
           "return": {
             "type": {
-              "text": "ProgressTreeNode"
+              "text": "string"
             }
-          }
+          },
+          "parameters": [
+            {
+              "name": "apiUrl",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "apiVersion",
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
         },
         {
           "kind": "function",
-          "name": "hasProgressChunk",
+          "name": "chartToItemAsset",
           "return": {
             "type": {
-              "text": "boolean"
+              "text": "Record<string, unknown> | null"
             }
           },
           "parameters": [
             {
-              "name": "value",
+              "name": "chart",
               "type": {
-                "text": "Record<string, unknown>"
+                "text": "LuzmoChart"
               }
             }
           ]
         },
         {
           "kind": "function",
-          "name": "fetchStreamingResponse",
+          "name": "buildItemAiPromptProperties",
           "return": {
             "type": {
-              "text": "Promise<StreamingResponse>"
+              "text": "AiPromptProperties"
             }
           },
           "parameters": [
             {
-              "name": "options",
+              "name": "ctx",
               "type": {
-                "text": "StreamingRequestOptions"
+                "text": "BuildAiPromptRequestContext"
               }
             }
           ]
         },
         {
           "kind": "function",
-          "name": "readNdjsonStream",
+          "name": "buildDashboardAiPromptProperties",
           "return": {
             "type": {
-              "text": "Promise<void>"
+              "text": "AiPromptProperties"
             }
           },
           "parameters": [
             {
-              "name": "body",
+              "name": "ctx",
               "type": {
-                "text": "ReadableStream<Uint8Array>"
+                "text": "BuildAiPromptRequestContext"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "buildAnalystAiPromptProperties",
+          "return": {
+            "type": {
+              "text": "AiPromptProperties"
+            }
+          },
+          "parameters": [
+            {
+              "name": "ctx",
+              "type": {
+                "text": "BuildAiPromptRequestContext"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "buildAiPromptProperties",
+          "return": {
+            "type": {
+              "text": "AiPromptProperties"
+            }
+          },
+          "parameters": [
+            {
+              "name": "agent",
+              "type": {
+                "text": "AiPromptAgent"
               }
             },
             {
-              "name": "onChunk",
+              "name": "ctx",
               "type": {
-                "text": "(chunk: Record<string, unknown>) => void"
+                "text": "BuildAiPromptRequestContext"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "buildAiPromptRequest",
+          "return": {
+            "type": {
+              "text": "AiPromptCreateBody"
+            }
+          },
+          "parameters": [
+            {
+              "name": "agent",
+              "type": {
+                "text": "AiPromptAgent"
+              }
+            },
+            {
+              "name": "ctx",
+              "type": {
+                "text": "BuildAiPromptRequestContext"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "buildAiPromptDeleteRequest",
+          "return": {
+            "type": {
+              "text": "AiPromptDeleteBody"
+            }
+          },
+          "parameters": [
+            {
+              "name": "restoreToMessageId",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "authKey",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "authToken",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "apiVersion",
+              "default": "'0.1.0'"
+            },
+            {
+              "name": "conversationId",
+              "default": "null",
+              "type": {
+                "text": "string | null"
               }
             }
           ]
@@ -76,34 +187,162 @@
       "exports": [
         {
           "kind": "js",
-          "name": "createInitialProgress",
+          "name": "AiPromptAgent",
           "declaration": {
-            "name": "createInitialProgress",
-            "module": "src/components/ai-chat/ai-chat-streaming.ts"
+            "name": "AiPromptAgent",
+            "module": "./ai-prompt-types"
           }
         },
         {
           "kind": "js",
-          "name": "hasProgressChunk",
+          "name": "AiPromptCreateBody",
           "declaration": {
-            "name": "hasProgressChunk",
-            "module": "src/components/ai-chat/ai-chat-streaming.ts"
+            "name": "AiPromptCreateBody",
+            "module": "./ai-prompt-types"
           }
         },
         {
           "kind": "js",
-          "name": "fetchStreamingResponse",
+          "name": "AiPromptDeleteBody",
           "declaration": {
-            "name": "fetchStreamingResponse",
-            "module": "src/components/ai-chat/ai-chat-streaming.ts"
+            "name": "AiPromptDeleteBody",
+            "module": "./ai-prompt-types"
           }
         },
         {
           "kind": "js",
-          "name": "readNdjsonStream",
+          "name": "AiPromptInput",
           "declaration": {
-            "name": "readNdjsonStream",
-            "module": "src/components/ai-chat/ai-chat-streaming.ts"
+            "name": "AiPromptInput",
+            "module": "./ai-prompt-types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AiPromptItemTask",
+          "declaration": {
+            "name": "AiPromptItemTask",
+            "module": "./ai-prompt-types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AiPromptProperties",
+          "declaration": {
+            "name": "AiPromptProperties",
+            "module": "./ai-prompt-types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AiPromptScreenMode",
+          "declaration": {
+            "name": "AiPromptScreenMode",
+            "module": "./ai-prompt-types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "BuildAiPromptRequestContext",
+          "declaration": {
+            "name": "BuildAiPromptRequestContext",
+            "module": "./ai-prompt-types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "DashboardStatePayload",
+          "declaration": {
+            "name": "DashboardStatePayload",
+            "module": "./ai-prompt-types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "LuzmoDashboardGeneratedEventDetail",
+          "declaration": {
+            "name": "LuzmoDashboardGeneratedEventDetail",
+            "module": "./ai-prompt-types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "LuzmoPromptSubmittedEventDetail",
+          "declaration": {
+            "name": "LuzmoPromptSubmittedEventDetail",
+            "module": "./ai-prompt-types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "LuzmoRestoreRequestedEventDetail",
+          "declaration": {
+            "name": "LuzmoRestoreRequestedEventDetail",
+            "module": "./ai-prompt-types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getAiPromptUrl",
+          "declaration": {
+            "name": "getAiPromptUrl",
+            "module": "src/components/ai-chat/ai-chat-request.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "chartToItemAsset",
+          "declaration": {
+            "name": "chartToItemAsset",
+            "module": "src/components/ai-chat/ai-chat-request.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "buildItemAiPromptProperties",
+          "declaration": {
+            "name": "buildItemAiPromptProperties",
+            "module": "src/components/ai-chat/ai-chat-request.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "buildDashboardAiPromptProperties",
+          "declaration": {
+            "name": "buildDashboardAiPromptProperties",
+            "module": "src/components/ai-chat/ai-chat-request.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "buildAnalystAiPromptProperties",
+          "declaration": {
+            "name": "buildAnalystAiPromptProperties",
+            "module": "src/components/ai-chat/ai-chat-request.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "buildAiPromptProperties",
+          "declaration": {
+            "name": "buildAiPromptProperties",
+            "module": "src/components/ai-chat/ai-chat-request.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "buildAiPromptRequest",
+          "declaration": {
+            "name": "buildAiPromptRequest",
+            "module": "src/components/ai-chat/ai-chat-request.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "buildAiPromptDeleteRequest",
+          "declaration": {
+            "name": "buildAiPromptDeleteRequest",
+            "module": "src/components/ai-chat/ai-chat-request.ts"
           }
         }
       ]
@@ -133,7 +372,7 @@
                 "text": "ChatMessage[]"
               },
               "default": "[]",
-              "description": "Array of chat messages to display",
+              "description": "Live transcript is AiChatSession.state.messages. This prop optionally seeds the session on first connect.",
               "attribute": "messages"
             },
             {
@@ -143,7 +382,7 @@
                 "text": "Dataset[]"
               },
               "default": "[]",
-              "description": "Array of selected datasets for the input",
+              "description": "Live selection is in the session. This prop optionally seeds on first connect.",
               "attribute": "selected-datasets"
             },
             {
@@ -289,33 +528,42 @@
             },
             {
               "kind": "field",
-              "name": "modelPreference",
+              "name": "agent",
               "type": {
-                "text": "'performance' | 'quality'"
+                "text": "AiPromptAgent"
               },
-              "default": "'performance'",
-              "description": "AI model preference for chart generation",
-              "attribute": "model-preference"
+              "default": "'item'",
+              "description": "Which aiprompt agent to use. Determines request payload and stream handling.",
+              "attribute": "agent"
             },
             {
               "kind": "field",
-              "name": "requestMode",
+              "name": "task",
               "type": {
-                "text": "'internal' | 'external'"
+                "text": "AiPromptItemTask"
               },
-              "default": "'internal'",
-              "description": "Controls if API calls are handled internally or by the host application.",
-              "attribute": "request-mode"
+              "default": "'generate'",
+              "description": "Task for the item agent (`generate`, `suggest`, `describe`).",
+              "attribute": "task"
             },
             {
               "kind": "field",
-              "name": "isGenerating",
+              "name": "modelPreference",
               "type": {
-                "text": "boolean"
+                "text": "'performance' | 'quality'"
               },
-              "default": "false",
-              "description": "Used only in external request mode to reflect request lifecycle in the UI.",
-              "attribute": "is-generating"
+              "default": "'performance'",
+              "description": "AI model preference for item agent chart generation",
+              "attribute": "model-preference"
+            },
+            {
+              "kind": "field",
+              "name": "chatSession",
+              "type": {
+                "text": "AiChatSession | null"
+              },
+              "default": "null",
+              "description": "Host-owned AiChatSession. The component subscribes and renders; does not abort on disconnect."
             },
             {
               "kind": "field",
@@ -324,7 +572,7 @@
                 "text": "string | null"
               },
               "default": "null",
-              "description": "Conversation ID",
+              "description": "Conversation ID (synced into the session; updated when the API returns a new id).",
               "attribute": "conversation-id"
             },
             {
@@ -334,9 +582,47 @@
                 "text": "LuzmoChart | null"
               },
               "default": "null",
-              "description": "vizItem",
+              "description": "Chart context for `agent=\"item\"`.",
               "attribute": "chart"
             },
+            {
+              "kind": "field",
+              "name": "dashboard",
+              "type": {
+                "text": "DashboardStatePayload | null"
+              },
+              "default": "null",
+              "description": "Dashboard context for `agent=\"dashboard\"`.",
+              "attribute": "dashboard"
+            },
+            {
+              "kind": "field",
+              "name": "currentScreenMode",
+              "type": {
+                "text": "AiPromptScreenMode | undefined"
+              },
+              "description": "Current screen mode when editing a dashboard.",
+              "attribute": "current-screen-mode"
+            },
+            {
+              "kind": "field",
+              "name": "localeId",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Locale ID sent to the aiprompt API.",
+              "attribute": "locale-id"
+            },
+            {
+              "kind": "field",
+              "name": "timezoneId",
+              "type": {
+                "text": "string"
+              },
+              "default": "'UTC'",
+              "description": "Timezone ID for dashboard agent requests.",
+              "attribute": "timezone-id"
+            },
             {
               "kind": "field",
               "name": "apiVersion",
@@ -364,7 +650,7 @@
                 "text": "string | null"
               },
               "default": "null",
-              "description": "Loading message shown while generating and before progress steps are available.\nOnly effective in external request mode; in internal mode, progress steps\nare initialized immediately.",
+              "description": "Loading message shown while generating and before progress steps are available.",
               "attribute": "loading-message"
             },
             {
@@ -374,36 +660,54 @@
                 "text": "string | null"
               },
               "default": "null",
-              "description": "When set, the component auto-submits this prompt via the streaming API\nwithout adding a duplicate user message (assumes it is already in `messages`).\nUseful when the prompt originates from an external source (e.g. a dropdown).",
+              "description": "When set, auto-submits via the session without adding a duplicate user message\n(assumes the prompt is already in the transcript).",
               "attribute": "initial-prompt"
             },
             {
               "kind": "field",
-              "name": "progress",
+              "name": "emptyStateTitle",
               "type": {
-                "text": "ProgressTreeNode | null"
+                "text": "string"
               },
-              "default": "null",
-              "description": "Progress tree for external request mode. Ignored in internal mode.",
-              "attribute": "progress"
+              "default": "''",
+              "description": "Title for the empty state when there are no messages.",
+              "attribute": "empty-state-title"
             },
             {
               "kind": "field",
-              "name": "progressCollapsed",
+              "name": "emptyStateSubtitle",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Whether progress steps should be shown collapsed.\nOnly used in external request mode. Ignored in internal mode.",
-              "attribute": "progress-collapsed"
+              "default": "''",
+              "description": "Optional label above empty-state suggestion chips. Only shown when `emptyStateSuggestions` is non-empty.",
+              "attribute": "empty-state-subtitle"
             },
             {
+              "kind": "field",
+              "name": "emptyStateSuggestions",
               "type": {
-                "text": "string"
+                "text": "AiChatEmptyStateSuggestion[]"
               },
-              "description": "Background of the chat container",
-              "name": "--luzmo-ai-chat-background",
-              "kind": "field"
+              "default": "[]",
+              "description": "Optional suggestion chips for the empty state. When empty, only the title is shown.\nEach entry may include `selectedDatasets` to pre-select datasets when the chip is activated."
+            },
+            {
+              "kind": "field",
+              "name": "session",
+              "type": {
+                "text": "AiChatSession | null"
+              },
+              "description": "Active AiChatSession (host or auto-created). Null until first bind or action.",
+              "readonly": true
+            },
+            {
+              "type": {
+                "text": "string"
+              },
+              "description": "Background of the chat container",
+              "name": "--luzmo-ai-chat-background",
+              "kind": "field"
             },
             {
               "type": {
@@ -600,45 +904,45 @@
           ],
           "events": [
             {
-              "name": "luzmo-response-received",
+              "name": "luzmo-message-sent",
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired when an AI text response is received. For chart responses, this event is only fired if the response includes a `message` field. For error responses, this event is always fired with the error explanation."
+              "description": "Fired when a user sends a message"
             },
             {
-              "name": "luzmo-chart-generated",
+              "name": "luzmo-datasets-changed",
               "type": {
                 "text": "CustomEvent"
-              },
-              "description": "Fired when the AI generates a chart (includes generatedChart in response)"
+              }
             },
             {
-              "name": "luzmo-message-sent",
+              "name": "luzmo-chart-generated",
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired when a user sends a message"
+              "description": "Fired when agent is `item` and a chart asset is ready"
             },
             {
-              "name": "luzmo-restore-requested",
+              "name": "luzmo-dashboard-generated",
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired when a restore action is triggered in external mode"
+              "description": "Fired when agent is `dashboard` and a dashboard asset is ready"
             },
             {
-              "name": "luzmo-datasets-changed",
+              "name": "luzmo-response-received",
               "type": {
                 "text": "CustomEvent"
-              }
+              },
+              "description": "Fired when an AI text response is received. For chart responses, this event is only fired if the response includes a `message` field. For error responses, this event is always fired with the error explanation."
             },
             {
-              "name": "luzmo-prompt-submitted",
+              "name": "luzmo-conversation-id-changed",
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired when request-mode is set to external so the host can execute the API request lifecycle."
+              "description": "Fired when the conversation ID is updated from the API"
             }
           ],
           "attributes": [
@@ -648,7 +952,7 @@
                 "text": "ChatMessage[]"
               },
               "default": "[]",
-              "description": "Array of chat messages to display",
+              "description": "Live transcript is AiChatSession.state.messages. This prop optionally seeds the session on first connect.",
               "fieldName": "messages"
             },
             {
@@ -657,7 +961,7 @@
                 "text": "Dataset[]"
               },
               "default": "[]",
-              "description": "Array of selected datasets for the input",
+              "description": "Live selection is in the session. This prop optionally seeds on first connect.",
               "fieldName": "selectedDatasets"
             },
             {
@@ -787,31 +1091,31 @@
               "fieldName": "requireDataset"
             },
             {
-              "name": "model-preference",
+              "name": "agent",
               "type": {
-                "text": "'performance' | 'quality'"
+                "text": "AiPromptAgent"
               },
-              "default": "'performance'",
-              "description": "AI model preference for chart generation",
-              "fieldName": "modelPreference"
+              "default": "'item'",
+              "description": "Which aiprompt agent to use. Determines request payload and stream handling.",
+              "fieldName": "agent"
             },
             {
-              "name": "request-mode",
+              "name": "task",
               "type": {
-                "text": "'internal' | 'external'"
+                "text": "AiPromptItemTask"
               },
-              "default": "'internal'",
-              "description": "Controls if API calls are handled internally or by the host application.",
-              "fieldName": "requestMode"
+              "default": "'generate'",
+              "description": "Task for the item agent (`generate`, `suggest`, `describe`).",
+              "fieldName": "task"
             },
             {
-              "name": "is-generating",
+              "name": "model-preference",
               "type": {
-                "text": "boolean"
+                "text": "'performance' | 'quality'"
               },
-              "default": "false",
-              "description": "Used only in external request mode to reflect request lifecycle in the UI.",
-              "fieldName": "isGenerating"
+              "default": "'performance'",
+              "description": "AI model preference for item agent chart generation",
+              "fieldName": "modelPreference"
             },
             {
               "name": "conversation-id",
@@ -819,7 +1123,7 @@
                 "text": "string | null"
               },
               "default": "null",
-              "description": "Conversation ID",
+              "description": "Conversation ID (synced into the session; updated when the API returns a new id).",
               "fieldName": "conversationId"
             },
             {
@@ -828,9 +1132,43 @@
                 "text": "LuzmoChart | null"
               },
               "default": "null",
-              "description": "vizItem",
+              "description": "Chart context for `agent=\"item\"`.",
               "fieldName": "chart"
             },
+            {
+              "name": "dashboard",
+              "type": {
+                "text": "DashboardStatePayload | null"
+              },
+              "default": "null",
+              "description": "Dashboard context for `agent=\"dashboard\"`.",
+              "fieldName": "dashboard"
+            },
+            {
+              "name": "current-screen-mode",
+              "type": {
+                "text": "AiPromptScreenMode | undefined"
+              },
+              "description": "Current screen mode when editing a dashboard.",
+              "fieldName": "currentScreenMode"
+            },
+            {
+              "name": "locale-id",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Locale ID sent to the aiprompt API.",
+              "fieldName": "localeId"
+            },
+            {
+              "name": "timezone-id",
+              "type": {
+                "text": "string"
+              },
+              "default": "'UTC'",
+              "description": "Timezone ID for dashboard agent requests.",
+              "fieldName": "timezoneId"
+            },
             {
               "name": "api-version",
               "type": {
@@ -855,116 +1193,1283 @@
                 "text": "string | null"
               },
               "default": "null",
-              "description": "Loading message shown while generating and before progress steps are available.\nOnly effective in external request mode; in internal mode, progress steps\nare initialized immediately.",
+              "description": "Loading message shown while generating and before progress steps are available.",
               "fieldName": "loadingMessage"
             },
             {
-              "name": "initial-prompt",
+              "name": "initial-prompt",
+              "type": {
+                "text": "string | null"
+              },
+              "default": "null",
+              "description": "When set, auto-submits via the session without adding a duplicate user message\n(assumes the prompt is already in the transcript).",
+              "fieldName": "initialPrompt"
+            },
+            {
+              "name": "empty-state-title",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Title for the empty state when there are no messages.",
+              "fieldName": "emptyStateTitle"
+            },
+            {
+              "name": "empty-state-subtitle",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Optional label above empty-state suggestion chips. Only shown when `emptyStateSuggestions` is non-empty.",
+              "fieldName": "emptyStateSubtitle"
+            }
+          ],
+          "superclass": {
+            "name": "LuzmoElement",
+            "package": "@utils/base"
+          },
+          "tagName": "luzmo-ai-chat",
+          "customElement": true,
+          "summary": "AI chat UI backed by AiChatSession for transcript, datasets, and streaming."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "LuzmoAiChat",
+          "declaration": {
+            "name": "LuzmoAiChat",
+            "module": "src/components/ai-chat/ai-chat.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/ai-prompt-types.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/empty-state/ai-chat-empty-state.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "LuzmoAiChatEmptyState",
+          "members": [
+            {
+              "kind": "field",
+              "name": "tagName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "default": "'luzmo-ai-chat-empty-state'"
+            },
+            {
+              "kind": "field",
+              "name": "title",
+              "description": "Heading shown above the suggestions.",
+              "attribute": "title"
+            },
+            {
+              "kind": "field",
+              "name": "subtitle",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Supporting text shown above suggestion chips when `suggestions` is non-empty.",
+              "attribute": "subtitle"
+            },
+            {
+              "kind": "field",
+              "name": "suggestions",
+              "type": {
+                "text": "AiChatEmptyStateSuggestion[]"
+              },
+              "default": "[]",
+              "description": "Suggestion chips rendered with https://lucero.luzmo.com/ | Lucero `luzmo-suggestion` (`variant=\"prompt\"`).",
+              "attribute": "suggestions"
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, suggestion chips cannot be activated.",
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "type": {
+                "text": "string"
+              },
+              "description": "Gap between the title and the actions block",
+              "name": "--luzmo-ai-chat-empty-state-header-actions-gap",
+              "kind": "field"
+            },
+            {
+              "type": {
+                "text": "string"
+              },
+              "description": "Gap between the actions label and suggestion chips",
+              "name": "--luzmo-ai-chat-empty-state-actions-gap",
+              "kind": "field"
+            },
+            {
+              "type": {
+                "text": "string"
+              },
+              "description": "Gap between suggestion chips",
+              "name": "--luzmo-ai-chat-empty-state-suggestions-gap",
+              "kind": "field"
+            },
+            {
+              "type": {
+                "text": "string"
+              },
+              "description": "Maximum content width",
+              "name": "--luzmo-ai-chat-empty-state-max-width",
+              "kind": "field"
+            },
+            {
+              "type": {
+                "text": "string"
+              },
+              "description": "Vertical padding",
+              "name": "--luzmo-ai-chat-empty-state-padding-block",
+              "kind": "field"
+            },
+            {
+              "type": {
+                "text": "string"
+              },
+              "description": "Horizontal padding",
+              "name": "--luzmo-ai-chat-empty-state-padding-inline",
+              "kind": "field"
+            },
+            {
+              "type": {
+                "text": "string"
+              },
+              "description": "Title font size",
+              "name": "--luzmo-ai-chat-empty-state-title-font-size",
+              "kind": "field"
+            },
+            {
+              "type": {
+                "text": "string"
+              },
+              "description": "Title font weight",
+              "name": "--luzmo-ai-chat-empty-state-title-font-weight",
+              "kind": "field"
+            },
+            {
+              "type": {
+                "text": "string"
+              },
+              "description": "Title line height",
+              "name": "--luzmo-ai-chat-empty-state-title-line-height",
+              "kind": "field"
+            },
+            {
+              "type": {
+                "text": "string"
+              },
+              "description": "Title text color",
+              "name": "--luzmo-ai-chat-empty-state-title-color",
+              "kind": "field"
+            },
+            {
+              "type": {
+                "text": "string"
+              },
+              "description": "Subtitle font size",
+              "name": "--luzmo-ai-chat-empty-state-subtitle-font-size",
+              "kind": "field"
+            },
+            {
+              "type": {
+                "text": "string"
+              },
+              "description": "Subtitle font weight",
+              "name": "--luzmo-ai-chat-empty-state-subtitle-font-weight",
+              "kind": "field"
+            },
+            {
+              "type": {
+                "text": "string"
+              },
+              "description": "Subtitle line height",
+              "name": "--luzmo-ai-chat-empty-state-subtitle-line-height",
+              "kind": "field"
+            },
+            {
+              "type": {
+                "text": "string"
+              },
+              "description": "Subtitle text color (`--luzmo-font-color-dimmed`)",
+              "name": "--luzmo-ai-chat-empty-state-subtitle-color",
+              "kind": "field"
+            }
+          ],
+          "events": [
+            {
+              "name": "luzmo-suggestion-selected",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired when the user selects a suggestion chip. `event.detail`: `{ label, prompt, selectedDatasets? }`."
+            }
+          ],
+          "attributes": [
+            {
+              "name": "title",
+              "description": "Heading shown above the suggestions.",
+              "fieldName": "title"
+            },
+            {
+              "name": "subtitle",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Supporting text shown above suggestion chips when `suggestions` is non-empty.",
+              "fieldName": "subtitle"
+            },
+            {
+              "name": "suggestions",
+              "type": {
+                "text": "AiChatEmptyStateSuggestion[]"
+              },
+              "default": "[]",
+              "description": "Suggestion chips rendered with https://lucero.luzmo.com/ | Lucero `luzmo-suggestion` (`variant=\"prompt\"`).",
+              "fieldName": "suggestions"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, suggestion chips cannot be activated.",
+              "fieldName": "disabled"
+            }
+          ],
+          "superclass": {
+            "name": "LuzmoElement",
+            "package": "@utils/base"
+          },
+          "tagName": "luzmo-ai-chat-empty-state",
+          "customElement": true,
+          "summary": "Empty state for AI chat with title, subtitle, and prompt suggestions."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "LuzmoAiChatEmptyState",
+          "declaration": {
+            "name": "LuzmoAiChatEmptyState",
+            "module": "src/components/ai-chat/empty-state/ai-chat-empty-state.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/empty-state/types.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/session/ai-chat-session-controller.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Single AiChatSession slot for `luzmo-ai-chat`.\nThe chat component uses current, state, and requireSession only.",
+          "name": "AiChatSessionController",
+          "members": [
+            {
+              "kind": "field",
+              "name": "current",
+              "type": {
+                "text": "AiChatSession | null"
+              },
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "state",
+              "type": {
+                "text": "Readonly<AiChatSessionState>"
+              },
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "ownsCurrentSession",
+              "type": {
+                "text": "boolean"
+              },
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "setSession",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "session",
+                  "type": {
+                    "text": "AiChatSession | null"
+                  }
+                }
+              ],
+              "description": "Use an app-provided session (e.g. from `.chatSession`).\nPass `null` to clear it; an owned session may be created later via requireSession."
+            },
+            {
+              "kind": "method",
+              "name": "syncProperties",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "changedProperties",
+                  "type": {
+                    "text": "Map<string, unknown>"
+                  }
+                }
+              ],
+              "description": "Sync config / seed props after Lit `updated`.\nCall after handling `chatSession` via setSession."
+            },
+            {
+              "kind": "method",
+              "name": "requireSession",
+              "return": {
+                "type": {
+                  "text": "AiChatSession"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "connect",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Re-attach UI bridge and state subscription after teardown on reconnect."
+            },
+            {
+              "kind": "method",
+              "name": "teardown",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AiChatSessionController",
+          "declaration": {
+            "name": "AiChatSessionController",
+            "module": "src/components/ai-chat/session/ai-chat-session-controller.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/session/ai-chat-session-types.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AiPromptCreateBody",
+          "declaration": {
+            "name": "AiPromptCreateBody",
+            "module": "src/components/ai-chat/session/ai-chat-session-types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AiPromptDeleteBody",
+          "declaration": {
+            "name": "AiPromptDeleteBody",
+            "module": "src/components/ai-chat/session/ai-chat-session-types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "LuzmoPromptSubmittedEventDetail",
+          "declaration": {
+            "name": "LuzmoPromptSubmittedEventDetail",
+            "module": "src/components/ai-chat/session/ai-chat-session-types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "LuzmoRestoreRequestedEventDetail",
+          "declaration": {
+            "name": "LuzmoRestoreRequestedEventDetail",
+            "module": "src/components/ai-chat/session/ai-chat-session-types.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/session/ai-chat-session.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Headless chat controller: transcript, datasets, streaming, and API calls without a DOM host.\nUse with `luzmo-ai-chat` via `.chatSession` for the same simplicity as internal mode,\nwhile keeping the session alive when the panel unmounts.",
+          "name": "AiChatSession",
+          "members": [
+            {
+              "kind": "field",
+              "name": "state",
+              "type": {
+                "text": "Readonly<AiChatSessionState>"
+              },
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "isGenerating",
+              "type": {
+                "text": "boolean"
+              },
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "subscribe",
+              "return": {
+                "type": {
+                  "text": "() => void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "listener",
+                  "type": {
+                    "text": "(state: AiChatSessionState) => void"
+                  }
+                }
+              ],
+              "description": "Subscribe to full session state (for `luzmo-ai-chat` rendering). Returns an unsubscribe function.\nThe listener is invoked immediately with the current state."
+            },
+            {
+              "kind": "method",
+              "name": "setUiBridge",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "bridge",
+                  "type": {
+                    "text": "AiChatSessionCallbacks"
+                  }
+                }
+              ],
+              "description": "Wire `luzmo-ai-chat` DOM event bridging. Safe to call again when hot-swapping the same\nsession back onto the component — replaces the previous bridge instead of stacking it."
+            },
+            {
+              "kind": "method",
+              "name": "updateConfig",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "partial",
+                  "type": {
+                    "text": "Partial<AiChatSessionConfig>"
+                  }
+                }
+              ],
+              "description": "Merge config (chart, conversationId, agent, …) without aborting an in-flight request."
+            },
+            {
+              "kind": "method",
+              "name": "setSelectedDatasets",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "datasets",
+                  "type": {
+                    "text": "Dataset[]"
+                  }
+                }
+              ],
+              "description": "Replace the full dataset selection (e.g. when the dashboard context changes)."
+            },
+            {
+              "kind": "method",
+              "name": "addDataset",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "dataset",
+                  "type": {
+                    "text": "Dataset"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "removeDataset",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "datasetId",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "isDatasetRequirementMet",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getAiPromptUrl",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "buildRequestBody",
+              "return": {
+                "type": {
+                  "text": "AiPromptCreateBody"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "prompt",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "datasetIds",
+                  "type": {
+                    "text": "string[]"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "buildPromptSubmittedDetail",
+              "return": {
+                "type": {
+                  "text": "LuzmoPromptSubmittedEventDetail"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "prompt",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "selectedDatasets",
+                  "type": {
+                    "text": "Dataset[]"
+                  }
+                },
+                {
+                  "name": "datasetIds",
+                  "type": {
+                    "text": "string[]"
+                  }
+                }
+              ],
+              "description": "Same payload passed to AiChatSessionCallbacks.onPromptSubmitted."
+            },
+            {
+              "kind": "method",
+              "name": "submit",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "params",
+                  "type": {
+                    "text": "AiChatSessionSubmitParams"
+                  }
+                }
+              ],
+              "description": "Append the user prompt (unless `skipUserMessage`), start streaming, and update state."
+            },
+            {
+              "kind": "method",
+              "name": "restore",
+              "return": {
+                "type": {
+                  "text": "Promise<AiChatSessionRestoreResult>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "params",
+                  "type": {
+                    "text": "AiChatSessionRestoreParams"
+                  }
+                }
+              ],
+              "description": "Item agent only — restore conversation to a prior API message."
+            },
+            {
+              "kind": "method",
+              "name": "buildRestoreRequest",
+              "return": {
+                "type": {
+                  "text": "AiPromptDeleteBody"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "restoreToMessageId",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "abort",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Cancel the in-flight fetch. Does not clear conversation state."
+            }
+          ]
+        },
+        {
+          "kind": "variable",
+          "name": "aiMessage",
+          "type": {
+            "text": "ChatMessage"
+          },
+          "default": "{ id: params.aiMessageId ?? generateMessageId(), type: 'ai', message: '' }"
+        },
+        {
+          "kind": "function",
+          "name": "createAiChatSession",
+          "return": {
+            "type": {
+              "text": "AiChatSession"
+            }
+          },
+          "parameters": [
+            {
+              "name": "config",
+              "type": {
+                "text": "AiChatSessionConfig"
+              }
+            },
+            {
+              "name": "callbacks",
+              "optional": true,
+              "type": {
+                "text": "AiChatSessionCallbacks"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AiChatSession",
+          "declaration": {
+            "name": "AiChatSession",
+            "module": "src/components/ai-chat/session/ai-chat-session.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "createAiChatSession",
+          "declaration": {
+            "name": "createAiChatSession",
+            "module": "src/components/ai-chat/session/ai-chat-session.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/stream/ai-chat-streaming.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "createInitialProgress",
+          "return": {
+            "type": {
+              "text": "ProgressTreeNode"
+            }
+          }
+        },
+        {
+          "kind": "function",
+          "name": "hasProgressChunk",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "value",
+              "type": {
+                "text": "Record<string, unknown>"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "fetchStreamingResponse",
+          "return": {
+            "type": {
+              "text": "Promise<StreamingResponse>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "options",
+              "type": {
+                "text": "StreamingRequestOptions"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "parseStreamLine",
+          "return": {
+            "type": {
+              "text": "Record<string, unknown> | null"
+            }
+          },
+          "parameters": [
+            {
+              "name": "line",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Parse one line from an aiprompt response stream.\nSupports plain NDJSON (`{\"type\":\"progress\",...}`) and SSE (`data: {...}`)."
+        },
+        {
+          "kind": "function",
+          "name": "readNdjsonStream",
+          "return": {
+            "type": {
+              "text": "Promise<void>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "body",
+              "type": {
+                "text": "ReadableStream<Uint8Array>"
+              }
+            },
+            {
+              "name": "onChunk",
+              "type": {
+                "text": "(chunk: Record<string, unknown>) => void"
+              }
+            }
+          ],
+          "description": "Read NDJSON or SSE (`data:`) chunks from a streaming aiprompt response body."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "createInitialProgress",
+          "declaration": {
+            "name": "createInitialProgress",
+            "module": "src/components/ai-chat/stream/ai-chat-streaming.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "hasProgressChunk",
+          "declaration": {
+            "name": "hasProgressChunk",
+            "module": "src/components/ai-chat/stream/ai-chat-streaming.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "fetchStreamingResponse",
+          "declaration": {
+            "name": "fetchStreamingResponse",
+            "module": "src/components/ai-chat/stream/ai-chat-streaming.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "parseStreamLine",
+          "declaration": {
+            "name": "parseStreamLine",
+            "module": "src/components/ai-chat/stream/ai-chat-streaming.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "readNdjsonStream",
+          "declaration": {
+            "name": "readNdjsonStream",
+            "module": "src/components/ai-chat/stream/ai-chat-streaming.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/stream/analyst-handler.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "processAnalystStreamChunk",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "chunk",
+              "type": {
+                "text": "Record<string, unknown>"
+              }
+            },
+            {
+              "name": "ctx",
+              "type": {
+                "text": "StreamHandlerContext"
+              }
+            }
+          ],
+          "description": "Minimal analyst stream handling: text, progress, and errors."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "processAnalystStreamChunk",
+          "declaration": {
+            "name": "processAnalystStreamChunk",
+            "module": "src/components/ai-chat/stream/analyst-handler.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/stream/dashboard-handler.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "processDashboardStreamChunk",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "chunk",
+              "type": {
+                "text": "Record<string, unknown>"
+              }
+            },
+            {
+              "name": "ctx",
+              "type": {
+                "text": "StreamHandlerContext"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "getDashboardSnapshot",
+          "return": {
+            "type": {
+              "text": "DashboardStatePayload | null"
+            }
+          },
+          "parameters": [
+            {
+              "name": "state",
+              "type": {
+                "text": "StreamHandlerContext['state']"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "processDashboardStreamChunk",
+          "declaration": {
+            "name": "processDashboardStreamChunk",
+            "module": "src/components/ai-chat/stream/dashboard-handler.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getDashboardSnapshot",
+          "declaration": {
+            "name": "getDashboardSnapshot",
+            "module": "src/components/ai-chat/stream/dashboard-handler.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/stream/item-handler.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "processItemStreamChunk",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "chunk",
               "type": {
-                "text": "string | null"
-              },
-              "default": "null",
-              "description": "When set, the component auto-submits this prompt via the streaming API\nwithout adding a duplicate user message (assumes it is already in `messages`).\nUseful when the prompt originates from an external source (e.g. a dropdown).",
-              "fieldName": "initialPrompt"
+                "text": "Record<string, unknown>"
+              }
             },
             {
-              "name": "progress",
+              "name": "ctx",
               "type": {
-                "text": "ProgressTreeNode | null"
-              },
-              "default": "null",
-              "description": "Progress tree for external request mode. Ignored in internal mode.",
-              "fieldName": "progress"
-            },
+                "text": "StreamHandlerContext"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "processItemStreamChunk",
+          "declaration": {
+            "name": "processItemStreamChunk",
+            "module": "src/components/ai-chat/stream/item-handler.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/stream/registry.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "createStreamHandler",
+          "return": {
+            "type": {
+              "text": "StreamChunkProcessor"
+            }
+          },
+          "parameters": [
             {
-              "name": "progress-collapsed",
+              "name": "agent",
               "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether progress steps should be shown collapsed.\nOnly used in external request mode. Ignored in internal mode.",
-              "fieldName": "progressCollapsed"
+                "text": "AiPromptAgent"
+              }
             }
-          ],
-          "superclass": {
-            "name": "LuzmoElement",
-            "package": "@utils/base"
-          },
-          "tagName": "luzmo-ai-chat",
-          "customElement": true,
-          "summary": "A complete AI chat interface combining messages display and input"
-        },
-        {
-          "kind": "variable",
-          "name": "request"
+          ]
         },
         {
-          "kind": "variable",
-          "name": "messageIndex"
+          "kind": "function",
+          "name": "createInitialStreamState",
+          "return": {
+            "type": {
+              "text": "StreamHandlerContext['state']"
+            }
+          }
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "LuzmoAiChat",
+          "name": "createStreamHandler",
           "declaration": {
-            "name": "LuzmoAiChat",
-            "module": "src/components/ai-chat/ai-chat.ts"
+            "name": "createStreamHandler",
+            "module": "src/components/ai-chat/stream/registry.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "createInitialStreamState",
+          "declaration": {
+            "name": "createInitialStreamState",
+            "module": "src/components/ai-chat/stream/registry.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/ai-chat/request-contract.ts",
+      "path": "src/components/ai-chat/stream/shared.ts",
       "declarations": [
         {
           "kind": "function",
-          "name": "buildAiMessageRequest",
+          "name": "extractInlineStreamText",
           "return": {
             "type": {
-              "text": "AiMessageRequestBody"
+              "text": "string"
             }
           },
           "parameters": [
             {
-              "name": "options",
+              "name": "chunk",
               "type": {
-                "text": "BuildAiMessageRequestOptions"
+                "text": "Record<string, unknown>"
               }
             }
           ]
         },
         {
           "kind": "function",
-          "name": "buildAiMessageDeleteRequest",
+          "name": "extractStreamText",
           "return": {
             "type": {
-              "text": "AiMessageDeleteRequestBody"
+              "text": "string"
             }
           },
           "parameters": [
             {
-              "name": "restoreToMessageId",
+              "name": "chunk",
               "type": {
-                "text": "string"
+                "text": "Record<string, unknown>"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "isStreamDone",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "chunk",
+              "type": {
+                "text": "Record<string, unknown>"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "applyConversationId",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "chunk",
+              "type": {
+                "text": "Record<string, unknown>"
               }
             },
             {
-              "name": "authKey",
+              "name": "ctx",
               "type": {
-                "text": "string"
+                "text": "StreamHandlerContext"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "handleSharedProgress",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "chunk",
+              "type": {
+                "text": "Record<string, unknown>"
               }
             },
             {
-              "name": "authToken",
+              "name": "ctx",
+              "type": {
+                "text": "StreamHandlerContext"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "handleSharedError",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "chunk",
+              "type": {
+                "text": "Record<string, unknown>"
+              }
+            },
+            {
+              "name": "ctx",
+              "type": {
+                "text": "StreamHandlerContext"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "appendStreamText",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "ctx",
+              "type": {
+                "text": "StreamHandlerContext"
+              }
+            },
+            {
+              "name": "textContent",
               "type": {
                 "text": "string"
               }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "finalizeTextResponse",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "ctx",
+              "type": {
+                "text": "StreamHandlerContext"
+              }
             },
             {
-              "name": "apiVersion",
-              "default": "'0.1.0'"
+              "name": "isDone",
+              "type": {
+                "text": "boolean"
+              }
+            },
+            {
+              "name": "hadTextInChunk",
+              "default": "false"
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "extractChartFromChunk",
+          "return": {
+            "type": {
+              "text": "Record<string, unknown> | null"
+            }
+          },
+          "parameters": [
+            {
+              "name": "chunk",
+              "type": {
+                "text": "Record<string, unknown>"
+              }
             }
           ]
         }
@@ -972,22 +2477,84 @@
       "exports": [
         {
           "kind": "js",
-          "name": "buildAiMessageRequest",
+          "name": "extractInlineStreamText",
+          "declaration": {
+            "name": "extractInlineStreamText",
+            "module": "src/components/ai-chat/stream/shared.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "extractStreamText",
+          "declaration": {
+            "name": "extractStreamText",
+            "module": "src/components/ai-chat/stream/shared.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "isStreamDone",
+          "declaration": {
+            "name": "isStreamDone",
+            "module": "src/components/ai-chat/stream/shared.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "applyConversationId",
+          "declaration": {
+            "name": "applyConversationId",
+            "module": "src/components/ai-chat/stream/shared.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "handleSharedProgress",
+          "declaration": {
+            "name": "handleSharedProgress",
+            "module": "src/components/ai-chat/stream/shared.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "handleSharedError",
+          "declaration": {
+            "name": "handleSharedError",
+            "module": "src/components/ai-chat/stream/shared.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "appendStreamText",
           "declaration": {
-            "name": "buildAiMessageRequest",
-            "module": "src/components/ai-chat/request-contract.ts"
+            "name": "appendStreamText",
+            "module": "src/components/ai-chat/stream/shared.ts"
           }
         },
         {
           "kind": "js",
-          "name": "buildAiMessageDeleteRequest",
+          "name": "finalizeTextResponse",
           "declaration": {
-            "name": "buildAiMessageDeleteRequest",
-            "module": "src/components/ai-chat/request-contract.ts"
+            "name": "finalizeTextResponse",
+            "module": "src/components/ai-chat/stream/shared.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "extractChartFromChunk",
+          "declaration": {
+            "name": "extractChartFromChunk",
+            "module": "src/components/ai-chat/stream/shared.ts"
           }
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/stream/types.ts",
+      "declarations": [],
+      "exports": []
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/ai-interaction-textarea/ai-interaction-textarea.ts",
@@ -6285,6 +7852,17 @@
               "attribute": "view-mode",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "itemActionsDocumentPopover",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "When true (default), the item actions menu uses the Document Popover API (`popover=\"manual\"`),\nwhich paints in the top layer. Set to false when embedding the grid next to another UI that\nalso uses a document popover (e.g. an analyst side pane) so the actions menu stays in normal\nstacking with `position: fixed` + Floating UI instead.",
+              "attribute": "item-actions-document-popover",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "placementItemActionsMenu",
@@ -6482,6 +8060,15 @@
               "description": "Whether the grid is in view mode. When true, dragging, resizing and action buttons are disabled.",
               "fieldName": "viewMode"
             },
+            {
+              "name": "item-actions-document-popover",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "When true (default), the item actions menu uses the Document Popover API (`popover=\"manual\"`),\nwhich paints in the top layer. Set to false when embedding the grid next to another UI that\nalso uses a document popover (e.g. an analyst side pane) so the actions menu stays in normal\nstacking with `position: fixed` + Floating UI instead.",
+              "fieldName": "itemActionsDocumentPopover"
+            },
             {
               "name": "placement-item-actions-menu",
               "type": {
@@ -7096,7 +8683,7 @@
           },
           "parameters": [
             {
-              "name": "{\n  element,\n  activeActions,\n  getGridItemById,\n  placementItemActionsMenu,\n  renderOverlayContent,\n  removeItemActionsMenuPopover\n}",
+              "name": "{\n  element,\n  activeActions,\n  getGridItemById,\n  placementItemActionsMenu,\n  renderOverlayContent,\n  removeItemActionsMenuPopover,\n  itemActionsDocumentPopover = true\n}",
               "type": {
                 "text": "CreateItemActionsMenuPopoverArgs"
               }
@@ -7511,7 +9098,7 @@
           },
           "parameters": [
             {
-              "name": "{\n  item,\n  activeActions,\n  defaultItemActionsMenu,\n  placementItemActionsMenu,\n  language,\n  handleAction\n}",
+              "name": "{\n  item,\n  activeActions,\n  defaultItemActionsMenu,\n  placementItemActionsMenu,\n  language,\n  handleAction,\n  itemActionsDocumentPopover = true\n}",
               "type": {
                 "text": "RenderOverlayContentArgs"
               }