@graph8/sdk 0.2.1 → 0.4.0

package/dist/react.d.ts

@@ -2,6 +2,454 @@ import * as _jitsu_js from '@jitsu/js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 
+/**
+ * Inbox channel — `email`, `sms`, or `linkedin` (HeyReach internally).
+ * Defaults to `email` on routes that accept this as a query param.
+ */
+type InboxChannel = "email" | "sms" | "linkedin";
+interface InboxContact {
+    name?: string | null;
+    email?: string | null;
+    company?: string | null;
+    [key: string]: unknown;
+}
+interface InboxTag {
+    id: string;
+    name: string;
+}
+interface InboxAssignee {
+    email: string;
+    name?: string | null;
+    [key: string]: unknown;
+}
+interface InboxMessage {
+    message_id: string | null;
+    from_address: string | null;
+    to_addresses: string[];
+    content: string | null;
+    /** "USER", "AI", or "OTHER". */
+    responder: string | null;
+    date: string | null;
+    is_draft: boolean;
+}
+interface InboxThread {
+    id: string;
+    /** "email", "sms", or "linkedin". */
+    channel: string;
+    subject: string | null;
+    contact: InboxContact | null;
+    messages: InboxMessage[];
+    /** "open", "responded", "ai_responded", etc. */
+    status: string | null;
+    tags: InboxTag[];
+    assignees: InboxAssignee[];
+    created_at: string | null;
+    updated_at: string | null;
+}
+interface InboxListParams {
+    channel?: InboxChannel;
+    sequence_id?: string;
+    /** Filter by thread status (e.g. "open", "responded", "ai_responded"). */
+    status?: string;
+    /** Filter by assignee email. */
+    assignee?: string;
+    /** Filter by tag ID. */
+    tag?: string;
+    page?: number;
+    /** Default 50, max 100. */
+    page_size?: number;
+}
+interface InboxAssignResult {
+    assigned: boolean;
+    assignee: string;
+    count: number;
+    [key: string]: unknown;
+}
+interface InboxTagResult {
+    tagged: boolean;
+    tag_count: number;
+    [key: string]: unknown;
+}
+interface InboxDraft {
+    /** HTML body. */
+    content: string;
+    /** Plain-text alternative, if available. */
+    plain_content: string | null;
+    /** Credits charged for AI generation. */
+    credits_charged: number;
+}
+interface InboxSendParams {
+    body: string;
+    channel: InboxChannel;
+    subject?: string;
+    /** Recipient override — email, phone, or LinkedIn ID. */
+    to?: string;
+    /** Sender override — mailbox email, Twilio number, or LinkedIn account ID. */
+    from_address?: string;
+}
+interface InboxSendResult {
+    message_id: string | null;
+    status: string;
+    channel: string;
+}
+/**
+ * Inbox API — read + reply to multi-channel inbox threads (email, SMS, LinkedIn/HeyReach).
+ * Requires API key (server-side).
+ *
+ * Backed by:
+ *   GET   /api/v1/inbox
+ *   GET   /api/v1/inbox/{reply_id}
+ *   POST  /api/v1/inbox/{reply_id}/assign
+ *   POST  /api/v1/inbox/{reply_id}/tag
+ *   GET   /api/v1/inbox/{reply_id}/draft     (charges credits, 402 on insufficient balance)
+ *   POST  /api/v1/inbox/{reply_id}/send
+ */
+declare const createInboxClient: (apiKey: string, apiUrl?: string) => {
+    /** List inbox threads across email, SMS, and LinkedIn. */
+    list(params?: InboxListParams): Promise<{
+        data: InboxThread[];
+    }>;
+    /** Get a single inbox thread. Defaults to email channel. */
+    get(replyId: string, channel?: InboxChannel): Promise<InboxThread>;
+    /** Assign a user to an inbox thread. */
+    assign(replyId: string, assigneeEmail: string, channel?: InboxChannel): Promise<InboxAssignResult>;
+    /** Attach tag IDs to an inbox thread. */
+    tag(replyId: string, tagIds: string[], channel?: InboxChannel): Promise<InboxTagResult>;
+    /**
+     * Generate an AI draft reply for a thread.
+     * Charges credits — server returns 402 if balance is insufficient.
+     */
+    draft(replyId: string, channel?: InboxChannel): Promise<InboxDraft>;
+    /** Send a reply through email, SMS, or LinkedIn. */
+    send(replyId: string, payload: InboxSendParams): Promise<InboxSendResult>;
+};
+
+interface Deal {
+    id: string | null;
+    name: string | null;
+    description: string | null;
+    amount: number | null;
+    currency: string | null;
+    stage_id: string | null;
+    stage_name: string | null;
+    pipeline_id: string | null;
+    /** Linked company ID (mashup_company_id), if any. */
+    company_id: number | string | null;
+    owner_id: string | null;
+    /** ISO 8601 date. */
+    close_date: string | null;
+    created_at: string | null;
+    updated_at: string | null;
+}
+interface DealCreateParams {
+    name: string;
+    /** Linked company ID. */
+    company_id?: number;
+    description?: string;
+    amount?: number;
+    /** Default: "USD". */
+    currency?: string;
+    /** Stage ID from the org's pipelines. Defaults to first stage of default pipeline if omitted. */
+    stage_id?: string;
+    /** Pipeline ID. Defaults to org's default pipeline if omitted. */
+    pipeline_id?: string;
+    /** ISO 8601 close date. */
+    close_date?: string;
+}
+interface DealUpdateParams {
+    name?: string;
+    description?: string;
+    amount?: number;
+    currency?: string;
+    stage_id?: string;
+    /** ISO 8601 close date. */
+    close_date?: string;
+}
+interface DealListParams {
+    page?: number;
+    limit?: number;
+    stage_id?: string;
+    pipeline_id?: string;
+    /** Substring search on deal name. */
+    search?: string;
+}
+interface PipelineStage {
+    id: string;
+    name: string;
+    probability: number | null;
+    position: number | null;
+    stage_type: string | null;
+    color: string | null;
+    required_elements: string[];
+    recommended_elements: string[];
+    channel_scripts: Record<string, string>;
+}
+interface Pipeline {
+    id: string;
+    name: string;
+    is_default: boolean;
+    stages: PipelineStage[];
+}
+/** Trimmed deal shape returned by /contacts/{id}/deals and /companies/{id}/deals. */
+interface ContactDeal {
+    deal_id: string | null;
+    name: string | null;
+    stage: string | null;
+    value: number | null;
+    currency: string | null;
+    role: string | null;
+    pipeline_id: string | null;
+    close_date: string | null;
+    owner_id: string | null;
+    created_at: string | null;
+}
+interface PaginationMeta$1 {
+    page: number;
+    limit: number;
+    total: number;
+    has_next: boolean;
+}
+/**
+ * Deals API - CRUD for deals + pipelines. Requires API key (server-side).
+ *
+ * Backed by:
+ *   GET    /api/v1/deals/pipelines
+ *   GET    /api/v1/deals
+ *   POST   /api/v1/deals
+ *   GET    /api/v1/deals/{deal_id}
+ *   PATCH  /api/v1/deals/{deal_id}
+ *   DELETE /api/v1/deals/{deal_id}
+ *   GET    /api/v1/contacts/{contact_id}/deals
+ *   GET    /api/v1/companies/{company_id}/deals
+ */
+declare const createDealsClient: (apiKey: string, apiUrl?: string) => {
+    /** List all deal pipelines and their stages. */
+    pipelines(): Promise<{
+        data: Pipeline[];
+    }>;
+    /** List deals org-wide with optional filters and pagination. */
+    list(params?: DealListParams): Promise<{
+        data: Deal[];
+        pagination?: PaginationMeta$1;
+    }>;
+    /** Create a new deal. */
+    create(deal: DealCreateParams): Promise<Deal>;
+    /** Get a single deal by ID. */
+    get(dealId: string): Promise<Deal>;
+    /** Update a deal (partial). */
+    update(dealId: string, fields: DealUpdateParams): Promise<Deal>;
+    /** Delete a deal. */
+    delete(dealId: string): Promise<{
+        data: {
+            deleted: boolean;
+        };
+    }>;
+    /** Get all deals associated with a contact. */
+    forContact(contactId: number): Promise<{
+        data: ContactDeal[];
+    }>;
+    /** Get all deals associated with a company. */
+    forCompany(companyId: number): Promise<{
+        data: ContactDeal[];
+    }>;
+};
+
+/** A field (column) definition on contacts or companies — base or custom. */
+interface Field {
+    id: number | null;
+    title: string;
+    /** Internal column name (slug). */
+    name: string | null;
+    /** Currently only "text" is supported; other types may be added later. */
+    data_type: string;
+    /** True if available org-wide, false if list-specific. */
+    is_global: boolean;
+}
+/** Created custom field (column). */
+interface CreatedField {
+    id: number;
+    title: string;
+    data_type: string;
+    name: string;
+    list_id: number | null;
+    is_global: boolean;
+}
+interface FieldCreateParams {
+    title: string;
+    /** "contacts" or "companies". Defaults to "contacts" on the backend. */
+    entity?: "contacts" | "companies";
+    /** "text" (default) — additional types may be added later. */
+    data_type?: string;
+    /** If set, the field is list-specific. Omit for org-wide global field. */
+    list_id?: number;
+}
+interface FieldDeleteParams {
+    entity?: "contacts" | "companies";
+    /**
+     * Optional list scope guard. If provided, the column must belong to this
+     * list or the request returns 404. Use this to prevent accidentally
+     * deleting a column on a different list in the same org.
+     */
+    list_id?: number;
+}
+interface SetFieldValueParams {
+    /** Contact ID (entity='contacts') or company ID (entity='companies'). */
+    record_id: number;
+    /** Value to write. Pass null/undefined to clear the field. */
+    value?: string | null;
+    entity?: "contacts" | "companies";
+}
+/**
+ * Fields API - manage custom fields (columns) on contacts and companies.
+ * Requires API key (server-side).
+ *
+ * Backed by:
+ *   GET    /api/v1/fields                — list contact fields
+ *   GET    /api/v1/fields/companies      — list company fields
+ *   POST   /api/v1/fields                — create a custom field
+ *   DELETE /api/v1/fields/{column_id}    — delete a custom field
+ *   PATCH  /api/v1/fields/{column_id}/values — set value on a single record
+ */
+declare const createFieldsClient: (apiKey: string, apiUrl?: string) => {
+    /** List contact fields (base + custom). Pass listId to include list-specific custom fields. */
+    listContactFields(listId?: number): Promise<{
+        data: Field[];
+    }>;
+    /** List company fields (base + custom). Pass listId to include list-specific custom fields. */
+    listCompanyFields(listId?: number): Promise<{
+        data: Field[];
+    }>;
+    /** Create a custom field on contacts (default) or companies. */
+    create(params: FieldCreateParams): Promise<CreatedField>;
+    /** Delete a custom field (soft-delete). Pass list_id to scope-guard against cross-list deletion. */
+    delete(columnId: number, params?: FieldDeleteParams): Promise<{
+        data: {
+            column_id: number;
+            deleted: boolean;
+        };
+    }>;
+    /** Set a custom field value on a single contact or company row. Pass value=null to clear. */
+    setValue(columnId: number, params: SetFieldValueParams): Promise<{
+        data: {
+            column_id: number;
+            record_id: number;
+            updated: boolean;
+        };
+    }>;
+};
+
+interface Task {
+    id: string;
+    entity_type: string | null;
+    entity_id: string | null;
+    title: string;
+    description: string | null;
+    due_date: string | null;
+    assignee_id: string | null;
+    assignee_name: string | null;
+    /** "open" | "completed" (other values may appear if the backend adds states later) */
+    status: string | null;
+    /** 0=none, 1=urgent, 2=high, 3=normal, 4=low */
+    priority: number | null;
+    task_type: string | null;
+    created_by: string | null;
+    created_at: string | null;
+    updated_at: string | null;
+}
+interface TaskCreateParams {
+    title: string;
+    description?: string;
+    /** ISO 8601 date string. */
+    due_date?: string;
+    assignee_id?: string;
+    /** 0=none, 1=urgent, 2=high, 3=normal, 4=low */
+    priority?: number;
+}
+interface TaskUpdateParams {
+    title?: string;
+    description?: string;
+    due_date?: string;
+    assignee_id?: string;
+    /** "open" | "completed" */
+    status?: string;
+    priority?: number;
+}
+interface TaskListParams {
+    /** "open" | "completed" */
+    status?: string;
+    /** 0-4 */
+    priority?: number;
+    assignee_id?: string;
+    /** Substring search on title. */
+    search?: string;
+}
+/**
+ * Tasks API - CRUD for tasks attached to contacts. Requires API key (server-side).
+ *
+ * Backed by:
+ *   GET    /api/v1/contacts/{contact_id}/tasks
+ *   GET    /api/v1/tasks
+ *   POST   /api/v1/contacts/{contact_id}/tasks
+ *   PATCH  /api/v1/tasks/{task_id}
+ *   DELETE /api/v1/tasks/{task_id}
+ */
+declare const createTasksClient: (apiKey: string, apiUrl?: string) => {
+    /** List tasks on a single contact. Optional status filter ("open" | "completed"). */
+    listForContact(contactId: number, status?: string): Promise<{
+        data: Task[];
+    }>;
+    /** List all tasks org-wide with optional filters. */
+    list(params?: TaskListParams): Promise<{
+        data: Task[];
+    }>;
+    /** Create a task on a contact. */
+    create(contactId: number, task: TaskCreateParams): Promise<Task>;
+    /** Update a task (partial). */
+    update(taskId: string, fields: TaskUpdateParams): Promise<Task>;
+    /** Delete a task. */
+    delete(taskId: string): Promise<{
+        data: {
+            deleted: boolean;
+        };
+    }>;
+};
+
+interface Note {
+    id: string;
+    entity_type: string;
+    entity_id: string;
+    content: string;
+    created_by: string | null;
+    created_by_name: string | null;
+    created_at: string | null;
+    updated_at: string | null;
+}
+/**
+ * Notes API - CRUD for notes attached to contacts. Requires API key (server-side).
+ *
+ * Backed by:
+ *   GET    /api/v1/contacts/{contact_id}/notes
+ *   POST   /api/v1/contacts/{contact_id}/notes
+ *   PATCH  /api/v1/notes/{note_id}
+ *   DELETE /api/v1/notes/{note_id}
+ */
+declare const createNotesClient: (apiKey: string, apiUrl?: string) => {
+    /** List all notes on a contact. */
+    list(contactId: number): Promise<{
+        data: Note[];
+    }>;
+    /** Create a note on a contact. */
+    create(contactId: number, content: string): Promise<Note>;
+    /** Update a note's content. */
+    update(noteId: string, content: string): Promise<Note>;
+    /** Delete a note. */
+    delete(noteId: string): Promise<{
+        data: {
+            deleted: boolean;
+        };
+    }>;
+};
+
 interface ContactList {
     id: number;
     title: string;
@@ -86,6 +534,25 @@ interface CompanyContact {
     work_email: string | null;
     job_title: string | null;
 }
+/** A column definition on companies (base or custom). */
+interface CompanyColumn {
+    id: number | null;
+    title: string;
+    data_type: string;
+    name: string | null;
+    /** Stringified list_id when list-scoped, otherwise null/empty for global. */
+    object_id: string | null;
+    is_global: boolean;
+}
+interface CompanyColumnCreateParams {
+    title: string;
+    /** Email of the user creating the column. Required by the backend (audit). */
+    created_by: string;
+    /** "text" (default) — additional types may be added later. */
+    data_type?: string;
+    /** If set, the column is list-specific. Omit for org-wide global column. */
+    list_id?: number;
+}
 /**
  * Companies API - search and manage CRM companies. Requires API key (server-side).
  */
@@ -110,6 +577,12 @@ declare const createCompaniesClient: (apiKey: string, apiUrl?: string) => {
     delete(companyId: number): Promise<{
         deleted: boolean;
     }>;
+    /** List custom company columns. Pass listId to include list-specific columns. */
+    listColumns(listId?: number): Promise<{
+        data: CompanyColumn[];
+    }>;
+    /** Create a custom company column. Global if list_id is omitted, list-scoped otherwise. */
+    createColumn(params: CompanyColumnCreateParams): Promise<CompanyColumn>;
 };
 
 interface Contact {
@@ -166,6 +639,25 @@ interface ContactUpdateParams {
     state?: string;
     country?: string;
 }
+/** A column definition on contacts (base or custom). */
+interface ContactColumn {
+    id: number | null;
+    title: string;
+    data_type: string;
+    name: string | null;
+    /** Stringified list_id when list-scoped, otherwise null/empty for global. */
+    object_id: string | null;
+    is_global: boolean;
+}
+interface ContactColumnCreateParams {
+    title: string;
+    /** Email of the user creating the column. Required by the backend (audit). */
+    created_by: string;
+    /** "text" (default) — additional types may be added later. */
+    data_type?: string;
+    /** If set, the column is list-specific. Omit for org-wide global column. */
+    list_id?: number;
+}
 /**
  * Contacts API - full CRUD for CRM contacts. Requires API key (server-side).
  */
@@ -187,6 +679,12 @@ declare const createContactsClient: (apiKey: string, apiUrl?: string) => {
     delete(contactId: number): Promise<{
         deleted: boolean;
     }>;
+    /** List custom contact columns. Pass listId to include list-specific columns. */
+    listColumns(listId?: number): Promise<{
+        data: ContactColumn[];
+    }>;
+    /** Create a custom contact column. Global if list_id is omitted, list-scoped otherwise. */
+    createColumn(params: ContactColumnCreateParams): Promise<ContactColumn>;
 };
 
 type WebhookEvent = "reply_received" | "meeting_booked" | "contact_enriched" | "contact_created" | "sequence_completed" | "sequence_replied" | "campaign_launched" | "form_submitted" | "visitor_identified";
@@ -248,20 +746,276 @@ interface CallAnalysis {
 }
 type VoiceEvent = "connected" | "transcription" | "ended" | "error";
 type VoiceCallback = (data: Record<string, unknown>) => void;
+interface VoicePagination {
+    total_items: number;
+    total_pages: number;
+    current_page: number;
+    page_size: number;
+}
+interface DialerSessionSummary {
+    session_id: string;
+    status: string | null;
+    user_id: string | null;
+    user_email: string | null;
+    org_id: string | null;
+    from_phone: string | null;
+    campaign_id: string | null;
+    campaign_builder_campaign_id: string | null;
+    name: string | null;
+    session_metadata: Record<string, unknown> | null;
+    total_calls: number | null;
+    created_at: string | null;
+    updated_at: string | null;
+    contact_ids: unknown[];
+}
+interface DialerSessionsListResult {
+    sessions: DialerSessionSummary[];
+    pagination: VoicePagination;
+}
+interface DialerSessionsListParams {
+    page?: number;
+    /** Default 50, max 200. */
+    page_size?: number;
+    /** Comma-separated status list (e.g. "ACTIVE,PAUSED"). */
+    status?: string;
+    user_email?: string;
+    /** Substring search on session name. */
+    name?: string;
+    campaign_id?: string;
+    list_id?: string;
+    list_name?: string;
+    /** ISO 8601 timestamp. */
+    date_from?: string;
+    /** ISO 8601 timestamp. */
+    date_to?: string;
+    sort_by?: string;
+    /** Default "desc". */
+    sort_order?: "asc" | "desc";
+}
+interface DialerStatsParams {
+    session_id?: string;
+    user_email?: string;
+    /** YYYY-MM-DD. */
+    date_from?: string;
+    /** YYYY-MM-DD. */
+    date_to?: string;
+    /** Default "DAILY". */
+    aggregation?: "DAILY" | "TOTAL";
+}
+interface DialerReportFilters {
+    session_id: string | null;
+    user_email: string | null;
+    org_id: string | null;
+    date_from: string | null;
+    date_to: string | null;
+    aggregation: string | null;
+}
+interface DialerReportMetric {
+    date: string | null;
+    sdr_name: string | null;
+    org_id: string | null;
+    list_title: string | null;
+    total_dials: number;
+    total_connections: number;
+    connection_rate: number;
+    total_voicemails: number;
+    voicemail_rate: number;
+    talk_time_minutes: number;
+    avg_call_duration_minutes: number;
+    dispositions: Record<string, unknown> | null;
+    success_rate: number;
+    unique_sessions: number;
+    avg_calls_per_session: number;
+    redial_count: number;
+    redial_success_rate: number | null;
+    peak_calling_hour: number | null;
+    total_callbacks: number;
+}
+interface DialerStatsResult {
+    filters: DialerReportFilters;
+    metrics: DialerReportMetric[];
+    summary: DialerReportMetric | null;
+}
+interface DialerNumberInfo {
+    number: string;
+    /** Default "ai". */
+    inbound_type: string;
+    /** Default "twilio". */
+    telephony_provider: string;
+    calls_today: number;
+    calls_7d: number;
+    connect_rate_7d: number;
+    is_valid: boolean;
+    daily_limit: number;
+    assigned_to: string | null;
+    created_at: string | null;
+}
+interface DialerNumbersListResult {
+    numbers: DialerNumberInfo[];
+}
+interface MissedCallback {
+    id: string | number | null;
+    caller_phone: string | null;
+    inbound_number: string | null;
+    first_name: string | null;
+    last_name: string | null;
+    email: string | null;
+    contact_id: string | number | null;
+    parallel_session_id: string | null;
+    created_at: string | null;
+    call_duration: number | null;
+    is_callback: boolean;
+}
+interface MissedCallbacksResult {
+    missed_callbacks: MissedCallback[];
+    count: number;
+}
+interface CallGradingResult {
+    room_name: string;
+    /** "ready" or "pending". */
+    status: string;
+    grading: Record<string, unknown> | null;
+    reviewed: boolean;
+    reviewed_at: string | null;
+}
+interface DialerAgentSummary {
+    agent_id: string;
+    agent_name: string | null;
+    /** "SDR", etc. */
+    role: string | null;
+    agent_status: string | null;
+    /** "agent" or "twin". */
+    entity_type: string | null;
+    description: string | null;
+    phone: string | null;
+    is_template: boolean;
+}
+interface DialerAgentsListResult {
+    agents: DialerAgentSummary[];
+    total_count: number;
+}
+interface DialerAgentsListParams {
+    /** e.g. "SDR". */
+    role?: string;
+    agent_status?: string;
+    /** "agent" or "twin". */
+    entity_type?: "agent" | "twin";
+    /** Substring filter on name/description. */
+    search?: string;
+}
+interface DialerSessionCreateParams {
+    /** 1-200 chars. */
+    name: string;
+    /** Org's dialer phone (E.164, 9-16 chars). */
+    from_phone: string;
+    /** Contact list ID (stored in session metadata). */
+    list_id?: string;
+    /** Display title for the source list. */
+    list_title?: string;
+    /** V2 agent UUID. */
+    agent_id?: string;
+    /** V1 fallback name. Defaults to "default_agent". */
+    agent_name?: string;
+    /** "agent" or "twin". */
+    entity_type?: "agent" | "twin";
+    /** Campaign Builder UUID. */
+    studio_campaign_id?: string;
+    /** IANA timezone (e.g. "America/New_York"). */
+    user_timezone?: string;
+    /** Per-session voicemail-skip override. null/omit = use SDR default. */
+    skip_voicemails?: boolean;
+}
+interface DialerSessionCreateResult {
+    session_id: string;
+    status: string;
+    name: string | null;
+    org_id: string | null;
+    user_id: string | null;
+    user_email: string | null;
+    from_phone: string | null;
+    session_metadata: Record<string, unknown> | null;
+    total_calls: number;
+    created_at: string | null;
+    message: string | null;
+}
+/** "ACTIVE" resumes, "PAUSED" pauses, "COMPLETED" stops. "FAILED" is rejected. */
+type DialerSessionStatus = "ACTIVE" | "PAUSED" | "COMPLETED";
+interface DialerSessionStatusUpdateResult {
+    session_id: string;
+    status: string;
+    message: string | null;
+    name: string | null;
+    org_id: string | null;
+    user_id: string | null;
+    user_email: string | null;
+    from_phone: string | null;
+    session_metadata: Record<string, unknown> | null;
+    total_calls: number;
+    created_at: string | null;
+    updated_at: string | null;
+}
+interface DialerSessionResumeResult extends DialerSessionStatusUpdateResult {
+    /** Contacts actually placed in this batch (voice caps at 4). */
+    dialed_count: number;
+}
 /**
- * Voice AI - start AI voice calls, get transcriptions and analysis. Requires API key.
+ * Voice AI — start AI voice calls, get transcriptions and analysis.
+ * Plus full parallel-dialer session control via the `dialer` namespace.
+ * Requires API key (server-side).
+ *
+ * Backed by:
+ *   GET    /api/v1/voice/dialer/sessions
+ *   POST   /api/v1/voice/dialer/sessions
+ *   PATCH  /api/v1/voice/dialer/sessions/{session_id}/status
+ *   POST   /api/v1/voice/dialer/sessions/{session_id}/resume
+ *   GET    /api/v1/voice/dialer/stats
+ *   GET    /api/v1/voice/dialer/numbers
+ *   GET    /api/v1/voice/dialer/missed-callbacks
+ *   GET    /api/v1/voice/dialer/calls/{room_name}/grading
+ *   GET    /api/v1/voice/dialer/agents
  */
 declare const createVoiceClient: (apiKey: string, apiUrl?: string) => {
-    /** Start an AI voice session. */
+    /**
+     * Start an AI voice session.
+     * @deprecated Preview surface — for parallel-dialer flows use `voice.dialer.createSession()`.
+     */
     start(config: {
         agent?: string;
         contactId?: number;
         context?: Record<string, unknown>;
     }): Promise<VoiceSession>;
-    /** Get call analysis for a completed session. */
+    /**
+     * Get call analysis for a completed session.
+     * @deprecated Preview surface — for dialer-call grading use `voice.dialer.callGrading(roomName)`.
+     */
     analysis(sessionId: string): Promise<CallAnalysis>;
     /** Listen for voice events. */
     on(event: VoiceEvent, callback: VoiceCallback): void;
+    /** Parallel-dialer session control + analytics. */
+    dialer: {
+        /** List parallel-dialer sessions with filters + pagination. */
+        listSessions(params?: DialerSessionsListParams): Promise<DialerSessionsListResult>;
+        /** Create a parallel-dialer session in PAUSED state. SDR opens UI to start dialing. */
+        createSession(payload: DialerSessionCreateParams): Promise<DialerSessionCreateResult>;
+        /** Pause / resume / stop a dialer session via status flip. */
+        updateSessionStatus(sessionId: string, status: DialerSessionStatus): Promise<DialerSessionStatusUpdateResult>;
+        /**
+         * Resume a PAUSED dialer session. Auto-fetches the next batch from the source list,
+         * filters already-called + phoneless rows, and forwards to voice's start-session.
+         * @param maxContacts 1-4 (voice caps parallel dialing at 4). Default 4.
+         */
+        resumeSession(sessionId: string, maxContacts?: number): Promise<DialerSessionResumeResult>;
+        /** Aggregated dialer analytics (daily breakdown or total). */
+        stats(params?: DialerStatsParams): Promise<DialerStatsResult>;
+        /** List dialer-eligible phone numbers with 7-day stats + daily limits. */
+        numbers(userEmail?: string): Promise<DialerNumbersListResult>;
+        /** List missed inbound callbacks with caller / contact info. */
+        missedCallbacks(limit?: number): Promise<MissedCallbacksResult>;
+        /** AI grading for a single dialer call (returns "pending" while in progress). */
+        callGrading(roomName: string): Promise<CallGradingResult>;
+        /** List voice agents available for dialer sessions (capped at 100; no pagination). */
+        agents(params?: DialerAgentsListParams): Promise<DialerAgentsListResult>;
+    };
 };
 
 interface AnalyticsOverview {
@@ -352,24 +1106,210 @@ declare const createCampaignsClient: (apiKey: string, apiUrl?: string) => {
     stats(campaignId: string): Promise<CampaignStats>;
 };
 
-interface Sequence {
-    id: string;
-    name: string;
-    status: string;
-    step_count: number | null;
-    contact_count: number | null;
-}
 interface AddToSequenceConfig {
     sequenceId: string;
     contactIds: number[];
     listId: number;
 }
+interface SequenceListItem {
+    id: string;
+    name: string | null;
+    status: string | null;
+    user_email: string | null;
+    step_count: number | null;
+    contact_count: number | null;
+    sequence_kind: string | null;
+    associated_list_id: number | null;
+    created_at: string | null;
+    updated_at: string | null;
+}
+interface SequenceListParams {
+    page?: number;
+    limit?: number;
+    /** Filter by sequence status (e.g. "live", "draft", "paused"). */
+    status?: string;
+}
+interface SequenceDetail {
+    id: string;
+    name: string | null;
+    description: string | null;
+    status: string | null;
+    user_email: string | null;
+    associated_list_id: number | null;
+    finish_on_reply: boolean;
+    send_in_same_thread: boolean;
+    wait_for_new_contacts: boolean;
+    paused_at: string | null;
+    resumed_at: string | null;
+    created_at: string | null;
+    updated_at: string | null;
+}
+interface SequenceContactItem {
+    id: string | null;
+    contact_id: number | null;
+    state: string | null;
+    current_step_order: number | null;
+    created_at: string | null;
+    updated_at: string | null;
+}
+interface SequenceContactsParams {
+    page?: number;
+    limit?: number;
+    /** Filter by contact state (e.g. "active", "completed", "replied"). */
+    state?: string;
+}
+interface SequenceActionResult {
+    sequence_id: string;
+    status: string;
+    contacts_affected: number;
+}
 /**
- * Sequences - manage outbound sequences. Requires API key (server-side).
+ * Step type. Note: LinkedIn flows use "HEYREACH" — there is no "LINKEDIN" step type.
+ * Server is case-insensitive on input but stores uppercase.
+ */
+type SequenceStepType = "EMAIL" | "PHONE" | "SMS" | "WHATSAPP" | "HEYREACH" | "MANUAL_DIALER";
+type SequenceStepInputType = "ON_DEMAND" | "MANUAL_TEMPLATE" | "AI_GENERATED_TEMPLATE";
+interface SequenceStepConfig {
+    step_order: number;
+    step_type: SequenceStepType | string;
+    /** Defaults to "ON_DEMAND". */
+    input_type?: SequenceStepInputType | string;
+    /** Wait time before this step in seconds. Defaults to 0. */
+    time_interval?: number;
+    /** Template body, AI prompt, or other step-type-specific config. */
+    step_data?: Record<string, unknown>;
+}
+interface SequenceChannelConfig {
+    channel_id: number;
+    channel_value: string;
+    channel_type: string;
+    channel_data?: Record<string, unknown>;
+}
+interface SequenceCreateParams {
+    name: string;
+    user_email: string;
+    description?: string;
+    finish_on_reply?: boolean;
+    send_in_same_thread?: boolean;
+    wait_for_new_contacts?: boolean;
+    associated_list_id?: number;
+    steps?: SequenceStepConfig[];
+    channels?: SequenceChannelConfig[];
+    campaign_id?: string;
+}
+interface SequenceCreateResult {
+    id: string;
+    name: string;
+    status: string;
+    created_at: string | null;
+}
+interface SequenceUpdateParams {
+    name?: string;
+    description?: string;
+    is_shared?: boolean;
+    finish_on_reply?: boolean;
+    send_in_same_thread?: boolean;
+    wait_for_new_contacts?: boolean;
+    schedule_id?: string;
+    appointment_id?: number;
+}
+interface SequenceStepUpdateParams {
+    step_data?: Record<string, unknown>;
+    time_interval?: number;
+    step_type?: SequenceStepType | string;
+    input_type?: SequenceStepInputType | string;
+}
+interface SequencePreviewStep {
+    id: string;
+    step_order: number;
+    step_type: string;
+    input_type: string;
+    time_interval: number | null;
+    step_data: Record<string, unknown> | null;
+}
+interface SequencePreviewChannel {
+    id: string;
+    channel_id: number | null;
+    channel_value: string | null;
+    channel_type: string | null;
+}
+interface SequencePreview {
+    id: string;
+    name: string | null;
+    status: string | null;
+    description: string | null;
+    steps: SequencePreviewStep[];
+    channels: SequencePreviewChannel[];
+}
+interface SequenceAnalytics {
+    overview: Record<string, unknown>;
+    performance: Record<string, unknown>;
+    engagement: Record<string, unknown>;
+    timeline: Record<string, unknown>[];
+    contact_distribution: Record<string, unknown>;
+    step_breakdown: Record<string, unknown>[];
+    step_creation_methods: Record<string, unknown>[];
+    sender_distribution: Record<string, unknown>[];
+}
+interface PaginationMeta {
+    page: number;
+    limit: number;
+    total: number;
+    has_next: boolean;
+}
+/**
+ * Sequences API — list, create, run, pause, update, analyze multi-channel sequences.
+ * Requires API key (server-side).
+ *
+ * Backed by:
+ *   GET    /api/v1/sequences
+ *   POST   /api/v1/sequences
+ *   GET    /api/v1/sequences/{sequence_id}
+ *   PATCH  /api/v1/sequences/{sequence_id}
+ *   DELETE /api/v1/sequences/{sequence_id}
+ *   GET    /api/v1/sequences/{sequence_id}/contacts
+ *   POST   /api/v1/sequences/{sequence_id}/contacts
+ *   POST   /api/v1/sequences/{sequence_id}/run
+ *   POST   /api/v1/sequences/{sequence_id}/pause
+ *   POST   /api/v1/sequences/{sequence_id}/resume
+ *   PATCH  /api/v1/sequences/{sequence_id}/steps/{step_id}
+ *   GET    /api/v1/sequences/{sequence_id}/preview
+ *   GET    /api/v1/sequences/{sequence_id}/analytics
  */
 declare const createSequencesClient: (apiKey: string, apiUrl?: string) => {
-    list(page?: number, limit?: number): Promise<Sequence[]>;
-    add(config: AddToSequenceConfig): Promise<void>;
+    /** List sequences with pagination + optional status filter. */
+    list: {
+        (): Promise<SequenceListItem[]>;
+        (page: number, limit?: number): Promise<SequenceListItem[]>;
+        (params: SequenceListParams): Promise<SequenceListItem[]>;
+    };
+    /** Get full sequence details by ID. */
+    get(sequenceId: string): Promise<SequenceDetail>;
+    /** List contacts enrolled in a sequence. Filter by state (e.g. "active", "replied"). */
+    contacts(sequenceId: string, params?: SequenceContactsParams): Promise<{
+        data: SequenceContactItem[];
+        pagination?: PaginationMeta;
+    }>;
+    /** Add contacts to a sequence (V2 queuing). Live or drafted sequences only. */
+    add(config: AddToSequenceConfig): Promise<SequenceActionResult>;
+    /** Create a new sequence with optional steps + channels. */
+    create(payload: SequenceCreateParams): Promise<SequenceCreateResult>;
+    /** Update sequence metadata. Rejected (409) if sequence is in a transitional status. */
+    update(sequenceId: string, fields: SequenceUpdateParams): Promise<SequenceActionResult>;
+    /** Update a single step within a sequence. */
+    updateStep(sequenceId: string, stepId: string, fields: SequenceStepUpdateParams): Promise<SequenceActionResult>;
+    /** Soft-delete (archive) a sequence. */
+    delete(sequenceId: string): Promise<SequenceActionResult>;
+    /** Run/start a DRAFTED sequence (V2 orchestration). */
+    run(sequenceId: string): Promise<SequenceActionResult>;
+    /** Pause a live sequence. */
+    pause(sequenceId: string): Promise<SequenceActionResult>;
+    /** Resume a paused sequence. */
+    resume(sequenceId: string): Promise<SequenceActionResult>;
+    /** Read-only sequence preview with all steps + channels (no enrollment). */
+    preview(sequenceId: string): Promise<SequencePreview>;
+    /** Comprehensive analytics for a sequence. */
+    analytics(sequenceId: string): Promise<SequenceAnalytics>;
 };
 
 interface PersonEnrichment {
@@ -696,6 +1636,11 @@ declare const useG8: () => {
         _contacts: ReturnType<typeof createContactsClient> | null;
         _companies: ReturnType<typeof createCompaniesClient> | null;
         _lists: ReturnType<typeof createListsClient> | null;
+        _notes: ReturnType<typeof createNotesClient> | null;
+        _tasks: ReturnType<typeof createTasksClient> | null;
+        _fields: ReturnType<typeof createFieldsClient> | null;
+        _deals: ReturnType<typeof createDealsClient> | null;
+        _inbox: ReturnType<typeof createInboxClient> | null;
         init(config: G8Config): void;
         track(event: string, properties?: TrackProperties): void;
         identify(userId: string, properties?: IdentifyProperties): void;
@@ -749,8 +1694,26 @@ declare const useG8: () => {
             search(filters: SearchFilter[], page?: number, limit?: number): Promise<SearchResults>;
         };
         get sequences(): {
-            list(page?: number, limit?: number): Promise<Sequence[]>;
-            add(config: AddToSequenceConfig): Promise<void>;
+            list: {
+                (): Promise<SequenceListItem[]>;
+                (page: number, limit?: number): Promise<SequenceListItem[]>;
+                (params: SequenceListParams): Promise<SequenceListItem[]>;
+            };
+            get(sequenceId: string): Promise<SequenceDetail>;
+            contacts(sequenceId: string, params?: SequenceContactsParams): Promise<{
+                data: SequenceContactItem[];
+                pagination?: PaginationMeta;
+            }>;
+            add(config: AddToSequenceConfig): Promise<SequenceActionResult>;
+            create(payload: SequenceCreateParams): Promise<SequenceCreateResult>;
+            update(sequenceId: string, fields: SequenceUpdateParams): Promise<SequenceActionResult>;
+            updateStep(sequenceId: string, stepId: string, fields: SequenceStepUpdateParams): Promise<SequenceActionResult>;
+            delete(sequenceId: string): Promise<SequenceActionResult>;
+            run(sequenceId: string): Promise<SequenceActionResult>;
+            pause(sequenceId: string): Promise<SequenceActionResult>;
+            resume(sequenceId: string): Promise<SequenceActionResult>;
+            preview(sequenceId: string): Promise<SequencePreview>;
+            analytics(sequenceId: string): Promise<SequenceAnalytics>;
         };
         get campaigns(): {
             list(page?: number, limit?: number): Promise<Campaign[]>;
@@ -784,6 +1747,17 @@ declare const useG8: () => {
             }): Promise<VoiceSession>;
             analysis(sessionId: string): Promise<CallAnalysis>;
             on(event: "error" | "ended" | "connected" | "transcription", callback: (data: Record<string, unknown>) => void): void;
+            dialer: {
+                listSessions(params?: DialerSessionsListParams): Promise<DialerSessionsListResult>;
+                createSession(payload: DialerSessionCreateParams): Promise<DialerSessionCreateResult>;
+                updateSessionStatus(sessionId: string, status: DialerSessionStatus): Promise<DialerSessionStatusUpdateResult>;
+                resumeSession(sessionId: string, maxContacts?: number): Promise<DialerSessionResumeResult>;
+                stats(params?: DialerStatsParams): Promise<DialerStatsResult>;
+                numbers(userEmail?: string): Promise<DialerNumbersListResult>;
+                missedCallbacks(limit?: number): Promise<MissedCallbacksResult>;
+                callGrading(roomName: string): Promise<CallGradingResult>;
+                agents(params?: DialerAgentsListParams): Promise<DialerAgentsListResult>;
+            };
         };
         get pages(): {
             clone(url: string): Promise<LandingPage>;
@@ -813,6 +1787,10 @@ declare const useG8: () => {
             delete(contactId: number): Promise<{
                 deleted: boolean;
             }>;
+            listColumns(listId?: number): Promise<{
+                data: ContactColumn[];
+            }>;
+            createColumn(params: ContactColumnCreateParams): Promise<ContactColumn>;
         };
         get companies(): {
             list(params?: CompanyListParams): Promise<{
@@ -830,6 +1808,10 @@ declare const useG8: () => {
             delete(companyId: number): Promise<{
                 deleted: boolean;
             }>;
+            listColumns(listId?: number): Promise<{
+                data: CompanyColumn[];
+            }>;
+            createColumn(params: CompanyColumnCreateParams): Promise<CompanyColumn>;
         };
         get lists(): {
             list(page?: number, limit?: number): Promise<{
@@ -851,6 +1833,88 @@ declare const useG8: () => {
                 removed: number;
             }>;
         };
+        get notes(): {
+            list(contactId: number): Promise<{
+                data: Note[];
+            }>;
+            create(contactId: number, content: string): Promise<Note>;
+            update(noteId: string, content: string): Promise<Note>;
+            delete(noteId: string): Promise<{
+                data: {
+                    deleted: boolean;
+                };
+            }>;
+        };
+        get tasks(): {
+            listForContact(contactId: number, status?: string): Promise<{
+                data: Task[];
+            }>;
+            list(params?: TaskListParams): Promise<{
+                data: Task[];
+            }>;
+            create(contactId: number, task: TaskCreateParams): Promise<Task>;
+            update(taskId: string, fields: TaskUpdateParams): Promise<Task>;
+            delete(taskId: string): Promise<{
+                data: {
+                    deleted: boolean;
+                };
+            }>;
+        };
+        get fields(): {
+            listContactFields(listId?: number): Promise<{
+                data: Field[];
+            }>;
+            listCompanyFields(listId?: number): Promise<{
+                data: Field[];
+            }>;
+            create(params: FieldCreateParams): Promise<CreatedField>;
+            delete(columnId: number, params?: FieldDeleteParams): Promise<{
+                data: {
+                    column_id: number;
+                    deleted: boolean;
+                };
+            }>;
+            setValue(columnId: number, params: SetFieldValueParams): Promise<{
+                data: {
+                    column_id: number;
+                    record_id: number;
+                    updated: boolean;
+                };
+            }>;
+        };
+        get deals(): {
+            pipelines(): Promise<{
+                data: Pipeline[];
+            }>;
+            list(params?: DealListParams): Promise<{
+                data: Deal[];
+                pagination?: PaginationMeta$1;
+            }>;
+            create(deal: DealCreateParams): Promise<Deal>;
+            get(dealId: string): Promise<Deal>;
+            update(dealId: string, fields: DealUpdateParams): Promise<Deal>;
+            delete(dealId: string): Promise<{
+                data: {
+                    deleted: boolean;
+                };
+            }>;
+            forContact(contactId: number): Promise<{
+                data: ContactDeal[];
+            }>;
+            forCompany(companyId: number): Promise<{
+                data: ContactDeal[];
+            }>;
+        };
+        get inbox(): {
+            list(params?: InboxListParams): Promise<{
+                data: InboxThread[];
+            }>;
+            get(replyId: string, channel?: InboxChannel): Promise<InboxThread>;
+            assign(replyId: string, assigneeEmail: string, channel?: InboxChannel): Promise<InboxAssignResult>;
+            tag(replyId: string, tagIds: string[], channel?: InboxChannel): Promise<InboxTagResult>;
+            draft(replyId: string, channel?: InboxChannel): Promise<InboxDraft>;
+            send(replyId: string, payload: InboxSendParams): Promise<InboxSendResult>;
+        };
         get initialized(): boolean;
         _assertInit(): void;
         _assertKey(module: string): void;