@alfadocs/ui-kit 0.71.0 → 0.72.1

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "0.71.0",
+  "packageVersion": "0.72.1",
   "components": [
     {
       "kind": "component",
@@ -549,247 +549,6 @@
         }
       }
     },
-    {
-      "kind": "component",
-      "id": "anatomy-scheme",
-      "capabilities": [
-        "pick",
-        "set_value",
-        "edit_inline",
-        "view_change"
-      ],
-      "state": [
-        {
-          "name": "chart",
-          "type": "object",
-          "description": "Current anatomy chart — findings keyed by region id. Notes are PHI and omitted from this snapshot; read them per-region via get_region.",
-          "descriptionKey": "ui.agent.anatomyScheme.state.chart"
-        },
-        {
-          "name": "activeView",
-          "type": "string",
-          "description": "Id of the currently displayed anatomy view.",
-          "descriptionKey": "ui.agent.anatomyScheme.state.activeView"
-        }
-      ],
-      "actions": [
-        {
-          "name": "focus_region",
-          "safety": "read",
-          "argsType": "{ regionId: string }",
-          "argsSchema": {
-            "type": "object",
-            "properties": {
-              "regionId": {
-                "type": "string",
-                "description": "Region id within the active view, e.g. 'ovary-l', 'prostate', 'quadriceps-r', 'kidney-r'."
-              }
-            },
-            "required": [
-              "regionId"
-            ]
-          },
-          "idempotent": true,
-          "description": "Move focus to a specific region in the active view.",
-          "descriptionKey": "ui.agent.anatomyScheme.actions.focusRegion"
-        },
-        {
-          "name": "get_region",
-          "safety": "phi",
-          "argsType": "{ regionId: string }",
-          "argsSchema": {
-            "type": "object",
-            "properties": {
-              "regionId": {
-                "type": "string",
-                "description": "Region id within the active view, e.g. 'ovary-l', 'prostate', 'quadriceps-r', 'kidney-r'."
-              }
-            },
-            "required": [
-              "regionId"
-            ]
-          },
-          "returns": "AnatomyFinding[]",
-          "returnsSchema": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "properties": {
-                "type": {
-                  "enum": [
-                    "observation",
-                    "lesion",
-                    "pain",
-                    "treatment",
-                    "note"
-                  ]
-                },
-                "note": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "type"
-              ]
-            }
-          },
-          "idempotent": true,
-          "description": "Read the findings (incl. notes) recorded on one region.",
-          "descriptionKey": "ui.agent.anatomyScheme.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": "Region id within the active view, e.g. 'ovary-l', 'prostate', 'quadriceps-r', 'kidney-r'."
-            }
-          },
-          "idempotent": true,
-          "description": "List the region ids carrying a given finding type.",
-          "descriptionKey": "ui.agent.anatomyScheme.actions.regionsWith"
-        },
-        {
-          "name": "set_finding",
-          "safety": "write",
-          "argsType": "{ regionId: string; type: FindingType; note?: string }",
-          "argsSchema": {
-            "type": "object",
-            "properties": {
-              "regionId": {
-                "type": "string",
-                "description": "Region id within the active view, e.g. 'ovary-l', 'prostate', 'quadriceps-r', 'kidney-r'."
-              },
-              "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 region.",
-          "descriptionKey": "ui.agent.anatomyScheme.actions.setFinding"
-        },
-        {
-          "name": "remove_finding",
-          "safety": "write",
-          "argsType": "{ regionId: string; type: FindingType }",
-          "argsSchema": {
-            "type": "object",
-            "properties": {
-              "regionId": {
-                "type": "string",
-                "description": "Region id within the active view, e.g. 'ovary-l', 'prostate', 'quadriceps-r', 'kidney-r'."
-              },
-              "type": {
-                "enum": [
-                  "observation",
-                  "lesion",
-                  "pain",
-                  "treatment",
-                  "note"
-                ]
-              }
-            },
-            "required": [
-              "regionId",
-              "type"
-            ]
-          },
-          "idempotent": true,
-          "description": "Remove a single finding type from a region.",
-          "descriptionKey": "ui.agent.anatomyScheme.actions.removeFinding"
-        },
-        {
-          "name": "clear_region",
-          "safety": "destructive",
-          "argsType": "{ regionId: string }",
-          "argsSchema": {
-            "type": "object",
-            "properties": {
-              "regionId": {
-                "type": "string",
-                "description": "Region id within the active view, e.g. 'ovary-l', 'prostate', 'quadriceps-r', 'kidney-r'."
-              }
-            },
-            "required": [
-              "regionId"
-            ]
-          },
-          "idempotent": true,
-          "description": "Clear every finding from a region.",
-          "descriptionKey": "ui.agent.anatomyScheme.actions.clearRegion"
-        },
-        {
-          "name": "set_view",
-          "safety": "write",
-          "argsType": "{ viewId: string }",
-          "argsSchema": {
-            "type": "object",
-            "properties": {
-              "viewId": {
-                "type": "string",
-                "description": "View id, e.g. 'body-front', 'face-front', 'female-reproductive', 'male-reproductive', 'urinary', 'muscular-front', 'skeletal-front'."
-              }
-            },
-            "required": [
-              "viewId"
-            ]
-          },
-          "idempotent": true,
-          "description": "Switch the active anatomy view.",
-          "descriptionKey": "ui.agent.anatomyScheme.actions.setView"
-        }
-      ],
-      "domHooks": {
-        "root": {
-          "attr": "data-component",
-          "value": "anatomy-scheme"
-        },
-        "instanceId": {
-          "attr": "data-component-id",
-          "sourceProp": "id",
-          "description": "Sourced from the id prop."
-        },
-        "item": {
-          "attr": "data-region",
-          "description": "Each rendered region `<g>` carries its region id as `data-region` and its anatomical side (`left` / `right` / `midline`) as `data-side`, so bilateral regions can be disambiguated by side. The root `data-system` / `data-view` attributes expose the active anatomy system and view."
-        }
-      }
-    },
     {
       "kind": "component",
       "id": "app-frame",
@@ -3933,36 +3692,285 @@
     },
     {
       "kind": "component",
-      "id": "fetal-weight",
+      "id": "face-scheme",
       "capabilities": [
-        "set_value"
+        "pick",
+        "set_value",
+        "edit_inline",
+        "view_change"
       ],
-      "state": [],
-      "actions": [],
-      "domHooks": {
-        "root": {
-          "attr": "data-component",
-          "value": "fetal-weight",
-          "description": "Marks the FetalWeight calculator (estimated fetal weight from ultrasound biometry)."
+      "state": [
+        {
+          "name": "activeView",
+          "type": "string",
+          "description": "Id of the currently displayed view (front / profile-left / profile-right).",
+          "descriptionKey": "ui.agent.faceScheme.state.activeView"
         },
-        "instanceId": {
-          "attr": "data-component-id",
-          "sourceProp": "id",
-          "description": "Sourced from the id prop. Required to address a specific calculator instance from the agent."
+        {
+          "name": "chart",
+          "type": "Record<string, string[]>",
+          "description": "Current face chart — the finding types recorded on each zone, keyed by zone id. Free-text notes and the patient photo are not exposed here.",
+          "descriptionKey": "ui.agent.faceScheme.state.chart"
+        },
+        {
+          "name": "markedZones",
+          "type": "string[]",
+          "description": "Zone ids carrying at least one finding.",
+          "descriptionKey": "ui.agent.faceScheme.state.markedZones"
         }
-      }
-    },
-    {
-      "kind": "component",
-      "id": "field-array",
-      "capabilities": [
-        "edit_inline"
       ],
-      "state": [
+      "actions": [
         {
-          "name": "count",
-          "type": "number",
-          "description": "Number of rows currently rendered.",
+          "name": "focus_zone",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Face-zone id (e.g. 'glabella', 'nasolabialFold', 'forehead', 'mandibularAngleLeft' on the front view; 'cheekbone', 'masseter', 'chin' on a profile view)."
+              }
+            },
+            "required": [
+              "id"
+            ]
+          },
+          "idempotent": true,
+          "description": "Move focus to a specific face zone by id.",
+          "descriptionKey": "ui.agent.faceScheme.actions.focusZone"
+        },
+        {
+          "name": "get_zone",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Face-zone id (e.g. 'glabella', 'nasolabialFold', 'forehead', 'mandibularAngleLeft' on the front view; 'cheekbone', 'masseter', 'chin' on a profile view)."
+              }
+            },
+            "required": [
+              "id"
+            ]
+          },
+          "returns": "string[]",
+          "returnsSchema": {
+            "type": "array",
+            "items": {
+              "enum": [
+                "observation",
+                "treatment",
+                "concern",
+                "note"
+              ]
+            }
+          },
+          "idempotent": true,
+          "description": "Read the finding types recorded on one zone (notes are not returned).",
+          "descriptionKey": "ui.agent.faceScheme.actions.getZone"
+        },
+        {
+          "name": "zones_with",
+          "safety": "read",
+          "argsType": "{ finding: FaceFindingType }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "finding": {
+                "enum": [
+                  "observation",
+                  "treatment",
+                  "concern",
+                  "note"
+                ]
+              }
+            },
+            "required": [
+              "finding"
+            ]
+          },
+          "returns": "string[]",
+          "returnsSchema": {
+            "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)."
+            }
+          },
+          "idempotent": true,
+          "description": "List the zone ids carrying a given finding type.",
+          "descriptionKey": "ui.agent.faceScheme.actions.zonesWith"
+        },
+        {
+          "name": "set_finding",
+          "safety": "write",
+          "argsType": "{ id: string; finding: FaceFindingType; note?: string }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Face-zone id (e.g. 'glabella', 'nasolabialFold', 'forehead', 'mandibularAngleLeft' on the front view; 'cheekbone', 'masseter', 'chin' on a profile view)."
+              },
+              "finding": {
+                "enum": [
+                  "observation",
+                  "treatment",
+                  "concern",
+                  "note"
+                ]
+              },
+              "note": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "id",
+              "finding"
+            ]
+          },
+          "idempotent": true,
+          "description": "Record a finding on a zone, with an optional free-text note.",
+          "descriptionKey": "ui.agent.faceScheme.actions.setFinding"
+        },
+        {
+          "name": "remove_finding",
+          "safety": "write",
+          "argsType": "{ id: string; finding: FaceFindingType }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Face-zone id (e.g. 'glabella', 'nasolabialFold', 'forehead', 'mandibularAngleLeft' on the front view; 'cheekbone', 'masseter', 'chin' on a profile view)."
+              },
+              "finding": {
+                "enum": [
+                  "observation",
+                  "treatment",
+                  "concern",
+                  "note"
+                ]
+              }
+            },
+            "required": [
+              "id",
+              "finding"
+            ]
+          },
+          "idempotent": true,
+          "description": "Remove a single finding from a zone.",
+          "descriptionKey": "ui.agent.faceScheme.actions.removeFinding"
+        },
+        {
+          "name": "clear_zone",
+          "safety": "destructive",
+          "argsType": "{ id: string }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Face-zone id (e.g. 'glabella', 'nasolabialFold', 'forehead', 'mandibularAngleLeft' on the front view; 'cheekbone', 'masseter', 'chin' on a profile view)."
+              }
+            },
+            "required": [
+              "id"
+            ]
+          },
+          "idempotent": true,
+          "description": "Clear every finding from a zone.",
+          "descriptionKey": "ui.agent.faceScheme.actions.clearZone"
+        },
+        {
+          "name": "auto_align",
+          "safety": "write",
+          "argsType": "{}",
+          "argsSchema": {
+            "type": "object",
+            "properties": {}
+          },
+          "idempotent": true,
+          "description": "Run the on-device detector to align the zone overlay to the patient photo (works on the active view — front or profile). No-op if detection is disabled or no face is found.",
+          "descriptionKey": "ui.agent.faceScheme.actions.autoAlign"
+        },
+        {
+          "name": "set_view",
+          "safety": "write",
+          "argsType": "{ view: FaceViewId }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "view": {
+                "type": "string",
+                "enum": [
+                  "front",
+                  "profile-left",
+                  "profile-right"
+                ],
+                "description": "Active view id: 'front', 'profile-left', or 'profile-right'."
+              }
+            },
+            "required": [
+              "view"
+            ]
+          },
+          "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"
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "face-scheme"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "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."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "fetal-weight",
+      "capabilities": [
+        "set_value"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "fetal-weight",
+          "description": "Marks the FetalWeight calculator (estimated fetal weight from ultrasound biometry)."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop. Required to address a specific calculator instance from the agent."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "field-array",
+      "capabilities": [
+        "edit_inline"
+      ],
+      "state": [
+        {
+          "name": "count",
+          "type": "number",
+          "description": "Number of rows currently rendered.",
           "descriptionKey": "ui.agent.fieldArray.state.count"
         }
       ],
@@ -5290,66 +5298,307 @@
     },
     {
       "kind": "component",
-      "id": "nav-grid",
+      "id": "muscle-scheme",
       "capabilities": [
-        "navigate"
+        "pick",
+        "set_value",
+        "edit_inline",
+        "view_change"
       ],
       "state": [
         {
-          "name": "itemCount",
-          "type": "number",
-          "description": "Number of navigable tiles currently rendered in the grid.",
-          "descriptionKey": "ui.agent.navGrid.state.itemCount"
+          "name": "chart",
+          "type": "object",
+          "description": "Current muscle chart — findings keyed by region id. Notes are PHI and omitted from this snapshot; read them per-region via get_region.",
+          "descriptionKey": "ui.agent.muscleScheme.state.chart"
+        },
+        {
+          "name": "activeView",
+          "type": "string",
+          "description": "Id of the currently displayed muscle view.",
+          "descriptionKey": "ui.agent.muscleScheme.state.activeView"
         }
       ],
       "actions": [
         {
-          "name": "open_item",
-          "safety": "write",
-          "argsType": "{ id: string }",
+          "name": "focus_region",
+          "safety": "read",
+          "argsType": "{ regionId: string }",
           "argsSchema": {
             "type": "object",
             "properties": {
-              "id": {
+              "regionId": {
                 "type": "string",
-                "description": "Stable opaque tile id (emitted as data-nav-item-id on each tile)."
+                "description": "Per-muscle region id within the active view, e.g. 'quadriceps-r', 'biceps-l', 'pectoralis-r', 'trapezius-l'."
               }
             },
             "required": [
-              "id"
+              "regionId"
             ]
           },
-          "openWorld": false,
-          "examples": [
-            {
-              "args": {
-                "id": "billing"
-              },
-              "note": "Open the \"billing\" settings section."
-            }
-          ],
-          "description": "Activate the tile with the given id (navigates or fires its select handler).",
-          "descriptionKey": "ui.agent.navGrid.actions.openItem"
-        }
-      ],
-      "domHooks": {
-        "root": {
-          "attr": "data-component",
-          "value": "nav-grid",
-          "description": "Marks the NavGrid nav landmark."
-        },
-        "instanceId": {
-          "attr": "data-component-id",
-          "sourceProp": "id",
-          "description": "Sourced from the id prop. Required to address a specific grid from the agent."
+          "idempotent": true,
+          "description": "Move focus to a specific region in the active view.",
+          "descriptionKey": "ui.agent.muscleScheme.actions.focusRegion"
         },
-        "item": {
-          "attr": "data-nav-item-id",
-          "sourceProp": "item id",
-          "description": "Stable opaque id of a tile, sourced from each item.id. open_item targets this attribute."
-        }
-      }
-    },
+        {
+          "name": "get_region",
+          "safety": "phi",
+          "argsType": "{ regionId: string }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "regionId": {
+                "type": "string",
+                "description": "Per-muscle region id within the active view, e.g. 'quadriceps-r', 'biceps-l', 'pectoralis-r', 'trapezius-l'."
+              }
+            },
+            "required": [
+              "regionId"
+            ]
+          },
+          "returns": "MuscleFinding[]",
+          "returnsSchema": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "enum": [
+                    "observation",
+                    "lesion",
+                    "pain",
+                    "treatment",
+                    "note"
+                  ]
+                },
+                "note": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "type"
+              ]
+            }
+          },
+          "idempotent": true,
+          "description": "Read the findings (incl. notes) recorded on one region.",
+          "descriptionKey": "ui.agent.muscleScheme.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-muscle region id within the active view, e.g. 'quadriceps-r', 'biceps-l', 'pectoralis-r', 'trapezius-l'."
+            }
+          },
+          "idempotent": true,
+          "description": "List the region ids carrying a given finding type.",
+          "descriptionKey": "ui.agent.muscleScheme.actions.regionsWith"
+        },
+        {
+          "name": "set_finding",
+          "safety": "write",
+          "argsType": "{ regionId: string; type: FindingType; note?: string }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "regionId": {
+                "type": "string",
+                "description": "Per-muscle region id within the active view, e.g. 'quadriceps-r', 'biceps-l', 'pectoralis-r', 'trapezius-l'."
+              },
+              "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 region.",
+          "descriptionKey": "ui.agent.muscleScheme.actions.setFinding"
+        },
+        {
+          "name": "remove_finding",
+          "safety": "write",
+          "argsType": "{ regionId: string; type: FindingType }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "regionId": {
+                "type": "string",
+                "description": "Per-muscle region id within the active view, e.g. 'quadriceps-r', 'biceps-l', 'pectoralis-r', 'trapezius-l'."
+              },
+              "type": {
+                "enum": [
+                  "observation",
+                  "lesion",
+                  "pain",
+                  "treatment",
+                  "note"
+                ]
+              }
+            },
+            "required": [
+              "regionId",
+              "type"
+            ]
+          },
+          "idempotent": true,
+          "description": "Remove a single finding type from a region.",
+          "descriptionKey": "ui.agent.muscleScheme.actions.removeFinding"
+        },
+        {
+          "name": "clear_region",
+          "safety": "destructive",
+          "argsType": "{ regionId: string }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "regionId": {
+                "type": "string",
+                "description": "Per-muscle region id within the active view, e.g. 'quadriceps-r', 'biceps-l', 'pectoralis-r', 'trapezius-l'."
+              }
+            },
+            "required": [
+              "regionId"
+            ]
+          },
+          "idempotent": true,
+          "description": "Clear every finding from a region.",
+          "descriptionKey": "ui.agent.muscleScheme.actions.clearRegion"
+        },
+        {
+          "name": "set_view",
+          "safety": "write",
+          "argsType": "{ viewId: string }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "viewId": {
+                "type": "string",
+                "description": "View id, e.g. 'muscular-front', 'muscular-back', 'muscular-front-female', 'muscular-back-female', 'muscular-front-child', 'muscular-back-child'."
+              }
+            },
+            "required": [
+              "viewId"
+            ]
+          },
+          "idempotent": true,
+          "description": "Switch the active muscle view.",
+          "descriptionKey": "ui.agent.muscleScheme.actions.setView"
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "muscle-scheme"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-region",
+          "description": "Each rendered region `<g>` carries its region id as `data-region` and its anatomical side (`left` / `right` / `midline`) as `data-side`, so bilateral regions can be disambiguated by side. The root `data-view` attribute exposes the active muscle view."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "nav-grid",
+      "capabilities": [
+        "navigate"
+      ],
+      "state": [
+        {
+          "name": "itemCount",
+          "type": "number",
+          "description": "Number of navigable tiles currently rendered in the grid.",
+          "descriptionKey": "ui.agent.navGrid.state.itemCount"
+        }
+      ],
+      "actions": [
+        {
+          "name": "open_item",
+          "safety": "write",
+          "argsType": "{ id: string }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Stable opaque tile id (emitted as data-nav-item-id on each tile)."
+              }
+            },
+            "required": [
+              "id"
+            ]
+          },
+          "openWorld": false,
+          "examples": [
+            {
+              "args": {
+                "id": "billing"
+              },
+              "note": "Open the \"billing\" settings section."
+            }
+          ],
+          "description": "Activate the tile with the given id (navigates or fires its select handler).",
+          "descriptionKey": "ui.agent.navGrid.actions.openItem"
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "nav-grid",
+          "description": "Marks the NavGrid nav landmark."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop. Required to address a specific grid from the agent."
+        },
+        "item": {
+          "attr": "data-nav-item-id",
+          "sourceProp": "item id",
+          "description": "Stable opaque id of a tile, sourced from each item.id. open_item targets this attribute."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "navigation-menu",
@@ -5856,22 +6105,288 @@
     },
     {
       "kind": "component",
-      "id": "otp-input",
+      "id": "optical-prescription",
       "capabilities": [
+        "pick",
+        "edit_inline",
         "set_value"
       ],
       "state": [
         {
-          "name": "value",
-          "type": "string",
-          "description": "Current digits entered, packed into a single string.",
-          "descriptionKey": "ui.agent.otpInput.state.value"
+          "name": "prescription",
+          "type": "object",
+          "description": "Current prescription — refraction rows per band/eye plus PD, lens type and axis system. The free-text note is PHI and omitted; read it via get_notes.",
+          "descriptionKey": "ui.agent.opticalPrescription.state.prescription"
         },
         {
-          "name": "isComplete",
-          "type": "boolean",
-          "description": "Whether all required digits have been entered.",
-          "descriptionKey": "ui.agent.otpInput.state.isComplete"
+          "name": "bands",
+          "type": "string[]",
+          "description": "Distance bands carrying at least one refraction value (far / intermediate / near).",
+          "descriptionKey": "ui.agent.opticalPrescription.state.bands"
+        }
+      ],
+      "actions": [
+        {
+          "name": "focus_eye",
+          "safety": "read",
+          "argsType": "{ eye: Eye; band?: DistanceBand }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "eye": {
+                "enum": [
+                  "od",
+                  "os"
+                ],
+                "description": "Eye — `od` (right eye) or `os` (left eye)."
+              },
+              "band": {
+                "enum": [
+                  "far",
+                  "intermediate",
+                  "near"
+                ],
+                "description": "Distance band — `far` (per lontano), `intermediate`, `near` (per vicino)."
+              }
+            },
+            "required": [
+              "eye"
+            ]
+          },
+          "idempotent": true,
+          "description": "Move focus to an eye's row (first editable cell in interactive mode), optionally within a specific band.",
+          "descriptionKey": "ui.agent.opticalPrescription.actions.focusEye"
+        },
+        {
+          "name": "get_row",
+          "safety": "read",
+          "argsType": "{ band: DistanceBand; eye: Eye }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "band": {
+                "enum": [
+                  "far",
+                  "intermediate",
+                  "near"
+                ],
+                "description": "Distance band — `far` (per lontano), `intermediate`, `near` (per vicino)."
+              },
+              "eye": {
+                "enum": [
+                  "od",
+                  "os"
+                ],
+                "description": "Eye — `od` (right eye) or `os` (left eye)."
+              }
+            },
+            "required": [
+              "band",
+              "eye"
+            ]
+          },
+          "returns": "RefractionRow | undefined",
+          "returnsSchema": {
+            "type": "object",
+            "properties": {
+              "sphere": {
+                "type": "number"
+              },
+              "cylinder": {
+                "type": "number"
+              },
+              "axis": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 180
+              },
+              "add": {
+                "type": "number"
+              },
+              "prism": {
+                "type": "number"
+              },
+              "base": {
+                "enum": [
+                  "up",
+                  "down",
+                  "in",
+                  "out"
+                ]
+              }
+            }
+          },
+          "idempotent": true,
+          "description": "Read one eye's refraction row at a distance band.",
+          "descriptionKey": "ui.agent.opticalPrescription.actions.getRow"
+        },
+        {
+          "name": "get_notes",
+          "safety": "phi",
+          "returns": "string",
+          "returnsSchema": {
+            "type": "string"
+          },
+          "idempotent": true,
+          "description": "Read the free-text clinical note on the prescription.",
+          "descriptionKey": "ui.agent.opticalPrescription.actions.getNotes"
+        },
+        {
+          "name": "set_cell",
+          "safety": "write",
+          "argsType": "{ band: DistanceBand; eye: Eye; field: keyof RefractionRow; value: number | PrismBase | null }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "band": {
+                "enum": [
+                  "far",
+                  "intermediate",
+                  "near"
+                ],
+                "description": "Distance band — `far` (per lontano), `intermediate`, `near` (per vicino)."
+              },
+              "eye": {
+                "enum": [
+                  "od",
+                  "os"
+                ],
+                "description": "Eye — `od` (right eye) or `os` (left eye)."
+              },
+              "field": {
+                "enum": [
+                  "sphere",
+                  "cylinder",
+                  "axis",
+                  "add",
+                  "prism",
+                  "base"
+                ],
+                "description": "Refraction column — dioptric `sphere` / `cylinder` / `add` (0.25 steps), `axis` (0–180°), `prism`, or `base` (a direction enum)."
+              },
+              "value": {
+                "description": "New cell value — a number for the dioptric/axis/prism columns, a base-direction string for `base`, or null to clear."
+              }
+            },
+            "required": [
+              "band",
+              "eye",
+              "field",
+              "value"
+            ]
+          },
+          "idempotent": true,
+          "description": "Set (or clear, with null) a single refraction cell — sphere / cylinder / axis / add / prism / base.",
+          "descriptionKey": "ui.agent.opticalPrescription.actions.setCell"
+        },
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: OpticalPrescriptionValue }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "value": {
+                "type": "object",
+                "properties": {
+                  "bands": {
+                    "type": "object",
+                    "description": "Refraction rows keyed by band (`far` / `intermediate` / `near`) then eye (`od` / `os`)."
+                  },
+                  "pd": {
+                    "type": "number",
+                    "description": "Interpupillary distance, mm."
+                  },
+                  "lensType": {
+                    "enum": [
+                      "single-vision",
+                      "bifocal",
+                      "progressive"
+                    ]
+                  },
+                  "axisSystem": {
+                    "enum": [
+                      "tabo",
+                      "int"
+                    ]
+                  },
+                  "notes": {
+                    "type": "string",
+                    "description": "Free-text note — PHI."
+                  }
+                },
+                "required": [
+                  "bands"
+                ]
+              }
+            },
+            "required": [
+              "value"
+            ]
+          },
+          "idempotent": true,
+          "description": "Replace the entire prescription value.",
+          "descriptionKey": "ui.agent.opticalPrescription.actions.setValue"
+        },
+        {
+          "name": "clear_band",
+          "safety": "destructive",
+          "argsType": "{ band: DistanceBand }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "band": {
+                "enum": [
+                  "far",
+                  "intermediate",
+                  "near"
+                ],
+                "description": "Distance band — `far` (per lontano), `intermediate`, `near` (per vicino)."
+              }
+            },
+            "required": [
+              "band"
+            ]
+          },
+          "idempotent": true,
+          "description": "Clear every refraction row in a distance band.",
+          "descriptionKey": "ui.agent.opticalPrescription.actions.clearBand"
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "optical-prescription"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "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."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "otp-input",
+      "capabilities": [
+        "set_value"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string",
+          "description": "Current digits entered, packed into a single string.",
+          "descriptionKey": "ui.agent.otpInput.state.value"
+        },
+        {
+          "name": "isComplete",
+          "type": "boolean",
+          "description": "Whether all required digits have been entered.",
+          "descriptionKey": "ui.agent.otpInput.state.isComplete"
         }
       ],
       "actions": [
@@ -11299,6 +11814,647 @@
         }
       ]
     },
+    {
+      "kind": "pattern",
+      "id": "care-plan-editor-aesthetic",
+      "composes": [
+        {
+          "component": "care-plan-header",
+          "as": "planHeader"
+        },
+        {
+          "component": "muscle-scheme",
+          "as": "bodyMap",
+          "entity": "region"
+        },
+        {
+          "component": "face-scheme",
+          "as": "faceMap",
+          "entity": "zone"
+        },
+        {
+          "component": "data-table",
+          "as": "treatmentsGrid",
+          "entity": "treatment"
+        },
+        {
+          "component": "control-room-rail",
+          "as": "toolRail"
+        },
+        {
+          "component": "entity-summary",
+          "as": "planSummary"
+        }
+      ],
+      "workflows": [
+        {
+          "name": "select_plan",
+          "safety": "read",
+          "description": "Open one of the patient's aesthetic-medicine care plans from the plan list.",
+          "descriptionKey": "ui.agent.aestheticCarePlanEditor.workflows.selectPlan",
+          "uiActions": [],
+          "apiActions": [
+            "carePlan.get"
+          ]
+        },
+        {
+          "name": "add_plan",
+          "safety": "write",
+          "description": "Create a new aesthetic-medicine care plan for the patient.",
+          "descriptionKey": "ui.agent.aestheticCarePlanEditor.workflows.addPlan",
+          "uiActions": [],
+          "apiActions": [
+            "carePlan.create"
+          ]
+        },
+        {
+          "name": "inspect_area",
+          "safety": "read",
+          "description": "Focus a body or face region on the anatomy anchor and read its charted treatment areas.",
+          "descriptionKey": "ui.agent.aestheticCarePlanEditor.workflows.inspectArea",
+          "uiActions": [
+            "muscle-scheme.focus_region",
+            "face-scheme.focus_zone"
+          ],
+          "stateReads": [
+            "muscle-scheme.chart",
+            "face-scheme.chart"
+          ],
+          "apiActions": []
+        },
+        {
+          "name": "mark_treatment_done",
+          "safety": "write",
+          "description": "Mark a planned treatment as executed from its row action in the treatments grid.",
+          "descriptionKey": "ui.agent.aestheticCarePlanEditor.workflows.markTreatmentDone",
+          "uiActions": [],
+          "stateReads": [
+            "data-table.selection"
+          ],
+          "apiActions": [
+            "carePlanTreatment.update"
+          ]
+        },
+        {
+          "name": "add_treatment",
+          "safety": "write",
+          "description": "Add a planned treatment row to the current care plan.",
+          "descriptionKey": "ui.agent.aestheticCarePlanEditor.workflows.addTreatment",
+          "uiActions": [],
+          "apiActions": [
+            "carePlanTreatment.create"
+          ]
+        },
+        {
+          "name": "remove_treatment",
+          "safety": "destructive",
+          "description": "Remove the selected treatment(s) from the plan (read data-table.selection for the targets).",
+          "descriptionKey": "ui.agent.aestheticCarePlanEditor.workflows.removeTreatment",
+          "uiActions": [],
+          "stateReads": [
+            "data-table.selection"
+          ],
+          "apiActions": [
+            "carePlanTreatment.delete"
+          ]
+        },
+        {
+          "name": "save_plan",
+          "safety": "write",
+          "description": "Persist the current edits to the aesthetic-medicine care plan.",
+          "descriptionKey": "ui.agent.aestheticCarePlanEditor.workflows.savePlan",
+          "uiActions": [],
+          "apiActions": [
+            "carePlan.update"
+          ]
+        },
+        {
+          "name": "regenerate_summary",
+          "safety": "write",
+          "description": "Regenerate the AI plan summary in the docked Plan summary tool.",
+          "descriptionKey": "ui.agent.aestheticCarePlanEditor.workflows.regenerateSummary",
+          "uiActions": [
+            "entity-summary.regenerate"
+          ],
+          "apiActions": [
+            "alia.summarise"
+          ]
+        }
+      ]
+    },
+    {
+      "kind": "pattern",
+      "id": "care-plan-editor-dermatology",
+      "composes": [
+        {
+          "component": "care-plan-header",
+          "as": "planHeader"
+        },
+        {
+          "component": "muscle-scheme",
+          "as": "bodyMap",
+          "entity": "region"
+        },
+        {
+          "component": "face-scheme",
+          "as": "faceMap",
+          "entity": "zone"
+        },
+        {
+          "component": "data-table",
+          "as": "treatmentsGrid",
+          "entity": "treatment"
+        },
+        {
+          "component": "control-room-rail",
+          "as": "toolRail"
+        },
+        {
+          "component": "entity-summary",
+          "as": "planSummary"
+        }
+      ],
+      "workflows": [
+        {
+          "name": "select_plan",
+          "safety": "read",
+          "description": "Open one of the patient's dermatology / skin-lesion care plans from the plan list.",
+          "descriptionKey": "ui.agent.dermatologyCarePlanEditor.workflows.selectPlan",
+          "uiActions": [],
+          "apiActions": [
+            "carePlan.get"
+          ]
+        },
+        {
+          "name": "add_plan",
+          "safety": "write",
+          "description": "Create a new dermatology / skin-lesion care plan for the patient.",
+          "descriptionKey": "ui.agent.dermatologyCarePlanEditor.workflows.addPlan",
+          "uiActions": [],
+          "apiActions": [
+            "carePlan.create"
+          ]
+        },
+        {
+          "name": "inspect_lesion",
+          "safety": "read",
+          "description": "Focus a body or face region on the skin-lesion anchor and read its charted lesions.",
+          "descriptionKey": "ui.agent.dermatologyCarePlanEditor.workflows.inspectLesion",
+          "uiActions": [
+            "muscle-scheme.focus_region",
+            "face-scheme.focus_zone"
+          ],
+          "stateReads": [
+            "muscle-scheme.chart",
+            "face-scheme.chart"
+          ],
+          "apiActions": []
+        },
+        {
+          "name": "mark_treatment_done",
+          "safety": "write",
+          "description": "Mark a planned procedure as executed from its row action in the treatments grid.",
+          "descriptionKey": "ui.agent.dermatologyCarePlanEditor.workflows.markTreatmentDone",
+          "uiActions": [],
+          "stateReads": [
+            "data-table.selection"
+          ],
+          "apiActions": [
+            "carePlanTreatment.update"
+          ]
+        },
+        {
+          "name": "add_treatment",
+          "safety": "write",
+          "description": "Add a planned procedure row to the current care plan.",
+          "descriptionKey": "ui.agent.dermatologyCarePlanEditor.workflows.addTreatment",
+          "uiActions": [],
+          "apiActions": [
+            "carePlanTreatment.create"
+          ]
+        },
+        {
+          "name": "remove_treatment",
+          "safety": "destructive",
+          "description": "Remove the selected procedure(s) from the plan (read data-table.selection for the targets).",
+          "descriptionKey": "ui.agent.dermatologyCarePlanEditor.workflows.removeTreatment",
+          "uiActions": [],
+          "stateReads": [
+            "data-table.selection"
+          ],
+          "apiActions": [
+            "carePlanTreatment.delete"
+          ]
+        },
+        {
+          "name": "save_plan",
+          "safety": "write",
+          "description": "Persist the current edits to the dermatology / skin-lesion care plan.",
+          "descriptionKey": "ui.agent.dermatologyCarePlanEditor.workflows.savePlan",
+          "uiActions": [],
+          "apiActions": [
+            "carePlan.update"
+          ]
+        },
+        {
+          "name": "regenerate_summary",
+          "safety": "write",
+          "description": "Regenerate the AI plan summary in the docked Plan summary tool.",
+          "descriptionKey": "ui.agent.dermatologyCarePlanEditor.workflows.regenerateSummary",
+          "uiActions": [
+            "entity-summary.regenerate"
+          ],
+          "apiActions": [
+            "alia.summarise"
+          ]
+        }
+      ]
+    },
+    {
+      "kind": "pattern",
+      "id": "care-plan-editor-ophthalmology",
+      "composes": [
+        {
+          "component": "care-plan-header",
+          "as": "planHeader"
+        },
+        {
+          "component": "optical-prescription",
+          "as": "prescription",
+          "entity": "eye"
+        },
+        {
+          "component": "data-table",
+          "as": "productsGrid",
+          "entity": "treatment"
+        },
+        {
+          "component": "control-room-rail",
+          "as": "toolRail"
+        },
+        {
+          "component": "entity-summary",
+          "as": "planSummary"
+        }
+      ],
+      "workflows": [
+        {
+          "name": "select_plan",
+          "safety": "read",
+          "description": "Open one of the patient's optical / glasses care plans from the plan list.",
+          "descriptionKey": "ui.agent.ophthalmologyCarePlanEditor.workflows.selectPlan",
+          "uiActions": [],
+          "apiActions": [
+            "carePlan.get"
+          ]
+        },
+        {
+          "name": "add_plan",
+          "safety": "write",
+          "description": "Create a new optical / glasses care plan for the patient.",
+          "descriptionKey": "ui.agent.ophthalmologyCarePlanEditor.workflows.addPlan",
+          "uiActions": [],
+          "apiActions": [
+            "carePlan.create"
+          ]
+        },
+        {
+          "name": "inspect_prescription",
+          "safety": "read",
+          "description": "Focus an eye's row on the glasses-prescription anchor and read its refraction (sphere / cylinder / axis / add) per distance band.",
+          "descriptionKey": "ui.agent.ophthalmologyCarePlanEditor.workflows.inspectPrescription",
+          "uiActions": [
+            "optical-prescription.focus_eye",
+            "optical-prescription.get_row"
+          ],
+          "stateReads": [
+            "optical-prescription.prescription",
+            "optical-prescription.bands"
+          ],
+          "apiActions": []
+        },
+        {
+          "name": "mark_product_done",
+          "safety": "write",
+          "description": "Mark a planned product as dispensed from its row action in the products grid.",
+          "descriptionKey": "ui.agent.ophthalmologyCarePlanEditor.workflows.markProductDone",
+          "uiActions": [],
+          "stateReads": [
+            "data-table.selection"
+          ],
+          "apiActions": [
+            "carePlanTreatment.update"
+          ]
+        },
+        {
+          "name": "add_product",
+          "safety": "write",
+          "description": "Add a product row (lens, frame, coating, …) to the plan.",
+          "descriptionKey": "ui.agent.ophthalmologyCarePlanEditor.workflows.addProduct",
+          "uiActions": [],
+          "apiActions": [
+            "carePlanTreatment.create"
+          ]
+        },
+        {
+          "name": "remove_product",
+          "safety": "destructive",
+          "description": "Remove the selected product(s) from the plan (read data-table.selection for the targets).",
+          "descriptionKey": "ui.agent.ophthalmologyCarePlanEditor.workflows.removeProduct",
+          "uiActions": [],
+          "stateReads": [
+            "data-table.selection"
+          ],
+          "apiActions": [
+            "carePlanTreatment.delete"
+          ]
+        },
+        {
+          "name": "save_plan",
+          "safety": "write",
+          "description": "Persist the current edits to the optical care plan.",
+          "descriptionKey": "ui.agent.ophthalmologyCarePlanEditor.workflows.savePlan",
+          "uiActions": [],
+          "apiActions": [
+            "carePlan.update"
+          ]
+        },
+        {
+          "name": "regenerate_summary",
+          "safety": "write",
+          "description": "Regenerate the AI plan summary in the docked Plan summary tool.",
+          "descriptionKey": "ui.agent.ophthalmologyCarePlanEditor.workflows.regenerateSummary",
+          "uiActions": [
+            "entity-summary.regenerate"
+          ],
+          "apiActions": [
+            "alia.summarise"
+          ]
+        }
+      ]
+    },
+    {
+      "kind": "pattern",
+      "id": "care-plan-editor-orthopedics",
+      "composes": [
+        {
+          "component": "care-plan-header",
+          "as": "planHeader"
+        },
+        {
+          "component": "muscle-scheme",
+          "as": "bodyMap",
+          "entity": "region"
+        },
+        {
+          "component": "data-table",
+          "as": "treatmentsGrid",
+          "entity": "treatment"
+        },
+        {
+          "component": "control-room-rail",
+          "as": "toolRail"
+        },
+        {
+          "component": "entity-summary",
+          "as": "planSummary"
+        }
+      ],
+      "workflows": [
+        {
+          "name": "select_plan",
+          "safety": "read",
+          "description": "Open one of the patient's orthopaedic / musculoskeletal care plans from the plan list.",
+          "descriptionKey": "ui.agent.orthopedicsCarePlanEditor.workflows.selectPlan",
+          "uiActions": [],
+          "apiActions": [
+            "carePlan.get"
+          ]
+        },
+        {
+          "name": "add_plan",
+          "safety": "write",
+          "description": "Create a new orthopaedic / musculoskeletal care plan for the patient.",
+          "descriptionKey": "ui.agent.orthopedicsCarePlanEditor.workflows.addPlan",
+          "uiActions": [],
+          "apiActions": [
+            "carePlan.create"
+          ]
+        },
+        {
+          "name": "inspect_injury",
+          "safety": "read",
+          "description": "Focus a body region on the fracture / joint anchor and read its charted injury sites.",
+          "descriptionKey": "ui.agent.orthopedicsCarePlanEditor.workflows.inspectInjury",
+          "uiActions": [
+            "muscle-scheme.focus_region"
+          ],
+          "stateReads": [
+            "muscle-scheme.chart"
+          ],
+          "apiActions": []
+        },
+        {
+          "name": "mark_treatment_done",
+          "safety": "write",
+          "description": "Mark a planned procedure as executed from its row action in the treatments grid.",
+          "descriptionKey": "ui.agent.orthopedicsCarePlanEditor.workflows.markTreatmentDone",
+          "uiActions": [],
+          "stateReads": [
+            "data-table.selection"
+          ],
+          "apiActions": [
+            "carePlanTreatment.update"
+          ]
+        },
+        {
+          "name": "add_treatment",
+          "safety": "write",
+          "description": "Add a planned procedure row to the current care plan.",
+          "descriptionKey": "ui.agent.orthopedicsCarePlanEditor.workflows.addTreatment",
+          "uiActions": [],
+          "apiActions": [
+            "carePlanTreatment.create"
+          ]
+        },
+        {
+          "name": "remove_treatment",
+          "safety": "destructive",
+          "description": "Remove the selected procedure(s) from the plan (read data-table.selection for the targets).",
+          "descriptionKey": "ui.agent.orthopedicsCarePlanEditor.workflows.removeTreatment",
+          "uiActions": [],
+          "stateReads": [
+            "data-table.selection"
+          ],
+          "apiActions": [
+            "carePlanTreatment.delete"
+          ]
+        },
+        {
+          "name": "save_plan",
+          "safety": "write",
+          "description": "Persist the current edits to the orthopaedic / musculoskeletal care plan.",
+          "descriptionKey": "ui.agent.orthopedicsCarePlanEditor.workflows.savePlan",
+          "uiActions": [],
+          "apiActions": [
+            "carePlan.update"
+          ]
+        },
+        {
+          "name": "regenerate_summary",
+          "safety": "write",
+          "description": "Regenerate the AI plan summary in the docked Plan summary tool.",
+          "descriptionKey": "ui.agent.orthopedicsCarePlanEditor.workflows.regenerateSummary",
+          "uiActions": [
+            "entity-summary.regenerate"
+          ],
+          "apiActions": [
+            "alia.summarise"
+          ]
+        }
+      ]
+    },
+    {
+      "kind": "pattern",
+      "id": "care-plan-editor-physio",
+      "composes": [
+        {
+          "component": "care-plan-header",
+          "as": "planHeader"
+        },
+        {
+          "component": "data-table",
+          "as": "treatmentsGrid",
+          "entity": "treatment"
+        },
+        {
+          "component": "control-room-rail",
+          "as": "toolRail"
+        },
+        {
+          "component": "notes-panel",
+          "as": "planNotes",
+          "entity": "note"
+        },
+        {
+          "component": "tasks-panel",
+          "as": "planTasks",
+          "entity": "task"
+        },
+        {
+          "component": "entity-summary",
+          "as": "planSummary"
+        }
+      ],
+      "workflows": [
+        {
+          "name": "select_plan",
+          "safety": "read",
+          "description": "Open one of the patient's physiotherapy care plans from the plan list.",
+          "descriptionKey": "ui.agent.physioCarePlanEditor.workflows.selectPlan",
+          "uiActions": [],
+          "apiActions": [
+            "carePlan.get"
+          ]
+        },
+        {
+          "name": "add_plan",
+          "safety": "write",
+          "description": "Create a new physiotherapy care plan for the patient.",
+          "descriptionKey": "ui.agent.physioCarePlanEditor.workflows.addPlan",
+          "uiActions": [],
+          "apiActions": [
+            "carePlan.create"
+          ]
+        },
+        {
+          "name": "mark_session_done",
+          "safety": "write",
+          "description": "Mark a planned session as executed from its row action in the sessions grid.",
+          "descriptionKey": "ui.agent.physioCarePlanEditor.workflows.markSessionDone",
+          "uiActions": [],
+          "stateReads": [
+            "data-table.selection"
+          ],
+          "apiActions": [
+            "carePlanTreatment.update"
+          ]
+        },
+        {
+          "name": "add_session",
+          "safety": "write",
+          "description": "Add a planned session row to the current care plan.",
+          "descriptionKey": "ui.agent.physioCarePlanEditor.workflows.addSession",
+          "uiActions": [],
+          "apiActions": [
+            "carePlanTreatment.create"
+          ]
+        },
+        {
+          "name": "remove_session",
+          "safety": "destructive",
+          "description": "Remove the selected session(s) from the plan (read data-table.selection for the targets).",
+          "descriptionKey": "ui.agent.physioCarePlanEditor.workflows.removeSession",
+          "uiActions": [],
+          "stateReads": [
+            "data-table.selection"
+          ],
+          "apiActions": [
+            "carePlanTreatment.delete"
+          ]
+        },
+        {
+          "name": "save_plan",
+          "safety": "write",
+          "description": "Persist the current edits to the physiotherapy care plan.",
+          "descriptionKey": "ui.agent.physioCarePlanEditor.workflows.savePlan",
+          "uiActions": [],
+          "apiActions": [
+            "carePlan.update"
+          ]
+        },
+        {
+          "name": "add_plan_note",
+          "safety": "phi",
+          "description": "Add a note to the plan via the docked Notes tool. A clinical note requires the clinical-note permission.",
+          "descriptionKey": "ui.agent.physioCarePlanEditor.workflows.addPlanNote",
+          "uiActions": [
+            "notes-panel.add_note"
+          ],
+          "apiActions": [
+            "note.create"
+          ]
+        },
+        {
+          "name": "triage_plan_tasks",
+          "safety": "write",
+          "description": "Open or complete a follow-up task from the docked Tasks tool.",
+          "descriptionKey": "ui.agent.physioCarePlanEditor.workflows.triagePlanTasks",
+          "uiActions": [
+            "tasks-panel.select_item",
+            "tasks-panel.toggle_done"
+          ],
+          "stateReads": [
+            "tasks-panel.items"
+          ],
+          "apiActions": [
+            "task.update"
+          ]
+        },
+        {
+          "name": "regenerate_summary",
+          "safety": "write",
+          "description": "Regenerate the AI plan summary in the docked Plan summary tool.",
+          "descriptionKey": "ui.agent.physioCarePlanEditor.workflows.regenerateSummary",
+          "uiActions": [
+            "entity-summary.regenerate"
+          ],
+          "apiActions": [
+            "alia.summarise"
+          ]
+        }
+      ]
+    },
     {
       "kind": "pattern",
       "id": "care-plans",