import { type AgentPassportNetwork } from "./agentPassport.js";
import type { SolanaNetwork } from "./generated/solanaV14Deployments.generated.js";
export interface AgentHistoryOptions {
    address?: string;
    /** Public @username, AIFP number or aifp_agent_* identifier; never a secret. */
    passport?: string;
    network?: AgentPassportNetwork;
    /** Required with network="solana"; never infer a cluster from an address. */
    solanaNetwork?: SolanaNetwork;
    source?: "transactions" | "receipts";
    limit?: number;
    offset?: number;
    baseUrl?: string;
    fetchImpl?: typeof fetch;
}
/** Public fields returned for source="receipts". Single source of truth — MCP must import, not copy. */
export declare const AGENT_RECEIPT_FIELDS: string[];
/** Public fields returned for source="transactions". Single source of truth — MCP must import, not copy. */
export declare const AGENT_TRANSACTION_FIELDS: string[];
/** Read public payment metadata. A passport is resolved to a verified wallet first. */
export declare function getAgentHistory(options: AgentHistoryOptions): Promise<Record<string, unknown>>;
export interface QuotaOptions {
    address: string;
    network?: AgentPassportNetwork;
    solanaNetwork?: SolanaNetwork;
    /** Optional mrch_… filter — only batches bought from this service. */
    merchantId?: string;
    /** Also list batches with 0 remaining (still retained, not yet expired). */
    includeExhausted?: boolean;
    baseUrl?: string;
    fetchImpl?: typeof fetch;
}
export interface QuotaBatch {
    merchant_id?: string;
    resource?: string;
    scope: string;
    tier?: string;
    used: number;
    remaining: number;
    quota: number;
    paid?: string;
    expires?: string;
    receipt_id?: string;
    chain?: string;
    network?: SolanaNetwork;
    program?: string;
    asset?: string;
}
export interface QuotaSummary {
    agent: string;
    totals: Record<string, {
        remaining: number;
        batches: number;
    }>;
    batches: QuotaBatch[];
}
/**
 * Prepaid quota batches for an address, most room first, rolled up per
 * merchant. Data only — the human-facing "no quota, go pay a 402" note stays
 * with the caller (MCP). `remaining` is authoritative where AiFinPay meters;
 * merchants running their own gate meter locally and our copy can lag.
 */
export declare function getQuota(options: QuotaOptions): Promise<QuotaSummary>;
//# sourceMappingURL=agentHistory.d.ts.map