veto-sdk 2.0.0 → 2.2.0

package/dist/economic/budget-engine.js

@@ -0,0 +1,146 @@
+/**
+ * Local budget engine — in-memory, session scope only.
+ *
+ * Implements the BudgetEngine interface for standalone SDK mode.
+ * Only materializes 'session' scope; agent/user/global require
+ * CloudBudgetEngine (platform).
+ *
+ * @module economic/budget-engine
+ */
+export class LocalBudgetEngine {
+    state = new Map();
+    logger;
+    constructor(options) {
+        this.logger = options.logger;
+        for (const budget of options.budgets) {
+            if (budget.scope !== 'session') {
+                this.logger.warn('LocalBudgetEngine only supports session scope — ' +
+                    `ignoring ${budget.scope} budget. ` +
+                    'Use Veto Cloud for agent/user/global scopes.', { scope: budget.scope, window: budget.window });
+                continue;
+            }
+            this.state.set(budget.scope, {
+                spent: 0,
+                limit: budget.limit,
+                currency: budget.currency,
+                approval_threshold: budget.approval_threshold,
+            });
+        }
+    }
+    check(cost, currency, scope) {
+        const safeCost = this.sanitizeCost(cost);
+        const budget = this.state.get(scope);
+        if (!budget) {
+            // No budget configured for this scope — allow by default
+            return { allowed: true, decision: 'allow' };
+        }
+        // Currency mismatch check
+        if (currency.toUpperCase() !== budget.currency.toUpperCase()) {
+            return {
+                allowed: false,
+                decision: 'deny',
+                denial: this.buildDenial('currency_mismatch', safeCost, currency, budget, scope),
+            };
+        }
+        const remaining = budget.limit - budget.spent;
+        // Budget exceeded
+        if (safeCost > remaining) {
+            this.logger.warn('Budget would be exceeded', {
+                scope, cost: safeCost, spent: budget.spent, limit: budget.limit,
+            });
+            return {
+                allowed: false,
+                decision: 'deny',
+                denial: this.buildDenial('budget_exceeded', safeCost, currency, budget, scope),
+            };
+        }
+        // Approval threshold
+        if (budget.approval_threshold !== undefined && safeCost > budget.approval_threshold) {
+            this.logger.info('Cost exceeds approval threshold', {
+                scope, cost: safeCost, threshold: budget.approval_threshold,
+            });
+            return {
+                allowed: false,
+                decision: 'require_approval',
+                denial: this.buildDenial('approval_required', safeCost, currency, budget, scope),
+            };
+        }
+        return { allowed: true, decision: 'allow' };
+    }
+    reserve(cost, currency, scope) {
+        const result = this.check(cost, currency, scope);
+        if (!result.allowed)
+            return result;
+        const safeCost = this.sanitizeCost(cost);
+        const budget = this.state.get(scope);
+        if (budget && safeCost > 0) {
+            budget.spent += safeCost;
+            this.logger.debug('Budget reserved', {
+                scope, cost: safeCost, totalSpent: budget.spent,
+                remaining: budget.limit - budget.spent,
+            });
+        }
+        return result;
+    }
+    record(cost, _currency, scope) {
+        const safeCost = this.sanitizeCost(cost);
+        const budget = this.state.get(scope);
+        if (budget && safeCost > 0) {
+            budget.spent += safeCost;
+            this.logger.debug('Budget charge recorded', {
+                scope, cost: safeCost, totalSpent: budget.spent,
+                remaining: budget.limit - budget.spent,
+            });
+        }
+    }
+    refund(amount, scope) {
+        if (amount <= 0)
+            return;
+        const budget = this.state.get(scope);
+        if (budget) {
+            budget.spent = Math.max(0, budget.spent - amount);
+            this.logger.debug('Budget refunded', {
+                scope, amount, totalSpent: budget.spent,
+                remaining: budget.limit - budget.spent,
+            });
+        }
+    }
+    getStatus(scope) {
+        const budget = this.state.get(scope);
+        if (!budget)
+            return null;
+        return {
+            scope,
+            spent: budget.spent,
+            limit: budget.limit,
+            remaining: Math.max(0, budget.limit - budget.spent),
+            currency: budget.currency,
+        };
+    }
+    reset(scope) {
+        const budget = this.state.get(scope);
+        if (budget) {
+            const previous = budget.spent;
+            budget.spent = 0;
+            this.logger.debug('Budget reset', { scope, previousSpent: previous });
+        }
+    }
+    sanitizeCost(cost) {
+        if (!Number.isFinite(cost) || cost < 0)
+            return 0;
+        return cost;
+    }
+    buildDenial(reason, cost, currency, budget, scope) {
+        return {
+            reason,
+            cost,
+            currency,
+            budget_scope: scope,
+            budget_limit: budget.limit,
+            budget_spent: budget.spent,
+            budget_remaining: Math.max(0, budget.limit - budget.spent),
+            approval_threshold: budget.approval_threshold,
+        };
+    }
+}
+//# sourceMappingURL=budget-engine.js.map

package/dist/economic/budget-engine.js.map

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

package/dist/economic/connectors/ap2.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Google AP2 (Agent Payments Protocol) connector.
+ *
+ * Reads AP2 mandate constraints (spending caps, categories, expiry)
+ * and enforces Veto policies ON TOP of mandate constraints.
+ * Veto is always more restrictive, never less (D4).
+ *
+ * Timing mode: pre-call — mandate metadata available at setup.
+ * Note: v1 does NOT verify mandate signatures. AP2 card-based
+ * crypto path is still maturing; signature verification is Phase 2.
+ *
+ * @module economic/connectors/ap2
+ */
+import type { ProtocolConnector, EconomicDenialDetails } from '../types.js';
+/**
+ * AP2 mandate data shape (from mandate negotiation response).
+ */
+export interface AP2MandateData {
+    /** Mandate identifier */
+    mandate_id?: string;
+    /** Maximum spending amount for this mandate */
+    spending_cap?: number;
+    /** Amount already spent under this mandate */
+    spent?: number;
+    /** Mandate currency (ISO 4217) */
+    currency?: string;
+    /** Mandate expiry (ISO 8601) */
+    expires_at?: string;
+    /**
+     * Allowed spending categories.
+     *
+     * Categories are advisory metadata in v1. Use Veto rules to enforce
+     * tool-category constraints.
+     */
+    categories?: string[];
+    /** Mandate signer (payer identity) */
+    signer?: string;
+    /** Per-action cost */
+    cost?: number;
+    /** Additional mandate metadata */
+    [key: string]: unknown;
+}
+/**
+ * Create an AP2 protocol connector.
+ */
+export declare function createAP2Connector(): ProtocolConnector;
+/**
+ * Build a connector_error denial for AP2 parse failures.
+ */
+export declare function buildAP2ConnectorError(error: string): EconomicDenialDetails;
+//# sourceMappingURL=ap2.d.ts.map

package/dist/economic/connectors/ap2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ap2.d.ts","sourceRoot":"","sources":["../../../src/economic/connectors/ap2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAmB,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE7F;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAiCD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,iBAAiB,CAyEtD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAY3E"}

package/dist/economic/connectors/ap2.js

@@ -0,0 +1,133 @@
+/**
+ * Google AP2 (Agent Payments Protocol) connector.
+ *
+ * Reads AP2 mandate constraints (spending caps, categories, expiry)
+ * and enforces Veto policies ON TOP of mandate constraints.
+ * Veto is always more restrictive, never less (D4).
+ *
+ * Timing mode: pre-call — mandate metadata available at setup.
+ * Note: v1 does NOT verify mandate signatures. AP2 card-based
+ * crypto path is still maturing; signature verification is Phase 2.
+ *
+ * @module economic/connectors/ap2
+ */
+function extractMandateData(obj) {
+    const mandate = (obj.ap2_mandate ?? obj.mandate ?? obj);
+    const mandateId = mandate.mandate_id;
+    if (typeof mandateId !== 'string' || !mandateId)
+        return null;
+    return {
+        mandate_id: mandateId,
+        spending_cap: typeof mandate.spending_cap === 'number' ? mandate.spending_cap : undefined,
+        spent: typeof mandate.spent === 'number' ? mandate.spent : undefined,
+        currency: typeof mandate.currency === 'string' ? mandate.currency : undefined,
+        expires_at: typeof mandate.expires_at === 'string' ? mandate.expires_at : undefined,
+        categories: Array.isArray(mandate.categories) ? mandate.categories.filter(c => typeof c === 'string') : undefined,
+        signer: typeof mandate.signer === 'string' ? mandate.signer : undefined,
+        cost: typeof mandate.cost === 'number' ? mandate.cost : undefined,
+    };
+}
+function isMandateExpired(expiresAt) {
+    const expiry = new Date(expiresAt);
+    // Fail-closed: treat unparseable dates as expired (payment boundary)
+    if (Number.isNaN(expiry.getTime()))
+        return true;
+    return expiry.getTime() < Date.now();
+}
+function exceedsSpendingCap(cost, spendingCap, spent) {
+    if (spendingCap == null)
+        return false;
+    // If spent is unknown, assume 0 (fail-closed: enforce cap from scratch)
+    return cost > (spendingCap - (spent ?? 0));
+}
+/**
+ * Create an AP2 protocol connector.
+ */
+export function createAP2Connector() {
+    return {
+        protocol: 'ap2',
+        protocolVersion: '2026.03',
+        extract(response) {
+            // Handle fetch Response objects
+            if (response instanceof Response) {
+                const mandateId = response.headers.get('x-ap2-mandate-id');
+                const ap2Cost = response.headers.get('x-ap2-cost');
+                const ap2Currency = response.headers.get('x-ap2-currency');
+                const ap2Signer = response.headers.get('x-ap2-signer');
+                const ap2SpendingCap = response.headers.get('x-ap2-spending-cap');
+                const ap2Spent = response.headers.get('x-ap2-spent');
+                const ap2Expires = response.headers.get('x-ap2-expires');
+                if (!mandateId)
+                    return null;
+                // Check mandate expiry
+                if (ap2Expires && isMandateExpired(ap2Expires))
+                    return null;
+                const cost = ap2Cost ? Number(ap2Cost) : 0;
+                if (!Number.isFinite(cost) || cost < 0)
+                    return null;
+                // Enforce spending cap (D4: Veto is always more restrictive)
+                const spendingCap = ap2SpendingCap ? Number(ap2SpendingCap) : undefined;
+                const spent = ap2Spent ? Number(ap2Spent) : undefined;
+                if (exceedsSpendingCap(cost, spendingCap, spent))
+                    return null;
+                return {
+                    cost,
+                    currency: (ap2Currency ?? 'USD').toUpperCase(),
+                    payer: ap2Signer ?? undefined,
+                    protocol: 'ap2',
+                    protocol_metadata: {
+                        mandate_id: mandateId,
+                        spending_cap: spendingCap,
+                        mandate_spent: spent,
+                        expires_at: ap2Expires ?? undefined,
+                    },
+                };
+            }
+            // Handle plain objects (manual mode / pre-call)
+            const mandate = extractMandateData(response);
+            if (!mandate)
+                return null;
+            // Check mandate expiry
+            if (mandate.expires_at && isMandateExpired(mandate.expires_at))
+                return null;
+            // Enforce spending cap (D4: Veto is always more restrictive)
+            const cost = mandate.cost ?? 0;
+            if (exceedsSpendingCap(cost, mandate.spending_cap, mandate.spent))
+                return null;
+            return {
+                cost,
+                currency: (mandate.currency ?? 'USD').toUpperCase(),
+                payer: mandate.signer,
+                protocol: 'ap2',
+                protocol_metadata: {
+                    mandate_id: mandate.mandate_id,
+                    spending_cap: mandate.spending_cap,
+                    mandate_spent: mandate.spent,
+                    /**
+                     * Categories are advisory metadata in v1. Use Veto rules to
+                     * enforce tool-category constraints.
+                     */
+                    categories: mandate.categories,
+                    expires_at: mandate.expires_at,
+                },
+            };
+        },
+    };
+}
+/**
+ * Build a connector_error denial for AP2 parse failures.
+ */
+export function buildAP2ConnectorError(error) {
+    return {
+        reason: 'connector_error',
+        cost: 0,
+        currency: 'USD',
+        budget_scope: 'session',
+        budget_limit: 0,
+        budget_spent: 0,
+        budget_remaining: 0,
+        connector_name: 'ap2',
+        raw_error: error,
+    };
+}
+//# sourceMappingURL=ap2.js.map

package/dist/economic/connectors/ap2.js.map

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

package/dist/economic/connectors/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Protocol connector exports.
+ * @module economic/connectors
+ */
+export { createX402Connector, buildX402ConnectorError } from './x402.js';
+export { createMPPConnector, buildMPPConnectorError, type MPPSessionData } from './mpp.js';
+export { createAP2Connector, buildAP2ConnectorError, type AP2MandateData } from './ap2.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/economic/connectors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/economic/connectors/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAC3F,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC"}

package/dist/economic/connectors/index.js

@@ -0,0 +1,8 @@
+/**
+ * Protocol connector exports.
+ * @module economic/connectors
+ */
+export { createX402Connector, buildX402ConnectorError } from './x402.js';
+export { createMPPConnector, buildMPPConnectorError } from './mpp.js';
+export { createAP2Connector, buildAP2ConnectorError } from './ap2.js';
+//# sourceMappingURL=index.js.map

package/dist/economic/connectors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/economic/connectors/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAuB,MAAM,UAAU,CAAC;AAC3F,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAuB,MAAM,UAAU,CAAC"}

package/dist/economic/connectors/mpp.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Stripe MPP (Machine Payments Protocol) connector.
+ *
+ * Reads MPP session spending limits and per-action costs from
+ * session metadata. Tracks cumulative session spend against
+ * Veto budget policies.
+ *
+ * Timing mode: pre-call — session metadata available at setup.
+ * MPP spec version: March 2026 launch (spec may evolve).
+ *
+ * @module economic/connectors/mpp
+ */
+import type { ProtocolConnector, EconomicDenialDetails } from '../types.js';
+/**
+ * MPP session data shape (from Stripe's session negotiation response).
+ */
+export interface MPPSessionData {
+    /** Shared Payment Token identifier */
+    session_token?: string;
+    /** Per-action cost in the session currency */
+    cost?: number;
+    /** Session currency (ISO 4217) */
+    currency?: string;
+    /** Session spending limit */
+    spending_limit?: number;
+    /** Cumulative session spend so far */
+    spent?: number;
+    /** Payer identifier (Stripe customer ID or SPT holder) */
+    payer?: string;
+    /** Additional session metadata */
+    [key: string]: unknown;
+}
+/**
+ * Create an MPP protocol connector.
+ */
+export declare function createMPPConnector(): ProtocolConnector;
+/**
+ * Build a connector_error denial for MPP parse failures.
+ */
+export declare function buildMPPConnectorError(error: string): EconomicDenialDetails;
+//# sourceMappingURL=mpp.d.ts.map

package/dist/economic/connectors/mpp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mpp.d.ts","sourceRoot":"","sources":["../../../src/economic/connectors/mpp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAmB,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE7F;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAyBD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,iBAAiB,CA+CtD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAY3E"}

package/dist/economic/connectors/mpp.js

@@ -0,0 +1,97 @@
+/**
+ * Stripe MPP (Machine Payments Protocol) connector.
+ *
+ * Reads MPP session spending limits and per-action costs from
+ * session metadata. Tracks cumulative session spend against
+ * Veto budget policies.
+ *
+ * Timing mode: pre-call — session metadata available at setup.
+ * MPP spec version: March 2026 launch (spec may evolve).
+ *
+ * @module economic/connectors/mpp
+ */
+function extractMPPSessionData(obj) {
+    // Accept both top-level and nested mpp_session shapes
+    const session = (obj.mpp_session ?? obj);
+    const sessionToken = session.session_token;
+    if (typeof sessionToken !== 'string' || !sessionToken)
+        return null;
+    const cost = typeof session.cost === 'number' ? session.cost : undefined;
+    const currency = typeof session.currency === 'string' ? session.currency : undefined;
+    const spendingLimit = typeof session.spending_limit === 'number' ? session.spending_limit : undefined;
+    const spent = typeof session.spent === 'number' ? session.spent : undefined;
+    const payer = typeof session.payer === 'string' ? session.payer : undefined;
+    return {
+        session_token: sessionToken,
+        cost,
+        currency,
+        spending_limit: spendingLimit,
+        spent,
+        payer,
+    };
+}
+/**
+ * Create an MPP protocol connector.
+ */
+export function createMPPConnector() {
+    return {
+        protocol: 'mpp',
+        protocolVersion: '2026.03',
+        extract(response) {
+            // Handle fetch Response objects — MPP data comes in response headers/body
+            if (response instanceof Response) {
+                // Check for MPP headers
+                const mppSession = response.headers.get('x-mpp-session');
+                const mppCost = response.headers.get('x-mpp-cost');
+                const mppCurrency = response.headers.get('x-mpp-currency');
+                const mppPayer = response.headers.get('x-mpp-payer');
+                if (!mppSession)
+                    return null;
+                const cost = mppCost ? Number(mppCost) : undefined;
+                if (cost !== undefined && (!Number.isFinite(cost) || cost < 0))
+                    return null;
+                return {
+                    cost: cost ?? 0,
+                    currency: (mppCurrency ?? 'USD').toUpperCase(),
+                    payer: mppPayer ?? undefined,
+                    protocol: 'mpp',
+                    protocol_metadata: {
+                        session_token: mppSession,
+                    },
+                };
+            }
+            // Handle plain objects (manual mode / pre-call)
+            const sessionData = extractMPPSessionData(response);
+            if (!sessionData)
+                return null;
+            return {
+                cost: sessionData.cost ?? 0,
+                currency: (sessionData.currency ?? 'USD').toUpperCase(),
+                payer: sessionData.payer,
+                protocol: 'mpp',
+                protocol_metadata: {
+                    session_token: sessionData.session_token,
+                    spending_limit: sessionData.spending_limit,
+                    session_spent: sessionData.spent,
+                },
+            };
+        },
+    };
+}
+/**
+ * Build a connector_error denial for MPP parse failures.
+ */
+export function buildMPPConnectorError(error) {
+    return {
+        reason: 'connector_error',
+        cost: 0,
+        currency: 'USD',
+        budget_scope: 'session',
+        budget_limit: 0,
+        budget_spent: 0,
+        budget_remaining: 0,
+        connector_name: 'mpp',
+        raw_error: error,
+    };
+}
+//# sourceMappingURL=mpp.js.map

package/dist/economic/connectors/mpp.js.map

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

package/dist/economic/connectors/x402.d.ts

@@ -0,0 +1,20 @@
+/**
+ * x402 protocol connector.
+ *
+ * Detects HTTP 402 Payment Required responses and parses the
+ * X-Payment header (Coinbase x402 V2 protocol) into EconomicContext.
+ *
+ * Timing mode: post-response — cost discovered from 402 response.
+ *
+ * @module economic/connectors/x402
+ */
+import type { ProtocolConnector, EconomicDenialDetails } from '../types.js';
+/**
+ * Create an x402 protocol connector.
+ */
+export declare function createX402Connector(): ProtocolConnector;
+/**
+ * Build a connector_error denial for x402 parse failures.
+ */
+export declare function buildX402ConnectorError(error: string): EconomicDenialDetails;
+//# sourceMappingURL=x402.d.ts.map

package/dist/economic/connectors/x402.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.d.ts","sourceRoot":"","sources":["../../../src/economic/connectors/x402.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAmB,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAuD7F;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,iBAAiB,CA6DvD;AAuBD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAY5E"}