@alfadocs/ui-kit 0.69.0 → 0.70.0

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "0.69.0",
+  "packageVersion": "0.70.0",
   "components": [
     {
       "kind": "component",
@@ -532,6 +532,247 @@
         }
       }
     },
+    {
+      "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",
@@ -567,6 +808,66 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "appointment-timeline",
+      "capabilities": [
+        "scroll",
+        "pick"
+      ],
+      "state": [
+        {
+          "name": "items",
+          "type": "Array<{ id: string; state: string }>",
+          "description": "Currently-rendered appointments. Ids + lifecycle state only — never patient identity.",
+          "descriptionKey": "ui.agent.appointmentTimeline.state.items"
+        }
+      ],
+      "actions": [
+        {
+          "name": "select_item",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "id"
+            ]
+          },
+          "idempotent": true,
+          "description": "Activate the appointment with the given id.",
+          "descriptionKey": "ui.agent.appointmentTimeline.actions.selectItem"
+        },
+        {
+          "name": "jump_to_today",
+          "safety": "read",
+          "idempotent": true,
+          "description": "Re-anchor the timeline scroll on today's appointments.",
+          "descriptionKey": "ui.agent.appointmentTimeline.actions.jumpToToday"
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "appointment-timeline",
+          "description": "Marks the AppointmentTimeline wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop. Required to address a specific timeline from the agent."
+        },
+        "item": {
+          "attr": "data-appointment-id",
+          "description": "Stable appointment id emitted on each rendered AppointmentCard inside the timeline."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "appointment-tray",
@@ -1565,6 +1866,38 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "care-plan-header",
+      "capabilities": [],
+      "state": [
+        {
+          "name": "state",
+          "type": "'estimate' | 'accepted' | 'discarded' | 'closed'",
+          "description": "The plan lifecycle state. Enum value only — never the localised label or any PHI.",
+          "descriptionKey": "ui.agent.carePlanHeader.state.state"
+        },
+        {
+          "name": "alertCount",
+          "type": "number",
+          "description": "How many attention alerts (e.g. missing signature) are showing. Count only — never the alert labels.",
+          "descriptionKey": "ui.agent.carePlanHeader.state.alertCount"
+        }
+      ],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "care-plan-header",
+          "description": "Marks the CarePlanHeader root region."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop. Addresses a specific plan header."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "carousel",
@@ -4902,29 +5235,162 @@
     },
     {
       "kind": "component",
-      "id": "patient-search",
+      "id": "patient-details",
       "capabilities": [
-        "filter"
+        "view_change",
+        "set_value"
       ],
       "state": [
         {
-          "name": "variant",
-          "type": "string",
-          "description": "Active variant — one of `who-where`, `who-where-when`, `faceted`, `discovery`.",
-          "descriptionKey": "ui.agent.patientSearch.state.variant"
+          "name": "visibleFieldOrder",
+          "type": "string[]",
+          "description": "Ordered list of visible field KEYS (e.g. \"fiscalCode\"). Never a field value.",
+          "descriptionKey": "ui.agent.patientDetails.state.visibleFieldOrder"
+        },
+        {
+          "name": "patientId",
+          "type": "string | undefined",
+          "description": "Opaque patient id the panel is bound to. No patient-identifiable data.",
+          "descriptionKey": "ui.agent.patientDetails.state.patientId"
         }
       ],
       "actions": [
         {
-          "name": "reset",
+          "name": "set_visible_fields",
           "safety": "write",
+          "argsType": "{ fieldIds: string[] }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "fieldIds": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "required": [
+              "fieldIds"
+            ]
+          },
           "idempotent": true,
-          "description": "Clear the current search query (WHO, WHERE, WHEN, facets, geo) via the consumer-owned onChange.",
-          "descriptionKey": "ui.agent.patientSearch.actions.reset"
-        },
-        {
-          "name": "focus_primary",
-          "safety": "read",
+          "examples": [
+            {
+              "args": {
+                "fieldIds": [
+                  "lastName",
+                  "firstName",
+                  "phone",
+                  "email"
+                ]
+              },
+              "note": "Show only name + contact fields."
+            }
+          ],
+          "description": "Set which fields are visible (and their order). Unknown ids are ignored.",
+          "descriptionKey": "ui.agent.patientDetails.actions.setVisibleFields"
+        },
+        {
+          "name": "set_field_order",
+          "safety": "write",
+          "argsType": "{ orderedIds: string[] }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "orderedIds": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "required": [
+              "orderedIds"
+            ]
+          },
+          "idempotent": true,
+          "description": "Reorder the visible fields. Order within a section is honoured; sections stay fixed.",
+          "descriptionKey": "ui.agent.patientDetails.actions.setFieldOrder"
+        },
+        {
+          "name": "update_field",
+          "safety": "phi",
+          "argsType": "{ fieldId: string; value: unknown }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "fieldId": {
+                "type": "string"
+              },
+              "value": {}
+            },
+            "required": [
+              "fieldId",
+              "value"
+            ]
+          },
+          "idempotent": true,
+          "openWorld": true,
+          "errors": [
+            "no-save-handler",
+            "validation-failed",
+            "permission-denied"
+          ],
+          "examples": [
+            {
+              "args": {
+                "fieldId": "job",
+                "value": "Architect"
+              },
+              "note": "Update the patient’s occupation."
+            }
+          ],
+          "description": "Write a patient field value via the consumer's audited save path. Subject to the same permissions and validation as a human edit.",
+          "descriptionKey": "ui.agent.patientDetails.actions.updateField"
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "patient-details",
+          "description": "Marks the PatientDetails root region."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop. Addresses a specific panel."
+        },
+        "item": {
+          "attr": "data-field-id",
+          "description": "Stable field KEY on each row. Never the field value (no PHI in the DOM hook)."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "patient-search",
+      "capabilities": [
+        "filter"
+      ],
+      "state": [
+        {
+          "name": "variant",
+          "type": "string",
+          "description": "Active variant — one of `who-where`, `who-where-when`, `faceted`, `discovery`.",
+          "descriptionKey": "ui.agent.patientSearch.state.variant"
+        }
+      ],
+      "actions": [
+        {
+          "name": "reset",
+          "safety": "write",
+          "idempotent": true,
+          "description": "Clear the current search query (WHO, WHERE, WHEN, facets, geo) via the consumer-owned onChange.",
+          "descriptionKey": "ui.agent.patientSearch.actions.reset"
+        },
+        {
+          "name": "focus_primary",
+          "safety": "read",
           "idempotent": true,
           "description": "Move keyboard focus to the most-relevant search field for the current variant.",
           "descriptionKey": "ui.agent.patientSearch.actions.focusPrimary"
@@ -5827,6 +6293,65 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "radiograph-panel",
+      "capabilities": [
+        "pick",
+        "view_change"
+      ],
+      "state": [
+        {
+          "name": "radiographs",
+          "type": "Array<{ id: string; kind?: string }>",
+          "description": "Structural references (id + kind) to the films shown for the selected tooth.",
+          "descriptionKey": "ui.agent.radiographPanel.state.radiographs"
+        }
+      ],
+      "actions": [
+        {
+          "name": "view_radiograph",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "id"
+            ]
+          },
+          "idempotent": true,
+          "description": "Open a film in the fullscreen viewer by id.",
+          "descriptionKey": "ui.agent.radiographPanel.actions.viewRadiograph"
+        },
+        {
+          "name": "close_viewer",
+          "safety": "read",
+          "idempotent": true,
+          "description": "Close the fullscreen radiograph viewer.",
+          "descriptionKey": "ui.agent.radiographPanel.actions.closeViewer"
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "radiograph-panel"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-radiograph-id",
+          "description": "Each film row (`<li>`) carries its radiograph id as `data-radiograph-id`. The panel root additionally carries the selected tooth's FDI id as `data-tooth`."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "rating",
@@ -7892,14 +8417,26 @@
         {
           "name": "chart",
           "type": "object",
-          "description": "Current dental chart — findings (and marked surfaces) keyed by FDI id.",
+          "description": "Current dental chart — findings (and marked surfaces) keyed by FDI id, or by a special-element id (quadrant / sextant / arch / general) for region-spanning findings.",
           "descriptionKey": "ui.agent.toothScheme.state.chart"
         },
         {
           "name": "chartedTeeth",
           "type": "string[]",
-          "description": "FDI ids of every tooth carrying at least one finding.",
+          "description": "Ids carrying at least one finding — FDI tooth ids and/or special-element ids (quadrant / sextant / arch / general).",
           "descriptionKey": "ui.agent.toothScheme.state.chartedTeeth"
+        },
+        {
+          "name": "radiographs",
+          "type": "Record<string, { id: string; kind?: string }[]>",
+          "description": "Structural references (id + kind) to the radiographs on each tooth, keyed by FDI id. Notes, dates and image URLs are not exposed here — fetch them on demand via get_radiographs.",
+          "descriptionKey": "ui.agent.toothScheme.state.radiographs"
+        },
+        {
+          "name": "teethWithRadiographs",
+          "type": "string[]",
+          "description": "FDI ids of every tooth carrying at least one radiograph.",
+          "descriptionKey": "ui.agent.toothScheme.state.teethWithRadiographs"
         }
       ],
       "actions": [
@@ -7912,7 +8449,7 @@
             "properties": {
               "id": {
                 "type": "string",
-                "description": "FDI tooth id, e.g. '11'–'48' permanent, '51'–'85' primary."
+                "description": "FDI tooth id ('11'–'48' permanent, '51'–'85' primary) or a special-element id ('Q1'–'Q4' quadrants, 'S1'–'S6' sextants, 'AS'/'AI' arches, 'general'; primary mirrors with an 'm' prefix)."
               }
             },
             "required": [
@@ -7932,7 +8469,7 @@
             "properties": {
               "id": {
                 "type": "string",
-                "description": "FDI tooth id, e.g. '11'–'48' permanent, '51'–'85' primary."
+                "description": "FDI tooth id ('11'–'48' permanent, '51'–'85' primary) or a special-element id ('Q1'–'Q4' quadrants, 'S1'–'S6' sextants, 'AS'/'AI' arches, 'general'; primary mirrors with an 'm' prefix)."
               }
             },
             "required": [
@@ -7994,13 +8531,93 @@
             "type": "array",
             "items": {
               "type": "string",
-              "description": "FDI tooth id, e.g. '11'–'48' permanent, '51'–'85' primary."
+              "description": "FDI tooth id ('11'–'48' permanent, '51'–'85' primary) or a special-element id ('Q1'–'Q4' quadrants, 'S1'–'S6' sextants, 'AS'/'AI' arches, 'general'; primary mirrors with an 'm' prefix)."
             }
           },
           "idempotent": true,
-          "description": "List the FDI ids of every tooth carrying a given finding (e.g. all teeth with caries).",
+          "description": "List the ids carrying a given finding — FDI tooth ids and/or special-element ids (e.g. all teeth with caries).",
           "descriptionKey": "ui.agent.toothScheme.actions.teethWith"
         },
+        {
+          "name": "get_radiographs",
+          "safety": "read",
+          "argsType": "{ id: FdiId }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "FDI tooth id ('11'–'48' permanent, '51'–'85' primary) or a special-element id ('Q1'–'Q4' quadrants, 'S1'–'S6' sextants, 'AS'/'AI' arches, 'general'; primary mirrors with an 'm' prefix)."
+              }
+            },
+            "required": [
+              "id"
+            ]
+          },
+          "returns": "Radiograph[]",
+          "returnsSchema": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "url": {
+                  "type": "string"
+                },
+                "thumbnailUrl": {
+                  "type": "string"
+                },
+                "date": {
+                  "type": "string",
+                  "description": "ISO acquisition date (YYYY-MM-DD)."
+                },
+                "note": {
+                  "type": "string"
+                },
+                "kind": {
+                  "enum": [
+                    "periapical",
+                    "bitewing",
+                    "panoramic",
+                    "other"
+                  ]
+                },
+                "alt": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id",
+                "url"
+              ]
+            }
+          },
+          "idempotent": true,
+          "description": "Read the radiographs (x-rays) attached to one tooth.",
+          "descriptionKey": "ui.agent.toothScheme.actions.getRadiographs"
+        },
+        {
+          "name": "open_radiographs",
+          "safety": "read",
+          "argsType": "{ id: FdiId }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "FDI tooth id ('11'–'48' permanent, '51'–'85' primary) or a special-element id ('Q1'–'Q4' quadrants, 'S1'–'S6' sextants, 'AS'/'AI' arches, 'general'; primary mirrors with an 'm' prefix)."
+              }
+            },
+            "required": [
+              "id"
+            ]
+          },
+          "idempotent": true,
+          "description": "Focus a tooth and open its radiograph archive (fires the host's onOpenRadiographs).",
+          "descriptionKey": "ui.agent.toothScheme.actions.openRadiographs"
+        },
         {
           "name": "set_finding",
           "safety": "write",
@@ -8010,7 +8627,7 @@
             "properties": {
               "id": {
                 "type": "string",
-                "description": "FDI tooth id, e.g. '11'–'48' permanent, '51'–'85' primary."
+                "description": "FDI tooth id ('11'–'48' permanent, '51'–'85' primary) or a special-element id ('Q1'–'Q4' quadrants, 'S1'–'S6' sextants, 'AS'/'AI' arches, 'general'; primary mirrors with an 'm' prefix)."
               },
               "condition": {
                 "enum": [
@@ -8046,7 +8663,7 @@
             ]
           },
           "idempotent": true,
-          "description": "Record a finding on a tooth (crown, implant, root canal, caries, …). Optionally mark the affected surfaces for a surface finding.",
+          "description": "Record a finding on a tooth or region element (crown, implant, root canal, caries, …). Optionally mark the affected surfaces for a surface finding.",
           "descriptionKey": "ui.agent.toothScheme.actions.setFinding"
         },
         {
@@ -8058,7 +8675,7 @@
             "properties": {
               "id": {
                 "type": "string",
-                "description": "FDI tooth id, e.g. '11'–'48' permanent, '51'–'85' primary."
+                "description": "FDI tooth id ('11'–'48' permanent, '51'–'85' primary) or a special-element id ('Q1'–'Q4' quadrants, 'S1'–'S6' sextants, 'AS'/'AI' arches, 'general'; primary mirrors with an 'm' prefix)."
               },
               "condition": {
                 "enum": [
@@ -8094,7 +8711,7 @@
             "properties": {
               "id": {
                 "type": "string",
-                "description": "FDI tooth id, e.g. '11'–'48' permanent, '51'–'85' primary."
+                "description": "FDI tooth id ('11'–'48' permanent, '51'–'85' primary) or a special-element id ('Q1'–'Q4' quadrants, 'S1'–'S6' sextants, 'AS'/'AI' arches, 'general'; primary mirrors with an 'm' prefix)."
               }
             },
             "required": [
@@ -8118,7 +8735,7 @@
         },
         "item": {
           "attr": "data-fdi",
-          "description": "Each rendered tooth `<g>` carries its FDI id as `data-fdi`. The `data-projection` attribute on the root exposes the side/plan view."
+          "description": "Each rendered tooth `<g>` carries its FDI id as `data-fdi`; selectable special-element slots carry their id there too (plus `data-special` naming the kind). The `data-projection` / `data-view-mode` attributes on the root expose the side/plan/both view."
         }
       }
     },
@@ -9037,10 +9654,6 @@
           "as": "register",
           "entity": "carePlan"
         },
-        {
-          "component": "select",
-          "as": "periodFilter"
-        },
         {
           "component": "button",
           "as": "newPlan"
@@ -9053,10 +9666,6 @@
           "component": "icon-button-group",
           "as": "rowActions"
         },
-        {
-          "component": "tag",
-          "as": "planStatus"
-        },
         {
           "component": "transaction-chip",
           "as": "invoiceChip"
@@ -9067,27 +9676,15 @@
         },
         {
           "component": "counter",
-          "as": "totalsFooter"
+          "as": "planRollupCount"
         },
         {
           "component": "card",
-          "as": "planDetail"
-        },
-        {
-          "component": "description-list",
-          "as": "planSummary"
-        },
-        {
-          "component": "tooth-scheme",
-          "as": "odontogram"
+          "as": "gridCard"
         },
         {
           "component": "warning-stack",
           "as": "planWarnings"
-        },
-        {
-          "component": "badge",
-          "as": "rollupCount"
         }
       ],
       "workflows": [
@@ -9108,14 +9705,12 @@
         {
           "name": "filter_by_period",
           "safety": "read",
-          "description": "Choose a period preset (e.g. this month, this year) and filter the register to it.",
+          "description": "Filter the register to a created/scheduled date range via the per-column date filters.",
           "descriptionKey": "ui.agent.carePlans.workflows.filterByPeriod",
           "uiActions": [
-            "select.set_value",
             "data-table.apply_filter"
           ],
           "stateReads": [
-            "select.value",
             "data-table.filter"
           ],
           "apiActions": []
@@ -9687,41 +10282,182 @@
     },
     {
       "kind": "pattern",
-      "id": "marketplace-app-shell",
+      "id": "invoices",
       "composes": [
         {
-          "component": "app-frame",
-          "as": "frame"
+          "component": "data-table",
+          "as": "ledger",
+          "entity": "invoice"
         },
         {
-          "component": "header",
-          "as": "topBar"
+          "component": "icon-button-group",
+          "as": "tableActions"
         },
         {
-          "component": "sidebar",
-          "as": "mainNav",
-          "entity": "navItem"
+          "component": "icon-button",
+          "as": "tableAction"
         },
         {
-          "component": "tab-bar",
-          "as": "embeddedNav",
-          "entity": "navItem"
+          "component": "badge",
+          "as": "statusBadge"
         },
         {
-          "component": "avatar",
-          "as": "accountAvatar"
-        },
+          "component": "button",
+          "as": "rowAction"
+        }
+      ],
+      "workflows": [
         {
-          "component": "dropdown-menu",
-          "as": "accountMenu"
+          "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"
+          ]
         },
         {
-          "component": "header-settings",
-          "as": "settings"
+          "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": []
         },
         {
-          "component": "sign-in-with-alfadocs-button",
-          "as": "connectCta"
+          "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",
@@ -10547,8 +11283,8 @@
           "as": "bulkAction"
         },
         {
-          "component": "select",
-          "as": "viewSwitcher"
+          "component": "icon-button-group",
+          "as": "tableActions"
         }
       ],
       "workflows": [
@@ -10626,21 +11362,14 @@
           ]
         },
         {
-          "name": "apply_view",
+          "name": "export_roster",
           "safety": "read",
-          "description": "Choose a saved view from the switcher to apply its filter and sort (and saved column layout) to the roster.",
-          "descriptionKey": "ui.agent.patients.workflows.applyView",
-          "uiActions": [
-            "select.set_value",
-            "data-table.apply_filter",
-            "data-table.sort_by"
-          ],
-          "stateReads": [
-            "select.value",
-            "data-table.filter",
-            "data-table.sort"
-          ],
-          "apiActions": []
+          "description": "Export the current (optionally filtered) patient roster from the page-header table-tools cluster — CSV / Excel / PDF.",
+          "descriptionKey": "ui.agent.patients.workflows.exportRoster",
+          "uiActions": [],
+          "apiActions": [
+            "patient.export"
+          ]
         }
       ]
     },
@@ -11065,6 +11794,147 @@
         }
       ]
     },
+    {
+      "kind": "pattern",
+      "id": "services",
+      "composes": [
+        {
+          "component": "data-table",
+          "as": "catalogue",
+          "entity": "service"
+        },
+        {
+          "component": "card",
+          "as": "gridShell"
+        },
+        {
+          "component": "icon-button-group",
+          "as": "tableActions"
+        },
+        {
+          "component": "icon-button",
+          "as": "tableAction"
+        },
+        {
+          "component": "switch",
+          "as": "compactActionsToggle"
+        }
+      ],
+      "workflows": [
+        {
+          "name": "filter_services",
+          "safety": "read",
+          "description": "Narrow the catalogue by name, code, category, VAT rate or active status using the per-column filters.",
+          "descriptionKey": "ui.agent.services.workflows.filterServices",
+          "uiActions": [
+            "data-table.apply_filter"
+          ],
+          "stateReads": [
+            "data-table.filter"
+          ],
+          "apiActions": [
+            "service.list"
+          ]
+        },
+        {
+          "name": "sort_catalogue",
+          "safety": "read",
+          "description": "Re-sort the catalogue by any column (e.g. price, duration, active).",
+          "descriptionKey": "ui.agent.services.workflows.sortCatalogue",
+          "uiActions": [
+            "data-table.sort_by"
+          ],
+          "stateReads": [
+            "data-table.sort"
+          ],
+          "apiActions": []
+        },
+        {
+          "name": "compact_actions",
+          "safety": "read",
+          "description": "Toggle the ColumnToggle settings-footer switch to compact the per-row action column.",
+          "descriptionKey": "ui.agent.services.workflows.compactActions",
+          "uiActions": [
+            "switch.set_checked"
+          ],
+          "stateReads": [
+            "switch.checked"
+          ],
+          "apiActions": []
+        },
+        {
+          "name": "toggle_active",
+          "safety": "write",
+          "description": "Flip a service’s availability via its per-row Active toggle so it is offered (or withdrawn) on new plans.",
+          "descriptionKey": "ui.agent.services.workflows.toggleActive",
+          "uiActions": [
+            "data-table.get_selection"
+          ],
+          "stateReads": [
+            "data-table.selection"
+          ],
+          "apiActions": [
+            "service.setActive"
+          ]
+        },
+        {
+          "name": "export_catalogue",
+          "safety": "read",
+          "description": "Export the current (optionally filtered) catalogue from the page-header table-tools cluster — CSV / Excel / PDF.",
+          "descriptionKey": "ui.agent.services.workflows.exportCatalogue",
+          "uiActions": [],
+          "apiActions": [
+            "service.export"
+          ]
+        },
+        {
+          "name": "edit_service",
+          "safety": "write",
+          "description": "Edit the selected service (e.g. price, duration, VAT) from its row action.",
+          "descriptionKey": "ui.agent.services.workflows.editService",
+          "uiActions": [
+            "data-table.get_selection"
+          ],
+          "stateReads": [
+            "data-table.selection"
+          ],
+          "apiActions": [
+            "service.update"
+          ]
+        },
+        {
+          "name": "duplicate_service",
+          "safety": "write",
+          "description": "Duplicate the selected service into a new editable copy from its row action.",
+          "descriptionKey": "ui.agent.services.workflows.duplicateService",
+          "uiActions": [
+            "data-table.get_selection"
+          ],
+          "stateReads": [
+            "data-table.selection"
+          ],
+          "apiActions": [
+            "service.duplicate"
+          ]
+        },
+        {
+          "name": "delete_service",
+          "safety": "destructive",
+          "description": "Delete the selected service from its row action. A service in use on a plan cannot be deleted. Irreversible.",
+          "descriptionKey": "ui.agent.services.workflows.deleteService",
+          "uiActions": [
+            "data-table.get_selection",
+            "data-table.clear_selection"
+          ],
+          "stateReads": [
+            "data-table.selection"
+          ],
+          "apiActions": [
+            "service.delete"
+          ]
+        }
+      ]
+    },
     {
       "kind": "pattern",
       "id": "settings",
@@ -11466,6 +12336,153 @@
         }
       ]
     },
+    {
+      "kind": "pattern",
+      "id": "tasks",
+      "composes": [
+        {
+          "component": "data-table",
+          "as": "roster",
+          "entity": "task"
+        },
+        {
+          "component": "warning-stack",
+          "as": "notices"
+        },
+        {
+          "component": "switch",
+          "as": "doneToggle"
+        },
+        {
+          "component": "button",
+          "as": "noticeAction"
+        },
+        {
+          "component": "icon-button-group",
+          "as": "tableActions"
+        },
+        {
+          "component": "icon-button",
+          "as": "tableAction"
+        },
+        {
+          "component": "smart-date",
+          "as": "dueDate"
+        }
+      ],
+      "workflows": [
+        {
+          "name": "filter_tasks",
+          "safety": "read",
+          "description": "Narrow the roster by title, type, assignee, due range or status using the per-column filters.",
+          "descriptionKey": "ui.agent.tasks.workflows.filterTasks",
+          "uiActions": [
+            "data-table.apply_filter"
+          ],
+          "stateReads": [
+            "data-table.filter"
+          ],
+          "apiActions": [
+            "task.list"
+          ]
+        },
+        {
+          "name": "filter_from_notice",
+          "safety": "read",
+          "description": "Apply a WarningStack notice’s \"View\" action (e.g. \"View overdue\", \"View collections\") to narrow the roster to the flagged tasks.",
+          "descriptionKey": "ui.agent.tasks.workflows.filterFromNotice",
+          "uiActions": [
+            "data-table.apply_filter"
+          ],
+          "stateReads": [
+            "data-table.filter"
+          ],
+          "apiActions": []
+        },
+        {
+          "name": "sort_roster",
+          "safety": "read",
+          "description": "Re-sort the roster by any column (e.g. soonest due first, created date).",
+          "descriptionKey": "ui.agent.tasks.workflows.sortRoster",
+          "uiActions": [
+            "data-table.sort_by"
+          ],
+          "stateReads": [
+            "data-table.sort"
+          ],
+          "apiActions": []
+        },
+        {
+          "name": "toggle_done",
+          "safety": "write",
+          "description": "Mark a task as done (or reopen it) via its per-row done toggle.",
+          "descriptionKey": "ui.agent.tasks.workflows.toggleDone",
+          "uiActions": [
+            "switch.set_checked"
+          ],
+          "stateReads": [
+            "switch.checked"
+          ],
+          "apiActions": [
+            "task.setDone"
+          ]
+        },
+        {
+          "name": "compact_actions",
+          "safety": "read",
+          "description": "Toggle the ColumnToggle settings-footer switch to compact the per-row action column.",
+          "descriptionKey": "ui.agent.tasks.workflows.compactActions",
+          "uiActions": [
+            "switch.set_checked"
+          ],
+          "stateReads": [
+            "switch.checked"
+          ],
+          "apiActions": []
+        },
+        {
+          "name": "export_roster",
+          "safety": "read",
+          "description": "Export the current (optionally filtered) roster from the page-header table-tools cluster — CSV / Excel / PDF.",
+          "descriptionKey": "ui.agent.tasks.workflows.exportRoster",
+          "uiActions": [],
+          "apiActions": [
+            "task.export"
+          ]
+        },
+        {
+          "name": "edit_task",
+          "safety": "write",
+          "description": "Edit the selected task from its row action.",
+          "descriptionKey": "ui.agent.tasks.workflows.editTask",
+          "uiActions": [
+            "data-table.get_selection"
+          ],
+          "stateReads": [
+            "data-table.selection"
+          ],
+          "apiActions": [
+            "task.update"
+          ]
+        },
+        {
+          "name": "delete_task",
+          "safety": "destructive",
+          "description": "Delete the selected task from its row action. Completed tasks cannot be deleted. Irreversible.",
+          "descriptionKey": "ui.agent.tasks.workflows.deleteTask",
+          "uiActions": [
+            "data-table.get_selection",
+            "data-table.clear_selection"
+          ],
+          "stateReads": [
+            "data-table.selection"
+          ],
+          "apiActions": [
+            "task.delete"
+          ]
+        }
+      ]
+    },
     {
       "kind": "pattern",
       "id": "two-factor-login",
@@ -11636,6 +12653,156 @@
           ]
         }
       ]
+    },
+    {
+      "kind": "pattern",
+      "id": "warehouse",
+      "composes": [
+        {
+          "component": "data-table",
+          "as": "inventory",
+          "entity": "inventoryItem"
+        },
+        {
+          "component": "icon-button-group",
+          "as": "tableActions"
+        },
+        {
+          "component": "icon-button",
+          "as": "tableAction"
+        },
+        {
+          "component": "badge",
+          "as": "statusBadge"
+        },
+        {
+          "component": "switch",
+          "as": "compactActionsToggle"
+        },
+        {
+          "component": "dialog",
+          "as": "importDialog"
+        },
+        {
+          "component": "file-upload",
+          "as": "xmlUpload"
+        }
+      ],
+      "workflows": [
+        {
+          "name": "filter_inventory",
+          "safety": "read",
+          "description": "Narrow the inventory by product, SKU, category, supplier or stock status using the per-column filters.",
+          "descriptionKey": "ui.agent.warehouse.workflows.filterInventory",
+          "uiActions": [
+            "data-table.apply_filter"
+          ],
+          "stateReads": [
+            "data-table.filter"
+          ],
+          "apiActions": [
+            "inventory.list"
+          ]
+        },
+        {
+          "name": "sort_inventory",
+          "safety": "read",
+          "description": "Re-sort the inventory by any column (e.g. in-stock, total value, last restocked).",
+          "descriptionKey": "ui.agent.warehouse.workflows.sortInventory",
+          "uiActions": [
+            "data-table.sort_by"
+          ],
+          "stateReads": [
+            "data-table.sort"
+          ],
+          "apiActions": []
+        },
+        {
+          "name": "compact_actions",
+          "safety": "read",
+          "description": "Toggle the ColumnToggle settings-footer switch to compact the per-row action column.",
+          "descriptionKey": "ui.agent.warehouse.workflows.compactActions",
+          "uiActions": [
+            "switch.set_checked"
+          ],
+          "stateReads": [
+            "switch.checked"
+          ],
+          "apiActions": []
+        },
+        {
+          "name": "export_inventory",
+          "safety": "read",
+          "description": "Export the current (optionally filtered) inventory from the page-header table-tools cluster — CSV / Excel / PDF.",
+          "descriptionKey": "ui.agent.warehouse.workflows.exportInventory",
+          "uiActions": [],
+          "apiActions": [
+            "inventory.export"
+          ]
+        },
+        {
+          "name": "stock_in",
+          "safety": "write",
+          "description": "Record incoming stock for the selected item from its row action.",
+          "descriptionKey": "ui.agent.warehouse.workflows.stockIn",
+          "uiActions": [
+            "data-table.get_selection"
+          ],
+          "stateReads": [
+            "data-table.selection"
+          ],
+          "apiActions": [
+            "inventory.stockIn"
+          ]
+        },
+        {
+          "name": "stock_out",
+          "safety": "write",
+          "description": "Record outgoing stock for the selected item from its row action.",
+          "descriptionKey": "ui.agent.warehouse.workflows.stockOut",
+          "uiActions": [
+            "data-table.get_selection"
+          ],
+          "stateReads": [
+            "data-table.selection"
+          ],
+          "apiActions": [
+            "inventory.stockOut"
+          ]
+        },
+        {
+          "name": "edit_item",
+          "safety": "write",
+          "description": "Edit the selected inventory item (e.g. min-stock threshold, supplier) from its row action.",
+          "descriptionKey": "ui.agent.warehouse.workflows.editItem",
+          "uiActions": [
+            "data-table.get_selection"
+          ],
+          "stateReads": [
+            "data-table.selection"
+          ],
+          "apiActions": [
+            "inventory.update"
+          ]
+        },
+        {
+          "name": "import_fatturapa",
+          "safety": "write",
+          "description": "Open the FatturaPA XML import dialog, upload supplier e-invoice XML files, review the classified line preview, deselect any unwanted lines, and confirm to create articles and stock movements.",
+          "descriptionKey": "ui.agent.warehouse.workflows.importFatturapa",
+          "uiActions": [
+            "dialog.open",
+            "file-upload.clear"
+          ],
+          "stateReads": [
+            "dialog.isOpen",
+            "file-upload.files"
+          ],
+          "apiActions": [
+            "inventory.importFatturapa"
+          ]
+        }
+      ]
     }
   ]
 }