@alfadocs/ui-kit-debug 1.3.13 → 1.4.0

package/dist/agent-i18n/en.json

@@ -202,8 +202,12 @@
       }
     },
     "chatContainer": {
+      "state": {
+        "isAtBottom": "True when the viewport is pinned to the newest message. The read-back for `scroll_to_bottom` — the direct confirmation that the latest turn is on screen.",
+        "messageCount": "Number of messages currently rendered in the log. Count only — never message content."
+      },
       "actions": {
-        "scrollToBottom": "Scroll the conversation viewport to the latest message."
+        "scrollToBottom": "Scroll the conversation viewport to the latest message. Read the `isAtBottom` slot afterwards to confirm the viewport settled there."
       }
     },
     "chatInput": {
@@ -329,6 +333,17 @@
         "clearSelection": "Clear the selected country."
       }
     },
+    "cycleCalculator": {
+      "state": {
+        "inputs": "The three cycle inputs as entered — last-period start date (`yyyy-MM-dd`), average cycle length in days, and period (bleed) length in days. Null where unset.",
+        "result": "Computed prediction — ovulation date, fertile window, next period, current bleed range and the next few period starts, all `yyyy-MM-dd`. Null until a last-period date is set."
+      },
+      "actions": {
+        "setLastPeriod": "Set the start date of the last period. This is the only required input — the prediction stays null without it.",
+        "setCycleLength": "Set the average cycle length in days. Shifts ovulation, the fertile window and every upcoming period.",
+        "setPeriodLength": "Set the period (bleed) length in days. Optional — it only adds the current bleed range to the result."
+      }
+    },
     "dashboardGrid": {
       "state": {
         "layout": "Current widget geometry in cell units — ids and rectangles only, no widget content.",
@@ -447,6 +462,20 @@
         "close": "Close the menu."
       }
     },
+    "dueDateCalculator": {
+      "state": {
+        "inputs": "The dating inputs as entered — method, its reference date, cycle length (LMP), embryo age (IVF), the optional CRL + scan date, and the evaluation date. Dates are `yyyy-MM-dd`. Read this to see which method a reference date will be interpreted under.",
+        "result": "Computed estimated delivery date, the GA day-0 anchor after any CRL re-dating, the gestational age as of the evaluation date, and the trimester band. Null until a reference date is set."
+      },
+      "actions": {
+        "setMethod": "Choose which anchor the pregnancy is dated from. The reference date is kept and re-interpreted under the new method, so set the method first.",
+        "setReferenceDate": "Set the reference date for the active method. This is the only required input — the result stays null without it.",
+        "setCycleLength": "LMP method only — set the average cycle length, which shifts Naegele dating off the 28-day assumption.",
+        "setEmbryoAge": "IVF method only — set the embryo age at transfer, which offsets the transfer date back to a notional LMP.",
+        "setCrl": "LMP method only — set the first-trimester crown-rump length and its scan date. When the two disagree with the LMP beyond the ACOG threshold, the scan re-dates the pregnancy and overrides cycle length.",
+        "setAsOfDate": "Set the date gestational age, trimester and the antenatal schedule are evaluated against. Defaults to today; the estimated delivery date itself does not depend on it."
+      }
+    },
     "emailInput": {
       "state": {
         "value": "The current email address typed into the field.",
@@ -494,6 +523,15 @@
         "clearAnnotations": "Clear every free-form annotation from the active view. Zone findings are untouched."
       }
     },
+    "fetalWeight": {
+      "state": {
+        "biometry": "The four ultrasound measurements as entered, in millimetres — biparietal diameter, head circumference, abdominal circumference and femur length. Null where unset. Read this to see why a result is still null.",
+        "result": "Estimated fetal weight in grams and which Hadlock regression produced it — `hadlock4` when all four measurements are present, `hadlock1` from AC + FL alone. Null until AC and FL are both set."
+      },
+      "actions": {
+        "setBiometry": "Set any subset of the ultrasound biometry in millimetres. Omitted measurements are left unchanged; an explicit null clears one. AC and FL are the minimum for an estimate."
+      }
+    },
     "fieldArray": {
       "state": {
         "count": "Number of rows currently rendered."
@@ -551,11 +589,37 @@
         "dismiss": "Dismiss the paywall via the Not Now action. Irreversible from the same UI."
       }
     },
+    "gestationalAgeCalculator": {
+      "state": {
+        "inputs": "The dating inputs as entered — whether the reference date is a last period or a known due date, that date, and the evaluation date. Dates are `yyyy-MM-dd`. Read this to see which method a reference date will be interpreted under.",
+        "result": "Computed gestational age in completed weeks + days as of the evaluation date, the trimester band (preconception / first / second / third / postterm), and the estimated delivery date. Null until a reference date is set."
+      },
+      "actions": {
+        "setMethod": "Choose how the reference date is read. The date is kept and re-interpreted under the new method, so set the method first — an EDD may be in the future, an LMP may not.",
+        "setReferenceDate": "Set the dating anchor. This is the only required input — the result stays null without it.",
+        "setAsOfDate": "Set the date gestational age, trimester and the antenatal schedule are evaluated against. Defaults to today; the estimated delivery date itself does not depend on it."
+      }
+    },
+    "hcgDoubling": {
+      "state": {
+        "samples": "The two timed β-hCG samples as entered — value in mIU/mL plus the draw time as an ISO-8601 timestamp. Null where unset. Read this to see why a result is still null.",
+        "result": "Computed doubling time in hours (null when not rising), the rise normalised to 48 hours, and the trend band against the minimal-rise benchmark. Null until both samples are set and the second is after the first."
+      },
+      "actions": {
+        "setSamples": "Set any subset of the two timed β-hCG samples. Omitted keys are left unchanged; an explicit null clears one. All four are needed before a trend is computed."
+      }
+    },
     "headerSettings": {
+      "state": {
+        "locale": "Active IETF language tag (e.g. \"en\", \"it\", \"ar\"). Read after `set_locale` to confirm the switch landed — an unknown tag is silently dropped and leaves this unchanged.",
+        "theme": "Stored base-theme preference. `'system'` means no override is set and the OS decides — read `resolvedTheme` for what is actually painted.",
+        "accessibility": "Stored AAA-contrast preference. `'system'` means no override is set and `prefers-contrast` decides.",
+        "resolvedTheme": "The theme actually applied to the document once preference and OS signals resolve. This is what makes a `set_theme(\"system\")` or `set_accessibility(\"system\")` write verifiable."
+      },
       "actions": {
-        "setLocale": "Switch the active locale to the given IETF tag.",
-        "setTheme": "Switch the theme preference.",
-        "setAccessibility": "Switch the accessibility preference."
+        "setLocale": "Switch the active locale to the given IETF tag. Unknown tags are silently dropped — read the `locale` state slot afterwards to confirm.",
+        "setTheme": "Switch the theme preference. Verify with the `theme` slot (the stored preference) and `resolvedTheme` (what is actually painted).",
+        "setAccessibility": "Switch the accessibility preference. Verify with the `accessibility` slot (the stored preference) and `resolvedTheme` (what is actually painted)."
       }
     },
     "ibanInput": {
@@ -610,15 +674,26 @@
       }
     },
     "localePicker": {
+      "state": {
+        "locale": "Resolved IETF tag of the locale currently applied to the page. Read this after `set_locale` — the setter silently drops tags the kit ships no bundle for, so this is the only confirmation the switch landed.",
+        "isSystemDefault": "True when the resolved locale came from `navigator.language` rather than an explicit user choice. Distinguishes \"the user chose English\" from \"we are following the browser, which happens to be English\" — a distinction the resolved tag alone destroys."
+      },
       "actions": {
-        "setLocale": "Switch the active locale to the given IETF tag."
+        "setLocale": "Switch the active locale to the given IETF tag. Unsupported tags are a silent no-op — read the `locale` state slot afterwards to confirm the switch landed."
       }
     },
     "mapView": {
+      "state": {
+        "consentGranted": "True when the GDPR consent gate has been passed and the Google Maps subtree is mounted. Read this FIRST — while it is false every action is a silent no-op against a placeholder, and nothing else in the surface says so.",
+        "markerCount": "Number of markers the consumer passed. Zero means there is nothing for `select_marker` to select. A count only — no ids, labels or positions.",
+        "selectedMarkerId": "Id of the marker the host currently holds as selected, or null. Selection is fully controlled by the consumer, so `select_marker` only proposes — this slot is the only way to see whether the proposal was accepted.",
+        "center": "Live map centre in lat/lng, or null while the map subtree is unmounted (consent not granted). The read-back for `pan_to`.",
+        "zoom": "Live zoom level, or null while the map subtree is unmounted. Google clamps zoom to the map type's range, so this is not necessarily the value last passed to `set_zoom`."
+      },
       "actions": {
-        "panTo": "Pan the map to a new centre without changing zoom.",
-        "setZoom": "Set the map zoom level (typical range 1–20).",
-        "selectMarker": "Select a marker by id, or pass null to clear the selection."
+        "panTo": "Pan the map to a new centre without changing zoom. Read the `center` slot back to confirm — Google animates the pan, so the applied centre settles after the call.",
+        "setZoom": "Set the map zoom level (typical range 1–20). Read the `zoom` slot back — Google clamps the request to the map type’s supported range, so requested and applied can differ.",
+        "selectMarker": "Propose a marker selection by id, or pass null to clear it. Fires the host's `onMarkerClick`; selection is controlled by the host, so read the `selectedMarkerId` slot back to see whether it accepted."
       }
     },
     "messageTray": {
@@ -816,16 +891,29 @@
       }
     },
     "paymentForm": {
+      "state": {
+        "status": "Lifecycle of the current payment attempt. `succeeded` is only reached once Stripe confirmed the PaymentIntent; `failed` covers validation, decline and processor errors alike. Still `idle` after `submit` means the attempt never fired — Stripe had not mounted.",
+        "complete": "True when Stripe reports the payment fields as complete. Read this before `submit` — outside preview mode the submit control is disabled while it is false, so the call will not be accepted.",
+        "errorKey": "i18n key of the current error (e.g. `payment.error.cardDeclined`), or null. The key is the structural datum — the translated message is free text and is never exposed.",
+        "paymentIntentId": "Opaque Stripe PaymentIntent id once a charge succeeded, else null. The receipt — the attribution handle for the money that moved. Never the client secret."
+      },
       "actions": {
-        "submit": "Submit the payment. Charges the configured payment method — irreversible.",
-        "reset": "Reset the form to its initial state. Loses any in-progress input."
+        "submit": "Submit the payment. Charges the configured payment method — irreversible. Resolves once the attempt has settled; the outcome is never in the resolved value, so read `status`, then `errorKey` on failure or `paymentIntentId` on success.",
+        "reset": "Reset the form to its initial state. Loses any in-progress input, and discards the previous attempt — `status` returns to \"idle\" and `errorKey` / `paymentIntentId` to null."
       }
     },
     "pdfViewer": {
+      "state": {
+        "status": "Whether the document has loaded. Read this first — every action is a silent no-op while the viewer is loading or has failed.",
+        "currentPage": "1-indexed page currently in view. The read-back for `go_to_page`, which clamps out-of-range requests silently.",
+        "pageCount": "Number of pages in the loaded document, or 0 before it loads. Range-check against this before calling `go_to_page` rather than discovering the clamp after the fact.",
+        "zoom": "Zoom preset or numeric scale factor currently applied. The read-back for `set_zoom`.",
+        "searchMatchCount": "Number of matches for the active search query — 0 when nothing matched or no search is running. A count only; the matched text is never exposed."
+      },
       "actions": {
-        "goToPage": "Navigate to a specific 1-indexed page.",
+        "goToPage": "Navigate to a specific 1-indexed page. Check `pageCount` first — an out-of-range page is clamped silently, and the call is a no-op until `status` is \"ready\".",
         "setZoom": "Apply a zoom preset or numeric scale factor.",
-        "search": "Search the document for the given query and highlight matches.",
+        "search": "Search the document for the given query and highlight matches. Read the `searchMatchCount` slot afterwards — the action itself returns nothing.",
         "print": "Open the browser print dialog for the document."
       }
     },
@@ -934,6 +1022,34 @@
         "focusPin": "Highlight the map pin for the given result id (no-op on rich-cards)."
       }
     },
+    "pregnancyDating": {
+      "state": {
+        "inputs": "The dating inputs as entered — anchor method, its reference date, cycle length (LMP), embryo age (IVF), the optional CRL + scan date, the manual ±days nudge, and the evaluation date. Dates are `yyyy-MM-dd`. Read this to see which method a reference date will be interpreted under.",
+        "result": "Computed estimated delivery date, the GA day-0 anchor after any re-dating or adjustment, the gestational age in completed weeks + days as of the evaluation date, and the trimester band (preconception / first / second / third / postterm). Null until a reference date is set."
+      },
+      "actions": {
+        "setMethod": "Choose which anchor the pregnancy is dated from. The reference date is kept and re-interpreted under the new method, so set the method first — only a known EDD may be in the future.",
+        "setReferenceDate": "Set the reference date for the active method. This is the only required input — the result stays null without it.",
+        "setCycleLength": "LMP method only — set the average cycle length, which shifts Naegele dating off the 28-day assumption.",
+        "setEmbryoAge": "IVF method only — set the embryo age at transfer, which offsets the transfer date back to a notional LMP.",
+        "setCrl": "LMP method only — set the first-trimester crown-rump length and its scan date. A confirmed re-dating wins over both the cycle length and the manual adjustment.",
+        "setDatingAdjustment": "Nudge the dating by whole days for an uncertain anchor. Positive moves the pregnancy further along (earlier effective LMP, earlier due date).",
+        "setAsOfDate": "Set the date gestational age, trimester and the antenatal schedule are evaluated against. Defaults to today; the estimated delivery date itself does not depend on it."
+      }
+    },
+    "pregnancyWeightGain": {
+      "state": {
+        "inputs": "The four entered measurements — height (cm), pre-pregnancy weight (kg), current weight (kg) and completed gestational weeks. Null for anything not yet entered.",
+        "plurality": "Number of babies the assessment is keyed to. Drives which IOM band applies — twins use the higher twin bands, triplets have no published band.",
+        "result": "Computed assessment — actual gain (kg), the IOM recommended-to-date and total bands, and where the gain sits against them (below / within / above). Null until every input is valid; the bands are null when the IOM publishes none (triplets, underweight twins)."
+      },
+      "actions": {
+        "setValue": "Set one or more of the four measurements. Omitted fields are left unchanged; the assessment recomputes as soon as all four are valid.",
+        "setPlurality": "Choose the number of babies. Twins use the higher IOM twin bands; triplets have no published IOM range, so only the actual gain is reported.",
+        "reset": "Clear the four measurements and the computed assessment. The plurality choice is a setting and is kept.",
+        "getResult": "Read back the computed assessment — the same value the `result` state slot returns. Null until every input is valid."
+      }
+    },
     "privacyLock": {
       "state": {
         "isLocked": "True when the privacy overlay is open."
@@ -961,6 +1077,15 @@
         "close": "Close the product-updates panel."
       }
     },
+    "progress": {
+      "state": {
+        "value": "The figure the bar currently shows, in the same units as the `max` prop (default max 100) — including a value written imperatively by `set_value`. Null while indeterminate.",
+        "indeterminate": "True when the operation reports no measurable progress. Read this before treating a null/0 `value` as \"nothing done yet\" — the two are different states."
+      },
+      "actions": {
+        "setValue": "Paint the displayed progress value straight onto the DOM, bypassing React. Read it back with the `value` state slot — the `value` prop does not change."
+      }
+    },
     "provinceSelect": {
       "state": {
         "value": "Selected province code (UPPERCASED sigla for Italy), or null when nothing is selected."
@@ -1135,11 +1260,33 @@
         "setValue": "Replace the thumb value(s). Pass a 1-tuple for single, 2-tuple for range."
       }
     },
+    "slotGrid": {
+      "state": {
+        "status": "Visual state of the grid. Read this before concluding \"no availability\" — `loading` means the window has not resolved yet.",
+        "selectedSlotId": "Id of the slot the consumer has committed as selected, or null. Reflects the controlled `selectedSlotId` prop, not an internal choice.",
+        "visibleDays": "Calendar days currently rendered as columns, as `yyyy-MM-dd` keys in display order.",
+        "slotsByDay": "Map of day key (`yyyy-MM-dd`) to the ids of that day’s bookable slots. Ids only — never slot or patient objects. Includes slots still collapsed behind \"Show more\".",
+        "expandedDays": "Day keys whose \"Show more\" control has been used, so every slot for that day is rendered.",
+        "hasPrevious": "True when an earlier window of days exists — the \"previous days\" arrow is offered.",
+        "hasNext": "True when a later window of days exists — the \"next days\" arrow is offered."
+      },
+      "actions": {
+        "selectSlot": "Select an available slot by id. Emits the same selection the user would by clicking the slot button.",
+        "nextDays": "Page the visible window forward to the next group of days, as the \"next days\" arrow does.",
+        "previousDays": "Page the visible window back to the previous group of days, as the \"previous days\" arrow does.",
+        "showMoreDay": "Render every slot for one day, as the day’s \"Show more\" button does. Only affects what is on screen — `slotsByDay` already lists collapsed slots."
+      }
+    },
     "sparkline": {
+      "state": {
+        "annotationIds": "Ids of the annotations currently drawn, in declaration order. The only ids `select_annotation` will accept — check against this before calling. Ids only, never annotation labels.",
+        "selectable": "True when the host wired an annotation-select handler. False means every `select_annotation` call is a no-op, whatever id is passed.",
+        "pointCount": "Number of positions in the currently rendered series, unmeasured gaps included — reflecting whichever applied last, the `data` prop or an `update_series` call. A count only; the plotted values are never exposed."
+      },
       "actions": {
-        "updateSeries": "Replace the sparkline data without remounting.",
+        "updateSeries": "Replace the sparkline data without remounting. Writes straight into ApexCharts, bypassing React — read the `pointCount` slot back rather than expecting the host tree to reflect it.",
         "exportPng": "Return a PNG data URI of the sparkline.",
-        "selectAnnotation": "Select a drawn annotation, as pressing its band would. No-op unless the host wired onAnnotationSelect and the id names an annotation that is currently drawn."
+        "selectAnnotation": "Select a drawn annotation, as pressing its band would. No-op unless the host wired onAnnotationSelect and the id names an annotation that is currently drawn — check the `selectable` and `annotationIds` slots first, since neither failure produces a signal."
       }
     },
     "stepperAccordion": {
@@ -1377,6 +1524,22 @@
         "reviewRecord": "Review a completed anamnesis in the care plan: expand the intake answers and read the record. No mutation."
       }
     },
+    "appointmentWorkflow": {
+      "workflows": {
+        "browseAgenda": "Navigate the agenda: jump to today, step to the previous or next range, go to a specific date, or switch between day / week / month and the chair or operator resource views. Every range change re-fetches the appointments for the new window.",
+        "createAppointment": "Book a new appointment. Open the form from the \"New appointment\" button or by clicking an empty slot (or an all-day cell) on the agenda, then set the patient, date, start time and duration — or mark it all-day — plus the operator, chair, colour and notes, optionally turning on weekly recurrence, and save. Booking writes patient-identifiable data.",
+        "editAppointment": "Amend an existing appointment. Focus the event card, open its actions popover, choose \"Edit\", change any field in the pre-filled form and save. Editing writes patient-identifiable data.",
+        "moveAppointment": "Reschedule an appointment by dragging or resizing its card, or by choosing \"Move\" in the actions popover and then clicking the target slot. A confirm dialog asks whether to notify the patient by SMS and / or email — each channel is offered only when the patient has that contact detail on file. Cancelling reverts the card to its original slot and commits nothing.",
+        "copyAppointment": "Duplicate an appointment onto another slot: choose \"Copy\" in the actions popover, then click the target slot on the agenda. The copy keeps the original patient, duration, colour and resource. Duplicating writes patient-identifiable data.",
+        "changeAppointmentStatus": "Set an appointment's attendance status — confirmed, waiting, in care, done, cancelled or absent — from the status panel inside its actions popover. The status is patient-identifiable attendance data.",
+        "deleteAppointment": "Remove an appointment from the agenda: choose \"Delete\" in the actions popover and confirm in the alert dialog. Irreversible — the booking is dropped and the slot freed.",
+        "chooseRecurringScope": "Decide how far a move or delete reaches when the appointment belongs to a repeating series: this appointment only, this and following, or all appointments. The chooser precedes the move confirm or the delete, so picking \"all appointments\" before a delete removes the whole series.",
+        "placeWaitingListEntry": "Schedule an unplaced request from the waiting-list rail. Choose \"Place on calendar\" to arm placement mode, click the target slot on the agenda, then confirm the pre-filled form. Saving books the appointment and drops the entry from the rail; cancelling placement returns it untouched.",
+        "findFreeSlot": "Search availability for a waiting-list request: choose \"Find free slot\" on the rail entry to open the multi-day slot picker, page through days, and pick a free slot to pre-fill the appointment form. Slot picking is delegated — activate the slot button carrying `data-slot-id`; SlotGrid exposes no imperative handle.",
+        "filterAvailableOperators": "Toggle \"Available operators only\" so each operator column hides the dates that clinician is absent, leaving only bookable time visible.",
+        "openPatientFolder": "Hand off from an appointment to its patient: choose \"Open patient folder\" in the actions popover to navigate to the Patient Folder context for the booked patient."
+      }
+    },
     "appointments": {
       "workflows": {
         "filterAppointments": "Narrow the agenda by date range, patient, operator, chair, type, or status using the per-column filters.",
@@ -1553,6 +1716,34 @@
         "completeCheckIn": "Finalise the check-in once all steps are done; marks the patient as arrived."
       }
     },
+    "patientFolder": {
+      "workflows": {
+        "openSection": "Switch the folder to one of its section tabs — Anamnesis, Diagnosis, Care Plan, Communications, Documents or Bills — swapping the panel in place beneath the persistent patient banner. The banner and the four patient-level Control Room tools stay put across the switch. TabBar's active tab is a consumer-owned prop with no adapter action, so activation is a native click on the section button. View state only.",
+        "readPatientBanner": "Read the structural summary the persistent patient banner carries — unsigned-document and highlighted-anamnesis counts, unpaid-balance and AI-consent flags — to decide what the folder needs attention on. Identifiers, counts and flags only; never patient identity or clinical content.",
+        "customisePatientFields": "Choose which demographic, contact and address fields the folder shows, and in what order. The banner's field cog and the rail's Patient details tool share one field catalogue, so the choice applies to both. View state only — no patient data is written.",
+        "openPatientTool": "Open, switch or close one of the Control Room tools docked in the inline-end rail. The four patient-level tools — Patient details, Notes, Appointments, Tasks — are folder-owned and available on every section tab; the section-scoped ones (Plan summary and Radiographs on Care Plan, Document preview on Documents) come and go with the active tab. View state only.",
+        "updatePatientDetails": "Correct a patient demographic or contact field inline in the rail's Patient details tool — sex, date of birth, place of birth, fiscal code, profession, phone, email, address. Writes patient-identifiable data.",
+        "addPatientNote": "Add a note to the patient from the folder's Notes tool. The folder has exactly ONE Notes tool, shared by every section tab, so a note filed from any tab lands on the same timeline. A clinical note requires the clinical-note permission — read it before writing. Writes patient-identifiable clinical content.",
+        "openVisitNote": "Open the note recorded at one visit from the Diagnosis tab's evolution grid. The folder owns the address: the tab hands the visit's note id out and the folder routes it into its own Notes tool, which scrolls to and focuses that note — no second panel opens, so the note lives in exactly one place. Pressing the same marker again re-scrolls it. Read-only.",
+        "reviewPatientAppointments": "Read the patient's appointment timeline in the rail — past and upcoming visits — and jump to today or focus one appointment. Read-only; booking happens in the Appointments context, not the folder.",
+        "triagePatientTasks": "Work the patient's follow-up tasks in the rail: filter the list, jump to what is overdue, open a task or tick it done.",
+        "reviewCarePlan": "Read the patient's open care plan in the Care Plan tab — the plan header's lifecycle state and alerts, the charted odontogram, the treatments grid and the rail's plan summary. The folder mounts the shared care-plan-editor surface with its own patient card suppressed, so the folder banner remains the only patient header. Editing the plan is the Care Plan Editor pattern's contract, not the folder's.",
+        "openToothRadiographs": "Open the films charted against one tooth. This is a folder-specific seam: clicking a tooth on the odontogram routes that tooth's radiographs into the FOLDER's Control Room rail (alongside the pinned patient tools) rather than into a plan-local drawer. Read-only.",
+        "reviewAnamnesis": "Read the patient's anamnesis from the folder: the Anamnesis tab mounts the tool's intake surface (the pre-visit questionnaire) and the Diagnosis tab mounts its compile surface (the diagnostic record plus the across-visits evolution grid), both embedded so they sit flush under the folder header. Switch between the tool's own summary / compile / evolution views. Recording measurements, targets and answers is the Anamnesis pattern's contract, not the folder's.",
+        "browseDocuments": "Navigate the patient's document tree in the Documents tab: open a folder, filter by document type, and select files. Reads structural metadata only — ids, kinds, sizes, dates, document types and signature states. Document NAMES can identify a patient and are not returned here.",
+        "previewDocument": "Open a document into the Control Room rail's Document preview. Single-clicking one file previews it; selecting two or more surfaces them as a tabbed preview. Reads only which render branch is active (pdf, image, metadata or empty) — never the document name. Read-only; nothing is downloaded or shared.",
+        "identifyDocuments": "Resolve the display names of the selected documents, or of the one in the rail preview, when the agent must name a file back to the user. Document names routinely identify a patient, so this is the deliberate, audited read — every other document readback stays name-free.",
+        "uploadDocument": "Upload one or more files into the open folder of the patient's document tree. Writes a patient-identifiable document.",
+        "organiseDocuments": "Reorganise the document tree: create a folder, rename an item, or move the selected items into another folder. Only one of these action dialogs can be in flight at a time — read the active action before starting another. Reversible through the same toolbar.",
+        "deleteDocuments": "Delete the selected files or folders from the patient's document tree. Deleting a folder takes everything nested beneath it. Not reversible from this surface — read the selection first and confirm.",
+        "requestDocumentSignature": "Send the selected document out for the patient's signature. The banner's unsigned-documents count is the same signal, so read it to see what is already pending before requesting another. Puts a patient-identifiable document into an outbound signing envelope.",
+        "shareDocuments": "Share the selected documents with the patient. The shared files then appear as a document-share bubble in the Communications thread. Sends patient-identifiable documents out of the practice.",
+        "readMessageThread": "Read the per-patient message thread in the Communications tab — App, SMS, Email and inbound WhatsApp messages in one chronological log, with SMS delivery status and campaign / workflow / document-share provenance on each bubble — and scroll back to the latest message. Read-only.",
+        "composeMessage": "Draft a message to the patient: pick the outbound channel (App, SMS or Email — WhatsApp is inbound-only and never offered) and type the body. On SMS the composer counts GSM/Unicode segments including the appended practice sender name, so read the draft back before sending a long one. Nothing leaves the practice until the draft is submitted.",
+        "sendMessage": "Send the composed message to the patient over the picked channel and append it to the thread. The destination readout beside the channel picker names exactly where it lands — portal account, mobile number or email address — so confirm it before submitting. Sends patient-identifiable content out of the practice.",
+        "enablePatientChannel": "Turn on a communication channel the patient has no route for yet — no portal account, no mobile number, no email address. The composer shows an enablement prompt in place of offering that channel; enabling it adds the channel back to the picker. Requires recording the patient contact detail the channel needs, so it writes patient-identifiable data."
+      }
+    },
     "patientPortal": {
       "workflows": {
         "signInWithCode": "Request a one-time SMS/email code, enter it, and authenticate into the portal.",
@@ -1563,6 +1754,16 @@
         "saveDetails": "Edit and save the patient personal details (contact, address, fiscal code)."
       }
     },
+    "patientRecord": {
+      "workflows": {
+        "openPatientTool": "Switch the Control Room rail between the patient tools — the editable \"Patient details\" panel and the AI summary — or collapse the rail back to its icon strip. View state only; no panel content is exposed.",
+        "readRecordStatus": "Read the structural state of the record already on screen — which patient the panel is bound to, which field keys are visible and in what order, and the card’s counts and flags (unpaid balance, unsigned documents, highlighted anamnesis answers, AI consent). Returns identifiers, counts and field KEYS only, never a field value.",
+        "customizeFieldSet": "Show, hide and reorder the patient fields through the details panel’s cog picker. The one preference drives BOTH surfaces at once, so the main-area summary card reflects the change immediately. Mutates the per-user view preference, not the patient record, and is reversible with the same picker.",
+        "updatePatientField": "Write a patient field value from the details panel — an identity or contact field, or a clinical field such as the diagnosis note. Routes through the consumer’s audited save path, so the same permissions, validation and audit apply as to a human inline edit. Writes patient-identifiable data.",
+        "copyPatientIdentifier": "Copy a sensitive identifier (e.g. the fiscal code) out of the details panel to the clipboard. The copy affordance lives inside the field row and exposes no adapter action, so this workflow documents the boundary rather than driving it: the value leaves the surface, so it is treated as a PHI egress and must be confirmed and audited.",
+        "refreshAiBrief": "Open the AI summary tool in the rail and request a fresh brief over this patient, then read back when it was generated and the shape of its sections (headings, tone, item counts — never the bullet text). Generation is gated upstream by the AI consent banner. Produces patient-identifiable clinical narrative, so it is stricter than EntitySummary’s own entity-agnostic write."
+      }
+    },
     "patients": {
       "workflows": {
         "filterFromNotice": "Apply a WarningStack notice’s \"View\" action to narrow the roster to the flagged patients (e.g. overdue balances, estimate-stage plans).",
@@ -1580,6 +1781,18 @@
         "notifyAdmin": "As a non-owner member, notify the practice owner / admin to activate the Payment Automation module."
       }
     },
+    "periodontalCharting": {
+      "workflows": {
+        "reviewChart": "Read the exam back without changing it: the derived whole-mouth indices (mean probing depth, mean attachment level, plaque %, bleeding on probing %, scored-site and deep-pocket counts) and the narratable per-tooth problem list, ordered clinically with each tooth’s pockets deepest-first — e.g. “46: 8 mm disto-buccal pocket, bleeding, grade 2 mobility”. Structural readings and FDI ids only; the free-text per-tooth note is never returned.",
+        "recordProbingDepths": "Walk the mouth site by site during probing: move focus to a measurement input, then record the pocket depth and the gingival recession in whole millimetres at that site. Writes patient clinical data.",
+        "recordToothFindings": "Record the non-millimetre findings alongside the depths: bleeding on probing and plaque at a site, the tooth’s Miller mobility grade (0–3), and whether the tooth is present or absent. Writes patient clinical data.",
+        "readRiskProfile": "Read the Lang & Tonetti risk hexagon beside the chart: the overall periodontal risk verdict (low / moderate / high) and the per-factor bands (bleeding, pockets, tooth loss, bone loss vs age, smoking, systemic). Ordinal bands only — never the raw clinical inputs. The hexagon is display-only, so there is nothing to drive here.",
+        "recordDiagnosis": "Record the 2017-classification diagnosis for the exam: stage (I–IV), grade (A–C), extent (localised / generalised / molar-incisor) and the ticked contributing factors, then read back the composed diagnosis sentence and whether the form is complete. Writes patient clinical data; the clinician’s free-text note is never exposed.",
+        "saveExam": "Persist the whole periodontal examination — every probing reading plus the recorded diagnosis — against the patient record once charting is finished. Writes patient clinical data.",
+        "clearToothReadings": "Discard every reading captured on one mischarted tooth — all six sites, the mobility grade and the missing / implant flags. Not undoable from this surface; confirm the FDI id with the clinician first.",
+        "clearDiagnosis": "Reset the recorded stage, grade, extent and contributing factors back to empty, leaving the chart readings untouched. Not undoable from this surface."
+      }
+    },
     "practiceProfileHero": {
       "workflows": {
         "viewProfile": "Read the practice's public profile summary — name, tagline, average rating, review count, and trust badges."
@@ -1592,7 +1805,13 @@
         "openPractice": "Open a practice or operator profile from a result card to view contact details and reviews.",
         "filterReviews": "Filter the reviews panel on a profile by star rating to read targeted feedback.",
         "bookVisit": "Start booking a visit from a result card next-available slot or a profile \"Book visit\" CTA.",
-        "navigateMenu": "Open the public header navigation (doctors, pricing, for-practices) or the sign-in / register actions."
+        "navigateMenu": "Open the public header navigation (doctors, pricing, for-practices) or the sign-in / register actions.",
+        "chooseService": "Choose the service to book on the booking page. Type into the service combobox to narrow the practice catalogue, commit the matching service id, then move the flow on. Reading `combobox.query` back confirms what was actually typed; `combobox.value` confirms what stuck. This is the step patients abandon most, so prefer setting the service id directly over leaving a half-typed filter.",
+        "chooseOperator": "Narrow the booking to particular practitioners using the operator multi-select, or clear it back to \"no preference\". An empty selection means any operator — clearing is the correct way to widen availability, not a failure.",
+        "pickSlot": "Find and select an appointment slot in the four-day grid. Read `status` before concluding there is no availability — `loading` means the window has not resolved. Read `slotsByDay` for the bookable ids in view (it already includes slots collapsed behind \"Show more\", so they can be selected without expanding), page with `next_days` / `previous_days` while `hasNext` / `hasPrevious` allow it, then commit with `select_slot`. Selecting a slot only fills the booking draft — it does not book anything.",
+        "submitBookingRequest": "Commit the booking request once a service, slot and patient details are in place. The commit goes through the appointment tool layer, not the form: the details fields (name, email, mobile, optional date of birth and fiscal code, consents) have no adapter and are not addressable through the registry, so send the payload to `appointment.book` rather than trying to type into the form. `goto_step` is only for walking the patient back to a step they left incomplete.",
+        "confirmBookingRequest": "Confirm a pending booking request from the single-use link the patient is emailed (`/conferma?token=…`). The landing page confirms on load and only reports the outcome, so there is no UI to drive — redeem the token through the API. A token is single-use: a second attempt reports \"expired\", which is the correct terminal state, not an error to retry.",
+        "abandonBooking": "Clear an in-progress booking back to an empty flow. Destructive: everything the patient has entered — service, operator, slot and any details already typed — is lost and cannot be recovered from the UI. Confirm with the patient first."
       }
     },
     "roiDashboard": {

package/dist/components/agenda-card/agenda-card.agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agenda-card.agent.d.ts","sourceRoot":"","sources":["../../../src/components/agenda-card/agenda-card.agent.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,eAAO,MAAM,eAAe,EAAE,YAuB7B,CAAC"}
+{"version":3,"file":"agenda-card.agent.d.ts","sourceRoot":"","sources":["../../../src/components/agenda-card/agenda-card.agent.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,eAAO,MAAM,eAAe,EAAE,YAwB7B,CAAC"}

package/dist/components/agenda-card/index.js

@@ -1,5 +1,5 @@
 import { A as e } from "../../_chunks/agenda-card-BCGaQazD.js";
-import { a as d } from "../../_chunks/agenda-card.agent-mTCrkKSZ.js";
+import { a as d } from "../../_chunks/agenda-card.agent-Cb5tuEh3.js";
 import { i as g } from "../../_chunks/is-safe-url-DkETxeHz.js";
 export {
   e as AgendaCard,

package/dist/components/appointment-timeline/index.js

@@ -1,4 +1,4 @@
-import { A as i, a as t } from "../../_chunks/appointment-timeline-B630OT_J.js";
+import { A as i, a as t } from "../../_chunks/appointment-timeline-Bqf1sTU5.js";
 export {
   i as AppointmentTimeline,
   t as appointmentTimelineAgent

package/dist/components/bmi-calculator/index.js

@@ -1,4 +1,4 @@
-import { B as m } from "../../_chunks/bmi-calculator-CM0-G2mg.js";
+import { B as m } from "../../_chunks/bmi-calculator-CpyY13MV.js";
 import { b as e, a as t, c as r, d as T, e as c, f as i, i as b, k as n, l as f } from "../../_chunks/bmi-BxD-tFzU.js";
 export {
   m as BmiCalculator,

package/dist/components/booking/booking.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"booking.d.ts","sourceRoot":"","sources":["../../../src/components/booking/booking.tsx"],"names":[],"mappings":"AA0EA,OAAO,KAAK,EAIV,YAAY,EAOb,MAAM,iBAAiB,CAAC;AA0BzB,YAAY,EACV,cAAc,EACd,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAypE1C,eAAO,MAAM,OAAO,yGAsanB,CAAC"}
+{"version":3,"file":"booking.d.ts","sourceRoot":"","sources":["../../../src/components/booking/booking.tsx"],"names":[],"mappings":"AA0EA,OAAO,KAAK,EAIV,YAAY,EAOb,MAAM,iBAAiB,CAAC;AA0BzB,YAAY,EACV,cAAc,EACd,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAqqE1C,eAAO,MAAM,OAAO,yGAwanB,CAAC"}

package/dist/components/booking/index.js

@@ -1,4 +1,4 @@
-import { B as A, C as R, O as a, b as s } from "../../_chunks/booking-DjNbd7C1.js";
+import { B as A, C as R, O as a, b as s } from "../../_chunks/booking-BjsA7j1-.js";
 export {
   A as Booking,
   R as CONFIRMATION_CHANNEL_ORDER,

package/dist/components/calculator-dialog/calculator-dialog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calculator-dialog.d.ts","sourceRoot":"","sources":["../../../src/components/calculator-dialog/calculator-dialog.tsx"],"names":[],"mappings":"AAeA,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACnD,OAAO,EAAU,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE5D,MAAM,WAAW,qBAAqB;IACpC,gFAAgF;IAChF,OAAO,EAAE,SAAS,CAAC;IACnB,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,QAAQ,EAAE,SAAS,CAAC;IACpB,uEAAuE;IACvE,IAAI,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAClC,6BAA6B;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,uCAAuC;IACvC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iCAAiC;IACjC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,2DAA2D;IAC3D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,gBAAgB,kHAyC5B,CAAC"}
+{"version":3,"file":"calculator-dialog.d.ts","sourceRoot":"","sources":["../../../src/components/calculator-dialog/calculator-dialog.tsx"],"names":[],"mappings":"AAeA,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACnD,OAAO,EAAU,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE5D,MAAM,WAAW,qBAAqB;IACpC,gFAAgF;IAChF,OAAO,EAAE,SAAS,CAAC;IACnB,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,QAAQ,EAAE,SAAS,CAAC;IACpB,uEAAuE;IACvE,IAAI,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAClC,6BAA6B;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,uCAAuC;IACvC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iCAAiC;IACjC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,2DAA2D;IAC3D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,gBAAgB,kHA6C5B,CAAC"}

package/dist/components/calculator-dialog/index.js

@@ -1,4 +1,4 @@
-import { C as l } from "../../_chunks/calculator-dialog-DuXMQSdm.js";
+import { C as l } from "../../_chunks/calculator-dialog-12d3Sxaz.js";
 export {
   l as CalculatorDialog
 };

package/dist/components/care-plan-card/index.js

@@ -1,4 +1,4 @@
-import { C as e, c as C } from "../../_chunks/care-plan-card-1G_f4I5s.js";
+import { C as e, c as C } from "../../_chunks/care-plan-card-BvQy366X.js";
 export {
   e as CarePlanCard,
   C as carePlanCardAgent

package/dist/components/care-plan-entry-card/index.js

@@ -1,4 +1,4 @@
-import { C as n, c as e } from "../../_chunks/care-plan-entry-card-DmBsffHS.js";
+import { C as n, c as e } from "../../_chunks/care-plan-entry-card-apk_5B3O.js";
 export {
   n as CarePlanEntryCard,
   e as carePlanEntryCardAgent

package/dist/components/chat-container/chat-container.agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-container.agent.d.ts","sourceRoot":"","sources":["../../../src/components/chat-container/chat-container.agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,eAAO,MAAM,kBAAkB,EAAE,YAAY,CAAC,mBAAmB,CAoChE,CAAC"}
+{"version":3,"file":"chat-container.agent.d.ts","sourceRoot":"","sources":["../../../src/components/chat-container/chat-container.agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,eAAO,MAAM,kBAAkB,EAAE,YAAY,CAAC,mBAAmB,CAyDhE,CAAC"}

package/dist/components/chat-container/chat-container.d.ts

@@ -7,7 +7,21 @@ export interface ChatContainerHandle {
     scrollToBottom: (opts?: {
         smooth?: boolean;
     }) => void;
+    /**
+     * Escape hatch for host code that needs the live scroll element
+     * (measuring, custom scroll restoration). NOT an agent surface: the
+     * node's subtree is the conversation itself, which is PHI-bearing in
+     * the Alia surfaces, and PRS §26 §7 limits state slots to identifiers
+     * and structural state. The adapter deliberately does not expose it.
+     */
     getScrollViewport: () => HTMLDivElement | null;
+    /**
+     * True when the viewport is pinned to the newest message (within
+     * `BOTTOM_SLACK_PX`). The read-back for `scroll_to_bottom`.
+     */
+    isAtBottom: () => boolean;
+    /** Number of messages currently rendered. Count only — never content. */
+    getMessageCount: () => number;
 }
 export interface ChatContainerProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'id'>, VariantProps<typeof rootVariants> {
     /** Opaque instance id — emitted as `data-component-id` for the agent registry. */

package/dist/components/chat-container/chat-container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-container.d.ts","sourceRoot":"","sources":["../../../src/components/chat-container/chat-container.tsx"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAYlE,QAAA,MAAM,YAAY;;8EAWjB,CAAC;AA4BF,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IACtD,iBAAiB,EAAE,MAAM,cAAc,GAAG,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,kBACf,SACE,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC,EACvD,YAAY,CAAC,OAAO,YAAY,CAAC;IACnC,kFAAkF;IAClF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;2DACuD;IACvD,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IACjD,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;IACnD;;;;;;;;OAQG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,eAAO,MAAM,aAAa,+GA4MzB,CAAC"}
+{"version":3,"file":"chat-container.d.ts","sourceRoot":"","sources":["../../../src/components/chat-container/chat-container.tsx"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAYlE,QAAA,MAAM,YAAY;;8EAWjB,CAAC;AA4BF,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IACtD;;;;;;OAMG;IACH,iBAAiB,EAAE,MAAM,cAAc,GAAG,IAAI,CAAC;IAC/C;;;OAGG;IACH,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,yEAAyE;IACzE,eAAe,EAAE,MAAM,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,kBACf,SACE,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC,EACvD,YAAY,CAAC,OAAO,YAAY,CAAC;IACnC,kFAAkF;IAClF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;2DACuD;IACvD,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IACjD,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;IACnD;;;;;;;;OAQG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,eAAO,MAAM,aAAa,+GAuNzB,CAAC"}

package/dist/components/chat-container/index.js

@@ -1,4 +1,4 @@
-import { C as n, c as e } from "../../_chunks/chat-container-HlFnoEIl.js";
+import { C as n, c as e } from "../../_chunks/chat-container-CYYego1W.js";
 export {
   n as ChatContainer,
   e as chatContainerAgent

package/dist/components/cycle-calculator/cycle-calculator.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { CycleCalculatorHandle } from './cycle-calculator';
+export declare const cycleCalculatorAgent: AgentAdapter<CycleCalculatorHandle>;
+//# sourceMappingURL=cycle-calculator.agent.d.ts.map

package/dist/components/cycle-calculator/cycle-calculator.agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycle-calculator.agent.d.ts","sourceRoot":"","sources":["../../../src/components/cycle-calculator/cycle-calculator.agent.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAQhE,eAAO,MAAM,oBAAoB,EAAE,YAAY,CAAC,qBAAqB,CA2IpE,CAAC"}

package/dist/components/cycle-calculator/cycle-calculator.d.ts

@@ -4,6 +4,48 @@ import { type CyclePrediction } from './cycle';
 declare const rootVariants: (props?: ({
     width?: "auto" | "full" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/** `CyclePrediction` projected onto the agent boundary — ISO dates, no Dates. */
+export interface CyclePredictionSnapshot {
+    /** Estimated ovulation date, `yyyy-MM-dd`. */
+    ovulation: string;
+    /** Fertile window, `yyyy-MM-dd` endpoints. */
+    fertileWindow: {
+        start: string;
+        end: string;
+    };
+    /** Start of the next period, `yyyy-MM-dd`. */
+    nextPeriod: string;
+    /** Current period's bleed range, or null when no period length was given. */
+    periodRange: {
+        start: string;
+        end: string;
+    } | null;
+    /** Start dates of the next few periods, `yyyy-MM-dd`. */
+    upcomingPeriods: string[];
+}
+/**
+ * Curated imperative handle for agent / external automation. Reads the three
+ * cycle inputs and the computed prediction, and drives the inputs the way a
+ * user would. Never exposes patient identity — only structural dates and day
+ * counts. Consumed by `cycle-calculator.agent.ts`; the public `ref` stays the
+ * root DOM element.
+ */
+export interface CycleCalculatorHandle {
+    /** Current inputs — ISO date + day counts, or null when unset. */
+    getInputs: () => {
+        lastPeriodStart: string | null;
+        cycleLength: number | null;
+        periodLength: number | null;
+    };
+    /** Computed prediction, or null until a last-period date is set. */
+    getResult: () => CyclePredictionSnapshot | null;
+    /** Set the last period's start date (`yyyy-MM-dd`, not in the future). */
+    setLastPeriod: (isoDate: string | null) => boolean;
+    /** Set the average cycle length in days (20–45). */
+    setCycleLength: (days: number | null) => boolean;
+    /** Set the period (bleed) length in days (1–14). */
+    setPeriodLength: (days: number | null) => boolean;
+}
 export interface CycleCalculatorProps extends VariantProps<typeof rootVariants> {
     /** Initial cycle length in days. Defaults to 28. */
     defaultCycleLength?: number;

package/dist/components/cycle-calculator/cycle-calculator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cycle-calculator.d.ts","sourceRoot":"","sources":["../../../src/components/cycle-calculator/cycle-calculator.tsx"],"names":[],"mappings":"AAQA,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAQlE,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,eAAe,EAGrB,MAAM,SAAS,CAAC;AAEjB,QAAA,MAAM,YAAY;;8EAKhB,CAAC;AAUH,MAAM,WAAW,oBAAqB,SAAQ,YAAY,CACxD,OAAO,YAAY,CACpB;IACC,oDAAoD;IACpD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,8EAA8E;IAC9E,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI,CAAC;IAC1D,kFAAkF;IAClF,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;IAC5C;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,sEAAsE;IACtE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IACpC,wEAAwE;IACxE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC7B,0DAA0D;IAC1D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,eAAe,iHAmO3B,CAAC"}
+{"version":3,"file":"cycle-calculator.d.ts","sourceRoot":"","sources":["../../../src/components/cycle-calculator/cycle-calculator.tsx"],"names":[],"mappings":"AAQA,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAWlE,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,eAAe,EAGrB,MAAM,SAAS,CAAC;AAEjB,QAAA,MAAM,YAAY;;8EAKhB,CAAC;AAkCH,iFAAiF;AACjF,MAAM,WAAW,uBAAuB;IACtC,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,aAAa,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnD,yDAAyD;IACzD,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,SAAS,EAAE,MAAM;QACf,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B,CAAC;IACF,oEAAoE;IACpE,SAAS,EAAE,MAAM,uBAAuB,GAAG,IAAI,CAAC;IAChD,0EAA0E;IAC1E,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC;IACnD,oDAAoD;IACpD,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC;IACjD,oDAAoD;IACpD,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC;CACnD;AAED,MAAM,WAAW,oBAAqB,SAAQ,YAAY,CACxD,OAAO,YAAY,CACpB;IACC,oDAAoD;IACpD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,8EAA8E;IAC9E,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI,CAAC;IAC1D,kFAAkF;IAClF,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;IAC5C;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,sEAAsE;IACtE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IACpC,wEAAwE;IACxE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC7B,0DAA0D;IAC1D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,eAAe,iHA6R3B,CAAC"}

package/dist/components/cycle-calculator/index.d.ts

@@ -1,4 +1,4 @@
 export { CycleCalculator } from './cycle-calculator';
-export type { CycleCalculatorProps } from './cycle-calculator';
+export type { CycleCalculatorProps, CycleCalculatorHandle, CyclePredictionSnapshot, } from './cycle-calculator';
 export { predictCycle, LUTEAL_PHASE_DAYS, type CycleInput, type CyclePrediction, type DateRange, } from './cycle';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/cycle-calculator/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/cycle-calculator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,SAAS,GACf,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/cycle-calculator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,SAAS,GACf,MAAM,SAAS,CAAC"}

package/dist/components/cycle-calculator/index.js

@@ -1,4 +1,4 @@
-import { C as e, L as l, p as r } from "../../_chunks/cycle-calculator-BwqYVPB4.js";
+import { C as e, L as l, p as r } from "../../_chunks/cycle-calculator-B7fyH-h4.js";
 export {
   e as CycleCalculator,
   l as LUTEAL_PHASE_DAYS,