dexe-mcp 0.1.0

package/dist/lib/selectors.js

@@ -0,0 +1,110 @@
+import { Interface } from "ethers";
+/**
+ * Lazy, memoized selector index over all loaded contract artifacts.
+ * Built on first query; invalidated when the underlying artifact cache is.
+ * Supports collisions — the same 4-byte selector can appear in multiple contracts.
+ */
+export class SelectorIndex {
+    artifacts;
+    built = false;
+    byFunctionSelector = new Map();
+    byEventTopic = new Map();
+    byErrorSelector = new Map();
+    lastCacheStamp = null;
+    constructor(artifacts) {
+        this.artifacts = artifacts;
+    }
+    /** Build the index (idempotent). Called automatically by find/forContract. */
+    ensureBuilt() {
+        // Tie rebuild to the artifacts list identity — invalidate() creates a new one.
+        const stamp = this.artifacts.list();
+        if (this.built && stamp === this.lastCacheStamp)
+            return;
+        this.byFunctionSelector.clear();
+        this.byEventTopic.clear();
+        this.byErrorSelector.clear();
+        for (const record of stamp) {
+            this.indexContract(record);
+        }
+        this.built = true;
+        this.lastCacheStamp = stamp;
+    }
+    indexContract(record) {
+        let iface;
+        try {
+            iface = new Interface(record.abi);
+        }
+        catch {
+            return; // tolerate malformed ABIs
+        }
+        iface.forEachFunction((fn) => {
+            const hit = {
+                contract: record.contractName,
+                sourceName: record.sourceName,
+                signature: fn.format("sighash"),
+                selector: fn.selector,
+                kind: "function",
+            };
+            push(this.byFunctionSelector, fn.selector, hit);
+        });
+        iface.forEachEvent((ev) => {
+            const hit = {
+                contract: record.contractName,
+                sourceName: record.sourceName,
+                signature: ev.format("sighash"),
+                selector: ev.topicHash,
+                kind: "event",
+            };
+            push(this.byEventTopic, ev.topicHash, hit);
+        });
+        iface.forEachError((err) => {
+            const hit = {
+                contract: record.contractName,
+                sourceName: record.sourceName,
+                signature: err.format("sighash"),
+                selector: err.selector,
+                kind: "error",
+            };
+            push(this.byErrorSelector, err.selector, hit);
+        });
+    }
+    /** Look up a selector or event topic. Accepts function selector (4B), error selector (4B), or event topic (32B). */
+    find(selector) {
+        this.ensureBuilt();
+        const s = selector.toLowerCase();
+        return [
+            ...(this.byFunctionSelector.get(s) ?? []),
+            ...(this.byErrorSelector.get(s) ?? []),
+            ...(this.byEventTopic.get(s) ?? []),
+        ];
+    }
+    /** All selectors exposed by a single contract. */
+    forContract(contractName) {
+        this.ensureBuilt();
+        const out = [];
+        for (const hits of this.byFunctionSelector.values()) {
+            for (const h of hits)
+                if (h.contract === contractName)
+                    out.push(h);
+        }
+        for (const hits of this.byEventTopic.values()) {
+            for (const h of hits)
+                if (h.contract === contractName)
+                    out.push(h);
+        }
+        for (const hits of this.byErrorSelector.values()) {
+            for (const h of hits)
+                if (h.contract === contractName)
+                    out.push(h);
+        }
+        return out;
+    }
+}
+function push(m, k, v) {
+    const existing = m.get(k);
+    if (existing)
+        existing.push(v);
+    else
+        m.set(k, [v]);
+}
+//# sourceMappingURL=selectors.js.map

package/dist/lib/selectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.js","sourceRoot":"","sources":["../../src/lib/selectors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAanC;;;;GAIG;AACH,MAAM,OAAO,aAAa;IAOK;IANrB,KAAK,GAAG,KAAK,CAAC;IACd,kBAAkB,GAAG,IAAI,GAAG,EAAyB,CAAC;IACtD,YAAY,GAAG,IAAI,GAAG,EAAyB,CAAC;IAChD,eAAe,GAAG,IAAI,GAAG,EAAyB,CAAC;IACnD,cAAc,GAAY,IAAI,CAAC;IAEvC,YAA6B,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;IAAG,CAAC;IAErD,8EAA8E;IACtE,WAAW;QACjB,+EAA+E;QAC/E,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,IAAI,CAAC,cAAc;YAAE,OAAO;QAExD,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAE7B,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;YAC3B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;IAC9B,CAAC;IAEO,aAAa,CAAC,MAAsB;QAC1C,IAAI,KAAgB,CAAC;QACrB,IAAI,CAAC;YACH,KAAK,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,GAAkD,CAAC,CAAC;QACnF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,0BAA0B;QACpC,CAAC;QAED,KAAK,CAAC,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE;YAC3B,MAAM,GAAG,GAAgB;gBACvB,QAAQ,EAAE,MAAM,CAAC,YAAY;gBAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC;gBAC/B,QAAQ,EAAE,EAAE,CAAC,QAAQ;gBACrB,IAAI,EAAE,UAAU;aACjB,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE;YACxB,MAAM,GAAG,GAAgB;gBACvB,QAAQ,EAAE,MAAM,CAAC,YAAY;gBAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC;gBAC/B,QAAQ,EAAE,EAAE,CAAC,SAAS;gBACtB,IAAI,EAAE,OAAO;aACd,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,EAAE;YACzB,MAAM,GAAG,GAAgB;gBACvB,QAAQ,EAAE,MAAM,CAAC,YAAY;gBAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC;gBAChC,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,IAAI,EAAE,OAAO;aACd,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,oHAAoH;IACpH,IAAI,CAAC,QAAgB;QACnB,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,MAAM,CAAC,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACjC,OAAO;YACL,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACzC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACtC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpC,CAAC;IACJ,CAAC;IAED,kDAAkD;IAClD,WAAW,CAAC,YAAoB;QAC9B,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,MAAM,GAAG,GAAkB,EAAE,CAAC;QAC9B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,EAAE,CAAC;YACpD,KAAK,MAAM,CAAC,IAAI,IAAI;gBAAE,IAAI,CAAC,CAAC,QAAQ,KAAK,YAAY;oBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrE,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC;YAC9C,KAAK,MAAM,CAAC,IAAI,IAAI;gBAAE,IAAI,CAAC,CAAC,QAAQ,KAAK,YAAY;oBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrE,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC;YACjD,KAAK,MAAM,CAAC,IAAI,IAAI;gBAAE,IAAI,CAAC,CAAC,QAAQ,KAAK,YAAY;oBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAED,SAAS,IAAI,CAAO,CAAc,EAAE,CAAI,EAAE,CAAI;IAC5C,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,QAAQ;QAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;;QAC1B,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACrB,CAAC"}

package/dist/rpc.d.ts

@@ -0,0 +1,14 @@
+import { JsonRpcProvider } from "ethers";
+import type { DexeConfig } from "./config.js";
+/**
+ * Lazy ethers v6 provider factory. Gov tools that need an RPC endpoint call
+ * `requireProvider()`; tools that don't (decode_calldata, list_gov_contract_types)
+ * never touch this module. Single-shared-provider per process.
+ */
+export declare class RpcProvider {
+    private readonly config;
+    private provider;
+    constructor(config: DexeConfig);
+    requireProvider(): JsonRpcProvider;
+}
+//# sourceMappingURL=rpc.d.ts.map

package/dist/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;GAIG;AACH,qBAAa,WAAW;IAGV,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAgC;gBAEnB,MAAM,EAAE,UAAU;IAE/C,eAAe,IAAI,eAAe;CAWnC"}

package/dist/rpc.js

@@ -0,0 +1,23 @@
+import { JsonRpcProvider } from "ethers";
+/**
+ * Lazy ethers v6 provider factory. Gov tools that need an RPC endpoint call
+ * `requireProvider()`; tools that don't (decode_calldata, list_gov_contract_types)
+ * never touch this module. Single-shared-provider per process.
+ */
+export class RpcProvider {
+    config;
+    provider = null;
+    constructor(config) {
+        this.config = config;
+    }
+    requireProvider() {
+        if (!this.config.rpcUrl) {
+            throw new Error("DEXE_RPC_URL is not set. This tool requires a JSON-RPC endpoint — add DEXE_RPC_URL to the MCP env block.");
+        }
+        if (!this.provider) {
+            this.provider = new JsonRpcProvider(this.config.rpcUrl);
+        }
+        return this.provider;
+    }
+}
+//# sourceMappingURL=rpc.js.map

package/dist/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAGzC;;;;GAIG;AACH,MAAM,OAAO,WAAW;IAGO;IAFrB,QAAQ,GAA2B,IAAI,CAAC;IAEhD,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,eAAe;QACb,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,0GAA0G,CAC3G,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF"}

package/dist/tools/build.d.ts

@@ -0,0 +1,21 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ToolContext } from "./context.js";
+export declare function registerBuildTools(server: McpServer, ctx: ToolContext): void;
+export declare function parseSolcDiagnostics(text: string): Array<{
+    severity: "error" | "warning";
+    code?: string;
+    message: string;
+    file?: string;
+    line?: number;
+}>;
+export interface MochaParseResult {
+    passing: number;
+    failing: number;
+    pending: number;
+    failures: Array<{
+        title: string;
+        error: string;
+    }>;
+}
+export declare function parseMocha(text: string): MochaParseResult;
+//# sourceMappingURL=build.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/tools/build.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAK5E;AA4ED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACxD,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC,CAaD;AAsED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAgBzD"}

package/dist/tools/build.js

@@ -0,0 +1,281 @@
+import { z } from "zod";
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+export function registerBuildTools(server, ctx) {
+    registerCompile(server, ctx);
+    registerTest(server, ctx);
+    registerCoverage(server, ctx);
+    registerLint(server, ctx);
+}
+// ---------- dexe_compile ----------
+function registerCompile(server, ctx) {
+    server.registerTool("dexe_compile", {
+        title: "Compile DeXe-Protocol",
+        description: "Runs `npm run compile` in DEXE_PROTOCOL_PATH. Parses solc diagnostics and invalidates the artifact cache on success. Must be called at least once per session before introspection tools can read artifacts.",
+        inputSchema: {
+            // The current protocol's `compile` script already passes `--force`;
+            // keep this input for forward-compat and ignore it for now.
+            force: z.boolean().optional().describe("Forward-compat only — the current compile script always forces."),
+        },
+        outputSchema: {
+            success: z.boolean(),
+            errorCount: z.number(),
+            warningCount: z.number(),
+            diagnostics: z.array(z.object({
+                severity: z.enum(["error", "warning"]),
+                code: z.string().optional(),
+                message: z.string(),
+                file: z.string().optional(),
+                line: z.number().optional(),
+            })),
+            durationMs: z.number(),
+            logFile: z.string(),
+            stdoutTail: z.string(),
+        },
+    }, async () => {
+        const result = await ctx.runner.runNpmScript("compile");
+        const diags = parseSolcDiagnostics(result.stdout + "\n" + result.stderr);
+        const success = result.exitCode === 0;
+        if (success)
+            ctx.artifacts.invalidate();
+        const structured = {
+            success,
+            errorCount: diags.filter((d) => d.severity === "error").length,
+            warningCount: diags.filter((d) => d.severity === "warning").length,
+            diagnostics: diags.slice(0, 20),
+            durationMs: result.durationMs,
+            logFile: result.logFile,
+            stdoutTail: result.stdoutTail,
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: summarizeCompile(structured, result),
+                },
+            ],
+            structuredContent: structured,
+            isError: !success,
+        };
+    });
+}
+function summarizeCompile(s, r) {
+    const header = s.success
+        ? `Compile OK (${s.warningCount} warning${s.warningCount === 1 ? "" : "s"}) in ${(s.durationMs / 1000).toFixed(1)}s`
+        : `Compile FAILED (${s.errorCount} error${s.errorCount === 1 ? "" : "s"}, ${s.warningCount} warning${s.warningCount === 1 ? "" : "s"}) in ${(s.durationMs / 1000).toFixed(1)}s`;
+    return `${header}\nFull log: ${s.logFile}\n\n--- tail ---\n${r.stdoutTail || "(empty)"}`;
+}
+const SOLC_DIAG = /^(Error|Warning)(?:\s*\(([^)]+)\))?:\s*(.*?)(?:\n\s*-->\s*([^\s:]+):(\d+):\d+)?/gm;
+export function parseSolcDiagnostics(text) {
+    const out = [];
+    for (const m of text.matchAll(SOLC_DIAG)) {
+        const severity = m[1] === "Error" ? "error" : "warning";
+        out.push({
+            severity,
+            code: m[2],
+            message: (m[3] ?? "").trim(),
+            file: m[4],
+            line: m[5] ? Number(m[5]) : undefined,
+        });
+    }
+    return out;
+}
+// ---------- dexe_test ----------
+function registerTest(server, ctx) {
+    server.registerTool("dexe_test", {
+        title: "Run Hardhat tests",
+        description: "Runs `npx hardhat test` in DEXE_PROTOCOL_PATH. Optionally filters by mocha --grep or a specific test file. Parses pass/fail counts and captures up to 20 failure bodies.",
+        inputSchema: {
+            grep: z.string().optional().describe("Mocha --grep pattern"),
+            file: z.string().optional().describe("Specific test file path (relative to protocol root)"),
+            bail: z.boolean().optional().describe("Stop after first failure"),
+        },
+        outputSchema: {
+            success: z.boolean(),
+            passing: z.number(),
+            failing: z.number(),
+            pending: z.number(),
+            failures: z.array(z.object({
+                title: z.string(),
+                error: z.string(),
+            })),
+            durationMs: z.number(),
+            logFile: z.string(),
+            stdoutTail: z.string(),
+        },
+    }, async ({ grep, file, bail }) => {
+        const args = [];
+        if (file)
+            args.push(file);
+        if (grep)
+            args.push("--grep", grep);
+        if (bail)
+            args.push("--bail");
+        const result = await ctx.runner.runHardhat("test", args);
+        const parsed = parseMocha(result.stdout);
+        const success = result.exitCode === 0;
+        const structured = {
+            success,
+            passing: parsed.passing,
+            failing: parsed.failing,
+            pending: parsed.pending,
+            failures: parsed.failures.slice(0, 20),
+            durationMs: result.durationMs,
+            logFile: result.logFile,
+            stdoutTail: result.stdoutTail,
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Tests: ${structured.passing} passing, ${structured.failing} failing` +
+                        (structured.pending ? `, ${structured.pending} pending` : "") +
+                        ` (${(result.durationMs / 1000).toFixed(1)}s)\nFull log: ${result.logFile}\n\n--- tail ---\n${result.stdoutTail || "(empty)"}`,
+                },
+            ],
+            structuredContent: structured,
+            isError: !success,
+        };
+    });
+}
+export function parseMocha(text) {
+    const clean = stripAnsi(text);
+    const passing = Number(/(\d+)\s+passing/.exec(clean)?.[1] ?? 0);
+    const failing = Number(/(\d+)\s+failing/.exec(clean)?.[1] ?? 0);
+    const pending = Number(/(\d+)\s+pending/.exec(clean)?.[1] ?? 0);
+    const failures = [];
+    // Mocha failure blocks: "  1) Test title:" followed by an indented error body.
+    const failureRe = /^\s*(\d+)\)\s+(.+?)\n([\s\S]*?)(?=\n\s*\d+\)\s+|\n\s*\d+\s+passing|\n\s*\d+\s+failing|$)/gm;
+    for (const m of clean.matchAll(failureRe)) {
+        failures.push({
+            title: (m[2] ?? "").trim(),
+            error: (m[3] ?? "").trim().split("\n").slice(0, 20).join("\n"),
+        });
+    }
+    return { passing, failing, pending, failures };
+}
+function stripAnsi(s) {
+    // eslint-disable-next-line no-control-regex
+    return s.replace(/\u001b\[[0-9;]*m/g, "");
+}
+// ---------- dexe_coverage ----------
+function registerCoverage(server, ctx) {
+    server.registerTool("dexe_coverage", {
+        title: "Run solidity-coverage",
+        description: "Runs `npm run coverage` in DEXE_PROTOCOL_PATH and reads coverage/coverage-summary.json for per-file line/branch percentages. Slow — can take several minutes.",
+        inputSchema: {
+            grep: z.string().optional().describe("Mocha --grep pattern (passed through)"),
+        },
+        outputSchema: {
+            success: z.boolean(),
+            total: z
+                .object({
+                lines: z.number(),
+                branches: z.number(),
+                functions: z.number(),
+                statements: z.number(),
+            })
+                .optional(),
+            files: z.array(z.object({
+                file: z.string(),
+                lines: z.number(),
+                branches: z.number(),
+                functions: z.number(),
+                statements: z.number(),
+            })),
+            durationMs: z.number(),
+            logFile: z.string(),
+        },
+    }, async ({ grep }) => {
+        const result = grep
+            ? await ctx.runner.runNpmScript("coverage", ["--grep", grep])
+            : await ctx.runner.runNpmScript("coverage");
+        const success = result.exitCode === 0;
+        const summary = readCoverageSummary(ctx.config.protocolPath);
+        const structured = {
+            success,
+            total: summary?.total,
+            files: summary?.files ?? [],
+            durationMs: result.durationMs,
+            logFile: result.logFile,
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: success
+                        ? `Coverage OK (${structured.files.length} files). Lines: ${structured.total?.lines ?? "?"}%, Branches: ${structured.total?.branches ?? "?"}%\nFull log: ${result.logFile}`
+                        : `Coverage FAILED (exit ${result.exitCode})\nFull log: ${result.logFile}\n\n--- tail ---\n${result.stdoutTail}`,
+                },
+            ],
+            structuredContent: structured,
+            isError: !success,
+        };
+    });
+}
+function readCoverageSummary(protocolPath) {
+    const path = join(protocolPath, "coverage", "coverage-summary.json");
+    if (!existsSync(path))
+        return null;
+    try {
+        const raw = JSON.parse(readFileSync(path, "utf8"));
+        const files = [];
+        let total = { lines: 0, branches: 0, functions: 0, statements: 0 };
+        for (const [key, entry] of Object.entries(raw)) {
+            const rec = {
+                file: key,
+                lines: entry.lines?.pct ?? 0,
+                branches: entry.branches?.pct ?? 0,
+                functions: entry.functions?.pct ?? 0,
+                statements: entry.statements?.pct ?? 0,
+            };
+            if (key === "total")
+                total = { lines: rec.lines, branches: rec.branches, functions: rec.functions, statements: rec.statements };
+            else
+                files.push(rec);
+        }
+        return { total, files };
+    }
+    catch {
+        return null;
+    }
+}
+// ---------- dexe_lint ----------
+function registerLint(server, ctx) {
+    server.registerTool("dexe_lint", {
+        title: "Run protocol linters",
+        description: "Runs the protocol's lint scripts. With `fix: true` runs `npm run lint-fix` (chained solhint/eslint/jsonlint fixers). Without, runs `npm run lint-check` if available.",
+        inputSchema: {
+            fix: z.boolean().optional().describe("Apply fixes in-place"),
+        },
+        outputSchema: {
+            success: z.boolean(),
+            script: z.string(),
+            durationMs: z.number(),
+            logFile: z.string(),
+            stdoutTail: z.string(),
+        },
+    }, async ({ fix }) => {
+        const script = fix ? "lint-fix" : "lint-check";
+        const result = await ctx.runner.runNpmScript(script);
+        const success = result.exitCode === 0;
+        const structured = {
+            success,
+            script,
+            durationMs: result.durationMs,
+            logFile: result.logFile,
+            stdoutTail: result.stdoutTail,
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `${success ? "Lint OK" : `Lint FAILED (exit ${result.exitCode})`} via \`npm run ${script}\` in ${(result.durationMs / 1000).toFixed(1)}s\nFull log: ${result.logFile}\n\n--- tail ---\n${result.stdoutTail || "(empty)"}`,
+                },
+            ],
+            structuredContent: structured,
+            isError: !success,
+        };
+    });
+}
+//# sourceMappingURL=build.js.map

package/dist/tools/build.js.map

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

package/dist/tools/context.d.ts

@@ -0,0 +1,16 @@
+import type { DexeConfig } from "../config.js";
+import type { Artifacts } from "../artifacts.js";
+import type { HardhatRunner } from "../hardhat.js";
+import type { SelectorIndex } from "../lib/selectors.js";
+/**
+ * Shared dependency bag passed to every tool register() function. Built once
+ * in `registerAll` and handed out by reference so all tools share artifact
+ * caches, selector indices, and the single-slot hardhat runner.
+ */
+export interface ToolContext {
+    readonly config: DexeConfig;
+    readonly artifacts: Artifacts;
+    readonly runner: HardhatRunner;
+    readonly selectors: SelectorIndex;
+}
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;CACnC"}

package/dist/tools/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/tools/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":""}

package/dist/tools/gov.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ToolContext } from "./context.js";
+export declare function registerGovTools(server: McpServer, ctx: ToolContext): void;
+//# sourceMappingURL=gov.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gov.d.ts","sourceRoot":"","sources":["../../src/tools/gov.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAMhD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAS1E"}