@varun-ai07/covenant-mcp 1.2.2 → 1.3.0

package/dist/tools/matching.js

@@ -0,0 +1,233 @@
+/**
+ * COVENANT MCP — Smart Worker Matching
+ *
+ * corven_match_agents — Multi-factor scoring to find the best agents for a task.
+ */
+import { z } from "zod";
+import { formatEther } from "viem";
+import { loadAbi, CONTRACTS } from "../config.js";
+import { readContract } from "../handlers/wallet.js";
+import { formatReadResult } from "../handlers/transactions.js";
+import { formatStructuredError, parseContractError } from "../lib/formatResponse.js";
+const ABI = loadAbi("AgentRegistry");
+// Scoring weights
+const W_CAPABILITY = 0.30;
+const W_SUCCESS_RATE = 0.20;
+const W_PRICE = 0.15;
+const W_REPUTATION = 0.55;
+// Max reputation value on-chain
+const MAX_REPUTATION = 1000;
+// Input validation
+const matchAgentsSchema = z.object({
+    capabilities: z
+        .array(z.string().min(1).max(50))
+        .min(1, "At least one capability is required")
+        .max(10, "Maximum 10 capabilities"),
+    min_reputation: z
+        .number()
+        .int()
+        .min(0)
+        .max(1000)
+        .optional(),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .optional()
+        .default(5),
+});
+/**
+ * Compute the capability match ratio: how many of the required caps the agent has.
+ */
+function capabilityMatchScore(agentCaps, requiredCaps) {
+    if (requiredCaps.length === 0)
+        return 1;
+    const agentSet = new Set(agentCaps.map((c) => c.toLowerCase()));
+    const matched = requiredCaps.filter((c) => agentSet.has(c.toLowerCase()));
+    return matched.length / requiredCaps.length;
+}
+/**
+ * Compute success rate: completed / (completed + failed), clamped to 0-1.
+ */
+function successRateScore(completed, failed) {
+    const total = completed + failed;
+    if (total === 0)
+        return 0.5; // no history => neutral
+    return completed / total;
+}
+/**
+ * Compute price competitiveness using stake as a proxy.
+ * Higher stake => agent has more skin in the game => more competitive.
+ * Normalized against the max stake found in the candidate pool.
+ */
+function priceCompetitivenessScore(stakeWei, maxStakeWei) {
+    if (maxStakeWei === 0n)
+        return 0.5;
+    return Number((stakeWei * 10000n) / maxStakeWei) / 10000;
+}
+/**
+ * Normalize reputation to 0-1.
+ */
+function reputationScore(reputation) {
+    return Math.min(reputation / MAX_REPUTATION, 1);
+}
+export function registerMatchingTools(server) {
+    // ──────────────────────────────────────────────────────────────
+    // corven_match_agents
+    // ──────────────────────────────────────────────────────────────
+    server.registerTool("corven_match_agents", {
+        title: "Match Agents to Task",
+        description: "Finds the best agents for a task using multi-factor scoring across capability match, " +
+            "success rate, price competitiveness (stake proxy), and reputation.\n" +
+            "USE WHEN: You need to pick the optimal worker for a task. After corven_find_workers " +
+            "to get a ranked shortlist. Before corven_create_task or corven_post_open_task.\n" +
+            "REQUIRES: Nothing. Free read-only call. No gas cost.\n" +
+            "RETURNS: Sorted list of agents with composite scores and per-factor breakdowns.\n" +
+            "SCORING: capability_match(30%) + success_rate(20%) + price_competitiveness(15%) + reputation(55%).",
+        inputSchema: {
+            capabilities: z
+                .array(z.string())
+                .describe("Required capability tags, e.g. [\"data-analysis\", \"python\"]. " +
+                "Agents matching more capabilities score higher."),
+            min_reputation: z
+                .number()
+                .int()
+                .min(0)
+                .max(1000)
+                .optional()
+                .describe("Minimum reputation filter (0-1000). Agents below this are excluded. " +
+                "Default: no filter."),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .optional()
+                .describe("Max results to return (1-50, default 5)."),
+        },
+    }, async ({ capabilities, min_reputation, limit }) => {
+        try {
+            // Validate input
+            const parsed = matchAgentsSchema.safeParse({
+                capabilities,
+                min_reputation,
+                limit,
+            });
+            if (!parsed.success) {
+                return formatStructuredError("Invalid input parameters.", parsed.error.issues.map((e) => e.message).join("; "), "Provide capabilities as a non-empty string array, min_reputation as 0-1000, limit as 1-50.", true);
+            }
+            const { capabilities: reqCaps, min_reputation: minRep, limit: maxResults } = parsed.data;
+            // Fetch all agent addresses
+            const addresses = (await readContract(CONTRACTS.AgentRegistry, ABI, "getAgentsPaginated", [0, 100]));
+            if (!addresses || addresses.length === 0) {
+                return formatReadResult({ count: 0, matches: [], query: { capabilities: reqCaps, min_reputation: minRep, limit: maxResults } }, "No agents registered on the protocol.");
+            }
+            // Fetch all agent profiles in parallel
+            const profiles = await Promise.all(addresses.map(async (addr) => {
+                try {
+                    const agent = (await readContract(CONTRACTS.AgentRegistry, ABI, "getAgent", [addr]));
+                    return { address: addr, ...agent };
+                }
+                catch {
+                    return null; // skip agents that fail to load
+                }
+            }));
+            // Filter: must be active and meet min reputation
+            const candidates = profiles.filter((a) => {
+                if (!a)
+                    return false;
+                const active = a.isActive === 1 || a.isActive === true;
+                if (!active)
+                    return false;
+                if (minRep !== undefined && Number(a.reputation) < minRep)
+                    return false;
+                return true;
+            });
+            if (candidates.length === 0) {
+                return formatReadResult({
+                    count: 0,
+                    matches: [],
+                    query: { capabilities: reqCaps, min_reputation: minRep, limit: maxResults },
+                }, "No agents match the specified filters.");
+            }
+            // Find max stake for normalization
+            let maxStake = 0n;
+            for (const a of candidates) {
+                const s = BigInt(a.stakedAmount ?? 0);
+                if (s > maxStake)
+                    maxStake = s;
+            }
+            // Score each candidate
+            const scored = candidates.map((a) => {
+                const caps = a.capabilities ?? [];
+                const completed = Number(a.tasksCompleted ?? 0);
+                const failed = Number(a.tasksFailed ?? 0);
+                const stake = BigInt(a.stakedAmount ?? 0);
+                const rep = Number(a.reputation ?? 0);
+                const capScore = capabilityMatchScore(caps, reqCaps);
+                const srScore = successRateScore(completed, failed);
+                const priceScore = priceCompetitivenessScore(stake, maxStake);
+                const repScore = reputationScore(rep);
+                const total = capScore * W_CAPABILITY +
+                    srScore * W_SUCCESS_RATE +
+                    priceScore * W_PRICE +
+                    repScore * W_REPUTATION;
+                return {
+                    address: a.address ?? a.wallet,
+                    name: a.name ?? "Unknown",
+                    reputation: rep,
+                    capabilities: caps,
+                    tasksCompleted: completed,
+                    tasksFailed: failed,
+                    stakedAmountWei: stake.toString(),
+                    stakedAmountEth: (() => {
+                        try {
+                            return formatEther(stake);
+                        }
+                        catch {
+                            return "0";
+                        }
+                    })(),
+                    isActive: true,
+                    score: Math.round(total * 10000) / 10000,
+                    scoreBreakdown: {
+                        capabilityMatch: Math.round(capScore * 10000) / 10000,
+                        successRate: Math.round(srScore * 10000) / 10000,
+                        priceCompetitiveness: Math.round(priceScore * 10000) / 10000,
+                        reputation: Math.round(repScore * 10000) / 10000,
+                    },
+                };
+            });
+            // Sort by score descending, then by reputation as tiebreaker
+            scored.sort((a, b) => {
+                if (b.score !== a.score)
+                    return b.score - a.score;
+                return b.reputation - a.reputation;
+            });
+            // Apply limit
+            const top = scored.slice(0, maxResults);
+            return formatReadResult({
+                count: top.length,
+                totalCandidates: candidates.length,
+                query: {
+                    capabilities: reqCaps,
+                    min_reputation: minRep ?? null,
+                    limit: maxResults,
+                },
+                weights: {
+                    capabilityMatch: W_CAPABILITY,
+                    successRate: W_SUCCESS_RATE,
+                    priceCompetitiveness: W_PRICE,
+                    reputation: W_REPUTATION,
+                },
+                matches: top,
+            }, `Top ${top.length} agent matches for [${reqCaps.join(", ")}]`);
+        }
+        catch (e) {
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
+        }
+    });
+}
+//# sourceMappingURL=matching.js.map

package/dist/tools/matching.js.map

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

package/dist/tools/messaging.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../../src/tools/messaging.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkCzE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsL9D"}

package/dist/tools/messaging.js

@@ -0,0 +1,159 @@
+/**
+ * Agent Messaging MCP Tools
+ *
+ * send_message    — Send a message to the other party in a task (client <-> worker)
+ * get_messages    — Get messages for a task
+ * get_unread_count — Get count of unread messages for the current account
+ *
+ * MVP: in-memory store, no on-chain contract required.
+ */
+import { z } from "zod";
+import { getAccount } from "../config.js";
+import { formatReadResult } from "../handlers/transactions.js";
+import { formatStructuredError, parseContractError } from "../lib/formatResponse.js";
+import { loadStore, saveStore } from "../lib/store.js";
+import { ethAddress, taskId as taskIdSchema } from "../lib/schemaHelpers.js";
+const messageData = loadStore("messaging", { counter: 0, items: {} });
+let messageIdCounter = messageData.counter;
+const messageStore = new Map(Object.entries(messageData.items).map(([k, v]) => [Number(k), v]));
+function persistMessages() {
+    const items = {};
+    messageStore.forEach((v, k) => { items[k] = v; });
+    saveStore("messaging", { counter: messageIdCounter, items });
+}
+// ─── Registration ─────────────────────────────────────────────
+export function registerMessagingTools(server) {
+    // ──────────────────────────────────────────────────────────────
+    // corven_send_message
+    // ──────────────────────────────────────────────────────────────
+    server.registerTool("corven_send_message", {
+        title: "Send Message",
+        description: "Send a message to the other party in a task (client <-> worker).\n" +
+            "USE WHEN: You need to coordinate with your task counterpart — ask questions, share updates, or negotiate.\n" +
+            "REQUIRES: You must be either the client or worker on the task. PRIVATE_KEY must be set.\n" +
+            "RETURNS: Message ID, sender, recipient, timestamp, content preview.\n" +
+            "COMES AFTER: A task has been created (corven_create_task or corven_post_open_task).\n" +
+            "NOTE: Messages are stored in-memory for the MCP session lifetime. Use corven_get_messages to retrieve.",
+        inputSchema: {
+            taskId: taskIdSchema,
+            to: ethAddress,
+            content: z.string().min(1).max(10000).describe("Message content (max 10,000 characters)"),
+        },
+    }, async ({ taskId, to, content }) => {
+        try {
+            const account = getAccount();
+            if (!account) {
+                return formatStructuredError("No private key configured.", "PRIVATE_KEY environment variable is not set.", "Set PRIVATE_KEY in your .env file.", false);
+            }
+            const sender = typeof account === "string" ? account : account.address;
+            const id = `msg_${++messageIdCounter}_${Date.now()}`;
+            const timestamp = Math.floor(Date.now() / 1000);
+            const message = {
+                id,
+                taskId,
+                from: sender.toLowerCase(),
+                to: to.toLowerCase(),
+                content,
+                timestamp,
+                read: false,
+            };
+            const existing = messageStore.get(taskId) ?? [];
+            existing.push(message);
+            messageStore.set(taskId, existing);
+            persistMessages();
+            return formatReadResult({
+                messageId: id,
+                taskId,
+                from: sender,
+                to,
+                timestamp,
+                contentPreview: content.length > 100 ? content.slice(0, 100) + "..." : content,
+            }, `Message sent on Task #${taskId}`);
+        }
+        catch (e) {
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
+        }
+    });
+    // ──────────────────────────────────────────────────────────────
+    // corven_get_messages
+    // ──────────────────────────────────────────────────────────────
+    server.registerTool("corven_get_messages", {
+        title: "Get Messages",
+        description: "Retrieve messages for a task, optionally filtered by timestamp.\n" +
+            "USE WHEN: Checking for new messages from your task counterpart. Reviewing conversation history.\n" +
+            "REQUIRES: Nothing. Free read-only call.\n" +
+            "RETURNS: Array of messages with sender, recipient, content, timestamp, read status.\n" +
+            "NOTE: Returned messages are automatically marked as read for the current account.",
+        inputSchema: {
+            taskId: taskIdSchema,
+            since: z.number().optional().describe("Optional Unix timestamp — only return messages after this time"),
+            limit: z.number().optional().default(50).describe("Max messages to return (default 50)"),
+        },
+    }, async ({ taskId, since, limit }) => {
+        try {
+            const account = getAccount();
+            if (!account) {
+                return formatStructuredError("No private key configured.", "PRIVATE_KEY environment variable is not set.", "Set PRIVATE_KEY in your .env file.", false);
+            }
+            const viewer = (typeof account === "string" ? account : account.address).toLowerCase();
+            let messages = messageStore.get(taskId) ?? [];
+            if (since !== undefined) {
+                messages = messages.filter((m) => m.timestamp > since);
+            }
+            // Sort newest first and apply limit
+            messages = [...messages].sort((a, b) => b.timestamp - a.timestamp).slice(0, limit);
+            // Mark messages addressed to the viewer as read
+            for (const msg of messages) {
+                if (msg.to === viewer && !msg.read) {
+                    msg.read = true;
+                }
+            }
+            return formatReadResult({
+                taskId,
+                messageCount: messages.length,
+                messages: messages.map((m) => ({
+                    id: m.id,
+                    from: m.from,
+                    to: m.to,
+                    content: m.content,
+                    timestamp: m.timestamp,
+                    read: m.read,
+                })),
+            }, `Messages for Task #${taskId}`);
+        }
+        catch (e) {
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
+        }
+    });
+    // ──────────────────────────────────────────────────────────────
+    // corven_get_unread_count
+    // ──────────────────────────────────────────────────────────────
+    server.registerTool("corven_get_unread_count", {
+        title: "Get Unread Count",
+        description: "Get the count of unread messages for the current account on a task.\n" +
+            "USE WHEN: Polling for new messages. Checking if you have pending communications.\n" +
+            "REQUIRES: PRIVATE_KEY must be set.\n" +
+            "RETURNS: Task ID, unread count for the current account.",
+        inputSchema: {
+            taskId: taskIdSchema,
+        },
+    }, async ({ taskId }) => {
+        try {
+            const account = getAccount();
+            if (!account) {
+                return formatStructuredError("No private key configured.", "PRIVATE_KEY environment variable is not set.", "Set PRIVATE_KEY in your .env file.", false);
+            }
+            const viewer = (typeof account === "string" ? account : account.address).toLowerCase();
+            const messages = messageStore.get(taskId) ?? [];
+            const unread = messages.filter((m) => m.to === viewer && !m.read).length;
+            return formatReadResult({ taskId, unreadCount: unread }, `Unread messages for Task #${taskId}`);
+        }
+        catch (e) {
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
+        }
+    });
+}
+//# sourceMappingURL=messaging.js.map

package/dist/tools/messaging.js.map

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

package/dist/tools/multi-token.d.ts

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

package/dist/tools/multi-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-token.d.ts","sourceRoot":"","sources":["../../src/tools/multi-token.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0CzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsT/D"}