@gpt-platform/client 0.10.5 → 0.11.1

package/dist/namespaces/clinical.d.ts

@@ -0,0 +1,2443 @@
+/**
+ * Clinical namespace for the GPT Platform Client SDK.
+ * Covers patients, sessions, notes, health metrics, meal plans,
+ * goals, supplements, deliveries, note versions, practice resources,
+ * practice tools, client resource assignments, and supplement caches.
+ */
+import type { ClinicalClientGoal as RawClinicalClientGoal, ClinicalClientMedication as RawClinicalClientMedication, ClinicalClientResourceAssignment as RawClinicalClientResourceAssignment, ClinicalClientSupplement as RawClinicalClientSupplement, ClinicalDelivery as RawClinicalDelivery, ClinicalGoalTemplate as RawClinicalGoalTemplate, ClinicalGoalTemplateCategory as RawClinicalGoalTemplateCategory, ClinicalHealthMetric as RawClinicalHealthMetric, ClinicalMealPlan as RawClinicalMealPlan, ClinicalNote as RawClinicalNote, ClinicalNoteVersion as RawClinicalNoteVersion, ClinicalPatient as RawClinicalPatient, ClinicalPracticeResource as RawClinicalPracticeResource, ClinicalPracticeTool as RawClinicalPracticeTool, ClinicalSession as RawClinicalSession, ClinicalSupplementRecCache as RawClinicalSupplementRecCache } from "../_internal/types.gen";
+import type { FlatResource } from "../json-api";
+import type { RequestOptions } from "../base-client";
+import { RequestBuilder } from "../request-builder";
+export type ClinicalClientGoal = FlatResource<RawClinicalClientGoal>;
+export type ClinicalClientResourceAssignment = FlatResource<RawClinicalClientResourceAssignment>;
+export type ClinicalClientMedication = FlatResource<RawClinicalClientMedication>;
+export type ClinicalClientSupplement = FlatResource<RawClinicalClientSupplement>;
+export type ClinicalDelivery = FlatResource<RawClinicalDelivery>;
+export type ClinicalGoalTemplate = FlatResource<RawClinicalGoalTemplate>;
+export type ClinicalGoalTemplateCategory = FlatResource<RawClinicalGoalTemplateCategory>;
+export type ClinicalHealthMetric = FlatResource<RawClinicalHealthMetric>;
+export type ClinicalMealPlan = FlatResource<RawClinicalMealPlan>;
+export type ClinicalNote = FlatResource<RawClinicalNote>;
+export type ClinicalNoteVersion = FlatResource<RawClinicalNoteVersion>;
+export type ClinicalPatient = FlatResource<RawClinicalPatient>;
+export type ClinicalPracticeResource = FlatResource<RawClinicalPracticeResource>;
+export type ClinicalPracticeTool = FlatResource<RawClinicalPracticeTool>;
+export type ClinicalSession = FlatResource<RawClinicalSession>;
+export type ClinicalSupplementRecCache = FlatResource<RawClinicalSupplementRecCache>;
+export interface CreateClinicalPatientAttributes {
+    workspace_id: string;
+    contact_id?: string;
+    assigned_user_id?: string;
+    status?: string;
+    timezone?: string;
+    state?: string;
+    tags?: string[];
+    date_of_birth?: string;
+    sex?: string;
+    height_inches?: number;
+    weight_lbs?: number;
+    goal_weight_lbs?: number;
+    activity_level?: string;
+    eating_style?: string[];
+    meals_per_day?: number;
+    snacks_per_day?: number;
+    conditions?: string[];
+    food_aversions?: string[];
+    food_allergies?: string[];
+    food_preferences?: string[];
+    target_calories_override?: number;
+    protein_pct?: number;
+    carbs_pct?: number;
+    fat_pct?: number;
+    protein_unit?: string;
+    protein_per_weight?: number;
+    followup_interval_value?: number;
+    followup_interval_unit?: string;
+    primary_insurance?: string;
+    diagnosis_codes?: string[];
+    referring_physician_name?: string;
+    referring_physician_phone?: string;
+    referring_physician_fax?: string;
+    profile_data?: Record<string, unknown>;
+    external_ids?: Record<string, string>;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateClinicalPatientAttributes {
+    contact_id?: string;
+    assigned_user_id?: string;
+    status?: string;
+    timezone?: string;
+    state?: string;
+    tags?: string[];
+    date_of_birth?: string;
+    sex?: string;
+    height_inches?: number;
+    weight_lbs?: number;
+    goal_weight_lbs?: number;
+    activity_level?: string;
+    eating_style?: string[];
+    meals_per_day?: number;
+    snacks_per_day?: number;
+    conditions?: string[];
+    food_aversions?: string[];
+    food_allergies?: string[];
+    food_preferences?: string[];
+    target_calories_override?: number;
+    protein_pct?: number;
+    carbs_pct?: number;
+    fat_pct?: number;
+    protein_unit?: string;
+    protein_per_weight?: number;
+    followup_interval_value?: number;
+    followup_interval_unit?: string;
+    primary_insurance?: string;
+    diagnosis_codes?: string[];
+    referring_physician_name?: string;
+    referring_physician_phone?: string;
+    referring_physician_fax?: string;
+    profile_data?: Record<string, unknown>;
+    external_ids?: Record<string, string>;
+    metadata?: Record<string, unknown>;
+}
+export interface CreateClinicalSessionAttributes {
+    workspace_id: string;
+    patient_id: string;
+    practitioner_id?: string;
+    event_id?: string;
+    session_type?: string;
+    session_status?: string;
+    session_format?: string;
+    session_date?: string;
+    duration_minutes?: number;
+    transcript_storage_key?: string;
+    transcript?: string;
+    session_summary?: string;
+    notes?: string;
+    external_ids?: Record<string, string>;
+    prep_execution_id?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateClinicalSessionAttributes {
+    practitioner_id?: string;
+    event_id?: string;
+    pipeline_execution_id?: string;
+    session_type?: string;
+    session_status?: string;
+    session_format?: string;
+    session_date?: string;
+    duration_minutes?: number;
+    transcript_storage_key?: string;
+    transcript?: string;
+    session_summary?: string;
+    notes?: string;
+    external_ids?: Record<string, string>;
+    prep_execution_id?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface CreateClinicalNoteAttributes {
+    workspace_id: string;
+    session_id: string;
+    pipeline_execution_id?: string;
+    note_type?: string;
+    note_content?: string;
+    amends_note_id?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateClinicalNoteAttributes {
+    pipeline_execution_id?: string;
+    note_type?: string;
+    note_content?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface CreateHealthMetricAttributes {
+    workspace_id: string;
+    patient_id: string;
+    session_id?: string;
+    pipeline_execution_id?: string;
+    metric_type: string;
+    metric_category?: string;
+    value_numeric?: number;
+    value_text?: string;
+    unit?: string;
+    measured_at?: string;
+    source?: string;
+    extracted_from?: string;
+    confidence?: number;
+    raw_extract?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateHealthMetricAttributes {
+    metric_type?: string;
+    metric_category?: string;
+    value_numeric?: number;
+    value_text?: string;
+    unit?: string;
+    measured_at?: string;
+    source?: string;
+    confidence?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface CreateMealPlanAttributes {
+    workspace_id: string;
+    /** Patient UUID. Optional if `session_id` is provided — auto-populated from the session's patient. Required when creating a meal plan without a session. */
+    patient_id?: string;
+    session_id?: string;
+    pipeline_execution_id?: string;
+    status?: string;
+    plan_type?: string;
+    goal_calories?: number;
+    macro_targets?: Record<string, unknown>;
+    plan_content?: string;
+    patient_notes?: string;
+    parent_plan_id?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateMealPlanAttributes {
+    status?: string;
+    plan_type?: string;
+    goal_calories?: number;
+    macro_targets?: Record<string, unknown>;
+    plan_content?: string;
+    patient_notes?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface CreateClientGoalAttributes {
+    workspace_id: string;
+    patient_id: string;
+    status?: "active" | "completed" | "abandoned" | "paused" | "achieved" | "discontinued";
+    goal_type: string;
+    title: string;
+    description?: string;
+    target_value?: number;
+    current_value?: number;
+    unit?: string;
+    target_date?: string;
+    linked_metric_type?: string;
+    tool_ids?: string[];
+    action_steps?: string[];
+    priority?: "high" | "medium" | "low";
+    category?: string;
+    timeframe?: string;
+    position?: number;
+    source?: "manual" | "session" | "template";
+    session_id?: string;
+    template_id?: string;
+    email_sent_at?: string;
+    metadata?: Record<string, unknown>;
+    progress_notes?: string;
+    achieved_at?: string;
+}
+export interface UpdateClientGoalAttributes {
+    status?: "active" | "completed" | "abandoned" | "paused" | "achieved" | "discontinued";
+    goal_type?: string;
+    title?: string;
+    description?: string;
+    target_value?: number;
+    current_value?: number;
+    unit?: string;
+    target_date?: string;
+    linked_metric_type?: string;
+    tool_ids?: string[];
+    action_steps?: string[];
+    priority?: "high" | "medium" | "low";
+    category?: string;
+    timeframe?: string;
+    position?: number;
+    source?: "manual" | "session" | "template";
+    session_id?: string;
+    template_id?: string;
+    email_sent_at?: string;
+    metadata?: Record<string, unknown>;
+    progress_notes?: string;
+    achieved_at?: string;
+}
+export interface CreateClientSupplementAttributes {
+    workspace_id: string;
+    patient_id: string;
+    status?: string;
+    name: string;
+    dosage?: string;
+    frequency?: string;
+    instructions?: string;
+    rationale_client?: string;
+    rationale_clinical?: string;
+    fullscript_product_id?: string;
+    fullscript_variant_id?: string;
+    prescribed_at?: string;
+    discontinued_at?: string;
+    metadata?: Record<string, unknown>;
+    route?: string;
+    source?: string;
+    fullscript_treatment_plan_id?: string;
+}
+export interface UpdateClientSupplementAttributes {
+    status?: string;
+    name?: string;
+    dosage?: string;
+    frequency?: string;
+    instructions?: string;
+    rationale_client?: string;
+    rationale_clinical?: string;
+    fullscript_product_id?: string;
+    fullscript_variant_id?: string;
+    prescribed_at?: string;
+    discontinued_at?: string;
+    metadata?: Record<string, unknown>;
+    route?: string;
+    source?: string;
+    fullscript_treatment_plan_id?: string;
+}
+export interface CreateClientMedicationAttributes {
+    workspace_id: string;
+    patient_id: string;
+    status?: "active" | "discontinued" | "on_hold" | "pending_review";
+    name: string;
+    generic_name?: string;
+    ndc_code?: string;
+    dosage?: string;
+    frequency?: string;
+    instructions?: string;
+    route?: string;
+    prescriber_name?: string;
+    prescriber_npi?: string;
+    pharmacy_name?: string;
+    pharmacy_phone?: string;
+    prescribed_at?: string;
+    start_date?: string;
+    end_date?: string;
+    refill_date?: string;
+    refills_remaining?: number;
+    indication?: string;
+    clinical_notes?: string;
+    source?: string;
+    interaction_flags?: string[];
+    external_ids?: Record<string, string>;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateClientMedicationAttributes {
+    status?: "active" | "discontinued" | "on_hold" | "pending_review";
+    name?: string;
+    generic_name?: string;
+    ndc_code?: string;
+    dosage?: string;
+    frequency?: string;
+    instructions?: string;
+    route?: string;
+    prescriber_name?: string;
+    prescriber_npi?: string;
+    pharmacy_name?: string;
+    pharmacy_phone?: string;
+    prescribed_at?: string;
+    start_date?: string;
+    end_date?: string;
+    refill_date?: string;
+    refills_remaining?: number;
+    indication?: string;
+    clinical_notes?: string;
+    source?: string;
+    interaction_flags?: string[];
+    external_ids?: Record<string, string>;
+    metadata?: Record<string, unknown>;
+}
+export interface CreateDeliveryAttributes {
+    workspace_id: string;
+    patient_id: string;
+    session_id?: string;
+    delivery_type?: string;
+    status?: string;
+    email_message_id?: string;
+    included_goal_ids?: string[];
+    included_supplement_ids?: string[];
+    included_resource_ids?: string[];
+    delivered_at?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateDeliveryAttributes {
+    status?: string;
+    delivered_at?: string;
+    email_message_id?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface CreatePracticeResourceAttributes {
+    workspace_id: string;
+    title: string;
+    description?: string;
+    resource_type?: "article" | "video" | "handout" | "worksheet" | "tool_link" | "infographic" | "audio" | "recipe" | "checklist" | "protocol" | "assessment" | "exercise" | "template" | "presentation" | "ebook" | "other";
+    storage_key?: string;
+    url?: string;
+    tags?: string[];
+    is_active?: boolean;
+    content_format?: "pdf" | "html" | "video_embed" | "external_link" | "interactive";
+    preview_url?: string;
+    language?: string;
+    reading_level?: "basic" | "intermediate" | "advanced" | "clinical";
+    audience?: "patient" | "practitioner" | "both";
+    author?: string;
+    license?: string;
+    estimated_duration_minutes?: number;
+    applicable_conditions?: string[];
+    related_goal_types?: string[];
+    icon_url?: string;
+    category?: string;
+    condition_tags?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface UpdatePracticeResourceAttributes {
+    title?: string;
+    description?: string;
+    resource_type?: "article" | "video" | "handout" | "worksheet" | "tool_link" | "infographic" | "audio" | "recipe" | "checklist" | "protocol" | "assessment" | "exercise" | "template" | "presentation" | "ebook" | "other";
+    storage_key?: string;
+    url?: string;
+    tags?: string[];
+    is_active?: boolean;
+    content_format?: "pdf" | "html" | "video_embed" | "external_link" | "interactive";
+    preview_url?: string;
+    language?: string;
+    reading_level?: "basic" | "intermediate" | "advanced" | "clinical";
+    audience?: "patient" | "practitioner" | "both";
+    author?: string;
+    license?: string;
+    estimated_duration_minutes?: number;
+    applicable_conditions?: string[];
+    related_goal_types?: string[];
+    icon_url?: string;
+    category?: string;
+    condition_tags?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface CreatePracticeToolAttributes {
+    workspace_id: string;
+    name: string;
+    description?: string;
+    tool_type?: string;
+    url?: string;
+    platform?: string;
+    is_active?: boolean;
+    category?: string;
+    pricing_model?: "free" | "freemium" | "paid" | "prescription";
+    supported_platforms?: string[];
+    integrations?: string[];
+    website_url?: string;
+    app_store_url?: string;
+    play_store_url?: string;
+    icon_url?: string;
+    logo_url?: string;
+    rating?: string;
+    privacy_rating?: "hipaa_compliant" | "hipaa_partial" | "standard" | "unknown";
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface UpdatePracticeToolAttributes {
+    name?: string;
+    description?: string;
+    tool_type?: string;
+    url?: string;
+    platform?: string;
+    is_active?: boolean;
+    category?: string;
+    pricing_model?: "free" | "freemium" | "paid" | "prescription";
+    supported_platforms?: string[];
+    integrations?: string[];
+    website_url?: string;
+    app_store_url?: string;
+    play_store_url?: string;
+    icon_url?: string;
+    logo_url?: string;
+    rating?: string;
+    privacy_rating?: "hipaa_compliant" | "hipaa_partial" | "standard" | "unknown";
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+}
+/** Parameters for listing practice tools. */
+export interface ListPracticeToolsParams {
+    workspace_id: string;
+    filter?: Record<string, unknown>;
+    sort?: string;
+    page?: {
+        offset?: number;
+        limit?: number;
+    };
+}
+/** A practice tool category with usage count. */
+export interface PracticeToolCategory {
+    category: string;
+    tool_count: number;
+}
+/** A practice resource category with usage count. */
+export interface PracticeResourceCategory {
+    category: string;
+    resource_count: number;
+}
+export interface CreateClientResourceAssignmentAttributes {
+    workspace_id: string;
+    patient_id: string;
+    resource_id: string;
+    assigned_by_id?: string;
+    status?: string;
+    assigned_at?: string;
+    notes?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateClientResourceAssignmentAttributes {
+    status?: string;
+    completed_at?: string;
+    notes?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface TriggerPipelineResponse {
+    execution_id: string | null;
+}
+/** Options for triggering a pipeline on a clinical session. */
+export interface TriggerPipelineOptions {
+    /** Slug of a specific pipeline to trigger. Defaults to "post-session-documentation". */
+    pipeline_slug?: string;
+}
+export interface PatientAdherenceGoals {
+    total: number;
+    completed: number;
+    in_progress: number;
+    completion_rate: number;
+}
+export interface PatientAdherenceHealthMetrics {
+    entries_recorded: number;
+    days_with_data: number;
+    by_category: Record<string, number>;
+}
+export interface PatientAdherenceResponse {
+    patient_id: string;
+    period_days: number;
+    goals: PatientAdherenceGoals;
+    health_metrics: PatientAdherenceHealthMetrics;
+}
+/** Item in a batch reorder request. */
+export interface ReorderGoalItem {
+    id: string;
+    position: number;
+}
+/** Server response from a batch reorder operation. */
+export interface ReorderGoalsResponse {
+    reordered: number;
+}
+export interface CreateGoalTemplateAttributes {
+    workspace_id: string;
+    goal_type: string;
+    title: string;
+    description?: string;
+    action_steps?: string[];
+    priority?: "high" | "medium" | "low";
+    category?: string;
+    timeframe?: string;
+    tool_ids?: string[];
+    metadata?: Record<string, unknown>;
+    tags?: string[];
+    target_value?: string;
+    unit?: string;
+    linked_metric_type?: string;
+    difficulty?: "beginner" | "intermediate" | "advanced";
+    evidence_base?: string;
+    instructions?: string;
+    suggested_duration_days?: number;
+    applicable_conditions?: string[];
+    age_groups?: string[];
+    source_reference?: string;
+}
+export interface UpdateGoalTemplateAttributes {
+    goal_type?: string;
+    title?: string;
+    description?: string;
+    action_steps?: string[];
+    priority?: "high" | "medium" | "low";
+    category?: string;
+    timeframe?: string;
+    tool_ids?: string[];
+    metadata?: Record<string, unknown>;
+    is_active?: boolean;
+    tags?: string[];
+    target_value?: string;
+    unit?: string;
+    linked_metric_type?: string;
+    difficulty?: "beginner" | "intermediate" | "advanced";
+    evidence_base?: string;
+    instructions?: string;
+    suggested_duration_days?: number;
+    applicable_conditions?: string[];
+    age_groups?: string[];
+    source_reference?: string;
+}
+export interface CreateGoalFromExistingAttributes {
+    workspace_id: string;
+    source_template_id: string;
+}
+export interface ListGoalTemplatesParams {
+    workspace_id: string;
+    filter?: Record<string, unknown>;
+    sort?: string;
+    page?: {
+        offset?: number;
+        limit?: number;
+    };
+}
+export interface RecipeSearchParams {
+    query: string;
+    connector_id: string;
+    workspace_id: string;
+    meal_type?: string;
+    diet?: string;
+    health?: string;
+    from?: number;
+    to?: number;
+}
+/** Recipe object returned by Edamam via the platform proxy. */
+export interface RecipeHit {
+    recipe: {
+        uri: string;
+        label: string;
+        image?: string;
+        source?: string;
+        url?: string;
+        yield?: number;
+        dietLabels?: string[];
+        healthLabels?: string[];
+        ingredientLines?: string[];
+        calories?: number;
+        totalTime?: number;
+        cuisineType?: string[];
+        mealType?: string[];
+        dishType?: string[];
+        [key: string]: unknown;
+    };
+}
+/** Result shape returned by `clinical.recipes.search()`. */
+export interface RecipeSearchResult {
+    hits: RecipeHit[];
+    count: number;
+    next_page?: string;
+}
+export interface GenerateSupplementRecsResponse {
+    execution_id: string | null;
+}
+/** Result of a tag rename operation. */
+export interface TagRenameResult {
+    updated_count: number;
+}
+/** Result of a tag delete operation. */
+export interface TagDeleteResult {
+    updated_count: number;
+}
+/** Result of a tag merge operation. */
+export interface TagMergeResult {
+    updated_count: number;
+}
+/** Parameters for importing resources from a URL. */
+export interface ImportFromUrlParams {
+    url: string;
+    workspace_id: string;
+}
+/** Duplicate detection statistics for a resource type in a workspace. */
+export interface DuplicateStats {
+    total_resources: number;
+    duplicate_groups: number;
+    affected_resources: number;
+}
+/** A group of duplicate resources identified by similarity. */
+export interface DuplicateGroup {
+    group_id: string;
+    resource_ids: string[];
+    match_type: string;
+    confidence: number;
+    sample_title: string;
+    count: number;
+}
+/** Result of resolving a duplicate group. */
+export interface DuplicateResolveResult {
+    kept: string;
+    archived: string[];
+}
+export interface ClinicalSearchResult {
+    type: string;
+    id: string;
+    attributes: Record<string, unknown>;
+    meta: {
+        similarity: number;
+    };
+}
+/** Standard JSON:API list parameters for clinical resources. */
+export interface ClinicalListParams {
+    /** Filter results. */
+    filter?: Record<string, unknown>;
+    /** Sort by field(s). Prefix with '-' for descending. */
+    sort?: string;
+    /** Pagination parameters. */
+    page?: {
+        count?: boolean;
+        limit?: number;
+        offset?: number;
+    };
+    /** Include related resources (comma-separated). */
+    include?: string;
+}
+/**
+ * Clinical namespace — patient management, sessions, notes, health data, and care plans.
+ *
+ * Provides sub-namespaces for the full clinical workflow: patients, sessions,
+ * notes (with HITL approve/reject), health metrics, meal plans, client goals,
+ * supplements, deliveries, note versions, practice resources, practice tools,
+ * client resource assignments, and supplement recommendation cache.
+ *
+ * Custom controller endpoints are also exposed for pipeline triggering,
+ * adherence reporting, recipe search, and AI supplement recommendations.
+ *
+ * @example
+ * ```typescript
+ * const client = new GptClient({ apiKey: 'sk_app_...' });
+ *
+ * // List patients in a workspace
+ * const patients = await client.clinical.patients.list({
+ *   filter: { workspace_id: 'ws_123' },
+ * });
+ *
+ * // Trigger AI session pipeline
+ * const { execution_id } = await client.clinical.sessions.triggerPipeline(
+ *   'sess_xyz',
+ *   'ws_123',
+ * );
+ *
+ * // Approve a generated clinical note
+ * const note = await client.clinical.notes.approve('note_abc', 'user_xyz');
+ * ```
+ */
+export declare function createClinicalNamespace(rb: RequestBuilder): {
+    /**
+     * Manage clinical patients (end users of the platform's health service).
+     */
+    patients: {
+        /**
+         * List patients in a workspace.
+         *
+         * @param params - Filter/pagination parameters (must include `filter[workspace_id]`)
+         * @param options - Request options
+         * @returns Array of {@link ClinicalPatient} records
+         *
+         * @example
+         * ```typescript
+         * const patients = await client.clinical.patients.list({
+         *   filter: { workspace_id: 'ws_123' },
+         * });
+         * ```
+         */
+        list: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalPatient[]>;
+        /**
+         * Get a single patient by ID.
+         *
+         * @param id - Patient UUID
+         * @param options - Request options
+         * @returns {@link ClinicalPatient} record
+         *
+         * @example
+         * ```typescript
+         * const patient = await client.clinical.patients.get('pat_abc123');
+         * ```
+         */
+        get: (id: string, options?: RequestOptions) => Promise<ClinicalPatient>;
+        /**
+         * Create a new clinical patient.
+         *
+         * @param attributes - Patient creation attributes. Must include `workspace_id`.
+         * @param options - Request options
+         * @returns Created {@link ClinicalPatient} record
+         *
+         * @example
+         * ```typescript
+         * const patient = await client.clinical.patients.create({
+         *   workspace_id: 'ws_123',
+         *   contact_id: 'contact_abc',
+         *   status: 'active',
+         * });
+         * ```
+         */
+        create: (attributes: CreateClinicalPatientAttributes, options?: RequestOptions) => Promise<ClinicalPatient>;
+        /**
+         * Update a clinical patient.
+         *
+         * @param id - Patient UUID
+         * @param attributes - Fields to update (PATCH semantics)
+         * @param options - Request options
+         * @returns Updated {@link ClinicalPatient} record
+         *
+         * @example
+         * ```typescript
+         * const updated = await client.clinical.patients.update('pat_abc123', {
+         *   status: 'inactive',
+         * });
+         * ```
+         */
+        update: (id: string, attributes: UpdateClinicalPatientAttributes, options?: RequestOptions) => Promise<ClinicalPatient>;
+        /**
+         * Delete a clinical patient.
+         *
+         * @param id - Patient UUID
+         * @param options - Request options
+         * @returns `true` on successful deletion
+         *
+         * @example
+         * ```typescript
+         * await client.clinical.patients.delete('pat_abc123');
+         * ```
+         */
+        delete: (id: string, options?: RequestOptions) => Promise<true>;
+        /**
+         * Look up a patient by their CRM Contact ID.
+         *
+         * Most ISV apps work with CRM Contact IDs, not Clinical Patient UUIDs.
+         * Use this to resolve the patient record for a given contact.
+         *
+         * @param contactId - CRM Contact UUID
+         * @param options - Request options
+         * @returns {@link ClinicalPatient} record linked to the contact
+         * @throws {@link NotFoundError} if no patient exists for the contact
+         *
+         * @example
+         * ```typescript
+         * const patient = await client.clinical.patients.getByContact('c7da2056-...');
+         * console.log(patient.id); // Clinical Patient UUID
+         * ```
+         */
+        getByContact: (contactId: string, options?: RequestOptions) => Promise<ClinicalPatient>;
+        /**
+         * List health metrics for a patient (related resource).
+         *
+         * @param patientId - Patient UUID
+         * @param options - Request options
+         * @returns Array of {@link ClinicalHealthMetric} records
+         */
+        healthMetrics: (patientId: string, options?: RequestOptions) => Promise<ClinicalHealthMetric[]>;
+        /**
+         * List goals for a patient (related resource).
+         *
+         * @param patientId - Patient UUID
+         * @param options - Request options
+         * @returns Array of {@link ClinicalClientGoal} records
+         */
+        goals: (patientId: string, options?: RequestOptions) => Promise<ClinicalClientGoal[]>;
+        /**
+         * List supplements for a patient (related resource).
+         *
+         * @param patientId - Patient UUID
+         * @param options - Request options
+         * @returns Array of {@link ClinicalClientSupplement} records
+         */
+        supplements: (patientId: string, options?: RequestOptions) => Promise<ClinicalClientSupplement[]>;
+        /**
+         * List medications for a patient (related resource).
+         *
+         * @param patientId - Patient UUID or CRM Contact UUID
+         * @param options - Request options
+         * @returns Array of {@link ClinicalClientMedication} records
+         */
+        medications: (patientId: string, options?: RequestOptions) => Promise<ClinicalClientMedication[]>;
+        /**
+         * List resource assignments for a patient (related resource).
+         *
+         * @param patientId - Patient UUID
+         * @param options - Request options
+         * @returns Array of {@link ClinicalClientResourceAssignment} records
+         */
+        resourceAssignments: (patientId: string, options?: RequestOptions) => Promise<ClinicalClientResourceAssignment[]>;
+        /**
+         * Get patient adherence summary for a given period.
+         *
+         * Returns goal completion rates and health metric tracking stats.
+         *
+         * @param patientId - Patient UUID
+         * @param workspaceId - Workspace UUID (required)
+         * @param days - Number of days to look back (default: 30, max: 365)
+         * @param options - Request options
+         * @returns {@link PatientAdherenceResponse} with goal and metric breakdowns
+         *
+         * @example
+         * ```typescript
+         * const adherence = await client.clinical.patients.getAdherence(
+         *   'pat_abc123',
+         *   'ws_123',
+         *   30,
+         * );
+         * console.log(adherence.goals.completion_rate); // 0.75
+         * ```
+         */
+        getAdherence: (patientId: string, workspaceId: string, days?: number, options?: RequestOptions) => Promise<PatientAdherenceResponse>;
+    };
+    /**
+     * Manage clinical sessions (practitioner-patient encounters).
+     */
+    sessions: {
+        /**
+         * List sessions in a workspace.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of {@link ClinicalSession} records
+         */
+        list: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalSession[]>;
+        /**
+         * List sessions for a specific patient.
+         *
+         * @param params - Must include `patient_id`. Optional filter/pagination parameters.
+         * @param options - Request options
+         * @returns Array of {@link ClinicalSession} records
+         */
+        listByPatient: (params: {
+            patient_id: string;
+            filter?: Record<string, unknown>;
+        }, options?: RequestOptions) => Promise<ClinicalSession[]>;
+        /**
+         * Get a single session by ID.
+         *
+         * @param id - Session UUID
+         * @param options - Request options
+         * @returns {@link ClinicalSession} record
+         */
+        get: (id: string, options?: RequestOptions) => Promise<ClinicalSession>;
+        /**
+         * Create a new clinical session.
+         *
+         * @param attributes - Session creation attributes. Must include `workspace_id` and `patient_id`.
+         * @param options - Request options
+         * @returns Created {@link ClinicalSession} record
+         */
+        create: (attributes: CreateClinicalSessionAttributes, options?: RequestOptions) => Promise<ClinicalSession>;
+        /**
+         * Update a clinical session.
+         *
+         * @param id - Session UUID
+         * @param attributes - Fields to update (PATCH semantics)
+         * @param options - Request options
+         * @returns Updated {@link ClinicalSession} record
+         */
+        update: (id: string, attributes: UpdateClinicalSessionAttributes, options?: RequestOptions) => Promise<ClinicalSession>;
+        /**
+         * Delete a clinical session.
+         *
+         * @param id - Session UUID
+         * @param options - Request options
+         * @returns `true` on successful deletion
+         */
+        delete: (id: string, options?: RequestOptions) => Promise<true>;
+        /**
+         * List notes for a session (related resource).
+         *
+         * @param sessionId - Session UUID
+         * @param options - Request options
+         * @returns Array of {@link ClinicalNote} records
+         */
+        notes: (sessionId: string, options?: RequestOptions) => Promise<ClinicalNote[]>;
+        /**
+         * List meal plans for a session (related resource).
+         *
+         * @param sessionId - Session UUID
+         * @param options - Request options
+         * @returns Array of {@link ClinicalMealPlan} records
+         */
+        mealPlans: (sessionId: string, options?: RequestOptions) => Promise<ClinicalMealPlan[]>;
+        /**
+         * Trigger the AI processing pipeline for a session.
+         *
+         * Processes the session transcript to extract clinical insights and generate notes.
+         * Returns immediately with an execution ID; poll `client.agents.executions.get(id)` for results.
+         *
+         * @param sessionId - Session UUID
+         * @param workspaceId - Workspace UUID
+         * @param triggerOptions - Optional pipeline targeting (pipeline_slug)
+         * @param options - Request options
+         * @returns {@link TriggerPipelineResponse} with execution_id (may be null if pipeline not configured)
+         *
+         * @example
+         * ```typescript
+         * // Default pipeline (post-session-documentation)
+         * const { execution_id } = await client.clinical.sessions.triggerPipeline(
+         *   'sess_xyz',
+         *   'ws_123',
+         * );
+         *
+         * // Specific pipeline by slug
+         * const { execution_id: eid } = await client.clinical.sessions.triggerPipeline(
+         *   'sess_xyz',
+         *   'ws_123',
+         *   { pipeline_slug: 'chartless-quick-goals-update' },
+         * );
+         * ```
+         */
+        triggerPipeline: (sessionId: string, workspaceId: string, triggerOptions?: TriggerPipelineOptions, options?: RequestOptions) => Promise<TriggerPipelineResponse>;
+    };
+    /**
+     * Manage clinical notes (SOAP notes, progress notes, AI-generated summaries).
+     *
+     * Notes support a HITL (Human-In-The-Loop) approval workflow: AI-generated
+     * notes start with `status: "draft"` and must be approved or rejected
+     * by a clinician before they are finalized.
+     */
+    notes: {
+        /**
+         * List notes, optionally filtered by patient or session.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of {@link ClinicalNote} records
+         */
+        list: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalNote[]>;
+        /**
+         * List all notes for a patient across all sessions.
+         *
+         * @param patientId - Patient UUID
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of {@link ClinicalNote} records
+         */
+        listByPatient: (patientId: string, params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalNote[]>;
+        /**
+         * List all notes in a workspace.
+         *
+         * @param workspaceId - Workspace UUID
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of {@link ClinicalNote} records
+         */
+        listByWorkspace: (workspaceId: string, params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalNote[]>;
+        /**
+         * Get a single note by ID.
+         *
+         * @param id - Note UUID
+         * @param options - Request options
+         * @returns {@link ClinicalNote} record
+         */
+        get: (id: string, options?: RequestOptions) => Promise<ClinicalNote>;
+        /**
+         * Create a new clinical note.
+         *
+         * @param attributes - Note creation attributes. Must include `workspace_id` and `session_id`.
+         * @param options - Request options
+         * @returns Created {@link ClinicalNote} record
+         */
+        create: (attributes: CreateClinicalNoteAttributes, options?: RequestOptions) => Promise<ClinicalNote>;
+        /**
+         * Update a clinical note.
+         *
+         * @param id - Note UUID
+         * @param attributes - Fields to update (PATCH semantics)
+         * @param options - Request options
+         * @returns Updated {@link ClinicalNote} record
+         */
+        update: (id: string, attributes: UpdateClinicalNoteAttributes, options?: RequestOptions) => Promise<ClinicalNote>;
+        /**
+         * Archive (soft-delete) a note.
+         *
+         * @deprecated Use `archive()` instead. Now performs soft-delete, not permanent deletion.
+         * Use `permanentDelete()` for irreversible removal.
+         * @param id - Note UUID
+         * @param options - Request options
+         * @returns Archived {@link ClinicalNote} record
+         */
+        delete: (id: string, options?: RequestOptions) => Promise<ClinicalNote>;
+        /**
+         * Archive (soft-delete) a note.
+         *
+         * @param id - Note UUID
+         * @param options - Request options
+         * @returns Archived {@link ClinicalNote} record
+         */
+        archive: (id: string, options?: RequestOptions) => Promise<ClinicalNote>;
+        /**
+         * Restore an archived note.
+         *
+         * @param id - Note UUID
+         * @param options - Request options
+         * @returns Restored {@link ClinicalNote} record
+         */
+        restore: (id: string, options?: RequestOptions) => Promise<ClinicalNote>;
+        /**
+         * Permanently delete a note. Irreversible.
+         *
+         * @param id - Note UUID
+         * @param options - Request options
+         * @returns `true` on success
+         */
+        permanentDelete: (id: string, options?: RequestOptions) => Promise<true>;
+        /**
+         * List archived (soft-deleted) notes.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of archived {@link ClinicalNote} records
+         */
+        listArchived: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalNote[]>;
+        /**
+         * Approve a clinical note (HITL workflow).
+         *
+         * Marks the note as clinician-reviewed and approved, transitioning it
+         * to `status: "approved"`. Only notes in `draft` status can be approved.
+         * Creates an immutable NoteVersion snapshot.
+         *
+         * @param id - Note UUID
+         * @param reviewedById - UUID of the reviewer (required)
+         * @param options - Request options
+         * @returns Updated {@link ClinicalNote} record
+         *
+         * @example
+         * ```typescript
+         * const approved = await client.clinical.notes.approve('note_abc', 'user_xyz');
+         * console.log(approved.attributes.status); // 'approved'
+         * ```
+         */
+        approve: (id: string, reviewedById: string, options?: RequestOptions) => Promise<ClinicalNote>;
+        /**
+         * Reject a clinical note (HITL workflow).
+         *
+         * Marks the note as rejected, transitioning it to `status: "rejected"`.
+         * Only notes in `draft` status can be rejected.
+         *
+         * @param id - Note UUID
+         * @param reviewedById - UUID of the reviewer (required)
+         * @param options - Request options
+         * @returns Updated {@link ClinicalNote} record
+         *
+         * @example
+         * ```typescript
+         * const rejected = await client.clinical.notes.reject('note_abc', 'user_xyz');
+         * console.log(rejected.attributes.status); // 'rejected'
+         * ```
+         */
+        reject: (id: string, reviewedById: string, options?: RequestOptions) => Promise<ClinicalNote>;
+        /**
+         * List versions for a note (related resource).
+         *
+         * Each edit to an approved note creates a version record for audit purposes.
+         *
+         * @param noteId - Note UUID
+         * @param options - Request options
+         * @returns Array of {@link ClinicalNoteVersion} records
+         */
+        versions: (noteId: string, options?: RequestOptions) => Promise<ClinicalNoteVersion[]>;
+        /**
+         * Get a specific note version.
+         *
+         * @param noteId - Note UUID
+         * @param versionId - NoteVersion UUID
+         * @param options - Request options
+         * @returns {@link ClinicalNoteVersion} record
+         */
+        getVersion: (noteId: string, versionId: string, options?: RequestOptions) => Promise<ClinicalNoteVersion>;
+    };
+    /**
+     * Manage clinical health metrics (weight, blood pressure, glucose, etc.).
+     */
+    healthMetrics: {
+        /**
+         * List health metrics, filtered by patient/workspace/date range.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of {@link ClinicalHealthMetric} records
+         */
+        list: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalHealthMetric[]>;
+        /**
+         * Get a single health metric by ID.
+         *
+         * @param id - HealthMetric UUID
+         * @param options - Request options
+         * @returns {@link ClinicalHealthMetric} record
+         */
+        get: (id: string, options?: RequestOptions) => Promise<ClinicalHealthMetric>;
+        /**
+         * Record a new health metric entry.
+         *
+         * @param attributes - Metric creation attributes. Must include `workspace_id`, `patient_id`,
+         *   and `metric_type`.
+         * @param options - Request options
+         * @returns Created {@link ClinicalHealthMetric} record
+         *
+         * @example
+         * ```typescript
+         * const metric = await client.clinical.healthMetrics.create({
+         *   workspace_id: 'ws_123',
+         *   patient_id: 'pat_abc',
+         *   metric_type: 'weight_kg',
+         *   metric_category: 'vitals',
+         *   value_numeric: 82.5,
+         *   unit: 'kg',
+         * });
+         * ```
+         */
+        create: (attributes: CreateHealthMetricAttributes, options?: RequestOptions) => Promise<ClinicalHealthMetric>;
+        /**
+         * Update a health metric entry.
+         *
+         * @param id - HealthMetric UUID
+         * @param attributes - Fields to update (PATCH semantics)
+         * @param options - Request options
+         * @returns Updated {@link ClinicalHealthMetric} record
+         */
+        update: (id: string, attributes: UpdateHealthMetricAttributes, options?: RequestOptions) => Promise<ClinicalHealthMetric>;
+        /**
+         * Archive (soft-delete) a health metric.
+         *
+         * @deprecated Use `archive()` instead. Now performs soft-delete, not permanent deletion.
+         * Use `permanentDelete()` for irreversible removal.
+         * @param id - HealthMetric UUID
+         * @param options - Request options
+         * @returns Archived {@link ClinicalHealthMetric} record
+         */
+        delete: (id: string, options?: RequestOptions) => Promise<ClinicalHealthMetric>;
+        /**
+         * Archive (soft-delete) a health metric.
+         *
+         * @param id - HealthMetric UUID
+         * @param options - Request options
+         * @returns Archived {@link ClinicalHealthMetric} record
+         */
+        archive: (id: string, options?: RequestOptions) => Promise<ClinicalHealthMetric>;
+        /**
+         * Restore an archived health metric.
+         *
+         * @param id - HealthMetric UUID
+         * @param options - Request options
+         * @returns Restored {@link ClinicalHealthMetric} record
+         */
+        restore: (id: string, options?: RequestOptions) => Promise<ClinicalHealthMetric>;
+        /**
+         * Permanently delete a health metric. Irreversible.
+         *
+         * @param id - HealthMetric UUID
+         * @param options - Request options
+         * @returns `true` on success
+         */
+        permanentDelete: (id: string, options?: RequestOptions) => Promise<true>;
+        /**
+         * List archived (soft-deleted) health metrics.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of archived {@link ClinicalHealthMetric} records
+         */
+        listArchived: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalHealthMetric[]>;
+    };
+    /**
+     * Manage meal plans for clinical patients.
+     */
+    mealPlans: {
+        /**
+         * List meal plans, filtered by patient/workspace.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of {@link ClinicalMealPlan} records
+         */
+        list: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalMealPlan[]>;
+        /**
+         * List all meal plans for a patient across all sessions.
+         *
+         * @param patientId - Patient UUID
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of {@link ClinicalMealPlan} records
+         */
+        listByPatient: (patientId: string, params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalMealPlan[]>;
+        /**
+         * Get a single meal plan by ID.
+         *
+         * @param id - MealPlan UUID
+         * @param options - Request options
+         * @returns {@link ClinicalMealPlan} record
+         */
+        get: (id: string, options?: RequestOptions) => Promise<ClinicalMealPlan>;
+        /**
+         * Create a new meal plan.
+         *
+         * @param attributes - Meal plan creation attributes. Must include `workspace_id`.
+         *   Provide `patient_id` directly, or `session_id` to auto-populate
+         *   `patient_id` from the session's patient.
+         * @param options - Request options
+         * @returns Created {@link ClinicalMealPlan} record
+         */
+        create: (attributes: CreateMealPlanAttributes, options?: RequestOptions) => Promise<ClinicalMealPlan>;
+        /**
+         * Update a meal plan.
+         *
+         * @param id - MealPlan UUID
+         * @param attributes - Fields to update (PATCH semantics)
+         * @param options - Request options
+         * @returns Updated {@link ClinicalMealPlan} record
+         */
+        update: (id: string, attributes: UpdateMealPlanAttributes, options?: RequestOptions) => Promise<ClinicalMealPlan>;
+        /**
+         * Archive (soft-delete) a meal plan.
+         *
+         * @deprecated Use `archive()` instead. Now performs soft-delete, not permanent deletion.
+         * Use `permanentDelete()` for irreversible removal.
+         * @param id - MealPlan UUID
+         * @param options - Request options
+         * @returns Archived {@link ClinicalMealPlan} record
+         */
+        delete: (id: string, options?: RequestOptions) => Promise<ClinicalMealPlan>;
+        /**
+         * Archive (soft-delete) a meal plan.
+         *
+         * @param id - MealPlan UUID
+         * @param options - Request options
+         * @returns Archived {@link ClinicalMealPlan} record
+         */
+        archive: (id: string, options?: RequestOptions) => Promise<ClinicalMealPlan>;
+        /**
+         * Restore an archived meal plan.
+         *
+         * @param id - MealPlan UUID
+         * @param options - Request options
+         * @returns Restored {@link ClinicalMealPlan} record
+         */
+        restore: (id: string, options?: RequestOptions) => Promise<ClinicalMealPlan>;
+        /**
+         * Permanently delete a meal plan. Irreversible.
+         *
+         * @param id - MealPlan UUID
+         * @param options - Request options
+         * @returns `true` on success
+         */
+        permanentDelete: (id: string, options?: RequestOptions) => Promise<true>;
+        /**
+         * List archived (soft-deleted) meal plans.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of archived {@link ClinicalMealPlan} records
+         */
+        listArchived: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalMealPlan[]>;
+    };
+    /**
+     * Manage client goals (therapeutic targets and wellness milestones).
+     */
+    clientGoals: {
+        /**
+         * List client goals, filtered by patient/workspace.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of {@link ClinicalClientGoal} records
+         */
+        list: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalClientGoal[]>;
+        /**
+         * Get a single client goal by ID.
+         *
+         * @param id - ClientGoal UUID
+         * @param options - Request options
+         * @returns {@link ClinicalClientGoal} record
+         */
+        get: (id: string, options?: RequestOptions) => Promise<ClinicalClientGoal>;
+        /**
+         * Create a new client goal.
+         *
+         * @param attributes - Goal creation attributes. Must include `workspace_id`, `patient_id`, `goal_type`, and `title`.
+         * @param options - Request options
+         * @returns Created {@link ClinicalClientGoal} record
+         */
+        create: (attributes: CreateClientGoalAttributes, options?: RequestOptions) => Promise<ClinicalClientGoal>;
+        /**
+         * Update a client goal.
+         *
+         * @param id - ClientGoal UUID
+         * @param attributes - Fields to update (PATCH semantics)
+         * @param options - Request options
+         * @returns Updated {@link ClinicalClientGoal} record
+         */
+        update: (id: string, attributes: UpdateClientGoalAttributes, options?: RequestOptions) => Promise<ClinicalClientGoal>;
+        /**
+         * Archive (soft-delete) a client goal.
+         *
+         * @deprecated Use `archive()` instead. Now performs soft-delete, not permanent deletion.
+         * Use `permanentDelete()` for irreversible removal.
+         * @param id - ClientGoal UUID
+         * @param options - Request options
+         * @returns Archived {@link ClinicalClientGoal} record
+         */
+        delete: (id: string, options?: RequestOptions) => Promise<ClinicalClientGoal>;
+        /**
+         * Archive (soft-delete) a client goal.
+         *
+         * @param id - ClientGoal UUID
+         * @param options - Request options
+         * @returns Archived {@link ClinicalClientGoal} record
+         */
+        archive: (id: string, options?: RequestOptions) => Promise<ClinicalClientGoal>;
+        /**
+         * Restore an archived client goal.
+         *
+         * @param id - ClientGoal UUID
+         * @param options - Request options
+         * @returns Restored {@link ClinicalClientGoal} record
+         */
+        restore: (id: string, options?: RequestOptions) => Promise<ClinicalClientGoal>;
+        /**
+         * Permanently delete a client goal. Irreversible.
+         *
+         * @param id - ClientGoal UUID
+         * @param options - Request options
+         * @returns `true` on success
+         */
+        permanentDelete: (id: string, options?: RequestOptions) => Promise<true>;
+        /**
+         * List archived (soft-deleted) client goals.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of archived {@link ClinicalClientGoal} records
+         */
+        listArchived: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalClientGoal[]>;
+        /**
+         * Batch reorder client goals by updating their positions.
+         *
+         * @param items - Array of `{ id, position }` pairs specifying new order
+         * @param options - Request options
+         * @returns `{ reordered: number }` — count of updated goals
+         *
+         * @example
+         * ```typescript
+         * await client.clinical.clientGoals.reorder([
+         *   { id: "goal-uuid-1", position: 0 },
+         *   { id: "goal-uuid-2", position: 1 },
+         *   { id: "goal-uuid-3", position: 2 },
+         * ]);
+         * ```
+         */
+        reorder: (items: ReorderGoalItem[], options?: RequestOptions) => Promise<ReorderGoalsResponse>;
+    };
+    /**
+     * Manage supplement prescriptions for clinical patients.
+     */
+    clientSupplements: {
+        /**
+         * List supplement prescriptions, filtered by patient/workspace.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of {@link ClinicalClientSupplement} records
+         */
+        list: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalClientSupplement[]>;
+        /**
+         * Get a single supplement prescription by ID.
+         *
+         * @param id - ClientSupplement UUID
+         * @param options - Request options
+         * @returns {@link ClinicalClientSupplement} record
+         */
+        get: (id: string, options?: RequestOptions) => Promise<ClinicalClientSupplement>;
+        /**
+         * Create a new supplement prescription.
+         *
+         * @param attributes - Supplement creation attributes. Must include `workspace_id`,
+         *   `patient_id`, and `name`.
+         * @param options - Request options
+         * @returns Created {@link ClinicalClientSupplement} record
+         */
+        create: (attributes: CreateClientSupplementAttributes, options?: RequestOptions) => Promise<ClinicalClientSupplement>;
+        /**
+         * Update a supplement prescription.
+         *
+         * @param id - ClientSupplement UUID
+         * @param attributes - Fields to update (PATCH semantics)
+         * @param options - Request options
+         * @returns Updated {@link ClinicalClientSupplement} record
+         */
+        update: (id: string, attributes: UpdateClientSupplementAttributes, options?: RequestOptions) => Promise<ClinicalClientSupplement>;
+        /**
+         * Archive (soft-delete) a supplement prescription.
+         *
+         * @deprecated Use `archive()` instead. Now performs soft-delete, not permanent deletion.
+         * Use `permanentDelete()` for irreversible removal.
+         * @param id - ClientSupplement UUID
+         * @param options - Request options
+         * @returns Archived {@link ClinicalClientSupplement} record
+         */
+        delete: (id: string, options?: RequestOptions) => Promise<ClinicalClientSupplement>;
+        /**
+         * Archive (soft-delete) a supplement prescription.
+         *
+         * @param id - ClientSupplement UUID
+         * @param options - Request options
+         * @returns Archived {@link ClinicalClientSupplement} record
+         */
+        archive: (id: string, options?: RequestOptions) => Promise<ClinicalClientSupplement>;
+        /**
+         * Restore an archived supplement prescription.
+         *
+         * @param id - ClientSupplement UUID
+         * @param options - Request options
+         * @returns Restored {@link ClinicalClientSupplement} record
+         */
+        restore: (id: string, options?: RequestOptions) => Promise<ClinicalClientSupplement>;
+        /**
+         * Permanently delete a supplement prescription. Irreversible.
+         *
+         * @param id - ClientSupplement UUID
+         * @param options - Request options
+         * @returns `true` on success
+         */
+        permanentDelete: (id: string, options?: RequestOptions) => Promise<true>;
+        /**
+         * List archived (soft-deleted) supplement prescriptions.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of archived {@link ClinicalClientSupplement} records
+         */
+        listArchived: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalClientSupplement[]>;
+        /**
+         * Create multiple supplements in a single request.
+         *
+         * @param attrs - Bulk creation attributes with workspace_id and supplements array
+         * @param options - Request options
+         * @returns Array of creation results with id and status per supplement
+         *
+         * @example
+         * ```typescript
+         * const results = await client.clinical.clientSupplements.bulkCreate({
+         *   workspace_id: 'ws_123',
+         *   supplements: [
+         *     { patient_id: 'pat_1', name: 'Vitamin D3', source: 'fullscript' },
+         *     { patient_id: 'pat_1', name: 'Omega-3', source: 'fullscript' },
+         *   ],
+         * });
+         * ```
+         */
+        bulkCreate: (attrs: {
+            workspace_id: string;
+            supplements: Array<Omit<CreateClientSupplementAttributes, "workspace_id">>;
+        }, options?: RequestOptions) => Promise<Array<{
+            id?: string;
+            status: string;
+            error?: string;
+        }>>;
+    };
+    /**
+     * Manage medication prescriptions for clinical patients.
+     */
+    clientMedications: {
+        /**
+         * List medication prescriptions, filtered by patient/workspace.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of {@link ClinicalClientMedication} records
+         */
+        list: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalClientMedication[]>;
+        /**
+         * Get a single medication prescription by ID.
+         *
+         * @param id - ClientMedication UUID
+         * @param options - Request options
+         * @returns {@link ClinicalClientMedication} record
+         */
+        get: (id: string, options?: RequestOptions) => Promise<ClinicalClientMedication>;
+        /**
+         * Create a new medication prescription.
+         *
+         * @param attributes - Medication creation attributes. Must include `workspace_id`,
+         *   `patient_id`, and `name`.
+         * @param options - Request options
+         * @returns Created {@link ClinicalClientMedication} record
+         */
+        create: (attributes: CreateClientMedicationAttributes, options?: RequestOptions) => Promise<ClinicalClientMedication>;
+        /**
+         * Update a medication prescription.
+         *
+         * @param id - ClientMedication UUID
+         * @param attributes - Fields to update (PATCH semantics)
+         * @param options - Request options
+         * @returns Updated {@link ClinicalClientMedication} record
+         */
+        update: (id: string, attributes: UpdateClientMedicationAttributes, options?: RequestOptions) => Promise<ClinicalClientMedication>;
+        /**
+         * Delete (archive) a medication prescription.
+         *
+         * @deprecated Use {@link archive} instead.
+         * @param id - ClientMedication UUID
+         * @param options - Request options
+         * @returns Archived {@link ClinicalClientMedication} record
+         */
+        delete: (id: string, options?: RequestOptions) => Promise<ClinicalClientMedication>;
+        /**
+         * Archive (soft-delete) a medication prescription.
+         *
+         * @param id - ClientMedication UUID
+         * @param options - Request options
+         * @returns Archived {@link ClinicalClientMedication} record
+         */
+        archive: (id: string, options?: RequestOptions) => Promise<ClinicalClientMedication>;
+        /**
+         * Restore an archived medication prescription.
+         *
+         * @param id - ClientMedication UUID
+         * @param options - Request options
+         * @returns Restored {@link ClinicalClientMedication} record
+         */
+        restore: (id: string, options?: RequestOptions) => Promise<ClinicalClientMedication>;
+        /**
+         * Permanently delete a medication prescription. Irreversible.
+         *
+         * @param id - ClientMedication UUID
+         * @param options - Request options
+         * @returns `true` on success
+         */
+        permanentDelete: (id: string, options?: RequestOptions) => Promise<true>;
+        /**
+         * List archived (soft-deleted) medication prescriptions.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of archived {@link ClinicalClientMedication} records
+         */
+        listArchived: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalClientMedication[]>;
+        /**
+         * Create multiple medications in a single request.
+         *
+         * @param attrs - Bulk creation attributes with workspace_id and medications array
+         * @param options - Request options
+         * @returns Array of creation results with id and status per medication
+         *
+         * @example
+         * ```typescript
+         * const results = await client.clinical.clientMedications.bulkCreate({
+         *   workspace_id: 'ws_123',
+         *   medications: [
+         *     { patient_id: 'pat_1', name: 'Metformin', source: 'ehr_import' },
+         *     { patient_id: 'pat_1', name: 'Lisinopril', source: 'ehr_import' },
+         *   ],
+         * });
+         * ```
+         */
+        bulkCreate: (attrs: {
+            workspace_id: string;
+            medications: Array<Omit<CreateClientMedicationAttributes, "workspace_id">>;
+        }, options?: RequestOptions) => Promise<Array<{
+            id?: string;
+            status: string;
+            error?: string;
+        }>>;
+    };
+    /**
+     * Manage clinical deliveries (care plan items sent to patients).
+     */
+    deliveries: {
+        /**
+         * List deliveries, filtered by patient/workspace.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of {@link ClinicalDelivery} records
+         */
+        list: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalDelivery[]>;
+        /**
+         * Get a single delivery by ID.
+         *
+         * @param id - Delivery UUID
+         * @param options - Request options
+         * @returns {@link ClinicalDelivery} record
+         */
+        get: (id: string, options?: RequestOptions) => Promise<ClinicalDelivery>;
+        /**
+         * Create a new delivery.
+         *
+         * @param attributes - Delivery creation attributes. Must include `workspace_id`,
+         *   `patient_id`, and `delivery_type`.
+         * @param options - Request options
+         * @returns Created {@link ClinicalDelivery} record
+         */
+        create: (attributes: CreateDeliveryAttributes, options?: RequestOptions) => Promise<ClinicalDelivery>;
+        /**
+         * Update a delivery (e.g., change status to `delivered`).
+         *
+         * @param id - Delivery UUID
+         * @param attributes - Fields to update (PATCH semantics)
+         * @param options - Request options
+         * @returns Updated {@link ClinicalDelivery} record
+         */
+        update: (id: string, attributes: UpdateDeliveryAttributes, options?: RequestOptions) => Promise<ClinicalDelivery>;
+    };
+    /**
+     * Manage practice-level educational resources.
+     */
+    practiceResources: {
+        /**
+         * List practice resources in a workspace.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of {@link ClinicalPracticeResource} records
+         */
+        list: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalPracticeResource[]>;
+        /**
+         * Get a single practice resource by ID.
+         *
+         * @param id - PracticeResource UUID
+         * @param options - Request options
+         * @returns {@link ClinicalPracticeResource} record
+         */
+        get: (id: string, options?: RequestOptions) => Promise<ClinicalPracticeResource>;
+        /**
+         * Create a new practice resource.
+         *
+         * @param attributes - Resource creation attributes. Must include `workspace_id` and `title`.
+         * @param options - Request options
+         * @returns Created {@link ClinicalPracticeResource} record
+         */
+        create: (attributes: CreatePracticeResourceAttributes, options?: RequestOptions) => Promise<ClinicalPracticeResource>;
+        /**
+         * Update a practice resource.
+         *
+         * @param id - PracticeResource UUID
+         * @param attributes - Fields to update (PATCH semantics)
+         * @param options - Request options
+         * @returns Updated {@link ClinicalPracticeResource} record
+         */
+        update: (id: string, attributes: UpdatePracticeResourceAttributes, options?: RequestOptions) => Promise<ClinicalPracticeResource>;
+        /**
+         * Archive (soft-delete) a practice resource.
+         *
+         * @deprecated Use `archive()` instead. Now performs soft-delete, not permanent deletion.
+         * Use `permanentDelete()` for irreversible removal.
+         * @param id - PracticeResource UUID
+         * @param options - Request options
+         * @returns Archived {@link ClinicalPracticeResource} record
+         */
+        delete: (id: string, options?: RequestOptions) => Promise<ClinicalPracticeResource>;
+        /**
+         * Archive (soft-delete) a practice resource.
+         *
+         * @param id - PracticeResource UUID
+         * @param options - Request options
+         * @returns Archived {@link ClinicalPracticeResource} record
+         */
+        archive: (id: string, options?: RequestOptions) => Promise<ClinicalPracticeResource>;
+        /**
+         * Restore an archived practice resource.
+         *
+         * @param id - PracticeResource UUID
+         * @param options - Request options
+         * @returns Restored {@link ClinicalPracticeResource} record
+         */
+        restore: (id: string, options?: RequestOptions) => Promise<ClinicalPracticeResource>;
+        /**
+         * Permanently delete a practice resource. Irreversible.
+         *
+         * @param id - PracticeResource UUID
+         * @param options - Request options
+         * @returns `true` on success
+         */
+        permanentDelete: (id: string, options?: RequestOptions) => Promise<true>;
+        /**
+         * List archived (soft-deleted) practice resources.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of archived {@link ClinicalPracticeResource} records
+         */
+        listArchived: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalPracticeResource[]>;
+        /**
+         * List application-level catalog practice resources.
+         *
+         * @param params - Optional filter/sort params. Application ID is resolved from the API key context.
+         * @param options - Request options
+         * @returns Array of {@link ClinicalPracticeResource} catalog records
+         */
+        listCatalog: (params?: {
+            filter?: Record<string, unknown>;
+            sort?: string;
+        }, options?: RequestOptions) => Promise<ClinicalPracticeResource[]>;
+        /**
+         * Archive (soft-delete) a catalog practice resource.
+         *
+         * @param id - PracticeResource UUID
+         * @param options - Request options
+         * @returns Archived {@link ClinicalPracticeResource} record
+         */
+        archiveCatalog: (id: string, options?: RequestOptions) => Promise<ClinicalPracticeResource>;
+        /**
+         * Restore an archived catalog practice resource.
+         *
+         * @param id - PracticeResource UUID
+         * @param options - Request options
+         * @returns Restored {@link ClinicalPracticeResource} record
+         */
+        restoreCatalog: (id: string, options?: RequestOptions) => Promise<ClinicalPracticeResource>;
+        /**
+         * Permanently delete a catalog practice resource. Irreversible.
+         *
+         * @param id - PracticeResource UUID
+         * @param options - Request options
+         * @returns `true` on success
+         */
+        permanentDeleteCatalog: (id: string, options?: RequestOptions) => Promise<true>;
+        /**
+         * List archived (soft-deleted) catalog practice resources.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of archived {@link ClinicalPracticeResource} catalog records
+         */
+        listArchivedCatalog: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalPracticeResource[]>;
+        /**
+         * List distinct practice resource categories in a workspace.
+         *
+         * Returns unique `resource_type` values with their active resource counts,
+         * sorted by count descending.
+         *
+         * @param params - Must include `workspace_id`
+         * @param options - Request options
+         * @returns Array of {@link PracticeResourceCategory} records
+         *
+         * @example
+         * ```typescript
+         * const categories = await client.clinical.practiceResources.listCategories({
+         *   workspace_id: "..."
+         * });
+         * // [{ category: "article", resource_count: 5 }, { category: "video", resource_count: 3 }]
+         * ```
+         */
+        listCategories: (params: {
+            workspace_id: string;
+        }, options?: RequestOptions) => Promise<PracticeResourceCategory[]>;
+        /**
+         * List distinct catalog practice resource categories.
+         *
+         * Returns unique `resource_type` values from application-level catalog resources.
+         * Application ID is resolved from the API key context.
+         *
+         * @param options - Request options
+         * @returns Array of {@link PracticeResourceCategory} records
+         *
+         * @example
+         * ```typescript
+         * const cats = await client.clinical.practiceResources.listCatalogCategories();
+         * ```
+         */
+        listCatalogCategories: (options?: RequestOptions) => Promise<PracticeResourceCategory[]>;
+        tags: {
+            rename: (workspaceId: string, oldTag: string, newTag: string, options?: RequestOptions) => Promise<TagRenameResult>;
+            delete: (workspaceId: string, tag: string, options?: RequestOptions) => Promise<TagDeleteResult>;
+            merge: (workspaceId: string, sourceTags: string[], targetTag: string, options?: RequestOptions) => Promise<TagMergeResult>;
+        };
+        imports: {
+            fromFile: (workspaceId: string, file: File | Blob, options?: RequestOptions) => Promise<Record<string, unknown>>;
+            fromUrl: (workspaceId: string, url: string, options?: RequestOptions) => Promise<Record<string, unknown>>;
+        };
+        duplicates: {
+            getStats: (workspaceId: string, options?: RequestOptions) => Promise<DuplicateStats>;
+            listGroups: (workspaceId: string, opts?: {
+                threshold?: number;
+                limit?: number;
+            }, options?: RequestOptions) => Promise<DuplicateGroup[]>;
+            resolve: (workspaceId: string, groupId: string, keepId: string, options?: RequestOptions) => Promise<DuplicateResolveResult>;
+        };
+        /**
+         * Search practice resources using semantic similarity.
+         * Finds resources matching the query by meaning, not just keywords.
+         *
+         * @param workspaceId - The workspace to search in
+         * @param params - Search parameters
+         * @param params.query - Free-text search query
+         * @param params.limit - Maximum results to return (default: 10)
+         * @returns Array of matching practice resources with similarity scores
+         *
+         * @example
+         * ```typescript
+         * const results = await client.clinical.practiceResources.search(workspaceId, {
+         *   query: "diabetes management patient education",
+         *   limit: 5,
+         * });
+         * ```
+         */
+        search: (workspaceId: string, params: {
+            query: string;
+            limit?: number;
+        }, options?: RequestOptions) => Promise<ClinicalSearchResult[]>;
+    };
+    /**
+     * Manage practice-level assessment and therapeutic tools.
+     */
+    practiceTools: {
+        /**
+         * List practice tools in a workspace.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of {@link ClinicalPracticeTool} records
+         */
+        list: (params: ListPracticeToolsParams, options?: RequestOptions) => Promise<ClinicalPracticeTool[]>;
+        /**
+         * Get a single practice tool by ID.
+         *
+         * @param id - PracticeTool UUID
+         * @param options - Request options
+         * @returns {@link ClinicalPracticeTool} record
+         */
+        get: (id: string, options?: RequestOptions) => Promise<ClinicalPracticeTool>;
+        /**
+         * Create a new practice tool.
+         *
+         * @param attributes - Tool creation attributes. Must include `workspace_id` and `name`.
+         * @param options - Request options
+         * @returns Created {@link ClinicalPracticeTool} record
+         */
+        create: (attributes: CreatePracticeToolAttributes, options?: RequestOptions) => Promise<ClinicalPracticeTool>;
+        /**
+         * Update a practice tool.
+         *
+         * @param id - PracticeTool UUID
+         * @param attributes - Fields to update (PATCH semantics)
+         * @param options - Request options
+         * @returns Updated {@link ClinicalPracticeTool} record
+         */
+        update: (id: string, attributes: UpdatePracticeToolAttributes, options?: RequestOptions) => Promise<ClinicalPracticeTool>;
+        /**
+         * Archive (soft-delete) a practice tool.
+         *
+         * @deprecated Use `archive()` instead. Now performs soft-delete, not permanent deletion.
+         * Use `permanentDelete()` for irreversible removal.
+         * @param id - PracticeTool UUID
+         * @param options - Request options
+         * @returns Archived {@link ClinicalPracticeTool} record
+         */
+        delete: (id: string, options?: RequestOptions) => Promise<ClinicalPracticeTool>;
+        /**
+         * Archive (soft-delete) a practice tool.
+         *
+         * @param id - PracticeTool UUID
+         * @param options - Request options
+         * @returns Archived {@link ClinicalPracticeTool} record
+         */
+        archive: (id: string, options?: RequestOptions) => Promise<ClinicalPracticeTool>;
+        /**
+         * Restore an archived practice tool.
+         *
+         * @param id - PracticeTool UUID
+         * @param options - Request options
+         * @returns Restored {@link ClinicalPracticeTool} record
+         */
+        restore: (id: string, options?: RequestOptions) => Promise<ClinicalPracticeTool>;
+        /**
+         * Permanently delete a practice tool. Irreversible.
+         *
+         * @param id - PracticeTool UUID
+         * @param options - Request options
+         * @returns `true` on success
+         */
+        permanentDelete: (id: string, options?: RequestOptions) => Promise<true>;
+        /**
+         * List archived (soft-deleted) practice tools.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of archived {@link ClinicalPracticeTool} records
+         */
+        listArchived: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalPracticeTool[]>;
+        /**
+         * List distinct practice tool categories in a workspace.
+         *
+         * Returns unique `tool_type` values with their active tool counts,
+         * sorted by count descending.
+         *
+         * @param params - Must include `workspace_id`
+         * @param options - Request options
+         * @returns Array of {@link PracticeToolCategory} records
+         *
+         * @example
+         * ```typescript
+         * const categories = await client.clinical.practiceTools.listCategories({
+         *   workspace_id: "..."
+         * });
+         * // [{ category: "app", tool_count: 5 }, { category: "wearable", tool_count: 3 }]
+         * ```
+         */
+        listCategories: (params: {
+            workspace_id: string;
+        }, options?: RequestOptions) => Promise<PracticeToolCategory[]>;
+        /**
+         * List application-level catalog practice tools.
+         *
+         * @param params - Optional filter/sort params. Application ID is resolved from the API key context.
+         * @param options - Request options
+         * @returns Array of {@link ClinicalPracticeTool} catalog records
+         */
+        listCatalog: (params?: {
+            filter?: Record<string, unknown>;
+            sort?: string;
+        }, options?: RequestOptions) => Promise<ClinicalPracticeTool[]>;
+        /**
+         * Archive (soft-delete) a catalog practice tool.
+         *
+         * @param id - PracticeTool UUID
+         * @param options - Request options
+         * @returns Archived {@link ClinicalPracticeTool} record
+         */
+        archiveCatalog: (id: string, options?: RequestOptions) => Promise<ClinicalPracticeTool>;
+        /**
+         * Restore an archived catalog practice tool.
+         *
+         * @param id - PracticeTool UUID
+         * @param options - Request options
+         * @returns Restored {@link ClinicalPracticeTool} record
+         */
+        restoreCatalog: (id: string, options?: RequestOptions) => Promise<ClinicalPracticeTool>;
+        /**
+         * Permanently delete a catalog practice tool. Irreversible.
+         *
+         * @param id - PracticeTool UUID
+         * @param options - Request options
+         * @returns `true` on success
+         */
+        permanentDeleteCatalog: (id: string, options?: RequestOptions) => Promise<true>;
+        /**
+         * List archived (soft-deleted) catalog practice tools.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of archived {@link ClinicalPracticeTool} catalog records
+         */
+        listArchivedCatalog: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalPracticeTool[]>;
+        /**
+         * List distinct catalog practice tool categories.
+         *
+         * Returns unique `tool_type` values from application-level catalog tools.
+         * Application ID is resolved from the API key context.
+         *
+         * @param options - Request options
+         * @returns Array of {@link PracticeToolCategory} records
+         *
+         * @example
+         * ```typescript
+         * const cats = await client.clinical.practiceTools.listCatalogCategories();
+         * ```
+         */
+        listCatalogCategories: (options?: RequestOptions) => Promise<PracticeToolCategory[]>;
+        tags: {
+            rename: (workspaceId: string, oldTag: string, newTag: string, options?: RequestOptions) => Promise<TagRenameResult>;
+            delete: (workspaceId: string, tag: string, options?: RequestOptions) => Promise<TagDeleteResult>;
+            merge: (workspaceId: string, sourceTags: string[], targetTag: string, options?: RequestOptions) => Promise<TagMergeResult>;
+        };
+        imports: {
+            fromFile: (workspaceId: string, file: File | Blob, options?: RequestOptions) => Promise<Record<string, unknown>>;
+            fromUrl: (workspaceId: string, url: string, options?: RequestOptions) => Promise<Record<string, unknown>>;
+        };
+        duplicates: {
+            getStats: (workspaceId: string, options?: RequestOptions) => Promise<DuplicateStats>;
+            listGroups: (workspaceId: string, opts?: {
+                threshold?: number;
+                limit?: number;
+            }, options?: RequestOptions) => Promise<DuplicateGroup[]>;
+            resolve: (workspaceId: string, groupId: string, keepId: string, options?: RequestOptions) => Promise<DuplicateResolveResult>;
+        };
+        /**
+         * Search practice tools using semantic similarity.
+         *
+         * @param workspaceId - The workspace to search in
+         * @param params - Search parameters
+         * @param params.query - Free-text search query
+         * @param params.limit - Maximum results to return (default: 10)
+         * @returns Array of matching practice tools with similarity scores
+         *
+         * @example
+         * ```typescript
+         * const results = await client.clinical.practiceTools.search(workspaceId, {
+         *   query: "stress assessment screening tool",
+         *   limit: 5,
+         * });
+         * ```
+         */
+        search: (workspaceId: string, params: {
+            query: string;
+            limit?: number;
+        }, options?: RequestOptions) => Promise<ClinicalSearchResult[]>;
+    };
+    /**
+     * Manage assignments of practice resources to patients.
+     */
+    clientResourceAssignments: {
+        /**
+         * List resource assignments, filtered by patient/workspace.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of {@link ClinicalClientResourceAssignment} records
+         */
+        list: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalClientResourceAssignment[]>;
+        /**
+         * Get a single resource assignment by ID.
+         *
+         * @param id - ClientResourceAssignment UUID
+         * @param options - Request options
+         * @returns {@link ClinicalClientResourceAssignment} record
+         */
+        get: (id: string, options?: RequestOptions) => Promise<ClinicalClientResourceAssignment>;
+        /**
+         * Assign a practice resource to a patient.
+         *
+         * @param attributes - Assignment creation attributes. Must include `workspace_id`,
+         *   `patient_id`, and `resource_id`.
+         * @param options - Request options
+         * @returns Created {@link ClinicalClientResourceAssignment} record
+         */
+        create: (attributes: CreateClientResourceAssignmentAttributes, options?: RequestOptions) => Promise<ClinicalClientResourceAssignment>;
+        /**
+         * Update a resource assignment (e.g., mark as completed).
+         *
+         * @param id - ClientResourceAssignment UUID
+         * @param attributes - Fields to update (PATCH semantics)
+         * @param options - Request options
+         * @returns Updated {@link ClinicalClientResourceAssignment} record
+         */
+        update: (id: string, attributes: UpdateClientResourceAssignmentAttributes, options?: RequestOptions) => Promise<ClinicalClientResourceAssignment>;
+        /**
+         * Archive (soft-delete) a resource assignment.
+         *
+         * @deprecated Use `archive()` instead. Now performs soft-delete, not permanent deletion.
+         * Use `permanentDelete()` for irreversible removal.
+         * @param id - ClientResourceAssignment UUID
+         * @param options - Request options
+         * @returns Archived {@link ClinicalClientResourceAssignment} record
+         */
+        delete: (id: string, options?: RequestOptions) => Promise<ClinicalClientResourceAssignment>;
+        /**
+         * Archive (soft-delete) a resource assignment.
+         *
+         * @param id - ClientResourceAssignment UUID
+         * @param options - Request options
+         * @returns Archived {@link ClinicalClientResourceAssignment} record
+         */
+        archive: (id: string, options?: RequestOptions) => Promise<ClinicalClientResourceAssignment>;
+        /**
+         * Restore an archived resource assignment.
+         *
+         * @param id - ClientResourceAssignment UUID
+         * @param options - Request options
+         * @returns Restored {@link ClinicalClientResourceAssignment} record
+         */
+        restore: (id: string, options?: RequestOptions) => Promise<ClinicalClientResourceAssignment>;
+        /**
+         * Permanently delete a resource assignment. Irreversible.
+         *
+         * @param id - ClientResourceAssignment UUID
+         * @param options - Request options
+         * @returns `true` on success
+         */
+        permanentDelete: (id: string, options?: RequestOptions) => Promise<true>;
+        /**
+         * List archived (soft-deleted) resource assignments.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of archived {@link ClinicalClientResourceAssignment} records
+         */
+        listArchived: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalClientResourceAssignment[]>;
+    };
+    /**
+     * Read-only access to the AI-generated supplement recommendation cache.
+     *
+     * This resource is server-managed — entries are created and updated
+     * exclusively by the AI post-session pipeline. Direct create/update
+     * operations are not supported.
+     */
+    supplementRecCache: {
+        /**
+         * List supplement recommendation cache entries, filtered by patient/workspace.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of {@link ClinicalSupplementRecCache} records
+         */
+        list: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalSupplementRecCache[]>;
+        /**
+         * Get a single supplement recommendation cache entry by ID.
+         *
+         * @param id - SupplementRecCache UUID
+         * @param options - Request options
+         * @returns {@link ClinicalSupplementRecCache} record
+         */
+        get: (id: string, options?: RequestOptions) => Promise<ClinicalSupplementRecCache>;
+        /**
+         * Generate supplement recommendations for a patient via the AI pipeline.
+         *
+         * Returns immediately with an execution ID; poll executions for results.
+         * The AI pipeline populates the supplement recommendation cache entries
+         * once the execution completes.
+         *
+         * @param patientId - Patient UUID
+         * @param sessionId - Session UUID to base recommendations on
+         * @param workspaceId - Workspace UUID
+         * @param options - Request options
+         * @returns {@link GenerateSupplementRecsResponse} with execution_id
+         *
+         * @example
+         * ```typescript
+         * const { execution_id } = await client.clinical.supplementRecCache.generate(
+         *   'pat_abc123',
+         *   'sess_xyz',
+         *   'ws_123',
+         * );
+         * ```
+         */
+        generate: (patientId: string, sessionId: string, workspaceId: string, options?: RequestOptions) => Promise<GenerateSupplementRecsResponse>;
+    };
+    /**
+     * Manage reusable clinical goal templates.
+     *
+     * Templates are workspace-scoped patterns that practitioners can personalize
+     * and instantiate as ClientGoals.
+     */
+    goalTemplates: {
+        /**
+         * List goal templates in a workspace.
+         *
+         * @param params - Must include `workspace_id`
+         * @param options - Request options
+         * @returns Array of {@link ClinicalGoalTemplate} records
+         *
+         * @example
+         * ```typescript
+         * const templates = await client.clinical.goalTemplates.list({
+         *   workspace_id: "ws_123",
+         *   filter: { category: "nutrition" },
+         * });
+         * ```
+         */
+        list: (params: ListGoalTemplatesParams, options?: RequestOptions) => Promise<ClinicalGoalTemplate[]>;
+        /**
+         * List practitioner's personal templates.
+         *
+         * @param params - Must include `created_by_id`
+         * @param options - Request options
+         * @returns Array of {@link ClinicalGoalTemplate} records
+         */
+        listMine: (params: {
+            created_by_id: string;
+            page?: {
+                offset?: number;
+                limit?: number;
+            };
+        }, options?: RequestOptions) => Promise<ClinicalGoalTemplate[]>;
+        /**
+         * List distinct goal template categories with counts.
+         *
+         * @param params - Must include `workspace_id`
+         * @param options - Request options
+         * @returns Array of {@link ClinicalGoalTemplateCategory} records
+         */
+        listCategories: (params: {
+            workspace_id: string;
+        }, options?: RequestOptions) => Promise<ClinicalGoalTemplateCategory[]>;
+        /**
+         * Get a single goal template by ID.
+         *
+         * @param id - GoalTemplate UUID
+         * @param options - Request options
+         * @returns {@link ClinicalGoalTemplate} record
+         */
+        get: (id: string, options?: RequestOptions) => Promise<ClinicalGoalTemplate>;
+        /**
+         * Create a new goal template.
+         *
+         * @param attributes - Template creation attributes. Must include `workspace_id`, `goal_type`, and `title`.
+         * @param options - Request options
+         * @returns Created {@link ClinicalGoalTemplate} record
+         */
+        create: (attributes: CreateGoalTemplateAttributes, options?: RequestOptions) => Promise<ClinicalGoalTemplate>;
+        /**
+         * Create a personalized template from an existing one.
+         *
+         * Copies all fields from the source template, sets `created_by_id` to the
+         * current actor, and sets `source_template_id` as a reference.
+         *
+         * @param attributes - Must include `workspace_id` and `source_template_id`
+         * @param options - Request options
+         * @returns Created {@link ClinicalGoalTemplate} record
+         *
+         * @example
+         * ```typescript
+         * const personal = await client.clinical.goalTemplates.createFromExisting({
+         *   workspace_id: "ws_123",
+         *   source_template_id: "tmpl_abc",
+         * });
+         * ```
+         */
+        createFromExisting: (attributes: CreateGoalFromExistingAttributes, options?: RequestOptions) => Promise<ClinicalGoalTemplate>;
+        /**
+         * Update a goal template.
+         *
+         * @param id - GoalTemplate UUID
+         * @param attributes - Fields to update (PATCH semantics)
+         * @param options - Request options
+         * @returns Updated {@link ClinicalGoalTemplate} record
+         */
+        update: (id: string, attributes: UpdateGoalTemplateAttributes, options?: RequestOptions) => Promise<ClinicalGoalTemplate>;
+        /**
+         * Archive (soft-delete) a goal template.
+         *
+         * @deprecated Use `archive()` instead. Now performs soft-delete, not permanent deletion.
+         * Use `permanentDelete()` for irreversible removal.
+         * @param id - GoalTemplate UUID
+         * @param options - Request options
+         * @returns Archived {@link ClinicalGoalTemplate} record
+         */
+        delete: (id: string, options?: RequestOptions) => Promise<ClinicalGoalTemplate>;
+        /**
+         * Archive (soft-delete) a goal template.
+         *
+         * @param id - GoalTemplate UUID
+         * @param options - Request options
+         * @returns Archived {@link ClinicalGoalTemplate} record
+         */
+        archive: (id: string, options?: RequestOptions) => Promise<ClinicalGoalTemplate>;
+        /**
+         * Restore an archived goal template.
+         *
+         * @param id - GoalTemplate UUID
+         * @param options - Request options
+         * @returns Restored {@link ClinicalGoalTemplate} record
+         */
+        restore: (id: string, options?: RequestOptions) => Promise<ClinicalGoalTemplate>;
+        /**
+         * Permanently delete a goal template. Irreversible.
+         *
+         * @param id - GoalTemplate UUID
+         * @param options - Request options
+         * @returns `true` on success
+         */
+        permanentDelete: (id: string, options?: RequestOptions) => Promise<true>;
+        /**
+         * List archived (soft-deleted) goal templates.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of archived {@link ClinicalGoalTemplate} records
+         */
+        listArchived: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalGoalTemplate[]>;
+        /**
+         * List application-level catalog goal templates.
+         *
+         * @param params - Optional filter/sort params. Application ID is resolved from the API key context.
+         * @param options - Request options
+         * @returns Array of {@link ClinicalGoalTemplate} catalog records
+         */
+        listCatalog: (params?: {
+            filter?: Record<string, unknown>;
+            sort?: string;
+        }, options?: RequestOptions) => Promise<ClinicalGoalTemplate[]>;
+        /**
+         * Archive (soft-delete) a catalog goal template.
+         *
+         * @param id - GoalTemplate UUID
+         * @param options - Request options
+         * @returns Archived {@link ClinicalGoalTemplate} record
+         */
+        archiveCatalog: (id: string, options?: RequestOptions) => Promise<ClinicalGoalTemplate>;
+        /**
+         * Restore an archived catalog goal template.
+         *
+         * @param id - GoalTemplate UUID
+         * @param options - Request options
+         * @returns Restored {@link ClinicalGoalTemplate} record
+         */
+        restoreCatalog: (id: string, options?: RequestOptions) => Promise<ClinicalGoalTemplate>;
+        /**
+         * Permanently delete a catalog goal template. Irreversible.
+         *
+         * @param id - GoalTemplate UUID
+         * @param options - Request options
+         * @returns `true` on success
+         */
+        permanentDeleteCatalog: (id: string, options?: RequestOptions) => Promise<true>;
+        /**
+         * List archived (soft-deleted) catalog goal templates.
+         *
+         * @param params - Filter/pagination parameters
+         * @param options - Request options
+         * @returns Array of archived {@link ClinicalGoalTemplate} catalog records
+         */
+        listArchivedCatalog: (params?: ClinicalListParams, options?: RequestOptions) => Promise<ClinicalGoalTemplate[]>;
+        /**
+         * List distinct catalog goal template categories.
+         *
+         * Returns unique `category` values from application-level catalog templates.
+         * Application ID is resolved from the API key context.
+         *
+         * @param options - Request options
+         * @returns Array of {@link ClinicalGoalTemplateCategory} records
+         *
+         * @example
+         * ```typescript
+         * const cats = await client.clinical.goalTemplates.listCatalogCategories();
+         * ```
+         */
+        listCatalogCategories: (options?: RequestOptions) => Promise<ClinicalGoalTemplateCategory[]>;
+        tags: {
+            rename: (workspaceId: string, oldTag: string, newTag: string, options?: RequestOptions) => Promise<TagRenameResult>;
+            delete: (workspaceId: string, tag: string, options?: RequestOptions) => Promise<TagDeleteResult>;
+            merge: (workspaceId: string, sourceTags: string[], targetTag: string, options?: RequestOptions) => Promise<TagMergeResult>;
+        };
+        imports: {
+            fromFile: (workspaceId: string, file: File | Blob, options?: RequestOptions) => Promise<Record<string, unknown>>;
+            fromUrl: (workspaceId: string, url: string, options?: RequestOptions) => Promise<Record<string, unknown>>;
+        };
+        duplicates: {
+            getStats: (workspaceId: string, options?: RequestOptions) => Promise<DuplicateStats>;
+            listGroups: (workspaceId: string, opts?: {
+                threshold?: number;
+                limit?: number;
+            }, options?: RequestOptions) => Promise<DuplicateGroup[]>;
+            resolve: (workspaceId: string, groupId: string, keepId: string, options?: RequestOptions) => Promise<DuplicateResolveResult>;
+        };
+        /**
+         * Search goal templates using semantic similarity.
+         *
+         * @param workspaceId - The workspace to search in
+         * @param params - Search parameters
+         * @param params.query - Free-text search query
+         * @param params.limit - Maximum results to return (default: 10)
+         * @returns Array of matching goal templates with similarity scores
+         *
+         * @example
+         * ```typescript
+         * const results = await client.clinical.goalTemplates.search(workspaceId, {
+         *   query: "improve sleep quality and duration",
+         *   limit: 5,
+         * });
+         * ```
+         */
+        search: (workspaceId: string, params: {
+            query: string;
+            limit?: number;
+        }, options?: RequestOptions) => Promise<ClinicalSearchResult[]>;
+    };
+    /**
+     * Recipe search via configured Edamam connector.
+     */
+    recipes: {
+        /**
+         * Search recipes using a connected Edamam API integration.
+         *
+         * Requires an Edamam connector to be configured in the workspace.
+         * Returns raw Edamam API response data.
+         *
+         * @param params - Search parameters. Must include `query`, `connector_id`, and `workspace_id`.
+         * @param options - Request options
+         * @returns Edamam API search results
+         *
+         * @example
+         * ```typescript
+         * const results = await client.clinical.recipes.search({
+         *   query: 'high protein lunch',
+         *   connector_id: 'conn_edamam_123',
+         *   workspace_id: 'ws_123',
+         *   diet: 'high-protein',
+         * });
+         * ```
+         */
+        search: (params: RecipeSearchParams, options?: RequestOptions) => Promise<RecipeSearchResult>;
+    };
+};
+//# sourceMappingURL=clinical.d.ts.map