@oneshot-agent/sdk 0.16.2 → 0.18.0

package/dist/index.d.ts

@@ -4,1049 +4,9 @@ export { EthersWalletProvider } from './providers/ethers';
 export { CdpWalletProvider } from './providers/cdp';
 export { getSwapQuote, executeSwap } from './swap';
 export type { SwapQuote, SwapResult, UniswapAddresses } from './swap';
-export declare class OneShotError extends Error {
-    constructor(message: string);
-}
-export declare class ToolError extends OneShotError {
-    readonly statusCode: number;
-    readonly responseBody: string;
-    constructor(message: string, statusCode: number, responseBody: string);
-}
-export declare class JobError extends OneShotError {
-    readonly jobId: string;
-    readonly jobError: string;
-    constructor(message: string, jobId: string, jobError: string);
-}
-export declare class JobTimeoutError extends OneShotError {
-    readonly jobId: string;
-    readonly elapsedMs: number;
-    constructor(jobId: string, elapsedMs: number);
-}
-export declare class ValidationError extends OneShotError {
-    readonly field: string;
-    constructor(message: string, field: string);
-}
-export declare class ContentBlockedError extends OneShotError {
-    readonly categories: string[];
-    constructor(message: string, categories: string[]);
-}
-export declare class EmergencyNumberError extends OneShotError {
-    readonly blockedNumber: string;
-    constructor(message: string, blockedNumber: string);
-}
-export interface TokenInfo {
-    address: string;
-    symbol: string;
-    decimals: number;
-}
-export interface PaymentInfo {
-    protocol: 'x402';
-    network: string;
-    payTo: string;
-    amount: string;
-    currency: string;
-    facilitator_url: string;
-    token: TokenInfo;
-    context?: Record<string, unknown>;
-}
-export interface PaymentRequirements {
-    scheme: string;
-    network: string;
-    amount: string;
-    asset: string;
-    payTo: string;
-    maxTimeoutSeconds: number;
-    extra?: Record<string, unknown>;
-}
-export interface PaymentAuthorization {
-    x402Version: 2;
-    resource?: {
-        url: string;
-        description?: string;
-        mimeType?: string;
-    };
-    extensions?: Record<string, unknown>;
-    accepted: PaymentRequirements;
-    payload: {
-        signature: string;
-        authorization: {
-            from: string;
-            to: string;
-            value: string;
-            validAfter: string;
-            validBefore: string;
-            nonce: string;
-        };
-    };
-}
-export type LoggerFn = (message: string) => void;
-export type StatusUpdateFn = (status: string, requestId: string) => void;
-export interface OneShotConfig {
-    /** Option A: Raw private key (existing behavior) */
-    privateKey?: string;
-    /** Option B: Use Coinbase CDP Server Wallet (reads CDP_* env vars). Pass true or { address } to reuse existing. */
-    cdp?: boolean | {
-        address?: string;
-    };
-    /** Option C: Bring your own WalletProvider implementation */
-    walletProvider?: WalletProvider;
-    /** Override API URL */
-    baseUrl?: string;
-    /** Override RPC URL */
-    rpcUrl?: string;
-    /** Enable debug logging */
-    debug?: boolean;
-    /** Custom logger function */
-    logger?: LoggerFn;
-    /** Payment currency: "USDC" (default, no swap) or "ETH" (auto-swap via Uniswap V3) */
-    currency?: 'USDC' | 'ETH';
-    /** Slippage tolerance for ETH→USDC swaps (default: 0.01 = 1%). Only used when currency is "ETH". */
-    slippage?: number;
-}
-/**
- * Structured decision context for a tool call. Machine-readable metadata
- * that explains WHY this tool was called — consumed by auditor agents
- * and programmatic oversight. Open schema: known fields are typed,
- * extra keys are allowed.
- */
-export interface DecisionContext {
-    /** Goal or objective this tool call serves */
-    goal?: string;
-    /** Compute goal ID if linked to an orchestrated goal */
-    goalId?: string;
-    /** Alternative tools/approaches that were considered */
-    alternatives?: string[];
-    /** Confidence in this being the right tool choice (0-1) */
-    confidence?: number;
-    /** Any additional context */
-    [key: string]: unknown;
-}
-export interface ToolOptions {
-    maxCost?: number;
-    timeout?: number;
-    signal?: AbortSignal;
-    onStatusUpdate?: StatusUpdateFn;
-    wait?: boolean;
-    /** Optional value tag for RoCS tracking — stored in the receipt at creation time */
-    valueTag?: {
-        type: string;
-        amount?: number;
-        label?: string;
-    };
-    /**
-     * Short human-readable reason for this tool call. Stored on the receipt
-     * for debugging and audit. Max 1000 chars. The SDK warns (does not error)
-     * if a paid tool is called without a memo.
-     */
-    memo?: string;
-    /**
-     * Structured decision context — goal linkage, alternatives considered,
-     * confidence score. Machine-readable counterpart to memo. Stored alongside
-     * the receipt for programmatic auditing by supervisor agents.
-     */
-    decisionContext?: DecisionContext;
-    /**
-     * Apollo phone-reveal opt-in. Apollo's phone numbers arrive asynchronously
-     * via a webhook minutes AFTER the initial enrichment completes. By default,
-     * the SDK returns as soon as the worker writes status=completed (phones=null,
-     * phones_pending=true). Set `waitForPhones: true` to keep polling at a slower
-     * cadence (every 5s) until phones land or `phoneTimeoutSec` expires (default
-     * 360s = 6 min — Apollo says "several minutes"). Only meaningful for tools
-     * that hit Apollo internally (research/person, enrich/profile, etc.). For
-     * other tools the flag is a no-op.
-     */
-    waitForPhones?: boolean;
-    phoneTimeoutSec?: number;
-}
-export interface EmailToolOptions extends ToolOptions {
-    to: string | string[];
-    subject: string;
-    body: string;
-    from_domain?: string;
-    /** Sender mailbox / local-part. Defaults to `agent` (i.e. agent@from_domain). */
-    from_mailbox?: string;
-    /** Display name shown to the recipient, e.g. "Jane Doe" → "Jane Doe <jane@domain>". */
-    from_name?: string;
-    attachments?: Array<{
-        filename?: string;
-        content?: string;
-        url?: string;
-        content_type?: string;
-    }>;
-}
-export interface ResearchToolOptions extends ToolOptions {
-    topic: string;
-    depth?: 'deep' | 'quick';
-}
-export interface PeopleSearchOptions extends ToolOptions {
-    job_titles?: string[];
-    keywords?: string[];
-    companies?: string[];
-    company_domains?: string[];
-    location?: string[];
-    skills?: string[];
-    seniority?: string[];
-    industry?: string[];
-    company_size?: string;
-    limit?: number;
-}
-export interface EnrichProfileOptions extends ToolOptions {
-    linkedin_url?: string;
-    email?: string;
-    name?: string;
-    company_domain?: string;
-}
-export interface FindEmailOptions extends ToolOptions {
-    full_name?: string;
-    first_name?: string;
-    last_name?: string;
-    company_domain: string;
-}
-export interface VerifyEmailOptions extends ToolOptions {
-    email: string;
-}
-export interface DeepResearchPersonOptions extends ToolOptions {
-    email?: string;
-    social_media_url?: string;
-    name?: string;
-    company?: string;
-}
-export interface SocialProfilesOptions extends ToolOptions {
-    email?: string;
-    social_media_url?: string;
-}
-export interface ArticleSearchOptions extends ToolOptions {
-    name: string;
-    company: string;
-    sort?: 'recent' | 'popular';
-    limit?: number;
-}
-export interface PersonNewsfeedOptions extends ToolOptions {
-    social_media_url: string;
-}
-export interface PersonInterestsOptions extends ToolOptions {
-    email?: string;
-    phone?: string;
-    social_media_url?: string;
-}
-export interface PersonInteractionsOptions extends ToolOptions {
-    social_media_url: string;
-    type?: 'replies' | 'followers' | 'following' | 'followers,following';
-    max_results?: number;
-}
-export interface InboxListOptions {
-    since?: string;
-    limit?: number;
-    include_body?: boolean;
-}
-export interface ShippingAddress {
-    first_name: string;
-    last_name: string;
-    street: string;
-    street2?: string;
-    city: string;
-    state: string;
-    zip_code: string;
-    country?: string;
-    email?: string;
-    phone: string;
-}
-export interface CommerceBuyOptions extends ToolOptions {
-    product_url: string;
-    shipping_address: ShippingAddress;
-    quantity?: number;
-    variant_id?: string;
-}
-export interface CommerceSearchOptions extends ToolOptions {
-    query: string;
-    limit?: number;
-}
-export interface WebSearchOptions extends ToolOptions {
-    query: string;
-    max_results?: number;
-}
-export interface WebSearchResult {
-    query: string;
-    results: Array<{
-        url: string;
-        title: string;
-        description: string;
-    }>;
-    result_count: number;
-    memo?: string;
-    cost?: number;
-}
-export interface WebReadOptions extends ToolOptions {
-    /** URL of the web page to read */
-    url: string;
-}
-export interface WebReadResult {
-    request_id?: string;
-    url: string;
-    markdown: string;
-    screenshot_url?: string;
-    metadata?: {
-        title: string;
-        description: string;
-        statusCode?: number;
-    };
-    truncated?: boolean;
-    memo?: string;
-    cost?: number;
-}
-export interface VoiceCallOptions extends ToolOptions {
-    /** The objective of the call - what should the OneShot Agent accomplish */
-    objective: string;
-    /** Target phone number(s) in E.164 format. Array triggers conference mode analysis. */
-    target_number: string | string[];
-    /** Optional persona for the OneShot Agent caller */
-    caller_persona?: string;
-    /** Additional context about the call */
-    context?: string;
-    /** Maximum call duration in minutes (1-30) */
-    max_duration_minutes?: number;
-}
-export interface SmsOptions extends ToolOptions {
-    /** The SMS message body (max 1600 characters) */
-    message: string;
-    /** Target phone number(s) in E.164 format (max 10 recipients) */
-    to_number: string | string[];
-}
-export interface SmsInboxOptions {
-    /** Filter messages received after this ISO timestamp */
-    since?: string;
-    /** Maximum number of messages to return (default: 50, max: 100) */
-    limit?: number;
-    /** Filter by sender phone number */
-    from?: string;
-}
-export interface Experience {
-    company?: {
-        name?: string;
-        website?: string;
-    };
-    title?: {
-        name?: string;
-    };
-    start_date?: string;
-    end_date?: string;
-    is_primary?: boolean;
-}
-export interface Education {
-    school?: {
-        name?: string;
-    };
-    degrees?: string[];
-    majors?: string[];
-    start_date?: string;
-    end_date?: string;
-}
-export interface PersonResult {
-    full_name?: string;
-    first_name?: string;
-    last_name?: string;
-    title?: string;
-    company?: string;
-    company_domain?: string;
-    linkedin_url?: string;
-    location?: string;
-    email?: string;
-    phone?: string;
-    summary?: string;
-    skills?: string[];
-    experience?: Experience[];
-    education?: Education[];
-    fullphone?: Array<{
-        fullphone: string;
-    }>;
-    altemails?: string[];
-    best_work_email?: string | null;
-    best_personal_email?: string | null;
-}
-export interface PeopleSearchResult {
-    status: string;
-    results: PersonResult[];
-    total_found: number;
-    request_id?: string;
-    completed_at?: string;
-    filters?: Record<string, unknown>;
-    memo?: string;
-    cost?: number;
-}
-export interface ResearchResult {
-    request_id?: string;
-    report_content: string;
-    sources: Array<{
-        url: string;
-        title?: string;
-    }>;
-    sources_count: number;
-    topic: string;
-    depth: string;
-    workspace: string;
-    report_path: string;
-    completed_at: string;
-    report_gcs_uri: string;
-    memo?: string;
-    cost?: number;
-}
-export interface EmailResult {
-    request_id?: string;
-    status: string;
-    timeline?: Array<Record<string, unknown>>;
-    error?: string;
-    email?: {
-        id: string;
-        provider_message_id: string;
-        status: string;
-    };
-    domain?: {
-        domain: string;
-        status: string;
-        was_provisioned: boolean;
-    };
-    memo?: string;
-    cost?: number;
-}
-export interface EnrichProfileResult {
-    status: string;
-    profile: PersonResult;
-    request_id?: string;
-    completed_at?: string;
-    memo?: string;
-    cost?: number;
-}
-export interface FindEmailResult {
-    status: string;
-    email: string | null;
-    found: boolean;
-    full_name?: string;
-    company_domain?: string;
-    request_id?: string;
-    completed_at?: string;
-    memo?: string;
-    cost?: number;
-}
-export interface AsyncJobResult {
-    request_id: string;
-    status: string;
-}
-/** Enrichment data nested inside deep research and enrichment responses. */
-export interface PersonEnrichment {
-    displayname?: string;
-    firstname?: string;
-    lastname?: string;
-    bio?: string;
-    location?: string;
-    altemails?: string[];
-    best_work_email?: string;
-    best_personal_email?: string;
-    fullphone?: Array<{
-        fullphone: string;
-        type: string;
-    }>;
-    organizations?: Array<{
-        name?: string;
-        title?: string;
-        startDate?: string;
-        endDate?: string;
-        endDate_formatted?: {
-            is_current: boolean;
-        };
-    }>;
-    schools_info?: Array<{
-        name?: string;
-        degree?: string;
-        title?: string;
-    }>;
-    social_profiles?: Record<string, {
-        url?: string;
-        username?: string;
-        followers?: number;
-    }>;
-    newsfeed?: Array<{
-        source?: string;
-        type?: string;
-        content?: string;
-        date_posted?: string;
-        engagement?: {
-            likes?: number;
-            replies?: number;
-            shares?: number;
-        };
-    }>;
-}
-export interface DeepResearchPersonResult {
-    status: string;
-    result: {
-        enrichment: PersonEnrichment;
-        following?: Record<string, unknown>[];
-        articles?: Array<{
-            title?: string;
-            url?: string;
-            source?: string;
-            published_date?: string;
-            snippet?: string;
-        }>;
-        dossier?: Record<string, unknown>;
-    };
-    request_id: string;
-    completed_at: string;
-    memo?: string;
-    cost?: number;
-}
-export interface SocialProfilesResult {
-    status: string;
-    result: Record<string, {
-        url?: string;
-        username?: string;
-        followers?: number;
-        bio?: string;
-    }>;
-    request_id: string;
-    completed_at: string;
-    memo?: string;
-    cost?: number;
-}
-export interface ArticleSearchResult {
-    status: string;
-    result: Array<{
-        title?: string;
-        url?: string;
-        source?: string;
-        published_date?: string;
-        snippet?: string;
-    }>;
-    request_id: string;
-    completed_at: string;
-    memo?: string;
-    cost?: number;
-}
-export interface PersonNewsfeedResult {
-    status: string;
-    result: Array<{
-        platform?: string;
-        content?: string;
-        url?: string;
-        posted_at?: string;
-        likes?: number;
-        replies?: number;
-        shares?: number;
-    }>;
-    request_id: string;
-    completed_at: string;
-    memo?: string;
-    cost?: number;
-}
-export interface PersonInterestsResult {
-    status: string;
-    result: Record<string, unknown>;
-    request_id: string;
-    completed_at: string;
-    memo?: string;
-    cost?: number;
-}
-export interface PersonInteractionsResult {
-    status: string;
-    result: {
-        followers?: Array<Record<string, unknown>>;
-        following?: Array<Record<string, unknown>>;
-        replies?: Array<Record<string, unknown>>;
-    };
-    request_id: string;
-    completed_at: string;
-    memo?: string;
-    cost?: number;
-}
-export interface VerifyEmailResult {
-    status: string;
-    email: string;
-    valid: boolean;
-    deliverable: boolean;
-    catch_all: boolean;
-    disposable: boolean;
-    request_id?: string;
-    completed_at?: string;
-    memo?: string;
-    cost?: number;
-}
-export interface InboxEmail {
-    id: string;
-    from: string;
-    subject: string;
-    received_at: string;
-    thread_id?: string;
-    body?: string;
-    body_html?: string;
-    attachments?: Array<{
-        filename: string;
-        content_type: string;
-        size: number;
-        content?: string;
-    }>;
-}
-export interface InboxListResult {
-    emails: InboxEmail[];
-    count: number;
-    has_more: boolean;
-    agent_id: string;
-}
-export interface CommerceQuote {
-    quote_id: string;
-    product_title: string;
-    subtotal: string;
-    shipping: string;
-    tax: string;
-    fee: string;
-    total: string;
-}
-export interface CommerceBuyResult {
-    request_id?: string;
-    status: string;
-    order_id: string;
-    order_status: string;
-    tracking_url?: string;
-    memo?: string;
-    cost?: number;
-}
-export interface CommerceSearchProduct {
-    product_url: string;
-    title: string;
-    price: number;
-    currency: string;
-    image_url?: string;
-    vendor?: string;
-    rating?: number;
-    review_count?: number;
-    in_stock?: boolean;
-    description?: string;
-}
-export interface CommerceSearchResult {
-    request_id?: string;
-    status: string;
-    query: string;
-    products: CommerceSearchProduct[];
-    count: number;
-    memo?: string;
-    cost?: number;
-}
-export interface VoiceQuote {
-    quote_id: string;
-    target_numbers: string[];
-    conference_mode: boolean;
-    objective_summary: string;
-    talking_points: string[];
-    success_criteria: string[];
-    estimated_duration_minutes: number;
-    complexity_score: number;
-    pipeline_fee: string;
-    phone_registration_fee: string;
-    estimated_call_cost: string;
-    total: string;
-    needs_phone_registration: boolean;
-    expires_at: string;
-}
-export interface VoiceCallResult {
-    request_id?: string;
-    status: string;
-    ended_reason?: string;
-    duration_seconds?: number;
-    transcript?: string;
-    summary?: string;
-    success_evaluation?: string;
-    structured_data?: Record<string, unknown>;
-    memo?: string;
-    cost?: number;
-    credit_issued?: number;
-}
-export interface SmsQuote {
-    quote_id: string;
-    recipient_count: number;
-    message_length: number;
-    segment_count: number;
-    per_message_rate: string;
-    messaging_fee: string;
-    phone_registration_fee: string;
-    total: string;
-    needs_phone_registration: boolean;
-    expires_at: string;
-}
-export interface SmsSendResult {
-    request_id?: string;
-    status: string;
-    sent: number;
-    failed: number;
-    total: number;
-    details: Array<{
-        to: string;
-        from?: string;
-        status: string;
-        message_sid?: string;
-        error?: string;
-    }>;
-    memo?: string;
-    cost?: number;
-}
-export interface SmsInboxMessage {
-    id: string;
-    from: string;
-    to: string;
-    body: string;
-    num_media: number;
-    media_urls?: string[];
-    thread_id?: string;
-    related_outbound_id?: string;
-    received_at: string;
-    created_at: string;
-}
-export interface SmsInboxResult {
-    messages: SmsInboxMessage[];
-    count: number;
-}
-export interface Notification {
-    id: string;
-    agentId: string;
-    type: 'job_completed' | 'job_failed' | 'voice_completed' | 'sms_completed' | 'credit_issued' | 'domain_expiring' | 'phone_expiring';
-    title: string;
-    body?: string;
-    metadata?: Record<string, unknown>;
-    read: boolean;
-    createdAt: string;
-}
-export interface NotificationsListOptions {
-    /** Only return unread notifications */
-    unread?: boolean;
-    /** Maximum number of notifications to return (default: 50, max: 100) */
-    limit?: number;
-}
-export interface NotificationsResult {
-    notifications: Notification[];
-    count: number;
-}
-export interface BuildProduct {
-    /** Product or business name */
-    name: string;
-    /** Description of the product/service (min 10 chars) */
-    description: string;
-    /** Industry category */
-    industry?: string;
-    /** Pricing information to display */
-    pricing?: string;
-}
-export interface BuildLeadCapture {
-    /** Enable lead capture form */
-    enabled: boolean;
-    /** Email to receive leads (defaults to agent inbox) */
-    inbox_email?: string;
-}
-export interface BuildBrand {
-    /** Primary brand color (hex format, e.g., #FF5733) */
-    primary_color?: string;
-    /** Font family preference */
-    font?: string;
-    /** Brand tone */
-    tone?: 'professional' | 'playful' | 'bold' | 'minimal';
-}
-export interface BuildImages {
-    /** Hero image URL */
-    hero?: string;
-    /** Logo image URL */
-    logo?: string;
-}
-export interface BuildOptions extends ToolOptions {
-    /** Website type */
-    type?: 'saas' | 'portfolio' | 'agency' | 'personal' | 'product' | 'funnel' | 'restaurant' | 'event';
-    /** Product/business information */
-    product: BuildProduct;
-    /** URL to analyze for content/inspiration */
-    source_url?: string;
-    /** Specific sections to include */
-    sections?: string[];
-    /** Lead capture configuration */
-    lead_capture?: BuildLeadCapture;
-    /** Brand customization */
-    brand?: BuildBrand;
-    /** Image URLs to use */
-    images?: BuildImages;
-    /** Custom domain (e.g., mysite.com) */
-    domain?: string;
-    /** Existing build ID to update */
-    build_id?: string;
-}
-export interface BuildQuote {
-    quote_id: string;
-    type: string;
-    product_name: string;
-    analysis: {
-        inferred_type: string;
-        estimated_sections: number;
-        estimated_ai_images: number;
-        needs_lead_capture: boolean;
-        needs_video: boolean;
-        video_type?: string;
-        complexity_score: number;
-        reasoning: string;
-    };
-    pricing: {
-        base_price: string;
-        extra_sections_fee: string;
-        ai_images_fee: string;
-        video_embed_fee: string;
-        lead_capture_fee: string;
-        source_analysis_fee: string;
-        custom_domain_fee: string;
-        total: string;
-    };
-    expires_at: string;
-}
-export interface BuildResult {
-    request_id?: string;
-    status: string;
-    success: boolean;
-    production_url?: string;
-    preview_url?: string;
-    design_score?: number;
-    iterations?: number;
-    v0_chat_id?: string;
-    vercel_deployment_id?: string;
-    vercel_project_id?: string;
-    github_repo?: string;
-    error?: string;
-    memo?: string;
-    cost?: number;
-}
-export interface BrowserTaskOptions extends ToolOptions {
-    /** Natural language instruction for what to do in the browser (min 10 chars) */
-    task: string;
-    /** JSON schema for structured output extraction */
-    output_schema?: Record<string, unknown>;
-    /** Initial URL to navigate to */
-    start_url?: string;
-    /** Restrict browsing to specific domains */
-    allowed_domains?: string[];
-    /** Reuse an existing browser session */
-    session_id?: string;
-    /** Persistent browser profile ID for reusing cookies/localStorage across sessions */
-    profile_id?: string;
-    /** Domain-scoped credentials for auto-login, e.g. { "github.com": "user:token" } */
-    secrets?: Record<string, string>;
-    /** Maximum browser steps (default: 50, max: 100) */
-    max_steps?: number;
-}
-export interface BrowserProfile {
-    id: string;
-    name: string;
-}
-export interface BrowserQuote {
-    quote_id: string;
-    task_preview: string;
-    estimated_steps: number;
-    max_steps: number;
-    estimated_cost: string;
-    has_output_schema: boolean;
-    start_url: string | null;
-    expires_at: string;
-}
-export interface BrowserResult {
-    request_id?: string;
-    output?: string | Record<string, unknown>;
-    steps?: Array<{
-        number: number;
-        goal: string;
-        url: string;
-    }>;
-    memo?: string;
-    cost?: number;
-    output_files?: string[];
-    browser_task_id?: string;
-    session_id?: string;
-}
-export interface UpdateBuildOptions extends ToolOptions {
-    /** Existing build ID to update (required) */
-    build_id: string;
-    /** Updated product/business information */
-    product: BuildProduct;
-    /** Website type (optional, defaults to existing) */
-    type?: 'saas' | 'portfolio' | 'agency' | 'personal' | 'product' | 'funnel' | 'restaurant' | 'event';
-    /** URL to analyze for content/inspiration */
-    source_url?: string;
-    /** Specific sections to include */
-    sections?: string[];
-    /** Lead capture configuration */
-    lead_capture?: BuildLeadCapture;
-    /** Brand customization */
-    brand?: BuildBrand;
-    /** Image URLs to use */
-    images?: BuildImages;
-    /** Custom domain */
-    domain?: string;
-}
-export interface SpendCategory {
-    category: string;
-    total: string;
-    count: number;
-    pct: number;
-}
-export interface SpendBreakdown {
-    categories: SpendCategory[];
-    total: string;
-    period_days: number;
-}
-export interface RoCSResult {
-    rocs: number;
-    total_spend: string;
-    total_value: string;
-    period_days: number;
-}
-export interface Receipt {
-    id: string;
-    receipt_id: string;
-    category: string;
-    subcategory: string;
-    amount_usdc: string;
-    service_fee: string;
-    provider_cost: string;
-    status: string;
-    settlement_tx: string | null;
-    value_tag: {
-        type: string;
-        amount?: number;
-        label?: string;
-    } | null;
-    job_id: string | null;
-    metadata: Record<string, unknown> | null;
-    created_at: string;
-    settled_at: string | null;
-}
-export interface ReceiptsListResult {
-    receipts: Receipt[];
-    count: number;
-    has_more: boolean;
-}
-export interface UnifiedBalance {
-    on_chain_balance: string;
-    credits_balance: string;
-    currency: string;
-    address: string;
-    chain_id: number;
-}
-export interface ComputeSchedule {
-    /** Cron expression (UTC). Minimum interval: 15 minutes. */
-    cron: string;
-    /** USDC budget per run */
-    budget_per_run: number;
-    /** Maximum number of runs (optional — runs indefinitely if omitted) */
-    max_runs?: number;
-}
-export interface ComputeOptions extends ToolOptions {
-    /** Natural language objective for the orchestrator */
-    objective: string;
-    /** Additional parameters / constraints */
-    params?: Record<string, unknown>;
-    /** Suggested budget in USDC (server will estimate if omitted) */
-    budget_usdc?: number;
-    /** ISO deadline for completion */
-    deadline?: string;
-    /** Route to a specific Soul agent */
-    soul_slug?: string;
-    /** Route to a specific Soul service */
-    soul_service_slug?: string;
-    /** Make this a recurring goal */
-    schedule?: ComputeSchedule;
-}
-export interface ComputeQuote {
-    quote_id: string;
-    objective_summary: string;
-    estimated_phases: number;
-    estimated_tasks: number;
-    estimated_duration_days: number;
-    budget_breakdown: Record<string, string>;
-    total_budget: string;
-    expires_at: string;
-    schedule_cron?: string;
-    budget_per_run?: number;
-    max_runs?: number;
-    projected_runs?: number;
-}
-export interface ComputeGoalResult {
-    goal_id: string;
-    request_id: string;
-    receipt_id?: string;
-    status: string;
-    message: string;
-    memo?: string;
-    cost?: number;
-    goal: {
-        objective: string;
-        budget_usdc: string;
-        deadline?: string;
-        schedule_cron?: string;
-        budget_per_run?: number;
-        max_runs?: number;
-        next_run_at?: string;
-    };
-}
-export interface ComputeGoalStatus {
-    id: string;
-    status: string;
-    name: string;
-    objective: string;
-    current_phase: number | null;
-    plan: unknown;
-    budget: {
-        total: string;
-        spent: string;
-        reserved: string;
-        remaining: string;
-    } | null;
-    soul_agent_id: string | null;
-    deadline: string | null;
-    started_at: string | null;
-    completed_at: string | null;
-    last_wake_at: string | null;
-    next_wake_at: string | null;
-    created_at: string;
-    schedule?: {
-        cron: string;
-        budget_per_run: string;
-        max_runs: number | null;
-        run_count: number;
-        last_run_at: string | null;
-        next_run_at: string | null;
-    };
-}
-export interface ComputeTask {
-    id: string;
-    task_type: string;
-    tool: string | null;
-    description: string;
-    status: string;
-    phase: number | null;
-    sequence: number | null;
-    progress_pct: number | null;
-    progress_message: string | null;
-    result: unknown;
-    quoted_usdc: string | null;
-    actual_usdc: string | null;
-    run_number: number | null;
-    started_at: string | null;
-    completed_at: string | null;
-    created_at: string;
-}
-export interface ComputeBudgetStatus {
-    budgetId: string;
-    goalId: string;
-    totalBudgetUsdc: string;
-    spentUsdc: string;
-    reservedUsdc: string;
-    remainingUsdc: string;
-    spend_entries: Array<{
-        category: string;
-        amount_usdc: string;
-        description: string;
-        created_at: string;
-    }>;
-}
+export * from './errors';
+export * from './types';
+import type { OneShotConfig, ToolOptions, EmailToolOptions, ResearchToolOptions, PeopleSearchOptions, EnrichProfileOptions, FindEmailOptions, VerifyEmailOptions, DeepResearchPersonOptions, SocialProfilesOptions, ArticleSearchOptions, PersonNewsfeedOptions, PersonInterestsOptions, PersonInteractionsOptions, InboxListOptions, CommerceBuyOptions, CommerceSearchOptions, WebSearchOptions, WebSearchResult, WebReadOptions, WebReadResult, VoiceCallOptions, SmsOptions, SmsInboxOptions, PeopleSearchResult, ResearchResult, EmailResult, EnrichProfileResult, FindEmailResult, DeepResearchPersonResult, SocialProfilesResult, ArticleSearchResult, PersonNewsfeedResult, PersonInterestsResult, PersonInteractionsResult, VerifyEmailResult, InboxEmail, InboxListResult, CommerceBuyResult, CommerceSearchResult, VoiceCallResult, SmsSendResult, SmsInboxMessage, SmsInboxResult, NotificationsListOptions, NotificationsResult, BuildOptions, BuildResult, BrowserTaskOptions, BrowserProfile, BrowserResult, UpdateBuildOptions, SpendBreakdown, RoCSResult, ReceiptsListResult, UnifiedBalance, ComputeOptions, ComputeGoalResult, ComputeGoalStatus, ComputeTask, ComputeBudgetStatus, DomainPoolListResult, DomainPoolStatusResult } from './types';
 /**
  * OneShot Agent SDK - Execute commercial transactions with automatic x402 payments.
  *
@@ -1090,6 +50,12 @@ export declare class OneShot {
     get slippage(): number;
     tool<T = unknown>(toolName: string, options: ToolOptions & Record<string, unknown>): Promise<T>;
     email(options: EmailToolOptions): Promise<EmailResult>;
+    /** List the caller's domain pool with warmup and rotation metadata. */
+    listDomains(): Promise<DomainPoolListResult>;
+    /** Take a domain out of rotation without releasing it. */
+    pauseDomain(domain: string): Promise<DomainPoolStatusResult>;
+    /** Put a paused domain back into rotation. */
+    resumeDomain(domain: string): Promise<DomainPoolStatusResult>;
     research(options: ResearchToolOptions): Promise<ResearchResult>;
     peopleSearch(options: PeopleSearchOptions): Promise<PeopleSearchResult>;
     enrichProfile(options: EnrichProfileOptions): Promise<EnrichProfileResult>;
@@ -1374,7 +340,10 @@ export declare class OneShot {
         run_count: number;
     }>;
     /**
-     * Top up budget for a recurring compute goal
+     * Top up budget for a recurring compute goal.
+     *
+     * Uses the quote-then-pay flow: the first call gets a 402 with the top-up price,
+     * the second call (with payment) credits the budget. The amount IS the price.
      *
      * @example
      * ```typescript
@@ -1447,12 +416,20 @@ export declare class OneShot {
     private log;
     private validate;
     private headers;
+    /**
+     * Header that asks the API to reject the request when the computed quote
+     * exceeds the caller-supplied cap (commit 8f328a7). The SDK still does its
+     * own local `quote.total > maxCost` check after the 402 returns — this is
+     * a server-side enforcement layer so non-SDK callers (MCP server, custom
+     * integrations) can't ignore the cap.
+     */
+    private maxCostHeader;
     private executeToolRequest;
     private pollJob;
     /**
-     * Detects whether a job result is still waiting for Apollo's async phone
-     * reveal. The worker sets `result.phones_pending=true` when an enrichment
-     * was Apollo-sourced and Apollo's webhook URL is configured. The webhook
+     * Detects whether a job result is still waiting for an async phone reveal.
+     * The worker sets `result.phones_pending=true` when the upstream enrichment
+     * has a pending async webhook and the webhook URL is configured; the webhook
      * handler flips it to false (or removes it) once phones arrive.
      *
      * Tolerates two shapes: the unwrapped result `{phones_pending}` and the
@@ -1460,11 +437,12 @@ export declare class OneShot {
      */
     private _isPhonesPending;
     /**
-     * Slow poll loop that waits for Apollo phone-reveal callbacks to arrive
-     * via the webhook handler (which UPDATEs jobs.result_data.result.phones).
-     * Polls GET /v1/requests/{id} every 5s — Apollo says "several minutes" so
-     * a tight loop wastes API calls. Returns the latest snapshot whether or
-     * not phones arrived (consumer can re-check `phones_pending`).
+     * Slow poll loop that waits for async phone-reveal callbacks to arrive via
+     * the webhook handler (which UPDATEs jobs.result_data.result.phones). Polls
+     * GET /v1/requests/{id} every 5s — the upstream provider can take several
+     * minutes to deliver, so a tight loop just wastes API calls. Returns the
+     * latest snapshot whether or not phones arrived (consumer can re-check
+     * `phones_pending`).
      */
     private _pollForPhones;
     private waitViaWebSocket;