@vitest-agent/mcp 5.3.1 → 5.4.0

package/index.d.ts

@@ -1,7 +1,7 @@
-import { ToolRefusal } from "@effected/mcp";
+import { ToolRefusal, ToolRefusal as ToolRefusal$1 } from "@effected/mcp";
 import { Context, Effect, Layer, Schema, Stdio } from "effect";
 import { DataReader, DataStore, ProjectDiscovery, SessionContext } from "@vitest-agent/engine";
-import { McpServer, Toolkit } from "effect/ai";
+import { McpServer, Tool, Toolkit } from "effect/ai";
 import "@effected/git";
 import "@vitest-agent/sdk";
 import { Remediation } from "@effected/engine";
@@ -230,7 +230,40 @@ type AcceptanceMetricsResultType = Schema.Schema.Type<typeof AcceptanceMetricsRe
  *
  * @public
  */
-declare const handleAcceptanceMetrics: () => Effect.Effect<AcceptanceMetricsResultType, never, DataReader>;
+export declare const handleAcceptanceMetrics: () => Effect.Effect<AcceptanceMetricsResultType, never, DataReader>;
+/**
+ * The Effect-native `acceptance_metrics` tool. No parameters (the default
+ * `Tool.EmptyParams` serves as a strict empty object).
+ *
+ * @public
+ */
+export declare const acceptanceMetricsTool: Tool.Tool<"acceptance_metrics", {
+  readonly parameters: Tool.EmptyParams;
+  readonly success: 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;
+    }>;
+  }>;
+  readonly failure: Schema.Never;
+  readonly failureMode: "error";
+}, DataReader>;
 /**
  * The `cache_health` tool's success payload.
  *
@@ -265,7 +298,36 @@ type CacheHealthResultType = Schema.Schema.Type<typeof CacheHealthResult>;
  *
  * @public
  */
-declare const handleCacheHealth: () => Effect.Effect<CacheHealthResultType, never, DataReader>;
+export declare const handleCacheHealth: () => Effect.Effect<CacheHealthResultType, never, DataReader>;
+/**
+ * The Effect-native `cache_health` tool. No parameters (the default
+ * `Tool.EmptyParams` serves as a strict empty object).
+ *
+ * @public
+ */
+export declare const cacheHealthTool: Tool.Tool<"cache_health", {
+  readonly parameters: Tool.EmptyParams;
+  readonly success: 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>;
+  }>]>;
+  readonly failure: Schema.Never;
+  readonly failureMode: "error";
+}, DataReader>;
 /**
  * The `commit_changes` tool's success payload.
  *
@@ -312,7 +374,35 @@ type CommitChangesInputType = Schema.Schema.Type<typeof CommitChangesInput>;
  *
  * @public
  */
-declare const handleCommitChanges: (input: CommitChangesInputType) => Effect.Effect<CommitChangesResultType, never, DataReader>;
+export declare const handleCommitChanges: (input: CommitChangesInputType) => Effect.Effect<CommitChangesResultType, never, DataReader>;
+/**
+ * The Effect-native `commit_changes` tool.
+ *
+ * @public
+ */
+export declare const commitChangesTool: Tool.Tool<"commit_changes", {
+  readonly parameters: Schema.Struct<{
+    readonly sha: Schema.optionalKey<Schema.String>;
+  }>;
+  readonly success: 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"]>;
+      }>>;
+    }>>;
+  }>;
+  readonly failure: Schema.Never;
+  readonly failureMode: "error";
+}, DataReader>;
 /**
  * The `configure` tool's success payload.
  *
@@ -365,7 +455,41 @@ type ConfigureInputType = Schema.Schema.Type<typeof ConfigureInput>;
  *
  * @public
  */
-declare const handleConfigure: (input: ConfigureInputType) => Effect.Effect<ConfigureResultType, never, DataReader>;
+export declare const handleConfigure: (input: ConfigureInputType) => Effect.Effect<ConfigureResultType, never, DataReader>;
+/**
+ * The Effect-native `configure` tool.
+ *
+ * @public
+ */
+export declare const configureTool: Tool.Tool<"configure", {
+  readonly parameters: Schema.Struct<{
+    readonly settingsHash: Schema.optionalKey<Schema.String>;
+  }>;
+  readonly success: 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 found: Schema.Literal<false>;
+    readonly source: Schema.Literals<readonly ["requested", "latest"]>;
+    readonly requestedHash: Schema.optional<Schema.String>;
+  }>]>;
+  readonly failure: Schema.Never;
+  readonly failureMode: "error";
+}, DataReader>;
 /**
  * The `test_coverage` tool's success payload.
  *
@@ -511,7 +635,134 @@ type TestCoverageInputType = Schema.Schema.Type<typeof TestCoverageInput>;
  *
  * @public
  */
-declare const handleTestCoverage: (input: TestCoverageInputType) => Effect.Effect<TestCoverageResultType, never, DataReader>;
+export declare const handleTestCoverage: (input: TestCoverageInputType) => Effect.Effect<TestCoverageResultType, never, DataReader>;
+/**
+ * The Effect-native `test_coverage` tool.
+ *
+ * @public
+ */
+export declare const testCoverageTool: Tool.Tool<"test_coverage", {
+  readonly parameters: Schema.Struct<{
+    readonly project: Schema.optionalKey<Schema.String>;
+  }>;
+  readonly success: Schema.Union<readonly [Schema.Struct<{
+    readonly dataAvailable: Schema.Literal<true>;
+    readonly project: Schema.String;
+    readonly coverage: Schema.Struct<{
+      readonly totals: Schema.Struct<{
+        readonly statements: Schema.Finite;
+        readonly branches: Schema.Finite;
+        readonly functions: Schema.Finite;
+        readonly lines: Schema.Finite;
+      }>;
+      readonly thresholds: Schema.Struct<{
+        readonly global: Schema.Struct<{
+          readonly lines: Schema.optional<Schema.Finite>;
+          readonly functions: Schema.optional<Schema.Finite>;
+          readonly branches: Schema.optional<Schema.Finite>;
+          readonly statements: Schema.optional<Schema.Finite>;
+        }>;
+        readonly patterns: Schema.withDecodingDefaultKey<Schema.$Array<Schema.Tuple<readonly [Schema.String, Schema.Struct<{
+          readonly lines: Schema.optional<Schema.Finite>;
+          readonly functions: Schema.optional<Schema.Finite>;
+          readonly branches: Schema.optional<Schema.Finite>;
+          readonly statements: Schema.optional<Schema.Finite>;
+          readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+            readonly lines: Schema.optional<Schema.Finite>;
+            readonly functions: Schema.optional<Schema.Finite>;
+            readonly branches: Schema.optional<Schema.Finite>;
+            readonly statements: Schema.optional<Schema.Finite>;
+          }>]>>;
+        }>]>>, never>;
+      }>;
+      readonly targets: Schema.optional<Schema.Struct<{
+        readonly global: Schema.Struct<{
+          readonly lines: Schema.optional<Schema.Finite>;
+          readonly functions: Schema.optional<Schema.Finite>;
+          readonly branches: Schema.optional<Schema.Finite>;
+          readonly statements: Schema.optional<Schema.Finite>;
+        }>;
+        readonly patterns: Schema.withDecodingDefaultKey<Schema.$Array<Schema.Tuple<readonly [Schema.String, Schema.Struct<{
+          readonly lines: Schema.optional<Schema.Finite>;
+          readonly functions: Schema.optional<Schema.Finite>;
+          readonly branches: Schema.optional<Schema.Finite>;
+          readonly statements: Schema.optional<Schema.Finite>;
+          readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+            readonly lines: Schema.optional<Schema.Finite>;
+            readonly functions: Schema.optional<Schema.Finite>;
+            readonly branches: Schema.optional<Schema.Finite>;
+            readonly statements: Schema.optional<Schema.Finite>;
+          }>]>>;
+        }>]>>, never>;
+      }>>;
+      readonly baselines: Schema.optional<Schema.Struct<{
+        readonly global: Schema.Struct<{
+          readonly lines: Schema.optional<Schema.Finite>;
+          readonly functions: Schema.optional<Schema.Finite>;
+          readonly branches: Schema.optional<Schema.Finite>;
+          readonly statements: Schema.optional<Schema.Finite>;
+        }>;
+        readonly patterns: Schema.withDecodingDefaultKey<Schema.$Array<Schema.Tuple<readonly [Schema.String, Schema.Struct<{
+          readonly lines: Schema.optional<Schema.Finite>;
+          readonly functions: Schema.optional<Schema.Finite>;
+          readonly branches: Schema.optional<Schema.Finite>;
+          readonly statements: Schema.optional<Schema.Finite>;
+          readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+            readonly lines: Schema.optional<Schema.Finite>;
+            readonly functions: Schema.optional<Schema.Finite>;
+            readonly branches: Schema.optional<Schema.Finite>;
+            readonly statements: Schema.optional<Schema.Finite>;
+          }>]>>;
+        }>]>>, never>;
+      }>>;
+      readonly scoped: Schema.withDecodingDefaultKey<Schema.Boolean, never>;
+      readonly scopedFiles: Schema.optional<Schema.$Array<Schema.String>>;
+      readonly totalFiles: Schema.optional<Schema.Finite>;
+      readonly lowCoverage: Schema.$Array<Schema.Struct<{
+        readonly file: Schema.String;
+        readonly summary: Schema.Struct<{
+          readonly statements: Schema.Finite;
+          readonly branches: Schema.Finite;
+          readonly functions: Schema.Finite;
+          readonly lines: Schema.Finite;
+        }>;
+        readonly uncoveredLines: Schema.String;
+      }>>;
+      readonly lowCoverageFiles: Schema.$Array<Schema.String>;
+      readonly belowTarget: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly file: Schema.String;
+        readonly summary: Schema.Struct<{
+          readonly statements: Schema.Finite;
+          readonly branches: Schema.Finite;
+          readonly functions: Schema.Finite;
+          readonly lines: Schema.Finite;
+        }>;
+        readonly uncoveredLines: Schema.String;
+      }>>>;
+      readonly belowTargetFiles: Schema.optional<Schema.$Array<Schema.String>>;
+      readonly globShortfalls: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly pattern: Schema.String;
+        readonly summary: Schema.Struct<{
+          readonly statements: Schema.Finite;
+          readonly branches: Schema.Finite;
+          readonly functions: Schema.Finite;
+          readonly lines: Schema.Finite;
+        }>;
+        readonly thresholds: Schema.Struct<{
+          readonly lines: Schema.optional<Schema.Finite>;
+          readonly functions: Schema.optional<Schema.Finite>;
+          readonly branches: Schema.optional<Schema.Finite>;
+          readonly statements: Schema.optional<Schema.Finite>;
+        }>;
+      }>>>;
+    }>;
+  }>, Schema.Struct<{
+    readonly dataAvailable: Schema.Literal<false>;
+    readonly project: Schema.String;
+  }>]>;
+  readonly failure: Schema.Never;
+  readonly failureMode: "error";
+}, DataReader>;
 /**
  * The `test_errors` tool's success payload — populates `structuredContent`.
  *
@@ -570,7 +821,47 @@ type TestErrorsInputType = Schema.Schema.Type<typeof TestErrorsInput>;
  *
  * @public
  */
-declare const handleTestErrors: (input: TestErrorsInputType) => Effect.Effect<TestErrorsResultType, never, DataReader>;
+export declare const handleTestErrors: (input: TestErrorsInputType) => Effect.Effect<TestErrorsResultType, never, DataReader>;
+/**
+ * The Effect-native `test_errors` tool.
+ *
+ * @public
+ */
+export declare const testErrorsTool: Tool.Tool<"test_errors", {
+  readonly parameters: Schema.Struct<{
+    readonly project: Schema.String;
+    readonly errorName: Schema.optionalKey<Schema.String>;
+  }>;
+  readonly success: Schema.Struct<{
+    readonly project: Schema.String;
+    readonly errorName: Schema.optional<Schema.String>;
+    readonly count: Schema.Finite;
+    readonly errors: Schema.$Array<Schema.Struct<{
+      readonly id: Schema.Finite;
+      readonly topStackFrameId: Schema.NullOr<Schema.Number>;
+      readonly name: Schema.NullOr<Schema.String>;
+      readonly message: Schema.String;
+      readonly diff: Schema.NullOr<Schema.String>;
+      readonly actual: Schema.NullOr<Schema.String>;
+      readonly expected: Schema.NullOr<Schema.String>;
+      readonly stack: Schema.NullOr<Schema.String>;
+      readonly scope: Schema.Literals<readonly ["test", "suite", "module", "unhandled"]>;
+      readonly testFullName: Schema.NullOr<Schema.String>;
+      readonly moduleFile: Schema.NullOr<Schema.String>;
+      readonly annotations: Schema.$Array<Schema.Struct<{
+        readonly type: Schema.String;
+        readonly message: Schema.String;
+        readonly location: Schema.optional<Schema.Struct<{
+          readonly file: Schema.String;
+          readonly line: Schema.Number;
+          readonly column: Schema.Number;
+        }>>;
+      }>>;
+    }>>;
+  }>;
+  readonly failure: Schema.Never;
+  readonly failureMode: "error";
+}, DataReader>;
 /**
  * The `failure_signature_get` tool's success payload.
  *
@@ -617,7 +908,35 @@ type FailureSignatureGetInputType = Schema.Schema.Type<typeof FailureSignatureGe
  *
  * @public
  */
-declare const handleFailureSignatureGet: (input: FailureSignatureGetInputType) => Effect.Effect<FailureSignatureGetResultType, never, DataReader>;
+export declare const handleFailureSignatureGet: (input: FailureSignatureGetInputType) => Effect.Effect<FailureSignatureGetResultType, never, DataReader>;
+/**
+ * The Effect-native `failure_signature_get` tool.
+ *
+ * @public
+ */
+export declare const failureSignatureGetTool: Tool.Tool<"failure_signature_get", {
+  readonly parameters: Schema.Struct<{
+    readonly hash: Schema.String;
+  }>;
+  readonly success: 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;
+  }>]>;
+  readonly failure: Schema.Never;
+  readonly failureMode: "error";
+}, DataReader>;
 /**
  * The `file_coverage` tool's success payload.
  *
@@ -685,7 +1004,56 @@ type FileCoverageInputType = Schema.Schema.Type<typeof FileCoverageInput>;
  *
  * @public
  */
-declare const handleFileCoverage: (input: FileCoverageInputType) => Effect.Effect<FileCoverageResultType, never, DataReader>;
+export declare const handleFileCoverage: (input: FileCoverageInputType) => Effect.Effect<FileCoverageResultType, never, DataReader>;
+/**
+ * The Effect-native `file_coverage` tool.
+ *
+ * @public
+ */
+export declare const fileCoverageTool: Tool.Tool<"file_coverage", {
+  readonly parameters: Schema.Struct<{
+    readonly filePath: Schema.String;
+    readonly project: Schema.optionalKey<Schema.String>;
+  }>;
+  readonly success: Schema.Union<readonly [Schema.Struct<{
+    readonly dataAvailable: Schema.Literal<true>;
+    readonly matched: Schema.Literal<true>;
+    readonly filePath: Schema.String;
+    readonly report: Schema.Struct<{
+      readonly file: Schema.String;
+      readonly summary: Schema.Struct<{
+        readonly statements: Schema.Finite;
+        readonly branches: Schema.Finite;
+        readonly functions: Schema.Finite;
+        readonly lines: Schema.Finite;
+      }>;
+      readonly uncoveredLines: Schema.String;
+    }>;
+    readonly globalThresholds: Schema.Struct<{
+      readonly statements: Schema.optional<Schema.Number>;
+      readonly branches: Schema.optional<Schema.Number>;
+      readonly functions: Schema.optional<Schema.Number>;
+      readonly lines: Schema.optional<Schema.Number>;
+    }>;
+    readonly relatedTestFiles: Schema.$Array<Schema.String>;
+  }>, Schema.Struct<{
+    readonly dataAvailable: Schema.Literal<true>;
+    readonly matched: Schema.Literal<false>;
+    readonly filePath: Schema.String;
+    readonly totals: Schema.Struct<{
+      readonly statements: Schema.Finite;
+      readonly branches: Schema.Finite;
+      readonly functions: Schema.Finite;
+      readonly lines: Schema.Finite;
+    }>;
+    readonly relatedTestFiles: Schema.$Array<Schema.String>;
+  }>, Schema.Struct<{
+    readonly dataAvailable: Schema.Literal<false>;
+    readonly filePath: Schema.String;
+  }>]>;
+  readonly failure: Schema.Never;
+  readonly failureMode: "error";
+}, DataReader>;
 /**
  * The `help` tool's success payload.
  *
@@ -700,12 +1068,26 @@ export declare const HelpResult: Schema.Struct<{
  * @public
  */
 type HelpResultType = Schema.Schema.Type<typeof HelpResult>;
+/**
+ * The Effect-native `help` tool. `structuredContent.helpText` carries the
+ * markdown reference.
+ *
+ * @public
+ */
+export declare const helpTool: Tool.Tool<"help", {
+  readonly parameters: Tool.EmptyParams;
+  readonly success: Schema.Struct<{
+    readonly helpText: Schema.String;
+  }>;
+  readonly failure: Schema.Never;
+  readonly failureMode: "error";
+}, never>;
 /**
  * Handler for {@link helpTool}.
  *
  * @public
  */
-declare const handleHelp: () => Effect.Effect<HelpResultType>;
+export declare const handleHelp: () => Effect.Effect<HelpResultType>;
 /**
  * The `test_history` tool's success payload.
  *
@@ -792,7 +1174,75 @@ type TestHistoryInputType = Schema.Schema.Type<typeof TestHistoryInput>;
  *
  * @public
  */
-declare const handleTestHistory: (input: TestHistoryInputType) => Effect.Effect<TestHistoryResultType, never, DataReader>;
+export declare const handleTestHistory: (input: TestHistoryInputType) => Effect.Effect<TestHistoryResultType, never, DataReader>;
+/**
+ * The Effect-native `test_history` tool.
+ *
+ * @public
+ */
+export declare const testHistoryTool: Tool.Tool<"test_history", {
+  readonly parameters: Schema.Struct<{
+    readonly project: Schema.String;
+    readonly testName: Schema.optionalKey<Schema.String>;
+    readonly modulePath: Schema.optionalKey<Schema.String>;
+    readonly limit: Schema.optionalKey<Schema.Int>;
+  }>;
+  readonly success: 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;
+        }>>;
+      }>>;
+    }>;
+  }>;
+  readonly failure: Schema.Never;
+  readonly failureMode: "error";
+}, DataReader>;
 /**
  * The `test_overview` tool's success payload.
  *
@@ -840,7 +1290,36 @@ type TestOverviewInputType = Schema.Schema.Type<typeof TestOverviewInput>;
  *
  * @public
  */
-declare const handleTestOverview: (input: TestOverviewInputType) => Effect.Effect<TestOverviewResultType, never, DataReader>;
+export declare const handleTestOverview: (input: TestOverviewInputType) => Effect.Effect<TestOverviewResultType, never, DataReader>;
+/**
+ * The Effect-native `test_overview` tool.
+ *
+ * @public
+ */
+export declare const testOverviewTool: Tool.Tool<"test_overview", {
+  readonly parameters: Schema.Struct<{
+    readonly project: Schema.optionalKey<Schema.String>;
+  }>;
+  readonly success: 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 dataAvailable: Schema.Literal<false>;
+    readonly projectFilter: Schema.optional<Schema.String>;
+    readonly reason: Schema.Literals<readonly ["no_runs", "project_filter_empty"]>;
+  }>]>;
+  readonly failure: Schema.Never;
+  readonly failureMode: "error";
+}, DataReader>;
 /**
  * The `ping` tool's success payload.
  *
@@ -859,12 +1338,31 @@ export declare const PingResult: Schema.Struct<{
  * @public
  */
 type PingResultType = Schema.Schema.Type<typeof PingResult>;
+/**
+ * The Effect-native `ping` tool. No parameters (the default
+ * `Tool.EmptyParams` serves as a strict empty object; `Schema.Struct({})`
+ * would serialize to a non-object JSON Schema that MCP rejects).
+ *
+ * @public
+ */
+export declare const pingTool: Tool.Tool<"ping", {
+  readonly parameters: Tool.EmptyParams;
+  readonly success: Schema.Struct<{
+    readonly message: Schema.Literal<"pong">;
+    readonly distribution: Schema.NullOr<Schema.Struct<{
+      readonly name: Schema.String;
+      readonly version: Schema.String;
+    }>>;
+  }>;
+  readonly failure: Schema.Never;
+  readonly failureMode: "error";
+}, never>;
 /**
  * Handler for {@link pingTool}.
  *
  * @public
  */
-declare const handlePing: () => Effect.Effect<PingResultType>;
+export declare const handlePing: () => Effect.Effect<PingResultType>;
 /**
  * The `register_agent` tool's parameters.
  *
@@ -919,7 +1417,41 @@ type RegisterAgentOutput = Schema.Schema.Type<typeof RegisterAgentResult>;
  *
  * @public
  */
-declare const handleRegisterAgent: (input: RegisterAgentInputType) => Effect.Effect<RegisterAgentOutput, never, DataReader | DataStore>;
+export declare const handleRegisterAgent: (input: RegisterAgentInputType) => Effect.Effect<RegisterAgentOutput, never, DataReader | DataStore>;
+/**
+ * The Effect-native `register_agent` tool.
+ *
+ * @public
+ */
+export declare const registerAgentTool: Tool.Tool<"register_agent", {
+  readonly parameters: Schema.Struct<{
+    readonly chatId: Schema.String;
+    readonly conversationId: Schema.optionalKey<Schema.String>;
+    readonly hostKind: Schema.optionalKey<Schema.String>;
+    readonly agentType: Schema.String;
+    readonly parentAgentId: Schema.optionalKey<Schema.String>;
+    readonly clientNonce: Schema.optionalKey<Schema.String>;
+    readonly startGitBranch: Schema.optionalKey<Schema.String>;
+    readonly startGitCommitSha: Schema.optionalKey<Schema.String>;
+    readonly startWorktreeDir: Schema.optionalKey<Schema.String>;
+  }>;
+  readonly success: Schema.Union<readonly [Schema.Struct<{
+    readonly ok: Schema.Literal<true>;
+    readonly agentId: Schema.String;
+    readonly conversationId: Schema.NullOr<Schema.String>;
+    readonly idempotencyKey: Schema.String;
+  }>, Schema.Struct<{
+    readonly ok: Schema.Literal<false>;
+    readonly error: Schema.Struct<{
+      readonly code: Schema.Literals<readonly ["AGENT_ALREADY_REGISTERED", "PARENT_AGENT_NOT_FOUND", "SESSION_NOT_FOUND", "INVALID_AGENT_TYPE_PREFIX"]>;
+      readonly message: Schema.String;
+      readonly existingAgentId: Schema.optional<Schema.String>;
+      readonly expectedPrefix: Schema.optional<Schema.String>;
+    }>;
+  }>]>;
+  readonly failure: Schema.Never;
+  readonly failureMode: "error";
+}, DataReader | DataStore>;
 /**
  * The `run_tests` tool's success payload.
  *
@@ -1200,18 +1732,274 @@ type RunTestsInputType = Schema.Schema.Type<typeof RunTestsInput>;
  *
  * @public
  */
-declare const handleRunTests: (input: RunTestsInputType) => Effect.Effect<RunTestsResultType, never, McpSession | DataReader | DataStore>;
+export declare const handleRunTests: (input: RunTestsInputType) => Effect.Effect<RunTestsResultType, never, McpSession | DataReader | DataStore>;
 /**
- * The `settings_list` tool's success payload.
+ * The Effect-native `run_tests` tool.
  *
  * @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;
-  }>>;
+export declare const runTestsTool: Tool.Tool<"run_tests", {
+  readonly parameters: 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;
+    }>>;
+  }>;
+  readonly success: Schema.Union<readonly [Schema.Struct<{
+    readonly kind: Schema.Literal<"ok">;
+    readonly project: Schema.optional<Schema.String>;
+    readonly projectRoot: Schema.String;
+    readonly scope: Schema.Struct<{
+      readonly project: Schema.NullOr<Schema.String>;
+      readonly files: Schema.$Array<Schema.String>;
+      readonly tags: Schema.NullOr<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 report: Schema.Struct<{
+      readonly timestamp: Schema.String;
+      readonly project: Schema.optional<Schema.String>;
+      readonly reason: Schema.Literals<readonly ["passed", "failed", "interrupted"]>;
+      readonly summary: Schema.Struct<{
+        readonly total: Schema.Finite;
+        readonly passed: Schema.Finite;
+        readonly failed: Schema.Finite;
+        readonly skipped: Schema.Finite;
+        readonly duration: Schema.Finite;
+        readonly modules: Schema.optional<Schema.Finite>;
+      }>;
+      readonly failed: Schema.$Array<Schema.Struct<{
+        readonly file: Schema.String;
+        readonly state: Schema.Literals<readonly ["passed", "failed", "skipped", "pending"]>;
+        readonly duration: Schema.optional<Schema.Finite>;
+        readonly errors: Schema.optional<Schema.$Array<Schema.Struct<{
+          readonly message: Schema.String;
+          readonly stack: Schema.optional<Schema.String>;
+          readonly diff: Schema.optional<Schema.String>;
+          readonly expected: Schema.optional<Schema.String>;
+          readonly received: Schema.optional<Schema.String>;
+        }>>>;
+        readonly tests: Schema.$Array<Schema.Struct<{
+          readonly name: Schema.String;
+          readonly fullName: Schema.String;
+          readonly state: Schema.Literals<readonly ["passed", "failed", "skipped", "pending"]>;
+          readonly duration: Schema.optional<Schema.Finite>;
+          readonly flaky: Schema.optional<Schema.Boolean>;
+          readonly slow: Schema.optional<Schema.Boolean>;
+          readonly errors: Schema.optional<Schema.$Array<Schema.Struct<{
+            readonly message: Schema.String;
+            readonly stack: Schema.optional<Schema.String>;
+            readonly diff: Schema.optional<Schema.String>;
+            readonly expected: Schema.optional<Schema.String>;
+            readonly received: Schema.optional<Schema.String>;
+          }>>>;
+          readonly classification: Schema.optional<Schema.Literals<readonly ["stable", "new-failure", "persistent", "flaky", "recovered"]>>;
+        }>>;
+      }>>;
+      readonly unhandledErrors: Schema.$Array<Schema.Struct<{
+        readonly message: Schema.String;
+        readonly stack: Schema.optional<Schema.String>;
+        readonly diff: Schema.optional<Schema.String>;
+        readonly expected: Schema.optional<Schema.String>;
+        readonly received: Schema.optional<Schema.String>;
+      }>>;
+      readonly failedFiles: Schema.$Array<Schema.String>;
+      readonly coverage: Schema.optional<Schema.Struct<{
+        readonly totals: Schema.Struct<{
+          readonly statements: Schema.Finite;
+          readonly branches: Schema.Finite;
+          readonly functions: Schema.Finite;
+          readonly lines: Schema.Finite;
+        }>;
+        readonly thresholds: Schema.Struct<{
+          readonly global: Schema.Struct<{
+            readonly lines: Schema.optional<Schema.Finite>;
+            readonly functions: Schema.optional<Schema.Finite>;
+            readonly branches: Schema.optional<Schema.Finite>;
+            readonly statements: Schema.optional<Schema.Finite>;
+          }>;
+          readonly patterns: Schema.withDecodingDefaultKey<Schema.$Array<Schema.Tuple<readonly [Schema.String, Schema.Struct<{
+            readonly lines: Schema.optional<Schema.Finite>;
+            readonly functions: Schema.optional<Schema.Finite>;
+            readonly branches: Schema.optional<Schema.Finite>;
+            readonly statements: Schema.optional<Schema.Finite>;
+            readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+              readonly lines: Schema.optional<Schema.Finite>;
+              readonly functions: Schema.optional<Schema.Finite>;
+              readonly branches: Schema.optional<Schema.Finite>;
+              readonly statements: Schema.optional<Schema.Finite>;
+            }>]>>;
+          }>]>>, never>;
+        }>;
+        readonly targets: Schema.optional<Schema.Struct<{
+          readonly global: Schema.Struct<{
+            readonly lines: Schema.optional<Schema.Finite>;
+            readonly functions: Schema.optional<Schema.Finite>;
+            readonly branches: Schema.optional<Schema.Finite>;
+            readonly statements: Schema.optional<Schema.Finite>;
+          }>;
+          readonly patterns: Schema.withDecodingDefaultKey<Schema.$Array<Schema.Tuple<readonly [Schema.String, Schema.Struct<{
+            readonly lines: Schema.optional<Schema.Finite>;
+            readonly functions: Schema.optional<Schema.Finite>;
+            readonly branches: Schema.optional<Schema.Finite>;
+            readonly statements: Schema.optional<Schema.Finite>;
+            readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+              readonly lines: Schema.optional<Schema.Finite>;
+              readonly functions: Schema.optional<Schema.Finite>;
+              readonly branches: Schema.optional<Schema.Finite>;
+              readonly statements: Schema.optional<Schema.Finite>;
+            }>]>>;
+          }>]>>, never>;
+        }>>;
+        readonly baselines: Schema.optional<Schema.Struct<{
+          readonly global: Schema.Struct<{
+            readonly lines: Schema.optional<Schema.Finite>;
+            readonly functions: Schema.optional<Schema.Finite>;
+            readonly branches: Schema.optional<Schema.Finite>;
+            readonly statements: Schema.optional<Schema.Finite>;
+          }>;
+          readonly patterns: Schema.withDecodingDefaultKey<Schema.$Array<Schema.Tuple<readonly [Schema.String, Schema.Struct<{
+            readonly lines: Schema.optional<Schema.Finite>;
+            readonly functions: Schema.optional<Schema.Finite>;
+            readonly branches: Schema.optional<Schema.Finite>;
+            readonly statements: Schema.optional<Schema.Finite>;
+            readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+              readonly lines: Schema.optional<Schema.Finite>;
+              readonly functions: Schema.optional<Schema.Finite>;
+              readonly branches: Schema.optional<Schema.Finite>;
+              readonly statements: Schema.optional<Schema.Finite>;
+            }>]>>;
+          }>]>>, never>;
+        }>>;
+        readonly scoped: Schema.withDecodingDefaultKey<Schema.Boolean, never>;
+        readonly scopedFiles: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly totalFiles: Schema.optional<Schema.Finite>;
+        readonly lowCoverage: Schema.$Array<Schema.Struct<{
+          readonly file: Schema.String;
+          readonly summary: Schema.Struct<{
+            readonly statements: Schema.Finite;
+            readonly branches: Schema.Finite;
+            readonly functions: Schema.Finite;
+            readonly lines: Schema.Finite;
+          }>;
+          readonly uncoveredLines: Schema.String;
+        }>>;
+        readonly lowCoverageFiles: Schema.$Array<Schema.String>;
+        readonly belowTarget: Schema.optional<Schema.$Array<Schema.Struct<{
+          readonly file: Schema.String;
+          readonly summary: Schema.Struct<{
+            readonly statements: Schema.Finite;
+            readonly branches: Schema.Finite;
+            readonly functions: Schema.Finite;
+            readonly lines: Schema.Finite;
+          }>;
+          readonly uncoveredLines: Schema.String;
+        }>>>;
+        readonly belowTargetFiles: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly globShortfalls: Schema.optional<Schema.$Array<Schema.Struct<{
+          readonly pattern: Schema.String;
+          readonly summary: Schema.Struct<{
+            readonly statements: Schema.Finite;
+            readonly branches: Schema.Finite;
+            readonly functions: Schema.Finite;
+            readonly lines: Schema.Finite;
+          }>;
+          readonly thresholds: Schema.Struct<{
+            readonly lines: Schema.optional<Schema.Finite>;
+            readonly functions: Schema.optional<Schema.Finite>;
+            readonly branches: Schema.optional<Schema.Finite>;
+            readonly statements: Schema.optional<Schema.Finite>;
+          }>;
+        }>>>;
+      }>>;
+      readonly tagCounts: Schema.optional<Schema.$Record<Schema.String, Schema.Struct<{
+        readonly passed: Schema.optional<Schema.Finite>;
+        readonly failed: Schema.optional<Schema.Finite>;
+        readonly skipped: Schema.optional<Schema.Finite>;
+      }>>>;
+      readonly consoleLeaks: Schema.optional<Schema.Struct<{
+        readonly total: Schema.Finite;
+        readonly byFile: Schema.$Array<Schema.Struct<{
+          readonly file: Schema.String;
+          readonly stdout: Schema.Finite;
+          readonly stderr: Schema.Finite;
+          readonly tests: Schema.optional<Schema.$Array<Schema.String>>;
+          readonly sample: Schema.optional<Schema.String>;
+        }>>;
+        readonly truncated: Schema.optional<Schema.Boolean>;
+        readonly fromFailingTests: Schema.optional<Schema.Struct<{
+          readonly total: Schema.Finite;
+          readonly files: Schema.Finite;
+        }>>;
+      }>>;
+      readonly strayOutput: Schema.optional<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;
+        }>>;
+      }>>;
+    }>;
+    readonly classifications: Schema.$Record<Schema.String, Schema.String>;
+    readonly discoveryLastScannedAt: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly scopedNote: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly suggestedActions: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+      readonly severity: Schema.Literals<readonly ["info", "warn", "blocker"]>;
+      readonly title: Schema.String;
+      readonly detail: Schema.String;
+      readonly targetTool: Schema.optional<Schema.String>;
+    }>>>;
+  }>, Schema.Struct<{
+    readonly kind: Schema.Literal<"timeout">;
+    readonly timeoutSeconds: Schema.Number;
+  }>, Schema.Struct<{
+    readonly kind: Schema.Literal<"error">;
+    readonly message: Schema.String;
+    readonly reason: Schema.optionalKey<Schema.Literals<readonly ["stale-install"]>>;
+  }>, Schema.Struct<{
+    readonly kind: Schema.Literal<"no-match">;
+    readonly projectRoot: Schema.String;
+    readonly filter: Schema.Struct<{
+      readonly project: Schema.NullOr<Schema.String>;
+      readonly files: Schema.$Array<Schema.String>;
+      readonly tags: Schema.NullOr<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 resolvedExpression: Schema.NullOr<Schema.String>;
+    }>;
+  }>]>;
+  readonly failure: Schema.Never;
+  readonly failureMode: "error";
+}, DataReader | DataStore | McpSession>;
+/**
+ * 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}.
@@ -1224,7 +2012,25 @@ type SettingsListResultType = Schema.Schema.Type<typeof SettingsListResult>;
  *
  * @public
  */
-declare const handleSettingsList: () => Effect.Effect<SettingsListResultType, never, DataReader>;
+export declare const handleSettingsList: () => Effect.Effect<SettingsListResultType, never, DataReader>;
+/**
+ * The Effect-native `settings_list` tool. No parameters (the default
+ * `Tool.EmptyParams` serves as a strict empty object).
+ *
+ * @public
+ */
+export declare const settingsListTool: Tool.Tool<"settings_list", {
+  readonly parameters: Tool.EmptyParams;
+  readonly success: Schema.Struct<{
+    readonly count: Schema.Number;
+    readonly settings: Schema.$Array<Schema.Struct<{
+      readonly hash: Schema.String;
+      readonly capturedAt: Schema.String;
+    }>>;
+  }>;
+  readonly failure: Schema.Never;
+  readonly failureMode: "error";
+}, DataReader>;
 /**
  * The `test_status` tool's success payload.
  *
@@ -1282,7 +2088,45 @@ type TestStatusInputType = Schema.Schema.Type<typeof TestStatusInput>;
  *
  * @public
  */
-declare const handleTestStatus: (input: TestStatusInputType) => Effect.Effect<TestStatusResultType, never, DataReader>;
+export declare const handleTestStatus: (input: TestStatusInputType) => Effect.Effect<TestStatusResultType, never, DataReader>;
+/**
+ * The Effect-native `test_status` tool.
+ *
+ * @public
+ */
+export declare const testStatusTool: Tool.Tool<"test_status", {
+  readonly parameters: Schema.Struct<{
+    readonly project: Schema.optionalKey<Schema.String>;
+  }>;
+  readonly success: 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"]>;
+  }>]>;
+  readonly failure: Schema.Never;
+  readonly failureMode: "error";
+}, DataReader>;
 /**
  * The `tdd_artifact_list` tool's success payload.
  *
@@ -1339,7 +2183,45 @@ type TddArtifactListInputType = Schema.Schema.Type<typeof TddArtifactListInput>;
  *
  * @public
  */
-declare const handleTddArtifactList: (input: TddArtifactListInputType) => Effect.Effect<TddArtifactListResultType, never, DataReader>;
+export declare const handleTddArtifactList: (input: TddArtifactListInputType) => Effect.Effect<TddArtifactListResultType, never, DataReader>;
+/**
+ * The Effect-native `tdd_artifact_list` tool.
+ *
+ * @public
+ */
+export declare const tddArtifactListTool: Tool.Tool<"tdd_artifact_list", {
+  readonly parameters: 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>;
+  }>;
+  readonly success: 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"]>;
+    }>>;
+  }>;
+  readonly failure: Schema.Never;
+  readonly failureMode: "error";
+}, DataReader>;
 /**
  * The `tdd_phase_transition_request` tool's success payload.
  *
@@ -1401,7 +2283,42 @@ type PhaseTransitionInputType = Schema.Schema.Type<typeof PhaseTransitionInput>;
  *
  * @public
  */
-declare const handlePhaseTransitionRequest: (input: PhaseTransitionInputType) => Effect.Effect<PhaseTransitionResultType, never, DataReader | DataStore>;
+export declare const handlePhaseTransitionRequest: (input: PhaseTransitionInputType) => Effect.Effect<PhaseTransitionResultType, never, DataReader | DataStore>;
+/**
+ * The Effect-native `tdd_phase_transition_request` tool.
+ *
+ * @public
+ */
+export declare const tddPhaseTransitionRequestTool: Tool.Tool<"tdd_phase_transition_request", {
+  readonly parameters: 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>;
+  }>;
+  readonly success: 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>>;
+    }>;
+  }>]>;
+  readonly failure: Schema.Never;
+  readonly failureMode: "error";
+}, DataReader | DataStore>;
 /**
  * The `tdd_progress_push` tool's parameters.
  *
@@ -1438,7 +2355,22 @@ type TddProgressPushResultType = Schema.Schema.Type<typeof TddProgressPushResult
  *
  * @public
  */
-declare const handleTddProgressPush: (input: TddProgressPushInputType) => Effect.Effect<TddProgressPushResultType, never, DataReader | McpServer.McpServer>;
+export declare const handleTddProgressPush: (input: TddProgressPushInputType) => Effect.Effect<TddProgressPushResultType, never, DataReader | McpServer.McpServer>;
+/**
+ * The Effect-native `tdd_progress_push` tool.
+ *
+ * @public
+ */
+export declare const tddProgressPushTool: Tool.Tool<"tdd_progress_push", {
+  readonly parameters: Schema.Struct<{
+    readonly payload: Schema.String;
+  }>;
+  readonly success: Schema.Struct<{
+    readonly ok: Schema.Literal<true>;
+  }>;
+  readonly failure: Schema.Never;
+  readonly failureMode: "error";
+}, DataReader | McpServer.McpServer>;
 /**
  * The `test_trends` tool's success payload.
  *
@@ -1496,7 +2428,46 @@ type TestTrendsInputType = Schema.Schema.Type<typeof TestTrendsInput>;
  *
  * @public
  */
-declare const handleTestTrends: (input: TestTrendsInputType) => Effect.Effect<TestTrendsResultType, never, DataReader>;
+export declare const handleTestTrends: (input: TestTrendsInputType) => Effect.Effect<TestTrendsResultType, never, DataReader>;
+/**
+ * The Effect-native `test_trends` tool.
+ *
+ * @public
+ */
+export declare const testTrendsTool: Tool.Tool<"test_trends", {
+  readonly parameters: Schema.Struct<{
+    readonly project: Schema.String;
+    readonly limit: Schema.optionalKey<Schema.Finite>;
+  }>;
+  readonly success: 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;
+  }>]>;
+  readonly failure: Schema.Never;
+  readonly failureMode: "error";
+}, DataReader>;
 /**
  * The `triage_brief` tool's success payload.
  *
@@ -1532,7 +2503,24 @@ type TriageBriefInputType = Schema.Schema.Type<typeof TriageBriefInput>;
  *
  * @public
  */
-declare const handleTriageBrief: (input: TriageBriefInputType) => Effect.Effect<TriageBriefResultType, never, DataReader>;
+export declare const handleTriageBrief: (input: TriageBriefInputType) => Effect.Effect<TriageBriefResultType, never, DataReader>;
+/**
+ * The Effect-native `triage_brief` tool.
+ *
+ * @public
+ */
+export declare const triageBriefTool: Tool.Tool<"triage_brief", {
+  readonly parameters: Schema.Struct<{
+    readonly project: Schema.optionalKey<Schema.String>;
+    readonly maxLines: Schema.optionalKey<Schema.Finite>;
+  }>;
+  readonly success: Schema.Struct<{
+    readonly hasContent: Schema.Boolean;
+    readonly markdown: Schema.String;
+  }>;
+  readonly failure: Schema.Never;
+  readonly failureMode: "error";
+}, DataReader>;
 /**
  * The `turn_search` tool's success payload.
  *
@@ -1577,7 +2565,33 @@ type TurnSearchInputType = Schema.Schema.Type<typeof TurnSearchInput>;
  *
  * @public
  */
-declare const handleTurnSearch: (input: TurnSearchInputType) => Effect.Effect<TurnSearchResultType, never, DataReader>;
+export declare const handleTurnSearch: (input: TurnSearchInputType) => Effect.Effect<TurnSearchResultType, never, DataReader>;
+/**
+ * The Effect-native `turn_search` tool.
+ *
+ * @public
+ */
+export declare const turnSearchTool: Tool.Tool<"turn_search", {
+  readonly parameters: 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>;
+  }>;
+  readonly success: 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;
+    }>>;
+  }>;
+  readonly failure: Schema.Never;
+  readonly failureMode: "error";
+}, DataReader>;
 /**
  * The `wrapup_prompt` tool's success payload.
  *
@@ -1616,7 +2630,27 @@ type WrapupPromptInputType = Schema.Schema.Type<typeof WrapupPromptInput>;
  *
  * @public
  */
-declare const handleWrapupPrompt: (input: WrapupPromptInputType) => Effect.Effect<WrapupPromptResultType, never, DataReader>;
+export declare const handleWrapupPrompt: (input: WrapupPromptInputType) => Effect.Effect<WrapupPromptResultType, never, DataReader>;
+/**
+ * The Effect-native `wrapup_prompt` tool.
+ *
+ * @public
+ */
+export declare const wrapupPromptTool: Tool.Tool<"wrapup_prompt", {
+  readonly parameters: 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>;
+  }>;
+  readonly success: 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;
+  }>;
+  readonly failure: Schema.Never;
+  readonly failureMode: "error";
+}, DataReader>;
 /**
  * Every tool the server registers.
  *
@@ -5804,6 +6838,120 @@ interface TddErrorEnvelope {
     readonly [key: string]: unknown;
   };
 }
+/**
+ * The `hypothesis` tool's success payload.
+ *
+ * @public
+ */
+export declare const HypothesisResult: Schema.Union<readonly [Schema.Struct<{
+  readonly action: Schema.Literal<"record">;
+  readonly id: Schema.Finite;
+}>, Schema.Struct<{
+  readonly _idempotentReplay: Schema.optionalKey<Schema.Literal<true>>;
+  readonly action: Schema.Literal<"validate">;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"list">;
+  readonly count: Schema.Number;
+  readonly hypotheses: Schema.$Array<Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly sessionId: Schema.Number;
+    readonly content: Schema.String;
+    readonly citedTestErrorId: Schema.NullOr<Schema.Number>;
+    readonly citedStackFrameId: Schema.NullOr<Schema.Number>;
+    readonly validationOutcome: Schema.NullOr<Schema.Literals<readonly ["confirmed", "refuted", "abandoned"]>>;
+    readonly validatedAt: Schema.NullOr<Schema.String>;
+  }>>;
+}>]>;
+/**
+ * The decoded {@link HypothesisResult}.
+ *
+ * @public
+ */
+type HypothesisResultType = Schema.Schema.Type<typeof HypothesisResult>;
+/**
+ * The `hypothesis` tool's parameters — a union discriminated on `action`.
+ *
+ * @public
+ */
+export declare const HypothesisInput: Schema.Union<readonly [Schema.Struct<{
+  readonly action: Schema.Literal<"record">;
+  readonly tddTaskId: Schema.optionalKey<Schema.Union<readonly [Schema.Finite, Schema.FiniteFromString]>>;
+  readonly sessionId: Schema.optionalKey<Schema.Union<readonly [Schema.Finite, Schema.FiniteFromString]>>;
+  readonly content: Schema.String;
+  readonly createdTurnId: Schema.optionalKey<Schema.Finite>;
+  readonly citedTestErrorId: Schema.optionalKey<Schema.Finite>;
+  readonly citedStackFrameId: Schema.optionalKey<Schema.Finite>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"validate">;
+  readonly id: Schema.Finite;
+  readonly outcome: Schema.Literals<readonly ["confirmed", "refuted", "abandoned"]>;
+  readonly validatedTurnId: Schema.optionalKey<Schema.Finite>;
+  readonly validatedAt: Schema.optionalKey<Schema.String>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"list">;
+  readonly sessionId: Schema.optionalKey<Schema.Finite>;
+  readonly outcome: Schema.optionalKey<Schema.Literals<readonly ["confirmed", "refuted", "abandoned", "open"]>>;
+  readonly limit: Schema.optionalKey<Schema.Finite>;
+}>]>;
+/**
+ * The decoded {@link HypothesisInput}.
+ *
+ * @public
+ */
+type HypothesisInputType = Schema.Schema.Type<typeof HypothesisInput>;
+/**
+ * Handler for {@link hypothesisTool}. `record` fails with a
+ * `ToolRefusal` (an `isError` result naming the fix) when the binding
+ * session cannot be resolved: an unknown `tddTaskId`, an unknown fallback
+ * `sessionId`, or no session at all; `validate` does for an unknown id. Any
+ * other store failure is a defect.
+ *
+ * @public
+ */
+export declare const handleHypothesis: (input: HypothesisInputType) => Effect.Effect<HypothesisResultType, ToolRefusal$1, DataReader | DataStore | McpSession>;
+/**
+ * The Effect-native `hypothesis` tool.
+ *
+ * @public
+ */
+export declare const hypothesisTool: import("@effected/mcp").UnionTool<"hypothesis", Schema.Union<readonly [Schema.Struct<{
+  readonly action: Schema.Literal<"record">;
+  readonly tddTaskId: Schema.optionalKey<Schema.Union<readonly [Schema.Finite, Schema.FiniteFromString]>>;
+  readonly sessionId: Schema.optionalKey<Schema.Union<readonly [Schema.Finite, Schema.FiniteFromString]>>;
+  readonly content: Schema.String;
+  readonly createdTurnId: Schema.optionalKey<Schema.Finite>;
+  readonly citedTestErrorId: Schema.optionalKey<Schema.Finite>;
+  readonly citedStackFrameId: Schema.optionalKey<Schema.Finite>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"validate">;
+  readonly id: Schema.Finite;
+  readonly outcome: Schema.Literals<readonly ["confirmed", "refuted", "abandoned"]>;
+  readonly validatedTurnId: Schema.optionalKey<Schema.Finite>;
+  readonly validatedAt: Schema.optionalKey<Schema.String>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"list">;
+  readonly sessionId: Schema.optionalKey<Schema.Finite>;
+  readonly outcome: Schema.optionalKey<Schema.Literals<readonly ["confirmed", "refuted", "abandoned", "open"]>>;
+  readonly limit: Schema.optionalKey<Schema.Finite>;
+}>]>, Schema.Union<readonly [Schema.Struct<{
+  readonly action: Schema.Literal<"record">;
+  readonly id: Schema.Finite;
+}>, Schema.Struct<{
+  readonly _idempotentReplay: Schema.optionalKey<Schema.Literal<true>>;
+  readonly action: Schema.Literal<"validate">;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"list">;
+  readonly count: Schema.Number;
+  readonly hypotheses: Schema.$Array<Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly sessionId: Schema.Number;
+    readonly content: Schema.String;
+    readonly citedTestErrorId: Schema.NullOr<Schema.Number>;
+    readonly citedStackFrameId: Schema.NullOr<Schema.Number>;
+    readonly validationOutcome: Schema.NullOr<Schema.Literals<readonly ["confirmed", "refuted", "abandoned"]>>;
+    readonly validatedAt: Schema.NullOr<Schema.String>;
+  }>>;
+}>]>, typeof ToolRefusal$1, DataReader | DataStore | McpSession>;
 /**
  * The `inventory` tool's success payload.
  *
@@ -5945,11 +7093,137 @@ export declare const InventoryInput: Schema.Union<readonly [Schema.Struct<{
  */
 type InventoryInputType = Schema.Schema.Type<typeof InventoryInput>;
 /**
- * The `note` tool's success payload.
+ * Handler for {@link inventoryTool}.
  *
  * @public
  */
-export declare const NoteResult: Schema.Union<readonly [Schema.Struct<{
+export declare const handleInventory: (input: InventoryInputType) => Effect.Effect<InventoryResultType, never, DataReader>;
+/**
+ * The Effect-native `inventory` tool.
+ *
+ * @public
+ */
+export declare const inventoryTool: import("@effected/mcp").UnionTool<"inventory", Schema.Union<readonly [Schema.Struct<{
+  readonly kind: Schema.Literal<"project">;
+}>, Schema.Struct<{
+  readonly kind: Schema.Literal<"module">;
+  readonly project: Schema.optionalKey<Schema.String>;
+}>, Schema.Struct<{
+  readonly kind: Schema.Literal<"suite">;
+  readonly project: Schema.optionalKey<Schema.String>;
+  readonly module: Schema.optionalKey<Schema.String>;
+}>, Schema.Struct<{
+  readonly kind: Schema.Literal<"session">;
+  readonly id: Schema.optionalKey<Schema.Finite>;
+  readonly project: Schema.optionalKey<Schema.String>;
+  readonly agentKind: Schema.optionalKey<Schema.Literals<readonly ["main", "subagent"]>>;
+  readonly limit: Schema.optionalKey<Schema.Finite>;
+}>, Schema.Struct<{
+  readonly kind: Schema.Literal<"tag">;
+  readonly project: Schema.optionalKey<Schema.String>;
+}>]>, Schema.Union<readonly [Schema.Struct<{
+  readonly inventoryKind: Schema.Literal<"project">;
+  readonly count: Schema.Number;
+  readonly projects: 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 inventoryKind: Schema.Literal<"module">;
+  readonly count: Schema.Number;
+  readonly groups: Schema.$Array<Schema.Struct<{
+    readonly project: Schema.String;
+    readonly modules: Schema.$Array<Schema.Struct<{
+      readonly id: Schema.Number;
+      readonly file: Schema.String;
+      readonly state: Schema.String;
+      readonly testCount: Schema.Number;
+      readonly duration: Schema.NullOr<Schema.Number>;
+    }>>;
+  }>>;
+}>, Schema.Struct<{
+  readonly inventoryKind: Schema.Literal<"suite">;
+  readonly count: Schema.Number;
+  readonly groups: Schema.$Array<Schema.Struct<{
+    readonly project: Schema.String;
+    readonly suites: Schema.$Array<Schema.Struct<{
+      readonly id: Schema.Number;
+      readonly name: Schema.String;
+      readonly module: Schema.String;
+      readonly state: Schema.String;
+      readonly testCount: Schema.Number;
+    }>>;
+  }>>;
+}>, Schema.Struct<{
+  readonly inventoryKind: Schema.Literal<"session_detail">;
+  readonly found: Schema.Literal<true>;
+  readonly session: Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly chatId: Schema.String;
+    readonly project: Schema.String;
+    readonly cwd: Schema.String;
+    readonly agentKind: Schema.Literals<readonly ["main", "subagent"]>;
+    readonly agentType: Schema.NullOr<Schema.String>;
+    readonly parentSessionId: Schema.NullOr<Schema.Number>;
+    readonly triageWasNonEmpty: Schema.Boolean;
+    readonly startedAt: Schema.String;
+    readonly endedAt: Schema.NullOr<Schema.String>;
+    readonly endReason: Schema.NullOr<Schema.String>;
+  }>;
+}>, Schema.Struct<{
+  readonly inventoryKind: Schema.Literal<"session_detail">;
+  readonly found: Schema.Literal<false>;
+  readonly id: Schema.Number;
+}>, Schema.Struct<{
+  readonly inventoryKind: Schema.Literal<"session_list">;
+  readonly count: Schema.Number;
+  readonly sessions: Schema.$Array<Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly chatId: Schema.String;
+    readonly project: Schema.String;
+    readonly cwd: Schema.String;
+    readonly agentKind: Schema.Literals<readonly ["main", "subagent"]>;
+    readonly agentType: Schema.NullOr<Schema.String>;
+    readonly parentSessionId: Schema.NullOr<Schema.Number>;
+    readonly triageWasNonEmpty: Schema.Boolean;
+    readonly startedAt: Schema.String;
+    readonly endedAt: Schema.NullOr<Schema.String>;
+    readonly endReason: Schema.NullOr<Schema.String>;
+  }>>;
+}>, Schema.Struct<{
+  readonly inventoryKind: Schema.Literal<"tag_scoped">;
+  readonly project: Schema.String;
+  readonly count: Schema.Number;
+  readonly tags: Schema.$Array<Schema.Struct<{
+    readonly tag: Schema.String;
+    readonly moduleCount: Schema.Number;
+    readonly testCount: Schema.Number;
+  }>>;
+}>, Schema.Struct<{
+  readonly inventoryKind: Schema.Literal<"tag_unscoped">;
+  readonly count: Schema.Number;
+  readonly tags: Schema.$Array<Schema.Struct<{
+    readonly tag: Schema.String;
+    readonly moduleCount: Schema.Number;
+    readonly testCount: Schema.Number;
+    readonly byProject: Schema.$Array<Schema.Struct<{
+      readonly project: Schema.String;
+      readonly moduleCount: Schema.Number;
+      readonly testCount: Schema.Number;
+    }>>;
+  }>>;
+}>]>, typeof ToolRefusal$1, DataReader>;
+/**
+ * The `note` tool's success payload.
+ *
+ * @public
+ */
+export declare const NoteResult: Schema.Union<readonly [Schema.Struct<{
   readonly action: Schema.Literal<"create">;
   readonly id: Schema.Finite;
 }>, Schema.Struct<{
@@ -6019,56 +7293,928 @@ export declare const NoteResult: Schema.Union<readonly [Schema.Struct<{
   }>>;
 }>]>;
 /**
- * The decoded {@link NoteResult}.
+ * The decoded {@link NoteResult}.
+ *
+ * @public
+ */
+type NoteResultType = Schema.Schema.Type<typeof NoteResult>;
+/**
+ * The `note` tool's parameters — a union discriminated on `action`.
+ *
+ * @public
+ */
+export declare const NoteParams: Schema.Union<readonly [Schema.Struct<{
+  readonly action: Schema.Literal<"create">;
+  readonly title: Schema.String;
+  readonly content: Schema.String;
+  readonly scope: Schema.Literals<readonly ["global", "project", "module", "suite", "test", "note"]>;
+  readonly project: Schema.optionalKey<Schema.String>;
+  readonly testFullName: Schema.optionalKey<Schema.String>;
+  readonly modulePath: Schema.optionalKey<Schema.String>;
+  readonly parentNoteId: Schema.optionalKey<Schema.Finite>;
+  readonly createdBy: Schema.optionalKey<Schema.String>;
+  readonly expiresAt: Schema.optionalKey<Schema.String>;
+  readonly pinned: Schema.optionalKey<Schema.Boolean>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"list">;
+  readonly scope: Schema.optionalKey<Schema.Literals<readonly ["global", "project", "module", "suite", "test", "note"]>>;
+  readonly project: Schema.optionalKey<Schema.String>;
+  readonly testFullName: Schema.optionalKey<Schema.String>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly id: Schema.Finite;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"update">;
+  readonly id: Schema.Finite;
+  readonly title: Schema.optionalKey<Schema.String>;
+  readonly content: Schema.optionalKey<Schema.String>;
+  readonly pinned: Schema.optionalKey<Schema.Boolean>;
+  readonly expiresAt: Schema.optionalKey<Schema.String>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"delete">;
+  readonly id: Schema.Finite;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"search">;
+  readonly query: Schema.String;
+}>]>;
+/**
+ * The decoded {@link NoteParams}.
+ *
+ * @public
+ */
+type NoteParamsType = Schema.Schema.Type<typeof NoteParams>;
+/**
+ * Handler for {@link noteTool}.
+ *
+ * @public
+ */
+export declare const handleNote: (input: NoteParamsType) => Effect.Effect<NoteResultType, never, DataReader | DataStore>;
+/**
+ * The Effect-native `note` tool.
+ *
+ * @public
+ */
+export declare const noteTool: import("@effected/mcp").UnionTool<"note", Schema.Union<readonly [Schema.Struct<{
+  readonly action: Schema.Literal<"create">;
+  readonly title: Schema.String;
+  readonly content: Schema.String;
+  readonly scope: Schema.Literals<readonly ["global", "project", "module", "suite", "test", "note"]>;
+  readonly project: Schema.optionalKey<Schema.String>;
+  readonly testFullName: Schema.optionalKey<Schema.String>;
+  readonly modulePath: Schema.optionalKey<Schema.String>;
+  readonly parentNoteId: Schema.optionalKey<Schema.Finite>;
+  readonly createdBy: Schema.optionalKey<Schema.String>;
+  readonly expiresAt: Schema.optionalKey<Schema.String>;
+  readonly pinned: Schema.optionalKey<Schema.Boolean>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"list">;
+  readonly scope: Schema.optionalKey<Schema.Literals<readonly ["global", "project", "module", "suite", "test", "note"]>>;
+  readonly project: Schema.optionalKey<Schema.String>;
+  readonly testFullName: Schema.optionalKey<Schema.String>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly id: Schema.Finite;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"update">;
+  readonly id: Schema.Finite;
+  readonly title: Schema.optionalKey<Schema.String>;
+  readonly content: Schema.optionalKey<Schema.String>;
+  readonly pinned: Schema.optionalKey<Schema.Boolean>;
+  readonly expiresAt: Schema.optionalKey<Schema.String>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"delete">;
+  readonly id: Schema.Finite;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"search">;
+  readonly query: Schema.String;
+}>]>, Schema.Union<readonly [Schema.Struct<{
+  readonly action: Schema.Literal<"create">;
+  readonly id: Schema.Finite;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"list">;
+  readonly count: Schema.Number;
+  readonly notes: Schema.$Array<Schema.Struct<{
+    readonly id: Schema.Finite;
+    readonly title: Schema.String;
+    readonly content: Schema.String;
+    readonly scope: Schema.Literals<readonly ["global", "project", "module", "suite", "test", "note"]>;
+    readonly project: Schema.NullOr<Schema.String>;
+    readonly testFullName: Schema.NullOr<Schema.String>;
+    readonly modulePath: Schema.NullOr<Schema.String>;
+    readonly parentNoteId: Schema.NullOr<Schema.Number>;
+    readonly createdBy: Schema.NullOr<Schema.String>;
+    readonly expiresAt: Schema.NullOr<Schema.String>;
+    readonly pinned: Schema.Boolean;
+    readonly createdAt: Schema.String;
+    readonly updatedAt: Schema.String;
+  }>>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly found: Schema.Literal<true>;
+  readonly note: Schema.Struct<{
+    readonly id: Schema.Finite;
+    readonly title: Schema.String;
+    readonly content: Schema.String;
+    readonly scope: Schema.Literals<readonly ["global", "project", "module", "suite", "test", "note"]>;
+    readonly project: Schema.NullOr<Schema.String>;
+    readonly testFullName: Schema.NullOr<Schema.String>;
+    readonly modulePath: Schema.NullOr<Schema.String>;
+    readonly parentNoteId: Schema.NullOr<Schema.Number>;
+    readonly createdBy: Schema.NullOr<Schema.String>;
+    readonly expiresAt: Schema.NullOr<Schema.String>;
+    readonly pinned: Schema.Boolean;
+    readonly createdAt: Schema.String;
+    readonly updatedAt: Schema.String;
+  }>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly found: Schema.Literal<false>;
+  readonly id: Schema.Number;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"update">;
+  readonly success: Schema.Literal<true>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"delete">;
+  readonly success: Schema.Literal<true>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"search">;
+  readonly query: Schema.String;
+  readonly count: Schema.Number;
+  readonly notes: Schema.$Array<Schema.Struct<{
+    readonly id: Schema.Finite;
+    readonly title: Schema.String;
+    readonly content: Schema.String;
+    readonly scope: Schema.Literals<readonly ["global", "project", "module", "suite", "test", "note"]>;
+    readonly project: Schema.NullOr<Schema.String>;
+    readonly testFullName: Schema.NullOr<Schema.String>;
+    readonly modulePath: Schema.NullOr<Schema.String>;
+    readonly parentNoteId: Schema.NullOr<Schema.Number>;
+    readonly createdBy: Schema.NullOr<Schema.String>;
+    readonly expiresAt: Schema.NullOr<Schema.String>;
+    readonly pinned: Schema.Boolean;
+    readonly createdAt: Schema.String;
+    readonly updatedAt: Schema.String;
+  }>>;
+}>]>, typeof ToolRefusal$1, DataReader | DataStore>;
+/**
+ * The `tdd_behavior` tool's success payload.
+ *
+ * @public
+ */
+export declare const TddBehaviorResult: Schema.Union<readonly [Schema.Struct<{
+  readonly _idempotentReplay: Schema.optionalKey<Schema.Literal<true>>;
+  readonly ok: Schema.Literal<true>;
+  readonly action: Schema.Literal<"create">;
+  readonly behavior: Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly goalId: Schema.Number;
+    readonly ordinal: Schema.Number;
+    readonly behavior: Schema.String;
+    readonly suggestedTestName: Schema.NullOr<Schema.String>;
+    readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+    readonly createdAt: Schema.String;
+  }>;
+}>, Schema.Struct<{
+  readonly ok: Schema.Literal<true>;
+  readonly action: Schema.Literal<"update">;
+  readonly behavior: Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly goalId: Schema.Number;
+    readonly ordinal: Schema.Number;
+    readonly behavior: Schema.String;
+    readonly suggestedTestName: Schema.NullOr<Schema.String>;
+    readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+    readonly createdAt: Schema.String;
+  }>;
+}>, Schema.Struct<{
+  readonly ok: Schema.Literal<true>;
+  readonly action: Schema.Literal<"delete">;
+  readonly id: Schema.Number;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly found: Schema.Literal<true>;
+  readonly behavior: Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly goalId: Schema.Number;
+    readonly ordinal: Schema.Number;
+    readonly behavior: Schema.String;
+    readonly suggestedTestName: Schema.NullOr<Schema.String>;
+    readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+    readonly createdAt: Schema.String;
+    readonly parentGoal: Schema.Struct<{
+      readonly id: Schema.Number;
+      readonly goal: Schema.String;
+      readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+    }>;
+    readonly dependencies: Schema.$Array<Schema.Struct<{
+      readonly id: Schema.Number;
+      readonly goalId: Schema.Number;
+      readonly ordinal: Schema.Number;
+      readonly behavior: Schema.String;
+      readonly suggestedTestName: Schema.NullOr<Schema.String>;
+      readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+      readonly createdAt: Schema.String;
+    }>>;
+  }>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly found: Schema.Literal<false>;
+  readonly id: Schema.Number;
+}>, Schema.Struct<{
+  readonly ok: Schema.Literal<true>;
+  readonly action: Schema.Literal<"list_by_goal">;
+  readonly goalId: Schema.Number;
+  readonly behaviors: Schema.$Array<Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly goalId: Schema.Number;
+    readonly ordinal: Schema.Number;
+    readonly behavior: Schema.String;
+    readonly suggestedTestName: Schema.NullOr<Schema.String>;
+    readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+    readonly createdAt: Schema.String;
+  }>>;
+}>, Schema.Struct<{
+  readonly ok: Schema.Literal<true>;
+  readonly action: Schema.Literal<"list_by_tdd_task">;
+  readonly tddTaskId: Schema.Number;
+  readonly behaviors: Schema.$Array<Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly goalId: Schema.Number;
+    readonly ordinal: Schema.Number;
+    readonly behavior: Schema.String;
+    readonly suggestedTestName: Schema.NullOr<Schema.String>;
+    readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+    readonly createdAt: Schema.String;
+  }>>;
+}>, Schema.Struct<{
+  readonly ok: Schema.Literal<false>;
+  readonly error: Schema.StructWithRest<Schema.Struct<{
+    readonly _tag: Schema.String;
+    readonly remediation: Schema.Struct<{
+      readonly hint: Schema.String;
+      readonly suggestedTool: Schema.optionalKey<Schema.String>;
+      readonly suggestedArgs: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Unknown>>;
+    }>;
+  }>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>;
+}>]>;
+/**
+ * The decoded {@link TddBehaviorResult}.
+ *
+ * @public
+ */
+type TddBehaviorResultType = Schema.Schema.Type<typeof TddBehaviorResult>;
+/**
+ * The `tdd_behavior` tool's parameters — a union discriminated on `action`.
+ *
+ * @public
+ */
+export declare const TddBehaviorInput: Schema.Union<readonly [Schema.Struct<{
+  readonly action: Schema.Literal<"create">;
+  readonly goalId: Schema.Finite;
+  readonly behavior: Schema.String;
+  readonly suggestedTestName: Schema.optionalKey<Schema.String>;
+  readonly dependsOnBehaviorIds: Schema.optionalKey<Schema.$Array<Schema.Finite>>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"update">;
+  readonly id: Schema.Finite;
+  readonly behavior: Schema.optionalKey<Schema.String>;
+  readonly suggestedTestName: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+  readonly status: Schema.optionalKey<Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>>;
+  readonly dependsOnBehaviorIds: Schema.optionalKey<Schema.$Array<Schema.Finite>>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"delete">;
+  readonly id: Schema.Finite;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly id: Schema.Finite;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"list_by_goal">;
+  readonly goalId: Schema.Finite;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"list_by_tdd_task">;
+  readonly tddTaskId: Schema.Finite;
+}>]>;
+/**
+ * The decoded {@link TddBehaviorInput}.
+ *
+ * @public
+ */
+type TddBehaviorInputType = Schema.Schema.Type<typeof TddBehaviorInput>;
+/**
+ * Handler for {@link tddBehaviorTool}. The five tagged TDD errors come
+ * back as the `{ ok: false, error }` envelope; anything else is a defect.
+ *
+ * @public
+ */
+export declare const handleTddBehavior: (input: TddBehaviorInputType) => Effect.Effect<TddBehaviorResultType, never, DataReader | DataStore>;
+/**
+ * The Effect-native `tdd_behavior` tool.
+ *
+ * @public
+ */
+export declare const tddBehaviorTool: import("@effected/mcp").UnionTool<"tdd_behavior", Schema.Union<readonly [Schema.Struct<{
+  readonly action: Schema.Literal<"create">;
+  readonly goalId: Schema.Finite;
+  readonly behavior: Schema.String;
+  readonly suggestedTestName: Schema.optionalKey<Schema.String>;
+  readonly dependsOnBehaviorIds: Schema.optionalKey<Schema.$Array<Schema.Finite>>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"update">;
+  readonly id: Schema.Finite;
+  readonly behavior: Schema.optionalKey<Schema.String>;
+  readonly suggestedTestName: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+  readonly status: Schema.optionalKey<Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>>;
+  readonly dependsOnBehaviorIds: Schema.optionalKey<Schema.$Array<Schema.Finite>>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"delete">;
+  readonly id: Schema.Finite;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly id: Schema.Finite;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"list_by_goal">;
+  readonly goalId: Schema.Finite;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"list_by_tdd_task">;
+  readonly tddTaskId: Schema.Finite;
+}>]>, Schema.Union<readonly [Schema.Struct<{
+  readonly _idempotentReplay: Schema.optionalKey<Schema.Literal<true>>;
+  readonly ok: Schema.Literal<true>;
+  readonly action: Schema.Literal<"create">;
+  readonly behavior: Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly goalId: Schema.Number;
+    readonly ordinal: Schema.Number;
+    readonly behavior: Schema.String;
+    readonly suggestedTestName: Schema.NullOr<Schema.String>;
+    readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+    readonly createdAt: Schema.String;
+  }>;
+}>, Schema.Struct<{
+  readonly ok: Schema.Literal<true>;
+  readonly action: Schema.Literal<"update">;
+  readonly behavior: Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly goalId: Schema.Number;
+    readonly ordinal: Schema.Number;
+    readonly behavior: Schema.String;
+    readonly suggestedTestName: Schema.NullOr<Schema.String>;
+    readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+    readonly createdAt: Schema.String;
+  }>;
+}>, Schema.Struct<{
+  readonly ok: Schema.Literal<true>;
+  readonly action: Schema.Literal<"delete">;
+  readonly id: Schema.Number;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly found: Schema.Literal<true>;
+  readonly behavior: Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly goalId: Schema.Number;
+    readonly ordinal: Schema.Number;
+    readonly behavior: Schema.String;
+    readonly suggestedTestName: Schema.NullOr<Schema.String>;
+    readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+    readonly createdAt: Schema.String;
+    readonly parentGoal: Schema.Struct<{
+      readonly id: Schema.Number;
+      readonly goal: Schema.String;
+      readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+    }>;
+    readonly dependencies: Schema.$Array<Schema.Struct<{
+      readonly id: Schema.Number;
+      readonly goalId: Schema.Number;
+      readonly ordinal: Schema.Number;
+      readonly behavior: Schema.String;
+      readonly suggestedTestName: Schema.NullOr<Schema.String>;
+      readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+      readonly createdAt: Schema.String;
+    }>>;
+  }>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly found: Schema.Literal<false>;
+  readonly id: Schema.Number;
+}>, Schema.Struct<{
+  readonly ok: Schema.Literal<true>;
+  readonly action: Schema.Literal<"list_by_goal">;
+  readonly goalId: Schema.Number;
+  readonly behaviors: Schema.$Array<Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly goalId: Schema.Number;
+    readonly ordinal: Schema.Number;
+    readonly behavior: Schema.String;
+    readonly suggestedTestName: Schema.NullOr<Schema.String>;
+    readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+    readonly createdAt: Schema.String;
+  }>>;
+}>, Schema.Struct<{
+  readonly ok: Schema.Literal<true>;
+  readonly action: Schema.Literal<"list_by_tdd_task">;
+  readonly tddTaskId: Schema.Number;
+  readonly behaviors: Schema.$Array<Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly goalId: Schema.Number;
+    readonly ordinal: Schema.Number;
+    readonly behavior: Schema.String;
+    readonly suggestedTestName: Schema.NullOr<Schema.String>;
+    readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+    readonly createdAt: Schema.String;
+  }>>;
+}>, Schema.Struct<{
+  readonly ok: Schema.Literal<false>;
+  readonly error: Schema.StructWithRest<Schema.Struct<{
+    readonly _tag: Schema.String;
+    readonly remediation: Schema.Struct<{
+      readonly hint: Schema.String;
+      readonly suggestedTool: Schema.optionalKey<Schema.String>;
+      readonly suggestedArgs: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Unknown>>;
+    }>;
+  }>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>;
+}>]>, typeof ToolRefusal$1, DataReader | DataStore>;
+/**
+ * The `tdd_goal` tool's success payload.
+ *
+ * @public
+ */
+export declare const TddGoalResult: Schema.Union<readonly [Schema.Struct<{
+  readonly _idempotentReplay: Schema.optionalKey<Schema.Literal<true>>;
+  readonly ok: Schema.Literal<true>;
+  readonly action: Schema.Literal<"create">;
+  readonly goal: Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly sessionId: Schema.Number;
+    readonly ordinal: Schema.Number;
+    readonly goal: Schema.String;
+    readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+    readonly createdAt: Schema.String;
+  }>;
+}>, Schema.Struct<{
+  readonly ok: Schema.Literal<true>;
+  readonly action: Schema.Literal<"update">;
+  readonly goal: Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly sessionId: Schema.Number;
+    readonly ordinal: Schema.Number;
+    readonly goal: Schema.String;
+    readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+    readonly createdAt: Schema.String;
+  }>;
+}>, Schema.Struct<{
+  readonly ok: Schema.Literal<true>;
+  readonly action: Schema.Literal<"delete">;
+  readonly id: Schema.Number;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly found: Schema.Literal<true>;
+  readonly goal: Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly sessionId: Schema.Number;
+    readonly ordinal: Schema.Number;
+    readonly goal: Schema.String;
+    readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+    readonly createdAt: Schema.String;
+    readonly behaviors: Schema.$Array<Schema.Struct<{
+      readonly id: Schema.Number;
+      readonly goalId: Schema.Number;
+      readonly ordinal: Schema.Number;
+      readonly behavior: Schema.String;
+      readonly suggestedTestName: Schema.NullOr<Schema.String>;
+      readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+      readonly createdAt: Schema.String;
+    }>>;
+  }>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly found: Schema.Literal<false>;
+  readonly id: Schema.Number;
+}>, Schema.Struct<{
+  readonly ok: Schema.Literal<true>;
+  readonly action: Schema.Literal<"list">;
+  readonly tddTaskId: Schema.Number;
+  readonly goals: Schema.$Array<Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly sessionId: Schema.Number;
+    readonly ordinal: Schema.Number;
+    readonly goal: Schema.String;
+    readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+    readonly createdAt: Schema.String;
+    readonly behaviors: Schema.$Array<Schema.Struct<{
+      readonly id: Schema.Number;
+      readonly goalId: Schema.Number;
+      readonly ordinal: Schema.Number;
+      readonly behavior: Schema.String;
+      readonly suggestedTestName: Schema.NullOr<Schema.String>;
+      readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+      readonly createdAt: Schema.String;
+    }>>;
+  }>>;
+}>, Schema.Struct<{
+  readonly ok: Schema.Literal<false>;
+  readonly error: Schema.StructWithRest<Schema.Struct<{
+    readonly _tag: Schema.String;
+    readonly remediation: Schema.Struct<{
+      readonly hint: Schema.String;
+      readonly suggestedTool: Schema.optionalKey<Schema.String>;
+      readonly suggestedArgs: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Unknown>>;
+    }>;
+  }>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>;
+}>]>;
+/**
+ * The decoded {@link TddGoalResult}.
+ *
+ * @public
+ */
+type TddGoalResultType = Schema.Schema.Type<typeof TddGoalResult>;
+/**
+ * The `tdd_goal` tool's parameters — a union discriminated on `action`.
+ *
+ * @public
+ */
+export declare const TddGoalInput: Schema.Union<readonly [Schema.Struct<{
+  readonly action: Schema.Literal<"create">;
+  readonly tddTaskId: Schema.Finite;
+  readonly goal: Schema.String;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"update">;
+  readonly id: Schema.Finite;
+  readonly goal: Schema.optionalKey<Schema.String>;
+  readonly status: Schema.optionalKey<Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"delete">;
+  readonly id: Schema.Finite;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly id: Schema.Finite;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"list">;
+  readonly tddTaskId: Schema.Finite;
+}>]>;
+/**
+ * The decoded {@link TddGoalInput}.
+ *
+ * @public
+ */
+type TddGoalInputType = Schema.Schema.Type<typeof TddGoalInput>;
+/**
+ * Handler for {@link tddGoalTool}. The five tagged TDD errors come back as
+ * the `{ ok: false, error }` envelope; anything else is a defect.
+ *
+ * @public
+ */
+export declare const handleTddGoal: (input: TddGoalInputType) => Effect.Effect<TddGoalResultType, never, DataReader | DataStore>;
+/**
+ * The Effect-native `tdd_goal` tool.
+ *
+ * @public
+ */
+export declare const tddGoalTool: import("@effected/mcp").UnionTool<"tdd_goal", Schema.Union<readonly [Schema.Struct<{
+  readonly action: Schema.Literal<"create">;
+  readonly tddTaskId: Schema.Finite;
+  readonly goal: Schema.String;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"update">;
+  readonly id: Schema.Finite;
+  readonly goal: Schema.optionalKey<Schema.String>;
+  readonly status: Schema.optionalKey<Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"delete">;
+  readonly id: Schema.Finite;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly id: Schema.Finite;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"list">;
+  readonly tddTaskId: Schema.Finite;
+}>]>, Schema.Union<readonly [Schema.Struct<{
+  readonly _idempotentReplay: Schema.optionalKey<Schema.Literal<true>>;
+  readonly ok: Schema.Literal<true>;
+  readonly action: Schema.Literal<"create">;
+  readonly goal: Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly sessionId: Schema.Number;
+    readonly ordinal: Schema.Number;
+    readonly goal: Schema.String;
+    readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+    readonly createdAt: Schema.String;
+  }>;
+}>, Schema.Struct<{
+  readonly ok: Schema.Literal<true>;
+  readonly action: Schema.Literal<"update">;
+  readonly goal: Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly sessionId: Schema.Number;
+    readonly ordinal: Schema.Number;
+    readonly goal: Schema.String;
+    readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+    readonly createdAt: Schema.String;
+  }>;
+}>, Schema.Struct<{
+  readonly ok: Schema.Literal<true>;
+  readonly action: Schema.Literal<"delete">;
+  readonly id: Schema.Number;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly found: Schema.Literal<true>;
+  readonly goal: Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly sessionId: Schema.Number;
+    readonly ordinal: Schema.Number;
+    readonly goal: Schema.String;
+    readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+    readonly createdAt: Schema.String;
+    readonly behaviors: Schema.$Array<Schema.Struct<{
+      readonly id: Schema.Number;
+      readonly goalId: Schema.Number;
+      readonly ordinal: Schema.Number;
+      readonly behavior: Schema.String;
+      readonly suggestedTestName: Schema.NullOr<Schema.String>;
+      readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+      readonly createdAt: Schema.String;
+    }>>;
+  }>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly found: Schema.Literal<false>;
+  readonly id: Schema.Number;
+}>, Schema.Struct<{
+  readonly ok: Schema.Literal<true>;
+  readonly action: Schema.Literal<"list">;
+  readonly tddTaskId: Schema.Number;
+  readonly goals: Schema.$Array<Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly sessionId: Schema.Number;
+    readonly ordinal: Schema.Number;
+    readonly goal: Schema.String;
+    readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+    readonly createdAt: Schema.String;
+    readonly behaviors: Schema.$Array<Schema.Struct<{
+      readonly id: Schema.Number;
+      readonly goalId: Schema.Number;
+      readonly ordinal: Schema.Number;
+      readonly behavior: Schema.String;
+      readonly suggestedTestName: Schema.NullOr<Schema.String>;
+      readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+      readonly createdAt: Schema.String;
+    }>>;
+  }>>;
+}>, Schema.Struct<{
+  readonly ok: Schema.Literal<false>;
+  readonly error: Schema.StructWithRest<Schema.Struct<{
+    readonly _tag: Schema.String;
+    readonly remediation: Schema.Struct<{
+      readonly hint: Schema.String;
+      readonly suggestedTool: Schema.optionalKey<Schema.String>;
+      readonly suggestedArgs: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Unknown>>;
+    }>;
+  }>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>;
+}>]>, typeof ToolRefusal$1, DataReader | DataStore>;
+/**
+ * The `tdd_task` tool's success payload.
+ *
+ * @public
+ */
+export declare const TddTaskResult: Schema.Union<readonly [Schema.Struct<{
+  readonly _idempotentReplay: Schema.optionalKey<Schema.Literal<true>>;
+  readonly action: Schema.Literal<"start">;
+  readonly tddTaskId: Schema.Number;
+  readonly goal: Schema.String;
+  readonly runId: Schema.optional<Schema.String>;
+}>, Schema.Struct<{
+  readonly _idempotentReplay: Schema.optionalKey<Schema.Literal<true>>;
+  readonly action: Schema.Literal<"end">;
+  readonly tddTaskId: Schema.Number;
+  readonly outcome: Schema.Literals<readonly ["succeeded", "blocked", "abandoned"]>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly found: Schema.Literal<true>;
+  readonly task: Schema.Struct<{
+    readonly tddTaskId: Schema.Number;
+    readonly sessionId: Schema.Number;
+    readonly goal: Schema.String;
+    readonly startedAt: Schema.String;
+    readonly endedAt: Schema.NullOr<Schema.String>;
+    readonly outcome: Schema.NullOr<Schema.String>;
+    readonly runId: Schema.NullOr<Schema.String>;
+    readonly goals: Schema.$Array<Schema.Struct<{
+      readonly id: Schema.Number;
+      readonly sessionId: Schema.Number;
+      readonly ordinal: Schema.Number;
+      readonly goal: Schema.String;
+      readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+      readonly createdAt: Schema.String;
+      readonly behaviors: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.Number;
+        readonly goalId: Schema.Number;
+        readonly ordinal: Schema.Number;
+        readonly behavior: Schema.String;
+        readonly suggestedTestName: Schema.NullOr<Schema.String>;
+        readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+        readonly createdAt: Schema.String;
+      }>>;
+    }>>;
+    readonly phases: Schema.$Array<Schema.Struct<{
+      readonly id: Schema.Number;
+      readonly behaviorId: Schema.NullOr<Schema.Number>;
+      readonly phase: Schema.String;
+      readonly startedAt: Schema.String;
+      readonly endedAt: Schema.NullOr<Schema.String>;
+      readonly transitionReason: Schema.NullOr<Schema.String>;
+    }>>;
+    readonly artifacts: Schema.$Array<Schema.Struct<{
+      readonly id: Schema.Number;
+      readonly phaseId: Schema.Number;
+      readonly artifactKind: Schema.String;
+      readonly testCaseId: Schema.NullOr<Schema.Number>;
+      readonly testRunId: Schema.NullOr<Schema.Number>;
+      readonly recordedAt: Schema.String;
+    }>>;
+  }>;
+  readonly currentPhase: Schema.NullOr<Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly phase: Schema.String;
+    readonly startedAt: Schema.String;
+    readonly behaviorId: Schema.NullOr<Schema.Number>;
+  }>>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly found: Schema.Literal<false>;
+  readonly tddTaskId: Schema.Number;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"resume">;
+  readonly found: Schema.Literal<true>;
+  readonly tddTaskId: Schema.Number;
+  readonly goal: Schema.String;
+  readonly status: Schema.String;
+  readonly currentPhase: Schema.NullOr<Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly phase: Schema.String;
+    readonly startedAt: Schema.String;
+    readonly behaviorId: Schema.NullOr<Schema.Number>;
+  }>>;
+  readonly phasesRecorded: Schema.Number;
+  readonly artifactsRecorded: Schema.Number;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"resume">;
+  readonly found: Schema.Literal<false>;
+  readonly tddTaskId: Schema.Number;
+}>]>;
+/**
+ * The decoded {@link TddTaskResult}.
  *
  * @public
  */
-type NoteResultType = Schema.Schema.Type<typeof NoteResult>;
+type TddTaskResultType = Schema.Schema.Type<typeof TddTaskResult>;
 /**
- * The `note` tool's parameters — a union discriminated on `action`.
+ * The `tdd_task` tool's parameters — a union discriminated on `action`.
  *
  * @public
  */
-export declare const NoteParams: Schema.Union<readonly [Schema.Struct<{
-  readonly action: Schema.Literal<"create">;
-  readonly title: Schema.String;
-  readonly content: Schema.String;
-  readonly scope: Schema.Literals<readonly ["global", "project", "module", "suite", "test", "note"]>;
-  readonly project: Schema.optionalKey<Schema.String>;
-  readonly testFullName: Schema.optionalKey<Schema.String>;
-  readonly modulePath: Schema.optionalKey<Schema.String>;
-  readonly parentNoteId: Schema.optionalKey<Schema.Finite>;
-  readonly createdBy: Schema.optionalKey<Schema.String>;
-  readonly expiresAt: Schema.optionalKey<Schema.String>;
-  readonly pinned: Schema.optionalKey<Schema.Boolean>;
+export declare const TddTaskInput: Schema.Union<readonly [Schema.Struct<{
+  readonly action: Schema.Literal<"start">;
+  readonly goal: Schema.String;
+  readonly sessionId: Schema.optionalKey<Schema.Finite>;
+  readonly chatId: Schema.optionalKey<Schema.String>;
+  readonly parentTddTaskId: Schema.optionalKey<Schema.Finite>;
+  readonly startedAt: Schema.optionalKey<Schema.String>;
+  readonly runId: Schema.optionalKey<Schema.String>;
 }>, Schema.Struct<{
-  readonly action: Schema.Literal<"list">;
-  readonly scope: Schema.optionalKey<Schema.Literals<readonly ["global", "project", "module", "suite", "test", "note"]>>;
-  readonly project: Schema.optionalKey<Schema.String>;
-  readonly testFullName: Schema.optionalKey<Schema.String>;
+  readonly action: Schema.Literal<"end">;
+  readonly tddTaskId: Schema.Finite;
+  readonly outcome: Schema.Literals<readonly ["succeeded", "blocked", "abandoned"]>;
+  readonly summaryNoteId: Schema.optionalKey<Schema.Finite>;
 }>, Schema.Struct<{
   readonly action: Schema.Literal<"get">;
-  readonly id: Schema.Finite;
-}>, Schema.Struct<{
-  readonly action: Schema.Literal<"update">;
-  readonly id: Schema.Finite;
-  readonly title: Schema.optionalKey<Schema.String>;
-  readonly content: Schema.optionalKey<Schema.String>;
-  readonly pinned: Schema.optionalKey<Schema.Boolean>;
-  readonly expiresAt: Schema.optionalKey<Schema.String>;
-}>, Schema.Struct<{
-  readonly action: Schema.Literal<"delete">;
-  readonly id: Schema.Finite;
+  readonly tddTaskId: Schema.Finite;
 }>, Schema.Struct<{
-  readonly action: Schema.Literal<"search">;
-  readonly query: Schema.String;
+  readonly action: Schema.Literal<"resume">;
+  readonly tddTaskId: Schema.Finite;
 }>]>;
 /**
- * The decoded {@link NoteParams}.
+ * The decoded {@link TddTaskInput}.
  *
  * @public
  */
-type NoteParamsType = Schema.Schema.Type<typeof NoteParams>;
+type TddTaskInputType = Schema.Schema.Type<typeof TddTaskInput>;
+/**
+ * Handler for {@link tddTaskTool}. A `start` with neither `sessionId` nor
+ * `chatId`, an unknown `sessionId` or `chatId`, or a blank `runId` fails with a
+ * `ToolRefusal` (an `isError` result naming the fix). A store failure is
+ * a defect.
+ *
+ * @public
+ */
+export declare const handleTddTask: (input: TddTaskInputType) => Effect.Effect<TddTaskResultType, ToolRefusal$1, DataReader | DataStore>;
+/**
+ * The Effect-native `tdd_task` tool.
+ *
+ * @public
+ */
+export declare const tddTaskTool: import("@effected/mcp").UnionTool<"tdd_task", Schema.Union<readonly [Schema.Struct<{
+  readonly action: Schema.Literal<"start">;
+  readonly goal: Schema.String;
+  readonly sessionId: Schema.optionalKey<Schema.Finite>;
+  readonly chatId: Schema.optionalKey<Schema.String>;
+  readonly parentTddTaskId: Schema.optionalKey<Schema.Finite>;
+  readonly startedAt: Schema.optionalKey<Schema.String>;
+  readonly runId: Schema.optionalKey<Schema.String>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"end">;
+  readonly tddTaskId: Schema.Finite;
+  readonly outcome: Schema.Literals<readonly ["succeeded", "blocked", "abandoned"]>;
+  readonly summaryNoteId: Schema.optionalKey<Schema.Finite>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly tddTaskId: Schema.Finite;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"resume">;
+  readonly tddTaskId: Schema.Finite;
+}>]>, Schema.Union<readonly [Schema.Struct<{
+  readonly _idempotentReplay: Schema.optionalKey<Schema.Literal<true>>;
+  readonly action: Schema.Literal<"start">;
+  readonly tddTaskId: Schema.Number;
+  readonly goal: Schema.String;
+  readonly runId: Schema.optional<Schema.String>;
+}>, Schema.Struct<{
+  readonly _idempotentReplay: Schema.optionalKey<Schema.Literal<true>>;
+  readonly action: Schema.Literal<"end">;
+  readonly tddTaskId: Schema.Number;
+  readonly outcome: Schema.Literals<readonly ["succeeded", "blocked", "abandoned"]>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly found: Schema.Literal<true>;
+  readonly task: Schema.Struct<{
+    readonly tddTaskId: Schema.Number;
+    readonly sessionId: Schema.Number;
+    readonly goal: Schema.String;
+    readonly startedAt: Schema.String;
+    readonly endedAt: Schema.NullOr<Schema.String>;
+    readonly outcome: Schema.NullOr<Schema.String>;
+    readonly runId: Schema.NullOr<Schema.String>;
+    readonly goals: Schema.$Array<Schema.Struct<{
+      readonly id: Schema.Number;
+      readonly sessionId: Schema.Number;
+      readonly ordinal: Schema.Number;
+      readonly goal: Schema.String;
+      readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+      readonly createdAt: Schema.String;
+      readonly behaviors: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.Number;
+        readonly goalId: Schema.Number;
+        readonly ordinal: Schema.Number;
+        readonly behavior: Schema.String;
+        readonly suggestedTestName: Schema.NullOr<Schema.String>;
+        readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+        readonly createdAt: Schema.String;
+      }>>;
+    }>>;
+    readonly phases: Schema.$Array<Schema.Struct<{
+      readonly id: Schema.Number;
+      readonly behaviorId: Schema.NullOr<Schema.Number>;
+      readonly phase: Schema.String;
+      readonly startedAt: Schema.String;
+      readonly endedAt: Schema.NullOr<Schema.String>;
+      readonly transitionReason: Schema.NullOr<Schema.String>;
+    }>>;
+    readonly artifacts: Schema.$Array<Schema.Struct<{
+      readonly id: Schema.Number;
+      readonly phaseId: Schema.Number;
+      readonly artifactKind: Schema.String;
+      readonly testCaseId: Schema.NullOr<Schema.Number>;
+      readonly testRunId: Schema.NullOr<Schema.Number>;
+      readonly recordedAt: Schema.String;
+    }>>;
+  }>;
+  readonly currentPhase: Schema.NullOr<Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly phase: Schema.String;
+    readonly startedAt: Schema.String;
+    readonly behaviorId: Schema.NullOr<Schema.Number>;
+  }>>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly found: Schema.Literal<false>;
+  readonly tddTaskId: Schema.Number;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"resume">;
+  readonly found: Schema.Literal<true>;
+  readonly tddTaskId: Schema.Number;
+  readonly goal: Schema.String;
+  readonly status: Schema.String;
+  readonly currentPhase: Schema.NullOr<Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly phase: Schema.String;
+    readonly startedAt: Schema.String;
+    readonly behaviorId: Schema.NullOr<Schema.Number>;
+  }>>;
+  readonly phasesRecorded: Schema.Number;
+  readonly artifactsRecorded: Schema.Number;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"resume">;
+  readonly found: Schema.Literal<false>;
+  readonly tddTaskId: Schema.Number;
+}>]>, typeof ToolRefusal$1, DataReader | DataStore>;
 /**
  * The `test` tool's success payload.
  *
@@ -6244,6 +8390,167 @@ export declare const TestInput: Schema.Union<readonly [Schema.Struct<{
  * @public
  */
 type TestInputType = Schema.Schema.Type<typeof TestInput>;
+/**
+ * Handler for {@link testTool}.
+ *
+ * @public
+ */
+export declare const handleTest: (input: TestInputType) => Effect.Effect<TestResultType, never, DataReader>;
+/**
+ * The Effect-native `test` tool.
+ *
+ * @public
+ */
+export declare const testTool: import("@effected/mcp").UnionTool<"test", Schema.Union<readonly [Schema.Struct<{
+  readonly action: Schema.Literal<"list">;
+  readonly project: Schema.optionalKey<Schema.String>;
+  readonly state: Schema.optionalKey<Schema.String>;
+  readonly module: Schema.optionalKey<Schema.String>;
+  readonly limit: Schema.optionalKey<Schema.Finite>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly fullName: Schema.String;
+  readonly project: Schema.optionalKey<Schema.String>;
+  readonly modulePath: Schema.optionalKey<Schema.String>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"for_file">;
+  readonly filePath: Schema.String;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"for_tag">;
+  readonly tag: Schema.String;
+  readonly project: Schema.optionalKey<Schema.String>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"annotations">;
+  readonly fullName: Schema.String;
+  readonly project: Schema.optionalKey<Schema.String>;
+  readonly modulePath: Schema.optionalKey<Schema.String>;
+  readonly maxBytes: Schema.optionalKey<Schema.Int>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"artifacts">;
+  readonly fullName: Schema.String;
+  readonly project: Schema.optionalKey<Schema.String>;
+  readonly modulePath: Schema.optionalKey<Schema.String>;
+  readonly maxBytes: Schema.optionalKey<Schema.Int>;
+}>]>, Schema.Union<readonly [Schema.Struct<{
+  readonly action: Schema.Literal<"list">;
+  readonly count: Schema.Number;
+  readonly groups: Schema.$Array<Schema.Struct<{
+    readonly project: Schema.String;
+    readonly tests: Schema.$Array<Schema.Struct<{
+      readonly id: Schema.Number;
+      readonly fullName: Schema.String;
+      readonly state: Schema.String;
+      readonly duration: Schema.NullOr<Schema.Number>;
+      readonly module: Schema.String;
+      readonly classification: Schema.NullOr<Schema.String>;
+    }>>;
+  }>>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly found: Schema.Literal<true>;
+  readonly project: Schema.String;
+  readonly test: Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly fullName: Schema.String;
+    readonly state: Schema.String;
+    readonly duration: Schema.NullOr<Schema.Number>;
+    readonly module: Schema.String;
+    readonly classification: Schema.NullOr<Schema.String>;
+  }>;
+  readonly errors: Schema.$Array<Schema.Struct<{
+    readonly name: Schema.NullOr<Schema.String>;
+    readonly message: Schema.String;
+    readonly diff: Schema.NullOr<Schema.String>;
+    readonly stack: Schema.NullOr<Schema.String>;
+  }>>;
+  readonly runs: Schema.$Array<Schema.Struct<{
+    readonly state: Schema.Literals<readonly ["passed", "failed"]>;
+    readonly timestamp: Schema.String;
+  }>>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"get">;
+  readonly found: Schema.Literal<false>;
+  readonly project: Schema.String;
+  readonly fullName: Schema.String;
+  /**
+   * `true` when the lookup failed *because* the name matched more than
+   * one module in the project's latest run and no `modulePath` was
+   * supplied to disambiguate (issue #243) — as opposed to the name
+   * simply not existing.
+   */
+  readonly ambiguous: Schema.optional<Schema.Boolean>;
+  /** The module paths a `fullName` matched when `ambiguous` is `true`. */
+  readonly candidateModules: Schema.optional<Schema.$Array<Schema.String>>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"for_file">;
+  readonly filePath: Schema.String;
+  readonly count: Schema.Number;
+  readonly testFiles: Schema.$Array<Schema.String>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"for_tag">;
+  readonly tag: Schema.String;
+  readonly count: Schema.Number;
+  readonly groups: Schema.$Array<Schema.Struct<{
+    readonly project: Schema.String;
+    readonly tests: Schema.$Array<Schema.Struct<{
+      readonly id: Schema.Number;
+      readonly fullName: Schema.String;
+      readonly state: Schema.String;
+      readonly duration: Schema.NullOr<Schema.Number>;
+      readonly module: Schema.String;
+      readonly classification: Schema.NullOr<Schema.String>;
+    }>>;
+  }>>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"annotations">;
+  readonly project: Schema.String;
+  readonly fullName: Schema.String;
+  readonly count: Schema.Number;
+  readonly annotations: Schema.$Array<Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly type: Schema.String;
+    readonly message: Schema.String;
+    readonly location: Schema.optional<Schema.Struct<{
+      readonly file: Schema.String;
+      readonly line: Schema.Number;
+      readonly column: Schema.Number;
+    }>>;
+    readonly attachments: Schema.$Array<Schema.Struct<{
+      readonly contentType: Schema.optional<Schema.String>;
+      readonly path: Schema.optional<Schema.String>;
+      readonly byteSize: Schema.NullOr<Schema.Number>;
+      /** Present only for inline attachments under the 64 KiB persistence cap. */
+      readonly body: Schema.optional<Schema.String>;
+      /** How to read `body`. Absent when nothing was stored inline. */
+      readonly bodyEncoding: Schema.optional<Schema.Literals<readonly ["base64", "utf-8"]>>;
+    }>>;
+  }>>;
+}>, Schema.Struct<{
+  readonly action: Schema.Literal<"artifacts">;
+  readonly project: Schema.String;
+  readonly fullName: Schema.String;
+  readonly count: Schema.Number;
+  readonly artifacts: Schema.$Array<Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly type: Schema.String;
+    readonly message: Schema.NullOr<Schema.String>;
+    readonly data: Schema.NullOr<Schema.String>;
+    readonly location: Schema.optional<Schema.Struct<{
+      readonly file: Schema.String;
+      readonly line: Schema.Number;
+      readonly column: Schema.Number;
+    }>>;
+    readonly attachments: Schema.$Array<Schema.Struct<{
+      readonly contentType: Schema.optional<Schema.String>;
+      readonly path: Schema.optional<Schema.String>;
+      readonly byteSize: Schema.NullOr<Schema.Number>;
+      /** Present only for inline attachments under the 64 KiB persistence cap. */
+      readonly body: Schema.optional<Schema.String>;
+      /** How to read `body`. Absent when nothing was stored inline. */
+      readonly bodyEncoding: Schema.optional<Schema.Literals<readonly ["base64", "utf-8"]>>;
+    }>>;
+  }>>;
+}>]>, typeof ToolRefusal$1, DataReader>;
 /**
  * The version of this package, inlined at build time from
  * `package.json#version` via the bundler's `__PACKAGE_VERSION__` substitution.
@@ -6253,5 +8560,5 @@ type TestInputType = Schema.Schema.Type<typeof TestInput>;
  * @public
  */
 export declare const CURRENT_MCP_VERSION: string;
-export { type AcceptanceMetricsResultType, type CacheHealthResultType, type CommitChangesInputType, type CommitChangesResultType, type ConfigureInputType, type ConfigureResultType, type CurrentSessionIdRef, type FailureSignatureGetInputType, type FailureSignatureGetResultType, type FileCoverageInputType, type FileCoverageResultType, type HelpResultType, type InventoryInputType, type InventoryResultType, type McpSessionOptions, type NoteParamsType, type NoteResultType, type PhaseTransitionInputType, type PhaseTransitionResultType, type PingResultType, type PlatformServices, type RegisterAgentInputType, type RegisterAgentOutput, type Remediation, type RunTestsInputType, type RunTestsResultType, type ServerLayerOptions, type SessionContext, type SessionContextRef, type SettingsListResultType, type TddArtifactListInputType, type TddArtifactListResultType, type TddErrorEnvelope, type TddProgressPushInputType, type TddProgressPushResultType, type TestCoverageInputType, type TestCoverageResultType, type TestErrorsInputType, type TestErrorsResultType, type TestHistoryInputType, type TestHistoryResultType, type TestInputType, type TestOverviewInputType, type TestOverviewResultType, type TestResultType, type TestStatusInputType, type TestStatusResultType, type TestTrendsInputType, type TestTrendsResultType, ToolRefusal, type TriageBriefInputType, type TriageBriefResultType, type TurnSearchInputType, type TurnSearchResultType, type WrapupPromptInputType, type WrapupPromptResultType };
+export { type AcceptanceMetricsResultType, type CacheHealthResultType, type CommitChangesInputType, type CommitChangesResultType, type ConfigureInputType, type ConfigureResultType, type CurrentSessionIdRef, type FailureSignatureGetInputType, type FailureSignatureGetResultType, type FileCoverageInputType, type FileCoverageResultType, type HelpResultType, type HypothesisInputType, type HypothesisResultType, type InventoryInputType, type InventoryResultType, type McpSessionOptions, type NoteParamsType, type NoteResultType, type PhaseTransitionInputType, type PhaseTransitionResultType, type PingResultType, type PlatformServices, type RegisterAgentInputType, type RegisterAgentOutput, type Remediation, type RunTestsInputType, type RunTestsResultType, type ServerLayerOptions, type SessionContext, type SessionContextRef, type SettingsListResultType, type TddArtifactListInputType, type TddArtifactListResultType, type TddBehaviorInputType, type TddBehaviorResultType, type TddErrorEnvelope, type TddGoalInputType, type TddGoalResultType, type TddProgressPushInputType, type TddProgressPushResultType, type TddTaskInputType, type TddTaskResultType, type TestCoverageInputType, type TestCoverageResultType, type TestErrorsInputType, type TestErrorsResultType, type TestHistoryInputType, type TestHistoryResultType, type TestInputType, type TestOverviewInputType, type TestOverviewResultType, type TestResultType, type TestStatusInputType, type TestStatusResultType, type TestTrendsInputType, type TestTrendsResultType, ToolRefusal, type TriageBriefInputType, type TriageBriefResultType, type TurnSearchInputType, type TurnSearchResultType, type WrapupPromptInputType, type WrapupPromptResultType };
 //# sourceMappingURL=index.d.ts.map