sverklo 0.1.0

package/dist/src/memory/staleness.js

@@ -0,0 +1,19 @@
+export function checkStaleness(memory, fileStore, memoryStore) {
+    if (!memory.related_files)
+        return false;
+    let files;
+    try {
+        files = JSON.parse(memory.related_files);
+    }
+    catch {
+        return false;
+    }
+    if (!Array.isArray(files) || files.length === 0)
+        return false;
+    const anyMissing = files.some((path) => !fileStore.getByPath(path));
+    if (anyMissing !== Boolean(memory.is_stale)) {
+        memoryStore.markStale(memory.id, anyMissing);
+    }
+    return anyMissing;
+}
+//# sourceMappingURL=staleness.js.map

package/dist/src/memory/staleness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staleness.js","sourceRoot":"","sources":["../../../src/memory/staleness.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,SAAoB,EACpB,WAAwB;IAExB,IAAI,CAAC,MAAM,CAAC,aAAa;QAAE,OAAO,KAAK,CAAC;IAExC,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAE9D,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAEpE,IAAI,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5C,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/src/search/hybrid-search.d.ts

@@ -0,0 +1,13 @@
+import type { Indexer } from "../indexer/indexer.js";
+import type { SearchResult, ChunkType } from "../types/index.js";
+interface SearchOptions {
+    query: string;
+    tokenBudget: number;
+    scope?: string;
+    language?: string;
+    type?: ChunkType | "any";
+}
+export declare function hybridSearch(indexer: Indexer, options: SearchOptions): Promise<SearchResult[]>;
+export declare function packResults(candidates: SearchResult[], tokenBudget: number): SearchResult[];
+export declare function formatResults(results: SearchResult[]): string;
+export {};

package/dist/src/search/hybrid-search.js

@@ -0,0 +1,97 @@
+import { embed, cosineSimilarity } from "../indexer/embedder.js";
+// Reciprocal Rank Fusion constant
+const RRF_K = 60;
+export async function hybridSearch(indexer, options) {
+    const { query, tokenBudget, scope, language, type } = options;
+    // Signal A: BM25 text search
+    const ftsResults = indexer.chunkStore.searchFts(query, 50);
+    // Signal B: Vector similarity search
+    const [queryVector] = await embed([query]);
+    const allEmbeddings = indexer.embeddingStore.getAll();
+    const vectorScores = [];
+    for (const [chunkId, vec] of allEmbeddings) {
+        const score = cosineSimilarity(queryVector, vec);
+        vectorScores.push({ chunkId, score });
+    }
+    vectorScores.sort((a, b) => b.score - a.score);
+    const topVector = vectorScores.slice(0, 50);
+    // Build file cache for PageRank lookup
+    const fileCache = new Map();
+    for (const f of indexer.fileStore.getAll()) {
+        fileCache.set(f.id, f);
+    }
+    // Reciprocal Rank Fusion
+    const rrfScores = new Map();
+    // Add FTS scores
+    for (let rank = 0; rank < ftsResults.length; rank++) {
+        const chunkId = ftsResults[rank].id;
+        const score = 1 / (RRF_K + rank + 1);
+        rrfScores.set(chunkId, (rrfScores.get(chunkId) || 0) + score);
+    }
+    // Add vector scores
+    for (let rank = 0; rank < topVector.length; rank++) {
+        const chunkId = topVector[rank].chunkId;
+        const score = 1 / (RRF_K + rank + 1);
+        rrfScores.set(chunkId, (rrfScores.get(chunkId) || 0) + score);
+    }
+    // Collect candidates with full data
+    const candidates = [];
+    for (const [chunkId, rrfScore] of rrfScores) {
+        const chunk = indexer.chunkStore.getById(chunkId);
+        if (!chunk)
+            continue;
+        const file = fileCache.get(chunk.file_id);
+        if (!file)
+            continue;
+        // Apply filters
+        if (scope && !file.path.startsWith(scope))
+            continue;
+        if (language && file.language !== language)
+            continue;
+        if (type && type !== "any" && chunk.type !== type)
+            continue;
+        // Boost by PageRank
+        const pagerankBoost = 1 + 0.3 * file.pagerank;
+        const finalScore = rrfScore * pagerankBoost;
+        candidates.push({ chunk, file, score: finalScore });
+    }
+    // Sort by score
+    candidates.sort((a, b) => b.score - a.score);
+    // Pack into token budget
+    return packResults(candidates, tokenBudget);
+}
+export function packResults(candidates, tokenBudget) {
+    const results = [];
+    let remaining = tokenBudget;
+    for (const candidate of candidates) {
+        // Estimate overhead per result (file path, line numbers, formatting)
+        const overhead = 30;
+        const cost = candidate.chunk.token_count + overhead;
+        if (cost <= remaining) {
+            results.push(candidate);
+            remaining -= cost;
+        }
+        else if (remaining < 100) {
+            break;
+        }
+    }
+    return results;
+}
+export function formatResults(results) {
+    if (results.length === 0) {
+        return "No results found.";
+    }
+    const parts = [];
+    for (const { chunk, file, score } of results) {
+        const header = chunk.name
+            ? `## ${file.path}:${chunk.start_line}-${chunk.end_line} (${chunk.type}: ${chunk.name})`
+            : `## ${file.path}:${chunk.start_line}-${chunk.end_line} (${chunk.type})`;
+        parts.push(header);
+        parts.push(`\`\`\`${file.language || ""}`);
+        parts.push(chunk.content);
+        parts.push("```");
+        parts.push("");
+    }
+    return parts.join("\n");
+}
+//# sourceMappingURL=hybrid-search.js.map

package/dist/src/search/hybrid-search.js.map

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

package/dist/src/search/pagerank.d.ts

@@ -0,0 +1,4 @@
+export declare function computePageRank(fileIds: number[], edges: {
+    source: number;
+    target: number;
+}[]): Map<number, number>;

package/dist/src/search/pagerank.js

@@ -0,0 +1,64 @@
+// PageRank implementation for file importance ranking.
+// Aider's key innovation: apply PageRank to the dependency graph
+// so that structurally important files (many importers) rank higher.
+const DAMPING = 0.85;
+const ITERATIONS = 20;
+const CONVERGENCE_THRESHOLD = 0.0001;
+export function computePageRank(fileIds, edges) {
+    const n = fileIds.length;
+    if (n === 0)
+        return new Map();
+    // Build adjacency lists
+    const outLinks = new Map();
+    const inLinks = new Map();
+    for (const id of fileIds) {
+        outLinks.set(id, new Set());
+        inLinks.set(id, new Set());
+    }
+    for (const { source, target } of edges) {
+        outLinks.get(source)?.add(target);
+        inLinks.get(target)?.add(source);
+    }
+    // Initialize ranks equally
+    let ranks = new Map();
+    const initialRank = 1 / n;
+    for (const id of fileIds) {
+        ranks.set(id, initialRank);
+    }
+    // Iterate
+    for (let iter = 0; iter < ITERATIONS; iter++) {
+        const newRanks = new Map();
+        let maxDelta = 0;
+        for (const id of fileIds) {
+            let incomingRank = 0;
+            const incomers = inLinks.get(id);
+            if (incomers) {
+                for (const srcId of incomers) {
+                    const srcOutDegree = outLinks.get(srcId)?.size || 1;
+                    incomingRank += (ranks.get(srcId) || 0) / srcOutDegree;
+                }
+            }
+            const newRank = (1 - DAMPING) / n + DAMPING * incomingRank;
+            newRanks.set(id, newRank);
+            const delta = Math.abs(newRank - (ranks.get(id) || 0));
+            if (delta > maxDelta)
+                maxDelta = delta;
+        }
+        ranks = newRanks;
+        if (maxDelta < CONVERGENCE_THRESHOLD)
+            break;
+    }
+    // Normalize to 0-1 range
+    let maxRank = 0;
+    for (const r of ranks.values()) {
+        if (r > maxRank)
+            maxRank = r;
+    }
+    if (maxRank > 0) {
+        for (const [id, r] of ranks) {
+            ranks.set(id, r / maxRank);
+        }
+    }
+    return ranks;
+}
+//# sourceMappingURL=pagerank.js.map

package/dist/src/search/pagerank.js.map

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

package/dist/src/search/token-budget.d.ts

@@ -0,0 +1,10 @@
+import type { FileRecord, CodeChunk } from "../types/index.js";
+export interface OverviewEntry {
+    file: FileRecord;
+    chunks: CodeChunk[];
+}
+export declare function formatOverview(entries: OverviewEntry[], tokenBudget: number, basePath?: string): string;
+export declare function formatLookup(chunks: (CodeChunk & {
+    filePath?: string;
+    pagerank?: number;
+})[], files: Map<number, FileRecord>, tokenBudget: number): string;

package/dist/src/search/token-budget.js

@@ -0,0 +1,67 @@
+export function formatOverview(entries, tokenBudget, basePath) {
+    const parts = [];
+    let remaining = tokenBudget;
+    // Group by directory
+    const dirs = new Map();
+    for (const entry of entries) {
+        const dir = entry.file.path.split("/").slice(0, -1).join("/") || ".";
+        if (!basePath || dir.startsWith(basePath)) {
+            const existing = dirs.get(dir) || [];
+            existing.push(entry);
+            dirs.set(dir, existing);
+        }
+    }
+    // Sort directories, most important files first within each
+    const sortedDirs = [...dirs.entries()].sort((a, b) => {
+        const maxA = Math.max(...a[1].map((e) => e.file.pagerank));
+        const maxB = Math.max(...b[1].map((e) => e.file.pagerank));
+        return maxB - maxA;
+    });
+    for (const [dir, dirEntries] of sortedDirs) {
+        const dirLine = `${dir}/`;
+        const dirCost = 5; // tokens for dir header
+        if (remaining < dirCost + 20)
+            break;
+        parts.push(dirLine);
+        remaining -= dirCost;
+        // Sort files by PageRank within directory
+        dirEntries.sort((a, b) => b.file.pagerank - a.file.pagerank);
+        for (const entry of dirEntries) {
+            const fileName = entry.file.path.split("/").pop() || entry.file.path;
+            const symbols = entry.chunks
+                .filter((c) => c.name)
+                .map((c) => `${c.name}()`)
+                .slice(0, 8)
+                .join(", ");
+            const line = `  ${fileName} [${entry.file.pagerank.toFixed(2)}] — ${symbols || "(no named exports)"}`;
+            const lineCost = Math.ceil(line.length / 3.5);
+            if (remaining < lineCost)
+                break;
+            parts.push(line);
+            remaining -= lineCost;
+        }
+    }
+    return parts.join("\n");
+}
+export function formatLookup(chunks, files, tokenBudget) {
+    const parts = [];
+    let remaining = tokenBudget;
+    for (const chunk of chunks) {
+        const file = files.get(chunk.file_id);
+        const filePath = chunk.filePath || file?.path || "unknown";
+        const lang = file?.language || "";
+        const header = `## ${filePath}:${chunk.start_line}-${chunk.end_line} (${chunk.type}: ${chunk.name})`;
+        const headerCost = Math.ceil(header.length / 3.5);
+        const contentCost = chunk.token_count;
+        const totalCost = headerCost + contentCost + 10;
+        if (remaining < totalCost)
+            break;
+        parts.push(header);
+        parts.push(`\`\`\`${lang}`);
+        parts.push(chunk.content);
+        parts.push("```\n");
+        remaining -= totalCost;
+    }
+    return parts.length > 0 ? parts.join("\n") : "No results found.";
+}
+//# sourceMappingURL=token-budget.js.map

package/dist/src/search/token-budget.js.map

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

package/dist/src/server/mcp-server.d.ts

@@ -0,0 +1 @@
+export declare function startMcpServer(rootPath: string): Promise<void>;

package/dist/src/server/mcp-server.js

@@ -0,0 +1,120 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { Indexer } from "../indexer/indexer.js";
+import { startWatcher } from "../indexer/watcher.js";
+import { getProjectConfig } from "../utils/config.js";
+import { log, logError } from "../utils/logger.js";
+import { searchTool, handleSearch } from "./tools/search.js";
+import { overviewTool, handleOverview } from "./tools/overview.js";
+import { lookupTool, handleLookup } from "./tools/lookup.js";
+import { findReferencesTool, handleFindReferences, } from "./tools/find-references.js";
+import { dependenciesTool, handleDependencies, } from "./tools/dependencies.js";
+import { indexStatusTool, handleIndexStatus, } from "./tools/index-status.js";
+import { rememberTool, handleRemember } from "./tools/remember.js";
+import { recallTool, handleRecall } from "./tools/recall.js";
+import { forgetTool, handleForget } from "./tools/forget.js";
+import { memoriesTool, handleMemories } from "./tools/memories.js";
+export async function startMcpServer(rootPath) {
+    const config = getProjectConfig(rootPath);
+    const indexer = new Indexer(config);
+    // Start indexing in background
+    const indexPromise = indexer.index().catch((err) => {
+        logError("Initial indexing failed", err);
+    });
+    // Start file watcher
+    startWatcher(indexer, rootPath);
+    const server = new Server({
+        name: "sverklo",
+        version: "0.1.0",
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // List tools
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: [
+            searchTool,
+            overviewTool,
+            lookupTool,
+            findReferencesTool,
+            dependenciesTool,
+            indexStatusTool,
+            rememberTool,
+            recallTool,
+            forgetTool,
+            memoriesTool,
+        ],
+    }));
+    // Handle tool calls
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        // Ensure index is ready for search operations
+        if (name !== "index_status") {
+            await indexPromise;
+        }
+        try {
+            let result;
+            switch (name) {
+                case "search":
+                    result = await handleSearch(indexer, args || {});
+                    break;
+                case "overview":
+                    result = handleOverview(indexer, args || {});
+                    break;
+                case "lookup":
+                    result = handleLookup(indexer, args || {});
+                    break;
+                case "find_references":
+                    result = handleFindReferences(indexer, args || {});
+                    break;
+                case "dependencies":
+                    result = handleDependencies(indexer, args || {});
+                    break;
+                case "index_status":
+                    result = handleIndexStatus(indexer);
+                    break;
+                case "remember":
+                    result = await handleRemember(indexer, args || {});
+                    break;
+                case "recall":
+                    result = await handleRecall(indexer, args || {});
+                    break;
+                case "forget":
+                    result = handleForget(indexer, args || {});
+                    break;
+                case "memories":
+                    result = handleMemories(indexer, args || {});
+                    break;
+                default:
+                    result = `Unknown tool: ${name}`;
+            }
+            return {
+                content: [{ type: "text", text: result }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : "Unknown error";
+            logError(`Tool ${name} failed`, err);
+            return {
+                content: [{ type: "text", text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // Connect via stdio
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    log(`MCP server started for ${rootPath}`);
+    // Handle shutdown
+    process.on("SIGINT", () => {
+        indexer.close();
+        process.exit(0);
+    });
+    process.on("SIGTERM", () => {
+        indexer.close();
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/src/server/mcp-server.js.map

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

package/dist/src/server/tools/dependencies.d.ts

@@ -0,0 +1,29 @@
+import type { Indexer } from "../../indexer/indexer.js";
+export declare const dependenciesTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            path: {
+                type: string;
+                description: string;
+            };
+            direction: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            depth: {
+                type: string;
+                description: string;
+            };
+            token_budget: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleDependencies(indexer: Indexer, args: Record<string, unknown>): string;

package/dist/src/server/tools/dependencies.js

@@ -0,0 +1,118 @@
+export const dependenciesTool = {
+    name: "dependencies",
+    description: "Show what a file imports/depends on and what depends on it. Helps understand the impact of changing a file.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            path: {
+                type: "string",
+                description: "File path to analyze",
+            },
+            direction: {
+                type: "string",
+                enum: ["imports", "importers", "both"],
+                description: "Direction of dependencies (default: both)",
+            },
+            depth: {
+                type: "number",
+                description: "How many levels deep to traverse (default: 1)",
+            },
+            token_budget: {
+                type: "number",
+                description: "Max tokens to return (default: 2000)",
+            },
+        },
+        required: ["path"],
+    },
+};
+export function handleDependencies(indexer, args) {
+    const path = args.path;
+    const direction = args.direction || "both";
+    const depth = args.depth || 1;
+    const tokenBudget = args.token_budget || 2000;
+    const file = indexer.fileStore.getByPath(path);
+    if (!file) {
+        return `File not found in index: ${path}`;
+    }
+    const fileCache = new Map();
+    for (const f of indexer.fileStore.getAll()) {
+        fileCache.set(f.id, f);
+    }
+    const parts = [];
+    let remaining = tokenBudget;
+    parts.push(`## Dependencies for ${path}\n`);
+    remaining -= 20;
+    if (direction === "imports" || direction === "both") {
+        parts.push("### This file imports:");
+        remaining -= 10;
+        const visited = new Set();
+        const queue = [
+            { fileId: file.id, depth: 0 },
+        ];
+        while (queue.length > 0) {
+            const { fileId, depth: d } = queue.shift();
+            if (d >= depth)
+                continue;
+            if (visited.has(fileId))
+                continue;
+            visited.add(fileId);
+            const deps = indexer.graphStore.getImports(fileId);
+            for (const dep of deps) {
+                const targetFile = fileCache.get(dep.target_file_id);
+                if (!targetFile)
+                    continue;
+                const indent = "  ".repeat(d + 1);
+                const line = `${indent}→ ${targetFile.path} (${dep.reference_count} refs)`;
+                const cost = Math.ceil(line.length / 3.5);
+                if (remaining < cost)
+                    break;
+                parts.push(line);
+                remaining -= cost;
+                if (d + 1 < depth) {
+                    queue.push({ fileId: dep.target_file_id, depth: d + 1 });
+                }
+            }
+        }
+        if (parts[parts.length - 1] === "### This file imports:") {
+            parts.push("  (none)");
+        }
+        parts.push("");
+    }
+    if (direction === "importers" || direction === "both") {
+        parts.push("### Files that import this:");
+        remaining -= 10;
+        const visited = new Set();
+        const queue = [
+            { fileId: file.id, depth: 0 },
+        ];
+        while (queue.length > 0) {
+            const { fileId, depth: d } = queue.shift();
+            if (d >= depth)
+                continue;
+            if (visited.has(fileId))
+                continue;
+            visited.add(fileId);
+            const importers = indexer.graphStore.getImporters(fileId);
+            for (const imp of importers) {
+                const sourceFile = fileCache.get(imp.source_file_id);
+                if (!sourceFile)
+                    continue;
+                const indent = "  ".repeat(d + 1);
+                const line = `${indent}← ${sourceFile.path} (${imp.reference_count} refs)`;
+                const cost = Math.ceil(line.length / 3.5);
+                if (remaining < cost)
+                    break;
+                parts.push(line);
+                remaining -= cost;
+                if (d + 1 < depth) {
+                    queue.push({ fileId: imp.source_file_id, depth: d + 1 });
+                }
+            }
+        }
+        if (parts[parts.length - 1] === "### Files that import this:") {
+            parts.push("  (none)");
+        }
+    }
+    return parts.join("\n");
+}
+//# sourceMappingURL=dependencies.js.map

package/dist/src/server/tools/dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.js","sourceRoot":"","sources":["../../../../src/server/tools/dependencies.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,6GAA6G;IAC/G,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sBAAsB;aACpC;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC;gBACtC,WAAW,EAAE,2CAA2C;aACzD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+CAA+C;aAC7D;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sCAAsC;aACpD;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;CACF,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAChC,OAAgB,EAChB,IAA6B;IAE7B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAc,CAAC;IACjC,MAAM,SAAS,GAAI,IAAI,CAAC,SAAoB,IAAI,MAAM,CAAC;IACvD,MAAM,KAAK,GAAI,IAAI,CAAC,KAAgB,IAAI,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAI,IAAI,CAAC,YAAuB,IAAI,IAAI,CAAC;IAE1D,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,4BAA4B,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,EAAsB,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;QAC3C,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,SAAS,GAAG,WAAW,CAAC;IAE5B,KAAK,CAAC,IAAI,CAAC,uBAAuB,IAAI,IAAI,CAAC,CAAC;IAC5C,SAAS,IAAI,EAAE,CAAC;IAEhB,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACrC,SAAS,IAAI,EAAE,CAAC;QAEhB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,MAAM,KAAK,GAAwC;YACjD,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;SAC9B,CAAC;QAEF,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;YAC5C,IAAI,CAAC,IAAI,KAAK;gBAAE,SAAS;YACzB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,SAAS;YAClC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAEpB,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YACnD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;gBACrD,IAAI,CAAC,UAAU;oBAAE,SAAS;gBAE1B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAClC,MAAM,IAAI,GAAG,GAAG,MAAM,KAAK,UAAU,CAAC,IAAI,KAAK,GAAG,CAAC,eAAe,QAAQ,CAAC;gBAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;gBAC1C,IAAI,SAAS,GAAG,IAAI;oBAAE,MAAM;gBAE5B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,SAAS,IAAI,IAAI,CAAC;gBAElB,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,CAAC;oBAClB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,cAAc,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC3D,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,wBAAwB,EAAE,CAAC;YACzD,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,SAAS,KAAK,WAAW,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC1C,SAAS,IAAI,EAAE,CAAC;QAEhB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,MAAM,KAAK,GAAwC;YACjD,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;SAC9B,CAAC;QAEF,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;YAC5C,IAAI,CAAC,IAAI,KAAK;gBAAE,SAAS;YACzB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,SAAS;YAClC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAEpB,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAC1D,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;gBAC5B,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;gBACrD,IAAI,CAAC,UAAU;oBAAE,SAAS;gBAE1B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAClC,MAAM,IAAI,GAAG,GAAG,MAAM,KAAK,UAAU,CAAC,IAAI,KAAK,GAAG,CAAC,eAAe,QAAQ,CAAC;gBAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;gBAC1C,IAAI,SAAS,GAAG,IAAI;oBAAE,MAAM;gBAE5B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,SAAS,IAAI,IAAI,CAAC;gBAElB,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,CAAC;oBAClB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,cAAc,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC3D,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,6BAA6B,EAAE,CAAC;YAC9D,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/src/server/tools/find-references.d.ts

@@ -0,0 +1,20 @@
+import type { Indexer } from "../../indexer/indexer.js";
+export declare const findReferencesTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            symbol: {
+                type: string;
+                description: string;
+            };
+            token_budget: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleFindReferences(indexer: Indexer, args: Record<string, unknown>): string;