@everfur/sdk 0.12.1 → 0.14.0

package/dist/web/index.d.cts

@@ -1,38 +1,78 @@
 import { ReactNode, CSSProperties } from 'react';
-import { E as EverfurProviderProps } from '../context-D_bcpHDA.cjs';
-export { a as EverfurConfig, b as EverfurHandle, c as EverfurUser, U as UseEverfurPetProfileState, u as useCapability, d as useEverfur, e as useEverfurPetProfile, f as useEverfurTheme } from '../context-D_bcpHDA.cjs';
-import { C as CapabilityName, a as CapabilityDecision } from '../resolve-D4Ywz5OS.cjs';
-export { b as CapabilityDisabled, D as DisabledLevel } from '../resolve-D4Ywz5OS.cjs';
-import { U as UrgencyDisplayLevel, L as LifecyclePort, E as EverfurChatDraftStore } from '../attachments-BOk3hEAM.cjs';
-export { C as ChatFeedbackReason, a as ChatFeedbackReasonOption, b as ChatSentiment, c as UseChatAttachmentsOptions, d as UseChatAttachmentsState, e as UseEverfurChatState, f as UseEverfurPetsState, u as useChatAttachments, g as useEverfurChat, h as useEverfurPets } from '../attachments-BOk3hEAM.cjs';
-import { P as PetRef, C as ConversationId } from '../ids-B2GAAifq.cjs';
-export { B as Brand, a as ClientId, b as ResponseId, U as UserRef, _ as __brand, c as conversationId, p as petRef, u as userRef } from '../ids-B2GAAifq.cjs';
-import { a as ChatCheckinTarget } from '../ports-gJ3faaWz.cjs';
-export { C as ChatCheckin, b as ChatConversation, c as ChatConversationListOptions, d as ChatConversationPage, e as ChatFeedbackReceipt, f as ChatFeedbackType, g as ChatHistoryOptions, i as ChatMessage, h as ChatMessagePage, j as ChatMessageRole, k as ChatMessageSender, l as ChatStatus, m as Citation, P as PresignedPolicy, S as SendOptions, U as UploadPort } from '../ports-gJ3faaWz.cjs';
-import { P as PetProfileInput } from '../petsRepository-Cqpd3hLU.cjs';
-export { a as PetProfilePatch, R as RegisteredPet, W as WidgetPet, b as WidgetPetProfile } from '../petsRepository-Cqpd3hLU.cjs';
-export { A as AcceptedFrame, a as AnalysisCompleteFrame, b as AnalysisStartedFrame, D as DeltaFrame, c as DoneFrame, E as ErrorFrame, d as EverfurRequest, e as EverfurRequestBase, F as Frame, f as FrameBase, g as FrameKind, H as HeartbeatFrame, h as HttpMethod, M as MultipartBody, T as TransportPort, U as UnknownFrame, i as UrgencyLevel } from '../config-C9zhanL-.cjs';
-export { C as CheckinAnswer, a as CheckinOutcome, W as WatchCase } from '../casesRepository-C8KJmlxE.cjs';
-export { E as EverfurError, a as EverfurErrorCategory, b as EverfurErrorCode, c as categoryFor, i as isRetryableCode, u as userFacingError } from '../EverfurError-DeBqRpQV.cjs';
-export { A as AttachmentError, a as AttachmentErrorCode, b as AttachmentOutcome, c as AttachmentQueue, d as AttachmentState, e as AttachmentStatus } from '../attachments-DXBETOrV.cjs';
-import { U as UploadTransport, F as FileHandle } from '../ports-BN6RHF9W.cjs';
-export { b as FilePort, a as UploadPolicyWire } from '../ports-BN6RHF9W.cjs';
-import { K as KvPort } from '../cacheEpoch-DknKn3S0.cjs';
-export { I as ImageCachePort } from '../cacheEpoch-DknKn3S0.cjs';
-export { E as EverfurClientEvent, a as EverfurEventHandler, L as LogLevel, b as LogRecord, c as LogSink, P as PrepareOptions, d as PrepareResult, e as PrepareStatus, S as SecureStorePort } from '../runtimeTypes-BxxCKMn8.cjs';
-export { T as TelemetryPort } from '../TelemetryPort-BDNr00hu.cjs';
-export { E as ErrorPolicyPort } from '../ErrorPolicyPort-10s3HJCt.cjs';
-export { C as CameraPort, a as CaptureOptions, M as MediaSource } from '../CameraPort-Cv31Pz7g.cjs';
-export { a as EverfurConfigError, E as EverfurResult, b as EverfurThrownError, i as isErr, c as isOk, u as unwrap } from '../EverfurResult-COlXj1wq.cjs';
-export { M as MintedToken, T as TokenProvider } from '../identity-gjurBi7m.cjs';
-export { E as EverfurFaceStyle, a as EverfurThemeAdjustment, f as face, h as headingFace, p as previewTheme, t as themeAdjustments } from '../typeStyle-DJedEu14.cjs';
-import { E as EverfurThemeInput } from '../branding-BCfwLj0h.cjs';
-export { A as APPEARANCE_PRESETS, a as APPEARANCE_PRESET_NAMES, b as APPEARANCE_SIZE_RANGES, c as EverfurAppearance, d as EverfurAppearanceFont, e as EverfurAppearancePreset, f as EverfurAppearanceRules, g as EverfurAppearanceVariables, h as EverfurThemeFontFaceKey, i as EverfurThemeFontUrlsInput, j as EverfurThemeFontsInput, k as EverfurThemeSlotInput, l as EverfurThemeSlotsInput, m as expandAppearance } from '../branding-BCfwLj0h.cjs';
-import { d as EverfurFontWeight, m as EverfurTheme, a as EverfurFontFaceKey } from '../tokens-DLj8OnLH.cjs';
-export { E as EverfurColorTokens, b as EverfurFontFamilies, c as EverfurFontSource, e as EverfurLetterSpacingTokens, f as EverfurLineHeightTokens, g as EverfurMotionDurationTokens, h as EverfurMotionTokens, i as EverfurRadiusTokens, j as EverfurSpaceTokens, k as EverfurSpringToken, l as EverfurTextColorTokens, n as EverfurThemeMeta, o as EverfurThemeSlot, p as EverfurThemeSlotKey, q as EverfurThemeSlotName, r as EverfurThemeSlots, s as EverfurTypeSizeTokens, t as EverfurTypeTokens, u as EverfurWeightTokens, T as THEME_SLOT_KEYS, v as THEME_SLOT_NAMES } from '../tokens-DLj8OnLH.cjs';
-export { b as PetActivityLevel, c as PetAllergy, d as PetAllergySeverity, e as PetBirthDatePrecision, f as PetCondition, a as PetHealthProfile, P as PetHealthProfileInput, g as PetIndoorOutdoor, h as PetMedication, i as PetSex } from '../profile-CSs1wlXT.cjs';
-export { C as CanonicalPetSpecies, c as canonicalPetSpecies } from '../species-BXAIMh7I.cjs';
-import '../requestFunnel-DLZpiFD3.cjs';
+import { E as EverfurProviderProps } from '../context.d-C6MJsMpN.cjs';
+export { a as EverfurConfig, b as EverfurHandle, c as EverfurUser, U as UseEverfurPetProfileState, u as useCapability, d as useEverfur, e as useEverfurPetProfile, f as useEverfurTheme } from '../context.d-C6MJsMpN.cjs';
+import { C as CapabilityName, a as CapabilityDecision } from '../resolve.d-CoQWUy1Y.cjs';
+export { b as CapabilityDisabled, D as DisabledLevel } from '../resolve.d-CoQWUy1Y.cjs';
+import { U as UrgencyDisplayLevel, E as EverfurChatDraftStore } from '../attachments.d-DNUCiyy5.cjs';
+export { C as ChatFeedbackReason, a as ChatFeedbackReasonOption, b as ChatSentiment, c as UseChatAttachmentsOptions, d as UseChatAttachmentsState, e as UseEverfurChatState, f as UseEverfurPetsState, u as useChatAttachments, g as useEverfurChat, h as useEverfurPets } from '../attachments.d-DNUCiyy5.cjs';
+import { P as PetRef, C as ConversationId } from '../ids.d-B2GAAifq.cjs';
+export { B as Brand, a as ClientId, b as ResponseId, U as UserRef, _ as __brand, c as conversationId, p as petRef, u as userRef } from '../ids.d-B2GAAifq.cjs';
+import { a as ChatCheckinTarget } from '../ports.d-DBA_gsq5.cjs';
+export { C as ChatCheckin, b as ChatConversation, c as ChatConversationListOptions, d as ChatConversationPage, e as ChatFeedbackReceipt, f as ChatFeedbackType, g as ChatHistoryOptions, i as ChatMessage, h as ChatMessagePage, j as ChatMessageRole, k as ChatMessageSender, l as ChatStatus, m as Citation, P as PresignedPolicy, S as SendOptions, U as UploadPort } from '../ports.d-DBA_gsq5.cjs';
+import { i as EverfurPresentationInput } from '../presentation.d-vy8kTGfR.cjs';
+export { D as DEFAULT_PRESENTATION, E as EverfurChatAnswerStyle, a as EverfurChatComposerPlaceholder, b as EverfurChatComposerStyle, c as EverfurChatHistoryBarSetting, d as EverfurChatHistoryStyle, e as EverfurChatSendButtonSetting, f as EverfurChatTopCardSetting, g as EverfurHealthPlanLayout, h as EverfurPresentation, l as EverfurPresentationField, j as EverfurSafetyDisclaimerPlacement, p as parsePresentation, r as resolvePresentation } from '../presentation.d-vy8kTGfR.cjs';
+import { P as PetProfileInput } from '../petsRepository.d-B2TpRE7r.cjs';
+export { a as PetProfilePatch, R as RegisteredPet, W as WidgetPet, b as WidgetPetProfile } from '../petsRepository.d-B2TpRE7r.cjs';
+import { L as LifecyclePort } from '../LifecyclePort.d-Cr1p33a7.cjs';
+import { E as EverfurStarterPrompt } from '../quickPrompts.d-NM_81Jc1.cjs';
+import { h as EverfurChatEmptyHeaderContext, i as EverfurChatEmptyState, j as EverfurChatHistoryBar, k as EverfurChatOpeningCard, l as EverfurChatAnswerCards, E as EverfurChatTopCard, m as EverfurChatHistorySheet, b as EverfurHealthPlanProps } from '../threadOptions.d-9r4Csa7k.cjs';
+export { n as EverfurChatAnswerCard, o as EverfurChatAnswerContext, p as EverfurChatFollowUpAction } from '../threadOptions.d-9r4Csa7k.cjs';
+export { A as AcceptedFrame, a as AnalysisCompleteFrame, b as AnalysisStartedFrame, D as DeltaFrame, c as DoneFrame, E as ErrorFrame, d as EverfurRequest, e as EverfurRequestBase, F as Frame, f as FrameBase, g as FrameKind, H as HeartbeatFrame, h as HttpMethod, M as MultipartBody, T as TransportPort, U as UnknownFrame, i as UrgencyLevel } from '../config.d-DJ4mvf_w.cjs';
+export { C as CheckinAnswer, a as CheckinOutcome, W as WatchCase } from '../casesRepository.d-DCnix2pT.cjs';
+export { E as EverfurError, a as EverfurErrorCategory, b as EverfurErrorCode, c as categoryFor, i as isRetryableCode, u as userFacingError } from '../EverfurError.d-8NHtlgzA.cjs';
+export { A as AttachmentError, a as AttachmentErrorCode, b as AttachmentOutcome, c as AttachmentQueue, d as AttachmentState, e as AttachmentStatus } from '../attachments.d-ZEpTUeWN.cjs';
+import { U as UploadTransport, F as FileHandle } from '../ports.d-BX4f4UsB.cjs';
+export { b as FilePort, a as UploadPolicyWire } from '../ports.d-BX4f4UsB.cjs';
+import { C as CaptureRecordsSignature } from '../clinicRequestProps.d-1dCtouGA.cjs';
+import { E as EverfurRecordsPageProps } from '../RecordsPage.d-DMKU0IKc.cjs';
+import { E as EverfurIntroCopy, a as EverfurIntroBlank, b as EverfurRecordsRequested, d as EverfurRecordsLanded } from '../introEvents.d-BkGDT_kG.cjs';
+import { a as EverfurTabId, E as EverfurTabsCopy } from '../tabsModel.d-BfIQg6yS.cjs';
+export { b as EVERFUR_TABS_COPY } from '../tabsModel.d-BfIQg6yS.cjs';
+export { E as EVERFUR_RECORDS_LANDED_EVENT, a as EVERFUR_RECORDS_REQUESTED_EVENT } from '../introEvents.d-dS3fJCH1.cjs';
+export { L as useEverfurPresentation } from '../usePresentation.d-DYTF_ZGf.cjs';
+import { K as KvPort } from '../cacheEpoch.d-DknKn3S0.cjs';
+export { I as ImageCachePort } from '../cacheEpoch.d-DknKn3S0.cjs';
+export { E as EverfurClientEvent, a as EverfurEventHandler, L as LogLevel, b as LogRecord, c as LogSink, P as PrepareOptions, d as PrepareResult, e as PrepareStatus, S as SecureStorePort } from '../runtimeTypes.d-LkwZaF7z.cjs';
+export { T as TelemetryPort } from '../TelemetryPort.d-BDNr00hu.cjs';
+export { E as ErrorPolicyPort } from '../ErrorPolicyPort.d-DirW9hgO.cjs';
+export { C as CameraPort, a as CaptureOptions, M as MediaSource } from '../CameraPort.d-Cv31Pz7g.cjs';
+export { a as EverfurConfigError, E as EverfurResult, b as EverfurThrownError, i as isErr, c as isOk, u as unwrap } from '../EverfurResult.d-BFH-3s6E.cjs';
+export { M as MintedToken, T as TokenProvider } from '../identity.d-CJfnWOdH.cjs';
+export { E as EverfurFaceStyle, a as EverfurThemeAdjustment, f as face, h as headingFace, p as previewTheme, t as themeAdjustments } from '../typeStyle.d-xIZj02Ru.cjs';
+import { E as EverfurThemeInput } from '../branding.d-CTXTUg_8.cjs';
+export { A as APPEARANCE_PRESETS, a as APPEARANCE_PRESET_NAMES, b as APPEARANCE_SIZE_RANGES, c as EverfurAppearance, d as EverfurAppearanceFont, e as EverfurAppearancePreset, f as EverfurAppearanceRules, g as EverfurAppearanceVariables, h as EverfurThemeFontFaceKey, i as EverfurThemeFontUrlsInput, j as EverfurThemeFontsInput, k as EverfurThemeSlotInput, l as EverfurThemeSlotsInput, m as expandAppearance } from '../branding.d-CTXTUg_8.cjs';
+import { d as EverfurFontWeight, m as EverfurTheme, a as EverfurFontFaceKey } from '../tokens.d-DarDaV39.cjs';
+export { E as EverfurColorTokens, b as EverfurFontFamilies, c as EverfurFontSource, e as EverfurLetterSpacingTokens, f as EverfurLineHeightTokens, g as EverfurMotionDurationTokens, h as EverfurMotionTokens, i as EverfurRadiusTokens, j as EverfurSpaceTokens, k as EverfurSpringToken, l as EverfurTextColorTokens, n as EverfurThemeMeta, o as EverfurThemeSlot, p as EverfurThemeSlotKey, q as EverfurThemeSlotName, r as EverfurThemeSlots, s as EverfurTypeSizeTokens, t as EverfurTypeTokens, u as EverfurWeightTokens, T as THEME_SLOT_KEYS, v as THEME_SLOT_KEYS_BY_SLOT, w as THEME_SLOT_NAMES, x as themeSlotKeysFor } from '../tokens.d-DarDaV39.cjs';
+export { b as PetActivityLevel, c as PetAllergy, d as PetAllergySeverity, e as PetBirthDatePrecision, f as PetCondition, a as PetHealthProfile, P as PetHealthProfileInput, g as PetIndoorOutdoor, h as PetMedication, i as PetSex } from '../profile.d-CSs1wlXT.cjs';
+export { C as CanonicalPetSpecies, c as canonicalPetSpecies } from '../species.d-BXAIMh7I.cjs';
+import '../requestFunnel.d-RZex94XX.cjs';
+import '../focus.d-jQWp0hdK.cjs';
+import '../clinicModels.d-BXgKZqDb.cjs';
+import '../models.d-BSqvbTE1.cjs';
+import '../useRecords.d-BYNX01El.cjs';
+import '../features.d-DrQxTw3-.cjs';
+import '../screenProps.d-CQ0qZJkr.cjs';
+import '../clinicBatch.d-Ccmrngcu.cjs';
+import '../recordsAsk.d-C5CGSi3j.cjs';
+import '../sheetSeam.d-BBuEIVsa.cjs';
+
+/**
+ * A host's rule for the follow-ups under a reply (`EverfurChat`'s `followUpPolicy`, opt-in). Without one the
+ * surface draws `visibleFollowUps` exactly as before.
+ */
+interface ChatFollowUpPolicy {
+    /** How many to draw, 1 to 5. With `fill` the surface draws exactly this many whenever it can. Default 3. */
+    readonly count?: number;
+    /** Drop a backend prompt this matches (a visit or booking follow-up a host does not offer). */
+    readonly exclude?: RegExp | ((prompt: string) => boolean);
+    /**
+     * The host's own prompts that top the list up to `count` after the backend's (in order, de-duplicated, the
+     * `exclude` rule applied too). A function receives the member's last question, so the top-ups can follow it.
+     */
+    readonly fill?: readonly string[] | ((lastQuestion: string | null) => readonly string[]);
+    /** A visible label over the follow-ups ("Follow-up questions"). Absent, the list keeps only its accessible name. */
+    readonly label?: string;
+}
 
 /**
  * Wrap the tree ONCE, high. Mounting constructs the runtime (transport, identity, registry,
@@ -130,6 +170,12 @@ interface EverfurChatProps {
      * conversation. Pass `composerSeed` instead when the user should decide whether to send it.
      */
     readonly initialAsk?: string;
+    /**
+     * The identity of this `initialAsk`, when the same words can be asked again: your own id for each tap of an
+     * "Ask Everfur" pill or each push opened. A new key asks again even with the same words. Absent, the
+     * question's own words are the key, so the same question twice in a row is asked once.
+     */
+    readonly initialAskKey?: string | number;
     /**
      * Text to put in the composer on arrival. It is never sent for the user: they edit it, send it or clear
      * it. Only an empty composer is seeded, so nothing they typed is ever replaced.
@@ -139,10 +185,12 @@ interface EverfurChatProps {
      * Your app's lifecycle signals. Everfur has no socket and no polling here, so a message the platform
      * writes into the thread (a follow-up check-in, a reminder) is not visible until something re-reads it.
      * Tell Everfur when your page becomes visible again, when connectivity returns and when a push announced a
-     * change, and the thread and the unread dot catch up on that signal alone. Without this, chat refreshes
-     * only when the user does something.
+     * change, and the thread and the unread dot catch up on that signal alone. Absent, Everfur uses the browser's
+     * own signals (the page becoming visible again, the window `online` event, `navigator.onLine`; see
+     * `createBrowserLifecycle`). Pass your own port to add a push announcement, or `null` to turn the re-read off,
+     * in which case chat refreshes only when the user does something.
      */
-    readonly lifecycle?: LifecyclePort;
+    readonly lifecycle?: LifecyclePort | null;
     /**
      * Your own storage for an unsent draft. Given, what the user typed and did not send survives leaving this
      * screen; absent, the draft lives in memory for as long as the surface is mounted and nowhere else.
@@ -180,6 +228,71 @@ interface EverfurChatProps {
      * 1 to 6. Default 2: a drop-in widget does not claim your page's `<h1>`. Pass 1 when chat IS the page.
      */
     readonly headingLevel?: number;
+    /**
+     * Whether the surface draws its own header bar (the history control, your logo, the pet and its switcher, a new
+     * chat and the vet entry). Default `true`. Pass `false` when your own screen already has a header over chat: the
+     * thread, the urgency banner and the composer are unchanged, and on a wide box the history rail still shows.
+     * Without the header there is no control that opens the history drawer on a narrow box.
+     */
+    readonly header?: boolean;
+    /**
+     * Your own starter chips for the empty thread, in place of Everfur's four (the vet-prep chip included). Each chip
+     * shows its `label`, sends its `prompt` (the label when absent) as the member's next message, and is filled with
+     * its `tint` (any CSS colour) under its `ink`; without a `tint` it takes your theme's highlight. A chip with a blank
+     * label is dropped and at most 8 are drawn. Absent or empty, Everfur's own chips. The words are yours.
+     */
+    readonly starterPrompts?: readonly EverfurStarterPrompt[];
+    /**
+     * Your own content for the top of the empty thread, above its title and starter chips (for example a card of the
+     * pet's top findings). Rendered only while the thread is empty; if it throws, the empty state draws as usual.
+     * Absent, the empty state is Everfur's own. It receives `{ ask }`: a row of your card can ask its question in
+     * this thread directly, with no screen in between.
+     */
+    readonly renderEmptyHeader?: (context: EverfurChatEmptyHeaderContext) => ReactNode;
+    /**
+     * The empty thread's title and layout your way: your title words in place of Everfur's, and classes for the
+     * block, the title, the chip list and each chip (a class drops that element's inline layout). Absent, as before.
+     */
+    readonly emptyState?: EverfurChatEmptyState;
+    /**
+     * Your rule for the follow-ups under a reply: how many (exactly, with `fill`), which backend prompts to drop
+     * (`exclude`, for example visit or booking prompts you do not offer) and your own prompts to top up with.
+     * Absent, at most three of the backend's, as before.
+     */
+    readonly followUpPolicy?: ChatFollowUpPolicy;
+    /**
+     * A history bar over the thread ("Chats" with the thread count, and "New chat"), for a surface with
+     * `header={false}`. The words are yours. Absent, no bar.
+     */
+    readonly historyBar?: EverfurChatHistoryBar;
+    /**
+     * The card a notification-opened thread starts with: drawn in place of the first bubble while that bubble is
+     * `initialAsk`. Pair it with `initialAsk` (the notification's question). Absent, the bubble draws as usual.
+     */
+    readonly initialAskCard?: EverfurChatOpeningCard;
+    /**
+     * Opens the pet's Health Plan (your tab or screen), called with the pet. The focus card the chat draws from the pet's
+     * Health Plan page (when you pass no `topCard`) uses it for its "See her Health Plan" button; without it that card
+     * has no plan button. Also RESERVED for a Health Plan card in an answer, which the chat stream does not carry yet.
+     */
+    readonly onOpenHealthPlan?: (petRef: PetRef | null) => void;
+    /**
+     * The layout settings (PRESENTATION-CONTRACT): answer style, history style, top card, follow-ups, composer mic and
+     * upload, disclaimer placement. Each also comes from your console (render_hints.branding.presentation); a field you
+     * set here wins over the console unless the console locks it. Absent everywhere, the chat draws exactly as before.
+     * `dictation`, `attachments` and `followUpPolicy` count as your explicit values for their fields; `topCard`,
+     * `answerCards` and `historySheet` are content only and never switch a layout on by themselves.
+     */
+    readonly presentation?: EverfurPresentationInput;
+    /** The cards answer style's content and classes (used while `chatAnswerStyle` resolves to `cards`). */
+    readonly answerCards?: EverfurChatAnswerCards;
+    /**
+     * The top card of the empty thread's content (drawn while `chatTopCard` resolves to `focus`, the default). Absent,
+     * the chat reads the pet's Health Plan page and draws its focus when there is one; yours always wins.
+     */
+    readonly topCard?: EverfurChatTopCard;
+    /** The history bottom sheet's words and classes (used while `chatHistoryStyle` resolves to `sheet`). */
+    readonly historySheet?: EverfurChatHistorySheet;
 }
 /**
  * Entitlement-gated, four-state chat surface. Entitlement-OFF renders the CapabilityGate OffState; otherwise
@@ -188,6 +301,23 @@ interface EverfurChatProps {
  */
 declare function EverfurChat(props: EverfurChatProps): ReactNode;
 
+/** True while the host shows Everfur's attribution itself (an `EverfurPoweredBy` is mounted). */
+declare function useHostPoweredBy(): boolean;
+interface EverfurPoweredByProps {
+    /** Your lockup (for example a mark, "powered by" and the everfur wordmark). Absent, Everfur's own words. */
+    readonly children?: ReactNode;
+    readonly className?: string;
+    readonly style?: CSSProperties;
+}
+/** Everfur's attribution where your design puts it; the chat then leaves out its own line. */
+declare function EverfurPoweredBy({ children, className, style }: EverfurPoweredByProps): ReactNode;
+
+/**
+ * The browser's lifecycle signals for EverfurChat: `visibilitychange` from hidden to visible is the foreground
+ * edge, the window `online` event is connectivity returning, and `navigator.onLine === false` reads as offline.
+ */
+declare function createBrowserLifecycle(): LifecyclePort;
+
 interface WebAttachmentTransportOptions {
     /** Test seam: the `fetch` to use. Defaults to the global one. A host has no reason to set it. */
     readonly fetch?: typeof fetch;
@@ -204,6 +334,130 @@ declare function createWebAttachmentTransport(options?: WebAttachmentTransportOp
  */
 declare function fileToAttachmentHandle(file: File): FileHandle;
 
+/**
+ * How the member got here, said by the host (explicit, owner decision (a)): a plain open from the app's own tab
+ * bar, or a deep link (a push, a text, a web card, a "See her plan" button) that names a tab and maybe a question.
+ * Change `key` for each new open, so the same link twice is two opens.
+ */
+type EverfurTabsOpened = {
+    readonly via: 'plain';
+    readonly key?: string | number;
+} | {
+    readonly via: 'link';
+    readonly tab: EverfurTabId;
+    /** A question to start a chat with (the tab is then Ask), and the card the chat opens under (a push's own). */
+    readonly ask?: {
+        readonly prompt: string;
+        readonly card?: EverfurChatOpeningCard;
+    };
+    readonly key?: string | number;
+};
+
+/** EverfurChat's own props, passed through; the shell sets the pet, the question a link carries and the plan door. */
+type EverfurTabsChatProps = Omit<EverfurChatProps, 'petRef' | 'initialAsk' | 'initialAskKey' | 'initialAskCard' | 'onOpenHealthPlan'>;
+/** EverfurHealthPlan's own props, passed through; the shell sets the pet and remounts it on a changed plan. */
+type EverfurTabsPlanProps = Omit<EverfurHealthPlanProps, 'petRef'>;
+/** EverfurRecordsPage's own props, passed through; the shell sets the pet, its name, Ask and the plan door. */
+type EverfurTabsRecordsProps = Omit<EverfurRecordsPageProps, 'petRef' | 'petName'>;
+/** The intro's options (`EverfurTabs intro=`). Every one is optional; `intro={false}` never plays it. */
+interface EverfurTabsIntro {
+    /** Your own words in the intro (each defaults to empty, and an empty line is not drawn). */
+    readonly copy?: Partial<EverfurIntroCopy>;
+    /** The plan's blanks the records ask shows. Absent: the pet's weight and next shots. */
+    readonly blanks?: readonly EverfurIntroBlank[];
+    /** Sent's "Turn on notifications": your app's permission ask; resolve true once on. Absent: Everfur's preferences. */
+    readonly onEnableNotifications?: () => boolean | Promise<boolean>;
+    /** The clinic frame's "Upload a PDF or a photo instead", run once the intro closes. Absent: the Records tab opens. */
+    readonly onUpload?: () => void;
+    /** The consent step's owner name, and your own signature capture. */
+    readonly ownerName?: string;
+    readonly onCaptureSignature?: CaptureRecordsSignature;
+    /** The records-landed banner's app tile (your app's mark). */
+    readonly bannerIcon?: ReactNode;
+    /**
+     * The intro plays only while the page is narrower than this (Raph's intro is the phone's; his web view has none, and
+     * a shell in a desktop column can be phone-narrow). Default 600.
+     */
+    readonly maxWidth?: number;
+}
+/** Class names for a host that keeps its own CSS hooks on the shell's parts (the look itself is inline). */
+interface EverfurTabsClassNames {
+    readonly root?: string;
+    readonly bar?: string;
+    readonly tab?: string;
+    readonly panes?: string;
+    readonly pane?: string;
+    /** The box the chat fills in the Ask pane. */
+    readonly ask?: string;
+    /** The scroller of the Health Plan and Records panes. */
+    readonly scroll?: string;
+}
+interface EverfurTabsProps {
+    /** The pet the three tabs are about. Null: no pet yet (the chat starts unscoped, the plan and records wait). */
+    readonly petRef: PetRef | null;
+    /** The pet's name, for Records and the intro until the plan page names it. */
+    readonly petName?: string | null;
+    /**
+     * How the member got here (explicit): `{ via: 'plain' }` from your app's own tab bar, `{ via: 'link', tab }` from a
+     * push, a text, a web card or a "See her plan" button. A new `key` is a new open. A plain open lands on Health Plan
+     * and may play the intro; a link opens where it points, and the intro waits for the next plain open.
+     */
+    readonly opened: EverfurTabsOpened;
+    /** Whether the shell is on screen (your app's own tab is this one). Default true. */
+    readonly visible?: boolean;
+    readonly copy?: Partial<EverfurTabsCopy>;
+    readonly chat?: EverfurTabsChatProps;
+    readonly plan?: EverfurTabsPlanProps;
+    readonly records?: EverfurTabsRecordsProps;
+    /** Your content around the records page (your own top section over it). Absent: the page alone. */
+    readonly renderRecords?: (page: ReactNode) => ReactNode;
+    /** Your content under a pane (a composer), drawn inside the pane after the SDK's surface. */
+    readonly paneFooter?: Partial<Record<EverfurTabId, ReactNode>>;
+    /**
+     * The pet's results are not back yet (your data): Ask draws no focus card and no pill and offers
+     * `pendingStarterPrompts`, and the intro uses its waiting lines.
+     */
+    readonly resultsPending?: boolean;
+    /** Ask's starters while the results are not back (your words). */
+    readonly pendingStarterPrompts?: readonly EverfurStarterPrompt[];
+    /** The first-open intro. Default on (it plays once per member); false never plays it. */
+    readonly intro?: EverfurTabsIntro | false;
+    /**
+     * The element the intro, the toast and the banner cover (your phone screen, positioned). Absent: the shell itself,
+     * which is then positioned.
+     */
+    readonly overlayContainer?: HTMLElement | null;
+    /** Names the page after the open tab while `visible` (Raph's titles are the tab labels). Default false. */
+    readonly documentTitle?: boolean;
+    readonly onTabChange?: (tab: EverfurTabId) => void;
+    readonly onRecordsRequested?: (event: EverfurRecordsRequested) => void;
+    readonly onRecordsLanded?: (event: EverfurRecordsLanded) => void;
+    /** Your own toast. Absent: Raph's, drawn over the tab bar. */
+    readonly onToast?: (message: string) => void;
+    /**
+     * A ref the shell fills with its handle (open a tab, ask, request records), for your callbacks that live outside its
+     * content, such as a button on a card you pass in `chat`. Content inside the shell reads it with useEverfurTabs().
+     */
+    readonly tabsRef?: {
+        current: EverfurTabsHandle | null;
+    };
+    readonly className?: string;
+    readonly style?: CSSProperties;
+    readonly classNames?: EverfurTabsClassNames;
+}
+/** What the content inside the shell can do: open a tab, ask in the chat, open the records request sheet. */
+interface EverfurTabsHandle {
+    readonly tab: EverfurTabId;
+    open(tab: EverfurTabId): void;
+    /** Opens Ask with a question in a fresh chat. An empty question only opens Ask. */
+    ask(prompt: string, card?: EverfurChatOpeningCard): void;
+    /** Raph's records request sheet (his 2a and 2b): her clinic, the consent, Sent. Backing out stays where you are. */
+    requestRecords(): void;
+}
+/** The shell around you, inside EverfurTabs (a pane footer, your records section); null outside it. */
+declare function useEverfurTabs(): EverfurTabsHandle | null;
+declare function EverfurTabs(props: EverfurTabsProps): ReactNode;
+
 interface EverfurThemeProviderProps {
     /**
      * The clamped client `theme` prop. It wins over the console's branding field by field, except for a field
@@ -246,4 +500,4 @@ declare function headingFaceCss(theme: EverfurTheme, fallback?: EverfurFontFaceK
  */
 declare function createLocalStorageKv(): KvPort;
 
-export { CapabilityDecision, CapabilityGate, type CapabilityGateProps, CapabilityName, ChatCheckinTarget, ConversationId, EverfurChat, EverfurChatDraftStore, type EverfurChatProps, type EverfurFaceCss, EverfurFontFaceKey, EverfurFontWeight, EverfurProvider, EverfurProviderProps, EverfurTheme, EverfurThemeInput, EverfurThemeProvider, type EverfurThemeProviderProps, FileHandle, KvPort, LifecyclePort, PetProfileInput, PetRef, UploadTransport, UrgencyDisplayLevel, type WebAttachmentTransportOptions, createLocalStorageKv, createWebAttachmentTransport, faceCss, fileToAttachmentHandle, headingFaceCss };
+export { CapabilityDecision, CapabilityGate, type CapabilityGateProps, CapabilityName, ChatCheckinTarget, type ChatFollowUpPolicy, ConversationId, EverfurChat, EverfurChatAnswerCards, EverfurChatDraftStore, EverfurChatEmptyHeaderContext, EverfurChatEmptyState, EverfurChatHistoryBar, EverfurChatHistorySheet, EverfurChatOpeningCard, type EverfurChatProps, EverfurChatTopCard, type EverfurFaceCss, EverfurFontFaceKey, EverfurFontWeight, EverfurPoweredBy, type EverfurPoweredByProps, EverfurPresentationInput, EverfurProvider, EverfurProviderProps, EverfurRecordsLanded, EverfurRecordsRequested, EverfurStarterPrompt, EverfurTabId, EverfurTabs, type EverfurTabsChatProps, type EverfurTabsClassNames, EverfurTabsCopy, type EverfurTabsHandle, type EverfurTabsIntro, type EverfurTabsOpened, type EverfurTabsPlanProps, type EverfurTabsProps, type EverfurTabsRecordsProps, EverfurTheme, EverfurThemeInput, EverfurThemeProvider, type EverfurThemeProviderProps, FileHandle, KvPort, LifecyclePort, PetProfileInput, PetRef, UploadTransport, UrgencyDisplayLevel, type WebAttachmentTransportOptions, createBrowserLifecycle, createLocalStorageKv, createWebAttachmentTransport, faceCss, fileToAttachmentHandle, headingFaceCss, useEverfurTabs, useHostPoweredBy };