@ecodrix/erix-api 2.1.4 → 3.0.0

package/dist/ts/esm/index.d.ts

@@ -256,235 +256,6 @@ declare class Analytics extends APIResource {
     retention<T = any>(): Promise<T>;
 }
 
-declare class AutomationDashboard extends APIResource {
-    /**
-     * Retrieve summary statistics for automation health (total, success, failed).
-     *
-     * @returns Stats object.
-     * @example
-     * ```typescript
-     * const stats = await erixClient.crm.automationDashboard.stats();
-     * ```
-     */
-    stats<T = any>(): Promise<T>;
-    /**
-     * List recent EventLog entries representing automation executions.
-     *
-     * @param params - Optional filters (limit, status).
-     * @example
-     * ```typescript
-     * const logs = await erixClient.crm.automationDashboard.logs({ status: "failed" });
-     * ```
-     */
-    logs<T = any>(params?: {
-        limit?: number;
-        status?: string;
-    }): Promise<T>;
-    /**
-     * Re-emit a failed event log to re-trigger its associated automation rules.
-     *
-     * @param logId - The unique ID of the failed event log.
-     * @example
-     * ```typescript
-     * await erixClient.crm.automationDashboard.retryFailedEvent("log_123");
-     * ```
-     */
-    retryFailedEvent<T = any>(logId: string): Promise<T>;
-}
-
-interface AutomationRulePayload {
-    name: string;
-    trigger: string;
-    isActive?: boolean;
-    nodes: any[];
-    edges: any[];
-}
-declare class Automations extends APIResource {
-    /**
-     * List all automation rules (workflows) configured for the tenant.
-     *
-     * @returns Array of automation rule objects.
-     * @example
-     * ```typescript
-     * const rules = await erixClient.crm.automations.list();
-     * ```
-     */
-    list<T = any>(): Promise<T>;
-    /**
-     * Create a new automation rule with triggers and workflow nodes.
-     *
-     * @param payload - The automation rule definition (trigger, nodes, edges).
-     * @returns The created automation rule.
-     * @example
-     * ```typescript
-     * await erixClient.crm.automations.create({
-     *   name: "Welcome Email Workflow",
-     *   trigger: "contact_created",
-     *   nodes: [...],
-     *   edges: [...]
-     * });
-     * ```
-     */
-    create<T = any>(payload: AutomationRulePayload): Promise<T>;
-    /**
-     * Update an existing automation rule.
-     */
-    update<T = any>(ruleId: string, payload: Partial<AutomationRulePayload>): Promise<T>;
-    /**
-     * Enable or disable an automation rule.
-     */
-    toggle<T = any>(ruleId: string): Promise<T>;
-    /**
-     * Delete an automation rule.
-     */
-    delete<T = any>(ruleId: string): Promise<unknown>;
-    /**
-     * Bulk delete rules.
-     */
-    bulkDelete<T = any>(ruleIds: string[]): Promise<T>;
-    /**
-     * Dry-run test an automation rule against a specific lead to verify logic.
-     *
-     * @param ruleId - The ID of the rule to test.
-     * @param leadId - The ID of the lead to run the test against.
-     * @example
-     * ```typescript
-     * await erixClient.crm.automations.test("rule_123", "lead_456");
-     * ```
-     */
-    test<T = any>(ruleId: string, leadId: string): Promise<T>;
-    /**
-     * Get available event triggers for automations.
-     */
-    getAvailableEvents<T = any>(): Promise<T>;
-    /**
-     * List enrollments for a rule.
-     */
-    enrollments<T = any>(ruleId: string, params?: {
-        status?: string;
-        page?: number;
-        limit?: number;
-        startDate?: string;
-        endDate?: string;
-    }): Promise<T>;
-    /**
-     * Get an enrollment detail.
-     */
-    getEnrollment<T = any>(enrollmentId: string): Promise<T>;
-    /**
-     * Pause an enrollment.
-     */
-    pauseEnrollment<T = any>(ruleId: string, enrollmentId: string): Promise<T>;
-    /**
-     * Resume an enrollment.
-     */
-    resumeEnrollment<T = any>(ruleId: string, enrollmentId: string): Promise<T>;
-    /**
-     * List workflow runs.
-     */
-    runs<T = any>(ruleId: string): Promise<T>;
-    /**
-     * Get run details.
-     */
-    getRun<T = any>(runId: string): Promise<T>;
-    /**
-     * Resume a paused run.
-     */
-    resumeRun<T = any>(runId: string): Promise<T>;
-    /**
-     * Abort a running workflow.
-     */
-    abortRun<T = any>(runId: string): Promise<T>;
-    /**
-     * Emit an external webhook event to unlock a `wait_event` node inside a
-     * paused workflow run. Required when integrating third-party tools that
-     * need to resume a suspended automation.
-     *
-     * @param ruleId - The automation rule that contains the wait_event node.
-     * @param eventName - The event name that should match the node's condition.
-     * @param payload - Arbitrary data forwarded to the node context.
-     */
-    webhookEvent<T = any>(ruleId: string, eventName: string, payload?: any): Promise<T>;
-    /**
-     * Fire a CRM automation trigger for a given phone number.
-     *
-     * @param params - Trigger payload (trigger name, phone, variables, etc.)
-     */
-    trigger<T = any>(params: {
-        trigger: string;
-        phone: string;
-        email?: string;
-        variables?: Record<string, string>;
-        createLeadIfMissing?: boolean;
-        leadData?: any;
-        delayMinutes?: number;
-        runAt?: Date | string;
-    }): Promise<T>;
-}
-
-/**
- * CRM Campaigns — broadcast campaigns with A/B testing.
- *
- * @example
- * ```typescript
- * const campaigns = await ecod.crm.campaigns.list();
- * const analytics = await ecod.crm.campaigns.analytics("campaign-id");
- * const ab = await ecod.crm.campaigns.createAB({ channel: "email", ... });
- * ```
- */
-declare class CRMCampaigns extends APIResource {
-    /**
-     * List campaigns with metrics.
-     */
-    list<T = any>(params?: {
-        status?: string;
-        startDate?: string;
-        endDate?: string;
-        page?: number;
-        limit?: number;
-    }): Promise<T>;
-    /**
-     * Get analytics for a specific campaign.
-     */
-    analytics<T = any>(campaignId: string): Promise<T>;
-    /**
-     * Create and send a campaign.
-     */
-    create<T = any>(payload: {
-        channel: "email" | "whatsapp";
-        recipients: Array<string | {
-            email?: string;
-            phone?: string;
-            name?: string;
-        }>;
-        subject?: string;
-        html?: string;
-        templateName?: string;
-        languageCode?: string;
-        variables?: Record<string, unknown>;
-    }): Promise<T>;
-    /**
-     * Create an A/B split test campaign.
-     */
-    createAB<T = any>(payload: {
-        channel: "email" | "whatsapp";
-        recipients: Array<string | {
-            email?: string;
-            phone?: string;
-            name?: string;
-        }>;
-        variants: Array<{
-            name: string;
-            subject?: string;
-            html?: string;
-            templateName?: string;
-        }>;
-        testPercent?: number;
-        waitHours?: number;
-        winnerMetric?: "open" | "click" | "reply" | "delivered";
-    }): Promise<T>;
-}
-
 /**
  * CRM Documents — document checklist management per lead.
  *
@@ -768,6 +539,14 @@ interface UpsertLeadParams {
         phone: string;
         name?: string;
     };
+    /**
+     * Generic, tenant-agnostic cross-reference map ({ refKey: refValue }) the
+     * caller controls — e.g. `{ orderId: "..." }`, `{ appointmentId: "..." }`,
+     * or any custom key. Merged into the lead's `metadata.refs`. Preferred over
+     * the deprecated `moduleInfo`.
+     */
+    refs?: Record<string, string>;
+    /** @deprecated Use `refs` instead. Retained for backward compatibility. */
     moduleInfo?: any;
     trigger?: string;
     pipelineId?: string;
@@ -1049,9 +828,10 @@ declare class Leads extends APIResource {
      */
     meetings<T = any>(leadId: string): Promise<T>;
     /**
-     * List sequence enrollments for this lead.
+     * List automation history for this lead as Flow runs. Flow is the automation
+     * engine — this returns the workflow runs triggered for the lead.
      */
-    sequences<T = any>(leadId: string): Promise<T>;
+    flowRuns<T = any>(leadId: string): Promise<T>;
     /**
      * Merge two duplicate leads. Primary survives, secondary's data is merged in
      * (conversations, activities, tags) and the secondary is deleted.
@@ -1301,516 +1081,116 @@ declare class Scoring extends APIResource {
     preview<T = any>(leadId: string): Promise<T>;
 }
 
-declare class Sequences extends APIResource {
-    /**
-     * Manually enroll a lead into a specific automation drip sequence (Workflow).
-     *
-     * @param payload - Enrollment details (leadId, ruleId, and custom variables).
-     * @example
-     * ```typescript
-     * await erixClient.crm.sequences.enroll({
-     *   leadId: "lead_123",
-     *   ruleId: "rule_456",
-     *   variables: { start_date: "2026-05-01" }
-     * });
-     * ```
-     */
-    enroll<T = any>(payload: {
-        leadId: string;
-        ruleId: string;
-        variables?: Record<string, any>;
-    }): Promise<T>;
-    /**
-     * Unenroll a lead from a currently running automation sequence.
-     *
-     * @param enrollmentId - The unique ID of the sequence enrollment.
-     * @example
-     * ```typescript
-     * await erixClient.crm.sequences.unenroll("enroll_123");
-     * ```
-     */
-    unenroll<T = any>(enrollmentId: string): Promise<unknown>;
-    /**
-     * List all active and completed sequence enrollments for a specific lead.
-     *
-     * @param leadId - The unique ID of the lead.
-     * @returns Array of enrollment records.
-     * @example
-     * ```typescript
-     * const enrollments = await erixClient.crm.sequences.listForLead("lead_123");
-     * ```
-     */
-    listForLead<T = any>(leadId: string): Promise<T>;
-}
-
-/**
- * Broadcast campaign entity returned by `/product/erix/chat/broadcasts`.
- *
- * Tracks the lifecycle of a bulk WhatsApp send and its delivery counters.
- */
-interface Broadcast {
-    _id: string;
-    name: string;
-    templateName: string;
-    status: "draft" | "scheduled" | "sending" | "completed" | "failed";
-    recipientCount: number;
-    sentCount: number;
-    deliveredCount: number;
-    readCount: number;
-    createdAt: string;
-    scheduledAt?: string;
-    completedAt?: string;
-}
-interface CreateBroadcastParams {
-    /** Optional name for the broadcast campaign */
-    name?: string;
-    /** Name of the Meta template to send */
-    templateName: string;
-    /** Language code (defaults to en_US) */
-    templateLanguage?: string;
-    /** List of recipients with their phone numbers and variable overrides */
-    recipients: {
-        phone: string;
-        variables?: string[];
-    }[];
-}
-declare class Broadcasts extends APIResource {
-    /**
-     * List past and active WhatsApp broadcast campaigns.
-     *
-     * @param params - Optional filter parameters (page, limit, status).
-     * @returns Paginated list of broadcast records.
-     * @example
-     * ```typescript
-     * const broadcasts = await erixClient.whatsapp.broadcasts.list({ limit: 10 });
-     * ```
-     */
-    list<T = any>(params?: Record<string, any>): Promise<T>;
-    /**
-     * Retrieve full details and real-time stats for a specific broadcast campaign.
-     *
-     * @param id - The unique identifier of the broadcast.
-     * @returns The broadcast record including sent/failed counts.
-     * @example
-     * ```typescript
-     * const stats = await erixClient.whatsapp.broadcasts.retrieve("bc_123");
-     * console.log(`Success Rate: ${(stats.sentCount / stats.totalRecipients) * 100}%`);
-     * ```
-     */
-    retrieve<T = any>(id: string): Promise<T>;
-    /**
-     * Create a new broadcast campaign to send template messages to multiple recipients.
-     *
-     * @param params - Broadcast configuration (name, templateName, recipients).
-     * @returns The newly created broadcast record.
-     * @example
-     * ```typescript
-     * await erixClient.whatsapp.broadcasts.create({
-     *   name: "Spring Sale",
-     *   templateName: "promo_code",
-     *   recipients: [
-     *     { phone: "+919876543210", variables: ["SAVE10"] }
-     *   ]
-     * });
-     * ```
-     */
-    create<T = any>(params: CreateBroadcastParams): Promise<T>;
-    /**
-     * Update broadcast metadata, such as its name or administrative status.
-     *
-     * @param id - The unique ID of the broadcast.
-     * @param data - The fields to update (name, status).
-     * @example
-     * ```typescript
-     * await erixClient.whatsapp.broadcasts.update("bc_123", { name: "Revised Spring Sale" });
-     * ```
-     */
-    update<T = any>(id: string, data: {
-        name?: string;
-        status?: string;
-    }): Promise<T>;
-    /**
-     * Delete a broadcast campaign record.
-     * Note: This does not cancel messages already in flight but removes the record from the dashboard.
-     *
-     * @param id - The unique ID of the broadcast.
-     * @example
-     * ```typescript
-     * await erixClient.whatsapp.broadcasts.delete("bc_123");
-     * ```
-     */
-    delete<T = any>(id: string): Promise<T>;
-}
-
-/**
- * Conversation entity returned by `/product/erix/chat/conversations`.
- *
- * Represents a single WhatsApp thread between the workspace and an
- * external phone number. `status` is the conversation lifecycle (open
- * vs resolved) — distinct from `LeadStatus` on the linked lead.
- */
+/** Channels the platform inbox carries. */
+type InboxChannel = "whatsapp" | "instagram" | "facebook" | "telegram" | "email" | "webchat";
+/** One inbox thread (any channel) — served by `/platform/inbox`. */
 interface Conversation {
-    _id: string;
+    id: string;
+    leadId: string | null;
+    channel: InboxChannel;
+    /** The contact's address on that channel (phone, IG id, chat id…). */
     phone: string;
-    contactName?: string;
-    lastMessage?: {
-        body: string;
-        timestamp: string;
-        direction: "inbound" | "outbound";
-    };
+    userName: string | null;
+    profilePicture: string | null;
+    lastMessage: string | null;
+    lastMessageAt: string | null;
     unreadCount: number;
-    status: "open" | "resolved";
-    assignedTo?: string;
-    leadId?: string;
-    updatedAt: string;
+    status: string;
+    updatedAt: string | null;
 }
 interface ListParams {
-    limit?: number;
-    before?: string;
-    after?: string;
+    channel?: InboxChannel;
     status?: string;
+    search?: string;
+    limit?: number;
+    offset?: number;
 }
+/**
+ * The unified inbox (WhatsApp, Instagram, Facebook, Telegram, email, webchat)
+ * — one set of threads for every channel.
+ */
 declare class Conversations extends APIResource {
-    /**
-     * List conversations for the tenant.
-     * @deprecated Use `list` method from `ErixClient` instead.
-     * @param params - List parameters.
-     * @returns List of conversations.
-     * @example
-     * ```typescript
-     * import { ErixClient } from "erix-react";
-     * const erixClient = new ErixClient({ apiKey: "YOUR_API_KEY" });
-     * const conversations = await erixClient.whatsapp.conversations.list();
-     * ```
-     */
+    /** Threads, newest first. Response: `{ success, data, total }`. */
     list<T = any>(params?: ListParams): Promise<T>;
-    /**
-     * Create a new conversation explicitly.
-     *
-     * @param params - Conversation details.
-     * @example
-     * ```typescript
-     * const conversation = await erixClient.whatsapp.conversations.create({
-     *   phone: "+919876543210",
-     *   name: "John Doe"
-     * });
-     * ```
-     */
+    /** Find or open the thread for a contact (defaults to WhatsApp). */
     create<T = any>(params: {
         phone: string;
         name?: string;
+        channel?: InboxChannel;
     }): Promise<T>;
-    /**
-     * Retrieve details of a specific conversation.
-     *
-     * @param conversationId - The unique ID of the conversation.
-     * @example
-     * ```typescript
-     * const conversation = await erixClient.whatsapp.conversations.retrieve("conv_123");
-     * ```
-     */
+    /** Link the thread to one of your CRM leads (e.g. after creating it). */
+    linkLead<T = any>(conversationId: string, leadId: string): Promise<T>;
     retrieve<T = any>(conversationId: string): Promise<T>;
     /**
-     * Get messages for a specific conversation.
-     *
-     * @param conversationId - The unique ID of the conversation.
-     * @param params - Pagination and filter parameters.
-     * @example
-     * ```typescript
-     * const messages = await erixClient.whatsapp.conversations.messages("conv_123", { limit: 50 });
-     * ```
-     */
-    messages<T = any>(conversationId: string, params?: ListParams): Promise<T>;
-    /**
-     * Link a conversation to a lead in the CRM.
-     *
-     * @param conversationId - The unique ID of the conversation.
-     * @param leadId - The unique ID of the lead to link.
-     * @param leadData - Optional additional lead metadata.
-     * @example
-     * ```typescript
-     * await erixClient.whatsapp.conversations.linkLead("conv_123", "lead_456");
-     * ```
-     */
-    linkLead<T = any>(conversationId: string, leadId: string, leadData?: any): Promise<T>;
-    /**
-     * Mark a conversation as read (clear unread count).
-     *
-     * @param conversationId - The unique ID of the conversation.
-     * @example
-     * ```typescript
-     * await erixClient.whatsapp.conversations.markRead("conv_123");
-     * ```
+     * Messages of a thread, newest page first. Page back with `before` = the
+     * oldest message's `createdAt` you have. Response: `{ data, hasMore }`.
      */
+    messages<T = any>(conversationId: string, params?: {
+        limit?: number;
+        before?: string;
+    }): Promise<T>;
     markRead<T = any>(conversationId: string): Promise<T>;
-    /**
-     * Delete a conversation.
-     *
-     * @param conversationId - The unique ID of the conversation.
-     * @example
-     * ```typescript
-     * await erixClient.whatsapp.conversations.delete("conv_123");
-     * ```
-     */
     delete(conversationId: string): Promise<unknown>;
-    /**
-     * Bulk delete conversations.
-     *
-     * @param ids - Array of conversation IDs to delete.
-     * @example
-     * ```typescript
-     * await erixClient.whatsapp.conversations.bulkDelete(["conv_1", "conv_2"]);
-     * ```
-     */
+    /** Delete 1–100 threads. */
     bulkDelete<T = any>(ids: string[]): Promise<T>;
 }
 
-/**
- * A single chat message inside a `Conversation`.
- */
+/** One inbox message (any channel). */
 interface Message {
-    _id: string;
+    id: string;
     conversationId: string;
-    body?: string;
-    mediaUrl?: string;
-    mediaType?: "image" | "video" | "audio" | "document";
     direction: "inbound" | "outbound";
-    status: "sent" | "delivered" | "read" | "failed";
-    timestamp: string;
-    replyToId?: string;
+    messageType: string;
+    text: string | null;
+    mediaUrl: string | null;
+    mediaType: string | null;
+    caption: string | null;
+    status: string;
+    isStarred: boolean;
+    createdAt?: string;
+}
+/** A file already uploaded to YOUR tenant storage (see {@link Messages.upload}). */
+interface OutboundMedia {
+    key: string;
+    mimeType: string;
+    fileName?: string;
 }
-/**
- * Parameters for sending a free-form WhatsApp message.
- */
 interface SendMessageParams {
-    /**
-     * Recipient's phone number in E.164 format.
-     * @example "+919876543210"
-     */
-    to?: string;
-    /**
-     * The unique ID of the conversation. If supplied, `to` is resolved automatically.
-     */
+    /** Reply in an existing inbox thread (any channel). */
     conversationId?: string;
-    /** Plain text body of the message. */
+    /** …or message a WhatsApp number directly (free text needs an open 24h window). */
+    to?: string;
     text?: string;
-    /** Public URL of the media asset to send. */
-    mediaUrl?: string;
-    /** MIME category of the media. */
-    mediaType?: "image" | "video" | "audio" | "document";
-    /** The `messageId` of the message to reply to (quoted replies). */
-    replyToId?: string;
-    /** Filename shown to the recipient (required for `document` type). */
-    filename?: string;
-    /** Arbitrary metadata stored with the message record. */
-    metadata?: Record<string, any>;
-    /** Template name for template messages. */
-    templateName?: string;
-    /** Template language for template messages. */
-    templateLanguage?: string;
-    /** Alternative language parameter. */
-    language?: string;
-    /** Template variables. */
-    variables?: string[];
+    /** An uploaded file — inbox threads only (WhatsApp today). */
+    media?: OutboundMedia;
 }
-/**
- * Parameters for sending a pre-approved WhatsApp Business template.
- */
 interface SendTemplateParams {
-    /**
-     * Recipient's phone number in E.164 format.
-     * @example "+919876543210"
-     */
-    to?: string;
-    /**
-     * The unique ID of the conversation.
-     */
-    conversationId?: string;
-    /** The exact template name as approved in Meta Business Manager. */
+    /** Recipient phone (E.164). */
+    to: string;
+    /** Template name as approved in Meta Business Manager. */
     templateName: string;
-    /**
-     * BCP-47 language code for the template.
-     * @default "en_US"
-     */
     language?: string;
-    /**
-     * Ordered array of variable substitutions for template placeholders.
-     * @example ["Alice", "10 April 2026", "10:00 AM"]
-     */
     variables?: string[];
-    /** Optional header media URL (for templates with media headers). */
-    mediaUrl?: string;
-    /** Media type for the header (e.g. "image", "document"). */
-    mediaType?: string;
-    /** User ID of the agent sending the message. */
-    userId?: string;
-    /** Optional filename for media headers. */
-    filename?: string;
-    /** Template language for template messages. */
-    templateLanguage?: string;
-}
-/**
- * WhatsApp outbound messaging resource.
- *
- * Access via `ecod.whatsapp.messages`.
- *
- * @example
- * ```typescript
- * await ecod.whatsapp.messages.send({
- *   to: "+919876543210",
- *   text: "Your appointment is confirmed!",
- * });
- * ```
- */
-/**
- * Resolved media metadata returned by any upload endpoint.
- * `variants` is only present for raster images (JPEG, PNG, WebP, AVIF, GIF).
- */
-interface ChatMediaMeta {
-    /** Raw CDN URL — always present, all media types */
-    url: string;
-    /** Categorical type — "image" | "video" | "audio" | "document" */
-    type: "image" | "video" | "audio" | "document";
-    /** Cloudflare-optimised variant URLs. Only present for raster images. */
-    variants?: {
-        /** 150px WebP — use for list thumbnails and chat bubbles */
-        thumb: string;
-        /** 600px WebP — use for modal previews */
-        medium: string;
-        /** 1200px WebP — use for hero or full-screen views */
-        full: string;
-        /** Original CDN URL, no transformation */
-        raw: string;
-    };
-    /** Storage key within the tenant bucket */
-    key?: string;
-    /** Original filename */
-    fileName?: string;
 }
 declare class Messages extends APIResource {
     /**
-     * Send a free-text or media message to a WhatsApp number.
-     *
-     * For text-only messages, supply `text`. For media, supply `mediaUrl`
-     * and `mediaType`. Both can be combined in a single message.
-     *
-     * @param params - Message parameters including recipient, text, and media.
-     * @returns The created message record from the database.
-     *
-     * @example Send a simple text message
-     * ```typescript
-     * await erixClient.whatsapp.messages.send({
-     *   to: "+919876543210",
-     *   text: "Hello from Ecodrix!",
-     * });
-     * ```
-     *
-     * @example Send an image with a caption
-     * ```typescript
-     * await erixClient.whatsapp.messages.send({
-     *   to: "+919876543210",
-     *   text: "Check out this flyer",
-     *   mediaUrl: "https://example.com/flyer.jpg",
-     *   mediaType: "image",
-     * });
-     * ```
+     * Send a message. With `conversationId` it goes through the unified inbox
+     * (text and/or `media`); with `to` it's a direct WhatsApp text.
      */
     send<T = any>(params: SendMessageParams): Promise<T>;
-    /**
-     * Send a pre-approved WhatsApp Business template message.
-     *
-     * Templates must be approved in Meta Business Manager before they can be sent.
-     * Variable placeholders (e.g., {{1}}, {{2}}) are replaced with values from the
-     * `variables` array in order.
-     *
-     * @param params - Template message configuration (name, language, variables).
-     * @returns The created message record.
-     *
-     * @example
-     * ```typescript
-     * await erixClient.whatsapp.messages.sendTemplate({
-     *   to: "+919876543210",
-     *   templateName: "welcome_user",
-     *   language: "en_US",
-     *   variables: ["Alice"], // Replaces {{1}} in template
-     * });
-     * ```
-     */
+    /** Send an approved WhatsApp template (opens a conversation). */
     sendTemplate<T = any>(params: SendTemplateParams): Promise<T>;
-    /**
-     * Star or unstar a message.
-     *
-     * @param messageId - The ID of the message.
-     * @param isStarred - Boolean indicating whether to star or unstar.
-     */
     star<T = any>(messageId: string, isStarred: boolean): Promise<T>;
-    /**
-     * React to a message with an emoji.
-     *
-     * @param messageId - The ID of the message.
-     * @param reaction - The emoji (e.g. "👍") to react with, or empty string to remove.
-     */
-    react<T = any>(messageId: string, reaction: string): Promise<T>;
-    /**
-     * Mark all messages in a conversation as read (double-tick).
-     *
-     * @param conversationId - The conversation to mark as read.
-     *
-     * @example
-     * ```typescript
-     * await ecod.whatsapp.messages.markRead("conv_64abc...");
-     * ```
-     */
     markRead(conversationId: string): Promise<unknown>;
     /**
-     * Upload a media file for WhatsApp chat.
-     *
-     * Works with any file type — image, video, audio, or document.
-     * For raster images the response includes Cloudflare-optimised `variants`
-     * (thumb 150px, medium 600px, full 1200px). Non-image types return only `url`.
-     *
-     * @param file - The file to upload (File, Blob, or Buffer).
-     * @returns Full media metadata `{ url, type, variants?, key, fileName }`.
-     *
-     * @example
-     * ```typescript
-     * const file = input.files[0];
-     * const { data } = await ecod.whatsapp.messages.upload(file);
-     * // For images: data.variants.thumb → 150px WebP from Cloudflare
-     * // For video/audio: use data.url directly in <video> or <audio>
-     * ```
-     */
-    upload(file: any): Promise<{
-        success: boolean;
-        data: ChatMediaMeta;
-    }>;
-}
-
-/**
- * Channel-agnostic marketing campaigns (email / SMS / WhatsApp) owned by
- * ERIX-CRM. Mounted at `/product/erix/crm/campaigns`.
- *
- * Access via `ecod.product.erix.campaigns`.
- */
-declare class Campaigns extends APIResource {
-    /**
-     * List campaigns with optional status filtering.
-     */
-    list<T = any>(params?: {
-        status?: string;
-        limit?: number;
-        page?: number;
-        startDate?: string;
-        endDate?: string;
-    }): Promise<T>;
-    /**
-     * Create a campaign.
+     * Upload a file to your tenant storage for sending as `media`:
+     * presign → PUT straight to storage → confirm (counts usage). Your API key
+     * never goes to the storage host.
      */
-    create<T = any>(payload: Record<string, unknown>): Promise<T>;
-    /**
-     * Delivery + engagement analytics for a campaign (opens, clicks, bounces).
-     */
-    stats<T = any>(campaignId: string): Promise<T>;
+    upload(file: Blob, opts?: {
+        fileName?: string;
+        folder?: string;
+    }): Promise<OutboundMedia>;
 }
 
 interface CheckoutProduct {
@@ -1917,9 +1297,15 @@ declare class Checkout extends APIResource {
 interface TriggerPayload {
     /** The name of the event to fire (e.g., "webinar_joined") */
     trigger: string;
-    /** Phone number of the lead (E.164 format) */
-    phone: string;
-    /** Email of the lead */
+    /**
+     * Phone number of the lead (E.164 format). Phone OR email is required —
+     * at least one of `phone`/`email` must be provided (enforced server-side).
+     */
+    phone?: string;
+    /**
+     * Email of the lead. Phone OR email is required — at least one of
+     * `phone`/`email` must be provided (enforced server-side).
+     */
     email?: string;
     /** Key-value pairs for string templates */
     variables?: Record<string, string>;
@@ -1964,18 +1350,18 @@ interface TriggerResponse {
         eventLogId: string;
         trigger: string;
         leadId: string;
-        rulesMatched: number;
     };
     message?: string;
     code?: string;
 }
 declare class EventsResource extends APIResource {
     /**
-     * Programmatically trigger an automation workflow by firing a specific event.
-     * This matches the event against active Automation Rules and executes linked actions.
+     * Programmatically trigger an automation by firing a specific event.
+     * This matches the event against active Flows (Flow is the automation
+     * engine) and starts each flow whose declared trigger matches.
      *
      * @param payload - The trigger details (event name, lead phone/email, variables).
-     * @returns Trigger response with diagnostic info (eventLogId, matched rules).
+     * @returns Trigger response with diagnostic info (eventLogId, trigger, leadId).
      * @example
      * ```typescript
      * await erixClient.events.trigger({
@@ -1988,7 +1374,8 @@ declare class EventsResource extends APIResource {
      */
     trigger(payload: TriggerPayload): Promise<TriggerResponse>;
     /**
-     * List all custom event definitions.
+     * Every trigger a flow can start on: built-ins plus your custom events.
+     * Response: `{ success, data: { triggers } }`.
      */
     listCustomEvents<T = any>(): Promise<T>;
     /**
@@ -2039,10 +1426,8 @@ declare class Invoices extends APIResource {
      * Update an invoice.
      */
     update<T = any>(id: string, payload: Record<string, unknown>): Promise<T>;
-    /**
-     * Delete an invoice.
-     */
-    delete<T = any>(id: string): Promise<T>;
+    /** Void an invoice (invoices are never deleted — GST records stay). */
+    void<T = any>(id: string): Promise<T>;
     /**
      * Send an invoice via WhatsApp to the linked lead.
      */
@@ -2057,89 +1442,6 @@ declare class Invoices extends APIResource {
     updateSettings<T = any>(payload: Record<string, unknown>): Promise<T>;
 }
 
-interface LogPaginationQuery {
-    page?: number;
-    limit?: number;
-    trigger?: string;
-    status?: "received" | "processing" | "completed" | "partial" | "failed";
-    from?: string;
-    to?: string;
-}
-interface EventLog {
-    id: string;
-    trigger: string;
-    phone?: string;
-    email?: string;
-    status: "received" | "processing" | "completed" | "partial" | "failed";
-    rulesMatched: number;
-    jobsCreated: number;
-    meetLink?: string;
-    callbackUrl?: string;
-    callbackStatus: "not_required" | "sent" | "failed";
-    payload: any;
-    error?: string;
-    idempotencyKey?: string;
-    processedAt?: string;
-    createdAt: string;
-    updatedAt: string;
-}
-interface CallbackLog {
-    id: string;
-    callbackUrl: string;
-    method: string;
-    payload: any;
-    jobId?: string;
-    enrollmentId?: string;
-    responseStatus: number;
-    responseBody: string;
-    status: "sent" | "failed" | "pending_retry";
-    attempts: number;
-    lastAttemptAt?: string;
-    signature?: string;
-    createdAt: string;
-}
-interface LogResponse<T> {
-    success: boolean;
-    data: T[];
-    pagination: {
-        total: number;
-        page: number;
-        limit: number;
-        pages: number;
-    };
-}
-/**
- * Audit and execution logs for platform events and webhooks.
- *
- * Access via `ecod.logs`.
- */
-declare class Logs extends APIResource {
-    /**
-     * List event execution logs with optional filtering.
-     *
-     * Use this to audit automation triggers and debug workflow execution.
-     */
-    listEventLogs(query?: LogPaginationQuery): Promise<LogResponse<EventLog>>;
-    /**
-     * Get detailed information for a single event execution.
-     */
-    getEventLog(id: string): Promise<{
-        success: boolean;
-        data: EventLog;
-    }>;
-    /**
-     * List webhook callback logs (outbound responses from ECODrIx to your system).
-     */
-    listCallbackLogs(query?: LogPaginationQuery): Promise<LogResponse<CallbackLog>>;
-    /**
-     * Get high-level execution statistics for the tenant.
-     */
-    getStats(): Promise<{
-        success: boolean;
-        data: any;
-    }>;
-}
-
 /**
  * Niche Resources — Workflow packs + WhatsApp template suggestions.
  *
@@ -2170,41 +1472,6 @@ declare class NicheResources extends APIResource {
     templateSuggestions<T = any>(): Promise<T>;
 }
 
-/**
- * Portal Inbox — team-side unified inbox for portal conversations.
- *
- * Lists all projects with active client threads, retrieves messages,
- * and posts replies. Mounted at `/product/erix/portal-inbox`.
- *
- * @example
- * ```typescript
- * const threads = await ecod.portalInbox.conversations();
- * const messages = await ecod.portalInbox.messages(projectId);
- * await ecod.portalInbox.reply(projectId, { body: "We'll get back to you!" });
- * ```
- */
-declare class PortalInbox extends APIResource {
-    /**
-     * List all projects with active portal conversation threads.
-     * Returns projectId, projectName, lastMessageAt, lastBody, lastSender, unreadCount.
-     */
-    conversations<T = any>(): Promise<T>;
-    /**
-     * Get paginated messages for a project's portal thread.
-     */
-    messages<T = any>(projectId: string): Promise<T>;
-    /**
-     * Post a reply from the team to a project's portal thread.
-     */
-    reply<T = any>(projectId: string, payload: {
-        body: string;
-        attachments?: Array<{
-            name: string;
-            url: string;
-        }>;
-    }): Promise<T>;
-}
-
 /**
  * Project Documents + E-Sign — document management and digital signatures
  * for CRM projects.
@@ -2343,6 +1610,16 @@ declare class Connect extends APIResource {
         module: "crm" | "flow" | "laie";
         enabled: boolean;
     }): Promise<T>;
+    /**
+     * One-click Google OAuth: the consent-popup URL for the signed-in tenant.
+     * It carries a short-lived (5 min) ticket, so open it right away.
+     */
+    googleConnectUrl(): Promise<{
+        success: boolean;
+        data: {
+            url: string;
+        };
+    }>;
     /**
      * Create a payment link on the tenant's OWN connected gateway
      * (Razorpay / Stripe). Tenant-scoped; requires the `payments` provider to be
@@ -2789,9 +2066,65 @@ interface Template {
     status: "APPROVED" | "PENDING" | "REJECTED";
     components: TemplateComponent[];
 }
+type TemplateBindingSource = "crm" | "trigger" | "system" | "manual" | "static" | "computed";
+type TemplateEmptyPolicy = "use_fallback" | "error" | "empty_string";
+interface TemplateBinding {
+    token?: string;
+    position: number;
+    source: TemplateBindingSource;
+    collection?: string;
+    field?: string;
+    staticValue?: string;
+    formula?: string;
+    transform?: string;
+    fallback?: string;
+    required?: boolean;
+    label?: string;
+    componentType?: string;
+    componentIndex?: number;
+    originalIndex?: string | number;
+}
 interface TemplateMapping {
-    mappings: any[];
-    onEmptyVariable: string;
+    mappings: TemplateBinding[];
+    onEmptyVariable: TemplateEmptyPolicy;
+}
+interface MappingField {
+    key: string;
+    label: string;
+    type?: string;
+    dataType?: string;
+}
+interface MappingSources {
+    collections: Array<{
+        name: string;
+        label: string;
+        fields: MappingField[];
+    }>;
+    triggers: Array<{
+        name: string;
+        label: string;
+        fields: MappingField[];
+    }>;
+    system: MappingField[];
+    static: {
+        hint: string;
+    };
+}
+interface TemplateApiResponse<T> {
+    success: boolean;
+    data: T;
+    message?: string;
+    error?: string;
+}
+interface MappingValidationResult {
+    isReady: boolean;
+    mappingCount: number;
+}
+interface MappingPreviewResult {
+    isReady: boolean;
+    resolvedVariables: string[];
+    previewText: string;
+    contextSnapshot?: Record<string, unknown>;
 }
 declare class Templates extends APIResource {
     /**
@@ -2873,8 +2206,10 @@ declare class Templates extends APIResource {
      * ```
      */
     mappingConfig<T = any>(): Promise<T>;
+    /** Tenant-scoped CRM, custom-field, automation, and system mapping sources. */
+    mappingSources<T = MappingSources>(): Promise<TemplateApiResponse<T>>;
     /**
-     * List CRM collections available for variable mapping (Leads, Deals, etc.).
+     * List CRM collections available for variable mapping (legacy).
      */
     collections<T = any>(): Promise<T>;
     /**
@@ -2889,27 +2224,17 @@ declare class Templates extends APIResource {
      * @param templateName - Name of the template.
      * @param payload - Mapping definitions.
      */
-    updateMapping<T = any>(templateName: string, payload: TemplateMapping): Promise<T>;
-    /**
-     * Validate if a template is ready for automated sending based on its mappings.
-     */
-    validate<T = any>(templateName: string): Promise<T>;
+    updateMapping<T = unknown>(templateName: string, payload: TemplateMapping): Promise<TemplateApiResponse<T>>;
+    /** Validate a persisted mapping, or a draft mapping before saving. */
+    validate<T = MappingValidationResult>(templateName: string, draft?: TemplateMapping): Promise<TemplateApiResponse<T>>;
     /**
-     * Preview a template resolution with sample data.
-     *
-     * @param templateName - Name of the template.
-     * @param context - Lead data or variable overrides for preview.
-     * @example
-     * ```typescript
-     * const preview = await erixClient.whatsapp.templates.preview("welcome", {
-     *   lead: { firstName: "Alice" }
-     * });
-     * ```
+     * Preview a template resolution with caller-provided sample data.
+     * Draft mappings are validated server-side and are never persisted.
      */
-    preview<T = any>(templateName: string, context: {
-        lead?: any;
-        vars?: any;
-    }): Promise<T>;
+    preview<T = MappingPreviewResult>(templateName: string, context: {
+        lead?: Record<string, unknown>;
+        vars?: Record<string, unknown>;
+    }, mappings?: TemplateBinding[], onEmptyVariable?: TemplateEmptyPolicy): Promise<TemplateApiResponse<T>>;
     /**
      * Introspect a template and provide a manifest of its required variables.
      *
@@ -2919,10 +2244,6 @@ declare class Templates extends APIResource {
      * @param templateIdentifier - The name or ID of the template.
      */
     getVariableManifest(templateIdentifier: string): Promise<ResourceManifest>;
-    /**
-     * Check which automations or sequences are currently using this template.
-     */
-    checkUsage<T = any>(templateName: string): Promise<T>;
 }
 
 /**
@@ -3106,10 +2427,6 @@ declare class Folders extends APIResource {
      * ```
      */
     create<T = any>(name: string): Promise<T>;
-    /**
-     * Delete a folder and its contents.
-     */
-    delete<T = any>(folderPath: string): Promise<T>;
 }
 declare class Files extends APIResource {
     /**
@@ -3163,27 +2480,104 @@ declare class Files extends APIResource {
     delete(key: string): Promise<unknown>;
 }
 
+interface SystemHealth {
+    status: string;
+    version: string;
+    env: string;
+    uptime: number;
+    db: string;
+    queueDepth: number;
+    timestamp: string;
+}
 /**
- * Adaptive Onboarding type definitions.
- *
- * These types mirror the Postgres data shapes from the
- * `adaptive-onboarding-ai-persona` spec — see
- * `.kiro/specs/adaptive-onboarding-ai-persona/design.md` §"Data Models" and
- * §"Onboarding engine".
+ * Platform health diagnostics.
  *
- * NO RUNTIME CODE. Types only. Both saas (Next.js) and server (Express)
- * import from here so the wire shape stays in lockstep.
- */
-/**
- * Renderable step kinds. The saas selects the appropriate React component
- * from `components/onboarding/steps/*` based on this discriminator.
+ * Access via `ecod.platform.health`.
  */
-type OnboardingStepType = "single_choice" | "multi_choice" | "text_input" | "ai_summary_confirm" | "feature_preview" | "completion";
+declare class Health extends APIResource {
+    /**
+     * Global platform health check — verifies the core API is operational.
+     * Public endpoint: `GET /health`.
+     */
+    system(): Promise<SystemHealth>;
+}
+
 /**
- * One selectable answer option in a `single_choice` / `multi_choice` step.
- */
-interface OnboardingOption {
-    /** Internal value persisted in `session.answers[stepId]`. */
+ * Automation event log and provider callback resource.
+ *
+ * Access via `ecod.notifications`.
+ *
+ * This resource is **read-only**. It exposes platform audit trails — useful
+ * for debugging automation failures, monitoring webhook callbacks, and
+ * building internal ops dashboards.
+ *
+ * @example
+ * ```typescript
+ * // Find failed automations in April
+ * const { data } = await ecod.notifications.listLogs({
+ *   status: "failed",
+ *   startDate: "2026-04-01",
+ *   endDate: "2026-04-30",
+ * });
+ * ```
+ */
+declare class Notifications extends APIResource {
+    /**
+     * List unread CRM notifications and alerts (e.g., lead assignments, system alerts).
+     *
+     * @param params - Optional filters (limit, unreadOnly).
+     * @returns Paginated list of notification objects.
+     * @example
+     * ```typescript
+     * const alerts = await erixClient.notifications.listAlerts({ unreadOnly: true });
+     * ```
+     */
+    listAlerts<T = any>(params?: {
+        limit?: number;
+        unreadOnly?: boolean;
+    }): Promise<T>;
+    /**
+     * Dismiss/mark a specific notification alert as read.
+     *
+     * @param notificationId - The unique ID of the notification.
+     * @example
+     * ```typescript
+     * await erixClient.notifications.dismissAlert("alert_123");
+     * ```
+     */
+    dismissAlert<T = any>(notificationId: string): Promise<T>;
+    /**
+     * Clear all notifications for the current tenant immediately.
+     *
+     * @example
+     * ```typescript
+     * await erixClient.notifications.clearAllAlerts();
+     * ```
+     */
+    clearAllAlerts<T = any>(): Promise<T>;
+}
+
+/**
+ * Adaptive Onboarding type definitions.
+ *
+ * These types mirror the Postgres data shapes from the
+ * `adaptive-onboarding-ai-persona` spec — see
+ * `.kiro/specs/adaptive-onboarding-ai-persona/design.md` §"Data Models" and
+ * §"Onboarding engine".
+ *
+ * NO RUNTIME CODE. Types only. Both saas (Next.js) and server (Express)
+ * import from here so the wire shape stays in lockstep.
+ */
+/**
+ * Renderable step kinds. The saas selects the appropriate React component
+ * from `components/onboarding/steps/*` based on this discriminator.
+ */
+type OnboardingStepType = "single_choice" | "multi_choice" | "text_input" | "ai_summary_confirm" | "feature_preview" | "completion";
+/**
+ * One selectable answer option in a `single_choice` / `multi_choice` step.
+ */
+interface OnboardingOption {
+    /** Internal value persisted in `session.answers[stepId]`. */
     value: string;
     /** Human-readable label shown to the user. */
     label: string;
@@ -3597,6 +2991,135 @@ interface NichePack {
     researchConfig?: NichePackResearchConfig;
 }
 
+/**
+ * Body of `POST /platform/tenants/onboarding/global` — the four-question signup form.
+ *
+ * Fields land directly on `ecodrix_organizations.*` columns (workspace
+ * name, timezone) and `service_config -> 'global'` (primary product,
+ * adaptive flag). See REQ-001.
+ */
+interface GlobalOnboardingPayload {
+    /** Workspace / org display name. Persisted to `ecodrix_organizations.name`. */
+    workspaceName: string;
+    /** Personal display name of the signing-up user. */
+    displayName: string;
+    /** IANA timezone, e.g. `"Asia/Kolkata"`. Persisted to `organizations.timezone`. */
+    timezone: string;
+    /**
+     * The product the user wants to start with. `"not_sure"` defers
+     * per-product onboarding to first product open.
+     */
+    primaryProduct: "crm" | "laie" | "flow" | "not_sure";
+}
+/**
+ * Body of `POST /platform/tenants/onboarding/${productId}/start` — opens a per-product onboarding
+ * session. Triggered by the explicit "Enable {Product}" click on
+ * `/products/<productId>` (REQ-002).
+ */
+interface StartOnboardingPayload {
+    productId: "crm" | "laie" | "flow";
+}
+/**
+ * Body of `POST /platform/tenants/onboarding/${productId}/answer` — records one step's answer and
+ * advances the engine. The saas calls this on every step submit (and as
+ * a debounced PATCH for resumability).
+ */
+interface AnswerOnboardingPayload {
+    sessionId: string;
+    stepId: string;
+    /** Shape depends on the step type — string, string[], boolean, etc. */
+    answer: unknown;
+}
+/**
+ * Body of `POST /platform/tenants/onboarding/complete` — terminates the session,
+ * upserts the persona, and materializes the workspace defaults.
+ */
+interface CompleteOnboardingPayload {
+    sessionId: string;
+}
+/**
+ * Body of `POST /platform/tenants/onboarding/${productId}/edit` — post-completion edit of a single
+ * answer from `/settings/onboarding`. Triggers a `persona_recomputed`
+ * event (REQ-010).
+ */
+interface EditOnboardingPayload {
+    stepId: string;
+    answer: unknown;
+}
+/**
+ * Result of `POST /platform/tenants/onboarding/${productId}/start`.
+ */
+interface StartOnboardingResponse {
+    sessionId: string;
+    firstStep: OnboardingStep;
+}
+/**
+ * Result of `POST /platform/tenants/onboarding/${productId}/answer`.
+ */
+interface AnswerOnboardingResponse {
+    /** `null` when the engine has reached the final step. */
+    nextStep: OnboardingStep | null;
+    draftPersona: Record<string, unknown>;
+}
+/**
+ * Result of `GET /platform/tenants/onboarding/${productId}/state`. Returns the active session
+ * (status `"active"`) for `(userId, productId)`, plus the step the
+ * renderer should currently show.
+ */
+interface OnboardingStateResponse {
+    session: OnboardingSession | null;
+    currentStep: OnboardingStep | null;
+}
+/**
+ * Result of `POST /platform/tenants/onboarding/complete`.
+ */
+interface CompleteOnboardingResponse {
+    /** Opaque persona document — full type lives in `resources/persona.ts`. */
+    persona: Record<string, unknown>;
+    workspaceProfile: WorkspaceProfile;
+}
+/**
+ * Result of `POST /platform/tenants/onboarding/${productId}/edit`.
+ */
+interface EditOnboardingResponse {
+    persona: Record<string, unknown>;
+    /** RFC 6902 JSON Patch describing what changed in the persona. */
+    diff: Array<Record<string, unknown>>;
+}
+/**
+ * Adaptive onboarding resource.
+ *
+ * Mounted on the main client as `ecod.onboarding`. Mirrors the seven
+ * tenant-facing routes documented in `design.md` § "API surface".
+ *
+ * @example
+ * ```typescript
+ * await ecod.onboarding.global({
+ *   workspaceName: "Acme Health",
+ *   displayName: "Alice",
+ *   timezone: "Asia/Kolkata",
+ *   primaryProduct: "crm",
+ * });
+ *
+ * const { sessionId, firstStep } = await ecod.onboarding.start({ productId: "crm" });
+ * await ecod.onboarding.answer({ sessionId, stepId: firstStep.stepId, answer: "healthcare" });
+ * await ecod.onboarding.complete({ sessionId });
+ * ```
+ */
+declare class Onboarding extends APIResource {
+    /**
+     * Submit the four-question global onboarding form (REQ-001).
+     * Updates `ecodrix_organizations.*` columns and
+     * `service_config.global.primaryProduct`.
+     */
+    global<T = unknown>(payload: GlobalOnboardingPayload): Promise<T>;
+    /**
+     * Finalise the session, upsert the persona, and materialize the
+     * niche-tuned workspace defaults.
+     */
+    complete(payload: CompleteOnboardingPayload): Promise<CompleteOnboardingResponse>;
+}
+
 /**
  * Identity block — who the user is, what they sell, where they operate.
  * Stored at `ecodrix_ai_personas.identity` (JSONB).
@@ -4214,2450 +3737,581 @@ declare class Persona extends APIResource {
 }
 
 /**
- * Admin-side onboarding resource.
- *
- * Mounted on the main client as `ecod.adminOnboarding`. Mirrors the
- * platform-admin endpoints under `/platform/admin/onboarding/*`
- * documented in `server/src/platform/routes/admin/onboarding.routes.ts`.
- *
- * Auth: every method requires the elevated platform `coreApiKey`. The
- * SDK forwards it as `x-core-api-key`; admin server-side callers should
- * always construct a client with `coreApiKey` set (see
- * `admin/src/lib/client/erix-admin.ts`).
- *
- * Endpoints covered in this build (task 4.1.1 — list page):
- *
- *   - GET    /platform/admin/onboarding/niche-packs               list
- *   - GET    /platform/admin/onboarding/niche-packs/:slug         fetch one
- *   - POST   /platform/admin/onboarding/niche-packs               create
- *   - PATCH  /platform/admin/onboarding/niche-packs/:slug         update
- *   - POST   /platform/admin/onboarding/niche-packs/:slug/publish publish
- *   - POST   /platform/admin/onboarding/niche-packs/:slug/unpublish back to draft
- *   - POST   /platform/admin/onboarding/niche-packs/:slug/fork    new draft copy
- *   - GET    /platform/admin/onboarding/configs                   list configs
- *   - POST   /platform/admin/onboarding/configs                   create config
- *   - PATCH  /platform/admin/onboarding/configs/:productId/:version  update
- *   - POST   /platform/admin/onboarding/configs/:productId/:version/publish publish
- *
- * Endpoints for A/B onboarding experiments (task 4.2.2):
- *
- *   - GET    /platform/admin/onboarding/experiments               list
- *   - GET    /platform/admin/onboarding/experiments/:slug         fetch one
- *   - POST   /platform/admin/onboarding/experiments               create draft
- *   - PATCH  /platform/admin/onboarding/experiments/:slug         partial update
- *   - DELETE /platform/admin/onboarding/experiments/:slug         hard-delete
+ * Copilot resource — synchronous chat, confirmation, and session management.
  *
- * Successive admin tasks (4.1.2–4.1.5) layer richer editor / fork /
- * publish flows on top of these primitives.
+ * Access via `ecod.platform.ai.copilot`.
  */
-
-/** Niche pack row as returned by the admin list endpoint. */
-interface NichePackSummary {
-    id: string;
-    slug: string;
-    productId: NichePack["productId"];
-    version: string;
-    status: NichePackStatus;
-    /** ISO 8601 — creation timestamp (server clock). */
-    createdAt: string;
-    /** ISO 8601 — last edit timestamp. */
-    updatedAt: string;
-    /** ISO 8601 — first time `status` flipped to `published`. */
-    publishedAt?: string | null;
-    /** Admin staff id who created this version. */
-    createdBy?: string | null;
-}
-/** Filters accepted by `adminOnboarding.listNichePacks`. */
-interface ListNichePacksParams {
-    /** Restrict to a single product family. */
-    productId?: NichePack["productId"];
-    /** Restrict to one lifecycle status. */
-    status?: NichePackStatus;
+declare class Copilot extends APIResource {
     /**
-     * Free-form fuzzy search. Matched (case-insensitive) against `slug`
-     * and `productId`. Whitespace is trimmed.
+     * Send a synchronous (non-streaming) chat message to the copilot.
      */
-    search?: string;
-    /** Page size — server clamps to 1..100, default 25. */
-    limit?: number;
-    /** Pagination offset, default 0. */
-    offset?: number;
-}
-/** Body accepted by the create-pack endpoint. */
-interface CreateNichePackPayload {
-    slug: string;
-    productId: NichePack["productId"];
-    /** Defaults to `"1.0.0"` server-side. */
-    version?: string;
-    onboardingConfig?: Record<string, unknown>;
-    workspaceProfile?: Record<string, unknown>;
-    researchConfig?: Record<string, unknown>;
-}
-/** Body accepted by the update-pack endpoint. At least one field required. */
-interface UpdateNichePackPayload {
-    status?: NichePackStatus;
-    onboardingConfig?: Record<string, unknown>;
-    workspaceProfile?: Record<string, unknown>;
-    researchConfig?: Record<string, unknown>;
-}
-/** Body accepted by the fork-pack endpoint. */
-interface ForkNichePackPayload {
-    /** Source version to clone; defaults to the latest row for the slug. */
-    fromVersion?: string;
-    /** Target version for the new draft; defaults to a server-side bump. */
-    version?: string;
-}
-/**
- * Body accepted by `adminOnboarding.smokeTestNichePack` (task 4.1.5).
- *
- * Both fields are optional:
- *
- *   - `fromVersion` pins a specific row for the slug; without it the
- *     server picks the most recent (typically the latest draft).
- *   - `answers` is a `{ stepId: value }` map. When omitted (or missing
- *     keys for some steps) the in-memory runner auto-picks the first
- *     option of `single_choice` / `multi_choice` steps and uses a
- *     placeholder for `text_input`.
- */
-interface SmokeTestNichePackPayload {
-    fromVersion?: string;
-    answers?: Record<string, unknown>;
-}
-/**
- * One materializer action the live `workspaceShaper.materialize` call
- * WOULD perform if the smoke-tested pack were used in a real
- * onboarding-complete flow. The summary string is what the admin
- * panel renders verbatim ("Would create pipeline 'Patient Journey'
- * with 5 stages").
- */
-type SmokeTestMaterializerAction = {
-    kind: "pipeline";
-    name: string;
-    stageCount: number;
-    isDefault: boolean;
-    summary: string;
-} | {
-    kind: "field";
-    key: string;
-    label: string;
-    type: string;
-    required: boolean;
-    summary: string;
-} | {
-    kind: "automation";
-    name: string;
-    trigger: string;
-    enabled: boolean;
-    summary: string;
-};
-/**
- * Result envelope returned by `adminOnboarding.smokeTestNichePack`.
- *
- * Mirrors `SmokeTestResult` in
- * `server/src/erix/services/onboarding/smokeTestRunner.ts`.
- */
-interface SmokeTestResult {
-    /** In-memory `OnboardingSession` produced by the simulator. */
-    session: OnboardingSession;
-    /** Persona shaped from the answers + memory mappings. */
-    persona: AIPersona;
-    /** Workspace profile produced by `workspaceShaper.produce`. */
-    workspaceProfile: WorkspaceProfile;
-    /** Actions the live materializer would perform. */
-    materializerActions: SmokeTestMaterializerAction[];
-    /** Wall-clock duration (millis) of the simulation. */
-    durationMs: number;
-    /** Step ids the engine visited (in order). */
-    visitedStepIds: string[];
-    /** Step ids the engine skipped via branching predicates. */
-    skippedStepIds: string[];
-    /** Whether the runner had to auto-pick at least one answer. */
-    autoPicked: boolean;
-}
-/** Standard `{ success, data }` envelope used by every admin endpoint. */
-interface ApiEnvelope<T> {
-    success: boolean;
-    data: T;
-}
-/** Envelope returned by `GET /platform/admin/onboarding/niche-packs`. */
-interface ListNichePacksResponse extends ApiEnvelope<NichePackSummary[]> {
+    chatSync<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Total niche-pack rows matching the current filter set, ignoring
-     * the page window. Drives the saas-side paginator. Falls back to
-     * `data.length` when the server can't compute a true count.
+     * Confirm a pending copilot action.
      */
-    total: number;
-}
-/** Envelope returned by single-pack endpoints (get / create / update / fork). */
-type NichePackResponse = ApiEnvelope<NichePack & NichePackSummary>;
-/** Filters accepted by `adminOnboarding.listOnboardingConfigs`. */
-interface ListOnboardingConfigsParams {
-    productId?: OnboardingConfig["productId"];
-    status?: NichePackStatus;
-}
-/** Body accepted by the create-config endpoint. */
-interface CreateOnboardingConfigPayload {
-    productId: OnboardingConfig["productId"];
-    version?: string;
-    config?: Record<string, unknown>;
-}
-/** Body accepted by the update-config endpoint. */
-interface UpdateOnboardingConfigPayload {
-    status?: NichePackStatus;
-    config?: Record<string, unknown>;
-}
-/** Filters accepted by `adminOnboarding.listOnboardingExperiments`. */
-interface ListOnboardingExperimentsParams {
-    productId?: OnboardingExperiment["productId"];
-    status?: OnboardingExperimentStatus;
-    /** Page size — server clamps to 1..100, default 25. */
-    limit?: number;
-    /** Pagination offset, default 0. */
-    offset?: number;
-} /** Body accepted by the create-experiment endpoint. */
-interface CreateOnboardingExperimentPayload {
-    /** Admin-facing handle; unique platform-wide. */
-    slug: string;
-    productId: OnboardingExperiment["productId"];
-    /** Display name shown in the admin panel. */
-    name: string;
-    description?: string;
-    /** Defaults to `"draft"` server-side. */
-    status?: OnboardingExperimentStatus;
-    /**
-     * Variant routing table — may be empty for a freshly created
-     * draft. Variants whose `cohortRange` overlaps are rejected with
-     * `OVERLAPPING_VARIANTS`.
-     */
-    variants?: OnboardingExperimentVariant[];
-    /** Fallback config version when no variant matches the user's bucket. */
-    controlConfigVersion?: string | null;
-}
-/** Body accepted by the patch-experiment endpoint. */
-interface UpdateOnboardingExperimentPayload {
-    name?: string;
-    description?: string | null;
-    status?: OnboardingExperimentStatus;
-    variants?: OnboardingExperimentVariant[];
-    controlConfigVersion?: string | null;
-}
-/** Envelope returned by `GET /platform/admin/onboarding/experiments`. */
-interface ListOnboardingExperimentsResponse extends ApiEnvelope<OnboardingExperiment[]> {
-    /**
-     * Total experiments matching the current filter set, ignoring the
-     * page window. Drives the saas-side paginator. Falls back to
-     * `data.length` when the server can't compute a true count.
-     */
-    total: number;
-}
-/** Envelope returned by single-experiment endpoints. */
-type OnboardingExperimentResponse = ApiEnvelope<OnboardingExperiment>;
-/**
- * Filters accepted by every analytics endpoint
- * (`getOnboardingFunnel`, `getOnboardingTimeOnStep`,
- * `getOnboardingAbandonment`).
- *
- * `productId` constrains by product family, `nicheSubtype` by the
- * `nichePackSlug` recorded on the originating session row. `fromDate`
- * / `toDate` are wire-side ISO 8601 strings (the server coerces them
- * via Zod's `z.coerce.date()`); when omitted, the server defaults to
- * the trailing 30 days. The server hard-caps the requested window at
- * 180 days and rejects `fromDate >= toDate` with 400 INVALID_FIELD.
- */
-interface OnboardingAnalyticsFiltersParams {
-    productId?: "crm" | "laie" | "flow" | string;
-    nicheSubtype?: string;
-    /** ISO 8601 datetime, e.g. `"2025-01-01T00:00:00.000Z"`. */
-    fromDate?: string;
-    /** ISO 8601 datetime. */
-    toDate?: string;
-}
-/** One funnel row — distinct sessions that reached `stepId`. */
-interface OnboardingFunnelStep {
-    productId: string;
-    nichePackSlug: string | null;
-    stepId: string;
-    /** Distinct sessions that emitted at least one event for this step. */
-    sessions: number;
-    /**
-     * Fraction `[0, 1]` of sessions that reached this step relative to
-     * the first step in the same `(productId, nichePackSlug)` flow.
-     * The first step always has `conversionRate = 1`.
-     */
-    conversionRate: number;
-}
-/** Result envelope for `getOnboardingFunnel`. */
-interface OnboardingFunnelResult {
-    /** Flat list, ordered by `(productId, nichePackSlug, sessions DESC)`. */
-    funnel: OnboardingFunnelStep[];
-    /** Distinct sessions across all rows in the window. */
-    totalSessions: number;
-}
-/** One time-on-step row — per `(productId, nichePackSlug, stepId)`. */
-interface OnboardingTimeOnStepRow {
-    productId: string;
-    nichePackSlug: string | null;
-    stepId: string;
-    /** Median (p50) milliseconds from `stepId` first event → next step. */
-    medianMs: number;
-    /** p95 milliseconds. */
-    p95Ms: number;
-    /** Number of (session, step) pairs that contributed a delta. */
-    sampleSize: number;
-}
-/** Result envelope for `getOnboardingTimeOnStep`. */
-interface OnboardingTimeOnStepResult {
-    rows: OnboardingTimeOnStepRow[];
-}
-/** One abandonment bucket — abandoned sessions whose last seen step was `stepId`. */
-interface OnboardingAbandonmentRow {
-    productId: string;
-    nichePackSlug: string | null;
-    stepId: string;
-    abandonedSessions: number;
-}
-/** Result envelope for `getOnboardingAbandonment`. */
-interface OnboardingAbandonmentResult {
-    rows: OnboardingAbandonmentRow[];
-    totalAbandoned: number;
-}
-/** `{ success, data: OnboardingFunnelResult }`. */
-type OnboardingFunnelResponse = ApiEnvelope<OnboardingFunnelResult>;
-/** `{ success, data: OnboardingTimeOnStepResult }`. */
-type OnboardingTimeOnStepResponse = ApiEnvelope<OnboardingTimeOnStepResult>;
-/** `{ success, data: OnboardingAbandonmentResult }`. */
-type OnboardingAbandonmentResponse = ApiEnvelope<OnboardingAbandonmentResult>;
-/**
- * Admin-side onboarding control plane.
- *
- * @example
- * ```typescript
- * const { data, total } = await ecod.adminOnboarding.listNichePacks({
- *   productId: "crm",
- *   status: "published",
- *   search: "clinic",
- *   limit: 25,
- *   offset: 0,
- * });
- * ```
- */
-declare class AdminOnboarding extends APIResource {
-    /**
-     * List niche packs with optional filtering, search, and pagination.
-     * Server response shape: `{ success, data, total }`.
-     */
-    listNichePacks(params?: ListNichePacksParams): Promise<ListNichePacksResponse>;
-    /** Fetch a single niche pack by slug. Without `version` returns the latest. */
-    getNichePack(slug: string, version?: string): Promise<NichePackResponse>;
-    /** Create a new niche pack draft. */
-    createNichePack(payload: CreateNichePackPayload): Promise<NichePackResponse>;
-    /** Patch a draft niche pack. Server enforces "at least one field". */
-    updateNichePack(slug: string, payload: UpdateNichePackPayload, version?: string): Promise<NichePackResponse>;
-    /** Flip a niche pack to `published`. */
-    publishNichePack(slug: string, version?: string): Promise<NichePackResponse>;
-    /** Flip a niche pack back to `draft`. */
-    unpublishNichePack(slug: string, version?: string): Promise<NichePackResponse>;
-    /** Fork an existing niche pack into a new draft version. */
-    forkNichePack(slug: string, payload?: ForkNichePackPayload): Promise<NichePackResponse>;
-    /**
-     * Run an in-memory smoke test against a niche pack (task 4.1.5).
-     *
-     * The server resolves the pack row, walks its `onboardingConfig`
-     * with the supplied (or auto-picked) answers, shapes a persona
-     * + workspace profile, and returns the result without writing
-     * anything. Useful for admins to validate a draft pack before
-     * publishing.
-     *
-     * @param slug    - Niche pack slug.
-     * @param payload - Optional `{ fromVersion?, answers? }`. Both
-     *   fields are independently optional; `version` (the legacy
-     *   query-string equivalent) is also supported as a third
-     *   argument for parity with the other slug-keyed methods.
-     * @param version - Optional version override applied as a
-     *   `?version=` query param (kept for callers that already
-     *   thread version through the URL).
-     */
-    smokeTestNichePack(slug: string, payload?: SmokeTestNichePackPayload, version?: string): Promise<ApiEnvelope<SmokeTestResult>>;
-    listOnboardingConfigs(params?: ListOnboardingConfigsParams): Promise<ApiEnvelope<unknown[]>>;
-    createOnboardingConfig(payload: CreateOnboardingConfigPayload): Promise<ApiEnvelope<unknown>>;
-    updateOnboardingConfig(productId: OnboardingConfig["productId"], version: string, payload: UpdateOnboardingConfigPayload): Promise<ApiEnvelope<unknown>>;
-    publishOnboardingConfig(productId: OnboardingConfig["productId"], version: string): Promise<ApiEnvelope<unknown>>;
-    /**
-     * List onboarding A/B experiments with optional filters and
-     * pagination. Server response shape: `{ success, data, total }`.
-     */
-    listOnboardingExperiments(params?: ListOnboardingExperimentsParams): Promise<ListOnboardingExperimentsResponse>;
-    /** Fetch a single experiment by its slug. 404 when absent. */
-    getOnboardingExperiment(slug: string): Promise<OnboardingExperimentResponse>;
-    /**
-     * Create a draft experiment. The server enforces:
-     *
-     *   - `slug` non-empty + globally unique.
-     *   - `productId ∈ {crm, laie, flow}`.
-     *   - `variants` is an array (may be empty for a draft).
-     *   - Each variant's `cohortRange.from < cohortRange.to`, both in
-     *     `[0, 100]`.
-     *   - Variants don't overlap (returns 400 `OVERLAPPING_VARIANTS`).
-     */
-    createOnboardingExperiment(payload: CreateOnboardingExperimentPayload): Promise<OnboardingExperimentResponse>;
-    /**
-     * Patch an experiment. At least one of `name | description |
-     * status | variants | controlConfigVersion` must be supplied —
-     * the server returns 400 `NO_UPDATES` for an empty body. When
-     * `variants` is supplied the overlap validator re-runs.
-     */
-    updateOnboardingExperiment(slug: string, payload: UpdateOnboardingExperimentPayload): Promise<OnboardingExperimentResponse>;
-    /**
-     * Hard-delete an experiment. Returns the deleted row in `data` for
-     * audit-log convenience. Admin-only — no soft-delete column.
-     */
-    deleteOnboardingExperiment(slug: string): Promise<OnboardingExperimentResponse>;
-    /**
-     * Funnel-by-step counts for `(productId, nichePackSlug)`, plus
-     * conversion rates relative to each flow's first step.
-     *
-     * Server-side filters: `productId`, `nicheSubtype` (the niche pack
-     * slug — UI-friendly alias of the column name), `fromDate`,
-     * `toDate`. Both date bounds default to the trailing 30 days. The
-     * server clamps the window at 180 days and rejects
-     * `fromDate >= toDate` with 400 INVALID_FIELD.
-     *
-     * Powers the admin Sankey + per-step bar chart in Task 4.3.2.
-     */
-    getOnboardingFunnel(params?: OnboardingAnalyticsFiltersParams): Promise<OnboardingFunnelResponse>;
-    /**
-     * Median + p95 milliseconds spent on each step (per
-     * `(productId, nichePackSlug, stepId)`), computed via
-     * `LEAD(created_at) OVER (PARTITION BY session_id …)` on the event
-     * stream. Sample size accompanies each row so the saas can
-     * grey-out under-sampled buckets.
-     */
-    getOnboardingTimeOnStep(params?: OnboardingAnalyticsFiltersParams): Promise<OnboardingTimeOnStepResponse>;
-    /**
-     * Histogram of `stepId` values where sessions went inactive — i.e.
-     * `status = 'abandoned'` OR (active for >24h with no further
-     * events). The server also tallies a `totalAbandoned` aggregate so
-     * the saas can render a percentage column without re-summing.
-     */
-    getOnboardingAbandonment(params?: OnboardingAnalyticsFiltersParams): Promise<OnboardingAbandonmentResponse>;
-}
-
-interface CorsOriginCreatePayload {
-    url: string;
-    name?: string;
-    allowedHeaders?: string[];
-    allowedMethods?: string[];
-}
-interface CorsOriginUpdatePayload {
-    url?: string;
-    name?: string;
-    allowedHeaders?: string[];
-    allowedMethods?: string[];
-    isActive?: boolean;
-}
-declare class Cors extends APIResource {
-    /**
-     * List all dynamic cross-origin policies.
-     */
-    list<T = any>(): Promise<T>;
-    /**
-     * Register a new cross-origin client for the SaaS API network dynamically.
-     */
-    create<T = any>(payload: CorsOriginCreatePayload): Promise<T>;
-    /**
-     * Adjust active states or configurations for an existing origin policy.
-     */
-    update<T = any>(id: string, payload: CorsOriginUpdatePayload): Promise<T>;
-    /**
-     * Irreversibly drop support for a cross-origin client URL policy permanently.
-     */
-    delete<T = any>(id: string): Promise<T>;
-}
-
-interface SystemHealth {
-    status: string;
-    version: string;
-    env: string;
-    uptime: number;
-    db: string;
-    queueDepth: number;
-    timestamp: string;
-}
-/**
- * Platform health diagnostics.
- *
- * Access via `ecod.platform.health`.
- */
-declare class Health extends APIResource {
-    /**
-     * Global platform health check — verifies the core API is operational.
-     * Public endpoint: `GET /health`.
-     */
-    system(): Promise<SystemHealth>;
-}
-
-/**
- * Filters for querying event and automation execution logs.
- */
-interface LogFilter {
-    /** Page number for pagination (1-indexed). */
-    page?: number;
-    /** Maximum number of records to return per page. */
-    limit?: number;
-    /**
-     * Filter by automation trigger name.
-     * @example "lead_created" | "appointment_booked"
-     */
-    trigger?: string;
-    /**
-     * Filter by execution status.
-     * @example "success" | "failed" | "pending"
-     */
-    status?: string;
-    /** Filter logs associated with a specific phone number. */
-    phone?: string;
-    /** Start of the date range (inclusive). ISO 8601 or Date object. */
-    startDate?: string | Date;
-    /** End of the date range (inclusive). ISO 8601 or Date object. */
-    endDate?: string | Date;
-}
-/**
- * Automation event log and provider callback resource.
- *
- * Access via `ecod.notifications`.
- *
- * This resource is **read-only**. It exposes platform audit trails — useful
- * for debugging automation failures, monitoring webhook callbacks, and
- * building internal ops dashboards.
- *
- * @example
- * ```typescript
- * // Find failed automations in April
- * const { data } = await ecod.notifications.listLogs({
- *   status: "failed",
- *   startDate: "2026-04-01",
- *   endDate: "2026-04-30",
- * });
- * ```
- */
-declare class Notifications extends APIResource {
-    /**
-     * List automation execution logs with optional filtering.
-     *
-     * Each log entry represents one automation run triggered by a platform event.
-     * Filter by `status: "failed"` to build a failure alerting pipeline.
-     *
-     * @param params - Optional filter criteria.
-     * @returns Paginated list of event log objects.
-     *
-     * @example
-     * ```typescript
-     * const { data: failed } = await ecod.notifications.listLogs({
-     *   status: "failed",
-     *   trigger: "lead_created",
-     *   limit: 50,
-     * });
-     * ```
-     */
-    listLogs(params?: LogFilter): Promise<unknown>;
-    /**
-     * Retrieve the full details for a single automation event log entry.
-     *
-     * @param logId - The unique log ID.
-     * @returns A single event log document including the payload and error trace.
-     *
-     * @example
-     * ```typescript
-     * const { data } = await ecod.notifications.retrieveLog("log_64abc...");
-     * console.log(data.error);  // → "Provider timeout after 30s"
-     * ```
-     */
-    retrieveLog(logId: string): Promise<unknown>;
-    /**
-     * Get a summary statistics object for automation event execution.
-     *
-     * @param params - Optional date range for the summary window.
-     * @returns `{ total, success, failed, pending }` counts.
-     *
-     * @example
-     * ```typescript
-     * const { data: stats } = await ecod.notifications.getStats({
-     *   startDate: "2026-04-01",
-     *   endDate: "2026-04-30",
-     * });
-     * console.log(`Failed: ${stats.failed} / ${stats.total}`);
-     * ```
-     */
-    getStats(params?: {
-        startDate?: string;
-        endDate?: string;
-    }): Promise<unknown>;
-    /**
-     * List external provider webhook callback logs.
-     *
-     * These are inbound HTTP callbacks from third-party providers
-     * (payment gateways, email services, etc.) stored for audit purposes.
-     *
-     * @param params - Pagination and date filter options.
-     * @returns Paginated list of callback log records.
-     *
-     * @example
-     * ```typescript
-     * const { data } = await ecod.notifications.listCallbacks({ limit: 20 });
-     * ```
-     */
-    listCallbacks(params?: Omit<LogFilter, "trigger" | "phone">): Promise<unknown>;
-    /**
-     * List unread CRM notifications and alerts (e.g., lead assignments, system alerts).
-     *
-     * @param params - Optional filters (limit, unreadOnly).
-     * @returns Paginated list of notification objects.
-     * @example
-     * ```typescript
-     * const alerts = await erixClient.notifications.listAlerts({ unreadOnly: true });
-     * ```
-     */
-    listAlerts<T = any>(params?: {
-        limit?: number;
-        unreadOnly?: boolean;
-    }): Promise<T>;
-    /**
-     * Dismiss/mark a specific notification alert as read.
-     *
-     * @param notificationId - The unique ID of the notification.
-     * @example
-     * ```typescript
-     * await erixClient.notifications.dismissAlert("alert_123");
-     * ```
-     */
-    dismissAlert<T = any>(notificationId: string): Promise<T>;
-    /**
-     * Clear all notifications for the current tenant immediately.
-     *
-     * @example
-     * ```typescript
-     * await erixClient.notifications.clearAllAlerts();
-     * ```
-     */
-    clearAllAlerts<T = any>(): Promise<T>;
-    /**
-     * Retry an action from a notification (e.g. failed automation send).
-     *
-     * @param notificationId - The unique ID of the notification.
-     * @example
-     * ```typescript
-     * await erixClient.notifications.retryAction("alert_123");
-     * ```
-     */
-    retryAction<T = any>(notificationId: string): Promise<T>;
-}
-
-/**
- * Body of `POST /platform/tenants/onboarding/global` — the four-question signup form.
- *
- * Fields land directly on `ecodrix_organizations.*` columns (workspace
- * name, timezone) and `service_config -> 'global'` (primary product,
- * adaptive flag). See REQ-001.
- */
-interface GlobalOnboardingPayload {
-    /** Workspace / org display name. Persisted to `ecodrix_organizations.name`. */
-    workspaceName: string;
-    /** Personal display name of the signing-up user. */
-    displayName: string;
-    /** IANA timezone, e.g. `"Asia/Kolkata"`. Persisted to `organizations.timezone`. */
-    timezone: string;
-    /**
-     * The product the user wants to start with. `"not_sure"` defers
-     * per-product onboarding to first product open.
-     */
-    primaryProduct: "crm" | "laie" | "flow" | "not_sure";
-}
-/**
- * Body of `POST /platform/tenants/onboarding/${productId}/start` — opens a per-product onboarding
- * session. Triggered by the explicit "Enable {Product}" click on
- * `/products/<productId>` (REQ-002).
- */
-interface StartOnboardingPayload {
-    productId: "crm" | "laie" | "flow";
-}
-/**
- * Body of `POST /platform/tenants/onboarding/${productId}/answer` — records one step's answer and
- * advances the engine. The saas calls this on every step submit (and as
- * a debounced PATCH for resumability).
- */
-interface AnswerOnboardingPayload {
-    sessionId: string;
-    stepId: string;
-    /** Shape depends on the step type — string, string[], boolean, etc. */
-    answer: unknown;
-}
-/**
- * Body of `POST /platform/tenants/onboarding/complete` — terminates the session,
- * upserts the persona, and materializes the workspace defaults.
- */
-interface CompleteOnboardingPayload {
-    sessionId: string;
-}
-/**
- * Body of `POST /platform/tenants/onboarding/${productId}/edit` — post-completion edit of a single
- * answer from `/settings/onboarding`. Triggers a `persona_recomputed`
- * event (REQ-010).
- */
-interface EditOnboardingPayload {
-    stepId: string;
-    answer: unknown;
-}
-/**
- * Result of `POST /platform/tenants/onboarding/${productId}/start`.
- */
-interface StartOnboardingResponse {
-    sessionId: string;
-    firstStep: OnboardingStep;
-}
-/**
- * Result of `POST /platform/tenants/onboarding/${productId}/answer`.
- */
-interface AnswerOnboardingResponse {
-    /** `null` when the engine has reached the final step. */
-    nextStep: OnboardingStep | null;
-    draftPersona: Record<string, unknown>;
-}
-/**
- * Result of `GET /platform/tenants/onboarding/${productId}/state`. Returns the active session
- * (status `"active"`) for `(userId, productId)`, plus the step the
- * renderer should currently show.
- */
-interface OnboardingStateResponse {
-    session: OnboardingSession | null;
-    currentStep: OnboardingStep | null;
-}
-/**
- * Result of `POST /platform/tenants/onboarding/complete`.
- */
-interface CompleteOnboardingResponse {
-    /** Opaque persona document — full type lives in `resources/persona.ts`. */
-    persona: Record<string, unknown>;
-    workspaceProfile: WorkspaceProfile;
-}
-/**
- * Result of `POST /platform/tenants/onboarding/${productId}/edit`.
- */
-interface EditOnboardingResponse {
-    persona: Record<string, unknown>;
-    /** RFC 6902 JSON Patch describing what changed in the persona. */
-    diff: Array<Record<string, unknown>>;
-}
-/**
- * Adaptive onboarding resource.
- *
- * Mounted on the main client as `ecod.onboarding`. Mirrors the seven
- * tenant-facing routes documented in `design.md` § "API surface".
- *
- * @example
- * ```typescript
- * await ecod.onboarding.global({
- *   workspaceName: "Acme Health",
- *   displayName: "Alice",
- *   timezone: "Asia/Kolkata",
- *   primaryProduct: "crm",
- * });
- *
- * const { sessionId, firstStep } = await ecod.onboarding.start({ productId: "crm" });
- * await ecod.onboarding.answer({ sessionId, stepId: firstStep.stepId, answer: "healthcare" });
- * await ecod.onboarding.complete({ sessionId });
- * ```
- */
-declare class Onboarding extends APIResource {
-    /**
-     * Submit the four-question global onboarding form (REQ-001).
-     * Updates `ecodrix_organizations.*` columns and
-     * `service_config.global.primaryProduct`.
-     */
-    global<T = unknown>(payload: GlobalOnboardingPayload): Promise<T>;
-    /**
-     * Open a per-product onboarding session. Called when the user clicks
-     * "Enable {Product}" on `/products/<productId>` (REQ-002).
-     */
-    start(payload: StartOnboardingPayload): Promise<StartOnboardingResponse>;
-    /**
-     * Record one step's answer and advance the engine. Returns the next
-     * step (or `null` at the end) and the in-progress draft persona.
-     */
-    answer(payload: AnswerOnboardingPayload): Promise<AnswerOnboardingResponse>;
-    /**
-     * Load the active session for the calling user + product. Used on
-     * page mount + every revisit to support resumability (REQ-010).
-     */
-    state(productId: string): Promise<OnboardingStateResponse>;
-    /**
-     * Finalise the session, upsert the persona, and materialize the
-     * niche-tuned workspace defaults.
-     */
-    complete(payload: CompleteOnboardingPayload): Promise<CompleteOnboardingResponse>;
-    /**
-     * Edit a previously-answered step from `/settings/onboarding`. The
-     * server emits a `persona_recomputed` event so the workspace and
-     * persona update in-session (REQ-010).
-     */
-    edit(payload: EditOnboardingPayload): Promise<EditOnboardingResponse>;
-    /**
-     * Preview the workspace profile that would be materialized if the
-     * session completed right now. Used by the `feature_preview` step.
-     */
-    previewWorkspace(sessionId: string): Promise<WorkspaceProfile>;
-}
-
-declare class Clients extends APIResource {
-    /**
-     * List all clients in the ecosystem.
-     */
-    list<T = any>(): Promise<T>;
-    /**
-     * Get client count and auto-generate a unique code.
-     */
-    getCountAndGenerateCode<T = any>(): Promise<T>;
-    /**
-     * Retrieve a single client by client code.
-     */
-    retrieve<T = any>(clientCode: string): Promise<T>;
-    /**
-     * Get API Key for a specific client (Admin Only).
-     */
-    getApiKey<T = any>(clientCode: string): Promise<T>;
-    /**
-     * Generate or rotate API Key for a specific client (Admin Only).
-     */
-    rotateApiKey<T = any>(clientCode: string): Promise<T>;
-    /**
-     * Create a new client identity and provision initial resources.
-     */
-    create<T = any>(payload: {
-        name: string;
-        clientCode: string;
-        business?: any;
-        plan?: any;
-    }): Promise<T>;
-    /**
-     * Get active service configuration for a specific client.
-     */
-    getConfig<T = any>(clientCode: string): Promise<T>;
-    /**
-     * Update active service configuration for a specific client.
-     */
-    updateConfig<T = any>(clientCode: string, payload: any): Promise<T>;
-    /**
-     * List a client's ERIX-Connect connections (masked status + per-module
-     * grants). Replaces the legacy `getSecrets` — credentials are never returned
-     * in plaintext.
-     */
-    getConnections<T = any>(clientCode: string): Promise<T>;
-    /**
-     * List the ERIX-Connect provider registry (cards + methods + field metadata).
-     */
-    getConnectProviders<T = any>(clientCode: string): Promise<T>;
-    /**
-     * Connect a provider for a client via a chosen method.
-     */
-    connectProvider<T = any>(clientCode: string, providerId: string, payload: {
-        method: string;
-        config: Record<string, unknown>;
-    }): Promise<T>;
-    /**
-     * Update an already-connected provider's configuration.
-     */
-    configureProvider<T = any>(clientCode: string, providerId: string, payload: {
-        method: string;
-        config: Record<string, unknown>;
-    }): Promise<T>;
-    /**
-     * Disconnect a provider for a client.
-     */
-    disconnectProvider<T = any>(clientCode: string, providerId: string): Promise<T>;
-    /**
-     * Reveal a client's DECRYPTED credentials for a provider (admin/agency).
-     */
-    revealConnection<T = any>(clientCode: string, providerId: string): Promise<T>;
-    /**
-     * Toggle a per-module access grant (crm | flow | laie) for a client's
-     * connector.
-     */
-    setConnectionAccess<T = any>(clientCode: string, providerId: string, payload: {
-        module: "crm" | "flow" | "laie";
-        enabled: boolean;
-    }): Promise<T>;
-    /**
-     * Retrieve Data Source connection metadata.
-     */
-    getDataSource<T = any>(clientCode: string): Promise<T>;
-    /**
-     * Configure Data Source metadata.
-     */
-    manageDataSource<T = any>(clientCode: string, payload: any): Promise<T>;
-    /**
-     * Update Client Identity and perform cascading updates if required.
-     */
-    updateIdentity<T = any>(id: string, payload: any): Promise<T>;
-    /**
-     * Initiate Google Re-authentication for OAuth tokens.
-     */
-    googleReauth<T = any>(clientCode: string, payload?: {
-        authCode?: string;
-    }): Promise<T>;
-    /**
-     * Delete a client and perform cascading cleanup.
-     */
-    delete<T = any>(id: string): Promise<T>;
-}
-declare class Blogs extends APIResource {
-    /**
-     * Retrieve public corporate blogs/news.
-     */
-    list<T = any>(): Promise<T>;
-}
-declare class GlobalLeads extends APIResource {
-    /**
-     * Add a corporate lead capture entry.
-     */
-    add<T = any>(payload: any): Promise<T>;
-}
-declare class Services extends APIResource {
-    clients: Clients;
-    blogs: Blogs;
-    globalLeads: GlobalLeads;
-    constructor(client: any);
-}
-
-/**
- * Copilot resource — synchronous chat, confirmation, and session management.
- *
- * Access via `ecod.platform.ai.copilot`.
- */
-declare class Copilot extends APIResource {
-    /**
-     * Send a synchronous (non-streaming) chat message to the copilot.
-     */
-    chatSync<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Confirm a pending copilot action.
-     */
-    confirm<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * List all copilot sessions.
-     */
-    listSessions<T = any>(): Promise<T>;
-    /**
-     * Retrieve a single copilot session by its ID.
-     *
-     * @param id - The session ID.
-     */
-    getSession<T = any>(id: string): Promise<T>;
-    /**
-     * Delete a copilot session by its ID.
-     *
-     * @param id - The session ID.
-     */
-    deleteSession<T = any>(id: string): Promise<T>;
-    /**
-     * Returns the version-relative path for the copilot chat streaming
-     * endpoint (`POST /platform/ai/copilot/chat`).
-     *
-     * NOTE: This endpoint is a Server-Sent-Events (SSE) stream. The axios
-     * client is not used for streaming, so SSE consumption must be handled by
-     * the caller (e.g. using `fetch` with a `ReadableStream` reader or an
-     * `EventSource`-compatible client). This method intentionally does not
-     * perform the request or implement streaming.
-     *
-     * @returns The version-relative SSE endpoint path.
-     */
-    chatStreamUrl(): string;
-}
-/**
- * Platform AI container — groups the `copilot` sub-resource.
- *
- * Access via `ecod.platform.ai`.
- */
-declare class PlatformAI {
-    readonly copilot: Copilot;
-    constructor(client: AxiosInstance);
-}
-
-/**
- * Platform authentication resource — registration, login, sessions,
- * password management, OAuth linking, and organization invitations.
- *
- * Access via `ecod.platform.auth`.
- */
-declare class Auth extends APIResource {
-    /**
-     * Register a new platform user / organization.
-     */
-    register<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Authenticate a user and establish a session.
-     */
-    login<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Log out of the current session.
-     */
-    logout<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Log out of every active session for the current user.
-     */
-    logoutAll<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Validate the current session token.
-     */
-    validateSession<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * List all active sessions for the current user.
-     */
-    listSessions<T = any>(): Promise<T>;
-    /**
-     * Revoke a specific session by its ID.
-     *
-     * @param id - The session ID to revoke.
-     */
-    revokeSession<T = any>(id: string): Promise<T>;
-    /**
-     * Request a one-time password (OTP) to set or change a password.
-     */
-    requestPasswordOtp<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Set a password for the current user.
-     */
-    setPassword<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Change the current user's password.
-     */
-    changePassword<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Begin the forgot-password flow.
-     */
-    forgotPassword<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Reset a password using a reset token.
-     */
-    resetPassword<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Link an OAuth identity to the current user.
-     */
-    linkOAuth<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve details about an organization invitation by token.
-     *
-     * @param token - The invitation token.
-     */
-    getInvitation<T = any>(token: string): Promise<T>;
-    /**
-     * Accept an organization invitation by token.
-     *
-     * @param token - The invitation token.
-     * @param body - Optional acceptance payload.
-     */
-    acceptInvitation<T = any>(token: string, body?: Record<string, unknown>): Promise<T>;
-}
-
-/**
- * Entitlements resource — read current plan entitlements and usage.
- *
- * Access via `ecod.platform.billing.entitlements`.
- */
-declare class Entitlements extends APIResource {
-    /**
-     * Retrieve the current organization's entitlements.
-     */
-    get<T = any>(): Promise<T>;
-    /**
-     * Retrieve current usage against entitlements.
-     */
-    usage<T = any>(): Promise<T>;
-}
-/**
- * Subscriptions resource — manage plan upgrades, downgrades, cancellations,
- * and add-ons.
- *
- * Access via `ecod.platform.billing.subscriptions`.
- */
-declare class Subscriptions extends APIResource {
-    /**
-     * Upgrade the current subscription plan.
-     */
-    upgrade<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Downgrade the current subscription plan.
-     */
-    downgrade<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Cancel the current subscription.
-     */
-    cancel<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Purchase an add-on for the current subscription.
-     */
-    purchaseAddon<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Cancel a previously purchased add-on.
-     */
-    cancelAddon<T = any>(body: Record<string, unknown>): Promise<T>;
-}
-/**
- * Plans resource — read publicly available plans.
- *
- * Access via `ecod.platform.billing.plans`.
- */
-declare class Plans extends APIResource {
-    /**
-     * List all publicly available plans.
-     */
-    listPublic<T = any>(): Promise<T>;
-}
-/**
- * Billing checkout resource — plan selection, subscription, verification,
- * and synchronization.
- *
- * Access via `ecod.platform.billing.checkout`.
- */
-declare class BillingCheckout extends APIResource {
-    /**
-     * List plans available at checkout.
-     */
-    plans<T = any>(): Promise<T>;
-    /**
-     * Subscribe to a plan via checkout.
-     */
-    subscribe<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Verify a checkout payment.
-     */
-    verify<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Cancel an in-progress checkout.
-     */
-    cancel<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve the current checkout status.
-     */
-    status<T = any>(): Promise<T>;
-    /**
-     * Synchronize the checkout plan state with the provider.
-     */
-    syncPlan<T = any>(body: Record<string, unknown>): Promise<T>;
-}
-/**
- * Billing user resource — transactions, subscription, and disputes for the
- * current user.
- *
- * Access via `ecod.platform.billing.user`.
- */
-declare class BillingUser extends APIResource {
-    /**
-     * List the current user's billing transactions.
-     */
-    transactions<T = any>(): Promise<T>;
-    /**
-     * Retrieve the current user's subscription.
-     */
-    subscription<T = any>(): Promise<T>;
-    /**
-     * Raise a billing dispute.
-     */
-    raiseDispute<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * List the current user's billing disputes.
-     */
-    disputes<T = any>(): Promise<T>;
-}
-/**
- * Credits resource — balance, transactions, packs, and top-ups.
- *
- * Access via `ecod.platform.billing.credits`.
- */
-declare class Credits extends APIResource {
-    /**
-     * Retrieve the current credit balance.
-     */
-    balance<T = any>(): Promise<T>;
-    /**
-     * List credit transactions.
-     */
-    transactions<T = any>(): Promise<T>;
-    /**
-     * List available credit packs.
-     */
-    packs<T = any>(): Promise<T>;
-    /**
-     * Create a credit top-up order.
-     */
-    topupOrder<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Verify a credit top-up payment.
-     */
-    verifyTopup<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Configure automatic credit top-ups.
-     */
-    setAutoTopup<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Configure the daily spend cap (cost control).
-     * Body: `{ dailyCap: number | null, alertPct?: number }`.
-     */
-    setSpendCap<T = any>(body: Record<string, unknown>): Promise<T>;
-}
-/**
- * Platform billing container — groups the `entitlements`, `subscriptions`,
- * `plans`, `checkout`, `user`, and `credits` sub-resources.
- *
- * Access via `ecod.platform.billing`.
- */
-declare class Billing {
-    readonly entitlements: Entitlements;
-    readonly subscriptions: Subscriptions;
-    readonly plans: Plans;
-    readonly checkout: BillingCheckout;
-    readonly user: BillingUser;
-    readonly credits: Credits;
-    constructor(client: AxiosInstance);
-}
-
-/**
- * Platform support resource — categories and support ticket lifecycle.
- *
- * Access via `ecod.platform.support`.
- */
-declare class Support extends APIResource {
-    /**
-     * List available support categories.
-     */
-    categories<T = any>(): Promise<T>;
-    /**
-     * List support tickets with optional filtering.
-     *
-     * @param params - Optional query parameters (status, pagination, etc.).
-     */
-    listTickets<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Create a new support ticket.
-     */
-    createTicket<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve a single support ticket by its ID.
-     *
-     * @param id - The support ticket ID.
-     */
-    getTicket<T = any>(id: string): Promise<T>;
-    /**
-     * Reply to an existing support ticket.
-     *
-     * @param id - The support ticket ID.
-     * @param body - The reply payload.
-     */
-    reply<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
-    /**
-     * Close a support ticket.
-     *
-     * @param id - The support ticket ID.
-     */
-    close<T = any>(id: string): Promise<T>;
-}
-
-/**
- * Current-user ("me") resource — profile, organization, modules,
- * workspaces, and active-org management.
- *
- * Access via `ecod.platform.users.me`.
- */
-declare class Me extends APIResource {
-    /**
-     * Retrieve the current authenticated user's profile.
-     */
-    get<T = any>(): Promise<T>;
-    /**
-     * Update the current user's profile.
-     */
-    update<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Update the current user's active organization details.
-     */
-    updateOrganization<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Toggle enabled modules for the current user / organization.
-     */
-    toggleModules<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * List the workspaces available to the current user.
-     */
-    workspaces<T = any>(): Promise<T>;
-    /**
-     * Set the active organization for the current user.
-     */
-    setActiveOrg<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Dismiss the workspace setup prompt for the current user.
-     */
-    dismissWorkspaceSetup<T = any>(): Promise<T>;
-}
-/**
- * Organization members resource — list, invite, and remove members.
- *
- * Access via `ecod.platform.users.members`.
- */
-declare class Members extends APIResource {
-    /**
-     * List all members of the current organization.
-     */
-    list<T = any>(): Promise<T>;
-    /**
-     * Invite a new member to the current organization.
-     */
-    invite<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Remove a member from the current organization.
-     *
-     * @param id - The member ID to remove.
-     */
-    remove<T = any>(id: string): Promise<T>;
-}
-/**
- * User sessions resource — list and revoke sessions.
- *
- * Access via `ecod.platform.users.sessions`.
- */
-declare class Sessions extends APIResource {
-    /**
-     * List all sessions for the current user.
-     */
-    list<T = any>(): Promise<T>;
-    /**
-     * Revoke a specific session by its ID.
-     *
-     * @param id - The session ID to revoke.
-     */
-    revoke<T = any>(id: string): Promise<T>;
-    /**
-     * Revoke all sessions for the current user.
-     */
-    revokeAll<T = any>(): Promise<T>;
-}
-
-/**
- * Platform-admin activity logs resource — list and export activity logs.
- *
- * Access via `ecod.platform.admin.activityLogs`.
- */
-declare class AdminActivityLogs extends APIResource {
-    /**
-     * List activity logs.
-     */
-    list<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Export activity logs.
-     */
-    export<T = any>(params?: Record<string, unknown>): Promise<T>;
-}
-
-/**
- * Platform-admin agency invoices resource — agency invoice settings and CRUD.
- *
- * NOTE: the doubled `admin/invoice-settings` / `admin/invoices` segments are
- * intentional — a legacy router is mounted under the new prefix.
- *
- * Access via `ecod.platform.admin.agencyInvoices`.
- */
-declare class AdminAgencyInvoices extends APIResource {
-    /**
-     * Retrieve agency invoice settings.
-     */
-    getSettings<T = any>(): Promise<T>;
-    /**
-     * Update agency invoice settings.
-     */
-    updateSettings<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * List agency invoices.
-     */
-    list<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Create an agency invoice.
-     */
-    create<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve a single agency invoice by ID.
-     */
-    retrieve<T = any>(id: string): Promise<T>;
-    /**
-     * Update an agency invoice.
-     */
-    update<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
-    /**
-     * Delete an agency invoice.
-     */
-    remove<T = any>(id: string): Promise<T>;
-}
-
-/**
- * Platform-admin agents resource — inspect and manage agents.
- *
- * Access via `ecod.platform.admin.agents`.
- */
-declare class AdminAgents extends APIResource {
-    /**
-     * Retrieve aggregate agent statistics.
-     */
-    stats<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * List all agents.
-     */
-    list<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve a single agent by ID.
-     */
-    retrieve<T = any>(id: string): Promise<T>;
-    /**
-     * Update an existing agent.
-     */
-    update<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
-    /**
-     * List runs for an agent.
-     */
-    runs<T = any>(id: string): Promise<T>;
-}
-
-/**
- * Platform-admin analytics resource — platform-wide analytics overviews.
- *
- * Access via `ecod.platform.admin.analytics`.
- */
-declare class AdminAnalytics extends APIResource {
-    /**
-     * Retrieve the analytics overview.
-     */
-    overview<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve per-endpoint analytics.
-     */
-    endpoints<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve error analytics.
-     */
-    errors<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve per-tenant analytics.
-     */
-    tenants<T = any>(params?: Record<string, unknown>): Promise<T>;
-}
-
-/**
- * Platform-admin announcements resource — manage communications,
- * broadcasts, maintenance windows, and changelog entries.
- *
- * Access via `ecod.platform.admin.announcements`.
- */
-declare class AdminAnnouncements extends APIResource {
-    /**
-     * List all communications.
-     */
-    list<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Create a new communication.
-     */
-    create<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Update an existing communication.
-     */
-    update<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
-    /**
-     * Delete a communication.
-     */
-    remove<T = any>(id: string): Promise<T>;
-    /**
-     * Publish a communication.
-     */
-    publish<T = any>(id: string, body?: Record<string, unknown>): Promise<T>;
-    /**
-     * Broadcast a communication to recipients.
-     */
-    broadcast<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Set the maintenance window.
-     */
-    setMaintenance<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve the current maintenance window.
-     */
-    getMaintenance<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Post a changelog entry.
-     */
-    changelog<T = any>(body: Record<string, unknown>): Promise<T>;
-}
-
-/**
- * Platform-admin audit logs resource — audit statistics, listing, and export.
- *
- * Access via `ecod.platform.admin.auditLogs`.
- */
-declare class AdminAuditLogs extends APIResource {
-    /**
-     * Retrieve aggregate audit statistics.
-     */
-    stats<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * List audit log entries.
-     */
-    list<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Export audit log entries.
-     */
-    export<T = any>(params?: Record<string, unknown>): Promise<T>;
-}
-
-/**
- * Platform-admin billing resource — billing events, trial extensions,
- * grandfathering, and reconciliation.
- *
- * Access via `ecod.platform.admin.billing`.
- */
-declare class AdminBilling extends APIResource {
-    /**
-     * List all billing events.
-     */
-    events<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * List billing events for a specific organization.
-     */
-    orgEvents<T = any>(orgId: string): Promise<T>;
-    /**
-     * List failed billing events.
-     */
-    failed<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Record a billing event.
-     */
-    recordEvent<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Extend a trial period.
-     */
-    extendTrial<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Grandfather an organization onto legacy pricing.
-     */
-    grandfather<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Reconcile billing state with the provider.
-     */
-    reconcile<T = any>(params?: Record<string, unknown>): Promise<T>;
-}
-
-/**
- * Platform-admin blogs resource — blog content management.
- *
- * NOTE: the doubled `services/blogs` segments are intentional — a legacy
- * router is mounted under the new prefix.
- *
- * Access via `ecod.platform.admin.blogs`.
- */
-declare class AdminBlogs extends APIResource {
-    /**
-     * List blog posts.
-     */
-    list<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve a single blog post by slug or ID.
-     */
-    retrieve<T = any>(slugOrId: string): Promise<T>;
-    /**
-     * Create a blog post.
-     */
-    create<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Update a blog post by slug or ID.
-     */
-    update<T = any>(slugOrId: string, body: Record<string, unknown>): Promise<T>;
-    /**
-     * Delete a blog post by slug or ID.
-     */
-    remove<T = any>(slugOrId: string): Promise<T>;
-}
-
-/**
- * Platform-admin compliance resource — manage compliance requests and
- * organization data exports.
- *
- * Access via `ecod.platform.admin.compliance`.
- */
-declare class AdminCompliance extends APIResource {
-    /**
-     * List compliance requests.
-     */
-    requests<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Create a new compliance request.
-     */
-    createRequest<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Update an existing compliance request.
-     */
-    updateRequest<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
-    /**
-     * Export compliance data for an organization.
-     */
-    exportOrg<T = any>(orgId: string, body?: Record<string, unknown>): Promise<T>;
-}
-
-/**
- * Platform-admin credits resource — rate cards, credit packs, and wallets.
- *
- * Access via `ecod.platform.admin.credits`.
- */
-declare class AdminCredits extends APIResource {
-    /**
-     * Retrieve the credits rate card.
-     */
-    rateCard<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * List all credit packs.
-     */
-    packs<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Create a new credit pack.
-     */
-    createPack<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Update an existing credit pack.
-     */
-    updatePack<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
-    /**
-     * Delete a credit pack.
-     */
-    deletePack<T = any>(id: string): Promise<T>;
-    /**
-     * Retrieve the credit wallet for an organization.
-     */
-    wallet<T = any>(orgId: string): Promise<T>;
+    confirm<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Adjust the credit wallet balance for an organization.
+     * List all copilot sessions.
      */
-    adjustWallet<T = any>(orgId: string, body: Record<string, unknown>): Promise<T>;
-}
-
-/**
- * Platform-admin dashboard resource — admin dashboard statistics.
- *
- * Access via `ecod.platform.admin.dashboard`.
- */
-declare class AdminDashboard extends APIResource {
+    listSessions<T = any>(): Promise<T>;
     /**
-     * Retrieve admin dashboard statistics.
+     * Retrieve a single copilot session by its ID.
      *
-     * NOTE: the doubled `admin/dashboard` segment is intentional — a legacy
-     * router is mounted under the new prefix.
-     */
-    stats<T = any>(params?: Record<string, unknown>): Promise<T>;
-}
-
-/**
- * Platform-admin email monitor resource — cross-tenant email monitoring.
- *
- * Access via `ecod.platform.admin.email`.
- */
-declare class AdminEmail extends APIResource {
-    /**
-     * Retrieve the platform-wide email overview.
-     */
-    overview<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * List email campaigns across tenants.
-     */
-    campaigns<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * List email events (opens, clicks, bounces, etc.).
-     */
-    events<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve SES health metrics.
-     */
-    sesHealth<T = any>(params?: Record<string, unknown>): Promise<T>;
-}
-
-/**
- * Platform-admin Erix resource — Erix tenant provisioning and lifecycle.
- *
- * Access via `ecod.platform.admin.erix`.
- */
-declare class AdminErix extends APIResource {
-    /**
-     * Create a new Erix tenant.
-     */
-    createTenant<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * List Erix tenants.
-     */
-    tenants<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve a single Erix tenant by ID.
-     */
-    tenant<T = any>(id: string): Promise<T>;
-    /**
-     * Update the plan for an Erix tenant.
-     */
-    updatePlan<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
-    /**
-     * Suspend an Erix tenant.
-     */
-    suspend<T = any>(id: string, body?: Record<string, unknown>): Promise<T>;
-    /**
-     * Reactivate a suspended Erix tenant.
-     */
-    reactivate<T = any>(id: string, body?: Record<string, unknown>): Promise<T>;
-    /**
-     * Rotate the API key for an Erix tenant.
-     */
-    rotateKey<T = any>(id: string, body?: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve usage metrics for an Erix tenant.
-     */
-    usage<T = any>(id: string): Promise<T>;
-}
-
-/**
- * Platform-admin feature flags resource — manage feature flags and their
- * per-organization overrides.
- *
- * Access via `ecod.platform.admin.featureFlags`.
- */
-declare class AdminFeatureFlags extends APIResource {
-    /**
-     * List all feature flags.
-     */
-    list<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Create a new feature flag.
-     */
-    create<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Update an existing feature flag.
-     */
-    update<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
-    /**
-     * Delete a feature flag.
-     */
-    remove<T = any>(id: string): Promise<T>;
-    /**
-     * List per-organization overrides for a feature flag.
-     */
-    listOverrides<T = any>(id: string): Promise<T>;
-    /**
-     * Add a per-organization override to a feature flag.
+     * @param id - The session ID.
      */
-    addOverride<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
+    getSession<T = any>(id: string): Promise<T>;
     /**
-     * Remove a per-organization override from a feature flag.
+     * Delete a copilot session by its ID.
+     *
+     * @param id - The session ID.
      */
-    removeOverride<T = any>(id: string, orgId: string): Promise<T>;
+    deleteSession<T = any>(id: string): Promise<T>;
     /**
-     * Retrieve resolved feature flags for a specific organization.
+     * Returns the version-relative path for the copilot chat streaming
+     * endpoint (`POST /platform/ai/copilot/chat`).
+     *
+     * NOTE: This endpoint is a Server-Sent-Events (SSE) stream. The axios
+     * client is not used for streaming, so SSE consumption must be handled by
+     * the caller (e.g. using `fetch` with a `ReadableStream` reader or an
+     * `EventSource`-compatible client). This method intentionally does not
+     * perform the request or implement streaming.
+     *
+     * @returns The version-relative SSE endpoint path.
      */
-    forOrg<T = any>(orgId: string): Promise<T>;
+    chatStreamUrl(): string;
 }
-
 /**
- * Platform-admin flow monitor resource — cross-tenant flow run monitoring.
+ * Platform AI container — groups the `copilot` sub-resource.
  *
- * Access via `ecod.platform.admin.flow`.
+ * Access via `ecod.platform.ai`.
  */
-declare class AdminFlow extends APIResource {
-    /**
-     * Retrieve the platform-wide flow overview.
-     */
-    overview<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * List flow runs across tenants.
-     */
-    runs<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * List flow run failures.
-     */
-    failures<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve a single flow run by ID.
-     */
-    run<T = any>(id: string): Promise<T>;
-    /**
-     * Retry a failed flow run.
-     */
-    retryRun<T = any>(id: string, body?: Record<string, unknown>): Promise<T>;
+declare class PlatformAI {
+    readonly copilot: Copilot;
+    constructor(client: AxiosInstance);
 }
 
-/**
- * Platform-admin integrations resource — per-tenant integration management.
- *
- * Access via `ecod.platform.admin.integrations`.
- */
-declare class AdminIntegrations extends APIResource {
-    /**
-     * List integrations for a tenant organization.
-     */
-    list<T = any>(orgId: string): Promise<T>;
-    /**
-     * Connect a provider integration for a tenant organization.
-     */
-    connect<T = any>(orgId: string, providerId: string, body?: Record<string, unknown>): Promise<T>;
-    /**
-     * Disconnect a provider integration for a tenant organization.
-     */
-    disconnect<T = any>(orgId: string, providerId: string): Promise<T>;
-    /**
-     * Test a provider integration for a tenant organization.
-     */
-    test<T = any>(orgId: string, providerId: string, body?: Record<string, unknown>): Promise<T>;
-    /**
-     * Send an integration invite for a tenant organization.
-     */
-    invite<T = any>(orgId: string, body: Record<string, unknown>): Promise<T>;
+/** One thing the AI agent knows from: pasted text, a web page or a file. */
+interface KnowledgeSource {
+    id: string;
+    kind: "text" | "url" | "file";
+    title: string;
+    /** The URL (kind=url) or storage key (kind=file). */
+    ref: string | null;
+    mimeType: string | null;
+    /** `pending` → `processing` → `ready` | `failed` (live: `knowledge.source_updated`). */
+    status: "pending" | "processing" | "ready" | "failed";
+    /** Why it failed, readable as-is. */
+    error: string | null;
+    chunkCount: number;
+    createdAt: string;
+    updatedAt: string;
 }
-
-/**
- * Platform-admin LAIE control resource — LAIE overview, queue, proxies,
- * credits, actors, enrichment config, and audits.
- *
- * Access via `ecod.platform.admin.laie`.
- */
-declare class AdminLaie extends APIResource {
-    /**
-     * Retrieve the LAIE platform overview.
-     */
-    overview<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve the LAIE processing queue.
-     */
-    queue<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * List LAIE proxies.
-     */
-    proxies<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve LAIE vault statistics.
-     */
-    vaultStats<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve LAIE credit usage.
-     */
-    credits<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * List LAIE actors.
-     */
-    actors<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve the LAIE actor registry.
-     */
-    actorRegistry<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Run a named LAIE actor.
-     */
-    runActor<T = any>(name: string, body?: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve the LAIE enrichment configuration.
-     */
-    getEnrichmentConfig<T = any>(): Promise<T>;
-    /**
-     * Update the LAIE enrichment configuration.
-     */
-    setEnrichmentConfig<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * List LAIE audit records.
-     */
-    audits<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve a single LAIE audit record by ID.
-     */
-    audit<T = any>(id: string): Promise<T>;
+/** A passage the agent would use for a question. */
+interface KnowledgePassage {
+    chunkId: string;
+    sourceId: string;
+    title: string;
+    content: string;
+    score: number;
 }
-
+/** File types the knowledge base can read. */
+declare const KNOWLEDGE_FILE_TYPES: readonly ["application/pdf", "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "text/plain", "text/markdown", "text/csv", "text/html", "image/png", "image/jpeg", "image/webp"];
+type Res<T> = {
+    success: boolean;
+    data: T;
+};
 /**
- * Platform-admin LAIE runtime resource — live runtime stats for queue,
- * proxies, browser pool, dead-letter queue, and runs.
- *
- * Access via `ecod.platform.admin.laieRuntime`.
+ * The AI agent's knowledge base (RAG): what it answers from. Adding and
+ * removing sources needs a workspace admin; reading and test-searching don't.
  */
-declare class AdminLaieRuntime extends APIResource {
-    /**
-     * Retrieve LAIE runtime queue statistics.
-     */
-    queueStats<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve LAIE runtime proxy health.
-     */
-    proxyHealth<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve LAIE runtime browser pool statistics.
-     */
-    browserPoolStats<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Replay the LAIE runtime dead-letter queue.
-     */
-    replayDlq<T = any>(body?: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve LAIE runtime run statistics.
-     */
-    runStats<T = any>(params?: Record<string, unknown>): Promise<T>;
+declare class Knowledge extends APIResource {
+    list(): Promise<Res<KnowledgeSource[]>>;
+    /** Paste text — an FAQ, a price list, a policy. */
+    addText(params: {
+        title: string;
+        content: string;
+    }): Promise<Res<KnowledgeSource>>;
+    /** A public web page (re-read it later with `reindex`). */
+    addUrl(params: {
+        url: string;
+        title?: string;
+    }): Promise<Res<KnowledgeSource>>;
+    /** Upload a file (PDF, Word, text, image) to your storage and add it. */
+    addFile(file: Blob, opts?: {
+        title?: string;
+    }): Promise<Res<KnowledgeSource>>;
+    remove(id: string): Promise<{
+        success: boolean;
+    }>;
+    /** Read the source again (e.g. the web page changed). */
+    reindex(id: string): Promise<Res<KnowledgeSource>>;
+    /** What the agent would retrieve for a question. */
+    search(query: string, limit?: number): Promise<Res<KnowledgePassage[]>>;
 }
 
-/**
- * Platform-admin LAIE vault resource — LAIE vault overview.
- *
- * Access via `ecod.platform.admin.laieVault`.
- */
-declare class AdminLaieVault extends APIResource {
-    /**
-     * Retrieve the LAIE vault overview.
-     *
-     * NOTE: the doubled `admin/laie/vault` segment is intentional — a legacy
-     * router is mounted under the new prefix.
-     */
-    overview<T = any>(params?: Record<string, unknown>): Promise<T>;
+/** A tool the org can let its AI agent use (from the server's catalog). */
+interface AiAgentTool {
+    id: string;
+    label: string;
+    description: string;
+    /** True when it changes data (books, updates…). */
+    sideEffect: boolean;
+}
+/** The org's AI agent (inbox auto-reply on WhatsApp, Instagram, Facebook, Telegram, email). */
+interface AiAgentSettings {
+    aiAgentEnabled: boolean;
+    /** The persona / instructions the agent follows. */
+    aiAgentPrompt: string | null;
+    /** Auto-send replies (otherwise they wait in the inbox as suggestions). */
+    aiAutoReply: boolean;
+    /** 0–1: below this, an auto-reply becomes a suggestion instead. */
+    aiConfidenceThreshold: number;
+    /** Ids from `availableTools` the agent may use. */
+    aiAllowedTools: string[];
+    /** Read-only: every tool that can be granted. */
+    availableTools?: AiAgentTool[];
+    /**
+     * Returned by `updateSettings` when the agent is on: the channels whose
+     * AI Auto-Reply flow is set up (connected channels only).
+     */
+    autoReplyChannels?: string[];
+}
+/** An AI draft waiting for a person in the inbox (kept up to 7 days). */
+interface AiSuggestion {
+    id: string;
+    conversationId: string;
+    text: string;
+    confidence: number;
+    /** A data-changing step the agent proposed with the reply (approve to run). */
+    pendingAction?: {
+        action: string;
+        input: Record<string, unknown>;
+    };
+    /** Knowledge sources the draft was grounded on. */
+    sources?: {
+        sourceId: string;
+        title: string;
+    }[];
+    /** Set once a person approved `pendingAction`. */
+    actionApprovedAt?: string;
+    generatedAt: string;
 }
-
-/**
- * Platform-admin leads resource — admin lead management, qualification,
- * follow-ups, and notes.
- *
- * NOTE: the doubled `leads/leads` segments are intentional — a legacy router
- * is mounted under the new prefix.
- *
- * Access via `ecod.platform.admin.leads`.
- */
-declare class AdminLeads extends APIResource {
-    /**
-     * Add a new lead.
-     */
-    addLead<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * List leads.
-     */
-    list<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve a single lead by ID.
-     */
-    retrieve<T = any>(id: string): Promise<T>;
-    /**
-     * Update a lead.
-     */
-    update<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
-    /**
-     * Delete a lead.
-     */
-    remove<T = any>(id: string): Promise<T>;
-    /**
-     * Update a lead's status.
-     */
-    updateStatus<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
-    /**
-     * Record a lead's qualification.
-     */
-    qualification<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
-    /**
-     * Record a lead's first contact.
-     */
-    firstContact<T = any>(id: string, body?: Record<string, unknown>): Promise<T>;
-    /**
-     * Record a follow-up for a lead.
-     */
-    followup<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
-    /**
-     * List notes for a lead.
-     */
-    notes<T = any>(id: string): Promise<T>;
-    /**
-     * Add a note to a lead.
-     */
-    addNote<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
-    /**
-     * Update a lead note.
-     */
-    updateNote<T = any>(id: string, noteId: string, body: Record<string, unknown>): Promise<T>;
-    /**
-     * Delete a lead note.
-     */
-    deleteNote<T = any>(id: string, noteId: string): Promise<T>;
+/** A Flow run held at an approval step. */
+interface PausedRun {
+    id: string;
+    flowId: string;
+    flowName: string;
+    leadId: string | null;
+    recordsHeld: number | null;
+    startedAt: string | null;
+    createdAt: string;
 }
-
 /**
- * Platform-admin OpenAPI resource — OpenAPI spec and health.
- *
- * Access via `ecod.platform.admin.openapi`.
+ * The AI agent: its settings and the drafts it leaves in the inbox. Drafts
+ * also arrive live on `ai_suggestion` and leave on `ai_suggestion.resolved`;
+ * held runs change on `workflow-run-update`.
  */
-declare class AdminOpenApi extends APIResource {
-    /**
-     * Retrieve the OpenAPI spec as JSON.
-     */
-    json<T = any>(): Promise<T>;
+declare class AiAgent extends APIResource {
+    /** Settings plus `availableTools`. */
+    settings(): Promise<{
+        success: boolean;
+        data: AiAgentSettings;
+    }>;
+    /** Change settings (workspace admins only). */
+    updateSettings(patch: Partial<Omit<AiAgentSettings, "availableTools">>): Promise<{
+        success: boolean;
+        data: AiAgentSettings;
+    }>;
+    /** The draft waiting on a conversation (`data: null` when none). */
+    suggestion(conversationId: string): Promise<{
+        success: boolean;
+        data: AiSuggestion | null;
+    }>;
     /**
-     * Retrieve the Swagger UI HTML page.
+     * Run the action the draft proposed (exactly the server's copy — once per
+     * draft). Send the reply afterwards through the inbox as usual.
      */
-    docs<T = any>(): Promise<T>;
+    approveAction(conversationId: string): Promise<{
+        success: boolean;
+        data: {
+            action: string;
+            output: unknown;
+        };
+    }>;
+    /** Record that a person sent the draft (possibly edited) and clear it. */
+    markSent(conversationId: string, text: string, confidence: number): Promise<unknown>;
+    /** Discard the draft. */
+    dismiss(conversationId: string): Promise<unknown>;
     /**
-     * Retrieve the OpenAPI health status.
+     * Everything waiting on a person: AI drafts across every conversation, and
+     * Flow runs held at an approval step.
      */
-    health<T = any>(): Promise<T>;
+    approvals(): Promise<{
+        success: boolean;
+        data: {
+            drafts: AiSuggestion[];
+            runs: PausedRun[];
+        };
+    }>;
+    /** Let a held run continue, or stop it. */
+    decideRun(runId: string, decision: "approve" | "reject"): Promise<{
+        success: boolean;
+        decision: string;
+    }>;
 }
 
 /**
- * Platform-admin partners resource — manage partners and their referrals.
+ * Platform authentication resource — registration, login, sessions,
+ * password management, OAuth linking, and organization invitations.
  *
- * Access via `ecod.platform.admin.partners`.
+ * Access via `ecod.platform.auth`.
  */
-declare class AdminPartners extends APIResource {
-    /**
-     * Retrieve aggregate partner statistics.
-     */
-    stats<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * List all partners.
-     */
-    list<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Create a new partner.
-     */
-    create<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Retrieve a single partner by ID.
-     */
-    retrieve<T = any>(id: string): Promise<T>;
-    /**
-     * Update an existing partner.
-     */
-    update<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
+declare class Auth extends APIResource {
     /**
-     * Delete a partner.
+     * Register a new platform user / organization.
      */
-    remove<T = any>(id: string): Promise<T>;
+    register<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * List referrals for a partner.
+     * Authenticate a user and establish a session.
      */
-    referrals<T = any>(id: string): Promise<T>;
+    login<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Update a specific referral for a partner.
+     * Log out of the current session.
      */
-    updateReferral<T = any>(id: string, refId: string, body: Record<string, unknown>): Promise<T>;
-}
-
-/**
- * Platform-admin payment operations resource — refunds, payment validation,
- * retries, timelines, and risk assessment.
- *
- * Access via `ecod.platform.admin.paymentOps`.
- */
-declare class AdminPaymentOps extends APIResource {
+    logout<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Issue a refund.
+     * Log out of every active session for the current user.
      */
-    refund<T = any>(body: Record<string, unknown>): Promise<T>;
+    logoutAll<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Validate a payment by ID.
+     * Validate the current session token.
      */
-    validate<T = any>(paymentId: string): Promise<T>;
+    validateSession<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Fetch a payment by ID.
+     * List all active sessions for the current user.
      */
-    fetch<T = any>(paymentId: string): Promise<T>;
+    listSessions<T = any>(): Promise<T>;
     /**
-     * Retrieve a subscription by ID.
+     * Revoke a specific session by its ID.
+     *
+     * @param id - The session ID to revoke.
      */
-    subscription<T = any>(subId: string): Promise<T>;
+    revokeSession<T = any>(id: string): Promise<T>;
     /**
-     * List failed payments.
+     * Request a one-time password (OTP) to set or change a password.
      */
-    failed<T = any>(params?: Record<string, unknown>): Promise<T>;
+    requestPasswordOtp<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Retry failed payments for an organization.
+     * Set a password for the current user.
      */
-    retry<T = any>(orgId: string, body?: Record<string, unknown>): Promise<T>;
+    setPassword<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Retrieve the payment timeline for an organization.
+     * Change the current user's password.
      */
-    timeline<T = any>(orgId: string): Promise<T>;
+    changePassword<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Retrieve the payment risk assessment for an organization.
+     * Begin the forgot-password flow.
      */
-    risk<T = any>(orgId: string): Promise<T>;
-}
-
-/**
- * Platform-admin persona history resource — inspect persona version history.
- *
- * Access via `ecod.platform.admin.personaHistory`.
- */
-declare class AdminPersonaHistory extends APIResource {
+    forgotPassword<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Retrieve aggregate persona history statistics.
+     * Reset a password using a reset token.
      */
-    stats<T = any>(params?: Record<string, unknown>): Promise<T>;
+    resetPassword<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * List persona history entries.
+     * Link an OAuth identity to the current user.
      */
-    list<T = any>(params?: Record<string, unknown>): Promise<T>;
+    linkOAuth<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Retrieve the history for a specific persona.
+     * Retrieve details about an organization invitation by token.
+     *
+     * @param token - The invitation token.
      */
-    retrieve<T = any>(personaId: string): Promise<T>;
+    getInvitation<T = any>(token: string): Promise<T>;
     /**
-     * Retrieve a specific version of a persona's history.
+     * Accept an organization invitation by token.
+     *
+     * @param token - The invitation token.
+     * @param body - Optional acceptance payload.
      */
-    version<T = any>(personaId: string, version: string): Promise<T>;
+    acceptInvitation<T = any>(token: string, body?: Record<string, unknown>): Promise<T>;
 }
 
 /**
- * Platform-admin pipelines resource — pipeline template management and
- * provisioning.
+ * Entitlements resource — read current plan entitlements and usage.
  *
- * Access via `ecod.platform.admin.pipelines`.
+ * Access via `ecod.platform.billing.entitlements`.
  */
-declare class AdminPipelines extends APIResource {
-    /**
-     * List pipeline templates.
-     */
-    templates<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * Create a new pipeline template.
-     */
-    createTemplate<T = any>(body: Record<string, unknown>): Promise<T>;
-    /**
-     * Update an existing pipeline template.
-     */
-    updateTemplate<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
-    /**
-     * Delete a pipeline template.
-     */
-    deleteTemplate<T = any>(id: string): Promise<T>;
+declare class Entitlements extends APIResource {
     /**
-     * Provision pipelines from templates.
+     * Retrieve the current organization's entitlements.
      */
-    provision<T = any>(body: Record<string, unknown>): Promise<T>;
+    get<T = any>(): Promise<T>;
     /**
-     * Retrieve the pipelines overview.
+     * Retrieve current usage against entitlements.
      */
-    overview<T = any>(params?: Record<string, unknown>): Promise<T>;
+    usage<T = any>(): Promise<T>;
 }
-
 /**
- * Platform-admin plans resource — manage billing plans.
+ * Subscriptions resource — manage plan upgrades, downgrades, cancellations,
+ * and add-ons.
  *
- * Access via `ecod.platform.admin.plans`.
+ * Access via `ecod.platform.billing.subscriptions`.
  */
-declare class AdminPlans extends APIResource {
+declare class Subscriptions extends APIResource {
     /**
-     * List all plans.
+     * Upgrade the current subscription plan.
      */
-    list<T = any>(params?: Record<string, unknown>): Promise<T>;
+    upgrade<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Create a new plan.
+     * Downgrade the current subscription plan.
      */
-    create<T = any>(body: Record<string, unknown>): Promise<T>;
+    downgrade<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Update an existing plan.
+     * Cancel the current subscription.
      */
-    update<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
+    cancel<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Delete a plan.
+     * Purchase an add-on for the current subscription.
      */
-    remove<T = any>(id: string): Promise<T>;
+    purchaseAddon<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * List tenants subscribed to a plan.
+     * Cancel a previously purchased add-on.
      */
-    tenants<T = any>(id: string): Promise<T>;
+    cancelAddon<T = any>(body: Record<string, unknown>): Promise<T>;
 }
-
 /**
- * Platform-admin revenue resource — revenue summaries and snapshots.
+ * Plans resource — read publicly available plans.
  *
- * Access via `ecod.platform.admin.revenue`.
+ * Access via `ecod.platform.billing.plans`.
  */
-declare class AdminRevenue extends APIResource {
-    /**
-     * Retrieve the aggregated revenue summary.
-     */
-    summary<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * List historical revenue snapshots.
-     */
-    snapshots<T = any>(params?: Record<string, unknown>): Promise<T>;
+declare class Plans extends APIResource {
     /**
-     * Generate a new revenue snapshot.
+     * List all publicly available plans.
      */
-    generateSnapshot<T = any>(body?: Record<string, unknown>): Promise<T>;
+    listPublic<T = any>(): Promise<T>;
 }
-
 /**
- * Platform-admin staff resource — admin staff account management.
- *
- * NOTE: the doubled `admin/staff` segments are intentional — a legacy router
- * is mounted under the new prefix.
+ * Billing checkout resource — plan selection, subscription, verification,
+ * and synchronization.
  *
- * Access via `ecod.platform.admin.staff`.
+ * Access via `ecod.platform.billing.checkout`.
  */
-declare class AdminStaff extends APIResource {
+declare class BillingCheckout extends APIResource {
     /**
-     * Verify staff credentials.
+     * List plans available at checkout.
      */
-    verifyCredentials<T = any>(body: Record<string, unknown>): Promise<T>;
+    plans<T = any>(): Promise<T>;
     /**
-     * Find an existing staff account or create one.
+     * Subscribe to a plan via checkout.
      */
-    findOrCreate<T = any>(body: Record<string, unknown>): Promise<T>;
+    subscribe<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * List admin staff accounts.
+     * Verify a checkout payment.
      */
-    list<T = any>(params?: Record<string, unknown>): Promise<T>;
+    verify<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Create an admin staff account.
+     * Cancel an in-progress checkout.
      */
-    create<T = any>(body: Record<string, unknown>): Promise<T>;
+    cancel<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Update an admin staff account.
+     * Retrieve the current checkout status.
      */
-    update<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
+    status<T = any>(): Promise<T>;
     /**
-     * Delete an admin staff account.
+     * Synchronize the checkout plan state with the provider.
      */
-    remove<T = any>(id: string): Promise<T>;
+    syncPlan<T = any>(body: Record<string, unknown>): Promise<T>;
 }
-
 /**
- * Platform-admin storage resource — storage statistics, events, and usage.
+ * Billing user resource — transactions, subscription, and disputes for the
+ * current user.
  *
- * Access via `ecod.platform.admin.storage`.
+ * Access via `ecod.platform.billing.user`.
  */
-declare class AdminStorage extends APIResource {
+declare class BillingUser extends APIResource {
     /**
-     * Retrieve aggregate storage statistics.
+     * List the current user's billing transactions.
      */
-    stats<T = any>(params?: Record<string, unknown>): Promise<T>;
+    transactions<T = any>(): Promise<T>;
     /**
-     * List storage events.
+     * Retrieve the current user's subscription.
      */
-    events<T = any>(params?: Record<string, unknown>): Promise<T>;
+    subscription<T = any>(): Promise<T>;
     /**
-     * Retrieve storage usage.
+     * Raise a billing dispute.
      */
-    usage<T = any>(params?: Record<string, unknown>): Promise<T>;
-}
-
-/**
- * Platform-admin system health resource — system health overview.
- *
- * Access via `ecod.platform.admin.health`.
- */
-declare class AdminHealth extends APIResource {
+    raiseDispute<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Retrieve the system health overview.
+     * List the current user's billing disputes.
      */
-    overview<T = any>(params?: Record<string, unknown>): Promise<T>;
+    disputes<T = any>(): Promise<T>;
 }
-
 /**
- * Platform-admin templates resource — manage templates, versions, and
- * plan assignments.
+ * Credits resource — balance, transactions, packs, and top-ups.
  *
- * Access via `ecod.platform.admin.templates`.
+ * Access via `ecod.platform.billing.credits`.
  */
-declare class AdminTemplates extends APIResource {
-    /**
-     * List all templates.
-     */
-    list<T = any>(params?: Record<string, unknown>): Promise<T>;
+declare class Credits extends APIResource {
     /**
-     * Create a new template.
+     * Retrieve the current credit balance.
      */
-    create<T = any>(body: Record<string, unknown>): Promise<T>;
+    balance<T = any>(): Promise<T>;
     /**
-     * Retrieve a single template by ID.
+     * List credit transactions.
      */
-    retrieve<T = any>(id: string): Promise<T>;
+    transactions<T = any>(): Promise<T>;
     /**
-     * Update an existing template.
+     * List available credit packs.
      */
-    update<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
+    packs<T = any>(): Promise<T>;
     /**
-     * Delete a template.
+     * Create a credit top-up order.
      */
-    remove<T = any>(id: string): Promise<T>;
+    topupOrder<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Clone an existing template.
+     * Verify a credit top-up payment.
      */
-    clone<T = any>(id: string, body?: Record<string, unknown>): Promise<T>;
+    verifyTopup<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * List versions of a template.
+     * Configure automatic credit top-ups.
      */
-    versions<T = any>(id: string): Promise<T>;
+    setAutoTopup<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Assign plans to a template.
+     * Configure the daily spend cap (cost control).
+     * Body: `{ dailyCap: number | null, alertPct?: number }`.
      */
-    assignPlans<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
+    setSpendCap<T = any>(body: Record<string, unknown>): Promise<T>;
+}
+/**
+ * Platform billing container — groups the `entitlements`, `subscriptions`,
+ * `plans`, `checkout`, `user`, and `credits` sub-resources.
+ *
+ * Access via `ecod.platform.billing`.
+ */
+declare class Billing {
+    readonly entitlements: Entitlements;
+    readonly subscriptions: Subscriptions;
+    readonly plans: Plans;
+    readonly checkout: BillingCheckout;
+    readonly user: BillingUser;
+    readonly credits: Credits;
+    constructor(client: AxiosInstance);
 }
 
 /**
- * Platform-admin tenants resource — deep tenant inspection and lifecycle control.
+ * Platform support resource — categories and support ticket lifecycle.
  *
- * Access via `ecod.platform.admin.tenants`.
+ * Access via `ecod.platform.support`.
  */
-declare class AdminTenants extends APIResource {
-    /**
-     * Retrieve a deep, fully-expanded view of a tenant organization.
-     */
-    deep<T = any>(orgId: string): Promise<T>;
-    /**
-     * Retrieve usage metrics for a tenant organization.
-     */
-    usage<T = any>(orgId: string): Promise<T>;
-    /**
-     * Retrieve the team/members for a tenant organization.
-     */
-    team<T = any>(orgId: string): Promise<T>;
-    /**
-     * Retrieve billing details for a tenant organization.
-     */
-    billing<T = any>(orgId: string): Promise<T>;
-    /**
-     * Retrieve WhatsApp configuration for a tenant organization.
-     */
-    whatsapp<T = any>(orgId: string): Promise<T>;
-    /**
-     * Retrieve automation flows for a tenant organization.
-     */
-    flows<T = any>(orgId: string): Promise<T>;
-    /**
-     * Retrieve CRM statistics for a tenant organization.
-     */
-    crmStats<T = any>(orgId: string): Promise<T>;
-    /**
-     * Impersonate a tenant organization.
-     */
-    impersonate<T = any>(orgId: string, body?: Record<string, unknown>): Promise<T>;
+declare class Support extends APIResource {
     /**
-     * Suspend a tenant organization.
+     * List available support categories.
      */
-    suspend<T = any>(orgId: string, body?: Record<string, unknown>): Promise<T>;
+    categories<T = any>(): Promise<T>;
     /**
-     * Reactivate a suspended tenant organization.
+     * List support tickets with optional filtering.
+     *
+     * @param params - Optional query parameters (status, pagination, etc.).
      */
-    reactivate<T = any>(orgId: string, body?: Record<string, unknown>): Promise<T>;
+    listTickets<T = any>(params?: Record<string, unknown>): Promise<T>;
     /**
-     * Update the plan assigned to a tenant organization.
+     * Create a new support ticket.
      */
-    updatePlan<T = any>(orgId: string, body: Record<string, unknown>): Promise<T>;
+    createTicket<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Update usage limits for a tenant organization.
+     * Retrieve a single support ticket by its ID.
+     *
+     * @param id - The support ticket ID.
      */
-    updateLimits<T = any>(orgId: string, body: Record<string, unknown>): Promise<T>;
+    getTicket<T = any>(id: string): Promise<T>;
     /**
-     * Bulk-assign a plan across multiple tenant organizations.
+     * Reply to an existing support ticket.
+     *
+     * @param id - The support ticket ID.
+     * @param body - The reply payload.
      */
-    bulkAssignPlan<T = any>(body: Record<string, unknown>): Promise<T>;
+    reply<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
     /**
-     * List tenant organizations that have no plan assigned.
+     * Close a support ticket.
+     *
+     * @param id - The support ticket ID.
      */
-    unassigned<T = any>(): Promise<T>;
+    close<T = any>(id: string): Promise<T>;
 }
 
 /**
- * Platform-admin tickets resource — manage support tickets, messages, and
- * lifecycle transitions.
+ * Current-user ("me") resource — profile, organization, modules,
+ * workspaces, and active-org management.
  *
- * Access via `ecod.platform.admin.tickets`.
+ * Access via `ecod.platform.users.me`.
  */
-declare class AdminTickets extends APIResource {
-    /**
-     * Retrieve aggregate ticket statistics.
-     */
-    stats<T = any>(params?: Record<string, unknown>): Promise<T>;
+declare class Me extends APIResource {
     /**
-     * List all tickets.
+     * Retrieve the current authenticated user's profile.
      */
-    list<T = any>(params?: Record<string, unknown>): Promise<T>;
+    get<T = any>(): Promise<T>;
     /**
-     * Create a new ticket.
+     * Update the current user's profile.
      */
-    create<T = any>(body: Record<string, unknown>): Promise<T>;
+    update<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Retrieve a single ticket by ID.
+     * Update the current user's active organization details.
      */
-    retrieve<T = any>(id: string): Promise<T>;
+    updateOrganization<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Update an existing ticket.
+     * Toggle enabled modules for the current user / organization.
      */
-    update<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
+    toggleModules<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Add a message to a ticket.
+     * List the workspaces available to the current user.
      */
-    addMessage<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
+    workspaces<T = any>(): Promise<T>;
     /**
-     * Resolve a ticket.
+     * Set the active organization for the current user.
      */
-    resolve<T = any>(id: string, body?: Record<string, unknown>): Promise<T>;
+    setActiveOrg<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Close a ticket.
+     * Dismiss the workspace setup prompt for the current user.
      */
-    close<T = any>(id: string, body?: Record<string, unknown>): Promise<T>;
+    dismissWorkspaceSetup<T = any>(): Promise<T>;
 }
-
 /**
- * Platform-admin waitlist resource — manage waitlist entries.
+ * Organization members resource — list, invite, and remove members.
  *
- * Access via `ecod.platform.admin.waitlist`.
+ * Access via `ecod.platform.users.members`.
  */
-declare class AdminWaitlist extends APIResource {
-    /**
-     * Retrieve aggregate waitlist statistics.
-     */
-    stats<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * List waitlist entries.
-     */
-    list<T = any>(params?: Record<string, unknown>): Promise<T>;
+declare class Members extends APIResource {
     /**
-     * Retrieve a single waitlist entry by ID.
+     * List all members of the current organization.
      */
-    retrieve<T = any>(id: string): Promise<T>;
+    list<T = any>(): Promise<T>;
     /**
-     * Update a waitlist entry.
+     * Invite a new member to the current organization.
      */
-    update<T = any>(id: string, body: Record<string, unknown>): Promise<T>;
+    invite<T = any>(body: Record<string, unknown>): Promise<T>;
     /**
-     * Remove a waitlist entry.
+     * Remove a member from the current organization.
+     *
+     * @param id - The member ID to remove.
      */
     remove<T = any>(id: string): Promise<T>;
-    /**
-     * Perform a bulk operation on waitlist entries.
-     */
-    bulk<T = any>(body: Record<string, unknown>): Promise<T>;
 }
-
 /**
- * Platform-admin WhatsApp control resource — cross-tenant WhatsApp monitoring.
+ * User sessions resource — list and revoke sessions.
  *
- * Access via `ecod.platform.admin.whatsapp`.
+ * Access via `ecod.platform.users.sessions`.
  */
-declare class AdminWhatsApp extends APIResource {
-    /**
-     * Retrieve the platform-wide WhatsApp overview.
-     */
-    overview<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * List all WhatsApp Business Accounts (WABAs).
-     */
-    wabas<T = any>(params?: Record<string, unknown>): Promise<T>;
-    /**
-     * List WhatsApp message templates across tenants.
-     */
-    templates<T = any>(params?: Record<string, unknown>): Promise<T>;
+declare class Sessions extends APIResource {
     /**
-     * Retrieve WhatsApp delivery metrics.
+     * List all sessions for the current user.
      */
-    delivery<T = any>(params?: Record<string, unknown>): Promise<T>;
+    list<T = any>(): Promise<T>;
     /**
-     * List WhatsApp webhook events.
+     * Revoke a specific session by its ID.
+     *
+     * @param id - The session ID to revoke.
      */
-    webhooks<T = any>(params?: Record<string, unknown>): Promise<T>;
+    revoke<T = any>(id: string): Promise<T>;
 }
 
 /**
@@ -6675,36 +4329,34 @@ declare class AdminWhatsApp extends APIResource {
  * mounted v1 endpoint are wired.
  */
 
-/** WhatsApp/web chat inbox (`/v1/api/product/erix/chat/*`). */
+/**
+ * The unified inbox (`/v1/api/platform/inbox/*`) — every channel's threads.
+ * Bulk sends are Flow campaigns (a flow run over a CRM segment), not a raw
+ * broadcast API.
+ */
 declare class ErixChat {
     readonly messages: Messages;
     readonly conversations: Conversations;
-    readonly broadcasts: Broadcasts;
     constructor(client: AxiosInstance);
 }
 /** Every ERIX product resource (`/v1/api/product/erix/*`). */
 declare class ErixProduct {
     readonly leads: Leads;
     readonly pipelines: Pipelines;
-    readonly automations: Automations;
     readonly activities: Activities;
     readonly analytics: Analytics;
     readonly scoring: Scoring;
     readonly payments: Payments;
-    readonly sequences: Sequences;
-    readonly automationDashboard: AutomationDashboard;
     readonly chat: ErixChat;
     readonly events: EventsResource;
-    readonly eventLog: Logs;
     readonly invoices: Invoices;
     readonly checkout: Checkout;
     readonly projects: ProjectDocuments;
-    readonly campaigns: Campaigns;
-    readonly portalInbox: PortalInbox;
     readonly niche: NicheResources;
     readonly documents: CRMDocuments;
     readonly invoiceExport: CRMInvoiceExport;
-    readonly crmCampaigns: CRMCampaigns;
+    /** The AI agent: settings + inbox drafts. */
+    readonly ai: AiAgent;
     constructor(client: AxiosInstance);
 }
 /** Product domain root (`/v1/api/product/*`). */
@@ -6758,52 +4410,6 @@ declare class PlatformUsers {
     readonly notifications: Notifications;
     constructor(client: AxiosInstance);
 }
-/**
- * Admin control plane (`/platform/admin/*`) — requires the elevated
- * `coreApiKey`. This is the full platform-admin console surface consumed by
- * the `admin` app.
- */
-declare class PlatformAdmin {
-    readonly revenue: AdminRevenue;
-    readonly billing: AdminBilling;
-    readonly payments: AdminPaymentOps;
-    readonly credits: AdminCredits;
-    readonly plans: AdminPlans;
-    readonly agencyInvoices: AdminAgencyInvoices;
-    readonly flags: AdminFeatureFlags;
-    readonly activityLogs: AdminActivityLogs;
-    readonly auditLogs: AdminAuditLogs;
-    readonly analytics: AdminAnalytics;
-    readonly health: AdminHealth;
-    readonly storage: AdminStorage;
-    readonly announcements: AdminAnnouncements;
-    readonly compliance: AdminCompliance;
-    readonly tickets: AdminTickets;
-    readonly templates: AdminTemplates;
-    readonly agents: AdminAgents;
-    readonly personaHistory: AdminPersonaHistory;
-    readonly openapi: AdminOpenApi;
-    readonly staff: AdminStaff;
-    readonly tenants: AdminTenants;
-    readonly whatsapp: AdminWhatsApp;
-    readonly laie: AdminLaie;
-    readonly laieRuntime: AdminLaieRuntime;
-    readonly laieVault: AdminLaieVault;
-    readonly flow: AdminFlow;
-    readonly email: AdminEmail;
-    readonly pipelines: AdminPipelines;
-    readonly integrations: AdminIntegrations;
-    readonly erix: AdminErix;
-    readonly dashboard: AdminDashboard;
-    readonly partners: AdminPartners;
-    readonly waitlist: AdminWaitlist;
-    readonly blogs: AdminBlogs;
-    readonly leads: AdminLeads;
-    readonly onboarding: AdminOnboarding;
-    readonly cors: Cors;
-    readonly clients: Services;
-    constructor(client: AxiosInstance);
-}
 /** Platform control plane (`/platform/*`). */
 declare class PlatformDomain {
     readonly auth: Auth;
@@ -6812,7 +4418,8 @@ declare class PlatformDomain {
     readonly billing: Billing;
     readonly support: Support;
     readonly ai: PlatformAI;
-    readonly admin: PlatformAdmin;
+    /** The AI agent's knowledge base (RAG). */
+    readonly knowledge: Knowledge;
     readonly health: Health;
     constructor(client: AxiosInstance);
 }
@@ -6911,7 +4518,8 @@ declare class Webhooks {
 /**
  * Configuration options for the ECODrIxAPI client.
  *
- * Minimum required: `apiKey` and `clientCode`.
+ * Server-side: `apiKey` and `clientCode`. In a browser use `proxy` instead —
+ * a workspace key must never ship to a browser.
  * The backend URL is managed internally and should not need to be changed.
  */
 interface ECODrIxAPIOptions {
@@ -6920,18 +4528,13 @@ interface ECODrIxAPIOptions {
      * Obtain this from the ECODrIx dashboard under Settings → API Keys.
      * @example "ecod_live_sk_..."
      */
-    apiKey: string;
+    apiKey?: string;
     /**
      * Your tenant ID (Client Code).
      * This scopes all API requests to your specific organisation.
      * @example "ERIX_CLNT_JHBJHF"
      */
     clientCode?: string;
-    /**
-     * Optional Core API Key for deep system-level bypasses.
-     * Only used by elevated internal SaaS modules like Nirvisham.
-     */
-    coreApiKey?: string;
     /**
      * API route version to target. This is the ONLY knob for moving the entire
      * SDK to a new server API version — every endpoint is issued relative to
@@ -6962,6 +4565,27 @@ interface ECODrIxAPIOptions {
      * caller forever). Defaults to 30000 (30s). Set 0 to disable.
      */
     timeout?: number;
+    /**
+     * Browser mode — no workspace key in the page. Requests go to YOUR server
+     * route at `url` (it checks your signed-in user, adds `x-api-key` /
+     * `x-client-code`, and forwards `<url>/<version>/api/*` to ECODrIx). For
+     * realtime, `ticket` returns a short-lived socket ticket your server gets
+     * from `POST /v1/api/platform/realtime/ticket`; without it no socket opens.
+     *
+     * @example
+     * ```typescript
+     * new ECODrIxAPI({
+     *   proxy: {
+     *     url: "/api/erix",
+     *     ticket: () => fetch("/api/erix/ticket").then((r) => r.text()),
+     *   },
+     * });
+     * ```
+     */
+    proxy?: {
+        url: string;
+        ticket?: () => Promise<string>;
+    };
 }
 /**
  * The primary entry point for the ECODrIx SDK.
@@ -7033,6 +4657,8 @@ declare class ECODrIxAPI {
      * @param roomId - The unique identifier for the room.
      */
     leaveRoom(roomId: string): void;
+    /** Highest event `seq` seen — sent on reconnect so missed events replay. */
+    private lastSeq;
     private setupSocket;
     /**
      * Subscribe to a real-time event emitted by the ECODrIx platform.
@@ -7042,14 +4668,24 @@ declare class ECODrIxAPI {
      * your own tenant.
      *
      * **Standard events:**
-     * - `new_message` — inbound WhatsApp message (includes conversation and message payload)
-     * - `message_sent` — outbound message successfully sent
-     * - `message_status_update` — WhatsApp message status change (delivered, read, failed)
-     * - `conversation_updated` — metadata change (unread count, last message, status)
-     * - `message_updated` — real-time updates for reactions or media processing
-     * - `notification:new` — new system or CRM notification
+     * - `inbox.message` — `{ conversationId, message }` for EVERY message the
+     *   inbox stores: any channel, inbound or outbound, sent by anyone
+     *   (customer, agent, Flow, the AI). The one event an inbox needs.
+     * - `message_status_update` — `{ messageId, conversationId, status }`
+     *   (sent → delivered → read, or failed)
+     * - `new_message` / `message_sent` / `conversation_updated` /
+     *   `message_updated` — WhatsApp-specific detail (reactions, media)
+     * - `ai_suggestion` — an AI draft is waiting on a conversation
+     * - `ai_handoff` — `{ conversationId, reason }`: the AI handed a chat to a person
+     * - `platform:notification` / `platform:notification_count` — notifications
+     * - `knowledge.source_updated` / `knowledge.source_removed` — knowledge base
      * - `workflow-run-update` — automation execution progress
-     * - `meet.scheduled` — Google Meet appointment booked
+     * - `resync` — after a reconnect the server couldn't replay everything that
+     *   was missed (gap too old/large): refetch your data.
+     *
+     * Every event's last argument is `{ seq }` (plus `replay: true` when it was
+     * re-sent after a reconnect). A replay can repeat an event you already got,
+     * so make handlers idempotent (e.g. upsert by id).
      *
      * @param event - The event name to subscribe to.
      * @param callback - The handler function invoked when the event fires.
@@ -7073,6 +4709,7 @@ declare class ECODrIxAPI {
      * process.on("SIGTERM", () => ecod.disconnect());
      * ```
      */
+    private closed;
     disconnect(): void;
     /**
      * Remove a previously registered event listener.
@@ -7465,4 +5102,4 @@ declare function getRetryConfig(error: any): {
     readonly reason: "Generic API errors may be transient and worth retrying";
 };
 
-export { type AIPersona, APIError, AdminOnboarding, type AnswerFollowupBody, type AnswerOnboardingPayload, type AnswerOnboardingResponse, type ApplyCouponPayload, AuthenticationError, type BehaviorRules, type Broadcast, type CheckboxConfig, type CheckoutAmountBreakdown, type CheckoutOrderResponse, type CheckoutProduct, type CheckoutSession, type ColorRule, type ColumnConfig, type CompleteOnboardingPayload, type CompleteOnboardingResponse, type ConfidenceResponse, ConnectInfra, type Conversation, type ListParams as ConversationListParams, type Correction, type CreateBroadcastParams, type CreateLeadParams, type CreateNichePackPayload, type CreateOnboardingConfigPayload, type CreateOnboardingExperimentPayload, type CreateOrderPayload, type CreatePipelineParams, type CreateSessionPayload, type CrmView, type CurrencyConfig, type CurrencyValue, type CustomFieldFilter, type DateConfig, type DateTimeConfig, type DropdownConfig, ECODrIxAPI as ECODrIx, ECODrIxAPI, type ECODrIxAPIOptions, ERROR_RETRY_CONFIG, EcodrixError, type EditOnboardingPayload, type EditOnboardingResponse, type EmailConfig, EmailConnect, ErixChat, ErixProduct, type FieldConfig, type FieldDefinition, type FieldManifest, type FieldType, type FileConfig, type FilterOperator, type FilterRule, type ForkNichePackPayload, type FormulaConfig, type GlobalOnboardingPayload, HTTP_STATUS_ERROR_MAP, type ICP, InfraDomain, LEAD_STATUS_VALUES, type LayoutType, type Lead, type LeadPattern, type LeadSource, type LeadStatus, type LearningMemory, type ListLeadsParams, type ListNichePacksParams, type ListNichePacksResponse, type ListOnboardingConfigsParams, type ListOnboardingExperimentsParams, type ListOnboardingExperimentsResponse, type ManifestFieldType, type Message, type NichePack, type NichePackResearchConfig, type NichePackResponse, type NichePackStatus, type NichePackSummary, type NormalizedFieldValue, type NumberConfig, Onboarding, type OnboardingAbandonmentResponse, type OnboardingAbandonmentResult, type OnboardingAbandonmentRow, type OnboardingAnalyticsFiltersParams, type OnboardingCohortRange, type OnboardingConfig, type OnboardingExperiment, type OnboardingExperimentResponse, type OnboardingExperimentStatus, type OnboardingExperimentVariant, type OnboardingFunnelResponse, type OnboardingFunnelResult, type OnboardingFunnelStep, type OnboardingMemoryMapping, type OnboardingOption, type OnboardingSession, type OnboardingSessionStatus, type OnboardingStateResponse, type OnboardingStep, type OnboardingStepType, type OnboardingTimeOnStepResponse, type OnboardingTimeOnStepResult, type OnboardingTimeOnStepRow, type OutreachEdit, type PaginatedResponse, Persona, type PersonaFollowupQuestion, type PersonaFollowupsResponse, type PersonaIdentity, type PersonaTimelineEntry, type PersonaTimelineOptions, type PersonaTimelineResponse, type PhoneConfig, type Pipeline, type PipelineStage, type PipelineStageParams, PlatformAdmin, PlatformDomain, PlatformTenants, PlatformUsers, ProductDomain, type ProgressConfig, RateLimitError, type RatingConfig, type ReinforceResponse, type ReinforcementEvent, type RelationConfig, type RelationValue, type ResourceManifest, type SendMessageParams, type ServiceConfig, type ServiceConfigGlobal, type ServiceConfigPerProduct, type SmokeTestMaterializerAction, type SmokeTestNichePackPayload, type SmokeTestResult, type SortRule, type StartOnboardingPayload, type StartOnboardingResponse, StorageInfra, type StoredFieldValue, type SuggestionEvent, type TagsConfig, type Template, type TemplateComponent, type TemplateMapping, type TextConfig, type UpdateNichePackPayload, type UpdateOnboardingConfigPayload, type UpdateOnboardingExperimentPayload, type UpsertLeadParams, type UrlConfig, type VerifyPayload, type ViewConfig, type Vocabulary, WhatsAppConnect, type WorkspaceDashboardLayout, type WorkspaceDefaultAutomation, type WorkspaceDefaultField, type WorkspaceDefaultPipeline, type WorkspaceModuleConfig, type WorkspaceProfile, ECODrIxAPI as default, getErrorDetails, getRetryConfig, handleAPIError, isAPIError };
+export { type AIPersona, APIError, APIResource, AiAgent, type AiAgentSettings, type AiAgentTool, type AiSuggestion, type AnswerFollowupBody, type AnswerOnboardingPayload, type AnswerOnboardingResponse, type ApplyCouponPayload, AuthenticationError, type BehaviorRules, type CheckboxConfig, type CheckoutAmountBreakdown, type CheckoutOrderResponse, type CheckoutProduct, type CheckoutSession, type ColorRule, type ColumnConfig, type CompleteOnboardingPayload, type CompleteOnboardingResponse, type ConfidenceResponse, ConnectInfra, type Conversation, type ListParams as ConversationListParams, type Correction, type CreateLeadParams, type CreateOrderPayload, type CreatePipelineParams, type CreateSessionPayload, type CrmView, type CurrencyConfig, type CurrencyValue, type CustomFieldFilter, type DateConfig, type DateTimeConfig, type DropdownConfig, ECODrIxAPI as ECODrIx, ECODrIxAPI, type ECODrIxAPIOptions, ERROR_RETRY_CONFIG, EcodrixError, type EditOnboardingPayload, type EditOnboardingResponse, type EmailConfig, EmailConnect, ErixChat, ErixProduct, type FieldConfig, type FieldDefinition, type FieldManifest, type FieldType, type FileConfig, type FilterOperator, type FilterRule, type FormulaConfig, type GlobalOnboardingPayload, HTTP_STATUS_ERROR_MAP, type ICP, type InboxChannel, InfraDomain, KNOWLEDGE_FILE_TYPES, Knowledge, type KnowledgePassage, type KnowledgeSource, LEAD_STATUS_VALUES, type LayoutType, type Lead, type LeadPattern, type LeadSource, type LeadStatus, type LearningMemory, type ListLeadsParams, type ManifestFieldType, type MappingField, type MappingPreviewResult, type MappingSources, type MappingValidationResult, type Message, type NichePack, type NichePackResearchConfig, type NichePackStatus, type NormalizedFieldValue, type NumberConfig, Onboarding, type OnboardingCohortRange, type OnboardingConfig, type OnboardingExperiment, type OnboardingExperimentStatus, type OnboardingExperimentVariant, type OnboardingMemoryMapping, type OnboardingOption, type OnboardingSession, type OnboardingSessionStatus, type OnboardingStateResponse, type OnboardingStep, type OnboardingStepType, type OutboundMedia, type OutreachEdit, type PaginatedResponse, type PausedRun, Persona, type PersonaFollowupQuestion, type PersonaFollowupsResponse, type PersonaIdentity, type PersonaTimelineEntry, type PersonaTimelineOptions, type PersonaTimelineResponse, type PhoneConfig, type Pipeline, type PipelineStage, type PipelineStageParams, PlatformDomain, PlatformTenants, PlatformUsers, ProductDomain, type ProgressConfig, RateLimitError, type RatingConfig, type ReinforceResponse, type ReinforcementEvent, type RelationConfig, type RelationValue, type RequestOptions, type ResourceManifest, type SendMessageParams, type SendTemplateParams, type ServiceConfig, type ServiceConfigGlobal, type ServiceConfigPerProduct, type SortRule, type StartOnboardingPayload, type StartOnboardingResponse, StorageInfra, type StoredFieldValue, type SuggestionEvent, type TagsConfig, type Template, type TemplateApiResponse, type TemplateBinding, type TemplateBindingSource, type TemplateComponent, type TemplateEmptyPolicy, type TemplateMapping, type TextConfig, type UpsertLeadParams, type UrlConfig, type VerifyPayload, type ViewConfig, type Vocabulary, WhatsAppConnect, type WorkspaceDashboardLayout, type WorkspaceDefaultAutomation, type WorkspaceDefaultField, type WorkspaceDefaultPipeline, type WorkspaceModuleConfig, type WorkspaceProfile, ECODrIxAPI as default, getErrorDetails, getRetryConfig, handleAPIError, isAPIError };