@t402/a2a 2.4.0

package/dist/esm/server.d.ts

@@ -0,0 +1,177 @@
+import { PaymentPayload, PaymentRequired, SettleResponse, A2AMessage, A2ATaskStatus, A2ATask } from '@t402/core/types';
+import { FacilitatorClient } from '@t402/core/server';
+
+/**
+ * A2A Payment Server
+ *
+ * Handles server-side payment processing for A2A agent endpoints,
+ * including generating payment requirements and processing payment submissions.
+ */
+
+/**
+ * Result of payment processing
+ */
+interface A2APaymentResult {
+    /** Whether payment was successful */
+    success: boolean;
+    /** Settlement receipts (if settled) */
+    receipts?: SettleResponse[];
+    /** Error message (if failed) */
+    error?: string;
+    /** A2A message to include in response */
+    message: A2AMessage;
+}
+/**
+ * Payment handler function type
+ */
+type A2APaymentHandler = (payload: PaymentPayload, requirements: PaymentRequired) => Promise<A2APaymentResult>;
+/**
+ * Options for A2APaymentServer
+ */
+interface A2APaymentServerOptions {
+    /**
+     * Facilitator client for verification and settlement
+     */
+    facilitator?: FacilitatorClient;
+    /**
+     * Custom payment handler (alternative to facilitator)
+     */
+    paymentHandler?: A2APaymentHandler;
+    /**
+     * Default payment requirements template
+     */
+    defaultRequirements?: Partial<PaymentRequired>;
+    /**
+     * Optional callback when payment is received
+     */
+    onPaymentReceived?: (payload: PaymentPayload) => void;
+    /**
+     * Optional callback when payment is verified
+     */
+    onPaymentVerified?: (payload: PaymentPayload) => void;
+    /**
+     * Optional callback when payment is settled
+     */
+    onPaymentSettled?: (receipts: SettleResponse[]) => void;
+    /**
+     * Optional callback when payment fails
+     */
+    onPaymentFailed?: (error: string, payload?: PaymentPayload) => void;
+}
+/**
+ * A2A Payment Server
+ *
+ * Provides server-side payment handling for A2A agent endpoints.
+ *
+ * @example
+ * ```typescript
+ * const server = new A2APaymentServer({
+ *   facilitator: facilitatorClient,
+ *   defaultRequirements: {
+ *     t402Version: 2,
+ *     resource: 'agent://my-agent/skill',
+ *   },
+ * });
+ *
+ * // Create payment-required response
+ * const requirements = server.createRequirements({
+ *   accepts: [{ scheme: 'exact', network: 'eip155:8453', amount: '1000000', ... }],
+ * });
+ * const task = server.createPaymentRequiredTask(taskId, requirements);
+ *
+ * // Process payment submission
+ * const result = await server.processPayment(message, requirements);
+ * if (result.success) {
+ *   // Continue with task execution
+ * }
+ * ```
+ */
+declare class A2APaymentServer {
+    private options;
+    constructor(options?: A2APaymentServerOptions);
+    /**
+     * Create payment requirements with defaults
+     *
+     * @param requirements - Partial requirements to merge with defaults
+     * @returns Complete payment requirements
+     */
+    createRequirements(requirements: Partial<PaymentRequired>): PaymentRequired;
+    /**
+     * Create a payment-required task status
+     *
+     * @param requirements - Payment requirements
+     * @param text - Optional text message
+     * @returns A2A task status
+     */
+    createPaymentRequiredStatus(requirements: PaymentRequired, text?: string): A2ATaskStatus;
+    /**
+     * Create a payment-required task
+     *
+     * @param taskId - Task identifier
+     * @param requirements - Payment requirements
+     * @param text - Optional text message
+     * @returns A2A task in input-required state
+     */
+    createPaymentRequiredTask(taskId: string, requirements: PaymentRequired, text?: string): A2ATask;
+    /**
+     * Extract payment payload from an A2A message
+     *
+     * @param message - A2A message that may contain payment
+     * @returns Payment payload or undefined
+     */
+    extractPaymentPayload(message: A2AMessage): PaymentPayload | undefined;
+    /**
+     * Check if a message contains a payment submission
+     *
+     * @param message - A2A message to check
+     * @returns Whether the message contains a payment
+     */
+    hasPaymentPayload(message: A2AMessage): boolean;
+    /**
+     * Process a payment submission
+     *
+     * @param message - A2A message containing payment payload
+     * @param requirements - Original payment requirements
+     * @returns Payment processing result
+     */
+    processPayment(message: A2AMessage, requirements: PaymentRequired): Promise<A2APaymentResult>;
+    /**
+     * Create a completed task status with payment receipts
+     *
+     * @param receipts - Settlement receipts
+     * @param text - Optional text message
+     * @returns A2A task status
+     */
+    createPaymentCompletedStatus(receipts: SettleResponse[], text?: string): A2ATaskStatus;
+    /**
+     * Create a failed task status with payment error
+     *
+     * @param error - Error message
+     * @param receipts - Optional settlement receipts
+     * @param errorCode - Optional error code
+     * @returns A2A task status
+     */
+    createPaymentFailedStatus(error: string, receipts?: SettleResponse[], errorCode?: string): A2ATaskStatus;
+    /**
+     * Update a task with payment completion
+     *
+     * @param task - Original task
+     * @param result - Payment processing result
+     * @returns Updated task
+     */
+    updateTaskWithPaymentResult(task: A2ATask, result: A2APaymentResult): A2ATask;
+    /**
+     * Handle a complete payment flow for a task
+     *
+     * This is a convenience method that processes a payment submission
+     * and returns an updated task.
+     *
+     * @param task - The current A2A task
+     * @param message - The message containing payment payload
+     * @param requirements - Payment requirements
+     * @returns Updated task with payment result
+     */
+    handlePayment(task: A2ATask, message: A2AMessage, requirements: PaymentRequired): Promise<A2ATask>;
+}
+
+export { type A2APaymentHandler, type A2APaymentResult, A2APaymentServer, type A2APaymentServerOptions };

package/dist/esm/server.mjs

@@ -0,0 +1,6 @@
+import {
+  A2APaymentServer
+} from "./chunk-6TJQKXTN.mjs";
+export {
+  A2APaymentServer
+};

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@t402/a2a",
+  "version": "2.4.0",
+  "description": "A2A (Agent-to-Agent) transport for t402 payment protocol",
+  "type": "module",
+  "main": "./dist/cjs/index.cjs",
+  "module": "./dist/esm/index.mjs",
+  "types": "./dist/esm/index.d.mts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.mts",
+        "default": "./dist/esm/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.cts",
+        "default": "./dist/cjs/index.cjs"
+      }
+    },
+    "./client": {
+      "import": {
+        "types": "./dist/esm/client.d.mts",
+        "default": "./dist/esm/client.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/client.d.cts",
+        "default": "./dist/cjs/client.cjs"
+      }
+    },
+    "./server": {
+      "import": {
+        "types": "./dist/esm/server.d.mts",
+        "default": "./dist/esm/server.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/server.d.cts",
+        "default": "./dist/cjs/server.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@t402/core": "2.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.3",
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^3.2.4"
+  },
+  "keywords": [
+    "t402",
+    "a2a",
+    "agent-to-agent",
+    "payments",
+    "crypto",
+    "stablecoin",
+    "usdt",
+    "usdc",
+    "ai-agents"
+  ],
+  "author": "T402 Contributors",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/t402-io/t402.git",
+    "directory": "sdks/typescript/packages/a2a"
+  },
+  "bugs": {
+    "url": "https://github.com/t402-io/t402/issues"
+  },
+  "homepage": "https://t402.io",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist coverage"
+  }
+}