@adcp/client 4.8.0 → 4.9.0

package/dist/lib/core/GovernanceMiddleware.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Buyer-side governance middleware.
+ *
+ * Intercepts tool calls in the execution path and checks them against
+ * a campaign governance agent before allowing execution. Handles:
+ * - approved: proceed with execution
+ * - denied: return denial to caller
+ * - conditions: auto-apply machine-actionable conditions and re-check
+ * - escalated: return escalation continuation to caller
+ *
+ * After execution, reports the outcome back to the governance agent.
+ */
+import type { GovernanceContext, OutcomeType } from '../types/tools.generated';
+import type { Activity } from './AsyncHandler';
+import type { GovernanceConfig, CampaignGovernanceConfig, GovernanceCheckResult, GovernanceOutcome, GovernanceCondition } from './GovernanceTypes';
+/**
+ * Typed debug log entries for governance operations.
+ */
+export type GovernanceDebugEntry = {
+    type: 'governance_check';
+    iteration: number;
+    tool: string;
+    plan_id: string;
+} | {
+    type: 'governance_conditions_applied';
+    iteration: number;
+    conditions: GovernanceCondition[];
+} | {
+    type: 'governance_outcome_error';
+    check_id: string;
+    error: string;
+};
+/**
+ * Set a value at a dot-path in an object. Creates intermediate objects as needed.
+ * e.g., setAtPath(obj, 'packages.0.budget', 25000)
+ *
+ * Path segments are validated against a safe allowlist pattern and a forbidden
+ * set to prevent prototype pollution from external governance agent responses.
+ */
+export declare function setAtPath(obj: Record<string, any>, path: string, value: unknown): void;
+/**
+ * Extract structured governance context from tool call parameters.
+ *
+ * Extracts budget, countries, channels, flight dates, and seller URL from
+ * common AdCP tool parameter conventions. Override via
+ * CampaignGovernanceConfig.extractContext for custom tool schemas.
+ */
+export declare function extractGovernanceContext(params: Record<string, unknown>, config: CampaignGovernanceConfig): GovernanceContext | undefined;
+export declare class GovernanceMiddleware {
+    private governanceConfig;
+    private onActivity?;
+    constructor(governanceConfig: GovernanceConfig, onActivity?: ((activity: Activity) => void | Promise<void>) | undefined);
+    /**
+     * Check whether this tool requires a governance check.
+     */
+    requiresCheck(tool: string): boolean;
+    /**
+     * Get the campaign governance config. Returns undefined if not configured.
+     */
+    get campaign(): CampaignGovernanceConfig | undefined;
+    /**
+     * Run a proposed governance check before sending a tool call to a seller.
+     *
+     * Returns the governance result. The caller decides how to handle each status:
+     * - approved: proceed with execution (params may be modified by conditions)
+     * - denied: do not execute
+     * - escalated: do not execute, return continuation to caller
+     *
+     * When conditions are returned with required_value, this method auto-applies
+     * them and re-checks, up to maxConditionsIterations.
+     */
+    checkProposed(tool: string, params: Record<string, unknown>, debugLogs?: GovernanceDebugEntry[]): Promise<{
+        result: GovernanceCheckResult;
+        params: Record<string, unknown>;
+    }>;
+    /**
+     * Report the outcome of a tool execution to the governance agent.
+     * Called after the seller responds (success or failure).
+     */
+    reportOutcome(checkId: string, outcome: OutcomeType, sellerResponse?: Record<string, unknown>, error?: {
+        code?: string;
+        message: string;
+    }, debugLogs?: GovernanceDebugEntry[]): Promise<GovernanceOutcome | undefined>;
+    private emitGovernanceActivity;
+}
+//# sourceMappingURL=GovernanceMiddleware.d.ts.map

package/dist/lib/core/GovernanceMiddleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GovernanceMiddleware.d.ts","sourceRoot":"","sources":["../../../src/lib/core/GovernanceMiddleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAGV,iBAAiB,EAGjB,WAAW,EACZ,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACxB,qBAAqB,EACrB,iBAAiB,EAEjB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAI3B;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC9E;IAAE,IAAI,EAAE,+BAA+B,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,mBAAmB,EAAE,CAAA;CAAE,GAC/F;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAQ1E;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAuBtF;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,wBAAwB,GAC/B,iBAAiB,GAAG,SAAS,CAyC/B;AAED,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,UAAU,CAAC;gBADX,gBAAgB,EAAE,gBAAgB,EAClC,UAAU,CAAC,GAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,aAAA;IAGnE;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpC;;OAEG;IACH,IAAI,QAAQ,IAAI,wBAAwB,GAAG,SAAS,CAEnD;IAED;;;;;;;;;;OAUG;IACG,aAAa,CACjB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,GAAE,oBAAoB,EAAO,GACrC,OAAO,CAAC;QAAE,MAAM,EAAE,qBAAqB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IA4G9E;;;OAGG;IACG,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,WAAW,EACpB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAC1C,SAAS,GAAE,oBAAoB,EAAO,GACrC,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;YAyE3B,sBAAsB;CAerC"}

package/dist/lib/core/GovernanceMiddleware.js

@@ -0,0 +1,289 @@
+"use strict";
+/**
+ * Buyer-side governance middleware.
+ *
+ * Intercepts tool calls in the execution path and checks them against
+ * a campaign governance agent before allowing execution. Handles:
+ * - approved: proceed with execution
+ * - denied: return denial to caller
+ * - conditions: auto-apply machine-actionable conditions and re-check
+ * - escalated: return escalation continuation to caller
+ *
+ * After execution, reports the outcome back to the governance agent.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GovernanceMiddleware = void 0;
+exports.setAtPath = setAtPath;
+exports.extractGovernanceContext = extractGovernanceContext;
+const protocols_1 = require("../protocols");
+const GovernanceTypes_1 = require("./GovernanceTypes");
+const response_unwrapper_1 = require("../utils/response-unwrapper");
+/** Safe pattern for path segments: identifiers or numeric indices */
+const SAFE_PATH_SEGMENT = /^[a-zA-Z_$][a-zA-Z0-9_$]*$|^\d+$/;
+/** Path segments that would cause prototype pollution even though they match the safe pattern. */
+const FORBIDDEN_PATH_SEGMENTS = new Set(['__proto__', 'constructor', 'prototype']);
+/**
+ * Set a value at a dot-path in an object. Creates intermediate objects as needed.
+ * e.g., setAtPath(obj, 'packages.0.budget', 25000)
+ *
+ * Path segments are validated against a safe allowlist pattern and a forbidden
+ * set to prevent prototype pollution from external governance agent responses.
+ */
+function setAtPath(obj, path, value) {
+    if (!path || path.trim() === '') {
+        throw new Error('Empty path is not allowed');
+    }
+    const parts = path.split('.');
+    for (const part of parts) {
+        if (FORBIDDEN_PATH_SEGMENTS.has(part)) {
+            throw new Error(`Invalid path segment: ${part}`);
+        }
+        if (!SAFE_PATH_SEGMENT.test(part)) {
+            throw new Error(`Invalid path segment: ${part}`);
+        }
+    }
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const key = parts[i];
+        if (current[key] == null || typeof current[key] !== 'object') {
+            // Create array if next key is numeric, else object
+            current[key] = /^\d+$/.test(parts[i + 1]) ? [] : {};
+        }
+        current = current[key];
+    }
+    current[parts[parts.length - 1]] = value;
+}
+/**
+ * Extract structured governance context from tool call parameters.
+ *
+ * Extracts budget, countries, channels, flight dates, and seller URL from
+ * common AdCP tool parameter conventions. Override via
+ * CampaignGovernanceConfig.extractContext for custom tool schemas.
+ */
+function extractGovernanceContext(params, config) {
+    const ctx = {};
+    let hasField = false;
+    // Extract budget from common locations
+    const budget = params.budget;
+    if (budget?.total != null && budget?.currency) {
+        ctx.total_budget = { amount: budget.total, currency: budget.currency };
+        hasField = true;
+    }
+    // Extract countries
+    if (Array.isArray(params.countries) && params.countries.length > 0) {
+        ctx.countries = params.countries;
+        hasField = true;
+    }
+    // Extract channels
+    const channel = params.channel;
+    if (channel) {
+        ctx.channels = [channel];
+        hasField = true;
+    }
+    else if (Array.isArray(params.channels) && params.channels.length > 0) {
+        ctx.channels = params.channels;
+        hasField = true;
+    }
+    // Extract flight dates
+    const flight = params.flight;
+    if (flight?.start && flight?.end) {
+        ctx.flight = { start: flight.start, end: flight.end };
+        hasField = true;
+    }
+    // Include seller URL if the agent config has it
+    if (config.callerUrl) {
+        ctx.seller_url = config.callerUrl;
+        hasField = true;
+    }
+    return hasField ? ctx : undefined;
+}
+class GovernanceMiddleware {
+    governanceConfig;
+    onActivity;
+    constructor(governanceConfig, onActivity) {
+        this.governanceConfig = governanceConfig;
+        this.onActivity = onActivity;
+    }
+    /**
+     * Check whether this tool requires a governance check.
+     */
+    requiresCheck(tool) {
+        return (0, GovernanceTypes_1.toolRequiresGovernance)(tool, this.governanceConfig);
+    }
+    /**
+     * Get the campaign governance config. Returns undefined if not configured.
+     */
+    get campaign() {
+        return this.governanceConfig.campaign;
+    }
+    /**
+     * Run a proposed governance check before sending a tool call to a seller.
+     *
+     * Returns the governance result. The caller decides how to handle each status:
+     * - approved: proceed with execution (params may be modified by conditions)
+     * - denied: do not execute
+     * - escalated: do not execute, return continuation to caller
+     *
+     * When conditions are returned with required_value, this method auto-applies
+     * them and re-checks, up to maxConditionsIterations.
+     */
+    async checkProposed(tool, params, debugLogs = []) {
+        const config = this.governanceConfig.campaign;
+        if (!config) {
+            throw new Error('Campaign governance not configured');
+        }
+        const maxReChecks = config.maxConditionsIterations ?? 0;
+        let currentParams = structuredClone(params);
+        let iteration = 0;
+        // Always make the initial governance check. maxConditionsIterations only
+        // controls how many times we re-apply conditions and re-check.
+        do {
+            const request = {
+                plan_id: config.planId,
+                buyer_campaign_ref: config.buyerCampaignRef ?? '',
+                binding: 'proposed',
+                caller: config.callerUrl ?? '',
+                tool,
+                payload: currentParams,
+                governance_context: config.extractContext
+                    ? config.extractContext(currentParams)
+                    : extractGovernanceContext(currentParams, config),
+            };
+            debugLogs.push({
+                type: 'governance_check',
+                iteration,
+                tool,
+                plan_id: config.planId,
+            });
+            const response = await protocols_1.ProtocolClient.callTool(config.agent, 'check_governance', request, debugLogs);
+            // Unwrap protocol response (MCP text content, structuredContent, A2A artifacts)
+            const responseData = (0, response_unwrapper_1.unwrapProtocolResponse)(response);
+            await this.emitGovernanceActivity('governance_check', {
+                tool,
+                binding: 'proposed',
+                iteration,
+                response: responseData,
+            });
+            const checkResult = (0, GovernanceTypes_1.parseCheckResponse)(responseData);
+            if (checkResult.status === 'approved') {
+                return { result: checkResult, params: currentParams };
+            }
+            if (checkResult.status === 'denied' || checkResult.status === 'escalated') {
+                return { result: checkResult, params: currentParams };
+            }
+            // status === 'conditions'
+            if (!checkResult.conditions || checkResult.conditions.length === 0) {
+                // Conditions status with no conditions — treat as advisory denial
+                return { result: checkResult, params: currentParams };
+            }
+            // Try to auto-apply machine-actionable conditions
+            const allApplicable = checkResult.conditions.every(c => c.requiredValue !== undefined);
+            if (!allApplicable) {
+                // Some conditions are advisory-only (no required_value) — can't auto-apply
+                return { result: checkResult, params: currentParams };
+            }
+            // If we've exhausted re-check iterations, return conditions to caller
+            if (iteration >= maxReChecks) {
+                return { result: checkResult, params: currentParams };
+            }
+            // Apply conditions and re-check
+            for (const condition of checkResult.conditions) {
+                setAtPath(currentParams, condition.field, condition.requiredValue);
+            }
+            checkResult.conditionsApplied = true;
+            checkResult.modifiedParams = currentParams;
+            debugLogs.push({
+                type: 'governance_conditions_applied',
+                iteration,
+                conditions: checkResult.conditions,
+            });
+            iteration++;
+        } while (iteration <= maxReChecks);
+        // Defensive: the early return at `iteration >= maxReChecks` inside the loop
+        // should always fire before this point. If we somehow reach here, treat it
+        // as an unresolvable condition so we fail closed.
+        return {
+            result: {
+                checkId: '',
+                status: 'denied',
+                binding: 'proposed',
+                explanation: `Governance conditions could not be resolved after ${maxReChecks} iterations`,
+            },
+            params: currentParams,
+        };
+    }
+    /**
+     * Report the outcome of a tool execution to the governance agent.
+     * Called after the seller responds (success or failure).
+     */
+    async reportOutcome(checkId, outcome, sellerResponse, error, debugLogs = []) {
+        const config = this.governanceConfig.campaign;
+        if (!config)
+            return undefined;
+        const request = {
+            plan_id: config.planId,
+            check_id: checkId,
+            buyer_campaign_ref: config.buyerCampaignRef ?? '',
+            outcome,
+        };
+        if (outcome === 'completed' && sellerResponse) {
+            request.seller_response = sellerResponse;
+        }
+        if (outcome === 'failed' && error) {
+            request.error = error;
+        }
+        try {
+            const response = await protocols_1.ProtocolClient.callTool(config.agent, 'report_plan_outcome', request, debugLogs);
+            const responseData = (0, response_unwrapper_1.unwrapProtocolResponse)(response);
+            await this.emitGovernanceActivity('governance_outcome', {
+                check_id: checkId,
+                outcome,
+            });
+            return {
+                outcomeId: responseData.outcome_id,
+                status: responseData.status,
+                committedBudget: responseData.committed_budget,
+                findings: responseData.findings?.map(f => ({
+                    categoryId: f.category_id,
+                    severity: f.severity,
+                    explanation: f.explanation,
+                    details: f.details,
+                })),
+                planSummary: responseData.plan_summary?.total_committed != null && responseData.plan_summary?.budget_remaining != null
+                    ? {
+                        totalCommitted: responseData.plan_summary.total_committed,
+                        budgetRemaining: responseData.plan_summary.budget_remaining,
+                    }
+                    : undefined,
+            };
+        }
+        catch (err) {
+            // Outcome reporting failure shouldn't fail the task
+            debugLogs.push({
+                type: 'governance_outcome_error',
+                check_id: checkId,
+                error: err.message,
+            });
+            await this.emitGovernanceActivity('governance_outcome', {
+                check_id: checkId,
+                outcome,
+                error: err.message,
+                warning: 'Outcome reporting failed — governance agent may have stale state',
+            }, 'failed');
+            return undefined;
+        }
+    }
+    async emitGovernanceActivity(type, payload, status = 'completed') {
+        await this.onActivity?.({
+            type,
+            operation_id: '',
+            agent_id: this.governanceConfig.campaign?.agent.id ?? '',
+            task_type: 'governance',
+            status,
+            payload,
+            timestamp: new Date().toISOString(),
+        });
+    }
+}
+exports.GovernanceMiddleware = GovernanceMiddleware;
+//# sourceMappingURL=GovernanceMiddleware.js.map

package/dist/lib/core/GovernanceMiddleware.js.map

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

package/dist/lib/core/GovernanceTypes.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Governance middleware types for buyer-side campaign governance.
+ *
+ * The governance middleware intercepts tool calls and checks them against
+ * a campaign governance agent before execution. It handles the full lifecycle:
+ * check → execute → report outcome.
+ */
+import type { AgentConfig } from '../types';
+import type { CheckGovernanceResponse, EscalationSeverity, GovernanceMode } from '../types/tools.generated';
+/**
+ * Campaign governance agent configuration.
+ * The campaign governance agent handles check_governance, sync_plans,
+ * report_plan_outcome, and get_plan_audit_logs.
+ */
+export interface CampaignGovernanceConfig {
+    /** The governance agent to call */
+    agent: AgentConfig;
+    /** Plan ID for this advertiser's campaign */
+    planId: string;
+    /** Buyer's campaign reference (groups checks within a plan) */
+    buyerCampaignRef?: string;
+    /** Caller URL for the check_governance request */
+    callerUrl?: string;
+    /** Max re-check iterations after auto-applying conditions. Default: 0 (return conditions to caller without re-checking). The initial governance check always fires. */
+    maxConditionsIterations?: number;
+    /** Custom context extractor. Overrides the default extraction of budget, countries, channels, flight from tool params. Return undefined to send no context. */
+    extractContext?: (params: Record<string, unknown>) => import('../types/tools.generated').GovernanceContext | undefined;
+}
+/**
+ * Governance configuration.
+ *
+ * Campaign governance handles: check_governance, sync_plans,
+ * report_plan_outcome, get_plan_audit_logs.
+ */
+export interface GovernanceConfig {
+    /** Campaign governance agent */
+    campaign?: CampaignGovernanceConfig;
+    /**
+     * Which tools require governance checks.
+     * - 'all': every tool including get_adcp_capabilities (governance tools themselves still excluded)
+     * - string[]: only listed tools
+     * - function: custom predicate
+     * - undefined (default): all tools except get_adcp_capabilities and governance tools
+     */
+    scope?: 'all' | string[] | ((tool: string) => boolean);
+}
+/**
+ * Determine whether a tool requires a governance check given the config.
+ */
+export declare function toolRequiresGovernance(tool: string, config: GovernanceConfig): boolean;
+/**
+ * A single finding from a governance check.
+ */
+export interface GovernanceFinding {
+    categoryId: string;
+    policyId?: string;
+    severity: EscalationSeverity;
+    explanation: string;
+    confidence?: number;
+    uncertaintyReason?: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * A condition that must be met before the action can proceed.
+ */
+export interface GovernanceCondition {
+    /** Dot-path to the field that needs adjustment */
+    field: string;
+    /** The value the field must have for approval. When present, condition is machine-actionable. */
+    requiredValue?: unknown;
+    /** Why this condition is required */
+    reason: string;
+}
+/**
+ * Escalation details when a governance check requires human review.
+ */
+export interface GovernanceEscalation {
+    reason: string;
+    severity: EscalationSeverity;
+    requiresHuman: boolean;
+    approvalTier?: string;
+}
+/**
+ * Governance check result attached to TaskResult.
+ */
+export interface GovernanceCheckResult {
+    checkId: string;
+    status: 'approved' | 'denied' | 'conditions' | 'escalated';
+    binding: 'proposed' | 'committed';
+    explanation: string;
+    mode?: GovernanceMode;
+    findings?: GovernanceFinding[];
+    conditions?: GovernanceCondition[];
+    escalation?: GovernanceEscalation;
+    expiresAt?: string;
+    /** Whether conditions were auto-applied by the middleware */
+    conditionsApplied?: boolean;
+    /** The modified params after conditions were applied */
+    modifiedParams?: Record<string, unknown>;
+}
+/**
+ * Outcome metadata from report_plan_outcome, attached to TaskResult after completion.
+ */
+export interface GovernanceOutcome {
+    outcomeId: string;
+    status: 'accepted' | 'findings';
+    committedBudget?: number;
+    findings?: GovernanceFinding[];
+    planSummary?: {
+        totalCommitted: number;
+        budgetRemaining: number;
+    };
+}
+/**
+ * Parse a CheckGovernanceResponse into GovernanceCheckResult.
+ */
+export declare function parseCheckResponse(response: CheckGovernanceResponse): GovernanceCheckResult;
+//# sourceMappingURL=GovernanceTypes.d.ts.map

package/dist/lib/core/GovernanceTypes.d.ts.map

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

package/dist/lib/core/GovernanceTypes.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * Governance middleware types for buyer-side campaign governance.
+ *
+ * The governance middleware intercepts tool calls and checks them against
+ * a campaign governance agent before execution. It handles the full lifecycle:
+ * check → execute → report outcome.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolRequiresGovernance = toolRequiresGovernance;
+exports.parseCheckResponse = parseCheckResponse;
+/** Governance tools that are always excluded (infinite recursion otherwise) */
+const GOVERNANCE_SELF_TOOLS = new Set(['sync_plans', 'check_governance', 'report_plan_outcome', 'get_plan_audit_logs']);
+/** Tools excluded by default (governance tools + capabilities) */
+const DEFAULT_EXCLUDED_TOOLS = new Set([...GOVERNANCE_SELF_TOOLS, 'get_adcp_capabilities']);
+/**
+ * Determine whether a tool requires a governance check given the config.
+ */
+function toolRequiresGovernance(tool, config) {
+    if (!config.campaign)
+        return false;
+    // Governance tools are always excluded to prevent infinite recursion
+    if (GOVERNANCE_SELF_TOOLS.has(tool))
+        return false;
+    if (config.scope === 'all')
+        return true;
+    if (Array.isArray(config.scope))
+        return config.scope.includes(tool);
+    if (typeof config.scope === 'function')
+        return config.scope(tool);
+    // Default: all tools except excluded set
+    return !DEFAULT_EXCLUDED_TOOLS.has(tool);
+}
+/**
+ * Parse a CheckGovernanceResponse into GovernanceCheckResult.
+ */
+function parseCheckResponse(response) {
+    return {
+        checkId: response.check_id,
+        status: response.status,
+        binding: response.binding,
+        explanation: response.explanation,
+        mode: response.mode,
+        findings: response.findings?.map(f => ({
+            categoryId: f.category_id,
+            policyId: f.policy_id,
+            severity: f.severity,
+            explanation: f.explanation,
+            confidence: f.confidence,
+            uncertaintyReason: f.uncertainty_reason,
+            details: f.details,
+        })),
+        conditions: response.conditions?.map(c => ({
+            field: c.field,
+            requiredValue: c.required_value,
+            reason: c.reason,
+        })),
+        escalation: response.escalation
+            ? {
+                reason: response.escalation.reason,
+                severity: response.escalation.severity,
+                requiresHuman: response.escalation.requires_human,
+                approvalTier: response.escalation.approval_tier,
+            }
+            : undefined,
+        expiresAt: response.expires_at,
+    };
+}
+//# sourceMappingURL=GovernanceTypes.js.map

package/dist/lib/core/GovernanceTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GovernanceTypes.js","sourceRoot":"","sources":["../../../src/lib/core/GovernanceTypes.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAuDH,wDAcC;AAyED,gDA+BC;AA/HD,+EAA+E;AAC/E,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,qBAAqB,CAAC,CAAC,CAAC;AAExH,kEAAkE;AAClE,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,qBAAqB,EAAE,uBAAuB,CAAC,CAAC,CAAC;AAE5F;;GAEG;AACH,SAAgB,sBAAsB,CAAC,IAAY,EAAE,MAAwB;IAC3E,IAAI,CAAC,MAAM,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAEnC,qEAAqE;IACrE,IAAI,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAElD,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAExC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEpE,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,UAAU;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElE,yCAAyC;IACzC,OAAO,CAAC,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC;AAsED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,QAAiC;IAClE,OAAO;QACL,OAAO,EAAE,QAAQ,CAAC,QAAQ;QAC1B,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACrC,UAAU,EAAE,CAAC,CAAC,WAAW;YACzB,QAAQ,EAAE,CAAC,CAAC,SAAS;YACrB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,iBAAiB,EAAE,CAAC,CAAC,kBAAkB;YACvC,OAAO,EAAE,CAAC,CAAC,OAAO;SACnB,CAAC,CAAC;QACH,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACzC,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,aAAa,EAAE,CAAC,CAAC,cAAc;YAC/B,MAAM,EAAE,CAAC,CAAC,MAAM;SACjB,CAAC,CAAC;QACH,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC7B,CAAC,CAAC;gBACE,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,MAAM;gBAClC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ;gBACtC,aAAa,EAAE,QAAQ,CAAC,UAAU,CAAC,cAAc;gBACjD,YAAY,EAAE,QAAQ,CAAC,UAAU,CAAC,aAAa;aAChD;YACH,CAAC,CAAC,SAAS;QACb,SAAS,EAAE,QAAQ,CAAC,UAAU;KAC/B,CAAC;AACJ,CAAC"}

package/dist/lib/core/SingleAgentClient.d.ts

@@ -1,5 +1,5 @@
 import type { AgentConfig } from '../types';
-import type { GetProductsRequest, GetProductsResponse, ListCreativeFormatsRequest, ListCreativeFormatsResponse, CreateMediaBuyRequest, UpdateMediaBuyRequest, UpdateMediaBuyResponse, SyncCreativesRequest, SyncCreativesResponse, ListCreativesRequest, ListCreativesResponse, GetMediaBuysRequest, GetMediaBuysResponse, GetMediaBuyDeliveryRequest, GetMediaBuyDeliveryResponse, ProvidePerformanceFeedbackRequest, ProvidePerformanceFeedbackResponse, GetSignalsRequest, GetSignalsResponse, ActivateSignalRequest, ActivateSignalResponse, PreviewCreativeRequest, PreviewCreativeResponse, Format, GetAdCPCapabilitiesRequest, GetAdCPCapabilitiesResponse } from '../types/tools.generated';
+import type { GetProductsRequest, GetProductsResponse, ListCreativeFormatsRequest, ListCreativeFormatsResponse, CreateMediaBuyRequest, UpdateMediaBuyRequest, UpdateMediaBuyResponse, SyncCreativesRequest, SyncCreativesResponse, ListCreativesRequest, ListCreativesResponse, GetMediaBuysRequest, GetMediaBuysResponse, GetMediaBuyDeliveryRequest, GetMediaBuyDeliveryResponse, ProvidePerformanceFeedbackRequest, ProvidePerformanceFeedbackResponse, GetSignalsRequest, GetSignalsResponse, ActivateSignalRequest, ActivateSignalResponse, PreviewCreativeRequest, PreviewCreativeResponse, Format, GetAdCPCapabilitiesRequest, GetAdCPCapabilitiesResponse, SyncPlansRequest, SyncPlansResponse, GetPlanAuditLogsRequest, GetPlanAuditLogsResponse, OutcomeType } from '../types/tools.generated';
 import type { MCPWebhookPayload, CreateMediaBuyResponse } from '../types/core.generated';
 import type { Task as A2ATask, TaskStatusUpdateEvent } from '@a2a-js/sdk';
 import type { InputHandler, TaskOptions, TaskResult, ConversationConfig, TaskInfo } from './ConversationTypes';
@@ -91,6 +91,8 @@ export interface SingleAgentClientConfig extends ConversationConfig {
          */
         logSchemaViolations?: boolean;
     };
+    /** Governance configuration for buyer-side campaign governance */
+    governance?: import('./GovernanceTypes').GovernanceConfig;
 }
 /**
  * Internal single-agent client implementation
@@ -438,6 +440,38 @@ export declare class SingleAgentClient {
      * @param options - Task execution options
      */
     activateSignal(params: ActivateSignalRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ActivateSignalResponse>>;
+    /**
+     * Sync campaign plans to a governance agent.
+     * Plans define authorized parameters: budget, channels, flight dates, markets, policies, delegations.
+     *
+     * Uses the governance agent from config.governance.campaign.agent by default.
+     * Pass an explicit agent via options.agent to override.
+     */
+    syncPlans(params: SyncPlansRequest, inputHandler?: InputHandler, options?: TaskOptions & {
+        agent?: AgentConfig;
+    }): Promise<TaskResult<SyncPlansResponse>>;
+    /**
+     * Get governance audit logs for one or more plans.
+     * Returns budget state, channel allocation, per-campaign breakdown, and audit trail.
+     *
+     * Uses the governance agent from config.governance.campaign.agent by default.
+     * Pass an explicit agent via options.agent to override.
+     */
+    getPlanAuditLogs(params: GetPlanAuditLogsRequest, options?: TaskOptions & {
+        agent?: AgentConfig;
+    }): Promise<TaskResult<GetPlanAuditLogsResponse>>;
+    /**
+     * Report a governance outcome for an async task that has resolved.
+     *
+     * Use this when a task returned status 'submitted' or 'working' and
+     * later resolves via polling or webhooks. The checkId is available
+     * on the original TaskResult at result.governance.checkId.
+     */
+    reportGovernanceOutcome(checkId: string, outcome: OutcomeType, sellerResponse?: Record<string, unknown>, error?: {
+        code?: string;
+        message: string;
+    }): Promise<import('./GovernanceTypes').GovernanceOutcome | undefined>;
+    private getGovernanceAgent;
     /**
      * Get AdCP capabilities
      *