@graph8/sdk 0.5.1 → 0.7.1

package/dist/react.d.mts

@@ -2,6 +2,314 @@ import * as _jitsu_js from '@jitsu/js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 
+interface Snippet {
+    write_key: string;
+    tracking_host: string;
+    domains: string[];
+    /** Ready-to-use React component import for @graph8/nextjs. */
+    react_snippet: string;
+    /** Vanilla JS script tag for non-React apps. */
+    script_tag: string;
+    /** Full configuration object (gtm/config.json). */
+    config: Record<string, unknown>;
+}
+/**
+ * Snippet API — fetch your org's graph8 tracking snippet programmatically, to
+ * embed the tracker into an app or a customer's site (the write key, a React
+ * component, a vanilla `<script>` tag, allowed domains, and the full config).
+ * Requires an API key (server-side). Built on the hardened HTTP core, so it
+ * throws a typed `G8Error` on failure and retries transient errors.
+ *
+ * Backed by `GET /api/v1/snippet`.
+ */
+declare const createSnippetClient: (apiKey: string, apiUrl?: string) => {
+    /** Get your org's tracking snippet (write key + React/script-tag embeds + config). */
+    get(): Promise<Snippet>;
+};
+
+interface MarketplaceProfile {
+    id: string;
+    email: string;
+    first_name?: string | null;
+    last_name?: string | null;
+    marketplace_role?: string | null;
+    country_code?: string | null;
+    monthly_rate_usd?: string | null;
+    per_meeting_rate_usd?: string | null;
+    availability_status?: string | null;
+    bio?: string | null;
+    is_complete: boolean;
+}
+interface MarketplaceOffer {
+    id: string;
+    org_id: string;
+    org_name?: string | null;
+    sdr_id: string;
+    status: string;
+    monthly_rate_usd?: string | null;
+    per_meeting_rate_usd?: string | null;
+    created_at?: string | null;
+}
+interface MarketplaceHiring {
+    id: string;
+    org_id: string;
+    sdr_id: string;
+    status: string;
+    sdr_name?: string | null;
+    sdr_role?: string | null;
+    sdr_email?: string | null;
+    monthly_rate_usd?: string | null;
+    per_meeting_rate_usd?: string | null;
+    started_at?: string | null;
+}
+/**
+ * Marketplace API — for SDR/AE talent on the graph8 marketplace. View your
+ * profile, see pending hire offers and respond to them, and list your active
+ * hirings. Requires a personal API key (server-side). Built on the hardened
+ * HTTP core, so every method throws a typed `G8Error` on failure and retries
+ * transient errors.
+ *
+ * Backed by `/api/v1/marketplace`.
+ */
+declare const createMarketplaceClient: (apiKey: string, apiUrl?: string) => {
+    /** Your own marketplace SDR profile. */
+    profile(): Promise<MarketplaceProfile>;
+    /** Pending hire offers you can accept or reject. */
+    offers(): Promise<{
+        offers: MarketplaceOffer[];
+        count: number;
+    }>;
+    /** Accept a pending hire offer (by hiring id). */
+    acceptOffer(hiringId: string): Promise<Record<string, unknown>>;
+    /** Reject a pending hire offer (by hiring id). */
+    rejectOffer(hiringId: string): Promise<Record<string, unknown>>;
+    /** Your active hiring contracts. */
+    hirings(): Promise<{
+        hirings: MarketplaceHiring[];
+        count: number;
+    }>;
+};
+
+interface AgencyInfo {
+    agency_org_id: string;
+    agency_org_name: string | null;
+    is_agency: boolean;
+    client_count: number;
+    /** Request header to set when operating a client org (e.g. "X-Target-Org-Id"). */
+    target_header: string;
+}
+interface AgencyClient {
+    /** Pass this as the `X-Target-Org-Id` header to operate this client org. */
+    org_id: string;
+}
+/**
+ * Agency API — for agency-scoped API keys (minted with `is_agency: true`).
+ * Discover the agency credential and the client orgs it may operate. To act on a
+ * client org, set the `X-Target-Org-Id` header (see `target_header`) to that
+ * client's `org_id` on your subsequent requests. Requires an agency API key
+ * (server-side); a non-agency key gets a `403`.
+ *
+ * Built on the hardened HTTP core (typed `G8Error` + retries). Backed by
+ * `/api/v1/agency`.
+ */
+declare const createAgencyClient: (apiKey: string, apiUrl?: string) => {
+    /** Describe the agency credential: agency org + authorized client count. */
+    me(): Promise<AgencyInfo>;
+    /** List the client orgs this agency key may target via `X-Target-Org-Id`. */
+    clients(): Promise<{
+        data: AgencyClient[];
+    }>;
+};
+
+/** Filter operators supported by open-data search. */
+type SearchOperator = "any_of" | "contains" | "all_of" | "none_of" | "is_empty" | "is_not_empty" | "between" | "exists";
+/** A single search filter condition (named to avoid colliding with enrich's `SearchFilter`). */
+interface SearchCondition {
+    /** Field to filter on, e.g. "job_title", "country", "industry". */
+    field: string;
+    operator: SearchOperator;
+    /** Filter values (operator-dependent; e.g. `["VP", "Director"]` for any_of). */
+    value?: unknown[];
+}
+interface SearchParams {
+    /** Filter conditions, combined with AND. */
+    filters?: SearchCondition[];
+    /** Page number, 1-indexed (1-100). */
+    page?: number;
+    /** Results per page (1-100, default 25). */
+    limit?: number;
+}
+interface SearchSaveParams extends SearchParams {
+    /** Title for the new list the matched records are saved into. */
+    list_title: string;
+    /** Max records to save (1-10,000, default 1,000). */
+    max_results?: number;
+}
+interface SearchContactItem {
+    first_name?: string | null;
+    last_name?: string | null;
+    middle_name?: string | null;
+    work_email?: string | null;
+    personal_emails?: string | null;
+    direct_phone?: string | null;
+    mobile_phone?: string | null;
+    job_title?: string | null;
+    job_department?: string | null;
+    seniority_level?: string | null;
+    role?: string | null;
+    linkedin_url?: string | null;
+    linkedin_headline?: string | null;
+    city?: string | null;
+    state?: string | null;
+    country?: string | null;
+    company_name?: string | null;
+    company_domain?: string | null;
+    company_industry?: string | null;
+    company_employee_count?: string | null;
+    company_country?: string | null;
+    confidence_score?: number | null;
+}
+interface SearchCompanyItem {
+    name?: string | null;
+    domain?: string | null;
+    website?: string | null;
+    description?: string | null;
+    industry?: string | null;
+    industry_group?: string | null;
+    employee_count?: string | null;
+    revenue?: string | null;
+    founded_year?: number | null;
+    phone?: string | null;
+    address?: string | null;
+    city?: string | null;
+    state?: string | null;
+    country?: string | null;
+    zip?: number | null;
+    linkedin_url?: string | null;
+    linkedin_followers?: string | null;
+    facebook_url?: string | null;
+    twitter_url?: string | null;
+    crunchbase_url?: string | null;
+    logo_url?: string | null;
+}
+interface SearchSaveResult {
+    list_id: number;
+    list_title: string;
+    estimated_total: number;
+    status: string;
+}
+/**
+ * Search API — prospect the open-data graph for new contacts and companies by
+ * filter, and optionally save the matches straight into a list. Requires API
+ * key (server-side). Built on the hardened HTTP core, so every method throws a
+ * typed `G8Error` on failure and retries transient errors.
+ *
+ * Backed by `/api/v1/search`.
+ */
+declare const createSearchClient: (apiKey: string, apiUrl?: string) => {
+    /** Search open-data contacts by filter. */
+    contacts(params?: SearchParams): Promise<{
+        data: SearchContactItem[];
+    }>;
+    /** Search open-data companies by filter. */
+    companies(params?: SearchParams): Promise<{
+        data: SearchCompanyItem[];
+    }>;
+    /** Search contacts and save the matches into a new list. */
+    saveContacts(params: SearchSaveParams): Promise<SearchSaveResult>;
+    /** Search companies and save the matches into a new list. */
+    saveCompanies(params: SearchSaveParams): Promise<SearchSaveResult>;
+};
+
+/** Ad platform an audience can sync to. */
+type AudienceSyncPlatform = "meta" | "linkedin" | "google" | "x";
+/** Sync mode: full mirror, or only ever add members. */
+type AudienceSyncMode = "mirror" | "append_only";
+interface AudienceSync {
+    id: number;
+    audience_id: number;
+    platform: string;
+    platform_audience_name: string | null;
+    mode: string;
+    refresh_cadence_hours: number;
+    is_active: boolean;
+    status: string | null;
+    last_sync_at: string | null;
+    created_at: string | null;
+}
+interface AudienceSyncCreateParams {
+    /** Audience list ID to sync. */
+    audience_id: number;
+    platform: AudienceSyncPlatform;
+    platform_audience_name?: string;
+    /** Default "mirror". */
+    mode?: AudienceSyncMode;
+    /** Refresh cadence in hours (0-720; default 24). */
+    refresh_cadence_hours?: number;
+    /** Platform-specific config (OAuth creds, ad-account ids, etc.). */
+    platform_config?: Record<string, unknown>;
+    /** Audience list IDs whose members should be suppressed from the sync. */
+    suppression_list_ids?: number[];
+}
+interface AudienceSyncUpdateParams {
+    mode?: AudienceSyncMode;
+    refresh_cadence_hours?: number;
+    is_active?: boolean;
+    suppression_list_ids?: number[];
+}
+interface AudienceSyncRun {
+    id: number;
+    started_at: string | null;
+    finished_at: string | null;
+    status: string | null;
+    members_added: number | null;
+    members_removed: number | null;
+    total_members: number | null;
+    error_message: string | null;
+}
+interface AudienceSyncError {
+    id: number;
+    started_at: string | null;
+    error_message: string | null;
+    details: Record<string, unknown> | null;
+}
+/**
+ * Audiences API — sync an audience list to ad platforms (Meta, LinkedIn,
+ * Google, X). Requires API key (server-side). Built on the hardened HTTP core,
+ * so every method throws a typed `G8Error` on failure and retries transient
+ * 429/5xx/network errors.
+ *
+ * Backed by `/api/v1/audience-syncs`.
+ */
+declare const createAudiencesClient: (apiKey: string, apiUrl?: string) => {
+    /** List all audience syncs for the organization. */
+    list(): Promise<{
+        data: AudienceSync[];
+    }>;
+    /** Create a new audience sync to an ad platform. */
+    create(params: AudienceSyncCreateParams): Promise<AudienceSync>;
+    /** Get a single audience sync by ID. */
+    get(configId: number): Promise<AudienceSync>;
+    /** Update an audience sync (partial). */
+    update(configId: number, fields: AudienceSyncUpdateParams): Promise<AudienceSync>;
+    /** Delete an audience sync. */
+    delete(configId: number): Promise<{
+        data: Record<string, unknown>;
+    }>;
+    /** Trigger an immediate sync run for a config. */
+    trigger(configId: number): Promise<{
+        data: Record<string, unknown>;
+    }>;
+    /** List recent sync runs for a config (most recent first). */
+    runs(configId: number): Promise<{
+        data: AudienceSyncRun[];
+    }>;
+    /** List recent sync errors for a config. */
+    errors(configId: number): Promise<{
+        data: AudienceSyncError[];
+    }>;
+};
+
 interface MeetingAttendee {
     name: string | null;
     email: string;
@@ -135,10 +443,13 @@ interface ResearchReport {
  *   GET /api/v1/research-reports
  */
 declare const createStudioClient: (apiKey: string, apiUrl?: string) => {
-    /** Org-level Studio documents (brand_brief, value_props, messaging_house, etc.). */
+    /** Org-level Studio documents (brand_brief, value_props, messaging_house, etc.).
+     * `include_content` defaults to true server-side, so each document includes
+     * its `content` body unless you explicitly pass `include_content: false`. */
     globalContext(params?: {
         category?: string;
         limit?: number;
+        include_content?: boolean;
     }): Promise<{
         data: GlobalContextDocument[];
     }>;
@@ -584,7 +895,8 @@ interface WorkflowListParams {
 }
 /**
  * Workflows API - automation workflows with nodes, connections, and execution lifecycle.
- * Requires API key (server-side).
+ * Requires API key (server-side). On the hardened HTTP core: throws a typed
+ * `G8Error` on failure and retries transient errors.
  *
  * The graph8 workflow surface treats the whole workflow definition as a single
  * record updated via `update()` — there are no per-node CRUD endpoints. To edit
@@ -649,9 +961,9 @@ declare const createWorkflowsClient: (apiKey: string, apiUrl?: string) => {
     }>;
     /** Execute a workflow immediately with a trigger payload. */
     execute(workflowId: string, triggerPayload?: Record<string, unknown>): Promise<WorkflowExecution>;
-    /** Get the status + output of a workflow execution. */
+    /** Get the status + outputs of a single execution. */
     getExecution(executionId: string): Promise<WorkflowExecution>;
-    /** Pause an in-flight execution. */
+    /** Pause a running execution. */
     pauseExecution(executionId: string): Promise<{
         data: {
             paused: boolean;
@@ -663,34 +975,32 @@ declare const createWorkflowsClient: (apiKey: string, apiUrl?: string) => {
             resumed: boolean;
         };
     }>;
-    /** Stop an execution (terminal state — cannot resume). */
+    /** Stop an execution. */
     stopExecution(executionId: string): Promise<{
         data: {
             stopped: boolean;
         };
     }>;
-    /** Get the status of a workflow's external trigger (e.g. "waiting for webhook"). */
+    /** Get the trigger status (e.g. schedule / webhook wiring) for a workflow. */
     getTriggerStatus(workflowId: string): Promise<{
         data: {
             status: string;
             details: Record<string, unknown>;
         };
     }>;
-    /** Reset the trigger cursor (e.g. for event-stream triggers — resume from beginning). */
+    /** Reset a workflow's trigger cursor / state. */
     resetTrigger(workflowId: string): Promise<{
         data: {
             reset: boolean;
         };
     }>;
-    /**
-     * List available node types with schemas. Pass a `type` param to fetch one type's full schema.
-     */
+    /** Catalog of available workflow node types with config + output schemas. */
     nodeTypes(params?: {
         type?: string;
     }): Promise<{
         data: NodeTypeSchema[];
     }>;
-    /** Slack workspace users (for Slack action recipients). */
+    /** Slack users available to workflow nodes. */
     listSlackUsers(): Promise<{
         data: Array<{
             id: string;
@@ -698,7 +1008,7 @@ declare const createWorkflowsClient: (apiKey: string, apiUrl?: string) => {
             email: string | null;
         }>;
     }>;
-    /** Slack channels. */
+    /** Slack channels available to workflow nodes. */
     listSlackChannels(): Promise<{
         data: Array<{
             id: string;
@@ -706,7 +1016,7 @@ declare const createWorkflowsClient: (apiKey: string, apiUrl?: string) => {
             is_private: boolean;
         }>;
     }>;
-    /** Roam (Copilot chat) users. */
+    /** Roam users available to workflow nodes. */
     listRoamUsers(): Promise<{
         data: Array<{
             id: string;
@@ -714,14 +1024,14 @@ declare const createWorkflowsClient: (apiKey: string, apiUrl?: string) => {
             email: string | null;
         }>;
     }>;
-    /** Roam (Copilot chat) groups. */
+    /** Roam groups available to workflow nodes. */
     listRoamGroups(): Promise<{
         data: Array<{
             id: string;
             name: string;
         }>;
     }>;
-    /** Available MCP servers (for Agent-node integrations). */
+    /** MCP servers available to workflow nodes. */
     listMcpServers(): Promise<{
         data: Array<{
             id: string;
@@ -729,14 +1039,14 @@ declare const createWorkflowsClient: (apiKey: string, apiUrl?: string) => {
             url: string;
         }>;
     }>;
-    /** Available call dispositions (voice workflow nodes). */
+    /** Disposition options available to workflow nodes. */
     listDispositions(): Promise<{
         data: Array<{
             id: string;
             label: string;
         }>;
     }>;
-    /** Form field schema for form-trigger nodes. */
+    /** Form field definitions for a given form (used by form-trigger nodes). */
     listFormFields(formId: string): Promise<{
         data: Array<{
             name: string;
@@ -819,7 +1129,8 @@ interface PipelineSuggestion {
 }
 /**
  * Stage Checklist Pipelines API - workflow pipelines with evidence + scripts.
- * Requires API key (server-side).
+ * Requires API key (server-side). On the hardened HTTP core: throws a typed
+ * `G8Error` on failure and retries transient errors.
  *
  * Backed by:
  *   GET    /api/v1/pipelines
@@ -962,7 +1273,9 @@ interface PaginationMeta$2 {
     has_next: boolean;
 }
 /**
- * Quotes API - quote-to-cash lifecycle. Requires API key (server-side).
+ * Quotes API - quote-to-cash lifecycle. Requires API key (server-side). On the
+ * hardened HTTP core: throws a typed `G8Error` on failure and retries transient
+ * errors.
  *
  * Backed by:
  *   GET    /api/v1/quotes
@@ -1115,7 +1428,9 @@ interface InboxSendResult {
 }
 /**
  * Inbox API — read + reply to multi-channel inbox threads (email, SMS, LinkedIn/HeyReach).
- * Requires API key (server-side).
+ * Requires API key (server-side). On the hardened HTTP core: throws a typed
+ * `G8Error` on failure (e.g. 402 when an AI draft exceeds your credit balance)
+ * and retries transient errors.
  *
  * Backed by:
  *   GET   /api/v1/inbox
@@ -1322,7 +1637,8 @@ interface SetFieldValueParams {
 }
 /**
  * Fields API - manage custom fields (columns) on contacts and companies.
- * Requires API key (server-side).
+ * Requires API key (server-side). On the hardened HTTP core: throws a typed
+ * `G8Error` on failure and retries transient errors.
  *
  * Backed by:
  *   GET    /api/v1/fields                — list contact fields
@@ -1716,8 +2032,11 @@ declare const createContactsClient: (apiKey: string, apiUrl?: string) => {
     }>;
     /** Get a single contact by ID. */
     get(contactId: number): Promise<Contact>;
-    /** Create a new contact. */
-    create(contact: ContactCreateParams): Promise<Contact>;
+    /**
+     * Create a new contact. Pass `idempotencyKey` to make a retry safe — the
+     * same key returns the first result instead of creating a duplicate (A6).
+     */
+    create(contact: ContactCreateParams, idempotencyKey?: string): Promise<Contact>;
     /** Update a contact (partial). */
     update(contactId: number, fields: ContactUpdateParams): Promise<{
         updated: number;
@@ -1734,18 +2053,44 @@ declare const createContactsClient: (apiKey: string, apiUrl?: string) => {
     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";
-type WebhookCallback = (data: Record<string, unknown>) => void;
 /**
- * Webhooks - listen for graph8 events. Requires API key (server-side).
+ * Known graph8 webhook event types.
  *
- * For client-side real-time events, use g8.visitors.onIntent() or g8.chat.on() instead.
+ * Source of truth is the backend ``WEBHOOK_EVENTS`` catalog
+ * (campaign_builder/services/webhook_service.py). Keep in sync when the backend
+ * adds events. ``WebhookEvent`` also accepts any string so a newly-added
+ * backend event never breaks a client that hasn't upgraded.
  */
-declare const createWebhooksClient: (apiKey: string, apiUrl?: string) => {
-    /** Register a listener for a webhook event. Starts polling automatically. */
-    on(event: WebhookEvent, callback: WebhookCallback): void;
-    /** Stop all webhook polling. */
-    stop(): void;
+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"];
+type WebhookEvent = (typeof KNOWN_WEBHOOK_EVENTS)[number] | (string & {});
+/** The decoded body graph8 delivers to a webhook endpoint. */
+interface WebhookEventPayload {
+    event: WebhookEvent;
+    timestamp: string;
+    data: Record<string, unknown>;
+    org_id: string;
+    /** Stable per-delivery id (present once the backend adds it; for consumer dedup). */
+    id?: string;
+}
+interface ConstructEventOptions {
+    /**
+     * Reject events whose ``X-Studio-Timestamp`` is older (or newer) than this
+     * many seconds — replay protection. Disabled when 0/undefined.
+     */
+    toleranceSeconds?: number;
+}
+/**
+ * Webhooks client (server-side). graph8 webhooks are PUSH — graph8 POSTs to your
+ * endpoint; you verify each delivery with {@link constructEvent}. (The previous
+ * polling implementation hit a feed endpoint that never existed and is removed.)
+ */
+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"];
+    /** 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 {
@@ -1756,7 +2101,9 @@ interface LandingPage {
     published_url: string | null;
 }
 /**
- * Landing pages - clone, create, publish. Requires API key (server-side).
+ * 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. */
@@ -2114,6 +2461,12 @@ interface AnalyticsOverview {
 }
 /**
  * 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?: {
@@ -2146,7 +2499,9 @@ interface Integration {
     connected_at: string | null;
 }
 /**
- * Integrations - connect CRM platforms, trigger syncs. Requires API key (server-side).
+ * 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[]>;
@@ -2182,6 +2537,8 @@ interface CampaignStats {
 }
 /**
  * Campaigns - create, manage, launch campaigns. Requires API key (server-side).
+ * On the hardened HTTP core: throws a typed `G8Error` on failure and retries
+ * transient errors.
  */
 declare const createCampaignsClient: (apiKey: string, apiUrl?: string) => {
     list(page?: number, limit?: number): Promise<Campaign[]>;
@@ -2213,6 +2570,8 @@ interface SequenceListParams {
     limit?: number;
     /** Filter by sequence status (e.g. "live", "draft", "paused"). */
     status?: string;
+    /** Filter by sequence kind ("cold_outbound" or "nurture"). Omit to list all kinds. */
+    sequence_kind?: SequenceKind;
 }
 interface SequenceDetail {
     id: string;
@@ -2226,6 +2585,10 @@ interface SequenceDetail {
     wait_for_new_contacts: boolean;
     paused_at: string | null;
     resumed_at: string | null;
+    /** Sequence kind. Immutable after creation. "cold_outbound" (default) or "nurture". */
+    sequence_kind?: string | null;
+    /** Pinned mailbox for nurture sequences; null for cold_outbound. Immutable. */
+    pinned_mailbox_id?: number | null;
     created_at: string | null;
     updated_at: string | null;
 }
@@ -2270,6 +2633,13 @@ interface SequenceChannelConfig {
     channel_type: string;
     channel_data?: Record<string, unknown>;
 }
+/**
+ * Sequence kind. A "nurture" is an ordinary sequence with `sequence_kind:
+ * "nurture"` — same step types as cold outreach, but pinned to a single mailbox
+ * with a higher daily email cap. There is no separate nurture client; create one
+ * via `sequences.create({ sequence_kind: "nurture", pinned_mailbox_id })`.
+ */
+type SequenceKind = "cold_outbound" | "nurture";
 interface SequenceCreateParams {
     name: string;
     user_email: string;
@@ -2281,6 +2651,18 @@ interface SequenceCreateParams {
     steps?: SequenceStepConfig[];
     channels?: SequenceChannelConfig[];
     campaign_id?: string;
+    /**
+     * Sequence kind. Defaults to "cold_outbound" server-side. Immutable after
+     * creation. "nurture" requires `pinned_mailbox_id` and is gated by the
+     * ENABLE_NURTURE feature flag.
+     */
+    sequence_kind?: SequenceKind;
+    /**
+     * Mailbox to pin for a nurture sequence. Required when
+     * `sequence_kind: "nurture"`; all email channels must use this mailbox.
+     * Ignored for cold_outbound sequences.
+     */
+    pinned_mailbox_id?: number;
 }
 interface SequenceCreateResult {
     id: string;
@@ -2426,7 +2808,8 @@ interface SearchResults {
 /**
  * Enrichment API - person/company lookup, email verification, prospecting search.
  *
- * Requires API key (server-side only). Credits charged per call.
+ * Requires API key (server-side only). Credits charged per call. On the hardened
+ * HTTP core: throws a typed `G8Error` on failure and retries transient errors.
  */
 declare const createEnrichClient: (apiKey: string, apiUrl?: string) => {
     /** Look up a person by email, LinkedIn, or name + company. Costs 1 credit. */
@@ -2733,6 +3116,11 @@ declare const useG8: () => {
         _intent: ReturnType<typeof createIntentClient> | null;
         _studio: ReturnType<typeof createStudioClient> | null;
         _meetings: ReturnType<typeof createMeetingsClient> | null;
+        _audiences: ReturnType<typeof createAudiencesClient> | null;
+        _search: ReturnType<typeof createSearchClient> | null;
+        _agency: ReturnType<typeof createAgencyClient> | null;
+        _marketplace: ReturnType<typeof createMarketplaceClient> | null;
+        _snippet: ReturnType<typeof createSnippetClient> | null;
         init(config: G8Config): void;
         track(event: string, properties?: TrackProperties): void;
         identify(userId: string, properties?: IdentifyProperties): void;
@@ -2897,8 +3285,9 @@ declare const useG8: () => {
             }>;
         };
         get webhooks(): {
-            on(event: WebhookEvent, callback: (data: Record<string, unknown>) => void): void;
-            stop(): void;
+            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"];
+            constructEvent(payload: string, signature: string, timestamp: string | number, secret: string, opts?: ConstructEventOptions): WebhookEventPayload;
         };
         get contacts(): {
             list(params?: ContactListParams): Promise<{
@@ -2906,7 +3295,7 @@ declare const useG8: () => {
                 total: number;
             }>;
             get(contactId: number): Promise<Contact>;
-            create(contact: ContactCreateParams): Promise<Contact>;
+            create(contact: ContactCreateParams, idempotencyKey?: string): Promise<Contact>;
             update(contactId: number, fields: ContactUpdateParams): Promise<{
                 updated: number;
             }>;
@@ -3346,6 +3735,7 @@ declare const useG8: () => {
             globalContext(params?: {
                 category?: string;
                 limit?: number;
+                include_content?: boolean;
             }): Promise<{
                 data: GlobalContextDocument[];
             }>;
@@ -3386,6 +3776,58 @@ declare const useG8: () => {
             }>;
             get(meetingId: string): Promise<MeetingDetail>;
         };
+        get audiences(): {
+            list(): Promise<{
+                data: AudienceSync[];
+            }>;
+            create(params: AudienceSyncCreateParams): Promise<AudienceSync>;
+            get(configId: number): Promise<AudienceSync>;
+            update(configId: number, fields: AudienceSyncUpdateParams): Promise<AudienceSync>;
+            delete(configId: number): Promise<{
+                data: Record<string, unknown>;
+            }>;
+            trigger(configId: number): Promise<{
+                data: Record<string, unknown>;
+            }>;
+            runs(configId: number): Promise<{
+                data: AudienceSyncRun[];
+            }>;
+            errors(configId: number): Promise<{
+                data: AudienceSyncError[];
+            }>;
+        };
+        get search(): {
+            contacts(params?: SearchParams): Promise<{
+                data: SearchContactItem[];
+            }>;
+            companies(params?: SearchParams): Promise<{
+                data: SearchCompanyItem[];
+            }>;
+            saveContacts(params: SearchSaveParams): Promise<SearchSaveResult>;
+            saveCompanies(params: SearchSaveParams): Promise<SearchSaveResult>;
+        };
+        get agency(): {
+            me(): Promise<AgencyInfo>;
+            clients(): Promise<{
+                data: AgencyClient[];
+            }>;
+        };
+        get marketplace(): {
+            profile(): Promise<MarketplaceProfile>;
+            offers(): Promise<{
+                offers: MarketplaceOffer[];
+                count: number;
+            }>;
+            acceptOffer(hiringId: string): Promise<Record<string, unknown>>;
+            rejectOffer(hiringId: string): Promise<Record<string, unknown>>;
+            hirings(): Promise<{
+                hirings: MarketplaceHiring[];
+                count: number;
+            }>;
+        };
+        get snippet(): {
+            get(): Promise<Snippet>;
+        };
         get initialized(): boolean;
         _assertInit(): void;
         _assertKey(module: string): void;