paygate-mcp 10.5.0 → 10.7.0

package/dist/a2a-protocol.d.ts

@@ -0,0 +1,245 @@
+/**
+ * A2A Protocol Support — Agent-to-Agent communication alongside MCP.
+ *
+ * Implements core A2A (Agent-to-Agent) protocol primitives for inter-agent
+ * communication, task delegation, and capability discovery. Supports:
+ *
+ *   - Agent Cards (/.well-known/agent.json): Advertise agent capabilities
+ *   - Task lifecycle: create → working → completed/failed/canceled
+ *   - Message exchange with typed parts (text, file, data)
+ *   - Agent skill discovery and matching
+ *   - Billing hooks for task-based pricing
+ *
+ * A2A protocol specification: https://google.github.io/A2A/
+ *
+ * Zero external dependencies.
+ */
+/** Agent capability advertised via Agent Card. */
+export interface AgentSkill {
+    /** Unique skill ID. */
+    id: string;
+    /** Human-readable skill name. */
+    name: string;
+    /** Description of what this skill does. */
+    description?: string;
+    /** Tags for discoverability. */
+    tags?: string[];
+    /** Example prompts that invoke this skill. */
+    examples?: string[];
+    /** MIME types this skill accepts as input. */
+    inputModes?: string[];
+    /** MIME types this skill can produce as output. */
+    outputModes?: string[];
+}
+/** Agent Card served at /.well-known/agent.json. */
+export interface AgentCard {
+    /** Agent name. */
+    name: string;
+    /** Agent description. */
+    description?: string;
+    /** Agent provider info. */
+    provider?: {
+        organization: string;
+        url?: string;
+    };
+    /** Agent version. */
+    version: string;
+    /** URL where A2A protocol requests are accepted. */
+    url: string;
+    /** Skills this agent provides. */
+    skills: AgentSkill[];
+    /** Supported A2A capabilities. */
+    capabilities?: {
+        streaming?: boolean;
+        pushNotifications?: boolean;
+        stateTransitionHistory?: boolean;
+    };
+    /** Authentication requirements. */
+    authentication?: {
+        schemes: string[];
+        credentials?: string;
+    };
+    /** Default input MIME types. */
+    defaultInputModes?: string[];
+    /** Default output MIME types. */
+    defaultOutputModes?: string[];
+}
+/** Status of an A2A task. */
+export type A2ATaskStatus = 'submitted' | 'working' | 'input-required' | 'completed' | 'failed' | 'canceled';
+/** A part of a message (text, file, or data). */
+export interface MessagePart {
+    type: 'text' | 'file' | 'data';
+    /** Text content (for type='text'). */
+    text?: string;
+    /** File reference (for type='file'). */
+    file?: {
+        name?: string;
+        mimeType?: string;
+        uri?: string;
+        bytes?: string;
+    };
+    /** Structured data (for type='data'). */
+    data?: Record<string, unknown>;
+    /** Metadata about this part. */
+    metadata?: Record<string, unknown>;
+}
+/** A message in the A2A conversation. */
+export interface A2AMessage {
+    /** Unique message ID. */
+    messageId: string;
+    /** Who sent this: 'user' (requesting agent) or 'agent' (this agent). */
+    role: 'user' | 'agent';
+    /** Message parts. */
+    parts: MessagePart[];
+    /** ISO timestamp. */
+    timestamp: string;
+    /** Arbitrary metadata. */
+    metadata?: Record<string, unknown>;
+}
+/** Status update for a task. */
+export interface TaskStatus {
+    state: A2ATaskStatus;
+    message?: A2AMessage;
+    timestamp: string;
+}
+/** An A2A task. */
+export interface A2ATask {
+    /** Unique task ID. */
+    id: string;
+    /** Session ID for multi-turn conversations. */
+    sessionId: string;
+    /** Current status. */
+    status: TaskStatus;
+    /** History of status transitions. */
+    history: TaskStatus[];
+    /** Artifacts produced by the task. */
+    artifacts: A2AArtifact[];
+    /** ISO creation timestamp. */
+    createdAt: string;
+    /** ISO last update timestamp. */
+    updatedAt: string;
+    /** Metadata. */
+    metadata?: Record<string, unknown>;
+}
+/** An artifact produced by a task. */
+export interface A2AArtifact {
+    /** Unique artifact ID. */
+    id: string;
+    /** Artifact name. */
+    name?: string;
+    /** Artifact parts. */
+    parts: MessagePart[];
+    /** Whether this artifact is the final result. */
+    lastChunk?: boolean;
+    /** Artifact index (for multi-artifact tasks). */
+    index?: number;
+    /** Metadata. */
+    metadata?: Record<string, unknown>;
+}
+/** A2A JSON-RPC methods. */
+export type A2AMethod = 'tasks/send' | 'tasks/get' | 'tasks/cancel' | 'tasks/pushNotification/set' | 'tasks/pushNotification/get' | 'tasks/sendSubscribe';
+/** A2A JSON-RPC request. */
+export interface A2ARequest {
+    jsonrpc: '2.0';
+    id?: string | number;
+    method: A2AMethod;
+    params?: Record<string, unknown>;
+}
+/** A2A JSON-RPC response. */
+export interface A2AResponse {
+    jsonrpc: '2.0';
+    id?: string | number;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export interface A2AManagerConfig {
+    /** This agent's card. */
+    agentCard: AgentCard;
+    /** Max tasks to retain. Default: 10000. */
+    maxTasks?: number;
+    /** Max task age in ms. Default: 86400000 (24h). */
+    maxTaskAgeMs?: number;
+    /** Whether to record state transition history. Default: true. */
+    recordHistory?: boolean;
+}
+export interface A2AStats {
+    /** Total tasks created. */
+    totalTasks: number;
+    /** Tasks by status. */
+    byStatus: Record<string, number>;
+    /** Total messages exchanged. */
+    totalMessages: number;
+    /** Total artifacts produced. */
+    totalArtifacts: number;
+    /** Active (non-terminal) tasks. */
+    activeTasks: number;
+}
+export declare class A2AManager {
+    private agentCard;
+    private tasks;
+    private maxTasks;
+    private maxTaskAgeMs;
+    private recordHistory;
+    private stats;
+    constructor(config: A2AManagerConfig);
+    /** Get the agent card for /.well-known/agent.json. */
+    getAgentCard(): AgentCard;
+    /** Update agent card. */
+    updateAgentCard(card: Partial<AgentCard>): void;
+    /**
+     * Handle an incoming A2A JSON-RPC request.
+     * Routes to the appropriate handler based on method.
+     */
+    handleRequest(request: A2ARequest): A2AResponse;
+    /**
+     * Create a new task or send a message to an existing task.
+     */
+    private handleTaskSend;
+    /**
+     * Get task status.
+     */
+    private handleTaskGet;
+    /**
+     * Cancel a task.
+     */
+    private handleTaskCancel;
+    /**
+     * Transition a task to a new state (for use by task handlers).
+     */
+    transitionTask(taskOrId: A2ATask | string, newState: A2ATaskStatus, message?: A2AMessage, artifact?: A2AArtifact): A2ATask | null;
+    /**
+     * Get a task by ID.
+     */
+    getTask(taskId: string): A2ATask | null;
+    /**
+     * List tasks with optional filters.
+     */
+    listTasks(opts?: {
+        sessionId?: string;
+        status?: A2ATaskStatus;
+        limit?: number;
+    }): A2ATask[];
+    /**
+     * Find skills matching a query.
+     */
+    findSkills(query: string): AgentSkill[];
+    /**
+     * Get stats.
+     */
+    getStats(): A2AStats;
+    /**
+     * Clean up old tasks.
+     */
+    cleanup(maxAgeMs?: number): number;
+    /**
+     * Destroy and release resources.
+     */
+    destroy(): void;
+    private sanitizeTask;
+    private evictOldTasks;
+}
+//# sourceMappingURL=a2a-protocol.d.ts.map

package/dist/a2a-protocol.d.ts.map

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

package/dist/a2a-protocol.js

@@ -0,0 +1,288 @@
+"use strict";
+/**
+ * A2A Protocol Support — Agent-to-Agent communication alongside MCP.
+ *
+ * Implements core A2A (Agent-to-Agent) protocol primitives for inter-agent
+ * communication, task delegation, and capability discovery. Supports:
+ *
+ *   - Agent Cards (/.well-known/agent.json): Advertise agent capabilities
+ *   - Task lifecycle: create → working → completed/failed/canceled
+ *   - Message exchange with typed parts (text, file, data)
+ *   - Agent skill discovery and matching
+ *   - Billing hooks for task-based pricing
+ *
+ * A2A protocol specification: https://google.github.io/A2A/
+ *
+ * Zero external dependencies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A2AManager = void 0;
+// ─── A2A Manager ─────────────────────────────────────────────────────────────
+class A2AManager {
+    agentCard;
+    tasks = new Map();
+    maxTasks;
+    maxTaskAgeMs;
+    recordHistory;
+    stats = {
+        totalTasks: 0,
+        byStatus: {},
+        totalMessages: 0,
+        totalArtifacts: 0,
+        activeTasks: 0,
+    };
+    constructor(config) {
+        this.agentCard = config.agentCard;
+        this.maxTasks = config.maxTasks ?? 10_000;
+        this.maxTaskAgeMs = config.maxTaskAgeMs ?? 86_400_000;
+        this.recordHistory = config.recordHistory ?? true;
+    }
+    /** Get the agent card for /.well-known/agent.json. */
+    getAgentCard() {
+        return { ...this.agentCard };
+    }
+    /** Update agent card. */
+    updateAgentCard(card) {
+        Object.assign(this.agentCard, card);
+    }
+    /**
+     * Handle an incoming A2A JSON-RPC request.
+     * Routes to the appropriate handler based on method.
+     */
+    handleRequest(request) {
+        const base = { jsonrpc: '2.0', id: request.id };
+        switch (request.method) {
+            case 'tasks/send':
+                return { ...base, ...this.handleTaskSend(request.params ?? {}) };
+            case 'tasks/get':
+                return { ...base, ...this.handleTaskGet(request.params ?? {}) };
+            case 'tasks/cancel':
+                return { ...base, ...this.handleTaskCancel(request.params ?? {}) };
+            default:
+                return { ...base, error: { code: -32601, message: `Unknown A2A method: ${request.method}` } };
+        }
+    }
+    /**
+     * Create a new task or send a message to an existing task.
+     */
+    handleTaskSend(params) {
+        const taskId = params.id;
+        const sessionId = params.sessionId ?? `session_${Date.now()}`;
+        const messageParts = params.message;
+        if (!messageParts?.parts || messageParts.parts.length === 0) {
+            return { error: { code: -32602, message: 'Message with parts is required' } };
+        }
+        const message = {
+            messageId: `msg_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
+            role: messageParts.role ?? 'user',
+            parts: messageParts.parts,
+            timestamp: new Date().toISOString(),
+            metadata: params.metadata,
+        };
+        this.stats.totalMessages++;
+        // Existing task — append message
+        if (taskId && this.tasks.has(taskId)) {
+            const task = this.tasks.get(taskId);
+            const newStatus = {
+                state: 'working',
+                message,
+                timestamp: new Date().toISOString(),
+            };
+            if (this.recordHistory) {
+                task.history.push(task.status);
+            }
+            task.status = newStatus;
+            task.updatedAt = new Date().toISOString();
+            return { result: this.sanitizeTask(task) };
+        }
+        // New task
+        this.evictOldTasks();
+        const newTaskId = taskId ?? `task_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+        const status = {
+            state: 'submitted',
+            message,
+            timestamp: new Date().toISOString(),
+        };
+        const task = {
+            id: newTaskId,
+            sessionId,
+            status,
+            history: [],
+            artifacts: [],
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            metadata: params.metadata,
+        };
+        this.tasks.set(newTaskId, task);
+        this.stats.totalTasks++;
+        this.stats.activeTasks++;
+        this.stats.byStatus['submitted'] = (this.stats.byStatus['submitted'] ?? 0) + 1;
+        return { result: this.sanitizeTask(task) };
+    }
+    /**
+     * Get task status.
+     */
+    handleTaskGet(params) {
+        const taskId = params.id;
+        if (!taskId) {
+            return { error: { code: -32602, message: 'Task ID is required' } };
+        }
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            return { error: { code: -32001, message: `Task not found: ${taskId}` } };
+        }
+        return { result: this.sanitizeTask(task) };
+    }
+    /**
+     * Cancel a task.
+     */
+    handleTaskCancel(params) {
+        const taskId = params.id;
+        if (!taskId) {
+            return { error: { code: -32602, message: 'Task ID is required' } };
+        }
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            return { error: { code: -32001, message: `Task not found: ${taskId}` } };
+        }
+        const terminalStates = ['completed', 'failed', 'canceled'];
+        if (terminalStates.includes(task.status.state)) {
+            return { error: { code: -32002, message: `Task already in terminal state: ${task.status.state}` } };
+        }
+        this.transitionTask(task, 'canceled');
+        return { result: this.sanitizeTask(task) };
+    }
+    /**
+     * Transition a task to a new state (for use by task handlers).
+     */
+    transitionTask(taskOrId, newState, message, artifact) {
+        const task = typeof taskOrId === 'string' ? this.tasks.get(taskOrId) : taskOrId;
+        if (!task)
+            return null;
+        const oldState = task.status.state;
+        if (this.recordHistory) {
+            task.history.push(task.status);
+        }
+        const newStatus = {
+            state: newState,
+            message,
+            timestamp: new Date().toISOString(),
+        };
+        task.status = newStatus;
+        task.updatedAt = new Date().toISOString();
+        if (artifact) {
+            task.artifacts.push(artifact);
+            this.stats.totalArtifacts++;
+        }
+        // Update stats
+        this.stats.byStatus[oldState] = Math.max(0, (this.stats.byStatus[oldState] ?? 0) - 1);
+        this.stats.byStatus[newState] = (this.stats.byStatus[newState] ?? 0) + 1;
+        const terminalStates = ['completed', 'failed', 'canceled'];
+        if (terminalStates.includes(newState) && !terminalStates.includes(oldState)) {
+            this.stats.activeTasks = Math.max(0, this.stats.activeTasks - 1);
+        }
+        return task;
+    }
+    /**
+     * Get a task by ID.
+     */
+    getTask(taskId) {
+        const task = this.tasks.get(taskId);
+        return task ? this.sanitizeTask(task) : null;
+    }
+    /**
+     * List tasks with optional filters.
+     */
+    listTasks(opts) {
+        let tasks = [...this.tasks.values()];
+        if (opts?.sessionId) {
+            tasks = tasks.filter(t => t.sessionId === opts.sessionId);
+        }
+        if (opts?.status) {
+            tasks = tasks.filter(t => t.status.state === opts.status);
+        }
+        tasks.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+        if (opts?.limit) {
+            tasks = tasks.slice(0, opts.limit);
+        }
+        return tasks.map(t => this.sanitizeTask(t));
+    }
+    /**
+     * Find skills matching a query.
+     */
+    findSkills(query) {
+        const q = query.toLowerCase();
+        return this.agentCard.skills.filter(s => {
+            if (s.name.toLowerCase().includes(q))
+                return true;
+            if (s.description?.toLowerCase().includes(q))
+                return true;
+            if (s.tags?.some(t => t.toLowerCase().includes(q)))
+                return true;
+            return false;
+        });
+    }
+    /**
+     * Get stats.
+     */
+    getStats() {
+        return { ...this.stats, byStatus: { ...this.stats.byStatus } };
+    }
+    /**
+     * Clean up old tasks.
+     */
+    cleanup(maxAgeMs) {
+        const threshold = maxAgeMs ?? this.maxTaskAgeMs;
+        const cutoff = Date.now() - threshold;
+        let cleaned = 0;
+        for (const [id, task] of this.tasks) {
+            if (new Date(task.updatedAt).getTime() < cutoff) {
+                const terminalStates = ['completed', 'failed', 'canceled'];
+                if (!terminalStates.includes(task.status.state)) {
+                    this.stats.activeTasks = Math.max(0, this.stats.activeTasks - 1);
+                }
+                this.tasks.delete(id);
+                cleaned++;
+            }
+        }
+        return cleaned;
+    }
+    /**
+     * Destroy and release resources.
+     */
+    destroy() {
+        this.tasks.clear();
+        this.stats = {
+            totalTasks: 0,
+            byStatus: {},
+            totalMessages: 0,
+            totalArtifacts: 0,
+            activeTasks: 0,
+        };
+    }
+    // ─── Private ─────────────────────────────────────────────────────────────
+    sanitizeTask(task) {
+        return {
+            ...task,
+            history: this.recordHistory ? [...task.history] : [],
+            artifacts: [...task.artifacts],
+        };
+    }
+    evictOldTasks() {
+        if (this.tasks.size < this.maxTasks)
+            return;
+        // Remove oldest completed tasks first
+        const entries = [...this.tasks.entries()]
+            .sort((a, b) => a[1].updatedAt.localeCompare(b[1].updatedAt));
+        const terminalStates = ['completed', 'failed', 'canceled'];
+        for (const [id, task] of entries) {
+            if (this.tasks.size < this.maxTasks * 0.8)
+                break; // Keep 80% capacity
+            if (terminalStates.includes(task.status.state)) {
+                this.tasks.delete(id);
+            }
+        }
+    }
+}
+exports.A2AManager = A2AManager;
+//# sourceMappingURL=a2a-protocol.js.map

package/dist/a2a-protocol.js.map

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

package/dist/billable-metrics.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Billable Metric Expressions — Config-driven pricing formulas.
+ *
+ * Instead of flat per-call pricing, define expressions that compute
+ * cost based on request/response attributes:
+ *
+ *   cost = input_tokens * 0.001 + output_tokens * 0.003
+ *   cost = max(1, file_size_kb * 0.5)
+ *   cost = base_cost + (duration_ms / 1000) * 2
+ *
+ * SECURITY: Expressions are parsed with a safe recursive descent parser.
+ * NO JavaScript eval(), NO Function constructor. The parser only
+ * supports arithmetic (+, -, *, /, %), built-in math functions
+ * (min, max, ceil, floor, round, abs, sqrt, log, pow),
+ * numeric literals, and named variables.
+ *
+ * Features:
+ *   - Safe expression parsing (AST-based, no code execution)
+ *   - Built-in math functions: min, max, ceil, floor, round, abs
+ *   - Variable binding from tool args and response fields
+ *   - Per-tool metric definitions
+ *   - Fallback to flat pricing if expression errors
+ *   - Statistics and audit trail
+ *
+ * Zero external dependencies.
+ */
+export interface BillableMetric {
+    /** Unique metric ID. */
+    id: string;
+    /** Human-readable name. */
+    name: string;
+    /** Expression string (e.g., 'input_tokens * 0.001 + output_tokens * 0.003'). */
+    expression: string;
+    /** Tools this metric applies to. Empty = all. */
+    tools: string[];
+    /** Minimum cost (floor). Default: 0. */
+    minCost?: number;
+    /** Maximum cost (ceiling). Default: Infinity. */
+    maxCost?: number;
+    /** Whether this metric is active. Default: true. */
+    active: boolean;
+    /** Description. */
+    description?: string;
+    /** Fallback flat cost if expression fails. Default: 1. */
+    fallbackCost?: number;
+}
+export interface MetricContext {
+    /** Tool name. */
+    tool: string;
+    /** Input arguments (flattened key-value). */
+    inputArgs: Record<string, unknown>;
+    /** Response content (if post-call). */
+    responseContent?: string;
+    /** Response size in bytes. */
+    responseSizeBytes?: number;
+    /** Call duration in ms. */
+    durationMs?: number;
+    /** Input size in bytes. */
+    inputSizeBytes?: number;
+    /** Custom variables injected by caller. */
+    customVars?: Record<string, number>;
+}
+export interface MetricResult {
+    /** Computed cost in credits. */
+    cost: number;
+    /** Metric ID used. */
+    metricId: string;
+    /** Whether fallback was used. */
+    usedFallback: boolean;
+    /** Error if expression failed. */
+    error?: string;
+    /** Variables resolved for the expression. */
+    resolvedVars: Record<string, number>;
+}
+export interface BillableMetricStats {
+    /** Total evaluations. */
+    totalEvaluations: number;
+    /** Successful expression evaluations. */
+    successfulEvals: number;
+    /** Fallback evaluations (expression error). */
+    fallbackEvals: number;
+    /** Total credits computed. */
+    totalCreditsComputed: number;
+    /** Evaluations by metric ID. */
+    byMetric: Record<string, number>;
+    /** Evaluations by tool. */
+    byTool: Record<string, number>;
+}
+/**
+ * Safely compute a math expression with named variables.
+ *
+ * Uses a recursive descent parser. No JavaScript code execution.
+ * Only supports: numbers, variables, +, -, *, /, %, parentheses,
+ * and built-in math functions (min, max, ceil, floor, round, abs, sqrt, log, pow).
+ */
+export declare function computeExpression(expression: string, vars: Record<string, number>): number;
+export declare class BillableMetricEngine {
+    private metrics;
+    private stats;
+    constructor(metrics?: BillableMetric[]);
+    /** Get all metrics. */
+    getMetrics(): BillableMetric[];
+    /** Add or update a metric. */
+    upsertMetric(metric: BillableMetric): BillableMetric;
+    /** Remove a metric by ID. */
+    removeMetric(id: string): boolean;
+    /**
+     * Find the matching metric for a tool.
+     * Returns the first active metric whose tool list matches.
+     */
+    findMetric(tool: string): BillableMetric | null;
+    /**
+     * Compute cost for a tool call using billable metric expressions.
+     *
+     * @param context - Context with args, response, timing data
+     * @returns Result with computed cost, or null if no metric matches
+     */
+    computeCost(context: MetricContext): MetricResult | null;
+    /** Get statistics. */
+    getStats(): BillableMetricStats;
+    /** Reset stats. */
+    resetStats(): void;
+    /** Export metrics for backup/serialization. */
+    exportMetrics(): BillableMetric[];
+    /** Import metrics. */
+    importMetrics(metrics: BillableMetric[], mode?: 'merge' | 'replace'): number;
+    /** Destroy. */
+    destroy(): void;
+}
+//# sourceMappingURL=billable-metrics.d.ts.map