@the_ro_show/agent-ads-sdk 0.17.1 → 0.18.0

package/dist/index.d.mts

@@ -14,6 +14,10 @@ interface AgentSignupResponse {
     agent_id: string;
     api_key: string;
     test_api_key: string;
+    /** Live API key (v2 field, same value as api_key) */
+    api_key_live?: string;
+    /** Test API key (v2 field, same value as test_api_key) */
+    api_key_test?: string;
     created_at: string;
 }
 interface DecideRequest {
@@ -166,6 +170,12 @@ interface DecideFromContextRequest {
      * optimizeFor: 'relevance'  // Prioritize best semantic match over highest bid
      */
     optimizeFor?: 'revenue' | 'relevance';
+    /**
+     * Maximum time in milliseconds to wait for an ad response.
+     * Useful for latency-sensitive applications.
+     * @since v0.18.0
+     */
+    maxWaitMs?: number;
 }
 interface DecideResponse {
     request_id?: string;
@@ -279,7 +289,7 @@ interface ToolCall {
     url: string;
     headers?: Record<string, string>;
 }
-type EventType = 'impression' | 'click' | 'action' | 'conversion' | 'dismiss' | 'hide_advertiser' | 'report' | 'feedback';
+type EventType = 'impression' | 'click' | 'action' | 'conversion' | 'dismiss' | 'hide_advertiser' | 'report' | 'feedback' | 'ad_shown' | 'ad_dismissed' | 'agent_call';
 interface EventIngestRequest {
     event_id: string;
     occurred_at: string;
@@ -423,6 +433,12 @@ interface PolicyResponse {
         blocked_categories: string[];
     };
     unit_rules: Record<string, unknown>;
+    /** Rate limits (optional, returned by expanded backend) */
+    rate_limits?: Record<string, unknown>;
+    /** Supported ad types (optional) */
+    supported_ad_types?: string[];
+    /** Feature flags (optional) */
+    features?: Record<string, boolean>;
 }
 interface APIError {
     error: string;
@@ -774,6 +790,624 @@ interface GetCategoriesParams {
     /** Search by name or path (case-insensitive) */
     search?: string;
 }
+interface CapabilitySessionInitiateRequest {
+    /** Type of capability session */
+    capability_type: string;
+    /** Initial configuration for the session */
+    config?: Record<string, unknown>;
+    /** Optional metadata */
+    metadata?: Record<string, unknown>;
+}
+interface CapabilitySessionInitiateResponse {
+    session_id: string;
+    status: 'initiated' | 'ready';
+    capability_type: string;
+    created_at: string;
+}
+interface CapabilitySessionMessageRequest {
+    /** Session ID from initiate response */
+    session_id: string;
+    /** Message content to send */
+    message: string;
+    /** Optional attachments or context */
+    attachments?: Record<string, unknown>[];
+}
+interface CapabilitySessionMessageResponse {
+    session_id: string;
+    message_id: string;
+    response: string;
+    /** Structured data from the capability */
+    data?: Record<string, unknown>;
+    status: 'completed' | 'pending' | 'error';
+}
+interface CapabilitySessionEndRequest {
+    /** Session ID to end */
+    session_id: string;
+    /** Optional reason for ending */
+    reason?: string;
+}
+interface CapabilitySessionEndResponse {
+    session_id: string;
+    status: 'ended';
+    /** Summary of the session */
+    summary?: string;
+    /** Total messages exchanged */
+    message_count?: number;
+}
+interface CapabilitySessionConnectGitHubRequest {
+    /** Session ID */
+    session_id: string;
+    /** GitHub repository URL or owner/repo */
+    repository: string;
+    /** Optional branch */
+    branch?: string;
+}
+interface CapabilitySessionConnectGitHubResponse {
+    session_id: string;
+    status: 'connected' | 'error';
+    repository: string;
+    branch?: string;
+}
+interface DeveloperLoginRequest {
+    email: string;
+    password: string;
+}
+interface DeveloperLoginResponse {
+    session_token: string;
+    developer_id: string;
+    email: string;
+    expires_at: string;
+}
+interface DeveloperDataResponse {
+    developer_id: string;
+    email: string;
+    agent_name: string;
+    created_at: string;
+    api_key_live: string;
+    api_key_test: string;
+    settings?: Record<string, unknown>;
+}
+interface DeveloperEarningsResponse {
+    balances: {
+        available: number;
+        pending: number;
+        lifetime: number;
+    };
+    payout_info: {
+        method?: string;
+        last_payout_at?: string;
+        next_payout_at?: string;
+    };
+    recent_earnings: Array<{
+        date: string;
+        amount: number;
+        source: string;
+        campaign_id?: string;
+    }>;
+    payouts: Array<{
+        id: string;
+        amount: number;
+        status: string;
+        created_at: string;
+    }>;
+}
+interface DeveloperStatsRequest {
+    /** Time period for stats */
+    period?: '7d' | '30d' | '90d' | 'all';
+}
+interface DeveloperStatsResponse {
+    period: string;
+    impressions: number;
+    clicks: number;
+    conversions: number;
+    earnings: number;
+    ctr: number;
+    fill_rate: number;
+}
+interface DeveloperAnalyticsRequest {
+    session_token: string;
+    /** Start date (ISO 8601) */
+    start_date?: string;
+    /** End date (ISO 8601) */
+    end_date?: string;
+    /** Group by dimension */
+    group_by?: 'day' | 'week' | 'month' | 'campaign';
+}
+interface DeveloperAnalyticsResponse {
+    data: Array<{
+        period: string;
+        impressions: number;
+        clicks: number;
+        conversions: number;
+        earnings: number;
+    }>;
+    totals: {
+        impressions: number;
+        clicks: number;
+        conversions: number;
+        earnings: number;
+    };
+}
+interface RegenerateKeysRequest {
+    session_token: string;
+    /** Which key to regenerate */
+    key_type: 'live' | 'test' | 'both';
+}
+interface RegenerateKeysResponse {
+    api_key_live?: string;
+    api_key_test?: string;
+    regenerated_at: string;
+}
+interface AdvertiserSignupRequest {
+    email: string;
+    password: string;
+    company_name: string;
+    website?: string;
+}
+interface AdvertiserSignupResponse {
+    advertiser_id: string;
+    email: string;
+    company_name: string;
+    session_token: string;
+    created_at: string;
+}
+interface AdvertiserLoginRequest {
+    email: string;
+    password: string;
+}
+interface AdvertiserLoginResponse {
+    session_token: string;
+    advertiser_id: string;
+    email: string;
+    company_name: string;
+    expires_at: string;
+}
+interface AdvertiserStatsRequest {
+    /** Advertiser API key or ID for lookup */
+    advertiser_key?: string;
+    /** Time period */
+    period?: '7d' | '30d' | '90d' | 'all';
+}
+interface AdvertiserStatsResponse {
+    budget: {
+        total: number;
+        spent: number;
+        remaining: number;
+    };
+    metrics: {
+        impressions: number;
+        clicks: number;
+        conversions: number;
+        ctr: number;
+        cpc_avg: number;
+    };
+    campaigns: Array<{
+        campaign_id: string;
+        name: string;
+        status: string;
+        budget_spent: number;
+        impressions: number;
+        clicks: number;
+    }>;
+}
+interface AdvertiserAnalyticsRequest {
+    session_token: string;
+    start_date?: string;
+    end_date?: string;
+    group_by?: 'day' | 'week' | 'month' | 'campaign';
+}
+interface AdvertiserAnalyticsResponse {
+    data: Array<{
+        period: string;
+        impressions: number;
+        clicks: number;
+        conversions: number;
+        spend: number;
+    }>;
+    totals: {
+        impressions: number;
+        clicks: number;
+        conversions: number;
+        spend: number;
+    };
+}
+interface CampaignCreateRequest {
+    /** Campaign name */
+    name: string;
+    /** Ad type */
+    ad_type: AdType;
+    /** Daily budget in cents */
+    daily_budget: number;
+    /** Bid amount in cents */
+    bid_amount: number;
+    /** Target taxonomy/categories */
+    target_categories?: string[];
+    /** Target countries */
+    target_countries?: string[];
+    /** Creative content */
+    creative: {
+        title: string;
+        body: string;
+        cta: string;
+        landing_url: string;
+    };
+    /** Recommendation ad fields */
+    teaser?: string;
+    promo_code?: string;
+    /** Service ad fields */
+    service_endpoint?: string;
+    service_description?: string;
+}
+interface CampaignCreateResponse {
+    campaign_id: string;
+    status: 'active' | 'pending_review';
+    created_at: string;
+}
+interface CampaignUpdateRequest {
+    /** Campaign ID to update */
+    campaign_id: string;
+    /** Session token for auth */
+    session_token: string;
+    /** Fields to update (partial) */
+    updates: Partial<Omit<CampaignCreateRequest, 'ad_type'>>;
+    /** Set campaign status */
+    status?: 'active' | 'paused';
+}
+interface CampaignUpdateResponse {
+    campaign_id: string;
+    status: string;
+    updated_at: string;
+}
+interface ScrapeSiteRequest {
+    /** URL to scrape */
+    url: string;
+    /** Maximum depth of pages to follow */
+    max_depth?: number;
+    /** Maximum number of pages */
+    max_pages?: number;
+    /** CSS selectors to extract */
+    selectors?: string[];
+}
+interface ScrapeSiteResponse {
+    job_id: string;
+    status: 'queued' | 'processing' | 'completed' | 'failed';
+    pages_scraped?: number;
+    content?: Array<{
+        url: string;
+        title: string;
+        text: string;
+    }>;
+}
+interface TrainAgentRequest {
+    /** Agent ID to train */
+    agent_id: string;
+    /** Training data: documents, Q&A pairs, etc. */
+    training_data: Array<{
+        type: 'document' | 'qa_pair' | 'instruction';
+        content: string;
+        metadata?: Record<string, unknown>;
+    }>;
+    /** Training configuration */
+    config?: {
+        /** Override existing training */
+        replace?: boolean;
+    };
+}
+interface TrainAgentResponse {
+    job_id: string;
+    status: 'queued' | 'processing' | 'completed' | 'failed';
+    items_processed?: number;
+    message?: string;
+}
+interface AgentSignupV2Request {
+    owner_email: string;
+    agent_name: string;
+    /** Agent description */
+    description?: string;
+    /** Agent website URL */
+    website?: string;
+    /** SDK platform */
+    sdk?: 'typescript' | 'python' | 'other';
+    /** Deployment environment */
+    environment?: 'test' | 'live';
+    /** Declared ad placements */
+    declared_placements?: PlacementType[];
+    /** Declared capabilities */
+    declared_capabilities?: string[];
+    /** Monthly estimated traffic */
+    estimated_traffic?: number;
+}
+interface AgentSignupV2Response {
+    agent_id: string;
+    api_key_live: string;
+    api_key_test: string;
+    /** @deprecated Use api_key_live */
+    api_key: string;
+    /** @deprecated Use api_key_test */
+    test_api_key: string;
+    created_at: string;
+    status: 'active' | 'pending_review';
+}
+interface TrackCallRequest {
+    /** Tracking token from the ad */
+    token: string;
+    /** Optional metadata about the call */
+    metadata?: Record<string, unknown>;
+}
+interface TrackCallResponse {
+    status: 'tracked';
+    token: string;
+}
+
+/**
+ * HTTP client with retry logic, timeout handling, and authentication.
+ * Retry policy: only on 408, 429, 500, 502, 503, 504
+ * Max retries: 2 (configurable)
+ * Backoff: exponential with jitter
+ */
+interface HTTPClientConfig {
+    apiKey?: string;
+    supabaseAnonKey?: string;
+    baseUrl: string;
+    timeoutMs: number;
+    maxRetries: number;
+}
+declare class HTTPClient {
+    private config;
+    constructor(config: HTTPClientConfig);
+    /** Expose the API key so sub-clients can re-use it in different headers */
+    get apiKey(): string | undefined;
+    request<T>(method: 'GET' | 'POST', path: string, options?: {
+        body?: unknown;
+        headers?: Record<string, string>;
+        idempotencyKey?: string;
+        skipDefaultAuth?: boolean;
+    }): Promise<T>;
+    private makeRequest;
+    private shouldRetry;
+    private backoff;
+}
+
+/**
+ * Capability Session sub-client.
+ * Manages multi-turn AI sessions via the capability-session endpoint.
+ * All methods use standard X-AM-API-Key auth.
+ */
+
+declare class SessionClient {
+    private http;
+    constructor(http: HTTPClient);
+    /**
+     * Initiate a new capability session.
+     *
+     * @example
+     * ```typescript
+     * const session = await client.sessions.initiate({
+     *   capability_type: 'code_review',
+     *   config: { language: 'typescript' }
+     * });
+     * console.log(session.session_id);
+     * ```
+     */
+    initiate(request: CapabilitySessionInitiateRequest): Promise<CapabilitySessionInitiateResponse>;
+    /**
+     * Send a message within an existing capability session.
+     *
+     * @example
+     * ```typescript
+     * const response = await client.sessions.sendMessage({
+     *   session_id: 'sess_abc123',
+     *   message: 'Review this function for bugs'
+     * });
+     * console.log(response.response);
+     * ```
+     */
+    sendMessage(request: CapabilitySessionMessageRequest): Promise<CapabilitySessionMessageResponse>;
+    /**
+     * End a capability session.
+     *
+     * @example
+     * ```typescript
+     * const result = await client.sessions.end({
+     *   session_id: 'sess_abc123',
+     *   reason: 'task_completed'
+     * });
+     * ```
+     */
+    end(request: CapabilitySessionEndRequest): Promise<CapabilitySessionEndResponse>;
+    /**
+     * Connect a GitHub repository to the capability session.
+     *
+     * @example
+     * ```typescript
+     * const result = await client.sessions.connectGitHub({
+     *   session_id: 'sess_abc123',
+     *   repository: 'owner/repo',
+     *   branch: 'main'
+     * });
+     * ```
+     */
+    connectGitHub(request: CapabilitySessionConnectGitHubRequest): Promise<CapabilitySessionConnectGitHubResponse>;
+}
+
+/**
+ * Developer Portal sub-client.
+ * Manages developer authentication, data, earnings, stats, and analytics.
+ * Mixed auth patterns: some endpoints need no auth, others use X-API-Key or X-AM-API-Key.
+ */
+
+declare class DeveloperClient {
+    private http;
+    constructor(http: HTTPClient);
+    /**
+     * Log in as a developer. Returns a session token for subsequent calls.
+     * No API key auth needed for this endpoint.
+     *
+     * @example
+     * ```typescript
+     * const session = await client.developer.login({
+     *   email: 'dev@example.com',
+     *   password: 'secret'
+     * });
+     * console.log(session.session_token);
+     * ```
+     */
+    login(request: DeveloperLoginRequest): Promise<DeveloperLoginResponse>;
+    /**
+     * Get developer account data using a session token.
+     * No default API key auth — uses session token in body.
+     *
+     * @example
+     * ```typescript
+     * const data = await client.developer.getData('session_token_here');
+     * console.log(data.agent_name);
+     * ```
+     */
+    getData(sessionToken: string): Promise<DeveloperDataResponse>;
+    /**
+     * Get developer earnings. Uses X-API-Key header (not X-AM-API-Key).
+     *
+     * @example
+     * ```typescript
+     * const earnings = await client.developer.getEarnings();
+     * console.log(earnings.balances.available);
+     * ```
+     */
+    getEarnings(): Promise<DeveloperEarningsResponse>;
+    /**
+     * Get developer stats. Uses standard X-AM-API-Key auth.
+     *
+     * @example
+     * ```typescript
+     * const stats = await client.developer.getStats({ period: '30d' });
+     * console.log(stats.impressions, stats.clicks);
+     * ```
+     */
+    getStats(params?: DeveloperStatsRequest): Promise<DeveloperStatsResponse>;
+    /**
+     * Get developer analytics. Uses session token in body (no default auth).
+     *
+     * @example
+     * ```typescript
+     * const analytics = await client.developer.getAnalytics('session_token', {
+     *   start_date: '2026-01-01',
+     *   group_by: 'week'
+     * });
+     * ```
+     */
+    getAnalytics(sessionToken: string, params?: Omit<DeveloperAnalyticsRequest, 'session_token'>): Promise<DeveloperAnalyticsResponse>;
+    /**
+     * Regenerate API keys. Uses session token in body (no default auth).
+     *
+     * @example
+     * ```typescript
+     * const newKeys = await client.developer.regenerateKeys({
+     *   session_token: 'session_token_here',
+     *   key_type: 'test'
+     * });
+     * console.log(newKeys.api_key_test);
+     * ```
+     */
+    regenerateKeys(request: RegenerateKeysRequest): Promise<RegenerateKeysResponse>;
+}
+
+/**
+ * Advertiser Portal sub-client.
+ * Manages advertiser authentication, stats, analytics, and campaign management.
+ * Mixed auth patterns including JWT for campaign creation.
+ */
+
+declare class AdvertiserClient {
+    private http;
+    constructor(http: HTTPClient);
+    /**
+     * Sign up as a new advertiser. No API key auth needed.
+     *
+     * @example
+     * ```typescript
+     * const account = await client.advertiser.signup({
+     *   email: 'ads@company.com',
+     *   password: 'secure123',
+     *   company_name: 'Acme Corp'
+     * });
+     * console.log(account.advertiser_id);
+     * ```
+     */
+    signup(request: AdvertiserSignupRequest): Promise<AdvertiserSignupResponse>;
+    /**
+     * Log in as an advertiser. Returns a session token.
+     * No API key auth needed.
+     *
+     * @example
+     * ```typescript
+     * const session = await client.advertiser.login({
+     *   email: 'ads@company.com',
+     *   password: 'secure123'
+     * });
+     * console.log(session.session_token);
+     * ```
+     */
+    login(request: AdvertiserLoginRequest): Promise<AdvertiserLoginResponse>;
+    /**
+     * Get advertiser stats. Uses X-Advertiser-Key header or query param.
+     *
+     * @example
+     * ```typescript
+     * const stats = await client.advertiser.getStats({
+     *   advertiser_key: 'adv_key_123',
+     *   period: '30d'
+     * });
+     * console.log(stats.budget.remaining);
+     * ```
+     */
+    getStats(params?: AdvertiserStatsRequest): Promise<AdvertiserStatsResponse>;
+    /**
+     * Get advertiser analytics. Uses session token in body (no default auth).
+     *
+     * @example
+     * ```typescript
+     * const analytics = await client.advertiser.getAnalytics('session_token', {
+     *   start_date: '2026-01-01',
+     *   group_by: 'week'
+     * });
+     * ```
+     */
+    getAnalytics(sessionToken: string, params?: Omit<AdvertiserAnalyticsRequest, 'session_token'>): Promise<AdvertiserAnalyticsResponse>;
+    /**
+     * Create a new campaign. Uses JWT bearer token for auth.
+     *
+     * @example
+     * ```typescript
+     * const campaign = await client.advertiser.createCampaign('jwt_token', {
+     *   name: 'Summer Sale',
+     *   ad_type: 'link',
+     *   daily_budget: 5000,
+     *   bid_amount: 100,
+     *   creative: {
+     *     title: 'Summer Sale - 50% Off',
+     *     body: 'Limited time offer',
+     *     cta: 'Shop Now',
+     *     landing_url: 'https://example.com/sale'
+     *   }
+     * });
+     * ```
+     */
+    createCampaign(jwt: string, request: CampaignCreateRequest): Promise<CampaignCreateResponse>;
+    /**
+     * Update an existing campaign. Uses session token in body (no default auth).
+     *
+     * @example
+     * ```typescript
+     * const result = await client.advertiser.updateCampaign({
+     *   campaign_id: 'camp_123',
+     *   session_token: 'session_token',
+     *   updates: { name: 'Updated Campaign Name' },
+     *   status: 'paused'
+     * });
+     * ```
+     */
+    updateCampaign(request: CampaignUpdateRequest): Promise<CampaignUpdateResponse>;
+}
 
 /**
  * Utility functions for the AttentionMarket SDK.
@@ -908,6 +1542,12 @@ declare class AttentionMarketClient {
     private http;
     private agentId;
     private appId;
+    /** Capability session management (multi-turn AI sessions) */
+    readonly sessions: SessionClient;
+    /** Developer portal (login, earnings, stats, analytics) */
+    readonly developer: DeveloperClient;
+    /** Advertiser portal (signup, login, campaigns, stats) */
+    readonly advertiser: AdvertiserClient;
     constructor(config: SDKConfig);
     /**
      * Validate SDK configuration for security
@@ -1203,6 +1843,59 @@ declare class AttentionMarketClient {
      * ```
      */
     getCategories(params?: GetCategoriesParams): Promise<CategoryTaxonomyResponse>;
+    /**
+     * Sign up a new agent using the v2 endpoint.
+     * Static method — no API key needed.
+     *
+     * @example
+     * ```typescript
+     * const agent = await AttentionMarketClient.signupAgentV2({
+     *   owner_email: 'dev@example.com',
+     *   agent_name: 'My Agent',
+     *   sdk: 'typescript'
+     * });
+     * console.log(agent.api_key_live);
+     * ```
+     */
+    static signupAgentV2(request: AgentSignupV2Request, baseUrl?: string): Promise<AgentSignupV2Response>;
+    /**
+     * Track an agent-to-agent call using a tracking token.
+     *
+     * @example
+     * ```typescript
+     * await client.trackCall('trk_abc123', { model: 'gpt-4' });
+     * ```
+     */
+    trackCall(token: string, metadata?: Record<string, unknown>): Promise<TrackCallResponse>;
+    /**
+     * Scrape a website for knowledge base content.
+     * Requires Bearer JWT and an OpenAI API key header.
+     *
+     * @example
+     * ```typescript
+     * const result = await client.scrapeSite(
+     *   { url: 'https://example.com', max_pages: 10 },
+     *   'jwt_token',
+     *   'sk-openai-key'
+     * );
+     * ```
+     */
+    scrapeSite(request: ScrapeSiteRequest, jwt: string, openaiKey: string): Promise<ScrapeSiteResponse>;
+    /**
+     * Train an agent with custom knowledge.
+     * No default auth — agent ID is in the request body.
+     *
+     * @example
+     * ```typescript
+     * const result = await client.trainAgent({
+     *   agent_id: 'agt_123',
+     *   training_data: [
+     *     { type: 'document', content: 'Product FAQ...' }
+     *   ]
+     * });
+     * ```
+     */
+    trainAgent(request: TrainAgentRequest): Promise<TrainAgentResponse>;
 }
 
 /**
@@ -1607,4 +2300,4 @@ declare function getVertical(taxonomy: string): string | null;
  */
 declare function suggestTaxonomies(query: string): string[];
 
-export { type APIError, APIRequestError, type AdResponse, type AdScore, type AdUnit, type AgentSignupRequest, type AgentSignupResponse, AttentionMarketClient, AttentionMarketError, type Constraints, type Context, type CreateImpressionEventParams, type CreateOpportunityParams, type DecideFromContextRequest, type DecideRequest, type DecideResponse, type Disclosure, type EventIngestRequest, type EventIngestResponse, type EventType, type FormattedAd, type Intent, MockAttentionMarketClient, type MockClientConfig, type NaturalFormatOptions, NetworkError, type OfferResponse, type Opportunity, type ParsedTaxonomy, type Placement, type PlacementType, type PolicyResponse, type Privacy, type RequestOfferFromContextParams, type RequestOfferParams, type SDKConfig, type SanitizeURLOptions, type SponsoredSuggestion, type SponsoredTool, type TaxonomyIntent, TimeoutError, type ToolCall, type Tracking, buildTaxonomy, createImpressionEvent, createOpportunity, detectIntent, escapeHTML, formatInlineMention, formatNatural, generateTimestamp, generateUUID, getBaseTaxonomy, getVertical, isValidTaxonomy, matchesTaxonomy, parseTaxonomy, sanitizeURL, suggestTaxonomies, validateAdFits };
+export { type APIError, APIRequestError, type AdResponse, type AdScore, type AdUnit, type AdvertiserAnalyticsRequest, type AdvertiserAnalyticsResponse, AdvertiserClient, type AdvertiserLoginRequest, type AdvertiserLoginResponse, type AdvertiserSignupRequest, type AdvertiserSignupResponse, type AdvertiserStatsRequest, type AdvertiserStatsResponse, type AgentSignupRequest, type AgentSignupResponse, type AgentSignupV2Request, type AgentSignupV2Response, AttentionMarketClient, AttentionMarketError, type CampaignCreateRequest, type CampaignCreateResponse, type CampaignUpdateRequest, type CampaignUpdateResponse, type CapabilitySessionConnectGitHubRequest, type CapabilitySessionConnectGitHubResponse, type CapabilitySessionEndRequest, type CapabilitySessionEndResponse, type CapabilitySessionInitiateRequest, type CapabilitySessionInitiateResponse, type CapabilitySessionMessageRequest, type CapabilitySessionMessageResponse, type Constraints, type Context, type CreateImpressionEventParams, type CreateOpportunityParams, type DecideFromContextRequest, type DecideRequest, type DecideResponse, type DeveloperAnalyticsRequest, type DeveloperAnalyticsResponse, DeveloperClient, type DeveloperDataResponse, type DeveloperEarningsResponse, type DeveloperLoginRequest, type DeveloperLoginResponse, type DeveloperStatsRequest, type DeveloperStatsResponse, type Disclosure, type EventIngestRequest, type EventIngestResponse, type EventType, type FormattedAd, type Intent, MockAttentionMarketClient, type MockClientConfig, type NaturalFormatOptions, NetworkError, type OfferResponse, type Opportunity, type ParsedTaxonomy, type Placement, type PlacementType, type PolicyResponse, type Privacy, type RegenerateKeysRequest, type RegenerateKeysResponse, type RequestOfferFromContextParams, type RequestOfferParams, type SDKConfig, type SanitizeURLOptions, type ScrapeSiteRequest, type ScrapeSiteResponse, SessionClient, type SponsoredSuggestion, type SponsoredTool, type TaxonomyIntent, TimeoutError, type ToolCall, type TrackCallRequest, type TrackCallResponse, type Tracking, type TrainAgentRequest, type TrainAgentResponse, buildTaxonomy, createImpressionEvent, createOpportunity, detectIntent, escapeHTML, formatInlineMention, formatNatural, generateTimestamp, generateUUID, getBaseTaxonomy, getVertical, isValidTaxonomy, matchesTaxonomy, parseTaxonomy, sanitizeURL, suggestTaxonomies, validateAdFits };