@graph8/sdk 0.2.1 → 0.4.0

package/dist/index.d.mts

@@ -1,5 +1,453 @@
 import { AnalyticsInterface } from '@jitsu/js';
 
+/**
+ * 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;
@@ -84,6 +532,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).
  */
@@ -108,6 +575,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 {
@@ -164,6 +637,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).
  */
@@ -185,6 +677,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";
@@ -246,20 +744,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 {
@@ -362,12 +1116,205 @@ interface AddToSequenceConfig {
     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 {
@@ -664,6 +1611,11 @@ declare class G8 {
     /** @internal */ _contacts: ReturnType<typeof createContactsClient> | null;
     /** @internal */ _companies: ReturnType<typeof createCompaniesClient> | null;
     /** @internal */ _lists: ReturnType<typeof createListsClient> | null;
+    /** @internal */ _notes: ReturnType<typeof createNotesClient> | null;
+    /** @internal */ _tasks: ReturnType<typeof createTasksClient> | null;
+    /** @internal */ _fields: ReturnType<typeof createFieldsClient> | null;
+    /** @internal */ _deals: ReturnType<typeof createDealsClient> | null;
+    /** @internal */ _inbox: ReturnType<typeof createInboxClient> | null;
     /**
      * Initialize the graph8 SDK. Must be called before any other method.
      * Safe to call on the server (SSR) - becomes a no-op for tracking.
@@ -732,8 +1684,26 @@ declare class G8 {
     };
     /** Sequences (requires API key). */
     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>;
     };
     /** Campaigns (requires API key). */
     get campaigns(): {
@@ -772,6 +1742,17 @@ declare class G8 {
         }): 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>;
+        };
     };
     /** Landing pages (requires API key). */
     get pages(): {
@@ -804,6 +1785,10 @@ declare class G8 {
         delete(contactId: number): Promise<{
             deleted: boolean;
         }>;
+        listColumns(listId?: number): Promise<{
+            data: ContactColumn[];
+        }>;
+        createColumn(params: ContactColumnCreateParams): Promise<ContactColumn>;
     };
     /** Companies CRUD (requires API key). */
     get companies(): {
@@ -822,6 +1807,10 @@ declare class G8 {
         delete(companyId: number): Promise<{
             deleted: boolean;
         }>;
+        listColumns(listId?: number): Promise<{
+            data: CompanyColumn[];
+        }>;
+        createColumn(params: CompanyColumnCreateParams): Promise<CompanyColumn>;
     };
     /** Lists management (requires API key). */
     get lists(): {
@@ -844,6 +1833,93 @@ declare class G8 {
             removed: number;
         }>;
     };
+    /** Notes on contacts (requires API key). */
+    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;
+            };
+        }>;
+    };
+    /** Tasks on contacts (requires API key). */
+    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;
+            };
+        }>;
+    };
+    /** Custom fields management (requires API key). */
+    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;
+            };
+        }>;
+    };
+    /** Deals and pipelines (requires API key). */
+    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[];
+        }>;
+    };
+    /** Multi-channel inbox — read + reply across email, SMS, LinkedIn (requires API key). */
+    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>;
+    };
     /** Whether the SDK has been initialized. */
     get initialized(): boolean;
     /** @internal */
@@ -854,4 +1930,4 @@ declare class G8 {
 /** Singleton g8 client instance. */
 declare const g8: G8;
 
-export { type AddToSequenceConfig, type AnalyticsOverview, type Booking, type BookingRequest, type CalendarConfig, type CallAnalysis, type Campaign, type CampaignCreateConfig, type CampaignStats, type ChatConfig, type Company, type CompanyContact, type CompanyEnrichment, type CompanyListParams, type CompanyUpdateParams, type Contact, type ContactCreateParams, type ContactList, type ContactListParams, type ContactUpdateParams, type CopilotConfig, type EmailVerification, type EnrichLookupResult, type G8Config, type G8PrivacyConfig, type IdentifyProperties, type Integration, type IntentSignals, type LandingPage, type ListContact, type PersonEnrichment, type SearchFilter, type SearchResults, type Sequence, type TimeSlot, type TrackProperties, type VisitorCompany, type VisitorScore, type VoiceSession, type WebhookEvent, g8 };
+export { type AddToSequenceConfig, type AnalyticsOverview, type Booking, type BookingRequest, type CalendarConfig, type CallAnalysis, type CallGradingResult, type Campaign, type CampaignCreateConfig, type CampaignStats, type ChatConfig, type Company, type CompanyColumn, type CompanyColumnCreateParams, type CompanyContact, type CompanyEnrichment, type CompanyListParams, type CompanyUpdateParams, type Contact, type ContactColumn, type ContactColumnCreateParams, type ContactCreateParams, type ContactDeal, type ContactList, type ContactListParams, type ContactUpdateParams, type CopilotConfig, type CreatedField, type Deal, type DealCreateParams, type DealListParams, type DealUpdateParams, type DialerAgentSummary, type DialerAgentsListParams, type DialerAgentsListResult, type DialerNumberInfo, type DialerNumbersListResult, type DialerReportFilters, type DialerReportMetric, type DialerSessionCreateParams, type DialerSessionCreateResult, type DialerSessionResumeResult, type DialerSessionStatus, type DialerSessionStatusUpdateResult, type DialerSessionSummary, type DialerSessionsListParams, type DialerSessionsListResult, type DialerStatsParams, type DialerStatsResult, type EmailVerification, type EnrichLookupResult, type Field, type FieldCreateParams, type FieldDeleteParams, type G8Config, type G8PrivacyConfig, type IdentifyProperties, type InboxAssignResult, type InboxAssignee, type InboxChannel, type InboxContact, type InboxDraft, type InboxListParams, type InboxMessage, type InboxSendParams, type InboxSendResult, type InboxTag, type InboxTagResult, type InboxThread, type Integration, type IntentSignals, type LandingPage, type ListContact, type MissedCallback, type MissedCallbacksResult, type Note, type PaginationMeta$1 as PaginationMeta, type PersonEnrichment, type Pipeline, type PipelineStage, type SearchFilter, type SearchResults, type Sequence, type SequenceActionResult, type SequenceAnalytics, type SequenceChannelConfig, type SequenceContactItem, type SequenceContactsParams, type SequenceCreateParams, type SequenceCreateResult, type SequenceDetail, type SequenceListItem, type SequenceListParams, type SequencePreview, type SequencePreviewChannel, type SequencePreviewStep, type SequenceStepConfig, type SequenceStepInputType, type SequenceStepType, type SequenceStepUpdateParams, type SequenceUpdateParams, type SetFieldValueParams, type Task, type TaskCreateParams, type TaskListParams, type TaskUpdateParams, type TimeSlot, type TrackProperties, type VisitorCompany, type VisitorScore, type VoicePagination, type VoiceSession, type WebhookEvent, g8 };