@the_ro_show/agent-ads-sdk 0.13.3 → 0.14.0

package/dist/index.d.mts

@@ -25,6 +25,9 @@ interface DecideRequest {
     context?: string;
     /** Detected or inferred user intent for semantic matching (optional) */
     user_intent?: string;
+    /** Response format: 'minimal' | 'standard' | 'verbose' (default: 'minimal') */
+    response_format?: string;
+    [key: string]: any;
 }
 /**
  * Simplified request for semantic context-based ad matching.
@@ -127,11 +130,27 @@ interface DecideFromContextRequest {
     optimizeFor?: 'revenue' | 'relevance';
 }
 interface DecideResponse {
-    request_id: string;
-    decision_id: string;
-    status: 'filled' | 'no_fill';
-    ttl_ms: number;
-    units: AdUnit[];
+    request_id?: string;
+    decision_id?: string;
+    status?: 'filled' | 'no_fill';
+    ttl_ms?: number;
+    units?: AdUnit[];
+    creative?: {
+        title: string;
+        body: string;
+        cta: string;
+    };
+    click_url?: string;
+    tracking_token?: string;
+    advertiser_id?: string;
+    payout?: number;
+    disclosure?: {
+        label: string;
+        explanation: string;
+        sponsor_name: string;
+    };
+    relevance_score?: number;
+    [key: string]: any;
 }
 type PlacementType = 'sponsored_suggestion' | 'sponsored_block' | 'sponsored_tool';
 interface Placement {

package/dist/index.d.ts

@@ -25,6 +25,9 @@ interface DecideRequest {
     context?: string;
     /** Detected or inferred user intent for semantic matching (optional) */
     user_intent?: string;
+    /** Response format: 'minimal' | 'standard' | 'verbose' (default: 'minimal') */
+    response_format?: string;
+    [key: string]: any;
 }
 /**
  * Simplified request for semantic context-based ad matching.
@@ -127,11 +130,27 @@ interface DecideFromContextRequest {
     optimizeFor?: 'revenue' | 'relevance';
 }
 interface DecideResponse {
-    request_id: string;
-    decision_id: string;
-    status: 'filled' | 'no_fill';
-    ttl_ms: number;
-    units: AdUnit[];
+    request_id?: string;
+    decision_id?: string;
+    status?: 'filled' | 'no_fill';
+    ttl_ms?: number;
+    units?: AdUnit[];
+    creative?: {
+        title: string;
+        body: string;
+        cta: string;
+    };
+    click_url?: string;
+    tracking_token?: string;
+    advertiser_id?: string;
+    payout?: number;
+    disclosure?: {
+        label: string;
+        explanation: string;
+        sponsor_name: string;
+    };
+    relevance_score?: number;
+    [key: string]: any;
 }
 type PlacementType = 'sponsored_suggestion' | 'sponsored_block' | 'sponsored_tool';
 interface Placement {

package/dist/index.js

@@ -468,7 +468,7 @@ var AttentionMarketClient = class {
     if (response.status === "no_fill") {
       return null;
     }
-    return response.units[0] ?? null;
+    return response.units?.[0] ?? null;
   }
   /**
    * Simplified ad matching using conversation context and semantic search.
@@ -584,6 +584,8 @@ var AttentionMarketClient = class {
       },
       context,
       user_intent: params.userMessage,
+      // Use minimal response format by default for better performance
+      response_format: "minimal",
       // Developer controls (Phase 1: Quality & Brand Safety)
       ...params.minQualityScore !== void 0 && { minQualityScore: params.minQualityScore },
       ...params.allowedCategories && { allowedCategories: params.allowedCategories },
@@ -595,7 +597,43 @@ var AttentionMarketClient = class {
       ...params.optimizeFor && { optimizeFor: params.optimizeFor }
     };
     const response = await this.decideRaw(request, options);
-    if (response.status === "no_fill" || response.units.length === 0) {
+    if (response.creative) {
+      try {
+        await this.track({
+          event_id: `evt_${generateUUID()}`,
+          event_type: "impression",
+          occurred_at: (/* @__PURE__ */ new Date()).toISOString(),
+          agent_id: this.agentId,
+          tracking_token: response.tracking_token
+        });
+      } catch (error) {
+        console.warn("[AttentionMarket] Failed to auto-track impression:", error);
+      }
+      const adResponse2 = {
+        request_id: request.request_id,
+        decision_id: `dec_${generateUUID()}`,
+        advertiser_id: response.advertiser_id || "",
+        ad_type: "link",
+        payout: response.payout || 0,
+        creative: response.creative,
+        click_url: response.click_url || "",
+        tracking_url: response.click_url || "",
+        // Same as click_url
+        tracking_token: response.tracking_token || "",
+        disclosure: response.disclosure || {
+          label: "Sponsored",
+          explanation: "This is a paid advertisement",
+          sponsor_name: "Advertiser"
+        },
+        // Internal fields preserved for backward compatibility
+        _ad: {
+          unit_id: "",
+          tracking: { token: response.tracking_token || "" }
+        }
+      };
+      return adResponse2;
+    }
+    if (response.status === "no_fill" || !response.units || response.units.length === 0) {
       return null;
     }
     const adUnit = response.units[0];
@@ -908,7 +946,7 @@ var AttentionMarketClient = class {
       user_intent: params.intentKey
     };
     const response = await this.decideRaw(request, { idempotencyKey });
-    if (response.status === "no_fill" || response.units.length === 0) {
+    if (response.status === "no_fill" || !response.units || response.units.length === 0) {
       return null;
     }
     const adUnit = response.units[0];
@@ -919,7 +957,7 @@ var AttentionMarketClient = class {
     const matchMethod = semanticContext ? "hybrid" : "semantic";
     return {
       offer_id: adUnit.unit_id,
-      request_id: response.request_id,
+      request_id: response.request_id || "",
       impression_id: impressionId,
       // LIMITATION: Backend doesn't return campaign_id yet - use unit_id as placeholder
       campaign_id: adUnit.unit_id,
@@ -950,7 +988,7 @@ var AttentionMarketClient = class {
           ...params.revenueSharePct !== void 0 ? { source_agent_pct: params.revenueSharePct } : {}
         }
       } : {},
-      ttl_ms: response.ttl_ms
+      ttl_ms: response.ttl_ms || 3e5
     };
   }
   /**
@@ -1041,7 +1079,7 @@ var AttentionMarketClient = class {
       user_intent: params.userMessage
     };
     const response = await this.decideRaw(request, { idempotencyKey });
-    if (response.status === "no_fill" || response.units.length === 0) {
+    if (response.status === "no_fill" || !response.units || response.units.length === 0) {
       return null;
     }
     const adUnit = response.units[0];
@@ -1052,7 +1090,7 @@ var AttentionMarketClient = class {
     const similarity = adUnit._score?.relevance;
     return {
       offer_id: adUnit.unit_id,
-      request_id: response.request_id,
+      request_id: response.request_id || "",
       impression_id: impressionId,
       // LIMITATION: Backend doesn't return campaign_id yet - use unit_id as placeholder
       campaign_id: adUnit.unit_id,
@@ -1083,7 +1121,7 @@ var AttentionMarketClient = class {
           ...params.revenueSharePct !== void 0 ? { source_agent_pct: params.revenueSharePct } : {}
         }
       } : {},
-      ttl_ms: response.ttl_ms
+      ttl_ms: response.ttl_ms || 3e5
     };
   }
   // ============================================================================
@@ -1169,7 +1207,7 @@ var AttentionMarketClient = class {
       user_intent: params.taskDescription
     };
     const response = await this.decideRaw(request);
-    if (response.status === "no_fill" || response.units.length === 0) {
+    if (response.status === "no_fill" || !response.units || response.units.length === 0) {
       return null;
     }
     const adUnit = response.units[0];
@@ -1430,7 +1468,7 @@ var MockAttentionMarketClient = class {
    */
   async decide(request) {
     const response = await this.decideRaw(request);
-    if (response.status === "filled" && response.units.length > 0) {
+    if (response.status === "filled" && response.units && response.units.length > 0) {
       return response.units[0] || null;
     }
     return null;