@alfadocs/ui-kit-debug 1.13.0 → 1.15.0

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "1.13.0",
+  "packageVersion": "1.15.0",
   "components": [
     {
       "kind": "component",
@@ -16572,6 +16572,872 @@
         }
       ]
     },
+    {
+      "kind": "pattern",
+      "id": "calendar",
+      "composes": [
+        {
+          "component": "calendar",
+          "as": "agenda",
+          "entity": "appointment"
+        },
+        {
+          "component": "card",
+          "as": "page"
+        },
+        {
+          "component": "scroll-area",
+          "as": "surfaceScroller"
+        },
+        {
+          "component": "visually-hidden",
+          "as": "dockAnnouncement"
+        },
+        {
+          "component": "control-room-rail",
+          "as": "toolRail"
+        },
+        {
+          "component": "button",
+          "as": "newAppointment"
+        },
+        {
+          "component": "button-group",
+          "as": "waitingListSplit"
+        },
+        {
+          "component": "button",
+          "as": "onlineBookings"
+        },
+        {
+          "component": "button",
+          "as": "findFreeSlots"
+        },
+        {
+          "component": "popover",
+          "as": "chairFilter"
+        },
+        {
+          "component": "checkbox",
+          "as": "chairChoice",
+          "entity": "chair"
+        },
+        {
+          "component": "popover",
+          "as": "operatorFilter"
+        },
+        {
+          "component": "checkbox",
+          "as": "operatorChoice",
+          "entity": "operator"
+        },
+        {
+          "component": "avatar",
+          "as": "operatorFace",
+          "entity": "operator"
+        },
+        {
+          "component": "tag",
+          "as": "disabledOperatorMarker",
+          "entity": "operator"
+        },
+        {
+          "component": "switch",
+          "as": "availableOperatorsOnly"
+        },
+        {
+          "component": "switch",
+          "as": "showDisabledOperators"
+        },
+        {
+          "component": "badge",
+          "as": "filterCount"
+        },
+        {
+          "component": "button",
+          "as": "resetFilters"
+        },
+        {
+          "component": "icon-button",
+          "as": "toolbarIcon"
+        },
+        {
+          "component": "popover",
+          "as": "displaySettings"
+        },
+        {
+          "component": "select",
+          "as": "displayChoice"
+        },
+        {
+          "component": "switch",
+          "as": "displayToggle"
+        },
+        {
+          "component": "number-input",
+          "as": "defaultDuration"
+        },
+        {
+          "component": "date-picker",
+          "as": "jumpToDate"
+        },
+        {
+          "component": "dropdown-menu",
+          "as": "viewMenu"
+        },
+        {
+          "component": "kbd",
+          "as": "rangeShortcutHint"
+        },
+        {
+          "component": "button-group",
+          "as": "rangeNav"
+        },
+        {
+          "component": "popover",
+          "as": "hoverPeek",
+          "entity": "appointment"
+        },
+        {
+          "component": "key-value-pair",
+          "as": "peekFact"
+        },
+        {
+          "component": "timestamp",
+          "as": "peekTime"
+        },
+        {
+          "component": "dialog",
+          "as": "moveConfirm"
+        },
+        {
+          "component": "checkbox",
+          "as": "notifyChannel"
+        },
+        {
+          "component": "radio-group",
+          "as": "moveScope"
+        },
+        {
+          "component": "radio",
+          "as": "scopeOption"
+        },
+        {
+          "component": "dialog",
+          "as": "printDayPicker"
+        },
+        {
+          "component": "data-table",
+          "as": "callSheet",
+          "entity": "appointment"
+        },
+        {
+          "component": "toast",
+          "as": "feedback"
+        },
+        {
+          "component": "appointment-timeline",
+          "as": "upcoming",
+          "entity": "appointment"
+        },
+        {
+          "component": "panel-header",
+          "as": "panelHeader"
+        },
+        {
+          "component": "empty-state",
+          "as": "emptyPanel"
+        },
+        {
+          "component": "form-field",
+          "as": "formRow"
+        },
+        {
+          "component": "radio-group",
+          "as": "appointmentType"
+        },
+        {
+          "component": "combobox",
+          "as": "patientPicker",
+          "entity": "patient"
+        },
+        {
+          "component": "combobox",
+          "as": "carePicker",
+          "entity": "care"
+        },
+        {
+          "component": "combobox",
+          "as": "durationPicker"
+        },
+        {
+          "component": "select",
+          "as": "operatorSelect",
+          "entity": "operator"
+        },
+        {
+          "component": "select",
+          "as": "chairSelect",
+          "entity": "chair"
+        },
+        {
+          "component": "select",
+          "as": "branchSelect",
+          "entity": "branch"
+        },
+        {
+          "component": "select",
+          "as": "statusSelect"
+        },
+        {
+          "component": "date-picker",
+          "as": "appointmentDate"
+        },
+        {
+          "component": "time-picker",
+          "as": "startTime"
+        },
+        {
+          "component": "color-picker",
+          "as": "appointmentColour"
+        },
+        {
+          "component": "text-input",
+          "as": "appointmentDescription"
+        },
+        {
+          "component": "text-area",
+          "as": "appointmentNotes"
+        },
+        {
+          "component": "number-input",
+          "as": "repetitionCount"
+        },
+        {
+          "component": "checkbox",
+          "as": "reminderChannel"
+        },
+        {
+          "component": "radio-group",
+          "as": "requiredDocsSignMode"
+        },
+        {
+          "component": "alert",
+          "as": "editorAdvisory"
+        },
+        {
+          "component": "tag",
+          "as": "careRowMarker",
+          "entity": "care"
+        },
+        {
+          "component": "icon-button-group",
+          "as": "panelToolbar"
+        },
+        {
+          "component": "icon-button",
+          "as": "panelAction"
+        },
+        {
+          "component": "timeline",
+          "as": "modificationHistory"
+        },
+        {
+          "component": "notes-panel",
+          "as": "patientNotes",
+          "entity": "note"
+        },
+        {
+          "component": "dialog",
+          "as": "noteEditor"
+        },
+        {
+          "component": "dialog",
+          "as": "noteDeleteConfirm"
+        },
+        {
+          "component": "dialog",
+          "as": "deleteConfirm"
+        },
+        {
+          "component": "radio-group",
+          "as": "deleteScope"
+        },
+        {
+          "component": "dialog",
+          "as": "createBillConfirm"
+        },
+        {
+          "component": "dropdown-menu",
+          "as": "signatureMenu"
+        },
+        {
+          "component": "dropdown-menu",
+          "as": "documentsMenu"
+        },
+        {
+          "component": "signature-status-chip",
+          "as": "signatureStatus"
+        },
+        {
+          "component": "key-value-pair",
+          "as": "readOnlyFact"
+        },
+        {
+          "component": "select",
+          "as": "waitingQuickView"
+        },
+        {
+          "component": "button",
+          "as": "advancedFilterToggle"
+        },
+        {
+          "component": "badge",
+          "as": "waitingFilterCount"
+        },
+        {
+          "component": "avatar",
+          "as": "waitingPatientFace",
+          "entity": "patient"
+        },
+        {
+          "component": "whatsapp-button",
+          "as": "whatsAppBridge",
+          "entity": "patient"
+        },
+        {
+          "component": "icon-button",
+          "as": "waitingRowAction",
+          "entity": "waitingEntry"
+        },
+        {
+          "component": "appointment-card",
+          "as": "bookingRow",
+          "entity": "appointment"
+        },
+        {
+          "component": "collapsible",
+          "as": "finderFilters"
+        },
+        {
+          "component": "popover",
+          "as": "finderScope"
+        },
+        {
+          "component": "checkbox",
+          "as": "finderScopeChoice"
+        },
+        {
+          "component": "switch",
+          "as": "finderToggle"
+        },
+        {
+          "component": "select",
+          "as": "medicalDeviceSelect"
+        },
+        {
+          "component": "alert",
+          "as": "finderAdvisory"
+        }
+      ],
+      "workflows": [
+        {
+          "name": "browse_agenda",
+          "safety": "read",
+          "description": "Navigate the agenda: today, previous / next range, jump to a date through the navigation row's date picker, or change what the grid shows from the one view menu — a range (day, three days, week, month, also reachable as the bare keys D · X · W · M) and a column axis (plain, chairs, operators), plus a remembered \"Show weekends\" item that hides Saturday and Sunday in every range. Each range change hands the new window to the host, which fetches the appointments for it.",
+          "descriptionKey": "ui.agent.calendar.workflows.browseAgenda",
+          "uiActions": [
+            "calendar.today",
+            "calendar.prev",
+            "calendar.next",
+            "calendar.goto_date",
+            "calendar.change_view",
+            "date-picker.set_date",
+            "dropdown-menu.open",
+            "dropdown-menu.close"
+          ],
+          "stateReads": [
+            "calendar.currentView",
+            "calendar.currentDate",
+            "calendar.currentTitle",
+            "date-picker.value",
+            "dropdown-menu.isOpen"
+          ],
+          "apiActions": [
+            "appointment.list"
+          ]
+        },
+        {
+          "name": "filter_columns",
+          "safety": "read",
+          "description": "Narrow the grid to particular chairs or operators from the two filter popovers, with the platform's semantics: nothing ticked shows everyone and ticking narrows. Operators list under their groups with a tri-state row per group; \"Only available operators\" is on by default in the operator views, and a session-local \"Show disabled operators\" switch reveals the operators the practice has disabled. A count badge rides each filter button while it narrows, and the \"Reset filters\" chip beside them clears both selections and restores both switches without ever changing the view. Selection only — no appointment is touched.",
+          "descriptionKey": "ui.agent.calendar.workflows.filterColumns",
+          "uiActions": [
+            "popover.open",
+            "popover.close",
+            "checkbox.set_checked",
+            "checkbox.toggle",
+            "switch.set_checked",
+            "switch.toggle"
+          ],
+          "stateReads": [
+            "popover.isOpen",
+            "checkbox.checked",
+            "switch.checked"
+          ],
+          "apiActions": []
+        },
+        {
+          "name": "mask_patient_names",
+          "safety": "read",
+          "description": "Turn privacy mode on or off from the toolbar. While on, patient names are masked on the cards, in the hover peek, in the Appointments panel and on the printed call sheet, so the page can stay open beside a waiting patient. It is a display mask, not a permission: it is not persisted and it changes no record.",
+          "descriptionKey": "ui.agent.calendar.workflows.maskPatientNames",
+          "uiActions": [],
+          "apiActions": []
+        },
+        {
+          "name": "configure_display",
+          "safety": "write",
+          "description": "Set the per-user display knobs in the cog popover — layout, zebra rows, show times, slot precision, the day window, the care-description mode, what the cards are coloured by, the default duration of a new appointment (5–240 minutes), whether operators read as an initials disc or a dot plus full name, whether chairs read as a full name or a short code, and whether the details panel offers the map link. The choices are remembered per user through the host's preferences adapter under `calendarWorkspace.*` keys, so they persist beyond the page load; they change presentation only and touch no patient record.",
+          "descriptionKey": "ui.agent.calendar.workflows.configureDisplay",
+          "uiActions": [
+            "popover.open",
+            "popover.close",
+            "select.set_value",
+            "switch.set_checked",
+            "switch.toggle",
+            "number-input.set_value"
+          ],
+          "stateReads": [
+            "popover.isOpen",
+            "select.value",
+            "switch.checked",
+            "number-input.value"
+          ],
+          "apiActions": [
+            "calendarPreference.update"
+          ]
+        },
+        {
+          "name": "dock_tool",
+          "safety": "read",
+          "description": "Open one of the rail's tools — Appointments, the appointment editor / details panel, the waiting list, the online bookings or the free-slot finder — or read which one is docked. A host declares which of the five it can back with real data, so read the strip rather than assuming all five: a tool the host withheld is absent, and anything routed at it docks Appointments instead. Closing returns to the Appointments panel rather than collapsing the rail, so no path leaves an empty dock. Docking moves no focus; a polite live region announces the panel that arrived.",
+          "descriptionKey": "ui.agent.calendar.workflows.dockTool",
+          "uiActions": [
+            "control-room-rail.open",
+            "control-room-rail.close",
+            "control-room-rail.select_tool"
+          ],
+          "stateReads": [
+            "control-room-rail.activeToolId"
+          ],
+          "apiActions": []
+        },
+        {
+          "name": "review_upcoming",
+          "safety": "read",
+          "description": "Read the rail's resting panel: the practice's upcoming appointments — now to the end of the seventh day, cancelled excluded, earliest first — each row led by the patient. The preset row, the jump-to-date picker and the edge loaders widen the derived window up to ±180 days. Activating a row selects that appointment on the grid, which docks its details. Read-only; the rows carry ids and lifecycle state, never patient identity.",
+          "descriptionKey": "ui.agent.calendar.workflows.reviewUpcoming",
+          "uiActions": [
+            "appointment-timeline.select_item",
+            "appointment-timeline.jump_to_today",
+            "date-picker.set_date",
+            "calendar.focus_event"
+          ],
+          "stateReads": [
+            "appointment-timeline.items",
+            "date-picker.value"
+          ],
+          "apiActions": [
+            "appointment.list"
+          ]
+        },
+        {
+          "name": "create_appointment",
+          "safety": "phi",
+          "description": "Book a new appointment in the editor panel, docked from the New appointment button, from a click on an empty slot (prefilled with the slot, the clicked column and the cog's default duration) or from an online booking being processed. Set the patient, the linked care or care-plan lines, the date, start time and duration, the operator, chair, branch and colour, the description (255 characters at most — a longer one blocks the save), and, once a patient is chosen, the SMS and e-mail reminders, the first-visit question and — where the patient has unsigned required documents — how they are asked to sign. Busy chair, busy operator and operator-away warnings are advisory and do not hold the save; only a practice closure does. Enter submits from any text field. Writes patient-identifiable data.",
+          "descriptionKey": "ui.agent.calendar.workflows.createAppointment",
+          "uiActions": [
+            "combobox.set_value",
+            "combobox.apply_filter",
+            "select.set_value",
+            "date-picker.set_date",
+            "time-picker.set_time",
+            "color-picker.set_value",
+            "text-input.set_value",
+            "text-area.set_value",
+            "number-input.set_value",
+            "checkbox.set_checked",
+            "radio-group.set_value",
+            "control-room-rail.open"
+          ],
+          "stateReads": [
+            "combobox.value",
+            "select.value",
+            "date-picker.value",
+            "time-picker.value",
+            "checkbox.checked",
+            "radio-group.value",
+            "control-room-rail.activeToolId"
+          ],
+          "apiActions": [
+            "appointment.create"
+          ]
+        },
+        {
+          "name": "edit_appointment",
+          "safety": "phi",
+          "description": "Amend an existing appointment. Clicking its card docks the SAME panel in details mode — the identity strip, the prefilled form, the read-only extras and the History sub-view — so there is one editing paradigm and no separate Edit jump. Change any field and save; for a member of a repeating series the save asks how far it reaches. On save the rail returns to the Appointments panel and a toast names the day, carrying a \"Go to\" action when that day is off screen, on a hidden weekend or filtered out. Writes patient-identifiable data.",
+          "descriptionKey": "ui.agent.calendar.workflows.editAppointment",
+          "uiActions": [
+            "calendar.focus_event",
+            "combobox.set_value",
+            "select.set_value",
+            "date-picker.set_date",
+            "time-picker.set_time",
+            "color-picker.set_value",
+            "text-input.set_value",
+            "text-area.set_value",
+            "radio-group.set_value"
+          ],
+          "stateReads": [
+            "combobox.value",
+            "select.value",
+            "date-picker.value",
+            "time-picker.value",
+            "radio-group.value",
+            "calendar.currentDate"
+          ],
+          "apiActions": [
+            "appointment.update",
+            "appointmentSeries.applyScope"
+          ]
+        },
+        {
+          "name": "change_appointment_status",
+          "safety": "phi",
+          "description": "Set an appointment's attendance status from the Status select in the details panel. The status is patient-identifiable attendance data.",
+          "descriptionKey": "ui.agent.calendar.workflows.changeAppointmentStatus",
+          "uiActions": [
+            "calendar.focus_event",
+            "select.set_value"
+          ],
+          "stateReads": [
+            "select.value"
+          ],
+          "apiActions": [
+            "appointment.setStatus"
+          ]
+        },
+        {
+          "name": "move_appointment",
+          "safety": "phi",
+          "description": "Reschedule an appointment either by dragging its card to a new slot or by arming \"Move…\" in the details panel and then clicking the target slot — the panel stays docked and a banner tinted with the appointment's own colour names what is being placed. Either route ends in the confirmation dialog, which offers the SMS and e-mail notify channels (kept even when the appointment recurs, where the platform drops them) and, for a series member, the recurring scope. Cancelling reverts the card and commits nothing. Writes patient-identifiable data.",
+          "descriptionKey": "ui.agent.calendar.workflows.moveAppointment",
+          "uiActions": [
+            "calendar.focus_event",
+            "calendar.goto_date",
+            "dialog.open",
+            "dialog.close",
+            "dialog.dismiss",
+            "checkbox.set_checked",
+            "radio-group.set_value"
+          ],
+          "stateReads": [
+            "dialog.isOpen",
+            "checkbox.checked",
+            "radio-group.value",
+            "calendar.currentDate"
+          ],
+          "apiActions": [
+            "appointment.reschedule",
+            "patient.notifyAppointmentChange"
+          ]
+        },
+        {
+          "name": "resize_appointment",
+          "safety": "phi",
+          "description": "Change an appointment's duration by dragging its card edge. Unlike a move this SAVES AT ONCE with no confirmation, exactly as the platform does; the toast that follows carries an Undo that restores the previous duration and logs both changes on the appointment's history. Writes patient-identifiable data.",
+          "descriptionKey": "ui.agent.calendar.workflows.resizeAppointment",
+          "uiActions": [
+            "calendar.focus_event",
+            "toast.dismiss"
+          ],
+          "stateReads": [
+            "toast.visibleToasts"
+          ],
+          "apiActions": [
+            "appointment.update"
+          ]
+        },
+        {
+          "name": "copy_appointment",
+          "safety": "phi",
+          "description": "Duplicate an appointment onto another slot: arm \"Copy…\" in the details panel, then click the target. The copy lands immediately with no confirmation, and its toast carries an Undo. A plan-linked appointment first asks whether to copy the appointment only or the appointment and its treatments. Writes patient-identifiable data.",
+          "descriptionKey": "ui.agent.calendar.workflows.copyAppointment",
+          "uiActions": [
+            "calendar.focus_event",
+            "calendar.goto_date",
+            "toast.dismiss",
+            "radio-group.set_value"
+          ],
+          "stateReads": [
+            "calendar.currentDate",
+            "toast.visibleToasts",
+            "radio-group.value"
+          ],
+          "apiActions": [
+            "appointment.duplicate"
+          ]
+        },
+        {
+          "name": "delete_appointment",
+          "safety": "destructive",
+          "description": "Remove an appointment from the details panel behind an alert dialog. The dialog asks for the recurring scope when the appointment belongs to a series, and for the care-plan cleanup when it is the parent of a price-list recurrence — so confirming can drop far more than the one card. Irreversible from this surface.",
+          "descriptionKey": "ui.agent.calendar.workflows.deleteAppointment",
+          "uiActions": [
+            "calendar.focus_event",
+            "dialog.open",
+            "dialog.close",
+            "dialog.dismiss",
+            "radio-group.set_value"
+          ],
+          "stateReads": [
+            "dialog.isOpen",
+            "radio-group.value"
+          ],
+          "apiActions": [
+            "appointment.delete",
+            "appointmentSeries.applyScope"
+          ]
+        },
+        {
+          "name": "manage_patient_notes",
+          "safety": "phi",
+          "description": "Read and write the patient's notes from the Notes sub-view beside History: add a note through the composer, pin one, edit one in a dialog or delete one behind an alert dialog. Every write goes to the host, which stamps the note's id, time and author — the kit attributes nothing to a clinical note. With no host seam, or without the edit permission, the sub-view is a read-only timeline. The rows carry ids and pin / flag / clinical markers only; the body and the author are never exposed as state. Writes patient-identifiable clinical data.",
+          "descriptionKey": "ui.agent.calendar.workflows.managePatientNotes",
+          "uiActions": [
+            "notes-panel.add_note",
+            "notes-panel.toggle_pin",
+            "dialog.open",
+            "dialog.close",
+            "dialog.dismiss",
+            "text-area.set_value"
+          ],
+          "stateReads": [
+            "notes-panel.notes",
+            "notes-panel.canAddClinical",
+            "notes-panel.currentNoteId",
+            "dialog.isOpen"
+          ],
+          "apiActions": [
+            "patientNote.create",
+            "patientNote.update",
+            "patientNote.delete",
+            "patientNote.pin"
+          ]
+        },
+        {
+          "name": "read_modification_history",
+          "safety": "read",
+          "description": "Open the History sub-view of the details panel and read the appointment's modification ledger, newest first — what changed, from what to what, and when. No mutation.",
+          "descriptionKey": "ui.agent.calendar.workflows.readModificationHistory",
+          "uiActions": [
+            "timeline.select_event"
+          ],
+          "stateReads": [
+            "timeline.selectedEvent"
+          ],
+          "apiActions": [
+            "appointment.listHistory"
+          ]
+        },
+        {
+          "name": "request_signature",
+          "safety": "phi",
+          "description": "Ask the patient to sign the appointment's documents from the details panel: by SMS or e-mail through the kit menu, or \"On this device…\", which hands off to the host's own e-signature surface. The chip beside it reports the channel a request has already gone out on. Sends a patient-identifiable request.",
+          "descriptionKey": "ui.agent.calendar.workflows.requestSignature",
+          "uiActions": [
+            "dropdown-menu.open",
+            "dropdown-menu.close"
+          ],
+          "stateReads": [
+            "dropdown-menu.isOpen"
+          ],
+          "apiActions": [
+            "signature.request"
+          ]
+        },
+        {
+          "name": "create_bill",
+          "safety": "phi",
+          "description": "Raise a bill for the appointment from the details panel's Documents menu, behind a confirmation dialog. Refused while the appointment has no operator. Creates a patient-identifiable financial document.",
+          "descriptionKey": "ui.agent.calendar.workflows.createBill",
+          "uiActions": [
+            "dropdown-menu.open",
+            "dropdown-menu.close",
+            "dialog.open",
+            "dialog.close",
+            "dialog.dismiss"
+          ],
+          "stateReads": [
+            "dropdown-menu.isOpen",
+            "dialog.isOpen"
+          ],
+          "apiActions": [
+            "bill.create"
+          ]
+        },
+        {
+          "name": "open_patient_folder",
+          "safety": "read",
+          "description": "Hand off from an appointment or a waiting-list row to its patient: the name in the details panel's identity strip and in the waiting queue is a link the host resolves to the patient folder. Navigation only.",
+          "descriptionKey": "ui.agent.calendar.workflows.openPatientFolder",
+          "uiActions": [
+            "calendar.focus_event"
+          ],
+          "apiActions": [
+            "patient.get"
+          ]
+        },
+        {
+          "name": "message_patient_whatsapp",
+          "safety": "phi",
+          "description": "Reach the patient over WhatsApp from the details panel or a waiting-list row. The kit only raises the bridge — the host mounts the legacy Snippets surface that composes and sends. The affordance is disabled, and names its reason in its accessible name, when the entry carries no SMS-capable number. Hands a patient's contact detail to an outbound channel.",
+          "descriptionKey": "ui.agent.calendar.workflows.messagePatientWhatsapp",
+          "uiActions": [],
+          "apiActions": [
+            "patient.openWhatsAppSnippets"
+          ]
+        },
+        {
+          "name": "filter_waiting_list",
+          "safety": "read",
+          "description": "Narrow the waiting queue: the four quick views (all, patients without an appointment, appointment scheduled over 30 days ago, on the list over 30 days) and, behind \"Show advanced filters\", the platform's nine optional client-side inputs — patient, patient assigned, operator, appointment scheduled, appointment scheduled from / to, on the waiting list from / to and description — applied only when \"Filter list\" is pressed. The toggle carries a count badge while any input is set, and changing the quick view drops the form. Selection only.",
+          "descriptionKey": "ui.agent.calendar.workflows.filterWaitingList",
+          "uiActions": [
+            "select.set_value",
+            "combobox.set_value",
+            "date-picker.set_date",
+            "text-area.set_value"
+          ],
+          "stateReads": [
+            "select.value",
+            "combobox.value",
+            "date-picker.value",
+            "text-area.value"
+          ],
+          "apiActions": []
+        },
+        {
+          "name": "manage_waiting_list_entry",
+          "safety": "phi",
+          "description": "Add, amend or remove a waiting-list entry. The four-field form opens as a rail SUB-VIEW — from the toolbar split button's plus segment, from Add entry, or from a row's pencil — with a back arrow to the queue. Editing is refused on a row already linked to an appointment, because those fields belong to the appointment; the pencil stays focusable and names that reason. Remove deletes at once with no confirmation, platform parity, and its toast carries an Undo that puts the entry back. Writes patient-identifiable data.",
+          "descriptionKey": "ui.agent.calendar.workflows.manageWaitingListEntry",
+          "uiActions": [
+            "combobox.set_value",
+            "select.set_value",
+            "color-picker.set_value",
+            "text-area.set_value",
+            "toast.dismiss"
+          ],
+          "stateReads": [
+            "combobox.value",
+            "select.value",
+            "text-area.value",
+            "toast.visibleToasts"
+          ],
+          "apiActions": [
+            "waitingListEntry.create",
+            "waitingListEntry.update",
+            "waitingListEntry.delete"
+          ]
+        },
+        {
+          "name": "schedule_waiting_patient",
+          "safety": "phi",
+          "description": "Give a waiting patient a slot. \"Schedule\" on an unlinked row hands off to the free-slot finder seeded from the entry — operator, chair, duration, patient, care and colour already filled in — and booking a slot opens the editor carrying the entry, so saving books the appointment and takes the entry off the list. A row already linked to an appointment reads \"Reschedule\" and seeds the same finder, but booking there MOVES the existing appointment rather than creating a second one. Writes patient-identifiable data.",
+          "descriptionKey": "ui.agent.calendar.workflows.scheduleWaitingPatient",
+          "uiActions": [
+            "control-room-rail.open",
+            "calendar.goto_date",
+            "date-picker.set_date",
+            "time-picker.set_time"
+          ],
+          "stateReads": [
+            "control-room-rail.activeToolId",
+            "calendar.currentDate"
+          ],
+          "apiActions": [
+            "waitingListEntry.schedule",
+            "appointment.create",
+            "appointment.reschedule"
+          ]
+        },
+        {
+          "name": "find_free_slot",
+          "safety": "read",
+          "description": "Search the practice for bookable time in the finder panel. Operator and chair scope are grouped checklists behind a popover per axis — a select-all row first, operators sectioned under their groups, nothing ticked searching every eligible resource — beside the care, the duration, the date range and, for a care that needs one, a medical-device select. The results list groups the slots under a day heading; a click steers the grid to that day and docks the editor prefilled with the date, time, duration, chair, operator and any seeded patient or care. The 185-day range warning is advisory (the search still runs), \"Show more slots\" pushes the To date out by 30 days and re-searches, and an alert links to the scheduler when the practice or its operators hold no business hours. Read-only until a slot is booked.",
+          "descriptionKey": "ui.agent.calendar.workflows.findFreeSlot",
+          "uiActions": [
+            "collapsible.toggle",
+            "popover.open",
+            "popover.close",
+            "checkbox.set_checked",
+            "combobox.set_value",
+            "select.set_value",
+            "date-picker.set_date",
+            "switch.set_checked"
+          ],
+          "stateReads": [
+            "collapsible.isOpen",
+            "popover.isOpen",
+            "checkbox.checked",
+            "combobox.value",
+            "select.value",
+            "date-picker.value",
+            "switch.checked"
+          ],
+          "apiActions": [
+            "availability.search"
+          ]
+        },
+        {
+          "name": "triage_online_booking",
+          "safety": "phi",
+          "description": "Work the online-bookings panel — the platform's bookings page hosted in the rail, badged with the bookings of the last thirty days still missing a patient or an operator. A row can be shown on the grid, which selects it and docks its details, or completed, which docks the editor prefilled with what the person typed on the booking site so the missing patient or operator can be filled in and saved. Completing writes patient-identifiable data.",
+          "descriptionKey": "ui.agent.calendar.workflows.triageOnlineBooking",
+          "uiActions": [
+            "calendar.focus_event",
+            "control-room-rail.open"
+          ],
+          "stateReads": [
+            "control-room-rail.activeToolId"
+          ],
+          "apiActions": [
+            "onlineBooking.list",
+            "onlineBooking.process"
+          ]
+        },
+        {
+          "name": "print_day_sheet",
+          "safety": "phi",
+          "description": "Print the front-desk call sheet. The toolbar's printer icon opens a dialog asking which day — one day, never the visible range — and Print renders that day's appointments through the browser, scoped by the filters in force and masked when privacy mode is on. Nothing is sent to a server, but the sheet itself is a patient-identifiable document.",
+          "descriptionKey": "ui.agent.calendar.workflows.printDaySheet",
+          "uiActions": [
+            "dialog.open",
+            "dialog.close",
+            "dialog.dismiss",
+            "date-picker.set_date"
+          ],
+          "stateReads": [
+            "dialog.isOpen",
+            "date-picker.value"
+          ],
+          "apiActions": []
+        }
+      ]
+    },
     {
       "kind": "pattern",
       "id": "care-plan-editor",