@graph8/sdk 0.7.1 → 0.11.0

package/dist/index.d.mts

@@ -434,11 +434,11 @@ interface ResearchReport {
  * Requires API key (server-side).
  *
  * Backed by:
- *   GET /api/v1/global-context/documents
- *   GET /api/v1/icps
- *   GET /api/v1/personas
- *   GET /api/v1/intelligence-data
- *   GET /api/v1/research-reports
+ *   GET   /api/v1/global-context/documents
+ *   GET   /api/v1/icps           POST /api/v1/icps           PATCH /api/v1/icps/{id}           POST /api/v1/icps/{id}/archive
+ *   GET   /api/v1/personas       POST /api/v1/personas       PATCH /api/v1/personas/{id}       POST /api/v1/personas/{id}/archive
+ *   GET   /api/v1/intelligence-data
+ *   GET   /api/v1/research-reports
  */
 declare const createStudioClient: (apiKey: string, apiUrl?: string) => {
     /** Org-level Studio documents (brand_brief, value_props, messaging_house, etc.).
@@ -479,6 +479,66 @@ declare const createStudioClient: (apiKey: string, apiUrl?: string) => {
     }): Promise<{
         data: ResearchReport[];
     }>;
+    /** Create an ICP manually (no AI scoring). Requires name + website_url. */
+    createIcp(body: {
+        name: string;
+        website_url: string;
+        description?: string;
+        firmographics?: Record<string, unknown>;
+        tech_stack?: Record<string, unknown>;
+        buying_signals?: unknown[];
+        estimated_market_size?: number;
+    }): Promise<{
+        data: ICP;
+    }>;
+    /** Update an ICP (partial - send only fields to change). */
+    updateIcp(icpId: string, body: {
+        name?: string;
+        description?: string;
+        firmographics?: Record<string, unknown>;
+        tech_stack?: Record<string, unknown>;
+        buying_signals?: unknown[];
+        estimated_market_size?: number;
+    }): Promise<{
+        data: ICP;
+    }>;
+    /** Archive an ICP (soft delete - sets status to "archived"). */
+    archiveIcp(icpId: string): Promise<{
+        data: ICP;
+    }>;
+    /** Create a buyer persona manually (no AI generation). Requires title + website_url. */
+    createPersona(body: {
+        title: string;
+        website_url: string;
+        priority?: number;
+        confidence?: string;
+        why_target?: string;
+        key_signals?: unknown[];
+        expected_receptivity?: string;
+        campaign_approach?: string;
+        recommended_goal?: string;
+        source?: string;
+    }): Promise<{
+        data: Persona;
+    }>;
+    /** Update a persona (partial). Passing status "archived" is equivalent to archivePersona. */
+    updatePersona(personaId: string, body: {
+        title?: string;
+        priority?: number;
+        confidence?: string;
+        why_target?: string;
+        key_signals?: unknown[];
+        expected_receptivity?: string;
+        campaign_approach?: string;
+        recommended_goal?: string;
+        status?: string;
+    }): Promise<{
+        data: Persona;
+    }>;
+    /** Archive a persona (soft delete - sets status to "archived"). */
+    archivePersona(personaId: string): Promise<{
+        data: Persona;
+    }>;
 };
 
 interface IntentKeyword {
@@ -1477,7 +1537,20 @@ interface Deal {
 }
 interface DealCreateParams {
     name: string;
-    /** Linked company ID. */
+    /**
+     * Deal owner (user id or email). Required.
+     */
+    owner_id: string;
+    /**
+     * mashup_contact_ids to attach. Required, at least one. Every contact must
+     * belong to the same company, and that company becomes the deal's company.
+     * Same id space as the contacts API. Attach is idempotent.
+     */
+    contact_ids: number[];
+    /**
+     * Deprecated: the company is derived from `contact_ids`. If supplied it must
+     * match the contacts' company, otherwise omit it.
+     */
     company_id?: number;
     description?: string;
     amount?: number;
@@ -1489,6 +1562,11 @@ interface DealCreateParams {
     pipeline_id?: string;
     /** ISO 8601 close date. */
     close_date?: string;
+    /**
+     * Set true to create a deal even if one already exists for the company.
+     * By default the API rejects a duplicate with HTTP 409.
+     */
+    allow_duplicate?: boolean;
 }
 interface DealUpdateParams {
     name?: string;
@@ -1498,6 +1576,16 @@ interface DealUpdateParams {
     stage_id?: string;
     /** ISO 8601 close date. */
     close_date?: string;
+    /** Reassign the deal owner (user id or email). Pass null to clear. */
+    owner_id?: string | null;
+    /**
+     * mashup_contact_ids to link. Must belong to the deal's company (if the deal
+     * has none yet, the added contacts' company is adopted); a cross-company add
+     * is rejected. Idempotent.
+     */
+    add_contact_ids?: number[];
+    /** mashup_contact_ids to unlink. Idempotent. */
+    remove_contact_ids?: number[];
 }
 interface DealListParams {
     page?: number;
@@ -2059,7 +2147,7 @@ declare const createContactsClient: (apiKey: string, apiUrl?: string) => {
  * adds events. ``WebhookEvent`` also accepts any string so a newly-added
  * backend event never breaks a client that hasn't upgraded.
  */
-declare const KNOWN_WEBHOOK_EVENTS: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.deployed", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled"];
+declare const KNOWN_WEBHOOK_EVENTS: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled"];
 type WebhookEvent = (typeof KNOWN_WEBHOOK_EVENTS)[number] | (string & {});
 /** The decoded body graph8 delivers to a webhook endpoint. */
 interface WebhookEventPayload {
@@ -2118,56 +2206,11 @@ declare const createWebhooksClient: (_apiKey: string, apiUrl?: string) => {
     /** Base URL the webhook subscription API lives under. */
     baseUrl: string;
     /** Known event types (for autocomplete / validation). */
-    knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.deployed", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled"];
+    knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled"];
     /** Verify an incoming webhook's HMAC signature and return the parsed event. */
     constructEvent(payload: string, signature: string, timestamp: string | number, secret: string, opts?: ConstructEventOptions): WebhookEventPayload;
 };
 
-interface LandingPage {
-    id: string;
-    title: string;
-    slug: string;
-    status: string;
-    published_url: string | null;
-}
-/**
- * Landing pages - clone, create, publish. Requires API key (server-side). On the
- * hardened HTTP core: throws a typed `G8Error` on failure and retries transient
- * errors.
- */
-declare const createPagesClient: (apiKey: string, apiUrl?: string) => {
-    /** Clone a landing page from any URL. */
-    clone(url: string): Promise<LandingPage>;
-    /** Create a landing page from a template. */
-    create(config: {
-        template?: string;
-        title?: string;
-        content?: Record<string, unknown>;
-    }): Promise<LandingPage>;
-    /** Publish a landing page to CDN. */
-    publish(pageId: string): Promise<{
-        url: string;
-    }>;
-};
-
-interface VoiceSession {
-    id: string;
-    status: string;
-    agent: string;
-    started_at: string;
-}
-interface CallAnalysis {
-    duration_seconds: number;
-    sentiment: "positive" | "neutral" | "negative";
-    summary: string;
-    next_steps: string[];
-    objections: string[];
-    transcript: Array<{
-        speaker: string;
-        text: string;
-        timestamp: number;
-    }>;
-}
 type VoiceEvent = "connected" | "transcription" | "ended" | "error";
 type VoiceCallback = (data: Record<string, unknown>) => void;
 interface VoicePagination {
@@ -2399,20 +2442,6 @@ interface DialerSessionResumeResult extends DialerSessionStatusUpdateResult {
  *   GET    /api/v1/voice/dialer/agents
  */
 declare const createVoiceClient: (apiKey: string, apiUrl?: string) => {
-    /**
-     * 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.
-     * @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. */
@@ -2480,31 +2509,6 @@ declare const createVoiceClient: (apiKey: string, apiUrl?: string) => {
     };
 };
 
-interface AnalyticsOverview {
-    visitors: number;
-    contacts_created: number;
-    emails_sent: number;
-    emails_opened: number;
-    replies: number;
-    meetings_booked: number;
-    period: string;
-}
-/**
- * Analytics - dashboard data and metrics. Requires API key (server-side).
- *
- * On the hardened HTTP core: throws a typed `G8Error` on failure and retries
- * transient errors. Note the deliberate behavior change vs the preview client —
- * a non-2xx response now **throws** instead of silently returning an all-zeros
- * overview, so callers can distinguish genuinely-zero activity from an auth/5xx
- * failure.
- */
-declare const createAnalyticsClient: (apiKey: string, apiUrl?: string) => {
-    overview(config?: {
-        period?: string;
-        metrics?: string[];
-    }): Promise<AnalyticsOverview>;
-};
-
 interface IntentSignals {
     domain: string;
     score: number;
@@ -2522,25 +2526,6 @@ declare const createSignalsClient: (key: string, isApiKey: boolean, apiUrl?: str
     stream(domains: string[], callback: (signals: IntentSignals[]) => void): () => void;
 };
 
-interface Integration {
-    id: string;
-    provider: string;
-    status: string;
-    connected_at: string | null;
-}
-/**
- * Integrations - connect CRM platforms, trigger syncs. Requires API key
- * (server-side). On the hardened HTTP core: throws a typed `G8Error` on failure
- * and retries transient errors.
- */
-declare const createIntegrationsClient: (apiKey: string, apiUrl?: string) => {
-    list(): Promise<Integration[]>;
-    connect(provider: string, config?: Record<string, unknown>): Promise<void>;
-    sync(provider: string, config?: {
-        direction?: "inbound" | "outbound" | "bidirectional";
-    }): Promise<void>;
-};
-
 interface Campaign {
     id: string;
     name: string;
@@ -2559,11 +2544,37 @@ interface CampaignCreateConfig {
     target_persona?: string;
     goal?: string;
 }
-interface CampaignStats {
-    sent: number;
-    opened: number;
-    replied: number;
-    meetings: number;
+interface CampaignLaunchExecution {
+    status: string;
+    contacts_total?: number;
+    contacts_scheduled?: number;
+    contacts_queued?: number;
+    job_id?: string;
+    polling_url?: string;
+    orchestrator_version?: string;
+}
+interface CampaignLaunchResult {
+    status: string;
+    campaign_id: string;
+    sequence_id: string;
+    sequence_name: string;
+    steps_created: number;
+    link_id: string;
+    warnings: string[];
+    channels_attached: Array<{
+        mailbox_id: number;
+        email: string;
+        channel_type: string;
+        auto_picked: boolean;
+    }>;
+    agent_assigned: {
+        textual_agent_name: string | null;
+        voice_agent_name: string | null;
+    };
+    schedule_id: string | null;
+    appointment_id: number | null;
+    execution: CampaignLaunchExecution;
+    message: string;
 }
 /**
  * Campaigns - create, manage, launch campaigns. Requires API key (server-side).
@@ -2574,8 +2585,7 @@ declare const createCampaignsClient: (apiKey: string, apiUrl?: string) => {
     list(page?: number, limit?: number): Promise<Campaign[]>;
     get(campaignId: string): Promise<Campaign>;
     create(config: CampaignCreateConfig): Promise<Campaign>;
-    launch(campaignId: string): Promise<void>;
-    stats(campaignId: string): Promise<CampaignStats>;
+    launch(campaignId: string): Promise<CampaignLaunchResult>;
 };
 
 interface Sequence {
@@ -2794,22 +2804,40 @@ declare const createSequencesClient: (apiKey: string, apiUrl?: string) => {
         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>;
+    /**
+     * Add contacts to a sequence (V2 queuing). Live or drafted sequences only.
+     * Pass `idempotencyKey` to make a retry safe — the same key returns the
+     * first result instead of re-enrolling on a 5xx-then-success (A6).
+     */
+    add(config: AddToSequenceConfig, idempotencyKey?: string): Promise<SequenceActionResult>;
+    /**
+     * Create a new sequence with optional steps + channels. Pass `idempotencyKey`
+     * to make a retry safe — the same key returns the first result instead of
+     * creating a duplicate sequence on a 5xx-then-success (A6).
+     */
+    create(payload: SequenceCreateParams, idempotencyKey?: string): 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>;
+    /**
+     * Run/start a DRAFTED sequence (V2 orchestration). Pass `idempotencyKey` to
+     * make a retry safe — the same key won't re-trigger the run on a
+     * 5xx-then-success (A6).
+     */
+    run(sequenceId: string, idempotencyKey?: string): Promise<SequenceActionResult>;
+    /**
+     * Pause a live sequence. Pass `idempotencyKey` to make a retry safe — the
+     * same key won't double-apply on a 5xx-then-success (A6).
+     */
+    pause(sequenceId: string, idempotencyKey?: string): Promise<SequenceActionResult>;
+    /**
+     * Resume a paused sequence. Pass `idempotencyKey` to make a retry safe — the
+     * same key won't double-apply on a 5xx-then-success (A6).
+     */
+    resume(sequenceId: string, idempotencyKey?: string): Promise<SequenceActionResult>;
     /** Read-only sequence preview with all steps + channels (no enrollment). */
     preview(sequenceId: string): Promise<SequencePreview>;
     /** Comprehensive analytics for a sequence. */
@@ -2864,7 +2892,7 @@ declare const createEnrichClient: (apiKey: string, apiUrl?: string) => {
     }): Promise<CompanyEnrichment>;
     /** Verify an email address. Costs 1 credit. */
     verifyEmail(email: string): Promise<EmailVerification>;
-    /** Search 300M+ contacts with filters. Credits charged per result. */
+    /** Search 700M+ contacts with filters. Credits charged per result. */
     search(filters: SearchFilter[], page?: number, limit?: number): Promise<SearchResults>;
 };
 
@@ -3086,7 +3114,7 @@ declare const createFormsClient: (writeKey: string, apiUrl?: string) => {
  * Handles event tracking, identity, and progressive forms.
  *
  * Usage:
- *   import { g8 } from '@graph8/js';
+ *   import { g8 } from '@graph8/sdk';
  *   g8.init({ writeKey: 'your_write_key' });
  *   g8.track('page_view', { page: '/pricing' });
  *   g8.identify('user@acme.com', { name: 'John', company: 'Acme' });
@@ -3102,11 +3130,8 @@ declare class G8 {
     /** @internal */ _enrich: ReturnType<typeof createEnrichClient> | null;
     /** @internal */ _sequences: ReturnType<typeof createSequencesClient> | null;
     /** @internal */ _campaigns: ReturnType<typeof createCampaignsClient> | null;
-    /** @internal */ _integrations: ReturnType<typeof createIntegrationsClient> | null;
     /** @internal */ _signals: ReturnType<typeof createSignalsClient> | null;
-    /** @internal */ _analytics: ReturnType<typeof createAnalyticsClient> | null;
     /** @internal */ _voice: ReturnType<typeof createVoiceClient> | null;
-    /** @internal */ _pages: ReturnType<typeof createPagesClient> | null;
     /** @internal */ _webhooks: ReturnType<typeof createWebhooksClient> | null;
     /** @internal */ _contacts: ReturnType<typeof createContactsClient> | null;
     /** @internal */ _companies: ReturnType<typeof createCompaniesClient> | null;
@@ -3206,14 +3231,14 @@ declare class G8 {
             data: SequenceContactItem[];
             pagination?: PaginationMeta;
         }>;
-        add(config: AddToSequenceConfig): Promise<SequenceActionResult>;
-        create(payload: SequenceCreateParams): Promise<SequenceCreateResult>;
+        add(config: AddToSequenceConfig, idempotencyKey?: string): Promise<SequenceActionResult>;
+        create(payload: SequenceCreateParams, idempotencyKey?: string): 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>;
+        run(sequenceId: string, idempotencyKey?: string): Promise<SequenceActionResult>;
+        pause(sequenceId: string, idempotencyKey?: string): Promise<SequenceActionResult>;
+        resume(sequenceId: string, idempotencyKey?: string): Promise<SequenceActionResult>;
         preview(sequenceId: string): Promise<SequencePreview>;
         analytics(sequenceId: string): Promise<SequenceAnalytics>;
     };
@@ -3222,37 +3247,15 @@ declare class G8 {
         list(page?: number, limit?: number): Promise<Campaign[]>;
         get(campaignId: string): Promise<Campaign>;
         create(config: CampaignCreateConfig): Promise<Campaign>;
-        launch(campaignId: string): Promise<void>;
-        stats(campaignId: string): Promise<CampaignStats>;
-    };
-    /** CRM integrations (requires API key). */
-    get integrations(): {
-        list(): Promise<Integration[]>;
-        connect(provider: string, config?: Record<string, unknown>): Promise<void>;
-        sync(provider: string, config?: {
-            direction?: "inbound" | "outbound" | "bidirectional";
-        }): Promise<void>;
+        launch(campaignId: string): Promise<CampaignLaunchResult>;
     };
     /** Intent signals. */
     get signals(): {
         company(domain: string): Promise<IntentSignals>;
         stream(domains: string[], callback: (signals: IntentSignals[]) => void): () => void;
     };
-    /** Analytics (requires API key). */
-    get analytics(): {
-        overview(config?: {
-            period?: string;
-            metrics?: string[];
-        }): Promise<AnalyticsOverview>;
-    };
     /** Voice AI (requires API key). */
     get voice(): {
-        start(config: {
-            agent?: string;
-            contactId?: number;
-            context?: Record<string, unknown>;
-        }): 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>;
@@ -3278,7 +3281,7 @@ declare class G8 {
                 contact_id?: number;
                 user_email?: string;
                 campaign_id?: string;
-                date_from?: string;
+                date_from? /** Marketplace — for SDR/AE talent: profile, hire offers (accept/reject), active hirings (requires API key). */: string;
                 date_to?: string;
                 limit?: number;
                 page?: number;
@@ -3300,22 +3303,10 @@ declare class G8 {
             }>;
         };
     };
-    /** Landing pages (requires API key). */
-    get pages(): {
-        clone(url: string): Promise<LandingPage>;
-        create(config: {
-            template?: string;
-            title?: string;
-            content?: Record<string, unknown>;
-        }): Promise<LandingPage>;
-        publish(pageId: string): Promise<{
-            url: string;
-        }>;
-    };
     /** Webhook event listeners (requires API key). */
     get webhooks(): {
         baseUrl: string;
-        knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.deployed", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled"];
+        knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled"];
         constructEvent(payload: string, signature: string, timestamp: string | number, secret: string, opts?: ConstructEventOptions): WebhookEventPayload;
     };
     /** Contacts CRUD (requires API key). */
@@ -3589,7 +3580,7 @@ declare class G8 {
             };
         }>;
         nodeTypes(params?: {
-            type?: string;
+            type? /** Identify a user with properties. */: string;
         }): Promise<{
             data: NodeTypeSchema[];
         }>;
@@ -3726,7 +3717,7 @@ declare class G8 {
             data: IntentCompany[];
         }>;
         keywordContacts(keywordId: string, params?: {
-            limit?: number;
+            limit? /** @internal */: number;
             date_from?: string;
             date_to?: string;
         }): Promise<{
@@ -3790,7 +3781,7 @@ declare class G8 {
         }>;
         personas(params?: {
             status?: string;
-            limit? /** @internal */: number;
+            limit?: number;
         }): Promise<{
             data: Persona[];
         }>;
@@ -3806,6 +3797,60 @@ declare class G8 {
         }): Promise<{
             data: ResearchReport[];
         }>;
+        createIcp(body: {
+            name: string;
+            website_url: string;
+            description?: string;
+            firmographics?: Record<string, unknown>;
+            tech_stack?: Record<string, unknown>;
+            buying_signals?: unknown[];
+            estimated_market_size?: number;
+        }): Promise<{
+            data: ICP;
+        }>;
+        updateIcp(icpId: string, body: {
+            name?: string;
+            description?: string;
+            firmographics?: Record<string, unknown>;
+            tech_stack?: Record<string, unknown>;
+            buying_signals?: unknown[];
+            estimated_market_size?: number;
+        }): Promise<{
+            data: ICP;
+        }>;
+        archiveIcp(icpId: string): Promise<{
+            data: ICP;
+        }>;
+        createPersona(body: {
+            title: string;
+            website_url: string;
+            priority?: number;
+            confidence?: string;
+            why_target?: string;
+            key_signals?: unknown[];
+            expected_receptivity?: string;
+            campaign_approach?: string;
+            recommended_goal?: string;
+            source?: string;
+        }): Promise<{
+            data: Persona;
+        }>;
+        updatePersona(personaId: string, body: {
+            title?: string;
+            priority?: number;
+            confidence?: string;
+            why_target?: string;
+            key_signals?: unknown[];
+            expected_receptivity?: string;
+            campaign_approach?: string;
+            recommended_goal?: string;
+            status?: string;
+        }): Promise<{
+            data: Persona;
+        }>;
+        archivePersona(personaId: string): Promise<{
+            data: Persona;
+        }>;
     };
     /** Meetings — read scheduled, completed, cancelled meetings with transcripts + AI analysis (requires API key). */
     get meetings(): {
@@ -3971,4 +4016,4 @@ interface PaginatedResponse<T> {
  */
 declare function paginate<T>(fetchPage: (cursor?: string) => Promise<PaginatedResponse<T>>): AsyncGenerator<T, void, unknown>;
 
-export { type AddToSequenceConfig, type AgencyClient, type AgencyInfo, type AnalyticsOverview, type AudienceSync, type AudienceSyncCreateParams, type AudienceSyncError, type AudienceSyncMode, type AudienceSyncPlatform, type AudienceSyncRun, type AudienceSyncUpdateParams, 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 ConstructEventOptions, 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 EvidenceKey, type Field, type FieldCreateParams, type FieldDeleteParams, type G8Config, G8Error, type G8PrivacyConfig, type GlobalContextDocument, type ICP, 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 IntelligenceData, type IntentCompany, type IntentContact, type IntentKeyword, type IntentPage, type IntentSignals, type IntentStats, type IntentVisitor, KNOWN_WEBHOOK_EVENTS, type LandingPage, type ListContact, type MarketplaceHiring, type MarketplaceOffer, type MarketplaceProfile, type MeetingAnalysis, type MeetingAttendee, type MeetingDetail, type MeetingListParams, type MeetingSummary, type MeetingTranscriptLine, type MissedCallback, type MissedCallbacksResult, type NodeTypeSchema, type Note, type PaginatedResponse, type PaginationMeta$1 as PaginationMeta, type PersonEnrichment, type Persona, type Pipeline, type PipelineStage, type PipelineSuggestion, type QuotableProduct, type QuoteCreateParams, type QuoteDetail, type QuoteLineItem, type QuoteListParams, type QuoteSendParams, type QuoteSettings, type QuoteStatus, type QuoteSummary, type QuoteUpdateParams, type RequestOptions, type ResearchReport, type SearchCompanyItem, type SearchCondition, type SearchContactItem, type SearchFilter, type SearchOperator, type SearchParams, type SearchResults, type SearchSaveParams, type SearchSaveResult, type Sequence, type SequenceActionResult, type SequenceAnalytics, type SequenceChannelConfig, type SequenceContactItem, type SequenceContactsParams, type SequenceCreateParams, type SequenceCreateResult, type SequenceDetail, type SequenceKind, type SequenceListItem, type SequenceListParams, type SequencePreview, type SequencePreviewChannel, type SequencePreviewStep, type SequenceStepConfig, type SequenceStepInputType, type SequenceStepType, type SequenceStepUpdateParams, type SequenceUpdateParams, type SetFieldValueParams, type Skill, type SkillCreateAPIParams, type SkillCreateLLMParams, type SkillInputField, type SkillListParams, type SkillTemplate, type SkillType, type SkillUpdateAPIParams, type SkillUpdateLLMParams, type Snippet, type StageCreateParams, type StagePipeline, type StagePipelineCreateParams, type StagePipelineStage, type StagePipelineUpdateParams, type StageUpdateParams, type Task, type TaskCreateParams, type TaskListParams, type TaskUpdateParams, type TimeSlot, type TrackProperties, type VisitorCompany, type VisitorScore, type VoicePagination, type VoiceSession, type WebhookEvent, type WebhookEventPayload, WebhookSignatureError, type Workflow, type WorkflowConfig, type WorkflowConnection, type WorkflowCreateParams, type WorkflowExecution, type WorkflowListParams, type WorkflowNode, type WorkflowUpdateParams, backoffDelayMs, constructEvent, g8, isRetryableStatus, paginate, parseRetryAfter, request };
+export { type AddToSequenceConfig, type AgencyClient, type AgencyInfo, type AudienceSync, type AudienceSyncCreateParams, type AudienceSyncError, type AudienceSyncMode, type AudienceSyncPlatform, type AudienceSyncRun, type AudienceSyncUpdateParams, type Booking, type BookingRequest, type CalendarConfig, type CallGradingResult, type Campaign, type CampaignCreateConfig, type CampaignLaunchExecution, type CampaignLaunchResult, type ChatConfig, type Company, type CompanyColumn, type CompanyColumnCreateParams, type CompanyContact, type CompanyEnrichment, type CompanyListParams, type CompanyUpdateParams, type ConstructEventOptions, 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 EvidenceKey, type Field, type FieldCreateParams, type FieldDeleteParams, type G8Config, G8Error, type G8PrivacyConfig, type GlobalContextDocument, type ICP, 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 IntelligenceData, type IntentCompany, type IntentContact, type IntentKeyword, type IntentPage, type IntentSignals, type IntentStats, type IntentVisitor, KNOWN_WEBHOOK_EVENTS, type ListContact, type MarketplaceHiring, type MarketplaceOffer, type MarketplaceProfile, type MeetingAnalysis, type MeetingAttendee, type MeetingDetail, type MeetingListParams, type MeetingSummary, type MeetingTranscriptLine, type MissedCallback, type MissedCallbacksResult, type NodeTypeSchema, type Note, type PaginatedResponse, type PaginationMeta$1 as PaginationMeta, type PersonEnrichment, type Persona, type Pipeline, type PipelineStage, type PipelineSuggestion, type QuotableProduct, type QuoteCreateParams, type QuoteDetail, type QuoteLineItem, type QuoteListParams, type QuoteSendParams, type QuoteSettings, type QuoteStatus, type QuoteSummary, type QuoteUpdateParams, type RequestOptions, type ResearchReport, type SearchCompanyItem, type SearchCondition, type SearchContactItem, type SearchFilter, type SearchOperator, type SearchParams, type SearchResults, type SearchSaveParams, type SearchSaveResult, type Sequence, type SequenceActionResult, type SequenceAnalytics, type SequenceChannelConfig, type SequenceContactItem, type SequenceContactsParams, type SequenceCreateParams, type SequenceCreateResult, type SequenceDetail, type SequenceKind, type SequenceListItem, type SequenceListParams, type SequencePreview, type SequencePreviewChannel, type SequencePreviewStep, type SequenceStepConfig, type SequenceStepInputType, type SequenceStepType, type SequenceStepUpdateParams, type SequenceUpdateParams, type SetFieldValueParams, type Skill, type SkillCreateAPIParams, type SkillCreateLLMParams, type SkillInputField, type SkillListParams, type SkillTemplate, type SkillType, type SkillUpdateAPIParams, type SkillUpdateLLMParams, type Snippet, type StageCreateParams, type StagePipeline, type StagePipelineCreateParams, type StagePipelineStage, type StagePipelineUpdateParams, type StageUpdateParams, type Task, type TaskCreateParams, type TaskListParams, type TaskUpdateParams, type TimeSlot, type TrackProperties, type VisitorCompany, type VisitorScore, type VoicePagination, type WebhookEvent, type WebhookEventPayload, WebhookSignatureError, type Workflow, type WorkflowConfig, type WorkflowConnection, type WorkflowCreateParams, type WorkflowExecution, type WorkflowListParams, type WorkflowNode, type WorkflowUpdateParams, backoffDelayMs, constructEvent, g8, isRetryableStatus, paginate, parseRetryAfter, request };