@graph8/sdk 0.251.0 → 0.260.0

package/dist/types/index.d.ts

@@ -0,0 +1,63 @@
+export { g8 } from "./core";
+export { G8Error, request, paginate, isRetryableStatus, parseRetryAfter, backoffDelayMs } from "./http";
+export type { RequestOptions, PaginatedResponse } from "./http";
+export type { G8Config, G8PrivacyConfig, TrackProperties, IdentifyProperties, EnrichLookupResult } from "./types";
+export type { VisitorCompany, VisitorScore } from "./visitors";
+export type { CopilotConfig } from "./copilot";
+export type { ChatConfig } from "./chat";
+export type { CalendarConfig, TimeSlot, Booking, BookingRequest } from "./calendar";
+export type { PersonEnrichment, CompanyEnrichment, EmailVerification, SearchFilter, SearchResults } from "./enrich";
+export type { Sequence, AddToSequenceConfig, SequenceListItem, SequenceListParams, SequenceDetail, SequenceContactItem, SequenceContactsParams, SequenceActionResult, SequenceKind, SequenceStepType, SequenceStepInputType, SequenceStepConfig, SequenceChannelConfig, SequenceCreateParams, SequenceCreateResult, SequenceUpdateParams, SequenceStepUpdateParams, SequencePreviewStep, SequencePreviewChannel, SequencePreview, SequenceAnalytics, } from "./sequences";
+export type { InboxChannel, InboxContact, InboxTag, InboxAssignee, InboxMessage, InboxThread, InboxListParams, InboxAssignResult, InboxTagResult, InboxDraft, InboxSendParams, InboxSendResult, } from "./inbox";
+export type { Campaign, CampaignCreateConfig, CampaignLaunchExecution, CampaignLaunchResult, } from "./campaigns";
+export type { App, AppInstallation, AppUsageSummary, AppLimit, AppCreateParams, AppStatus, InstallStatus, } from "./apps";
+export { createAppPlatformClient, MIN_TAIL_LINES, MAX_TAIL_LINES } from "./appPlatform";
+export type { Deployment, DeploymentStatus, CreateDeploymentParams, AppDomain, DomainVerificationStatus, DomainVerificationInstructions, AppSecretMetadata, AppSourceParams, SourceProvider, SchemaVersion, SchemaVersionStatus, AppLogs, ContainerLog, } from "./appPlatform";
+export type { CustomObject, CreateCustomObject, CustomObjectIcon, CreateCustomObjectAttribute, UpdateCustomObjectAttribute, UpdateCustomObject, CustomObjectAttribute, CustomObjectRecord, CustomObjectHistory, CustomObjectHistoryEntry, CustomObjectMutation, CustomObjectMutations, ListRecordsParams, ObjectPagination, } from "./objects";
+export type { IntentSignals } from "./signals";
+export type { VoicePagination, DialerSessionSummary, DialerSessionsListResult, DialerSessionsListParams, DialerStatsParams, DialerReportFilters, DialerReportMetric, DialerStatsResult, DialerNumberInfo, DialerNumbersListResult, MissedCallback, MissedCallbacksResult, CallGradingResult, DialerAgentSummary, DialerAgentsListResult, DialerAgentsListParams, DialerSessionCreateParams, DialerSessionCreateResult, DialerSessionStatus, DialerSessionStatusUpdateResult, DialerSessionResumeResult, } from "./voice";
+export type { WebhookEvent, WebhookEventPayload, ConstructEventOptions } from "./webhooks";
+export { constructEvent, WebhookSignatureError, KNOWN_WEBHOOK_EVENTS } from "./webhooks";
+export type { Contact, ContactListParams, ContactCreateParams, ContactUpdateParams, ContactUpsertParams, ContactUpsertResult, ContactDetail, ContactBulkGetItem, ContactColumn, ContactColumnCreateParams, } from "./contacts";
+export type { Company, CompanyListParams, CompanyUpdateParams, CompanyContact, CompanyColumn, CompanyColumnCreateParams, CompanyCreateParams, CompanyCreateResult, } from "./companies";
+export type { ContactList, ListContact } from "./lists";
+export type { Note } from "./notes";
+export type { Mailbox, MailboxListItem, MailboxListParams, MailboxCreateParams, MailboxUpdateParams, MailboxTestConnectionParams, MailboxTestConnectionResult, MailboxConnectionTestLegResult, MailboxDeleteResult, MailboxWarmupAnalytics, MailboxWarmupAnalyticsData, MailboxWarmupDailyStat, } from "./mailboxes";
+export type { Newsletter, NewsletterIssue, NewsletterTemplate, NewsletterSubscriber, NewsletterIssueKpis, NewsletterCreateParams, NewsletterIssueCreateParams, NewsletterIssueUpdateParams, NewsletterListParams, } from "./newsletter";
+export type { Task, TaskCreateParams, TaskUpdateParams, TaskListParams } from "./tasks";
+export type { Field, CreatedField, FieldCreateParams, FieldDeleteParams, SetFieldValueParams, } from "./fields";
+export type { Deal, DealCreateParams, DealUpdateParams, DealContactRole, DealListParams, Pipeline, PipelineStage, ContactDeal, PaginationMeta, } from "./deals";
+export type { QuoteSummary, QuoteDetail, QuoteLineItem, QuoteStatus, QuoteCreateParams, QuoteUpdateParams, QuoteSendParams, QuoteListParams, QuotableProduct, QuoteSettings, } from "./quotes";
+export type { StagePipeline, StagePipelineStage, StagePipelineCreateParams, StagePipelineUpdateParams, StageCreateParams, StageUpdateParams, EvidenceKey, PipelineSuggestion, } from "./pipelines";
+export type { Workflow, WorkflowNode, WorkflowConnection, WorkflowConfig, WorkflowCreateParams, WorkflowUpdateParams, WorkflowExecution, WorkflowListParams, NodeTypeSchema, } from "./workflows";
+export type { Skill, SkillType, SkillInputField, SkillCreateLLMParams, SkillCreateAPIParams, SkillUpdateLLMParams, SkillUpdateAPIParams, SkillTemplate, SkillListParams, } from "./skills";
+export type { IntentKeyword, IntentPage, IntentVisitor, IntentCompany, IntentContact, IntentStats, } from "./intent";
+export type { GlobalContextDocument, Persona, ICP, IntelligenceData, ResearchReport, } from "./studio";
+export type { MeetingSummary, MeetingDetail, MeetingAttendee, MeetingTranscriptLine, MeetingAnalysis, MeetingListParams, } from "./meetings";
+export type { AudienceSync, AudienceSyncPlatform, AudienceSyncMode, AudienceSyncCreateParams, AudienceSyncUpdateParams, AudienceSyncRun, AudienceSyncError, } from "./audiences";
+export type { SearchOperator, SearchCondition, SearchParams, SearchSaveParams, SearchContactItem, SearchCompanyItem, SearchSaveResult, } from "./search";
+export type { AgencyInfo, AgencyClient } from "./agency";
+export type { MarketplaceProfile, MarketplaceOffer, MarketplaceHiring } from "./marketplace";
+export type { Snippet } from "./snippet";
+export { createGraph8AppClient, createGraph8ServiceClient } from "./appClient";
+export type { Graph8AppClient, Graph8AppClientConfig, Graph8ServiceClient, Graph8ServiceClientConfig, } from "./appClient";
+export { createTokenManager, createAppRequester, exchangeBrowserToken, exchangeServiceToken, DEFAULT_APP_API, } from "./appTokens";
+export type { AppTokenResponse, TokenManager, AppRequest, AppRequestOptions } from "./appTokens";
+export { createApiClient, API_BASE_PATH } from "./api";
+export type { ApiClient, ApiDispatcher, ApiNamespaces, ApiMethod, ApiCallOptions, ApiInput, ApiOutput, ApiPageItem, ApiOperationInfo, } from "./api";
+export { API_OPERATIONS, API_OPERATION_IDS, API_OPERATION_COUNT } from "./generated/operations";
+export type { ApiOperationId, ApiHttpMethod, ApiTag, ApiOperationTuple } from "./generated/operations";
+export type { ApiOperationMap } from "./generated/operation-types";
+export type { ApiNamespaceMap } from "./generated/namespaces";
+/**
+ * Every schema the Developer API contract publishes, as a namespace.
+ *
+ * Namespaced rather than flattened on purpose: 696 bare type names through
+ * `export *` would eventually collide with a hand-written one (`Contact`,
+ * `Company`, `Sequence`, ... all already exist above), and a duplicate-symbol
+ * collision in the barrel is exactly the failure this package has hit before.
+ *
+ *   import type { G8Contract } from "@graph8/sdk";
+ *   function render(c: G8Contract.ContactResponse) { ... }
+ */
+export type * as G8Contract from "./generated/schemas";

package/dist/types/intent.d.ts

@@ -0,0 +1,196 @@
+export interface IntentKeyword {
+    id: string;
+    keyword: string;
+    domain: string | null;
+    include_patterns: string[];
+    exclude_patterns: string[];
+    page_count: number;
+    visitor_count: number;
+    company_count: number;
+    contact_count: number;
+    created_at: string | null;
+}
+export interface IntentPage {
+    url: string;
+    title: string | null;
+    keyword: string | null;
+    domain: string;
+    visitor_count: number;
+    last_seen: string | null;
+}
+export interface IntentVisitor {
+    visitor_id: string;
+    company_domain: string | null;
+    company_name: string | null;
+    page_url: string;
+    first_seen: string | null;
+    last_seen: string | null;
+    visit_count: number;
+}
+export interface IntentCompany {
+    domain: string;
+    name: string | null;
+    industry: string | null;
+    employee_count: string | null;
+    visit_count: number;
+    last_seen: string | null;
+}
+/** One company row from `intent.urlCompanies()`. Richer than {@link IntentCompany},
+ * which describes the keyword-companies surface. */
+export interface IntentUrlCompany {
+    company_id: number | null;
+    name: string | null;
+    domain: string | null;
+    industry: string | null;
+    employee_count: number | null;
+    logo_url: string | null;
+    audience: string;
+    visit_count: number;
+    contacts_seen: number;
+    last_seen: string | null;
+}
+/** Response of `intent.urlCompanies()`. This endpoint returns a bare aggregate,
+ * not the `{ data }` envelope the rest of the Developer API uses. */
+export interface IntentUrlCompaniesResponse {
+    url: string;
+    total_companies: number;
+    b2b_count: number;
+    b2c_count: number;
+    companies: IntentUrlCompany[];
+}
+export interface IntentContact {
+    contact_id: number | null;
+    email: string | null;
+    full_name: string | null;
+    company: string | null;
+    job_title: string | null;
+    last_seen: string | null;
+}
+export interface IntentStats {
+    total_keywords: number;
+    total_pages: number;
+    total_visitors_30d: number;
+    total_companies_30d: number;
+}
+/**
+ * Intent + visitor tracking. Distinct from `g8.signals` (which is summary scoring) —
+ * this module exposes keyword tracking, page-level visitor data, and account-level
+ * intent signals from your own site (or from competitor URLs you've added).
+ *
+ * Requires API key (server-side).
+ *
+ * Backed by:
+ *   GET    /api/v1/intent/stats
+ *   POST   /api/v1/intent/keywords/list
+ *   POST   /api/v1/intent/keywords/create-from-domain
+ *   DELETE /api/v1/intent/keywords/{keyword_id}
+ *   POST   /api/v1/intent/keywords/{keyword_id}/companies
+ *   POST   /api/v1/intent/keywords/{keyword_id}/contacts
+ *   POST   /api/v1/intent/keywords/{keyword_id}/urls
+ *   POST   /api/v1/intent/pages-by-domain
+ *   POST   /api/v1/intent/pages/search
+ *   POST   /api/v1/intent/pages/visitors
+ *   POST   /api/v1/intent/pages/contacts
+ *   POST   /api/v1/intent/pages/visitor-counts
+ *   POST   /api/v1/intent/url-companies
+ */
+export declare const createIntentClient: (apiKey: string, apiUrl?: string) => {
+    /** Org-level intent stats (totals over the last 30 days). */
+    stats(): Promise<{
+        data: IntentStats;
+    }>;
+    /** List tracked keywords with optional pagination. */
+    listKeywords(params?: {
+        page?: number;
+        limit?: number;
+        search?: string;
+    }): Promise<{
+        data: IntentKeyword[];
+    }>;
+    /** Create a keyword group from a domain (auto-tracks all pages). */
+    createFromDomain(domain: string): Promise<{
+        data: IntentKeyword;
+    }>;
+    /** Stop tracking a keyword (irreversible — historical data is retained). */
+    deleteKeyword(keywordId: string): Promise<{
+        data: {
+            deleted: boolean;
+        };
+    }>;
+    /** Companies showing interest in a tracked keyword. */
+    keywordCompanies(keywordId: string, params?: {
+        limit?: number;
+        date_from?: string;
+        date_to?: string;
+    }): Promise<{
+        data: IntentCompany[];
+    }>;
+    /** Contacts showing interest in a tracked keyword. */
+    keywordContacts(keywordId: string, params?: {
+        limit?: number;
+        date_from?: string;
+        date_to?: string;
+    }): Promise<{
+        data: IntentContact[];
+    }>;
+    /** URLs associated with a keyword (pages visitors landed on while interested). */
+    keywordUrls(keywordId: string, params?: {
+        limit?: number;
+    }): Promise<{
+        data: IntentPage[];
+    }>;
+    /** Pages tracked on a specific domain. */
+    pagesByDomain(domain: string, params?: {
+        limit?: number;
+    }): Promise<{
+        data: IntentPage[];
+    }>;
+    /** Search tracked pages by URL fragment or keyword. */
+    searchPages(query: string, params?: {
+        limit?: number;
+    }): Promise<{
+        data: IntentPage[];
+    }>;
+    /** Get visitor records for a specific page URL. */
+    pageVisitors(pageUrl: string, params?: {
+        limit?: number;
+        date_from?: string;
+        date_to?: string;
+    }): Promise<{
+        data: IntentVisitor[];
+    }>;
+    /** Get contacts who visited a specific page URL. */
+    pageContacts(pageUrl: string, params?: {
+        limit?: number;
+    }): Promise<{
+        data: IntentContact[];
+    }>;
+    /** Visitor count aggregates by page (pass an array of URLs). */
+    pageVisitorCounts(urls: string[]): Promise<{
+        data: Array<{
+            url: string;
+            visitor_count: number;
+        }>;
+    }>;
+    /**
+     * Find companies whose users visited a specific URL (intent search).
+     *
+     * Previously posted to the bare-host `/intent-search/url-companies`, bypassing
+     * the shared `post()` helper. That route is JWT-only, so this method could
+     * never actually work with an API key. It now goes through
+     * `/api/v1/intent/url-companies` like the rest of the intent surface (g8 issue
+     * #16536).
+     *
+     * Returns a bare aggregate, NOT the `{ data }` envelope — the previous
+     * `{ data: IntentCompany[] }` signature never matched what the API sends.
+     *
+     * `date_from` / `date_to` are accepted for backwards compatibility but have
+     * never been read by this endpoint; use `days` to set the lookback window.
+     */
+    urlCompanies(url: string, params?: {
+        limit?: number;
+        days?: number;
+        date_from?: string;
+        date_to?: string;
+    }): Promise<IntentUrlCompaniesResponse>;
+};

package/dist/types/lists.d.ts

@@ -0,0 +1,44 @@
+export interface ContactList {
+    id: number;
+    title: string;
+    type: "contacts" | "companies";
+    contact_count: number | null;
+    created_at: string | null;
+}
+export interface ListContact {
+    id: number;
+    first_name: string | null;
+    last_name: string | null;
+    work_email: string | null;
+    job_title: string | null;
+    company_name: string | null;
+}
+/**
+ * Lists API - manage contact and company lists. Requires API key (server-side).
+ */
+export declare const createListsClient: (apiKey: string, apiUrl?: string) => {
+    /** List all lists. */
+    list(page?: number, limit?: number): Promise<{
+        data: ContactList[];
+        total: number;
+    }>;
+    /** Create a new list. */
+    create(title: string, type?: "contacts" | "companies"): Promise<ContactList>;
+    /** Delete a list (soft-delete). */
+    delete(listId: number): Promise<{
+        deleted: boolean;
+    }>;
+    /** Get contacts in a list. */
+    contacts(listId: number, page?: number, limit?: number): Promise<{
+        data: ListContact[];
+        total: number;
+    }>;
+    /** Add contacts to a list. */
+    addContacts(listId: number, contactIds: number[]): Promise<{
+        added: number;
+    }>;
+    /** Remove contacts from a list. */
+    removeContacts(listId: number, contactIds: number[]): Promise<{
+        removed: number;
+    }>;
+};

package/dist/types/mailboxes.d.ts

@@ -0,0 +1,240 @@
+/**
+ * A sending mailbox. Mirrors `MailboxResponse`
+ * (`developer_api/interfaces/dtos/mailboxes.py:14-30`).
+ *
+ * Credentials (`smtp_password` / `imap_password`) are write-only server-side
+ * and are never returned by any endpoint, so this type deliberately has no
+ * field for them — see `mailbox_row_to_response()` (mailboxes.py:96-116),
+ * which drops anything credential-shaped before building the response.
+ */
+export interface Mailbox {
+    id: number;
+    email: string | null;
+    display_name: string | null;
+    /** active | paused | disconnected | expired | ... */
+    connection_status: string | null;
+    provider: string | null;
+    daily_limit: number | null;
+    allows_nurture: boolean | null;
+    warmup_enabled: boolean | null;
+    is_archived: boolean | null;
+    created_by: string | null;
+    created_at: string | null;
+    updated_at: string | null;
+}
+/**
+ * One row from `GET /api/v1/mailboxes` (list). This is a DIFFERENT, wider
+ * shape than `Mailbox`: the route predates the lifecycle router and returns a
+ * raw dict (`response_model=ApiResponse[list[dict]]`), not `MailboxResponse` —
+ * see `gtm_context_router.py:1090-1178`.
+ *
+ * Note `id` is a STRING here (`str(row.id)`, gtm_context_router.py:1163) while
+ * every lifecycle route (`get`/`update`/`delete`/`testConnection`) takes a
+ * NUMERIC `mailbox_id`. This is a real asymmetry in the backend, not an SDK
+ * typo — cast if you need to feed a list result into a lifecycle call.
+ */
+export interface MailboxListItem {
+    id: string;
+    email: string | null;
+    display_name: string | null;
+    provider: string | null;
+    source: string | null;
+    connection_status: string | null;
+    is_archived: boolean | null;
+    shared_with_team: boolean | null;
+    team_id: string | null;
+    team_name: string | null;
+    daily_limit: number | null;
+    created_by: string | null;
+    created_at: string | null;
+    updated_at: string | null;
+    /** Cheap DB-level warmup state. For live engagement metrics use `warmup()`. */
+    warmup_provider: string | null;
+    warmup_status: string | null;
+    smartlead_warmup_enabled: boolean | null;
+}
+/** Query params for `GET /api/v1/mailboxes` (gtm_context_router.py:1091-1098). */
+export interface MailboxListParams {
+    limit?: number;
+    include_archived?: boolean;
+    /** Filter by connection_status (active|paused|disconnected|expired|...). */
+    connection_status?: string;
+}
+/**
+ * Connect an existing mailbox over IMAP/SMTP. Mirrors `MailboxCreateRequest`
+ * field-for-field (`developer_api/interfaces/dtos/mailboxes.py:33-56`).
+ *
+ * Google/Microsoft mailboxes are not connectable through this endpoint: OAuth
+ * needs a browser redirect an API call cannot complete. Connect those in the
+ * app for now.
+ */
+export interface MailboxCreateParams {
+    email: string;
+    smtp_address: string;
+    smtp_username: string;
+    /** Write-only. Never returned by any endpoint. */
+    smtp_password: string;
+    imap_address: string;
+    imap_username: string;
+    /** Write-only. Never returned by any endpoint. */
+    imap_password: string;
+    display_name?: string;
+    smtp_port?: number;
+    imap_port?: number;
+    authentication?: string;
+    enable_starttls_auto?: boolean;
+    /** Max sends per day for this mailbox. */
+    daily_limit?: number;
+    signature_html?: string;
+    signature_plain?: string;
+    use_html_signature?: boolean;
+}
+/**
+ * Partial update — only supplied fields change. Mirrors `MailboxUpdateRequest`
+ * field-for-field (`developer_api/interfaces/dtos/mailboxes.py:59-75`); every
+ * field is optional there, so every field is optional here.
+ */
+export interface MailboxUpdateParams {
+    display_name?: string;
+    smtp_address?: string;
+    smtp_port?: number;
+    smtp_username?: string;
+    /** Write-only. */
+    smtp_password?: string;
+    imap_address?: string;
+    imap_port?: number;
+    imap_username?: string;
+    /** Write-only. */
+    imap_password?: string;
+    daily_limit?: number;
+    allows_nurture?: boolean;
+    signature_html?: string;
+    signature_plain?: string;
+    use_html_signature?: boolean;
+}
+/**
+ * Optionally override credentials for a connection test without saving them.
+ * Mirrors `MailboxTestConnectionRequest` field-for-field
+ * (`developer_api/interfaces/dtos/mailboxes.py:78-88`) — every field is
+ * optional there (and here); send `{}` to test what is already stored.
+ */
+export interface MailboxTestConnectionParams {
+    smtp_address?: string;
+    smtp_port?: number;
+    smtp_username?: string;
+    smtp_password?: string;
+    imap_address?: string;
+    imap_port?: number;
+    imap_username?: string;
+    imap_password?: string;
+}
+/** Result of `DELETE /api/v1/mailboxes/{id}`. Mirrors `MailboxDeleteResponse` (mailboxes.py:91-93). */
+export interface MailboxDeleteResult {
+    deleted: boolean;
+    mailbox_id: number;
+}
+/** One leg (SMTP or IMAP) of a connection test result (connection_tester.py test_smtp/test_imap). */
+export interface MailboxConnectionTestLegResult {
+    success: boolean;
+    error?: string;
+}
+/**
+ * Result of `POST /api/v1/mailboxes/{id}/test-connection`. This route has no
+ * Pydantic response model (`response_model=ApiResponse[dict]`) — shape taken
+ * from `mailboxes/usecases/test_connection/handler.py:89-94`.
+ */
+export interface MailboxTestConnectionResult {
+    success: boolean;
+    connection_status: string;
+    smtp: MailboxConnectionTestLegResult;
+    imap: MailboxConnectionTestLegResult;
+}
+/** One day of warmup send/receive counts (mailboxes/infrastructure/warmup_service.py DailyWarmupStats). */
+export interface MailboxWarmupDailyStat {
+    date: string;
+    sent: number;
+    inbox: number;
+    spam: number;
+    received: number;
+    replies: number;
+    saved_from_spam: number;
+}
+/**
+ * Provider warmup analytics (mailboxes/infrastructure/warmup_service.py
+ * WarmupAnalytics, ~line 99). Some fields are provider-specific: `health_score`
+ * is Instantly-only, `reputation` / `is_warmup_blocked` / `blocked_reason` /
+ * `is_suspended` are SmartLead-only.
+ */
+export interface MailboxWarmupAnalyticsData {
+    provider: string;
+    /** active | paused | disabled | error | connection_error | sending_error | soft_bounce_error */
+    status: string;
+    total_sent: number;
+    total_inbox: number;
+    total_spam: number;
+    total_received: number;
+    inbox_rate: number;
+    health_score: number | null;
+    reputation: number | null;
+    is_warmup_blocked: boolean | null;
+    blocked_reason: string | null;
+    is_suspended: boolean | null;
+    error_message: string | null;
+    daily_stats: MailboxWarmupDailyStat[];
+    raw_account: Record<string, unknown> | null;
+    raw_analytics: Record<string, unknown> | null;
+}
+/**
+ * Result of `GET /api/v1/mailboxes/{id}/warmup`. No Pydantic response model
+ * (`response_model=ApiResponse[dict]`) — shape taken from
+ * `gtm_context_router.py:1292-1298` (success/not-configured path) and
+ * `:1278-1284` (provider-transport-error path, which omits `warmup_settings`
+ * and adds `error` instead).
+ */
+export interface MailboxWarmupAnalytics {
+    success: boolean;
+    warmup_enabled: boolean | null;
+    provider: string | null;
+    analytics: MailboxWarmupAnalyticsData | null;
+    warmup_settings?: unknown;
+    /** Only present when the provider HTTP call itself failed. */
+    error?: string;
+}
+/**
+ * Mailboxes API - connect, read, update, test and delete sending mailboxes,
+ * plus list + live warmup analytics. Requires API key (server-side).
+ *
+ * Backed by:
+ *   GET    /api/v1/mailboxes                        (gtm_context_router.py:1090)
+ *   GET    /api/v1/mailboxes/{mailbox_id}/warmup     (gtm_context_router.py:1187)
+ *   POST   /api/v1/mailboxes                         (mailboxes_router.py:101)
+ *   GET    /api/v1/mailboxes/{mailbox_id}            (mailboxes_router.py:141)
+ *   PATCH  /api/v1/mailboxes/{mailbox_id}            (mailboxes_router.py:161)
+ *   DELETE /api/v1/mailboxes/{mailbox_id}            (mailboxes_router.py:196)
+ *   POST   /api/v1/mailboxes/{mailbox_id}/test-connection (mailboxes_router.py:214)
+ *
+ * Google/Microsoft mailboxes cannot be connected through `create()` — that
+ * needs a browser OAuth redirect. Connect those in the app.
+ */
+export declare const createMailboxesClient: (apiKey: string, apiUrl?: string) => {
+    /** List sending mailboxes in the org. */
+    list(params?: MailboxListParams): Promise<{
+        data: MailboxListItem[];
+    }>;
+    /** Get live warmup analytics for a single mailbox (a provider HTTP round-trip, ~300-800ms). */
+    warmup(mailboxId: number): Promise<MailboxWarmupAnalytics>;
+    /** Connect an existing mailbox over IMAP/SMTP. */
+    create(params: MailboxCreateParams): Promise<Mailbox>;
+    /** Get a single mailbox by id. Credentials are never included. */
+    get(mailboxId: number): Promise<Mailbox>;
+    /** Update a mailbox. Only supplied fields change; omitted fields are untouched. */
+    update(mailboxId: number, params: MailboxUpdateParams): Promise<Mailbox>;
+    /** Delete a mailbox. Sequences already referencing it stop being able to send from it. */
+    delete(mailboxId: number): Promise<MailboxDeleteResult>;
+    /**
+     * Verify a mailbox's IMAP/SMTP credentials and refresh its connection status.
+     * Call with no params (or `{}`) to test what is stored; supply overrides to
+     * test candidate values without saving them.
+     */
+    testConnection(mailboxId: number, params?: MailboxTestConnectionParams): Promise<MailboxTestConnectionResult>;
+};

package/dist/types/marketplace.d.ts

@@ -0,0 +1,62 @@
+export 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;
+}
+export 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;
+}
+export 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`.
+ */
+export 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;
+    }>;
+};

package/dist/types/meetings.d.ts

@@ -0,0 +1,70 @@
+export interface MeetingAttendee {
+    name: string | null;
+    email: string;
+    role: "host" | "prospect" | "guest" | string;
+    contact_id?: number | null;
+}
+export interface MeetingTranscriptLine {
+    speaker: string;
+    text: string;
+    timestamp: number;
+}
+export interface MeetingAnalysis {
+    sentiment: "positive" | "neutral" | "negative";
+    summary: string;
+    next_steps: string[];
+    objections: string[];
+    talk_listen_ratio: number | null;
+}
+export interface MeetingSummary {
+    id: string;
+    status: "scheduled" | "completed" | "cancelled" | "no_show";
+    event_type: string | null;
+    scheduled_at: string;
+    duration_minutes: number;
+    attendees: MeetingAttendee[];
+    contact_id: number | null;
+    conferencing_provider: string | null;
+    conferencing_url: string | null;
+    recording_url: string | null;
+    created_at: string;
+}
+export interface MeetingDetail extends MeetingSummary {
+    transcript: MeetingTranscriptLine[] | null;
+    analysis: MeetingAnalysis | null;
+}
+export interface MeetingListParams {
+    status?: "scheduled" | "completed" | "cancelled" | "no_show";
+    date_from?: string;
+    date_to?: string;
+    attendee_id?: string;
+    event_type?: string;
+    contact_id?: number;
+    page?: number;
+    limit?: number;
+}
+/**
+ * Meetings API - read-only access to scheduled, completed, and cancelled meetings.
+ * Booking happens via `g8.calendar.*` (write-key safe, browser only) — this surface
+ * is for reading meeting records, transcripts, and AI analysis.
+ *
+ * Requires API key (server-side).
+ *
+ * Backed by:
+ *   GET /api/v1/inbox/meetings
+ *   GET /api/v1/inbox/meetings/{meeting_id}
+ */
+export declare const createMeetingsClient: (apiKey: string, apiUrl?: string) => {
+    /** List meetings with optional filters. Returns summary rows without transcript / analysis. */
+    list(params?: MeetingListParams): Promise<{
+        data: MeetingSummary[];
+        pagination?: {
+            page: number;
+            limit: number;
+            total: number;
+            has_next: boolean;
+        };
+    }>;
+    /** Get full meeting detail including transcript + AI analysis (transcript available 1-5 min after meeting ends). */
+    get(meetingId: string): Promise<MeetingDetail>;
+};