@syntrologie/runtime-sdk 2.0.0 → 2.0.1-canary.0

package/CAPABILITIES.md

@@ -67,6 +67,7 @@ Change a page header when the element is visible:
 
 The SDK includes the following adaptive packages, each providing specific capabilities:
 
+- [@syntrologie/app-chatbot](#syntrologieapp-chatbot)
 - [@syntrologie/app-content](#syntrologieapp-content)
 - [@syntrologie/app-faq](#syntrologieapp-faq)
 - [@syntrologie/app-gamification](#syntrologieapp-gamification)
@@ -74,6 +75,85 @@ The SDK includes the following adaptive packages, each providing specific capabi
 - [@syntrologie/app-navigation](#syntrologieapp-navigation)
 - [@syntrologie/app-overlays](#syntrologieapp-overlays)
 
+---
+
+# @syntrologie/app-chatbot
+
+AI chat assistant widget with action execution capabilities.
+
+## Widgets
+
+### adaptive-chatbot:assistant
+
+Mounts an AI-powered chat assistant that connects to a backend LLM endpoint. The assistant can parse action instructions from the LLM response and execute them on the page via the runtime's ActionEngine.
+
+**Tile config example:**
+
+```json
+{
+  "id": "chatbot-assistant",
+  "title": "Ask Assistant",
+  "content": {
+    "type": "custom",
+    "component": "adaptive-chatbot:assistant",
+    "props": {
+      "backendUrl": "/api/chat/message",
+      "mlflowRunId": "abc123",
+      "greeting": "Hi! How can I help?"
+    }
+  },
+  "size": "full",
+  "defaultExpanded": true
+}
+```
+
+### Config Props
+
+| Property      | Type   | Required | Default               | Description                             |
+| ------------- | ------ | -------- | --------------------- | --------------------------------------- |
+| `backendUrl`  | string | Yes      | —                     | URL for the chat API endpoint           |
+| `mlflowRunId` | string | No       | —                     | MLflow run ID for experiment tracking   |
+| `greeting`    | string | No       | "Hi! How can I help?" | Initial greeting message                |
+| `maxHistory`  | number | No       | 20                    | Max messages sent as history to backend |
+
+## Action Execution
+
+The chatbot does **not** define its own action kinds. Instead, it parses JSON action blocks from the LLM response and executes them via `runtime.actions.applyBatch()`. This means the chatbot can trigger any action kind registered in the runtime (highlights, tooltips, text changes, navigation, tours, etc.).
+
+### LLM Response Format
+
+The backend returns a text reply that may contain embedded JSON action blocks in fenced code blocks:
+
+```
+Here's what I found. Let me highlight the pricing section for you.
+
+\`\`\`json
+{"kind": "overlays:highlight", "anchorId": "pricing-section"}
+\`\`\`
+
+Is there anything else you'd like to know?
+```
+
+- JSON blocks with a `kind` field are extracted as actions and removed from display text
+- JSON blocks without `kind` are left in the display text as-is
+- Multiple action blocks can appear in a single response
+- Actions with unknown kinds are silently ignored by the ActionEngine
+
+## Authentication
+
+The widget reads auth credentials from the browser:
+
+- **JWT**: `stytch_session_jwt` cookie
+- **Workspace ID**: `syntrologie_workspace_id` from localStorage
+- Headers: `Authorization: Bearer <jwt>` + `X-Workspace-Id: <id>`
+
+## Events
+
+| Event                     | Props                        | Description                       |
+| ------------------------- | ---------------------------- | --------------------------------- |
+| `chatbot.actions_applied` | `count`, `kinds[]`, `tileId` | Emitted when actions are executed |
+
+
 ---
 
 # @syntrologie/app-content
@@ -83,13 +163,14 @@ DOM content modification capabilities for text, attributes, styles, HTML, and cl
 ## Actions
 
 ### set_text
+
 Replaces the text content of an element.
 
-| Property | Type | Required | Description |
-|----------|------|----------|-------------|
-| `kind` | `"set_text"` | Yes | Action type |
-| `anchorId` | string | Yes | Element selector |
-| `text` | string | Yes | New text content |
+| Property   | Type         | Required | Description      |
+| ---------- | ------------ | -------- | ---------------- |
+| `kind`     | `"set_text"` | Yes      | Action type      |
+| `anchorId` | string       | Yes      | Element selector |
+| `text`     | string       | Yes      | New text content |
 
 ```json
 {
@@ -100,14 +181,15 @@ Replaces the text content of an element.
 ```
 
 ### set_attr
+
 Sets an HTML attribute on an element.
 
-| Property | Type | Required | Description |
-|----------|------|----------|-------------|
-| `kind` | `"set_attr"` | Yes | Action type |
-| `anchorId` | string | Yes | Element selector |
-| `attr` | string | Yes | Attribute name |
-| `value` | string | Yes | Attribute value |
+| Property   | Type         | Required | Description      |
+| ---------- | ------------ | -------- | ---------------- |
+| `kind`     | `"set_attr"` | Yes      | Action type      |
+| `anchorId` | string       | Yes      | Element selector |
+| `attr`     | string       | Yes      | Attribute name   |
+| `value`    | string       | Yes      | Attribute value  |
 
 **Blocked attributes:** Event handlers (`onclick`, `onerror`, etc.) are not allowed.
 
@@ -121,13 +203,14 @@ Sets an HTML attribute on an element.
 ```
 
 ### set_style
+
 Sets inline CSS styles on an element.
 
-| Property | Type | Required | Description |
-|----------|------|----------|-------------|
-| `kind` | `"set_style"` | Yes | Action type |
-| `anchorId` | string | Yes | Element selector |
-| `styles` | object | Yes | CSS property/value pairs |
+| Property   | Type          | Required | Description              |
+| ---------- | ------------- | -------- | ------------------------ |
+| `kind`     | `"set_style"` | Yes      | Action type              |
+| `anchorId` | string        | Yes      | Element selector         |
+| `styles`   | object        | Yes      | CSS property/value pairs |
 
 ```json
 {
@@ -141,16 +224,18 @@ Sets inline CSS styles on an element.
 ```
 
 ### insert_html
+
 Inserts HTML content relative to an element.
 
-| Property | Type | Required | Description |
-|----------|------|----------|-------------|
-| `kind` | `"insert_html"` | Yes | Action type |
-| `anchorId` | string | Yes | Element selector |
-| `html` | string | Yes | HTML content (sanitized) |
-| `position` | string | Yes | `"before"`, `"after"`, `"prepend"`, `"append"`, `"replace"` |
+| Property   | Type            | Required | Description                                                 |
+| ---------- | --------------- | -------- | ----------------------------------------------------------- |
+| `kind`     | `"insert_html"` | Yes      | Action type                                                 |
+| `anchorId` | string          | Yes      | Element selector                                            |
+| `html`     | string          | Yes      | HTML content (sanitized)                                    |
+| `position` | string          | Yes      | `"before"`, `"after"`, `"prepend"`, `"append"`, `"replace"` |
 
 **Positions:**
+
 - `before` - Insert before the element
 - `after` - Insert after the element
 - `prepend` - Insert inside, before first child
@@ -167,13 +252,14 @@ Inserts HTML content relative to an element.
 ```
 
 ### add_class
+
 Adds a CSS class to an element.
 
-| Property | Type | Required | Description |
-|----------|------|----------|-------------|
-| `kind` | `"add_class"` | Yes | Action type |
-| `anchorId` | string | Yes | Element selector |
-| `className` | string | Yes | Class name to add |
+| Property    | Type          | Required | Description       |
+| ----------- | ------------- | -------- | ----------------- |
+| `kind`      | `"add_class"` | Yes      | Action type       |
+| `anchorId`  | string        | Yes      | Element selector  |
+| `className` | string        | Yes      | Class name to add |
 
 ```json
 {
@@ -184,13 +270,14 @@ Adds a CSS class to an element.
 ```
 
 ### remove_class
+
 Removes a CSS class from an element.
 
-| Property | Type | Required | Description |
-|----------|------|----------|-------------|
-| `kind` | `"remove_class"` | Yes | Action type |
-| `anchorId` | string | Yes | Element selector |
-| `className` | string | Yes | Class name to remove |
+| Property    | Type             | Required | Description          |
+| ----------- | ---------------- | -------- | -------------------- |
+| `kind`      | `"remove_class"` | Yes      | Action type          |
+| `anchorId`  | string           | Yes      | Element selector     |
+| `className` | string           | Yes      | Class name to remove |
 
 ```json
 {
@@ -210,24 +297,25 @@ FAQ accordion widget with conditional item visibility.
 ## Actions
 
 ### mount_faq
+
 Mounts an FAQ accordion widget to a surface slot.
 
-| Property | Type | Required | Description |
-|----------|------|----------|-------------|
-| `kind` | `"mount_faq"` | Yes | Action type |
-| `slot` | string | Yes | Target slot (e.g., `"drawer_right"`, `"overlay_center"`) |
-| `config.title` | string | No | Widget title |
-| `config.items` | array | Yes | FAQ items (see below) |
+| Property       | Type          | Required | Description                                              |
+| -------------- | ------------- | -------- | -------------------------------------------------------- |
+| `kind`         | `"mount_faq"` | Yes      | Action type                                              |
+| `slot`         | string        | Yes      | Target slot (e.g., `"drawer_right"`, `"overlay_center"`) |
+| `config.title` | string        | No       | Widget title                                             |
+| `config.items` | array         | Yes      | FAQ items (see below)                                    |
 
 ### FAQ Item Schema
 
 Each item in the `items` array:
 
-| Property | Type | Required | Description |
-|----------|------|----------|-------------|
-| `question` | string | Yes | The question text |
-| `answer` | string | Yes | The answer text (supports markdown) |
-| `showWhen` | DecisionStrategy | No | Conditional visibility strategy |
+| Property   | Type             | Required | Description                         |
+| ---------- | ---------------- | -------- | ----------------------------------- |
+| `question` | string           | Yes      | The question text                   |
+| `answer`   | string           | Yes      | The answer text (supports markdown) |
+| `showWhen` | DecisionStrategy | No       | Conditional visibility strategy     |
 
 ```json
 {
@@ -247,9 +335,7 @@ Each item in the `items` array:
           "type": "rules",
           "rules": [
             {
-              "conditions": [
-                { "type": "page_url", "pattern": "/pricing*" }
-              ],
+              "conditions": [{ "type": "page_url", "pattern": "/pricing*" }],
               "value": true
             }
           ],
@@ -264,6 +350,7 @@ Each item in the `items` array:
 ## Compositional Pattern
 
 The FAQ widget supports **per-item conditional visibility** using `showWhen` strategies. This allows different FAQ items to appear based on:
+
 - Current page/route
 - User segment or state
 - Viewport conditions
@@ -281,34 +368,35 @@ Gamification capabilities including badges, points, and leaderboards.
 ## Actions
 
 ### mount_gamification
+
 Mounts gamification UI elements.
 
-| Property | Type | Required | Description |
-|----------|------|----------|-------------|
-| `kind` | `"mount_gamification"` | Yes | Action type |
-| `slot` | string | Yes | Target slot |
-| `config` | object | Yes | Gamification configuration |
+| Property | Type                   | Required | Description                |
+| -------- | ---------------------- | -------- | -------------------------- |
+| `kind`   | `"mount_gamification"` | Yes      | Action type                |
+| `slot`   | string                 | Yes      | Target slot                |
+| `config` | object                 | Yes      | Gamification configuration |
 
 ### Configuration Schema
 
-| Property | Type | Required | Default | Description |
-|----------|------|----------|---------|-------------|
-| `badges` | array | No | `[]` | Badge definitions |
-| `points.enabled` | boolean | No | `false` | Enable points system |
-| `points.multiplier` | number | No | `1` | Points multiplier |
-| `leaderboard.enabled` | boolean | No | `false` | Show leaderboard |
-| `leaderboard.refreshInterval` | number | No | `60000` | Refresh interval in ms |
+| Property                      | Type    | Required | Default | Description            |
+| ----------------------------- | ------- | -------- | ------- | ---------------------- |
+| `badges`                      | array   | No       | `[]`    | Badge definitions      |
+| `points.enabled`              | boolean | No       | `false` | Enable points system   |
+| `points.multiplier`           | number  | No       | `1`     | Points multiplier      |
+| `leaderboard.enabled`         | boolean | No       | `false` | Show leaderboard       |
+| `leaderboard.refreshInterval` | number  | No       | `60000` | Refresh interval in ms |
 
 ### Badge Schema
 
-| Property | Type | Required | Description |
-|----------|------|----------|-------------|
-| `id` | string | Yes | Unique badge identifier |
-| `name` | string | Yes | Display name |
-| `icon` | string | Yes | Icon identifier |
-| `description` | string | No | Badge description |
-| `trigger.event` | string | Yes | Event that triggers the badge |
-| `trigger.conditions` | array | No | Additional conditions |
+| Property             | Type   | Required | Description                   |
+| -------------------- | ------ | -------- | ----------------------------- |
+| `id`                 | string | Yes      | Unique badge identifier       |
+| `name`               | string | Yes      | Display name                  |
+| `icon`               | string | Yes      | Icon identifier               |
+| `description`        | string | No       | Badge description             |
+| `trigger.event`      | string | Yes      | Event that triggers the badge |
+| `trigger.conditions` | array  | No       | Additional conditions         |
 
 ```json
 {
@@ -367,25 +455,26 @@ Navigation link list widget with conditional item visibility.
 ## Actions
 
 ### mount_nav
+
 Mounts a navigation link list widget to a surface slot.
 
-| Property | Type | Required | Description |
-|----------|------|----------|-------------|
-| `kind` | `"mount_nav"` | Yes | Action type |
-| `slot` | string | Yes | Target slot (e.g., `"drawer_left"`, `"inline:{anchorId}"`) |
-| `config.title` | string | No | Widget title |
-| `config.items` | array | Yes | Navigation items (see below) |
+| Property       | Type          | Required | Description                                                |
+| -------------- | ------------- | -------- | ---------------------------------------------------------- |
+| `kind`         | `"mount_nav"` | Yes      | Action type                                                |
+| `slot`         | string        | Yes      | Target slot (e.g., `"drawer_left"`, `"inline:{anchorId}"`) |
+| `config.title` | string        | No       | Widget title                                               |
+| `config.items` | array         | Yes      | Navigation items (see below)                               |
 
 ### Nav Item Schema
 
 Each item in the `items` array:
 
-| Property | Type | Required | Description |
-|----------|------|----------|-------------|
-| `label` | string | Yes | Link text |
-| `href` | string | Yes | Link destination |
-| `icon` | string | No | Icon identifier |
-| `showWhen` | DecisionStrategy | No | Conditional visibility strategy |
+| Property   | Type             | Required | Description                     |
+| ---------- | ---------------- | -------- | ------------------------------- |
+| `label`    | string           | Yes      | Link text                       |
+| `href`     | string           | Yes      | Link destination                |
+| `icon`     | string           | No       | Icon identifier                 |
+| `showWhen` | DecisionStrategy | No       | Conditional visibility strategy |
 
 ```json
 {
@@ -407,9 +496,7 @@ Each item in the `items` array:
           "type": "rules",
           "rules": [
             {
-              "conditions": [
-                { "type": "state_equals", "key": "user.role", "value": "admin" }
-              ],
+              "conditions": [{ "type": "state_equals", "key": "user.role", "value": "admin" }],
               "value": true
             }
           ],
@@ -424,9 +511,7 @@ Each item in the `items` array:
           "type": "rules",
           "rules": [
             {
-              "conditions": [
-                { "type": "state_equals", "key": "user.plan", "value": "free" }
-              ],
+              "conditions": [{ "type": "state_equals", "key": "user.plan", "value": "free" }],
               "value": true
             }
           ],
@@ -441,6 +526,7 @@ Each item in the `items` array:
 ## Compositional Pattern
 
 The nav widget supports **per-item conditional visibility** using `showWhen` strategies. This allows different navigation items to appear based on:
+
 - User role or permissions
 - Subscription tier
 - Feature flags
@@ -458,15 +544,16 @@ Navigation capabilities for scrolling and URL navigation.
 ## Actions
 
 ### scroll_to
+
 Scrolls the viewport to bring an element into view.
 
-| Property | Type | Required | Default | Description |
-|----------|------|----------|---------|-------------|
-| `kind` | `"scroll_to"` | Yes | | Action type |
-| `anchorId` | string | Yes | | Element selector |
-| `behavior` | string | No | `"smooth"` | `"smooth"`, `"instant"`, `"auto"` |
-| `block` | string | No | `"center"` | `"start"`, `"center"`, `"end"`, `"nearest"` |
-| `inline` | string | No | `"nearest"` | `"start"`, `"center"`, `"end"`, `"nearest"` |
+| Property   | Type          | Required | Default     | Description                                 |
+| ---------- | ------------- | -------- | ----------- | ------------------------------------------- |
+| `kind`     | `"scroll_to"` | Yes      |             | Action type                                 |
+| `anchorId` | string        | Yes      |             | Element selector                            |
+| `behavior` | string        | No       | `"smooth"`  | `"smooth"`, `"instant"`, `"auto"`           |
+| `block`    | string        | No       | `"center"`  | `"start"`, `"center"`, `"end"`, `"nearest"` |
+| `inline`   | string        | No       | `"nearest"` | `"start"`, `"center"`, `"end"`, `"nearest"` |
 
 ```json
 {
@@ -478,13 +565,14 @@ Scrolls the viewport to bring an element into view.
 ```
 
 ### navigate
+
 Navigates to a URL.
 
-| Property | Type | Required | Default | Description |
-|----------|------|----------|---------|-------------|
-| `kind` | `"navigate"` | Yes | | Action type |
-| `url` | string | Yes | | Destination URL |
-| `target` | string | No | `"_self"` | `"_self"` or `"_blank"` |
+| Property | Type         | Required | Default   | Description             |
+| -------- | ------------ | -------- | --------- | ----------------------- |
+| `kind`   | `"navigate"` | Yes      |           | Action type             |
+| `url`    | string       | Yes      |           | Destination URL         |
+| `target` | string       | No       | `"_self"` | `"_self"` or `"_blank"` |
 
 ```json
 {
@@ -506,16 +594,17 @@ Visual overlay capabilities including highlights, tooltips, badges, and pulse an
 ## Actions
 
 ### highlight
+
 Creates a spotlight effect around an element with a scrim overlay.
 
-| Property | Type | Required | Default | Description |
-|----------|------|----------|---------|-------------|
-| `kind` | `"highlight"` | Yes | | Action type |
-| `anchorId` | string | Yes | | Element selector |
-| `style.color` | string | No | `"#5b8cff"` | Ring color |
-| `style.scrimOpacity` | number | No | `0.55` | Backdrop opacity 0-1 (set to 0 to hide) |
-| `style.paddingPx` | number | No | `12` | Space around element |
-| `style.radiusPx` | number | No | `12` | Ring corner radius |
+| Property             | Type          | Required | Default     | Description                             |
+| -------------------- | ------------- | -------- | ----------- | --------------------------------------- |
+| `kind`               | `"highlight"` | Yes      |             | Action type                             |
+| `anchorId`           | string        | Yes      |             | Element selector                        |
+| `style.color`        | string        | No       | `"#5b8cff"` | Ring color                              |
+| `style.scrimOpacity` | number        | No       | `0.55`      | Backdrop opacity 0-1 (set to 0 to hide) |
+| `style.paddingPx`    | number        | No       | `12`        | Space around element                    |
+| `style.radiusPx`     | number        | No       | `12`        | Ring corner radius                      |
 
 ```json
 {
@@ -529,18 +618,19 @@ Creates a spotlight effect around an element with a scrim overlay.
 ```
 
 ### tooltip
+
 Shows a tooltip near an element with optional title, body, and CTA.
 
-| Property | Type | Required | Default | Description |
-|----------|------|----------|---------|-------------|
-| `kind` | `"tooltip"` | Yes | | Action type |
-| `anchorId` | string | Yes | | Element selector |
-| `content.title` | string | No | | Tooltip heading |
-| `content.body` | string | Yes | | Tooltip text |
-| `content.cta.label` | string | No | | CTA button text |
-| `content.cta.action` | Action | No | | Action to execute on CTA click |
-| `trigger` | string | No | `"immediate"` | `"immediate"`, `"hover"`, `"click"` |
-| `placement` | string | No | `"top"` | See placement options below |
+| Property             | Type        | Required | Default       | Description                         |
+| -------------------- | ----------- | -------- | ------------- | ----------------------------------- |
+| `kind`               | `"tooltip"` | Yes      |               | Action type                         |
+| `anchorId`           | string      | Yes      |               | Element selector                    |
+| `content.title`      | string      | No       |               | Tooltip heading                     |
+| `content.body`       | string      | Yes      |               | Tooltip text                        |
+| `content.cta.label`  | string      | No       |               | CTA button text                     |
+| `content.cta.action` | Action      | No       |               | Action to execute on CTA click      |
+| `trigger`            | string      | No       | `"immediate"` | `"immediate"`, `"hover"`, `"click"` |
+| `placement`          | string      | No       | `"top"`       | See placement options below         |
 
 **Placement options:** `top`, `top-start`, `top-end`, `bottom`, `bottom-start`, `bottom-end`, `left`, `left-start`, `left-end`, `right`, `right-start`, `right-end`
 
@@ -562,14 +652,15 @@ Shows a tooltip near an element with optional title, body, and CTA.
 ```
 
 ### badge
+
 Adds a small badge indicator near an element.
 
-| Property | Type | Required | Default | Description |
-|----------|------|----------|---------|-------------|
-| `kind` | `"badge"` | Yes | | Action type |
-| `anchorId` | string | Yes | | Element selector |
-| `text` | string | Yes | | Badge text (e.g., "NEW", "3") |
-| `position` | string | No | `"top-right"` | `"top-left"`, `"top-right"`, `"bottom-left"`, `"bottom-right"` |
+| Property   | Type      | Required | Default       | Description                                                    |
+| ---------- | --------- | -------- | ------------- | -------------------------------------------------------------- |
+| `kind`     | `"badge"` | Yes      |               | Action type                                                    |
+| `anchorId` | string    | Yes      |               | Element selector                                               |
+| `text`     | string    | Yes      |               | Badge text (e.g., "NEW", "3")                                  |
+| `position` | string    | No       | `"top-right"` | `"top-left"`, `"top-right"`, `"bottom-left"`, `"bottom-right"` |
 
 ```json
 {
@@ -581,13 +672,14 @@ Adds a small badge indicator near an element.
 ```
 
 ### pulse
+
 Adds a pulsing animation to draw attention.
 
-| Property | Type | Required | Default | Description |
-|----------|------|----------|---------|-------------|
-| `kind` | `"pulse"` | Yes | | Action type |
-| `anchorId` | string | Yes | | Element selector |
-| `duration` | number | No | `2000` | Animation duration in ms |
+| Property   | Type      | Required | Default | Description              |
+| ---------- | --------- | -------- | ------- | ------------------------ |
+| `kind`     | `"pulse"` | Yes      |         | Action type              |
+| `anchorId` | string    | Yes      |         | Element selector         |
+| `duration` | number    | No       | `2000`  | Animation duration in ms |
 
 ```json
 {
@@ -598,23 +690,25 @@ Adds a pulsing animation to draw attention.
 ```
 
 ### modal
+
 Shows a centered modal dialog with optional CTA buttons.
 
-| Property | Type | Required | Default | Description |
-|----------|------|----------|---------|-------------|
-| `kind` | `"overlays:modal"` | Yes | | Action type |
-| `content.title` | string | No | | Modal heading |
-| `content.body` | string | Yes | | Modal text |
-| `size` | string | No | `"md"` | `"sm"`, `"md"`, `"lg"` |
-| `blocking` | boolean | No | `false` | Block page interaction |
-| `scrim.opacity` | number | No | `0.6` | Backdrop opacity 0-1 |
-| `dismiss.onEsc` | boolean | No | `true` | Close on Escape key |
-| `dismiss.closeButton` | boolean | No | `true` | Show close button |
-| `dismiss.timeoutMs` | number | No | | Auto-close after timeout |
-| `ctaButtons` | array | No | | Array of CTA buttons |
-| `waitFor` | string | No | | When to complete: `"dismissed"`, `"cta-click"`, `"timeout:N"` |
+| Property              | Type               | Required | Default | Description                                                   |
+| --------------------- | ------------------ | -------- | ------- | ------------------------------------------------------------- |
+| `kind`                | `"overlays:modal"` | Yes      |         | Action type                                                   |
+| `content.title`       | string             | No       |         | Modal heading                                                 |
+| `content.body`        | string             | Yes      |         | Modal text                                                    |
+| `size`                | string             | No       | `"md"`  | `"sm"`, `"md"`, `"lg"`                                        |
+| `blocking`            | boolean            | No       | `false` | Block page interaction                                        |
+| `scrim.opacity`       | number             | No       | `0.6`   | Backdrop opacity 0-1                                          |
+| `dismiss.onEsc`       | boolean            | No       | `true`  | Close on Escape key                                           |
+| `dismiss.closeButton` | boolean            | No       | `true`  | Show close button                                             |
+| `dismiss.timeoutMs`   | number             | No       |         | Auto-close after timeout                                      |
+| `ctaButtons`          | array              | No       |         | Array of CTA buttons                                          |
+| `waitFor`             | string             | No       |         | When to complete: `"dismissed"`, `"cta-click"`, `"timeout:N"` |
 
 **CTA Button properties:**
+
 - `label`: Button text
 - `actionId`: Identifier for the action
 - `primary`: Whether this is a primary button (default: false)