@hipnation-truth/sdk 0.17.1 → 0.18.0

package/dist/react.d.ts

@@ -1,6 +1,5 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { ConvexReactClient } from 'convex/react';
 import * as convex_browser from 'convex/browser';
 import { ConvexHttpClient } from 'convex/browser';
 
@@ -689,10 +688,20 @@ declare function useConversationMessages(input: {
  */
 type PermissionStatus = "granted" | "denied" | "undetermined" | "unknown";
 interface UseNotificationsOptions {
-    /** Truth API base URL, e.g. https://app.truth.communication-hub.com */
-    apiBaseUrl: string;
-    /** `hn_live_*` API key for the caller's application. */
-    apiKey: string;
+    /**
+     * Truth API base URL — e.g. `https://app.truth.communication-hub.com`.
+     * Optional when the hook is mounted under `<TruthProvider>`: the
+     * provider resolves the URL from the environment (production + uat →
+     * prod Lambda; everything else → sandbox). Pass an override to point
+     * at a per-PR Truth stage (e.g. `https://pr-132-app.sandbox...`).
+     */
+    apiBaseUrl?: string;
+    /**
+     * `hn_live_*` API key for the caller's application. Optional when
+     * provided via `<TruthProvider apiKey={...}>` — the SDK reads it from
+     * context so each hook call doesn't have to repeat the prop.
+     */
+    apiKey?: string;
     /** Current user id — used when registering the device. */
     userId: string | null | undefined;
     /** Optional app version string stored on the device row. */
@@ -733,6 +742,42 @@ interface UseNotificationsResult {
     setBadgeCount: (count: number) => Promise<void>;
 }
 declare function useNotifications(options: UseNotificationsOptions): UseNotificationsResult;
+/**
+ * useNotificationsActions — context-aware factory for the REST-backed
+ * notification actions exposed by `NotificationsResource` (send,
+ * schedule, get/update preferences). Reads `apiBaseUrl` + `apiKey`
+ * from `<TruthProvider>` so call sites don't have to instantiate the
+ * resource with creds inline.
+ *
+ * Returns memoized callbacks so they're stable across re-renders.
+ */
+interface UseNotificationsActions {
+    send: (input: {
+        userId: string;
+        title: string;
+        body: string;
+        data?: Record<string, unknown>;
+        badge?: number;
+        sound?: string;
+    }) => Promise<{
+        delivered: number;
+        failed?: number;
+        suppressed?: boolean;
+        suppressionReason?: string;
+    }>;
+    schedule: (input: {
+        userId: string;
+        title: string;
+        body: string;
+        scheduledAt: string;
+        data?: Record<string, unknown>;
+    }) => Promise<{
+        jobId: string;
+    }>;
+    getPreferences: (userId: string) => Promise<Record<string, unknown>>;
+    updatePreferences: (userId: string, prefs: Record<string, unknown>) => Promise<Record<string, unknown>>;
+}
+declare function useNotificationsActions(): UseNotificationsActions;
 
 /**
  * React hook for patient family-member lookup — Truth SDK.
@@ -1005,776 +1050,331 @@ declare function usePatientsByIds(ids: string[] | null | undefined): UseQueryRes
  */
 declare function usePatientsByPhones(phones: string[] | null | undefined): UseQueryResult<Record<string, Patient>>;
 
-interface TruthProviderProps {
-    /** Truth environment — determines which Convex deployment to connect to */
-    environment?: string;
-    /** Override the Convex URL directly */
-    convexUrl?: string;
-    children: ReactNode;
-}
-declare function TruthProvider({ environment, convexUrl, children, }: TruthProviderProps): react.FunctionComponentElement<{
-    client: ConvexReactClient;
-    children?: React.ReactNode;
-}>;
-
 /**
- * Reminder types — scheduled conversation reminders.
+ * Appointment interfaces for the Truth SDK.
  */
-type ReminderStatus = "pending" | "triggered" | "cancelled";
-interface Reminder {
-    _id: string;
-    conversationId: string;
-    remindAt: string;
-    status: ReminderStatus;
-    note?: string;
-    createdBy: string;
+/**
+ * Normalized appointment record from the Truth platform.
+ */
+interface Appointment {
+    /** Truth platform appointment ID */
+    id: string;
+    /** Associated patient ID */
+    patientId: string;
+    /** Provider/practitioner ID */
+    providerId?: string;
+    /** Provider/practitioner name */
+    providerName?: string;
+    /** Appointment start time (ISO 8601) */
+    startTime: string;
+    /** Appointment end time (ISO 8601) */
+    endTime: string;
+    /** Appointment status */
+    status: string;
+    /** Appointment type or reason */
+    appointmentType?: string;
+    /** Visit reason or chief complaint */
+    reason?: string;
+    /** Location or facility name */
+    location?: string;
+    /** Source EHR system (e.g. "elation", "hint") */
+    sourceSystem?: string;
+    /** ID in the source EHR system */
+    sourceId?: string;
+    /** Associated organization/tenant ID */
+    tenantId: string;
+    /** ISO 8601 timestamp of record creation */
     createdAt: string;
-    triggeredAt?: string;
-    cancelledAt?: string;
-}
-interface ScheduleReminderInput {
-    conversationId: string;
-    remindAt: string | Date;
-    note?: string;
-    createdBy: string;
+    /** ISO 8601 timestamp of last update */
+    updatedAt: string;
 }
-interface ScheduleReminderResult {
-    reminderId: string;
-    remindAt: string;
+/**
+ * Options for listing appointments.
+ */
+interface AppointmentListOptions {
+    /** Filter by patient ID */
+    patientId?: string;
+    /** Filter by start date (ISO 8601 date string) */
+    startDate?: string;
+    /** Filter by end date (ISO 8601 date string) */
+    endDate?: string;
+    /** Filter by appointment status */
+    status?: string;
+    /** Maximum number of results to return */
+    limit?: number;
+    /** Cursor for pagination */
+    cursor?: string;
 }
 
 /**
- * React hooks for conversation reminders — bulk lookup keyed by
- * conversation id. Wraps the public `reminders:listPendingByConversationIds`
- * Convex query so CommHub's inbox can render the reminder clock icon
- * with one reactive subscription for the entire visible list.
- *
- * Must be used within `<TruthProvider />` (see `./provider`).
+ * Configuration interfaces for the Truth SDK.
  */
-
 /**
- * Subscribe to the latest pending reminder for each of the given
- * conversation ids. Returns a `Record<conversationId, Reminder>` —
- * conversations with no pending reminder are absent from the map.
- *
- * Pass an empty array (or `undefined`) to skip the query — useful while
- * the inbox list is still loading.
- *
- * @example
- * ```tsx
- * const ids = conversations.map((c) => c.id);
- * const { data: remindersByConv } = useRemindersForConversations(ids);
- * const r = remindersByConv?.[conv.id]; // Reminder | undefined
- * ```
+ * Environment options for the Truth platform.
  */
-declare function useRemindersForConversations(conversationIds: string[] | null | undefined): UseQueryResult<Record<string, Reminder>>;
-
+declare const ENVIRONMENTS: {
+    readonly local: "local";
+    readonly staging: "staging";
+    readonly stg: "stg";
+    readonly sandbox: "sandbox";
+    readonly uat: "uat";
+    readonly production: "production";
+};
+type Environment = (typeof ENVIRONMENTS)[keyof typeof ENVIRONMENTS];
 /**
- * React hooks for conversation tasks (My Tasks surface).
- *
- * Provides a reactive `useMutation` wrapper around the
- * `conversationTasks:markSeen` Convex mutation so CommHub can replace
- * `useMark_Event_Activity_SeenMutation` from `@/generated/graphql`
- * with a Truth SDK equivalent without touching `react.ts` exports (the
- * central agent wires those).
- *
- * Pattern mirrors the existing hooks in `./conversations.ts`:
- *   - `makeFunctionReference` for decoupled Convex references
- *   - SKIP sentinel for conditional execution
- *   - Returns a stable callback, not a live subscription
- *
- * Must be used within `<TruthProvider />`.
+ * Configuration for initializing a TruthClient.
  */
+interface TruthClientConfig {
+    /** API key for authenticating with the Truth platform (e.g. "hn_live_...") */
+    apiKey: string;
+    /** Target environment */
+    environment: Environment;
+    /** Override the default Convex URL for data access */
+    convexUrl?: string;
+    /** Event source identifier (e.g. "communication-hub.backend") */
+    source?: string;
+    /** Git SHA or version string for event source versioning */
+    sourceVersion?: string;
+    /** Default tenant (organization) ID for events */
+    tenantId?: string;
+    /** Number of events to buffer before flushing (default: 25) */
+    batchSize?: number;
+    /** Interval in milliseconds between automatic flushes (default: 5000) */
+    flushIntervalMs?: number;
+    /** Base URL for the Truth API (overrides environment-based default) */
+    apiBaseUrl?: string;
+    /**
+     * Auto-register the service worker and subscribe to web push on init.
+     * Only applies in browser environments with Push API support.
+     * Default: true.
+     */
+    autoInitServiceWorker?: boolean;
+    /** Path to the service worker file. Default: "/truth-sw.js" */
+    serviceWorkerPath?: string;
+}
 /**
- * Returns a stable `markSeen(taskId, userId)` callback backed by the
- * `conversationTasks:markSeen` Convex mutation. Replaces the Hasura
- * `useMark_Event_Activity_SeenMutation` in CommHub's My Tasks surface.
- *
- * @example
- * ```tsx
- * const markSeen = useConversationTaskMarkSeen();
- *
- * // When a task row is pressed:
- * if (!task.seenBy.includes(userId)) {
- *   markSeen(task.id, userId).catch(console.error);
- * }
- * ```
+ * Actor context attached to tracked events.
  */
-declare function useConversationTaskMarkSeen(): (taskId: string, userId: string) => Promise<{
-    ok: true;
-}>;
+interface ActorContext {
+    actorId: string;
+    actorType: "user" | "system" | "webhook";
+}
+/**
+ * Paginated result wrapper for list operations.
+ */
+interface PaginatedResult<T> {
+    data: T[];
+    cursor: string | null;
+    hasMore: boolean;
+}
 
 /**
- * Typed event definitions for the Truth Platform event store.
+ * AppointmentResource provides data access to normalized appointment records
+ * backed by Convex.
+ */
+
+declare class AppointmentResource {
+    private readonly convex;
+    constructor(convexClient: ConvexHttpClient);
+    /**
+     * Get an appointment by its Truth platform ID.
+     */
+    get(id: string): Promise<Appointment | null>;
+    /**
+     * List appointments with optional filters, pagination, and limit.
+     */
+    list(options?: AppointmentListOptions): Promise<PaginatedResult<Appointment>>;
+}
+
+/**
+ * AttachmentsResource — presigned S3 upload/download + Convex metadata.
  *
- * All 26 event types from the Communication Hub -> Truth Event Store Contract.
- * Events are grouped by domain and include typed payload interfaces.
+ * Replaces CommHub's base64-in-Postgres attachment flow:
+ *   1. client.attachments.createUploadUrl(...) → presigned PUT URL
+ *   2. Client PUTs bytes directly to S3
+ *   3. client.attachments.record(...) → writes Convex metadata
+ *   4. client.attachments.getDownloadUrl(s3Key) → presigned GET URL
  */
-declare const CONVERSATION_EVENTS: {
-    readonly created: "conversation.created.v1";
-    readonly messageSent: "conversation.message_sent.v1";
-    readonly messageReceived: "conversation.message_received.v1";
-    readonly markedRead: "conversation.marked_read.v1";
-    readonly attachmentUploaded: "conversation.attachment_uploaded.v1";
-    readonly attachmentDownloaded: "conversation.attachment_downloaded.v1";
-};
-declare const CALL_EVENTS: {
-    readonly initiated: "call.initiated.v1";
-    readonly connected: "call.connected.v1";
-    readonly ended: "call.ended.v1";
-    readonly missed: "call.missed.v1";
-};
-declare const TASK_EVENTS: {
-    readonly created: "task.created.v1";
-    readonly assigned: "task.assigned.v1";
-    readonly statusChanged: "task.status_changed.v1";
-};
-declare const REMINDER_EVENTS: {
-    readonly scheduled: "reminder.scheduled.v1";
-    readonly triggered: "reminder.triggered.v1";
-};
-declare const TRANSLATION_EVENTS: {
-    readonly requested: "translation.requested.v1";
-    readonly completed: "translation.completed.v1";
-};
-declare const NOTIFICATION_EVENTS: {
-    readonly sent: "notification.sent.v1";
-    readonly delivered: "notification.delivered.v1";
-    readonly opened: "notification.opened.v1";
-};
-declare const PROVIDER_EVENTS: {
-    readonly syncStarted: "provider.sync_started.v1";
-    readonly syncSucceeded: "provider.sync_succeeded.v1";
-    readonly syncFailed: "provider.sync_failed.v1";
-};
-declare const AUTH_EVENTS: {
-    readonly loginSucceeded: "auth.login_succeeded.v1";
-    readonly loginFailed: "auth.login_failed.v1";
-};
-declare const SECURITY_EVENTS: {
-    readonly accessDenied: "security.access_denied.v1";
-};
-type ConversationEventType = (typeof CONVERSATION_EVENTS)[keyof typeof CONVERSATION_EVENTS];
-type CallEventType = (typeof CALL_EVENTS)[keyof typeof CALL_EVENTS];
-type TaskEventType = (typeof TASK_EVENTS)[keyof typeof TASK_EVENTS];
-type ReminderEventType = (typeof REMINDER_EVENTS)[keyof typeof REMINDER_EVENTS];
-type TranslationEventType = (typeof TRANSLATION_EVENTS)[keyof typeof TRANSLATION_EVENTS];
-type NotificationEventType = (typeof NOTIFICATION_EVENTS)[keyof typeof NOTIFICATION_EVENTS];
-type ProviderEventType = (typeof PROVIDER_EVENTS)[keyof typeof PROVIDER_EVENTS];
-type AuthEventType = (typeof AUTH_EVENTS)[keyof typeof AUTH_EVENTS];
-type SecurityEventType = (typeof SECURITY_EVENTS)[keyof typeof SECURITY_EVENTS];
-/**
- * Union of all 26 registered event type strings.
- */
-type EventType = ConversationEventType | CallEventType | TaskEventType | ReminderEventType | TranslationEventType | NotificationEventType | ProviderEventType | AuthEventType | SecurityEventType;
-interface ConversationCreatedPayload {
-    channel: string;
-    origin_system: string;
-    participant_count: number;
+
+interface CreateUploadUrlInput {
+    fileName: string;
+    mimeType: string;
+    size: number;
+    conversationId?: string;
 }
-interface ConversationMessageSentPayload {
-    channel: string;
-    direction: string;
-    message_chars: number;
-    has_attachment: boolean;
-    provider_system: string;
+interface CreateUploadUrlResult {
+    uploadUrl: string;
+    s3Key: string;
+    expiresIn: number;
+    applicationId: string | null;
 }
-interface ConversationMessageReceivedPayload {
-    channel: string;
-    direction: string;
-    message_chars: number;
-    provider_system: string;
+interface GetDownloadUrlResult {
+    url: string;
+    expiresIn: number;
 }
-interface ConversationMarkedReadPayload {
-    read_by_actor_id: string;
-    unread_count_before: number;
-    unread_count_after: number;
+interface RecordAttachmentInput {
+    s3Key: string;
+    fileName: string;
+    mimeType: string;
+    size: number;
+    conversationId?: string;
+    uploadedBy: string;
 }
-interface ConversationAttachmentUploadedPayload {
-    attachment_id: string;
-    mime_type: string;
-    size_bytes: number;
-    storage_class: string;
+interface Attachment {
+    _id: string;
+    s3Key: string;
+    fileName: string;
+    mimeType: string;
+    size: number;
+    conversationId?: string;
+    uploadedBy: string;
+    createdAt: string;
 }
-interface ConversationAttachmentDownloadedPayload {
-    attachment_id: string;
-    download_actor_type: string;
-    access_path: string;
+declare class AttachmentsResource {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly convex;
+    constructor(apiBaseUrl: string, apiKey: string, convexClient: ConvexHttpClient);
+    private post;
+    createUploadUrl(input: CreateUploadUrlInput): Promise<CreateUploadUrlResult>;
+    getDownloadUrl(s3Key: string, expiresIn?: number): Promise<GetDownloadUrlResult>;
+    record(input: RecordAttachmentInput): Promise<{
+        attachmentId: string;
+        s3Key: string;
+    }>;
+    get(attachmentId: string): Promise<Attachment | null>;
+    listByConversation(conversationId: string): Promise<Attachment[]>;
+    /**
+     * One-shot upload: presign → PUT to S3 → record in Convex → return a
+     * 7-day signed download URL ready to embed in an outbound SMS. Caller
+     * passes the resulting `downloadUrl` to `messages.dialpad.sendSms` (or
+     * the new `messages.sendAttachmentMessage`) to actually deliver it.
+     *
+     * Replaces CommHub's NestJS `/send-attachment` controller in a single
+     * SDK call — no base64 round-trip, no legacy `/attachments/:id/download`
+     * REST endpoint required.
+     */
+    upload(input: {
+        file: Blob | ArrayBuffer | Uint8Array;
+        fileName: string;
+        mimeType: string;
+        size: number;
+        conversationId?: string;
+        uploadedBy: string;
+        /** Download URL TTL in seconds. Default 7 days. */
+        downloadExpiresIn?: number;
+    }): Promise<{
+        attachmentId: string;
+        s3Key: string;
+        downloadUrl: string;
+    }>;
 }
-interface CallInitiatedPayload {
-    direction: string;
-    provider_system: string;
-    from_number_ref: string;
-    to_number_ref: string;
+
+/**
+ * ConversationsResource — write methods that hang off a specific
+ * conversation: notes, tasks, outbound messages.
+ *
+ * Replaces CommHub's `truthConversationApi.ts` raw-fetch wrappers so
+ * the frontend goes through a typed SDK surface instead of building
+ * URLs by hand.
+ *
+ * All methods proxy the matching oRPC procedures (`/conversations/*`)
+ * via Truth's application-key auth. Errors surface as
+ * `ConversationsError` with a status code so callers can distinguish
+ * transport failures (status=0) from API rejections (status>=400).
+ */
+/** Address a conversation by either Convex `_id` or the phonePair. */
+interface ConversationAddress {
+    conversationId?: string;
+    phonePair?: string;
 }
-interface CallConnectedPayload {
-    provider_system: string;
-    ring_duration_ms: number;
+type ConversationTaskStatus = "pending" | "completed";
+type ConversationTaskPriority = "high" | "medium" | "low";
+interface CreateConversationNoteInput extends ConversationAddress {
+    eventId?: string;
+    author: string;
+    content: string;
+    status?: string;
+    type?: string;
 }
-interface CallEndedPayload {
-    provider_system: string;
-    duration_ms: number;
-    end_reason: string;
-    disposition: string;
+interface CreateConversationTaskInput extends ConversationAddress {
+    eventId?: string;
+    author: string;
+    description: string;
+    status?: ConversationTaskStatus;
+    priority?: ConversationTaskPriority;
+    assignee?: string;
+    type?: string;
 }
-interface CallMissedPayload {
-    provider_system: string;
-    miss_reason: string;
+interface SetConversationTaskStatusInput {
+    taskId: string;
+    status: ConversationTaskStatus;
+    resolvedBy?: string;
 }
-interface TaskCreatedPayload {
-    task_id: string;
-    created_by: string;
-    assigned_to: string;
-    priority: string;
-    due_at: string;
+interface UpdateConversationTaskInput {
+    taskId: string;
+    /** Conversation the task belongs to. Truth requires this on PATCH. */
+    conversationId: string;
+    /** Required by the Truth task router — see `messages/procedures/tasks.ts`. */
+    author: string;
+    description: string;
+    /** Optional patch fields — pass only the ones you want to change. */
+    priority?: ConversationTaskPriority;
+    status?: ConversationTaskStatus;
+    assignee?: string;
+    type?: string;
 }
-interface TaskAssignedPayload {
-    task_id: string;
-    assigned_to: string;
-    assigned_by: string;
+interface SendConversationMessageInput {
+    fromNumber: string;
+    toNumber: string;
+    message?: string;
+    media?: string;
 }
-interface TaskStatusChangedPayload {
-    task_id: string;
-    status_from: string;
-    status_to: string;
-    changed_by: string;
+interface SendConversationMessageResult {
+    id: number;
+    messageStatus: string;
+    direction: string;
 }
-interface ReminderScheduledPayload {
-    reminder_id: string;
-    conversation_id: string;
-    scheduled_for: string;
-    scheduled_by: string;
+declare class ConversationNotesSubresource {
+    private readonly post;
+    constructor(post: <T>(path: string, body: unknown) => Promise<T>);
+    /** Create a note on a conversation (addressed by id or phonePair). */
+    create(input: CreateConversationNoteInput): Promise<{
+        id: string;
+    }>;
 }
-interface ReminderTriggeredPayload {
-    reminder_id: string;
-    trigger_result: string;
-    notification_attempted: boolean;
+declare class ConversationTasksSubresource {
+    private readonly post;
+    private readonly patch;
+    constructor(post: <T>(path: string, body: unknown) => Promise<T>, patch: <T>(path: string, body: unknown) => Promise<T>);
+    /** Create a task on a conversation. */
+    create(input: CreateConversationTaskInput): Promise<{
+        id: string;
+    }>;
+    /** Mark a task pending or completed. */
+    setStatus(input: SetConversationTaskStatusInput): Promise<{
+        ok: true;
+    }>;
+    /**
+     * Update task fields (priority, assignee, description, type). Wraps
+     * `PATCH /api/conversations/tasks/{id}` so CommHub doesn't have to
+     * direct-fetch for non-status field edits.
+     */
+    update(input: UpdateConversationTaskInput): Promise<{
+        ok: true;
+    }>;
 }
-interface TranslationRequestedPayload {
-    target_language: string;
-    source_language: string;
-    char_count: number;
-    mode: string;
-}
-interface TranslationCompletedPayload {
-    target_language: string;
-    provider: string;
-    latency_ms: number;
-    success: boolean;
-    error_code?: string;
-}
-interface NotificationSentPayload {
-    notification_id: string;
-    channel: string;
-    platform: string;
-    recipient_ref: string;
-    success: boolean;
-}
-interface NotificationDeliveredPayload {
-    notification_id: string;
-    platform: string;
-    delivered_at: string;
-}
-interface NotificationOpenedPayload {
-    notification_id: string;
-    platform: string;
-    opened_at: string;
-}
-interface ProviderSyncStartedPayload {
-    provider_system: string;
-    operation: string;
-    scope: string;
-    batch_id: string;
-}
-interface ProviderSyncSucceededPayload {
-    provider_system: string;
-    operation: string;
-    batch_id: string;
-    records_processed: number;
-    duration_ms: number;
-}
-interface ProviderSyncFailedPayload {
-    provider_system: string;
-    operation: string;
-    batch_id: string;
-    error_code: string;
-    retryable: boolean;
-}
-interface AuthLoginSucceededPayload {
-    auth_provider: string;
-    platform: string;
-    session_ref: string;
-}
-interface AuthLoginFailedPayload {
-    auth_provider: string;
-    platform: string;
-    failure_code: string;
-}
-interface SecurityAccessDeniedPayload {
-    resource: string;
-    policy: string;
-    reason_code: string;
-    actor_id: string;
-}
-/**
- * Maps each event type string to its required payload interface.
- */
-interface EventPayloadMap {
-    "conversation.created.v1": ConversationCreatedPayload;
-    "conversation.message_sent.v1": ConversationMessageSentPayload;
-    "conversation.message_received.v1": ConversationMessageReceivedPayload;
-    "conversation.marked_read.v1": ConversationMarkedReadPayload;
-    "conversation.attachment_uploaded.v1": ConversationAttachmentUploadedPayload;
-    "conversation.attachment_downloaded.v1": ConversationAttachmentDownloadedPayload;
-    "call.initiated.v1": CallInitiatedPayload;
-    "call.connected.v1": CallConnectedPayload;
-    "call.ended.v1": CallEndedPayload;
-    "call.missed.v1": CallMissedPayload;
-    "task.created.v1": TaskCreatedPayload;
-    "task.assigned.v1": TaskAssignedPayload;
-    "task.status_changed.v1": TaskStatusChangedPayload;
-    "reminder.scheduled.v1": ReminderScheduledPayload;
-    "reminder.triggered.v1": ReminderTriggeredPayload;
-    "translation.requested.v1": TranslationRequestedPayload;
-    "translation.completed.v1": TranslationCompletedPayload;
-    "notification.sent.v1": NotificationSentPayload;
-    "notification.delivered.v1": NotificationDeliveredPayload;
-    "notification.opened.v1": NotificationOpenedPayload;
-    "provider.sync_started.v1": ProviderSyncStartedPayload;
-    "provider.sync_succeeded.v1": ProviderSyncSucceededPayload;
-    "provider.sync_failed.v1": ProviderSyncFailedPayload;
-    "auth.login_succeeded.v1": AuthLoginSucceededPayload;
-    "auth.login_failed.v1": AuthLoginFailedPayload;
-    "security.access_denied.v1": SecurityAccessDeniedPayload;
-}
-/**
- * Subject references for the event. Uses tokenized references only -- no PHI.
- */
-interface EventSubject {
-    patient_ref?: string;
-    conversation_id?: string;
-    task_id?: string;
-    call_id?: string;
-}
-/**
- * Actor who triggered the event.
- */
-interface EventActor {
-    actor_id: string;
-    actor_type: "user" | "system" | "webhook";
-}
-/**
- * Compliance metadata for the event.
- */
-interface EventCompliance {
-    pii_level: "none" | "limited" | "full";
-    contains_phi: boolean;
-    consent_context: string;
-    retention_class: string;
-}
-/**
- * Optional overrides when calling truth.track().
- */
-interface TrackOptions {
-    /** Override the default actor for this event */
-    actor?: EventActor;
-    /** Subject references for this event */
-    subject?: EventSubject;
-    /** Compliance metadata for this event */
-    compliance?: EventCompliance;
-    /** Override the default tenant ID for this event */
-    tenantId?: string;
-    /** Override the occurred_at timestamp (ISO 8601) */
-    occurredAt?: string;
-}
-
-/**
- * Configuration interfaces for the Truth SDK.
- */
-/**
- * Environment options for the Truth platform.
- */
-declare const ENVIRONMENTS: {
-    readonly local: "local";
-    readonly staging: "staging";
-    readonly stg: "stg";
-    readonly sandbox: "sandbox";
-    readonly uat: "uat";
-    readonly production: "production";
-};
-type Environment = (typeof ENVIRONMENTS)[keyof typeof ENVIRONMENTS];
-/**
- * Configuration for initializing a TruthClient.
- */
-interface TruthClientConfig {
-    /** API key for authenticating with the Truth platform (e.g. "hn_live_...") */
-    apiKey: string;
-    /** Target environment */
-    environment: Environment;
-    /** Override the default Convex URL for data access */
-    convexUrl?: string;
-    /** Event source identifier (e.g. "communication-hub.backend") */
-    source?: string;
-    /** Git SHA or version string for event source versioning */
-    sourceVersion?: string;
-    /** Default tenant (organization) ID for events */
-    tenantId?: string;
-    /** Number of events to buffer before flushing (default: 25) */
-    batchSize?: number;
-    /** Interval in milliseconds between automatic flushes (default: 5000) */
-    flushIntervalMs?: number;
-    /** Base URL for the Truth API (overrides environment-based default) */
-    apiBaseUrl?: string;
-    /**
-     * Auto-register the service worker and subscribe to web push on init.
-     * Only applies in browser environments with Push API support.
-     * Default: true.
-     */
-    autoInitServiceWorker?: boolean;
-    /** Path to the service worker file. Default: "/truth-sw.js" */
-    serviceWorkerPath?: string;
-}
-/**
- * Actor context attached to tracked events.
- */
-interface ActorContext {
-    actorId: string;
-    actorType: "user" | "system" | "webhook";
-}
-/**
- * Paginated result wrapper for list operations.
- */
-interface PaginatedResult<T> {
-    data: T[];
-    cursor: string | null;
-    hasMore: boolean;
-}
-
-interface TruthTrackingContextValue {
-    track: <T extends EventType>(eventType: T, payload: EventPayloadMap[T], options?: TrackOptions) => void;
-    identify: (actorId: string, actorType: ActorContext["actorType"]) => void;
-}
-interface TruthTrackingProviderProps {
-    /** Truth environment — determines API URL for event delivery */
-    environment?: string;
-    /** Event source identifier */
-    source?: string;
-    /** Source version (git SHA) */
-    sourceVersion?: string;
-    /** Default tenant ID */
-    tenantId?: string;
-    /** API key for authentication */
-    apiKey?: string;
-    children: ReactNode;
-}
-declare function TruthTrackingProvider({ environment, source, sourceVersion, tenantId, apiKey, children, }: TruthTrackingProviderProps): react.FunctionComponentElement<react.ProviderProps<TruthTrackingContextValue | null>>;
-/**
- * Access the Truth tracking context. Must be within a TruthTrackingProvider.
- * Returns `{ track, identify }` for emitting events to Kinesis.
- */
-declare function useTruth(): TruthTrackingContextValue;
-
-/**
- * UserSettingsResource — typed client for the Truth `userSettings` Convex
- * table. Exposes the one mutation CommHub's Settings screen needs:
- * `updateNotifications({ userId, notificationsEnabled })`.
- *
- * Server-side / imperative use:
- *   truth.userSettings.updateNotifications({ userId, notificationsEnabled: true })
- *
- * Reactive React use lives in `@hipnation-truth/sdk/react` via
- * `useUserSettings`.
- */
-
-interface UserSettings {
-    _id: string;
-    userId: string;
-    notificationsEnabled: boolean;
-    createdAt: string;
-    updatedAt: string;
-}
-interface UpdateNotificationsInput {
-    userId: string;
-    notificationsEnabled: boolean;
-}
-interface UpdateNotificationsResult {
-    action: "inserted" | "updated";
-    id: string;
-}
-declare class UserSettingsResource {
-    private readonly convex;
-    constructor(convex: ConvexHttpClient);
-    /**
-     * Upsert notification preferences for a user. Creates the row if it
-     * doesn't exist; patches `notificationsEnabled` + `updatedAt` otherwise.
-     */
-    updateNotifications(input: UpdateNotificationsInput): Promise<UpdateNotificationsResult>;
-}
-
-/**
- * useUserSettings — reactive hook for per-user notification preferences
- * stored in the Truth `userSettings` Convex table.
- *
- * Must be used within `<TruthProvider />` (see `./provider`).
- *
- * @example
- * ```tsx
- * const { data: settings, loading } = useUserSettings(userId);
- * // settings?.notificationsEnabled — boolean or undefined (no row yet)
- * ```
- */
-
-/**
- * Subscribe to the `userSettings` row for `userId`. Returns `null` when
- * no row exists (treat as all-defaults). Returns `undefined` while the
- * Convex query is in-flight.
- *
- * Pass `null` or `undefined` as `userId` to skip the query (e.g. while
- * auth is loading).
- */
-declare function useUserSettings(userId: string | null | undefined): UseQueryResult<UserSettings | null>;
-
-/**
- * Appointment interfaces for the Truth SDK.
- */
-/**
- * Normalized appointment record from the Truth platform.
- */
-interface Appointment {
-    /** Truth platform appointment ID */
-    id: string;
-    /** Associated patient ID */
-    patientId: string;
-    /** Provider/practitioner ID */
-    providerId?: string;
-    /** Provider/practitioner name */
-    providerName?: string;
-    /** Appointment start time (ISO 8601) */
-    startTime: string;
-    /** Appointment end time (ISO 8601) */
-    endTime: string;
-    /** Appointment status */
-    status: string;
-    /** Appointment type or reason */
-    appointmentType?: string;
-    /** Visit reason or chief complaint */
-    reason?: string;
-    /** Location or facility name */
-    location?: string;
-    /** Source EHR system (e.g. "elation", "hint") */
-    sourceSystem?: string;
-    /** ID in the source EHR system */
-    sourceId?: string;
-    /** Associated organization/tenant ID */
-    tenantId: string;
-    /** ISO 8601 timestamp of record creation */
-    createdAt: string;
-    /** ISO 8601 timestamp of last update */
-    updatedAt: string;
-}
-/**
- * Options for listing appointments.
- */
-interface AppointmentListOptions {
-    /** Filter by patient ID */
-    patientId?: string;
-    /** Filter by start date (ISO 8601 date string) */
-    startDate?: string;
-    /** Filter by end date (ISO 8601 date string) */
-    endDate?: string;
-    /** Filter by appointment status */
-    status?: string;
-    /** Maximum number of results to return */
-    limit?: number;
-    /** Cursor for pagination */
-    cursor?: string;
-}
-
-/**
- * AppointmentResource provides data access to normalized appointment records
- * backed by Convex.
- */
-
-declare class AppointmentResource {
-    private readonly convex;
-    constructor(convexClient: ConvexHttpClient);
-    /**
-     * Get an appointment by its Truth platform ID.
-     */
-    get(id: string): Promise<Appointment | null>;
-    /**
-     * List appointments with optional filters, pagination, and limit.
-     */
-    list(options?: AppointmentListOptions): Promise<PaginatedResult<Appointment>>;
-}
-
-/**
- * AttachmentsResource — presigned S3 upload/download + Convex metadata.
- *
- * Replaces CommHub's base64-in-Postgres attachment flow:
- *   1. client.attachments.createUploadUrl(...) → presigned PUT URL
- *   2. Client PUTs bytes directly to S3
- *   3. client.attachments.record(...) → writes Convex metadata
- *   4. client.attachments.getDownloadUrl(s3Key) → presigned GET URL
- */
-
-interface CreateUploadUrlInput {
-    fileName: string;
-    mimeType: string;
-    size: number;
-    conversationId?: string;
-}
-interface CreateUploadUrlResult {
-    uploadUrl: string;
-    s3Key: string;
-    expiresIn: number;
-    applicationId: string | null;
-}
-interface GetDownloadUrlResult {
-    url: string;
-    expiresIn: number;
-}
-interface RecordAttachmentInput {
-    s3Key: string;
-    fileName: string;
-    mimeType: string;
-    size: number;
-    conversationId?: string;
-    uploadedBy: string;
-}
-interface Attachment {
-    _id: string;
-    s3Key: string;
-    fileName: string;
-    mimeType: string;
-    size: number;
-    conversationId?: string;
-    uploadedBy: string;
-    createdAt: string;
-}
-declare class AttachmentsResource {
-    private readonly baseUrl;
-    private readonly apiKey;
-    private readonly convex;
-    constructor(apiBaseUrl: string, apiKey: string, convexClient: ConvexHttpClient);
-    private post;
-    createUploadUrl(input: CreateUploadUrlInput): Promise<CreateUploadUrlResult>;
-    getDownloadUrl(s3Key: string, expiresIn?: number): Promise<GetDownloadUrlResult>;
-    record(input: RecordAttachmentInput): Promise<{
-        attachmentId: string;
-        s3Key: string;
-    }>;
-    get(attachmentId: string): Promise<Attachment | null>;
-    listByConversation(conversationId: string): Promise<Attachment[]>;
-    /**
-     * One-shot upload: presign → PUT to S3 → record in Convex → return a
-     * 7-day signed download URL ready to embed in an outbound SMS. Caller
-     * passes the resulting `downloadUrl` to `messages.dialpad.sendSms` (or
-     * the new `messages.sendAttachmentMessage`) to actually deliver it.
-     *
-     * Replaces CommHub's NestJS `/send-attachment` controller in a single
-     * SDK call — no base64 round-trip, no legacy `/attachments/:id/download`
-     * REST endpoint required.
-     */
-    upload(input: {
-        file: Blob | ArrayBuffer | Uint8Array;
-        fileName: string;
-        mimeType: string;
-        size: number;
-        conversationId?: string;
-        uploadedBy: string;
-        /** Download URL TTL in seconds. Default 7 days. */
-        downloadExpiresIn?: number;
-    }): Promise<{
-        attachmentId: string;
-        s3Key: string;
-        downloadUrl: string;
-    }>;
-}
-
-/**
- * ConversationsResource — write methods that hang off a specific
- * conversation: notes, tasks, outbound messages.
- *
- * Replaces CommHub's `truthConversationApi.ts` raw-fetch wrappers so
- * the frontend goes through a typed SDK surface instead of building
- * URLs by hand.
- *
- * All methods proxy the matching oRPC procedures (`/conversations/*`)
- * via Truth's application-key auth. Errors surface as
- * `ConversationsError` with a status code so callers can distinguish
- * transport failures (status=0) from API rejections (status>=400).
- */
-/** Address a conversation by either Convex `_id` or the phonePair. */
-interface ConversationAddress {
-    conversationId?: string;
-    phonePair?: string;
-}
-type ConversationTaskStatus = "pending" | "completed";
-type ConversationTaskPriority = "high" | "medium" | "low";
-interface CreateConversationNoteInput extends ConversationAddress {
-    eventId?: string;
-    author: string;
-    content: string;
-    status?: string;
-    type?: string;
-}
-interface CreateConversationTaskInput extends ConversationAddress {
-    eventId?: string;
-    author: string;
-    description: string;
-    status?: ConversationTaskStatus;
-    priority?: ConversationTaskPriority;
-    assignee?: string;
-    type?: string;
-}
-interface SetConversationTaskStatusInput {
-    taskId: string;
-    status: ConversationTaskStatus;
-    resolvedBy?: string;
-}
-interface SendConversationMessageInput {
-    fromNumber: string;
-    toNumber: string;
-    message?: string;
-    media?: string;
-}
-interface SendConversationMessageResult {
-    id: number;
-    messageStatus: string;
-    direction: string;
-}
-declare class ConversationNotesSubresource {
-    private readonly post;
-    constructor(post: <T>(path: string, body: unknown) => Promise<T>);
-    /** Create a note on a conversation (addressed by id or phonePair). */
-    create(input: CreateConversationNoteInput): Promise<{
-        id: string;
-    }>;
-}
-declare class ConversationTasksSubresource {
-    private readonly post;
-    constructor(post: <T>(path: string, body: unknown) => Promise<T>);
-    /** Create a task on a conversation. */
-    create(input: CreateConversationTaskInput): Promise<{
-        id: string;
-    }>;
-    /** Mark a task pending or completed. */
-    setStatus(input: SetConversationTaskStatusInput): Promise<{
-        ok: true;
-    }>;
-}
-declare class ConversationMessagesSubresource {
-    private readonly post;
-    constructor(post: <T>(path: string, body: unknown) => Promise<T>);
-    /**
-     * Send an outbound SMS / MMS via the typed `sendMessage` oRPC procedure.
-     *
-     * Prefer this over the generic Dialpad proxy (`messages.dialpad.sendSms`)
-     * — this hits the validated Truth route and consistently surfaces
-     * `ConversationsError` on failure.
-     */
-    send(input: SendConversationMessageInput): Promise<SendConversationMessageResult>;
+declare class ConversationMessagesSubresource {
+    private readonly post;
+    constructor(post: <T>(path: string, body: unknown) => Promise<T>);
+    /**
+     * Send an outbound SMS / MMS via the typed `sendMessage` oRPC procedure.
+     *
+     * Prefer this over the generic Dialpad proxy (`messages.dialpad.sendSms`)
+     * — this hits the validated Truth route and consistently surfaces
+     * `ConversationsError` on failure.
+     */
+    send(input: SendConversationMessageInput): Promise<SendConversationMessageResult>;
 }
 declare class ConversationsResource {
     readonly notes: ConversationNotesSubresource;
@@ -1817,6 +1417,13 @@ declare class ConversationsResource {
         cleared: number;
     }>;
     private postRequest;
+    /**
+     * PATCH variant of `postRequest`. Mirrors the timeout + API-key
+     * handling so callers like `tasks.update()` don't need to roll their
+     * own fetch. The Truth task router treats unknown methods as 405, so
+     * a dedicated PATCH path is required.
+     */
+    private patchRequest;
 }
 
 /**
@@ -2078,437 +1685,784 @@ declare class NotesResource {
      * row to `elationSyncEvents`. Replaces CommHub's `pushNotesToElation`
      * Hasura action.
      */
-    pushConversationToElation(input: PushConversationToElationInput): Promise<PushConversationToElationResult>;
+    pushConversationToElation(input: PushConversationToElationInput): Promise<PushConversationToElationResult>;
+}
+
+/**
+ * NotificationsResource — wraps Truth's /api/notifications/* endpoints.
+ *
+ * Server-side use (for example from a CommHub backend job or
+ * another service): `truth.notifications.send({ userId, title, body })`.
+ *
+ * Client-side React usage lives in `@hipnation-truth/sdk/react` via
+ * the `useNotifications` hook which mirrors `expo-notifications`.
+ */
+type NotificationPlatform = "ios" | "android" | "web";
+interface RegisterDeviceInput {
+    userId: string;
+    platform: NotificationPlatform;
+    nativeToken?: string;
+    webPushSubscription?: {
+        endpoint: string;
+        keys: {
+            p256dh: string;
+            auth: string;
+        };
+    };
+    appVersion?: string;
+    osVersion?: string;
+    locale?: string;
+    timezone?: string;
+    /**
+     * iOS only — which APNs endpoint the `nativeToken` was issued
+     * against. The token bytes don't carry this; it's determined by
+     * the build's `aps-environment` entitlement
+     * (`development` ⇒ sandbox, `production` ⇒ production). When the
+     * consumer is an Expo app, detect via
+     * `Application.getIosPushNotificationServiceEnvironmentAsync()`
+     * from `expo-application` and pass the normalised value here.
+     * Omitting this falls back to the application's default
+     * `pushConfig.ios.environment` server-side.
+     */
+    apnsEnvironment?: "sandbox" | "production";
+}
+interface RegisterDeviceResult {
+    deviceId: string;
+    action: "inserted" | "updated";
+    snsEndpointArn?: string;
+}
+interface UnregisterDeviceInput {
+    nativeToken?: string;
+    deviceId?: string;
+}
+interface SendNotificationInput {
+    userId: string;
+    title: string;
+    body: string;
+    data?: Record<string, unknown>;
+    badge?: number;
+    sound?: string;
+}
+interface SendNotificationResult {
+    delivered: number;
+    failed?: number;
+    suppressed?: boolean;
+    suppressionReason?: string;
+}
+interface NotificationPreferences {
+    channels: {
+        sms: boolean;
+        push: boolean;
+        email: boolean;
+        inApp: boolean;
+    };
+    quietHours?: {
+        enabled: boolean;
+        start: string;
+        end: string;
+        timezone: string;
+    };
+    doNotDisturbUntil?: string;
+    updatedAt: string;
+}
+interface UpdatePreferencesInput {
+    userId: string;
+    channels?: NotificationPreferences["channels"];
+    quietHours?: NotificationPreferences["quietHours"];
+    doNotDisturbUntil?: string | null;
+}
+interface ScheduleNotificationInput extends SendNotificationInput {
+    /** ISO 8601 timestamp; must be strictly in the future. */
+    scheduledAt: string;
+}
+interface ScheduleNotificationResult {
+    jobId: string;
+    scheduledAt: string;
+}
+interface CancelScheduledNotificationResult {
+    cancelled: boolean;
+    reason?: string;
+    status?: string;
+}
+type ScheduledJobStatus = "pending" | "executed" | "cancelled" | "failed";
+interface ScheduledNotification {
+    jobId: string;
+    userId: string;
+    title: string;
+    body: string;
+    data?: unknown;
+    badge?: number;
+    sound?: string;
+    scheduledAt: string;
+    status: ScheduledJobStatus;
+    resultHistoryId?: string;
+    errorMessage?: string;
+    createdAt: string;
+}
+interface PushEventPayload {
+    title: string;
+    body: string;
+    data?: unknown;
+}
+declare class NotificationsResource {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor(apiBaseUrl: string, apiKey: string);
+    private post;
+    private get;
+    private delete;
+    /**
+     * Register a device (or refresh its metadata) for push delivery.
+     * Safe to call repeatedly — the server dedupes by native token.
+     */
+    registerDevice(input: RegisterDeviceInput): Promise<RegisterDeviceResult>;
+    /** Revoke a device — on sign-out or when the OS reports an invalid token. */
+    unregisterDevice(input: UnregisterDeviceInput): Promise<{
+        revoked: boolean;
+    }>;
+    /**
+     * Send a push notification to every active device belonging to
+     * `userId`. Honors the user's notificationPreferences (quiet hours,
+     * DND, channel off) before publishing.
+     */
+    send(input: SendNotificationInput): Promise<SendNotificationResult>;
+    /** Read a user's notification preferences. Returns defaults when no row exists. */
+    getPreferences(userId: string): Promise<NotificationPreferences>;
+    updatePreferences(input: UpdatePreferencesInput): Promise<{
+        ok: boolean;
+    }>;
+    /**
+     * Schedule a future push notification. Convex's native scheduler
+     * fires the send at `scheduledAt` and runs the same delivery
+     * pipeline as `send()` (preferences, devices, history audit).
+     *
+     * Throws `NotificationsError` with status 400 if `scheduledAt` is
+     * not strictly in the future.
+     */
+    schedule(input: ScheduleNotificationInput): Promise<ScheduleNotificationResult>;
+    /**
+     * Cancel a pending scheduled notification. Returns `cancelled: false`
+     * (no error) if the job has already executed, was previously
+     * cancelled, or no longer exists — `reason` describes which case.
+     */
+    cancelScheduled(jobId: string): Promise<CancelScheduledNotificationResult>;
+    /**
+     * List scheduled notifications for a user — pending, executed,
+     * cancelled, or failed. Most-recent first. Default limit 100.
+     */
+    listScheduled(userId: string, options?: {
+        limit?: number;
+    }): Promise<ScheduledNotification[]>;
+    getVapidKey(): Promise<string | null>;
+    onPushReceived(callback: (payload: PushEventPayload) => void): () => void;
+    onPushTapped(callback: (payload: PushEventPayload) => void): () => void;
+}
+
+/**
+ * PatientDetailsResource — merged Hint + Elation patient lookups.
+ *
+ * Backed by the Truth API at /api/patients/details/*, authenticated with
+ * X-API-Key. Replaces CommHub's getPatientDetails / getPatientBasicDetails
+ * / getPatientMedicalDetails actions.
+ */
+interface PatientDetailsInput {
+    hintId?: string;
+    elationId?: string;
+}
+interface PatientDetailsResult {
+    hint: unknown | null;
+    elation: unknown | null;
+    resolvedElationId: string | null;
+}
+interface PatientBasicDetailsResult {
+    hint: unknown | null;
+    elationId: string | null;
+}
+interface PatientMedicalDetailsResult {
+    problems: unknown | null;
+    medications: unknown | null;
+    allergies: unknown | null;
+    appointments: unknown | null;
+}
+declare class PatientDetailsResource {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor(apiBaseUrl: string, apiKey: string);
+    private post;
+    get(input: PatientDetailsInput): Promise<PatientDetailsResult>;
+    getBasic(input: PatientDetailsInput): Promise<PatientBasicDetailsResult>;
+    getMedical(elationId: string): Promise<PatientMedicalDetailsResult>;
+    /**
+     * Trigger a server-side refresh of the patient's Elation medical
+     * records (medications, problems, allergies, appointments) into the
+     * Convex cache. Fire-and-forget — the UI should read via the Convex-
+     * reactive `usePatientMedical` hook.
+     */
+    refreshMedical(elationId: number): Promise<{
+        totals: {
+            medications: number;
+            problems: number;
+            allergies: number;
+            appointments: number;
+        };
+    }>;
+}
+
+/**
+ * PatientResource provides data access to normalized patient records
+ * backed by Convex.
+ */
+
+declare class PatientResource {
+    private readonly convex;
+    constructor(convexClient: ConvexHttpClient);
+    /**
+     * Get a patient by their Truth platform ID.
+     */
+    get(id: string): Promise<Patient | null>;
+    /**
+     * Get a patient by their Elation EHR ID.
+     */
+    getByElationId(elationId: string): Promise<Patient | null>;
+    /**
+     * Get a patient by their Hint EHR ID.
+     */
+    getByHintId(hintId: string): Promise<Patient | null>;
+    /**
+     * List patients with optional search, pagination, and limit.
+     */
+    list(options?: PatientListOptions): Promise<PaginatedResult<Patient>>;
 }
 
 /**
- * NotificationsResource — wraps Truth's /api/notifications/* endpoints.
- *
- * Server-side use (for example from a CommHub backend job or
- * another service): `truth.notifications.send({ userId, title, body })`.
+ * PhysiciansResource — Convex-backed physician lookups.
  *
- * Client-side React usage lives in `@hipnation-truth/sdk/react` via
- * the `useNotifications` hook which mirrors `expo-notifications`.
+ * Populated from Elation by Truth's daily PhysiciansBackfillCron. Replaces
+ * per-physician Elation HTTP hops with a single Convex batch query.
  */
-type NotificationPlatform = "ios" | "android" | "web";
-interface RegisterDeviceInput {
-    userId: string;
-    platform: NotificationPlatform;
-    nativeToken?: string;
-    webPushSubscription?: {
-        endpoint: string;
-        keys: {
-            p256dh: string;
-            auth: string;
-        };
-    };
-    appVersion?: string;
-    osVersion?: string;
-    locale?: string;
-    timezone?: string;
+
+interface Physician {
+    _id: string;
+    elationId: number;
+    firstName?: string;
+    lastName?: string;
+    npi?: string;
+    credentials?: string;
+    specialties?: string[];
+    practice?: number;
+    email?: string;
+    phone?: string;
+    lastSyncedAt: string;
+}
+declare class PhysiciansResource {
+    private readonly convex;
+    constructor(convex: ConvexHttpClient);
     /**
-     * iOS only — which APNs endpoint the `nativeToken` was issued
-     * against. The token bytes don't carry this; it's determined by
-     * the build's `aps-environment` entitlement
-     * (`development` ⇒ sandbox, `production` ⇒ production). When the
-     * consumer is an Expo app, detect via
-     * `Application.getIosPushNotificationServiceEnvironmentAsync()`
-     * from `expo-application` and pass the normalised value here.
-     * Omitting this falls back to the application's default
-     * `pushConfig.ios.environment` server-side.
+     * Resolve a batch of physicians by Elation IDs. Missing ids are dropped.
      */
-    apnsEnvironment?: "sandbox" | "production";
+    getByElationIds(ids: number[]): Promise<Physician[]>;
+    getByElationId(id: number): Promise<Physician | null>;
+    listByPractice(practice: number, limit?: number): Promise<Physician[]>;
 }
-interface RegisterDeviceResult {
-    deviceId: string;
-    action: "inserted" | "updated";
-    snsEndpointArn?: string;
+
+/**
+ * Reminder types — scheduled conversation reminders.
+ */
+type ReminderStatus = "pending" | "triggered" | "cancelled";
+interface Reminder {
+    _id: string;
+    conversationId: string;
+    remindAt: string;
+    status: ReminderStatus;
+    note?: string;
+    createdBy: string;
+    createdAt: string;
+    triggeredAt?: string;
+    cancelledAt?: string;
 }
-interface UnregisterDeviceInput {
-    nativeToken?: string;
-    deviceId?: string;
+interface ScheduleReminderInput {
+    conversationId: string;
+    remindAt: string | Date;
+    note?: string;
+    createdBy: string;
 }
-interface SendNotificationInput {
-    userId: string;
-    title: string;
-    body: string;
-    data?: Record<string, unknown>;
-    badge?: number;
-    sound?: string;
+interface ScheduleReminderResult {
+    reminderId: string;
+    remindAt: string;
 }
-interface SendNotificationResult {
-    delivered: number;
-    failed?: number;
-    suppressed?: boolean;
-    suppressionReason?: string;
+
+/**
+ * RemindersResource — schedule, cancel, and list conversation reminders.
+ *
+ * Backed by Convex mutations/queries (durable scheduled functions) — replaces
+ * the in-memory setTimeout scheduler that used to live in CommHub's NestJS
+ * backend.
+ */
+
+declare class RemindersResource {
+    private readonly convex;
+    constructor(convexClient: ConvexHttpClient);
+    /**
+     * Schedule a reminder to fire at `remindAt`. Returns the reminder id,
+     * which callers should store if they may want to cancel it later.
+     */
+    schedule(input: ScheduleReminderInput): Promise<ScheduleReminderResult>;
+    /**
+     * Cancel a pending reminder. No-op if the reminder has already fired or
+     * been cancelled.
+     */
+    cancel(reminderId: string, cancelledBy: string): Promise<{
+        reminderId: string;
+        status: string;
+    }>;
+    /**
+     * List reminders for a conversation (most recent first).
+     */
+    listByConversation(conversationId: string): Promise<Reminder[]>;
 }
-interface NotificationPreferences {
-    channels: {
-        sms: boolean;
-        push: boolean;
-        email: boolean;
-        inApp: boolean;
-    };
-    quietHours?: {
-        enabled: boolean;
-        start: string;
-        end: string;
-        timezone: string;
-    };
-    doNotDisturbUntil?: string;
+
+type TaskStatus = "open" | "in_progress" | "resolved" | "cancelled";
+interface Task {
+    _id: string;
+    eventId?: string;
+    assignedTo: string;
+    createdBy: string;
+    title: string;
+    description?: string;
+    data?: unknown;
+    status: TaskStatus;
+    resolvedBy?: string;
+    resolvedAt?: string;
+    createdAt: string;
     updatedAt: string;
 }
-interface UpdatePreferencesInput {
-    userId: string;
-    channels?: NotificationPreferences["channels"];
-    quietHours?: NotificationPreferences["quietHours"];
-    doNotDisturbUntil?: string | null;
+interface CreateTaskInput {
+    eventId?: string;
+    assignedTo: string;
+    createdBy: string;
+    title: string;
+    description?: string;
+    data?: unknown;
 }
-interface ScheduleNotificationInput extends SendNotificationInput {
-    /** ISO 8601 timestamp; must be strictly in the future. */
-    scheduledAt: string;
+interface UpdateTaskStatusInput {
+    taskId: string;
+    status: TaskStatus;
+    resolvedBy?: string;
+    data?: unknown;
 }
-interface ScheduleNotificationResult {
-    jobId: string;
-    scheduledAt: string;
+/**
+ * Input for `tasks.markSeen()` — marks a conversation task as seen by
+ * the given user, backing CommHub's My Tasks "unseen" indicator.
+ */
+interface ConversationTaskMarkSeenInput {
+    /** Convex `_id` of the `conversationTasks` row. */
+    taskId: string;
+    /** User id of the person who viewed the task. */
+    userId: string;
 }
-interface CancelScheduledNotificationResult {
-    cancelled: boolean;
-    reason?: string;
-    status?: string;
+
+/**
+ * TasksResource — create, update status, list, get tasks.
+ *
+ * Backed by Convex. Replaces CommHub's createTaskWithNotification +
+ * updateTaskStatusWithNotification actions. Push notification side-effect
+ * is emitted downstream via Kinesis.
+ */
+
+declare class TasksResource {
+    private readonly convex;
+    constructor(convexClient: ConvexHttpClient);
+    create(input: CreateTaskInput): Promise<{
+        taskId: string;
+        status: TaskStatus;
+    }>;
+    updateStatus(input: UpdateTaskStatusInput): Promise<{
+        taskId: string;
+        status: TaskStatus;
+        previousStatus: TaskStatus;
+    }>;
+    get(taskId: string): Promise<Task | null>;
+    listByAssignee(assignedTo: string, options?: {
+        status?: TaskStatus;
+        limit?: number;
+    }): Promise<Task[]>;
+    listOpen(limit?: number): Promise<Task[]>;
+    /**
+     * Mark a conversation task as seen by the given user. Appends `userId`
+     * to the `seenBy` array on the `conversationTasks` row if not already
+     * present. Replaces CommHub's `useMark_Event_Activity_SeenMutation`.
+     *
+     * @returns `{ ok: true }` on success.
+     * @throws if the task does not exist in Convex.
+     */
+    markSeen(input: ConversationTaskMarkSeenInput): Promise<{
+        ok: true;
+    }>;
 }
-type ScheduledJobStatus = "pending" | "executed" | "cancelled" | "failed";
-interface ScheduledNotification {
-    jobId: string;
-    userId: string;
-    title: string;
-    body: string;
-    data?: unknown;
-    badge?: number;
-    sound?: string;
-    scheduledAt: string;
-    status: ScheduledJobStatus;
-    resultHistoryId?: string;
-    errorMessage?: string;
-    createdAt: string;
+
+interface TranslationResult {
+    translatedText: string;
+    detectedLanguage?: {
+        language: string;
+        score: number;
+    };
+    sourceLanguage: string;
+    targetLanguage: string;
 }
-interface PushEventPayload {
-    title: string;
-    body: string;
-    data?: unknown;
+interface DetectionResult {
+    language: string;
+    score: number;
+    isTranslationSupported: boolean;
+    isTransliterationSupported: boolean;
 }
-declare class NotificationsResource {
+interface TranslateTextInput {
+    text: string;
+    targetLanguage: string;
+    sourceLanguage?: string;
+}
+interface TranslateBatchInput {
+    texts: string[];
+    targetLanguage: string;
+    sourceLanguage?: string;
+}
+
+/**
+ * TranslationResource — Azure Translator proxy through Truth API.
+ *
+ * All three operations are HTTP calls to Truth's oRPC endpoints at
+ * `/api/translation/*`, authenticated with the same X-API-Key as the
+ * event tracker.
+ */
+
+declare class TranslationResource {
     private readonly baseUrl;
     private readonly apiKey;
     constructor(apiBaseUrl: string, apiKey: string);
     private post;
-    private get;
-    private delete;
-    /**
-     * Register a device (or refresh its metadata) for push delivery.
-     * Safe to call repeatedly — the server dedupes by native token.
-     */
-    registerDevice(input: RegisterDeviceInput): Promise<RegisterDeviceResult>;
-    /** Revoke a device — on sign-out or when the OS reports an invalid token. */
-    unregisterDevice(input: UnregisterDeviceInput): Promise<{
-        revoked: boolean;
-    }>;
-    /**
-     * Send a push notification to every active device belonging to
-     * `userId`. Honors the user's notificationPreferences (quiet hours,
-     * DND, channel off) before publishing.
-     */
-    send(input: SendNotificationInput): Promise<SendNotificationResult>;
-    /** Read a user's notification preferences. Returns defaults when no row exists. */
-    getPreferences(userId: string): Promise<NotificationPreferences>;
-    updatePreferences(input: UpdatePreferencesInput): Promise<{
-        ok: boolean;
-    }>;
-    /**
-     * Schedule a future push notification. Convex's native scheduler
-     * fires the send at `scheduledAt` and runs the same delivery
-     * pipeline as `send()` (preferences, devices, history audit).
-     *
-     * Throws `NotificationsError` with status 400 if `scheduledAt` is
-     * not strictly in the future.
-     */
-    schedule(input: ScheduleNotificationInput): Promise<ScheduleNotificationResult>;
-    /**
-     * Cancel a pending scheduled notification. Returns `cancelled: false`
-     * (no error) if the job has already executed, was previously
-     * cancelled, or no longer exists — `reason` describes which case.
-     */
-    cancelScheduled(jobId: string): Promise<CancelScheduledNotificationResult>;
+    translate(input: TranslateTextInput): Promise<TranslationResult>;
+    translateBatch(input: TranslateBatchInput): Promise<TranslationResult[]>;
+    detect(text: string): Promise<DetectionResult>;
+}
+
+/**
+ * UserSettingsResource — typed client for the Truth `userSettings` Convex
+ * table. Exposes the one mutation CommHub's Settings screen needs:
+ * `updateNotifications({ userId, notificationsEnabled })`.
+ *
+ * Server-side / imperative use:
+ *   truth.userSettings.updateNotifications({ userId, notificationsEnabled: true })
+ *
+ * Reactive React use lives in `@hipnation-truth/sdk/react` via
+ * `useUserSettings`.
+ */
+
+interface UserSettings {
+    _id: string;
+    userId: string;
+    notificationsEnabled: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+interface UpdateNotificationsInput {
+    userId: string;
+    notificationsEnabled: boolean;
+}
+interface UpdateNotificationsResult {
+    action: "inserted" | "updated";
+    id: string;
+}
+declare class UserSettingsResource {
+    private readonly convex;
+    constructor(convex: ConvexHttpClient);
     /**
-     * List scheduled notifications for a user — pending, executed,
-     * cancelled, or failed. Most-recent first. Default limit 100.
+     * Upsert notification preferences for a user. Creates the row if it
+     * doesn't exist; patches `notificationsEnabled` + `updatedAt` otherwise.
      */
-    listScheduled(userId: string, options?: {
-        limit?: number;
-    }): Promise<ScheduledNotification[]>;
-    getVapidKey(): Promise<string | null>;
-    onPushReceived(callback: (payload: PushEventPayload) => void): () => void;
-    onPushTapped(callback: (payload: PushEventPayload) => void): () => void;
+    updateNotifications(input: UpdateNotificationsInput): Promise<UpdateNotificationsResult>;
 }
 
 /**
- * PatientDetailsResource — merged Hint + Elation patient lookups.
+ * Typed event definitions for the Truth Platform event store.
  *
- * Backed by the Truth API at /api/patients/details/*, authenticated with
- * X-API-Key. Replaces CommHub's getPatientDetails / getPatientBasicDetails
- * / getPatientMedicalDetails actions.
+ * All 26 event types from the Communication Hub -> Truth Event Store Contract.
+ * Events are grouped by domain and include typed payload interfaces.
  */
-interface PatientDetailsInput {
-    hintId?: string;
-    elationId?: string;
+declare const CONVERSATION_EVENTS: {
+    readonly created: "conversation.created.v1";
+    readonly messageSent: "conversation.message_sent.v1";
+    readonly messageReceived: "conversation.message_received.v1";
+    readonly markedRead: "conversation.marked_read.v1";
+    readonly attachmentUploaded: "conversation.attachment_uploaded.v1";
+    readonly attachmentDownloaded: "conversation.attachment_downloaded.v1";
+};
+declare const CALL_EVENTS: {
+    readonly initiated: "call.initiated.v1";
+    readonly connected: "call.connected.v1";
+    readonly ended: "call.ended.v1";
+    readonly missed: "call.missed.v1";
+};
+declare const TASK_EVENTS: {
+    readonly created: "task.created.v1";
+    readonly assigned: "task.assigned.v1";
+    readonly statusChanged: "task.status_changed.v1";
+};
+declare const REMINDER_EVENTS: {
+    readonly scheduled: "reminder.scheduled.v1";
+    readonly triggered: "reminder.triggered.v1";
+};
+declare const TRANSLATION_EVENTS: {
+    readonly requested: "translation.requested.v1";
+    readonly completed: "translation.completed.v1";
+};
+declare const NOTIFICATION_EVENTS: {
+    readonly sent: "notification.sent.v1";
+    readonly delivered: "notification.delivered.v1";
+    readonly opened: "notification.opened.v1";
+};
+declare const PROVIDER_EVENTS: {
+    readonly syncStarted: "provider.sync_started.v1";
+    readonly syncSucceeded: "provider.sync_succeeded.v1";
+    readonly syncFailed: "provider.sync_failed.v1";
+};
+declare const AUTH_EVENTS: {
+    readonly loginSucceeded: "auth.login_succeeded.v1";
+    readonly loginFailed: "auth.login_failed.v1";
+};
+declare const SECURITY_EVENTS: {
+    readonly accessDenied: "security.access_denied.v1";
+};
+type ConversationEventType = (typeof CONVERSATION_EVENTS)[keyof typeof CONVERSATION_EVENTS];
+type CallEventType = (typeof CALL_EVENTS)[keyof typeof CALL_EVENTS];
+type TaskEventType = (typeof TASK_EVENTS)[keyof typeof TASK_EVENTS];
+type ReminderEventType = (typeof REMINDER_EVENTS)[keyof typeof REMINDER_EVENTS];
+type TranslationEventType = (typeof TRANSLATION_EVENTS)[keyof typeof TRANSLATION_EVENTS];
+type NotificationEventType = (typeof NOTIFICATION_EVENTS)[keyof typeof NOTIFICATION_EVENTS];
+type ProviderEventType = (typeof PROVIDER_EVENTS)[keyof typeof PROVIDER_EVENTS];
+type AuthEventType = (typeof AUTH_EVENTS)[keyof typeof AUTH_EVENTS];
+type SecurityEventType = (typeof SECURITY_EVENTS)[keyof typeof SECURITY_EVENTS];
+/**
+ * Union of all 26 registered event type strings.
+ */
+type EventType = ConversationEventType | CallEventType | TaskEventType | ReminderEventType | TranslationEventType | NotificationEventType | ProviderEventType | AuthEventType | SecurityEventType;
+interface ConversationCreatedPayload {
+    channel: string;
+    origin_system: string;
+    participant_count: number;
 }
-interface PatientDetailsResult {
-    hint: unknown | null;
-    elation: unknown | null;
-    resolvedElationId: string | null;
+interface ConversationMessageSentPayload {
+    channel: string;
+    direction: string;
+    message_chars: number;
+    has_attachment: boolean;
+    provider_system: string;
 }
-interface PatientBasicDetailsResult {
-    hint: unknown | null;
-    elationId: string | null;
+interface ConversationMessageReceivedPayload {
+    channel: string;
+    direction: string;
+    message_chars: number;
+    provider_system: string;
+}
+interface ConversationMarkedReadPayload {
+    read_by_actor_id: string;
+    unread_count_before: number;
+    unread_count_after: number;
+}
+interface ConversationAttachmentUploadedPayload {
+    attachment_id: string;
+    mime_type: string;
+    size_bytes: number;
+    storage_class: string;
+}
+interface ConversationAttachmentDownloadedPayload {
+    attachment_id: string;
+    download_actor_type: string;
+    access_path: string;
+}
+interface CallInitiatedPayload {
+    direction: string;
+    provider_system: string;
+    from_number_ref: string;
+    to_number_ref: string;
+}
+interface CallConnectedPayload {
+    provider_system: string;
+    ring_duration_ms: number;
+}
+interface CallEndedPayload {
+    provider_system: string;
+    duration_ms: number;
+    end_reason: string;
+    disposition: string;
+}
+interface CallMissedPayload {
+    provider_system: string;
+    miss_reason: string;
+}
+interface TaskCreatedPayload {
+    task_id: string;
+    created_by: string;
+    assigned_to: string;
+    priority: string;
+    due_at: string;
+}
+interface TaskAssignedPayload {
+    task_id: string;
+    assigned_to: string;
+    assigned_by: string;
+}
+interface TaskStatusChangedPayload {
+    task_id: string;
+    status_from: string;
+    status_to: string;
+    changed_by: string;
 }
-interface PatientMedicalDetailsResult {
-    problems: unknown | null;
-    medications: unknown | null;
-    allergies: unknown | null;
-    appointments: unknown | null;
+interface ReminderScheduledPayload {
+    reminder_id: string;
+    conversation_id: string;
+    scheduled_for: string;
+    scheduled_by: string;
 }
-declare class PatientDetailsResource {
-    private readonly baseUrl;
-    private readonly apiKey;
-    constructor(apiBaseUrl: string, apiKey: string);
-    private post;
-    get(input: PatientDetailsInput): Promise<PatientDetailsResult>;
-    getBasic(input: PatientDetailsInput): Promise<PatientBasicDetailsResult>;
-    getMedical(elationId: string): Promise<PatientMedicalDetailsResult>;
-    /**
-     * Trigger a server-side refresh of the patient's Elation medical
-     * records (medications, problems, allergies, appointments) into the
-     * Convex cache. Fire-and-forget — the UI should read via the Convex-
-     * reactive `usePatientMedical` hook.
-     */
-    refreshMedical(elationId: number): Promise<{
-        totals: {
-            medications: number;
-            problems: number;
-            allergies: number;
-            appointments: number;
-        };
-    }>;
+interface ReminderTriggeredPayload {
+    reminder_id: string;
+    trigger_result: string;
+    notification_attempted: boolean;
 }
-
-/**
- * PatientResource provides data access to normalized patient records
- * backed by Convex.
- */
-
-declare class PatientResource {
-    private readonly convex;
-    constructor(convexClient: ConvexHttpClient);
-    /**
-     * Get a patient by their Truth platform ID.
-     */
-    get(id: string): Promise<Patient | null>;
-    /**
-     * Get a patient by their Elation EHR ID.
-     */
-    getByElationId(elationId: string): Promise<Patient | null>;
-    /**
-     * Get a patient by their Hint EHR ID.
-     */
-    getByHintId(hintId: string): Promise<Patient | null>;
-    /**
-     * List patients with optional search, pagination, and limit.
-     */
-    list(options?: PatientListOptions): Promise<PaginatedResult<Patient>>;
+interface TranslationRequestedPayload {
+    target_language: string;
+    source_language: string;
+    char_count: number;
+    mode: string;
 }
-
-/**
- * PhysiciansResource — Convex-backed physician lookups.
- *
- * Populated from Elation by Truth's daily PhysiciansBackfillCron. Replaces
- * per-physician Elation HTTP hops with a single Convex batch query.
- */
-
-interface Physician {
-    _id: string;
-    elationId: number;
-    firstName?: string;
-    lastName?: string;
-    npi?: string;
-    credentials?: string;
-    specialties?: string[];
-    practice?: number;
-    email?: string;
-    phone?: string;
-    lastSyncedAt: string;
+interface TranslationCompletedPayload {
+    target_language: string;
+    provider: string;
+    latency_ms: number;
+    success: boolean;
+    error_code?: string;
 }
-declare class PhysiciansResource {
-    private readonly convex;
-    constructor(convex: ConvexHttpClient);
-    /**
-     * Resolve a batch of physicians by Elation IDs. Missing ids are dropped.
-     */
-    getByElationIds(ids: number[]): Promise<Physician[]>;
-    getByElationId(id: number): Promise<Physician | null>;
-    listByPractice(practice: number, limit?: number): Promise<Physician[]>;
+interface NotificationSentPayload {
+    notification_id: string;
+    channel: string;
+    platform: string;
+    recipient_ref: string;
+    success: boolean;
 }
-
-/**
- * RemindersResource — schedule, cancel, and list conversation reminders.
- *
- * Backed by Convex mutations/queries (durable scheduled functions) — replaces
- * the in-memory setTimeout scheduler that used to live in CommHub's NestJS
- * backend.
- */
-
-declare class RemindersResource {
-    private readonly convex;
-    constructor(convexClient: ConvexHttpClient);
-    /**
-     * Schedule a reminder to fire at `remindAt`. Returns the reminder id,
-     * which callers should store if they may want to cancel it later.
-     */
-    schedule(input: ScheduleReminderInput): Promise<ScheduleReminderResult>;
-    /**
-     * Cancel a pending reminder. No-op if the reminder has already fired or
-     * been cancelled.
-     */
-    cancel(reminderId: string, cancelledBy: string): Promise<{
-        reminderId: string;
-        status: string;
-    }>;
-    /**
-     * List reminders for a conversation (most recent first).
-     */
-    listByConversation(conversationId: string): Promise<Reminder[]>;
+interface NotificationDeliveredPayload {
+    notification_id: string;
+    platform: string;
+    delivered_at: string;
 }
-
-type TaskStatus = "open" | "in_progress" | "resolved" | "cancelled";
-interface Task {
-    _id: string;
-    eventId?: string;
-    assignedTo: string;
-    createdBy: string;
-    title: string;
-    description?: string;
-    data?: unknown;
-    status: TaskStatus;
-    resolvedBy?: string;
-    resolvedAt?: string;
-    createdAt: string;
-    updatedAt: string;
+interface NotificationOpenedPayload {
+    notification_id: string;
+    platform: string;
+    opened_at: string;
 }
-interface CreateTaskInput {
-    eventId?: string;
-    assignedTo: string;
-    createdBy: string;
-    title: string;
-    description?: string;
-    data?: unknown;
+interface ProviderSyncStartedPayload {
+    provider_system: string;
+    operation: string;
+    scope: string;
+    batch_id: string;
 }
-interface UpdateTaskStatusInput {
-    taskId: string;
-    status: TaskStatus;
-    resolvedBy?: string;
-    data?: unknown;
+interface ProviderSyncSucceededPayload {
+    provider_system: string;
+    operation: string;
+    batch_id: string;
+    records_processed: number;
+    duration_ms: number;
 }
-/**
- * Input for `tasks.markSeen()` — marks a conversation task as seen by
- * the given user, backing CommHub's My Tasks "unseen" indicator.
- */
-interface ConversationTaskMarkSeenInput {
-    /** Convex `_id` of the `conversationTasks` row. */
-    taskId: string;
-    /** User id of the person who viewed the task. */
-    userId: string;
+interface ProviderSyncFailedPayload {
+    provider_system: string;
+    operation: string;
+    batch_id: string;
+    error_code: string;
+    retryable: boolean;
 }
-
-/**
- * TasksResource — create, update status, list, get tasks.
- *
- * Backed by Convex. Replaces CommHub's createTaskWithNotification +
- * updateTaskStatusWithNotification actions. Push notification side-effect
- * is emitted downstream via Kinesis.
- */
-
-declare class TasksResource {
-    private readonly convex;
-    constructor(convexClient: ConvexHttpClient);
-    create(input: CreateTaskInput): Promise<{
-        taskId: string;
-        status: TaskStatus;
-    }>;
-    updateStatus(input: UpdateTaskStatusInput): Promise<{
-        taskId: string;
-        status: TaskStatus;
-        previousStatus: TaskStatus;
-    }>;
-    get(taskId: string): Promise<Task | null>;
-    listByAssignee(assignedTo: string, options?: {
-        status?: TaskStatus;
-        limit?: number;
-    }): Promise<Task[]>;
-    listOpen(limit?: number): Promise<Task[]>;
-    /**
-     * Mark a conversation task as seen by the given user. Appends `userId`
-     * to the `seenBy` array on the `conversationTasks` row if not already
-     * present. Replaces CommHub's `useMark_Event_Activity_SeenMutation`.
-     *
-     * @returns `{ ok: true }` on success.
-     * @throws if the task does not exist in Convex.
-     */
-    markSeen(input: ConversationTaskMarkSeenInput): Promise<{
-        ok: true;
-    }>;
+interface AuthLoginSucceededPayload {
+    auth_provider: string;
+    platform: string;
+    session_ref: string;
 }
-
-interface TranslationResult {
-    translatedText: string;
-    detectedLanguage?: {
-        language: string;
-        score: number;
-    };
-    sourceLanguage: string;
-    targetLanguage: string;
+interface AuthLoginFailedPayload {
+    auth_provider: string;
+    platform: string;
+    failure_code: string;
+}
+interface SecurityAccessDeniedPayload {
+    resource: string;
+    policy: string;
+    reason_code: string;
+    actor_id: string;
 }
-interface DetectionResult {
-    language: string;
-    score: number;
-    isTranslationSupported: boolean;
-    isTransliterationSupported: boolean;
+/**
+ * Maps each event type string to its required payload interface.
+ */
+interface EventPayloadMap {
+    "conversation.created.v1": ConversationCreatedPayload;
+    "conversation.message_sent.v1": ConversationMessageSentPayload;
+    "conversation.message_received.v1": ConversationMessageReceivedPayload;
+    "conversation.marked_read.v1": ConversationMarkedReadPayload;
+    "conversation.attachment_uploaded.v1": ConversationAttachmentUploadedPayload;
+    "conversation.attachment_downloaded.v1": ConversationAttachmentDownloadedPayload;
+    "call.initiated.v1": CallInitiatedPayload;
+    "call.connected.v1": CallConnectedPayload;
+    "call.ended.v1": CallEndedPayload;
+    "call.missed.v1": CallMissedPayload;
+    "task.created.v1": TaskCreatedPayload;
+    "task.assigned.v1": TaskAssignedPayload;
+    "task.status_changed.v1": TaskStatusChangedPayload;
+    "reminder.scheduled.v1": ReminderScheduledPayload;
+    "reminder.triggered.v1": ReminderTriggeredPayload;
+    "translation.requested.v1": TranslationRequestedPayload;
+    "translation.completed.v1": TranslationCompletedPayload;
+    "notification.sent.v1": NotificationSentPayload;
+    "notification.delivered.v1": NotificationDeliveredPayload;
+    "notification.opened.v1": NotificationOpenedPayload;
+    "provider.sync_started.v1": ProviderSyncStartedPayload;
+    "provider.sync_succeeded.v1": ProviderSyncSucceededPayload;
+    "provider.sync_failed.v1": ProviderSyncFailedPayload;
+    "auth.login_succeeded.v1": AuthLoginSucceededPayload;
+    "auth.login_failed.v1": AuthLoginFailedPayload;
+    "security.access_denied.v1": SecurityAccessDeniedPayload;
 }
-interface TranslateTextInput {
-    text: string;
-    targetLanguage: string;
-    sourceLanguage?: string;
+/**
+ * Subject references for the event. Uses tokenized references only -- no PHI.
+ */
+interface EventSubject {
+    patient_ref?: string;
+    conversation_id?: string;
+    task_id?: string;
+    call_id?: string;
 }
-interface TranslateBatchInput {
-    texts: string[];
-    targetLanguage: string;
-    sourceLanguage?: string;
+/**
+ * Actor who triggered the event.
+ */
+interface EventActor {
+    actor_id: string;
+    actor_type: "user" | "system" | "webhook";
 }
-
 /**
- * TranslationResource — Azure Translator proxy through Truth API.
- *
- * All three operations are HTTP calls to Truth's oRPC endpoints at
- * `/api/translation/*`, authenticated with the same X-API-Key as the
- * event tracker.
+ * Compliance metadata for the event.
  */
-
-declare class TranslationResource {
-    private readonly baseUrl;
-    private readonly apiKey;
-    constructor(apiBaseUrl: string, apiKey: string);
-    private post;
-    translate(input: TranslateTextInput): Promise<TranslationResult>;
-    translateBatch(input: TranslateBatchInput): Promise<TranslationResult[]>;
-    detect(text: string): Promise<DetectionResult>;
+interface EventCompliance {
+    pii_level: "none" | "limited" | "full";
+    contains_phi: boolean;
+    consent_context: string;
+    retention_class: string;
+}
+/**
+ * Optional overrides when calling truth.track().
+ */
+interface TrackOptions {
+    /** Override the default actor for this event */
+    actor?: EventActor;
+    /** Subject references for this event */
+    subject?: EventSubject;
+    /** Compliance metadata for this event */
+    compliance?: EventCompliance;
+    /** Override the default tenant ID for this event */
+    tenantId?: string;
+    /** Override the occurred_at timestamp (ISO 8601) */
+    occurredAt?: string;
 }
 
 /**
@@ -2619,6 +2573,225 @@ declare class TruthClient {
     destroy(): Promise<void>;
 }
 
+declare const CONVEX_URLS: Record<string, string>;
+declare const API_BASE_URLS: Record<string, string>;
+/**
+ * Resolve the Convex URL for a given environment. Honors an explicit
+ * override and falls back to sandbox for unknown environments.
+ */
+declare function resolveConvexUrl(environment: string | undefined, override?: string): string;
+/**
+ * Resolve the Truth REST API base URL for a given environment. Mirrors
+ * `resolveConvexUrl`. Honors an explicit override and falls back to
+ * sandbox for unknown environments.
+ */
+declare function resolveApiBaseUrl(environment: string | undefined, override?: string): string;
+interface TruthSdkContextValue {
+    apiBaseUrl: string;
+    apiKey: string;
+    environment: string;
+    client: TruthClient;
+}
+/**
+ * Read the Truth REST API base URL + API key + shared client from
+ * `TruthProvider`. Returns `null` when the provider isn't mounted,
+ * which lets hooks fall back to explicit options for backwards
+ * compatibility.
+ */
+declare function useTruthSdkContext(): TruthSdkContextValue | null;
+/**
+ * Hook variant of `getTruthClient()` for code that lives inside the
+ * React tree. Returns the shared `TruthClient` instance from
+ * `TruthProvider`. Throws if the provider isn't mounted.
+ */
+declare function useTruthClient(): TruthClient;
+/**
+ * Return the shared `TruthClient` instance set by `<TruthProvider>`.
+ * Throws if `TruthProvider` hasn't mounted yet — call this only from
+ * code that runs after the provider has rendered (event handlers,
+ * effects, async helpers invoked from rendered components).
+ */
+declare function getTruthClient(): TruthClient;
+interface TruthProviderProps {
+    /** Truth environment — determines which Convex + Lambda deployment to use */
+    environment?: string;
+    /** Override the Convex URL directly */
+    convexUrl?: string;
+    /**
+     * Override the Truth REST API base URL directly. Optional — defaults
+     * to the environment-mapped URL (`API_BASE_URLS[environment]`), then
+     * falls back to `process.env.EXPO_PUBLIC_TRUTH_API_BASE_URL` if set.
+     */
+    apiBaseUrl?: string;
+    /**
+     * `hn_live_*` API key for the caller's application. Optional —
+     * defaults to `process.env.EXPO_PUBLIC_TRUTH_API_KEY`. Stored in
+     * React context + on the shared TruthClient, never logged.
+     */
+    apiKey?: string;
+    /**
+     * Optional source / tenant metadata for event tracking. Mirrors
+     * `TruthClient` constructor options.
+     */
+    source?: string;
+    sourceVersion?: string;
+    tenantId?: string;
+    children: ReactNode;
+}
+declare function TruthProvider({ environment, convexUrl, apiBaseUrl, apiKey, source, sourceVersion, tenantId, children, }: TruthProviderProps): react.FunctionComponentElement<react.ProviderProps<TruthSdkContextValue | null>>;
+
+/**
+ * React hooks for conversation reminders — bulk lookup keyed by
+ * conversation id. Wraps the public `reminders:listPendingByConversationIds`
+ * Convex query so CommHub's inbox can render the reminder clock icon
+ * with one reactive subscription for the entire visible list.
+ *
+ * Must be used within `<TruthProvider />` (see `./provider`).
+ */
+
+/**
+ * Subscribe to the latest pending reminder for each of the given
+ * conversation ids. Returns a `Record<conversationId, Reminder>` —
+ * conversations with no pending reminder are absent from the map.
+ *
+ * Pass an empty array (or `undefined`) to skip the query — useful while
+ * the inbox list is still loading.
+ *
+ * @example
+ * ```tsx
+ * const ids = conversations.map((c) => c.id);
+ * const { data: remindersByConv } = useRemindersForConversations(ids);
+ * const r = remindersByConv?.[conv.id]; // Reminder | undefined
+ * ```
+ */
+declare function useRemindersForConversations(conversationIds: string[] | null | undefined): UseQueryResult<Record<string, Reminder>>;
+
+/**
+ * React hooks for conversation tasks (My Tasks surface).
+ *
+ * Provides a reactive `useMutation` wrapper around the
+ * `conversationTasks:markSeen` Convex mutation so CommHub can replace
+ * `useMark_Event_Activity_SeenMutation` from `@/generated/graphql`
+ * with a Truth SDK equivalent without touching `react.ts` exports (the
+ * central agent wires those).
+ *
+ * Pattern mirrors the existing hooks in `./conversations.ts`:
+ *   - `makeFunctionReference` for decoupled Convex references
+ *   - SKIP sentinel for conditional execution
+ *   - Returns a stable callback, not a live subscription
+ *
+ * Must be used within `<TruthProvider />`.
+ */
+/**
+ * Returns a stable `markSeen(taskId, userId)` callback backed by the
+ * `conversationTasks:markSeen` Convex mutation. Replaces the Hasura
+ * `useMark_Event_Activity_SeenMutation` in CommHub's My Tasks surface.
+ *
+ * @example
+ * ```tsx
+ * const markSeen = useConversationTaskMarkSeen();
+ *
+ * // When a task row is pressed:
+ * if (!task.seenBy.includes(userId)) {
+ *   markSeen(task.id, userId).catch(console.error);
+ * }
+ * ```
+ */
+declare function useConversationTaskMarkSeen(): (taskId: string, userId: string) => Promise<{
+    ok: true;
+}>;
+
+interface TruthTrackingContextValue {
+    track: <T extends EventType>(eventType: T, payload: EventPayloadMap[T], options?: TrackOptions) => void;
+    identify: (actorId: string, actorType: ActorContext["actorType"]) => void;
+}
+interface TruthTrackingProviderProps {
+    /** Truth environment — determines API URL for event delivery */
+    environment?: string;
+    /** Event source identifier */
+    source?: string;
+    /** Source version (git SHA) */
+    sourceVersion?: string;
+    /** Default tenant ID */
+    tenantId?: string;
+    /** API key for authentication */
+    apiKey?: string;
+    children: ReactNode;
+}
+declare function TruthTrackingProvider({ environment, source, sourceVersion, tenantId, apiKey, children, }: TruthTrackingProviderProps): react.FunctionComponentElement<react.ProviderProps<TruthTrackingContextValue | null>>;
+/**
+ * Access the Truth tracking context. Must be within a TruthTrackingProvider.
+ * Returns `{ track, identify }` for emitting events to Kinesis.
+ */
+declare function useTruth(): TruthTrackingContextValue;
+
+/**
+ * useUserSettings — reactive hook for per-user notification preferences
+ * stored in the Truth `userSettings` Convex table.
+ *
+ * Must be used within `<TruthProvider />` (see `./provider`).
+ *
+ * @example
+ * ```tsx
+ * const { data: settings, loading } = useUserSettings(userId);
+ * // settings?.notificationsEnabled — boolean or undefined (no row yet)
+ * ```
+ */
+
+/**
+ * Subscribe to the `userSettings` row for `userId`. Returns `null` when
+ * no row exists (treat as all-defaults). Returns `undefined` while the
+ * Convex query is in-flight.
+ *
+ * Pass `null` or `undefined` as `userId` to skip the query (e.g. while
+ * auth is loading).
+ */
+declare function useUserSettings(userId: string | null | undefined): UseQueryResult<UserSettings | null>;
+
+/**
+ * useUserSync — mirror the caller's Clerk profile into Truth's user roster.
+ *
+ * Truth's `users` Convex table backs the SMS push fan-out (office cohort
+ * + `notifications_enabled`), assignee pickers, and office-scoped
+ * filters. CommHub mounts this hook on app start so the active user
+ * lands in Truth without anyone reaching into Hasura.
+ *
+ * Resolves `apiBaseUrl` + `apiKey` from `<TruthProvider>` context, so
+ * the call site only passes the per-user details:
+ *
+ * ```tsx
+ * useUserSync({ userId, email, name, imageUrl });
+ * ```
+ *
+ * Idempotent — fires once per (userId, email, name, imageUrl) change.
+ */
+interface UseUserSyncInput {
+    /** Truth API base URL. Defaults to TruthProvider context. */
+    apiBaseUrl?: string;
+    /** `hn_live_*` application key. Defaults to TruthProvider context. */
+    apiKey?: string;
+    /** Clerk userId. The hook is a no-op while this is nullish. */
+    userId: string | null | undefined;
+    email?: string;
+    name?: string;
+    firstName?: string;
+    lastName?: string;
+    imageUrl?: string;
+    notificationsEnabled?: boolean;
+}
+interface UseUserSyncResult {
+    /** "idle" before any sync, "syncing" mid-fetch, "synced" on success, "error" otherwise. */
+    status: "idle" | "syncing" | "synced" | "error";
+    /** Last error message when status === "error". */
+    error: string | null;
+    /** Manually re-run the sync. Usually not needed — the hook auto-syncs. */
+    sync: () => Promise<{
+        ok: boolean;
+        reason?: string;
+    }>;
+}
+declare function useUserSync(input: UseUserSyncInput): UseUserSyncResult;
+
 /**
  * React hook for fetching an authenticated Dialpad voicemail URL.
  *
@@ -2664,4 +2837,4 @@ interface UseVoicemailUrlResult {
  */
 declare function useVoicemailUrl(client: TruthClient): UseVoicemailUrlResult;
 
-export { ACTIVE_CALL_STATES, type Appointment, type AppointmentListOptions, CONNECTED_CALL_STATES, type ConversationListItem, type ConversationMessage, type ConversationMessageRow, type ConversationNoteRow, type ConversationRow, type ConversationTaskForUserRow, type ConversationTaskRow, type DialpadCallLogRow, type DialpadCallRow, DialpadCallState, type EventPayloadMap, type EventType, type FamilyMemberRow, type Patient, type PatientListOptions, type PatientSearchResult, type PermissionStatus, type Physician$1 as Physician, RINGING_CALL_STATES, TERMINAL_CALL_STATES, type TrackOptions, TruthProvider, type TruthProviderProps, type TruthTrackingContextValue, TruthTrackingProvider, type TruthTrackingProviderProps, type UseActiveCallsOptions, type UseAppointmentListOptions, type UseConversationMessagesOptions, type UseConversationsFilters, type UseMessagesOptions, type UseNotificationsOptions, type UseNotificationsResult, type UsePatientBasicOptions, type UsePatientBasicResult, type UsePatientFamilyMembersInput, type UsePatientListOptions, type UsePatientMedicalOptions, type UsePatientPhotoOptions, type UsePatientSearchOptions, type UseQueryResult, useActiveCalls, useAppointment, useAppointmentByElationId, useAppointments, useConversationById, useConversationByPhonePair, useConversationMessages, useConversationNotes, useConversationNotesByPhonePair, useConversationTaskMarkSeen, useConversationTasks, useConversationTasksByPhonePair, useConversationTasksForUser, useConversations, useDialpadCallByCallId, useDialpadCallLog, useDialpadCallsForConversation, useMessages, useNotifications, usePatient, usePatientBasic, usePatientByElationId, usePatientByHintId, usePatientFamilyMembers, usePatientMedical, usePatientPhoto, usePatientSearch, usePatients, usePatientsByIds, usePatientsByPhones, usePharmacyByNcpdpId, usePhysicianByElationId, usePhysiciansByElationIds, useRemindersForConversations, useTruth, useUnreadAggregate, useUnreadCount, useUserSettings, useVoicemailUrl };
+export { ACTIVE_CALL_STATES, API_BASE_URLS, type Appointment, type AppointmentListOptions, CONNECTED_CALL_STATES, CONVEX_URLS, type ConversationListItem, type ConversationMessage, type ConversationMessageRow, type ConversationNoteRow, type ConversationRow, type ConversationTaskForUserRow, type ConversationTaskRow, type DialpadCallLogRow, type DialpadCallRow, DialpadCallState, type EventPayloadMap, type EventType, type FamilyMemberRow, type Patient, type PatientListOptions, type PatientSearchResult, type PermissionStatus, type Physician$1 as Physician, RINGING_CALL_STATES, TERMINAL_CALL_STATES, type TrackOptions, TruthProvider, type TruthProviderProps, type TruthTrackingContextValue, TruthTrackingProvider, type TruthTrackingProviderProps, type UseActiveCallsOptions, type UseAppointmentListOptions, type UseConversationMessagesOptions, type UseConversationsFilters, type UseMessagesOptions, type UseNotificationsActions, type UseNotificationsOptions, type UseNotificationsResult, type UsePatientBasicOptions, type UsePatientBasicResult, type UsePatientFamilyMembersInput, type UsePatientListOptions, type UsePatientMedicalOptions, type UsePatientPhotoOptions, type UsePatientSearchOptions, type UseQueryResult, type UseUserSyncInput, type UseUserSyncResult, getTruthClient, resolveApiBaseUrl, resolveConvexUrl, useActiveCalls, useAppointment, useAppointmentByElationId, useAppointments, useConversationById, useConversationByPhonePair, useConversationMessages, useConversationNotes, useConversationNotesByPhonePair, useConversationTaskMarkSeen, useConversationTasks, useConversationTasksByPhonePair, useConversationTasksForUser, useConversations, useDialpadCallByCallId, useDialpadCallLog, useDialpadCallsForConversation, useMessages, useNotifications, useNotificationsActions, usePatient, usePatientBasic, usePatientByElationId, usePatientByHintId, usePatientFamilyMembers, usePatientMedical, usePatientPhoto, usePatientSearch, usePatients, usePatientsByIds, usePatientsByPhones, usePharmacyByNcpdpId, usePhysicianByElationId, usePhysiciansByElationIds, useRemindersForConversations, useTruth, useTruthClient, useTruthSdkContext, useUnreadAggregate, useUnreadCount, useUserSettings, useUserSync, useVoicemailUrl };