agentpay-mcp 1.2.0 → 4.0.0

package/dist/tools/session.d.ts

@@ -0,0 +1,240 @@
+/**
+ * session.ts — x402 V2 session payment tools.
+ *
+ * Implements the x402 V2 "wallet-based access & reusable sessions" pattern:
+ *   1. x402_session_start  — pay once, receive a signed session token
+ *   2. x402_session_fetch  — make N calls within the session (no new payments)
+ *   3. x402_session_status — inspect active sessions and TTL remaining
+ *   4. x402_session_end    — explicitly close a session
+ *
+ * Non-custodial design:
+ *   Agents sign session tokens locally with their private key.
+ *   No third party holds or validates keys at any point.
+ *   Session tokens are self-contained ECDSA-signed claims that any server
+ *   implementing x402 V2 can independently verify.
+ */
+import { z } from 'zod';
+import { findSessionForUrl, buildSessionHeaders } from '../session/manager.js';
+export declare const X402SessionStartSchema: z.ZodObject<{
+    endpoint: z.ZodString;
+    scope: z.ZodDefault<z.ZodOptional<z.ZodEnum<["prefix", "exact"]>>>;
+    ttl_seconds: z.ZodOptional<z.ZodNumber>;
+    label: z.ZodOptional<z.ZodString>;
+    max_payment_eth: z.ZodOptional<z.ZodString>;
+    method: z.ZodDefault<z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    body: z.ZodOptional<z.ZodString>;
+    timeout_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    endpoint: string;
+    scope: "exact" | "prefix";
+    timeout_ms: number;
+    body?: string | undefined;
+    headers?: Record<string, string> | undefined;
+    ttl_seconds?: number | undefined;
+    label?: string | undefined;
+    max_payment_eth?: string | undefined;
+}, {
+    endpoint: string;
+    body?: string | undefined;
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | undefined;
+    headers?: Record<string, string> | undefined;
+    scope?: "exact" | "prefix" | undefined;
+    ttl_seconds?: number | undefined;
+    label?: string | undefined;
+    max_payment_eth?: string | undefined;
+    timeout_ms?: number | undefined;
+}>;
+export type X402SessionStartInput = z.infer<typeof X402SessionStartSchema>;
+export declare const x402SessionStartTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            endpoint: {
+                type: string;
+                description: string;
+            };
+            scope: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            ttl_seconds: {
+                type: string;
+                description: string;
+            };
+            label: {
+                type: string;
+                description: string;
+            };
+            max_payment_eth: {
+                type: string;
+                description: string;
+            };
+            method: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            headers: {
+                type: string;
+                additionalProperties: {
+                    type: string;
+                };
+                description: string;
+            };
+            body: {
+                type: string;
+                description: string;
+            };
+            timeout_ms: {
+                type: string;
+                description: string;
+                default: number;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleX402SessionStart(input: X402SessionStartInput): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const X402SessionFetchSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    url: z.ZodString;
+    method: z.ZodDefault<z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    body: z.ZodOptional<z.ZodString>;
+    timeout_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    timeout_ms: number;
+    session_id: string;
+    url: string;
+    body?: string | undefined;
+    headers?: Record<string, string> | undefined;
+}, {
+    session_id: string;
+    url: string;
+    body?: string | undefined;
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | undefined;
+    headers?: Record<string, string> | undefined;
+    timeout_ms?: number | undefined;
+}>;
+export type X402SessionFetchInput = z.infer<typeof X402SessionFetchSchema>;
+export declare const x402SessionFetchTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            session_id: {
+                type: string;
+                description: string;
+            };
+            url: {
+                type: string;
+                description: string;
+            };
+            method: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            headers: {
+                type: string;
+                additionalProperties: {
+                    type: string;
+                };
+                description: string;
+            };
+            body: {
+                type: string;
+                description: string;
+            };
+            timeout_ms: {
+                type: string;
+                description: string;
+                default: number;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleX402SessionFetch(input: X402SessionFetchInput): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const X402SessionStatusSchema: z.ZodObject<{
+    session_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    session_id?: string | undefined;
+}, {
+    session_id?: string | undefined;
+}>;
+export type X402SessionStatusInput = z.infer<typeof X402SessionStatusSchema>;
+export declare const x402SessionStatusTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            session_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+};
+export declare function handleX402SessionStatus(input: X402SessionStatusInput): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const X402SessionEndSchema: z.ZodObject<{
+    session_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    session_id: string;
+}, {
+    session_id: string;
+}>;
+export type X402SessionEndInput = z.infer<typeof X402SessionEndSchema>;
+export declare const x402SessionEndTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            session_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleX402SessionEnd(input: X402SessionEndInput): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export { findSessionForUrl, buildSessionHeaders };
+//# sourceMappingURL=session.d.ts.map

package/dist/tools/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/tools/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAML,iBAAiB,EACjB,mBAAmB,EAEpB,MAAM,uBAAuB,CAAC;AAI/B,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwDjC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE3E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDhC,CAAC;AAEF,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAkJhF;AAID,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;EA8BjC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE3E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0ChC,CAAC;AAEF,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA8IhF;AAID,eAAO,MAAM,uBAAuB;;;;;;EAQlC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE7E,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;CAiBjC,CAAC;AAEF,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAoGhF;AAID,eAAO,MAAM,oBAAoB;;;;;;EAK/B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEvE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;CAgB9B,CAAC;AAEF,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA6ChF;AA8CD,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,CAAC"}