@opensip-cli/mcp 0.1.15

package/dist/tools/register.js

@@ -0,0 +1,40 @@
+/**
+ * Mount the MCP tool catalog onto the server (ADR-0084, Phase 4).
+ *
+ * One place that wires every graph + result tool through the server's
+ * scope-wrapping {@link McpStdioServer.register} seam. The host calls this once
+ * (in `command.ts`) after building the ports; each tool reads ONLY its injected
+ * port (never `currentScope()`, never a run-command entry point).
+ */
+import { registerBlastRadius } from './blast-radius.js';
+import { registerCalleesOf } from './callees-of.js';
+import { registerFindDeadCode } from './find-dead-code.js';
+import { registerGetAgentCatalog } from './get-agent-catalog.js';
+import { registerGetArchitecture } from './get-architecture.js';
+import { registerGetLatestFindings } from './get-latest-findings.js';
+import { registerGetSymbol } from './get-symbol.js';
+import { registerListRuns } from './list-runs.js';
+import { registerRefreshGraph } from './refresh-graph.js';
+import { registerSearchSymbols } from './search-symbols.js';
+import { registerShowRun } from './show-run.js';
+import { registerTracePath } from './trace-path.js';
+import { registerWhoCalls } from './who-calls.js';
+/** Register all 13 MCP tools (9 graph + 4 result) on `server`. */
+export function registerMcpTools(server, deps) {
+    // ── Graph tools (over GraphReadPort) ──────────────────────────────
+    registerSearchSymbols(server, deps);
+    registerGetSymbol(server, deps);
+    registerWhoCalls(server, deps);
+    registerCalleesOf(server, deps);
+    registerTracePath(server, deps);
+    registerBlastRadius(server, deps);
+    registerFindDeadCode(server, deps);
+    registerGetArchitecture(server, deps);
+    registerRefreshGraph(server, deps);
+    // ── Result/history tools (over ResultsReadPort — replay only) ─────
+    registerGetAgentCatalog(server, deps);
+    registerListRuns(server, deps);
+    registerShowRun(server, deps);
+    registerGetLatestFindings(server, deps);
+}
+//# sourceMappingURL=register.js.map

package/dist/tools/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../src/tools/register.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAKlD,kEAAkE;AAClE,MAAM,UAAU,gBAAgB,CAAC,MAAsB,EAAE,IAAiB;IACxE,qEAAqE;IACrE,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACpC,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/B,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAClC,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACnC,uBAAuB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtC,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAEnC,qEAAqE;IACrE,uBAAuB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtC,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/B,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC9B,yBAAyB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC1C,CAAC"}

package/dist/tools/schemas.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Per-tool Zod input field schemas (ADR-0084 §Hardening, Phase 7).
+ *
+ * Every MCP tool declares a Zod **raw shape** as its `inputSchema`; the SDK
+ * validates arguments against it BEFORE the wrapped handler runs, so a malformed
+ * `symbolId`, an out-of-range `depth`, or a `..`-traversal `file` is rejected at
+ * the trust boundary and never reaches a port. These are the shared field
+ * builders each tool composes — validation lives here (the boundary), never in
+ * the ports.
+ *
+ * DTOs carry symbol METADATA only; none of these inputs accept raw file bodies.
+ */
+import { z } from 'zod';
+/** Hard depth cap on bounded adjacency walks (bounds memory). */
+export declare const MAX_DEPTH = 5;
+/** Default walk depth when the caller omits it. */
+export declare const DEFAULT_DEPTH = 5;
+/** Hard cap on a caller-supplied `limit` (search / dead-code / architecture rows). */
+export declare const MAX_LIMIT = 500;
+/** Hard cap on a free-text query length (bounds work; search is substring, not regex → no ReDoS). */
+export declare const MAX_QUERY_LEN = 200;
+/** Hard cap on a file-path argument length. */
+export declare const MAX_PATH_LEN = 1024;
+/**
+ * A `symbolId` in the canonical `"${filePath}:${line}:${column}"` shape. The
+ * trailing two colon-groups must be integers; the leading file segment is
+ * unconstrained here (the port resolves it — an unknown id is a structured
+ * not-found, not a validation error).
+ */
+export declare const symbolId: () => z.ZodString;
+/**
+ * A project-relative file path constrained to the project root: no absolute
+ * paths, no `..` traversal segments. The graph catalog keys occurrences by
+ * project-relative path, so a constrained relative path is also the only thing
+ * that can match.
+ */
+export declare const filePath: () => z.ZodString;
+/** A 1-based source line number. */
+export declare const line: () => z.ZodNumber;
+/** A length-bounded free-text search query (substring match — not a regex). */
+export declare const query: () => z.ZodString;
+/** A walk depth, clamped to `[1, MAX_DEPTH]`, defaulting to {@link DEFAULT_DEPTH}. */
+export declare const depth: () => z.ZodDefault<z.ZodNumber>;
+/** An optional result cap, clamped to `[1, MAX_LIMIT]`. */
+export declare const limit: () => z.ZodOptional<z.ZodNumber>;
+/** A registered-tool id (validated against the live registry in the handler). */
+export declare const toolId: () => z.ZodString;
+/** Severity filter for `get_latest_findings`. */
+export declare const severity: () => z.ZodOptional<z.ZodEnum<{
+    errors: "errors";
+    warnings: "warnings";
+    all: "all";
+}>>;
+//# sourceMappingURL=schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/tools/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iEAAiE;AACjE,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,mDAAmD;AACnD,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,sFAAsF;AACtF,eAAO,MAAM,SAAS,MAAM,CAAC;AAC7B,qGAAqG;AACrG,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,+CAA+C;AAC/C,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,mBAKsD,CAAC;AAE5E;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,mBAYhB,CAAC;AAEN,oCAAoC;AACpC,eAAO,MAAM,IAAI,mBAAoC,CAAC;AAEtD,+EAA+E;AAC/E,eAAO,MAAM,KAAK,mBAA6C,CAAC;AAEhE,sFAAsF;AACtF,eAAO,MAAM,KAAK,iCAAsE,CAAC;AAEzF,2DAA2D;AAC3D,eAAO,MAAM,KAAK,kCAA8D,CAAC;AAEjF,iFAAiF;AACjF,eAAO,MAAM,MAAM,mBAAkC,CAAC;AAEtD,iDAAiD;AACjD,eAAO,MAAM,QAAQ;;;;GAAyD,CAAC"}

package/dist/tools/schemas.js

@@ -0,0 +1,59 @@
+/**
+ * Per-tool Zod input field schemas (ADR-0084 §Hardening, Phase 7).
+ *
+ * Every MCP tool declares a Zod **raw shape** as its `inputSchema`; the SDK
+ * validates arguments against it BEFORE the wrapped handler runs, so a malformed
+ * `symbolId`, an out-of-range `depth`, or a `..`-traversal `file` is rejected at
+ * the trust boundary and never reaches a port. These are the shared field
+ * builders each tool composes — validation lives here (the boundary), never in
+ * the ports.
+ *
+ * DTOs carry symbol METADATA only; none of these inputs accept raw file bodies.
+ */
+import { z } from 'zod';
+/** Hard depth cap on bounded adjacency walks (bounds memory). */
+export const MAX_DEPTH = 5;
+/** Default walk depth when the caller omits it. */
+export const DEFAULT_DEPTH = 5;
+/** Hard cap on a caller-supplied `limit` (search / dead-code / architecture rows). */
+export const MAX_LIMIT = 500;
+/** Hard cap on a free-text query length (bounds work; search is substring, not regex → no ReDoS). */
+export const MAX_QUERY_LEN = 200;
+/** Hard cap on a file-path argument length. */
+export const MAX_PATH_LEN = 1024;
+/**
+ * A `symbolId` in the canonical `"${filePath}:${line}:${column}"` shape. The
+ * trailing two colon-groups must be integers; the leading file segment is
+ * unconstrained here (the port resolves it — an unknown id is a structured
+ * not-found, not a validation error).
+ */
+export const symbolId = () => z
+    .string()
+    .min(3)
+    .max(MAX_PATH_LEN + 16)
+    .regex(/^.+:\d+:\d+$/, 'symbolId must be "<filePath>:<line>:<column>"');
+/**
+ * A project-relative file path constrained to the project root: no absolute
+ * paths, no `..` traversal segments. The graph catalog keys occurrences by
+ * project-relative path, so a constrained relative path is also the only thing
+ * that can match.
+ */
+export const filePath = () => z
+    .string()
+    .min(1)
+    .max(MAX_PATH_LEN)
+    .refine((p) => !p.startsWith('/') && !/^[A-Za-z]:[\\/]/.test(p), 'file must be a project-relative path (not absolute)')
+    .refine((p) => !p.split(/[\\/]/).includes('..'), 'file must not contain ".." traversal segments');
+/** A 1-based source line number. */
+export const line = () => z.number().int().positive();
+/** A length-bounded free-text search query (substring match — not a regex). */
+export const query = () => z.string().min(1).max(MAX_QUERY_LEN);
+/** A walk depth, clamped to `[1, MAX_DEPTH]`, defaulting to {@link DEFAULT_DEPTH}. */
+export const depth = () => z.number().int().min(1).max(MAX_DEPTH).default(DEFAULT_DEPTH);
+/** An optional result cap, clamped to `[1, MAX_LIMIT]`. */
+export const limit = () => z.number().int().positive().max(MAX_LIMIT).optional();
+/** A registered-tool id (validated against the live registry in the handler). */
+export const toolId = () => z.string().min(1).max(64);
+/** Severity filter for `get_latest_findings`. */
+export const severity = () => z.enum(['errors', 'warnings', 'all']).optional();
+//# sourceMappingURL=schemas.js.map

package/dist/tools/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/tools/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iEAAiE;AACjE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC;AAC3B,mDAAmD;AACnD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAC/B,sFAAsF;AACtF,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC;AAC7B,qGAAqG;AACrG,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AACjC,+CAA+C;AAC/C,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,EAAE,CAC3B,CAAC;KACE,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,YAAY,GAAG,EAAE,CAAC;KACtB,KAAK,CAAC,cAAc,EAAE,+CAA+C,CAAC,CAAC;AAE5E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,EAAE,CAC3B,CAAC;KACE,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,YAAY,CAAC;KACjB,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EACvD,qDAAqD,CACtD;KACA,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EACvC,+CAA+C,CAChD,CAAC;AAEN,oCAAoC;AACpC,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;AAEtD,+EAA+E;AAC/E,MAAM,CAAC,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AAEhE,sFAAsF;AACtF,MAAM,CAAC,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;AAEzF,2DAA2D;AAC3D,MAAM,CAAC,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAC;AAEjF,iFAAiF;AACjF,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAEtD,iDAAiD;AACjD,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC"}

package/dist/tools/search-symbols.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `search_symbols` — name/substring symbol lookup (ADR-0084, Task 4.1).
+ *
+ * Returns the shared `{ data, freshness, truncated? }` envelope every graph tool
+ * reuses. Each result is a {@link SymbolRef} carrying the stable
+ * `symbolId = "${filePath}:${line}:${column}"` + `bodyHash` — the identity all
+ * downstream graph tools accept (never a bare name). Reads only `graphPort`.
+ */
+import type { McpToolDeps } from './types.js';
+import type { McpStdioServer } from '../server.js';
+export declare function registerSearchSymbols(server: McpStdioServer, deps: McpToolDeps): void;
+//# sourceMappingURL=search-symbols.d.ts.map

package/dist/tools/search-symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-symbols.d.ts","sourceRoot":"","sources":["../../src/tools/search-symbols.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CA2BrF"}

package/dist/tools/search-symbols.js

@@ -0,0 +1,37 @@
+/**
+ * `search_symbols` — name/substring symbol lookup (ADR-0084, Task 4.1).
+ *
+ * Returns the shared `{ data, freshness, truncated? }` envelope every graph tool
+ * reuses. Each result is a {@link SymbolRef} carrying the stable
+ * `symbolId = "${filePath}:${line}:${column}"` + `bodyHash` — the identity all
+ * downstream graph tools accept (never a bare name). Reads only `graphPort`.
+ */
+import { z } from 'zod';
+import { query as querySchema, limit as limitSchema } from './schemas.js';
+import { errorResult, jsonResult } from './tool-result.js';
+export function registerSearchSymbols(server, deps) {
+    server.register('search_symbols', {
+        title: 'Search symbols',
+        description: 'Find functions/methods by name (case-insensitive substring). Returns symbolId ' +
+            '("<filePath>:<line>:<column>") + bodyHash for each match — pass that symbolId to ' +
+            'who_calls, callees_of, blast_radius, or trace_path. Results carry a freshness verdict; ' +
+            'a missing catalog returns empty data (run refresh_graph once to build it).',
+        inputSchema: {
+            query: querySchema(),
+            kind: z.string().min(1).max(32).optional(),
+            limit: limitSchema(),
+        },
+    }, ({ query, kind, limit }) => {
+        const opts = limit === undefined ? undefined : { limit };
+        const outcome = deps.graph.searchSymbols(query, opts);
+        if (!outcome.ok)
+            return errorResult(outcome.error);
+        const result = outcome.value;
+        if (kind === undefined)
+            return jsonResult(result);
+        // Optional kind narrowing is applied post-hoc on the (already capped) page.
+        const filtered = result.data.filter((ref) => ref.kind === kind);
+        return jsonResult({ ...result, data: filtered });
+    });
+}
+//# sourceMappingURL=search-symbols.js.map

package/dist/tools/search-symbols.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-symbols.js","sourceRoot":"","sources":["../../src/tools/search-symbols.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,IAAI,WAAW,EAAE,KAAK,IAAI,WAAW,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAK3D,MAAM,UAAU,qBAAqB,CAAC,MAAsB,EAAE,IAAiB;IAC7E,MAAM,CAAC,QAAQ,CACb,gBAAgB,EAChB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EACT,gFAAgF;YAChF,mFAAmF;YACnF,yFAAyF;YACzF,4EAA4E;QAC9E,WAAW,EAAE;YACX,KAAK,EAAE,WAAW,EAAE;YACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;YAC1C,KAAK,EAAE,WAAW,EAAE;SACrB;KACF,EACD,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;QACzB,MAAM,IAAI,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;QACzD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACtD,IAAI,CAAC,OAAO,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAC7B,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;QAClD,4EAA4E;QAC5E,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAChE,OAAO,UAAU,CAAC,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACnD,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/show-run.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `show_run` — replay one stored run (ADR-0084, Task 4.5).
+ *
+ * Reads `resultsPort.showRun()` ONLY — resolves the ref (a session id or the
+ * `latest` sentinel, which requires `tool`), decodes the persisted payload, and
+ * applies the same agent filters/raw shape as CLI `sessions show`. Carries
+ * session provenance + `recommendedNext`. Never re-runs a tool.
+ */
+import type { McpToolDeps } from './types.js';
+import type { McpStdioServer } from '../server.js';
+export declare function registerShowRun(server: McpStdioServer, deps: McpToolDeps): void;
+//# sourceMappingURL=show-run.d.ts.map

package/dist/tools/show-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show-run.d.ts","sourceRoot":"","sources":["../../src/tools/show-run.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CA+B/E"}

package/dist/tools/show-run.js

@@ -0,0 +1,40 @@
+/**
+ * `show_run` — replay one stored run (ADR-0084, Task 4.5).
+ *
+ * Reads `resultsPort.showRun()` ONLY — resolves the ref (a session id or the
+ * `latest` sentinel, which requires `tool`), decodes the persisted payload, and
+ * applies the same agent filters/raw shape as CLI `sessions show`. Carries
+ * session provenance + `recommendedNext`. Never re-runs a tool.
+ */
+import { z } from 'zod';
+import { toolId as toolIdSchema } from './schemas.js';
+import { errorResult, jsonResult, unknownToolError } from './tool-result.js';
+export function registerShowRun(server, deps) {
+    server.register('show_run', {
+        title: 'Show an OpenSIP run',
+        description: 'Replay a stored OpenSIP run by id, or "latest" (with `tool`). Returns the decoded ' +
+            'finding envelope plus session provenance and recommendedNext commands — the same ' +
+            'filters/raw shape as `opensip sessions show`. Use `filters` (e.g. errors-only, ' +
+            'warnings-only, top:N) to narrow. Replays persisted data; never re-runs the tool.',
+        inputSchema: {
+            ref: z.string().min(1).max(128),
+            tool: toolIdSchema().optional(),
+            filters: z.array(z.string().min(1).max(64)).max(16).optional(),
+            raw: z.boolean().optional(),
+        },
+    }, async ({ ref, tool, filters, raw }) => {
+        if (tool !== undefined && !deps.validToolIds.has(tool)) {
+            return unknownToolError(tool, deps.validToolIds);
+        }
+        const outcome = await deps.results.showRun({
+            ref,
+            ...(tool === undefined ? {} : { tool }),
+            ...(filters === undefined ? {} : { filters }),
+            ...(raw === undefined ? {} : { raw }),
+        });
+        if (!outcome.ok)
+            return errorResult(outcome.error);
+        return jsonResult(outcome.value);
+    });
+}
+//# sourceMappingURL=show-run.js.map

package/dist/tools/show-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show-run.js","sourceRoot":"","sources":["../../src/tools/show-run.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAK7E,MAAM,UAAU,eAAe,CAAC,MAAsB,EAAE,IAAiB;IACvE,MAAM,CAAC,QAAQ,CACb,UAAU,EACV;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,oFAAoF;YACpF,mFAAmF;YACnF,iFAAiF;YACjF,kFAAkF;QACpF,WAAW,EAAE;YACX,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;YAC/B,IAAI,EAAE,YAAY,EAAE,CAAC,QAAQ,EAAE;YAC/B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;YAC9D,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SAC5B;KACF,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE;QACpC,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACvD,OAAO,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACnD,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;YACzC,GAAG;YACH,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;YACvC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;YAC7C,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;SACtC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACnD,OAAO,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/tool-result.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shared MCP tool-result helpers (ADR-0084).
+ *
+ * Every graph tool returns the same `{ data, freshness, truncated? }` envelope
+ * (the {@link McpToolResult} the ports already produce); every result tool
+ * returns an {@link McpResultReplay}. Both are serialized into a JSON-RPC reply
+ * the SAME way: a single `text` content item carrying the pretty-printed JSON.
+ *
+ * We deliberately do NOT set `structuredContent` (no per-tool `outputSchema` is
+ * declared — the SDK only honours `structuredContent` against an output schema),
+ * so the JSON text content is the single, widely-compatible payload channel.
+ *
+ * A port/domain failure (`Result` err arm) is surfaced as an `isError: true`
+ * result whose JSON body is the structured {@link McpReadError} — the agent sees
+ * a machine-readable `code` + `message`, never a thrown stack. `throw` stays
+ * reserved for genuine infra failures (the SDK converts those to a JSON-RPC error
+ * frame; the server's `dispatch` logs the decision point).
+ */
+import type { McpReadError } from '../mcp-error.js';
+import type { CallToolResult } from '../server.js';
+/** Serialize a successful tool payload as a single pretty-printed JSON text item. */
+export declare function jsonResult(payload: unknown): CallToolResult;
+/** Surface a structured domain error as an `isError` result (machine-readable body). */
+export declare function errorResult(error: McpReadError): CallToolResult;
+/** Build an inline structured error result from a `code` + `message` pair. */
+export declare function failure(code: string, message: string): CallToolResult;
+/** A structured `unknown-tool` error for a `tool` argument outside the live registry. */
+export declare function unknownToolError(tool: string, valid: ReadonlySet<string>): CallToolResult;
+//# sourceMappingURL=tool-result.d.ts.map

package/dist/tools/tool-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result.d.ts","sourceRoot":"","sources":["../../src/tools/tool-result.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAE3D;AAED,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,CAK/D;AAED,8EAA8E;AAC9E,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAErE;AAED,yFAAyF;AACzF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,cAAc,CAGzF"}

package/dist/tools/tool-result.js

@@ -0,0 +1,39 @@
+/**
+ * Shared MCP tool-result helpers (ADR-0084).
+ *
+ * Every graph tool returns the same `{ data, freshness, truncated? }` envelope
+ * (the {@link McpToolResult} the ports already produce); every result tool
+ * returns an {@link McpResultReplay}. Both are serialized into a JSON-RPC reply
+ * the SAME way: a single `text` content item carrying the pretty-printed JSON.
+ *
+ * We deliberately do NOT set `structuredContent` (no per-tool `outputSchema` is
+ * declared — the SDK only honours `structuredContent` against an output schema),
+ * so the JSON text content is the single, widely-compatible payload channel.
+ *
+ * A port/domain failure (`Result` err arm) is surfaced as an `isError: true`
+ * result whose JSON body is the structured {@link McpReadError} — the agent sees
+ * a machine-readable `code` + `message`, never a thrown stack. `throw` stays
+ * reserved for genuine infra failures (the SDK converts those to a JSON-RPC error
+ * frame; the server's `dispatch` logs the decision point).
+ */
+/** Serialize a successful tool payload as a single pretty-printed JSON text item. */
+export function jsonResult(payload) {
+    return { content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }] };
+}
+/** Surface a structured domain error as an `isError` result (machine-readable body). */
+export function errorResult(error) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify({ error }, null, 2) }],
+        isError: true,
+    };
+}
+/** Build an inline structured error result from a `code` + `message` pair. */
+export function failure(code, message) {
+    return errorResult({ code, message });
+}
+/** A structured `unknown-tool` error for a `tool` argument outside the live registry. */
+export function unknownToolError(tool, valid) {
+    const known = [...valid].sort().join(', ') || '(none registered)';
+    return failure('unknown-tool', `Unknown tool "${tool}". Registered tools: ${known}.`);
+}
+//# sourceMappingURL=tool-result.js.map

package/dist/tools/tool-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result.js","sourceRoot":"","sources":["../../src/tools/tool-result.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,qFAAqF;AACrF,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACjF,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,WAAW,CAAC,KAAmB;IAC7C,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACrE,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,OAAe;IACnD,OAAO,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,KAA0B;IACvE,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,mBAAmB,CAAC;IAClE,OAAO,OAAO,CAAC,cAAc,EAAE,iBAAiB,IAAI,wBAAwB,KAAK,GAAG,CAAC,CAAC;AACxF,CAAC"}

package/dist/tools/trace-path.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `trace_path` — shortest forward call path `from → … → to` (ADR-0084, Task 4.2).
+ *
+ * The third caller of the shared {@link boundedBfs}: resolves both symbolIds via
+ * the port, runs a goal-directed BFS over the forward-call adjacency, and (on a
+ * hit) reconstructs the path via the BFS parent map. No path within the depth
+ * bound returns `{ found: false, path: [] }` — not an error.
+ */
+import type { McpToolDeps } from './types.js';
+import type { McpStdioServer } from '../server.js';
+export declare function registerTracePath(server: McpStdioServer, deps: McpToolDeps): void;
+//# sourceMappingURL=trace-path.d.ts.map

package/dist/tools/trace-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-path.d.ts","sourceRoot":"","sources":["../../src/tools/trace-path.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAiDjF"}

package/dist/tools/trace-path.js

@@ -0,0 +1,57 @@
+/**
+ * `trace_path` — shortest forward call path `from → … → to` (ADR-0084, Task 4.2).
+ *
+ * The third caller of the shared {@link boundedBfs}: resolves both symbolIds via
+ * the port, runs a goal-directed BFS over the forward-call adjacency, and (on a
+ * hit) reconstructs the path via the BFS parent map. No path within the depth
+ * bound returns `{ found: false, path: [] }` — not an error.
+ */
+import { boundedBfs, MAX_WALK_NODES, reconstructPath } from './graph-walk.js';
+import { depth as depthSchema, symbolId as symbolIdSchema } from './schemas.js';
+import { errorResult, failure, jsonResult } from './tool-result.js';
+export function registerTracePath(server, deps) {
+    server.register('trace_path', {
+        title: 'Trace a call path',
+        description: 'Find a forward call path from one symbol to another (fromSymbolId reaches toSymbolId ' +
+            'through calls), within `depth` levels (default 5, max 5). Pass symbolIds from ' +
+            'search_symbols/get_symbol. Returns the ordered path, or { found: false } when none ' +
+            'exists within the bound.',
+        inputSchema: {
+            fromSymbolId: symbolIdSchema(),
+            toSymbolId: symbolIdSchema(),
+            depth: depthSchema(),
+        },
+    }, ({ fromSymbolId, toSymbolId, depth }) => {
+        const from = deps.graph.resolveSymbolId(fromSymbolId);
+        if (!from.ok)
+            return errorResult(from.error);
+        const to = deps.graph.resolveSymbolId(toSymbolId);
+        if (!to.ok)
+            return errorResult(to.error);
+        const fromRef = from.value.data;
+        const toRef = to.value.data;
+        if (fromRef === undefined || toRef === undefined) {
+            const missing = fromRef === undefined ? fromSymbolId : toSymbolId;
+            return failure('symbol-not-found', `Unknown symbolId "${missing}". Obtain valid symbolIds from search_symbols or get_symbol.`);
+        }
+        const graph = deps.graph.calleeGraph();
+        if (!graph.ok)
+            return errorResult(graph.error);
+        const { data: snapshot, freshness } = graph.value;
+        const walk = boundedBfs(snapshot.edges, fromRef.bodyHash, {
+            depth,
+            cap: MAX_WALK_NODES,
+            goal: toRef.bodyHash,
+        });
+        if (!walk.foundGoal) {
+            const data = { found: false, path: [] };
+            return jsonResult({ data, freshness, ...(walk.truncated ? { truncated: true } : {}) });
+        }
+        const path = reconstructPath(walk.parents, fromRef.bodyHash, toRef.bodyHash)
+            .map((hash) => snapshot.resolve(hash))
+            .filter((ref) => ref !== undefined);
+        const data = { found: true, path };
+        return jsonResult({ data, freshness });
+    });
+}
+//# sourceMappingURL=trace-path.js.map

package/dist/tools/trace-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-path.js","sourceRoot":"","sources":["../../src/tools/trace-path.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,KAAK,IAAI,WAAW,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAOpE,MAAM,UAAU,iBAAiB,CAAC,MAAsB,EAAE,IAAiB;IACzE,MAAM,CAAC,QAAQ,CACb,YAAY,EACZ;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,uFAAuF;YACvF,gFAAgF;YAChF,qFAAqF;YACrF,0BAA0B;QAC5B,WAAW,EAAE;YACX,YAAY,EAAE,cAAc,EAAE;YAC9B,UAAU,EAAE,cAAc,EAAE;YAC5B,KAAK,EAAE,WAAW,EAAE;SACrB;KACF,EACD,CAAC,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,EAAE,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QAChC,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;QAC5B,IAAI,OAAO,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACjD,MAAM,OAAO,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC;YAClE,OAAO,OAAO,CACZ,kBAAkB,EAClB,qBAAqB,OAAO,8DAA8D,CAC3F,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACvC,IAAI,CAAC,KAAK,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC;QAClD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE;YACxD,KAAK;YACL,GAAG,EAAE,cAAc;YACnB,IAAI,EAAE,KAAK,CAAC,QAAQ;SACrB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,GAAiB,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;YACtD,OAAO,UAAU,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACzF,CAAC;QACD,MAAM,IAAI,GAAgB,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC;aACtF,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;aACrC,MAAM,CAAC,CAAC,GAAG,EAAoB,EAAE,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC;QACxD,MAAM,IAAI,GAAiB,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACjD,OAAO,UAAU,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IACzC,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/types.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shared registration context for the MCP tools (ADR-0084).
+ *
+ * Each tool file exports a `register<Name>(server, deps)` function; the host
+ * passes the SAME pre-built ports the server captured plus the live set of
+ * registered tool ids (for the result tools' `tool`-argument validation). Tools
+ * read ONLY their injected port — never `currentScope()`, never a run-command
+ * entry point (the `mcp-results-no-rerun` invariant).
+ */
+import type { GraphReadPort } from '../graph-read-port.js';
+import type { ResultsReadPort } from '../results-read-port.js';
+export interface McpToolDeps {
+    /** Pre-built graph read port (graph tools). */
+    readonly graph: GraphReadPort;
+    /** Pre-built results/history read port (result tools). */
+    readonly results: ResultsReadPort;
+    /** The live registered tool ids — `get_latest_findings`/`show_run` validate `tool` against these. */
+    readonly validToolIds: ReadonlySet<string>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,qGAAqG;IACrG,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC5C"}

package/dist/tools/types.js

@@ -0,0 +1,11 @@
+/**
+ * Shared registration context for the MCP tools (ADR-0084).
+ *
+ * Each tool file exports a `register<Name>(server, deps)` function; the host
+ * passes the SAME pre-built ports the server captured plus the live set of
+ * registered tool ids (for the result tools' `tool`-argument validation). Tools
+ * read ONLY their injected port — never `currentScope()`, never a run-command
+ * entry point (the `mcp-results-no-rerun` invariant).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

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

package/dist/tools/who-calls.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `who_calls` — bounded reverse call walk (ADR-0084, Task 4.2).
+ *
+ * Resolves the input `symbolId` via the port (unknown id → structured error),
+ * then runs the shared {@link boundedBfs} over the reverse-call adjacency
+ * snapshot. Cycle-safe, depth-bounded (default 5, max 5), node-capped with a
+ * `truncated` flag. Returns the `{ data, freshness, truncated? }` envelope.
+ */
+import type { McpToolDeps } from './types.js';
+import type { McpStdioServer } from '../server.js';
+export declare function registerWhoCalls(server: McpStdioServer, deps: McpToolDeps): void;
+//# sourceMappingURL=who-calls.d.ts.map

package/dist/tools/who-calls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"who-calls.d.ts","sourceRoot":"","sources":["../../src/tools/who-calls.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAWhF"}

package/dist/tools/who-calls.js

@@ -0,0 +1,21 @@
+/**
+ * `who_calls` — bounded reverse call walk (ADR-0084, Task 4.2).
+ *
+ * Resolves the input `symbolId` via the port (unknown id → structured error),
+ * then runs the shared {@link boundedBfs} over the reverse-call adjacency
+ * snapshot. Cycle-safe, depth-bounded (default 5, max 5), node-capped with a
+ * `truncated` flag. Returns the `{ data, freshness, truncated? }` envelope.
+ */
+import { registerCallWalkTool } from './call-walk-tool.js';
+export function registerWhoCalls(server, deps) {
+    registerCallWalkTool(server, deps.graph, {
+        name: 'who_calls',
+        title: 'Who calls a symbol',
+        description: 'Find the callers of a symbol (reverse call graph), out to `depth` levels (default 5, ' +
+            'max 5). Pass a symbolId from search_symbols/get_symbol. Edges are body-hash-union ' +
+            '(twin-aware): a result is reachable through any occurrence sharing a body. Large fan-in ' +
+            'is node-capped with truncated:true.',
+        graph: (port) => port.callerGraph(),
+    });
+}
+//# sourceMappingURL=who-calls.js.map

package/dist/tools/who-calls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"who-calls.js","sourceRoot":"","sources":["../../src/tools/who-calls.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAK3D,MAAM,UAAU,gBAAgB,CAAC,MAAsB,EAAE,IAAiB;IACxE,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE;QACvC,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,uFAAuF;YACvF,oFAAoF;YACpF,0FAA0F;YAC1F,qCAAqC;QACvC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE;KACpC,CAAC,CAAC;AACL,CAAC"}