contextsliver 0.1.1

package/dist/mcp/tools/cs_blast_radius.js

@@ -0,0 +1,96 @@
+// cs_blast_radius — the flagship tool.
+//
+// Returns all callers (who uses this symbol) and all dependencies (what it uses) up to
+// max_depth hops. If a session_id is given, already-seen symbols are excluded and listed in
+// already_in_context, so the agent doesn't pay for context it already has. This is the core
+// differentiator vs grep/cat — see contextsliver-spec.md §8.
+import { z } from 'zod';
+import { blastRadius } from '../../graph/traverse.js';
+import { pruneBySession, symbolsToMark } from '../../session/pruner.js';
+import { log } from '../../utils/logger.js';
+import { textResponse } from '../responses.js';
+export const csBlastRadiusTool = {
+    register(server, ctx) {
+        server.registerTool('cs_blast_radius', {
+            description: [
+                'Returns all callers (who uses this symbol) and all dependencies (what this symbol uses)',
+                'up to max_depth hops. Use this BEFORE reading any file to understand code connections.',
+                'Much cheaper than cat or grep on entire files.',
+                'If session_id is provided, already-seen symbols are excluded from the response',
+                'and listed in already_in_context. Pass the same session_id to every call this session.',
+            ].join(' '),
+            inputSchema: {
+                symbol_name: z
+                    .string()
+                    .describe('Exact name of the function/class to analyze'),
+                session_id: z
+                    .string()
+                    .optional()
+                    .describe('Session ID for deduplication. Get it from the first cs_get_context call.'),
+                max_depth: z
+                    .number()
+                    .int()
+                    .min(1)
+                    .max(4)
+                    .default(2)
+                    .describe('How many hops to traverse (default 2, max 4)'),
+            },
+        }, async (args) => {
+            const { symbol_name, session_id, max_depth } = args;
+            log(`cs_blast_radius symbol="${symbol_name}" depth=${max_depth}`);
+            const symbolRow = ctx.store.findSymbolByName(symbol_name);
+            if (!symbolRow) {
+                return textResponse({
+                    error: `Symbol '${symbol_name}' not found in index.`,
+                    hint: 'Try cs_search_symbols to find the correct name, or run cs_index_repo to re-index.',
+                }, { annotateTokens: false });
+            }
+            const result = blastRadius(ctx.store.raw, symbolRow.id, max_depth);
+            if (!result) {
+                return textResponse({ error: 'Traversal failed' });
+            }
+            let callers = result.callers;
+            let dependencies = result.dependencies;
+            let skipped = [];
+            if (session_id && ctx.sessionManager.sessionExists(session_id)) {
+                const pruned = pruneBySession(ctx.sessionManager, session_id, {
+                    symbol: result.symbol,
+                    callers,
+                    dependencies,
+                });
+                callers = pruned.callers;
+                dependencies = pruned.dependencies;
+                skipped = pruned.skipped;
+                // Mark as sent only after we've built the response successfully.
+                ctx.sessionManager.markAsSent(session_id, symbolsToMark(pruned));
+            }
+            else if (session_id) {
+                // Caller passed a session_id that doesn't exist — create it lazily so the agent
+                // can start a session from any tool, not just cs_get_context.
+                // (We don't mark anything until next call, to keep semantics simple here.)
+                log(`Unknown session_id; creating session ${session_id}`, 'warn');
+            }
+            const response = {
+                symbol: result.symbol.name,
+                file: result.symbol.file_path,
+                kind: result.symbol.kind,
+                signature: result.symbol.signature,
+                callers: callers.map((s) => ({
+                    name: s.name,
+                    file: s.file_path,
+                    kind: s.kind,
+                })),
+                dependencies: dependencies.map((s) => ({
+                    name: s.name,
+                    file: s.file_path,
+                    kind: s.kind,
+                })),
+                depth_searched: max_depth,
+            };
+            if (skipped.length > 0)
+                response.already_in_context = skipped;
+            return textResponse(response);
+        });
+    },
+};
+//# sourceMappingURL=cs_blast_radius.js.map

package/dist/mcp/tools/cs_blast_radius.js.map

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

package/dist/mcp/tools/cs_get_context.d.ts

@@ -0,0 +1,3 @@
+import type { ToolModule } from '../types.js';
+export declare const csGetContextTool: ToolModule;
+//# sourceMappingURL=cs_get_context.d.ts.map

package/dist/mcp/tools/cs_get_context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cs_get_context.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/cs_get_context.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3D,eAAO,MAAM,gBAAgB,EAAE,UA8E9B,CAAC"}

package/dist/mcp/tools/cs_get_context.js

@@ -0,0 +1,80 @@
+// cs_get_context — lightweight "what is this symbol + its immediate neighbors" tool.
+//
+// Cheaper than cs_blast_radius: only 1-hop callers + dependencies, plus the symbol's own
+// definition. This is also the canonical place to START a session — the response includes a
+// session_id (creating one if not provided) that the agent should pass to subsequent calls.
+import { z } from 'zod';
+import { directNeighbors } from '../../graph/traverse.js';
+import { pruneBySession, symbolsToMark } from '../../session/pruner.js';
+import { log } from '../../utils/logger.js';
+import { textResponse } from '../responses.js';
+export const csGetContextTool = {
+    register(server, ctx) {
+        server.registerTool('cs_get_context', {
+            description: [
+                'Returns a symbol definition plus its immediate (1-hop) callers and dependencies.',
+                'Use this to understand a single symbol quickly. Cheaper than cs_blast_radius.',
+                'Returns a session_id — pass it to every subsequent cs_* call this session to enable',
+                'deduplication (skip context you already have).',
+            ].join(' '),
+            inputSchema: {
+                symbol_name: z
+                    .string()
+                    .describe('Exact name of the function/class/variable to look up'),
+                session_id: z
+                    .string()
+                    .optional()
+                    .describe('Existing session id. Omit to start a new session.'),
+            },
+        }, async (args) => {
+            const { symbol_name, session_id } = args;
+            log(`cs_get_context symbol="${symbol_name}"`);
+            const symbol = ctx.store.findSymbolByName(symbol_name);
+            if (!symbol) {
+                return textResponse({
+                    error: `Symbol '${symbol_name}' not found in index.`,
+                    hint: 'Try cs_search_symbols to locate it, or cs_index_repo to re-index.',
+                }, { annotateTokens: false });
+            }
+            // Resolve or create the session.
+            let sid = session_id;
+            if (sid && !ctx.sessionManager.sessionExists(sid)) {
+                log(`Unknown session_id; creating new session`, 'warn');
+                sid = ctx.sessionManager.createSession(ctx.projectRoot);
+            }
+            else if (!sid) {
+                sid = ctx.sessionManager.createSession(ctx.projectRoot);
+            }
+            const neighbors = directNeighbors(ctx.store.raw, symbol.id);
+            const pruned = pruneBySession(ctx.sessionManager, sid, {
+                symbol,
+                callers: neighbors.callers,
+                dependencies: neighbors.dependencies,
+            });
+            ctx.sessionManager.markAsSent(sid, symbolsToMark(pruned));
+            return textResponse({
+                session_id: sid,
+                symbol: symbol.name,
+                file: symbol.file_path,
+                kind: symbol.kind,
+                signature: symbol.signature,
+                lines: `${symbol.line_start}-${symbol.line_end}`,
+                callers: pruned.callers.map((s) => ({
+                    name: s.name,
+                    file: s.file_path,
+                    kind: s.kind,
+                })),
+                dependencies: pruned.dependencies.map((s) => ({
+                    name: s.name,
+                    file: s.file_path,
+                    kind: s.kind,
+                })),
+                ...(pruned.skipped.length > 0
+                    ? { already_in_context: pruned.skipped }
+                    : {}),
+                hint: 'Pass session_id to subsequent cs_* calls to skip already-sent context.',
+            });
+        });
+    },
+};
+//# sourceMappingURL=cs_get_context.js.map

package/dist/mcp/tools/cs_get_context.js.map

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

package/dist/mcp/tools/cs_index_repo.d.ts

@@ -0,0 +1,3 @@
+import type { ToolModule } from '../types.js';
+export declare const csIndexRepoTool: ToolModule;
+//# sourceMappingURL=cs_index_repo.d.ts.map

package/dist/mcp/tools/cs_index_repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cs_index_repo.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/cs_index_repo.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3D,eAAO,MAAM,eAAe,EAAE,UAwC7B,CAAC"}

package/dist/mcp/tools/cs_index_repo.js

@@ -0,0 +1,45 @@
+// cs_index_repo — trigger a full re-index of the project.
+//
+// Rarely needed in normal use (the file watcher keeps the index fresh after `start`), but
+// useful if the index gets out of sync (e.g. files changed while the server was down, or after
+// a git branch switch). Returns a status summary, not the symbols themselves.
+import { z } from 'zod';
+import { indexRepository } from '../../parser/index.js';
+import { log } from '../../utils/logger.js';
+import { textResponse } from '../responses.js';
+export const csIndexRepoTool = {
+    register(server, ctx) {
+        server.registerTool('cs_index_repo', {
+            description: [
+                'Trigger a full re-index of the project into the SQLite graph. Normally the file watcher',
+                'keeps the index fresh automatically; use this only if the index is out of sync',
+                '(e.g. after a git branch switch with the server stopped). Returns a status summary.',
+            ].join(' '),
+            inputSchema: {
+                force: z
+                    .boolean()
+                    .default(false)
+                    .describe('If true, re-parse every file even if its hash is unchanged.'),
+            },
+        }, async (args) => {
+            const { force } = args;
+            log(`cs_index_repo force=${force}`);
+            try {
+                const result = indexRepository(ctx.store, ctx.projectRoot, { force });
+                return textResponse({
+                    status: 'ok',
+                    files_indexed: result.filesIndexed,
+                    files_skipped: result.filesSkipped,
+                    symbols: result.symbols,
+                    edges: result.edges,
+                    duration_ms: result.durationMs,
+                });
+            }
+            catch (err) {
+                log(`cs_index_repo failed: ${err.message}`, 'error');
+                return textResponse({ status: 'error', message: err.message }, { annotateTokens: false });
+            }
+        });
+    },
+};
+//# sourceMappingURL=cs_index_repo.js.map

package/dist/mcp/tools/cs_index_repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cs_index_repo.js","sourceRoot":"","sources":["../../../src/mcp/tools/cs_index_repo.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,EAAE;AACF,0FAA0F;AAC1F,+FAA+F;AAC/F,8EAA8E;AAC9E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,MAAM,CAAC,MAAM,eAAe,GAAe;IACzC,QAAQ,CAAC,MAAiB,EAAE,GAAgB;QAC1C,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;YACE,WAAW,EAAE;gBACX,yFAAyF;gBACzF,gFAAgF;gBAChF,qFAAqF;aACtF,CAAC,IAAI,CAAC,GAAG,CAAC;YACX,WAAW,EAAE;gBACX,KAAK,EAAE,CAAC;qBACL,OAAO,EAAE;qBACT,OAAO,CAAC,KAAK,CAAC;qBACd,QAAQ,CAAC,6DAA6D,CAAC;aAC3E;SACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;YACb,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;YACvB,GAAG,CAAC,uBAAuB,KAAK,EAAE,CAAC,CAAC;YACpC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;gBACtE,OAAO,YAAY,CAAC;oBAClB,MAAM,EAAE,IAAI;oBACZ,aAAa,EAAE,MAAM,CAAC,YAAY;oBAClC,aAAa,EAAE,MAAM,CAAC,YAAY;oBAClC,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,WAAW,EAAE,MAAM,CAAC,UAAU;iBAC/B,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,GAAG,CAAC,yBAA0B,GAAa,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;gBAChE,OAAO,YAAY,CACjB,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAG,GAAa,CAAC,OAAO,EAAE,EACpD,EAAE,cAAc,EAAE,KAAK,EAAE,CAC1B,CAAC;YACJ,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/tools/cs_index_status.d.ts

@@ -0,0 +1,3 @@
+import type { ToolModule } from '../types.js';
+export declare const csIndexStatusTool: ToolModule;
+//# sourceMappingURL=cs_index_status.d.ts.map

package/dist/mcp/tools/cs_index_status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cs_index_status.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/cs_index_status.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3D,eAAO,MAAM,iBAAiB,EAAE,UAgC/B,CAAC"}

package/dist/mcp/tools/cs_index_status.js

@@ -0,0 +1,31 @@
+import { log } from '../../utils/logger.js';
+import { textResponse } from '../responses.js';
+export const csIndexStatusTool = {
+    register(server, ctx) {
+        server.registerTool('cs_index_status', {
+            description: [
+                'Report the health of the index: number of files, symbols, edges, and when the index was',
+                'last updated. Use this to check whether the index is fresh before relying on',
+                'cs_get_context / cs_blast_radius results.',
+            ].join(' '),
+            inputSchema: {},
+        }, async () => {
+            log('cs_index_status');
+            const stats = ctx.store.stats();
+            const lastIndexed = stats.lastIndexedAt
+                ? new Date(stats.lastIndexedAt).toISOString()
+                : null;
+            return textResponse({
+                status: stats.files > 0 ? 'ok' : 'empty',
+                files: stats.files,
+                symbols: stats.symbols,
+                edges: stats.edges,
+                last_indexed: lastIndexed,
+                hint: stats.files === 0
+                    ? 'Index is empty. Run cs_index_repo to populate it.'
+                    : undefined,
+            });
+        });
+    },
+};
+//# sourceMappingURL=cs_index_status.js.map

package/dist/mcp/tools/cs_index_status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cs_index_status.js","sourceRoot":"","sources":["../../../src/mcp/tools/cs_index_status.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,MAAM,CAAC,MAAM,iBAAiB,GAAe;IAC3C,QAAQ,CAAC,MAAiB,EAAE,GAAgB;QAC1C,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;YACE,WAAW,EAAE;gBACX,yFAAyF;gBACzF,8EAA8E;gBAC9E,2CAA2C;aAC5C,CAAC,IAAI,CAAC,GAAG,CAAC;YACX,WAAW,EAAE,EAAE;SAChB,EACD,KAAK,IAAI,EAAE;YACT,GAAG,CAAC,iBAAiB,CAAC,CAAC;YACvB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YAChC,MAAM,WAAW,GAAG,KAAK,CAAC,aAAa;gBACrC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE;gBAC7C,CAAC,CAAC,IAAI,CAAC;YACT,OAAO,YAAY,CAAC;gBAClB,MAAM,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO;gBACxC,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,YAAY,EAAE,WAAW;gBACzB,IAAI,EACF,KAAK,CAAC,KAAK,KAAK,CAAC;oBACf,CAAC,CAAC,mDAAmD;oBACrD,CAAC,CAAC,SAAS;aAChB,CAAC,CAAC;QACL,CAAC,CACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/tools/cs_search_symbols.d.ts

@@ -0,0 +1,3 @@
+import type { ToolModule } from '../types.js';
+export declare const csSearchSymbolsTool: ToolModule;
+//# sourceMappingURL=cs_search_symbols.d.ts.map

package/dist/mcp/tools/cs_search_symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cs_search_symbols.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/cs_search_symbols.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3D,eAAO,MAAM,mBAAmB,EAAE,UAiDjC,CAAC"}

package/dist/mcp/tools/cs_search_symbols.js

@@ -0,0 +1,51 @@
+// cs_search_symbols — full-text-ish search across all indexed symbols.
+//
+// Use this when you don't know the exact name or location of a symbol. Substring-matches on
+// symbol name + file path, prioritizing exact-ish name hits. Much cheaper than find/grep on
+// the whole repo, since it only searches the symbol index.
+import { z } from 'zod';
+import { log } from '../../utils/logger.js';
+import { textResponse } from '../responses.js';
+export const csSearchSymbolsTool = {
+    register(server, ctx) {
+        server.registerTool('cs_search_symbols', {
+            description: [
+                'Search across all indexed symbols (functions, classes, interfaces, types) by name',
+                'or file path. Use this instead of find/grep to locate a symbol. Returns matches with',
+                'their file + kind + line range.',
+            ].join(' '),
+            inputSchema: {
+                query: z
+                    .string()
+                    .min(1)
+                    .describe('Substring to search for in symbol names or file paths'),
+                limit: z
+                    .number()
+                    .int()
+                    .min(1)
+                    .max(100)
+                    .default(20)
+                    .describe('Max results to return (default 20)'),
+            },
+        }, async (args) => {
+            const { query, limit } = args;
+            log(`cs_search_symbols query="${query}" limit=${limit}`);
+            const matches = ctx.store.searchSymbols(query, limit);
+            if (matches.length === 0) {
+                return textResponse({ query, results: [], hint: 'No matches. Try cs_index_repo if the index is stale.' }, { annotateTokens: false });
+            }
+            return textResponse({
+                query,
+                count: matches.length,
+                results: matches.map((m) => ({
+                    name: m.name,
+                    kind: m.kind,
+                    file: m.file_path,
+                    lines: `${m.line_start}-${m.line_end}`,
+                    signature: m.signature,
+                })),
+            });
+        });
+    },
+};
+//# sourceMappingURL=cs_search_symbols.js.map

package/dist/mcp/tools/cs_search_symbols.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cs_search_symbols.js","sourceRoot":"","sources":["../../../src/mcp/tools/cs_search_symbols.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,EAAE;AACF,4FAA4F;AAC5F,4FAA4F;AAC5F,2DAA2D;AAC3D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,QAAQ,CAAC,MAAiB,EAAE,GAAgB;QAC1C,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;YACE,WAAW,EAAE;gBACX,mFAAmF;gBACnF,sFAAsF;gBACtF,iCAAiC;aAClC,CAAC,IAAI,CAAC,GAAG,CAAC;YACX,WAAW,EAAE;gBACX,KAAK,EAAE,CAAC;qBACL,MAAM,EAAE;qBACR,GAAG,CAAC,CAAC,CAAC;qBACN,QAAQ,CAAC,uDAAuD,CAAC;gBACpE,KAAK,EAAE,CAAC;qBACL,MAAM,EAAE;qBACR,GAAG,EAAE;qBACL,GAAG,CAAC,CAAC,CAAC;qBACN,GAAG,CAAC,GAAG,CAAC;qBACR,OAAO,CAAC,EAAE,CAAC;qBACX,QAAQ,CAAC,oCAAoC,CAAC;aAClD;SACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;YACb,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;YAC9B,GAAG,CAAC,4BAA4B,KAAK,WAAW,KAAK,EAAE,CAAC,CAAC;YAEzD,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACtD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,YAAY,CACjB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,sDAAsD,EAAE,EACpF,EAAE,cAAc,EAAE,KAAK,EAAE,CAC1B,CAAC;YACJ,CAAC;YACD,OAAO,YAAY,CAAC;gBAClB,KAAK;gBACL,KAAK,EAAE,OAAO,CAAC,MAAM;gBACrB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC3B,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,IAAI,EAAE,CAAC,CAAC,SAAS;oBACjB,KAAK,EAAE,GAAG,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,QAAQ,EAAE;oBACtC,SAAS,EAAE,CAAC,CAAC,SAAS;iBACvB,CAAC,CAAC;aACJ,CAAC,CAAC;QACL,CAAC,CACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/tools/index.d.ts

@@ -0,0 +1,4 @@
+import type { ToolModule } from '../types.js';
+/** Every tool ContextSliver exposes. Order is the order tools appear in tool listings. */
+export declare const ALL_TOOLS: ToolModule[];
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAO9C,0FAA0F;AAC1F,eAAO,MAAM,SAAS,EAAE,UAAU,EAMjC,CAAC"}

package/dist/mcp/tools/index.js

@@ -0,0 +1,14 @@
+import { csIndexRepoTool } from './cs_index_repo.js';
+import { csGetContextTool } from './cs_get_context.js';
+import { csBlastRadiusTool } from './cs_blast_radius.js';
+import { csSearchSymbolsTool } from './cs_search_symbols.js';
+import { csIndexStatusTool } from './cs_index_status.js';
+/** Every tool ContextSliver exposes. Order is the order tools appear in tool listings. */
+export const ALL_TOOLS = [
+    csGetContextTool,
+    csBlastRadiusTool,
+    csSearchSymbolsTool,
+    csIndexStatusTool,
+    csIndexRepoTool,
+];
+//# sourceMappingURL=index.js.map

package/dist/mcp/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,0FAA0F;AAC1F,MAAM,CAAC,MAAM,SAAS,GAAiB;IACrC,gBAAgB;IAChB,iBAAiB;IACjB,mBAAmB;IACnB,iBAAiB;IACjB,eAAe;CAChB,CAAC"}

package/dist/mcp/types.d.ts

@@ -0,0 +1,22 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { GraphStore } from '../graph/store.js';
+import type { SessionManager } from '../session/manager.js';
+/** Dependencies passed to every tool handler. */
+export interface ToolContext {
+    /** the graph store (read + write for re-index tools) */
+    store: GraphStore;
+    /** session ledger manager (for dedup) */
+    sessionManager: SessionManager;
+    /** absolute project root */
+    projectRoot: string;
+}
+/**
+ * A tool module: registers itself on the server using the current high-level MCP SDK API
+ * (server.registerTool with a Zod raw-shape inputSchema). Each tool lives in its own file
+ * and exports a `register(server, ctx)` function; tools/index.ts collects them.
+ */
+export type ToolModule = {
+    /** Register the tool on the given McpServer, closing over ctx. */
+    register: (server: McpServer, ctx: ToolContext) => void;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,KAAK,EAAE,UAAU,CAAC;IAClB,yCAAyC;IACzC,cAAc,EAAE,cAAc,CAAC;IAC/B,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,kEAAkE;IAClE,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,KAAK,IAAI,CAAC;CACzD,CAAC"}

package/dist/mcp/types.js

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

package/dist/mcp/types.js.map

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

package/dist/parser/extractor.d.ts

@@ -0,0 +1,16 @@
+import Parser, { Query } from 'tree-sitter';
+import type { LanguagePlugin } from './languages/registry.js';
+import type { ParseResult } from './types.js';
+/** Build (or fetch) a cached Query for a plugin's default grammar. */
+export declare function getQuery(plugin: LanguagePlugin): Query;
+/** Build (or fetch) a cached Parser for a plugin. */
+export declare function getParser(plugin: LanguagePlugin): Parser;
+/**
+ * Extract symbols + imports from source code.
+ *
+ * @param source  - raw file text
+ * @param plugin  - the language plugin (provides grammar + query)
+ * @param filePath - used only to pick tsx vs ts grammar for the TS family
+ */
+export declare function extractSymbols(source: string, plugin: LanguagePlugin, filePath?: string): ParseResult;
+//# sourceMappingURL=extractor.d.ts.map

package/dist/parser/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/parser/extractor.ts"],"names":[],"mappings":"AAcA,OAAO,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,OAAO,KAAK,EAGV,WAAW,EACZ,MAAM,YAAY,CAAC;AASpB,sEAAsE;AACtE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,KAAK,CActD;AAED,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAQxD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,EACtB,QAAQ,CAAC,EAAE,MAAM,GAChB,WAAW,CAgHb"}