@graph8/sdk 0.7.2 → 0.12.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 {
@@ -2882,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>;
 };
 
@@ -3104,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' });
@@ -3120,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;
@@ -3240,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>;
@@ -3296,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;
@@ -3318,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). */
@@ -3607,7 +3580,7 @@ declare class G8 {
             };
         }>;
         nodeTypes(params?: {
-            type?: string;
+            type? /** Identify a user with properties. */: string;
         }): Promise<{
             data: NodeTypeSchema[];
         }>;
@@ -3744,7 +3717,7 @@ declare class G8 {
             data: IntentCompany[];
         }>;
         keywordContacts(keywordId: string, params?: {
-            limit?: number;
+            limit? /** @internal */: number;
             date_from?: string;
             date_to?: string;
         }): Promise<{
@@ -3808,7 +3781,7 @@ declare class G8 {
         }>;
         personas(params?: {
             status?: string;
-            limit? /** @internal */: number;
+            limit?: number;
         }): Promise<{
             data: Persona[];
         }>;
@@ -3824,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(): {
@@ -3989,4 +4016,229 @@ 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 };
+/**
+ * App-platform token exchange + refresh core (M6-9).
+ *
+ * The hosted-app clients never carry a permanent org API key. Instead they mint
+ * SHORT-LIVED app tokens by EXCHANGING a longer-lived credential, and refresh
+ * them on/near expiry:
+ *
+ *   - browser apps exchange the caller's PropelAuth login at
+ *     `POST /api/v1/app-sessions/exchange` (identity is derived server-side from
+ *     the validated principal — the body only names the target app + scopes);
+ *   - hosted backends exchange service client-credentials at
+ *     `POST /api/v1/service-token`.
+ *
+ * Both endpoints answer with the reused `ApiResponse` envelope wrapping a
+ * `TokenResponse` (see developer_api/app_platform/app_tokens/dtos.py). This
+ * module owns:
+ *
+ *   - `AppTokenResponse` — the minted-token payload shape (frozen wire contract);
+ *   - `createTokenManager` — caches a token, refreshes it on/near expiry, and
+ *     de-dupes concurrent refreshes into one in-flight exchange;
+ *   - `createAppRequester` — binds the managed token onto the hardened
+ *     `request()` core (typed `G8Error`, retries, idempotency, pagination),
+ *     attaching `Authorization: Bearer <app-token>` (plus any static header such
+ *     as a service client's `X-Target-Org-Id`) and refreshing once on a 401.
+ *
+ * The backend app-token API is INERT/unmounted today (behind a deny-by-default
+ * flag), so these paths are exercised against mocked HTTP, never a live server.
+ */
+declare const DEFAULT_APP_API = "https://be.graph8.com";
+/** The minted app token + the non-secret metadata a client reads back.
+ *  Mirrors `TokenResponse` in developer_api/app_platform/app_tokens/dtos.py. */
+interface AppTokenResponse {
+    /** The signed app JWT (attach as `Authorization: Bearer <access_token>`). */
+    access_token: string;
+    /** Always "Bearer". */
+    token_type: string;
+    /** Lifetime in seconds from issuance. */
+    expires_in: number;
+    /** The distinct-per-app, per-environment audience. */
+    audience: string;
+    /** App the token is bound to (dapp_-prefixed). */
+    app_id: string;
+    /** Signing key id (matches a JWKS entry). */
+    kid: string;
+}
+/** Per-request options accepted by an {@link AppRequest}. A subset of the
+ *  hardened core's `RequestOptions` — auth (the app token) and the injected
+ *  fetch/sleep seams are bound by the requester, not passed per call. */
+interface AppRequestOptions {
+    method?: string;
+    body?: unknown;
+    headers?: Record<string, string>;
+    query?: Record<string, unknown>;
+    /** Sent as `Idempotency-Key` for safe POST/PATCH retries. */
+    idempotencyKey?: string;
+    /** Max retry attempts on 429/5xx/network (default 2). */
+    maxRetries?: number;
+    /** Base backoff in ms (default 200). */
+    retryBaseMs?: number;
+    signal?: AbortSignal;
+}
+/** A token-bound request function: same ergonomics as the raw `request()` core
+ *  minus the credential, which the token manager supplies. */
+type AppRequest = <T = unknown>(path: string, opts?: AppRequestOptions) => Promise<T>;
+/** Caches + refreshes one app token. */
+interface TokenManager {
+    /** Return a valid token, refreshing on/near expiry. `force` refreshes now. */
+    getToken(force?: boolean): Promise<string>;
+    /** Current token expiry as an epoch-ms timestamp (0 before the first mint). */
+    expiresAt(): number;
+}
+/**
+ * Build a token manager over a `refresh` exchange.
+ *
+ * Freshness rule: a cached token is reused until it is within `refreshSkewMs`
+ * of expiry, then a refresh is triggered. Concurrent callers during a refresh
+ * share ONE in-flight exchange (no stampede). `now` is injectable for tests.
+ */
+declare function createTokenManager(args: {
+    refresh: () => Promise<AppTokenResponse>;
+    now?: () => number;
+    refreshSkewMs?: number;
+}): TokenManager;
+/**
+ * Bind a {@link TokenManager} onto the hardened `request()` core.
+ *
+ * Every call fetches the current token, attaches `Authorization: Bearer …`
+ * (plus any `extraHeaders`, e.g. a service client's `X-Target-Org-Id`), and
+ * reuses all of the core's typed errors / retries / idempotency. On a 401 —
+ * a token revoked or gone stale mid-window — it force-refreshes ONCE and retries.
+ */
+declare function createAppRequester(args: {
+    baseUrl: string;
+    tokens: TokenManager;
+    extraHeaders?: Record<string, string>;
+    fetchImpl?: typeof fetch;
+    sleepImpl?: (ms: number) => Promise<void>;
+}): AppRequest;
+/**
+ * Exchange the caller's PropelAuth token for a short-lived BROWSER app token.
+ * `POST /api/v1/app-sessions/exchange` (body = target app + scopes only;
+ * identity/role/tenant are derived server-side from the validated principal).
+ */
+declare function exchangeBrowserToken(args: {
+    baseUrl: string;
+    appId: string;
+    scopes?: string[];
+    getPropelAuthToken: () => string | Promise<string>;
+    fetchImpl?: typeof fetch;
+    sleepImpl?: (ms: number) => Promise<void>;
+}): Promise<AppTokenResponse>;
+/**
+ * Exchange service client-credentials for a SERVICE app token.
+ * `POST /api/v1/service-token` — credentials travel in the body; this endpoint
+ * has no bearer auth, so no `Authorization` is sent on the exchange itself.
+ */
+declare function exchangeServiceToken(args: {
+    baseUrl: string;
+    clientId: string;
+    clientSecret: string;
+    scopes?: string[];
+    ttlSeconds?: number;
+    fetchImpl?: typeof fetch;
+    sleepImpl?: (ms: number) => Promise<void>;
+}): Promise<AppTokenResponse>;
+
+/**
+ * Hosted app-platform clients (M6-9).
+ *
+ * Two entry points, both additive to `@graph8/sdk` and independent of the
+ * `g8` tracking/API-key singleton:
+ *
+ *   - `createGraph8AppClient` — BROWSER client. Exchanges the caller's
+ *     PropelAuth token for a short-lived app token, refreshes it on/near expiry,
+ *     and attaches `Authorization: Bearer <app-token>` to every call. It NEVER
+ *     accepts a permanent org API key for browser init (the whole reason the
+ *     token-exchange exists).
+ *   - `createGraph8ServiceClient` — BACKEND client. Exchanges service
+ *     client-credentials for a service app token and sends `X-Target-Org-Id`
+ *     for the single configured tenant on every call.
+ *
+ * Both expose a token-bound `request()` — the hardened `request()` core with the
+ * minted app token attached — so callers reach Developer API routes with the
+ * app token and reuse the core's typed `G8Error`, retries, idempotency, and
+ * cursor pagination. The typed `apps` (control-plane) and `objects`
+ * (custom-object CRUD) resource modules are DEFERRED until their backend routes
+ * ship and freeze (M6-3 / M6-5); only the auth clients ship here.
+ */
+
+/** Config for {@link createGraph8AppClient} (browser). No API key is accepted. */
+interface Graph8AppClientConfig {
+    /** Target app id (dapp_-prefixed). */
+    appId: string;
+    /** The client org this browser session acts in (informational; the server
+     *  derives the authoritative tenant from the validated PropelAuth principal). */
+    tenantOrgId: string;
+    /** Returns the caller's current PropelAuth token (sync or async). */
+    getPropelAuthToken: () => string | Promise<string>;
+    /** Scopes to embed in the minted app token. */
+    scopes?: string[];
+    /** Backend API URL (default https://be.graph8.com). */
+    apiUrl?: string;
+    /** Refresh this many ms before expiry (default 60_000). */
+    refreshSkewMs?: number;
+    /** Injected for tests; defaults to global fetch. */
+    fetchImpl?: typeof fetch;
+    /** Injected for tests; defaults to a real setTimeout sleep. */
+    sleepImpl?: (ms: number) => Promise<void>;
+    /** Injected for tests; defaults to Date.now. */
+    now?: () => number;
+}
+/** A browser app-platform client. */
+interface Graph8AppClient {
+    readonly appId: string;
+    readonly tenantOrgId: string;
+    /** Token-bound requester: mints/refreshes the app token and attaches
+     *  `Authorization: Bearer <app-token>` to every Developer API call. */
+    readonly request: AppRequest;
+    /** Return the current app token, refreshing on/near expiry (`force` refreshes now). */
+    getAppToken(force?: boolean): Promise<string>;
+}
+/**
+ * Create a BROWSER app-platform client backed by PropelAuth->app-token exchange.
+ * Refuses an org API key / write key — those must never reach a browser.
+ */
+declare function createGraph8AppClient(config: Graph8AppClientConfig): Graph8AppClient;
+/** Config for {@link createGraph8ServiceClient} (backend / server-to-server). */
+interface Graph8ServiceClientConfig {
+    /** Service credential client id. */
+    clientId: string;
+    /** Service credential client secret (checked against the stored hash). */
+    clientSecret: string;
+    /** The single consented client org this backend acts for (sent as X-Target-Org-Id). */
+    tenantOrgId: string;
+    /** Scopes to embed in the minted service token. */
+    scopes?: string[];
+    /** Requested token TTL; the server clamps it into its service band. */
+    ttlSeconds?: number;
+    /** Backend API URL (default https://be.graph8.com). */
+    apiUrl?: string;
+    /** Refresh this many ms before expiry (default 60_000). */
+    refreshSkewMs?: number;
+    /** Injected for tests; defaults to global fetch. */
+    fetchImpl?: typeof fetch;
+    /** Injected for tests; defaults to a real setTimeout sleep. */
+    sleepImpl?: (ms: number) => Promise<void>;
+    /** Injected for tests; defaults to Date.now. */
+    now?: () => number;
+}
+/** A backend service app-platform client. */
+interface Graph8ServiceClient {
+    readonly tenantOrgId: string;
+    /** Token-bound requester: mints/refreshes the service token, attaches it, and
+     *  sends `X-Target-Org-Id` for the one consented tenant on every call. */
+    readonly request: AppRequest;
+    /** Return the current service token, refreshing on/near expiry (`force` refreshes now). */
+    getServiceToken(force?: boolean): Promise<string>;
+}
+/**
+ * Create a BACKEND service client backed by client-credentials->service-token
+ * exchange. Every request carries `X-Target-Org-Id: <tenantOrgId>` for the one
+ * configured consented tenant.
+ */
+declare function createGraph8ServiceClient(config: Graph8ServiceClientConfig): Graph8ServiceClient;
+
+export { type AddToSequenceConfig, type AgencyClient, type AgencyInfo, type AppRequest, type AppRequestOptions, type AppTokenResponse, 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, DEFAULT_APP_API, 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 Graph8AppClient, type Graph8AppClientConfig, type Graph8ServiceClient, type Graph8ServiceClientConfig, 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 TokenManager, 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, createAppRequester, createGraph8AppClient, createGraph8ServiceClient, createTokenManager, exchangeBrowserToken, exchangeServiceToken, g8, isRetryableStatus, paginate, parseRetryAfter, request };