@the_ro_show/agent-ads-sdk 0.13.2 → 0.14.0

package/README.md

@@ -95,7 +95,8 @@ const client = new AttentionMarketClient({
 const client = new AttentionMarketClient({
   apiKey: 'am_live_YOUR_KEY',        // Required
   agentId: 'agt_YOUR_AGENT_ID',      // Required for decideFromContext()
-  baseUrl: 'https://peruwnbrqkvmrldhpoom.supabase.co/functions/v1',  // Optional: defaults to production
+  // 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
 });

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

@@ -457,7 +457,7 @@ var AttentionMarketClient = class {
     if (options?.idempotencyKey !== void 0) {
       requestOptions.idempotencyKey = options.idempotencyKey;
     }
-    return await this.http.request("POST", "/v1/decide", requestOptions);
+    return await this.http.request("POST", "/decide", requestOptions);
   }
   /**
    * Convenience wrapper around decideRaw().
@@ -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];
@@ -648,7 +686,7 @@ var AttentionMarketClient = class {
    * Report an event (impression, click, action, conversion, feedback).
    */
   async track(event) {
-    return await this.http.request("POST", "/v1/event", {
+    return await this.http.request("POST", "/event", {
       body: event
     });
   }
@@ -738,13 +776,13 @@ var AttentionMarketClient = class {
    * ```
    */
   async sendFeedback(request) {
-    return await this.http.request("POST", "/v1/feedback", { body: request });
+    return await this.http.request("POST", "/feedback", { body: request });
   }
   /**
    * Fetch default policy constraints and formatting requirements.
    */
   async getPolicy() {
-    return await this.http.request("GET", "/v1/policy");
+    return await this.http.request("GET", "/policy");
   }
   /**
    * Create or register an agent (optional helper).
@@ -756,7 +794,7 @@ var AttentionMarketClient = class {
       timeoutMs: DEFAULT_TIMEOUT_MS,
       maxRetries: DEFAULT_MAX_RETRIES
     });
-    return await http.request("POST", "/v1/agent-signup", {
+    return await http.request("POST", "/agent-signup", {
       body: request
     });
   }
@@ -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];
@@ -1215,7 +1253,7 @@ var AttentionMarketClient = class {
   async logServiceResult(params) {
     return await this.http.request(
       "POST",
-      "/v1/service-result",
+      "/service-result",
       { body: params }
     );
   }
@@ -1262,7 +1300,7 @@ var AttentionMarketClient = class {
     if (params?.search) {
       queryParams.append("search", params.search);
     }
-    const url = `/v1/categories${queryParams.toString() ? "?" + queryParams.toString() : ""}`;
+    const url = `/categories${queryParams.toString() ? "?" + queryParams.toString() : ""}`;
     return await this.http.request(
       "GET",
       url
@@ -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;