@luzmo/analytics-components-kit 1.0.3-beta.1 → 1.0.3-beta.10

package/custom-elements.json

@@ -4,70 +4,215 @@
   "modules": [
     {
       "kind": "javascript-module",
-      "path": "src/components/ai-chat/ai-chat-streaming.ts",
+      "path": "src/components/ai-chat/ai-chat-events.ts",
       "declarations": [
         {
           "kind": "function",
-          "name": "createInitialProgress",
+          "name": "isRecognizedStep",
           "return": {
             "type": {
-              "text": "ProgressTreeNode"
+              "text": "event is RecognizedStepEvent"
+            }
+          },
+          "parameters": [
+            {
+              "name": "event",
+              "type": {
+                "text": "AiChatStepEvent"
+              }
             }
+          ],
+          "description": "Type guard separating the typed, recognized step set from the open passthrough.\nLets consumers `switch` exhaustively on `event.type` with fully narrowed `data`."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "isRecognizedStep",
+          "declaration": {
+            "name": "isRecognizedStep",
+            "module": "src/components/ai-chat/ai-chat-events.ts"
           }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/ai-chat-request.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "getAiPromptUrl",
+          "return": {
+            "type": {
+              "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 +221,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 +406,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 +416,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"
             },
             {
@@ -279,33 +552,52 @@
             },
             {
               "kind": "field",
-              "name": "modelPreference",
+              "name": "requireDataset",
               "type": {
-                "text": "'performance' | 'quality'"
+                "text": "boolean"
               },
-              "default": "'performance'",
-              "description": "AI model preference for chart generation",
-              "attribute": "model-preference"
+              "default": "false",
+              "description": "When true, at least one dataset must be selected before the prompt can be submitted",
+              "attribute": "require-dataset"
             },
             {
               "kind": "field",
-              "name": "requestMode",
+              "name": "agent",
               "type": {
-                "text": "'internal' | 'external'"
+                "text": "AiPromptAgent"
               },
-              "default": "'internal'",
-              "description": "Controls if API calls are handled internally or by the host application.",
-              "attribute": "request-mode"
+              "default": "'item'",
+              "description": "Which aiprompt agent to use. Determines request payload and stream handling.",
+              "attribute": "agent"
             },
             {
               "kind": "field",
-              "name": "isGenerating",
+              "name": "task",
               "type": {
-                "text": "boolean"
+                "text": "AiPromptItemTask"
               },
-              "default": "false",
-              "description": "Used only in external request mode to reflect request lifecycle in the UI.",
-              "attribute": "is-generating"
+              "default": "'generate'",
+              "description": "Task for the item agent (`generate`, `suggest`, `describe`).",
+              "attribute": "task"
+            },
+            {
+              "kind": "field",
+              "name": "modelPreference",
+              "type": {
+                "text": "'performance' | 'quality'"
+              },
+              "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",
@@ -314,7 +606,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"
             },
             {
@@ -324,18 +616,56 @@
                 "text": "LuzmoChart | null"
               },
               "default": "null",
-              "description": "vizItem",
+              "description": "Chart context for `agent=\"item\"`.",
               "attribute": "chart"
             },
             {
               "kind": "field",
-              "name": "apiVersion",
+              "name": "dashboard",
               "type": {
-                "text": "string"
+                "text": "DashboardStatePayload | null"
               },
-              "default": "'0.1.0'",
-              "description": "API version",
-              "attribute": "api-version"
+              "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",
+              "type": {
+                "text": "string"
+              },
+              "default": "'0.1.0'",
+              "description": "API version",
+              "attribute": "api-version"
             },
             {
               "kind": "field",
@@ -354,7 +684,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"
             },
             {
@@ -364,28 +694,46 @@
                 "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": "AiChatEmptyStateSuggestion[]"
+              },
+              "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": {
@@ -590,45 +938,46 @@
           ],
           "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)"
+              "description": "Fired when the selected datasets change"
             },
             {
-              "name": "luzmo-message-sent",
+              "name": "luzmo-step",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<AiChatStepEvent>"
               },
-              "description": "Fired when a user sends a message"
+              "description": "Fired for every incremental, kit-assembled event during a streamed response (decision, text, progress, dashboard-title/layout/item, chart, interrupt, plus forward-by-default unrecognized chunks). Use `isRecognizedStep` to narrow."
             },
             {
-              "name": "luzmo-restore-requested",
+              "name": "luzmo-complete",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<AiChatCompleteEvent>"
               },
-              "description": "Fired when a restore action is triggered in external mode"
+              "description": "Fired exactly once per response with the authoritative final result (dashboard/chart/name) or an `error`."
             },
             {
-              "name": "luzmo-datasets-changed",
+              "name": "luzmo-stop",
               "type": {
                 "text": "CustomEvent"
-              }
+              },
+              "description": "Fired when an in-flight prompt is stopped"
             },
             {
-              "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": [
@@ -638,7 +987,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"
             },
             {
@@ -647,7 +996,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"
             },
             {
@@ -768,31 +1117,40 @@
               "fieldName": "disableColumnMentions"
             },
             {
-              "name": "model-preference",
+              "name": "require-dataset",
               "type": {
-                "text": "'performance' | 'quality'"
+                "text": "boolean"
               },
-              "default": "'performance'",
-              "description": "AI model preference for chart generation",
-              "fieldName": "modelPreference"
+              "default": "false",
+              "description": "When true, at least one dataset must be selected before the prompt can be submitted",
+              "fieldName": "requireDataset"
             },
             {
-              "name": "request-mode",
+              "name": "agent",
               "type": {
-                "text": "'internal' | 'external'"
+                "text": "AiPromptAgent"
               },
-              "default": "'internal'",
-              "description": "Controls if API calls are handled internally or by the host application.",
-              "fieldName": "requestMode"
+              "default": "'item'",
+              "description": "Which aiprompt agent to use. Determines request payload and stream handling.",
+              "fieldName": "agent"
             },
             {
-              "name": "is-generating",
+              "name": "task",
               "type": {
-                "text": "boolean"
+                "text": "AiPromptItemTask"
               },
-              "default": "false",
-              "description": "Used only in external request mode to reflect request lifecycle in the UI.",
-              "fieldName": "isGenerating"
+              "default": "'generate'",
+              "description": "Task for the item agent (`generate`, `suggest`, `describe`).",
+              "fieldName": "task"
+            },
+            {
+              "name": "model-preference",
+              "type": {
+                "text": "'performance' | 'quality'"
+              },
+              "default": "'performance'",
+              "description": "AI model preference for item agent chart generation",
+              "fieldName": "modelPreference"
             },
             {
               "name": "conversation-id",
@@ -800,7 +1158,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"
             },
             {
@@ -809,9 +1167,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": {
@@ -822,153 +1214,1285 @@
               "fieldName": "apiVersion"
             },
             {
-              "name": "stream",
+              "name": "stream",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "When true, uses NDJSON streaming for AI responses.\nWhen false, uses a single JSON response.",
+              "fieldName": "stream"
+            },
+            {
+              "name": "loading-message",
+              "type": {
+                "text": "string | null"
+              },
+              "default": "null",
+              "description": "Loading message shown while generating and before progress steps are available.",
+              "fieldName": "loadingMessage"
+            },
+            {
+              "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-action-button` (`variant=\"accent\"`).",
+              "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-action-button` (`variant=\"accent\"`).",
+              "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[]"
+                  }
+                },
+                {
+                  "name": "signal",
+                  "optional": true,
+                  "type": {
+                    "text": "AbortSignal"
+                  }
+                }
+              ],
+              "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"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "options",
+                  "default": "{}",
+                  "type": {
+                    "text": "{ notify?: boolean }"
+                  }
+                }
+              ],
+              "description": "Cancel the in-flight prompt and discard any partial assistant output."
+            }
+          ]
+        },
+        {
+          "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/chunk-extractors.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "extractInlineStreamText",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "chunk",
+              "type": {
+                "text": "Record<string, unknown>"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "extractStreamText",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "chunk",
+              "type": {
+                "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": "ctx",
+              "type": {
+                "text": "StreamHandlerContext"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "extractChartFromChunk",
+          "return": {
+            "type": {
+              "text": "Record<string, unknown> | null"
+            }
+          },
+          "parameters": [
+            {
+              "name": "chunk",
+              "type": {
+                "text": "Record<string, unknown>"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "extractDashboardName",
+          "return": {
+            "type": {
+              "text": "Record<string, string> | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "assets",
+              "type": {
+                "text": "unknown[]"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "extractDashboardFromChunk",
+          "return": {
+            "type": {
+              "text": "DashboardStatePayload | null"
+            }
+          },
+          "parameters": [
+            {
+              "name": "chunk",
+              "type": {
+                "text": "Record<string, unknown>"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "extractDashboardNameFromChunk",
+          "return": {
+            "type": {
+              "text": "Record<string, string> | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "chunk",
+              "type": {
+                "text": "Record<string, unknown>"
+              }
+            }
+          ],
+          "description": "Collect dashboard name from whichever asset array the chunk exposes."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "extractInlineStreamText",
+          "declaration": {
+            "name": "extractInlineStreamText",
+            "module": "src/components/ai-chat/stream/chunk-extractors.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "extractStreamText",
+          "declaration": {
+            "name": "extractStreamText",
+            "module": "src/components/ai-chat/stream/chunk-extractors.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "isStreamDone",
+          "declaration": {
+            "name": "isStreamDone",
+            "module": "src/components/ai-chat/stream/chunk-extractors.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "applyConversationId",
+          "declaration": {
+            "name": "applyConversationId",
+            "module": "src/components/ai-chat/stream/chunk-extractors.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "extractChartFromChunk",
+          "declaration": {
+            "name": "extractChartFromChunk",
+            "module": "src/components/ai-chat/stream/chunk-extractors.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "extractDashboardName",
+          "declaration": {
+            "name": "extractDashboardName",
+            "module": "src/components/ai-chat/stream/chunk-extractors.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "extractDashboardFromChunk",
+          "declaration": {
+            "name": "extractDashboardFromChunk",
+            "module": "src/components/ai-chat/stream/chunk-extractors.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "extractDashboardNameFromChunk",
+          "declaration": {
+            "name": "extractDashboardNameFromChunk",
+            "module": "src/components/ai-chat/stream/chunk-extractors.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/stream/progress.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>"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "createInitialProgress",
+          "declaration": {
+            "name": "createInitialProgress",
+            "module": "src/components/ai-chat/stream/progress.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "hasProgressChunk",
+          "declaration": {
+            "name": "hasProgressChunk",
+            "module": "src/components/ai-chat/stream/progress.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/stream/registry.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "getAgentStreamDefinition",
+          "return": {
+            "type": {
+              "text": "AgentStreamDefinition"
+            }
+          },
+          "parameters": [
+            {
+              "name": "agent",
               "type": {
-                "text": "boolean"
-              },
-              "default": "true",
-              "description": "When true, uses NDJSON streaming for AI responses.\nWhen false, uses a single JSON response.",
-              "fieldName": "stream"
-            },
+                "text": "AiPromptAgent"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "createStreamHandler",
+          "return": {
+            "type": {
+              "text": "StreamChunkProcessor"
+            }
+          },
+          "parameters": [
             {
-              "name": "loading-message",
+              "name": "agent",
               "type": {
-                "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.",
-              "fieldName": "loadingMessage"
-            },
+                "text": "AiPromptAgent"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "createInitialStreamState",
+          "return": {
+            "type": {
+              "text": "StreamHandlerContext['state']"
+            }
+          }
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "getAgentStreamDefinition",
+          "declaration": {
+            "name": "getAgentStreamDefinition",
+            "module": "src/components/ai-chat/stream/registry.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "createStreamHandler",
+          "declaration": {
+            "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/stream/stream-processor.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "type"
+        },
+        {
+          "kind": "function",
+          "name": "processStreamChunk",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
             {
-              "name": "initial-prompt",
+              "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"
+              }
             },
             {
-              "name": "progress-collapsed",
+              "name": "def",
               "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": "AgentStreamDefinition"
+              }
             }
-          ],
-          "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"
+          ]
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "LuzmoAiChat",
+          "name": "processStreamChunk",
           "declaration": {
-            "name": "LuzmoAiChat",
-            "module": "src/components/ai-chat/ai-chat.ts"
+            "name": "processStreamChunk",
+            "module": "src/components/ai-chat/stream/stream-processor.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/ai-chat/request-contract.ts",
+      "path": "src/components/ai-chat/stream/transport.ts",
       "declarations": [
         {
           "kind": "function",
-          "name": "buildAiMessageRequest",
+          "name": "fetchStreamingResponse",
           "return": {
             "type": {
-              "text": "AiMessageRequestBody"
+              "text": "Promise<StreamingResponse>"
             }
           },
           "parameters": [
             {
               "name": "options",
               "type": {
-                "text": "BuildAiMessageRequestOptions"
+                "text": "StreamingRequestOptions"
               }
             }
           ]
         },
         {
           "kind": "function",
-          "name": "buildAiMessageDeleteRequest",
+          "name": "parseStreamLine",
           "return": {
             "type": {
-              "text": "AiMessageDeleteRequestBody"
+              "text": "Record<string, unknown> | null"
             }
           },
           "parameters": [
             {
-              "name": "restoreToMessageId",
+              "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": "authKey",
+              "name": "body",
               "type": {
-                "text": "string"
+                "text": "ReadableStream<Uint8Array>"
               }
             },
             {
-              "name": "authToken",
+              "name": "onChunk",
               "type": {
-                "text": "string"
+                "text": "(chunk: Record<string, unknown>) => void"
               }
-            },
-            {
-              "name": "apiVersion",
-              "default": "'0.1.0'"
             }
-          ]
+          ],
+          "description": "Read NDJSON or SSE (`data:`) chunks from a streaming aiprompt response body."
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "buildAiMessageRequest",
+          "name": "fetchStreamingResponse",
+          "declaration": {
+            "name": "fetchStreamingResponse",
+            "module": "src/components/ai-chat/stream/transport.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "parseStreamLine",
           "declaration": {
-            "name": "buildAiMessageRequest",
-            "module": "src/components/ai-chat/request-contract.ts"
+            "name": "parseStreamLine",
+            "module": "src/components/ai-chat/stream/transport.ts"
           }
         },
         {
           "kind": "js",
-          "name": "buildAiMessageDeleteRequest",
+          "name": "readNdjsonStream",
           "declaration": {
-            "name": "buildAiMessageDeleteRequest",
-            "module": "src/components/ai-chat/request-contract.ts"
+            "name": "readNdjsonStream",
+            "module": "src/components/ai-chat/stream/transport.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",
@@ -1105,7 +2629,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, hides the \"+ Add dataset\" button and disables dataset pill removal",
+              "description": "When true, disables the \"+ Add dataset\" button and disables dataset pill removal",
               "attribute": "disable-dataset-modification"
             },
             {
@@ -1158,6 +2682,16 @@
               "description": "When true, retains the input value after submitting a prompt (default: false)\nWhen false (default), clears the textarea value after submission",
               "attribute": "retain-on-submit"
             },
+            {
+              "kind": "field",
+              "name": "requireDataset",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, at least one dataset must be selected before the prompt can be submitted",
+              "attribute": "require-dataset"
+            },
             {
               "type": {
                 "text": "boolean"
@@ -1186,7 +2720,7 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "When true, hides the \"+ Add dataset\" button and disables dataset pill removal",
+              "description": "When true, disables the \"+ Add dataset\" button and disables dataset pill removal",
               "name": "disable-dataset-modification",
               "kind": "field"
             },
@@ -1224,122 +2758,18 @@
             },
             {
               "type": {
-                "text": "string"
-              },
-              "description": "Background color of the component",
-              "name": "--luzmo-ai-interaction-textarea-background-color",
-              "kind": "field"
-            },
-            {
-              "type": {
-                "text": "string"
-              },
-              "description": "Border color of the component",
-              "name": "--luzmo-ai-interaction-textarea-border-color",
-              "kind": "field"
-            },
-            {
-              "type": {
-                "text": "string"
-              },
-              "description": "Border radius of the component",
-              "name": "--luzmo-ai-interaction-textarea-border-radius",
-              "kind": "field"
-            },
-            {
-              "type": {
-                "text": "string"
-              },
-              "description": "Vertical and horizontal padding of the component",
-              "name": "--luzmo-ai-interaction-textarea-padding",
-              "kind": "field"
-            },
-            {
-              "type": {
-                "text": "string"
-              },
-              "description": "Gap between textarea sections",
-              "name": "--luzmo-ai-interaction-textarea-gap",
-              "kind": "field"
-            },
-            {
-              "type": {
-                "text": "string"
-              },
-              "description": "Font family used in the prompt box",
-              "name": "--luzmo-ai-interaction-textarea-font-family",
-              "kind": "field"
-            },
-            {
-              "type": {
-                "text": "string"
-              },
-              "description": "Font size used in the prompt box",
-              "name": "--luzmo-ai-interaction-textarea-font-size",
-              "kind": "field"
-            },
-            {
-              "type": {
-                "text": "string"
-              },
-              "description": "Border color when focused",
-              "name": "--luzmo-ai-interaction-textarea-focus-border-color",
-              "kind": "field"
-            },
-            {
-              "type": {
-                "text": "string"
-              },
-              "description": "Box shadow when focused",
-              "name": "--luzmo-ai-interaction-textarea-focus-box-shadow",
-              "kind": "field"
-            },
-            {
-              "type": {
-                "text": "string"
-              },
-              "description": "Text color of the prompt input",
-              "name": "--luzmo-ai-interaction-textarea-textarea-color",
-              "kind": "field"
-            },
-            {
-              "type": {
-                "text": "string"
-              },
-              "description": "Placeholder color of the prompt input",
-              "name": "--luzmo-ai-interaction-textarea-textarea-placeholder-color",
-              "kind": "field"
-            },
-            {
-              "type": {
-                "text": "string"
-              },
-              "description": "Size of the submit button",
-              "name": "--luzmo-ai-interaction-textarea-button-min-height",
-              "kind": "field"
-            },
-            {
-              "type": {
-                "text": "string"
-              },
-              "description": "Background color of the submit button",
-              "name": "--luzmo-ai-interaction-textarea-button-background-color",
-              "kind": "field"
-            },
-            {
-              "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "Text color of the submit button",
-              "name": "--luzmo-ai-interaction-textarea-button-color",
+              "description": "When true, at least one dataset must be selected before the prompt can be submitted",
+              "name": "require-dataset",
               "kind": "field"
             },
             {
               "type": {
                 "text": "string"
               },
-              "description": "Text color of dataset header rows in @ mention options",
-              "name": "--luzmo-ai-interaction-textarea-trigger-option-header-color",
+              "description": "Opacity of the host when `disabled` (does not map to Lucero prompt-box tokens)",
+              "name": "--luzmo-ai-interaction-textarea-disabled-opacity",
               "kind": "field"
             }
           ],
@@ -1350,6 +2780,13 @@
                 "text": "CustomEvent"
               },
               "description": "Fired when a prompt is submitted with selected datasets"
+            },
+            {
+              "name": "prompt-stopped",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired when a running prompt is stopped"
             }
           ],
           "attributes": [
@@ -1458,7 +2895,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, hides the \"+ Add dataset\" button and disables dataset pill removal",
+              "description": "When true, disables the \"+ Add dataset\" button and disables dataset pill removal",
               "fieldName": "disableDatasetModification"
             },
             {
@@ -1505,6 +2942,15 @@
               "default": "false",
               "description": "When true, retains the input value after submitting a prompt (default: false)\nWhen false (default), clears the textarea value after submission",
               "fieldName": "retainOnSubmit"
+            },
+            {
+              "name": "require-dataset",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, at least one dataset must be selected before the prompt can be submitted",
+              "fieldName": "requireDataset"
             }
           ],
           "superclass": {
@@ -1513,7 +2959,7 @@
           },
           "tagName": "luzmo-ai-interaction-textarea",
           "customElement": true,
-          "summary": "A textarea component for AI interaction with dataset selection"
+          "summary": "A textarea for AI interaction with dataset selection. Uses Lucero `luzmo-prompt-box` for visuals; theme it with `--luzmo-prompt-box-*` on this host or an ancestor."
         }
       ],
       "exports": [
@@ -3238,7 +4684,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, disables all interactions: hides the add button, removes dataset pill delete buttons, and makes tags non-interactive",
+              "description": "When true, disables all interactions: disables the add button, removes dataset pill delete buttons, and makes tags non-interactive",
               "attribute": "disabled",
               "reflects": true
             },
@@ -3312,25 +4758,9 @@
               "type": {
                 "text": "string"
               },
-              "description": "Maximum height of the dataset search dropdown menu (Lucero `--luzmo-popover-max-height`)",
+              "description": "Optional scoped max height for this row’s search dropdown; falls back to inherited `--luzmo-popover-max-height`, then `400px`",
               "name": "--luzmo-dataset-selector-row-search-popover-max-height",
               "kind": "field"
-            },
-            {
-              "type": {
-                "text": "string"
-              },
-              "description": "Maximum width of each selected dataset tag",
-              "name": "--luzmo-dataset-selector-row-tag-max-width",
-              "kind": "field"
-            },
-            {
-              "type": {
-                "text": "string"
-              },
-              "description": "Height of selected dataset tags",
-              "name": "--luzmo-dataset-selector-row-tag-height",
-              "kind": "field"
             }
           ],
           "events": [
@@ -3415,7 +4845,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, disables all interactions: hides the add button, removes dataset pill delete buttons, and makes tags non-interactive",
+              "description": "When true, disables all interactions: disables the add button, removes dataset pill delete buttons, and makes tags non-interactive",
               "fieldName": "disabled"
             },
             {
@@ -3434,7 +4864,7 @@
           },
           "tagName": "luzmo-dataset-selector-row",
           "customElement": true,
-          "summary": "A row component for selecting and managing datasets with pills and overlay"
+          "summary": "A row component for selecting and managing datasets with pills and overlay. Theme Lucero primitives (`luzmo-select`, options, popover, tags) with `--luzmo-select-*`, `--luzmo-popover-max-height`, `--luzmo-option-*`, `--luzmo-tag-*` on this host or an ancestor; optional `--luzmo-dataset-selector-row-*` overrides ACK row shell defaults (gap, typography, search max width, scoped popover height)."
         }
       ],
       "exports": [
@@ -6095,6 +7525,340 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/formula/formula.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "LuzmoFormula",
+          "members": [
+            {
+              "kind": "field",
+              "name": "display",
+              "type": {
+                "text": "'rich' | 'text'"
+              },
+              "default": "'rich'",
+              "description": "Rendering mode. `rich` (default) renders read-only column / aggregation\npills; `text` renders plain text with an inline type icon per column. Both\nare always read-only.",
+              "attribute": "display",
+              "reflects": true
+            }
+          ],
+          "events": [
+            {
+              "type": {
+                "text": "CustomEvent<DatasetsErrorEventDetail>"
+              },
+              "description": "Fired when fetching datasets by id fails.",
+              "name": "luzmo-datasets-error"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "display",
+              "type": {
+                "text": "'rich' | 'text'"
+              },
+              "default": "'rich'",
+              "description": "Rendering mode. `rich` (default) renders read-only column / aggregation\npills; `text` renders plain text with an inline type icon per column. Both\nare always read-only.",
+              "fieldName": "display"
+            }
+          ],
+          "superclass": {
+            "name": "LuzmoFormulaBase",
+            "package": "@utils/formula/base/formula-base"
+          },
+          "tagName": "luzmo-formula",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "LuzmoFormula",
+          "declaration": {
+            "name": "LuzmoFormula",
+            "module": "src/components/formula/formula.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/formula-editor/formula-aggregations-list.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "renderAggregationsList",
+          "return": {
+            "type": {
+              "text": "TemplateResult"
+            }
+          },
+          "parameters": [
+            {
+              "name": "params",
+              "type": {
+                "text": "AggregationsListParams"
+              }
+            }
+          ],
+          "description": "Renders the aggregation-functions list (draggable / insertable pills) inside\nthe formula editor. Replaces the former `luzmo-formula-aggregations-list`\nelement: stateless markup driven entirely by the editor."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "renderAggregationsList",
+          "declaration": {
+            "name": "renderAggregationsList",
+            "module": "src/components/formula-editor/formula-aggregations-list.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/formula-editor/formula-datasets-list.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "renderDatasetsList",
+          "return": {
+            "type": {
+              "text": "TemplateResult"
+            }
+          },
+          "parameters": [
+            {
+              "name": "params",
+              "type": {
+                "text": "DatasetsListParams"
+              }
+            }
+          ],
+          "description": "Renders the datasets list (searchable, grouped, draggable columns) inside the\nformula editor. Replaces the former `luzmo-formula-datasets-list` element; the\nsearch query and collapsed groups live on the editor and are passed back in."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "renderDatasetsList",
+          "declaration": {
+            "name": "renderDatasetsList",
+            "module": "src/components/formula-editor/formula-datasets-list.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/formula-editor/formula-description.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "renderDescription",
+          "return": {
+            "type": {
+              "text": "TemplateResult"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{ target, size }",
+              "type": {
+                "text": "DescriptionParams"
+              }
+            }
+          ],
+          "description": "Renders the description region (label, description and example for the hovered\n/ selected function, aggregation or grouping) inside the formula editor.\nReplaces the former `luzmo-formula-description` element."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "renderDescription",
+          "declaration": {
+            "name": "renderDescription",
+            "module": "src/components/formula-editor/formula-description.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/formula-editor/formula-editor.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "LuzmoFormulaEditor",
+          "members": [
+            {
+              "kind": "field",
+              "name": "expressionResource",
+              "type": {
+                "text": "'column' | 'formula'"
+              },
+              "default": "'formula'",
+              "description": "Whether the expression is validated as a column or a formula.",
+              "attribute": "expression-resource",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "explanationDisplay",
+              "type": {
+                "text": "'tooltip' | 'description'"
+              },
+              "default": "'tooltip'",
+              "description": "How function / aggregation explanations are surfaced: as hover `tooltip`s on\nthe list items (default), or in a dedicated `description` region. With\n`tooltip` there is no description, so the remaining lists spread across\nthe full width.",
+              "attribute": "explanation-display",
+              "reflects": true
+            }
+          ],
+          "events": [
+            {
+              "name": "luzmo-validity-changed",
+              "type": {
+                "text": "CustomEvent<ValidityChangedEventDetail>"
+              },
+              "description": "Fired when expression validity changes."
+            },
+            {
+              "type": {
+                "text": "CustomEvent<ExpressionChangedEventDetail>"
+              },
+              "description": "Fired (debounced) when the expression changes.",
+              "name": "luzmo-expression-changed"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<DatasetsErrorEventDetail>"
+              },
+              "description": "Fired when fetching datasets by id fails.",
+              "name": "luzmo-datasets-error"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "expression-resource",
+              "type": {
+                "text": "'column' | 'formula'"
+              },
+              "default": "'formula'",
+              "description": "Whether the expression is validated as a column or a formula.",
+              "fieldName": "expressionResource"
+            },
+            {
+              "name": "explanation-display",
+              "type": {
+                "text": "'tooltip' | 'description'"
+              },
+              "default": "'tooltip'",
+              "description": "How function / aggregation explanations are surfaced: as hover `tooltip`s on\nthe list items (default), or in a dedicated `description` region. With\n`tooltip` there is no description, so the remaining lists spread across\nthe full width.",
+              "fieldName": "explanationDisplay"
+            }
+          ],
+          "superclass": {
+            "name": "LuzmoFormulaInputBase",
+            "package": "@utils/formula/base/formula-input-base"
+          },
+          "tagName": "luzmo-formula-editor",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "LuzmoFormulaEditor",
+          "declaration": {
+            "name": "LuzmoFormulaEditor",
+            "module": "src/components/formula-editor/formula-editor.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/formula-editor/formula-functions-list.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "renderFunctionsList",
+          "return": {
+            "type": {
+              "text": "TemplateResult"
+            }
+          },
+          "parameters": [
+            {
+              "name": "params",
+              "type": {
+                "text": "FunctionsListParams"
+              }
+            }
+          ],
+          "description": "Renders the functions list (category selector + draggable / insertable\nfunctions) inside the formula editor. Replaces the former\n`luzmo-formula-functions-list` element; the selected category lives on the\neditor and is passed back in."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "renderFunctionsList",
+          "declaration": {
+            "name": "renderFunctionsList",
+            "module": "src/components/formula-editor/formula-functions-list.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/formula-field/formula-field.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "LuzmoFormulaField",
+          "members": [],
+          "events": [
+            {
+              "type": {
+                "text": "CustomEvent<ExpressionChangedEventDetail>"
+              },
+              "description": "Fired (debounced) when the expression changes (only when not readonly).",
+              "name": "luzmo-expression-changed"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<DatasetsErrorEventDetail>"
+              },
+              "description": "Fired when fetching datasets by id fails.",
+              "name": "luzmo-datasets-error"
+            }
+          ],
+          "superclass": {
+            "name": "LuzmoFormulaInputBase",
+            "package": "@utils/formula/base/formula-input-base"
+          },
+          "tagName": "luzmo-formula-field",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "LuzmoFormulaField",
+          "declaration": {
+            "name": "LuzmoFormulaField",
+            "module": "src/components/formula-field/formula-field.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/item-grid/actions.ts",
@@ -6367,6 +8131,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",
@@ -6564,6 +8339,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": {
@@ -7178,7 +8962,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"
               }
@@ -7593,7 +9377,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"
               }