@vitest-agent/mcp 5.4.0 → 6.0.0

package/index.d.ts

@@ -3,6 +3,7 @@ import { Context, Effect, Layer, Schema, Stdio } from "effect";
 import { DataReader, DataStore, ProjectDiscovery, SessionContext } from "@vitest-agent/engine";
 import { McpServer, Tool, Toolkit } from "effect/ai";
 import "@effected/git";
+import "@effected/mcp/node";
 import "@vitest-agent/sdk";
 import { Remediation } from "@effected/engine";
 /**
@@ -17,37 +18,6 @@ import { Remediation } from "@effected/engine";
  * @public
  */
 export declare const RenderText: Context.Reference<((result: unknown) => string | undefined) | undefined>;
-/**
- * Wraps `handler` with idempotent-response caching keyed on `path`.
- *
- * Semantics (unchanged from the retired tRPC middleware):
- *
- * 1. Look up the `IdempotencyKeySpec` registered for `path`, and
- *    derive a key from `params` (already decoded — strict registration
- *    guarantees no key was stripped). No registered spec, or a `null`
- *    key, runs `handler` untouched with nothing cached.
- * 2. Cache HIT — `DataReader.findIdempotentResponse` returns the stored
- *    JSON. A row that parses falls through to step 2a; a row that fails
- *    to parse (corrupt or truncated) is treated as step 3, a cache MISS —
- *    it is not a reason to fail the call.
- * 2a. The parsed value is merged with `_idempotentReplay: true` for an
- *    object payload (a non-object payload passes through unchanged).
- *    `handler` does not run.
- * 3. Cache MISS — run `handler`, then persist the result via
- *    `DataStore.recordIdempotentResponse` best-effort: a persistence
- *    failure (or a cache-lookup failure) never surfaces to the caller, it
- *    is swallowed so a transient DB failure doesn't turn into a tool
- *    error. A failed `handler` persists nothing, so a retry re-runs it.
- *
- * The combinator reads no ambient state — `path` and `params` are its
- * only inputs beyond the `DataReader` / `DataStore` services it adds to
- * `handler`'s requirements.
- *
- * @public
- */
-export declare const withIdempotency: <P, R, E, S>(path: string, handler: (params: P) => Effect.Effect<R, E, S>) => (params: P) => Effect.Effect<R | (R & {
-  _idempotentReplay: true;
-}), E, S | DataReader | DataStore>;
 /**
  * Mutable holder for the MCP server's currently-associated host chat
  * id (the per-process CC chat UUID).
@@ -1413,7 +1383,7 @@ type RegisterAgentOutput = Schema.Schema.Type<typeof RegisterAgentResult>;
 /**
  * Handler for {@link registerAgentTool}. Idempotency is the tool's own
  * business rule (the `agents` idempotency key), not the generic
- * `withIdempotency` combinator.
+ * `ToolReplay` wrapper the write tools use (`replay.ts`).
  *
  * @public
  */
@@ -1666,6 +1636,30 @@ export declare const RunTestsResult: Schema.Union<readonly [Schema.Struct<{
     readonly detail: Schema.String;
     readonly targetTool: Schema.optional<Schema.String>;
   }>>>;
+  readonly runDiagnostics: Schema.optionalKey<Schema.Struct<{
+    readonly performanceHints: Schema.$Array<Schema.Struct<{
+      readonly kind: Schema.Literals<readonly ["environment", "import", "transform", "isolate"]>;
+      readonly project: Schema.optionalKey<Schema.String>;
+      readonly message: Schema.String;
+      readonly remedy: Schema.String;
+      readonly detail: Schema.String;
+      readonly learnMoreUrl: Schema.String;
+      readonly estimatedSavingMs: Schema.optionalKey<Schema.Finite>;
+      readonly share: Schema.optionalKey<Schema.Finite>;
+    }>>;
+    readonly postRun: Schema.optionalKey<Schema.Struct<{
+      readonly persistMs: Schema.Finite;
+      readonly coverageScanMs: Schema.Finite;
+      readonly totalMs: Schema.Finite;
+      readonly renderMs: Schema.optionalKey<Schema.Finite>;
+      readonly vitestDurationMs: Schema.optionalKey<Schema.Finite>;
+    }>>;
+    readonly persistence: Schema.optionalKey<Schema.Struct<{
+      readonly ok: Schema.Boolean;
+      readonly reason: Schema.optionalKey<Schema.String>;
+      readonly migrationFailed: Schema.optionalKey<Schema.Boolean>;
+    }>>;
+  }>>;
 }>, Schema.Struct<{
   readonly kind: Schema.Literal<"timeout">;
   readonly timeoutSeconds: Schema.Number;
@@ -1710,6 +1704,7 @@ export declare const RunTestsInput: Schema.Struct<{
   }>>;
   readonly passWithNoTests: Schema.optionalKey<Schema.Boolean>;
   readonly timeout: Schema.optionalKey<Schema.Finite>;
+  readonly _callerCwd: Schema.optionalKey<Schema.String>;
   readonly _sessionContext: Schema.optionalKey<Schema.Struct<{
     readonly chatId: Schema.String;
     readonly conversationId: Schema.String;
@@ -1723,12 +1718,13 @@ export declare const RunTestsInput: Schema.Struct<{
  */
 type RunTestsInputType = Schema.Schema.Type<typeof RunTestsInput>;
 /**
- * Handler for {@link runTestsTool}. Serialized through a one-permit
- * semaphore: the body assigns the active attribution UUIDs into
- * `process.env.VITEST_AGENT_*` and then awaits `createVitest` /
- * `vitest.start`, which spawns the worker pool that snapshots env at
- * spawn time — two interleaved calls would race, attributing one call's
- * results to the other's agent.
+ * Handler for {@link runTestsTool}. The body runs in the one-permit
+ * `Exclusive` lane: it assigns the active attribution UUIDs into
+ * `process.env.VITEST_AGENT_*`, enters the run's root, and then awaits
+ * `createVitest` / `vitest.start`, which spawns the worker pool that
+ * snapshots env and cwd at spawn time — two interleaved calls would race,
+ * attributing one call's results to the other's agent. A client cancel
+ * drops the response; the next call waits for the real run to end.
  *
  * @public
  */
@@ -1750,6 +1746,7 @@ export declare const runTestsTool: Tool.Tool<"run_tests", {
     }>>;
     readonly passWithNoTests: Schema.optionalKey<Schema.Boolean>;
     readonly timeout: Schema.optionalKey<Schema.Finite>;
+    readonly _callerCwd: Schema.optionalKey<Schema.String>;
     readonly _sessionContext: Schema.optionalKey<Schema.Struct<{
       readonly chatId: Schema.String;
       readonly conversationId: Schema.String;
@@ -1965,6 +1962,30 @@ export declare const runTestsTool: Tool.Tool<"run_tests", {
       readonly detail: Schema.String;
       readonly targetTool: Schema.optional<Schema.String>;
     }>>>;
+    readonly runDiagnostics: Schema.optionalKey<Schema.Struct<{
+      readonly performanceHints: Schema.$Array<Schema.Struct<{
+        readonly kind: Schema.Literals<readonly ["environment", "import", "transform", "isolate"]>;
+        readonly project: Schema.optionalKey<Schema.String>;
+        readonly message: Schema.String;
+        readonly remedy: Schema.String;
+        readonly detail: Schema.String;
+        readonly learnMoreUrl: Schema.String;
+        readonly estimatedSavingMs: Schema.optionalKey<Schema.Finite>;
+        readonly share: Schema.optionalKey<Schema.Finite>;
+      }>>;
+      readonly postRun: Schema.optionalKey<Schema.Struct<{
+        readonly persistMs: Schema.Finite;
+        readonly coverageScanMs: Schema.Finite;
+        readonly totalMs: Schema.Finite;
+        readonly renderMs: Schema.optionalKey<Schema.Finite>;
+        readonly vitestDurationMs: Schema.optionalKey<Schema.Finite>;
+      }>>;
+      readonly persistence: Schema.optionalKey<Schema.Struct<{
+        readonly ok: Schema.Boolean;
+        readonly reason: Schema.optionalKey<Schema.String>;
+        readonly migrationFailed: Schema.optionalKey<Schema.Boolean>;
+      }>>;
+    }>>;
   }>, Schema.Struct<{
     readonly kind: Schema.Literal<"timeout">;
     readonly timeoutSeconds: Schema.Number;
@@ -3142,6 +3163,7 @@ export declare const Kit: Toolkit.Toolkit<{
       }>>;
       readonly passWithNoTests: import("effect/Schema").optionalKey<import("effect/Schema").Boolean>;
       readonly timeout: import("effect/Schema").optionalKey<import("effect/Schema").Finite>;
+      readonly _callerCwd: import("effect/Schema").optionalKey<import("effect/Schema").String>;
       readonly _sessionContext: import("effect/Schema").optionalKey<import("effect/Schema").Struct<{
         readonly chatId: import("effect/Schema").String;
         readonly conversationId: import("effect/Schema").String;
@@ -3357,6 +3379,30 @@ export declare const Kit: Toolkit.Toolkit<{
         readonly detail: import("effect/Schema").String;
         readonly targetTool: import("effect/Schema").optional<import("effect/Schema").String>;
       }>>>;
+      readonly runDiagnostics: import("effect/Schema").optionalKey<import("effect/Schema").Struct<{
+        readonly performanceHints: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+          readonly kind: import("effect/Schema").Literals<readonly ["environment", "import", "transform", "isolate"]>;
+          readonly project: import("effect/Schema").optionalKey<import("effect/Schema").String>;
+          readonly message: import("effect/Schema").String;
+          readonly remedy: import("effect/Schema").String;
+          readonly detail: import("effect/Schema").String;
+          readonly learnMoreUrl: import("effect/Schema").String;
+          readonly estimatedSavingMs: import("effect/Schema").optionalKey<import("effect/Schema").Finite>;
+          readonly share: import("effect/Schema").optionalKey<import("effect/Schema").Finite>;
+        }>>;
+        readonly postRun: import("effect/Schema").optionalKey<import("effect/Schema").Struct<{
+          readonly persistMs: import("effect/Schema").Finite;
+          readonly coverageScanMs: import("effect/Schema").Finite;
+          readonly totalMs: import("effect/Schema").Finite;
+          readonly renderMs: import("effect/Schema").optionalKey<import("effect/Schema").Finite>;
+          readonly vitestDurationMs: import("effect/Schema").optionalKey<import("effect/Schema").Finite>;
+        }>>;
+        readonly persistence: import("effect/Schema").optionalKey<import("effect/Schema").Struct<{
+          readonly ok: import("effect/Schema").Boolean;
+          readonly reason: import("effect/Schema").optionalKey<import("effect/Schema").String>;
+          readonly migrationFailed: import("effect/Schema").optionalKey<import("effect/Schema").Boolean>;
+        }>>;
+      }>>;
     }>, import("effect/Schema").Struct<{
       readonly kind: import("effect/Schema").Literal<"timeout">;
       readonly timeoutSeconds: import("effect/Schema").Number;
@@ -3451,7 +3497,7 @@ export declare const Kit: Toolkit.Toolkit<{
   }>, import("effect/Schema").Struct<{
     readonly action: import("effect/Schema").Literal<"list_by_tdd_task">;
     readonly tddTaskId: import("effect/Schema").Finite;
-  }>]>, import("effect/Schema").Union<readonly [import("effect/Schema").Struct<{
+  }>]>, import("effect/Schema").Union<readonly [import("effect/Schema").Union<readonly [import("effect/Schema").Struct<{
     readonly _idempotentReplay: import("effect/Schema").optionalKey<import("effect/Schema").Literal<true>>;
     readonly ok: import("effect/Schema").Literal<true>;
     readonly action: import("effect/Schema").Literal<"create">;
@@ -3536,16 +3582,73 @@ export declare const Kit: Toolkit.Toolkit<{
       readonly status: import("effect/Schema").Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
       readonly createdAt: import("effect/Schema").String;
     }>>;
-  }>, import("effect/Schema").Struct<{
+  }>]>, import("effect/Schema").Struct<{
     readonly ok: import("effect/Schema").Literal<false>;
-    readonly error: import("effect/Schema").StructWithRest<import("effect/Schema").Struct<{
-      readonly _tag: import("effect/Schema").String;
+    readonly error: import("effect/Schema").Union<readonly [import("effect/Schema").Struct<{
+      readonly _tag: import("effect/Schema").Literal<"GoalNotFoundError">;
+    } & {
+      readonly message: import("effect/Schema").String;
+      readonly remediation: import("effect/Schema").Struct<{
+        readonly hint: import("effect/Schema").String;
+        readonly suggestedTool: import("effect/Schema").optionalKey<import("effect/Schema").String>;
+        readonly suggestedArgs: import("effect/Schema").optionalKey<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
+      }>;
+    } & {
+      readonly id: import("effect/Schema").Number;
+      readonly reason: import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+      readonly _tag: import("effect/Schema").Literal<"BehaviorNotFoundError">;
+    } & {
+      readonly message: import("effect/Schema").String;
+      readonly remediation: import("effect/Schema").Struct<{
+        readonly hint: import("effect/Schema").String;
+        readonly suggestedTool: import("effect/Schema").optionalKey<import("effect/Schema").String>;
+        readonly suggestedArgs: import("effect/Schema").optionalKey<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
+      }>;
+    } & {
+      readonly id: import("effect/Schema").Number;
+      readonly reason: import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+      readonly _tag: import("effect/Schema").Literal<"TddTaskNotFoundError">;
+    } & {
+      readonly message: import("effect/Schema").String;
+      readonly remediation: import("effect/Schema").Struct<{
+        readonly hint: import("effect/Schema").String;
+        readonly suggestedTool: import("effect/Schema").optionalKey<import("effect/Schema").String>;
+        readonly suggestedArgs: import("effect/Schema").optionalKey<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
+      }>;
+    } & {
+      readonly id: import("effect/Schema").Number;
+      readonly reason: import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+      readonly _tag: import("effect/Schema").Literal<"TddTaskAlreadyEndedError">;
+    } & {
+      readonly message: import("effect/Schema").String;
+      readonly remediation: import("effect/Schema").Struct<{
+        readonly hint: import("effect/Schema").String;
+        readonly suggestedTool: import("effect/Schema").optionalKey<import("effect/Schema").String>;
+        readonly suggestedArgs: import("effect/Schema").optionalKey<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
+      }>;
+    } & {
+      readonly id: import("effect/Schema").Number;
+      readonly endedAt: import("effect/Schema").String;
+      readonly outcome: import("effect/Schema").Literals<readonly ["succeeded", "blocked", "abandoned"]>;
+    }>, import("effect/Schema").Struct<{
+      readonly _tag: import("effect/Schema").Literal<"IllegalStatusTransitionError">;
+    } & {
+      readonly message: import("effect/Schema").String;
       readonly remediation: import("effect/Schema").Struct<{
         readonly hint: import("effect/Schema").String;
         readonly suggestedTool: import("effect/Schema").optionalKey<import("effect/Schema").String>;
         readonly suggestedArgs: import("effect/Schema").optionalKey<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
       }>;
-    }>, readonly [import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>]>;
+    } & {
+      readonly entity: import("effect/Schema").Literals<readonly ["goal", "behavior", "task"]>;
+      readonly id: import("effect/Schema").Number;
+      readonly from: import("effect/Schema").String;
+      readonly to: import("effect/Schema").String;
+      readonly reason: import("effect/Schema").String;
+    }>]>;
   }>]>, typeof import("@effected/mcp").ToolRefusal, import("@vitest-agent/engine").DataReader | import("@vitest-agent/engine").DataStore>;
   readonly tdd_goal: import("@effected/mcp").UnionTool<"tdd_goal", import("effect/Schema").Union<readonly [import("effect/Schema").Struct<{
     readonly action: import("effect/Schema").Literal<"create">;
@@ -3565,7 +3668,7 @@ export declare const Kit: Toolkit.Toolkit<{
   }>, import("effect/Schema").Struct<{
     readonly action: import("effect/Schema").Literal<"list">;
     readonly tddTaskId: import("effect/Schema").Finite;
-  }>]>, import("effect/Schema").Union<readonly [import("effect/Schema").Struct<{
+  }>]>, import("effect/Schema").Union<readonly [import("effect/Schema").Union<readonly [import("effect/Schema").Struct<{
     readonly _idempotentReplay: import("effect/Schema").optionalKey<import("effect/Schema").Literal<true>>;
     readonly ok: import("effect/Schema").Literal<true>;
     readonly action: import("effect/Schema").Literal<"create">;
@@ -3637,16 +3740,73 @@ export declare const Kit: Toolkit.Toolkit<{
         readonly createdAt: import("effect/Schema").String;
       }>>;
     }>>;
-  }>, import("effect/Schema").Struct<{
+  }>]>, import("effect/Schema").Struct<{
     readonly ok: import("effect/Schema").Literal<false>;
-    readonly error: import("effect/Schema").StructWithRest<import("effect/Schema").Struct<{
-      readonly _tag: import("effect/Schema").String;
+    readonly error: import("effect/Schema").Union<readonly [import("effect/Schema").Struct<{
+      readonly _tag: import("effect/Schema").Literal<"GoalNotFoundError">;
+    } & {
+      readonly message: import("effect/Schema").String;
+      readonly remediation: import("effect/Schema").Struct<{
+        readonly hint: import("effect/Schema").String;
+        readonly suggestedTool: import("effect/Schema").optionalKey<import("effect/Schema").String>;
+        readonly suggestedArgs: import("effect/Schema").optionalKey<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
+      }>;
+    } & {
+      readonly id: import("effect/Schema").Number;
+      readonly reason: import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+      readonly _tag: import("effect/Schema").Literal<"BehaviorNotFoundError">;
+    } & {
+      readonly message: import("effect/Schema").String;
+      readonly remediation: import("effect/Schema").Struct<{
+        readonly hint: import("effect/Schema").String;
+        readonly suggestedTool: import("effect/Schema").optionalKey<import("effect/Schema").String>;
+        readonly suggestedArgs: import("effect/Schema").optionalKey<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
+      }>;
+    } & {
+      readonly id: import("effect/Schema").Number;
+      readonly reason: import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+      readonly _tag: import("effect/Schema").Literal<"TddTaskNotFoundError">;
+    } & {
+      readonly message: import("effect/Schema").String;
+      readonly remediation: import("effect/Schema").Struct<{
+        readonly hint: import("effect/Schema").String;
+        readonly suggestedTool: import("effect/Schema").optionalKey<import("effect/Schema").String>;
+        readonly suggestedArgs: import("effect/Schema").optionalKey<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
+      }>;
+    } & {
+      readonly id: import("effect/Schema").Number;
+      readonly reason: import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+      readonly _tag: import("effect/Schema").Literal<"TddTaskAlreadyEndedError">;
+    } & {
+      readonly message: import("effect/Schema").String;
+      readonly remediation: import("effect/Schema").Struct<{
+        readonly hint: import("effect/Schema").String;
+        readonly suggestedTool: import("effect/Schema").optionalKey<import("effect/Schema").String>;
+        readonly suggestedArgs: import("effect/Schema").optionalKey<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
+      }>;
+    } & {
+      readonly id: import("effect/Schema").Number;
+      readonly endedAt: import("effect/Schema").String;
+      readonly outcome: import("effect/Schema").Literals<readonly ["succeeded", "blocked", "abandoned"]>;
+    }>, import("effect/Schema").Struct<{
+      readonly _tag: import("effect/Schema").Literal<"IllegalStatusTransitionError">;
+    } & {
+      readonly message: import("effect/Schema").String;
       readonly remediation: import("effect/Schema").Struct<{
         readonly hint: import("effect/Schema").String;
         readonly suggestedTool: import("effect/Schema").optionalKey<import("effect/Schema").String>;
         readonly suggestedArgs: import("effect/Schema").optionalKey<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
       }>;
-    }>, readonly [import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>]>;
+    } & {
+      readonly entity: import("effect/Schema").Literals<readonly ["goal", "behavior", "task"]>;
+      readonly id: import("effect/Schema").Number;
+      readonly from: import("effect/Schema").String;
+      readonly to: import("effect/Schema").String;
+      readonly reason: import("effect/Schema").String;
+    }>]>;
   }>]>, typeof import("@effected/mcp").ToolRefusal, import("@vitest-agent/engine").DataReader | import("@vitest-agent/engine").DataStore>;
   readonly tdd_phase_transition_request: import("effect/ai/Tool").Tool<"tdd_phase_transition_request", {
     readonly parameters: import("effect/Schema").Struct<{
@@ -4612,27 +4772,7 @@ export declare const toolHandlers: {
   } | {
     readonly _idempotentReplay?: true;
     readonly action: "validate";
-  } | (({
-    readonly action: "record";
-    readonly id: number;
-  } | {
-    readonly action: "list";
-    readonly count: number;
-    readonly hypotheses: readonly {
-      readonly id: number;
-      readonly sessionId: number;
-      readonly content: string;
-      readonly citedTestErrorId: number | null;
-      readonly citedStackFrameId: number | null;
-      readonly validationOutcome: "abandoned" | "confirmed" | "refuted" | null;
-      readonly validatedAt: string | null;
-    }[];
-  } | {
-    readonly _idempotentReplay?: true;
-    readonly action: "validate";
-  }) & {
-    _idempotentReplay: true;
-  }), import("effect/ai/McpSchema").InvalidParams | import("@effected/mcp").ToolRefusal, import("@vitest-agent/engine").DataReader | import("@vitest-agent/engine").DataStore | McpSession>;
+  }, import("effect/ai/McpSchema").InvalidParams | import("@effected/mcp").ToolRefusal, import("@vitest-agent/engine").DataReader | import("@vitest-agent/engine").DataStore | McpSession>;
   tdd_task: (payload: unknown) => import("effect/Effect").Effect<{
     readonly action: "get";
     readonly found: true;
@@ -4717,99 +4857,64 @@ export declare const toolHandlers: {
     readonly action: "end";
     readonly tddTaskId: number;
     readonly outcome: "abandoned" | "blocked" | "succeeded";
-  } | (({
-    readonly action: "get";
-    readonly found: true;
-    readonly task: {
-      readonly tddTaskId: number;
-      readonly sessionId: number;
-      readonly goal: string;
-      readonly startedAt: string;
-      readonly endedAt: string | null;
-      readonly outcome: string | null;
-      readonly runId: string | null;
-      readonly goals: readonly {
-        readonly id: number;
-        readonly sessionId: number;
-        readonly ordinal: number;
-        readonly goal: string;
-        readonly status: "abandoned" | "done" | "in_progress" | "pending";
-        readonly createdAt: string;
-        readonly behaviors: readonly {
-          readonly id: number;
-          readonly goalId: number;
-          readonly ordinal: number;
-          readonly behavior: string;
-          readonly suggestedTestName: string | null;
-          readonly status: "abandoned" | "done" | "in_progress" | "pending";
-          readonly createdAt: string;
-        }[];
-      }[];
-      readonly phases: readonly {
-        readonly id: number;
-        readonly behaviorId: number | null;
-        readonly phase: string;
-        readonly startedAt: string;
-        readonly endedAt: string | null;
-        readonly transitionReason: string | null;
-      }[];
-      readonly artifacts: readonly {
-        readonly id: number;
-        readonly phaseId: number;
-        readonly artifactKind: string;
-        readonly testCaseId: number | null;
-        readonly testRunId: number | null;
-        readonly recordedAt: string;
-      }[];
-    };
-    readonly currentPhase: {
-      readonly id: number;
-      readonly phase: string;
-      readonly startedAt: string;
-      readonly behaviorId: number | null;
-    } | null;
-  } | {
-    readonly action: "get";
-    readonly found: false;
-    readonly tddTaskId: number;
-  } | {
-    readonly action: "resume";
-    readonly found: true;
-    readonly tddTaskId: number;
-    readonly goal: string;
-    readonly status: string;
-    readonly currentPhase: {
-      readonly id: number;
-      readonly phase: string;
-      readonly startedAt: string;
-      readonly behaviorId: number | null;
-    } | null;
-    readonly phasesRecorded: number;
-    readonly artifactsRecorded: number;
-  } | {
-    readonly action: "resume";
-    readonly found: false;
-    readonly tddTaskId: number;
-  } | {
-    readonly _idempotentReplay?: true;
-    readonly action: "start";
-    readonly tddTaskId: number;
-    readonly goal: string;
-    readonly runId?: string | undefined;
-  } | {
-    readonly _idempotentReplay?: true;
-    readonly action: "end";
-    readonly tddTaskId: number;
-    readonly outcome: "abandoned" | "blocked" | "succeeded";
-  }) & {
-    _idempotentReplay: true;
-  }), import("effect/ai/McpSchema").InvalidParams | import("@effected/mcp").ToolRefusal, import("@vitest-agent/engine").DataReader | import("@vitest-agent/engine").DataStore>;
+  }, import("effect/ai/McpSchema").InvalidParams | import("@effected/mcp").ToolRefusal, import("@vitest-agent/engine").DataReader | import("@vitest-agent/engine").DataStore>;
   tdd_phase_transition_request: typeof handlePhaseTransitionRequest;
   tdd_goal: (payload: unknown) => import("effect/Effect").Effect<{
     readonly ok: false;
     readonly error: {
-      readonly [x: string]: unknown;
-      readonly _tag: string;
+      readonly message: string;
+      readonly remediation: {
+        readonly hint: string;
+        readonly suggestedTool?: string;
+        readonly suggestedArgs?: {
+          readonly [x: string]: unknown;
+        };
+      };
+      readonly _tag: "BehaviorNotFoundError";
+      readonly id: number;
+      readonly reason: string;
+    } | {
+      readonly message: string;
+      readonly remediation: {
+        readonly hint: string;
+        readonly suggestedTool?: string;
+        readonly suggestedArgs?: {
+          readonly [x: string]: unknown;
+        };
+      };
+      readonly _tag: "GoalNotFoundError";
+      readonly id: number;
+      readonly reason: string;
+    } | {
+      readonly message: string;
+      readonly remediation: {
+        readonly hint: string;
+        readonly suggestedTool?: string;
+        readonly suggestedArgs?: {
+          readonly [x: string]: unknown;
+        };
+      };
+      readonly _tag: "IllegalStatusTransitionError";
+      readonly entity: "behavior" | "goal" | "task";
+      readonly id: number;
+      readonly from: string;
+      readonly to: string;
+      readonly reason: string;
+    } | {
+      readonly message: string;
+      readonly remediation: {
+        readonly hint: string;
+        readonly suggestedTool?: string;
+        readonly suggestedArgs?: {
+          readonly [x: string]: unknown;
+        };
+      };
+      readonly _tag: "TddTaskAlreadyEndedError";
+      readonly id: number;
+      readonly endedAt: string;
+      readonly outcome: "abandoned" | "blocked" | "succeeded";
+    } | {
+      readonly message: string;
       readonly remediation: {
         readonly hint: string;
         readonly suggestedTool?: string;
@@ -4817,6 +4922,9 @@ export declare const toolHandlers: {
           readonly [x: string]: unknown;
         };
       };
+      readonly _tag: "TddTaskNotFoundError";
+      readonly id: number;
+      readonly reason: string;
     };
   } | {
     readonly ok: true;
@@ -4890,11 +4998,11 @@ export declare const toolHandlers: {
       readonly status: "abandoned" | "done" | "in_progress" | "pending";
       readonly createdAt: string;
     };
-  } | (({
+  }, import("effect/ai/McpSchema").InvalidParams, import("@vitest-agent/engine").DataReader | import("@vitest-agent/engine").DataStore>;
+  tdd_behavior: (payload: unknown) => import("effect/Effect").Effect<{
     readonly ok: false;
     readonly error: {
-      readonly [x: string]: unknown;
-      readonly _tag: string;
+      readonly message: string;
       readonly remediation: {
         readonly hint: string;
         readonly suggestedTool?: string;
@@ -4902,87 +5010,11 @@ export declare const toolHandlers: {
           readonly [x: string]: unknown;
         };
       };
-    };
-  } | {
-    readonly ok: true;
-    readonly action: "update";
-    readonly goal: {
+      readonly _tag: "BehaviorNotFoundError";
       readonly id: number;
-      readonly sessionId: number;
-      readonly ordinal: number;
-      readonly goal: string;
-      readonly status: "abandoned" | "done" | "in_progress" | "pending";
-      readonly createdAt: string;
-    };
-  } | {
-    readonly ok: true;
-    readonly action: "delete";
-    readonly id: number;
-  } | {
-    readonly action: "get";
-    readonly found: true;
-    readonly goal: {
-      readonly id: number;
-      readonly sessionId: number;
-      readonly ordinal: number;
-      readonly goal: string;
-      readonly status: "abandoned" | "done" | "in_progress" | "pending";
-      readonly createdAt: string;
-      readonly behaviors: readonly {
-        readonly id: number;
-        readonly goalId: number;
-        readonly ordinal: number;
-        readonly behavior: string;
-        readonly suggestedTestName: string | null;
-        readonly status: "abandoned" | "done" | "in_progress" | "pending";
-        readonly createdAt: string;
-      }[];
-    };
-  } | {
-    readonly action: "get";
-    readonly found: false;
-    readonly id: number;
-  } | {
-    readonly ok: true;
-    readonly action: "list";
-    readonly tddTaskId: number;
-    readonly goals: readonly {
-      readonly id: number;
-      readonly sessionId: number;
-      readonly ordinal: number;
-      readonly goal: string;
-      readonly status: "abandoned" | "done" | "in_progress" | "pending";
-      readonly createdAt: string;
-      readonly behaviors: readonly {
-        readonly id: number;
-        readonly goalId: number;
-        readonly ordinal: number;
-        readonly behavior: string;
-        readonly suggestedTestName: string | null;
-        readonly status: "abandoned" | "done" | "in_progress" | "pending";
-        readonly createdAt: string;
-      }[];
-    }[];
-  } | {
-    readonly _idempotentReplay?: true;
-    readonly ok: true;
-    readonly action: "create";
-    readonly goal: {
-      readonly id: number;
-      readonly sessionId: number;
-      readonly ordinal: number;
-      readonly goal: string;
-      readonly status: "abandoned" | "done" | "in_progress" | "pending";
-      readonly createdAt: string;
-    };
-  }) & {
-    _idempotentReplay: true;
-  }), import("effect/ai/McpSchema").InvalidParams, import("@vitest-agent/engine").DataReader | import("@vitest-agent/engine").DataStore>;
-  tdd_behavior: (payload: unknown) => import("effect/Effect").Effect<{
-    readonly ok: false;
-    readonly error: {
-      readonly [x: string]: unknown;
-      readonly _tag: string;
+      readonly reason: string;
+    } | {
+      readonly message: string;
       readonly remediation: {
         readonly hint: string;
         readonly suggestedTool?: string;
@@ -4990,97 +5022,39 @@ export declare const toolHandlers: {
           readonly [x: string]: unknown;
         };
       };
-    };
-  } | {
-    readonly ok: true;
-    readonly action: "update";
-    readonly behavior: {
-      readonly id: number;
-      readonly goalId: number;
-      readonly ordinal: number;
-      readonly behavior: string;
-      readonly suggestedTestName: string | null;
-      readonly status: "abandoned" | "done" | "in_progress" | "pending";
-      readonly createdAt: string;
-    };
-  } | {
-    readonly ok: true;
-    readonly action: "delete";
-    readonly id: number;
-  } | {
-    readonly action: "get";
-    readonly found: true;
-    readonly behavior: {
+      readonly _tag: "GoalNotFoundError";
       readonly id: number;
-      readonly goalId: number;
-      readonly ordinal: number;
-      readonly behavior: string;
-      readonly suggestedTestName: string | null;
-      readonly status: "abandoned" | "done" | "in_progress" | "pending";
-      readonly createdAt: string;
-      readonly parentGoal: {
-        readonly id: number;
-        readonly goal: string;
-        readonly status: "abandoned" | "done" | "in_progress" | "pending";
+      readonly reason: string;
+    } | {
+      readonly message: string;
+      readonly remediation: {
+        readonly hint: string;
+        readonly suggestedTool?: string;
+        readonly suggestedArgs?: {
+          readonly [x: string]: unknown;
+        };
       };
-      readonly dependencies: readonly {
-        readonly id: number;
-        readonly goalId: number;
-        readonly ordinal: number;
-        readonly behavior: string;
-        readonly suggestedTestName: string | null;
-        readonly status: "abandoned" | "done" | "in_progress" | "pending";
-        readonly createdAt: string;
-      }[];
-    };
-  } | {
-    readonly action: "get";
-    readonly found: false;
-    readonly id: number;
-  } | {
-    readonly ok: true;
-    readonly action: "list_by_goal";
-    readonly goalId: number;
-    readonly behaviors: readonly {
-      readonly id: number;
-      readonly goalId: number;
-      readonly ordinal: number;
-      readonly behavior: string;
-      readonly suggestedTestName: string | null;
-      readonly status: "abandoned" | "done" | "in_progress" | "pending";
-      readonly createdAt: string;
-    }[];
-  } | {
-    readonly ok: true;
-    readonly action: "list_by_tdd_task";
-    readonly tddTaskId: number;
-    readonly behaviors: readonly {
+      readonly _tag: "IllegalStatusTransitionError";
+      readonly entity: "behavior" | "goal" | "task";
       readonly id: number;
-      readonly goalId: number;
-      readonly ordinal: number;
-      readonly behavior: string;
-      readonly suggestedTestName: string | null;
-      readonly status: "abandoned" | "done" | "in_progress" | "pending";
-      readonly createdAt: string;
-    }[];
-  } | {
-    readonly _idempotentReplay?: true;
-    readonly ok: true;
-    readonly action: "create";
-    readonly behavior: {
+      readonly from: string;
+      readonly to: string;
+      readonly reason: string;
+    } | {
+      readonly message: string;
+      readonly remediation: {
+        readonly hint: string;
+        readonly suggestedTool?: string;
+        readonly suggestedArgs?: {
+          readonly [x: string]: unknown;
+        };
+      };
+      readonly _tag: "TddTaskAlreadyEndedError";
       readonly id: number;
-      readonly goalId: number;
-      readonly ordinal: number;
-      readonly behavior: string;
-      readonly suggestedTestName: string | null;
-      readonly status: "abandoned" | "done" | "in_progress" | "pending";
-      readonly createdAt: string;
-    };
-  } | (({
-    readonly ok: false;
-    readonly error: {
-      readonly [x: string]: unknown;
-      readonly _tag: string;
+      readonly endedAt: string;
+      readonly outcome: "abandoned" | "blocked" | "succeeded";
+    } | {
+      readonly message: string;
       readonly remediation: {
         readonly hint: string;
         readonly suggestedTool?: string;
@@ -5088,6 +5062,9 @@ export declare const toolHandlers: {
           readonly [x: string]: unknown;
         };
       };
+      readonly _tag: "TddTaskNotFoundError";
+      readonly id: number;
+      readonly reason: string;
     };
   } | {
     readonly ok: true;
@@ -5174,9 +5151,7 @@ export declare const toolHandlers: {
       readonly status: "abandoned" | "done" | "in_progress" | "pending";
       readonly createdAt: string;
     };
-  }) & {
-    _idempotentReplay: true;
-  }), import("effect/ai/McpSchema").InvalidParams, import("@vitest-agent/engine").DataReader | import("@vitest-agent/engine").DataStore>;
+  }, import("effect/ai/McpSchema").InvalidParams, import("@vitest-agent/engine").DataReader | import("@vitest-agent/engine").DataStore>;
   tdd_artifact_list: typeof handleTddArtifactList;
   tdd_progress_push: typeof handleTddProgressPush;
   run_tests: typeof handleRunTests;
@@ -5672,6 +5647,7 @@ export declare const ToolsLayer: import("effect/Layer").Layer<import("effect/ai/
       }>>;
       readonly passWithNoTests: import("effect/Schema").optionalKey<import("effect/Schema").Boolean>;
       readonly timeout: import("effect/Schema").optionalKey<import("effect/Schema").Finite>;
+      readonly _callerCwd: import("effect/Schema").optionalKey<import("effect/Schema").String>;
       readonly _sessionContext: import("effect/Schema").optionalKey<import("effect/Schema").Struct<{
         readonly chatId: import("effect/Schema").String;
         readonly conversationId: import("effect/Schema").String;
@@ -5887,6 +5863,30 @@ export declare const ToolsLayer: import("effect/Layer").Layer<import("effect/ai/
         readonly detail: import("effect/Schema").String;
         readonly targetTool: import("effect/Schema").optional<import("effect/Schema").String>;
       }>>>;
+      readonly runDiagnostics: import("effect/Schema").optionalKey<import("effect/Schema").Struct<{
+        readonly performanceHints: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+          readonly kind: import("effect/Schema").Literals<readonly ["environment", "import", "transform", "isolate"]>;
+          readonly project: import("effect/Schema").optionalKey<import("effect/Schema").String>;
+          readonly message: import("effect/Schema").String;
+          readonly remedy: import("effect/Schema").String;
+          readonly detail: import("effect/Schema").String;
+          readonly learnMoreUrl: import("effect/Schema").String;
+          readonly estimatedSavingMs: import("effect/Schema").optionalKey<import("effect/Schema").Finite>;
+          readonly share: import("effect/Schema").optionalKey<import("effect/Schema").Finite>;
+        }>>;
+        readonly postRun: import("effect/Schema").optionalKey<import("effect/Schema").Struct<{
+          readonly persistMs: import("effect/Schema").Finite;
+          readonly coverageScanMs: import("effect/Schema").Finite;
+          readonly totalMs: import("effect/Schema").Finite;
+          readonly renderMs: import("effect/Schema").optionalKey<import("effect/Schema").Finite>;
+          readonly vitestDurationMs: import("effect/Schema").optionalKey<import("effect/Schema").Finite>;
+        }>>;
+        readonly persistence: import("effect/Schema").optionalKey<import("effect/Schema").Struct<{
+          readonly ok: import("effect/Schema").Boolean;
+          readonly reason: import("effect/Schema").optionalKey<import("effect/Schema").String>;
+          readonly migrationFailed: import("effect/Schema").optionalKey<import("effect/Schema").Boolean>;
+        }>>;
+      }>>;
     }>, import("effect/Schema").Struct<{
       readonly kind: import("effect/Schema").Literal<"timeout">;
       readonly timeoutSeconds: import("effect/Schema").Number;
@@ -5981,7 +5981,7 @@ export declare const ToolsLayer: import("effect/Layer").Layer<import("effect/ai/
   }>, import("effect/Schema").Struct<{
     readonly action: import("effect/Schema").Literal<"list_by_tdd_task">;
     readonly tddTaskId: import("effect/Schema").Finite;
-  }>]>, import("effect/Schema").Union<readonly [import("effect/Schema").Struct<{
+  }>]>, import("effect/Schema").Union<readonly [import("effect/Schema").Union<readonly [import("effect/Schema").Struct<{
     readonly _idempotentReplay: import("effect/Schema").optionalKey<import("effect/Schema").Literal<true>>;
     readonly ok: import("effect/Schema").Literal<true>;
     readonly action: import("effect/Schema").Literal<"create">;
@@ -6066,16 +6066,73 @@ export declare const ToolsLayer: import("effect/Layer").Layer<import("effect/ai/
       readonly status: import("effect/Schema").Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
       readonly createdAt: import("effect/Schema").String;
     }>>;
-  }>, import("effect/Schema").Struct<{
+  }>]>, import("effect/Schema").Struct<{
     readonly ok: import("effect/Schema").Literal<false>;
-    readonly error: import("effect/Schema").StructWithRest<import("effect/Schema").Struct<{
-      readonly _tag: import("effect/Schema").String;
+    readonly error: import("effect/Schema").Union<readonly [import("effect/Schema").Struct<{
+      readonly _tag: import("effect/Schema").Literal<"GoalNotFoundError">;
+    } & {
+      readonly message: import("effect/Schema").String;
+      readonly remediation: import("effect/Schema").Struct<{
+        readonly hint: import("effect/Schema").String;
+        readonly suggestedTool: import("effect/Schema").optionalKey<import("effect/Schema").String>;
+        readonly suggestedArgs: import("effect/Schema").optionalKey<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
+      }>;
+    } & {
+      readonly id: import("effect/Schema").Number;
+      readonly reason: import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+      readonly _tag: import("effect/Schema").Literal<"BehaviorNotFoundError">;
+    } & {
+      readonly message: import("effect/Schema").String;
+      readonly remediation: import("effect/Schema").Struct<{
+        readonly hint: import("effect/Schema").String;
+        readonly suggestedTool: import("effect/Schema").optionalKey<import("effect/Schema").String>;
+        readonly suggestedArgs: import("effect/Schema").optionalKey<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
+      }>;
+    } & {
+      readonly id: import("effect/Schema").Number;
+      readonly reason: import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+      readonly _tag: import("effect/Schema").Literal<"TddTaskNotFoundError">;
+    } & {
+      readonly message: import("effect/Schema").String;
+      readonly remediation: import("effect/Schema").Struct<{
+        readonly hint: import("effect/Schema").String;
+        readonly suggestedTool: import("effect/Schema").optionalKey<import("effect/Schema").String>;
+        readonly suggestedArgs: import("effect/Schema").optionalKey<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
+      }>;
+    } & {
+      readonly id: import("effect/Schema").Number;
+      readonly reason: import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+      readonly _tag: import("effect/Schema").Literal<"TddTaskAlreadyEndedError">;
+    } & {
+      readonly message: import("effect/Schema").String;
       readonly remediation: import("effect/Schema").Struct<{
         readonly hint: import("effect/Schema").String;
         readonly suggestedTool: import("effect/Schema").optionalKey<import("effect/Schema").String>;
         readonly suggestedArgs: import("effect/Schema").optionalKey<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
       }>;
-    }>, readonly [import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>]>;
+    } & {
+      readonly id: import("effect/Schema").Number;
+      readonly endedAt: import("effect/Schema").String;
+      readonly outcome: import("effect/Schema").Literals<readonly ["succeeded", "blocked", "abandoned"]>;
+    }>, import("effect/Schema").Struct<{
+      readonly _tag: import("effect/Schema").Literal<"IllegalStatusTransitionError">;
+    } & {
+      readonly message: import("effect/Schema").String;
+      readonly remediation: import("effect/Schema").Struct<{
+        readonly hint: import("effect/Schema").String;
+        readonly suggestedTool: import("effect/Schema").optionalKey<import("effect/Schema").String>;
+        readonly suggestedArgs: import("effect/Schema").optionalKey<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
+      }>;
+    } & {
+      readonly entity: import("effect/Schema").Literals<readonly ["goal", "behavior", "task"]>;
+      readonly id: import("effect/Schema").Number;
+      readonly from: import("effect/Schema").String;
+      readonly to: import("effect/Schema").String;
+      readonly reason: import("effect/Schema").String;
+    }>]>;
   }>]>, typeof import("@effected/mcp").ToolRefusal, import("@vitest-agent/engine").DataReader | import("@vitest-agent/engine").DataStore>;
   readonly tdd_goal: import("@effected/mcp").UnionTool<"tdd_goal", import("effect/Schema").Union<readonly [import("effect/Schema").Struct<{
     readonly action: import("effect/Schema").Literal<"create">;
@@ -6095,7 +6152,7 @@ export declare const ToolsLayer: import("effect/Layer").Layer<import("effect/ai/
   }>, import("effect/Schema").Struct<{
     readonly action: import("effect/Schema").Literal<"list">;
     readonly tddTaskId: import("effect/Schema").Finite;
-  }>]>, import("effect/Schema").Union<readonly [import("effect/Schema").Struct<{
+  }>]>, import("effect/Schema").Union<readonly [import("effect/Schema").Union<readonly [import("effect/Schema").Struct<{
     readonly _idempotentReplay: import("effect/Schema").optionalKey<import("effect/Schema").Literal<true>>;
     readonly ok: import("effect/Schema").Literal<true>;
     readonly action: import("effect/Schema").Literal<"create">;
@@ -6167,16 +6224,73 @@ export declare const ToolsLayer: import("effect/Layer").Layer<import("effect/ai/
         readonly createdAt: import("effect/Schema").String;
       }>>;
     }>>;
-  }>, import("effect/Schema").Struct<{
+  }>]>, import("effect/Schema").Struct<{
     readonly ok: import("effect/Schema").Literal<false>;
-    readonly error: import("effect/Schema").StructWithRest<import("effect/Schema").Struct<{
-      readonly _tag: import("effect/Schema").String;
+    readonly error: import("effect/Schema").Union<readonly [import("effect/Schema").Struct<{
+      readonly _tag: import("effect/Schema").Literal<"GoalNotFoundError">;
+    } & {
+      readonly message: import("effect/Schema").String;
+      readonly remediation: import("effect/Schema").Struct<{
+        readonly hint: import("effect/Schema").String;
+        readonly suggestedTool: import("effect/Schema").optionalKey<import("effect/Schema").String>;
+        readonly suggestedArgs: import("effect/Schema").optionalKey<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
+      }>;
+    } & {
+      readonly id: import("effect/Schema").Number;
+      readonly reason: import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+      readonly _tag: import("effect/Schema").Literal<"BehaviorNotFoundError">;
+    } & {
+      readonly message: import("effect/Schema").String;
+      readonly remediation: import("effect/Schema").Struct<{
+        readonly hint: import("effect/Schema").String;
+        readonly suggestedTool: import("effect/Schema").optionalKey<import("effect/Schema").String>;
+        readonly suggestedArgs: import("effect/Schema").optionalKey<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
+      }>;
+    } & {
+      readonly id: import("effect/Schema").Number;
+      readonly reason: import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+      readonly _tag: import("effect/Schema").Literal<"TddTaskNotFoundError">;
+    } & {
+      readonly message: import("effect/Schema").String;
+      readonly remediation: import("effect/Schema").Struct<{
+        readonly hint: import("effect/Schema").String;
+        readonly suggestedTool: import("effect/Schema").optionalKey<import("effect/Schema").String>;
+        readonly suggestedArgs: import("effect/Schema").optionalKey<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
+      }>;
+    } & {
+      readonly id: import("effect/Schema").Number;
+      readonly reason: import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+      readonly _tag: import("effect/Schema").Literal<"TddTaskAlreadyEndedError">;
+    } & {
+      readonly message: import("effect/Schema").String;
       readonly remediation: import("effect/Schema").Struct<{
         readonly hint: import("effect/Schema").String;
         readonly suggestedTool: import("effect/Schema").optionalKey<import("effect/Schema").String>;
         readonly suggestedArgs: import("effect/Schema").optionalKey<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
       }>;
-    }>, readonly [import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>]>;
+    } & {
+      readonly id: import("effect/Schema").Number;
+      readonly endedAt: import("effect/Schema").String;
+      readonly outcome: import("effect/Schema").Literals<readonly ["succeeded", "blocked", "abandoned"]>;
+    }>, import("effect/Schema").Struct<{
+      readonly _tag: import("effect/Schema").Literal<"IllegalStatusTransitionError">;
+    } & {
+      readonly message: import("effect/Schema").String;
+      readonly remediation: import("effect/Schema").Struct<{
+        readonly hint: import("effect/Schema").String;
+        readonly suggestedTool: import("effect/Schema").optionalKey<import("effect/Schema").String>;
+        readonly suggestedArgs: import("effect/Schema").optionalKey<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
+      }>;
+    } & {
+      readonly entity: import("effect/Schema").Literals<readonly ["goal", "behavior", "task"]>;
+      readonly id: import("effect/Schema").Number;
+      readonly from: import("effect/Schema").String;
+      readonly to: import("effect/Schema").String;
+      readonly reason: import("effect/Schema").String;
+    }>]>;
   }>]>, typeof import("@effected/mcp").ToolRefusal, import("@vitest-agent/engine").DataReader | import("@vitest-agent/engine").DataStore>;
   readonly tdd_phase_transition_request: import("effect/ai/Tool").Tool<"tdd_phase_transition_request", {
     readonly parameters: import("effect/Schema").Struct<{
@@ -6825,8 +6939,9 @@ export declare const ToolsLayer: import("effect/Layer").Layer<import("effect/ai/
  * Success-shaped envelope returned by TDD CRUD tools when a known TDD error occurs.
  *
  * Instead of letting the five tagged TDD errors propagate as transport errors,
- * `catchTddErrorsAsEnvelope` maps them to this shape so the agent receives a normal
- * tool response with `ok: false` and a `Remediation` describing the next step.
+ * the goal / behavior handlers map them to this shape so the agent receives a
+ * normal tool response with `ok: false`, a one-sentence `message`, and a
+ * `Remediation` describing the next step.
  *
  * @public
  */
@@ -6834,6 +6949,7 @@ interface TddErrorEnvelope {
   readonly ok: false;
   readonly error: {
     readonly _tag: string;
+    readonly message: string;
     readonly remediation: Remediation;
     readonly [key: string]: unknown;
   };
@@ -7461,7 +7577,7 @@ export declare const noteTool: import("@effected/mcp").UnionTool<"note", Schema.
  *
  * @public
  */
-export declare const TddBehaviorResult: Schema.Union<readonly [Schema.Struct<{
+export declare const TddBehaviorResult: Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
   readonly _idempotentReplay: Schema.optionalKey<Schema.Literal<true>>;
   readonly ok: Schema.Literal<true>;
   readonly action: Schema.Literal<"create">;
@@ -7546,16 +7662,73 @@ export declare const TddBehaviorResult: Schema.Union<readonly [Schema.Struct<{
     readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
     readonly createdAt: Schema.String;
   }>>;
-}>, Schema.Struct<{
+}>]>, Schema.Struct<{
   readonly ok: Schema.Literal<false>;
-  readonly error: Schema.StructWithRest<Schema.Struct<{
-    readonly _tag: Schema.String;
+  readonly error: Schema.Union<readonly [Schema.Struct<{
+    readonly _tag: Schema.Literal<"GoalNotFoundError">;
+  } & {
+    readonly message: 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>]>;
+  } & {
+    readonly id: Schema.Number;
+    readonly reason: Schema.String;
+  }>, Schema.Struct<{
+    readonly _tag: Schema.Literal<"BehaviorNotFoundError">;
+  } & {
+    readonly message: 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 id: Schema.Number;
+    readonly reason: Schema.String;
+  }>, Schema.Struct<{
+    readonly _tag: Schema.Literal<"TddTaskNotFoundError">;
+  } & {
+    readonly message: 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 id: Schema.Number;
+    readonly reason: Schema.String;
+  }>, Schema.Struct<{
+    readonly _tag: Schema.Literal<"TddTaskAlreadyEndedError">;
+  } & {
+    readonly message: 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 id: Schema.Number;
+    readonly endedAt: Schema.String;
+    readonly outcome: Schema.Literals<readonly ["succeeded", "blocked", "abandoned"]>;
+  }>, Schema.Struct<{
+    readonly _tag: Schema.Literal<"IllegalStatusTransitionError">;
+  } & {
+    readonly message: 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 entity: Schema.Literals<readonly ["goal", "behavior", "task"]>;
+    readonly id: Schema.Number;
+    readonly from: Schema.String;
+    readonly to: Schema.String;
+    readonly reason: Schema.String;
+  }>]>;
 }>]>;
 /**
  * The decoded {@link TddBehaviorResult}.
@@ -7637,7 +7810,7 @@ export declare const tddBehaviorTool: import("@effected/mcp").UnionTool<"tdd_beh
 }>, Schema.Struct<{
   readonly action: Schema.Literal<"list_by_tdd_task">;
   readonly tddTaskId: Schema.Finite;
-}>]>, Schema.Union<readonly [Schema.Struct<{
+}>]>, Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
   readonly _idempotentReplay: Schema.optionalKey<Schema.Literal<true>>;
   readonly ok: Schema.Literal<true>;
   readonly action: Schema.Literal<"create">;
@@ -7722,23 +7895,80 @@ export declare const tddBehaviorTool: import("@effected/mcp").UnionTool<"tdd_beh
     readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
     readonly createdAt: Schema.String;
   }>>;
-}>, Schema.Struct<{
+}>]>, Schema.Struct<{
   readonly ok: Schema.Literal<false>;
-  readonly error: Schema.StructWithRest<Schema.Struct<{
-    readonly _tag: Schema.String;
+  readonly error: Schema.Union<readonly [Schema.Struct<{
+    readonly _tag: Schema.Literal<"GoalNotFoundError">;
+  } & {
+    readonly message: 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 id: Schema.Number;
+    readonly reason: Schema.String;
+  }>, Schema.Struct<{
+    readonly _tag: Schema.Literal<"BehaviorNotFoundError">;
+  } & {
+    readonly message: 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 id: Schema.Number;
+    readonly reason: Schema.String;
+  }>, Schema.Struct<{
+    readonly _tag: Schema.Literal<"TddTaskNotFoundError">;
+  } & {
+    readonly message: 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 id: Schema.Number;
+    readonly reason: Schema.String;
+  }>, Schema.Struct<{
+    readonly _tag: Schema.Literal<"TddTaskAlreadyEndedError">;
+  } & {
+    readonly message: 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 id: Schema.Number;
+    readonly endedAt: Schema.String;
+    readonly outcome: Schema.Literals<readonly ["succeeded", "blocked", "abandoned"]>;
+  }>, Schema.Struct<{
+    readonly _tag: Schema.Literal<"IllegalStatusTransitionError">;
+  } & {
+    readonly message: 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>]>;
+  } & {
+    readonly entity: Schema.Literals<readonly ["goal", "behavior", "task"]>;
+    readonly id: Schema.Number;
+    readonly from: Schema.String;
+    readonly to: Schema.String;
+    readonly reason: Schema.String;
+  }>]>;
 }>]>, typeof ToolRefusal$1, DataReader | DataStore>;
 /**
  * The `tdd_goal` tool's success payload.
  *
  * @public
  */
-export declare const TddGoalResult: Schema.Union<readonly [Schema.Struct<{
+export declare const TddGoalResult: Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
   readonly _idempotentReplay: Schema.optionalKey<Schema.Literal<true>>;
   readonly ok: Schema.Literal<true>;
   readonly action: Schema.Literal<"create">;
@@ -7810,16 +8040,73 @@ export declare const TddGoalResult: Schema.Union<readonly [Schema.Struct<{
       readonly createdAt: Schema.String;
     }>>;
   }>>;
-}>, Schema.Struct<{
+}>]>, Schema.Struct<{
   readonly ok: Schema.Literal<false>;
-  readonly error: Schema.StructWithRest<Schema.Struct<{
-    readonly _tag: Schema.String;
+  readonly error: Schema.Union<readonly [Schema.Struct<{
+    readonly _tag: Schema.Literal<"GoalNotFoundError">;
+  } & {
+    readonly message: 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 id: Schema.Number;
+    readonly reason: Schema.String;
+  }>, Schema.Struct<{
+    readonly _tag: Schema.Literal<"BehaviorNotFoundError">;
+  } & {
+    readonly message: 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 id: Schema.Number;
+    readonly reason: Schema.String;
+  }>, Schema.Struct<{
+    readonly _tag: Schema.Literal<"TddTaskNotFoundError">;
+  } & {
+    readonly message: 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 id: Schema.Number;
+    readonly reason: Schema.String;
+  }>, Schema.Struct<{
+    readonly _tag: Schema.Literal<"TddTaskAlreadyEndedError">;
+  } & {
+    readonly message: 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 id: Schema.Number;
+    readonly endedAt: Schema.String;
+    readonly outcome: Schema.Literals<readonly ["succeeded", "blocked", "abandoned"]>;
+  }>, Schema.Struct<{
+    readonly _tag: Schema.Literal<"IllegalStatusTransitionError">;
+  } & {
+    readonly message: 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>]>;
+  } & {
+    readonly entity: Schema.Literals<readonly ["goal", "behavior", "task"]>;
+    readonly id: Schema.Number;
+    readonly from: Schema.String;
+    readonly to: Schema.String;
+    readonly reason: Schema.String;
+  }>]>;
 }>]>;
 /**
  * The decoded {@link TddGoalResult}.
@@ -7887,7 +8174,7 @@ export declare const tddGoalTool: import("@effected/mcp").UnionTool<"tdd_goal",
 }>, Schema.Struct<{
   readonly action: Schema.Literal<"list">;
   readonly tddTaskId: Schema.Finite;
-}>]>, Schema.Union<readonly [Schema.Struct<{
+}>]>, Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
   readonly _idempotentReplay: Schema.optionalKey<Schema.Literal<true>>;
   readonly ok: Schema.Literal<true>;
   readonly action: Schema.Literal<"create">;
@@ -7959,16 +8246,73 @@ export declare const tddGoalTool: import("@effected/mcp").UnionTool<"tdd_goal",
       readonly createdAt: Schema.String;
     }>>;
   }>>;
-}>, Schema.Struct<{
+}>]>, Schema.Struct<{
   readonly ok: Schema.Literal<false>;
-  readonly error: Schema.StructWithRest<Schema.Struct<{
-    readonly _tag: Schema.String;
+  readonly error: Schema.Union<readonly [Schema.Struct<{
+    readonly _tag: Schema.Literal<"GoalNotFoundError">;
+  } & {
+    readonly message: 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 id: Schema.Number;
+    readonly reason: Schema.String;
+  }>, Schema.Struct<{
+    readonly _tag: Schema.Literal<"BehaviorNotFoundError">;
+  } & {
+    readonly message: 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 id: Schema.Number;
+    readonly reason: Schema.String;
+  }>, Schema.Struct<{
+    readonly _tag: Schema.Literal<"TddTaskNotFoundError">;
+  } & {
+    readonly message: 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 id: Schema.Number;
+    readonly reason: Schema.String;
+  }>, Schema.Struct<{
+    readonly _tag: Schema.Literal<"TddTaskAlreadyEndedError">;
+  } & {
+    readonly message: 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 id: Schema.Number;
+    readonly endedAt: Schema.String;
+    readonly outcome: Schema.Literals<readonly ["succeeded", "blocked", "abandoned"]>;
+  }>, Schema.Struct<{
+    readonly _tag: Schema.Literal<"IllegalStatusTransitionError">;
+  } & {
+    readonly message: 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>]>;
+  } & {
+    readonly entity: Schema.Literals<readonly ["goal", "behavior", "task"]>;
+    readonly id: Schema.Number;
+    readonly from: Schema.String;
+    readonly to: Schema.String;
+    readonly reason: Schema.String;
+  }>]>;
 }>]>, typeof ToolRefusal$1, DataReader | DataStore>;
 /**
  * The `tdd_task` tool's success payload.