@adcp/client 3.7.1 → 3.8.1

package/bin/adcp.js

@@ -41,7 +41,7 @@ const TEST_SCENARIOS = [
 // Note: These tokens are intentionally public for the AdCP test infrastructure.
 // They provide rate-limited access to test agents for SDK development and examples.
 const BUILT_IN_AGENTS = {
-  test: {
+  'test-mcp': {
     url: 'https://test-agent.adcontextprotocol.org/mcp/',
     protocol: 'mcp',
     auth_token: '1v8tAhASaUYYp4odoQ1PnMpdqNaMiTrCRqYo9OJp6IQ',
@@ -125,14 +125,30 @@ function extractProtocolMessage(conversation, protocol) {
 }
 
 /**
- * Display agent info - just calls library method
+ * Display agent info - includes capabilities detection for v3.0
  */
 async function displayAgentInfo(agentConfig, jsonOutput) {
   const client = new AdCPClient([agentConfig]);
-  const info = await client.agent(agentConfig.id).getAgentInfo();
+  const agentClient = client.agent(agentConfig.id);
+  const info = await agentClient.getAgentInfo();
+
+  // Try to get capabilities (v3.0 feature detection)
+  let capabilities = null;
+  try {
+    if (typeof agentClient.getCapabilities === 'function') {
+      capabilities = await agentClient.getCapabilities();
+    }
+  } catch (e) {
+    // Capabilities detection failed - continue without
+  }
 
   if (jsonOutput) {
-    console.log(JSON.stringify(info, null, 2));
+    // Include capabilities in JSON output
+    const output = {
+      ...info,
+      ...(capabilities && { capabilities }),
+    };
+    console.log(JSON.stringify(output, null, 2));
   } else {
     console.log(`\n📋 Agent Information\n`);
     console.log(`Name: ${info.name}`);
@@ -141,6 +157,29 @@ async function displayAgentInfo(agentConfig, jsonOutput) {
     }
     console.log(`Protocol: ${info.protocol.toUpperCase()}`);
     console.log(`URL: ${info.url}`);
+
+    // Display capabilities if available
+    if (capabilities) {
+      console.log(`\n🔧 Capabilities:\n`);
+      console.log(`   AdCP Version: ${capabilities.version}${capabilities._synthetic ? ' (detected)' : ''}`);
+      if (capabilities.protocols && capabilities.protocols.length > 0) {
+        console.log(`   Supported Protocols: ${capabilities.protocols.join(', ')}`);
+      }
+      if (capabilities.features) {
+        const features = [];
+        if (capabilities.features.supportsCreativeAssignments) features.push('creative_assignments');
+        if (capabilities.features.supportsRenders) features.push('renders');
+        if (capabilities.features.supportsPropertyListFiltering) features.push('property_list_filtering');
+        if (capabilities.features.supportsContentStandards) features.push('content_standards');
+        if (features.length > 0) {
+          console.log(`   v3.0 Features: ${features.join(', ')}`);
+        }
+      }
+      if (capabilities.extensions && capabilities.extensions.length > 0) {
+        console.log(`   Extensions: ${capabilities.extensions.join(', ')}`);
+      }
+    }
+
     console.log(`\nAvailable Tools (${info.tools.length}):\n`);
 
     if (info.tools.length === 0) {
@@ -279,7 +318,7 @@ async function handleTestCommand(args) {
     agentUrl = agentArg;
   } else {
     console.error(`ERROR: '${agentArg}' is not a valid agent alias or URL\n`);
-    console.error('Built-in aliases: test, test-a2a, creative');
+    console.error('Built-in aliases: test-mcp, test-a2a, creative');
     console.error(`Saved aliases: ${Object.keys(listAgents()).join(', ') || 'none'}\n`);
     process.exit(2);
   }
@@ -363,7 +402,7 @@ USAGE:
   npx @adcp/client <agent-alias|url> [tool-name] [payload] [options]
 
 ARGUMENTS:
-  agent-alias|url   Saved agent alias (e.g., 'test') or full URL to agent endpoint
+  agent-alias|url   Saved agent alias (e.g., 'test-mcp') or full URL to agent endpoint
   tool-name         Name of the tool to call (optional - omit to list available tools)
   payload           JSON payload for the tool (default: {})
                     - Can be inline JSON: '{"brief":"text"}'
@@ -381,7 +420,7 @@ OPTIONS:
   --debug           Show debug information
 
 BUILT-IN TEST AGENTS:
-  test                        AdCP public test agent (MCP, with auth)
+  test-mcp                    AdCP public test agent (MCP, with auth)
   test-a2a                    AdCP public test agent (A2A, with auth)
   test-no-auth                AdCP public test agent (MCP, no auth - demonstrates errors)
   test-a2a-no-auth            AdCP public test agent (A2A, no auth - demonstrates errors)
@@ -404,8 +443,8 @@ AGENT TESTING:
 
 EXAMPLES:
   # Use built-in test agent (zero config!)
-  npx @adcp/client test
-  npx @adcp/client test get_products '{"brief":"coffee brands"}'
+  npx @adcp/client test-mcp
+  npx @adcp/client test-mcp get_products '{"brief":"coffee brands"}'
   npx @adcp/client creative list_creative_formats
 
   # Use built-in test agent with A2A protocol
@@ -451,9 +490,9 @@ EXAMPLES:
   adcp myagent get_products '{"brief":"travel"}' --json | jq '.products[0]'
 
   # Run agent tests
-  adcp test test                          # Test built-in test agent with discovery scenario
-  adcp test test discovery                # Explicit discovery scenario
-  adcp test test full_sales_flow          # Full media buy lifecycle test
+  adcp test test-mcp                      # Test built-in test agent with discovery scenario
+  adcp test test-mcp discovery            # Explicit discovery scenario
+  adcp test test-mcp full_sales_flow      # Full media buy lifecycle test
   adcp test https://my-agent.com discovery --auth $TOKEN
   adcp test myagent error_handling --json # JSON output for CI
   adcp test --list-scenarios              # Show all available scenarios

package/dist/lib/adapters/content-standards-adapter.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Content Standards Adapter
+ *
+ * Server-side adapter for implementing content standards evaluation logic.
+ * Publishers use this to plug in their brand safety/suitability evaluation systems.
+ *
+ * This is a stub implementation that returns not-supported responses.
+ * Publishers should extend or replace this with their actual evaluation logic.
+ */
+import type { ListContentStandardsRequest, ListContentStandardsResponse, GetContentStandardsRequest, GetContentStandardsResponse, CreateContentStandardsRequest, CreateContentStandardsResponse, UpdateContentStandardsRequest, UpdateContentStandardsResponse, CalibrateContentRequest, CalibrateContentResponse, ValidateContentDeliveryRequest, ValidateContentDeliveryResponse, Artifact } from '../types/tools.generated';
+/**
+ * Content evaluation result from the adapter
+ */
+export interface ContentEvaluationResult {
+    verdict: 'pass' | 'fail';
+    confidence?: number;
+    explanation?: string;
+    features?: {
+        feature_id: string;
+        status: 'passed' | 'failed' | 'warning' | 'unevaluated';
+        explanation?: string;
+    }[];
+}
+/**
+ * Abstract interface for content standards adapters.
+ * Publishers implement this to provide their evaluation logic.
+ */
+export interface IContentStandardsAdapter {
+    /**
+     * Check if content standards are supported by this server
+     */
+    isSupported(): boolean;
+    /**
+     * List available content standards configurations
+     */
+    listStandards(request: ListContentStandardsRequest): Promise<ListContentStandardsResponse>;
+    /**
+     * Get a specific content standards configuration
+     */
+    getStandards(request: GetContentStandardsRequest): Promise<GetContentStandardsResponse>;
+    /**
+     * Create a new content standards configuration
+     */
+    createStandards(request: CreateContentStandardsRequest): Promise<CreateContentStandardsResponse>;
+    /**
+     * Update an existing content standards configuration
+     */
+    updateStandards(request: UpdateContentStandardsRequest): Promise<UpdateContentStandardsResponse>;
+    /**
+     * Calibrate content against standards (interactive feedback loop)
+     */
+    calibrateContent(request: CalibrateContentRequest): Promise<CalibrateContentResponse>;
+    /**
+     * Validate delivery records against content standards (batch validation)
+     */
+    validateContentDelivery(request: ValidateContentDeliveryRequest): Promise<ValidateContentDeliveryResponse>;
+    /**
+     * Evaluate a single artifact against standards.
+     * Used internally by get_products and create_media_buy to filter content.
+     */
+    evaluateArtifact(standardsId: string, artifact: Artifact): Promise<ContentEvaluationResult>;
+}
+/**
+ * Error codes for content standards operations
+ */
+export declare const ContentStandardsErrorCodes: {
+    readonly NOT_SUPPORTED: "content_standards_not_supported";
+    readonly STANDARDS_NOT_FOUND: "standards_not_found";
+    readonly INVALID_STANDARDS: "invalid_standards";
+    readonly EVALUATION_FAILED: "evaluation_failed";
+    readonly QUOTA_EXCEEDED: "quota_exceeded";
+};
+/**
+ * Stub implementation of ContentStandardsAdapter.
+ * Returns not-supported errors for all operations.
+ *
+ * Publishers should extend this class or provide their own implementation
+ * that integrates with their brand safety systems.
+ */
+export declare class ContentStandardsAdapter implements IContentStandardsAdapter {
+    /**
+     * Check if content standards are supported.
+     * Override this to return true when implementing real logic.
+     */
+    isSupported(): boolean;
+    listStandards(request: ListContentStandardsRequest): Promise<ListContentStandardsResponse>;
+    getStandards(request: GetContentStandardsRequest): Promise<GetContentStandardsResponse>;
+    createStandards(request: CreateContentStandardsRequest): Promise<CreateContentStandardsResponse>;
+    updateStandards(request: UpdateContentStandardsRequest): Promise<UpdateContentStandardsResponse>;
+    calibrateContent(request: CalibrateContentRequest): Promise<CalibrateContentResponse>;
+    validateContentDelivery(request: ValidateContentDeliveryRequest): Promise<ValidateContentDeliveryResponse>;
+    /**
+     * Evaluate a single artifact against content standards.
+     * Used by get_products and create_media_buy to filter content.
+     */
+    evaluateArtifact(standardsId: string, artifact: Artifact): Promise<ContentEvaluationResult>;
+}
+/**
+ * Helper to check if a response is an error response
+ */
+export declare function isContentStandardsError(response: ListContentStandardsResponse | GetContentStandardsResponse | CreateContentStandardsResponse): boolean;
+/**
+ * Default singleton instance for servers that don't need content standards
+ */
+export declare const defaultContentStandardsAdapter: ContentStandardsAdapter;
+//# sourceMappingURL=content-standards-adapter.d.ts.map

package/dist/lib/adapters/content-standards-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-standards-adapter.d.ts","sourceRoot":"","sources":["../../../src/lib/adapters/content-standards-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,EAC3B,6BAA6B,EAC7B,8BAA8B,EAC9B,6BAA6B,EAC7B,8BAA8B,EAC9B,uBAAuB,EACvB,wBAAwB,EACxB,8BAA8B,EAC9B,+BAA+B,EAE/B,QAAQ,EACT,MAAM,0BAA0B,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE;QACT,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,aAAa,CAAC;QACxD,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,EAAE,CAAC;CACL;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAE3F;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAExF;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAEjG;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAEjG;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAEtF;;OAEG;IACH,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAAC;IAE3G;;;OAGG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAC7F;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;CAM7B,CAAC;AAEX;;;;;;GAMG;AACH,qBAAa,uBAAwB,YAAW,wBAAwB;IACtE;;;OAGG;IACH,WAAW,IAAI,OAAO;IAIhB,aAAa,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAmB1F,YAAY,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAuBvF,eAAe,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,8BAA8B,CAAC;IAuBhG,eAAe,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,8BAA8B,CAAC;IAuBhG,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAuBrF,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,+BAA+B,CAAC;IA6BhH;;;OAGG;IACG,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAiBlG;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,4BAA4B,GAAG,2BAA2B,GAAG,8BAA8B,GACpG,OAAO,CAET;AAED;;GAEG;AACH,eAAO,MAAM,8BAA8B,yBAAgC,CAAC"}

package/dist/lib/adapters/content-standards-adapter.js

@@ -0,0 +1,199 @@
+"use strict";
+/**
+ * Content Standards Adapter
+ *
+ * Server-side adapter for implementing content standards evaluation logic.
+ * Publishers use this to plug in their brand safety/suitability evaluation systems.
+ *
+ * This is a stub implementation that returns not-supported responses.
+ * Publishers should extend or replace this with their actual evaluation logic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultContentStandardsAdapter = exports.ContentStandardsAdapter = exports.ContentStandardsErrorCodes = void 0;
+exports.isContentStandardsError = isContentStandardsError;
+/**
+ * Error codes for content standards operations
+ */
+exports.ContentStandardsErrorCodes = {
+    NOT_SUPPORTED: 'content_standards_not_supported',
+    STANDARDS_NOT_FOUND: 'standards_not_found',
+    INVALID_STANDARDS: 'invalid_standards',
+    EVALUATION_FAILED: 'evaluation_failed',
+    QUOTA_EXCEEDED: 'quota_exceeded',
+};
+/**
+ * Stub implementation of ContentStandardsAdapter.
+ * Returns not-supported errors for all operations.
+ *
+ * Publishers should extend this class or provide their own implementation
+ * that integrates with their brand safety systems.
+ */
+class ContentStandardsAdapter {
+    /**
+     * Check if content standards are supported.
+     * Override this to return true when implementing real logic.
+     */
+    isSupported() {
+        return false;
+    }
+    async listStandards(request) {
+        if (!this.isSupported()) {
+            return {
+                errors: [
+                    {
+                        code: exports.ContentStandardsErrorCodes.NOT_SUPPORTED,
+                        message: 'Content standards are not supported by this server',
+                    },
+                ],
+            };
+        }
+        // Override in subclass to return actual standards
+        return {
+            standards: [],
+            context: request.context,
+        };
+    }
+    async getStandards(request) {
+        if (!this.isSupported()) {
+            return {
+                errors: [
+                    {
+                        code: exports.ContentStandardsErrorCodes.NOT_SUPPORTED,
+                        message: 'Content standards are not supported by this server',
+                    },
+                ],
+            };
+        }
+        // Override in subclass to return actual standards
+        return {
+            errors: [
+                {
+                    code: exports.ContentStandardsErrorCodes.STANDARDS_NOT_FOUND,
+                    message: `Standards not found: ${request.standards_id}`,
+                },
+            ],
+        };
+    }
+    async createStandards(request) {
+        if (!this.isSupported()) {
+            return {
+                errors: [
+                    {
+                        code: exports.ContentStandardsErrorCodes.NOT_SUPPORTED,
+                        message: 'Content standards are not supported by this server',
+                    },
+                ],
+            };
+        }
+        // Override in subclass to implement creation logic
+        return {
+            errors: [
+                {
+                    code: exports.ContentStandardsErrorCodes.NOT_SUPPORTED,
+                    message: 'Creating content standards is not implemented',
+                },
+            ],
+        };
+    }
+    async updateStandards(request) {
+        if (!this.isSupported()) {
+            return {
+                errors: [
+                    {
+                        code: exports.ContentStandardsErrorCodes.NOT_SUPPORTED,
+                        message: 'Content standards are not supported by this server',
+                    },
+                ],
+            };
+        }
+        // Override in subclass to implement update logic
+        return {
+            errors: [
+                {
+                    code: exports.ContentStandardsErrorCodes.NOT_SUPPORTED,
+                    message: 'Updating content standards is not implemented',
+                },
+            ],
+        };
+    }
+    async calibrateContent(request) {
+        if (!this.isSupported()) {
+            return {
+                errors: [
+                    {
+                        code: exports.ContentStandardsErrorCodes.NOT_SUPPORTED,
+                        message: 'Content standards calibration is not supported by this server',
+                    },
+                ],
+            };
+        }
+        // Override in subclass to implement calibration logic
+        return {
+            errors: [
+                {
+                    code: exports.ContentStandardsErrorCodes.EVALUATION_FAILED,
+                    message: 'Content calibration is not implemented',
+                },
+            ],
+        };
+    }
+    async validateContentDelivery(request) {
+        if (!this.isSupported()) {
+            return {
+                errors: [
+                    {
+                        code: exports.ContentStandardsErrorCodes.NOT_SUPPORTED,
+                        message: 'Content delivery validation is not supported by this server',
+                    },
+                ],
+                context: request.context,
+            };
+        }
+        // Override in subclass to implement validation logic
+        // Stub returns all records as passed (no filtering)
+        return {
+            summary: {
+                total_records: request.records.length,
+                passed_records: request.records.length,
+                failed_records: 0,
+            },
+            results: request.records.map(record => ({
+                record_id: record.record_id,
+                verdict: 'pass',
+            })),
+            context: request.context,
+        };
+    }
+    /**
+     * Evaluate a single artifact against content standards.
+     * Used by get_products and create_media_buy to filter content.
+     */
+    async evaluateArtifact(standardsId, artifact) {
+        if (!this.isSupported()) {
+            // When not supported, all content passes (no filtering)
+            return {
+                verdict: 'pass',
+                confidence: 1.0,
+                explanation: 'Content standards evaluation not enabled',
+            };
+        }
+        // Override in subclass to implement actual evaluation
+        return {
+            verdict: 'pass',
+            confidence: 1.0,
+            explanation: 'Default pass-through (no evaluation implemented)',
+        };
+    }
+}
+exports.ContentStandardsAdapter = ContentStandardsAdapter;
+/**
+ * Helper to check if a response is an error response
+ */
+function isContentStandardsError(response) {
+    return 'errors' in response && Array.isArray(response.errors) && response.errors.length > 0;
+}
+/**
+ * Default singleton instance for servers that don't need content standards
+ */
+exports.defaultContentStandardsAdapter = new ContentStandardsAdapter();
+//# sourceMappingURL=content-standards-adapter.js.map

package/dist/lib/adapters/content-standards-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-standards-adapter.js","sourceRoot":"","sources":["../../../src/lib/adapters/content-standards-adapter.ts"],"names":[],"mappings":"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"}

package/dist/lib/adapters/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Server-Side Adapters
+ *
+ * These adapters allow publishers/brands to plug in their business logic
+ * when implementing AdCP servers. Each adapter provides a stub implementation
+ * that can be extended or replaced.
+ *
+ * Usage:
+ * - ContentStandardsAdapter: Implement brand safety/suitability evaluation
+ * - PropertyListAdapter: Manage buyer-defined property lists
+ * - ProposalManager: Generate and refine media plan proposals
+ * - SISessionManager: Handle Sponsored Intelligence conversational sessions
+ */
+export { ContentStandardsAdapter, type IContentStandardsAdapter, type ContentEvaluationResult, ContentStandardsErrorCodes, isContentStandardsError, defaultContentStandardsAdapter, } from './content-standards-adapter';
+export { PropertyListAdapter, type IPropertyListAdapter, type ResolvedProperty, PropertyListErrorCodes, isPropertyListError, defaultPropertyListAdapter, } from './property-list-adapter';
+export { ProposalManager, AIProposalManager, type IProposalManager, type ProposalContext, ProposalErrorCodes, defaultProposalManager, } from './proposal-manager';
+export { SISessionManager, AISISessionManager, type ISISessionManager, type SISession, SIErrorCodes, defaultSISessionManager, } from './si-session-manager';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EACL,uBAAuB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,0BAA0B,EAC1B,uBAAuB,EACvB,8BAA8B,GAC/B,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,YAAY,EACZ,uBAAuB,GACxB,MAAM,sBAAsB,CAAC"}

package/dist/lib/adapters/index.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * Server-Side Adapters
+ *
+ * These adapters allow publishers/brands to plug in their business logic
+ * when implementing AdCP servers. Each adapter provides a stub implementation
+ * that can be extended or replaced.
+ *
+ * Usage:
+ * - ContentStandardsAdapter: Implement brand safety/suitability evaluation
+ * - PropertyListAdapter: Manage buyer-defined property lists
+ * - ProposalManager: Generate and refine media plan proposals
+ * - SISessionManager: Handle Sponsored Intelligence conversational sessions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultSISessionManager = exports.SIErrorCodes = exports.AISISessionManager = exports.SISessionManager = exports.defaultProposalManager = exports.ProposalErrorCodes = exports.AIProposalManager = exports.ProposalManager = exports.defaultPropertyListAdapter = exports.isPropertyListError = exports.PropertyListErrorCodes = exports.PropertyListAdapter = exports.defaultContentStandardsAdapter = exports.isContentStandardsError = exports.ContentStandardsErrorCodes = exports.ContentStandardsAdapter = void 0;
+// Content Standards
+var content_standards_adapter_1 = require("./content-standards-adapter");
+Object.defineProperty(exports, "ContentStandardsAdapter", { enumerable: true, get: function () { return content_standards_adapter_1.ContentStandardsAdapter; } });
+Object.defineProperty(exports, "ContentStandardsErrorCodes", { enumerable: true, get: function () { return content_standards_adapter_1.ContentStandardsErrorCodes; } });
+Object.defineProperty(exports, "isContentStandardsError", { enumerable: true, get: function () { return content_standards_adapter_1.isContentStandardsError; } });
+Object.defineProperty(exports, "defaultContentStandardsAdapter", { enumerable: true, get: function () { return content_standards_adapter_1.defaultContentStandardsAdapter; } });
+// Property Lists
+var property_list_adapter_1 = require("./property-list-adapter");
+Object.defineProperty(exports, "PropertyListAdapter", { enumerable: true, get: function () { return property_list_adapter_1.PropertyListAdapter; } });
+Object.defineProperty(exports, "PropertyListErrorCodes", { enumerable: true, get: function () { return property_list_adapter_1.PropertyListErrorCodes; } });
+Object.defineProperty(exports, "isPropertyListError", { enumerable: true, get: function () { return property_list_adapter_1.isPropertyListError; } });
+Object.defineProperty(exports, "defaultPropertyListAdapter", { enumerable: true, get: function () { return property_list_adapter_1.defaultPropertyListAdapter; } });
+// Proposal Management
+var proposal_manager_1 = require("./proposal-manager");
+Object.defineProperty(exports, "ProposalManager", { enumerable: true, get: function () { return proposal_manager_1.ProposalManager; } });
+Object.defineProperty(exports, "AIProposalManager", { enumerable: true, get: function () { return proposal_manager_1.AIProposalManager; } });
+Object.defineProperty(exports, "ProposalErrorCodes", { enumerable: true, get: function () { return proposal_manager_1.ProposalErrorCodes; } });
+Object.defineProperty(exports, "defaultProposalManager", { enumerable: true, get: function () { return proposal_manager_1.defaultProposalManager; } });
+// Sponsored Intelligence Sessions
+var si_session_manager_1 = require("./si-session-manager");
+Object.defineProperty(exports, "SISessionManager", { enumerable: true, get: function () { return si_session_manager_1.SISessionManager; } });
+Object.defineProperty(exports, "AISISessionManager", { enumerable: true, get: function () { return si_session_manager_1.AISISessionManager; } });
+Object.defineProperty(exports, "SIErrorCodes", { enumerable: true, get: function () { return si_session_manager_1.SIErrorCodes; } });
+Object.defineProperty(exports, "defaultSISessionManager", { enumerable: true, get: function () { return si_session_manager_1.defaultSISessionManager; } });
+//# sourceMappingURL=index.js.map

package/dist/lib/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/adapters/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAEH,oBAAoB;AACpB,yEAOqC;AANnC,oIAAA,uBAAuB,OAAA;AAGvB,uIAAA,0BAA0B,OAAA;AAC1B,oIAAA,uBAAuB,OAAA;AACvB,2IAAA,8BAA8B,OAAA;AAGhC,iBAAiB;AACjB,iEAOiC;AAN/B,4HAAA,mBAAmB,OAAA;AAGnB,+HAAA,sBAAsB,OAAA;AACtB,4HAAA,mBAAmB,OAAA;AACnB,mIAAA,0BAA0B,OAAA;AAG5B,sBAAsB;AACtB,uDAO4B;AAN1B,mHAAA,eAAe,OAAA;AACf,qHAAA,iBAAiB,OAAA;AAGjB,sHAAA,kBAAkB,OAAA;AAClB,0HAAA,sBAAsB,OAAA;AAGxB,kCAAkC;AAClC,2DAO8B;AAN5B,sHAAA,gBAAgB,OAAA;AAChB,wHAAA,kBAAkB,OAAA;AAGlB,kHAAA,YAAY,OAAA;AACZ,6HAAA,uBAAuB,OAAA"}

package/dist/lib/adapters/property-list-adapter.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Property List Adapter
+ *
+ * Server-side adapter for implementing property list management logic.
+ * Publishers use this to manage buyer-defined property lists for filtering
+ * available inventory.
+ *
+ * This is a stub implementation that stores lists in memory.
+ * Publishers should extend or replace this with persistent storage.
+ */
+import type { CreatePropertyListRequest, CreatePropertyListResponse, UpdatePropertyListRequest, UpdatePropertyListResponse, GetPropertyListRequest, GetPropertyListResponse, ListPropertyListsRequest, ListPropertyListsResponse, DeletePropertyListRequest, DeletePropertyListResponse } from '../types/tools.generated';
+/**
+ * Resolved property identifier
+ */
+export interface ResolvedProperty {
+    identifier_type: string;
+    identifier_value: string;
+    publisher_domain?: string;
+    display_name?: string;
+    status?: 'active' | 'inactive' | 'pending';
+}
+/**
+ * Error thrown when property list operations fail
+ */
+export declare class PropertyListError extends Error {
+    code: string;
+    constructor(code: string, message: string);
+}
+/**
+ * Abstract interface for property list adapters.
+ * Publishers implement this to provide their storage and resolution logic.
+ */
+export interface IPropertyListAdapter {
+    /**
+     * Check if property list management is supported by this server
+     */
+    isSupported(): boolean;
+    /**
+     * Create a new property list
+     */
+    createList(request: CreatePropertyListRequest): Promise<CreatePropertyListResponse>;
+    /**
+     * Update an existing property list
+     */
+    updateList(request: UpdatePropertyListRequest): Promise<UpdatePropertyListResponse>;
+    /**
+     * Get a property list with optional resolution
+     */
+    getList(request: GetPropertyListRequest): Promise<GetPropertyListResponse>;
+    /**
+     * List all property lists for a principal
+     */
+    listLists(request: ListPropertyListsRequest): Promise<ListPropertyListsResponse>;
+    /**
+     * Delete a property list
+     */
+    deleteList(request: DeletePropertyListRequest): Promise<DeletePropertyListResponse>;
+    /**
+     * Check if a property identifier is in a property list.
+     * Used by get_products and create_media_buy for filtering.
+     */
+    isPropertyInList(listId: string, identifierType: string, identifierValue: string): Promise<boolean>;
+    /**
+     * Resolve a property list to its constituent identifiers.
+     * Applies filters and returns matching properties.
+     */
+    resolveList(listId: string, maxResults?: number, cursor?: string): Promise<ResolvedProperty[]>;
+}
+/**
+ * Error codes for property list operations
+ */
+export declare const PropertyListErrorCodes: {
+    readonly NOT_SUPPORTED: "property_lists_not_supported";
+    readonly LIST_NOT_FOUND: "list_not_found";
+    readonly INVALID_LIST: "invalid_list";
+    readonly PERMISSION_DENIED: "permission_denied";
+    readonly QUOTA_EXCEEDED: "quota_exceeded";
+};
+/**
+ * Stub implementation of PropertyListAdapter.
+ * Uses in-memory storage for development and testing.
+ *
+ * Publishers should extend this class or provide their own implementation
+ * that integrates with their property management systems.
+ */
+export declare class PropertyListAdapter implements IPropertyListAdapter {
+    private lists;
+    private authTokens;
+    private nextId;
+    /**
+     * Check if property list management is supported.
+     * Override this to return true when implementing real logic.
+     */
+    isSupported(): boolean;
+    createList(request: CreatePropertyListRequest): Promise<CreatePropertyListResponse>;
+    updateList(request: UpdatePropertyListRequest): Promise<UpdatePropertyListResponse>;
+    getList(request: GetPropertyListRequest): Promise<GetPropertyListResponse>;
+    listLists(request: ListPropertyListsRequest): Promise<ListPropertyListsResponse>;
+    deleteList(request: DeletePropertyListRequest): Promise<DeletePropertyListResponse>;
+    /**
+     * Check if a property is in a list.
+     * Stub implementation returns false (property not found).
+     */
+    isPropertyInList(listId: string, identifierType: string, identifierValue: string): Promise<boolean>;
+    /**
+     * Resolve a property list to identifiers.
+     * Stub implementation returns empty array.
+     */
+    resolveList(listId: string, maxResults?: number, cursor?: string): Promise<ResolvedProperty[]>;
+    /**
+     * Generate a random token for auth
+     */
+    protected generateToken(): string;
+}
+/**
+ * Helper to check if an error is a PropertyListError
+ */
+export declare function isPropertyListError(error: unknown): error is PropertyListError;
+/**
+ * Default singleton instance for servers that don't need property list management
+ */
+export declare const defaultPropertyListAdapter: PropertyListAdapter;
+//# sourceMappingURL=property-list-adapter.d.ts.map

package/dist/lib/adapters/property-list-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-list-adapter.d.ts","sourceRoot":"","sources":["../../../src/lib/adapters/property-list-adapter.ts"],"names":[],"mappings":"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"}