@varun-ai07/covenant-mcp 1.2.3 → 1.3.2

package/dist/tools/receipts.js

@@ -10,9 +10,13 @@ import { isAddress } from "viem";
 import { loadAbi, CONTRACTS, getAccount } from "../config.js";
 import { executeOrPrepare, readContract } from "../handlers/wallet.js";
 import { formatTxResult, formatReadResult, formatError } from "../handlers/transactions.js";
+import { parseContractError, formatStructuredError } from "../lib/formatResponse.js";
+import { ethAddress } from "../lib/schemaHelpers.js";
 import { RECEIPT_TYPE } from "../types.js";
 import { stringToBytes32, isBytes32 } from "../utils.js";
-const ABI = loadAbi("ReceiptVerifier");
+// V2 ReceiptVerifier doesn't have getReceiptsByAgent - use V1 ABI for that function
+const V1_ABI = loadAbi("ReceiptVerifier");
+const V2_ABI = loadAbi("ReceiptVerifier");
 // Input validation schemas
 const getAddressSchema = z.object({
     address: z.string().refine(isAddress, { message: "Invalid Ethereum address" })
@@ -32,10 +36,15 @@ export function registerReceiptTools(server) {
     // ──────────────────────────────────────────────────────────────
     server.registerTool("corven_get_receipts", {
         title: "Get All Receipts for Address",
-        description: "Fetch all ERC-8004 attestation receipts for an address. " +
-            "Returns receipt details including issuer, counterparty, type, and validity.",
+        description: "Fetch all ERC-8004 attestation receipts for an address. Returns receipt details including issuer, counterparty, type, and validity.\n" +
+            "USE WHEN: You want to see all attestation receipts issued for a specific agent or address.\n" +
+            "REQUIRES: The address must exist on-chain (may have zero receipts).\n" +
+            "RETURNS: Array of receipt objects with issuer, counterparty, interaction type, data hash, and validity status.\n" +
+            "COMES AFTER: corven_create_receipt issued receipts for this address.\n" +
+            "COMES BEFORE: corven_get_receipt (inspect a specific receipt by ID).\n" +
+            "NOTE: Returns all receipts where the address is either issuer or counterparty.",
         inputSchema: {
-            address: z.string().describe("Ethereum address to look up receipts for"),
+            address: ethAddress,
         },
     }, async ({ address }) => {
         try {
@@ -43,43 +52,27 @@ export function registerReceiptTools(server) {
             if (!validationResult.success) {
                 return formatError(new Error(`Invalid input: ${validationResult.error.issues.map((e) => e.message).join(", ")}`));
             }
-            const data = await readContract(CONTRACTS.ReceiptVerifier, ABI, "getReceiptsByAgent", [validationResult.data.address]);
+            const data = await readContract(CONTRACTS.ReceiptVerifier, V1_ABI, "getReceiptsByAgent", [validationResult.data.address]);
             return formatReadResult({ address, receipts: data }, `Receipts for ${address}`);
         }
         catch (e) {
-            return formatError(e);
-        }
-    });
-    // ──────────────────────────────────────────────────────────────
-    // get_receipt_count
-    // ──────────────────────────────────────────────────────────────
-    server.registerTool("corven_get_receipt_count", {
-        title: "Get Receipt Count for Address",
-        description: "Get the total number of ERC-8004 receipts issued for an agent address. " +
-            "Use this to check receipt volume before querying individual receipts.",
-        inputSchema: {
-            address: z.string().describe("Agent's Ethereum address"),
-        },
-    }, async ({ address }) => {
-        try {
-            const validationResult = getAddressSchema.safeParse({ address });
-            if (!validationResult.success) {
-                return formatError(new Error(`Invalid input: ${validationResult.error.issues.map((e) => e.message).join(", ")}`));
-            }
-            const count = await readContract(CONTRACTS.ReceiptVerifier, ABI, "getAgentReceiptCount", [validationResult.data.address]);
-            return formatReadResult({ address, receiptCount: Number(count) }, `Receipt count for ${address}`);
-        }
-        catch (e) {
-            return formatError(e);
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
         }
     });
+    // get_receipt_count is merged into get_receipts (returns count alongside receipts)
     // ──────────────────────────────────────────────────────────────
     // get_receipt (was verify_receipt)
     // ──────────────────────────────────────────────────────────────
     server.registerTool("corven_get_receipt", {
         title: "Get Receipt by ID",
-        description: "Retrieve a specific ERC-8004 receipt by its bytes32 ID. " +
-            "Returns the receipt details including issuer, counterparty, type, and validity.",
+        description: "Retrieve a specific ERC-8004 receipt by its bytes32 ID. Returns the receipt details including issuer, counterparty, type, and validity.\n" +
+            "USE WHEN: You know a receipt ID and want to inspect its full details and on-chain validity.\n" +
+            "REQUIRES: The receipt ID must be a valid bytes32 hex string.\n" +
+            "RETURNS: Receipt details including issuer, counterparty, interaction type, data hash, validity, and human-readable type label.\n" +
+            "COMES AFTER: corven_create_receipt or corven_get_receipts provided the receipt ID.\n" +
+            "COMES BEFORE: Use the receipt data to verify agent credentials or audit history.\n" +
+            "NOTE: Accepts both raw bytes32 hex IDs and string-to-bytes32 converted IDs.",
         inputSchema: {
             receiptId: z.string().describe("Receipt ID as bytes32 hex string (0x...64 hex chars)"),
         },
@@ -99,7 +92,7 @@ export function registerReceiptTools(server) {
                 // Try to convert string to bytes32
                 receiptIdBytes32 = stringToBytes32(receiptId);
             }
-            const data = await readContract(CONTRACTS.ReceiptVerifier, ABI, "getReceipt", [receiptIdBytes32]);
+            const data = await readContract(CONTRACTS.ReceiptVerifier, V2_ABI, "getReceipt", [receiptIdBytes32]);
             const enriched = {
                 ...data,
                 typeLabel: RECEIPT_TYPE[data.interactionType] ??
@@ -108,7 +101,8 @@ export function registerReceiptTools(server) {
             return formatReadResult(enriched, `Receipt ${receiptId}`);
         }
         catch (e) {
-            return formatError(e);
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
         }
     });
     // ──────────────────────────────────────────────────────────────
@@ -116,11 +110,16 @@ export function registerReceiptTools(server) {
     // ──────────────────────────────────────────────────────────────
     server.registerTool("corven_create_receipt", {
         title: "Create Receipt",
-        description: "Issue an ERC-8004 attestation receipt for a completed interaction. " +
-            "Only authorized issuers can create receipts.",
+        description: "Issue an ERC-8004 attestation receipt for a completed interaction. Only authorized issuers can create receipts.\n" +
+            "USE WHEN: You want to create a portable on-chain attestation that proves a specific interaction occurred.\n" +
+            "REQUIRES: You must be an authorized issuer. Both issuer and counterparty addresses must be valid.\n" +
+            "RETURNS: Transaction hash. The receipt ID (bytes32) is emitted in the event logs.\n" +
+            "COMES AFTER: A verifiable interaction occurred (task completion, agent verification, capability proof, etc.).\n" +
+            "COMES BEFORE: corven_get_receipt or corven_get_receipts to retrieve the receipt.\n" +
+            "NOTE: interactionType values: 0=TaskCompleted, 1=AgentVerified, 2=CapabilityProven, 3=ReputationVerified, 4=DisputeResolved, 5=InsuranceClaimed.",
         inputSchema: {
-            issuer: z.string().describe("Issuer's Ethereum address"),
-            counterparty: z.string().describe("Counterparty's Ethereum address"),
+            issuer: ethAddress,
+            counterparty: ethAddress,
             interactionType: z.union([z.number(), z.string()]).describe("Receipt type (0=TaskCompleted, 1=AgentVerified, etc.)"),
             dataHash: z.string().describe("Hash of the receipt data (will be converted to bytes32)"),
         },
@@ -136,11 +135,12 @@ export function registerReceiptTools(server) {
             }
             // Convert dataHash to bytes32
             const dataHashBytes32 = stringToBytes32(dataHash);
-            const result = await executeOrPrepare(CONTRACTS.ReceiptVerifier, ABI, "createReceipt", [issuer, counterparty, String(interactionType), dataHashBytes32]);
+            const result = await executeOrPrepare(CONTRACTS.ReceiptVerifier, V2_ABI, "createReceipt", [issuer, counterparty, String(interactionType), dataHashBytes32]);
             return formatTxResult(result);
         }
         catch (e) {
-            return formatError(e);
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
         }
     });
 }

package/dist/tools/receipts.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuBzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8P1D"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuBzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2V1D"}

package/dist/tools/registry.js

@@ -4,12 +4,17 @@
  * register_agent  — Register a new agent on-chain
  * get_agent       — Look up an agent's profile by address
  * find_workers    — Find agents by capability string
+ * add_stake       — Increase agent stake
+ * deactivate_agent — Deactivate and withdraw stake
+ * get_all_agents  — List all registered agents
  */
 import { z } from "zod";
 import { parseEther, isAddress } from "viem";
 import { loadAbi, CONTRACTS, getAccount } from "../config.js";
 import { executeOrPrepare, readContract } from "../handlers/wallet.js";
-import { formatTxResult, formatReadResult, formatError } from "../handlers/transactions.js";
+import { formatTxResult, formatReadResult } from "../handlers/transactions.js";
+import { formatSuccess, formatStructuredError, parseContractError } from "../lib/formatResponse.js";
+import { ethAddress, ethAmount, ethStake, agentName, capabilities } from "../lib/schemaHelpers.js";
 const ABI = loadAbi("AgentRegistry");
 // Input validation schemas
 const registerAgentSchema = z.object({
@@ -33,39 +38,52 @@ export function registerAgentTools(server) {
     // ──────────────────────────────────────────────────────────────
     server.registerTool("corven_register_agent", {
         title: "Register Agent",
-        description: "Register a new AI agent on the AgentRegistry contract. " +
-            "Requires a name, array of capabilities, and a minimum stake of 0.001 ETH.",
+        description: "Creates a permanent on-chain identity for an AI agent on COVENANT.\n" +
+            "USE WHEN: First-time setup for any wallet that wants to post tasks, receive tasks, or earn ETH. Call exactly once per wallet address.\n" +
+            "REQUIRES: Wallet with at least 0.001 ETH for stake deposit plus ~0.0002 ETH gas.\n" +
+            "RETURNS: Agent DID, reputation score (starts at 500/1000), txHash, Basescan URL, and next steps.\n" +
+            "COMES BEFORE: All other tools. Nothing works without this.\n" +
+            "NOTE: Already registered? Use corven_get_agent instead. Registration is permanent.",
         inputSchema: {
-            name: z.string().describe("Agent display name"),
-            capabilities: z
-                .array(z.string())
-                .describe('Capability tags, e.g. ["data-analysis", "code-review"]'),
-            stake: z
-                .string()
-                .optional()
-                .describe("Stake amount in ETH (default 0.001)"),
+            name: agentName,
+            capabilities: capabilities,
+            stake: ethStake,
         },
     }, async ({ name, capabilities, stake }) => {
         try {
             // Validate input
             const validationResult = registerAgentSchema.safeParse({ name, capabilities, stake });
             if (!validationResult.success) {
-                return formatError(new Error(`Invalid input: ${validationResult.error.issues.map((e) => e.message).join(", ")}`));
+                return formatStructuredError("Invalid input parameters.", validationResult.error.issues.map((e) => e.message).join(", "), "Check name format (alphanumeric, hyphens, underscores), capabilities (1-10 items), and stake (0.001-100 ETH decimal string).", true);
             }
-            // Use validated values
             const validatedName = validationResult.data.name;
             const validatedCapabilities = validationResult.data.capabilities;
             const validatedStake = validationResult.data.stake;
             const account = getAccount();
             if (!account) {
-                return formatError(new Error("No private key configured — cannot send transactions"));
+                return formatStructuredError("No private key configured.", "PRIVATE_KEY environment variable is not set.", "Set PRIVATE_KEY in your .env file to a valid Ethereum private key with ETH on Base Sepolia.", false);
             }
             const stakeAmount = parseEther(validatedStake);
             const result = await executeOrPrepare(CONTRACTS.AgentRegistry, ABI, "register", [validatedName, validatedCapabilities], stakeAmount);
+            if (result.status === "success") {
+                return formatSuccess(`Agent '${validatedName}' registered on COVENANT with reputation 500/1000 and ${validatedCapabilities.length} capabilities.`, {
+                    agentName: validatedName,
+                    walletAddress: account,
+                    reputation: 500,
+                    capabilities: validatedCapabilities,
+                    stakeDeposited: `${validatedStake} ETH`,
+                    isActive: true,
+                }, result.txHash, [
+                    "Registration complete. To find tasks as a worker: corven_get_worker_tasks.",
+                    "To post a task as a client: corven_create_task or corven_post_open_task.",
+                    "To see your full profile: corven_get_agent with your wallet address.",
+                ]);
+            }
             return formatTxResult(result);
         }
         catch (e) {
-            return formatError(e);
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
         }
     });
     // ──────────────────────────────────────────────────────────────
@@ -73,25 +91,27 @@ export function registerAgentTools(server) {
     // ──────────────────────────────────────────────────────────────
     server.registerTool("corven_get_agent", {
         title: "Get Agent Profile",
-        description: "Retrieve the full on-chain profile for a registered agent by address. " +
-            "Returns name, DID, reputation, staked amount, capabilities, task counts.",
+        description: "Fetches the complete on-chain profile for any registered agent.\n" +
+            "USE WHEN: Checking if an agent is registered before hiring them. Verifying your own reputation. Researching a potential worker.\n" +
+            "REQUIRES: Nothing. Free read-only call. No gas cost.\n" +
+            "RETURNS: Name, DID, reputation (0-1000), capabilities, stake amount, tasks completed, tasks failed, active status.\n" +
+            "COMES AFTER: corven_find_workers when you want full details on a candidate.",
         inputSchema: {
-            address: z.string().describe("Agent's Ethereum address (0x...)"),
+            address: ethAddress,
         },
     }, async ({ address }) => {
         try {
-            // Validate input
             const validationResult = getAgentSchema.safeParse({ address });
             if (!validationResult.success) {
-                return formatError(new Error(`Invalid input: ${validationResult.error.issues.map((e) => e.message).join(", ")}`));
+                return formatStructuredError("Invalid Ethereum address.", `Received '${address}' — must be a full 42-character 0x address.`, "Pass the full address starting with 0x. Example: 0x715f3b64189EcA51a57567962Cd2278dc7a5e92C", false);
             }
-            // Use validated address
             const validatedAddress = validationResult.data.address;
             const data = await readContract(CONTRACTS.AgentRegistry, ABI, "getAgent", [validatedAddress]);
             return formatReadResult(data, `Agent profile for ${address}`);
         }
         catch (e) {
-            return formatError(e);
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
         }
     });
     // ──────────────────────────────────────────────────────────────
@@ -99,37 +119,43 @@ export function registerAgentTools(server) {
     // ──────────────────────────────────────────────────────────────
     server.registerTool("corven_find_workers", {
         title: "Find Workers by Capability",
-        description: "Discover agents that have a specific capability tag. " +
-            "Returns addresses and profiles sorted by reputation (highest first).",
+        description: "Searches the registry for active agents with a specific capability. Returns them sorted by reputation highest first.\n" +
+            "USE WHEN: Before creating any task. This is how you discover who can do the work.\n" +
+            "REQUIRES: Nothing. Free read-only call. No gas cost.\n" +
+            "RETURNS: Array of agent profiles with address, name, reputation score, success rate, active task count.\n" +
+            "COMES BEFORE: corven_create_task or corven_post_open_task. Use the returned address as the worker parameter.\n" +
+            "NOTE: The first result has the highest reputation. For high-value tasks, always use a high-reputation worker.",
         inputSchema: {
             capability: z
                 .string()
-                .describe('Capability to search for, e.g. "data-analysis"'),
+                .describe('The capability tag to search for. ' +
+                'Valid values: "data-analysis", "code-review", "content-writing", ' +
+                '"financial-analysis", "research", "translation", "testing", ' +
+                '"security-audit", "documentation", "smart-contract", "python", ' +
+                '"visualization", "api-integration", "ml-training", "design". ' +
+                'Returns all active agents with this capability sorted by reputation.'),
         },
     }, async ({ capability }) => {
         try {
-            // Validate input
             const validationResult = findWorkersSchema.safeParse({ capability });
             if (!validationResult.success) {
-                return formatError(new Error(`Invalid input: ${validationResult.error.issues.map((e) => e.message).join(", ")}`));
+                return formatStructuredError("Invalid capability string.", `Received '${capability}' — must be 1-50 characters.`, "Pass a valid capability tag like 'data-analysis', 'code-review', or 'research'.", true);
             }
-            // Use validated capability
             const validatedCapability = validationResult.data.capability;
             const addresses = (await readContract(CONTRACTS.AgentRegistry, ABI, "getAgentsByCapability", [capability]));
             if (addresses.length === 0) {
                 return formatReadResult({ capability, count: 0, workers: [] }, `No workers found for "${capability}"`);
             }
-            // Fetch full profiles
             const workers = await Promise.all(addresses.map(async (addr) => {
                 const profile = await readContract(CONTRACTS.AgentRegistry, ABI, "getAgent", [addr]);
                 return { address: addr, ...profile };
             }));
-            // Sort by reputation descending
             workers.sort((a, b) => Number(b.reputation ?? 0) - Number(a.reputation ?? 0));
             return formatReadResult({ capability, count: workers.length, workers }, `Workers with capability "${capability}"`);
         }
         catch (e) {
-            return formatError(e);
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
         }
     });
     // ──────────────────────────────────────────────────────────────
@@ -137,23 +163,32 @@ export function registerAgentTools(server) {
     // ──────────────────────────────────────────────────────────────
     server.registerTool("corven_add_stake", {
         title: "Add Stake",
-        description: "Add additional ETH stake to an existing agent registration. " +
-            "Higher stake increases trust and priority in the network.",
+        description: "Adds additional ETH stake to your existing agent registration. Higher stake increases trust and priority.\n" +
+            "USE WHEN: Boosting your agent's reputation weight. Preparing for high-value tasks that favor staked agents.\n" +
+            "REQUIRES: You must be a registered agent. Wallet needs the stake amount plus ~0.0002 ETH gas.\n" +
+            "RETURNS: Amount added, total stake, txHash, Basescan link.\n" +
+            "COMES AFTER: corven_register_agent (must be registered first).\n" +
+            "COMES BEFORE: Higher stake improves ranking in corven_find_workers results.\n" +
+            "NOTE: Stake is withdrawable via corven_deactivate_agent when you leave the protocol.",
         inputSchema: {
-            amount: z.string().describe("Amount of ETH to add as stake, e.g. '0.01'"),
+            amount: ethAmount,
         },
     }, async ({ amount }) => {
         try {
             const account = getAccount();
             if (!account) {
-                return formatError(new Error("No private key configured — cannot send transactions"));
+                return formatStructuredError("No private key configured.", "PRIVATE_KEY environment variable is not set.", "Set PRIVATE_KEY in your .env file.", false);
             }
             const stakeAmount = parseEther(amount);
             const result = await executeOrPrepare(CONTRACTS.AgentRegistry, ABI, "addStake", [], stakeAmount);
+            if (result.status === "success") {
+                return formatSuccess(`Added ${amount} ETH to stake.`, { amount: `${amount} ETH`, txHash: result.txHash }, result.txHash, ["Your increased stake will be reflected in your agent profile on the next query."]);
+            }
             return formatTxResult(result);
         }
         catch (e) {
-            return formatError(e);
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
         }
     });
     // ──────────────────────────────────────────────────────────────
@@ -161,20 +196,28 @@ export function registerAgentTools(server) {
     // ──────────────────────────────────────────────────────────────
     server.registerTool("corven_deactivate_agent", {
         title: "Deactivate Agent",
-        description: "Deactivate your agent registration and withdraw staked ETH. " +
-            "This action is irreversible — your agent will no longer be discoverable.",
+        description: "Deactivates your agent registration and withdraws all staked ETH to your wallet.\n" +
+            "USE WHEN: Permanently leaving the protocol. Withdrawing your security deposit.\n" +
+            "REQUIRES: You must be a registered and active agent. No active (InProgress) tasks.\n" +
+            "RETURNS: Deactivation confirmation, wallet address that received stake, txHash.\n" +
+            "COMES AFTER: All tasks are completed or cancelled.\n" +
+            "NOTE: IRREVERSIBLE. Your agent is permanently removed from the registry. To return, use a different wallet address with corven_register_agent.",
         inputSchema: {},
     }, async () => {
         try {
             const account = getAccount();
             if (!account) {
-                return formatError(new Error("No private key configured — cannot send transactions"));
+                return formatStructuredError("No private key configured.", "PRIVATE_KEY environment variable is not set.", "Set PRIVATE_KEY in your .env file.", false);
             }
             const result = await executeOrPrepare(CONTRACTS.AgentRegistry, ABI, "deactivate", []);
+            if (result.status === "success") {
+                return formatSuccess("Agent deactivated. Staked ETH will be returned to your wallet.", { deactivated: true, wallet: account }, result.txHash, ["Registration is permanent. To re-activate, use a different wallet address."]);
+            }
             return formatTxResult(result);
         }
         catch (e) {
-            return formatError(e);
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
         }
     });
     // ──────────────────────────────────────────────────────────────
@@ -182,8 +225,11 @@ export function registerAgentTools(server) {
     // ──────────────────────────────────────────────────────────────
     server.registerTool("corven_get_all_agents", {
         title: "Get All Agents",
-        description: "Retrieve the addresses of all registered agents on the protocol. " +
-            "Use corven_get_agent to get full profiles for each address.",
+        description: "Returns the addresses of every registered agent on the protocol.\n" +
+            "USE WHEN: Building a directory. Discovering all participants. Checking protocol adoption.\n" +
+            "REQUIRES: Nothing. Free read-only call.\n" +
+            "RETURNS: Count and array of Ethereum addresses. Each needs corven_get_agent for full profile.\n" +
+            "COMES BEFORE: Call corven_get_agent on each address to get name, reputation, capabilities, and stake.",
         inputSchema: {},
     }, async () => {
         try {
@@ -191,7 +237,8 @@ export function registerAgentTools(server) {
             return formatReadResult({ count: addresses.length, agents: addresses }, "All Registered Agents");
         }
         catch (e) {
-            return formatError(e);
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
         }
     });
 }

package/dist/tools/registry.js.map

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

package/dist/tools/reputation-vc.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerReputationVCTools(server: McpServer): void;
+//# sourceMappingURL=reputation-vc.d.ts.map

package/dist/tools/reputation-vc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reputation-vc.d.ts","sourceRoot":"","sources":["../../src/tools/reputation-vc.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA6LzE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkYjE"}