@adcp/client 4.8.0 → 4.10.0

package/bin/adcp.js

@@ -56,6 +56,10 @@ const TEST_SCENARIOS = [
   'governance_content_standards',
   'si_session_lifecycle',
   'si_availability',
+  'campaign_governance',
+  'campaign_governance_denied',
+  'campaign_governance_conditions',
+  'campaign_governance_delivery',
 ];
 
 // Built-in test agent aliases (shared between main CLI and test command)
@@ -248,6 +252,10 @@ async function handleTestCommand(args) {
       governance_content_standards: 'Test content standards listing and calibration',
       si_session_lifecycle: 'Test full SI session: initiate → messages → terminate',
       si_availability: 'Quick check for SI offering availability',
+      campaign_governance: 'Full governance lifecycle: sync_plans → check → execute → report',
+      campaign_governance_denied: 'Denied flow: over-budget, unauthorized market',
+      campaign_governance_conditions: 'Conditions flow: apply conditions → re-check',
+      campaign_governance_delivery: 'Delivery monitoring with drift detection',
     };
 
     for (const scenario of TEST_SCENARIOS) {
@@ -452,6 +460,321 @@ async function handleTestCommand(args) {
   }
 }
 
+/**
+ * Parse common agent/auth options shared by test, comply, and convince commands.
+ */
+function parseAgentOptions(args) {
+  const authIndex = args.indexOf('--auth');
+  let authToken = process.env.ADCP_AUTH_TOKEN;
+  if (authIndex !== -1 && authIndex + 1 < args.length && !args[authIndex + 1].startsWith('--')) {
+    authToken = args[authIndex + 1];
+  }
+
+  const protocolIndex = args.indexOf('--protocol');
+  let protocolFlag = null;
+  if (protocolIndex !== -1 && protocolIndex + 1 < args.length && !args[protocolIndex + 1].startsWith('--')) {
+    protocolFlag = args[protocolIndex + 1];
+  }
+
+  const briefIndex = args.indexOf('--brief');
+  let brief;
+  if (briefIndex !== -1 && briefIndex + 1 < args.length && !args[briefIndex + 1].startsWith('--')) {
+    brief = args[briefIndex + 1];
+  }
+
+  const jsonOutput = args.includes('--json');
+  const debug = args.includes('--debug') || process.env.ADCP_DEBUG === 'true';
+  const dryRun = !args.includes('--no-dry-run');
+
+  // Filter out flags to find positional args
+  const positionalArgs = args.filter(
+    arg => !arg.startsWith('--') && arg !== authToken && arg !== protocolFlag && arg !== brief
+  );
+
+  return { authToken, protocolFlag, brief, jsonOutput, debug, dryRun, positionalArgs };
+}
+
+/**
+ * Resolve an agent argument (alias or URL) to { agentUrl, protocol, authToken }
+ *
+ * Auth resolution order:
+ *   1. Explicit --auth token from CLI
+ *   2. ADCP_AUTH_TOKEN env var
+ *   3. Saved OAuth tokens (if alias has them and they're valid)
+ *   4. Static auth_token from alias or built-in
+ *   5. None
+ */
+async function resolveAgent(agentArg, authToken, protocolFlag, jsonOutput) {
+  let agentUrl;
+  let protocol = protocolFlag;
+  let finalAuthToken = authToken;
+
+  if (BUILT_IN_AGENTS[agentArg]) {
+    const builtIn = BUILT_IN_AGENTS[agentArg];
+    agentUrl = builtIn.url;
+    protocol = protocol || builtIn.protocol;
+    finalAuthToken = finalAuthToken || builtIn.auth_token;
+  } else if (isAlias(agentArg)) {
+    const savedAgent = getAgent(agentArg);
+    agentUrl = savedAgent.url;
+    protocol = protocol || savedAgent.protocol;
+    // Use getEffectiveAuthToken: prefers valid OAuth tokens, falls back to static token
+    finalAuthToken = finalAuthToken || getEffectiveAuthToken(savedAgent);
+  } else if (agentArg.startsWith('http://') || agentArg.startsWith('https://')) {
+    agentUrl = agentArg;
+  } else {
+    console.error(`ERROR: '${agentArg}' is not a valid agent alias or URL\n`);
+    console.error('Built-in aliases: test-mcp, test-a2a, creative');
+    console.error(`Saved aliases: ${Object.keys(listAgents()).join(', ') || 'none'}\n`);
+    process.exit(2);
+  }
+
+  // Auto-detect protocol if not specified
+  if (!protocol) {
+    if (!jsonOutput) console.error('Auto-detecting protocol...');
+    try {
+      protocol = await detectProtocol(agentUrl);
+      if (!jsonOutput) console.error(`Detected protocol: ${protocol.toUpperCase()}\n`);
+    } catch (error) {
+      console.error(`ERROR: Failed to detect protocol: ${error.message}\n`);
+      process.exit(2);
+    }
+  }
+
+  return { agentUrl, protocol, authToken: finalAuthToken };
+}
+
+async function handleComplyCommand(args) {
+  if (args.includes('--help') || args.length === 0) {
+    console.log(`
+AdCP Comply - Compliance Assessment
+
+USAGE:
+  adcp comply <agent> [options]
+
+DESCRIPTION:
+  Runs all applicable capability tracks against an agent and reports
+  results for every track. Never stops at the first failure — shows
+  the full picture.
+
+  Tracks: core, products, media_buy, creative, reporting, governance,
+          signals, si, audiences
+
+OPTIONS:
+  --auth TOKEN        Authentication token (overrides saved tokens)
+  --protocol PROTO    Force protocol: mcp or a2a
+  --tracks TRACKS     Comma-separated tracks to run (default: all applicable)
+  --brief TEXT        Custom brief for product discovery
+  --json              Output raw JSON
+  --debug             Show debug output
+  --no-dry-run        Run in live mode (default: dry run)
+
+EXAMPLES:
+  adcp comply test-mcp
+  adcp comply myagent                                    # uses saved OAuth tokens automatically
+  adcp comply test-mcp --tracks core,products,media_buy
+  adcp comply https://my-agent.com/mcp --auth my-token
+  adcp comply test-mcp --json | jq '.summary'
+`);
+    return;
+  }
+
+  const opts = parseAgentOptions(args);
+
+  if (opts.positionalArgs.length === 0) {
+    console.error('ERROR: comply requires an agent alias or URL\n');
+    process.exit(2);
+  }
+
+  const {
+    agentUrl,
+    protocol,
+    authToken: finalAuthToken,
+  } = await resolveAgent(opts.positionalArgs[0], opts.authToken, opts.protocolFlag, opts.jsonOutput);
+
+  // Parse --tracks
+  const tracksIndex = args.indexOf('--tracks');
+  let tracks;
+  if (tracksIndex !== -1 && tracksIndex + 1 < args.length) {
+    tracks = args[tracksIndex + 1].split(',');
+  }
+
+  const testOptions = {
+    protocol,
+    dry_run: opts.dryRun,
+    brief: opts.brief,
+    tracks,
+    ...(finalAuthToken && { auth: { type: 'bearer', token: finalAuthToken } }),
+  };
+
+  if (!opts.jsonOutput) {
+    console.log(`\n🔍 Running compliance assessment against ${agentUrl}`);
+    console.log(`   Protocol: ${protocol.toUpperCase()}`);
+    console.log(`   Mode: ${opts.dryRun ? 'Dry Run' : 'Live'}`);
+    console.log(`   Auth: ${finalAuthToken ? 'configured' : 'none'}\n`);
+  }
+
+  try {
+    const { comply, formatComplianceResults, formatComplianceResultsJSON } =
+      await import('../dist/lib/testing/compliance/index.js');
+
+    // Silence logger unless debug
+    const { setAgentTesterLogger } = await import('../dist/lib/testing/client.js');
+    if (!opts.debug) {
+      setAgentTesterLogger({ info: () => {}, error: () => {}, warn: () => {}, debug: () => {} });
+    }
+
+    const result = await comply(agentUrl, testOptions);
+
+    if (opts.jsonOutput) {
+      console.log(formatComplianceResultsJSON(result));
+    } else {
+      console.log(formatComplianceResults(result));
+    }
+
+    const hasFailures = result.summary.tracks_failed > 0;
+    process.exit(hasFailures ? 3 : 0);
+  } catch (error) {
+    console.error(`\n❌ Compliance assessment failed: ${error.message}`);
+    if (opts.debug) console.error(error.stack);
+    process.exit(1);
+  }
+}
+
+async function handleConvinceCommand(args) {
+  if (args.includes('--help') || args.length === 0) {
+    console.log(`
+AdCP Convince - AI-Assessed Merchandising Quality
+
+USAGE:
+  adcp convince <agent> [options]
+
+DESCRIPTION:
+  Runs sample briefs against the agent's get_products endpoint and
+  uses an LLM to evaluate the quality of responses. Tests whether
+  your products would convince a buyer to transact.
+
+  Dimensions assessed: relevance, specificity, completeness, pricing,
+  merchandising
+
+OPTIONS:
+  --auth TOKEN           Authentication token (overrides saved tokens)
+  --protocol PROTO       Force protocol: mcp or a2a
+  --anthropic-key KEY    Anthropic API key (or set ANTHROPIC_API_KEY env var)
+  --gemini-key KEY       Google Gemini API key (or set GEMINI_API_KEY env var)
+  --briefs IDS           Comma-separated brief IDs to run (default: all)
+  --list-briefs          List available sample briefs
+  --brief TEXT           Custom brief for product discovery
+  --model MODEL          LLM model override
+  --json                 Output raw JSON
+  --debug                Show debug output
+  --no-dry-run           Run in live mode (default: dry run)
+
+EXAMPLES:
+  adcp convince myagent --anthropic-key sk-ant-...       # uses saved OAuth tokens automatically
+  adcp convince test-mcp --anthropic-key sk-ant-...
+  adcp convince test-mcp --briefs luxury_auto_ev,dtc_skincare_genZ
+  adcp convince test-mcp --list-briefs
+  ANTHROPIC_API_KEY=sk-ant-... adcp convince test-mcp
+`);
+    return;
+  }
+
+  // Handle --list-briefs
+  if (args.includes('--list-briefs')) {
+    const { SAMPLE_BRIEFS } = await import('../dist/lib/testing/compliance/briefs.js');
+    console.log('\n📋 Available Sample Briefs:\n');
+    for (const brief of SAMPLE_BRIEFS) {
+      console.log(`  ${brief.id}`);
+      console.log(`    ${brief.name} (${brief.vertical})`);
+      console.log(`    Budget: ${brief.budget_context || 'Not specified'}`);
+      console.log(`    ${brief.brief.slice(0, 100)}...`);
+      console.log('');
+    }
+    return;
+  }
+
+  const opts = parseAgentOptions(args);
+
+  if (opts.positionalArgs.length === 0) {
+    console.error('ERROR: convince requires an agent alias or URL\n');
+    process.exit(2);
+  }
+
+  const {
+    agentUrl,
+    protocol,
+    authToken: finalAuthToken,
+  } = await resolveAgent(opts.positionalArgs[0], opts.authToken, opts.protocolFlag, opts.jsonOutput);
+
+  // Parse LLM keys
+  const anthropicKeyIndex = args.indexOf('--anthropic-key');
+  const geminiKeyIndex = args.indexOf('--gemini-key');
+  const modelIndex = args.indexOf('--model');
+  const briefsIndex = args.indexOf('--briefs');
+
+  const anthropic_api_key = anthropicKeyIndex !== -1 ? args[anthropicKeyIndex + 1] : process.env.ANTHROPIC_API_KEY;
+  const gemini_api_key = geminiKeyIndex !== -1 ? args[geminiKeyIndex + 1] : process.env.GEMINI_API_KEY;
+  const model = modelIndex !== -1 ? args[modelIndex + 1] : undefined;
+  const brief_ids = briefsIndex !== -1 ? args[briefsIndex + 1].split(',') : undefined;
+
+  if (!anthropic_api_key && !gemini_api_key) {
+    console.error('ERROR: convince requires an LLM API key\n');
+    console.error('Provide one of:');
+    console.error('  --anthropic-key KEY    or set ANTHROPIC_API_KEY');
+    console.error('  --gemini-key KEY       or set GEMINI_API_KEY\n');
+    process.exit(2);
+  }
+
+  const testOptions = {
+    protocol,
+    dry_run: opts.dryRun,
+    brief: opts.brief,
+    anthropic_api_key,
+    gemini_api_key,
+    model,
+    brief_ids,
+    ...(finalAuthToken && { auth: { type: 'bearer', token: finalAuthToken } }),
+  };
+
+  const evaluator = anthropic_api_key ? 'Anthropic' : 'Gemini';
+  const briefCount = brief_ids ? brief_ids.length : 'all';
+
+  if (!opts.jsonOutput) {
+    console.log(`\n🎯 Running convince assessment against ${agentUrl}`);
+    console.log(`   Protocol: ${protocol.toUpperCase()}`);
+    console.log(`   Evaluator: ${evaluator}`);
+    console.log(`   Briefs: ${briefCount}`);
+    console.log(`   Mode: ${opts.dryRun ? 'Dry Run' : 'Live'}`);
+    console.log(`   Auth: ${finalAuthToken ? 'configured' : 'none'}\n`);
+  }
+
+  try {
+    const { convince, formatConvinceResults, formatConvinceResultsJSON } =
+      await import('../dist/lib/testing/compliance/index.js');
+
+    // Silence logger unless debug
+    const { setAgentTesterLogger } = await import('../dist/lib/testing/client.js');
+    if (!opts.debug) {
+      setAgentTesterLogger({ info: () => {}, error: () => {}, warn: () => {}, debug: () => {} });
+    }
+
+    const result = await convince(agentUrl, testOptions);
+
+    if (opts.jsonOutput) {
+      console.log(formatConvinceResultsJSON(result));
+    } else {
+      console.log(formatConvinceResults(result));
+    }
+
+    process.exit(0);
+  } catch (error) {
+    console.error(`\n❌ Convince assessment failed: ${error.message}`);
+    if (opts.debug) console.error(error.stack);
+    process.exit(1);
+  }
+}
+
 function printUsage() {
   console.log(`
 AdCP CLI Tool - Direct Agent Communication
@@ -503,6 +826,17 @@ AGENT TESTING:
                               Default scenario: discovery
   test --list-scenarios       List all available test scenarios
 
+COMPLIANCE & QUALITY:
+  comply <agent> [options]    Run compliance assessment across all capability tracks
+                              Tracks: core, products, media_buy, creative, reporting,
+                              governance, signals, si, audiences
+  comply --help               Full comply usage
+
+  convince <agent> [options]  AI-assessed merchandising quality against sample briefs
+                              Requires: --anthropic-key or --gemini-key (or env vars)
+  convince --list-briefs      List available sample briefs
+  convince --help             Full convince usage
+
 REGISTRY:
   registry brand <domain>                          Look up a brand
   registry brands <d1> <d2> ...                    Bulk brand lookup
@@ -861,6 +1195,18 @@ async function main() {
     return; // handleTestCommand exits, but return for clarity
   }
 
+  // Handle comply command
+  if (args[0] === 'comply') {
+    await handleComplyCommand(args.slice(1));
+    return;
+  }
+
+  // Handle convince command
+  if (args[0] === 'convince') {
+    await handleConvinceCommand(args.slice(1));
+    return;
+  }
+
   // Parse arguments
   if (args.length < 1) {
     console.error('ERROR: Missing required arguments\n');

package/dist/lib/adapters/governance-adapter.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Governance Adapter
+ *
+ * Server-side adapter for implementing committed governance checks.
+ * Sellers use this to check governance before executing media buys.
+ *
+ * The committed check verifies that the seller's planned delivery
+ * parameters comply with the buyer's campaign governance plan.
+ */
+import type { CheckGovernanceRequest, CheckGovernanceResponse, PlannedDelivery, GovernancePhase } from '../types/tools.generated';
+import type { AgentConfig } from '../types';
+/**
+ * Configuration for the seller-side governance adapter.
+ */
+export interface GovernanceAdapterConfig {
+    /** The governance agent to call for committed checks */
+    agent: AgentConfig;
+    /** The seller's caller URL for governance checks */
+    callerUrl: string;
+}
+/**
+ * Committed governance check request from the seller's perspective.
+ */
+export interface CommittedCheckRequest {
+    /** Campaign governance plan ID */
+    planId: string;
+    /** Buyer's campaign reference */
+    buyerCampaignRef: string;
+    /** The seller's media buy ID */
+    mediaBuyId: string;
+    /** What the seller will actually deliver */
+    plannedDelivery: PlannedDelivery;
+    /** Lifecycle phase of the check */
+    phase?: GovernancePhase;
+    /** Delivery metrics for delivery-phase checks */
+    deliveryMetrics?: CheckGovernanceRequest['delivery_metrics'];
+    /** Summary of changes for modification-phase checks */
+    modificationSummary?: string;
+}
+/**
+ * Interface for seller-side governance adapters.
+ * Sellers implement this to integrate governance checks into their execution path.
+ */
+export interface IGovernanceAdapter {
+    /** Whether governance is supported by this server */
+    isSupported(): boolean;
+    /** Run a committed governance check before executing a media buy */
+    checkCommitted(request: CommittedCheckRequest): Promise<CheckGovernanceResponse>;
+}
+/**
+ * Error codes for governance adapter responses.
+ */
+export declare const GovernanceAdapterErrorCodes: {
+    readonly NOT_SUPPORTED: "governance_not_supported";
+    readonly CHECK_FAILED: "governance_check_failed";
+    readonly AGENT_UNREACHABLE: "governance_agent_unreachable";
+};
+export type GovernanceAdapterErrorCode = (typeof GovernanceAdapterErrorCodes)[keyof typeof GovernanceAdapterErrorCodes];
+/**
+ * Type guard: check if a response is a governance adapter error.
+ */
+export declare function isGovernanceAdapterError(response: unknown): response is {
+    error: {
+        code: GovernanceAdapterErrorCode;
+        message?: string;
+    };
+};
+/**
+ * Governance adapter that calls a governance agent via AdCP protocol.
+ *
+ * Sellers configure this with their governance agent and caller URL,
+ * then call checkCommitted() before executing media buys.
+ *
+ * For custom governance logic, extend this class and override checkCommitted().
+ */
+export declare class GovernanceAdapter implements IGovernanceAdapter {
+    private agentConfig?;
+    constructor(config?: GovernanceAdapterConfig);
+    isSupported(): boolean;
+    checkCommitted(request: CommittedCheckRequest): Promise<CheckGovernanceResponse>;
+}
+/**
+ * Pre-configured governance adapter with no agent.
+ * isSupported() returns false and checkCommitted() returns a denial.
+ * Replace with a configured instance when connecting to a governance agent.
+ */
+export declare const defaultGovernanceAdapter: GovernanceAdapter;
+//# sourceMappingURL=governance-adapter.d.ts.map

package/dist/lib/adapters/governance-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance-adapter.d.ts","sourceRoot":"","sources":["../../../src/lib/adapters/governance-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EACvB,eAAe,EACf,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,wDAAwD;IACxD,KAAK,EAAE,WAAW,CAAC;IACnB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,eAAe,EAAE,eAAe,CAAC;IACjC,mCAAmC;IACnC,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,iDAAiD;IACjD,eAAe,CAAC,EAAE,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;IAC7D,uDAAuD;IACvD,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,WAAW,IAAI,OAAO,CAAC;IACvB,oEAAoE;IACpE,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAClF;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;CAI9B,CAAC;AAEX,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAC;AAExH;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,OAAO,GAChB,QAAQ,IAAI;IAAE,KAAK,EAAE;QAAE,IAAI,EAAE,0BAA0B,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAI/E;AAED;;;;;;;GAOG;AACH,qBAAa,iBAAkB,YAAW,kBAAkB;IAC1D,OAAO,CAAC,WAAW,CAAC,CAA0B;gBAElC,MAAM,CAAC,EAAE,uBAAuB;IAI5C,WAAW,IAAI,OAAO;IAIhB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,uBAAuB,CAAC;CA6CvF;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,mBAA0B,CAAC"}

package/dist/lib/adapters/governance-adapter.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * Governance Adapter
+ *
+ * Server-side adapter for implementing committed governance checks.
+ * Sellers use this to check governance before executing media buys.
+ *
+ * The committed check verifies that the seller's planned delivery
+ * parameters comply with the buyer's campaign governance plan.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultGovernanceAdapter = exports.GovernanceAdapter = exports.GovernanceAdapterErrorCodes = void 0;
+exports.isGovernanceAdapterError = isGovernanceAdapterError;
+const protocols_1 = require("../protocols");
+const response_unwrapper_1 = require("../utils/response-unwrapper");
+/**
+ * Error codes for governance adapter responses.
+ */
+exports.GovernanceAdapterErrorCodes = {
+    NOT_SUPPORTED: 'governance_not_supported',
+    CHECK_FAILED: 'governance_check_failed',
+    AGENT_UNREACHABLE: 'governance_agent_unreachable',
+};
+/**
+ * Type guard: check if a response is a governance adapter error.
+ */
+function isGovernanceAdapterError(response) {
+    if (!response || typeof response !== 'object')
+        return false;
+    const r = response;
+    return r.error?.code && Object.values(exports.GovernanceAdapterErrorCodes).includes(r.error.code);
+}
+/**
+ * Governance adapter that calls a governance agent via AdCP protocol.
+ *
+ * Sellers configure this with their governance agent and caller URL,
+ * then call checkCommitted() before executing media buys.
+ *
+ * For custom governance logic, extend this class and override checkCommitted().
+ */
+class GovernanceAdapter {
+    agentConfig;
+    constructor(config) {
+        this.agentConfig = config;
+    }
+    isSupported() {
+        return !!this.agentConfig;
+    }
+    async checkCommitted(request) {
+        if (!this.agentConfig) {
+            return {
+                check_id: '',
+                status: 'denied',
+                binding: 'committed',
+                plan_id: request.planId,
+                buyer_campaign_ref: request.buyerCampaignRef,
+                explanation: 'Governance not configured on this server',
+                error_code: exports.GovernanceAdapterErrorCodes.NOT_SUPPORTED,
+            };
+        }
+        const checkRequest = {
+            plan_id: request.planId,
+            buyer_campaign_ref: request.buyerCampaignRef,
+            binding: 'committed',
+            caller: this.agentConfig.callerUrl,
+            media_buy_id: request.mediaBuyId,
+            planned_delivery: request.plannedDelivery,
+            phase: request.phase,
+            delivery_metrics: request.deliveryMetrics,
+            modification_summary: request.modificationSummary,
+        };
+        try {
+            const response = await protocols_1.ProtocolClient.callTool(this.agentConfig.agent, 'check_governance', checkRequest);
+            return (0, response_unwrapper_1.unwrapProtocolResponse)(response);
+        }
+        catch (err) {
+            return {
+                check_id: '',
+                status: 'denied',
+                binding: 'committed',
+                plan_id: request.planId,
+                buyer_campaign_ref: request.buyerCampaignRef,
+                explanation: `Governance agent unreachable: ${err.message}`,
+                error_code: exports.GovernanceAdapterErrorCodes.AGENT_UNREACHABLE,
+            };
+        }
+    }
+}
+exports.GovernanceAdapter = GovernanceAdapter;
+/**
+ * Pre-configured governance adapter with no agent.
+ * isSupported() returns false and checkCommitted() returns a denial.
+ * Replace with a configured instance when connecting to a governance agent.
+ */
+exports.defaultGovernanceAdapter = new GovernanceAdapter();
+//# sourceMappingURL=governance-adapter.js.map

package/dist/lib/adapters/governance-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance-adapter.js","sourceRoot":"","sources":["../../../src/lib/adapters/governance-adapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAmEH,4DAMC;AAjED,4CAA8C;AAE9C,oEAAqE;AA2CrE;;GAEG;AACU,QAAA,2BAA2B,GAAG;IACzC,aAAa,EAAE,0BAA0B;IACzC,YAAY,EAAE,yBAAyB;IACvC,iBAAiB,EAAE,8BAA8B;CACzC,CAAC;AAIX;;GAEG;AACH,SAAgB,wBAAwB,CACtC,QAAiB;IAEjB,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5D,MAAM,CAAC,GAAG,QAA+B,CAAC;IAC1C,OAAO,CAAC,CAAC,KAAK,EAAE,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,mCAA2B,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC5F,CAAC;AAED;;;;;;;GAOG;AACH,MAAa,iBAAiB;IACpB,WAAW,CAA2B;IAE9C,YAAY,MAAgC;QAC1C,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;IAC5B,CAAC;IAED,WAAW;QACT,OAAO,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAA8B;QACjD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO;gBACL,QAAQ,EAAE,EAAE;gBACZ,MAAM,EAAE,QAAQ;gBAChB,OAAO,EAAE,WAAW;gBACpB,OAAO,EAAE,OAAO,CAAC,MAAM;gBACvB,kBAAkB,EAAE,OAAO,CAAC,gBAAgB;gBAC5C,WAAW,EAAE,0CAA0C;gBACvD,UAAU,EAAE,mCAA2B,CAAC,aAAa;aAC3B,CAAC;QAC/B,CAAC;QAED,MAAM,YAAY,GAA2B;YAC3C,OAAO,EAAE,OAAO,CAAC,MAAM;YACvB,kBAAkB,EAAE,OAAO,CAAC,gBAAgB;YAC5C,OAAO,EAAE,WAAW;YACpB,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,SAAS;YAClC,YAAY,EAAE,OAAO,CAAC,UAAU;YAChC,gBAAgB,EAAE,OAAO,CAAC,eAAe;YACzC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,gBAAgB,EAAE,OAAO,CAAC,eAAe;YACzC,oBAAoB,EAAE,OAAO,CAAC,mBAAmB;SAClD,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,0BAAc,CAAC,QAAQ,CAC5C,IAAI,CAAC,WAAW,CAAC,KAAK,EACtB,kBAAkB,EAClB,YAAmC,CACpC,CAAC;YAEF,OAAO,IAAA,2CAAsB,EAAC,QAAQ,CAAuC,CAAC;QAChF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,QAAQ,EAAE,EAAE;gBACZ,MAAM,EAAE,QAAQ;gBAChB,OAAO,EAAE,WAAW;gBACpB,OAAO,EAAE,OAAO,CAAC,MAAM;gBACvB,kBAAkB,EAAE,OAAO,CAAC,gBAAgB;gBAC5C,WAAW,EAAE,iCAAkC,GAAa,CAAC,OAAO,EAAE;gBACtE,UAAU,EAAE,mCAA2B,CAAC,iBAAiB;aAC/B,CAAC;QAC/B,CAAC;IACH,CAAC;CACF;AAxDD,8CAwDC;AAED;;;;GAIG;AACU,QAAA,wBAAwB,GAAG,IAAI,iBAAiB,EAAE,CAAC"}

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

@@ -14,5 +14,6 @@
 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 { GovernanceAdapter, defaultGovernanceAdapter, type IGovernanceAdapter, type GovernanceAdapterConfig, type GovernanceAdapterErrorCode, type CommittedCheckRequest, GovernanceAdapterErrorCodes, isGovernanceAdapterError, } from './governance-adapter';
 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

@@ -1 +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"}
+{"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,iBAAiB,EACjB,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAG9B,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

@@ -13,7 +13,7 @@
  * - 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;
+exports.defaultSISessionManager = exports.SIErrorCodes = exports.AISISessionManager = exports.SISessionManager = exports.isGovernanceAdapterError = exports.GovernanceAdapterErrorCodes = exports.defaultGovernanceAdapter = exports.GovernanceAdapter = 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; } });
@@ -32,6 +32,12 @@ Object.defineProperty(exports, "ProposalManager", { enumerable: true, get: funct
 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; } });
+// Governance (seller-side committed checks)
+var governance_adapter_1 = require("./governance-adapter");
+Object.defineProperty(exports, "GovernanceAdapter", { enumerable: true, get: function () { return governance_adapter_1.GovernanceAdapter; } });
+Object.defineProperty(exports, "defaultGovernanceAdapter", { enumerable: true, get: function () { return governance_adapter_1.defaultGovernanceAdapter; } });
+Object.defineProperty(exports, "GovernanceAdapterErrorCodes", { enumerable: true, get: function () { return governance_adapter_1.GovernanceAdapterErrorCodes; } });
+Object.defineProperty(exports, "isGovernanceAdapterError", { enumerable: true, get: function () { return governance_adapter_1.isGovernanceAdapterError; } });
 // 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; } });

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

@@ -1 +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"}
+{"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,4CAA4C;AAC5C,2DAS8B;AAR5B,uHAAA,iBAAiB,OAAA;AACjB,8HAAA,wBAAwB,OAAA;AAKxB,iIAAA,2BAA2B,OAAA;AAC3B,8HAAA,wBAAwB,OAAA;AAG1B,kCAAkC;AAClC,2DAO8B;AAN5B,sHAAA,gBAAgB,OAAA;AAChB,wHAAA,kBAAkB,OAAA;AAGlB,kHAAA,YAAY,OAAA;AACZ,6HAAA,uBAAuB,OAAA"}