@cloakedagent/sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { CloakedAgent } from "./agent";
+export { CLOAKED_PROGRAM_ID, ZK_VERIFIER_PROGRAM_ID } from "./constants";
+export * from "./types";
+export { Signer, keypairToSigner } from "./signer";
+export { setBackendUrl, getBackendUrl, isBackendUrlConfigured } from "./config";
+export { createPrivateAgentViaRelayer, getRelayerStatus, freezePrivateViaRelayer, unfreezePrivateViaRelayer, updateConstraintsPrivateViaRelayer, withdrawPrivateViaRelayer, closePrivateViaRelayer, type CreatePrivateViaRelayerOptions, type CreatePrivateViaRelayerResult, type RelayerStatus, type PrivateOperationParams, type UpdateConstraintsPrivateParams, type WithdrawPrivateParams, type ClosePrivateParams, } from "./relayer";
+export { poseidon, poseidonHash, initPoseidonSync, isPoseidonReady, deriveMasterSecret, deriveAgentSecrets, commitmentToBytes, bytesToCommitment, getSignMessage, MAX_AGENTS, initProver, isProverReady, generateOwnershipProof, proofToInstructionArgs, findAgentByCommitment, discoverPrivateAgents, getNextPrivateNonce, agentExistsForCommitment, } from "./zk";
+export type { PrivateAgentSecrets, OwnershipProof, DiscoveredPrivateAgent } from "./zk";
+export type { BalanceResponse, StatusResponse, PayResponse, } from "./mcp/types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACzE,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAGnD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAGhF,OAAO,EACL,4BAA4B,EAC5B,gBAAgB,EAChB,uBAAuB,EACvB,yBAAyB,EACzB,kCAAkC,EAClC,yBAAyB,EACzB,sBAAsB,EACtB,KAAK,8BAA8B,EACnC,KAAK,6BAA6B,EAClC,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,8BAA8B,EACnC,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,GACxB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAEL,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,eAAe,EAEf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,UAAU,EAEV,UAAU,EACV,aAAa,EACb,sBAAsB,EACtB,sBAAsB,EAEtB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,MAAM,CAAC;AACd,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,MAAM,CAAC;AAGxF,YAAY,EACV,eAAe,EACf,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,66 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentExistsForCommitment = exports.getNextPrivateNonce = exports.discoverPrivateAgents = exports.findAgentByCommitment = exports.proofToInstructionArgs = exports.generateOwnershipProof = exports.isProverReady = exports.initProver = exports.MAX_AGENTS = exports.getSignMessage = exports.bytesToCommitment = exports.commitmentToBytes = exports.deriveAgentSecrets = exports.deriveMasterSecret = exports.isPoseidonReady = exports.initPoseidonSync = exports.poseidonHash = exports.poseidon = exports.closePrivateViaRelayer = exports.withdrawPrivateViaRelayer = exports.updateConstraintsPrivateViaRelayer = exports.unfreezePrivateViaRelayer = exports.freezePrivateViaRelayer = exports.getRelayerStatus = exports.createPrivateAgentViaRelayer = exports.isBackendUrlConfigured = exports.getBackendUrl = exports.setBackendUrl = exports.keypairToSigner = exports.ZK_VERIFIER_PROGRAM_ID = exports.CLOAKED_PROGRAM_ID = exports.CloakedAgent = void 0;
+var agent_1 = require("./agent");
+Object.defineProperty(exports, "CloakedAgent", { enumerable: true, get: function () { return agent_1.CloakedAgent; } });
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "CLOAKED_PROGRAM_ID", { enumerable: true, get: function () { return constants_1.CLOAKED_PROGRAM_ID; } });
+Object.defineProperty(exports, "ZK_VERIFIER_PROGRAM_ID", { enumerable: true, get: function () { return constants_1.ZK_VERIFIER_PROGRAM_ID; } });
+__exportStar(require("./types"), exports);
+var signer_1 = require("./signer");
+Object.defineProperty(exports, "keypairToSigner", { enumerable: true, get: function () { return signer_1.keypairToSigner; } });
+// SDK configuration - MUST call setBackendUrl in browser environments
+var config_1 = require("./config");
+Object.defineProperty(exports, "setBackendUrl", { enumerable: true, get: function () { return config_1.setBackendUrl; } });
+Object.defineProperty(exports, "getBackendUrl", { enumerable: true, get: function () { return config_1.getBackendUrl; } });
+Object.defineProperty(exports, "isBackendUrlConfigured", { enumerable: true, get: function () { return config_1.isBackendUrlConfigured; } });
+// Relayer module (Truly Private Agent Creation & Operations)
+var relayer_1 = require("./relayer");
+Object.defineProperty(exports, "createPrivateAgentViaRelayer", { enumerable: true, get: function () { return relayer_1.createPrivateAgentViaRelayer; } });
+Object.defineProperty(exports, "getRelayerStatus", { enumerable: true, get: function () { return relayer_1.getRelayerStatus; } });
+Object.defineProperty(exports, "freezePrivateViaRelayer", { enumerable: true, get: function () { return relayer_1.freezePrivateViaRelayer; } });
+Object.defineProperty(exports, "unfreezePrivateViaRelayer", { enumerable: true, get: function () { return relayer_1.unfreezePrivateViaRelayer; } });
+Object.defineProperty(exports, "updateConstraintsPrivateViaRelayer", { enumerable: true, get: function () { return relayer_1.updateConstraintsPrivateViaRelayer; } });
+Object.defineProperty(exports, "withdrawPrivateViaRelayer", { enumerable: true, get: function () { return relayer_1.withdrawPrivateViaRelayer; } });
+Object.defineProperty(exports, "closePrivateViaRelayer", { enumerable: true, get: function () { return relayer_1.closePrivateViaRelayer; } });
+// ZK Privacy module
+var zk_1 = require("./zk");
+// Poseidon hash
+Object.defineProperty(exports, "poseidon", { enumerable: true, get: function () { return zk_1.poseidon; } });
+Object.defineProperty(exports, "poseidonHash", { enumerable: true, get: function () { return zk_1.poseidonHash; } });
+Object.defineProperty(exports, "initPoseidonSync", { enumerable: true, get: function () { return zk_1.initPoseidonSync; } });
+Object.defineProperty(exports, "isPoseidonReady", { enumerable: true, get: function () { return zk_1.isPoseidonReady; } });
+// Secret derivation
+Object.defineProperty(exports, "deriveMasterSecret", { enumerable: true, get: function () { return zk_1.deriveMasterSecret; } });
+Object.defineProperty(exports, "deriveAgentSecrets", { enumerable: true, get: function () { return zk_1.deriveAgentSecrets; } });
+Object.defineProperty(exports, "commitmentToBytes", { enumerable: true, get: function () { return zk_1.commitmentToBytes; } });
+Object.defineProperty(exports, "bytesToCommitment", { enumerable: true, get: function () { return zk_1.bytesToCommitment; } });
+Object.defineProperty(exports, "getSignMessage", { enumerable: true, get: function () { return zk_1.getSignMessage; } });
+Object.defineProperty(exports, "MAX_AGENTS", { enumerable: true, get: function () { return zk_1.MAX_AGENTS; } });
+// Proof generation
+Object.defineProperty(exports, "initProver", { enumerable: true, get: function () { return zk_1.initProver; } });
+Object.defineProperty(exports, "isProverReady", { enumerable: true, get: function () { return zk_1.isProverReady; } });
+Object.defineProperty(exports, "generateOwnershipProof", { enumerable: true, get: function () { return zk_1.generateOwnershipProof; } });
+Object.defineProperty(exports, "proofToInstructionArgs", { enumerable: true, get: function () { return zk_1.proofToInstructionArgs; } });
+// Discovery
+Object.defineProperty(exports, "findAgentByCommitment", { enumerable: true, get: function () { return zk_1.findAgentByCommitment; } });
+Object.defineProperty(exports, "discoverPrivateAgents", { enumerable: true, get: function () { return zk_1.discoverPrivateAgents; } });
+Object.defineProperty(exports, "getNextPrivateNonce", { enumerable: true, get: function () { return zk_1.getNextPrivateNonce; } });
+Object.defineProperty(exports, "agentExistsForCommitment", { enumerable: true, get: function () { return zk_1.agentExistsForCommitment; } });
+// Note: runMcpServer is available via "@cloakedagent/sdk/mcp" subpath import
+// Not exported here to avoid pulling Node.js deps into browser bundles
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iCAAuC;AAA9B,qGAAA,YAAY,OAAA;AACrB,yCAAyE;AAAhE,+GAAA,kBAAkB,OAAA;AAAE,mHAAA,sBAAsB,OAAA;AACnD,0CAAwB;AACxB,mCAAmD;AAAlC,yGAAA,eAAe,OAAA;AAEhC,sEAAsE;AACtE,mCAAgF;AAAvE,uGAAA,aAAa,OAAA;AAAE,uGAAA,aAAa,OAAA;AAAE,gHAAA,sBAAsB,OAAA;AAE7D,6DAA6D;AAC7D,qCAemB;AAdjB,uHAAA,4BAA4B,OAAA;AAC5B,2GAAA,gBAAgB,OAAA;AAChB,kHAAA,uBAAuB,OAAA;AACvB,oHAAA,yBAAyB,OAAA;AACzB,6HAAA,kCAAkC,OAAA;AAClC,oHAAA,yBAAyB,OAAA;AACzB,iHAAA,sBAAsB,OAAA;AAUxB,oBAAoB;AACpB,2BAuBc;AAtBZ,gBAAgB;AAChB,8FAAA,QAAQ,OAAA;AACR,kGAAA,YAAY,OAAA;AACZ,sGAAA,gBAAgB,OAAA;AAChB,qGAAA,eAAe,OAAA;AACf,oBAAoB;AACpB,wGAAA,kBAAkB,OAAA;AAClB,wGAAA,kBAAkB,OAAA;AAClB,uGAAA,iBAAiB,OAAA;AACjB,uGAAA,iBAAiB,OAAA;AACjB,oGAAA,cAAc,OAAA;AACd,gGAAA,UAAU,OAAA;AACV,mBAAmB;AACnB,gGAAA,UAAU,OAAA;AACV,mGAAA,aAAa,OAAA;AACb,4GAAA,sBAAsB,OAAA;AACtB,4GAAA,sBAAsB,OAAA;AACtB,YAAY;AACZ,2GAAA,qBAAqB,OAAA;AACrB,2GAAA,qBAAqB,OAAA;AACrB,yGAAA,mBAAmB,OAAA;AACnB,8GAAA,wBAAwB,OAAA;AAW1B,6EAA6E;AAC7E,uEAAuE"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Run the MCP server - exported for programmatic use
+ * Validates CLOAKED_AGENT_KEY and starts the server
+ */
+export declare function runMcpServer(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AAoYA;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAWlD"}

package/dist/mcp/index.js

@@ -0,0 +1,374 @@
+#!/usr/bin/env node
+"use strict";
+// sdk/src/mcp/index.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runMcpServer = runMcpServer;
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const tools_1 = require("./tools");
+// ============================================
+// Tool definitions
+// ============================================
+const TOOLS = [
+    {
+        name: "cloak_balance",
+        description: "Get Cloaked Agent balance with spending limits and remaining amounts. Use this to check how much SOL is available and what the daily/total limits are.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_key: {
+                    type: "string",
+                    description: "Cloaked Agent key (optional, uses env CLOAKED_AGENT_KEY if not provided)",
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "cloak_status",
+        description: "Get detailed Cloaked Agent status including constraints, spending history, and health indicator. Use this for a comprehensive overview of the agent's spending account.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_key: {
+                    type: "string",
+                    description: "Cloaked Agent key (optional, uses env CLOAKED_AGENT_KEY if not provided)",
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "cloak_pay",
+        description: "Pay SOL to a destination address using the Cloaked Agent spending account. Use this for x402 payments or any SOL transfer within the agent's spending limits.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                destination: {
+                    type: "string",
+                    description: "Destination wallet address (base58 encoded Solana public key)",
+                },
+                amount: {
+                    type: "number",
+                    minimum: 0.000001,
+                    description: "Amount in SOL to pay (e.g., 0.001 for 1 milliSOL, 0.1 for 100 milliSOL)",
+                },
+                agent_key: {
+                    type: "string",
+                    description: "Cloaked Agent key (optional, uses env CLOAKED_AGENT_KEY if not provided)",
+                },
+            },
+            required: ["destination", "amount"],
+        },
+    },
+    {
+        name: "cloak_x402_fetch",
+        description: "Fetch x402-protected resources with automatic payment. Makes HTTP request, detects 402 Payment Required, pays using Cloaked Agent, retries with payment proof, returns content. Test server available at https://api.cloakedagent.com/api/x402-test/paid-content (0.001 SOL).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                url: {
+                    type: "string",
+                    description: "The URL to fetch (must be a valid HTTP/HTTPS URL)",
+                },
+                method: {
+                    type: "string",
+                    enum: ["GET", "POST", "PUT", "DELETE"],
+                    description: "HTTP method (default: GET)",
+                },
+                headers: {
+                    type: "object",
+                    additionalProperties: { type: "string" },
+                    description: "Custom request headers (e.g., { \"Accept\": \"application/json\" })",
+                },
+                body: {
+                    type: "string",
+                    description: "Request body for POST/PUT requests",
+                },
+                agent_key: {
+                    type: "string",
+                    description: "Cloaked Agent key (optional, uses env CLOAKED_AGENT_KEY if not provided)",
+                },
+            },
+            required: ["url"],
+        },
+    },
+];
+// ============================================
+// Prompt definitions
+// ============================================
+const PROMPTS = [
+    {
+        name: "check_balance",
+        description: "Check the current balance and spending limits of your Cloaked Agent",
+        arguments: [],
+    },
+    {
+        name: "spending_report",
+        description: "Get a detailed spending report including health status and remaining limits",
+        arguments: [],
+    },
+    {
+        name: "pay_for_service",
+        description: "Pay for an x402 service or transfer SOL to a destination",
+        arguments: [
+            {
+                name: "destination",
+                description: "The Solana wallet address to pay",
+                required: true,
+            },
+            {
+                name: "amount",
+                description: "Amount in SOL (e.g., 0.01)",
+                required: true,
+            },
+            {
+                name: "service_name",
+                description: "Name of the service being paid for (for your records)",
+                required: false,
+            },
+        ],
+    },
+    {
+        name: "can_i_afford",
+        description: "Check if a specific payment amount is within your current limits",
+        arguments: [
+            {
+                name: "amount",
+                description: "Amount in SOL you want to check",
+                required: true,
+            },
+        ],
+    },
+    {
+        name: "fetch_paid_content",
+        description: "Fetch content from an x402-protected URL with automatic payment. Test with https://api.cloakedagent.com/api/x402-test/paid-content (0.001 SOL)",
+        arguments: [
+            {
+                name: "url",
+                description: "The x402-protected URL to fetch (test: https://api.cloakedagent.com/api/x402-test/paid-content)",
+                required: true,
+            },
+            {
+                name: "description",
+                description: "What this content is (for your records)",
+                required: false,
+            },
+        ],
+    },
+];
+// ============================================
+// Prompt content generators
+// ============================================
+function getPromptContent(name, args) {
+    switch (name) {
+        case "check_balance":
+            return `Please check my Cloaked Agent's current balance and spending limits.
+
+Use the cloak_balance tool to get the current state, then tell me:
+1. Current balance in SOL
+2. How much I've spent today vs my daily limit
+3. How much I've spent total vs my lifetime limit
+4. Whether I'm frozen or have any restrictions`;
+        case "spending_report":
+            return `Please give me a comprehensive spending report for my Cloaked Agent.
+
+Use the cloak_status tool to get detailed information, then provide:
+1. Current health status (ok, low_balance, near_limit, frozen, etc.)
+2. All constraint settings (max per transaction, daily limit, total limit, expiration)
+3. Current spending statistics
+4. Any warnings or recommendations based on the current state`;
+        case "pay_for_service":
+            const dest = args.destination || "[DESTINATION_ADDRESS]";
+            const amt = args.amount || "[AMOUNT]";
+            const svc = args.service_name ? ` for ${args.service_name}` : "";
+            return `Please pay ${amt} SOL to ${dest}${svc}.
+
+Steps:
+1. First use cloak_balance to verify I have sufficient funds and am within limits
+2. If the balance and limits allow, use cloak_pay with:
+   - destination: ${dest}
+   - amount: ${amt}
+3. Report the transaction result including the signature and remaining balance`;
+        case "can_i_afford":
+            const checkAmt = args.amount || "[AMOUNT]";
+            return `Please check if I can afford to spend ${checkAmt} SOL with my Cloaked Agent.
+
+Use cloak_balance to check:
+1. Is my current balance >= ${checkAmt} SOL?
+2. Would this exceed my per-transaction limit?
+3. Would this exceed my remaining daily limit?
+4. Would this exceed my remaining total limit?
+5. Am I frozen or expired?
+
+Give me a clear yes/no answer with explanation.`;
+        case "fetch_paid_content":
+            const fetchUrl = args.url || "[URL]";
+            const desc = args.description ? ` (${args.description})` : "";
+            return `Please fetch the x402-protected content from ${fetchUrl}${desc}.
+
+Steps:
+1. First use cloak_balance to verify you have sufficient funds
+2. Use cloak_x402_fetch with url: ${fetchUrl}
+3. The tool will automatically:
+   - Detect if payment is required (402 response)
+   - Parse the payment requirements
+   - Pay the required amount
+   - Retry and fetch the content
+4. Report what content was received and what was paid`;
+        default:
+            return `Unknown prompt: ${name}`;
+    }
+}
+// ============================================
+// Server factory
+// ============================================
+function createServer() {
+    const server = new index_js_1.Server({
+        name: "cloaked-mcp",
+        version: "0.8.1",
+    }, {
+        capabilities: {
+            tools: {},
+            prompts: {},
+        },
+    });
+    // Handler for listing available tools
+    server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+        return { tools: TOOLS };
+    });
+    // Handler for listing available prompts
+    server.setRequestHandler(types_js_1.ListPromptsRequestSchema, async () => {
+        return { prompts: PROMPTS };
+    });
+    // Handler for getting a specific prompt
+    server.setRequestHandler(types_js_1.GetPromptRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const prompt = PROMPTS.find(p => p.name === name);
+        if (!prompt) {
+            throw new Error(`Unknown prompt: ${name}`);
+        }
+        const content = getPromptContent(name, args || {});
+        return {
+            description: prompt.description,
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: content,
+                    },
+                },
+            ],
+        };
+    });
+    // Handler for tool execution
+    server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            let result;
+            switch (name) {
+                case "cloak_balance": {
+                    const balanceArgs = args;
+                    result = await (0, tools_1.handleBalance)(balanceArgs?.agent_key);
+                    break;
+                }
+                case "cloak_status": {
+                    const statusArgs = args;
+                    result = await (0, tools_1.handleStatus)(statusArgs?.agent_key);
+                    break;
+                }
+                case "cloak_pay": {
+                    const payArgs = args;
+                    if (!payArgs.destination || payArgs.amount === undefined) {
+                        throw new Error("destination and amount are required");
+                    }
+                    // Ensure amount is treated as a float
+                    const amount = typeof payArgs.amount === 'string'
+                        ? parseFloat(payArgs.amount)
+                        : payArgs.amount;
+                    if (isNaN(amount) || amount <= 0) {
+                        throw new Error("amount must be a positive number (e.g., 0.001 for 1 milliSOL)");
+                    }
+                    result = await (0, tools_1.handlePay)(payArgs.destination, amount, payArgs.agent_key);
+                    break;
+                }
+                case "cloak_x402_fetch": {
+                    const fetchArgs = args;
+                    if (!fetchArgs.url) {
+                        throw new Error("url is required");
+                    }
+                    result = await (0, tools_1.handleX402Fetch)(fetchArgs.url, {
+                        method: fetchArgs.method,
+                        headers: fetchArgs.headers,
+                        body: fetchArgs.body,
+                    }, fetchArgs.agent_key);
+                    break;
+                }
+                default:
+                    throw new Error(`Unknown tool: ${name}`);
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unknown error";
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: message }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+// ============================================
+// Run MCP Server
+// ============================================
+/**
+ * Run the MCP server - exported for programmatic use
+ * Validates CLOAKED_AGENT_KEY and starts the server
+ */
+async function runMcpServer() {
+    // Validate required environment variable
+    const agentKey = process.env.CLOAKED_AGENT_KEY;
+    if (!agentKey) {
+        throw new Error("CLOAKED_AGENT_KEY environment variable is required");
+    }
+    const server = createServer();
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error("Cloaked MCP server started");
+}
+// Auto-run when executed directly (via SDK's bin entry)
+const isMainModule = typeof require !== 'undefined' && require.main === module;
+if (isMainModule) {
+    if (!process.env.CLOAKED_AGENT_KEY) {
+        console.error("Error: CLOAKED_AGENT_KEY environment variable is required");
+        console.error("");
+        console.error("Usage:");
+        console.error("  CLOAKED_AGENT_KEY=<your-agent-key> npx cloaked-mcp");
+        console.error("");
+        console.error("Environment variables:");
+        console.error("  CLOAKED_AGENT_KEY    (required) Base58 encoded Cloaked Agent private key");
+        console.error("  CLOAKED_BACKEND_URL  (optional) Backend URL, default: http://localhost:3645");
+        console.error("  SOLANA_RPC_URL       (optional) Solana RPC URL, default: https://api.devnet.solana.com");
+        process.exit(1);
+    }
+    runMcpServer().catch((error) => {
+        console.error("Fatal error:", error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

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

package/dist/mcp/tools.d.ts

@@ -0,0 +1,26 @@
+import { BalanceResponse, StatusResponse, PayResponse, X402FetchResponse } from "./types";
+/**
+ * Tool handler for cloak_balance
+ * Returns enhanced balance info with constraints
+ */
+export declare function handleBalance(agentKey?: string): Promise<BalanceResponse>;
+/**
+ * Tool handler for cloak_status
+ * Returns detailed agent status with health indicator
+ */
+export declare function handleStatus(agentKey?: string): Promise<StatusResponse>;
+/**
+ * Tool handler for cloak_pay
+ * Pays to a destination address for x402 services
+ */
+export declare function handlePay(destination: string, amountSol: number, agentKey?: string): Promise<PayResponse>;
+/**
+ * Tool handler for cloak_x402_fetch
+ * Fetches x402-protected resources, automatically handling payment
+ */
+export declare function handleX402Fetch(url: string, options?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+}, agentKey?: string): Promise<X402FetchResponse>;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,eAAe,EACf,cAAc,EACd,WAAW,EACX,iBAAiB,EAElB,MAAM,SAAS,CAAC;AAsBjB;;;GAGG;AACH,wBAAsB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAmC/E;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA0C7E;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,CAAC,CAgCtB;AA0CD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,EACD,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC,CA+I5B"}