@the_ro_show/agent-ads-sdk 0.15.1 → 0.16.1

package/README.md

@@ -5,12 +5,24 @@
 
 Monetize your AI application with contextual advertising. AttentionMarket matches user intent with relevant sponsored content, enabling you to generate revenue from every conversation.
 
+## 📚 Documentation
+
+**Full documentation with REST API reference, mobile integration guides, and examples:**
+### → [https://rtrivedi.github.io/agent-ads-sdk/](https://rtrivedi.github.io/agent-ads-sdk/)
+
 ## Installation
 
 ```bash
 npm install @the_ro_show/agent-ads-sdk
 ```
 
+### For Non-Node.js Platforms
+
+See our [REST API Reference](https://rtrivedi.github.io/agent-ads-sdk/docs/api-reference) for direct HTTP integration in any language:
+- Python, Go, Ruby, PHP
+- iOS/Swift, Android/Kotlin
+- Direct cURL/HTTP
+
 ## Quick Start
 
 ```typescript
@@ -85,16 +97,18 @@ const ad = await client.decideFromContext({
 });
 ```
 
-### Performance Impact
+### Expected Performance Impact
 
-Smart context improves key metrics:
+Smart context is projected to improve key metrics:
 
-| Feature | CTR Improvement | Revenue Impact |
-|---------|----------------|----------------|
-| Intent Detection | +35% | +42% |
-| Interest Matching | +28% | +31% |
-| Session Tracking | +15% | +18% |
-| Combined | **+65%** | **+78%** |
+| Feature | Expected CTR Improvement | Expected Revenue Impact |
+|---------|-------------------------|------------------------|
+| Intent Detection | +30-40% | +35-45% |
+| Interest Matching | +20-30% | +25-35% |
+| Session Tracking | +10-20% | +15-25% |
+| Combined | **+50-70%** | **+60-80%** |
+
+*Note: These are projected improvements based on early testing. Actual results may vary.*
 
 ### Best Practices
 
@@ -162,15 +176,17 @@ const client = new AttentionMarketClient({
 
 ```typescript
 const client = new AttentionMarketClient({
-  apiKey: 'am_live_YOUR_KEY',        // Required
-  agentId: 'agt_YOUR_AGENT_ID',      // Required for decideFromContext()
+  apiKey: 'am_live_YOUR_KEY',       // Required: Your AttentionMarket API key
+  agentId: 'agt_YOUR_AGENT_ID',     // Required for decideFromContext()
   // baseUrl defaults to production Supabase endpoint
   // Only override if self-hosting or using different environment
-  timeoutMs: 4000,                   // Optional: request timeout in milliseconds
-  maxRetries: 2                      // Optional: automatic retry count
+  timeoutMs: 4000,                  // Optional: request timeout in milliseconds
+  maxRetries: 2                     // Optional: automatic retry count
 });
 ```
 
+**Note:** Get your API key and agent ID from your [developer dashboard](https://api.attentionmarket.ai).
+
 ## Core Concepts
 
 ### Placements
@@ -528,28 +544,27 @@ const ad = await client.decideFromContext({
 
 ### Click Tracking
 
-Clicks are automatically tracked when users visit `click_url`. For manual tracking:
+Clicks are automatically and securely tracked when users visit the `click_url`.
+
+**Important:** Always use the provided `click_url` or `tracking_url` for click tracking. These URLs contain HMAC-signed tokens that prevent click fraud and ensure accurate attribution.
 
 ```typescript
-await client.trackClick({
-  agent_id: 'agt_YOUR_AGENT_ID',
-  request_id: ad.request_id,
-  decision_id: ad.decision_id,
-  unit_id: ad._ad.unit_id,
-  tracking_token: ad.tracking_token,
-  href: ad.click_url,
-  click_context: "User clicked 'Get a Quote' button"
-});
-```
+import { sanitizeURL } from '@the_ro_show/agent-ads-sdk';
 
-Simplified tracking from ad object:
+// When user clicks the ad, sanitize URL for security
+const safeURL = sanitizeURL(ad.click_url);
+if (safeURL) {
+  window.location.href = safeURL;
+}
 
-```typescript
-await client.trackClickFromAd(ad, {
-  click_context: "User clicked on sponsored suggestion"
-});
+// Or in a chat/messaging context, share:
+const shareableLink = ad.tracking_url;
 ```
 
+**Security Note:** While our backend validates all URLs, it's recommended to use the `sanitizeURL()` helper to protect against potential XSS attacks if the backend is ever compromised or misconfigured.
+
+Manual click tracking has been removed for security reasons. All clicks must go through the redirect URLs to ensure fraud prevention and accurate tracking.
+
 ### Conversion Tracking
 
 Track conversions (purchases, signups, etc.) to improve advertiser ROI and your quality score:
@@ -625,6 +640,36 @@ Use test API keys (`am_test_...`) for development and testing. Test keys:
 
 Switch to live keys (`am_live_...`) when deploying to production.
 
+## 🌍 REST API for Mobile & Other Platforms
+
+For non-Node.js platforms, use our REST API directly:
+
+### iOS/Swift Example
+```swift
+// See full guide: https://rtrivedi.github.io/agent-ads-sdk/docs/mobile-integration
+let url = URL(string: "https://peruwnbrqkvmrldhpoom.supabase.co/functions/v1/decide")!
+var request = URLRequest(url: url)
+request.setValue("Bearer \(apiKey)", forHTTPHeaderField: "Authorization")
+request.setValue(supabaseAnonKey, forHTTPHeaderField: "apikey")
+// ... see docs for complete example
+```
+
+### Python Example
+```python
+# See full guide: https://rtrivedi.github.io/agent-ads-sdk/docs/api-reference
+import requests
+response = requests.post(
+    "https://peruwnbrqkvmrldhpoom.supabase.co/functions/v1/decide",
+    headers={
+        "Authorization": f"Bearer {api_key}",
+        "apikey": supabase_anon_key
+    },
+    json={"user_message": "I need insurance"}
+)
+```
+
+**📖 Full REST API Documentation:** [https://rtrivedi.github.io/agent-ads-sdk/docs/api-reference](https://rtrivedi.github.io/agent-ads-sdk/docs/api-reference)
+
 ## 🤖 Claude Code Integration
 
 Building with Claude Code? We've created ready-to-use prompts for seamless integration.

package/dist/index.d.mts

@@ -82,7 +82,8 @@ interface DecideFromContextRequest {
     placement?: PlacementType;
     /**
      * Optional category hint (e.g., 'legal', 'insurance', 'travel').
-     * Used as fallback if semantic matching fails.
+     * Defaults to 'general.query'. Only used as fallback - semantic matching
+     * uses conversation context, not taxonomy.
      */
     suggestedCategory?: string;
     /** User's country code. Default: 'US' */
@@ -773,24 +774,6 @@ interface CreateImpressionEventParams {
  * @returns EventIngestRequest ready to pass to client.track()
  */
 declare function createImpressionEvent(params: CreateImpressionEventParams): EventIngestRequest;
-interface CreateClickEventParams {
-    agent_id: string;
-    request_id: string;
-    decision_id: string;
-    unit_id: string;
-    tracking_token: string;
-    href: string;
-    click_context: string;
-    occurred_at?: string;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Helper to create a click event payload.
- *
- * @param params - Event parameters (snake_case to match API)
- * @returns EventIngestRequest ready to pass to client.track()
- */
-declare function createClickEvent(params: CreateClickEventParams): EventIngestRequest;
 /**
  * Options for URL sanitization
  */
@@ -868,11 +851,6 @@ declare class AttentionMarketClient {
     private agentId;
     private appId;
     constructor(config: SDKConfig);
-    /**
-     * Infer taxonomy from user message using keyword matching
-     * Returns best-guess taxonomy based on common patterns
-     */
-    private inferTaxonomy;
     /**
      * Validate SDK configuration for security
      */
@@ -922,35 +900,6 @@ declare class AttentionMarketClient {
     trackImpression(params: Omit<CreateImpressionEventParams, 'occurred_at'> & {
         occurred_at?: string;
     }): Promise<EventIngestResponse>;
-    /**
-     * Convenience method to track a click event.
-     * Creates a click event using createClickEvent() and calls track().
-     */
-    trackClick(params: Omit<CreateClickEventParams, 'occurred_at'> & {
-        occurred_at?: string;
-    }): Promise<EventIngestResponse>;
-    /**
-     * Ultra-simple method to track a click from an ad returned by decideFromContext().
-     * Automatically extracts all required fields from the ad object.
-     *
-     * @param ad - The ad object returned by decideFromContext()
-     * @param options - Just click_context (what you showed the user)
-     *
-     * @example
-     * ```typescript
-     * const ad = await client.decideFromContext({ userMessage: "I need car insurance" });
-     * if (ad) {
-     *   await client.trackClickFromAd(ad, {
-     *     click_context: "Progressive: Get 20% off - Compare quotes"
-     *   });
-     * }
-     * ```
-     */
-    trackClickFromAd(ad: AdResponse, options: {
-        click_context: string;
-        metadata?: Record<string, unknown>;
-        occurred_at?: string;
-    }): Promise<EventIngestResponse>;
     /**
      * Send feedback on an ad's performance to earn conversion-validated bonuses.
      *
@@ -1584,4 +1533,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 CreateClickEventParams, 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, createClickEvent, 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 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 };

package/dist/index.d.ts

@@ -82,7 +82,8 @@ interface DecideFromContextRequest {
     placement?: PlacementType;
     /**
      * Optional category hint (e.g., 'legal', 'insurance', 'travel').
-     * Used as fallback if semantic matching fails.
+     * Defaults to 'general.query'. Only used as fallback - semantic matching
+     * uses conversation context, not taxonomy.
      */
     suggestedCategory?: string;
     /** User's country code. Default: 'US' */
@@ -773,24 +774,6 @@ interface CreateImpressionEventParams {
  * @returns EventIngestRequest ready to pass to client.track()
  */
 declare function createImpressionEvent(params: CreateImpressionEventParams): EventIngestRequest;
-interface CreateClickEventParams {
-    agent_id: string;
-    request_id: string;
-    decision_id: string;
-    unit_id: string;
-    tracking_token: string;
-    href: string;
-    click_context: string;
-    occurred_at?: string;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Helper to create a click event payload.
- *
- * @param params - Event parameters (snake_case to match API)
- * @returns EventIngestRequest ready to pass to client.track()
- */
-declare function createClickEvent(params: CreateClickEventParams): EventIngestRequest;
 /**
  * Options for URL sanitization
  */
@@ -868,11 +851,6 @@ declare class AttentionMarketClient {
     private agentId;
     private appId;
     constructor(config: SDKConfig);
-    /**
-     * Infer taxonomy from user message using keyword matching
-     * Returns best-guess taxonomy based on common patterns
-     */
-    private inferTaxonomy;
     /**
      * Validate SDK configuration for security
      */
@@ -922,35 +900,6 @@ declare class AttentionMarketClient {
     trackImpression(params: Omit<CreateImpressionEventParams, 'occurred_at'> & {
         occurred_at?: string;
     }): Promise<EventIngestResponse>;
-    /**
-     * Convenience method to track a click event.
-     * Creates a click event using createClickEvent() and calls track().
-     */
-    trackClick(params: Omit<CreateClickEventParams, 'occurred_at'> & {
-        occurred_at?: string;
-    }): Promise<EventIngestResponse>;
-    /**
-     * Ultra-simple method to track a click from an ad returned by decideFromContext().
-     * Automatically extracts all required fields from the ad object.
-     *
-     * @param ad - The ad object returned by decideFromContext()
-     * @param options - Just click_context (what you showed the user)
-     *
-     * @example
-     * ```typescript
-     * const ad = await client.decideFromContext({ userMessage: "I need car insurance" });
-     * if (ad) {
-     *   await client.trackClickFromAd(ad, {
-     *     click_context: "Progressive: Get 20% off - Compare quotes"
-     *   });
-     * }
-     * ```
-     */
-    trackClickFromAd(ad: AdResponse, options: {
-        click_context: string;
-        metadata?: Record<string, unknown>;
-        occurred_at?: string;
-    }): Promise<EventIngestResponse>;
     /**
      * Send feedback on an ad's performance to earn conversion-validated bonuses.
      *
@@ -1584,4 +1533,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 CreateClickEventParams, 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, createClickEvent, 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 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 };

package/dist/index.js

@@ -27,7 +27,6 @@ __export(index_exports, {
   NetworkError: () => NetworkError,
   TimeoutError: () => TimeoutError,
   buildTaxonomy: () => buildTaxonomy,
-  createClickEvent: () => createClickEvent,
   createImpressionEvent: () => createImpressionEvent,
   createOpportunity: () => createOpportunity,
   detectIntent: () => detectIntent,
@@ -247,31 +246,6 @@ function createImpressionEvent(params) {
   }
   return event;
 }
-function createClickEvent(params) {
-  const event = {
-    event_id: generateUUID(),
-    occurred_at: params.occurred_at ?? generateTimestamp(),
-    agent_id: params.agent_id,
-    request_id: params.request_id,
-    decision_id: params.decision_id,
-    unit_id: params.unit_id,
-    event_type: "click",
-    tracking_token: params.tracking_token
-  };
-  if (params.metadata !== void 0) {
-    event.metadata = {
-      ...params.metadata,
-      href: params.href,
-      click_context: params.click_context
-    };
-  } else {
-    event.metadata = {
-      href: params.href,
-      click_context: params.click_context
-    };
-  }
-  return event;
-}
 var HTML_ESCAPES = {
   "&": "&",
   "<": "&lt;",
@@ -542,59 +516,6 @@ var AttentionMarketClient = class {
     }
     this.http = new HTTPClient(httpConfig);
   }
-  /**
-   * Infer taxonomy from user message using keyword matching
-   * Returns best-guess taxonomy based on common patterns
-   */
-  inferTaxonomy(userMessage) {
-    const msg = userMessage.toLowerCase();
-    if (msg.match(/\b(ecommerce|e-commerce|online store|shopify|sell products?|product brand)\b/)) {
-      return "business.ecommerce.platform.trial";
-    }
-    if (msg.match(/\b(start.*business|launch.*business|business formation|llc|incorporate)\b/)) {
-      return "business.ecommerce.platform.trial";
-    }
-    if (msg.match(/\b(car insurance|auto insurance|vehicle insurance)\b/)) {
-      return "insurance.auto.full_coverage.quote";
-    }
-    if (msg.match(/\b(health insurance|medical insurance)\b/)) {
-      return "insurance.health.individual.quote";
-    }
-    if (msg.match(/\b(life insurance)\b/)) {
-      return "insurance.life.term.quote";
-    }
-    if (msg.match(/\b(insurance)\b/)) {
-      return "insurance.auto.full_coverage.quote";
-    }
-    if (msg.match(/\b(personal loan|debt consolidation|borrow money)\b/)) {
-      return "finance.loans.personal.apply";
-    }
-    if (msg.match(/\b(credit card)\b/)) {
-      return "finance.credit_cards.rewards.apply";
-    }
-    if (msg.match(/\b(mover?s?|moving|relocat(e|ing))\b/)) {
-      return "home_services.moving.local.quote";
-    }
-    if (msg.match(/\b(plumber|plumbing|leak|pipe)\b/)) {
-      return "home_services.plumbing.emergency.quote";
-    }
-    if (msg.match(/\b(electrician|electrical|wiring)\b/)) {
-      return "home_services.electrical.repair.quote";
-    }
-    if (msg.match(/\b(clean(ing|er)|maid service)\b/)) {
-      return "home_services.cleaning.regular.book";
-    }
-    if (msg.match(/\b(hotel|lodging|accommodation)\b/)) {
-      return "travel.hotels.luxury.book";
-    }
-    if (msg.match(/\b(flight|plane ticket|airfare)\b/)) {
-      return "travel.flights.domestic.book";
-    }
-    if (msg.match(/\b(lawyer|attorney|legal help)\b/)) {
-      return "legal.general.consultation";
-    }
-    return "business.ecommerce.platform.trial";
-  }
   /**
    * Validate SDK configuration for security
    */
@@ -678,7 +599,7 @@ var AttentionMarketClient = class {
     const language = params.language || "en";
     const platform = params.platform || "web";
     const placementType = params.placement || "sponsored_suggestion";
-    const taxonomy = params.suggestedCategory || this.inferTaxonomy(params.userMessage);
+    const taxonomy = params.suggestedCategory || "general.query";
     if (params.minQualityScore !== void 0) {
       if (typeof params.minQualityScore !== "number" || params.minQualityScore < 0 || params.minQualityScore > 1) {
         throw new Error("minQualityScore must be a number between 0.0 and 1.0");
@@ -733,6 +654,11 @@ var AttentionMarketClient = class {
     if (params.optimizeFor && params.optimizeFor !== "revenue" && params.optimizeFor !== "relevance") {
       throw new Error('optimizeFor must be either "revenue" or "relevance"');
     }
+    const validFormats = ["minimal", "standard", "verbose"];
+    const responseFormat = params.response_format || "minimal";
+    if (!validFormats.includes(responseFormat)) {
+      throw new Error(`response_format must be one of: ${validFormats.join(", ")}. Got: ${responseFormat}`);
+    }
     const request = {
       request_id: generateUUID(),
       agent_id: this.agentId,
@@ -761,7 +687,7 @@ var AttentionMarketClient = class {
       context,
       user_intent: params.userMessage,
       // Use minimal response format by default for better performance
-      response_format: "minimal",
+      response_format: responseFormat,
       // === Smart Context Fields (v0.15.0) ===
       // Include user context if we have any data
       ...(interests.length > 0 || recentTopics.length > 0 || purchaseIntent) && {
@@ -804,7 +730,11 @@ var AttentionMarketClient = class {
             tracking_token: response.tracking_token
           });
         } catch (error) {
-          console.warn("[AttentionMarket] Failed to auto-track impression:", error);
+          console.error("[AttentionMarket] REVENUE RISK: Failed to auto-track impression. Clicks without impressions will NOT earn revenue.", {
+            error: error instanceof Error ? error.message : String(error),
+            tracking_token: response.tracking_token,
+            unit_id: response["_meta"]?.["unit_id"]
+          });
         }
       }
       const adResponse2 = {
@@ -849,7 +779,11 @@ var AttentionMarketClient = class {
         tracking_token: adUnit.tracking.token
       });
     } catch (error) {
-      console.warn("[AttentionMarket] Failed to auto-track impression:", error);
+      console.error("[AttentionMarket] REVENUE RISK: Failed to auto-track impression. Clicks without impressions will NOT earn revenue.", {
+        error: error instanceof Error ? error.message : String(error),
+        tracking_token: adUnit.tracking.token,
+        unit_id: adUnit.unit_id
+      });
     }
     const adResponse = {
       request_id: response.request_id,
@@ -897,52 +831,6 @@ var AttentionMarketClient = class {
     const event = createImpressionEvent(params);
     return await this.track(event);
   }
-  /**
-   * Convenience method to track a click event.
-   * Creates a click event using createClickEvent() and calls track().
-   */
-  async trackClick(params) {
-    const event = createClickEvent(params);
-    return await this.track(event);
-  }
-  /**
-   * Ultra-simple method to track a click from an ad returned by decideFromContext().
-   * Automatically extracts all required fields from the ad object.
-   *
-   * @param ad - The ad object returned by decideFromContext()
-   * @param options - Just click_context (what you showed the user)
-   *
-   * @example
-   * ```typescript
-   * const ad = await client.decideFromContext({ userMessage: "I need car insurance" });
-   * if (ad) {
-   *   await client.trackClickFromAd(ad, {
-   *     click_context: "Progressive: Get 20% off - Compare quotes"
-   *   });
-   * }
-   * ```
-   */
-  async trackClickFromAd(ad, options) {
-    if (!this.agentId) {
-      throw new Error("agentId is required for trackClickFromAd(). Set it in the constructor.");
-    }
-    const trackParams = {
-      agent_id: this.agentId,
-      request_id: ad.request_id,
-      decision_id: ad.decision_id,
-      unit_id: ad._ad.unit_id,
-      tracking_token: ad.tracking_token,
-      href: ad.click_url,
-      click_context: options.click_context
-    };
-    if (options.metadata) {
-      trackParams.metadata = options.metadata;
-    }
-    if (options.occurred_at) {
-      trackParams.occurred_at = options.occurred_at;
-    }
-    return await this.trackClick(trackParams);
-  }
   /**
    * Send feedback on an ad's performance to earn conversion-validated bonuses.
    *
@@ -1245,7 +1133,7 @@ var AttentionMarketClient = class {
     const context = contextParts.join("\n");
     const country = params.context?.geo?.country || "US";
     const language = this.normalizeLocale(params.context?.locale);
-    const taxonomy = params.suggestedCategory || "unknown";
+    const taxonomy = params.suggestedCategory || "general.query";
     const idempotencyKey = options?.idempotencyKey || generateUUID();
     const request = {
       request_id: idempotencyKey,
@@ -2057,7 +1945,6 @@ function suggestTaxonomies(query) {
   NetworkError,
   TimeoutError,
   buildTaxonomy,
-  createClickEvent,
   createImpressionEvent,
   createOpportunity,
   detectIntent,