vexp-mcp 1.2.14

package/dist/daemon-client.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Client per comunicare con il vexp-core daemon via Unix socket / Named pipe.
+ * Protocol: JSON lines (newline-delimited JSON).
+ */
+export declare class DaemonClient {
+    private socketPath;
+    private requestCounter;
+    private sessionId;
+    constructor(socketPath?: string, sessionId?: string);
+    /**
+     * Invia una richiesta al daemon e attende la risposta.
+     */
+    call(tool: string, params: unknown): Promise<unknown>;
+    /**
+     * Verifica se il daemon è raggiungibile
+     */
+    health(): Promise<boolean>;
+}
+//# sourceMappingURL=daemon-client.d.ts.map

package/dist/daemon-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-client.d.ts","sourceRoot":"","sources":["../src/daemon-client.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,SAAS,CAAS;gBAEd,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAKnD;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAiE3D;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;CAQjC"}

package/dist/daemon-client.js

@@ -0,0 +1,111 @@
+import * as net from "net";
+import * as path from "path";
+import { randomUUID } from "crypto";
+/**
+ * Client per comunicare con il vexp-core daemon via Unix socket / Named pipe.
+ * Protocol: JSON lines (newline-delimited JSON).
+ */
+export class DaemonClient {
+    socketPath;
+    requestCounter = 0;
+    sessionId;
+    constructor(socketPath, sessionId) {
+        this.socketPath = socketPath ?? getDefaultSocketPath();
+        this.sessionId = sessionId ?? randomUUID();
+    }
+    /**
+     * Invia una richiesta al daemon e attende la risposta.
+     */
+    async call(tool, params) {
+        return new Promise((resolve, reject) => {
+            const id = ++this.requestCounter;
+            const request = { id, tool, params, session_id: this.sessionId };
+            const requestLine = JSON.stringify(request) + "\n";
+            let client;
+            let responseBuffer = "";
+            let settled = false;
+            const timeout = setTimeout(() => {
+                if (!settled) {
+                    settled = true;
+                    client?.destroy();
+                    reject(new Error(`Timeout: no response from daemon for tool '${tool}' after 30s`));
+                }
+            }, 30_000);
+            const settle = (fn) => {
+                if (!settled) {
+                    settled = true;
+                    clearTimeout(timeout);
+                    fn();
+                }
+            };
+            if (process.platform === "win32") {
+                client = net.createConnection(this.socketPath);
+            }
+            else {
+                client = net.createConnection({ path: this.socketPath });
+            }
+            client.on("connect", () => {
+                client.write(requestLine);
+            });
+            client.on("data", (chunk) => {
+                responseBuffer += chunk.toString();
+                const newlineIndex = responseBuffer.indexOf("\n");
+                if (newlineIndex !== -1) {
+                    const line = responseBuffer.slice(0, newlineIndex);
+                    client.destroy();
+                    try {
+                        const response = JSON.parse(line);
+                        if (response.type === "response") {
+                            settle(() => resolve(response.result));
+                        }
+                        else {
+                            settle(() => reject(new Error(response.message ?? "Daemon error")));
+                        }
+                    }
+                    catch (e) {
+                        settle(() => reject(new Error(`Invalid response JSON: ${line}`)));
+                    }
+                }
+            });
+            client.on("error", (err) => {
+                settle(() => reject(new Error(`Daemon connection error: ${err.message}. Is vexp daemon running?`)));
+            });
+            client.on("close", () => {
+                settle(() => reject(new Error("Daemon connection closed unexpectedly")));
+            });
+        });
+    }
+    /**
+     * Verifica se il daemon è raggiungibile
+     */
+    async health() {
+        try {
+            await this.call("index_status", {});
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+/** FNV-1a 64-bit hash — must match vexp-core/src/utils.rs md5_hash() */
+function fnvHash(input) {
+    let hash = BigInt("0xcbf29ce484222325");
+    const prime = BigInt("0x100000001b3");
+    const mask = BigInt("0xffffffffffffffff");
+    const bytes = Buffer.from(input, "utf-8");
+    for (const byte of bytes) {
+        hash ^= BigInt(byte);
+        hash = (hash * prime) & mask;
+    }
+    return hash.toString(16);
+}
+function getDefaultSocketPath() {
+    const workspaceRoot = process.env["VEXP_WORKSPACE"] ?? process.cwd();
+    if (process.platform === "win32") {
+        const hash = fnvHash(workspaceRoot);
+        return `\\\\.\\pipe\\vexp-${hash.slice(0, 8)}`;
+    }
+    return path.join(workspaceRoot, ".vexp", "daemon.sock");
+}
+//# sourceMappingURL=daemon-client.js.map

package/dist/daemon-client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# 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":""}

package/dist/index.js

@@ -0,0 +1,238 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import express from "express";
+import { createServer } from "http";
+import { randomUUID } from "crypto";
+import fs from "fs";
+import { DaemonClient } from "./daemon-client.js";
+import { GET_CONTEXT_CAPSULE_DEFINITION, handleGetContextCapsule, } from "./tools/get-context-capsule.js";
+import { GET_IMPACT_GRAPH_DEFINITION, handleGetImpactGraph, } from "./tools/get-impact-graph.js";
+import { SEARCH_LOGIC_FLOW_DEFINITION, handleSearchLogicFlow, } from "./tools/search-logic-flow.js";
+import { GET_SKELETON_DEFINITION, handleGetSkeleton, } from "./tools/get-skeleton.js";
+import { INDEX_STATUS_DEFINITION, handleIndexStatus, } from "./tools/index-status.js";
+import { WORKSPACE_SETUP_DEFINITION, handleWorkspaceSetup, } from "./tools/workspace-setup.js";
+import { GET_SESSION_CONTEXT_DEFINITION, handleGetSessionContext, } from "./tools/get-session-context.js";
+import { SEARCH_MEMORY_DEFINITION, handleSearchMemory, } from "./tools/search-memory.js";
+import { SAVE_OBSERVATION_DEFINITION, handleSaveObservation, } from "./tools/save-observation.js";
+const ALL_TOOL_DEFINITIONS = [
+    GET_CONTEXT_CAPSULE_DEFINITION,
+    GET_IMPACT_GRAPH_DEFINITION,
+    SEARCH_LOGIC_FLOW_DEFINITION,
+    GET_SKELETON_DEFINITION,
+    INDEX_STATUS_DEFINITION,
+    WORKSPACE_SETUP_DEFINITION,
+    GET_SESSION_CONTEXT_DEFINITION,
+    SEARCH_MEMORY_DEFINITION,
+    SAVE_OBSERVATION_DEFINITION,
+];
+// Free plan: core tools + all memory tools (memory is the showcase).
+const FREE_TOOL_NAMES = new Set([
+    "get_context_capsule",
+    "get_skeleton",
+    "index_status",
+    "get_session_context",
+    "search_memory",
+    "save_observation",
+]);
+const allToolsEnabled = process.env.VEXP_ALL_TOOLS === "1";
+/** FNV-1a 64-bit hash — must match vexp-core/src/utils.rs md5_hash() */
+function fnvHash(input) {
+    let hash = BigInt("0xcbf29ce484222325");
+    const prime = BigInt("0x100000001b3");
+    const mask = BigInt("0xffffffffffffffff");
+    const bytes = Buffer.from(input, "utf-8");
+    for (const byte of bytes) {
+        hash ^= BigInt(byte);
+        hash = (hash * prime) & mask;
+    }
+    return hash.toString(16);
+}
+function getSocketPath() {
+    if (process.env.VEXP_SOCKET)
+        return process.env.VEXP_SOCKET;
+    const workspaceRoot = process.env.VEXP_WORKSPACE ?? process.cwd();
+    if (process.platform === "win32") {
+        // Normalize to lowercase — Windows drive letters can be C: or c: depending on context,
+        // but the FNV hash is case-sensitive. Must match vexp-core/src/utils.rs get_socket_path().
+        const normalized = workspaceRoot.toLowerCase();
+        const hash = fnvHash(normalized);
+        return `\\\\.\\pipe\\vexp-${hash.slice(0, 8)}`;
+    }
+    const cwdSocket = `${workspaceRoot}/.vexp/daemon.sock`;
+    if (fs.existsSync(cwdSocket))
+        return cwdSocket;
+    const home = process.env.HOME ?? "/tmp";
+    return `${home}/.vexp/daemon.sock`;
+}
+function createMcpServer(daemon) {
+    const server = new Server({ name: "vexp-mcp", version: "1.0.0" }, { capabilities: { tools: {} } });
+    const visibleTools = allToolsEnabled
+        ? ALL_TOOL_DEFINITIONS
+        : ALL_TOOL_DEFINITIONS.filter((t) => FREE_TOOL_NAMES.has(t.name));
+    server.setRequestHandler(ListToolsRequestSchema, () => ({
+        tools: visibleTools,
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const { name, arguments: args } = req.params;
+        // Block Pro-only tools for free users
+        if (!allToolsEnabled && !FREE_TOOL_NAMES.has(name)) {
+            return {
+                isError: true,
+                content: [{
+                        type: "text",
+                        text: `${name} requires a Pro plan. Upgrade at https://vexp.dev/#pricing to unlock all MCP tools.`,
+                    }],
+            };
+        }
+        try {
+            let text;
+            switch (name) {
+                case "get_context_capsule":
+                    text = await handleGetContextCapsule(args, daemon);
+                    break;
+                case "get_impact_graph":
+                    text = await handleGetImpactGraph(args, daemon);
+                    break;
+                case "search_logic_flow":
+                    text = await handleSearchLogicFlow(args, daemon);
+                    break;
+                case "get_skeleton":
+                    text = await handleGetSkeleton(args, daemon);
+                    break;
+                case "index_status":
+                    text = await handleIndexStatus(args, daemon);
+                    break;
+                case "workspace_setup":
+                    text = await handleWorkspaceSetup(args, daemon);
+                    break;
+                case "get_session_context":
+                    text = await handleGetSessionContext(args, daemon);
+                    break;
+                case "search_memory":
+                    text = await handleSearchMemory(args, daemon);
+                    break;
+                case "save_observation":
+                    text = await handleSaveObservation(args, daemon);
+                    break;
+                default:
+                    return {
+                        isError: true,
+                        content: [{ type: "text", text: `Unknown tool: ${name}` }],
+                    };
+            }
+            return {
+                content: [{ type: "text", text }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Error: ${message}` }],
+            };
+        }
+    });
+    return server;
+}
+async function startStdio(daemon) {
+    const server = createMcpServer(daemon);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[vexp-mcp] Running on stdio");
+}
+async function startHttp(daemon, port) {
+    const app = express();
+    app.use(express.json());
+    const transports = new Map();
+    // CORS preflight
+    app.options("*", (_req, res) => {
+        res.setHeader("Access-Control-Allow-Origin", "*");
+        res.setHeader("Access-Control-Allow-Methods", "GET, POST, DELETE, OPTIONS");
+        res.setHeader("Access-Control-Allow-Headers", "Content-Type, mcp-session-id");
+        res.status(204).send();
+    });
+    // Single MCP endpoint — handles initialize (POST without session ID),
+    // subsequent JSON-RPC requests, and GET for SSE notification streams.
+    app.all("/mcp", async (req, res) => {
+        res.setHeader("Access-Control-Allow-Origin", "*");
+        const sessionId = req.headers["mcp-session-id"];
+        if (sessionId) {
+            const transport = transports.get(sessionId);
+            if (!transport) {
+                // Session lost (server restart, transport closed) — create a new one
+                // instead of returning 404, so the client transparently reconnects.
+                console.error(`[vexp-mcp] Session ${sessionId} not found — creating new transport`);
+                // Fall through to the "new session" code below
+            }
+            else {
+                await transport.handleRequest(req, res, req.body);
+                return;
+            }
+        }
+        // No session ID → new client initializing
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: () => randomUUID(),
+            onsessioninitialized: (sid) => {
+                transports.set(sid, transport);
+            },
+        });
+        transport.onclose = () => {
+            if (transport.sessionId)
+                transports.delete(transport.sessionId);
+        };
+        const server = createMcpServer(daemon);
+        await server.connect(transport);
+        await transport.handleRequest(req, res, req.body);
+    });
+    // Health check
+    app.get("/health", async (_req, res) => {
+        try {
+            const healthy = await daemon.health();
+            res.json({ status: healthy ? "ok" : "daemon_down", sessions: transports.size });
+        }
+        catch {
+            res.status(503).json({ status: "error" });
+        }
+    });
+    const httpServer = createServer(app);
+    const tryListen = (retries) => new Promise((resolve, reject) => {
+        const onError = (err) => {
+            if (err.code === "EADDRINUSE" && retries > 0) {
+                console.error(`[vexp-mcp] Port ${port} busy, retrying in 1s (${retries} left)`);
+                setTimeout(() => tryListen(retries - 1).then(resolve, reject), 2000);
+            }
+            else {
+                reject(err);
+            }
+        };
+        httpServer.once("error", onError);
+        httpServer.listen(port, "127.0.0.1", () => {
+            httpServer.removeListener("error", onError);
+            console.error(`[vexp-mcp] HTTP server listening on 127.0.0.1:${port}`);
+            resolve();
+        });
+    });
+    await tryListen(10);
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const socketPath = getSocketPath();
+    const daemon = new DaemonClient(socketPath);
+    const useHttp = args.includes("--http") || process.env.VEXP_HTTP === "1";
+    const port = parseInt(args.find((a) => a.startsWith("--port="))?.split("=")[1] ??
+        process.env.VEXP_PORT ??
+        "7821", 10);
+    if (useHttp) {
+        await startHttp(daemon, port);
+    }
+    else {
+        await startStdio(daemon);
+    }
+}
+main().catch((err) => {
+    console.error("[vexp-mcp] Fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools/get-context-capsule.d.ts

@@ -0,0 +1,65 @@
+import { z } from "zod";
+import type { DaemonClient } from "../daemon-client.js";
+export declare const GetContextCapsuleSchema: z.ZodObject<{
+    query: z.ZodString;
+    repos: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    max_tokens: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pivot_depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    include_tests: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    skeleton_detail: z.ZodDefault<z.ZodOptional<z.ZodEnum<["minimal", "standard", "detailed"]>>>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    max_tokens: number;
+    pivot_depth: number;
+    include_tests: boolean;
+    skeleton_detail: "minimal" | "standard" | "detailed";
+    repos?: string[] | undefined;
+}, {
+    query: string;
+    repos?: string[] | undefined;
+    max_tokens?: number | undefined;
+    pivot_depth?: number | undefined;
+    include_tests?: boolean | undefined;
+    skeleton_detail?: "minimal" | "standard" | "detailed" | undefined;
+}>;
+export type GetContextCapsuleParams = z.infer<typeof GetContextCapsuleSchema>;
+export declare const GET_CONTEXT_CAPSULE_DEFINITION: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            repos: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            max_tokens: {
+                type: string;
+                description: string;
+            };
+            pivot_depth: {
+                type: string;
+                description: string;
+            };
+            include_tests: {
+                type: string;
+                description: string;
+            };
+            skeleton_detail: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleGetContextCapsule(params: unknown, daemon: DaemonClient): Promise<string>;
+//# sourceMappingURL=get-context-capsule.d.ts.map

package/dist/tools/get-context-capsule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-context-capsule.d.ts","sourceRoot":"","sources":["../../src/tools/get-context-capsule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;EAOlC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE9E,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0B1C,CAAC;AAEF,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,MAAM,CAAC,CAIjB"}

package/dist/tools/get-context-capsule.js

@@ -0,0 +1,101 @@
+import { z } from "zod";
+export const GetContextCapsuleSchema = z.object({
+    query: z.string().describe("Description of the task or what you need context for"),
+    repos: z.array(z.string()).optional().describe("Repo aliases to query (default: all)"),
+    max_tokens: z.number().optional().default(8000).describe("Max tokens for the capsule"),
+    pivot_depth: z.number().optional().default(2).describe("BFS depth from pivot nodes"),
+    include_tests: z.boolean().optional().default(false).describe("Include test files"),
+    skeleton_detail: z.enum(["minimal", "standard", "detailed"]).optional().default("standard"),
+});
+export const GET_CONTEXT_CAPSULE_DEFINITION = {
+    name: "get_context_capsule",
+    description: "Get a context capsule for a task. Finds the most relevant code (pivot nodes) via semantic + graph search " +
+        "and includes skeletons of supporting files, optimized to minimize token usage while maximizing relevance. " +
+        "WHEN TO USE: (1) Before any code change — always call this first to orient yourself. " +
+        "(2) When asked how a feature works or where something is implemented. " +
+        "(3) At the start of a debugging session. " +
+        "Prefer this over Read/Grep for initial exploration — it returns the most relevant code ranked by graph centrality. " +
+        "In multi-repo workspaces, automatically queries all indexed repos. Use the 'repos' parameter to restrict to specific repo aliases (discoverable via index_status).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: { type: "string", description: "Description of the task" },
+            repos: { type: "array", items: { type: "string" }, description: "Repo aliases to query (from index_status). Default: all indexed repos" },
+            max_tokens: { type: "number", description: "Max tokens (default: 8000)" },
+            pivot_depth: { type: "number", description: "Graph traversal depth (default: 2)" },
+            include_tests: { type: "boolean", description: "Include test files" },
+            skeleton_detail: {
+                type: "string",
+                enum: ["minimal", "standard", "detailed"],
+                description: "Skeleton detail level (default: standard)",
+            },
+        },
+        required: ["query"],
+    },
+};
+export async function handleGetContextCapsule(params, daemon) {
+    const validated = GetContextCapsuleSchema.parse(params);
+    const result = await daemon.call("get_context_capsule", validated);
+    return formatCapsuleAsText(result);
+}
+function formatCapsuleAsText(capsule) {
+    const lines = [];
+    lines.push(`# vexp Context Capsule`);
+    const savingLabel = capsule.token_budget.saving_pct > 1
+        ? `${capsule.token_budget.saving_pct.toFixed(0)}% token saving vs full content`
+        : `${capsule.graph_stats.nodes_analyzed} nodes · ${capsule.graph_stats.edges_traversed} edges traversed`;
+    const memoryCount = capsule.memories?.length ?? 0;
+    lines.push(`> Token budget: ${capsule.token_budget.used}/${capsule.token_budget.total} used | ` +
+        `${savingLabel} | ` +
+        `${capsule.graph_stats.query_time_ms}ms | ` +
+        `memories: ${memoryCount}`);
+    lines.push("");
+    if (capsule.pivots.length === 0) {
+        lines.push("*No relevant code found for this query. Try a different description.*");
+        return lines.join("\n");
+    }
+    const isMultiRepo = capsule.graph_stats.repos_queried.length > 1;
+    lines.push("## Pivot Files (Full Content)");
+    lines.push("");
+    for (const pivot of capsule.pivots) {
+        const repoLabel = isMultiRepo ? `\`${pivot.repo}\` / ` : '';
+        lines.push(`### ${repoLabel}\`${pivot.file_path}\` (relevance: ${pivot.relevance_score.toFixed(2)})`);
+        lines.push(`*${pivot.why}*`);
+        lines.push("");
+        lines.push("```");
+        lines.push(pivot.content);
+        lines.push("```");
+        lines.push("");
+    }
+    if (capsule.supporting.length > 0) {
+        lines.push("## Supporting Context (Skeletons)");
+        lines.push("");
+        for (const sup of capsule.supporting) {
+            const crossRepoLabel = sup.cross_repo ? " *(cross-repo)*" : "";
+            lines.push(`### \`${sup.file_path}\`${crossRepoLabel}`);
+            lines.push(`*${sup.relationship}*`);
+            lines.push("");
+            lines.push("```");
+            lines.push(sup.skeleton);
+            lines.push("```");
+            lines.push("");
+        }
+    }
+    lines.push("## Session Memory");
+    if (capsule.memories && capsule.memories.length > 0) {
+        lines.push("*Relevant observations from this and previous sessions:*");
+        lines.push("");
+        for (const mem of capsule.memories) {
+            const date = new Date(mem.created_at * 1000);
+            const timeStr = `${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")} ${String(date.getHours()).padStart(2, "0")}:${String(date.getMinutes()).padStart(2, "0")}`;
+            const staleTag = mem.stale ? " ~stale~" : "";
+            lines.push(`- [${timeStr}${staleTag}] ${mem.content}`);
+        }
+    }
+    else {
+        lines.push("*No relevant memories found. Use `save_observation` to persist important decisions.*");
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+//# sourceMappingURL=get-context-capsule.js.map

package/dist/tools/get-context-capsule.js.map

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

package/dist/tools/get-impact-graph.d.ts

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import type { DaemonClient } from "../daemon-client.js";
+export declare const GetImpactGraphSchema: z.ZodObject<{
+    symbol_fqn: z.ZodString;
+    depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    cross_repo: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    format: z.ZodDefault<z.ZodOptional<z.ZodEnum<["list", "tree", "mermaid"]>>>;
+}, "strip", z.ZodTypeAny, {
+    symbol_fqn: string;
+    depth: number;
+    cross_repo: boolean;
+    format: "list" | "tree" | "mermaid";
+}, {
+    symbol_fqn: string;
+    depth?: number | undefined;
+    cross_repo?: boolean | undefined;
+    format?: "list" | "tree" | "mermaid" | undefined;
+}>;
+export type GetImpactGraphParams = z.infer<typeof GetImpactGraphSchema>;
+export declare const GET_IMPACT_GRAPH_DEFINITION: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            symbol_fqn: {
+                type: string;
+                description: string;
+            };
+            depth: {
+                type: string;
+                description: string;
+            };
+            cross_repo: {
+                type: string;
+                description: string;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleGetImpactGraph(params: unknown, daemon: DaemonClient): Promise<string>;
+//# sourceMappingURL=get-impact-graph.d.ts.map

package/dist/tools/get-impact-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-impact-graph.d.ts","sourceRoot":"","sources":["../../src/tools/get-impact-graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAK/B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BvC,CAAC;AAsBF,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,MAAM,CAAC,CAMjB"}