@alfadocs/ui-kit-debug 0.1.8 → 0.2.0

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "0.1.8",
+  "packageVersion": "0.2.0",
   "components": [
     {
       "kind": "component",
@@ -10,13 +10,42 @@
         "select_single",
         "select_multiple"
       ],
-      "state": [],
-      "actions": [],
+      "state": [
+        {
+          "name": "openItems",
+          "type": "string[]",
+          "description": "Ids (values) of currently-expanded items. Single-mode accordions return an array with 0 or 1 entries."
+        }
+      ],
+      "actions": [
+        {
+          "name": "expand",
+          "safety": "read",
+          "argsType": "{ itemId: string }",
+          "description": "Expand the item with the given value."
+        },
+        {
+          "name": "collapse",
+          "safety": "read",
+          "argsType": "{ itemId: string }",
+          "description": "Collapse the item with the given value."
+        },
+        {
+          "name": "clear",
+          "safety": "read",
+          "description": "Collapse all items. Only meaningful for multi-mode accordions; single-mode equivalent to collapsing the active item."
+        }
+      ],
       "domHooks": {
         "root": {
           "attr": "data-component",
           "value": "accordion"
         },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
         "item": {
           "attr": "data-item-id",
           "description": "Each Accordion.Item emits its value as data-item-id."
@@ -25,660 +54,3818 @@
     },
     {
       "kind": "component",
-      "id": "autocomplete",
+      "id": "agenda-card",
       "capabilities": [
-        "filter",
         "pick",
-        "open",
-        "close"
+        "dismiss"
       ],
       "state": [],
       "actions": [],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "autocomplete"
+          "value": "agenda-card",
+          "description": "Marks the element as a kit AgendaCard. The card root also emits data-component-id sourced from item.id and data-status with the appointment lifecycle."
         },
-        "item": {
-          "attr": "data-option-id",
-          "description": "Each suggestion emits its value as data-option-id."
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "item.id",
+          "description": "Sourced from item.id — the stable appointment identifier."
         }
       }
     },
     {
       "kind": "component",
-      "id": "button",
-      "capabilities": [],
-      "state": [],
-      "actions": [],
+      "id": "agenda-tray",
+      "capabilities": [
+        "select_single"
+      ],
+      "state": [
+        {
+          "name": "items",
+          "type": "Array<{ id: string; status: string }>",
+          "description": "Currently-displayed appointments. Ids + status only — never patient identity."
+        }
+      ],
+      "actions": [
+        {
+          "name": "select_item",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "description": "Activate the appointment with the given id."
+        }
+      ],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "button",
-          "description": "Marks the element as a kit Button. Safety is declared by the host pattern, not the button. Buttons inherit native `id` from props, which is what agents address them by."
+          "value": "agenda-tray",
+          "description": "Marks the AgendaTray wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop. Required to address a specific tray from the agent."
+        },
+        "item": {
+          "attr": "data-appointment-id",
+          "description": "Stable appointment id emitted on each rendered AgendaCard inside the tray."
         }
       }
     },
     {
       "kind": "component",
-      "id": "calendar",
+      "id": "ai-prompt-input",
       "capabilities": [
-        "view_change",
-        "range_navigate",
-        "pick"
+        "edit_inline",
+        "submit"
       ],
       "state": [
         {
-          "name": "currentView",
-          "type": "CalendarView",
-          "description": "Active view name (e.g. dayGridMonth, timeGridWeek)."
+          "name": "value",
+          "type": "string",
+          "description": "Current text in the composer (no PHI processing)."
         },
         {
-          "name": "currentDate",
-          "type": "iso-date",
-          "description": "ISO date anchor of the visible range."
+          "name": "isEmpty",
+          "type": "boolean",
+          "description": "True when the composer has no text and no attachments."
         },
         {
-          "name": "currentTitle",
-          "type": "string",
-          "description": "Human title of the current range (e.g. \"April 2026\")."
+          "name": "isSubmitting",
+          "type": "boolean",
+          "description": "True while an onSubmit invocation is in flight (best-effort)."
         }
       ],
       "actions": [
         {
-          "name": "today",
-          "safety": "read",
-          "description": "Jump to the current day."
-        },
-        {
-          "name": "prev",
-          "safety": "read",
-          "description": "Move to the previous range."
-        },
-        {
-          "name": "next",
-          "safety": "read",
-          "description": "Move to the next range."
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: string }",
+          "description": "Replace the composer text with the given value."
         },
         {
-          "name": "goto_date",
-          "safety": "read",
-          "argsType": "{ date: string | Date }",
-          "description": "Navigate to a specific date."
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Clear text and attachments. Irreversible from the same UI."
         },
         {
-          "name": "change_view",
-          "safety": "read",
-          "argsType": "{ view: CalendarView }",
-          "description": "Switch the calendar to the given view."
+          "name": "submit",
+          "safety": "write",
+          "description": "Submit the current composer state via onSubmit."
         },
         {
-          "name": "focus_event",
+          "name": "focus",
           "safety": "read",
-          "argsType": "{ eventId: string }",
-          "description": "Scroll an event into view and briefly highlight it."
+          "description": "Move keyboard focus into the textarea."
         }
       ],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "calendar",
-          "description": "Marks the Calendar wrapper."
+          "value": "ai-prompt-input",
+          "description": "Marks the AIPromptInput wrapper."
         },
         "instanceId": {
           "attr": "data-component-id",
           "sourceProp": "id",
-          "description": "Sourced from the id prop."
-        },
-        "item": {
-          "attr": "data-event-id",
-          "description": "Emitted on every rendered FullCalendar event by the kit event renderer. Used by focusEvent."
-        }
-      }
-    },
-    {
-      "kind": "component",
-      "id": "chart",
-      "capabilities": [],
-      "state": [],
-      "actions": [
-        {
-          "name": "update_series",
-          "safety": "read",
-          "argsType": "series",
-          "description": "Replace the chart series without remounting."
-        },
-        {
-          "name": "export_png",
-          "safety": "read",
-          "description": "Return a PNG data URI of the chart for export or screenshotting."
-        }
-      ],
-      "domHooks": {
-        "root": {
-          "attr": "data-component",
-          "value": "chart"
+          "description": "Sourced from the id prop; addresses a specific composer instance."
         }
       }
     },
     {
       "kind": "component",
-      "id": "chat-container",
+      "id": "alert",
       "capabilities": [
-        "navigate"
+        "dismiss"
       ],
       "state": [],
-      "actions": [
-        {
-          "name": "scroll_to_bottom",
-          "safety": "read",
-          "argsType": "{ smooth?: boolean }",
-          "description": "Scroll the conversation viewport to the latest message."
-        }
-      ],
+      "actions": [],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "chat-container"
+          "value": "alert",
+          "description": "Marks the element as a kit Alert. The root also emits `data-state=\"open\" | \"closing\"` while the dismiss animation runs. Alerts inherit native `id` from props, which is what agents address them by."
         }
       }
     },
     {
       "kind": "component",
-      "id": "combobox",
-      "capabilities": [
-        "select_single",
-        "pick",
-        "filter",
-        "open",
-        "close"
-      ],
+      "id": "app-frame",
+      "capabilities": [],
       "state": [],
       "actions": [],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "combobox"
-        },
-        "item": {
-          "attr": "data-option-id",
-          "description": "Each option emits its value as data-option-id."
+          "value": "app-frame",
+          "description": "Marks the AppFrame layout wrapper. Inner landmarks (Header, Sidebar, main) carry their own component hooks."
         }
       }
     },
     {
       "kind": "component",
-      "id": "command-palette",
-      "capabilities": [
-        "open",
-        "close",
-        "filter",
-        "pick",
-        "submit"
-      ],
+      "id": "aspect-ratio",
+      "capabilities": [],
       "state": [],
       "actions": [],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "command-palette"
-        },
-        "item": {
-          "attr": "data-command-id",
-          "description": "Each command item emits its key as data-command-id."
+          "value": "aspect-ratio",
+          "description": "Marks the element as a kit AspectRatio wrapper."
         }
       }
     },
     {
       "kind": "component",
-      "id": "data-table",
+      "id": "audio-recorder",
       "capabilities": [
-        "select_single",
-        "select_multiple",
-        "range_pick",
-        "filter",
-        "sort",
-        "paginate"
+        "submit"
       ],
       "state": [
         {
-          "name": "selection",
-          "type": "string[]",
-          "description": "Row ids of currently-selected rows."
-        },
-        {
-          "name": "filter",
-          "type": "object",
-          "description": "Current ag-grid filter model, keyed by column id."
+          "name": "isRecording",
+          "type": "boolean",
+          "description": "True while actively capturing audio (not paused)."
         },
         {
-          "name": "sort",
-          "type": "Array<{ colId, sort }>",
-          "description": "Active sort, in priority order."
+          "name": "duration",
+          "type": "number",
+          "description": "Elapsed recording time in milliseconds (paused time excluded)."
         },
         {
-          "name": "currentPage",
-          "type": "number",
-          "description": "Zero-indexed page number."
+          "name": "hasRecording",
+          "type": "boolean",
+          "description": "True when a completed recording is available for submission."
         }
       ],
       "actions": [
         {
-          "name": "select_rows",
-          "safety": "read",
-          "argsType": "{ ids: string[] }",
-          "description": "Replace the current selection with the given row ids."
-        },
-        {
-          "name": "select_range",
-          "safety": "read",
-          "argsType": "{ fromId: string, toId: string }",
-          "description": "Select every row between fromId and toId, inclusive, in current sort order."
-        },
-        {
-          "name": "clear_selection",
-          "safety": "read",
-          "description": "Deselect all rows."
+          "name": "start_recording",
+          "safety": "write",
+          "description": "Request microphone permission and begin recording."
         },
         {
-          "name": "apply_filter",
-          "safety": "read",
-          "argsType": "{ model: Record<string, unknown> }",
-          "description": "Replace the filter model with the given object."
+          "name": "stop_recording",
+          "safety": "write",
+          "description": "Stop the current recording and finalise the blob."
         },
         {
-          "name": "sort_by",
-          "safety": "read",
-          "argsType": "{ model: DataTableSortEntry[] }",
-          "description": "Replace the active sort with the given list (priority order)."
+          "name": "discard",
+          "safety": "destructive",
+          "description": "Cancel the recording. Irreversible — the captured audio is dropped."
         },
         {
-          "name": "go_to_page",
-          "safety": "read",
-          "argsType": "{ page: number }",
-          "description": "Navigate to the given zero-indexed page."
+          "name": "submit",
+          "safety": "write",
+          "description": "Stop the active recording, finalising it via onRecordingComplete."
         }
       ],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "data-table",
-          "description": "Marks the DataTable wrapper."
+          "value": "audio-recorder",
+          "description": "Marks the AudioRecorder wrapper."
         },
         "instanceId": {
           "attr": "data-component-id",
-          "sourceProp": "gridId",
-          "description": "Sourced from the gridId prop. Required to address a specific table from the agent."
-        },
-        "item": {
-          "attr": "row-id",
-          "description": "Native ag-grid row-id attribute on each rendered row. Selection is performed via the curated handle, not by DOM mutation."
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
         }
       }
     },
     {
       "kind": "component",
-      "id": "dialog",
-      "capabilities": [
-        "open",
-        "close",
-        "dismiss"
-      ],
+      "id": "audio-visualiser",
+      "capabilities": [],
       "state": [],
       "actions": [],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "dialog"
+          "value": "audio-visualiser",
+          "description": "Marks the element as a kit AudioVisualiser canvas."
         }
       }
     },
     {
       "kind": "component",
-      "id": "dropdown-menu",
+      "id": "autocomplete",
       "capabilities": [
+        "filter",
+        "pick",
         "open",
-        "close",
+        "close"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string | null",
+          "description": "Currently-selected option value, or null when nothing is committed."
+        },
+        {
+          "name": "query",
+          "type": "string",
+          "description": "Current free-text query in the input."
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "True when the suggestion list is visible."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "read",
+          "argsType": "{ value: string | null }",
+          "description": "Set the committed value programmatically."
+        },
+        {
+          "name": "apply_filter",
+          "safety": "read",
+          "argsType": "{ query: string }",
+          "description": "Set the input query, which filters the suggestion list."
+        },
+        {
+          "name": "clear",
+          "safety": "read",
+          "description": "Clear the value and the query."
+        },
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the suggestion list."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the suggestion list."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "autocomplete"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-option-id",
+          "description": "Each suggestion emits its value as data-option-id."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "avatar",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "avatar",
+          "description": "Marks the element as a kit Avatar."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "badge",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "badge",
+          "description": "Marks the element as a kit Badge."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "breadcrumb",
+      "capabilities": [
+        "navigate"
+      ],
+      "state": [
+        {
+          "name": "items",
+          "type": "Array<{ id: string, href?: string }>",
+          "description": "Ordered list of crumb ids + hrefs in display order. Labels are intentionally excluded — they may contain PHI."
+        }
+      ],
+      "actions": [
+        {
+          "name": "navigate_to",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "description": "Activate the crumb with the given id — equivalent to clicking the link."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "breadcrumb",
+          "description": "Marks the Breadcrumb root `<nav>`."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-crumb-id",
+          "description": "Stable opaque id of a crumb. Labels are NEVER carried in data-* — they may contain PHI."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "button",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "button",
+          "description": "Marks the element as a kit Button. Safety is declared by the host pattern, not the button. Buttons inherit native `id` from props, which is what agents address them by."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "button-group",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "button-group",
+          "description": "Marks the ButtonGroup wrapper. Agents target individual Buttons inside the group via their native `id`."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "calendar",
+      "capabilities": [
+        "view_change",
+        "range_navigate",
         "pick"
       ],
+      "state": [
+        {
+          "name": "currentView",
+          "type": "CalendarView",
+          "description": "Active view name (e.g. dayGridMonth, timeGridWeek)."
+        },
+        {
+          "name": "currentDate",
+          "type": "iso-date",
+          "description": "ISO date anchor of the visible range."
+        },
+        {
+          "name": "currentTitle",
+          "type": "string",
+          "description": "Human title of the current range (e.g. \"April 2026\")."
+        }
+      ],
+      "actions": [
+        {
+          "name": "today",
+          "safety": "read",
+          "description": "Jump to the current day."
+        },
+        {
+          "name": "prev",
+          "safety": "read",
+          "description": "Move to the previous range."
+        },
+        {
+          "name": "next",
+          "safety": "read",
+          "description": "Move to the next range."
+        },
+        {
+          "name": "goto_date",
+          "safety": "read",
+          "argsType": "{ date: string | Date }",
+          "description": "Navigate to a specific date."
+        },
+        {
+          "name": "change_view",
+          "safety": "read",
+          "argsType": "{ view: CalendarView }",
+          "description": "Switch the calendar to the given view."
+        },
+        {
+          "name": "focus_event",
+          "safety": "read",
+          "argsType": "{ eventId: string }",
+          "description": "Scroll an event into view and briefly highlight it."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "calendar",
+          "description": "Marks the Calendar wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-event-id",
+          "description": "Emitted on every rendered FullCalendar event by the kit event renderer. Used by focusEvent."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "card",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "card",
+          "description": "Marks the Card root. Interactive Cards inherit `role=\"button\"` (unless `asChild` is used) and are addressed by their native `id`."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "chart",
+      "capabilities": [],
+      "state": [],
+      "actions": [
+        {
+          "name": "update_series",
+          "safety": "read",
+          "argsType": "series",
+          "description": "Replace the chart series without remounting."
+        },
+        {
+          "name": "export_png",
+          "safety": "read",
+          "description": "Return a PNG data URI of the chart for export or screenshotting."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "chart"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "chat-container",
+      "capabilities": [
+        "navigate"
+      ],
+      "state": [],
+      "actions": [
+        {
+          "name": "scroll_to_bottom",
+          "safety": "read",
+          "argsType": "{ smooth?: boolean }",
+          "description": "Scroll the conversation viewport to the latest message."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "chat-container"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "chat-input",
+      "capabilities": [
+        "edit_inline",
+        "submit"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string",
+          "description": "Current text in the composer."
+        },
+        {
+          "name": "isEmpty",
+          "type": "boolean",
+          "description": "True when the composer has no text."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: string }",
+          "description": "Replace the composer text."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Clear the composer. Irreversible from the same UI."
+        },
+        {
+          "name": "submit",
+          "safety": "write",
+          "description": "Submit the current composer state via onSubmit."
+        },
+        {
+          "name": "focus",
+          "safety": "read",
+          "description": "Move keyboard focus into the textarea."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "chat-input",
+          "description": "Marks the ChatInput wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "chat-message",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "chat-message",
+          "description": "Marks the ChatMessage article element. Agents address an individual message by its native `id` and read role / status from the DOM."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "checkbox",
+      "capabilities": [
+        "select_single"
+      ],
+      "state": [
+        {
+          "name": "checked",
+          "type": "boolean | \"indeterminate\"",
+          "description": "Current checked state."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_checked",
+          "safety": "write",
+          "argsType": "{ checked: boolean | \"indeterminate\" }",
+          "description": "Set the checked state to a specific value."
+        },
+        {
+          "name": "toggle",
+          "safety": "write",
+          "description": "Flip the checked state between checked and unchecked."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "checkbox",
+          "description": "Marks the Checkbox wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "checkbox-group",
+      "capabilities": [
+        "select_multiple"
+      ],
+      "state": [
+        {
+          "name": "selection",
+          "type": "string[]",
+          "description": "Values of currently-checked options."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_selection",
+          "safety": "write",
+          "argsType": "{ ids: string[] }",
+          "description": "Replace the current selection with the given option values."
+        },
+        {
+          "name": "clear_selection",
+          "safety": "destructive",
+          "description": "Uncheck every option in the group."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "checkbox-group",
+          "description": "Marks the CheckboxGroup fieldset."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-option-id",
+          "description": "Stable opaque value emitted on each rendered Checkbox child within the group."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "collapsible",
+      "capabilities": [
+        "expand"
+      ],
+      "state": [
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "True when the content panel is expanded."
+        }
+      ],
+      "actions": [
+        {
+          "name": "toggle",
+          "safety": "write",
+          "description": "Toggle between open and closed."
+        },
+        {
+          "name": "open",
+          "safety": "write",
+          "description": "Expand the content panel."
+        },
+        {
+          "name": "close",
+          "safety": "write",
+          "description": "Collapse the content panel."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "collapsible",
+          "description": "Marks the Collapsible root."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "color-picker",
+      "capabilities": [
+        "pick"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string",
+          "description": "Currently picked colour as a hex string (e.g. \"#3b82f6\")."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ hex: string }",
+          "description": "Set the picked colour from a hex string."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "color-picker",
+          "description": "Marks the ColorPicker wrapper (inline) or trigger (popover variant)."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "combobox",
+      "capabilities": [
+        "select_single",
+        "pick",
+        "filter",
+        "open",
+        "close"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string | null",
+          "description": "Currently-selected option value, or null when nothing is selected."
+        },
+        {
+          "name": "query",
+          "type": "string",
+          "description": "Current filter query in the combobox input."
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "True when the option list is visible."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "read",
+          "argsType": "{ value: string | null }",
+          "description": "Set the selected value programmatically."
+        },
+        {
+          "name": "apply_filter",
+          "safety": "read",
+          "argsType": "{ query: string }",
+          "description": "Set the filter query for the option list."
+        },
+        {
+          "name": "clear_selection",
+          "safety": "read",
+          "description": "Clear the current selection."
+        },
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the option list."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the option list."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "combobox"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-option-id",
+          "description": "Each option emits its value as data-option-id."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "command-palette",
+      "capabilities": [
+        "open",
+        "close",
+        "filter",
+        "pick",
+        "submit"
+      ],
+      "state": [
+        {
+          "name": "query",
+          "type": "string",
+          "description": "Current filter query in the command palette input."
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "True when the palette is visible."
+        }
+      ],
+      "actions": [
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the command palette."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the command palette."
+        },
+        {
+          "name": "apply_filter",
+          "safety": "read",
+          "argsType": "{ query: string }",
+          "description": "Set the filter query."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "command-palette"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-command-id",
+          "description": "Each command item emits its key as data-command-id."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "data-table",
+      "capabilities": [
+        "select_single",
+        "select_multiple",
+        "range_pick",
+        "filter",
+        "sort",
+        "paginate"
+      ],
+      "state": [
+        {
+          "name": "selection",
+          "type": "string[]",
+          "description": "Row ids of currently-selected rows."
+        },
+        {
+          "name": "filter",
+          "type": "object",
+          "description": "Current ag-grid filter model, keyed by column id."
+        },
+        {
+          "name": "sort",
+          "type": "Array<{ colId, sort }>",
+          "description": "Active sort, in priority order."
+        },
+        {
+          "name": "currentPage",
+          "type": "number",
+          "description": "Zero-indexed page number."
+        }
+      ],
+      "actions": [
+        {
+          "name": "select_rows",
+          "safety": "read",
+          "argsType": "{ ids: string[] }",
+          "description": "Replace the current selection with the given row ids."
+        },
+        {
+          "name": "select_range",
+          "safety": "read",
+          "argsType": "{ fromId: string, toId: string }",
+          "description": "Select every row between fromId and toId, inclusive, in current sort order."
+        },
+        {
+          "name": "clear_selection",
+          "safety": "read",
+          "description": "Deselect all rows."
+        },
+        {
+          "name": "apply_filter",
+          "safety": "read",
+          "argsType": "{ model: Record<string, unknown> }",
+          "description": "Replace the filter model with the given object."
+        },
+        {
+          "name": "sort_by",
+          "safety": "read",
+          "argsType": "{ model: DataTableSortEntry[] }",
+          "description": "Replace the active sort with the given list (priority order)."
+        },
+        {
+          "name": "go_to_page",
+          "safety": "read",
+          "argsType": "{ page: number }",
+          "description": "Navigate to the given zero-indexed page."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "data-table",
+          "description": "Marks the DataTable wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "gridId",
+          "description": "Sourced from the gridId prop. Required to address a specific table from the agent."
+        },
+        "item": {
+          "attr": "row-id",
+          "description": "Native ag-grid row-id attribute on each rendered row. Selection is performed via the curated handle, not by DOM mutation."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "date-picker",
+      "capabilities": [
+        "pick",
+        "open",
+        "close"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "iso-date",
+          "description": "Currently-selected ISO date, or null."
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "Whether the calendar popover is open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_date",
+          "safety": "write",
+          "argsType": "{ date: string }",
+          "description": "Select a specific date (ISO yyyy-mm-dd)."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Clear the selected date."
+        },
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the calendar popover."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the calendar popover."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "date-picker",
+          "description": "Marks the DatePicker wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "date-range-picker",
+      "capabilities": [
+        "range_pick",
+        "open",
+        "close"
+      ],
+      "state": [
+        {
+          "name": "range",
+          "type": "{ from: iso-date | null, to: iso-date | null }",
+          "description": "Currently-selected ISO date range endpoints, each possibly null."
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "Whether the range calendar popover is open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_range",
+          "safety": "write",
+          "argsType": "{ from: string, to: string }",
+          "description": "Replace the selected range with the given ISO endpoints."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Clear the selected range."
+        },
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the range calendar popover."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the range calendar popover."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "date-range-picker",
+          "description": "Marks the DateRangePicker wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "date-time-picker",
+      "capabilities": [
+        "pick",
+        "open",
+        "close"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "iso-datetime",
+          "description": "Currently-selected ISO datetime, or null."
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "Whether the datetime popover is open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_datetime",
+          "safety": "write",
+          "argsType": "{ datetime: string }",
+          "description": "Select a specific datetime (ISO string)."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Clear the selected datetime."
+        },
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the datetime popover."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the datetime popover."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "date-time-picker",
+          "description": "Marks the DateTimePicker wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "description-list",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "description-list",
+          "description": "Marks the element as a kit DescriptionList."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "dialog",
+      "capabilities": [
+        "open",
+        "close",
+        "dismiss"
+      ],
+      "state": [
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "True when the dialog is currently open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the dialog."
+        },
+        {
+          "name": "close",
+          "safety": "write",
+          "description": "Close the dialog. Reversible by reopening."
+        },
+        {
+          "name": "dismiss",
+          "safety": "destructive",
+          "description": "Dismiss the dialog. Loses any in-progress input that has not been committed."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "dialog"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop on Dialog.Root."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "dropdown-menu",
+      "capabilities": [
+        "open",
+        "close",
+        "pick"
+      ],
+      "state": [
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "True when the menu is currently open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the menu."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the menu."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "dropdown-menu"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop on DropdownMenu.Root."
+        },
+        "item": {
+          "attr": "data-item-id",
+          "description": "Each menu item emits its value as data-item-id."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "empty-state",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "empty-state",
+          "description": "Marks the EmptyState wrapper. CTAs inside are kit Buttons / Links and carry their own DOM hooks."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "file-upload",
+      "capabilities": [
+        "submit",
+        "dismiss"
+      ],
+      "state": [
+        {
+          "name": "files",
+          "type": "Array<{ id, name, size, status }>",
+          "description": "Files currently tracked by the uploader. Identifiers and metadata only — never file content."
+        }
+      ],
+      "actions": [
+        {
+          "name": "remove_file",
+          "safety": "destructive",
+          "argsType": "{ id: string }",
+          "description": "Remove the file with the given id from the upload list."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Remove all files from the upload list."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "file-upload"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-file-id",
+          "description": "Each tracked file emits its id as data-file-id."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "flag",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "flag",
+          "description": "Marks the element as a kit Flag glyph."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "floating-action-button",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "floating-action-button",
+          "description": "Marks the element as a kit FloatingActionButton. Safety is declared by the host pattern, not the button."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "form-field",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "form-field",
+          "description": "Marks the FormField wrapper. The label, description, and error are siblings of the inner input; agents address the input by its native `id`, which FormField wires up via context."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "freemium-paywall",
+      "capabilities": [
+        "submit",
+        "dismiss"
+      ],
+      "state": [
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "True when the paywall dialog is open."
+        },
+        {
+          "name": "selectedPlanId",
+          "type": "string | null",
+          "description": "Opaque id of the currently-selected plan."
+        }
+      ],
+      "actions": [
+        {
+          "name": "upgrade",
+          "safety": "write",
+          "description": "Fire onUpgrade with the currently-selected plan id."
+        },
+        {
+          "name": "dismiss",
+          "safety": "destructive",
+          "description": "Dismiss the paywall via the Not Now action. Irreversible from the same UI."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "freemium-paywall",
+          "description": "Marks the FreemiumPaywall dialog content."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "header",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "header",
+          "description": "Marks the page Header banner. Emits `data-scrolled=\"true\"` while the user has scrolled past the sentinel. Inner controls (HeaderBrand, HeaderMenuButton, etc.) carry their own component hooks."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "icon-button",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "icon-button",
+          "description": "Marks the element as a kit IconButton. Safety is declared by the host pattern, not the button. IconButtons inherit native `id` from props, which is what agents address them by."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "icon-button-group",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "icon-button-group",
+          "description": "Marks the IconButtonGroup wrapper. Agents target individual IconButtons inside the group via their native `id`."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "kbd",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "kbd",
+          "description": "Marks the element as a kit Kbd glyph."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "key-value-pair",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "key-value-pair",
+          "description": "Marks the element as a kit KeyValuePair row."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "link",
+      "capabilities": [
+        "navigate"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "link",
+          "description": "Marks the element as a kit Link. The destination URL is the native `href` attribute on the anchor; agents read it directly from the DOM."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "list",
+      "capabilities": [
+        "select_single",
+        "select_multiple"
+      ],
+      "state": [
+        {
+          "name": "selection",
+          "type": "string[]",
+          "description": "Ids of currently-selected list items. Empty array when none selected or list is presentational."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_selection",
+          "safety": "read",
+          "argsType": "{ ids: string[] }",
+          "description": "Replace the current selection with the given item ids. No-op on presentational lists."
+        },
+        {
+          "name": "clear_selection",
+          "safety": "read",
+          "description": "Deselect all items."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "list",
+          "description": "Marks the List root."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-item-id",
+          "description": "Opaque item id; sourced from each ListItem `value` prop. Emitted only when `value` is set."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "live-region",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "live-region",
+          "description": "Marks the LiveRegion element. `aria-live` politeness and `role` are emitted as native attributes; announcement content is the element's text content."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "logo",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "logo",
+          "description": "Marks the element as the AlfaDocs Logo asset."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "matrix-rain",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "matrix-rain",
+          "description": "Marks the decorative MatrixRain canvas."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "message-card",
+      "capabilities": [
+        "dismiss"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "message-card",
+          "description": "Marks the element as a kit MessageCard. The card root also emits data-component-id sourced from item.id and data-read with the current read flag."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "item.id",
+          "description": "Sourced from item.id — the stable message identifier."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "message-tray",
+      "capabilities": [
+        "open",
+        "close",
+        "select_single",
+        "dismiss"
+      ],
+      "state": [
+        {
+          "name": "items",
+          "type": "Array<{ id: string; read: boolean }>",
+          "description": "Currently-displayed messages. Ids + read flag only — no PHI / no sender names."
+        },
+        {
+          "name": "unreadCount",
+          "type": "number",
+          "description": "Badge unread count surfaced by the host."
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "Whether the dropdown panel is currently open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the message panel."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the message panel."
+        },
+        {
+          "name": "select_item",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "description": "Activate the message with the given id."
+        },
+        {
+          "name": "mark_read",
+          "safety": "write",
+          "argsType": "{ id: string }",
+          "description": "Request the host to mark a message as read."
+        },
+        {
+          "name": "dismiss",
+          "safety": "destructive",
+          "argsType": "{ id: string }",
+          "description": "Request the host to dismiss / archive the message with the given id."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "message-tray",
+          "description": "Marks the MessageTray wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop. Required to address a specific tray from the agent."
+        },
+        "item": {
+          "attr": "data-message-id",
+          "description": "Stable message id emitted on each rendered MessageCard inside the tray."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "multi-select",
+      "capabilities": [
+        "select_multiple",
+        "filter",
+        "open",
+        "close"
+      ],
+      "state": [
+        {
+          "name": "selection",
+          "type": "string[]",
+          "description": "Values of currently-selected options."
+        },
+        {
+          "name": "query",
+          "type": "string",
+          "description": "Current filter query."
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "True when the option list is visible."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_selection",
+          "safety": "read",
+          "argsType": "{ values: string[] }",
+          "description": "Replace the current selection with the given list of values."
+        },
+        {
+          "name": "clear_selection",
+          "safety": "read",
+          "description": "Clear the current selection."
+        },
+        {
+          "name": "apply_filter",
+          "safety": "read",
+          "argsType": "{ query: string }",
+          "description": "Set the filter query for the option list."
+        },
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the option list."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the option list."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "multi-select"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-option-id",
+          "description": "Each option emits its value as data-option-id."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "navigation-menu",
+      "capabilities": [
+        "select_single",
+        "navigate",
+        "open",
+        "close"
+      ],
+      "state": [
+        {
+          "name": "activeItem",
+          "type": "string | null",
+          "description": "Id of the currently-active top-level navigation item, or null when none is active."
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "Whether a dropdown / mega-menu panel is currently open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "select_item",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "description": "Activate (open) the top-level item with the given id."
+        },
+        {
+          "name": "open",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "description": "Open the dropdown / mega-menu panel for the given top-level item id."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close any open dropdown / mega-menu panel."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "navigation-menu",
+          "description": "Marks the NavigationMenu root."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop. Required to address a specific menu from the agent."
+        },
+        "item": {
+          "attr": "data-nav-id",
+          "description": "Stable opaque id of a top-level navigation item. Selection / open targets this attribute."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "notification-card",
+      "capabilities": [
+        "dismiss"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "notification-card",
+          "description": "Marks the element as a kit NotificationCard. The card root also emits data-component-id sourced from item.id and data-read with the current read flag."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "item.id",
+          "description": "Sourced from item.id — the stable notification identifier."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "notification-tray",
+      "capabilities": [
+        "open",
+        "close",
+        "select_single",
+        "dismiss"
+      ],
+      "state": [
+        {
+          "name": "items",
+          "type": "Array<{ id: string; read: boolean }>",
+          "description": "Currently-displayed notifications. Ids + read flag only — no PHI."
+        },
+        {
+          "name": "unreadCount",
+          "type": "number",
+          "description": "Badge unread count surfaced by the host."
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "Whether the dropdown panel is currently open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the notification panel."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the notification panel."
+        },
+        {
+          "name": "select_item",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "description": "Activate the notification with the given id."
+        },
+        {
+          "name": "mark_read",
+          "safety": "write",
+          "argsType": "{ id: string }",
+          "description": "Request the host to mark a notification as read."
+        },
+        {
+          "name": "dismiss",
+          "safety": "destructive",
+          "argsType": "{ id: string }",
+          "description": "Request the host to dismiss the notification with the given id."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "notification-tray",
+          "description": "Marks the NotificationTray wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop. Required to address a specific tray from the agent."
+        },
+        "item": {
+          "attr": "data-notification-id",
+          "description": "Stable notification id emitted on each rendered NotificationCard inside the tray."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "number-input",
+      "capabilities": [
+        "edit_inline"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "number | null",
+          "description": "Current numeric value, or null when empty."
+        },
+        {
+          "name": "isEmpty",
+          "type": "boolean",
+          "description": "Whether the input has no value."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: number | null }",
+          "description": "Replace the numeric value, or pass null to clear."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Empty the input. Loses any typed value."
+        },
+        {
+          "name": "focus",
+          "safety": "read",
+          "description": "Move keyboard focus to the input."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "number-input",
+          "description": "Marks the NumberInput wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "otp-input",
+      "capabilities": [
+        "edit_inline",
+        "submit"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string",
+          "description": "Current digits entered, packed into a single string."
+        },
+        {
+          "name": "isComplete",
+          "type": "boolean",
+          "description": "Whether all required digits have been entered."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: string }",
+          "description": "Replace the entered digits."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Empty all digit cells. Loses any typed value."
+        },
+        {
+          "name": "focus",
+          "safety": "read",
+          "description": "Move keyboard focus to the active digit cell."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "otp-input",
+          "description": "Marks the OTPInput wrapper. Completion is observable via state.isComplete; the host onComplete callback fires once when all digits are filled."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "pagination",
+      "capabilities": [
+        "paginate",
+        "range_navigate"
+      ],
+      "state": [
+        {
+          "name": "currentPage",
+          "type": "number",
+          "description": "Current page index (1-based)."
+        },
+        {
+          "name": "totalPages",
+          "type": "number",
+          "description": "Total number of pages."
+        }
+      ],
+      "actions": [
+        {
+          "name": "go_to_page",
+          "safety": "read",
+          "argsType": "{ page: number }",
+          "description": "Navigate to a specific 1-indexed page."
+        },
+        {
+          "name": "next",
+          "safety": "read",
+          "description": "Advance to the next page."
+        },
+        {
+          "name": "previous",
+          "safety": "read",
+          "description": "Step back to the previous page."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "pagination"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "password-input",
+      "capabilities": [
+        "edit_inline"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string",
+          "description": "Current password value. Never log or persist this off-device."
+        },
+        {
+          "name": "isEmpty",
+          "type": "boolean",
+          "description": "Whether the input has no value."
+        },
+        {
+          "name": "isRevealed",
+          "type": "boolean",
+          "description": "Whether the password is currently shown in plain text."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: string }",
+          "description": "Replace the password value."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Empty the input. Loses any typed value."
+        },
+        {
+          "name": "focus",
+          "safety": "read",
+          "description": "Move keyboard focus to the input."
+        },
+        {
+          "name": "toggle_visibility",
+          "safety": "read",
+          "description": "Toggle between masked and plain-text display."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "password-input",
+          "description": "Marks the PasswordInput wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "payment-form",
+      "capabilities": [
+        "submit"
+      ],
+      "state": [],
+      "actions": [
+        {
+          "name": "submit",
+          "safety": "destructive",
+          "description": "Submit the payment. Charges the configured payment method — irreversible."
+        },
+        {
+          "name": "reset",
+          "safety": "destructive",
+          "description": "Reset the form to its initial state. Loses any in-progress input."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "payment-form"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "pdf-viewer",
+      "capabilities": [
+        "paginate",
+        "view_change",
+        "filter"
+      ],
+      "state": [],
+      "actions": [
+        {
+          "name": "go_to_page",
+          "safety": "read",
+          "argsType": "{ page: number }",
+          "description": "Navigate to a specific 1-indexed page."
+        },
+        {
+          "name": "set_zoom",
+          "safety": "read",
+          "argsType": "{ zoom: PDFZoomPreset }",
+          "description": "Apply a zoom preset."
+        },
+        {
+          "name": "search",
+          "safety": "read",
+          "argsType": "{ query: string }",
+          "description": "Search the document for the given query and highlight matches."
+        },
+        {
+          "name": "print",
+          "safety": "read",
+          "description": "Open the browser print dialog for the document."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "pdf-viewer"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "phone-input",
+      "capabilities": [
+        "edit_inline"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string",
+          "description": "Current E.164 phone number, or empty string when not yet valid."
+        },
+        {
+          "name": "isEmpty",
+          "type": "boolean",
+          "description": "Whether the input has no value."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: string }",
+          "description": "Replace the phone number (E.164 or national format; parser will infer country)."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Empty the input. Loses any typed value."
+        },
+        {
+          "name": "focus",
+          "safety": "read",
+          "description": "Move keyboard focus to the phone-number input."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "phone-input",
+          "description": "Marks the PhoneInput wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "popover",
+      "capabilities": [
+        "open",
+        "close"
+      ],
+      "state": [
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "True when the popover is currently open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the popover."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the popover."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "popover"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop on Popover.Root."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "privacy-lock",
+      "capabilities": [
+        "submit",
+        "dismiss"
+      ],
+      "state": [
+        {
+          "name": "isLocked",
+          "type": "boolean",
+          "description": "True when the privacy overlay is open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "lock",
+          "safety": "write",
+          "description": "Open the privacy overlay."
+        },
+        {
+          "name": "unlock",
+          "safety": "write",
+          "description": "Close the privacy overlay (consumer-confirmed action)."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "privacy-lock",
+          "description": "Marks the PrivacyLock trigger."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "progress",
+      "capabilities": [],
+      "state": [],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "read",
+          "argsType": "{ value: number }",
+          "description": "Set the displayed progress value (0–100)."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "progress"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "radio",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "radio",
+          "description": "Marks a single Radio item. Group-level selection is exposed by the parent RadioGroup adapter."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "radio-group",
+      "capabilities": [
+        "select_single"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string",
+          "description": "Currently selected radio value, or empty string when none."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: string }",
+          "description": "Select the radio with the given value."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "radio-group",
+          "description": "Marks the RadioGroup root."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-option-id",
+          "description": "Stable opaque value emitted on each rendered Radio child."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "recaptcha-widget",
+      "capabilities": [
+        "submit"
+      ],
+      "state": [
+        {
+          "name": "hasToken",
+          "type": "boolean",
+          "description": "True when the widget currently holds a valid verification token."
+        }
+      ],
+      "actions": [
+        {
+          "name": "execute",
+          "safety": "write",
+          "description": "Programmatically trigger the captcha challenge. Issues a token via the callback."
+        },
+        {
+          "name": "reset",
+          "safety": "destructive",
+          "description": "Clear the current token and re-roll the captcha. Irreversible."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "recaptcha-widget",
+          "description": "Marks the RecaptchaWidget wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop (or the surrounding FormField id)."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "resizable",
+      "capabilities": [
+        "range_navigate"
+      ],
+      "state": [
+        {
+          "name": "sizes",
+          "type": "number[]",
+          "description": "Current per-panel sizes as percentages of the group."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_sizes",
+          "safety": "read",
+          "argsType": "{ sizes: number[] }",
+          "description": "Replace the panel sizes (percentages, summing to 100)."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "resizable"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop on PanelGroup."
+        },
+        "item": {
+          "attr": "data-panel-id",
+          "description": "Each Panel forwards its `id` to react-resizable-panels which emits it as `data-panel-id`."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "rich-text-editor",
+      "capabilities": [
+        "edit_inline"
+      ],
+      "state": [
+        {
+          "name": "html",
+          "type": "string",
+          "description": "Sanitised HTML representation of the editor content."
+        },
+        {
+          "name": "markdown",
+          "type": "string",
+          "description": "Markdown representation of the editor content."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_content",
+          "safety": "destructive",
+          "argsType": "{ html: string }",
+          "description": "Replace the editor content. Loses unsaved input."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Empty the editor. Loses unsaved input."
+        },
+        {
+          "name": "focus",
+          "safety": "read",
+          "description": "Move keyboard focus to the editor surface."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "rich-text-editor"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "scroll-area",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "scroll-area",
+          "description": "Marks the element as a kit ScrollArea."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "search-bar",
+      "capabilities": [
+        "filter",
+        "edit_inline",
+        "submit"
+      ],
+      "state": [
+        {
+          "name": "query",
+          "type": "string",
+          "description": "Current raw query string (inline mode). Empty in launcher mode."
+        },
+        {
+          "name": "isEmpty",
+          "type": "boolean",
+          "description": "True when the query is empty."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_query",
+          "safety": "read",
+          "argsType": "{ query: string }",
+          "description": "Replace the current query (inline mode only). No-op in launcher mode."
+        },
+        {
+          "name": "clear",
+          "safety": "read",
+          "description": "Clear the query and close the result popover."
+        },
+        {
+          "name": "submit",
+          "safety": "read",
+          "description": "In launcher mode opens the CommandPalette; in inline mode commits the highlighted option."
+        },
+        {
+          "name": "focus",
+          "safety": "read",
+          "description": "Move keyboard focus to the SearchBar."
+        },
+        {
+          "name": "apply_saved_search",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "description": "Apply a saved-search by id. The host wires the actual query lookup; the adapter routes the id to its onApplySavedSearch handler. No-op when no handler is wired."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "search-bar",
+          "description": "Marks the SearchBar root."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "search-input",
+      "capabilities": [
+        "filter",
+        "edit_inline"
+      ],
+      "state": [
+        {
+          "name": "query",
+          "type": "string",
+          "description": "Current raw query string (not debounced)."
+        },
+        {
+          "name": "isEmpty",
+          "type": "boolean",
+          "description": "True when the query is empty."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_query",
+          "safety": "read",
+          "argsType": "{ query: string }",
+          "description": "Replace the current query with the given string and fire onChange immediately."
+        },
+        {
+          "name": "clear",
+          "safety": "read",
+          "description": "Clear the query and return focus to the input."
+        },
+        {
+          "name": "submit",
+          "safety": "read",
+          "description": "Fire the current query without waiting for debounce."
+        },
+        {
+          "name": "focus",
+          "safety": "read",
+          "description": "Move keyboard focus to the input (expanding it first if `variant=\"expandable\"`)."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "search-input",
+          "description": "Marks the SearchInput wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "select",
+      "capabilities": [
+        "select_single",
+        "open",
+        "close"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string",
+          "description": "Currently selected option value, or empty string when none."
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "Whether the option list is open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: string }",
+          "description": "Select the option with the given value."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Clear the current selection."
+        },
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the option list."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the option list."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "select",
+          "description": "Marks the Select trigger."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-option-id",
+          "description": "Stable opaque option value emitted on each rendered option."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "separator",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "separator",
+          "description": "Marks the element as a kit Separator."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "sheet",
+      "capabilities": [
+        "open",
+        "close",
+        "dismiss"
+      ],
+      "state": [
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "True when the sheet is currently open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the sheet."
+        },
+        {
+          "name": "close",
+          "safety": "write",
+          "description": "Close the sheet. Reversible by reopening."
+        },
+        {
+          "name": "dismiss",
+          "safety": "destructive",
+          "description": "Dismiss the sheet. Loses any in-progress input that has not been committed."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "sheet"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop on Sheet.Root."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "sidebar",
+      "capabilities": [
+        "expand"
+      ],
+      "state": [
+        {
+          "name": "isCollapsed",
+          "type": "boolean",
+          "description": "True when the sidebar is in its collapsed (rail) state."
+        }
+      ],
+      "actions": [
+        {
+          "name": "toggle_collapsed",
+          "safety": "read",
+          "description": "Toggle the sidebar between collapsed and expanded."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "sidebar"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-nav-id",
+          "description": "Each Sidebar.Item emits its key as data-nav-id."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "sign-in-with-alfadocs-button",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "sign-in-with-alfadocs-button",
+          "description": "Marks the branded sign-in trigger. Safety is declared by the host auth pattern."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "signature-capture",
+      "capabilities": [
+        "edit_inline",
+        "submit"
+      ],
+      "state": [
+        {
+          "name": "isEmpty",
+          "type": "boolean",
+          "description": "True when no signature has been drawn or typed."
+        }
+      ],
+      "actions": [
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Erase the current signature. Loses unsaved input."
+        },
+        {
+          "name": "undo",
+          "safety": "write",
+          "description": "Undo the last stroke."
+        },
+        {
+          "name": "confirm",
+          "safety": "write",
+          "description": "Commit the signature and return its serialised payload."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "signature-capture"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "skeleton",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "skeleton",
+          "description": "Marks the element as a kit Skeleton placeholder."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "skip-link",
+      "capabilities": [
+        "navigate"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "skip-link",
+          "description": "Marks the SkipLink anchor. Destination is the native `href` attribute."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "slider",
+      "capabilities": [
+        "pick",
+        "range_pick"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "number[]",
+          "description": "Current thumb values; length 1 for a single slider, length 2 for a range."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: number[] }",
+          "description": "Replace the thumb value(s). Pass a 1-tuple for single, 2-tuple for range."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "slider",
+          "description": "Marks the Slider root."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "slot-grid",
+      "capabilities": [
+        "pick",
+        "range_navigate",
+        "expand"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "slot-grid",
+          "description": "Marks the SlotGrid region. Emits `data-state` reflecting the public `state` prop (default / loading / disabled / empty)."
+        },
+        "item": {
+          "attr": "data-slot-id",
+          "sourceProp": "days[].slots[].id",
+          "description": "Per-slot button identifier sourced from each `SlotGridSlot.id`. Agents activate a slot via native click on the matching button."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "sparkline",
+      "capabilities": [],
+      "state": [],
+      "actions": [
+        {
+          "name": "update_series",
+          "safety": "read",
+          "argsType": "{ data: number[] }",
+          "description": "Replace the sparkline data without remounting."
+        },
+        {
+          "name": "export_png",
+          "safety": "read",
+          "description": "Return a PNG data URI of the sparkline."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "sparkline"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "spinner",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "spinner",
+          "description": "Marks the element as a kit Spinner."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "stat",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "stat",
+          "description": "Marks the element as a kit Stat tile."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "stepper-accordion",
+      "capabilities": [
+        "expand",
+        "navigate"
+      ],
+      "state": [
+        {
+          "name": "currentStep",
+          "type": "number",
+          "description": "Zero-indexed active step."
+        },
+        {
+          "name": "totalSteps",
+          "type": "number",
+          "description": "Total number of steps in the flow."
+        },
+        {
+          "name": "openSteps",
+          "type": "number[]",
+          "description": "Indices of currently-open step panels (singleton under Radix single mode)."
+        }
+      ],
+      "actions": [
+        {
+          "name": "goto_step",
+          "safety": "read",
+          "argsType": "{ step: number }",
+          "description": "Activate the given step. Upcoming steps are gated by the consumer’s validation in onStepChange."
+        },
+        {
+          "name": "next",
+          "safety": "read",
+          "description": "Advance to the next step. Subject to the consumer’s onStepChange validation."
+        },
+        {
+          "name": "previous",
+          "safety": "read",
+          "description": "Return to the previous step (re-opens a completed step in edit mode)."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "stepper-accordion",
+          "description": "Marks the StepperAccordion root."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-step-id",
+          "description": "Stable opaque id of a step (the zero-indexed step number as a string)."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "stepper-calendar",
+      "capabilities": [
+        "navigate",
+        "view_change"
+      ],
+      "state": [
+        {
+          "name": "currentStep",
+          "type": "number",
+          "description": "Zero-indexed active step (0 = service, 1 = date, 2 = time, 3 = details)."
+        },
+        {
+          "name": "totalSteps",
+          "type": "number",
+          "description": "Total number of steps in the booking flow (always 4)."
+        }
+      ],
+      "actions": [
+        {
+          "name": "goto_step",
+          "safety": "read",
+          "argsType": "{ step: number }",
+          "description": "Jump to the given step. Steps beyond the first-incomplete are gated internally."
+        },
+        {
+          "name": "next",
+          "safety": "read",
+          "description": "Advance to the next step when the current step has a valid value."
+        },
+        {
+          "name": "previous",
+          "safety": "read",
+          "description": "Return to the previous step."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "stepper-calendar",
+          "description": "Marks the StepperCalendar root region."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "stepper-progress",
+      "capabilities": [
+        "navigate"
+      ],
+      "state": [
+        {
+          "name": "currentStep",
+          "type": "number",
+          "description": "Zero-indexed active step."
+        },
+        {
+          "name": "totalSteps",
+          "type": "number",
+          "description": "Total number of steps in the flow."
+        }
+      ],
+      "actions": [
+        {
+          "name": "goto_step",
+          "safety": "read",
+          "argsType": "{ step: number }",
+          "description": "Request the host to activate the given step via onStepChange. No-op when no handler is wired."
+        },
+        {
+          "name": "next",
+          "safety": "read",
+          "description": "Request the host to advance one step via onStepChange."
+        },
+        {
+          "name": "previous",
+          "safety": "read",
+          "description": "Request the host to retreat one step via onStepChange."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "stepper-progress",
+          "description": "Marks the StepperProgress root."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "streaming-text",
+      "capabilities": [],
       "state": [],
       "actions": [],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "dropdown-menu"
-        },
-        "item": {
-          "attr": "data-item-id",
-          "description": "Each menu item emits its value as data-item-id."
+          "value": "streaming-text",
+          "description": "Marks the element as a kit StreamingText surface."
         }
       }
     },
     {
       "kind": "component",
-      "id": "file-upload",
+      "id": "suggestion-chip",
       "capabilities": [
-        "submit",
+        "pick",
         "dismiss"
       ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string",
+          "description": "The chip's emitted value (its `value` prop or string child)."
+        }
+      ],
+      "actions": [
+        {
+          "name": "select",
+          "safety": "write",
+          "description": "Activate the chip — fires onSelect and (by default) self-removes."
+        },
+        {
+          "name": "dismiss",
+          "safety": "destructive",
+          "description": "Remove the chip without activating it."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "suggestion-chip",
+          "description": "Marks the chip button. Per chip — a parent rendering many chips ships its own item hook."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "switch",
+      "capabilities": [
+        "select_single"
+      ],
+      "state": [
+        {
+          "name": "checked",
+          "type": "boolean",
+          "description": "Whether the switch is on."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_checked",
+          "safety": "write",
+          "argsType": "{ checked: boolean }",
+          "description": "Set the on/off state to a specific value."
+        },
+        {
+          "name": "toggle",
+          "safety": "write",
+          "description": "Flip the on/off state."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "switch",
+          "description": "Marks the Switch root."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "tabs",
+      "capabilities": [
+        "select_single",
+        "navigate"
+      ],
+      "state": [
+        {
+          "name": "activeTab",
+          "type": "string | null",
+          "description": "Value of the currently-active tab."
+        }
+      ],
+      "actions": [
+        {
+          "name": "select_tab",
+          "safety": "read",
+          "argsType": "{ value: string }",
+          "description": "Activate the tab with the given value."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "tabs"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop on Tabs.Root."
+        },
+        "item": {
+          "attr": "data-tab-id",
+          "description": "Each Tab.Trigger emits its value as data-tab-id."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "tag",
+      "capabilities": [],
       "state": [],
       "actions": [],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "file-upload"
+          "value": "tag",
+          "description": "Marks the element as a kit Tag."
         }
       }
     },
     {
       "kind": "component",
-      "id": "multi-select",
+      "id": "task-card",
       "capabilities": [
-        "select_multiple",
-        "filter",
-        "open",
-        "close"
+        "dismiss"
       ],
       "state": [],
       "actions": [],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "multi-select"
+          "value": "task-card",
+          "description": "Marks the element as a kit TaskCard. The card root also emits data-component-id sourced from item.id and data-status with the current lifecycle."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "item.id",
+          "description": "Sourced from item.id — the stable task identifier."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "task-tray",
+      "capabilities": [
+        "select_single",
+        "dismiss"
+      ],
+      "state": [
+        {
+          "name": "items",
+          "type": "Array<{ id: string; status: string }>",
+          "description": "Currently-displayed tasks. Ids + status only — never task title / patient."
+        }
+      ],
+      "actions": [
+        {
+          "name": "select_item",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "description": "Activate the task with the given id."
+        },
+        {
+          "name": "toggle_done",
+          "safety": "write",
+          "argsType": "{ id: string }",
+          "description": "Request the host to toggle the done state of a task."
+        },
+        {
+          "name": "dismiss",
+          "safety": "destructive",
+          "argsType": "{ id: string }",
+          "description": "Request the host to dismiss / remove the task with the given id."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "task-tray",
+          "description": "Marks the TaskTray wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop. Required to address a specific tray from the agent."
         },
         "item": {
-          "attr": "data-option-id",
-          "description": "Each option emits its value as data-option-id."
+          "attr": "data-task-id",
+          "description": "Stable task id emitted on each rendered TaskCard inside the tray."
         }
       }
     },
     {
       "kind": "component",
-      "id": "pagination",
+      "id": "text-area",
       "capabilities": [
-        "paginate",
-        "range_navigate"
+        "edit_inline"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string",
+          "description": "Current value of the textarea."
+        },
+        {
+          "name": "isEmpty",
+          "type": "boolean",
+          "description": "Whether the textarea has no value."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: string }",
+          "description": "Replace the textarea value."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Empty the textarea. Loses any typed value."
+        },
+        {
+          "name": "focus",
+          "safety": "read",
+          "description": "Move keyboard focus to the textarea."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "text-area",
+          "description": "Marks the TextArea wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "text-input",
+      "capabilities": [
+        "edit_inline"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string",
+          "description": "Current value of the text input."
+        },
+        {
+          "name": "isEmpty",
+          "type": "boolean",
+          "description": "Whether the input has no value."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: string }",
+          "description": "Replace the input value."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Empty the input. Loses any typed value."
+        },
+        {
+          "name": "focus",
+          "safety": "read",
+          "description": "Move keyboard focus to the input."
+        }
       ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "text-input",
+          "description": "Marks the TextInput wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "theme-root",
+      "capabilities": [],
       "state": [],
       "actions": [],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "pagination"
+          "value": "theme-root",
+          "description": "Marks the ThemeRoot wrapper. The active theme is encoded in the element's class list (`theme-light` / `theme-dark` / `theme-accessible`)."
         }
       }
     },
     {
       "kind": "component",
-      "id": "payment-form",
+      "id": "theme-toggle",
       "capabilities": [
-        "submit"
+        "view_change"
+      ],
+      "state": [
+        {
+          "name": "currentTheme",
+          "type": "ThemePreference",
+          "description": "Active theme preference: light, dark, or system."
+        },
+        {
+          "name": "currentAccessibility",
+          "type": "AccessibilityPreference",
+          "description": "Active accessibility preference: default or accessible."
+        }
       ],
-      "state": [],
       "actions": [
         {
-          "name": "submit",
-          "safety": "destructive",
-          "description": "Submit the payment. Charges the configured payment method — irreversible."
+          "name": "set_theme",
+          "safety": "write",
+          "argsType": "{ theme: \"light\" | \"dark\" | \"system\" }",
+          "description": "Switch the theme preference."
         },
         {
-          "name": "reset",
-          "safety": "destructive",
-          "description": "Reset the form to its initial state. Loses any in-progress input."
+          "name": "set_accessibility",
+          "safety": "write",
+          "argsType": "{ accessibility: \"default\" | \"accessible\" }",
+          "description": "Switch the accessibility preference."
         }
       ],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "payment-form"
+          "value": "theme-toggle",
+          "description": "Marks the ThemeToggle wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
         }
       }
     },
     {
       "kind": "component",
-      "id": "pdf-viewer",
+      "id": "time-picker",
       "capabilities": [
-        "paginate",
-        "view_change",
-        "filter"
+        "pick",
+        "open",
+        "close"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "HH:MM",
+          "description": "Currently-selected time as 24h HH:MM (always present — defaults to 00:00 when unset)."
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "Whether the time popover is open. TimePicker has no popover of its own; always false."
+        }
       ],
-      "state": [],
       "actions": [
         {
-          "name": "go_to_page",
-          "safety": "read",
-          "argsType": "{ page: number }",
-          "description": "Navigate to a specific 1-indexed page."
+          "name": "set_time",
+          "safety": "write",
+          "argsType": "{ time: string }",
+          "description": "Set the time using a 24h HH:MM string."
         },
         {
-          "name": "set_zoom",
-          "safety": "read",
-          "argsType": "{ zoom: PDFZoomPreset }",
-          "description": "Apply a zoom preset."
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Clear the time (resets to 00:00)."
         },
         {
-          "name": "search",
+          "name": "open",
           "safety": "read",
-          "argsType": "{ query: string }",
-          "description": "Search the document for the given query and highlight matches."
+          "description": "No-op: TimePicker has no popover of its own."
         },
         {
-          "name": "print",
+          "name": "close",
           "safety": "read",
-          "description": "Open the browser print dialog for the document."
+          "description": "No-op: TimePicker has no popover of its own."
         }
       ],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "pdf-viewer"
+          "value": "time-picker",
+          "description": "Marks the TimePicker wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
         }
       }
     },
     {
       "kind": "component",
-      "id": "popover",
+      "id": "timeline",
       "capabilities": [
-        "open",
-        "close"
+        "pick",
+        "range_navigate"
       ],
-      "state": [],
-      "actions": [],
-      "domHooks": {
-        "root": {
-          "attr": "data-component",
-          "value": "popover"
+      "state": [
+        {
+          "name": "selectedEvent",
+          "type": "string | null",
+          "description": "Opaque event id of the currently-active event, or null."
         }
-      }
-    },
-    {
-      "kind": "component",
-      "id": "progress",
-      "capabilities": [],
-      "state": [],
+      ],
       "actions": [
         {
-          "name": "set_value",
+          "name": "select_event",
           "safety": "read",
-          "argsType": "{ value: number }",
-          "description": "Set the displayed progress value (0–100)."
+          "argsType": "{ id: string }",
+          "description": "Scroll the given event into view and mark it as selected."
         }
       ],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "progress"
+          "value": "timeline",
+          "description": "Marks the Timeline root."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-event-id",
+          "description": "Opaque event id emitted on each Timeline.Event when the `eventId` prop is provided."
         }
       }
     },
     {
       "kind": "component",
-      "id": "resizable",
-      "capabilities": [
-        "range_navigate"
-      ],
+      "id": "timestamp",
+      "capabilities": [],
       "state": [],
       "actions": [],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "resizable"
-        },
-        "item": {
-          "attr": "data-panel-id",
-          "description": "Each Panel forwards its `id` to react-resizable-panels which emits it as `data-panel-id`."
+          "value": "timestamp",
+          "description": "Marks the element as a kit Timestamp. The machine-readable value lives in the native `datetime` attribute on the inner `<time>` element."
         }
       }
     },
     {
       "kind": "component",
-      "id": "rich-text-editor",
+      "id": "toast",
       "capabilities": [
-        "edit_inline"
+        "dismiss",
+        "open",
+        "close"
       ],
       "state": [
         {
-          "name": "html",
-          "type": "string",
-          "description": "Sanitised HTML representation of the editor content."
-        },
-        {
-          "name": "markdown",
-          "type": "string",
-          "description": "Markdown representation of the editor content."
+          "name": "visibleToasts",
+          "type": "Array<{ id: string }>",
+          "description": "Snapshot of currently-visible toasts by opaque id. Never carries the toast body text."
         }
       ],
       "actions": [
         {
-          "name": "set_content",
+          "name": "dismiss",
           "safety": "destructive",
-          "argsType": "{ html: string }",
-          "description": "Replace the editor content. Loses unsaved input."
+          "argsType": "{ id: string }",
+          "description": "Dismiss the toast with the given id. Irreversible from the same UI."
         },
         {
-          "name": "clear",
+          "name": "dismiss_all",
           "safety": "destructive",
-          "description": "Empty the editor. Loses unsaved input."
-        },
-        {
-          "name": "focus",
-          "safety": "read",
-          "description": "Move keyboard focus to the editor surface."
+          "description": "Dismiss every visible toast."
         }
       ],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "rich-text-editor"
+          "value": "toast",
+          "description": "Marks the Toaster region wrapper. Toast is imperatively created; the registry addresses individual toasts by id, not by per-instance root."
+        },
+        "item": {
+          "attr": "data-toast-id",
+          "description": "Stable opaque toast id assigned at creation. Used by `dismiss({id})`."
         }
       }
     },
     {
       "kind": "component",
-      "id": "sheet",
-      "capabilities": [
-        "open",
-        "close",
-        "dismiss"
-      ],
+      "id": "tooltip",
+      "capabilities": [],
       "state": [],
       "actions": [],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "sheet"
+          "value": "tooltip",
+          "description": "Marks the element as a kit Tooltip content surface."
         }
       }
     },
     {
       "kind": "component",
-      "id": "sidebar",
+      "id": "tooth-scheme",
       "capabilities": [
-        "expand",
-        "select_single",
-        "navigate"
+        "pick"
+      ],
+      "state": [
+        {
+          "name": "chart",
+          "type": "object",
+          "description": "Current dental chart state — tooth conditions keyed by FDI id."
+        }
+      ],
+      "actions": [
+        {
+          "name": "focus_tooth",
+          "safety": "read",
+          "argsType": "{ id: FdiId }",
+          "description": "Move focus to a specific tooth by FDI id."
+        }
       ],
-      "state": [],
-      "actions": [],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "sidebar"
+          "value": "tooth-scheme"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
         },
         "item": {
-          "attr": "data-nav-id",
-          "description": "Each Sidebar.Item emits its key as data-nav-id."
+          "attr": "data-fdi",
+          "description": "Each rendered tooth `<g>` carries its FDI id as `data-fdi`. Tests still use `data-testid=\"tooth-<fdi>\"` separately."
         }
       }
     },
     {
       "kind": "component",
-      "id": "signature-capture",
+      "id": "transcript-panel",
       "capabilities": [
-        "edit_inline",
-        "submit"
+        "select_single"
       ],
       "state": [
         {
-          "name": "isEmpty",
-          "type": "boolean",
-          "description": "True when no signature has been drawn or typed."
+          "name": "selectedTurn",
+          "type": "string | null",
+          "description": "Opaque id (line index) of the currently-active turn, or null when none is active."
         }
       ],
       "actions": [
         {
-          "name": "clear",
-          "safety": "destructive",
-          "description": "Erase the current signature. Loses unsaved input."
-        },
-        {
-          "name": "undo",
-          "safety": "write",
-          "description": "Undo the last stroke."
+          "name": "focus_turn",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "description": "Scroll the given turn into view and focus its seek button."
         },
         {
-          "name": "confirm",
-          "safety": "write",
-          "description": "Commit the signature and return its serialised payload."
+          "name": "copy_turn",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "description": "Copy the given turn's text to the clipboard."
         }
       ],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "signature-capture"
+          "value": "transcript-panel",
+          "description": "Marks the TranscriptPanel wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-turn-id",
+          "description": "Stable opaque turn id (line index). Never carries the turn's dictated text."
         }
       }
     },
     {
       "kind": "component",
-      "id": "sparkline",
+      "id": "typing-indicator",
       "capabilities": [],
       "state": [],
-      "actions": [
-        {
-          "name": "update_series",
-          "safety": "read",
-          "argsType": "{ data: number[] }",
-          "description": "Replace the sparkline data without remounting."
-        },
-        {
-          "name": "export_png",
-          "safety": "read",
-          "description": "Return a PNG data URI of the sparkline."
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "typing-indicator",
+          "description": "Marks the element as a kit TypingIndicator."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "visually-hidden",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "visually-hidden",
+          "description": "Marks the element as a kit VisuallyHidden wrapper."
         }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "warning-stack",
+      "capabilities": [
+        "dismiss",
+        "expand"
       ],
+      "state": [],
+      "actions": [],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "sparkline"
+          "value": "warning-stack",
+          "description": "Marks the WarningStack region. Each item inside is a kit Alert; agents address an individual warning via the Alert's native `id`."
         }
       }
     },
     {
       "kind": "component",
-      "id": "tabs",
+      "id": "workflow-card",
       "capabilities": [
-        "select_single",
         "navigate"
       ],
       "state": [],
@@ -686,43 +3873,82 @@
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "tabs"
+          "value": "workflow-card",
+          "description": "Marks a Workflow summary card. Presentational — actions are owned by the host pattern."
         },
-        "item": {
-          "attr": "data-tab-id",
-          "description": "Each Tab.Trigger emits its value as data-tab-id. The agent reads this to identify the active tab via the DOM."
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
         }
       }
     },
     {
       "kind": "component",
-      "id": "tooth-scheme",
+      "id": "workflow-editor",
       "capabilities": [
-        "pick"
+        "navigate",
+        "expand"
       ],
       "state": [
         {
-          "name": "chart",
-          "type": "object",
-          "description": "Current dental chart state — tooth conditions keyed by FDI id."
+          "name": "totalSteps",
+          "type": "number",
+          "description": "Total number of nodes currently in the workflow graph."
+        },
+        {
+          "name": "currentStep",
+          "type": "string | null",
+          "description": "Opaque node id of the currently-focused step, or null."
         }
       ],
       "actions": [
         {
-          "name": "focus_tooth",
+          "name": "goto_step",
           "safety": "read",
-          "argsType": "{ id: FdiId }",
-          "description": "Move focus to a specific tooth by FDI id."
+          "argsType": "{ id: string }",
+          "description": "Focus a node by its opaque id."
         }
       ],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "tooth-scheme"
+          "value": "workflow-editor",
+          "description": "Marks the WorkflowEditor surface."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
         },
         "item": {
-          "attr": "data-fdi",
-          "description": "Each rendered tooth `<g>` carries its FDI id as `data-fdi`. Tests still use `data-testid=\"tooth-<fdi>\"` separately."
+          "attr": "data-node-id",
+          "description": "Stable opaque workflow node id emitted on each node card."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "workflow-map",
+      "capabilities": [
+        "navigate"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "workflow-map",
+          "description": "Marks a Workflow map (linear visualisation). Presentational."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-node-id",
+          "description": "Stable opaque workflow node id emitted on each step."
         }
       }
     }