@alfadocs/ui-kit-debug 0.72.2 → 0.73.0

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "0.72.2",
+  "packageVersion": "0.73.0",
   "components": [
     {
       "kind": "component",
@@ -3706,6 +3706,12 @@
           "description": "Id of the currently displayed view (front / profile-left / profile-right).",
           "descriptionKey": "ui.agent.faceScheme.state.activeView"
         },
+        {
+          "name": "zoom",
+          "type": "number",
+          "description": "Current figure zoom factor (1 = the base framing; up to 8). Only meaningful when the surface enables `zoomable`.",
+          "descriptionKey": "ui.agent.faceScheme.state.zoom"
+        },
         {
           "name": "chart",
           "type": "Record<string, string[]>",
@@ -3717,6 +3723,36 @@
           "type": "string[]",
           "description": "Zone ids carrying at least one finding.",
           "descriptionKey": "ui.agent.faceScheme.state.markedZones"
+        },
+        {
+          "name": "activeTool",
+          "type": "string | null",
+          "description": "The active free-form drawing tool (marker / pen / highlighter / arrow / line / rect / ellipse / text), or null when none is selected.",
+          "descriptionKey": "ui.agent.faceScheme.state.activeTool"
+        },
+        {
+          "name": "annotationCounts",
+          "type": "Record<string, number>",
+          "description": "Count of free-form annotations on the active view, keyed by kind (marker / pen / highlighter / arrow / line / rect / ellipse / text). Never includes coordinates or the free-text of a text callout.",
+          "descriptionKey": "ui.agent.faceScheme.state.annotationCounts"
+        },
+        {
+          "name": "selectedAnnotation",
+          "type": "{ id: string; kind: string } | null",
+          "description": "The selected free-form annotation on the active view (id + kind), or null when nothing is selected. Never includes coordinates or the free-text of a text callout.",
+          "descriptionKey": "ui.agent.faceScheme.state.selectedAnnotation"
+        },
+        {
+          "name": "selectedZones",
+          "type": "string[]",
+          "description": "Zone ids in the multi-selection (zoneSelect=\"multi\") — the set a bulk finding apply targets. Empty when the mode is off or nothing is selected.",
+          "descriptionKey": "ui.agent.faceScheme.state.selectedZones"
+        },
+        {
+          "name": "annotationZones",
+          "type": "Record<string, number>",
+          "description": "Count of free-form annotations on the active view keyed by their linked zone id ('unassigned' = outside every zone or not yet assessed). Counts only — never coordinates or text.",
+          "descriptionKey": "ui.agent.faceScheme.state.annotationZones"
         }
       ],
       "actions": [
@@ -3921,6 +3957,192 @@
           "idempotent": true,
           "description": "Switch the active view ('front' / 'profile-left' / 'profile-right'). Each view renders a different zone set, so switch before focusing a zone that belongs to another view.",
           "descriptionKey": "ui.agent.faceScheme.actions.setView"
+        },
+        {
+          "name": "set_zoom",
+          "safety": "write",
+          "argsType": "{ factor: number }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "factor": {
+                "type": "number",
+                "minimum": 1,
+                "maximum": 8
+              }
+            },
+            "required": [
+              "factor"
+            ]
+          },
+          "idempotent": true,
+          "description": "Set the figure zoom factor (1 = reset to the base framing, clamped to 1–8), anchored on the window centre. No-op unless the surface enables `zoomable`.",
+          "descriptionKey": "ui.agent.faceScheme.actions.setZoom"
+        },
+        {
+          "name": "set_tool",
+          "safety": "write",
+          "argsType": "{ tool: FaceAnnotationTool | 'none' }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "tool": {
+                "type": "string",
+                "enum": [
+                  "none",
+                  "marker",
+                  "pen",
+                  "highlighter",
+                  "arrow",
+                  "line",
+                  "rect",
+                  "ellipse",
+                  "text"
+                ],
+                "description": "Drawing tool: 'none' (off), 'marker', 'pen', 'highlighter', 'arrow', 'line', 'rect', 'ellipse', or 'text'."
+              }
+            },
+            "required": [
+              "tool"
+            ]
+          },
+          "idempotent": true,
+          "description": "Select the active free-form drawing tool ('none' turns drawing off; pointer then falls through to zone selection).",
+          "descriptionKey": "ui.agent.faceScheme.actions.setTool"
+        },
+        {
+          "name": "undo_annotation",
+          "safety": "write",
+          "argsType": "{}",
+          "argsSchema": {
+            "type": "object",
+            "properties": {}
+          },
+          "description": "Remove the most-recently-added free-form annotation from the active view.",
+          "descriptionKey": "ui.agent.faceScheme.actions.undoAnnotation"
+        },
+        {
+          "name": "select_annotation",
+          "safety": "read",
+          "argsType": "{ id: string | null }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "description": "Annotation id on the active view (null clears the selection). Unknown ids are ignored."
+              }
+            },
+            "required": [
+              "id"
+            ]
+          },
+          "idempotent": true,
+          "description": "Select a free-form annotation on the active view by id (null clears). Selection reveals the mark and enables its panel affordances (delete / recolour).",
+          "descriptionKey": "ui.agent.faceScheme.actions.selectAnnotation"
+        },
+        {
+          "name": "set_annotation_zone",
+          "safety": "write",
+          "argsType": "{ id: string; zone: string | null }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Annotation id on the active view."
+              },
+              "zone": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "description": "Zone id to link, or null to unlink ('no zone')."
+              }
+            },
+            "required": [
+              "id",
+              "zone"
+            ]
+          },
+          "idempotent": true,
+          "description": "Link a free-form annotation to a face zone by id (null unlinks it). Unknown annotation ids are ignored. New drawings are auto-linked to the zone under them; this re-assigns marks drawn outside every zone.",
+          "descriptionKey": "ui.agent.faceScheme.actions.setAnnotationZone"
+        },
+        {
+          "name": "select_zones",
+          "safety": "read",
+          "argsType": "{ ids: string[] }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "ids": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "description": "Face-zone id (e.g. 'glabella', 'nasolabialFold', 'forehead', 'mandibularAngleLeft' on the front view; 'cheekbone', 'masseter', 'chin' on a profile view)."
+                },
+                "description": "Zone ids to select (replaces the current selection; [] clears)."
+              }
+            },
+            "required": [
+              "ids"
+            ]
+          },
+          "idempotent": true,
+          "description": "Replace the zone multi-selection (zoneSelect=\"multi\"). Selection is UI state only — pair with set_finding_bulk to record a finding on the selected zones, or pass ids straight to set_finding_bulk instead.",
+          "descriptionKey": "ui.agent.faceScheme.actions.selectZones"
+        },
+        {
+          "name": "set_finding_bulk",
+          "safety": "write",
+          "argsType": "{ ids: string[]; finding: FaceFindingType; note?: string }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "ids": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "description": "Face-zone id (e.g. 'glabella', 'nasolabialFold', 'forehead', 'mandibularAngleLeft' on the front view; 'cheekbone', 'masseter', 'chin' on a profile view)."
+                },
+                "description": "Zone ids to record the finding on."
+              },
+              "finding": {
+                "enum": [
+                  "observation",
+                  "treatment",
+                  "concern",
+                  "note"
+                ]
+              },
+              "note": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "ids",
+              "finding"
+            ]
+          },
+          "idempotent": true,
+          "description": "Record one finding on several zones in a single chart commit (the multi-zone diagnosis path). Zones already carrying the finding are left as they are; the optional note lands only where the finding is newly added.",
+          "descriptionKey": "ui.agent.faceScheme.actions.setFindingBulk"
+        },
+        {
+          "name": "clear_annotations",
+          "safety": "destructive",
+          "argsType": "{}",
+          "argsSchema": {
+            "type": "object",
+            "properties": {}
+          },
+          "idempotent": true,
+          "description": "Clear every free-form annotation from the active view. Zone findings are untouched.",
+          "descriptionKey": "ui.agent.faceScheme.actions.clearAnnotations"
         }
       ],
       "domHooks": {
@@ -3935,7 +4157,7 @@
         },
         "item": {
           "attr": "data-zone",
-          "description": "Each clickable zone `<g>` carries its zone id as `data-zone` (plus `data-side` for the anatomical side). The root `<div>` carries the active view id as `data-view` — only the zones for the active view are in the DOM."
+          "description": "Each clickable zone `<g>` carries its zone id as `data-zone` (plus `data-side` for the anatomical side, and `data-zone-selected=\"true\"` while in the multi-selection). Each free-form annotation `<g>` carries `data-annotation` (its id), `data-annotation-kind`, `data-annotation-zone` (its linked zone id, when linked), and `data-selected=\"true\"` while selected. The root `<div>` carries the active view id as `data-view` — only the zones for the active view are in the DOM."
         }
       }
     },
@@ -6297,6 +6519,14 @@
                     "type": "number",
                     "description": "Interpupillary distance, mm."
                   },
+                  "pdRight": {
+                    "type": "number",
+                    "description": "Monocular PD, nose centre → OD pupil, mm."
+                  },
+                  "pdLeft": {
+                    "type": "number",
+                    "description": "Monocular PD, nose centre → OS pupil, mm."
+                  },
                   "lensType": {
                     "enum": [
                       "single-vision",
@@ -6365,7 +6595,7 @@
         },
         "item": {
           "attr": "data-eye",
-          "description": "Each refraction row carries its eye (`od` / `os`) as `data-eye` and its distance band as `data-band`; each editable cell carries the column key as `data-field`. The root `data-mode` attribute exposes interactive vs display."
+          "description": "Each refraction row carries its eye (`od` / `os`) as `data-eye` and its distance band as `data-band`; each editable cell carries the column key as `data-field`. The root `data-mode` attribute exposes interactive vs display. Standard chart figures carry `data-chart` (`tabo` / `powerCross` / `pd` / `prismBase`) plus `data-eye` on the per-eye ones."
         }
       }
     },
@@ -8940,80 +9170,321 @@
     },
     {
       "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",
+      "id": "skeleton-scheme",
       "capabilities": [
+        "pick",
         "set_value",
-        "range_pick"
+        "edit_inline",
+        "view_change"
       ],
       "state": [
         {
-          "name": "value",
-          "type": "number[]",
-          "description": "Current thumb values; length 1 for a single slider, length 2 for a range.",
-          "descriptionKey": "ui.agent.slider.state.value"
+          "name": "chart",
+          "type": "object",
+          "description": "Current skeletal chart — findings keyed by bone region id. Notes are PHI and omitted from this snapshot; read them per-region via get_region.",
+          "descriptionKey": "ui.agent.skeletonScheme.state.chart"
+        },
+        {
+          "name": "activeView",
+          "type": "string",
+          "description": "Id of the currently displayed skeletal view.",
+          "descriptionKey": "ui.agent.skeletonScheme.state.activeView"
         }
       ],
       "actions": [
         {
-          "name": "set_value",
-          "safety": "write",
-          "argsType": "{ value: number[] }",
+          "name": "focus_region",
+          "safety": "read",
+          "argsType": "{ regionId: string }",
           "argsSchema": {
             "type": "object",
             "properties": {
-              "value": {
-                "type": "array",
-                "items": {
-                  "type": "number"
-                },
-                "minItems": 1,
-                "maxItems": 2,
-                "description": "Thumb value(s): a 1-tuple for a single slider, a 2-tuple for a range."
+              "regionId": {
+                "type": "string",
+                "description": "Per-bone region id within the active view, e.g. 'femur-r', 'tibia-l', 'humerus-r', 'ribs-l', 'lumbar-spine', 'skull'. Bilateral bones carry a '-r' / '-l' anatomical-side suffix; midline bones (spine, skull, sternum, sacrum) have none."
               }
             },
             "required": [
-              "value"
+              "regionId"
             ]
           },
           "idempotent": true,
-          "examples": [
-            {
-              "args": {
-                "value": [
-                  50
-                ]
-              },
-              "note": "Set a single slider to 50."
+          "description": "Move focus to a specific bone in the active view.",
+          "descriptionKey": "ui.agent.skeletonScheme.actions.focusRegion"
+        },
+        {
+          "name": "get_region",
+          "safety": "phi",
+          "argsType": "{ regionId: string }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "regionId": {
+                "type": "string",
+                "description": "Per-bone region id within the active view, e.g. 'femur-r', 'tibia-l', 'humerus-r', 'ribs-l', 'lumbar-spine', 'skull'. Bilateral bones carry a '-r' / '-l' anatomical-side suffix; midline bones (spine, skull, sternum, sacrum) have none."
+              }
             },
-            {
-              "args": {
-                "value": [
-                  20,
-                  80
-                ]
+            "required": [
+              "regionId"
+            ]
+          },
+          "returns": "SkeletonFinding[]",
+          "returnsSchema": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "enum": [
+                    "observation",
+                    "lesion",
+                    "pain",
+                    "treatment",
+                    "note"
+                  ]
+                },
+                "note": {
+                  "type": "string"
+                }
               },
-              "note": "Set a range to 20–80."
+              "required": [
+                "type"
+              ]
             }
-          ],
-          "description": "Replace the thumb value(s). Pass a 1-tuple for single, 2-tuple for range.",
-          "descriptionKey": "ui.agent.slider.actions.setValue"
-        }
+          },
+          "idempotent": true,
+          "description": "Read the findings (incl. notes) recorded on one bone.",
+          "descriptionKey": "ui.agent.skeletonScheme.actions.getRegion"
+        },
+        {
+          "name": "regions_with",
+          "safety": "read",
+          "argsType": "{ type: FindingType }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "type": {
+                "enum": [
+                  "observation",
+                  "lesion",
+                  "pain",
+                  "treatment",
+                  "note"
+                ]
+              }
+            },
+            "required": [
+              "type"
+            ]
+          },
+          "returns": "string[]",
+          "returnsSchema": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "description": "Per-bone region id within the active view, e.g. 'femur-r', 'tibia-l', 'humerus-r', 'ribs-l', 'lumbar-spine', 'skull'. Bilateral bones carry a '-r' / '-l' anatomical-side suffix; midline bones (spine, skull, sternum, sacrum) have none."
+            }
+          },
+          "idempotent": true,
+          "description": "List the bone region ids carrying a given finding type.",
+          "descriptionKey": "ui.agent.skeletonScheme.actions.regionsWith"
+        },
+        {
+          "name": "set_finding",
+          "safety": "write",
+          "argsType": "{ regionId: string; type: FindingType; note?: string }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "regionId": {
+                "type": "string",
+                "description": "Per-bone region id within the active view, e.g. 'femur-r', 'tibia-l', 'humerus-r', 'ribs-l', 'lumbar-spine', 'skull'. Bilateral bones carry a '-r' / '-l' anatomical-side suffix; midline bones (spine, skull, sternum, sacrum) have none."
+              },
+              "type": {
+                "enum": [
+                  "observation",
+                  "lesion",
+                  "pain",
+                  "treatment",
+                  "note"
+                ]
+              },
+              "note": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "regionId",
+              "type"
+            ]
+          },
+          "idempotent": true,
+          "description": "Record a finding (observation / lesion / pain / treatment / note) on a bone.",
+          "descriptionKey": "ui.agent.skeletonScheme.actions.setFinding"
+        },
+        {
+          "name": "remove_finding",
+          "safety": "write",
+          "argsType": "{ regionId: string; type: FindingType }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "regionId": {
+                "type": "string",
+                "description": "Per-bone region id within the active view, e.g. 'femur-r', 'tibia-l', 'humerus-r', 'ribs-l', 'lumbar-spine', 'skull'. Bilateral bones carry a '-r' / '-l' anatomical-side suffix; midline bones (spine, skull, sternum, sacrum) have none."
+              },
+              "type": {
+                "enum": [
+                  "observation",
+                  "lesion",
+                  "pain",
+                  "treatment",
+                  "note"
+                ]
+              }
+            },
+            "required": [
+              "regionId",
+              "type"
+            ]
+          },
+          "idempotent": true,
+          "description": "Remove a single finding type from a bone.",
+          "descriptionKey": "ui.agent.skeletonScheme.actions.removeFinding"
+        },
+        {
+          "name": "clear_region",
+          "safety": "destructive",
+          "argsType": "{ regionId: string }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "regionId": {
+                "type": "string",
+                "description": "Per-bone region id within the active view, e.g. 'femur-r', 'tibia-l', 'humerus-r', 'ribs-l', 'lumbar-spine', 'skull'. Bilateral bones carry a '-r' / '-l' anatomical-side suffix; midline bones (spine, skull, sternum, sacrum) have none."
+              }
+            },
+            "required": [
+              "regionId"
+            ]
+          },
+          "idempotent": true,
+          "description": "Clear every finding from a bone.",
+          "descriptionKey": "ui.agent.skeletonScheme.actions.clearRegion"
+        },
+        {
+          "name": "set_view",
+          "safety": "write",
+          "argsType": "{ viewId: string }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "viewId": {
+                "type": "string",
+                "description": "View id, one of 'skeletal-front' / 'skeletal-back'."
+              }
+            },
+            "required": [
+              "viewId"
+            ]
+          },
+          "idempotent": true,
+          "description": "Switch the active skeletal view.",
+          "descriptionKey": "ui.agent.skeletonScheme.actions.setView"
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "skeleton-scheme"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-region",
+          "description": "Each rendered bone `<g>` carries its region id as `data-region` and its anatomical side (`left` / `right` / `midline`) as `data-side`, so bilateral bones can be disambiguated by side. The root `data-view` attribute exposes the active skeletal view."
+        }
+      }
+    },
+    {
+      "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": [
+        "set_value",
+        "range_pick"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "number[]",
+          "description": "Current thumb values; length 1 for a single slider, length 2 for a range.",
+          "descriptionKey": "ui.agent.slider.state.value"
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: number[] }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "value": {
+                "type": "array",
+                "items": {
+                  "type": "number"
+                },
+                "minItems": 1,
+                "maxItems": 2,
+                "description": "Thumb value(s): a 1-tuple for a single slider, a 2-tuple for a range."
+              }
+            },
+            "required": [
+              "value"
+            ]
+          },
+          "idempotent": true,
+          "examples": [
+            {
+              "args": {
+                "value": [
+                  50
+                ]
+              },
+              "note": "Set a single slider to 50."
+            },
+            {
+              "args": {
+                "value": [
+                  20,
+                  80
+                ]
+              },
+              "note": "Set a range to 20–80."
+            }
+          ],
+          "description": "Replace the thumb value(s). Pass a 1-tuple for single, 2-tuple for range.",
+          "descriptionKey": "ui.agent.slider.actions.setValue"
+        }
       ],
       "domHooks": {
         "root": {
@@ -11125,182 +11596,51 @@
   "patterns": [
     {
       "kind": "pattern",
-      "id": "alfascribe-consultation",
+      "id": "alia-assistant",
       "composes": [
         {
-          "component": "transcript-panel",
-          "as": "transcript",
-          "entity": "transcriptTurn"
+          "component": "chat-container",
+          "as": "conversation",
+          "entity": "message"
         },
         {
-          "component": "audio-visualiser",
-          "as": "levelMeter"
+          "component": "chat-message",
+          "as": "message",
+          "entity": "message"
         },
         {
-          "component": "button",
-          "as": "recordToggle"
+          "component": "streaming-text",
+          "as": "streamingReply"
         },
         {
-          "component": "chat-input",
-          "as": "composer"
+          "component": "typing-indicator",
+          "as": "typing"
         },
         {
           "component": "suggestion-chip",
-          "as": "followUp",
+          "as": "suggestion",
           "entity": "suggestion"
         },
         {
-          "component": "typing-indicator",
-          "as": "scribeTyping"
-        },
-        {
-          "component": "card",
-          "as": "summaryCard"
-        },
-        {
-          "component": "streaming-text",
-          "as": "summaryStream"
-        },
-        {
-          "component": "collapsible",
-          "as": "transcriptDrawer"
+          "component": "chat-input",
+          "as": "composer"
         },
         {
-          "component": "button",
-          "as": "regenerate"
+          "component": "avatar",
+          "as": "assistantAvatar"
         },
         {
-          "component": "button",
-          "as": "copySummary"
+          "component": "progress",
+          "as": "usageMeter"
         },
         {
-          "component": "toast",
-          "as": "copyToast"
+          "component": "sheet",
+          "as": "popoutPanel"
         }
       ],
       "workflows": [
         {
-          "name": "toggle_recording",
-          "safety": "write",
-          "description": "Start or stop audio capture for the consultation; the level meter and transcript update while recording.",
-          "descriptionKey": "ui.agent.alfascribeConsultation.workflows.toggleRecording",
-          "uiActions": [],
-          "apiActions": [
-            "consultation.startCapture",
-            "consultation.stopCapture"
-          ]
-        },
-        {
-          "name": "read_transcript",
-          "safety": "read",
-          "description": "Read the live transcript — focus or copy a specific turn (clinician / patient / AI).",
-          "descriptionKey": "ui.agent.alfascribeConsultation.workflows.readTranscript",
-          "uiActions": [
-            "transcript-panel.focus_turn",
-            "transcript-panel.copy_turn"
-          ],
-          "stateReads": [
-            "transcript-panel.selectedTurn"
-          ],
-          "apiActions": []
-        },
-        {
-          "name": "add_clinician_note",
-          "safety": "write",
-          "description": "Type a clinician note or question into the composer and submit it into the transcript, optionally seeding it from a suggested follow-up chip.",
-          "descriptionKey": "ui.agent.alfascribeConsultation.workflows.addClinicianNote",
-          "uiActions": [
-            "chat-input.set_value",
-            "chat-input.submit",
-            "suggestion-chip.select"
-          ],
-          "stateReads": [
-            "chat-input.value",
-            "chat-input.isEmpty"
-          ],
-          "apiActions": [
-            "consultation.addNote"
-          ]
-        },
-        {
-          "name": "regenerate_summary",
-          "safety": "write",
-          "description": "Regenerate the AI consultation summary; the new draft streams into the summary card.",
-          "descriptionKey": "ui.agent.alfascribeConsultation.workflows.regenerateSummary",
-          "uiActions": [],
-          "apiActions": [
-            "consultation.regenerateSummary"
-          ]
-        },
-        {
-          "name": "copy_summary",
-          "safety": "write",
-          "description": "Copy the AI summary to the clipboard; a success toast confirms the copy.",
-          "descriptionKey": "ui.agent.alfascribeConsultation.workflows.copySummary",
-          "uiActions": [
-            "toast.dismiss"
-          ],
-          "apiActions": []
-        },
-        {
-          "name": "save_summary",
-          "safety": "write",
-          "description": "Persist the reviewed consultation summary to the patient record.",
-          "descriptionKey": "ui.agent.alfascribeConsultation.workflows.saveSummary",
-          "uiActions": [],
-          "apiActions": [
-            "consultation.saveSummary"
-          ]
-        }
-      ]
-    },
-    {
-      "kind": "pattern",
-      "id": "alia-assistant",
-      "composes": [
-        {
-          "component": "chat-container",
-          "as": "conversation",
-          "entity": "message"
-        },
-        {
-          "component": "chat-message",
-          "as": "message",
-          "entity": "message"
-        },
-        {
-          "component": "streaming-text",
-          "as": "streamingReply"
-        },
-        {
-          "component": "typing-indicator",
-          "as": "typing"
-        },
-        {
-          "component": "suggestion-chip",
-          "as": "suggestion",
-          "entity": "suggestion"
-        },
-        {
-          "component": "chat-input",
-          "as": "composer"
-        },
-        {
-          "component": "avatar",
-          "as": "assistantAvatar"
-        },
-        {
-          "component": "progress",
-          "as": "usageMeter"
-        },
-        {
-          "component": "sheet",
-          "as": "popoutPanel"
-        }
-      ],
-      "workflows": [
-        {
-          "name": "send_message",
+          "name": "send_message",
           "safety": "write",
           "description": "Type a question into the composer and send it; Alia streams a reply into the conversation.",
           "descriptionKey": "ui.agent.aliaAssistant.workflows.sendMessage",
@@ -12789,542 +13129,239 @@
     },
     {
       "kind": "pattern",
-      "id": "dashboard-daily-queues",
+      "id": "invoices",
       "composes": [
         {
-          "component": "task-tray",
-          "as": "tasks",
-          "entity": "task"
-        },
-        {
-          "component": "agenda-tray",
-          "as": "agenda",
-          "entity": "appointment"
+          "component": "data-table",
+          "as": "ledger",
+          "entity": "invoice"
         },
         {
           "component": "icon-button-group",
-          "as": "rowActions"
+          "as": "tableActions"
         },
         {
           "component": "icon-button",
-          "as": "rowAction"
+          "as": "tableAction"
         },
         {
-          "component": "empty-state",
-          "as": "trayEmpty"
+          "component": "badge",
+          "as": "statusBadge"
+        },
+        {
+          "component": "button",
+          "as": "rowAction"
         }
       ],
       "workflows": [
         {
-          "name": "complete_task",
-          "safety": "write",
-          "description": "Mark a task in the \"My next tasks\" tray as done so it drops out of the undone queue.",
-          "descriptionKey": "ui.agent.dashboardDailyQueues.workflows.completeTask",
+          "name": "filter_invoices",
+          "safety": "read",
+          "description": "Narrow the ledger by number, relation, status, date range or amount using the per-column filters.",
+          "descriptionKey": "ui.agent.invoices.workflows.filterInvoices",
           "uiActions": [
-            "task-tray.toggle_done"
+            "data-table.apply_filter"
           ],
           "stateReads": [
-            "task-tray.items"
+            "data-table.filter"
           ],
           "apiActions": [
-            "task.complete"
+            "invoice.list"
           ]
         },
         {
-          "name": "schedule_from_task",
-          "safety": "write",
-          "description": "Open the \"Schedule appointment\" row action on a patient task to book a visit for the linked patient.",
-          "descriptionKey": "ui.agent.dashboardDailyQueues.workflows.scheduleFromTask",
+          "name": "sort_ledger",
+          "safety": "read",
+          "description": "Re-sort the ledger by any column (e.g. issue date, total, balance).",
+          "descriptionKey": "ui.agent.invoices.workflows.sortLedger",
+          "uiActions": [
+            "data-table.sort_by"
+          ],
+          "stateReads": [
+            "data-table.sort"
+          ],
+          "apiActions": []
+        },
+        {
+          "name": "paginate",
+          "safety": "read",
+          "description": "Move to another page of the ledger.",
+          "descriptionKey": "ui.agent.invoices.workflows.paginate",
           "uiActions": [
-            "task-tray.select_item"
+            "data-table.go_to_page"
           ],
           "stateReads": [
-            "task-tray.items"
+            "data-table.currentPage"
           ],
+          "apiActions": []
+        },
+        {
+          "name": "export_ledger",
+          "safety": "read",
+          "description": "Export the current (optionally filtered) ledger from the page-header table-tools cluster — CSV / Excel / PDF.",
+          "descriptionKey": "ui.agent.invoices.workflows.exportLedger",
+          "uiActions": [],
           "apiActions": [
-            "appointment.create"
+            "invoice.export"
           ]
         },
         {
-          "name": "open_appointment",
+          "name": "view_invoice",
           "safety": "read",
-          "description": "Open one of the upcoming appointments in the agenda tray to view or edit the visit.",
-          "descriptionKey": "ui.agent.dashboardDailyQueues.workflows.openAppointment",
+          "description": "Open a single invoice from its row action to inspect line items and payment history.",
+          "descriptionKey": "ui.agent.invoices.workflows.viewInvoice",
           "uiActions": [
-            "agenda-tray.select_item"
+            "data-table.get_selection"
           ],
           "stateReads": [
-            "agenda-tray.items"
+            "data-table.selection"
           ],
           "apiActions": [
-            "appointment.open"
+            "invoice.get"
           ]
         },
         {
-          "name": "create_task",
-          "safety": "write",
-          "description": "Use the tasks tray quick-create (or empty-state CTA) to start a new follow-up / recall / collection task.",
-          "descriptionKey": "ui.agent.dashboardDailyQueues.workflows.createTask",
-          "uiActions": [],
+          "name": "download_pdf",
+          "safety": "read",
+          "description": "Download the selected invoice as a PDF from its row action.",
+          "descriptionKey": "ui.agent.invoices.workflows.downloadPdf",
+          "uiActions": [
+            "data-table.get_selection"
+          ],
+          "stateReads": [
+            "data-table.selection"
+          ],
           "apiActions": [
-            "task.create"
+            "invoice.downloadPdf"
           ]
         },
         {
-          "name": "create_appointment",
+          "name": "send_reminder",
           "safety": "write",
-          "description": "Use the agenda tray quick-create (or empty-state CTA) to book a new appointment.",
-          "descriptionKey": "ui.agent.dashboardDailyQueues.workflows.createAppointment",
-          "uiActions": [],
+          "description": "Send a payment reminder for the selected invoice through its eligible channel (email or SMS).",
+          "descriptionKey": "ui.agent.invoices.workflows.sendReminder",
+          "uiActions": [
+            "data-table.get_selection"
+          ],
+          "stateReads": [
+            "data-table.selection"
+          ],
           "apiActions": [
-            "appointment.create"
+            "invoice.sendReminder"
           ]
         },
         {
-          "name": "delete_task",
+          "name": "delete_invoice",
           "safety": "destructive",
-          "description": "Remove a task from the queue via its row \"Delete task\" action. Irreversible.",
-          "descriptionKey": "ui.agent.dashboardDailyQueues.workflows.deleteTask",
+          "description": "Delete the selected invoice from its row action. Paid invoices cannot be deleted. Irreversible.",
+          "descriptionKey": "ui.agent.invoices.workflows.deleteInvoice",
           "uiActions": [
-            "task-tray.dismiss"
+            "data-table.get_selection",
+            "data-table.clear_selection"
           ],
           "stateReads": [
-            "task-tray.items"
+            "data-table.selection"
           ],
           "apiActions": [
-            "task.delete"
+            "invoice.delete"
           ]
         }
       ]
     },
     {
       "kind": "pattern",
-      "id": "entity-create-sheet",
+      "id": "marketplace-app-shell",
       "composes": [
         {
-          "component": "sheet",
-          "as": "overlay"
+          "component": "app-frame",
+          "as": "frame"
         },
         {
-          "component": "form-field",
-          "as": "field"
+          "component": "header",
+          "as": "topBar"
         },
         {
-          "component": "text-input",
-          "as": "textField"
+          "component": "sidebar",
+          "as": "mainNav",
+          "entity": "navItem"
+        },
+        {
+          "component": "tab-bar",
+          "as": "embeddedNav",
+          "entity": "navItem"
         },
         {
-          "component": "text-area",
-          "as": "notesField"
+          "component": "avatar",
+          "as": "accountAvatar"
         },
         {
-          "component": "select",
-          "as": "choiceField"
+          "component": "dropdown-menu",
+          "as": "accountMenu"
         },
         {
-          "component": "autocomplete",
-          "as": "lookupField"
+          "component": "header-settings",
+          "as": "settings"
         },
         {
-          "component": "date-time-picker",
-          "as": "dateField"
+          "component": "sign-in-with-alfadocs-button",
+          "as": "connectCta"
         },
         {
-          "component": "button",
-          "as": "save"
+          "component": "alert",
+          "as": "connectError"
         },
         {
-          "component": "button",
-          "as": "cancel"
+          "component": "card",
+          "as": "contentSurface"
+        },
+        {
+          "component": "theme-root",
+          "as": "themeScope"
+        },
+        {
+          "component": "tooltip",
+          "as": "navTooltip"
         }
       ],
       "workflows": [
         {
-          "name": "open_create_sheet",
+          "name": "navigate",
+          "safety": "read",
+          "description": "Navigate to one of the app sections via the sidebar nav (or the embedded tab strip). Routing is consumer-owned, so the destination resolves through the host router.",
+          "descriptionKey": "ui.agent.marketplaceAppShell.workflows.navigate",
+          "uiActions": [],
+          "apiActions": [
+            "app.navigate"
+          ]
+        },
+        {
+          "name": "toggle_sidebar",
           "safety": "read",
-          "description": "Open the quick-create sheet over the current list / dashboard without navigating away.",
-          "descriptionKey": "ui.agent.entityCreateSheet.workflows.openCreateSheet",
+          "description": "Collapse or expand the main navigation rail and read its current collapsed state.",
+          "descriptionKey": "ui.agent.marketplaceAppShell.workflows.toggleSidebar",
           "uiActions": [
-            "sheet.open"
+            "sidebar.toggle_collapsed"
           ],
           "stateReads": [
-            "sheet.isOpen"
+            "sidebar.isCollapsed"
           ],
           "apiActions": []
         },
         {
-          "name": "fill_form",
-          "safety": "write",
-          "description": "Populate the form fields: free-text inputs, the notes area, single-select choices, the autocomplete lookup, and the date/time field.",
-          "descriptionKey": "ui.agent.entityCreateSheet.workflows.fillForm",
+          "name": "open_account_menu",
+          "safety": "read",
+          "description": "Open the account dropdown to reach sign-out and account settings.",
+          "descriptionKey": "ui.agent.marketplaceAppShell.workflows.openAccountMenu",
           "uiActions": [
-            "text-input.set_value",
-            "text-area.set_value",
-            "select.set_value",
-            "autocomplete.set_value",
-            "autocomplete.apply_filter",
-            "date-time-picker.set_datetime"
+            "dropdown-menu.open"
           ],
           "stateReads": [
-            "text-input.value",
-            "text-area.value",
-            "select.value",
-            "autocomplete.value",
-            "date-time-picker.value"
+            "dropdown-menu.isOpen"
           ],
           "apiActions": []
         },
         {
-          "name": "save_entity",
-          "safety": "write",
-          "description": "Submit the form to create the new entity. Missing required fields keep the sheet open with inline errors; on success the sheet closes.",
-          "descriptionKey": "ui.agent.entityCreateSheet.workflows.saveEntity",
-          "uiActions": [
-            "sheet.close"
-          ],
-          "stateReads": [
-            "sheet.isOpen"
-          ],
-          "apiActions": [
-            "entity.create"
-          ]
-        },
-        {
-          "name": "cancel_create",
-          "safety": "read",
-          "description": "Dismiss the sheet without saving, discarding any entered values and returning to the underlying list.",
-          "descriptionKey": "ui.agent.entityCreateSheet.workflows.cancelCreate",
-          "uiActions": [
-            "sheet.dismiss"
-          ],
-          "stateReads": [
-            "sheet.isOpen"
-          ],
-          "apiActions": []
-        }
-      ]
-    },
-    {
-      "kind": "pattern",
-      "id": "entity-index-table",
-      "composes": [
-        {
-          "component": "data-table",
-          "as": "roster",
-          "entity": "entity"
-        },
-        {
-          "component": "button",
-          "as": "addNew"
-        },
-        {
-          "component": "button",
-          "as": "exportCsv"
-        },
-        {
-          "component": "button",
-          "as": "print"
-        },
-        {
-          "component": "button",
-          "as": "applyFilters"
-        },
-        {
-          "component": "button",
-          "as": "resetFilters"
-        }
-      ],
-      "workflows": [
-        {
-          "name": "select_rows",
-          "safety": "read",
-          "description": "Select one or more rows in the table.",
-          "descriptionKey": "ui.agent.entityIndexTable.workflows.selectRows",
-          "uiActions": [
-            "data-table.select_rows"
-          ],
-          "apiActions": []
-        },
-        {
-          "name": "apply_filter",
-          "safety": "read",
-          "description": "Set the filter strip values and apply.",
-          "descriptionKey": "ui.agent.entityIndexTable.workflows.applyFilter",
-          "uiActions": [
-            "data-table.apply_filter"
-          ],
-          "apiActions": []
-        },
-        {
-          "name": "create_entity",
-          "safety": "write",
-          "description": "Open the create form and submit a new entity.",
-          "descriptionKey": "ui.agent.entityIndexTable.workflows.createEntity",
-          "uiActions": [],
-          "apiActions": [
-            "entity.create"
-          ]
-        },
-        {
-          "name": "delete_selected",
-          "safety": "destructive",
-          "description": "Delete every selected row. Irreversible.",
-          "descriptionKey": "ui.agent.entityIndexTable.workflows.deleteSelected",
-          "uiActions": [
-            "data-table.get_selection",
-            "data-table.clear_selection"
-          ],
-          "apiActions": [
-            "entity.delete"
-          ]
-        },
-        {
-          "name": "export_csv",
-          "safety": "read",
-          "description": "Trigger the CSV export of the current filtered set.",
-          "descriptionKey": "ui.agent.entityIndexTable.workflows.exportCsv",
-          "uiActions": [],
-          "apiActions": [
-            "entity.export"
-          ]
-        }
-      ]
-    },
-    {
-      "kind": "pattern",
-      "id": "invoices",
-      "composes": [
-        {
-          "component": "data-table",
-          "as": "ledger",
-          "entity": "invoice"
-        },
-        {
-          "component": "icon-button-group",
-          "as": "tableActions"
-        },
-        {
-          "component": "icon-button",
-          "as": "tableAction"
-        },
-        {
-          "component": "badge",
-          "as": "statusBadge"
-        },
-        {
-          "component": "button",
-          "as": "rowAction"
-        }
-      ],
-      "workflows": [
-        {
-          "name": "filter_invoices",
-          "safety": "read",
-          "description": "Narrow the ledger by number, relation, status, date range or amount using the per-column filters.",
-          "descriptionKey": "ui.agent.invoices.workflows.filterInvoices",
-          "uiActions": [
-            "data-table.apply_filter"
-          ],
-          "stateReads": [
-            "data-table.filter"
-          ],
-          "apiActions": [
-            "invoice.list"
-          ]
-        },
-        {
-          "name": "sort_ledger",
-          "safety": "read",
-          "description": "Re-sort the ledger by any column (e.g. issue date, total, balance).",
-          "descriptionKey": "ui.agent.invoices.workflows.sortLedger",
-          "uiActions": [
-            "data-table.sort_by"
-          ],
-          "stateReads": [
-            "data-table.sort"
-          ],
-          "apiActions": []
-        },
-        {
-          "name": "paginate",
-          "safety": "read",
-          "description": "Move to another page of the ledger.",
-          "descriptionKey": "ui.agent.invoices.workflows.paginate",
-          "uiActions": [
-            "data-table.go_to_page"
-          ],
-          "stateReads": [
-            "data-table.currentPage"
-          ],
-          "apiActions": []
-        },
-        {
-          "name": "export_ledger",
-          "safety": "read",
-          "description": "Export the current (optionally filtered) ledger from the page-header table-tools cluster — CSV / Excel / PDF.",
-          "descriptionKey": "ui.agent.invoices.workflows.exportLedger",
-          "uiActions": [],
-          "apiActions": [
-            "invoice.export"
-          ]
-        },
-        {
-          "name": "view_invoice",
-          "safety": "read",
-          "description": "Open a single invoice from its row action to inspect line items and payment history.",
-          "descriptionKey": "ui.agent.invoices.workflows.viewInvoice",
-          "uiActions": [
-            "data-table.get_selection"
-          ],
-          "stateReads": [
-            "data-table.selection"
-          ],
-          "apiActions": [
-            "invoice.get"
-          ]
-        },
-        {
-          "name": "download_pdf",
-          "safety": "read",
-          "description": "Download the selected invoice as a PDF from its row action.",
-          "descriptionKey": "ui.agent.invoices.workflows.downloadPdf",
-          "uiActions": [
-            "data-table.get_selection"
-          ],
-          "stateReads": [
-            "data-table.selection"
-          ],
-          "apiActions": [
-            "invoice.downloadPdf"
-          ]
-        },
-        {
-          "name": "send_reminder",
-          "safety": "write",
-          "description": "Send a payment reminder for the selected invoice through its eligible channel (email or SMS).",
-          "descriptionKey": "ui.agent.invoices.workflows.sendReminder",
-          "uiActions": [
-            "data-table.get_selection"
-          ],
-          "stateReads": [
-            "data-table.selection"
-          ],
-          "apiActions": [
-            "invoice.sendReminder"
-          ]
-        },
-        {
-          "name": "delete_invoice",
-          "safety": "destructive",
-          "description": "Delete the selected invoice from its row action. Paid invoices cannot be deleted. Irreversible.",
-          "descriptionKey": "ui.agent.invoices.workflows.deleteInvoice",
-          "uiActions": [
-            "data-table.get_selection",
-            "data-table.clear_selection"
-          ],
-          "stateReads": [
-            "data-table.selection"
-          ],
-          "apiActions": [
-            "invoice.delete"
-          ]
-        }
-      ]
-    },
-    {
-      "kind": "pattern",
-      "id": "marketplace-app-shell",
-      "composes": [
-        {
-          "component": "app-frame",
-          "as": "frame"
-        },
-        {
-          "component": "header",
-          "as": "topBar"
-        },
-        {
-          "component": "sidebar",
-          "as": "mainNav",
-          "entity": "navItem"
-        },
-        {
-          "component": "tab-bar",
-          "as": "embeddedNav",
-          "entity": "navItem"
-        },
-        {
-          "component": "avatar",
-          "as": "accountAvatar"
-        },
-        {
-          "component": "dropdown-menu",
-          "as": "accountMenu"
-        },
-        {
-          "component": "header-settings",
-          "as": "settings"
-        },
-        {
-          "component": "sign-in-with-alfadocs-button",
-          "as": "connectCta"
-        },
-        {
-          "component": "alert",
-          "as": "connectError"
-        },
-        {
-          "component": "card",
-          "as": "contentSurface"
-        },
-        {
-          "component": "theme-root",
-          "as": "themeScope"
-        },
-        {
-          "component": "tooltip",
-          "as": "navTooltip"
-        }
-      ],
-      "workflows": [
-        {
-          "name": "navigate",
-          "safety": "read",
-          "description": "Navigate to one of the app sections via the sidebar nav (or the embedded tab strip). Routing is consumer-owned, so the destination resolves through the host router.",
-          "descriptionKey": "ui.agent.marketplaceAppShell.workflows.navigate",
-          "uiActions": [],
-          "apiActions": [
-            "app.navigate"
-          ]
-        },
-        {
-          "name": "toggle_sidebar",
-          "safety": "read",
-          "description": "Collapse or expand the main navigation rail and read its current collapsed state.",
-          "descriptionKey": "ui.agent.marketplaceAppShell.workflows.toggleSidebar",
-          "uiActions": [
-            "sidebar.toggle_collapsed"
-          ],
-          "stateReads": [
-            "sidebar.isCollapsed"
-          ],
-          "apiActions": []
-        },
-        {
-          "name": "open_account_menu",
-          "safety": "read",
-          "description": "Open the account dropdown to reach sign-out and account settings.",
-          "descriptionKey": "ui.agent.marketplaceAppShell.workflows.openAccountMenu",
-          "uiActions": [
-            "dropdown-menu.open"
-          ],
-          "stateReads": [
-            "dropdown-menu.isOpen"
-          ],
-          "apiActions": []
-        },
-        {
-          "name": "set_appearance",
+          "name": "set_appearance",
           "safety": "write",
           "description": "Change the active theme, locale, or accessibility profile from the header settings.",
           "descriptionKey": "ui.agent.marketplaceAppShell.workflows.setAppearance",
@@ -13361,127 +13398,6 @@
         }
       ]
     },
-    {
-      "kind": "pattern",
-      "id": "multi-signee-signing",
-      "composes": [
-        {
-          "component": "public-header",
-          "as": "brandBar"
-        },
-        {
-          "component": "avatar",
-          "as": "rosterAvatar",
-          "entity": "signer"
-        },
-        {
-          "component": "badge",
-          "as": "rosterStatus",
-          "entity": "signer"
-        },
-        {
-          "component": "otp-input",
-          "as": "gateCode"
-        },
-        {
-          "component": "checkbox",
-          "as": "gateConfirm"
-        },
-        {
-          "component": "alert",
-          "as": "gateNotice"
-        },
-        {
-          "component": "card",
-          "as": "gateCard"
-        },
-        {
-          "component": "button",
-          "as": "gateVerify"
-        },
-        {
-          "component": "pdf-viewer",
-          "as": "document"
-        },
-        {
-          "component": "signature-field",
-          "as": "fieldOverlay",
-          "entity": "signatureField"
-        },
-        {
-          "component": "dialog",
-          "as": "captureDialog"
-        },
-        {
-          "component": "signature-capture",
-          "as": "capturePad"
-        },
-        {
-          "component": "finished-terminal",
-          "as": "terminal"
-        }
-      ],
-      "workflows": [
-        {
-          "name": "verify_party_identity",
-          "safety": "write",
-          "description": "The active party passes its own identity gate: enter the 5-character SMS code, or tick the confirm-identity checkbox when no mobile number is on file, then verify.",
-          "descriptionKey": "ui.agent.multiSigneeSigning.workflows.verifyPartyIdentity",
-          "uiActions": [
-            "otp-input.set_value",
-            "checkbox.set_checked"
-          ],
-          "stateReads": [
-            "otp-input.isComplete",
-            "checkbox.checked"
-          ],
-          "apiActions": [
-            "signing.verifyPartyIdentity",
-            "signing.resendCode"
-          ]
-        },
-        {
-          "name": "sign_party_fields",
-          "safety": "write",
-          "description": "The active party signs the surface filtered to its own fields: activate a field overlay, draw or type the signature in the capture dialog, and confirm it.",
-          "descriptionKey": "ui.agent.multiSigneeSigning.workflows.signPartyFields",
-          "uiActions": [
-            "pdf-viewer.go_to_page",
-            "dialog.open",
-            "signature-capture.clear",
-            "signature-capture.undo",
-            "signature-capture.confirm"
-          ],
-          "stateReads": [
-            "signature-capture.isEmpty",
-            "dialog.isOpen"
-          ],
-          "apiActions": [
-            "signing.applyPartyFieldSignature"
-          ]
-        },
-        {
-          "name": "hand_off_to_next_party",
-          "safety": "write",
-          "description": "After the active party finishes, hand the device to the next party (same-device flow), switching the active session and re-filtering the surface to the next party’s fields.",
-          "descriptionKey": "ui.agent.multiSigneeSigning.workflows.handOffToNextParty",
-          "uiActions": [],
-          "apiActions": [
-            "signing.handOffParty"
-          ]
-        },
-        {
-          "name": "complete_envelope",
-          "safety": "write",
-          "description": "Finalise the envelope once every party has signed all of its fields.",
-          "descriptionKey": "ui.agent.multiSigneeSigning.workflows.completeEnvelope",
-          "uiActions": [],
-          "apiActions": [
-            "signing.completeEnvelope"
-          ]
-        }
-      ]
-    },
     {
       "kind": "pattern",
       "id": "patient-ai-summary",
@@ -13991,86 +13907,14 @@
           ],
           "stateReads": [
             "text-input.value",
-            "fiscal-code-input.isValid",
-            "address-autocomplete.value",
-            "date-picker.value",
-            "select.value",
-            "radio-group.value"
-          ],
-          "apiActions": [
-            "patient.updateDetails"
-          ]
-        }
-      ]
-    },
-    {
-      "kind": "pattern",
-      "id": "patient-shell",
-      "composes": [
-        {
-          "component": "app-frame",
-          "as": "frame"
-        },
-        {
-          "component": "header",
-          "as": "topBar"
-        },
-        {
-          "component": "logo",
-          "as": "brand"
-        },
-        {
-          "component": "sidebar",
-          "as": "nav",
-          "entity": "navItem"
-        },
-        {
-          "component": "dropdown-menu",
-          "as": "settingsMenu"
-        },
-        {
-          "component": "button",
-          "as": "settingsTrigger"
-        }
-      ],
-      "workflows": [
-        {
-          "name": "toggle_sidebar",
-          "safety": "read",
-          "description": "Collapse or expand the flat patient navigation rail.",
-          "descriptionKey": "ui.agent.patientShell.workflows.toggleSidebar",
-          "uiActions": [
-            "sidebar.toggle_collapsed"
-          ],
-          "stateReads": [
-            "sidebar.isCollapsed"
-          ],
-          "apiActions": []
-        },
-        {
-          "name": "open_settings",
-          "safety": "read",
-          "description": "Open the header settings menu (fullscreen toggle and logout).",
-          "descriptionKey": "ui.agent.patientShell.workflows.openSettings",
-          "uiActions": [
-            "dropdown-menu.open",
-            "dropdown-menu.close"
-          ],
-          "stateReads": [
-            "dropdown-menu.isOpen"
-          ],
-          "apiActions": []
-        },
-        {
-          "name": "sign_out",
-          "safety": "write",
-          "description": "Log the patient out and navigate to the configured logout URL.",
-          "descriptionKey": "ui.agent.patientShell.workflows.signOut",
-          "uiActions": [
-            "dropdown-menu.open"
+            "fiscal-code-input.isValid",
+            "address-autocomplete.value",
+            "date-picker.value",
+            "select.value",
+            "radio-group.value"
           ],
           "apiActions": [
-            "auth.logout"
+            "patient.updateDetails"
           ]
         }
       ]
@@ -14384,84 +14228,6 @@
         }
       ]
     },
-    {
-      "kind": "pattern",
-      "id": "print-invoice",
-      "composes": [
-        {
-          "component": "logo",
-          "as": "brandmark"
-        },
-        {
-          "component": "description-list",
-          "as": "invoiceMeta"
-        },
-        {
-          "component": "description-list",
-          "as": "totals"
-        },
-        {
-          "component": "data-table",
-          "as": "lineItems",
-          "entity": "invoiceLineItem"
-        },
-        {
-          "component": "tooth-scheme",
-          "as": "odontogram",
-          "entity": "tooth"
-        }
-      ],
-      "workflows": [
-        {
-          "name": "sort_line_items",
-          "safety": "read",
-          "description": "Sort the invoice line-items table by a column.",
-          "descriptionKey": "ui.agent.printInvoice.workflows.sortLineItems",
-          "uiActions": [
-            "data-table.sort_by"
-          ],
-          "stateReads": [
-            "data-table.sort"
-          ],
-          "apiActions": []
-        },
-        {
-          "name": "read_findings",
-          "safety": "read",
-          "description": "Read the charted odontogram findings on the treatment-plan variant.",
-          "descriptionKey": "ui.agent.printInvoice.workflows.readFindings",
-          "uiActions": [
-            "tooth-scheme.teeth_with",
-            "tooth-scheme.get_tooth"
-          ],
-          "stateReads": [
-            "tooth-scheme.chart",
-            "tooth-scheme.chartedTeeth"
-          ],
-          "apiActions": []
-        },
-        {
-          "name": "generate_pdf",
-          "safety": "read",
-          "description": "Render the current invoice (or treatment plan) to a print-ready PDF document.",
-          "descriptionKey": "ui.agent.printInvoice.workflows.generatePdf",
-          "uiActions": [],
-          "apiActions": [
-            "invoice.renderPdf"
-          ]
-        },
-        {
-          "name": "send_invoice",
-          "safety": "write",
-          "description": "Email the generated invoice document to the patient.",
-          "descriptionKey": "ui.agent.printInvoice.workflows.sendInvoice",
-          "uiActions": [],
-          "apiActions": [
-            "invoice.send"
-          ]
-        }
-      ]
-    },
     {
       "kind": "pattern",
       "id": "roi-dashboard",
@@ -15068,12 +14834,140 @@
         }
       ]
     },
+    {
+      "kind": "pattern",
+      "id": "signature-request",
+      "composes": [
+        {
+          "component": "dialog",
+          "as": "requestModal"
+        },
+        {
+          "component": "select",
+          "as": "operatorSigner"
+        },
+        {
+          "component": "select",
+          "as": "patientSigner"
+        },
+        {
+          "component": "radio-group",
+          "as": "deliveryChannel"
+        },
+        {
+          "component": "switch",
+          "as": "otpWaiver"
+        },
+        {
+          "component": "alert",
+          "as": "operatorHint"
+        },
+        {
+          "component": "alert",
+          "as": "otpWarning"
+        },
+        {
+          "component": "button",
+          "as": "assignToMe"
+        },
+        {
+          "component": "button",
+          "as": "requestSignature"
+        }
+      ],
+      "workflows": [
+        {
+          "name": "assign_operator",
+          "safety": "write",
+          "description": "Pick the operator who must counter-sign (or \"Assign later\" to leave the request unassigned). \"Assign to me\" claims it for the signed-in operator.",
+          "descriptionKey": "ui.agent.signatureRequest.workflows.assignOperator",
+          "uiActions": [
+            "select.set_value"
+          ],
+          "stateReads": [
+            "select.value"
+          ],
+          "apiActions": []
+        },
+        {
+          "name": "choose_patient_signer",
+          "safety": "write",
+          "description": "Pick who signs on the patient side: the patient, a legal guardian, or a third-party signer.",
+          "descriptionKey": "ui.agent.signatureRequest.workflows.choosePatientSigner",
+          "uiActions": [
+            "select.set_value"
+          ],
+          "stateReads": [
+            "select.value"
+          ],
+          "apiActions": []
+        },
+        {
+          "name": "choose_delivery_channel",
+          "safety": "write",
+          "description": "Choose how the signature request reaches the patient: SMS, e-mail, WhatsApp, or signing on this device.",
+          "descriptionKey": "ui.agent.signatureRequest.workflows.chooseDeliveryChannel",
+          "uiActions": [
+            "radio-group.set_value"
+          ],
+          "stateReads": [
+            "radio-group.value"
+          ],
+          "apiActions": []
+        },
+        {
+          "name": "waive_otp",
+          "safety": "write",
+          "description": "Toggle the on-device OTP waiver. Waiving OTP lowers the evidentiary value of the signature; the pattern surfaces a warning alert while waived.",
+          "descriptionKey": "ui.agent.signatureRequest.workflows.waiveOtp",
+          "uiActions": [
+            "switch.toggle",
+            "switch.set_checked"
+          ],
+          "stateReads": [
+            "switch.checked"
+          ],
+          "apiActions": []
+        },
+        {
+          "name": "request_signature",
+          "safety": "phi",
+          "description": "Send the signature request. Notifies the chosen signers over the selected channel and closes the modal.",
+          "descriptionKey": "ui.agent.signatureRequest.workflows.requestSignature",
+          "uiActions": [
+            "dialog.close"
+          ],
+          "stateReads": [
+            "select.value",
+            "radio-group.value",
+            "switch.checked",
+            "dialog.isOpen"
+          ],
+          "apiActions": [
+            "signature.request"
+          ]
+        },
+        {
+          "name": "dismiss",
+          "safety": "destructive",
+          "description": "Close the modal without sending a signature request. Discards the in-progress signer, channel, and OTP choices.",
+          "descriptionKey": "ui.agent.signatureRequest.workflows.dismiss",
+          "uiActions": [
+            "dialog.dismiss"
+          ],
+          "stateReads": [
+            "dialog.isOpen"
+          ],
+          "apiActions": []
+        }
+      ]
+    },
     {
       "kind": "pattern",
       "id": "signing",
       "composes": [
         {
-          "component": "public-header",
+          "component": "header",
           "as": "brandBar"
         },
         {
@@ -15117,6 +15011,16 @@
           "component": "finished-terminal",
           "as": "terminal"
         },
+        {
+          "component": "avatar",
+          "as": "rosterAvatar",
+          "entity": "signer"
+        },
+        {
+          "component": "badge",
+          "as": "rosterStatus",
+          "entity": "signer"
+        },
         {
           "component": "empty-state",
           "as": "invalidLink"
@@ -15178,131 +15082,38 @@
         {
           "name": "complete_envelope",
           "safety": "write",
-          "description": "Finalise the envelope once every required field carries a signature, persisting the completed document.",
+          "description": "Finalise the envelope once every required field carries a signature (with two signees: once both the primary and the secondary have signed all of their fields), persisting the completed document.",
           "descriptionKey": "ui.agent.signing.workflows.completeEnvelope",
           "uiActions": [],
           "apiActions": [
             "signing.completeEnvelope"
           ]
-        }
-      ]
-    },
-    {
-      "kind": "pattern",
-      "id": "signing-wizard",
-      "composes": [
-        {
-          "component": "public-header",
-          "as": "brandBar"
-        },
-        {
-          "component": "stepper-progress",
-          "as": "wizard"
-        },
-        {
-          "component": "otp-input",
-          "as": "gateCode"
-        },
-        {
-          "component": "checkbox",
-          "as": "gateConfirm"
-        },
-        {
-          "component": "alert",
-          "as": "gateNotice"
-        },
-        {
-          "component": "card",
-          "as": "gateCard"
-        },
-        {
-          "component": "button",
-          "as": "gateVerify"
-        },
-        {
-          "component": "pdf-viewer",
-          "as": "document"
-        },
-        {
-          "component": "signature-field",
-          "as": "fieldOverlay",
-          "entity": "signatureField"
-        },
-        {
-          "component": "dialog",
-          "as": "captureDialog"
-        },
-        {
-          "component": "signature-capture",
-          "as": "capturePad"
-        },
-        {
-          "component": "finished-terminal",
-          "as": "terminal"
-        },
-        {
-          "component": "empty-state",
-          "as": "invalidLink"
         },
         {
-          "component": "spinner",
-          "as": "loading"
-        }
-      ],
-      "workflows": [
-        {
-          "name": "verify_identity",
+          "name": "verify_signee_identity",
           "safety": "write",
-          "description": "Complete the Verify step: enter the 5-character SMS code, or tick the confirm-identity checkbox when no mobile number is on file, then advance to the Sign step.",
-          "descriptionKey": "ui.agent.signingWizard.workflows.verifyIdentity",
+          "description": "The active signee (primary or secondary) passes its own identity gate: enter the 5-character SMS code, or tick the confirm-identity checkbox when no mobile number is on file, then verify.",
+          "descriptionKey": "ui.agent.signing.workflows.verifySigneeIdentity",
           "uiActions": [
             "otp-input.set_value",
-            "checkbox.set_checked",
-            "stepper-progress.next"
+            "checkbox.set_checked"
           ],
           "stateReads": [
             "otp-input.isComplete",
-            "checkbox.checked",
-            "stepper-progress.currentStep"
+            "checkbox.checked"
           ],
           "apiActions": [
-            "signing.verifyIdentity",
+            "signing.verifySigneeIdentity",
             "signing.resendCode"
           ]
         },
         {
-          "name": "navigate_steps",
-          "safety": "read",
-          "description": "Move between the Verify → Sign → Done steps of the wizard.",
-          "descriptionKey": "ui.agent.signingWizard.workflows.navigateSteps",
-          "uiActions": [
-            "stepper-progress.next",
-            "stepper-progress.previous",
-            "stepper-progress.goto_step"
-          ],
-          "stateReads": [
-            "stepper-progress.currentStep",
-            "stepper-progress.totalSteps"
-          ],
-          "apiActions": []
-        },
-        {
-          "name": "read_document",
-          "safety": "read",
-          "description": "Page through and zoom the document under signature on the Sign step.",
-          "descriptionKey": "ui.agent.signingWizard.workflows.readDocument",
-          "uiActions": [
-            "pdf-viewer.go_to_page",
-            "pdf-viewer.set_zoom"
-          ],
-          "apiActions": []
-        },
-        {
-          "name": "sign_field",
+          "name": "sign_signee_fields",
           "safety": "write",
-          "description": "Activate a field overlay on the Sign step, draw or type the signature in the capture dialog, and confirm it.",
-          "descriptionKey": "ui.agent.signingWizard.workflows.signField",
+          "description": "The active signee signs the surface filtered to its own fields: activate a field overlay, draw or type the signature in the capture dialog, and confirm it.",
+          "descriptionKey": "ui.agent.signing.workflows.signSigneeFields",
           "uiActions": [
+            "pdf-viewer.go_to_page",
             "dialog.open",
             "signature-capture.clear",
             "signature-capture.undo",
@@ -15313,17 +15124,17 @@
             "dialog.isOpen"
           ],
           "apiActions": [
-            "signing.applyFieldSignature"
+            "signing.applySigneeFieldSignature"
           ]
         },
         {
-          "name": "complete_envelope",
+          "name": "hand_off_to_secondary_signee",
           "safety": "write",
-          "description": "Finalise the envelope once every required field is signed and the wizard reaches the Done step.",
-          "descriptionKey": "ui.agent.signingWizard.workflows.completeEnvelope",
+          "description": "After the primary signee finishes, hand the device to the secondary signee (same-device flow), switching the active session and re-filtering the surface to the secondary signee’s fields.",
+          "descriptionKey": "ui.agent.signing.workflows.handOffToSecondarySignee",
           "uiActions": [],
           "apiActions": [
-            "signing.completeEnvelope"
+            "signing.handOffToSecondarySignee"
           ]
         }
       ]