open-agentpay 0.1.0 → 0.2.5

package/dist/policy/interfaces.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Policy engine interfaces for AgentPay.
+ *
+ * Defines the two-phase reservation protocol and metering extensions.
+ */
+import type { BreakerState, PolicyDecision } from './models.js';
+export type Clock = () => number;
+export interface ReserveParams {
+    intentId: string;
+    amount: bigint | number | string;
+    payee: string;
+    asset: string;
+    network: string;
+    domain?: string | null;
+    ttlSeconds?: number;
+}
+export interface IPolicyEngine {
+    /**
+     * Atomically evaluate all precedence rules and lock quota.
+     */
+    reserve(params: ReserveParams): PolicyDecision;
+    /**
+     * Transition a reservation from RESERVED to COMMITTED.
+     * Idempotent: subsequent calls for the same intentId are no-ops.
+     */
+    commit(intentId: string): void;
+    /**
+     * Transition a reservation from RESERVED to RELEASED, returning quota.
+     * Guarded: if the intent was already COMMITTED, throws RESERVATION_ALREADY_FINALIZED.
+     */
+    release(intentId: string, reason?: string): void;
+}
+export interface IMeteredPolicyEngine extends IPolicyEngine {
+    /**
+     * Reserve quota for a credential-mode (non-402) call before wire dispatch.
+     */
+    reserveMetered(intentId: string, estimatedAmount: bigint | number | string, domain?: string | null, ttlSeconds?: number): PolicyDecision;
+    /**
+     * Settle a metered call by transitioning from RESERVED to COMMITTED.
+     */
+    settleMetered(intentId: string, actualAmount?: bigint | number | null): void;
+    /**
+     * Return the current available rolling budget in base units.
+     */
+    getAvailableRollingBudget(): bigint;
+    /**
+     * Return the current live circuit breaker state.
+     */
+    getBreakerState(): BreakerState;
+    /**
+     * Record a transaction or upstream delivery failure.
+     */
+    recordFailure(reason?: string): void;
+    /**
+     * Reset the circuit breaker to CLOSED.
+     */
+    resetBreaker(): void;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/policy/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/policy/interfaces.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhE,MAAM,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC;AAEjC,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,CAAC;IAE/C;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IACzD;;OAEG;IACH,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EACzC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,EACtB,UAAU,CAAC,EAAE,MAAM,GAClB,cAAc,CAAC;IAElB;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAE7E;;OAEG;IACH,yBAAyB,IAAI,MAAM,CAAC;IAEpC;;OAEG;IACH,eAAe,IAAI,YAAY,CAAC;IAEhC;;OAEG;IACH,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC;;OAEG;IACH,YAAY,IAAI,IAAI,CAAC;CACtB"}

package/dist/policy/interfaces.js

@@ -0,0 +1,7 @@
+/**
+ * Policy engine interfaces for AgentPay.
+ *
+ * Defines the two-phase reservation protocol and metering extensions.
+ */
+export {};
+//# sourceMappingURL=interfaces.js.map

package/dist/policy/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../src/policy/interfaces.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/policy/models.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Policy engine data models for AgentPay.
+ *
+ * All models are frozen value objects.
+ * Amounts are strictly bigint base units; floats and booleans are rejected.
+ * EVM addresses are auto-normalised to lowercase.
+ * CAIP-2 network identifiers are validated on construction.
+ */
+import { SQLITE_MAX_INT } from '../core/models.js';
+import { PolicyErrorCode } from './errors.js';
+export { SQLITE_MAX_INT };
+export declare function normalizeDomainHost(value: string): string;
+export declare function validatePositiveBigInt(value: unknown, fieldName: string): bigint;
+export declare enum BreakerState {
+    CLOSED = "CLOSED",
+    OPEN = "OPEN",
+    HALF_OPEN = "HALF_OPEN"
+}
+export declare enum WhitelistMode {
+    STRICT = "strict",
+    SIMPLE = "simple"
+}
+export declare enum LedgerEntryState {
+    RESERVED = "RESERVED",
+    COMMITTED = "COMMITTED",
+    RELEASED = "RELEASED"
+}
+export interface ReservationTokenInput {
+    reservationId?: string;
+    reservation_id?: string;
+    intentId?: string;
+    intent_id?: string;
+    policyId?: string;
+    policy_id?: string;
+    amount: bigint | number | string;
+    expiresAt?: number;
+    expires_at?: number;
+    createdAt?: number;
+    created_at?: number;
+}
+export declare class ReservationToken {
+    readonly reservationId: string;
+    readonly intentId: string;
+    readonly policyId: string;
+    readonly amount: bigint;
+    readonly expiresAt: number;
+    readonly createdAt: number;
+    get reservation_id(): string;
+    get intent_id(): string;
+    get policy_id(): string;
+    get expires_at(): number;
+    get created_at(): number;
+    constructor(input: ReservationTokenInput);
+    toJSON(): Record<string, unknown>;
+}
+export interface PolicyDecision {
+    readonly approved: boolean;
+    readonly errorCode?: PolicyErrorCode | null;
+    readonly reservation?: ReservationToken | null;
+    readonly availableAfter?: bigint | null;
+}
+export interface PaymentRequestInput {
+    intentId?: string;
+    intent_id?: string;
+    amount: bigint | number | string;
+    payee: string;
+    asset: string;
+    network: string;
+    domain?: string | null;
+    ttlSeconds?: number;
+    ttl_seconds?: number;
+}
+export declare class PaymentRequest {
+    readonly intentId: string;
+    readonly amount: bigint;
+    readonly payee: string;
+    readonly asset: string;
+    readonly network: string;
+    readonly domain: string | null;
+    readonly ttlSeconds: number;
+    get intent_id(): string;
+    get ttl_seconds(): number;
+    get isAgentpayWallet(): boolean;
+    get is_agentpay_wallet(): boolean;
+    constructor(input: PaymentRequestInput);
+}
+export interface PolicyConfigInput {
+    id: string;
+    name?: string;
+    walletAddress?: string;
+    wallet_address?: string;
+    maxPerTxBaseUnits?: bigint | number | string;
+    max_per_tx_base_units?: bigint | number | string;
+    rollingBudget24hBaseUnits?: bigint | number | string;
+    rolling_budget_24h_base_units?: bigint | number | string;
+    lifetimeBudgetBaseUnits?: bigint | number | string | null;
+    lifetime_budget_base_units?: bigint | number | string | null;
+    whitelistMode?: WhitelistMode | string;
+    whitelist_mode?: WhitelistMode | string;
+    whitelistPayees?: readonly string[];
+    whitelist_payees?: readonly string[];
+    whitelistAssets?: readonly string[];
+    whitelist_assets?: readonly string[];
+    whitelistNetworks?: readonly string[];
+    whitelist_networks?: readonly string[];
+    whitelistDomains?: readonly string[];
+    whitelist_domains?: readonly string[];
+    circuitMaxRpm?: number;
+    circuit_max_rpm?: number;
+    circuitConsecutiveFailures?: number;
+    circuit_consecutive_failures?: number;
+    circuitCooldownSeconds?: number;
+    circuit_cooldown_seconds?: number;
+    breakerState?: BreakerState | string;
+    breaker_state?: BreakerState | string;
+    trippedAt?: number | null;
+    tripped_at?: number | null;
+    isFrozen?: boolean;
+    is_frozen?: boolean | number;
+    createdAt?: number;
+    created_at?: number;
+    updatedAt?: number;
+    updated_at?: number;
+}
+export declare class PolicyConfig {
+    readonly id: string;
+    readonly name: string;
+    readonly walletAddress: `0x${string}`;
+    readonly maxPerTxBaseUnits: bigint;
+    readonly rollingBudget24hBaseUnits: bigint;
+    readonly lifetimeBudgetBaseUnits: bigint | null;
+    readonly whitelistMode: WhitelistMode;
+    readonly whitelistPayees: ReadonlySet<string>;
+    readonly whitelistAssets: ReadonlySet<string>;
+    readonly whitelistNetworks: ReadonlySet<string>;
+    readonly whitelistDomains: ReadonlySet<string>;
+    readonly circuitMaxRpm: number;
+    readonly circuitConsecutiveFailures: number;
+    readonly circuitCooldownSeconds: number;
+    readonly breakerState: BreakerState;
+    readonly trippedAt: number | null;
+    readonly isFrozen: boolean;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    get wallet_address(): `0x${string}`;
+    get max_per_tx_base_units(): bigint;
+    get rolling_budget_24h_base_units(): bigint;
+    get lifetime_budget_base_units(): bigint | null;
+    get whitelist_mode(): WhitelistMode;
+    get circuit_max_rpm(): number;
+    get circuit_consecutive_failures(): number;
+    get circuit_cooldown_seconds(): number;
+    get breaker_state(): BreakerState;
+    get tripped_at(): number | null;
+    get is_frozen(): boolean;
+    get created_at(): number;
+    get updated_at(): number;
+    constructor(input: PolicyConfigInput);
+}
+export declare function loadPolicyConfig(data: Record<string, any>): PolicyConfig;
+//# sourceMappingURL=models.d.ts.map

package/dist/policy/models.d.ts.map

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