@vitest-agent/mcp 5.3.0 → 5.3.1

package/index.d.ts

@@ -1,7 +1,7 @@
 import { ToolRefusal } from "@effected/mcp";
 import { Context, Effect, Layer, Schema, Stdio } from "effect";
 import { DataReader, DataStore, ProjectDiscovery, SessionContext } from "@vitest-agent/engine";
-import { Toolkit } from "effect/ai";
+import { McpServer, Toolkit } from "effect/ai";
 import "@effected/git";
 import "@vitest-agent/sdk";
 import { Remediation } from "@effected/engine";
@@ -193,130 +193,179 @@ export declare const SERVER_INSTRUCTIONS: string;
  */
 export declare const ServerLayer: (options: ServerLayerOptions) => Layer.Layer<never, never, PlatformServices | McpSession | DataReader | DataStore | ProjectDiscovery>;
 /**
- * The `ping` tool's success payload.
+ * The `acceptance_metrics` tool's success payload.
  *
  * @public
  */
-export declare const PingResult: Schema.Struct<{
-  readonly message: Schema.Literal<"pong">;
-  readonly distribution: Schema.NullOr<Schema.Struct<{
-    readonly name: Schema.String;
-    readonly version: Schema.String;
-  }>>;
+export declare const AcceptanceMetricsResult: Schema.Struct<{
+  readonly phaseEvidenceIntegrity: Schema.Struct<{
+    readonly total: Schema.Finite;
+    readonly compliant: Schema.Finite;
+    readonly ratio: Schema.Finite;
+  }>;
+  readonly complianceHookResponsiveness: Schema.Struct<{
+    readonly total: Schema.Finite;
+    readonly withFollowup: Schema.Finite;
+    readonly ratio: Schema.Finite;
+  }>;
+  readonly orientationUsefulness: Schema.Struct<{
+    readonly total: Schema.Finite;
+    readonly referencedCount: Schema.Finite;
+    readonly ratio: Schema.Finite;
+  }>;
+  readonly antiPatternDetectionRate: Schema.Struct<{
+    readonly total: Schema.Finite;
+    readonly cleanSessions: Schema.Finite;
+    readonly ratio: Schema.Finite;
+  }>;
 }>;
 /**
- * The decoded {@link PingResult}.
+ * The decoded {@link AcceptanceMetricsResult}.
  *
  * @public
  */
-type PingResultType = Schema.Schema.Type<typeof PingResult>;
+type AcceptanceMetricsResultType = Schema.Schema.Type<typeof AcceptanceMetricsResult>;
 /**
- * The `help` tool's success payload.
+ * Handler for {@link acceptanceMetricsTool}.
  *
  * @public
  */
-export declare const HelpResult: Schema.Struct<{
-  readonly helpText: Schema.String;
-}>;
+declare const handleAcceptanceMetrics: () => Effect.Effect<AcceptanceMetricsResultType, never, DataReader>;
 /**
- * The decoded {@link HelpResult}.
+ * The `cache_health` tool's success payload.
  *
  * @public
  */
-type HelpResultType = Schema.Schema.Type<typeof HelpResult>;
+export declare const CacheHealthResult: Schema.Union<readonly [Schema.Struct<{
+  readonly manifestPresent: Schema.Literal<true>;
+  readonly manifest: Schema.Struct<{
+    readonly updatedAt: Schema.String;
+    readonly cacheDir: Schema.String;
+    readonly projects: Schema.$Array<Schema.Struct<{
+      readonly project: Schema.String;
+      readonly reportFile: Schema.String;
+      readonly historyFile: Schema.optional<Schema.String>;
+      readonly lastRun: Schema.NullOr<Schema.String>;
+      readonly lastResult: Schema.NullOr<Schema.Literals<readonly ["passed", "failed", "interrupted"]>>;
+    }>>;
+  }>;
+  readonly ageMs: Schema.Finite;
+  readonly stale: Schema.Boolean;
+}>, Schema.Struct<{
+  readonly manifestPresent: Schema.Literal<false>;
+}>]>;
 /**
- * The `test_status` tool's success payload.
+ * The decoded {@link CacheHealthResult}.
  *
  * @public
  */
-export declare const TestStatusResult: Schema.Union<readonly [Schema.Struct<{
-  readonly dataAvailable: Schema.Literal<true>;
-  readonly manifestUpdatedAt: Schema.String;
-  readonly projectFilter: Schema.optional<Schema.String>;
-  readonly entries: Schema.$Array<Schema.Struct<{
-    readonly project: Schema.String;
-    readonly reportFile: Schema.String;
-    readonly historyFile: Schema.optional<Schema.String>;
-    readonly lastRun: Schema.NullOr<Schema.String>;
-    readonly lastResult: Schema.NullOr<Schema.Literals<readonly ["passed", "failed", "interrupted"]>>;
-    readonly strayOutput: Schema.optionalKey<Schema.Struct<{
-      readonly total: Schema.Finite;
-      readonly stdout: Schema.Finite;
-      readonly stderr: Schema.Finite;
-      readonly bytes: Schema.Finite;
-      readonly samples: Schema.$Array<Schema.Struct<{
-        readonly stream: Schema.Literals<readonly ["stdout", "stderr"]>;
-        readonly text: Schema.String;
-      }>>;
+type CacheHealthResultType = Schema.Schema.Type<typeof CacheHealthResult>;
+/**
+ * Handler for {@link cacheHealthTool}.
+ *
+ * @public
+ */
+declare const handleCacheHealth: () => Effect.Effect<CacheHealthResultType, never, DataReader>;
+/**
+ * The `commit_changes` tool's success payload.
+ *
+ * @public
+ */
+export declare const CommitChangesResult: Schema.Struct<{
+  readonly filterSha: Schema.optional<Schema.String>;
+  readonly count: Schema.Finite;
+  readonly commits: Schema.$Array<Schema.Struct<{
+    readonly sha: Schema.String;
+    readonly parentSha: Schema.NullOr<Schema.String>;
+    readonly message: Schema.NullOr<Schema.String>;
+    readonly author: Schema.NullOr<Schema.String>;
+    readonly committedAt: Schema.NullOr<Schema.String>;
+    readonly branch: Schema.NullOr<Schema.String>;
+    readonly files: Schema.$Array<Schema.Struct<{
+      readonly filePath: Schema.String;
+      readonly changeKind: Schema.Literals<readonly ["added", "modified", "deleted", "renamed", "untracked-modified"]>;
     }>>;
   }>>;
-}>, Schema.Struct<{
-  readonly dataAvailable: Schema.Literal<false>;
-  readonly projectFilter: Schema.optional<Schema.String>;
-  readonly reason: Schema.Literals<readonly ["no_manifest", "project_filter_empty"]>;
-}>]>;
+}>;
 /**
- * The decoded {@link TestStatusResult}.
+ * The decoded {@link CommitChangesResult}.
  *
  * @public
  */
-type TestStatusResultType = Schema.Schema.Type<typeof TestStatusResult>;
+type CommitChangesResultType = Schema.Schema.Type<typeof CommitChangesResult>;
 /**
- * The `test_status` tool's parameters.
+ * The `commit_changes` tool's parameters.
  *
  * @public
  */
-export declare const TestStatusInput: Schema.Struct<{
-  readonly project: Schema.optionalKey<Schema.String>;
+export declare const CommitChangesInput: Schema.Struct<{
+  readonly sha: Schema.optionalKey<Schema.String>;
 }>;
 /**
- * The decoded {@link TestStatusInput}.
+ * The decoded {@link CommitChangesInput}.
  *
  * @public
  */
-type TestStatusInputType = Schema.Schema.Type<typeof TestStatusInput>;
+type CommitChangesInputType = Schema.Schema.Type<typeof CommitChangesInput>;
 /**
- * The `test_overview` tool's success payload.
+ * Handler for {@link commitChangesTool}.
  *
  * @public
  */
-export declare const TestOverviewResult: Schema.Union<readonly [Schema.Struct<{
-  readonly dataAvailable: Schema.Literal<true>;
-  readonly projectFilter: Schema.optional<Schema.String>;
-  readonly runs: Schema.$Array<Schema.Struct<{
-    readonly project: Schema.String;
-    readonly lastRun: Schema.NullOr<Schema.String>;
-    readonly lastResult: Schema.NullOr<Schema.Literals<readonly ["passed", "failed", "interrupted"]>>;
-    readonly total: Schema.Number;
-    readonly passed: Schema.Number;
-    readonly failed: Schema.Number;
-    readonly skipped: Schema.Number;
-  }>>;
+declare const handleCommitChanges: (input: CommitChangesInputType) => Effect.Effect<CommitChangesResultType, never, DataReader>;
+/**
+ * The `configure` tool's success payload.
+ *
+ * @public
+ */
+export declare const ConfigureResult: Schema.Union<readonly [Schema.Struct<{
+  readonly found: Schema.Literal<true>;
+  readonly source: Schema.Literals<readonly ["requested", "latest"]>;
+  readonly settings: Schema.Struct<{
+    readonly hash: Schema.String;
+    readonly reporters: Schema.NullOr<Schema.String>;
+    readonly coverageEnabled: Schema.Boolean;
+    readonly coverageProvider: Schema.NullOr<Schema.String>;
+    readonly coverageThresholds: Schema.NullOr<Schema.String>;
+    readonly coverageTargets: Schema.NullOr<Schema.String>;
+    readonly pool: Schema.NullOr<Schema.String>;
+    readonly shard: Schema.NullOr<Schema.String>;
+    readonly project: Schema.NullOr<Schema.String>;
+    readonly environment: Schema.NullOr<Schema.String>;
+    readonly envVars: Schema.$Record<Schema.String, Schema.String>;
+    readonly capturedAt: Schema.String;
+  }>;
 }>, Schema.Struct<{
-  readonly dataAvailable: Schema.Literal<false>;
-  readonly projectFilter: Schema.optional<Schema.String>;
-  readonly reason: Schema.Literals<readonly ["no_runs", "project_filter_empty"]>;
+  readonly found: Schema.Literal<false>;
+  readonly source: Schema.Literals<readonly ["requested", "latest"]>;
+  readonly requestedHash: Schema.optional<Schema.String>;
 }>]>;
 /**
- * The decoded {@link TestOverviewResult}.
+ * The decoded {@link ConfigureResult}.
  *
  * @public
  */
-type TestOverviewResultType = Schema.Schema.Type<typeof TestOverviewResult>;
+type ConfigureResultType = Schema.Schema.Type<typeof ConfigureResult>;
 /**
- * The `test_overview` tool's parameters.
+ * The `configure` tool's parameters.
  *
  * @public
  */
-export declare const TestOverviewInput: Schema.Struct<{
-  readonly project: Schema.optionalKey<Schema.String>;
+export declare const ConfigureInput: Schema.Struct<{
+  readonly settingsHash: Schema.optionalKey<Schema.String>;
 }>;
 /**
- * The decoded {@link TestOverviewInput}.
+ * The decoded {@link ConfigureInput}.
  *
  * @public
  */
-type TestOverviewInputType = Schema.Schema.Type<typeof TestOverviewInput>;
+type ConfigureInputType = Schema.Schema.Type<typeof ConfigureInput>;
+/**
+ * Handler for {@link configureTool}.
+ *
+ * @public
+ */
+declare const handleConfigure: (input: ConfigureInputType) => Effect.Effect<ConfigureResultType, never, DataReader>;
 /**
  * The `test_coverage` tool's success payload.
  *
@@ -458,144 +507,17 @@ export declare const TestCoverageInput: Schema.Struct<{
  */
 type TestCoverageInputType = Schema.Schema.Type<typeof TestCoverageInput>;
 /**
- * The `test_history` tool's success payload.
- *
- * @public
- */
-export declare const TestHistoryResult: Schema.Struct<{
-  readonly project: Schema.String;
-  readonly hasData: Schema.Boolean;
-  readonly history: Schema.Struct<{
-    readonly project: Schema.String;
-    readonly updatedAt: Schema.String;
-    readonly tests: Schema.$Array<Schema.Struct<{
-      readonly modulePath: Schema.String;
-      readonly fullName: Schema.String;
-      readonly runs: Schema.$Array<Schema.Struct<{
-        readonly timestamp: Schema.String;
-        readonly state: Schema.Literals<readonly ["passed", "failed"]>;
-      }>>;
-    }>>;
-  }>;
-  readonly flaky: Schema.$Array<Schema.Struct<{
-    readonly fullName: Schema.String;
-    readonly modulePath: Schema.String;
-    readonly project: Schema.String;
-    readonly passCount: Schema.Finite;
-    readonly failCount: Schema.Finite;
-    readonly lastState: Schema.Literals<readonly ["passed", "failed"]>;
-    readonly lastTimestamp: Schema.String;
-  }>>;
-  readonly persistent: Schema.$Array<Schema.Struct<{
-    readonly fullName: Schema.String;
-    readonly modulePath: Schema.String;
-    readonly project: Schema.String;
-    readonly consecutiveFailures: Schema.Finite;
-    readonly firstFailedAt: Schema.String;
-    readonly lastFailedAt: Schema.String;
-    readonly lastErrorMessage: Schema.NullOr<Schema.String>;
-  }>>;
-  readonly recovered: Schema.$Array<Schema.Struct<{
-    readonly modulePath: Schema.String;
-    readonly fullName: Schema.String;
-    readonly recentRuns: Schema.$Array<Schema.Literals<readonly ["passed", "failed"]>>;
-  }>>;
-  readonly strayOutput: Schema.Struct<{
-    readonly runs: Schema.Finite;
-    readonly runsWithStrayOutput: Schema.Finite;
-    readonly latest: Schema.NullOr<Schema.Struct<{
-      readonly total: Schema.Finite;
-      readonly stdout: Schema.Finite;
-      readonly stderr: Schema.Finite;
-      readonly bytes: Schema.Finite;
-      readonly samples: Schema.$Array<Schema.Struct<{
-        readonly stream: Schema.Literals<readonly ["stdout", "stderr"]>;
-        readonly text: Schema.String;
-      }>>;
-    }>>;
-  }>;
-}>;
-/**
- * The decoded {@link TestHistoryResult}.
+ * Handler for {@link testCoverageTool}.
  *
  * @public
  */
-type TestHistoryResultType = Schema.Schema.Type<typeof TestHistoryResult>;
+declare const handleTestCoverage: (input: TestCoverageInputType) => Effect.Effect<TestCoverageResultType, never, DataReader>;
 /**
- * The `test_history` tool's parameters.
+ * The `test_errors` tool's success payload — populates `structuredContent`.
  *
  * @public
  */
-export declare const TestHistoryInput: Schema.Struct<{
-  readonly project: Schema.String;
-  readonly testName: Schema.optionalKey<Schema.String>;
-  readonly modulePath: Schema.optionalKey<Schema.String>;
-  readonly limit: Schema.optionalKey<Schema.Int>;
-}>;
-/**
- * The decoded {@link TestHistoryInput}.
- *
- * @public
- */
-type TestHistoryInputType = Schema.Schema.Type<typeof TestHistoryInput>;
-/**
- * The `test_trends` tool's success payload.
- *
- * @public
- */
-export declare const TestTrendsResult: Schema.Union<readonly [Schema.Struct<{
-  readonly dataAvailable: Schema.Literal<true>;
-  readonly project: Schema.String;
-  readonly trends: Schema.Struct<{
-    readonly entries: Schema.$Array<Schema.Struct<{
-      readonly timestamp: Schema.String;
-      readonly coverage: Schema.Struct<{
-        readonly statements: Schema.Finite;
-        readonly branches: Schema.Finite;
-        readonly functions: Schema.Finite;
-        readonly lines: Schema.Finite;
-      }>;
-      readonly delta: Schema.Struct<{
-        readonly statements: Schema.Finite;
-        readonly branches: Schema.Finite;
-        readonly functions: Schema.Finite;
-        readonly lines: Schema.Finite;
-      }>;
-      readonly direction: Schema.Literals<readonly ["improving", "regressing", "stable"]>;
-      readonly targetsHash: Schema.optional<Schema.String>;
-    }>>;
-  }>;
-}>, Schema.Struct<{
-  readonly dataAvailable: Schema.Literal<false>;
-  readonly project: Schema.String;
-}>]>;
-/**
- * The decoded {@link TestTrendsResult}.
- *
- * @public
- */
-type TestTrendsResultType = Schema.Schema.Type<typeof TestTrendsResult>;
-/**
- * The `test_trends` tool's parameters.
- *
- * @public
- */
-export declare const TestTrendsInput: Schema.Struct<{
-  readonly project: Schema.String;
-  readonly limit: Schema.optionalKey<Schema.Finite>;
-}>;
-/**
- * The decoded {@link TestTrendsInput}.
- *
- * @public
- */
-type TestTrendsInputType = Schema.Schema.Type<typeof TestTrendsInput>;
-/**
- * The `test_errors` tool's success payload — populates `structuredContent`.
- *
- * @public
- */
-export declare const TestErrorsResult: Schema.Struct<{
+export declare const TestErrorsResult: Schema.Struct<{
   readonly project: Schema.String;
   readonly errorName: Schema.optional<Schema.String>;
   readonly count: Schema.Finite;
@@ -643,6 +565,59 @@ export declare const TestErrorsInput: Schema.Struct<{
  * @public
  */
 type TestErrorsInputType = Schema.Schema.Type<typeof TestErrorsInput>;
+/**
+ * Handler for {@link testErrorsTool}.
+ *
+ * @public
+ */
+declare const handleTestErrors: (input: TestErrorsInputType) => Effect.Effect<TestErrorsResultType, never, DataReader>;
+/**
+ * The `failure_signature_get` tool's success payload.
+ *
+ * @public
+ */
+export declare const FailureSignatureGetResult: Schema.Union<readonly [Schema.Struct<{
+  readonly found: Schema.Literal<true>;
+  readonly signatureHash: Schema.String;
+  readonly firstSeenRunId: Schema.NullOr<Schema.Number>;
+  readonly firstSeenAt: Schema.String;
+  readonly lastSeenAt: Schema.NullOr<Schema.String>;
+  readonly occurrenceCount: Schema.Finite;
+  readonly recentErrors: Schema.$Array<Schema.Struct<{
+    readonly runId: Schema.Number;
+    readonly errorName: Schema.NullOr<Schema.String>;
+    readonly message: Schema.String;
+  }>>;
+}>, Schema.Struct<{
+  readonly found: Schema.Literal<false>;
+  readonly requestedHash: Schema.String;
+}>]>;
+/**
+ * The decoded {@link FailureSignatureGetResult}.
+ *
+ * @public
+ */
+type FailureSignatureGetResultType = Schema.Schema.Type<typeof FailureSignatureGetResult>;
+/**
+ * The `failure_signature_get` tool's parameters.
+ *
+ * @public
+ */
+export declare const FailureSignatureGetInput: Schema.Struct<{
+  readonly hash: Schema.String;
+}>;
+/**
+ * The decoded {@link FailureSignatureGetInput}.
+ *
+ * @public
+ */
+type FailureSignatureGetInputType = Schema.Schema.Type<typeof FailureSignatureGetInput>;
+/**
+ * Handler for {@link failureSignatureGetTool}.
+ *
+ * @public
+ */
+declare const handleFailureSignatureGet: (input: FailureSignatureGetInputType) => Effect.Effect<FailureSignatureGetResultType, never, DataReader>;
 /**
  * The `file_coverage` tool's success payload.
  *
@@ -706,316 +681,190 @@ export declare const FileCoverageInput: Schema.Struct<{
  */
 type FileCoverageInputType = Schema.Schema.Type<typeof FileCoverageInput>;
 /**
- * The `settings_list` tool's success payload.
+ * Handler for {@link fileCoverageTool}.
  *
  * @public
  */
-export declare const SettingsListResult: Schema.Struct<{
-  readonly count: Schema.Number;
-  readonly settings: Schema.$Array<Schema.Struct<{
-    readonly hash: Schema.String;
-    readonly capturedAt: Schema.String;
-  }>>;
-}>;
+declare const handleFileCoverage: (input: FileCoverageInputType) => Effect.Effect<FileCoverageResultType, never, DataReader>;
 /**
- * The decoded {@link SettingsListResult}.
+ * The `help` tool's success payload.
  *
  * @public
  */
-type SettingsListResultType = Schema.Schema.Type<typeof SettingsListResult>;
+export declare const HelpResult: Schema.Struct<{
+  readonly helpText: Schema.String;
+}>;
 /**
- * The `cache_health` tool's success payload.
+ * The decoded {@link HelpResult}.
  *
  * @public
  */
-export declare const CacheHealthResult: Schema.Union<readonly [Schema.Struct<{
-  readonly manifestPresent: Schema.Literal<true>;
-  readonly manifest: Schema.Struct<{
-    readonly updatedAt: Schema.String;
-    readonly cacheDir: Schema.String;
-    readonly projects: Schema.$Array<Schema.Struct<{
-      readonly project: Schema.String;
-      readonly reportFile: Schema.String;
-      readonly historyFile: Schema.optional<Schema.String>;
-      readonly lastRun: Schema.NullOr<Schema.String>;
-      readonly lastResult: Schema.NullOr<Schema.Literals<readonly ["passed", "failed", "interrupted"]>>;
-    }>>;
-  }>;
-  readonly ageMs: Schema.Finite;
-  readonly stale: Schema.Boolean;
-}>, Schema.Struct<{
-  readonly manifestPresent: Schema.Literal<false>;
-}>]>;
+type HelpResultType = Schema.Schema.Type<typeof HelpResult>;
 /**
- * The decoded {@link CacheHealthResult}.
+ * Handler for {@link helpTool}.
  *
  * @public
  */
-type CacheHealthResultType = Schema.Schema.Type<typeof CacheHealthResult>;
+declare const handleHelp: () => Effect.Effect<HelpResultType>;
 /**
- * The `configure` tool's success payload.
+ * The `test_history` tool's success payload.
  *
  * @public
  */
-export declare const ConfigureResult: Schema.Union<readonly [Schema.Struct<{
-  readonly found: Schema.Literal<true>;
-  readonly source: Schema.Literals<readonly ["requested", "latest"]>;
-  readonly settings: Schema.Struct<{
-    readonly hash: Schema.String;
-    readonly reporters: Schema.NullOr<Schema.String>;
-    readonly coverageEnabled: Schema.Boolean;
-    readonly coverageProvider: Schema.NullOr<Schema.String>;
-    readonly coverageThresholds: Schema.NullOr<Schema.String>;
-    readonly coverageTargets: Schema.NullOr<Schema.String>;
-    readonly pool: Schema.NullOr<Schema.String>;
-    readonly shard: Schema.NullOr<Schema.String>;
-    readonly project: Schema.NullOr<Schema.String>;
-    readonly environment: Schema.NullOr<Schema.String>;
-    readonly envVars: Schema.$Record<Schema.String, Schema.String>;
-    readonly capturedAt: Schema.String;
+export declare const TestHistoryResult: Schema.Struct<{
+  readonly project: Schema.String;
+  readonly hasData: Schema.Boolean;
+  readonly history: Schema.Struct<{
+    readonly project: Schema.String;
+    readonly updatedAt: Schema.String;
+    readonly tests: Schema.$Array<Schema.Struct<{
+      readonly modulePath: Schema.String;
+      readonly fullName: Schema.String;
+      readonly runs: Schema.$Array<Schema.Struct<{
+        readonly timestamp: Schema.String;
+        readonly state: Schema.Literals<readonly ["passed", "failed"]>;
+      }>>;
+    }>>;
   }>;
-}>, Schema.Struct<{
-  readonly found: Schema.Literal<false>;
-  readonly source: Schema.Literals<readonly ["requested", "latest"]>;
-  readonly requestedHash: Schema.optional<Schema.String>;
-}>]>;
+  readonly flaky: Schema.$Array<Schema.Struct<{
+    readonly fullName: Schema.String;
+    readonly modulePath: Schema.String;
+    readonly project: Schema.String;
+    readonly passCount: Schema.Finite;
+    readonly failCount: Schema.Finite;
+    readonly lastState: Schema.Literals<readonly ["passed", "failed"]>;
+    readonly lastTimestamp: Schema.String;
+  }>>;
+  readonly persistent: Schema.$Array<Schema.Struct<{
+    readonly fullName: Schema.String;
+    readonly modulePath: Schema.String;
+    readonly project: Schema.String;
+    readonly consecutiveFailures: Schema.Finite;
+    readonly firstFailedAt: Schema.String;
+    readonly lastFailedAt: Schema.String;
+    readonly lastErrorMessage: Schema.NullOr<Schema.String>;
+  }>>;
+  readonly recovered: Schema.$Array<Schema.Struct<{
+    readonly modulePath: Schema.String;
+    readonly fullName: Schema.String;
+    readonly recentRuns: Schema.$Array<Schema.Literals<readonly ["passed", "failed"]>>;
+  }>>;
+  readonly strayOutput: Schema.Struct<{
+    readonly runs: Schema.Finite;
+    readonly runsWithStrayOutput: Schema.Finite;
+    readonly latest: Schema.NullOr<Schema.Struct<{
+      readonly total: Schema.Finite;
+      readonly stdout: Schema.Finite;
+      readonly stderr: Schema.Finite;
+      readonly bytes: Schema.Finite;
+      readonly samples: Schema.$Array<Schema.Struct<{
+        readonly stream: Schema.Literals<readonly ["stdout", "stderr"]>;
+        readonly text: Schema.String;
+      }>>;
+    }>>;
+  }>;
+}>;
 /**
- * The decoded {@link ConfigureResult}.
+ * The decoded {@link TestHistoryResult}.
  *
  * @public
  */
-type ConfigureResultType = Schema.Schema.Type<typeof ConfigureResult>;
+type TestHistoryResultType = Schema.Schema.Type<typeof TestHistoryResult>;
 /**
- * The `configure` tool's parameters.
+ * The `test_history` tool's parameters.
  *
  * @public
  */
-export declare const ConfigureInput: Schema.Struct<{
-  readonly settingsHash: Schema.optionalKey<Schema.String>;
+export declare const TestHistoryInput: Schema.Struct<{
+  readonly project: Schema.String;
+  readonly testName: Schema.optionalKey<Schema.String>;
+  readonly modulePath: Schema.optionalKey<Schema.String>;
+  readonly limit: Schema.optionalKey<Schema.Int>;
 }>;
 /**
- * The decoded {@link ConfigureInput}.
+ * The decoded {@link TestHistoryInput}.
  *
  * @public
  */
-type ConfigureInputType = Schema.Schema.Type<typeof ConfigureInput>;
+type TestHistoryInputType = Schema.Schema.Type<typeof TestHistoryInput>;
 /**
- * The `commit_changes` tool's success payload.
+ * Handler for {@link testHistoryTool}.
  *
  * @public
  */
-export declare const CommitChangesResult: Schema.Struct<{
-  readonly filterSha: Schema.optional<Schema.String>;
-  readonly count: Schema.Finite;
-  readonly commits: Schema.$Array<Schema.Struct<{
-    readonly sha: Schema.String;
-    readonly parentSha: Schema.NullOr<Schema.String>;
-    readonly message: Schema.NullOr<Schema.String>;
-    readonly author: Schema.NullOr<Schema.String>;
-    readonly committedAt: Schema.NullOr<Schema.String>;
-    readonly branch: Schema.NullOr<Schema.String>;
-    readonly files: Schema.$Array<Schema.Struct<{
-      readonly filePath: Schema.String;
-      readonly changeKind: Schema.Literals<readonly ["added", "modified", "deleted", "renamed", "untracked-modified"]>;
-    }>>;
-  }>>;
-}>;
+declare const handleTestHistory: (input: TestHistoryInputType) => Effect.Effect<TestHistoryResultType, never, DataReader>;
 /**
- * The decoded {@link CommitChangesResult}.
+ * The `test_overview` tool's success payload.
  *
  * @public
  */
-type CommitChangesResultType = Schema.Schema.Type<typeof CommitChangesResult>;
-/**
- * The `commit_changes` tool's parameters.
- *
- * @public
- */
-export declare const CommitChangesInput: Schema.Struct<{
-  readonly sha: Schema.optionalKey<Schema.String>;
-}>;
-/**
- * The decoded {@link CommitChangesInput}.
- *
- * @public
- */
-type CommitChangesInputType = Schema.Schema.Type<typeof CommitChangesInput>;
-/**
- * The `turn_search` tool's success payload.
- *
- * @public
- */
-export declare const TurnSearchResult: Schema.Struct<{
-  readonly count: Schema.Finite;
-  readonly turns: Schema.$Array<Schema.Struct<{
-    readonly id: Schema.Finite;
-    readonly sessionId: Schema.Finite;
-    readonly turnNo: Schema.Finite;
-    readonly type: Schema.String;
-    readonly payload: Schema.String;
-    readonly occurredAt: Schema.String;
-  }>>;
-}>;
-/**
- * The decoded {@link TurnSearchResult}.
- *
- * @public
- */
-type TurnSearchResultType = Schema.Schema.Type<typeof TurnSearchResult>;
-/**
- * The `turn_search` tool's parameters.
- *
- * @public
- */
-export declare const TurnSearchInput: Schema.Struct<{
-  readonly sessionId: Schema.optionalKey<Schema.Finite>;
-  readonly since: Schema.optionalKey<Schema.String>;
-  readonly type: Schema.optionalKey<Schema.Literals<readonly ["user_prompt", "tool_call", "tool_result", "file_edit", "hook_fire", "note", "hypothesis"]>>;
-  readonly limit: Schema.optionalKey<Schema.Finite>;
-}>;
-/**
- * The decoded {@link TurnSearchInput}.
- *
- * @public
- */
-type TurnSearchInputType = Schema.Schema.Type<typeof TurnSearchInput>;
-/**
- * The `failure_signature_get` tool's success payload.
- *
- * @public
- */
-export declare const FailureSignatureGetResult: Schema.Union<readonly [Schema.Struct<{
-  readonly found: Schema.Literal<true>;
-  readonly signatureHash: Schema.String;
-  readonly firstSeenRunId: Schema.NullOr<Schema.Number>;
-  readonly firstSeenAt: Schema.String;
-  readonly lastSeenAt: Schema.NullOr<Schema.String>;
-  readonly occurrenceCount: Schema.Finite;
-  readonly recentErrors: Schema.$Array<Schema.Struct<{
-    readonly runId: Schema.Number;
-    readonly errorName: Schema.NullOr<Schema.String>;
-    readonly message: Schema.String;
+export declare const TestOverviewResult: Schema.Union<readonly [Schema.Struct<{
+  readonly dataAvailable: Schema.Literal<true>;
+  readonly projectFilter: Schema.optional<Schema.String>;
+  readonly runs: Schema.$Array<Schema.Struct<{
+    readonly project: Schema.String;
+    readonly lastRun: Schema.NullOr<Schema.String>;
+    readonly lastResult: Schema.NullOr<Schema.Literals<readonly ["passed", "failed", "interrupted"]>>;
+    readonly total: Schema.Number;
+    readonly passed: Schema.Number;
+    readonly failed: Schema.Number;
+    readonly skipped: Schema.Number;
   }>>;
 }>, Schema.Struct<{
-  readonly found: Schema.Literal<false>;
-  readonly requestedHash: Schema.String;
+  readonly dataAvailable: Schema.Literal<false>;
+  readonly projectFilter: Schema.optional<Schema.String>;
+  readonly reason: Schema.Literals<readonly ["no_runs", "project_filter_empty"]>;
 }>]>;
 /**
- * The decoded {@link FailureSignatureGetResult}.
- *
- * @public
- */
-type FailureSignatureGetResultType = Schema.Schema.Type<typeof FailureSignatureGetResult>;
-/**
- * The `failure_signature_get` tool's parameters.
- *
- * @public
- */
-export declare const FailureSignatureGetInput: Schema.Struct<{
-  readonly hash: Schema.String;
-}>;
-/**
- * The decoded {@link FailureSignatureGetInput}.
- *
- * @public
- */
-type FailureSignatureGetInputType = Schema.Schema.Type<typeof FailureSignatureGetInput>;
-/**
- * The `acceptance_metrics` tool's success payload.
- *
- * @public
- */
-export declare const AcceptanceMetricsResult: Schema.Struct<{
-  readonly phaseEvidenceIntegrity: Schema.Struct<{
-    readonly total: Schema.Finite;
-    readonly compliant: Schema.Finite;
-    readonly ratio: Schema.Finite;
-  }>;
-  readonly complianceHookResponsiveness: Schema.Struct<{
-    readonly total: Schema.Finite;
-    readonly withFollowup: Schema.Finite;
-    readonly ratio: Schema.Finite;
-  }>;
-  readonly orientationUsefulness: Schema.Struct<{
-    readonly total: Schema.Finite;
-    readonly referencedCount: Schema.Finite;
-    readonly ratio: Schema.Finite;
-  }>;
-  readonly antiPatternDetectionRate: Schema.Struct<{
-    readonly total: Schema.Finite;
-    readonly cleanSessions: Schema.Finite;
-    readonly ratio: Schema.Finite;
-  }>;
-}>;
-/**
- * The decoded {@link AcceptanceMetricsResult}.
- *
- * @public
- */
-type AcceptanceMetricsResultType = Schema.Schema.Type<typeof AcceptanceMetricsResult>;
-/**
- * The `triage_brief` tool's success payload.
- *
- * @public
- */
-export declare const TriageBriefResult: Schema.Struct<{
-  readonly hasContent: Schema.Boolean;
-  readonly markdown: Schema.String;
-}>;
-/**
- * The decoded {@link TriageBriefResult}.
+ * The decoded {@link TestOverviewResult}.
  *
  * @public
  */
-type TriageBriefResultType = Schema.Schema.Type<typeof TriageBriefResult>;
+type TestOverviewResultType = Schema.Schema.Type<typeof TestOverviewResult>;
 /**
- * The `triage_brief` tool's parameters.
+ * The `test_overview` tool's parameters.
  *
  * @public
  */
-export declare const TriageBriefInput: Schema.Struct<{
+export declare const TestOverviewInput: Schema.Struct<{
   readonly project: Schema.optionalKey<Schema.String>;
-  readonly maxLines: Schema.optionalKey<Schema.Finite>;
 }>;
 /**
- * The decoded {@link TriageBriefInput}.
+ * The decoded {@link TestOverviewInput}.
  *
  * @public
  */
-type TriageBriefInputType = Schema.Schema.Type<typeof TriageBriefInput>;
+type TestOverviewInputType = Schema.Schema.Type<typeof TestOverviewInput>;
 /**
- * The `wrapup_prompt` tool's success payload.
+ * Handler for {@link testOverviewTool}.
  *
  * @public
  */
-export declare const WrapupPromptResult: Schema.Struct<{
-  readonly hasContent: Schema.Boolean;
-  readonly kind: Schema.Literals<readonly ["stop", "session_end", "pre_compact", "tdd_handoff", "user_prompt_nudge"]>;
-  readonly markdown: Schema.String;
-}>;
+declare const handleTestOverview: (input: TestOverviewInputType) => Effect.Effect<TestOverviewResultType, never, DataReader>;
 /**
- * The decoded {@link WrapupPromptResult}.
+ * The `ping` tool's success payload.
  *
  * @public
  */
-type WrapupPromptResultType = Schema.Schema.Type<typeof WrapupPromptResult>;
+export declare const PingResult: Schema.Struct<{
+  readonly message: Schema.Literal<"pong">;
+  readonly distribution: Schema.NullOr<Schema.Struct<{
+    readonly name: Schema.String;
+    readonly version: Schema.String;
+  }>>;
+}>;
 /**
- * The `wrapup_prompt` tool's parameters.
+ * The decoded {@link PingResult}.
  *
  * @public
  */
-export declare const WrapupPromptInput: Schema.Struct<{
-  readonly sessionId: Schema.optionalKey<Schema.Finite>;
-  readonly chatId: Schema.optionalKey<Schema.String>;
-  readonly kind: Schema.optionalKey<Schema.Literals<readonly ["stop", "session_end", "pre_compact", "tdd_handoff", "user_prompt_nudge"]>>;
-  readonly userPromptHint: Schema.optionalKey<Schema.String>;
-}>;
+type PingResultType = Schema.Schema.Type<typeof PingResult>;
 /**
- * The decoded {@link WrapupPromptInput}.
+ * Handler for {@link pingTool}.
  *
  * @public
  */
-type WrapupPromptInputType = Schema.Schema.Type<typeof WrapupPromptInput>;
+declare const handlePing: () => Effect.Effect<PingResultType>;
 /**
  * The `register_agent` tool's parameters.
  *
@@ -1064,142 +913,15 @@ export declare const RegisterAgentResult: Schema.Union<readonly [Schema.Struct<{
  */
 type RegisterAgentOutput = Schema.Schema.Type<typeof RegisterAgentResult>;
 /**
- * The `tdd_phase_transition_request` tool's success payload.
- *
- * @public
- */
-export declare const PhaseTransitionResult: Schema.Union<readonly [Schema.Struct<{
-  readonly accepted: Schema.Literal<true>;
-  readonly phase: Schema.Literals<readonly ["spike", "red", "red.triangulate", "green", "green.fake-it", "refactor", "extended-red", "green-without-red"]>;
-  readonly newPhaseId: Schema.Finite;
-  readonly previousPhaseId: Schema.NullOr<Schema.Number>;
-  readonly citedArtifactId: Schema.optional<Schema.Number>;
-  readonly citedArtifactSource: Schema.optional<Schema.Literals<readonly ["explicit-id", "explicit-kind", "transition-derived", "none"]>>;
-}>, Schema.Struct<{
-  readonly accepted: Schema.Literal<false>;
-  readonly phase: Schema.Literals<readonly ["spike", "red", "red.triangulate", "green", "green.fake-it", "refactor", "extended-red", "green-without-red"]>;
-  readonly denialReason: Schema.Literals<readonly ["missing_artifact_evidence", "wrong_artifact_kind", "wrong_source_phase", "unknown_tdd_task", "tdd_task_already_ended", "goal_not_started", "goal_not_found", "goal_not_in_progress", "goal_not_in_tdd_task", "behavior_not_found", "behavior_not_in_goal", "refactor_without_passing_run", "evidence_not_in_phase_window", "evidence_not_for_behavior", "evidence_test_was_already_failing"]>;
-  readonly remediation: Schema.Struct<{
-    readonly hint: Schema.String;
-    readonly suggestedTool: Schema.optionalKey<Schema.String>;
-    readonly suggestedArgs: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Unknown>>;
-  }>;
-}>]>;
-/**
- * The decoded {@link PhaseTransitionResult}.
- *
- * @public
- */
-type PhaseTransitionResultType = Schema.Schema.Type<typeof PhaseTransitionResult>;
-/**
- * The `tdd_phase_transition_request` tool's parameters.
- *
- * `citedArtifactId` is optional in 2.0+. When omitted, the tool resolves
- * the most recent matching artifact for this session, where "matching" is
- * either the explicit `citedArtifactKind` value, or the kind required by
- * the transition (per `requiredArtifactForTransition`), or "no artifact
- * needed" for transitions like `spike→red` where the validator's
- * `requiredArtifactForTransition` returns null. The accepted response
- * carries `citedArtifactId` so the caller can see which row was used.
- *
- * @public
- */
-export declare const PhaseTransitionInput: Schema.Struct<{
-  readonly tddTaskId: Schema.Finite;
-  readonly goalId: Schema.Finite;
-  readonly requestedPhase: Schema.Literals<readonly ["spike", "red", "red.triangulate", "green", "green.fake-it", "refactor", "extended-red", "green-without-red"]>;
-  readonly citedArtifactId: Schema.optionalKey<Schema.Finite>;
-  readonly citedArtifactKind: Schema.optionalKey<Schema.Literals<readonly ["test_written", "test_failed_run", "code_written", "test_passed_run", "refactor", "test_weakened"]>>;
-  readonly behaviorId: Schema.optionalKey<Schema.Finite>;
-  readonly reason: Schema.optionalKey<Schema.String>;
-}>;
-/**
- * The decoded {@link PhaseTransitionInput}.
+ * Handler for {@link registerAgentTool}. Idempotency is the tool's own
+ * business rule (the `agents` idempotency key), not the generic
+ * `withIdempotency` combinator.
  *
  * @public
  */
-type PhaseTransitionInputType = Schema.Schema.Type<typeof PhaseTransitionInput>;
+declare const handleRegisterAgent: (input: RegisterAgentInputType) => Effect.Effect<RegisterAgentOutput, never, DataReader | DataStore>;
 /**
- * The `tdd_artifact_list` tool's success payload.
- *
- * @public
- */
-export declare const TddArtifactListResult: Schema.Struct<{
-  readonly tddTaskId: Schema.Number;
-  readonly filters: Schema.Struct<{
-    readonly artifactKind: Schema.optional<Schema.Literals<readonly ["test_written", "test_failed_run", "code_written", "test_passed_run", "refactor", "test_weakened"]>>;
-    readonly phaseId: Schema.optional<Schema.Number>;
-    readonly behaviorId: Schema.optional<Schema.Number>;
-  }>;
-  readonly count: Schema.Number;
-  readonly artifacts: Schema.$Array<Schema.Struct<{
-    readonly id: Schema.Finite;
-    readonly tddTaskId: Schema.Number;
-    readonly phaseId: Schema.Number;
-    readonly phaseName: Schema.Literals<readonly ["spike", "red", "red.triangulate", "green", "green.fake-it", "refactor", "extended-red", "green-without-red"]>;
-    readonly artifactKind: Schema.Literals<readonly ["test_written", "test_failed_run", "code_written", "test_passed_run", "refactor", "test_weakened"]>;
-    readonly behaviorId: Schema.NullOr<Schema.Number>;
-    readonly testCaseId: Schema.NullOr<Schema.Number>;
-    readonly testRunId: Schema.NullOr<Schema.Number>;
-    readonly testFirstFailureRunId: Schema.NullOr<Schema.Number>;
-    readonly recordedAt: Schema.String;
-    readonly suite: Schema.Literals<readonly ["vitest", "bats"]>;
-  }>>;
-}>;
-/**
- * The decoded {@link TddArtifactListResult}.
- *
- * @public
- */
-type TddArtifactListResultType = Schema.Schema.Type<typeof TddArtifactListResult>;
-/**
- * The `tdd_artifact_list` tool's parameters.
- *
- * @public
- */
-export declare const TddArtifactListInput: Schema.Struct<{
-  readonly tddTaskId: Schema.Finite;
-  readonly artifactKind: Schema.optionalKey<Schema.Literals<readonly ["test_written", "test_failed_run", "code_written", "test_passed_run", "refactor", "test_weakened"]>>;
-  readonly phaseId: Schema.optionalKey<Schema.Finite>;
-  readonly behaviorId: Schema.optionalKey<Schema.Finite>;
-  readonly limit: Schema.optionalKey<Schema.Finite>;
-}>;
-/**
- * The decoded {@link TddArtifactListInput}.
- *
- * @public
- */
-type TddArtifactListInputType = Schema.Schema.Type<typeof TddArtifactListInput>;
-/**
- * The `tdd_progress_push` tool's parameters.
- *
- * @public
- */
-export declare const TddProgressPushInput: Schema.Struct<{
-  readonly payload: Schema.String;
-}>;
-/**
- * The decoded {@link TddProgressPushInput}.
- *
- * @public
- */
-type TddProgressPushInputType = Schema.Schema.Type<typeof TddProgressPushInput>;
-/**
- * The `tdd_progress_push` result — always `{ ok: true }`.
- *
- * @public
- */
-export declare const TddProgressPushResult: Schema.Struct<{
-  readonly ok: Schema.Literal<true>;
-}>;
-/**
- * The decoded {@link TddProgressPushResult}.
- *
- * @public
- */
-type TddProgressPushResultType = Schema.Schema.Type<typeof TddProgressPushResult>;
-/**
- * The `run_tests` tool's success payload.
+ * The `run_tests` tool's success payload.
  *
  * @public
  */
@@ -1434,40 +1156,467 @@ export declare const RunTestsResult: Schema.Union<readonly [Schema.Struct<{
   }>;
 }>]>;
 /**
- * The decoded {@link RunTestsResult}.
+ * The decoded {@link RunTestsResult}.
+ *
+ * @public
+ */
+type RunTestsResultType = Schema.Schema.Type<typeof RunTestsResult>;
+/**
+ * The `run_tests` tool's parameters. `tags` and `_sessionContext` are
+ * nested structs and are served strict at their own level (issue #243).
+ *
+ * @public
+ */
+export declare const RunTestsInput: Schema.Struct<{
+  readonly files: Schema.optionalKey<Schema.$Array<Schema.String>>;
+  readonly project: Schema.optionalKey<Schema.String>;
+  readonly projectRoot: Schema.optionalKey<Schema.String>;
+  readonly tags: Schema.optionalKey<Schema.Struct<{
+    readonly all: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    readonly any: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    readonly none: Schema.optionalKey<Schema.$Array<Schema.String>>;
+  }>>;
+  readonly passWithNoTests: Schema.optionalKey<Schema.Boolean>;
+  readonly timeout: Schema.optionalKey<Schema.Finite>;
+  readonly _sessionContext: Schema.optionalKey<Schema.Struct<{
+    readonly chatId: Schema.String;
+    readonly conversationId: Schema.String;
+    readonly mainAgentId: Schema.String;
+  }>>;
+}>;
+/**
+ * The decoded {@link RunTestsInput}.
+ *
+ * @public
+ */
+type RunTestsInputType = Schema.Schema.Type<typeof RunTestsInput>;
+/**
+ * Handler for {@link runTestsTool}. Serialized through a one-permit
+ * semaphore: the body assigns the active attribution UUIDs into
+ * `process.env.VITEST_AGENT_*` and then awaits `createVitest` /
+ * `vitest.start`, which spawns the worker pool that snapshots env at
+ * spawn time — two interleaved calls would race, attributing one call's
+ * results to the other's agent.
+ *
+ * @public
+ */
+declare const handleRunTests: (input: RunTestsInputType) => Effect.Effect<RunTestsResultType, never, McpSession | DataReader | DataStore>;
+/**
+ * The `settings_list` tool's success payload.
+ *
+ * @public
+ */
+export declare const SettingsListResult: Schema.Struct<{
+  readonly count: Schema.Number;
+  readonly settings: Schema.$Array<Schema.Struct<{
+    readonly hash: Schema.String;
+    readonly capturedAt: Schema.String;
+  }>>;
+}>;
+/**
+ * The decoded {@link SettingsListResult}.
+ *
+ * @public
+ */
+type SettingsListResultType = Schema.Schema.Type<typeof SettingsListResult>;
+/**
+ * Handler for {@link settingsListTool}.
+ *
+ * @public
+ */
+declare const handleSettingsList: () => Effect.Effect<SettingsListResultType, never, DataReader>;
+/**
+ * The `test_status` tool's success payload.
+ *
+ * @public
+ */
+export declare const TestStatusResult: Schema.Union<readonly [Schema.Struct<{
+  readonly dataAvailable: Schema.Literal<true>;
+  readonly manifestUpdatedAt: Schema.String;
+  readonly projectFilter: Schema.optional<Schema.String>;
+  readonly entries: Schema.$Array<Schema.Struct<{
+    readonly project: Schema.String;
+    readonly reportFile: Schema.String;
+    readonly historyFile: Schema.optional<Schema.String>;
+    readonly lastRun: Schema.NullOr<Schema.String>;
+    readonly lastResult: Schema.NullOr<Schema.Literals<readonly ["passed", "failed", "interrupted"]>>;
+    readonly strayOutput: Schema.optionalKey<Schema.Struct<{
+      readonly total: Schema.Finite;
+      readonly stdout: Schema.Finite;
+      readonly stderr: Schema.Finite;
+      readonly bytes: Schema.Finite;
+      readonly samples: Schema.$Array<Schema.Struct<{
+        readonly stream: Schema.Literals<readonly ["stdout", "stderr"]>;
+        readonly text: Schema.String;
+      }>>;
+    }>>;
+  }>>;
+}>, Schema.Struct<{
+  readonly dataAvailable: Schema.Literal<false>;
+  readonly projectFilter: Schema.optional<Schema.String>;
+  readonly reason: Schema.Literals<readonly ["no_manifest", "project_filter_empty"]>;
+}>]>;
+/**
+ * The decoded {@link TestStatusResult}.
+ *
+ * @public
+ */
+type TestStatusResultType = Schema.Schema.Type<typeof TestStatusResult>;
+/**
+ * The `test_status` tool's parameters.
+ *
+ * @public
+ */
+export declare const TestStatusInput: Schema.Struct<{
+  readonly project: Schema.optionalKey<Schema.String>;
+}>;
+/**
+ * The decoded {@link TestStatusInput}.
+ *
+ * @public
+ */
+type TestStatusInputType = Schema.Schema.Type<typeof TestStatusInput>;
+/**
+ * Handler for {@link testStatusTool}: the single implementation of the
+ * tool.
+ *
+ * @public
+ */
+declare const handleTestStatus: (input: TestStatusInputType) => Effect.Effect<TestStatusResultType, never, DataReader>;
+/**
+ * The `tdd_artifact_list` tool's success payload.
+ *
+ * @public
+ */
+export declare const TddArtifactListResult: Schema.Struct<{
+  readonly tddTaskId: Schema.Number;
+  readonly filters: Schema.Struct<{
+    readonly artifactKind: Schema.optional<Schema.Literals<readonly ["test_written", "test_failed_run", "code_written", "test_passed_run", "refactor", "test_weakened"]>>;
+    readonly phaseId: Schema.optional<Schema.Number>;
+    readonly behaviorId: Schema.optional<Schema.Number>;
+  }>;
+  readonly count: Schema.Number;
+  readonly artifacts: Schema.$Array<Schema.Struct<{
+    readonly id: Schema.Finite;
+    readonly tddTaskId: Schema.Number;
+    readonly phaseId: Schema.Number;
+    readonly phaseName: Schema.Literals<readonly ["spike", "red", "red.triangulate", "green", "green.fake-it", "refactor", "extended-red", "green-without-red"]>;
+    readonly artifactKind: Schema.Literals<readonly ["test_written", "test_failed_run", "code_written", "test_passed_run", "refactor", "test_weakened"]>;
+    readonly behaviorId: Schema.NullOr<Schema.Number>;
+    readonly testCaseId: Schema.NullOr<Schema.Number>;
+    readonly testRunId: Schema.NullOr<Schema.Number>;
+    readonly testFirstFailureRunId: Schema.NullOr<Schema.Number>;
+    readonly recordedAt: Schema.String;
+    readonly suite: Schema.Literals<readonly ["vitest", "bats"]>;
+  }>>;
+}>;
+/**
+ * The decoded {@link TddArtifactListResult}.
+ *
+ * @public
+ */
+type TddArtifactListResultType = Schema.Schema.Type<typeof TddArtifactListResult>;
+/**
+ * The `tdd_artifact_list` tool's parameters.
+ *
+ * @public
+ */
+export declare const TddArtifactListInput: Schema.Struct<{
+  readonly tddTaskId: Schema.Finite;
+  readonly artifactKind: Schema.optionalKey<Schema.Literals<readonly ["test_written", "test_failed_run", "code_written", "test_passed_run", "refactor", "test_weakened"]>>;
+  readonly phaseId: Schema.optionalKey<Schema.Finite>;
+  readonly behaviorId: Schema.optionalKey<Schema.Finite>;
+  readonly limit: Schema.optionalKey<Schema.Finite>;
+}>;
+/**
+ * The decoded {@link TddArtifactListInput}.
+ *
+ * @public
+ */
+type TddArtifactListInputType = Schema.Schema.Type<typeof TddArtifactListInput>;
+/**
+ * Handler for {@link tddArtifactListTool}.
+ *
+ * @public
+ */
+declare const handleTddArtifactList: (input: TddArtifactListInputType) => Effect.Effect<TddArtifactListResultType, never, DataReader>;
+/**
+ * The `tdd_phase_transition_request` tool's success payload.
+ *
+ * @public
+ */
+export declare const PhaseTransitionResult: Schema.Union<readonly [Schema.Struct<{
+  readonly accepted: Schema.Literal<true>;
+  readonly phase: Schema.Literals<readonly ["spike", "red", "red.triangulate", "green", "green.fake-it", "refactor", "extended-red", "green-without-red"]>;
+  readonly newPhaseId: Schema.Finite;
+  readonly previousPhaseId: Schema.NullOr<Schema.Number>;
+  readonly citedArtifactId: Schema.optional<Schema.Number>;
+  readonly citedArtifactSource: Schema.optional<Schema.Literals<readonly ["explicit-id", "explicit-kind", "transition-derived", "none"]>>;
+}>, Schema.Struct<{
+  readonly accepted: Schema.Literal<false>;
+  readonly phase: Schema.Literals<readonly ["spike", "red", "red.triangulate", "green", "green.fake-it", "refactor", "extended-red", "green-without-red"]>;
+  readonly denialReason: Schema.Literals<readonly ["missing_artifact_evidence", "wrong_artifact_kind", "wrong_source_phase", "unknown_tdd_task", "tdd_task_already_ended", "goal_not_started", "goal_not_found", "goal_not_in_progress", "goal_not_in_tdd_task", "behavior_not_found", "behavior_not_in_goal", "refactor_without_passing_run", "evidence_not_in_phase_window", "evidence_not_for_behavior", "evidence_test_was_already_failing"]>;
+  readonly remediation: Schema.Struct<{
+    readonly hint: Schema.String;
+    readonly suggestedTool: Schema.optionalKey<Schema.String>;
+    readonly suggestedArgs: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Unknown>>;
+  }>;
+}>]>;
+/**
+ * The decoded {@link PhaseTransitionResult}.
+ *
+ * @public
+ */
+type PhaseTransitionResultType = Schema.Schema.Type<typeof PhaseTransitionResult>;
+/**
+ * The `tdd_phase_transition_request` tool's parameters.
+ *
+ * `citedArtifactId` is optional in 2.0+. When omitted, the tool resolves
+ * the most recent matching artifact for this session, where "matching" is
+ * either the explicit `citedArtifactKind` value, or the kind required by
+ * the transition (per `requiredArtifactForTransition`), or "no artifact
+ * needed" for transitions like `spike→red` where the validator's
+ * `requiredArtifactForTransition` returns null. The accepted response
+ * carries `citedArtifactId` so the caller can see which row was used.
+ *
+ * @public
+ */
+export declare const PhaseTransitionInput: Schema.Struct<{
+  readonly tddTaskId: Schema.Finite;
+  readonly goalId: Schema.Finite;
+  readonly requestedPhase: Schema.Literals<readonly ["spike", "red", "red.triangulate", "green", "green.fake-it", "refactor", "extended-red", "green-without-red"]>;
+  readonly citedArtifactId: Schema.optionalKey<Schema.Finite>;
+  readonly citedArtifactKind: Schema.optionalKey<Schema.Literals<readonly ["test_written", "test_failed_run", "code_written", "test_passed_run", "refactor", "test_weakened"]>>;
+  readonly behaviorId: Schema.optionalKey<Schema.Finite>;
+  readonly reason: Schema.optionalKey<Schema.String>;
+}>;
+/**
+ * The decoded {@link PhaseTransitionInput}.
+ *
+ * @public
+ */
+type PhaseTransitionInputType = Schema.Schema.Type<typeof PhaseTransitionInput>;
+/**
+ * Handler for {@link tddPhaseTransitionRequestTool}.
+ *
+ * @public
+ */
+declare const handlePhaseTransitionRequest: (input: PhaseTransitionInputType) => Effect.Effect<PhaseTransitionResultType, never, DataReader | DataStore>;
+/**
+ * The `tdd_progress_push` tool's parameters.
+ *
+ * @public
+ */
+export declare const TddProgressPushInput: Schema.Struct<{
+  readonly payload: Schema.String;
+}>;
+/**
+ * The decoded {@link TddProgressPushInput}.
+ *
+ * @public
+ */
+type TddProgressPushInputType = Schema.Schema.Type<typeof TddProgressPushInput>;
+/**
+ * The `tdd_progress_push` result — always `{ ok: true }`.
+ *
+ * @public
+ */
+export declare const TddProgressPushResult: Schema.Struct<{
+  readonly ok: Schema.Literal<true>;
+}>;
+/**
+ * The decoded {@link TddProgressPushResult}.
+ *
+ * @public
+ */
+type TddProgressPushResultType = Schema.Schema.Type<typeof TddProgressPushResult>;
+/**
+ * Handler for {@link tddProgressPushTool}. Malformed JSON is forwarded as
+ * the raw string; a DB read failure forwards the decoded event unenriched;
+ * a notification failure (no initialized client, transport gone) is
+ * ignored. The result is `{ ok: true }` on every path.
+ *
+ * @public
+ */
+declare const handleTddProgressPush: (input: TddProgressPushInputType) => Effect.Effect<TddProgressPushResultType, never, DataReader | McpServer.McpServer>;
+/**
+ * The `test_trends` tool's success payload.
+ *
+ * @public
+ */
+export declare const TestTrendsResult: Schema.Union<readonly [Schema.Struct<{
+  readonly dataAvailable: Schema.Literal<true>;
+  readonly project: Schema.String;
+  readonly trends: Schema.Struct<{
+    readonly entries: Schema.$Array<Schema.Struct<{
+      readonly timestamp: Schema.String;
+      readonly coverage: Schema.Struct<{
+        readonly statements: Schema.Finite;
+        readonly branches: Schema.Finite;
+        readonly functions: Schema.Finite;
+        readonly lines: Schema.Finite;
+      }>;
+      readonly delta: Schema.Struct<{
+        readonly statements: Schema.Finite;
+        readonly branches: Schema.Finite;
+        readonly functions: Schema.Finite;
+        readonly lines: Schema.Finite;
+      }>;
+      readonly direction: Schema.Literals<readonly ["improving", "regressing", "stable"]>;
+      readonly targetsHash: Schema.optional<Schema.String>;
+    }>>;
+  }>;
+}>, Schema.Struct<{
+  readonly dataAvailable: Schema.Literal<false>;
+  readonly project: Schema.String;
+}>]>;
+/**
+ * The decoded {@link TestTrendsResult}.
+ *
+ * @public
+ */
+type TestTrendsResultType = Schema.Schema.Type<typeof TestTrendsResult>;
+/**
+ * The `test_trends` tool's parameters.
+ *
+ * @public
+ */
+export declare const TestTrendsInput: Schema.Struct<{
+  readonly project: Schema.String;
+  readonly limit: Schema.optionalKey<Schema.Finite>;
+}>;
+/**
+ * The decoded {@link TestTrendsInput}.
+ *
+ * @public
+ */
+type TestTrendsInputType = Schema.Schema.Type<typeof TestTrendsInput>;
+/**
+ * Handler for {@link testTrendsTool}.
+ *
+ * @public
+ */
+declare const handleTestTrends: (input: TestTrendsInputType) => Effect.Effect<TestTrendsResultType, never, DataReader>;
+/**
+ * The `triage_brief` tool's success payload.
+ *
+ * @public
+ */
+export declare const TriageBriefResult: Schema.Struct<{
+  readonly hasContent: Schema.Boolean;
+  readonly markdown: Schema.String;
+}>;
+/**
+ * The decoded {@link TriageBriefResult}.
+ *
+ * @public
+ */
+type TriageBriefResultType = Schema.Schema.Type<typeof TriageBriefResult>;
+/**
+ * The `triage_brief` tool's parameters.
+ *
+ * @public
+ */
+export declare const TriageBriefInput: Schema.Struct<{
+  readonly project: Schema.optionalKey<Schema.String>;
+  readonly maxLines: Schema.optionalKey<Schema.Finite>;
+}>;
+/**
+ * The decoded {@link TriageBriefInput}.
+ *
+ * @public
+ */
+type TriageBriefInputType = Schema.Schema.Type<typeof TriageBriefInput>;
+/**
+ * Handler for {@link triageBriefTool}.
+ *
+ * @public
+ */
+declare const handleTriageBrief: (input: TriageBriefInputType) => Effect.Effect<TriageBriefResultType, never, DataReader>;
+/**
+ * The `turn_search` tool's success payload.
+ *
+ * @public
+ */
+export declare const TurnSearchResult: Schema.Struct<{
+  readonly count: Schema.Finite;
+  readonly turns: Schema.$Array<Schema.Struct<{
+    readonly id: Schema.Finite;
+    readonly sessionId: Schema.Finite;
+    readonly turnNo: Schema.Finite;
+    readonly type: Schema.String;
+    readonly payload: Schema.String;
+    readonly occurredAt: Schema.String;
+  }>>;
+}>;
+/**
+ * The decoded {@link TurnSearchResult}.
  *
  * @public
  */
-type RunTestsResultType = Schema.Schema.Type<typeof RunTestsResult>;
+type TurnSearchResultType = Schema.Schema.Type<typeof TurnSearchResult>;
 /**
- * The `run_tests` tool's parameters. `tags` and `_sessionContext` are
- * nested structs and are served strict at their own level (issue #243).
+ * The `turn_search` tool's parameters.
  *
  * @public
  */
-export declare const RunTestsInput: Schema.Struct<{
-  readonly files: Schema.optionalKey<Schema.$Array<Schema.String>>;
-  readonly project: Schema.optionalKey<Schema.String>;
-  readonly projectRoot: Schema.optionalKey<Schema.String>;
-  readonly tags: Schema.optionalKey<Schema.Struct<{
-    readonly all: Schema.optionalKey<Schema.$Array<Schema.String>>;
-    readonly any: Schema.optionalKey<Schema.$Array<Schema.String>>;
-    readonly none: Schema.optionalKey<Schema.$Array<Schema.String>>;
-  }>>;
-  readonly passWithNoTests: Schema.optionalKey<Schema.Boolean>;
-  readonly timeout: Schema.optionalKey<Schema.Finite>;
-  readonly _sessionContext: Schema.optionalKey<Schema.Struct<{
-    readonly chatId: Schema.String;
-    readonly conversationId: Schema.String;
-    readonly mainAgentId: Schema.String;
-  }>>;
+export declare const TurnSearchInput: Schema.Struct<{
+  readonly sessionId: Schema.optionalKey<Schema.Finite>;
+  readonly since: Schema.optionalKey<Schema.String>;
+  readonly type: Schema.optionalKey<Schema.Literals<readonly ["user_prompt", "tool_call", "tool_result", "file_edit", "hook_fire", "note", "hypothesis"]>>;
+  readonly limit: Schema.optionalKey<Schema.Finite>;
 }>;
 /**
- * The decoded {@link RunTestsInput}.
+ * The decoded {@link TurnSearchInput}.
  *
  * @public
  */
-type RunTestsInputType = Schema.Schema.Type<typeof RunTestsInput>;
+type TurnSearchInputType = Schema.Schema.Type<typeof TurnSearchInput>;
+/**
+ * Handler for {@link turnSearchTool}.
+ *
+ * @public
+ */
+declare const handleTurnSearch: (input: TurnSearchInputType) => Effect.Effect<TurnSearchResultType, never, DataReader>;
+/**
+ * The `wrapup_prompt` tool's success payload.
+ *
+ * @public
+ */
+export declare const WrapupPromptResult: Schema.Struct<{
+  readonly hasContent: Schema.Boolean;
+  readonly kind: Schema.Literals<readonly ["stop", "session_end", "pre_compact", "tdd_handoff", "user_prompt_nudge"]>;
+  readonly markdown: Schema.String;
+}>;
+/**
+ * The decoded {@link WrapupPromptResult}.
+ *
+ * @public
+ */
+type WrapupPromptResultType = Schema.Schema.Type<typeof WrapupPromptResult>;
+/**
+ * The `wrapup_prompt` tool's parameters.
+ *
+ * @public
+ */
+export declare const WrapupPromptInput: Schema.Struct<{
+  readonly sessionId: Schema.optionalKey<Schema.Finite>;
+  readonly chatId: Schema.optionalKey<Schema.String>;
+  readonly kind: Schema.optionalKey<Schema.Literals<readonly ["stop", "session_end", "pre_compact", "tdd_handoff", "user_prompt_nudge"]>>;
+  readonly userPromptHint: Schema.optionalKey<Schema.String>;
+}>;
+/**
+ * The decoded {@link WrapupPromptInput}.
+ *
+ * @public
+ */
+type WrapupPromptInputType = Schema.Schema.Type<typeof WrapupPromptInput>;
+/**
+ * Handler for {@link wrapupPromptTool}.
+ *
+ * @public
+ */
+declare const handleWrapupPrompt: (input: WrapupPromptInputType) => Effect.Effect<WrapupPromptResultType, never, DataReader>;
 /**
  * Every tool the server registers.
  *
@@ -3117,24 +3266,24 @@ export declare const Kit: Toolkit.Toolkit<{
  * @public
  */
 export declare const toolHandlers: {
-  ping: () => import("effect/Effect").Effect<PingResultType>;
-  help: () => import("effect/Effect").Effect<HelpResultType>;
-  test_status: (input: TestStatusInputType) => import("effect/Effect").Effect<TestStatusResultType, never, import("@vitest-agent/engine").DataReader>;
-  test_overview: (input: TestOverviewInputType) => import("effect/Effect").Effect<TestOverviewResultType, never, import("@vitest-agent/engine").DataReader>;
-  test_coverage: (input: TestCoverageInputType) => import("effect/Effect").Effect<TestCoverageResultType, never, import("@vitest-agent/engine").DataReader>;
-  test_history: (input: TestHistoryInputType) => import("effect/Effect").Effect<TestHistoryResultType, never, import("@vitest-agent/engine").DataReader>;
-  test_trends: (input: TestTrendsInputType) => import("effect/Effect").Effect<TestTrendsResultType, never, import("@vitest-agent/engine").DataReader>;
-  test_errors: (input: TestErrorsInputType) => import("effect/Effect").Effect<TestErrorsResultType, never, import("@vitest-agent/engine").DataReader>;
-  file_coverage: (input: FileCoverageInputType) => import("effect/Effect").Effect<FileCoverageResultType, never, import("@vitest-agent/engine").DataReader>;
-  settings_list: () => import("effect/Effect").Effect<SettingsListResultType, never, import("@vitest-agent/engine").DataReader>;
-  cache_health: () => import("effect/Effect").Effect<CacheHealthResultType, never, import("@vitest-agent/engine").DataReader>;
-  configure: (input: ConfigureInputType) => import("effect/Effect").Effect<ConfigureResultType, never, import("@vitest-agent/engine").DataReader>;
-  commit_changes: (input: CommitChangesInputType) => import("effect/Effect").Effect<CommitChangesResultType, never, import("@vitest-agent/engine").DataReader>;
-  turn_search: (input: TurnSearchInputType) => import("effect/Effect").Effect<TurnSearchResultType, never, import("@vitest-agent/engine").DataReader>;
-  failure_signature_get: (input: FailureSignatureGetInputType) => import("effect/Effect").Effect<FailureSignatureGetResultType, never, import("@vitest-agent/engine").DataReader>;
-  acceptance_metrics: () => import("effect/Effect").Effect<AcceptanceMetricsResultType, never, import("@vitest-agent/engine").DataReader>;
-  triage_brief: (input: TriageBriefInputType) => import("effect/Effect").Effect<TriageBriefResultType, never, import("@vitest-agent/engine").DataReader>;
-  wrapup_prompt: (input: WrapupPromptInputType) => import("effect/Effect").Effect<WrapupPromptResultType, never, import("@vitest-agent/engine").DataReader>;
+  ping: typeof handlePing;
+  help: typeof handleHelp;
+  test_status: typeof handleTestStatus;
+  test_overview: typeof handleTestOverview;
+  test_coverage: typeof handleTestCoverage;
+  test_history: typeof handleTestHistory;
+  test_trends: typeof handleTestTrends;
+  test_errors: typeof handleTestErrors;
+  file_coverage: typeof handleFileCoverage;
+  settings_list: typeof handleSettingsList;
+  cache_health: typeof handleCacheHealth;
+  configure: typeof handleConfigure;
+  commit_changes: typeof handleCommitChanges;
+  turn_search: typeof handleTurnSearch;
+  failure_signature_get: typeof handleFailureSignatureGet;
+  acceptance_metrics: typeof handleAcceptanceMetrics;
+  triage_brief: typeof handleTriageBrief;
+  wrapup_prompt: typeof handleWrapupPrompt;
   inventory: (payload: unknown) => import("effect/Effect").Effect<{
     readonly inventoryKind: "project";
     readonly count: number;
@@ -3268,13 +3417,6 @@ export declare const toolHandlers: {
       readonly state: "failed" | "passed";
       readonly timestamp: string;
     }[];
-  } | {
-    readonly action: "get";
-    readonly found: false;
-    readonly project: string;
-    readonly fullName: string;
-    readonly ambiguous?: boolean | undefined;
-    readonly candidateModules?: readonly string[] | undefined;
   } | {
     readonly action: "for_file";
     readonly filePath: string;
@@ -3340,8 +3482,15 @@ export declare const toolHandlers: {
         readonly bodyEncoding?: "base64" | "utf-8" | undefined;
       }[];
     }[];
+  } | {
+    readonly action: "get";
+    readonly found: false;
+    readonly project: string;
+    readonly fullName: string;
+    readonly ambiguous?: boolean | undefined;
+    readonly candidateModules?: readonly string[] | undefined;
   }, import("effect/ai/McpSchema").InvalidParams, import("@vitest-agent/engine").DataReader>;
-  register_agent: (input: RegisterAgentInputType) => import("effect/Effect").Effect<RegisterAgentOutput, never, import("@vitest-agent/engine").DataReader | import("@vitest-agent/engine").DataStore>;
+  register_agent: typeof handleRegisterAgent;
   note: (payload: unknown) => import("effect/Effect").Effect<{
     readonly action: "create";
     readonly id: number;
@@ -3414,9 +3563,6 @@ export declare const toolHandlers: {
   hypothesis: (payload: unknown) => import("effect/Effect").Effect<{
     readonly action: "record";
     readonly id: number;
-  } | {
-    readonly _idempotentReplay?: true;
-    readonly action: "validate";
   } | {
     readonly action: "list";
     readonly count: number;
@@ -3429,12 +3575,12 @@ export declare const toolHandlers: {
       readonly validationOutcome: "abandoned" | "confirmed" | "refuted" | null;
       readonly validatedAt: string | null;
     }[];
-  } | (({
-    readonly action: "record";
-    readonly id: number;
   } | {
     readonly _idempotentReplay?: true;
     readonly action: "validate";
+  } | (({
+    readonly action: "record";
+    readonly id: number;
   } | {
     readonly action: "list";
     readonly count: number;
@@ -3447,21 +3593,13 @@ export declare const toolHandlers: {
       readonly validationOutcome: "abandoned" | "confirmed" | "refuted" | null;
       readonly validatedAt: string | null;
     }[];
+  } | {
+    readonly _idempotentReplay?: true;
+    readonly action: "validate";
   }) & {
     _idempotentReplay: true;
   }), import("effect/ai/McpSchema").InvalidParams | import("@effected/mcp").ToolRefusal, import("@vitest-agent/engine").DataReader | import("@vitest-agent/engine").DataStore | McpSession>;
   tdd_task: (payload: unknown) => import("effect/Effect").Effect<{
-    readonly _idempotentReplay?: true;
-    readonly action: "start";
-    readonly tddTaskId: number;
-    readonly goal: string;
-    readonly runId?: string | undefined;
-  } | {
-    readonly _idempotentReplay?: true;
-    readonly action: "end";
-    readonly tddTaskId: number;
-    readonly outcome: "abandoned" | "blocked" | "succeeded";
-  } | {
     readonly action: "get";
     readonly found: true;
     readonly task: {
@@ -3534,7 +3672,7 @@ export declare const toolHandlers: {
     readonly action: "resume";
     readonly found: false;
     readonly tddTaskId: number;
-  } | (({
+  } | {
     readonly _idempotentReplay?: true;
     readonly action: "start";
     readonly tddTaskId: number;
@@ -3545,7 +3683,7 @@ export declare const toolHandlers: {
     readonly action: "end";
     readonly tddTaskId: number;
     readonly outcome: "abandoned" | "blocked" | "succeeded";
-  } | {
+  } | (({
     readonly action: "get";
     readonly found: true;
     readonly task: {
@@ -3618,21 +3756,33 @@ export declare const toolHandlers: {
     readonly action: "resume";
     readonly found: false;
     readonly tddTaskId: number;
+  } | {
+    readonly _idempotentReplay?: true;
+    readonly action: "start";
+    readonly tddTaskId: number;
+    readonly goal: string;
+    readonly runId?: string | undefined;
+  } | {
+    readonly _idempotentReplay?: true;
+    readonly action: "end";
+    readonly tddTaskId: number;
+    readonly outcome: "abandoned" | "blocked" | "succeeded";
   }) & {
     _idempotentReplay: true;
   }), import("effect/ai/McpSchema").InvalidParams | import("@effected/mcp").ToolRefusal, import("@vitest-agent/engine").DataReader | import("@vitest-agent/engine").DataStore>;
-  tdd_phase_transition_request: (input: PhaseTransitionInputType) => import("effect/Effect").Effect<PhaseTransitionResultType, never, import("@vitest-agent/engine").DataReader | import("@vitest-agent/engine").DataStore>;
+  tdd_phase_transition_request: typeof handlePhaseTransitionRequest;
   tdd_goal: (payload: unknown) => import("effect/Effect").Effect<{
-    readonly _idempotentReplay?: true;
-    readonly ok: true;
-    readonly action: "create";
-    readonly goal: {
-      readonly id: number;
-      readonly sessionId: number;
-      readonly ordinal: number;
-      readonly goal: string;
-      readonly status: "abandoned" | "done" | "in_progress" | "pending";
-      readonly createdAt: string;
+    readonly ok: false;
+    readonly error: {
+      readonly [x: string]: unknown;
+      readonly _tag: string;
+      readonly remediation: {
+        readonly hint: string;
+        readonly suggestedTool?: string;
+        readonly suggestedArgs?: {
+          readonly [x: string]: unknown;
+        };
+      };
     };
   } | {
     readonly ok: true;
@@ -3695,6 +3845,18 @@ export declare const toolHandlers: {
       }[];
     }[];
   } | {
+    readonly _idempotentReplay?: true;
+    readonly ok: true;
+    readonly action: "create";
+    readonly goal: {
+      readonly id: number;
+      readonly sessionId: number;
+      readonly ordinal: number;
+      readonly goal: string;
+      readonly status: "abandoned" | "done" | "in_progress" | "pending";
+      readonly createdAt: string;
+    };
+  } | (({
     readonly ok: false;
     readonly error: {
       readonly [x: string]: unknown;
@@ -3707,18 +3869,6 @@ export declare const toolHandlers: {
         };
       };
     };
-  } | (({
-    readonly _idempotentReplay?: true;
-    readonly ok: true;
-    readonly action: "create";
-    readonly goal: {
-      readonly id: number;
-      readonly sessionId: number;
-      readonly ordinal: number;
-      readonly goal: string;
-      readonly status: "abandoned" | "done" | "in_progress" | "pending";
-      readonly createdAt: string;
-    };
   } | {
     readonly ok: true;
     readonly action: "update";
@@ -3780,6 +3930,21 @@ export declare const toolHandlers: {
       }[];
     }[];
   } | {
+    readonly _idempotentReplay?: true;
+    readonly ok: true;
+    readonly action: "create";
+    readonly goal: {
+      readonly id: number;
+      readonly sessionId: number;
+      readonly ordinal: number;
+      readonly goal: string;
+      readonly status: "abandoned" | "done" | "in_progress" | "pending";
+      readonly createdAt: string;
+    };
+  }) & {
+    _idempotentReplay: true;
+  }), import("effect/ai/McpSchema").InvalidParams, import("@vitest-agent/engine").DataReader | import("@vitest-agent/engine").DataStore>;
+  tdd_behavior: (payload: unknown) => import("effect/Effect").Effect<{
     readonly ok: false;
     readonly error: {
       readonly [x: string]: unknown;
@@ -3792,22 +3957,6 @@ export declare const toolHandlers: {
         };
       };
     };
-  }) & {
-    _idempotentReplay: true;
-  }), import("effect/ai/McpSchema").InvalidParams, import("@vitest-agent/engine").DataReader | import("@vitest-agent/engine").DataStore>;
-  tdd_behavior: (payload: unknown) => import("effect/Effect").Effect<{
-    readonly _idempotentReplay?: true;
-    readonly ok: true;
-    readonly action: "create";
-    readonly behavior: {
-      readonly id: number;
-      readonly goalId: number;
-      readonly ordinal: number;
-      readonly behavior: string;
-      readonly suggestedTestName: string | null;
-      readonly status: "abandoned" | "done" | "in_progress" | "pending";
-      readonly createdAt: string;
-    };
   } | {
     readonly ok: true;
     readonly action: "update";
@@ -3881,19 +4030,6 @@ export declare const toolHandlers: {
       readonly createdAt: string;
     }[];
   } | {
-    readonly ok: false;
-    readonly error: {
-      readonly [x: string]: unknown;
-      readonly _tag: string;
-      readonly remediation: {
-        readonly hint: string;
-        readonly suggestedTool?: string;
-        readonly suggestedArgs?: {
-          readonly [x: string]: unknown;
-        };
-      };
-    };
-  } | (({
     readonly _idempotentReplay?: true;
     readonly ok: true;
     readonly action: "create";
@@ -3906,6 +4042,19 @@ export declare const toolHandlers: {
       readonly status: "abandoned" | "done" | "in_progress" | "pending";
       readonly createdAt: string;
     };
+  } | (({
+    readonly ok: false;
+    readonly error: {
+      readonly [x: string]: unknown;
+      readonly _tag: string;
+      readonly remediation: {
+        readonly hint: string;
+        readonly suggestedTool?: string;
+        readonly suggestedArgs?: {
+          readonly [x: string]: unknown;
+        };
+      };
+    };
   } | {
     readonly ok: true;
     readonly action: "update";
@@ -3979,24 +4128,24 @@ export declare const toolHandlers: {
       readonly createdAt: string;
     }[];
   } | {
-    readonly ok: false;
-    readonly error: {
-      readonly [x: string]: unknown;
-      readonly _tag: string;
-      readonly remediation: {
-        readonly hint: string;
-        readonly suggestedTool?: string;
-        readonly suggestedArgs?: {
-          readonly [x: string]: unknown;
-        };
-      };
+    readonly _idempotentReplay?: true;
+    readonly ok: true;
+    readonly action: "create";
+    readonly behavior: {
+      readonly id: number;
+      readonly goalId: number;
+      readonly ordinal: number;
+      readonly behavior: string;
+      readonly suggestedTestName: string | null;
+      readonly status: "abandoned" | "done" | "in_progress" | "pending";
+      readonly createdAt: string;
     };
   }) & {
     _idempotentReplay: true;
   }), import("effect/ai/McpSchema").InvalidParams, import("@vitest-agent/engine").DataReader | import("@vitest-agent/engine").DataStore>;
-  tdd_artifact_list: (input: TddArtifactListInputType) => import("effect/Effect").Effect<TddArtifactListResultType, never, import("@vitest-agent/engine").DataReader>;
-  tdd_progress_push: (input: TddProgressPushInputType) => import("effect/Effect").Effect<TddProgressPushResultType, never, import("@vitest-agent/engine").DataReader | import("effect/ai/McpServer").McpServer>;
-  run_tests: (input: RunTestsInputType) => import("effect/Effect").Effect<RunTestsResultType, never, McpSession | import("@vitest-agent/engine").DataReader | import("@vitest-agent/engine").DataStore>;
+  tdd_artifact_list: typeof handleTddArtifactList;
+  tdd_progress_push: typeof handleTddProgressPush;
+  run_tests: typeof handleRunTests;
 };
 /**
  * The handlers layer: provides `Tool.HandlersFor<typeof Kit.tools>`.