@vitest-agent/mcp 1.0.0

package/index.d.ts

@@ -0,0 +1,1577 @@
+import { DataReader, DataStore, OutputRenderer, ProjectDiscovery } from "@vitest-agent/sdk";
+import { Layer, LogLevel, ManagedRuntime } from "effect";
+import * as NodeContext from "@effect/platform-node/NodeContext";
+import * as SqliteMigrator from "@effect/sql-sqlite-node/SqliteMigrator";
+
+//#region src/context.d.ts
+/**
+ * Mutable holder for the MCP server's currently-associated host chat
+ * id (the per-process CC chat UUID).
+ *
+ * The MCP server is one process per host window, so a single in-memory
+ * ref is enough — no cross-window contention. The bin entry seeds the
+ * value from `process.env.VITEST_AGENT_CHAT_ID` (written by the
+ * SessionStart hook to `CLAUDE_ENV_FILE` and auto-sourced into the MCP
+ * child) or from an explicit positional argv. The legacy
+ * `set_current_session_id` MCP tool was removed in Phase 3.
+ *
+ * @public
+ */
+interface CurrentSessionIdRef {
+  get(): string | null;
+  set(id: string | null): void;
+}
+/**
+ * Creates a new {@link CurrentSessionIdRef} with an optional initial value.
+ *
+ * @param initial - the starting chat id, or `null` when unknown at construction time
+ * @returns a mutable ref holding the current session id
+ * @public
+ */
+declare const createCurrentSessionIdRef: (initial?: string | null) => CurrentSessionIdRef;
+/**
+ * Recovered session attribution context — the canonical UUIDs the
+ * SessionStart hook wrote to `${CLAUDE_ENV_FILE}` so they auto-source
+ * into the MCP server child's `process.env`, with the per-client
+ * session map as a fallback when the env vars are missing (dev /
+ * tests).
+ *
+ * Read by `run_tests` to populate `VITEST_AGENT_AGENT_ID` and friends
+ * on the Vitest child process so the reporter attributes runs back to
+ * the active agent.
+ *
+ * @public
+ */
+interface SessionContext {
+  readonly chatId: string;
+  readonly conversationId: string;
+  readonly mainAgentId: string;
+}
+/**
+ * Mutable ref holding the MCP server's recovered {@link SessionContext}.
+ *
+ * @public
+ */
+interface SessionContextRef {
+  get(): SessionContext | null;
+  set(ctx: SessionContext | null): void;
+}
+/**
+ * Creates a new {@link SessionContextRef} with an optional initial value.
+ *
+ * @param initial - the starting session context, or `null` when not yet recovered
+ * @returns a mutable ref holding the current session context
+ * @public
+ */
+declare const createSessionContextRef: (initial?: SessionContext | null) => SessionContextRef;
+/**
+ * tRPC context carrying a ManagedRuntime for Effect service access.
+ *
+ * The MCP server creates a ManagedRuntime at startup (long-lived
+ * process) and passes it through tRPC context so procedures can
+ * call Effect services via `ctx.runtime.runPromise(effect)`.
+ *
+ * @public
+ */
+interface McpContext {
+  readonly runtime: ManagedRuntime.ManagedRuntime<DataReader | DataStore | ProjectDiscovery | OutputRenderer, never>;
+  readonly cwd: string;
+  readonly currentSessionId: CurrentSessionIdRef;
+  readonly sessionContext: SessionContextRef;
+}
+/**
+ * Factory for creating server-side tRPC callers for the MCP router.
+ *
+ * Use with {@link appRouter} in tests or programmatic contexts to invoke
+ * tool procedures without starting the MCP server.
+ *
+ * @public
+ */
+declare const createCallerFactory: import("@trpc/server").TRPCRouterCallerFactory<{
+  ctx: McpContext;
+  meta: object;
+  errorShape: import("@trpc/server").TRPCDefaultErrorShape;
+  transformer: false;
+}>;
+//#endregion
+//#region src/layers/McpLive.d.ts
+/**
+ * Builds the Effect Layer that provides all services required by the MCP server.
+ *
+ * Composes DataReader, DataStore, ProjectDiscovery, OutputPipeline, SQLite
+ * client, migrator, NodeContext, NodeFileSystem, and the logger into a single
+ * layer suitable for `ManagedRuntime.make`.
+ *
+ * @param dbPath - absolute path to the SQLite database file
+ * @param logLevel - optional log level; defaults to the logger's own default
+ * @param logFile - optional path to write structured log output
+ * @returns an Effect Layer providing all MCP runtime services
+ * @public
+ */
+declare const McpLive: (dbPath: string, logLevel?: LogLevel.LogLevel, logFile?: string) => Layer.Layer<import("@vitest-agent/sdk").DataReader | import("@effect/sql/SqlClient").SqlClient | import("@vitest-agent/sdk").DataStore | import("@vitest-agent/sdk").ProjectDiscovery | import("@vitest-agent/sdk").DetailResolver | import("@vitest-agent/sdk").EnvironmentDetector | import("@vitest-agent/sdk").ExecutorResolver | import("@vitest-agent/sdk").FormatSelector | import("@vitest-agent/sdk").OutputRenderer | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | NodeContext.NodeContext, import("@effect/sql/SqlError").SqlError | SqliteMigrator.MigrationError | import("effect/ConfigError").ConfigError, never>;
+//#endregion
+//#region src/router.d.ts
+/**
+ * The tRPC router aggregating all MCP tool procedures.
+ *
+ * Pass to `createCallerFactory` in tests, or to `createCallerFactory(appRouter)`
+ * followed by `startMcpServer` in the bin entry to start the MCP server.
+ *
+ * @public
+ */
+declare const appRouter: import("@trpc/server").TRPCBuiltRouter<{
+  ctx: McpContext;
+  meta: object;
+  errorShape: import("@trpc/server").TRPCDefaultErrorShape;
+  transformer: false;
+}, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
+  help: import("@trpc/server").TRPCQueryProcedure<{
+    input: void;
+    output: {
+      readonly helpText: string;
+    };
+    meta: object;
+  }>;
+  test_status: import("@trpc/server").TRPCQueryProcedure<{
+    input: {
+      readonly project?: string | undefined;
+    };
+    output: {
+      readonly entries: readonly {
+        readonly project: string;
+        readonly reportFile: string;
+        readonly historyFile?: string | undefined;
+        readonly lastRun: string | null;
+        readonly lastResult: "passed" | "failed" | "interrupted" | null;
+      }[];
+      readonly dataAvailable: true;
+      readonly manifestUpdatedAt: string;
+      readonly projectFilter?: string | undefined;
+    } | {
+      readonly reason: "no_manifest" | "project_filter_empty";
+      readonly dataAvailable: false;
+      readonly projectFilter?: string | undefined;
+    };
+    meta: object;
+  }>;
+  test_overview: import("@trpc/server").TRPCQueryProcedure<{
+    input: {
+      readonly project?: string | undefined;
+    };
+    output: {
+      readonly dataAvailable: true;
+      readonly projectFilter?: string | undefined;
+      readonly runs: readonly {
+        readonly project: string;
+        readonly lastRun: string | null;
+        readonly lastResult: "passed" | "failed" | "interrupted" | null;
+        readonly passed: number;
+        readonly failed: number;
+        readonly total: number;
+        readonly skipped: number;
+      }[];
+    } | {
+      readonly reason: "project_filter_empty" | "no_runs";
+      readonly dataAvailable: false;
+      readonly projectFilter?: string | undefined;
+    };
+    meta: object;
+  }>;
+  test_coverage: import("@trpc/server").TRPCQueryProcedure<{
+    input: {
+      readonly project?: string | undefined;
+    };
+    output: {
+      readonly project: string;
+      readonly dataAvailable: true;
+      readonly coverage: {
+        readonly totals: {
+          readonly statements: number;
+          readonly branches: number;
+          readonly functions: number;
+          readonly lines: number;
+        };
+        readonly thresholds: {
+          readonly global: {
+            readonly statements?: number | undefined;
+            readonly branches?: number | undefined;
+            readonly functions?: number | undefined;
+            readonly lines?: number | undefined;
+          };
+          readonly patterns: readonly (readonly [string, {
+            readonly statements?: number | undefined;
+            readonly branches?: number | undefined;
+            readonly functions?: number | undefined;
+            readonly lines?: number | undefined;
+          }])[];
+        };
+        readonly targets?: {
+          readonly global: {
+            readonly statements?: number | undefined;
+            readonly branches?: number | undefined;
+            readonly functions?: number | undefined;
+            readonly lines?: number | undefined;
+          };
+          readonly patterns: readonly (readonly [string, {
+            readonly statements?: number | undefined;
+            readonly branches?: number | undefined;
+            readonly functions?: number | undefined;
+            readonly lines?: number | undefined;
+          }])[];
+        } | undefined;
+        readonly baselines?: {
+          readonly global: {
+            readonly statements?: number | undefined;
+            readonly branches?: number | undefined;
+            readonly functions?: number | undefined;
+            readonly lines?: number | undefined;
+          };
+          readonly patterns: readonly (readonly [string, {
+            readonly statements?: number | undefined;
+            readonly branches?: number | undefined;
+            readonly functions?: number | undefined;
+            readonly lines?: number | undefined;
+          }])[];
+        } | undefined;
+        readonly scoped: boolean;
+        readonly scopedFiles?: readonly string[] | undefined;
+        readonly lowCoverage: readonly {
+          readonly file: string;
+          readonly summary: {
+            readonly statements: number;
+            readonly branches: number;
+            readonly functions: number;
+            readonly lines: number;
+          };
+          readonly uncoveredLines: string;
+        }[];
+        readonly lowCoverageFiles: readonly string[];
+        readonly belowTarget?: readonly {
+          readonly file: string;
+          readonly summary: {
+            readonly statements: number;
+            readonly branches: number;
+            readonly functions: number;
+            readonly lines: number;
+          };
+          readonly uncoveredLines: string;
+        }[] | undefined;
+        readonly belowTargetFiles?: readonly string[] | undefined;
+      };
+    } | {
+      readonly project: string;
+      readonly dataAvailable: false;
+    };
+    meta: object;
+  }>;
+  test_history: import("@trpc/server").TRPCQueryProcedure<{
+    input: {
+      readonly project: string;
+    };
+    output: {
+      readonly project: string;
+      readonly hasData: boolean;
+      readonly history: {
+        readonly project: string;
+        readonly updatedAt: string;
+        readonly tests: readonly {
+          readonly runs: readonly {
+            readonly timestamp: string;
+            readonly state: "passed" | "failed";
+          }[];
+          readonly fullName: string;
+        }[];
+      };
+      readonly flaky: readonly {
+        readonly project: string;
+        readonly fullName: string;
+        readonly passCount: number;
+        readonly failCount: number;
+        readonly lastState: "passed" | "failed";
+        readonly lastTimestamp: string;
+      }[];
+      readonly persistent: readonly {
+        readonly project: string;
+        readonly fullName: string;
+        readonly consecutiveFailures: number;
+        readonly firstFailedAt: string;
+        readonly lastFailedAt: string;
+        readonly lastErrorMessage: string | null;
+      }[];
+      readonly recovered: readonly {
+        readonly fullName: string;
+        readonly recentRuns: readonly ("passed" | "failed")[];
+      }[];
+    };
+    meta: object;
+  }>;
+  test_trends: import("@trpc/server").TRPCQueryProcedure<{
+    input: {
+      readonly project: string;
+      readonly limit?: number | undefined;
+    };
+    output: {
+      readonly project: string;
+      readonly dataAvailable: true;
+      readonly trends: {
+        readonly entries: readonly {
+          readonly coverage: {
+            readonly statements: number;
+            readonly branches: number;
+            readonly functions: number;
+            readonly lines: number;
+          };
+          readonly timestamp: string;
+          readonly delta: {
+            readonly statements: number;
+            readonly branches: number;
+            readonly functions: number;
+            readonly lines: number;
+          };
+          readonly direction: "improving" | "regressing" | "stable";
+          readonly targetsHash?: string | undefined;
+        }[];
+      };
+    } | {
+      readonly project: string;
+      readonly dataAvailable: false;
+    };
+    meta: object;
+  }>;
+  test_errors: import("@trpc/server").TRPCQueryProcedure<{
+    input: {
+      readonly project: string;
+      readonly errorName?: string | undefined;
+    };
+    output: {
+      readonly project: string;
+      readonly errorName?: string | undefined;
+      readonly count: number;
+      readonly errors: readonly {
+        readonly message: string;
+        readonly id: number;
+        readonly topStackFrameId: number | null;
+        readonly name: string | null;
+        readonly diff: string | null;
+        readonly actual: string | null;
+        readonly expected: string | null;
+        readonly stack: string | null;
+        readonly scope: "test" | "suite" | "module" | "unhandled";
+        readonly testFullName: string | null;
+        readonly moduleFile: string | null;
+      }[];
+    };
+    meta: object;
+  }>;
+  test: import("@trpc/server").TRPCQueryProcedure<{
+    input: {
+      readonly action: "list";
+      readonly project?: string | undefined;
+      readonly state?: string | undefined;
+      readonly limit?: number | undefined;
+      readonly module?: string | undefined;
+    } | {
+      readonly fullName: string;
+      readonly action: "get";
+      readonly project?: string | undefined;
+    } | {
+      readonly action: "for_file";
+      readonly filePath: string;
+    } | {
+      readonly action: "for_tag";
+      readonly tag: string;
+      readonly project?: string | undefined;
+    };
+    output: {
+      readonly count: number;
+      readonly action: "list";
+      readonly groups: readonly {
+        readonly project: string;
+        readonly tests: readonly {
+          readonly fullName: string;
+          readonly state: string;
+          readonly id: number;
+          readonly module: string;
+          readonly duration: number | null;
+          readonly classification: string | null;
+        }[];
+      }[];
+    } | {
+      readonly project: string;
+      readonly runs: readonly {
+        readonly timestamp: string;
+        readonly state: "passed" | "failed";
+      }[];
+      readonly test: {
+        readonly fullName: string;
+        readonly state: string;
+        readonly id: number;
+        readonly module: string;
+        readonly duration: number | null;
+        readonly classification: string | null;
+      };
+      readonly errors: readonly {
+        readonly message: string;
+        readonly name: string | null;
+        readonly diff: string | null;
+        readonly stack: string | null;
+      }[];
+      readonly action: "get";
+      readonly found: true;
+    } | {
+      readonly project: string;
+      readonly fullName: string;
+      readonly action: "get";
+      readonly found: false;
+    } | {
+      readonly count: number;
+      readonly action: "for_file";
+      readonly filePath: string;
+      readonly testFiles: readonly string[];
+    } | {
+      readonly count: number;
+      readonly action: "for_tag";
+      readonly tag: string;
+      readonly groups: readonly {
+        readonly project: string;
+        readonly tests: readonly {
+          readonly fullName: string;
+          readonly state: string;
+          readonly id: number;
+          readonly module: string;
+          readonly duration: number | null;
+          readonly classification: string | null;
+        }[];
+      }[];
+    };
+    meta: object;
+  }>;
+  file_coverage: import("@trpc/server").TRPCQueryProcedure<{
+    input: {
+      readonly filePath: string;
+      readonly project?: string | undefined;
+    };
+    output: {
+      readonly dataAvailable: true;
+      readonly filePath: string;
+      readonly matched: true;
+      readonly report: {
+        readonly file: string;
+        readonly summary: {
+          readonly statements: number;
+          readonly branches: number;
+          readonly functions: number;
+          readonly lines: number;
+        };
+        readonly uncoveredLines: string;
+      };
+      readonly globalThresholds: {
+        readonly statements?: number | undefined;
+        readonly branches?: number | undefined;
+        readonly functions?: number | undefined;
+        readonly lines?: number | undefined;
+      };
+      readonly relatedTestFiles: readonly string[];
+    } | {
+      readonly dataAvailable: true;
+      readonly totals: {
+        readonly statements: number;
+        readonly branches: number;
+        readonly functions: number;
+        readonly lines: number;
+      };
+      readonly filePath: string;
+      readonly matched: false;
+      readonly relatedTestFiles: readonly string[];
+    } | {
+      readonly dataAvailable: false;
+      readonly filePath: string;
+    };
+    meta: object;
+  }>;
+  run_tests: import("@trpc/server").TRPCMutationProcedure<{
+    input: {
+      readonly project?: string | undefined;
+      readonly files?: readonly string[] | undefined;
+      readonly tags?: {
+        readonly all?: readonly string[] | undefined;
+        readonly any?: readonly string[] | undefined;
+        readonly none?: readonly string[] | undefined;
+      } | undefined;
+      readonly passWithNoTests?: boolean | undefined;
+      readonly timeout?: number | undefined;
+      readonly _sessionContext?: {
+        readonly chatId: string;
+        readonly conversationId: string;
+        readonly mainAgentId: string;
+      } | undefined;
+    };
+    output: {
+      readonly project?: string | undefined;
+      readonly report: {
+        readonly reason: "passed" | "failed" | "interrupted";
+        readonly project?: string | undefined;
+        readonly failed: readonly {
+          readonly file: string;
+          readonly tests: readonly {
+            readonly fullName: string;
+            readonly state: "passed" | "failed" | "skipped" | "pending";
+            readonly flaky?: boolean | undefined;
+            readonly name: string;
+            readonly errors?: readonly {
+              readonly message: string;
+              readonly diff?: string | undefined;
+              readonly expected?: string | undefined;
+              readonly stack?: string | undefined;
+              readonly received?: string | undefined;
+            }[] | undefined;
+            readonly duration?: number | undefined;
+            readonly classification?: "flaky" | "persistent" | "recovered" | "stable" | "new-failure" | undefined;
+            readonly slow?: boolean | undefined;
+          }[];
+          readonly state: "passed" | "failed" | "skipped" | "pending";
+          readonly errors?: readonly {
+            readonly message: string;
+            readonly diff?: string | undefined;
+            readonly expected?: string | undefined;
+            readonly stack?: string | undefined;
+            readonly received?: string | undefined;
+          }[] | undefined;
+          readonly duration?: number | undefined;
+        }[];
+        readonly summary: {
+          readonly passed: number;
+          readonly failed: number;
+          readonly total: number;
+          readonly skipped: number;
+          readonly duration: number;
+        };
+        readonly coverage?: {
+          readonly totals: {
+            readonly statements: number;
+            readonly branches: number;
+            readonly functions: number;
+            readonly lines: number;
+          };
+          readonly thresholds: {
+            readonly global: {
+              readonly statements?: number | undefined;
+              readonly branches?: number | undefined;
+              readonly functions?: number | undefined;
+              readonly lines?: number | undefined;
+            };
+            readonly patterns: readonly (readonly [string, {
+              readonly statements?: number | undefined;
+              readonly branches?: number | undefined;
+              readonly functions?: number | undefined;
+              readonly lines?: number | undefined;
+            }])[];
+          };
+          readonly targets?: {
+            readonly global: {
+              readonly statements?: number | undefined;
+              readonly branches?: number | undefined;
+              readonly functions?: number | undefined;
+              readonly lines?: number | undefined;
+            };
+            readonly patterns: readonly (readonly [string, {
+              readonly statements?: number | undefined;
+              readonly branches?: number | undefined;
+              readonly functions?: number | undefined;
+              readonly lines?: number | undefined;
+            }])[];
+          } | undefined;
+          readonly baselines?: {
+            readonly global: {
+              readonly statements?: number | undefined;
+              readonly branches?: number | undefined;
+              readonly functions?: number | undefined;
+              readonly lines?: number | undefined;
+            };
+            readonly patterns: readonly (readonly [string, {
+              readonly statements?: number | undefined;
+              readonly branches?: number | undefined;
+              readonly functions?: number | undefined;
+              readonly lines?: number | undefined;
+            }])[];
+          } | undefined;
+          readonly scoped: boolean;
+          readonly scopedFiles?: readonly string[] | undefined;
+          readonly lowCoverage: readonly {
+            readonly file: string;
+            readonly summary: {
+              readonly statements: number;
+              readonly branches: number;
+              readonly functions: number;
+              readonly lines: number;
+            };
+            readonly uncoveredLines: string;
+          }[];
+          readonly lowCoverageFiles: readonly string[];
+          readonly belowTarget?: readonly {
+            readonly file: string;
+            readonly summary: {
+              readonly statements: number;
+              readonly branches: number;
+              readonly functions: number;
+              readonly lines: number;
+            };
+            readonly uncoveredLines: string;
+          }[] | undefined;
+          readonly belowTargetFiles?: readonly string[] | undefined;
+        } | undefined;
+        readonly timestamp: string;
+        readonly unhandledErrors: readonly {
+          readonly message: string;
+          readonly diff?: string | undefined;
+          readonly expected?: string | undefined;
+          readonly stack?: string | undefined;
+          readonly received?: string | undefined;
+        }[];
+        readonly failedFiles: readonly string[];
+        readonly tagCounts?: {
+          readonly [x: string]: {
+            readonly passed?: number | undefined;
+            readonly failed?: number | undefined;
+            readonly skipped?: number | undefined;
+          };
+        } | undefined;
+      };
+      readonly kind: "ok";
+      readonly classifications: {
+        readonly [x: string]: string;
+      };
+    } | {
+      readonly kind: "timeout";
+      readonly timeoutSeconds: number;
+    } | {
+      readonly message: string;
+      readonly kind: "error";
+    } | {
+      readonly filter: {
+        readonly project: string | null;
+        readonly files: readonly string[];
+        readonly tags: {
+          readonly all?: readonly string[] | undefined;
+          readonly any?: readonly string[] | undefined;
+          readonly none?: readonly string[] | undefined;
+        } | null;
+        readonly resolvedExpression: string | null;
+      };
+      readonly kind: "no-match";
+    };
+    meta: object;
+  }>;
+  register_agent: import("@trpc/server").TRPCMutationProcedure<{
+    input: {
+      readonly chatId: string;
+      readonly agentType: string;
+      readonly conversationId?: string | undefined;
+      readonly hostKind?: string | undefined;
+      readonly parentAgentId?: string | undefined;
+      readonly clientNonce?: string | undefined;
+      readonly startGitBranch?: string | undefined;
+      readonly startGitCommitSha?: string | undefined;
+      readonly startWorktreeDir?: string | undefined;
+    };
+    output: {
+      readonly conversationId: string | null;
+      readonly ok: true;
+      readonly agentId: string;
+      readonly idempotencyKey: string;
+    } | {
+      readonly ok: false;
+      readonly error: {
+        readonly message: string;
+        readonly code: "AGENT_ALREADY_REGISTERED" | "PARENT_AGENT_NOT_FOUND" | "SESSION_NOT_FOUND" | "INVALID_AGENT_TYPE_PREFIX";
+        readonly existingAgentId?: string | undefined;
+        readonly expectedPrefix?: string | undefined;
+      };
+    };
+    meta: object;
+  }>;
+  cache_health: import("@trpc/server").TRPCQueryProcedure<{
+    input: void;
+    output: {
+      readonly manifestPresent: true;
+      readonly manifest: {
+        readonly updatedAt: string;
+        readonly cacheDir: string;
+        readonly projects: readonly {
+          readonly project: string;
+          readonly reportFile: string;
+          readonly historyFile?: string | undefined;
+          readonly lastRun: string | null;
+          readonly lastResult: "passed" | "failed" | "interrupted" | null;
+        }[];
+      };
+      readonly ageMs: number;
+      readonly stale: boolean;
+    } | {
+      readonly manifestPresent: false;
+    };
+    meta: object;
+  }>;
+  configure: import("@trpc/server").TRPCQueryProcedure<{
+    input: {
+      readonly settingsHash?: string | undefined;
+    };
+    output: {
+      readonly found: true;
+      readonly source: "requested" | "latest";
+      readonly settings: {
+        readonly project: string | null;
+        readonly hash: string;
+        readonly reporters: string | null;
+        readonly coverageEnabled: boolean;
+        readonly coverageProvider: string | null;
+        readonly coverageThresholds: string | null;
+        readonly coverageTargets: string | null;
+        readonly pool: string | null;
+        readonly shard: string | null;
+        readonly environment: string | null;
+        readonly envVars: {
+          readonly [x: string]: string;
+        };
+        readonly capturedAt: string;
+      };
+    } | {
+      readonly found: false;
+      readonly source: "requested" | "latest";
+      readonly requestedHash?: string | undefined;
+    };
+    meta: object;
+  }>;
+  inventory: import("@trpc/server").TRPCQueryProcedure<{
+    input: {
+      readonly kind: "project";
+    } | {
+      readonly kind: "module";
+      readonly project?: string | undefined;
+    } | {
+      readonly kind: "suite";
+      readonly project?: string | undefined;
+      readonly module?: string | undefined;
+    } | {
+      readonly kind: "session";
+      readonly project?: string | undefined;
+      readonly limit?: number | undefined;
+      readonly id?: number | undefined;
+      readonly agentKind?: "main" | "subagent" | undefined;
+    } | {
+      readonly kind: "tag";
+      readonly project?: string | undefined;
+    };
+    output: {
+      readonly count: number;
+      readonly projects: readonly {
+        readonly project: string;
+        readonly lastRun: string | null;
+        readonly lastResult: "passed" | "failed" | "interrupted" | null;
+        readonly passed: number;
+        readonly failed: number;
+        readonly total: number;
+        readonly skipped: number;
+      }[];
+      readonly inventoryKind: "project";
+    } | {
+      readonly count: number;
+      readonly groups: readonly {
+        readonly project: string;
+        readonly modules: readonly {
+          readonly file: string;
+          readonly state: string;
+          readonly id: number;
+          readonly duration: number | null;
+          readonly testCount: number;
+        }[];
+      }[];
+      readonly inventoryKind: "module";
+    } | {
+      readonly count: number;
+      readonly groups: readonly {
+        readonly project: string;
+        readonly suites: readonly {
+          readonly state: string;
+          readonly id: number;
+          readonly name: string;
+          readonly module: string;
+          readonly testCount: number;
+        }[];
+      }[];
+      readonly inventoryKind: "suite";
+    } | {
+      readonly found: true;
+      readonly session: {
+        readonly project: string;
+        readonly cwd: string;
+        readonly id: number;
+        readonly chatId: string;
+        readonly agentType: string | null;
+        readonly agentKind: "main" | "subagent";
+        readonly parentSessionId: number | null;
+        readonly triageWasNonEmpty: boolean;
+        readonly startedAt: string;
+        readonly endedAt: string | null;
+        readonly endReason: string | null;
+      };
+      readonly inventoryKind: "session_detail";
+    } | {
+      readonly id: number;
+      readonly found: false;
+      readonly inventoryKind: "session_detail";
+    } | {
+      readonly count: number;
+      readonly inventoryKind: "session_list";
+      readonly sessions: readonly {
+        readonly project: string;
+        readonly cwd: string;
+        readonly id: number;
+        readonly chatId: string;
+        readonly agentType: string | null;
+        readonly agentKind: "main" | "subagent";
+        readonly parentSessionId: number | null;
+        readonly triageWasNonEmpty: boolean;
+        readonly startedAt: string;
+        readonly endedAt: string | null;
+        readonly endReason: string | null;
+      }[];
+    } | {
+      readonly project: string;
+      readonly count: number;
+      readonly tags: readonly {
+        readonly tag: string;
+        readonly testCount: number;
+        readonly moduleCount: number;
+      }[];
+      readonly inventoryKind: "tag_scoped";
+    } | {
+      readonly count: number;
+      readonly tags: readonly {
+        readonly tag: string;
+        readonly testCount: number;
+        readonly moduleCount: number;
+        readonly byProject: readonly {
+          readonly project: string;
+          readonly testCount: number;
+          readonly moduleCount: number;
+        }[];
+      }[];
+      readonly inventoryKind: "tag_unscoped";
+    };
+    meta: object;
+  }>;
+  settings_list: import("@trpc/server").TRPCQueryProcedure<{
+    input: {};
+    output: {
+      readonly count: number;
+      readonly settings: readonly {
+        readonly hash: string;
+        readonly capturedAt: string;
+      }[];
+    };
+    meta: object;
+  }>;
+  note: import("@trpc/server").TRPCMutationProcedure<{
+    input: {
+      readonly title: string;
+      readonly scope: "project" | "global" | "test" | "suite" | "module" | "note";
+      readonly action: "create";
+      readonly content: string;
+      readonly project?: string | undefined;
+      readonly testFullName?: string | undefined;
+      readonly modulePath?: string | undefined;
+      readonly parentNoteId?: number | undefined;
+      readonly createdBy?: string | undefined;
+      readonly expiresAt?: string | undefined;
+      readonly pinned?: boolean | undefined;
+    } | {
+      readonly action: "list";
+      readonly project?: string | undefined;
+      readonly scope?: string | undefined;
+      readonly testFullName?: string | undefined;
+    } | {
+      readonly id: number;
+      readonly action: "get";
+    } | {
+      readonly id: number;
+      readonly action: "update";
+      readonly title?: string | undefined;
+      readonly content?: string | undefined;
+      readonly expiresAt?: string | undefined;
+      readonly pinned?: boolean | undefined;
+    } | {
+      readonly id: number;
+      readonly action: "delete";
+    } | {
+      readonly query: string;
+      readonly action: "search";
+    };
+    output: {
+      readonly id: number;
+      readonly action: "create";
+    } | {
+      readonly count: number;
+      readonly action: "list";
+      readonly notes: readonly {
+        readonly project: string | null;
+        readonly updatedAt: string;
+        readonly title: string;
+        readonly id: number;
+        readonly scope: "project" | "global" | "test" | "suite" | "module" | "note";
+        readonly testFullName: string | null;
+        readonly content: string;
+        readonly modulePath: string | null;
+        readonly parentNoteId: number | null;
+        readonly createdBy: string | null;
+        readonly expiresAt: string | null;
+        readonly pinned: boolean;
+        readonly createdAt: string;
+      }[];
+    } | {
+      readonly action: "get";
+      readonly found: true;
+      readonly note: {
+        readonly project: string | null;
+        readonly updatedAt: string;
+        readonly title: string;
+        readonly id: number;
+        readonly scope: "project" | "global" | "test" | "suite" | "module" | "note";
+        readonly testFullName: string | null;
+        readonly content: string;
+        readonly modulePath: string | null;
+        readonly parentNoteId: number | null;
+        readonly createdBy: string | null;
+        readonly expiresAt: string | null;
+        readonly pinned: boolean;
+        readonly createdAt: string;
+      };
+    } | {
+      readonly id: number;
+      readonly action: "get";
+      readonly found: false;
+    } | {
+      readonly action: "update";
+      readonly success: true;
+    } | {
+      readonly action: "delete";
+      readonly success: true;
+    } | {
+      readonly query: string;
+      readonly count: number;
+      readonly action: "search";
+      readonly notes: readonly {
+        readonly project: string | null;
+        readonly updatedAt: string;
+        readonly title: string;
+        readonly id: number;
+        readonly scope: "project" | "global" | "test" | "suite" | "module" | "note";
+        readonly testFullName: string | null;
+        readonly content: string;
+        readonly modulePath: string | null;
+        readonly parentNoteId: number | null;
+        readonly createdBy: string | null;
+        readonly expiresAt: string | null;
+        readonly pinned: boolean;
+        readonly createdAt: string;
+      }[];
+    };
+    meta: object;
+  }>;
+  turn_search: import("@trpc/server").TRPCQueryProcedure<{
+    input: {
+      readonly limit?: number | undefined;
+      readonly sessionId?: number | undefined;
+      readonly since?: string | undefined;
+      readonly type?: "note" | "user_prompt" | "tool_call" | "tool_result" | "file_edit" | "hook_fire" | "hypothesis" | undefined;
+    };
+    output: {
+      readonly count: number;
+      readonly turns: readonly {
+        readonly id: number;
+        readonly sessionId: number;
+        readonly type: string;
+        readonly turnNo: number;
+        readonly payload: string;
+        readonly occurredAt: string;
+      }[];
+    };
+    meta: object;
+  }>;
+  failure_signature_get: import("@trpc/server").TRPCQueryProcedure<{
+    input: {
+      readonly hash: string;
+    };
+    output: {
+      readonly found: true;
+      readonly signatureHash: string;
+      readonly firstSeenRunId: number | null;
+      readonly firstSeenAt: string;
+      readonly lastSeenAt: string | null;
+      readonly occurrenceCount: number;
+      readonly recentErrors: readonly {
+        readonly message: string;
+        readonly errorName: string | null;
+        readonly runId: number;
+      }[];
+    } | {
+      readonly found: false;
+      readonly requestedHash: string;
+    };
+    meta: object;
+  }>;
+  tdd_task: import("@trpc/server").TRPCMutationProcedure<{
+    input: {
+      readonly action: "start";
+      readonly goal: string;
+      readonly chatId?: string | undefined;
+      readonly startedAt?: string | undefined;
+      readonly sessionId?: number | undefined;
+      readonly runId?: string | undefined;
+      readonly parentTddTaskId?: number | undefined;
+    } | {
+      readonly action: "end";
+      readonly tddTaskId: number;
+      readonly outcome: "succeeded" | "blocked" | "abandoned";
+      readonly summaryNoteId?: number | undefined;
+    } | {
+      readonly action: "get";
+      readonly tddTaskId: number;
+    } | {
+      readonly action: "resume";
+      readonly tddTaskId: number;
+    };
+    output: {
+      readonly action: "start";
+      readonly runId?: string | undefined;
+      readonly goal: string;
+      readonly tddTaskId: number;
+    } | {
+      readonly action: "end";
+      readonly tddTaskId: number;
+      readonly outcome: "succeeded" | "blocked" | "abandoned";
+    } | {
+      readonly action: "get";
+      readonly found: true;
+      readonly task: {
+        readonly startedAt: string;
+        readonly endedAt: string | null;
+        readonly sessionId: number;
+        readonly runId: string | null;
+        readonly goal: string;
+        readonly tddTaskId: number;
+        readonly outcome: string | null;
+        readonly goals: readonly {
+          readonly id: number;
+          readonly createdAt: string;
+          readonly sessionId: number;
+          readonly goal: string;
+          readonly behaviors: readonly {
+            readonly id: number;
+            readonly createdAt: string;
+            readonly ordinal: number;
+            readonly status: "pending" | "abandoned" | "in_progress" | "done";
+            readonly goalId: number;
+            readonly behavior: string;
+            readonly suggestedTestName: string | null;
+          }[];
+          readonly ordinal: number;
+          readonly status: "pending" | "abandoned" | "in_progress" | "done";
+        }[];
+        readonly phases: readonly {
+          readonly id: number;
+          readonly startedAt: string;
+          readonly endedAt: string | null;
+          readonly behaviorId: number | null;
+          readonly phase: string;
+          readonly transitionReason: string | null;
+        }[];
+        readonly artifacts: readonly {
+          readonly id: number;
+          readonly phaseId: number;
+          readonly artifactKind: string;
+          readonly testCaseId: number | null;
+          readonly testRunId: number | null;
+          readonly recordedAt: string;
+        }[];
+      };
+      readonly currentPhase: {
+        readonly id: number;
+        readonly startedAt: string;
+        readonly behaviorId: number | null;
+        readonly phase: string;
+      } | null;
+    } | {
+      readonly action: "get";
+      readonly found: false;
+      readonly tddTaskId: number;
+    } | {
+      readonly action: "resume";
+      readonly found: true;
+      readonly goal: string;
+      readonly tddTaskId: number;
+      readonly status: string;
+      readonly currentPhase: {
+        readonly id: number;
+        readonly startedAt: string;
+        readonly behaviorId: number | null;
+        readonly phase: string;
+      } | null;
+      readonly phasesRecorded: number;
+      readonly artifactsRecorded: number;
+    } | {
+      readonly action: "resume";
+      readonly found: false;
+      readonly tddTaskId: number;
+    };
+    meta: object;
+  }>;
+  tdd_phase_transition_request: import("@trpc/server").TRPCMutationProcedure<{
+    input: {
+      readonly tddTaskId: number;
+      readonly goalId: number;
+      readonly requestedPhase: "spike" | "red" | "red.triangulate" | "green" | "green.fake-it" | "refactor" | "extended-red" | "green-without-red";
+      readonly reason?: string | undefined;
+      readonly behaviorId?: number | undefined;
+      readonly citedArtifactId?: number | undefined;
+      readonly citedArtifactKind?: "refactor" | "test_written" | "test_failed_run" | "code_written" | "test_passed_run" | "test_weakened" | undefined;
+    };
+    output: {
+      readonly accepted: false;
+      readonly phase: import("@vitest-agent/sdk").Phase;
+      readonly denialReason: import("@vitest-agent/sdk").DenialReason;
+      readonly remediation: import("@vitest-agent/sdk").Remediation;
+    } | {
+      citedArtifactId?: number | undefined;
+      citedArtifactSource?: "none" | "explicit-id" | "explicit-kind" | "transition-derived" | undefined;
+      accepted: true;
+      phase: import("@vitest-agent/sdk").Phase;
+      newPhaseId: number;
+      previousPhaseId: number | null;
+    };
+    meta: object;
+  }>;
+  tdd_goal: import("@trpc/server").TRPCMutationProcedure<{
+    input: {
+      readonly action: "create";
+      readonly goal: string;
+      readonly tddTaskId: number;
+    } | {
+      readonly id: number;
+      readonly action: "update";
+      readonly goal?: string | undefined;
+      readonly status?: "pending" | "abandoned" | "in_progress" | "done" | undefined;
+    } | {
+      readonly id: number;
+      readonly action: "delete";
+    } | {
+      readonly id: number;
+      readonly action: "get";
+    } | {
+      readonly action: "list";
+      readonly tddTaskId: number;
+    };
+    output: TddErrorEnvelope | {
+      ok: true;
+      action: "create";
+      goal: {
+        readonly id: number;
+        readonly createdAt: string;
+        readonly sessionId: number;
+        readonly goal: string;
+        readonly ordinal: number;
+        readonly status: "pending" | "abandoned" | "in_progress" | "done";
+      };
+    } | {
+      ok: true;
+      action: "update";
+      goal: {
+        readonly id: number;
+        readonly createdAt: string;
+        readonly sessionId: number;
+        readonly goal: string;
+        readonly ordinal: number;
+        readonly status: "pending" | "abandoned" | "in_progress" | "done";
+      };
+    } | {
+      ok: true;
+      action: "delete";
+      id: number;
+    } | {
+      action: "get";
+      found: false;
+      id: number;
+      goal?: undefined;
+    } | {
+      action: "get";
+      found: true;
+      goal: {
+        readonly id: number;
+        readonly createdAt: string;
+        readonly sessionId: number;
+        readonly goal: string;
+        readonly behaviors: readonly {
+          readonly id: number;
+          readonly createdAt: string;
+          readonly ordinal: number;
+          readonly status: "pending" | "abandoned" | "in_progress" | "done";
+          readonly goalId: number;
+          readonly behavior: string;
+          readonly suggestedTestName: string | null;
+        }[];
+        readonly ordinal: number;
+        readonly status: "pending" | "abandoned" | "in_progress" | "done";
+      };
+      id?: undefined;
+    } | {
+      ok: true;
+      action: "list";
+      tddTaskId: number;
+      goals: readonly {
+        readonly id: number;
+        readonly createdAt: string;
+        readonly sessionId: number;
+        readonly goal: string;
+        readonly behaviors: readonly {
+          readonly id: number;
+          readonly createdAt: string;
+          readonly ordinal: number;
+          readonly status: "pending" | "abandoned" | "in_progress" | "done";
+          readonly goalId: number;
+          readonly behavior: string;
+          readonly suggestedTestName: string | null;
+        }[];
+        readonly ordinal: number;
+        readonly status: "pending" | "abandoned" | "in_progress" | "done";
+      }[];
+    };
+    meta: object;
+  }>;
+  tdd_behavior: import("@trpc/server").TRPCMutationProcedure<{
+    input: {
+      readonly action: "create";
+      readonly goalId: number;
+      readonly behavior: string;
+      readonly suggestedTestName?: string | undefined;
+      readonly dependsOnBehaviorIds?: readonly number[] | undefined;
+    } | {
+      readonly id: number;
+      readonly action: "update";
+      readonly status?: "pending" | "abandoned" | "in_progress" | "done" | undefined;
+      readonly behavior?: string | undefined;
+      readonly suggestedTestName?: string | null | undefined;
+      readonly dependsOnBehaviorIds?: readonly number[] | undefined;
+    } | {
+      readonly id: number;
+      readonly action: "delete";
+    } | {
+      readonly id: number;
+      readonly action: "get";
+    } | {
+      readonly action: "list_by_goal";
+      readonly goalId: number;
+    } | {
+      readonly action: "list_by_tdd_task";
+      readonly tddTaskId: number;
+    };
+    output: TddErrorEnvelope | {
+      ok: true;
+      action: "create";
+      behavior: {
+        readonly id: number;
+        readonly createdAt: string;
+        readonly ordinal: number;
+        readonly status: "pending" | "abandoned" | "in_progress" | "done";
+        readonly goalId: number;
+        readonly behavior: string;
+        readonly suggestedTestName: string | null;
+      };
+    } | {
+      ok: true;
+      action: "update";
+      behavior: {
+        readonly id: number;
+        readonly createdAt: string;
+        readonly ordinal: number;
+        readonly status: "pending" | "abandoned" | "in_progress" | "done";
+        readonly goalId: number;
+        readonly behavior: string;
+        readonly suggestedTestName: string | null;
+      };
+    } | {
+      ok: true;
+      action: "delete";
+      id: number;
+    } | {
+      action: "get";
+      found: false;
+      id: number;
+      behavior?: undefined;
+    } | {
+      action: "get";
+      found: true;
+      behavior: {
+        readonly id: number;
+        readonly createdAt: string;
+        readonly ordinal: number;
+        readonly status: "pending" | "abandoned" | "in_progress" | "done";
+        readonly goalId: number;
+        readonly behavior: string;
+        readonly suggestedTestName: string | null;
+        readonly parentGoal: {
+          readonly id: number;
+          readonly goal: string;
+          readonly status: "pending" | "abandoned" | "in_progress" | "done";
+        };
+        readonly dependencies: readonly {
+          readonly id: number;
+          readonly createdAt: string;
+          readonly ordinal: number;
+          readonly status: "pending" | "abandoned" | "in_progress" | "done";
+          readonly goalId: number;
+          readonly behavior: string;
+          readonly suggestedTestName: string | null;
+        }[];
+      };
+      id?: undefined;
+    } | {
+      ok: true;
+      action: "list_by_goal";
+      goalId: number;
+      behaviors: readonly {
+        readonly id: number;
+        readonly createdAt: string;
+        readonly ordinal: number;
+        readonly status: "pending" | "abandoned" | "in_progress" | "done";
+        readonly goalId: number;
+        readonly behavior: string;
+        readonly suggestedTestName: string | null;
+      }[];
+    } | {
+      ok: true;
+      action: "list_by_tdd_task";
+      tddTaskId: number;
+      behaviors: readonly {
+        readonly id: number;
+        readonly createdAt: string;
+        readonly ordinal: number;
+        readonly status: "pending" | "abandoned" | "in_progress" | "done";
+        readonly goalId: number;
+        readonly behavior: string;
+        readonly suggestedTestName: string | null;
+      }[];
+    };
+    meta: object;
+  }>;
+  tdd_artifact_list: import("@trpc/server").TRPCQueryProcedure<{
+    input: {
+      readonly tddTaskId: number;
+      readonly limit?: number | undefined;
+      readonly behaviorId?: number | undefined;
+      readonly phaseId?: number | undefined;
+      readonly artifactKind?: "refactor" | "test_written" | "test_failed_run" | "code_written" | "test_passed_run" | "test_weakened" | undefined;
+    };
+    output: {
+      readonly count: number;
+      readonly tddTaskId: number;
+      readonly artifacts: readonly {
+        readonly id: number;
+        readonly tddTaskId: number;
+        readonly behaviorId: number | null;
+        readonly phaseId: number;
+        readonly artifactKind: "refactor" | "test_written" | "test_failed_run" | "code_written" | "test_passed_run" | "test_weakened";
+        readonly testCaseId: number | null;
+        readonly testRunId: number | null;
+        readonly recordedAt: string;
+        readonly phaseName: "spike" | "red" | "red.triangulate" | "green" | "green.fake-it" | "refactor" | "extended-red" | "green-without-red";
+        readonly testFirstFailureRunId: number | null;
+      }[];
+      readonly filters: {
+        readonly behaviorId?: number | undefined;
+        readonly phaseId?: number | undefined;
+        readonly artifactKind?: "refactor" | "test_written" | "test_failed_run" | "code_written" | "test_passed_run" | "test_weakened" | undefined;
+      };
+    };
+    meta: object;
+  }>;
+  hypothesis: import("@trpc/server").TRPCMutationProcedure<{
+    input: {
+      readonly action: "record";
+      readonly content: string;
+      readonly sessionId?: number | undefined;
+      readonly createdTurnId?: number | undefined;
+      readonly citedTestErrorId?: number | undefined;
+      readonly citedStackFrameId?: number | undefined;
+    } | {
+      readonly id: number;
+      readonly action: "validate";
+      readonly outcome: "abandoned" | "confirmed" | "refuted";
+      readonly validatedAt: string;
+      readonly validatedTurnId?: number | undefined;
+    } | {
+      readonly action: "list";
+      readonly limit?: number | undefined;
+      readonly sessionId?: number | undefined;
+      readonly outcome?: "open" | "abandoned" | "confirmed" | "refuted" | undefined;
+    };
+    output: {
+      readonly id: number;
+      readonly action: "record";
+    } | {
+      readonly action: "validate";
+    } | {
+      readonly count: number;
+      readonly action: "list";
+      readonly hypotheses: readonly {
+        readonly id: number;
+        readonly content: string;
+        readonly sessionId: number;
+        readonly citedTestErrorId: number | null;
+        readonly citedStackFrameId: number | null;
+        readonly validatedAt: string | null;
+        readonly validationOutcome: "abandoned" | "confirmed" | "refuted" | null;
+      }[];
+    };
+    meta: object;
+  }>;
+  acceptance_metrics: import("@trpc/server").TRPCQueryProcedure<{
+    input: {};
+    output: {
+      readonly phaseEvidenceIntegrity: {
+        readonly total: number;
+        readonly compliant: number;
+        readonly ratio: number;
+      };
+      readonly complianceHookResponsiveness: {
+        readonly total: number;
+        readonly ratio: number;
+        readonly withFollowup: number;
+      };
+      readonly orientationUsefulness: {
+        readonly total: number;
+        readonly ratio: number;
+        readonly referencedCount: number;
+      };
+      readonly antiPatternDetectionRate: {
+        readonly total: number;
+        readonly ratio: number;
+        readonly cleanSessions: number;
+      };
+    };
+    meta: object;
+  }>;
+  triage_brief: import("@trpc/server").TRPCQueryProcedure<{
+    input: {
+      readonly project?: string | undefined;
+      readonly maxLines?: number | undefined;
+    };
+    output: {
+      readonly hasContent: boolean;
+      readonly markdown: string;
+    };
+    meta: object;
+  }>;
+  wrapup_prompt: import("@trpc/server").TRPCQueryProcedure<{
+    input: {
+      readonly chatId?: string | undefined;
+      readonly kind?: "stop" | "session_end" | "pre_compact" | "tdd_handoff" | "user_prompt_nudge" | undefined;
+      readonly sessionId?: number | undefined;
+      readonly userPromptHint?: string | undefined;
+    };
+    output: {
+      readonly kind: "stop" | "session_end" | "pre_compact" | "tdd_handoff" | "user_prompt_nudge";
+      readonly hasContent: boolean;
+      readonly markdown: string;
+    };
+    meta: object;
+  }>;
+  commit_changes: import("@trpc/server").TRPCQueryProcedure<{
+    input: {
+      readonly sha?: string | undefined;
+    };
+    output: {
+      readonly count: number;
+      readonly filterSha?: string | undefined;
+      readonly commits: readonly {
+        readonly message: string | null;
+        readonly files: readonly {
+          readonly filePath: string;
+          readonly changeKind: "added" | "modified" | "deleted" | "renamed" | "untracked-modified";
+        }[];
+        readonly sha: string;
+        readonly parentSha: string | null;
+        readonly author: string | null;
+        readonly committedAt: string | null;
+        readonly branch: string | null;
+      }[];
+    };
+    meta: object;
+  }>;
+  ping: import("@trpc/server").TRPCQueryProcedure<{
+    input: void;
+    output: {
+      readonly message: "pong";
+    };
+    meta: object;
+  }>;
+}>>;
+//#endregion
+//#region src/server.d.ts
+/**
+ * Starts the MCP server over stdio, registering all tools, resources, and prompts.
+ *
+ * Constructs the MCP server instance, registers all tRPC-backed tools (wired through
+ * `ctx.runtime`), calls `registerAllResources` and `registerAllPrompts`, then connects
+ * a `StdioServerTransport`. Returns when the transport disconnects.
+ *
+ * @param ctx - the MCP context carrying the shared ManagedRuntime and session refs
+ * @public
+ */
+declare function startMcpServer(ctx: McpContext): Promise<void>;
+//#endregion
+//#region src/tools/_tdd-error-envelope.d.ts
+/**
+ * Suggested recovery action attached to a TDD error envelope.
+ *
+ * Tells the agent which tool to call next and provides a human-readable hint
+ * explaining the error context and recommended fix.
+ *
+ * @public
+ */
+interface Remediation {
+  readonly suggestedTool: string;
+  readonly suggestedArgs: Record<string, unknown>;
+  readonly humanHint: string;
+}
+/**
+ * Success-shaped envelope returned by TDD CRUD tools when a known TDD error occurs.
+ *
+ * Instead of letting the five tagged TDD errors propagate as transport errors,
+ * `catchTddErrorsAsEnvelope` maps them to this shape so the agent receives a normal
+ * tool response with `ok: false` and a {@link Remediation} describing the next step.
+ *
+ * @public
+ */
+interface TddErrorEnvelope {
+  readonly ok: false;
+  readonly error: {
+    readonly _tag: string;
+    readonly remediation: Remediation;
+    readonly [key: string]: unknown;
+  };
+}
+//#endregion
+//#region src/index.d.ts
+/**
+ * The version of this package, inlined at build time from
+ * package.json#version via rslib-builder's __PACKAGE_VERSION__ substitution.
+ * Compared against CURRENT_SDK_VERSION at MCP bin init to surface
+ * partially-upgraded installs as a single stderr warning. See the root
+ * CLAUDE.md "Cross-package version drift" section.
+ *
+ * @public
+ */
+declare const CURRENT_MCP_VERSION: string;
+//#endregion
+export { CURRENT_MCP_VERSION, type CurrentSessionIdRef, type McpContext, McpLive, type Remediation, type SessionContext, type SessionContextRef, type TddErrorEnvelope, appRouter, createCallerFactory, createCurrentSessionIdRef, createSessionContextRef, startMcpServer };
+//# sourceMappingURL=index.d.ts.map