@clawpay-hedera/sdk 0.1.0

package/dist/handler/proxy/hooks/auth-headers-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-headers-hook.js","sourceRoot":"","sources":["../../../../src/handler/proxy/hooks/auth-headers-hook.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,eAAe;IAGK;IAF7B,IAAI,GAAG,cAAc,CAAC;IAEtB,YAA6B,kBAAsC;QAAtC,uBAAkB,GAAlB,kBAAkB,CAAoB;IAAG,CAAC;IAEvE,KAAK,CAAC,sBAAsB,CAAC,GAA+B,EAAE,MAAoB;QAC9E,OAAO,EAAE,UAAU,EAAE,UAAmB,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,sBAAsB,CAAC,OAAgB,EAAE,GAAY,EAAE,KAAmB;QAC5E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3D,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,IAAI,QAAQ,YAAY,OAAO,EAAE,CAAC;YAC9B,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;oBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC/E,CAAC,CAAC,CAAC;YACH,OAAO;QACX,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,QAAQ,EAAE,CAAC;gBAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;oBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC/E,CAAC;YACD,OAAO;QACX,CAAC;QAED,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/E,CAAC;IACL,CAAC;CACJ"}

package/dist/handler/proxy/hooks/hcs-audit-hook.d.ts

@@ -0,0 +1,133 @@
+/**
+ * HCS Audit Trail Hook for ClawPay
+ *
+ * Logs every successful x402 payment to a Hedera Consensus Service (HCS) topic,
+ * creating an immutable, publicly verifiable audit trail of all MCP tool payments.
+ *
+ * Each MCP server gets its own HCS topic. Payment events are JSON messages
+ * containing transaction ID, amount, asset, tool name, and timestamp.
+ *
+ * View audit trails on HashScan: https://hashscan.io/testnet/topic/{topicId}
+ */
+import type { CallToolRequest, CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { Hook, RequestExtra } from "../hooks.js";
+export interface HCSAuditConfig {
+    /** Hedera operator account ID (e.g. "0.0.12345") */
+    operatorId: string;
+    /** Hedera operator private key (DER-encoded hex) */
+    operatorKey: string;
+    /** Network: "testnet" or "mainnet" */
+    network: "testnet" | "mainnet";
+    /** Optional: pre-existing topic ID to use instead of creating one */
+    topicId?: string;
+}
+export interface HCSPaymentEvent {
+    type: "payment_settled";
+    txId: string;
+    network: string;
+    amount: string;
+    asset: string;
+    tool: string;
+    payer?: string;
+    serverId?: string;
+    timestamp: string;
+}
+/**
+ * HCS Audit Hook — logs payment events to Hedera Consensus Service.
+ *
+ * Lazily initializes the Hedera SDK and topic on first payment.
+ * Falls back gracefully if HCS submission fails (payment still succeeds).
+ */
+export declare class HCSAuditHook implements Hook {
+    name: string;
+    private config;
+    private topicId;
+    private hederaClient;
+    private initialized;
+    constructor(config: HCSAuditConfig);
+    private ensureInitialized;
+    private submitAuditMessage;
+    /**
+     * Get the HCS topic ID for this audit trail.
+     * Returns null if not yet initialized.
+     */
+    getTopicId(): string | null;
+    processCallToolResult(res: CallToolResult, req: CallToolRequest, extra: RequestExtra): Promise<{
+        resultType: "continue";
+        response: {
+            [x: string]: unknown;
+            content: ({
+                [x: string]: unknown;
+                type: "text";
+                text: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            } | {
+                [x: string]: unknown;
+                type: "image";
+                data: string;
+                mimeType: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            } | {
+                [x: string]: unknown;
+                type: "audio";
+                data: string;
+                mimeType: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            } | {
+                [x: string]: unknown;
+                type: "resource_link";
+                name: string;
+                uri: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+                title?: string | undefined;
+                description?: string | undefined;
+                icons?: {
+                    [x: string]: unknown;
+                    src: string;
+                    mimeType?: string | undefined;
+                    sizes?: string | undefined;
+                }[] | undefined;
+            } | {
+                [x: string]: unknown;
+                type: "resource";
+                resource: {
+                    [x: string]: unknown;
+                    text: string;
+                    uri: string;
+                    _meta?: {
+                        [x: string]: unknown;
+                    } | undefined;
+                    mimeType?: string | undefined;
+                } | {
+                    [x: string]: unknown;
+                    uri: string;
+                    blob: string;
+                    _meta?: {
+                        [x: string]: unknown;
+                    } | undefined;
+                    mimeType?: string | undefined;
+                };
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            })[];
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            structuredContent?: {
+                [x: string]: unknown;
+            } | undefined;
+            isError?: boolean | undefined;
+        };
+    }>;
+}
+//# sourceMappingURL=hcs-audit-hook.d.ts.map

package/dist/handler/proxy/hooks/hcs-audit-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hcs-audit-hook.d.ts","sourceRoot":"","sources":["../../../../src/handler/proxy/hooks/hcs-audit-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACR,eAAe,EACf,cAAc,EACjB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC3B,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,qBAAa,YAAa,YAAW,IAAI;IACrC,IAAI,SAAe;IACnB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,cAAc;YAKpB,iBAAiB;YAwDjB,kBAAkB;IAoBhC;;;OAGG;IACH,UAAU,IAAI,MAAM,GAAG,IAAI;IAIrB,qBAAqB,CACvB,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,eAAe,EACpB,KAAK,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqD1B"}

package/dist/handler/proxy/hooks/hcs-audit-hook.js

@@ -0,0 +1,138 @@
+/**
+ * HCS Audit Trail Hook for ClawPay
+ *
+ * Logs every successful x402 payment to a Hedera Consensus Service (HCS) topic,
+ * creating an immutable, publicly verifiable audit trail of all MCP tool payments.
+ *
+ * Each MCP server gets its own HCS topic. Payment events are JSON messages
+ * containing transaction ID, amount, asset, tool name, and timestamp.
+ *
+ * View audit trails on HashScan: https://hashscan.io/testnet/topic/{topicId}
+ */
+/**
+ * HCS Audit Hook — logs payment events to Hedera Consensus Service.
+ *
+ * Lazily initializes the Hedera SDK and topic on first payment.
+ * Falls back gracefully if HCS submission fails (payment still succeeds).
+ */
+export class HCSAuditHook {
+    name = "hcs-audit";
+    config;
+    topicId;
+    hederaClient = null;
+    initialized = false;
+    constructor(config) {
+        this.config = config;
+        this.topicId = config.topicId || null;
+    }
+    async ensureInitialized() {
+        if (this.initialized)
+            return true;
+        try {
+            // Dynamic import to avoid requiring @hashgraph/sdk when not using HCS
+            const { Client, TopicCreateTransaction, AccountId, PrivateKey } = await import("@hashgraph/sdk");
+            const client = this.config.network === "mainnet"
+                ? Client.forMainnet()
+                : Client.forTestnet();
+            // Try multiple key formats: ECDSA hex, DER, ED25519
+            let operatorKey;
+            try {
+                operatorKey = PrivateKey.fromStringECDSA(this.config.operatorKey);
+            }
+            catch {
+                try {
+                    operatorKey = PrivateKey.fromStringDer(this.config.operatorKey);
+                }
+                catch {
+                    operatorKey = PrivateKey.fromStringED25519(this.config.operatorKey);
+                }
+            }
+            client.setOperator(AccountId.fromString(this.config.operatorId), operatorKey);
+            this.hederaClient = client;
+            // Create topic if not provided
+            if (!this.topicId) {
+                const txResponse = await new TopicCreateTransaction()
+                    .setTopicMemo("ClawPay Payment Audit Trail")
+                    .execute(client);
+                const receipt = await txResponse.getReceipt(client);
+                this.topicId = receipt.topicId?.toString() || null;
+                if (this.topicId) {
+                    console.log(`[HCSAuditHook] Created audit topic: ${this.topicId}`);
+                    const base = this.config.network === "mainnet"
+                        ? "https://hashscan.io/mainnet"
+                        : "https://hashscan.io/testnet";
+                    console.log(`[HCSAuditHook] View on HashScan: ${base}/topic/${this.topicId}`);
+                }
+            }
+            this.initialized = true;
+            return true;
+        }
+        catch (error) {
+            console.error("[HCSAuditHook] Failed to initialize:", error);
+            return false;
+        }
+    }
+    async submitAuditMessage(event) {
+        if (!this.hederaClient || !this.topicId)
+            return;
+        try {
+            const { TopicMessageSubmitTransaction, TopicId } = await import("@hashgraph/sdk");
+            const message = JSON.stringify(event);
+            await new TopicMessageSubmitTransaction()
+                .setTopicId(TopicId.fromString(this.topicId))
+                .setMessage(message)
+                .execute(this.hederaClient);
+            console.log(`[HCSAuditHook] Payment logged to topic ${this.topicId}: ${event.txId}`);
+        }
+        catch (error) {
+            // Don't fail the payment if HCS logging fails
+            console.error("[HCSAuditHook] Failed to submit audit message:", error);
+        }
+    }
+    /**
+     * Get the HCS topic ID for this audit trail.
+     * Returns null if not yet initialized.
+     */
+    getTopicId() {
+        return this.topicId;
+    }
+    async processCallToolResult(res, req, extra) {
+        // Check if this response contains a successful payment settlement
+        const meta = res._meta || {};
+        const paymentResponse = meta["x402/payment-response"];
+        if (paymentResponse?.success && paymentResponse.transaction) {
+            // Initialize HCS on first payment (lazy init)
+            const ready = await this.ensureInitialized();
+            if (!ready) {
+                return { resultType: "continue", response: res };
+            }
+            // Extract payment details from the x402 error metadata (original requirements)
+            const x402Error = meta["x402/error"];
+            const toolName = String(req?.params?.name ?? "unknown");
+            const firstAccept = x402Error?.accepts?.[0];
+            const event = {
+                type: "payment_settled",
+                txId: paymentResponse.transaction,
+                network: paymentResponse.network || "hedera-testnet",
+                amount: firstAccept?.maxAmountRequired || "unknown",
+                asset: firstAccept?.asset || "HBAR",
+                tool: toolName,
+                payer: paymentResponse.payer,
+                serverId: extra?.serverId || undefined,
+                timestamp: new Date().toISOString(),
+            };
+            // Submit to HCS (fire-and-forget, don't block the response)
+            this.submitAuditMessage(event).catch(() => { });
+            // Add HCS topic info to response metadata
+            if (this.topicId) {
+                res._meta["clawpay/hcs-topic"] = this.topicId;
+                const base = this.config.network === "mainnet"
+                    ? "https://hashscan.io/mainnet"
+                    : "https://hashscan.io/testnet";
+                res._meta["clawpay/hcs-url"] = `${base}/topic/${this.topicId}`;
+            }
+        }
+        return { resultType: "continue", response: res };
+    }
+}
+//# sourceMappingURL=hcs-audit-hook.js.map

package/dist/handler/proxy/hooks/hcs-audit-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hcs-audit-hook.js","sourceRoot":"","sources":["../../../../src/handler/proxy/hooks/hcs-audit-hook.ts"],"names":[],"mappings":"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"}

package/dist/handler/proxy/hooks/logging-hook.d.ts

@@ -0,0 +1,100 @@
+import { CallToolRequest, CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { Hook, RequestExtra } from "../hooks.js";
+export declare class LoggingHook implements Hook {
+    name: string;
+    processCallToolRequest(req: CallToolRequest, extra: RequestExtra): Promise<{
+        resultType: "continue";
+        request: {
+            params: {
+                [x: string]: unknown;
+                name: string;
+                _meta?: {
+                    [x: string]: unknown;
+                    progressToken?: string | number | undefined;
+                } | undefined;
+                arguments?: {
+                    [x: string]: unknown;
+                } | undefined;
+            };
+            method: "tools/call";
+        };
+    }>;
+    processCallToolResult(res: CallToolResult, req: CallToolRequest, extra: RequestExtra): Promise<{
+        resultType: "continue";
+        response: {
+            [x: string]: unknown;
+            content: ({
+                [x: string]: unknown;
+                type: "text";
+                text: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            } | {
+                [x: string]: unknown;
+                type: "image";
+                data: string;
+                mimeType: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            } | {
+                [x: string]: unknown;
+                type: "audio";
+                data: string;
+                mimeType: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            } | {
+                [x: string]: unknown;
+                type: "resource_link";
+                name: string;
+                uri: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+                title?: string | undefined;
+                description?: string | undefined;
+                icons?: {
+                    [x: string]: unknown;
+                    src: string;
+                    mimeType?: string | undefined;
+                    sizes?: string | undefined;
+                }[] | undefined;
+            } | {
+                [x: string]: unknown;
+                type: "resource";
+                resource: {
+                    [x: string]: unknown;
+                    text: string;
+                    uri: string;
+                    _meta?: {
+                        [x: string]: unknown;
+                    } | undefined;
+                    mimeType?: string | undefined;
+                } | {
+                    [x: string]: unknown;
+                    uri: string;
+                    blob: string;
+                    _meta?: {
+                        [x: string]: unknown;
+                    } | undefined;
+                    mimeType?: string | undefined;
+                };
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            })[];
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            structuredContent?: {
+                [x: string]: unknown;
+            } | undefined;
+            isError?: boolean | undefined;
+        };
+    }>;
+}
+//# sourceMappingURL=logging-hook.d.ts.map

package/dist/handler/proxy/hooks/logging-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging-hook.d.ts","sourceRoot":"","sources":["../../../../src/handler/proxy/hooks/logging-hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACrF,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEjD,qBAAa,WAAY,YAAW,IAAI;IACpC,IAAI,SAAa;IACX,sBAAsB,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY;;;;;;;;;;;;;;;;;IAIhE,qBAAqB,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAM7F"}

package/dist/handler/proxy/hooks/logging-hook.js

@@ -0,0 +1,14 @@
+export class LoggingHook {
+    name = "logging";
+    async processCallToolRequest(req, extra) {
+        console.log(`[${extra.requestId}] Tool called: ${JSON.stringify(req, null, 2)}`);
+        return { resultType: "continue", request: req };
+    }
+    async processCallToolResult(res, req, extra) {
+        console.log(`[${extra.requestId}] Response from: ${req.params.name}`);
+        console.log(`[${extra.requestId}] Response: ${JSON.stringify(res, null, 2)}`);
+        // Do not mutate the response shape; pass through unchanged to preserve JSON-RPC envelope expectations
+        return { resultType: "continue", response: res };
+    }
+}
+//# sourceMappingURL=logging-hook.js.map

package/dist/handler/proxy/hooks/logging-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging-hook.js","sourceRoot":"","sources":["../../../../src/handler/proxy/hooks/logging-hook.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,WAAW;IACpB,IAAI,GAAG,SAAS,CAAC;IACjB,KAAK,CAAC,sBAAsB,CAAC,GAAoB,EAAE,KAAmB;QAClE,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,SAAS,kBAAkB,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACjF,OAAO,EAAE,UAAU,EAAE,UAAmB,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAC7D,CAAC;IACD,KAAK,CAAC,qBAAqB,CAAC,GAAmB,EAAE,GAAoB,EAAE,KAAmB;QACtF,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,SAAS,oBAAoB,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,SAAS,eAAe,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9E,sGAAsG;QACtG,OAAO,EAAE,UAAU,EAAE,UAAmB,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IAC9D,CAAC;CACJ"}

package/dist/handler/proxy/hooks/x402-hook.d.ts

@@ -0,0 +1,246 @@
+import type { CallToolRequest, CallToolResult, ListToolsResult } from "@modelcontextprotocol/sdk/types.js";
+import type { FacilitatorConfig, Network, Price } from "x402/types";
+import type { Hook, RequestExtra, ListToolsRequestWithContext } from "../hooks.js";
+export type RecipientWithTestnet = {
+    address: string;
+    isTestnet?: boolean;
+};
+export type X402ProxyConfig = {
+    recipient: Partial<Record<Network, string>> | Partial<Record<"evm", RecipientWithTestnet>>;
+    facilitator: FacilitatorConfig;
+    version?: number;
+    prices: Record<string, Price>;
+};
+export declare class X402MonetizationHook implements Hook {
+    name: string;
+    private readonly cfg;
+    private readonly verify;
+    private readonly settle;
+    private readonly x402Version;
+    constructor(cfg: X402ProxyConfig);
+    private normalizeRecipients;
+    private buildRequirements;
+    private paymentRequired;
+    processCallToolRequest(req: CallToolRequest, extra: RequestExtra): Promise<{
+        resultType: "continue";
+        request: {
+            params: {
+                [x: string]: unknown;
+                name: string;
+                _meta?: {
+                    [x: string]: unknown;
+                    progressToken?: string | number | undefined;
+                } | undefined;
+                arguments?: {
+                    [x: string]: unknown;
+                } | undefined;
+            };
+            method: "tools/call";
+        };
+        response?: undefined;
+    } | {
+        resultType: "respond";
+        response: {
+            [x: string]: unknown;
+            content: ({
+                [x: string]: unknown;
+                type: "text";
+                text: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            } | {
+                [x: string]: unknown;
+                type: "image";
+                data: string;
+                mimeType: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            } | {
+                [x: string]: unknown;
+                type: "audio";
+                data: string;
+                mimeType: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            } | {
+                [x: string]: unknown;
+                type: "resource_link";
+                name: string;
+                uri: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+                title?: string | undefined;
+                description?: string | undefined;
+                icons?: {
+                    [x: string]: unknown;
+                    src: string;
+                    mimeType?: string | undefined;
+                    sizes?: string | undefined;
+                }[] | undefined;
+            } | {
+                [x: string]: unknown;
+                type: "resource";
+                resource: {
+                    [x: string]: unknown;
+                    text: string;
+                    uri: string;
+                    _meta?: {
+                        [x: string]: unknown;
+                    } | undefined;
+                    mimeType?: string | undefined;
+                } | {
+                    [x: string]: unknown;
+                    uri: string;
+                    blob: string;
+                    _meta?: {
+                        [x: string]: unknown;
+                    } | undefined;
+                    mimeType?: string | undefined;
+                };
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            })[];
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            structuredContent?: {
+                [x: string]: unknown;
+            } | undefined;
+            isError?: boolean | undefined;
+        };
+        request?: undefined;
+    }>;
+    processCallToolResult(res: CallToolResult, original: CallToolRequest, extra: RequestExtra): Promise<{
+        resultType: "continue";
+        response: {
+            [x: string]: unknown;
+            content: ({
+                [x: string]: unknown;
+                type: "text";
+                text: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            } | {
+                [x: string]: unknown;
+                type: "image";
+                data: string;
+                mimeType: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            } | {
+                [x: string]: unknown;
+                type: "audio";
+                data: string;
+                mimeType: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            } | {
+                [x: string]: unknown;
+                type: "resource_link";
+                name: string;
+                uri: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+                title?: string | undefined;
+                description?: string | undefined;
+                icons?: {
+                    [x: string]: unknown;
+                    src: string;
+                    mimeType?: string | undefined;
+                    sizes?: string | undefined;
+                }[] | undefined;
+            } | {
+                [x: string]: unknown;
+                type: "resource";
+                resource: {
+                    [x: string]: unknown;
+                    text: string;
+                    uri: string;
+                    _meta?: {
+                        [x: string]: unknown;
+                    } | undefined;
+                    mimeType?: string | undefined;
+                } | {
+                    [x: string]: unknown;
+                    uri: string;
+                    blob: string;
+                    _meta?: {
+                        [x: string]: unknown;
+                    } | undefined;
+                    mimeType?: string | undefined;
+                };
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            })[];
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            structuredContent?: {
+                [x: string]: unknown;
+            } | undefined;
+            isError?: boolean | undefined;
+        };
+    }>;
+    processListToolsResult(result: ListToolsResult, originalRequest: ListToolsRequestWithContext, extra: RequestExtra): Promise<{
+        resultType: "continue";
+        response: {
+            [x: string]: unknown;
+            tools: {
+                [x: string]: unknown;
+                name: string;
+                inputSchema: {
+                    [x: string]: unknown;
+                    type: "object";
+                    properties?: {
+                        [x: string]: unknown;
+                    } | undefined;
+                    required?: string[] | undefined;
+                };
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                title?: string | undefined;
+                description?: string | undefined;
+                icons?: {
+                    [x: string]: unknown;
+                    src: string;
+                    mimeType?: string | undefined;
+                    sizes?: string | undefined;
+                }[] | undefined;
+                outputSchema?: {
+                    [x: string]: unknown;
+                    type: "object";
+                    properties?: {
+                        [x: string]: unknown;
+                    } | undefined;
+                    required?: string[] | undefined;
+                } | undefined;
+                annotations?: {
+                    [x: string]: unknown;
+                    title?: string | undefined;
+                    readOnlyHint?: boolean | undefined;
+                    destructiveHint?: boolean | undefined;
+                    idempotentHint?: boolean | undefined;
+                    openWorldHint?: boolean | undefined;
+                } | undefined;
+            }[];
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            nextCursor?: string | undefined;
+        };
+    }>;
+}
+//# sourceMappingURL=x402-hook.d.ts.map

package/dist/handler/proxy/hooks/x402-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402-hook.d.ts","sourceRoot":"","sources":["../../../../src/handler/proxy/hooks/x402-hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAe,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACxH,OAAO,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAuC,KAAK,EAAE,MAAM,YAAY,CAAC;AAKzG,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AASnF,MAAM,MAAM,oBAAoB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAC5E,MAAM,MAAM,eAAe,GAAG;IAC1B,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAC3F,WAAW,EAAE,iBAAiB,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CACjC,CAAC;AAQF,qBAAa,oBAAqB,YAAW,IAAI;IAC7C,IAAI,SAAuB;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8C;IACrE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8C;IACrE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,GAAG,EAAE,eAAe;IAQhC,OAAO,CAAC,mBAAmB;YAyBb,iBAAiB;IAkC/B,OAAO,CAAC,eAAe;IASjB,sBAAsB,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA6ChE,qBAAqB,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAgDzF,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,eAAe,EAAE,2BAA2B,EAAE,KAAK,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6C1H"}