@the_ro_show/agent-ads-sdk 0.13.0 → 0.13.2

package/dist/index.d.mts

@@ -96,6 +96,35 @@ interface DecideFromContextRequest {
      * blockedAdvertisers: ['adv_abc123', 'adv_xyz789']
      */
     blockedAdvertisers?: string[];
+    /**
+     * Minimum cost-per-click threshold in cents.
+     * Only return ads with bids at or above this value.
+     * Higher values = more revenue per ad but lower fill rate.
+     *
+     * @example
+     * minCPC: 50  // Only show ads bidding $0.50 or more per click
+     */
+    minCPC?: number;
+    /**
+     * Minimum semantic relevance score threshold (0.0 - 1.0).
+     * Only return ads with relevance scores at or above this value.
+     * Higher values = more relevant ads but lower fill rate.
+     * Default backend threshold: 0.25
+     *
+     * @example
+     * minRelevanceScore: 0.8  // Only show highly relevant ads
+     */
+    minRelevanceScore?: number;
+    /**
+     * Ad ranking strategy.
+     * - 'revenue': Rank by bid amount (highest bid wins)
+     * - 'relevance': Rank by semantic similarity (best match wins)
+     * Default: 'revenue'
+     *
+     * @example
+     * optimizeFor: 'relevance'  // Prioritize best semantic match over highest bid
+     */
+    optimizeFor?: 'revenue' | 'relevance';
 }
 interface DecideResponse {
     request_id: string;

package/dist/index.d.ts

@@ -96,6 +96,35 @@ interface DecideFromContextRequest {
      * blockedAdvertisers: ['adv_abc123', 'adv_xyz789']
      */
     blockedAdvertisers?: string[];
+    /**
+     * Minimum cost-per-click threshold in cents.
+     * Only return ads with bids at or above this value.
+     * Higher values = more revenue per ad but lower fill rate.
+     *
+     * @example
+     * minCPC: 50  // Only show ads bidding $0.50 or more per click
+     */
+    minCPC?: number;
+    /**
+     * Minimum semantic relevance score threshold (0.0 - 1.0).
+     * Only return ads with relevance scores at or above this value.
+     * Higher values = more relevant ads but lower fill rate.
+     * Default backend threshold: 0.25
+     *
+     * @example
+     * minRelevanceScore: 0.8  // Only show highly relevant ads
+     */
+    minRelevanceScore?: number;
+    /**
+     * Ad ranking strategy.
+     * - 'revenue': Rank by bid amount (highest bid wins)
+     * - 'relevance': Rank by semantic similarity (best match wins)
+     * Default: 'revenue'
+     *
+     * @example
+     * optimizeFor: 'relevance'  // Prioritize best semantic match over highest bid
+     */
+    optimizeFor?: 'revenue' | 'relevance';
 }
 interface DecideResponse {
     request_id: string;

package/dist/index.js

@@ -354,7 +354,7 @@ function sanitizeURL(url, options) {
 }
 
 // src/client.ts
-var DEFAULT_BASE_URL = "https://api.attentionmarket.ai/v1";
+var DEFAULT_BASE_URL = "https://peruwnbrqkvmrldhpoom.supabase.co/functions/v1";
 var DEFAULT_TIMEOUT_MS = 4e3;
 var DEFAULT_MAX_RETRIES = 2;
 var AttentionMarketClient = class {
@@ -503,6 +503,60 @@ var AttentionMarketClient = class {
     const platform = params.platform || "web";
     const placementType = params.placement || "sponsored_suggestion";
     const taxonomy = params.suggestedCategory || this.inferTaxonomy(params.userMessage);
+    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");
+      }
+    }
+    if (params.allowedCategories !== void 0) {
+      if (!Array.isArray(params.allowedCategories)) {
+        throw new Error("allowedCategories must be an array");
+      }
+      if (params.allowedCategories.length === 0) {
+        throw new Error("allowedCategories cannot be empty (would block all ads). Use blockedCategories to exclude specific categories, or omit to allow all.");
+      }
+      for (const cat of params.allowedCategories) {
+        if (typeof cat !== "string" && typeof cat !== "number") {
+          throw new Error(`allowedCategories must contain strings or numbers, found: ${typeof cat}`);
+        }
+      }
+    }
+    if (params.blockedCategories !== void 0) {
+      if (!Array.isArray(params.blockedCategories)) {
+        throw new Error("blockedCategories must be an array");
+      }
+      for (const cat of params.blockedCategories) {
+        if (typeof cat !== "string" && typeof cat !== "number") {
+          throw new Error(`blockedCategories must contain strings or numbers, found: ${typeof cat}`);
+        }
+      }
+      if (params.allowedCategories && params.allowedCategories.length > 0) {
+        console.warn("[AttentionMarket] Both allowedCategories and blockedCategories specified. blockedCategories will be ignored.");
+      }
+    }
+    if (params.blockedAdvertisers !== void 0) {
+      if (!Array.isArray(params.blockedAdvertisers)) {
+        throw new Error("blockedAdvertisers must be an array");
+      }
+      for (const id of params.blockedAdvertisers) {
+        if (typeof id !== "string" || id.trim().length === 0) {
+          throw new Error("blockedAdvertisers must contain non-empty strings (advertiser IDs)");
+        }
+      }
+    }
+    if (params.minCPC !== void 0) {
+      if (typeof params.minCPC !== "number" || params.minCPC < 0) {
+        throw new Error("minCPC must be a non-negative number (cost-per-click in cents)");
+      }
+    }
+    if (params.minRelevanceScore !== void 0) {
+      if (typeof params.minRelevanceScore !== "number" || params.minRelevanceScore < 0 || params.minRelevanceScore > 1) {
+        throw new Error("minRelevanceScore must be a number between 0.0 and 1.0");
+      }
+    }
+    if (params.optimizeFor && params.optimizeFor !== "revenue" && params.optimizeFor !== "relevance") {
+      throw new Error('optimizeFor must be either "revenue" or "relevance"');
+    }
     const request = {
       request_id: generateUUID(),
       agent_id: this.agentId,
@@ -534,7 +588,11 @@ var AttentionMarketClient = class {
       ...params.minQualityScore !== void 0 && { minQualityScore: params.minQualityScore },
       ...params.allowedCategories && { allowedCategories: params.allowedCategories },
       ...params.blockedCategories && { blockedCategories: params.blockedCategories },
-      ...params.blockedAdvertisers && { blockedAdvertisers: params.blockedAdvertisers }
+      ...params.blockedAdvertisers && { blockedAdvertisers: params.blockedAdvertisers },
+      // Developer controls (Phase 2: Revenue Optimization)
+      ...params.minCPC !== void 0 && { minCPC: params.minCPC },
+      ...params.minRelevanceScore !== void 0 && { minRelevanceScore: params.minRelevanceScore },
+      ...params.optimizeFor && { optimizeFor: params.optimizeFor }
     };
     const response = await this.decideRaw(request, options);
     if (response.status === "no_fill" || response.units.length === 0) {