@aamp/protocol 1.1.5 → 1.1.6

package/src/types.ts

@@ -43,14 +43,35 @@ export interface IdentityCache {
   set(key: string, value: string, ttlSeconds: number): Promise<void>;
 }
 
+/**
+ * Optional Monetization (The Settlement Layer)
+ */
 /**
  * Optional Monetization (The Settlement Layer)
  */
 export interface MonetizationConfig {
-  method: 'BROKER' | 'CRYPTO' | 'PRIVATE_TREATY';
-  location: string; 
+  // Method 1: Payments (Flexible Callback)
+  // Developers implement their own logic (Database check, CMS lookup, etc.)
+  // Returns TRUE if the agent is a paid subscriber for this specific purpose.
+  checkPayment?: (agentId: string, purpose: string) => boolean | Promise<boolean>;
+
+  // Method 2: Ads (Proof Verification)
+  // Configuration to verify tokens from your Ad Provider (e.g. Google)
+  adNetwork?: {
+    jwksUrl: string;   // e.g. "https://www.googleapis.com/oauth2/v3/certs"
+    issuer: string;    // e.g. "https://accounts.google.com"
+  };
+
+  // Method 3: Payment Credentials (Unified JWT)
+  // Verifies "x-aamp-credential" for Broker or Direct payments.
+  paymentConfig?: {
+    jwksUrl: string;   // e.g. "https://my-site.com/.well-known/jwks.json"
+    issuer: string;    // e.g. "my-site.com"
+  };
 }
 
+
+
 /**
  * Handling Non-AAMP Visitors
  * 
@@ -65,15 +86,15 @@ export interface AccessPolicy {
   allowTraining: boolean;
   allowRAG: boolean;
   attributionRequired: boolean;
-  
+
   // Economic Signals
-  allowAdSupportedAccess: boolean; 
-  requiresPayment: boolean;        
+  allowAdSupportedAccess: boolean;
+  requiresPayment: boolean;
   paymentPointer?: string;
 
   // Identity Strictness
-  requireIdentityBinding?: boolean; 
-  
+  requireIdentityBinding?: boolean;
+
   // V1.1: Optional Settlement Info
   monetization?: MonetizationConfig;
 }
@@ -81,7 +102,7 @@ export interface AccessPolicy {
 export interface ProtocolHeader {
   v: '1.1';
   ts: string;
-  agent_id: string; 
+  agent_id: string;
   resource: string;
   purpose: AccessPurpose;
   context: {
@@ -98,11 +119,12 @@ export interface SignedAccessRequest {
 export interface FeedbackSignal {
   target_resource: string;
   agent_id: string;
-  quality_score: number; 
+  quality_score: number;
   flags: QualityFlag[];
   timestamp: string;
 }
 
+// Result of the full evaluation pipeline
 // Result of the full evaluation pipeline
 export interface EvaluationResult {
   allowed: boolean;
@@ -110,4 +132,15 @@ export interface EvaluationResult {
   reason: string;
   visitorType: 'VERIFIED_AGENT' | 'LIKELY_HUMAN' | 'UNIDENTIFIED_BOT';
   metadata?: any;
+  payment_status?: 'PAID_SUBSCRIBER' | 'AD_FUNDED' | 'UNPAID';
+  proofUsed?: string;
+}
+
+// Signed Quality Feedback (The "Report Card")
+export interface FeedbackSignalToken {
+  url: string;           // The resource being flagged
+  agent_id: string;      // Who is flagging it (e.g. "bot.openai.com")
+  quality_score: number; // 0.0 to 1.0
+  reason: string;        // e.g. "SEO_SPAM", "HATE_SPEECH"
+  timestamp: number;
 }

package/test/handshake.spec.ts

@@ -3,10 +3,10 @@
  * Run using: npm test
  * Location: sdk/typescript/test/handshake.spec.ts
  */
-import { AAMPAgent } from '../src/agent';
-import { AAMPPublisher } from '../src/publisher';
-import { AccessPurpose } from '../src/types';
-import { HEADERS } from '../src/constants';
+import { AAMPAgent } from '../src/agent.js';
+import { AAMPPublisher } from '../src/publisher.js';
+import { AccessPurpose } from '../src/types.js';
+import { HEADERS } from '../src/constants.js';
 
 async function runTest() {
   console.log("--- STARTING AAMP HANDSHAKE TEST ---");
@@ -29,7 +29,7 @@ async function runTest() {
   // TEST CASE A: Requesting RAG without Ads (Should FAIL due to Payment Requirement)
   console.log("\n[TEST A] Requesting RAG (No Ads)...");
   const reqA = await agent.createAccessRequest('/doc/1', AccessPurpose.RAG_RETRIEVAL, { adsDisplayed: false });
-  
+
   const payloadA = JSON.stringify(reqA.header);
   const headersA = {
     [HEADERS.PAYLOAD]: btoa(payloadA),
@@ -45,7 +45,7 @@ async function runTest() {
   // TEST CASE B: Requesting RAG WITH Ads (Should SUCCEED via Exemption)
   console.log("\n[TEST B] Requesting RAG (With Ads)...");
   const reqB = await agent.createAccessRequest('/doc/1', AccessPurpose.RAG_RETRIEVAL, { adsDisplayed: true });
-  
+
   const payloadB = JSON.stringify(reqB.header);
   const headersB = {
     [HEADERS.PAYLOAD]: btoa(payloadB),

package/tsconfig.json

@@ -1,8 +1,12 @@
 {
   "compilerOptions": {
     "target": "ES2020",
-    "module": "CommonJS",
-    "lib": ["ES2020", "DOM"],
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": [
+      "ES2020",
+      "DOM"
+    ],
     "declaration": true,
     "outDir": "./dist",
     "rootDir": "./src",
@@ -11,5 +15,7 @@
     "skipLibCheck": true,
     "forceConsistentCasingInFileNames": true
   },
-  "include": ["src/**/*"]
+  "include": [
+    "src/**/*"
+  ]
 }