purecontext-mcp 1.0.1

package/dist/server/tools/get-graph.js

@@ -0,0 +1,168 @@
+import { z } from 'zod';
+import { openDatabase } from '../../core/db/schema.js';
+import { getAllDepEdges } from '../../core/db/dep-store.js';
+import { buildMeta } from './_meta.js';
+export const name = 'get_graph';
+export const description = 'Return the dependency graph for a repository as nodes and edges. ' +
+    'Nodes represent files; edges represent import relationships. ' +
+    'Optionally focus on a specific file and limit traversal depth.';
+export const inputSchema = {
+    repoId: z.string().describe('Repo ID from index_folder or resolve_repo'),
+    filePath: z
+        .string()
+        .optional()
+        .describe('Focus file (relative to repo root). When set, only nodes within `depth` hops are returned.'),
+    depth: z
+        .number()
+        .int()
+        .min(1)
+        .max(10)
+        .optional()
+        .default(3)
+        .describe('Max hops from focus file (1–10). Only used when filePath is set.'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(500)
+        .optional()
+        .default(200)
+        .describe('Maximum number of nodes to return (1–500).'),
+};
+// ─── BFS helpers ──────────────────────────────────────────────────────────────
+function buildAdjacency(edges) {
+    const adj = new Map();
+    for (const e of edges) {
+        if (!adj.has(e.sourceFile))
+            adj.set(e.sourceFile, new Set());
+        if (!adj.has(e.targetFile))
+            adj.set(e.targetFile, new Set());
+        adj.get(e.sourceFile).add(e.targetFile);
+        adj.get(e.targetFile).add(e.sourceFile); // bidirectional for reachability
+    }
+    return adj;
+}
+function bfsNodes(start, adj, depth) {
+    const visited = new Set([start]);
+    let frontier = [start];
+    for (let d = 0; d < depth; d++) {
+        const next = [];
+        for (const node of frontier) {
+            for (const neighbor of adj.get(node) ?? []) {
+                if (!visited.has(neighbor)) {
+                    visited.add(neighbor);
+                    next.push(neighbor);
+                }
+            }
+        }
+        frontier = next;
+        if (frontier.length === 0)
+            break;
+    }
+    return visited;
+}
+function basename(filePath) {
+    const parts = filePath.replace(/\\/g, '/').split('/');
+    return parts[parts.length - 1] ?? filePath;
+}
+// ─── Handler ──────────────────────────────────────────────────────────────────
+export function handler(args) {
+    const t0 = Date.now();
+    const depth = args.depth ?? 3;
+    const limit = args.limit ?? 200;
+    const db = openDatabase(args.repoId);
+    const allEdges = getAllDepEdges(db, args.repoId);
+    // Build per-file symbol counts from dep edges (approximation using distinct files)
+    const symbolCountMap = new Map();
+    try {
+        const rows = db
+            .prepare('SELECT file_path, COUNT(*) as cnt FROM symbols WHERE repo_id = ? GROUP BY file_path')
+            .all(args.repoId);
+        for (const row of rows) {
+            symbolCountMap.set(row.file_path, row.cnt);
+        }
+    }
+    catch {
+        // symbols table may be empty — continue without counts
+    }
+    db.close();
+    // Determine which files are in scope
+    let scopedFiles = null;
+    if (args.filePath) {
+        const adj = buildAdjacency(allEdges);
+        scopedFiles = bfsNodes(args.filePath, adj, depth);
+    }
+    // Filter edges to scope
+    const scopedEdges = scopedFiles
+        ? allEdges.filter((e) => scopedFiles.has(e.sourceFile) && scopedFiles.has(e.targetFile))
+        : allEdges;
+    // Collect unique file nodes from edges
+    const fileSet = new Set();
+    for (const e of scopedEdges) {
+        fileSet.add(e.sourceFile);
+        fileSet.add(e.targetFile);
+    }
+    // Also include the focus file itself (might be isolated)
+    if (args.filePath)
+        fileSet.add(args.filePath);
+    // Apply node limit (prefer files with more edges — keep most connected)
+    const fileDegrees = new Map();
+    for (const e of scopedEdges) {
+        fileDegrees.set(e.sourceFile, (fileDegrees.get(e.sourceFile) ?? 0) + 1);
+        fileDegrees.set(e.targetFile, (fileDegrees.get(e.targetFile) ?? 0) + 1);
+    }
+    let sortedFiles = [...fileSet].sort((a, b) => (fileDegrees.get(b) ?? 0) - (fileDegrees.get(a) ?? 0));
+    const truncated = sortedFiles.length > limit;
+    if (truncated) {
+        // Always keep focus file
+        if (args.filePath) {
+            sortedFiles = [
+                args.filePath,
+                ...sortedFiles.filter((f) => f !== args.filePath).slice(0, limit - 1),
+            ];
+        }
+        else {
+            sortedFiles = sortedFiles.slice(0, limit);
+        }
+    }
+    const keptFiles = new Set(sortedFiles);
+    // Build nodes
+    const nodes = sortedFiles.map((filePath) => ({
+        id: filePath,
+        data: {
+            label: basename(filePath),
+            path: filePath,
+            symbolCount: symbolCountMap.get(filePath) ?? 0,
+        },
+    }));
+    // Build edges (only between kept nodes, deduplicate)
+    const edgeIds = new Set();
+    const edges = [];
+    for (const e of scopedEdges) {
+        if (!keptFiles.has(e.sourceFile) || !keptFiles.has(e.targetFile))
+            continue;
+        const edgeId = `${e.sourceFile}→${e.targetFile}`;
+        if (edgeIds.has(edgeId))
+            continue;
+        edgeIds.add(edgeId);
+        edges.push({
+            id: edgeId,
+            source: e.sourceFile,
+            target: e.targetFile,
+            data: { edgeType: e.edgeType, specifier: e.specifier },
+        });
+    }
+    const response = {
+        repoId: args.repoId,
+        nodeCount: nodes.length,
+        edgeCount: edges.length,
+        nodes,
+        edges,
+        truncated,
+        _meta: buildMeta({ timingMs: Date.now() - t0 }),
+    };
+    return {
+        content: [{ type: 'text', text: JSON.stringify(response, null, 2) }],
+    };
+}
+//# sourceMappingURL=get-graph.js.map

package/dist/server/tools/get-graph.js.map

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

package/dist/server/tools/get-layer-violations.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import type { LayerDefinition, LayerRule } from '../../config/config-schema.js';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const name = "get_layer_violations";
+export declare const description: string;
+export declare const inputSchema: {
+    repoId: z.ZodString;
+    layers: z.ZodOptional<z.ZodObject<{
+        definitions: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            paths: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+        rules: z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+            allowed: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+};
+/**
+ * Determine which layer a file belongs to.
+ * Returns the name of the first matching layer definition, or 'unclassified'.
+ */
+export declare function assignLayer(filePath: string, definitions: LayerDefinition[]): string;
+/**
+ * Check whether `from → to` is an allowed direction.
+ * Any pair not explicitly listed in rules is treated as allowed (opt-in violation detection).
+ */
+export declare function isAllowed(from: string, to: string, rules: LayerRule[]): boolean;
+export declare function handler(args: {
+    repoId: string;
+    layers?: {
+        definitions: LayerDefinition[];
+        rules: LayerRule[];
+    };
+}): CallToolResult;
+//# sourceMappingURL=get-layer-violations.d.ts.map

package/dist/server/tools/get-layer-violations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-layer-violations.d.ts","sourceRoot":"","sources":["../../../src/server/tools/get-layer-violations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAgB,MAAM,+BAA+B,CAAC;AAC9F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,IAAI,yBAAyB,CAAC;AAE3C,eAAO,MAAM,WAAW,QAG8C,CAAC;AAevE,eAAO,MAAM,WAAW;;;;;;;;;;;;;CAWvB,CAAC;AAcF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,GAAG,MAAM,CASpF;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAO/E;AAID,wBAAgB,OAAO,CAAC,IAAI,EAAE;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE;QAAE,WAAW,EAAE,eAAe,EAAE,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE,CAAC;CACjE,GAAG,cAAc,CAgGjB"}

package/dist/server/tools/get-layer-violations.js

@@ -0,0 +1,138 @@
+import { z } from 'zod';
+import { minimatch } from 'minimatch';
+import { openDatabase, getRepo } from '../../core/db/schema.js';
+import { getAllDepEdges } from '../../core/db/dep-store.js';
+import { getConfig } from '../../config/config-loader.js';
+export const name = 'get_layer_violations';
+export const description = 'Analyse the dependency graph for architectural layer violations. ' +
+    'Checks that files only import in allowed directions (e.g. core must not import handlers). ' +
+    'Layer definitions can be provided inline or read from config.json.';
+// ─── Input schema ─────────────────────────────────────────────────────────────
+const layerDefinitionSchema = z.object({
+    name: z.string().describe('Layer name'),
+    paths: z.array(z.string()).describe('Glob patterns for files in this layer'),
+});
+const layerRuleSchema = z.object({
+    from: z.string().describe('Source layer name'),
+    to: z.string().describe('Target layer name'),
+    allowed: z.boolean().describe('Whether this direction is allowed'),
+});
+export const inputSchema = {
+    repoId: z.string().describe('Repo ID from index_folder or resolve_repo'),
+    layers: z
+        .object({
+        definitions: z.array(layerDefinitionSchema),
+        rules: z.array(layerRuleSchema),
+    })
+        .optional()
+        .describe('Layer definitions and rules. If omitted, reads from config.json layers field.'),
+};
+// ─── Layer assignment ─────────────────────────────────────────────────────────
+/**
+ * Determine which layer a file belongs to.
+ * Returns the name of the first matching layer definition, or 'unclassified'.
+ */
+export function assignLayer(filePath, definitions) {
+    for (const def of definitions) {
+        for (const pattern of def.paths) {
+            if (minimatch(filePath, pattern, { matchBase: false, dot: true })) {
+                return def.name;
+            }
+        }
+    }
+    return 'unclassified';
+}
+/**
+ * Check whether `from → to` is an allowed direction.
+ * Any pair not explicitly listed in rules is treated as allowed (opt-in violation detection).
+ */
+export function isAllowed(from, to, rules) {
+    for (const rule of rules) {
+        if (rule.from === from && rule.to === to) {
+            return rule.allowed;
+        }
+    }
+    return true; // unlisted = allowed
+}
+// ─── Handler ──────────────────────────────────────────────────────────────────
+export function handler(args) {
+    // ── Resolve layer config ────────────────────────────────────────────────────
+    let layersConfig;
+    if (args.layers) {
+        layersConfig = args.layers;
+    }
+    else {
+        const cfg = getConfig();
+        layersConfig = cfg.layers;
+    }
+    if (!layersConfig) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: 'No layer config found. Provide a layers argument or add a layers config to ~/.purecontext/config.json.',
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    const { definitions, rules } = layersConfig;
+    // ── Open DB and verify repo ─────────────────────────────────────────────────
+    const db = openDatabase(args.repoId);
+    const repo = getRepo(db, args.repoId);
+    if (!repo) {
+        db.close();
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: `Repo "${args.repoId}" not found` }) }],
+            isError: true,
+        };
+    }
+    // ── Load all dep edges ──────────────────────────────────────────────────────
+    const edges = getAllDepEdges(db, args.repoId);
+    db.close();
+    // ── Detect violations ───────────────────────────────────────────────────────
+    const violations = [];
+    const byLayerPair = {};
+    for (const edge of edges) {
+        const sourceLayer = assignLayer(edge.sourceFile, definitions);
+        const targetLayer = assignLayer(edge.targetFile, definitions);
+        // Skip unclassified files — they would generate noise
+        if (sourceLayer === 'unclassified' || targetLayer === 'unclassified')
+            continue;
+        // Self-layer imports are always fine
+        if (sourceLayer === targetLayer)
+            continue;
+        if (!isAllowed(sourceLayer, targetLayer, rules)) {
+            violations.push({
+                from_layer: sourceLayer,
+                to_layer: targetLayer,
+                from_file: edge.sourceFile,
+                to_file: edge.targetFile,
+                import_spec: edge.specifier,
+            });
+            const key = `${sourceLayer} → ${targetLayer}`;
+            byLayerPair[key] = (byLayerPair[key] ?? 0) + 1;
+        }
+    }
+    const layersAnalyzed = definitions.map((d) => d.name);
+    const _tokenEstimate = Math.ceil(violations.reduce((n, v) => n + v.from_file.length + v.to_file.length + 30, 0) / 4);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    violations,
+                    summary: {
+                        total_violations: violations.length,
+                        by_layer_pair: byLayerPair,
+                    },
+                    layers_analyzed: layersAnalyzed,
+                    _tokenEstimate,
+                }, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=get-layer-violations.js.map

package/dist/server/tools/get-layer-violations.js.map

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

package/dist/server/tools/get-repo-outline.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const name = "get_repo_outline";
+export declare const description: string;
+export declare const inputSchema: {
+    repoId: z.ZodString;
+    limit: z.ZodOptional<z.ZodNumber>;
+};
+export declare function handler(args: {
+    repoId: string;
+    limit?: number;
+}): CallToolResult;
+//# sourceMappingURL=get-repo-outline.d.ts.map

package/dist/server/tools/get-repo-outline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-repo-outline.d.ts","sourceRoot":"","sources":["../../../src/server/tools/get-repo-outline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,IAAI,qBAAqB,CAAC;AAEvC,eAAO,MAAM,WAAW,QAGmC,CAAC;AAE5D,eAAO,MAAM,WAAW;;;CAQvB,CAAC;AAEF,wBAAgB,OAAO,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,cAAc,CAgEhF"}

package/dist/server/tools/get-repo-outline.js

@@ -0,0 +1,72 @@
+import { z } from 'zod';
+import { openDatabase } from '../../core/db/schema.js';
+import { getSymbolsByRepo } from '../../core/db/symbol-store.js';
+import { getFileSizesBatch } from '../../core/db/file-store.js';
+import { buildMeta } from './_meta.js';
+export const name = 'get_repo_outline';
+export const description = 'Get a structural overview of an indexed repo: all files with their top-level symbols. ' +
+    'Useful for understanding project structure before diving into specific files. ' +
+    'Returns signatures and summaries only — no source code.';
+export const inputSchema = {
+    repoId: z.string().describe('Repo ID from index_folder or resolve_repo'),
+    limit: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe('Max symbols per file (default unlimited)'),
+};
+export function handler(args) {
+    const t0 = Date.now();
+    const db = openDatabase(args.repoId);
+    const allSymbols = getSymbolsByRepo(db, args.repoId);
+    // Batch-fetch file sizes for savings calculation
+    const uniqueFiles = [...new Set(allSymbols.map((s) => s.filePath))];
+    const fileSizes = getFileSizesBatch(db, args.repoId, uniqueFiles);
+    db.close();
+    // Group by file
+    const byFile = new Map();
+    for (const s of allSymbols) {
+        let arr = byFile.get(s.filePath);
+        if (!arr) {
+            arr = [];
+            byFile.set(s.filePath, arr);
+        }
+        // Skip method-level symbols in the outline — keep functions/classes/types
+        if (s.kind !== 'method') {
+            arr.push(s);
+        }
+    }
+    const files = Array.from(byFile.entries())
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([filePath, symbols]) => {
+        const limited = args.limit ? symbols.slice(0, args.limit) : symbols;
+        return {
+            filePath,
+            symbols: limited.map((s) => ({
+                id: s.id,
+                name: s.name,
+                kind: s.kind,
+                signature: s.signature,
+                summary: s.summary,
+            })),
+        };
+    });
+    const totalSymbols = files.reduce((n, f) => n + f.symbols.length, 0);
+    const rawBytes = uniqueFiles.reduce((sum, fp) => sum + (fileSizes.get(fp) ?? 0), 0);
+    const responseBytes = allSymbols.reduce((sum, s) => sum + s.name.length + s.signature.length + s.summary.length, 0);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    fileCount: files.length,
+                    totalSymbols,
+                    files,
+                    _meta: buildMeta({ timingMs: Date.now() - t0, rawBytes, responseBytes }),
+                }, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=get-repo-outline.js.map

package/dist/server/tools/get-repo-outline.js.map

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

package/dist/server/tools/get-savings-stats.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const name = "get_savings_stats";
+export declare const description: string;
+export declare const inputSchema: {
+    reset: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+};
+export declare function handler(args: {
+    reset?: boolean;
+}): CallToolResult;
+//# sourceMappingURL=get-savings-stats.d.ts.map

package/dist/server/tools/get-savings-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-savings-stats.d.ts","sourceRoot":"","sources":["../../../src/server/tools/get-savings-stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAWzE,eAAO,MAAM,IAAI,sBAAsB,CAAC;AAExC,eAAO,MAAM,WAAW,QAGiC,CAAC;AAE1D,eAAO,MAAM,WAAW;;CAMvB,CAAC;AAIF,wBAAgB,OAAO,CAAC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,cAAc,CAyCjE"}

package/dist/server/tools/get-savings-stats.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { getTotalSaved, resetSavings, getSessionStart, costAvoided, } from '../../core/token-tracker.js';
+// ─── Context window sizes (in tokens) ────────────────────────────────────────
+const CONTEXT_WINDOWS = {
+    claude_200k: 200_000,
+    gpt4_128k: 128_000,
+};
+// ─── Tool definition ──────────────────────────────────────────────────────────
+export const name = 'get_savings_stats';
+export const description = 'Query cumulative token savings tracked across all PureContext tool calls. ' +
+    'Returns total tokens saved, cost avoided per model tier, and context-window equivalents. ' +
+    'Pass reset:true to clear the counter and start fresh.';
+export const inputSchema = {
+    reset: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Reset the savings counter to zero (returns previous total)'),
+};
+// ─── Handler ──────────────────────────────────────────────────────────────────
+export function handler(args) {
+    if (args.reset) {
+        const previous = resetSavings();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ reset: true, previous_total: previous }, null, 2),
+                },
+            ],
+        };
+    }
+    const total = getTotalSaved();
+    const { total_cost_avoided } = costAvoided(total, total);
+    const equivalent_context_windows = {};
+    for (const [label, size] of Object.entries(CONTEXT_WINDOWS)) {
+        equivalent_context_windows[label] = parseFloat((total / size).toFixed(2));
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    total_tokens_saved: total,
+                    equivalent_context_windows,
+                    total_cost_avoided,
+                    session_start: getSessionStart().toISOString(),
+                    _meta: {
+                        powered_by: 'PureContext MCP',
+                    },
+                }, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=get-savings-stats.js.map

package/dist/server/tools/get-savings-stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-savings-stats.js","sourceRoot":"","sources":["../../../src/server/tools/get-savings-stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,eAAe,EACf,WAAW,GACZ,MAAM,6BAA6B,CAAC;AAGrC,gFAAgF;AAEhF,MAAM,eAAe,GAAG;IACtB,WAAW,EAAE,OAAO;IACpB,SAAS,EAAE,OAAO;CACV,CAAC;AAEX,iFAAiF;AAEjF,MAAM,CAAC,MAAM,IAAI,GAAG,mBAAmB,CAAC;AAExC,MAAM,CAAC,MAAM,WAAW,GACtB,4EAA4E;IAC5E,2FAA2F;IAC3F,uDAAuD,CAAC;AAE1D,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,KAAK,EAAE,CAAC;SACL,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,4DAA4D,CAAC;CAC1E,CAAC;AAEF,iFAAiF;AAEjF,MAAM,UAAU,OAAO,CAAC,IAAyB;IAC/C,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;QAChC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACzE;aACF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,MAAM,EAAE,kBAAkB,EAAE,GAAG,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAEzD,MAAM,0BAA0B,GAA2B,EAAE,CAAC;IAC9D,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QAC5D,0BAA0B,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,kBAAkB,EAAE,KAAK;oBACzB,0BAA0B;oBAC1B,kBAAkB;oBAClB,aAAa,EAAE,eAAe,EAAE,CAAC,WAAW,EAAE;oBAC9C,KAAK,EAAE;wBACL,UAAU,EAAE,iBAAiB;qBAC9B;iBACF,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/server/tools/get-symbol-source.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const name = "get_symbol_source";
+export declare const description: string;
+export declare const inputSchema: {
+    repoId: z.ZodString;
+    symbolId: z.ZodString;
+};
+export declare function handler(args: {
+    repoId: string;
+    symbolId: string;
+}): CallToolResult;
+//# sourceMappingURL=get-symbol-source.d.ts.map

package/dist/server/tools/get-symbol-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-symbol-source.d.ts","sourceRoot":"","sources":["../../../src/server/tools/get-symbol-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,IAAI,sBAAsB,CAAC;AAExC,eAAO,MAAM,WAAW,QAG4C,CAAC;AAErE,eAAO,MAAM,WAAW;;;CAGvB,CAAC;AAkBF,wBAAgB,OAAO,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,cAAc,CAuElF"}