@the_ro_show/agent-ads-sdk 0.16.0 → 0.17.0

package/README.md

@@ -46,6 +46,35 @@ if (ad) {
 }
 ```
 
+## How You Earn Money
+
+AttentionMarket pays you when users **click** sponsored content. It's that simple.
+
+### Revenue Formula
+```
+Your Earnings = Clicks × Payout Per Click
+```
+
+Every response shows exactly what you'll earn:
+```typescript
+{
+  "payout": 250,        // You earn $2.50 when clicked
+  "click_url": "https://...",
+  "creative": { title: "...", body: "..." }
+}
+```
+
+### Why We Track Impressions
+
+Impressions prevent click fraud. If sponsored content wasn't shown, clicks won't generate revenue.
+
+**Important:**
+- ✅ Impressions are **required** for clicks to count
+- ❌ Impressions do **NOT** generate revenue themselves
+- ✅ The SDK tracks impressions automatically
+
+Think of impressions as a receipt: "Yes, this content was actually shown to a real user."
+
 ## Smart Context (v0.15.1+) 🎯
 
 Improve ad relevance by 2-3x with smart context features that understand user intent better:
@@ -176,17 +205,16 @@ const client = new AttentionMarketClient({
 
 ```typescript
 const client = new AttentionMarketClient({
-  apiKey: 'am_live_YOUR_KEY',        // Required: Your AttentionMarket API key
-  agentId: 'agt_YOUR_AGENT_ID',      // Required for decideFromContext()
-  supabaseAnonKey: 'YOUR_ANON_KEY',  // Required: Get from dashboard
+  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:** You need both `apiKey` (AttentionMarket) and `supabaseAnonKey` (infrastructure) for authentication. Get both from your [developer dashboard](https://api.attentionmarket.ai).
+**Note:** Get your API key and agent ID from your [developer dashboard](https://api.attentionmarket.ai).
 
 ## Core Concepts
 
@@ -376,10 +404,10 @@ const ad = await client.decideFromContext({
 **Validation:** Must be a non-negative number.
 
 **Use cases:**
-- Premium applications: `200+` for $2+ ads only
+- Premium applications: `200+` for $2+ per click only
 - High-value verticals: Filter out low-budget advertisers
-- Revenue targets: Ensure minimum revenue per impression
-- Lower fill rate tolerance: When you'd rather show nothing than a low-value ad
+- Revenue targets: Ensure minimum earnings when clicked
+- Lower fill rate tolerance: When you'd rather show nothing than low-value content
 
 **Trade-off:** Higher thresholds = higher revenue per ad but lower fill rate.
 
@@ -550,13 +578,20 @@ 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
-// When user clicks the ad, redirect them to:
-window.location.href = ad.click_url;
+import { sanitizeURL } from '@the_ro_show/agent-ads-sdk';
+
+// When user clicks the ad, sanitize URL for security
+const safeURL = sanitizeURL(ad.click_url);
+if (safeURL) {
+  window.location.href = safeURL;
+}
 
 // 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
@@ -580,6 +615,122 @@ await client.track({
 });
 ```
 
+### Developer Prediction System (Bonus Earnings)
+
+**Get paid more for accurate predictions!** After showing an ad, predict whether the user will convert. If you're right, earn a bonus:
+- ✅ Correct positive prediction → **+20% bonus**
+- ✅ Correct negative prediction → **+5% bonus**
+- ⚠️ Wrong prediction → No bonus (but no penalty)
+
+#### How It Works
+
+1. **Show the ad** to your user using `decideFromContext()`
+2. **Observe their reaction** (interested? asked questions? changed topic?)
+3. **Send feedback** with your prediction
+4. **Get bonus** 7 days later if you were right
+
+#### Option 1: Auto-Analysis (Recommended - Easiest)
+
+Just send the user's raw response, and our AI analyzes sentiment automatically:
+
+```typescript
+const ad = await client.decideFromContext({
+  userMessage: "I need car insurance",
+  placement: 'sponsored_suggestion'
+});
+
+// Show ad to user...
+// User responds: "Tell me more about that Geico offer!"
+
+await client.sendFeedback({
+  tracking_token: ad.tracking_token,
+  user_response: "Tell me more about that Geico offer!",
+  conversation_history: [
+    "User: I need car insurance",
+    "Agent: Check out Geico...",
+    "User: Tell me more about that Geico offer!"
+  ]
+});
+
+// Our AI detects: "positive" sentiment
+// You get base earnings + 20% bonus if user converts
+```
+
+**When to use:** You want simplicity. Let our AI handle sentiment analysis.
+
+#### Option 2: Manual Prediction (Advanced - Full Control)
+
+Analyze sentiment yourself and send your prediction:
+
+```typescript
+const ad = await client.decideFromContext({
+  userMessage: "I need car insurance",
+  placement: 'sponsored_suggestion'
+});
+
+// Show ad to user...
+// User responds: "No thanks, I already have insurance"
+
+// YOU analyze: User declined → predict negative
+await client.sendFeedback({
+  tracking_token: ad.tracking_token,
+  reaction: 'negative',  // You determine this
+  context: 'User already has insurance, politely declined'
+});
+
+// If user doesn't convert, you get +5% bonus
+```
+
+**When to use:** You want full control over sentiment classification, or you have your own sentiment analysis.
+
+#### Prediction Guidelines
+
+**Positive** - User shows interest:
+- "Tell me more!"
+- "How much does it cost?"
+- "Can you sign me up?"
+- Asks follow-up questions
+
+**Neutral** - Hard to tell:
+- "Maybe later"
+- "I'll think about it"
+- No clear response
+- Non-committal
+
+**Negative** - User not interested:
+- "No thanks"
+- "I already have that"
+- Changes topic immediately
+- Explicitly declines
+
+#### Response Format
+
+```typescript
+{
+  status: 'received',
+  feedback_id: 'evt_abc123',
+  potential_bonus: '20%',
+  resolution_date: '2026-03-13',
+  message: 'Feedback recorded. Bonus will be calculated after 7-day conversion window.',
+
+  // Only in auto-analysis mode:
+  sentiment_detected: 'positive',
+  analysis_mode: 'auto'
+}
+```
+
+#### Best Practices
+
+1. **Submit within 24 hours** - Feedback must be sent within 24 hours of showing the ad
+2. **One prediction per ad** - You can only submit feedback once per tracking_token
+3. **Be honest** - Don't predict "positive" for everything. Our system rewards accuracy, not volume
+4. **Use context** - Include conversation history for better auto-analysis
+5. **Skip when unsure** - No feedback is better than random guessing
+
+#### Cost of Auto-Analysis
+
+Auto-analysis costs ~$0.0001 per request (using GPT-3.5-turbo). We absorb this cost, so it's free for you. The better accuracy and developer experience is worth it.
+
 ## Error Handling
 
 The SDK throws errors for invalid configurations and failed requests:
@@ -698,6 +849,15 @@ Create a simple getRelevantAd(message) function that returns ads only when relev
 
 ## Changelog
 
+### v0.17.0 (2026-03-06) - AI-Powered Feedback Analysis
+- 🤖 **Auto-Analysis Mode:** Send raw user responses, our AI detects sentiment automatically
+- 💰 **Bonus Earnings:** +20% for correct positive predictions, +5% for correct negative predictions
+- 🔄 **Backward Compatible:** Existing manual `reaction` mode still supported
+- 📊 **Conversation Context:** Include conversation history for better sentiment analysis
+- ⚡ **Fast & Cheap:** GPT-3.5-turbo analysis (~$0.0001 per request, free for developers)
+- 🎯 **Fallback Logic:** Defaults to 'neutral' if AI analysis fails
+- 📝 **Enhanced Logging:** Track analysis_mode and sentiment_confidence in metadata
+
 ### v0.15.1 (2026-02-26) - Bug Fixes & Security
 - 🔒 Fixed session leak - sessionId now request-scoped, not instance-scoped
 - 🛡️ Added comprehensive input validation and sanitization

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' */
@@ -293,44 +294,63 @@ interface EventIngestRequest {
 interface EventIngestResponse {
     accepted: boolean;
 }
-/**
- * Sentiment types detected by backend AI analysis.
- *
- * - positive: User is interested/engaged (earn +15% if converts, -5% if not)
- * - neutral: User is indifferent (no bonus/penalty, data only)
- * - negative: User disliked the ad (no penalty, data only)
- */
-type FeedbackSentiment = 'positive' | 'neutral' | 'negative';
 /**
  * Send feedback on an ad after showing it to a user.
  *
- * **New in v0.11.0:** Backend analyzes sentiment automatically using AI.
- * Just send the user's actual response text - no need to classify it yourself.
+ * **Two modes available:**
  *
- * **Anti-Fraud:** Bonuses are deferred and validated against actual conversions.
- * - Correct positive prediction → +15% bonus after 7 days
- * - Wrong positive prediction → -5% penalty after 7 days
- * - Neutral/negative → no bonus/penalty (data only)
+ * **Auto-Analysis (Recommended):** Send the user's raw response, and our AI analyzes sentiment.
+ * ```typescript
+ * await client.sendFeedback({
+ *   tracking_token: ad.tracking_token,
+ *   user_response: "Tell me more about that!",
+ *   conversation_history: ["Previous message 1", "Previous message 2"]
+ * });
+ * ```
  *
- * @example
+ * **Manual Prediction:** Analyze sentiment yourself and send the prediction.
  * ```typescript
  * await client.sendFeedback({
  *   tracking_token: ad.tracking_token,
- *   user_response: "This looks perfect! How do I sign up?",
- *   agent_response: "Here's the signup link...",
- *   additional_context: "User spent 2 minutes reading the offer"
+ *   reaction: 'positive',  // You determine this
+ *   context: 'User asked follow-up questions'
  * });
  * ```
+ *
+ * **Bonuses (7-day deferred):**
+ * - Correct positive prediction → +20% bonus
+ * - Correct negative prediction → +5% bonus
+ * - Wrong prediction or no feedback → No bonus
  */
 interface FeedbackRequest {
-    /** Tracking token from the ad you showed */
+    /** Tracking token from the ad you showed (required) */
     tracking_token: string;
-    /** User's actual response text (required) */
-    user_response: string;
-    /** Your agent's response (optional, helps sentiment analysis) */
-    agent_response?: string;
-    /** Additional context about the interaction (optional) */
-    additional_context?: string;
+    /**
+     * OPTION 1 (Auto-Analysis): User's actual response text.
+     * Our AI will analyze sentiment and determine positive/neutral/negative.
+     * Max 2000 characters.
+     */
+    user_response?: string;
+    /**
+     * Conversation history for better context in auto-analysis.
+     * We use the last 3 messages to understand the conversation flow.
+     */
+    conversation_history?: string[];
+    /**
+     * OPTION 2 (Manual): Your prediction of user interest.
+     * Use this if you want full control over sentiment classification.
+     */
+    reaction?: 'positive' | 'neutral' | 'negative';
+    /**
+     * Additional context about the interaction (optional, both modes).
+     * Max 1000 characters.
+     */
+    context?: string;
+    /**
+     * Idempotency key for safe retries (optional).
+     * Use the same key if retrying a failed request to avoid duplicate feedback.
+     */
+    idempotency_key?: string;
 }
 /**
  * Response from sending feedback.
@@ -339,18 +359,27 @@ interface FeedbackRequest {
  * based on whether the user actually converted.
  */
 interface FeedbackResponse {
-    /** Whether feedback was recorded successfully */
-    success: boolean;
-    /** AI-detected sentiment from user response */
-    sentiment_detected: FeedbackSentiment;
-    /** Potential bonus if prediction is correct (not guaranteed) */
+    /** Status of feedback submission */
+    status: 'received';
+    /** Unique ID for this feedback event */
+    feedback_id: string;
+    /** Potential bonus if prediction is correct (20% for positive, 5% for negative) */
     potential_bonus: string;
-    /** Potential penalty if prediction is wrong */
-    potential_penalty: string;
     /** Explanation of the deferred bonus system */
     message: string;
-    /** When the bonus will be resolved (7 days from now) */
+    /** When the bonus will be resolved (7 days from impression, YYYY-MM-DD) */
     resolution_date: string;
+    /**
+     * AI-detected sentiment (only present in auto-analysis mode).
+     * Shows what sentiment our AI detected from the user response.
+     */
+    sentiment_detected?: 'positive' | 'neutral' | 'negative';
+    /**
+     * Analysis mode used (only present in auto-analysis or fallback modes).
+     * - 'auto': AI analyzed sentiment
+     * - 'fallback': AI failed, defaulted to neutral
+     */
+    analysis_mode?: 'auto' | 'fallback';
 }
 interface PolicyResponse {
     version: string;
@@ -850,11 +879,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
      */

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' */
@@ -293,44 +294,63 @@ interface EventIngestRequest {
 interface EventIngestResponse {
     accepted: boolean;
 }
-/**
- * Sentiment types detected by backend AI analysis.
- *
- * - positive: User is interested/engaged (earn +15% if converts, -5% if not)
- * - neutral: User is indifferent (no bonus/penalty, data only)
- * - negative: User disliked the ad (no penalty, data only)
- */
-type FeedbackSentiment = 'positive' | 'neutral' | 'negative';
 /**
  * Send feedback on an ad after showing it to a user.
  *
- * **New in v0.11.0:** Backend analyzes sentiment automatically using AI.
- * Just send the user's actual response text - no need to classify it yourself.
+ * **Two modes available:**
  *
- * **Anti-Fraud:** Bonuses are deferred and validated against actual conversions.
- * - Correct positive prediction → +15% bonus after 7 days
- * - Wrong positive prediction → -5% penalty after 7 days
- * - Neutral/negative → no bonus/penalty (data only)
+ * **Auto-Analysis (Recommended):** Send the user's raw response, and our AI analyzes sentiment.
+ * ```typescript
+ * await client.sendFeedback({
+ *   tracking_token: ad.tracking_token,
+ *   user_response: "Tell me more about that!",
+ *   conversation_history: ["Previous message 1", "Previous message 2"]
+ * });
+ * ```
  *
- * @example
+ * **Manual Prediction:** Analyze sentiment yourself and send the prediction.
  * ```typescript
  * await client.sendFeedback({
  *   tracking_token: ad.tracking_token,
- *   user_response: "This looks perfect! How do I sign up?",
- *   agent_response: "Here's the signup link...",
- *   additional_context: "User spent 2 minutes reading the offer"
+ *   reaction: 'positive',  // You determine this
+ *   context: 'User asked follow-up questions'
  * });
  * ```
+ *
+ * **Bonuses (7-day deferred):**
+ * - Correct positive prediction → +20% bonus
+ * - Correct negative prediction → +5% bonus
+ * - Wrong prediction or no feedback → No bonus
  */
 interface FeedbackRequest {
-    /** Tracking token from the ad you showed */
+    /** Tracking token from the ad you showed (required) */
     tracking_token: string;
-    /** User's actual response text (required) */
-    user_response: string;
-    /** Your agent's response (optional, helps sentiment analysis) */
-    agent_response?: string;
-    /** Additional context about the interaction (optional) */
-    additional_context?: string;
+    /**
+     * OPTION 1 (Auto-Analysis): User's actual response text.
+     * Our AI will analyze sentiment and determine positive/neutral/negative.
+     * Max 2000 characters.
+     */
+    user_response?: string;
+    /**
+     * Conversation history for better context in auto-analysis.
+     * We use the last 3 messages to understand the conversation flow.
+     */
+    conversation_history?: string[];
+    /**
+     * OPTION 2 (Manual): Your prediction of user interest.
+     * Use this if you want full control over sentiment classification.
+     */
+    reaction?: 'positive' | 'neutral' | 'negative';
+    /**
+     * Additional context about the interaction (optional, both modes).
+     * Max 1000 characters.
+     */
+    context?: string;
+    /**
+     * Idempotency key for safe retries (optional).
+     * Use the same key if retrying a failed request to avoid duplicate feedback.
+     */
+    idempotency_key?: string;
 }
 /**
  * Response from sending feedback.
@@ -339,18 +359,27 @@ interface FeedbackRequest {
  * based on whether the user actually converted.
  */
 interface FeedbackResponse {
-    /** Whether feedback was recorded successfully */
-    success: boolean;
-    /** AI-detected sentiment from user response */
-    sentiment_detected: FeedbackSentiment;
-    /** Potential bonus if prediction is correct (not guaranteed) */
+    /** Status of feedback submission */
+    status: 'received';
+    /** Unique ID for this feedback event */
+    feedback_id: string;
+    /** Potential bonus if prediction is correct (20% for positive, 5% for negative) */
     potential_bonus: string;
-    /** Potential penalty if prediction is wrong */
-    potential_penalty: string;
     /** Explanation of the deferred bonus system */
     message: string;
-    /** When the bonus will be resolved (7 days from now) */
+    /** When the bonus will be resolved (7 days from impression, YYYY-MM-DD) */
     resolution_date: string;
+    /**
+     * AI-detected sentiment (only present in auto-analysis mode).
+     * Shows what sentiment our AI detected from the user response.
+     */
+    sentiment_detected?: 'positive' | 'neutral' | 'negative';
+    /**
+     * Analysis mode used (only present in auto-analysis or fallback modes).
+     * - 'auto': AI analyzed sentiment
+     * - 'fallback': AI failed, defaulted to neutral
+     */
+    analysis_mode?: 'auto' | 'fallback';
 }
 interface PolicyResponse {
     version: string;
@@ -850,11 +879,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
      */

package/dist/index.js

@@ -516,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
    */
@@ -652,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");
@@ -707,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,
@@ -735,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) && {
@@ -778,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 = {
@@ -823,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,
@@ -1173,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,
@@ -1433,6 +1393,7 @@ var AttentionMarketClient = class {
       url
     );
   }
+  // TODO: Add getDeveloperMetrics() method when DeveloperMetricsResponse type is defined
 };
 
 // src/mock-client.ts