@vitest-agent/sdk 2.5.0 → 3.0.0

package/index.d.ts

@@ -9,19 +9,19 @@ import { ChildProcessSpawner } from "effect/unstable/process";
  * Aggregate coverage percentages across four istanbul metrics.
  * @public
  */
-declare const CoverageTotals: Schema.Struct<{
+export declare const CoverageTotals: Schema.Struct<{
   readonly statements: Schema.Number;
   readonly branches: Schema.Number;
   readonly functions: Schema.Number;
   readonly lines: Schema.Number;
 }>;
 /** @public */
-type CoverageTotals = typeof CoverageTotals.Type;
+export type CoverageTotals = typeof CoverageTotals.Type;
 /**
  * Per-file coverage data including uncovered line ranges.
  * @public
  */
-declare const FileCoverageReport: Schema.Struct<{
+export declare const FileCoverageReport: Schema.Struct<{
   readonly file: Schema.String;
   readonly summary: Schema.Struct<{
     readonly statements: Schema.Number;
@@ -32,12 +32,12 @@ declare const FileCoverageReport: Schema.Struct<{
   readonly uncoveredLines: Schema.String;
 }>;
 /** @public */
-type FileCoverageReport = typeof FileCoverageReport.Type;
+export type FileCoverageReport = typeof FileCoverageReport.Type;
 /**
  * Complete coverage report attached to an AgentReport.
  * @public
  */
-declare const CoverageReport: Schema.Struct<{
+export declare const CoverageReport: Schema.Struct<{
   readonly totals: Schema.Struct<{
     readonly statements: Schema.Number;
     readonly branches: Schema.Number;
@@ -56,6 +56,12 @@ declare const CoverageReport: Schema.Struct<{
       readonly functions: Schema.optional<Schema.Number>;
       readonly branches: Schema.optional<Schema.Number>;
       readonly statements: Schema.optional<Schema.Number>;
+      readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+        readonly lines: Schema.optional<Schema.Number>;
+        readonly functions: Schema.optional<Schema.Number>;
+        readonly branches: Schema.optional<Schema.Number>;
+        readonly statements: Schema.optional<Schema.Number>;
+      }>]>>;
     }>]>>, never>;
   }>;
   readonly targets: Schema.optional<Schema.Struct<{
@@ -70,6 +76,12 @@ declare const CoverageReport: Schema.Struct<{
       readonly functions: Schema.optional<Schema.Number>;
       readonly branches: Schema.optional<Schema.Number>;
       readonly statements: Schema.optional<Schema.Number>;
+      readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+        readonly lines: Schema.optional<Schema.Number>;
+        readonly functions: Schema.optional<Schema.Number>;
+        readonly branches: Schema.optional<Schema.Number>;
+        readonly statements: Schema.optional<Schema.Number>;
+      }>]>>;
     }>]>>, never>;
   }>>;
   readonly baselines: Schema.optional<Schema.Struct<{
@@ -84,6 +96,12 @@ declare const CoverageReport: Schema.Struct<{
       readonly functions: Schema.optional<Schema.Number>;
       readonly branches: Schema.optional<Schema.Number>;
       readonly statements: Schema.optional<Schema.Number>;
+      readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+        readonly lines: Schema.optional<Schema.Number>;
+        readonly functions: Schema.optional<Schema.Number>;
+        readonly branches: Schema.optional<Schema.Number>;
+        readonly statements: Schema.optional<Schema.Number>;
+      }>]>>;
     }>]>>, never>;
   }>>;
   readonly scoped: Schema.withDecodingDefaultKey<Schema.Boolean, never>;
@@ -113,14 +131,14 @@ declare const CoverageReport: Schema.Struct<{
   readonly belowTargetFiles: Schema.optional<Schema.$Array<Schema.String>>;
 }>;
 /** @public */
-type CoverageReport = typeof CoverageReport.Type;
+export type CoverageReport = typeof CoverageReport.Type;
 //#endregion
 //#region src/schemas/RenderState.d.ts
 /**
  * Per-test record accumulated as `TestStarted` / `TestFinished` events arrive.
  * @public
  */
-declare const TestRecord: Schema.Struct<{
+export declare const TestRecord: Schema.Struct<{
   readonly testName: Schema.String;
   readonly suitePath: Schema.$Array<Schema.String>;
   readonly status: Schema.Union<readonly [Schema.Literals<readonly ["passed", "failed", "skipped", "pending"]>, Schema.Literals<readonly ["running", "timed-out"]>]>;
@@ -134,13 +152,13 @@ declare const TestRecord: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type TestRecord = typeof TestRecord.Type;
+export type TestRecord = typeof TestRecord.Type;
 /**
  * Per-module aggregation. The reducer keeps modules keyed on
  * `modulePath` so out-of-order events can update the right slot.
  * @public
  */
-declare const ModuleRecord: Schema.Struct<{
+export declare const ModuleRecord: Schema.Struct<{
   readonly modulePath: Schema.String;
   readonly status: Schema.Literals<readonly ["queued", "running", "finished"]>;
   readonly passCount: Schema.Number;
@@ -177,14 +195,14 @@ declare const ModuleRecord: Schema.Struct<{
   readonly tagCounts: Schema.optional<Schema.$Record<Schema.String, Schema.Number>>;
 }>;
 /** @public */
-type ModuleRecord = typeof ModuleRecord.Type;
+export type ModuleRecord = typeof ModuleRecord.Type;
 /**
  * One row in the failure list. A failure can exist before its
  * classification arrives (`FailureClassified` is emitted from a
  * separate pipeline), so `classification` is nullable.
  * @public
  */
-declare const FailureRecord: Schema.Struct<{
+export declare const FailureRecord: Schema.Struct<{
   readonly modulePath: Schema.String;
   readonly testName: Schema.String;
   readonly suitePath: Schema.$Array<Schema.String>;
@@ -199,13 +217,13 @@ declare const FailureRecord: Schema.Struct<{
   readonly classification: Schema.NullOr<Schema.Literals<readonly ["stable", "new-failure", "persistent", "flaky", "recovered"]>>;
 }>;
 /** @public */
-type FailureRecord = typeof FailureRecord.Type;
+export type FailureRecord = typeof FailureRecord.Type;
 /**
  * Coverage block, populated only after `CoverageReady`. Threshold
  * violations are accumulated separately as they arrive.
  * @public
  */
-declare const CoverageRenderState: Schema.Struct<{
+export declare const CoverageRenderState: Schema.Struct<{
   readonly metrics: Schema.Struct<{
     readonly statements: Schema.Number;
     readonly branches: Schema.Number;
@@ -238,25 +256,25 @@ declare const CoverageRenderState: Schema.Struct<{
   readonly totalFiles: Schema.optional<Schema.Number>;
 }>;
 /** @public */
-type CoverageRenderState = typeof CoverageRenderState.Type;
+export type CoverageRenderState = typeof CoverageRenderState.Type;
 /**
  * A `SuggestedAction` event, denormalized into the queue the renderer reads.
  * @public
  */
-declare const SuggestedActionRecord: Schema.Struct<{
+export declare const SuggestedActionRecord: Schema.Struct<{
   readonly severity: Schema.Literals<readonly ["info", "warn", "blocker"]>;
   readonly title: Schema.String;
   readonly detail: Schema.String;
   readonly targetTool: Schema.optional<Schema.String>;
 }>;
 /** @public */
-type SuggestedActionRecord = typeof SuggestedActionRecord.Type;
+export type SuggestedActionRecord = typeof SuggestedActionRecord.Type;
 /**
  * Per-run totals, recomputed on every `ModuleFinished` and reconciled
  * against `RunFinished` (which carries the runner's own count).
  * @public
  */
-declare const RenderTotals: Schema.Struct<{
+export declare const RenderTotals: Schema.Struct<{
   readonly passCount: Schema.Number;
   readonly failCount: Schema.Number;
   readonly skipCount: Schema.Number;
@@ -264,7 +282,7 @@ declare const RenderTotals: Schema.Struct<{
   readonly durationMs: Schema.Number;
 }>;
 /** @public */
-type RenderTotals = typeof RenderTotals.Type;
+export type RenderTotals = typeof RenderTotals.Type;
 /**
  * The renderer state. Both the human (Ink) and agent (string)
  * renderers read this shape; the reducer is the only producer.
@@ -276,7 +294,7 @@ type RenderTotals = typeof RenderTotals.Type;
  * rather than the suite completing.
  * @public
  */
-declare const RenderState: Schema.Struct<{
+export declare const RenderState: Schema.Struct<{
   readonly phase: Schema.Literals<readonly ["idle", "running", "finished", "timed-out"]>;
   readonly runId: Schema.NullOr<Schema.String>;
   readonly configHash: Schema.NullOr<Schema.String>;
@@ -407,14 +425,14 @@ declare const RenderState: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type RenderState = typeof RenderState.Type;
+export type RenderState = typeof RenderState.Type;
 /**
  * Initial state — what the reducer returns when no events have been
  * applied yet. Exported so tests and the renderers' bootstrapping
  * code share one definition.
  * @public
  */
-declare const initialRenderState: RenderState;
+export declare const initialRenderState: RenderState;
 //#endregion
 //#region src/contracts/dispatcher.d.ts
 /**
@@ -430,7 +448,7 @@ declare const initialRenderState: RenderState;
  * - `workspace`      — more than one project.
  * @public
  */
-type RunShape = "single-test" | "single-file" | "single-project" | "workspace";
+export type RunShape = "single-test" | "single-file" | "single-project" | "workspace";
 /**
  * The three outcome classes the dispatcher distinguishes.
  *
@@ -439,7 +457,7 @@ type RunShape = "single-test" | "single-file" | "single-project" | "workspace";
  * - `threshold-violation`  — `totals.failed === 0` and at least one coverage violation.
  * @public
  */
-type RunOutcome = "all-pass" | "some-fail" | "threshold-violation";
+export type RunOutcome = "all-pass" | "some-fail" | "threshold-violation";
 /**
  * Compact per-project aggregate carried into workspace cells.
  *
@@ -448,7 +466,7 @@ type RunOutcome = "all-pass" | "some-fail" | "threshold-violation";
  * optional — workspace cells render the columns only when present.
  * @public
  */
-interface ProjectSummary {
+export interface ProjectSummary {
   readonly name: string;
   readonly passCount: number;
   readonly failCount: number;
@@ -468,7 +486,7 @@ interface ProjectSummary {
  * `ReporterRenderInput.trendSummary` before invoking `dispatch`.
  * @public
  */
-interface TrendSummary {
+export interface TrendSummary {
   readonly direction: "improving" | "regressing" | "stable";
   readonly runCount: number;
   readonly firstMetric?: {
@@ -487,7 +505,7 @@ interface TrendSummary {
  * helpers the plugin computes once before dispatch so cells stay pure.
  * @public
  */
-interface DispatchInputs {
+export interface DispatchInputs {
   readonly state: RenderState;
   readonly shape: RunShape;
   readonly outcome: RunOutcome;
@@ -525,7 +543,7 @@ interface DispatchInputs {
  * `dispatch(inputs, opts)`. Cells destructure only what they consume.
  * @public
  */
-interface CellOptions {
+export interface CellOptions {
   /**
    * Resolved value of the `NO_COLOR` env var. Cells gate ANSI escape
    * sequences and OSC-8 hyperlinks on this.
@@ -544,7 +562,7 @@ interface CellOptions {
  * Aggregate test run statistics.
  * @public
  */
-declare const ReportSummary: Schema.Struct<{
+export declare const ReportSummary: Schema.Struct<{
   readonly total: Schema.Number;
   readonly passed: Schema.Number;
   readonly failed: Schema.Number;
@@ -560,12 +578,12 @@ declare const ReportSummary: Schema.Struct<{
   readonly modules: Schema.optional<Schema.Number>;
 }>;
 /** @public */
-type ReportSummary = typeof ReportSummary.Type;
+export type ReportSummary = typeof ReportSummary.Type;
 /**
  * An individual test case result.
  * @public
  */
-declare const TestReport: Schema.Struct<{
+export declare const TestReport: Schema.Struct<{
   readonly name: Schema.String;
   readonly fullName: Schema.String;
   readonly state: Schema.Literals<readonly ["passed", "failed", "skipped", "pending"]>;
@@ -582,12 +600,12 @@ declare const TestReport: Schema.Struct<{
   readonly classification: Schema.optional<Schema.Literals<readonly ["stable", "new-failure", "persistent", "flaky", "recovered"]>>;
 }>;
 /** @public */
-type TestReport = typeof TestReport.Type;
+export type TestReport = typeof TestReport.Type;
 /**
  * A test module (file) and its contained test cases.
  * @public
  */
-declare const ModuleReport: Schema.Struct<{
+export declare const ModuleReport: Schema.Struct<{
   readonly file: Schema.String;
   readonly state: Schema.Literals<readonly ["passed", "failed", "skipped", "pending"]>;
   readonly duration: Schema.optional<Schema.Number>;
@@ -616,23 +634,23 @@ declare const ModuleReport: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type ModuleReport = typeof ModuleReport.Type;
+export type ModuleReport = typeof ModuleReport.Type;
 /**
  * Per-tag pass/fail/skip aggregates for a single project run.
  * @public
  */
-declare const TagCountEntry: Schema.Struct<{
+export declare const TagCountEntry: Schema.Struct<{
   readonly passed: Schema.optional<Schema.Number>;
   readonly failed: Schema.optional<Schema.Number>;
   readonly skipped: Schema.optional<Schema.Number>;
 }>;
 /** @public */
-type TagCountEntry = typeof TagCountEntry.Type;
+export type TagCountEntry = typeof TagCountEntry.Type;
 /**
  * Complete per-project test report written to disk as JSON.
  * @public
  */
-declare const AgentReport: Schema.Struct<{
+export declare const AgentReport: Schema.Struct<{
   readonly timestamp: Schema.String;
   readonly project: Schema.optional<Schema.String>;
   readonly reason: Schema.Literals<readonly ["passed", "failed", "interrupted"]>;
@@ -706,6 +724,12 @@ declare const AgentReport: Schema.Struct<{
         readonly functions: Schema.optional<Schema.Number>;
         readonly branches: Schema.optional<Schema.Number>;
         readonly statements: Schema.optional<Schema.Number>;
+        readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+          readonly lines: Schema.optional<Schema.Number>;
+          readonly functions: Schema.optional<Schema.Number>;
+          readonly branches: Schema.optional<Schema.Number>;
+          readonly statements: Schema.optional<Schema.Number>;
+        }>]>>;
       }>]>>, never>;
     }>;
     readonly targets: Schema.optional<Schema.Struct<{
@@ -720,6 +744,12 @@ declare const AgentReport: Schema.Struct<{
         readonly functions: Schema.optional<Schema.Number>;
         readonly branches: Schema.optional<Schema.Number>;
         readonly statements: Schema.optional<Schema.Number>;
+        readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+          readonly lines: Schema.optional<Schema.Number>;
+          readonly functions: Schema.optional<Schema.Number>;
+          readonly branches: Schema.optional<Schema.Number>;
+          readonly statements: Schema.optional<Schema.Number>;
+        }>]>>;
       }>]>>, never>;
     }>>;
     readonly baselines: Schema.optional<Schema.Struct<{
@@ -734,6 +764,12 @@ declare const AgentReport: Schema.Struct<{
         readonly functions: Schema.optional<Schema.Number>;
         readonly branches: Schema.optional<Schema.Number>;
         readonly statements: Schema.optional<Schema.Number>;
+        readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+          readonly lines: Schema.optional<Schema.Number>;
+          readonly functions: Schema.optional<Schema.Number>;
+          readonly branches: Schema.optional<Schema.Number>;
+          readonly statements: Schema.optional<Schema.Number>;
+        }>]>>;
       }>]>>, never>;
     }>>;
     readonly scoped: Schema.withDecodingDefaultKey<Schema.Boolean, never>;
@@ -784,37 +820,37 @@ declare const AgentReport: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type AgentReport = typeof AgentReport.Type;
+export type AgentReport = typeof AgentReport.Type;
 //#endregion
 //#region src/schemas/Common.d.ts
 /**
  * Possible states for an individual test case.
  * @public
  */
-declare const TestState: Schema.Literals<readonly ["passed", "failed", "skipped", "pending"]>;
+export declare const TestState: Schema.Literals<readonly ["passed", "failed", "skipped", "pending"]>;
 /** @public */
-type TestState = typeof TestState.Type;
+export type TestState = typeof TestState.Type;
 /**
  * Overall outcome of a test run.
  * @public
  */
-declare const TestRunReason: Schema.Literals<readonly ["passed", "failed", "interrupted"]>;
+export declare const TestRunReason: Schema.Literals<readonly ["passed", "failed", "interrupted"]>;
 /** @public */
-type TestRunReason = typeof TestRunReason.Type;
+export type TestRunReason = typeof TestRunReason.Type;
 /**
  * Classification of a test's failure history across runs.
  * @public
  */
-declare const TestClassification: Schema.Literals<readonly ["stable", "new-failure", "persistent", "flaky", "recovered"]>;
+export declare const TestClassification: Schema.Literals<readonly ["stable", "new-failure", "persistent", "flaky", "recovered"]>;
 /** @public */
-type TestClassification = typeof TestClassification.Type;
+export type TestClassification = typeof TestClassification.Type;
 /**
  * Console output verbosity mode for AgentReporter.
  * @public
  */
-declare const ConsoleOutputMode: Schema.Literals<readonly ["failures", "full", "silent"]>;
+export declare const ConsoleOutputMode: Schema.Literals<readonly ["failures", "full", "silent"]>;
 /** @public */
-type ConsoleOutputMode = typeof ConsoleOutputMode.Type;
+export type ConsoleOutputMode = typeof ConsoleOutputMode.Type;
 /**
  * Console output choices per executor type.
  *
@@ -833,60 +869,60 @@ type ConsoleOutputMode = typeof ConsoleOutputMode.Type;
  *   so the default for `ci` is `passthrough` until it lands.
  * @public
  */
-declare const HumanConsoleMode: Schema.Literals<readonly ["passthrough", "silent", "stream", "agent"]>;
+export declare const HumanConsoleMode: Schema.Literals<readonly ["passthrough", "silent", "stream", "agent"]>;
 /** @public */
-type HumanConsoleMode = typeof HumanConsoleMode.Type;
+export type HumanConsoleMode = typeof HumanConsoleMode.Type;
 /** @public */
-declare const AgentConsoleMode: Schema.Literals<readonly ["passthrough", "silent", "agent"]>;
+export declare const AgentConsoleMode: Schema.Literals<readonly ["passthrough", "silent", "agent"]>;
 /** @public */
-type AgentConsoleMode = typeof AgentConsoleMode.Type;
+export type AgentConsoleMode = typeof AgentConsoleMode.Type;
 /** @public */
-declare const CiConsoleMode: Schema.Literals<readonly ["passthrough", "silent", "ci-annotations"]>;
+export declare const CiConsoleMode: Schema.Literals<readonly ["passthrough", "silent", "ci-annotations"]>;
 /** @public */
-type CiConsoleMode = typeof CiConsoleMode.Type;
+export type CiConsoleMode = typeof CiConsoleMode.Type;
 /**
  * Union of every legal console-output value across the three executor slots.
  * Useful for type-narrowing in renderers that take the resolved value.
  * @public
  */
-declare const ConsoleMode: Schema.Union<readonly [Schema.Literals<readonly ["passthrough", "silent", "stream", "agent"]>, Schema.Literals<readonly ["passthrough", "silent", "agent"]>, Schema.Literals<readonly ["passthrough", "silent", "ci-annotations"]>]>;
+export declare const ConsoleMode: Schema.Union<readonly [Schema.Literals<readonly ["passthrough", "silent", "stream", "agent"]>, Schema.Literals<readonly ["passthrough", "silent", "agent"]>, Schema.Literals<readonly ["passthrough", "silent", "ci-annotations"]>]>;
 /** @public */
-type ConsoleMode = typeof ConsoleMode.Type;
+export type ConsoleMode = typeof ConsoleMode.Type;
 /**
  * Supported package managers for run command generation.
  * @public
  */
-declare const PackageManager: Schema.Literals<readonly ["pnpm", "npm", "yarn", "bun"]>;
+export declare const PackageManager: Schema.Literals<readonly ["pnpm", "npm", "yarn", "bun"]>;
 /** @public */
-type PackageManager = typeof PackageManager.Type;
+export type PackageManager = typeof PackageManager.Type;
 /**
  * Runtime environment where tests are being executed.
  * @public
  */
-declare const Environment: Schema.Literals<readonly ["agent-shell", "terminal", "ci-github", "ci-generic"]>;
+export declare const Environment: Schema.Literals<readonly ["agent-shell", "terminal", "ci-github", "ci-generic"]>;
 /** @public */
-type Environment = typeof Environment.Type;
+export type Environment = typeof Environment.Type;
 /**
  * Who or what is executing the test run.
  * @public
  */
-declare const Executor: Schema.Literals<readonly ["human", "agent", "ci"]>;
+export declare const Executor: Schema.Literals<readonly ["human", "agent", "ci"]>;
 /** @public */
-type Executor = typeof Executor.Type;
+export type Executor = typeof Executor.Type;
 /**
  * Output format for the reporter pipeline.
  * @public
  */
-declare const OutputFormat: Schema.Literals<readonly ["terminal", "markdown", "json", "vitest-bypass", "silent", "ci-annotations"]>;
+export declare const OutputFormat: Schema.Literals<readonly ["terminal", "markdown", "json", "vitest-bypass", "silent", "ci-annotations"]>;
 /** @public */
-type OutputFormat = typeof OutputFormat.Type;
+export type OutputFormat = typeof OutputFormat.Type;
 /**
  * Level of detail in reporter output.
  * @public
  */
-declare const DetailLevel: Schema.Literals<readonly ["minimal", "neutral", "standard", "verbose"]>;
+export declare const DetailLevel: Schema.Literals<readonly ["minimal", "neutral", "standard", "verbose"]>;
 /** @public */
-type DetailLevel = typeof DetailLevel.Type;
+export type DetailLevel = typeof DetailLevel.Type;
 /**
  * A single test or module error with optional stack trace, diff, and
  * structured assertion values.
@@ -899,7 +935,7 @@ type DetailLevel = typeof DetailLevel.Type;
  * the schema boundary.
  * @public
  */
-declare const ReportError: Schema.Struct<{
+export declare const ReportError: Schema.Struct<{
   readonly message: Schema.String;
   readonly stack: Schema.optional<Schema.String>;
   readonly diff: Schema.optional<Schema.String>;
@@ -907,17 +943,34 @@ declare const ReportError: Schema.Struct<{
   readonly received: Schema.optional<Schema.String>;
 }>;
 /** @public */
-type ReportError = typeof ReportError.Type;
+export type ReportError = typeof ReportError.Type;
 //#endregion
 //#region src/formatters/types.d.ts
-/** @public */
-interface RenderedOutput {
+/**
+ * One unit of rendered reporter output, tagged by where it goes.
+ *
+ * `stdout` writes to the process stdout stream, `github-summary`
+ * appends to the GitHub Actions step-summary file, and `file` is
+ * reserved for reporters that embed their own destination path.
+ *
+ * `report` writes `filename` into `.vitest/<scope>/` through Vitest 5's
+ * `createReport`. The plugin drops these when reporting is disabled,
+ * exactly as it drops `github-summary` outside GitHub Actions.
+ *
+ * @public
+ */
+export type RenderedOutput = {
   readonly target: "stdout" | "file" | "github-summary";
   readonly content: string;
   readonly contentType: string;
-}
+} | {
+  readonly target: "report";
+  readonly filename: string;
+  readonly content: string;
+  readonly contentType: string;
+};
 /** @public */
-interface FormatterContext {
+export interface FormatterContext {
   readonly detail: DetailLevel;
   readonly noColor: boolean;
   readonly coverageConsoleLimit: number;
@@ -936,7 +989,7 @@ interface FormatterContext {
   readonly mcp?: boolean;
 }
 /** @public */
-interface Formatter {
+export interface Formatter {
   readonly format: string;
   readonly render: (reports: ReadonlyArray<AgentReport>, context: FormatterContext) => ReadonlyArray<RenderedOutput>;
 }
@@ -946,43 +999,43 @@ interface Formatter {
  * Coverage metric whose threshold can be violated independently.
  * @public
  */
-declare const CoverageMetric: Schema.Literals<readonly ["lines", "branches", "functions", "statements"]>;
+export declare const CoverageMetric: Schema.Literals<readonly ["lines", "branches", "functions", "statements"]>;
 /** @public */
-type CoverageMetric = typeof CoverageMetric.Type;
+export type CoverageMetric = typeof CoverageMetric.Type;
 /**
  * Severity tier for a suggested action emitted during a run.
  * @public
  */
-declare const ActionSeverity: Schema.Literals<readonly ["info", "warn", "blocker"]>;
+export declare const ActionSeverity: Schema.Literals<readonly ["info", "warn", "blocker"]>;
 /** @public */
-type ActionSeverity = typeof ActionSeverity.Type;
+export type ActionSeverity = typeof ActionSeverity.Type;
 /**
  * Lifecycle scope of a Vitest setup/teardown hook.
  * @public
  */
-declare const HookType: Schema.Literals<readonly ["beforeAll", "afterAll", "beforeEach", "afterEach"]>;
+export declare const HookType: Schema.Literals<readonly ["beforeAll", "afterAll", "beforeEach", "afterEach"]>;
 /** @public */
-type HookType = typeof HookType.Type;
+export type HookType = typeof HookType.Type;
 /**
  * Terminal status of a Vitest hook run.
  * @public
  */
-declare const HookStatus: Schema.Literals<readonly ["passed", "failed"]>;
+export declare const HookStatus: Schema.Literals<readonly ["passed", "failed"]>;
 /** @public */
-type HookStatus = typeof HookStatus.Type;
+export type HookStatus = typeof HookStatus.Type;
 /**
  * Output stream a captured user `console.log` was written to.
  * @public
  */
-declare const ConsoleLogLevel: Schema.Literals<readonly ["stdout", "stderr"]>;
+export declare const ConsoleLogLevel: Schema.Literals<readonly ["stdout", "stderr"]>;
 /** @public */
-type ConsoleLogLevel = typeof ConsoleLogLevel.Type;
+export type ConsoleLogLevel = typeof ConsoleLogLevel.Type;
 /**
  * A coverage gap surfaced to the renderer — a per-file shortfall that
  * a renderer may want to call out individually.
  * @public
  */
-declare const CoverageGap: Schema.Struct<{
+export declare const CoverageGap: Schema.Struct<{
   readonly file: Schema.String;
   readonly missing: Schema.Struct<{
     readonly statements: Schema.Number;
@@ -993,7 +1046,7 @@ declare const CoverageGap: Schema.Struct<{
   readonly uncoveredLines: Schema.optional<Schema.String>;
 }>;
 /** @public */
-type CoverageGap = typeof CoverageGap.Type;
+export type CoverageGap = typeof CoverageGap.Type;
 /**
  * The reducer projects this union into `RenderState`. Renderers
  * never read the raw event stream — they read the projected state.
@@ -1004,7 +1057,7 @@ type CoverageGap = typeof CoverageGap.Type;
  * been updated to consume the new state shape.
  * @public
  */
-declare const RunEvent: Schema.Union<readonly [Schema.TaggedStruct<"RunStarted", {
+export declare const RunEvent: Schema.Union<readonly [Schema.TaggedStruct<"RunStarted", {
   readonly runId: Schema.String;
   readonly startedAt: Schema.String;
   readonly configHash: Schema.String;
@@ -1087,11 +1140,36 @@ declare const RunEvent: Schema.Union<readonly [Schema.TaggedStruct<"RunStarted",
   readonly testName: Schema.String;
   readonly suitePath: Schema.$Array<Schema.String>;
   readonly annotation: Schema.String;
+  readonly annotationType: 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 body: Schema.optional<Schema.String>;
+    readonly bodyEncoding: Schema.optional<Schema.Literals<readonly ["base64", "utf-8"]>>;
+    readonly byteSize: Schema.Number;
+  }>>;
 }>, Schema.TaggedStruct<"TestArtifactRecorded", {
   readonly modulePath: Schema.String;
   readonly testName: Schema.String;
   readonly suitePath: Schema.$Array<Schema.String>;
   readonly artifact: 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 body: Schema.optional<Schema.String>;
+    readonly bodyEncoding: Schema.optional<Schema.Literals<readonly ["base64", "utf-8"]>>;
+    readonly byteSize: Schema.Number;
+  }>>;
 }>, Schema.TaggedStruct<"WatcherReady", {}>, Schema.TaggedStruct<"WatcherRerun", {
   readonly triggerFiles: Schema.$Array<Schema.String>;
   readonly reason: Schema.optional<Schema.String>;
@@ -1168,7 +1246,7 @@ declare const RunEvent: Schema.Union<readonly [Schema.TaggedStruct<"RunStarted",
   }>>>;
 }>]>;
 /** @public */
-type RunEvent = typeof RunEvent.Type;
+export type RunEvent = typeof RunEvent.Type;
 /**
  * Convenience: discriminator-keyed map of the individual variants.
  *
@@ -1176,54 +1254,108 @@ type RunEvent = typeof RunEvent.Type;
  * pulling the whole union shape into scope.
  * @public
  */
-type RunEventByTag = { [E in RunEvent as E["_tag"]]: E; };
+export type RunEventByTag = { [E in RunEvent as E["_tag"]]: E; };
 //#endregion
 //#region src/schemas/Thresholds.d.ts
 /**
  * Per-metric threshold values. All optional -- only set metrics are enforced.
  * @public
  */
-declare const MetricThresholds: Schema.Struct<{
+export declare const MetricThresholds: Schema.Struct<{
   readonly lines: Schema.optional<Schema.Number>;
   readonly functions: Schema.optional<Schema.Number>;
   readonly branches: Schema.optional<Schema.Number>;
   readonly statements: Schema.optional<Schema.Number>;
 }>;
 /** @public */
-type MetricThresholds = typeof MetricThresholds.Type;
+export type MetricThresholds = typeof MetricThresholds.Type;
+/**
+ * A `perFile` setting. Vitest 5 allows either a plain boolean or a
+ * per-metric object that overrides the metric numbers used for the
+ * per-file check.
+ *
+ * An object constrains exactly the metrics it names, so `{}` enforces
+ * nothing at all. Write `true` to check every metric.
+ * @public
+ */
+export declare const PerFileThresholds: Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+  readonly lines: Schema.optional<Schema.Number>;
+  readonly functions: Schema.optional<Schema.Number>;
+  readonly branches: Schema.optional<Schema.Number>;
+  readonly statements: Schema.optional<Schema.Number>;
+}>]>;
+/** @public */
+export type PerFileThresholds = typeof PerFileThresholds.Type;
+/**
+ * The metric values carried by a glob-pattern entry. Under Vitest 5 a
+ * glob entry no longer inherits the top-level `perFile`, so it carries
+ * its own optional setting.
+ * @public
+ */
+export declare const PatternMetricThresholds: Schema.Struct<{
+  readonly lines: Schema.optional<Schema.Number>;
+  readonly functions: Schema.optional<Schema.Number>;
+  readonly branches: Schema.optional<Schema.Number>;
+  readonly statements: Schema.optional<Schema.Number>;
+  readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+    readonly lines: Schema.optional<Schema.Number>;
+    readonly functions: Schema.optional<Schema.Number>;
+    readonly branches: Schema.optional<Schema.Number>;
+    readonly statements: Schema.optional<Schema.Number>;
+  }>]>>;
+}>;
+/** @public */
+export type PatternMetricThresholds = typeof PatternMetricThresholds.Type;
 /**
  * A glob pattern paired with its metric thresholds.
  * @public
  */
-declare const PatternThresholds: Schema.Tuple<readonly [Schema.String, Schema.Struct<{
+export declare const PatternThresholds: Schema.Tuple<readonly [Schema.String, Schema.Struct<{
   readonly lines: Schema.optional<Schema.Number>;
   readonly functions: Schema.optional<Schema.Number>;
   readonly branches: Schema.optional<Schema.Number>;
   readonly statements: Schema.optional<Schema.Number>;
+  readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+    readonly lines: Schema.optional<Schema.Number>;
+    readonly functions: Schema.optional<Schema.Number>;
+    readonly branches: Schema.optional<Schema.Number>;
+    readonly statements: Schema.optional<Schema.Number>;
+  }>]>>;
 }>]>;
 /** @public */
-type PatternThresholds = typeof PatternThresholds.Type;
+export type PatternThresholds = typeof PatternThresholds.Type;
 /**
  * Fully resolved thresholds ready for evaluation.
  * @public
  */
-declare const ResolvedThresholds: Schema.Struct<{
+export declare const ResolvedThresholds: Schema.Struct<{
   readonly global: Schema.Struct<{
     readonly lines: Schema.optional<Schema.Number>;
     readonly functions: Schema.optional<Schema.Number>;
     readonly branches: Schema.optional<Schema.Number>;
     readonly statements: Schema.optional<Schema.Number>;
   }>;
-  readonly perFile: Schema.withDecodingDefaultKey<Schema.Boolean, never>;
+  readonly perFile: Schema.withDecodingDefaultKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+    readonly lines: Schema.optional<Schema.Number>;
+    readonly functions: Schema.optional<Schema.Number>;
+    readonly branches: Schema.optional<Schema.Number>;
+    readonly statements: Schema.optional<Schema.Number>;
+  }>]>, never>;
   readonly patterns: Schema.withDecodingDefaultKey<Schema.$Array<Schema.Tuple<readonly [Schema.String, Schema.Struct<{
     readonly lines: Schema.optional<Schema.Number>;
     readonly functions: Schema.optional<Schema.Number>;
     readonly branches: Schema.optional<Schema.Number>;
     readonly statements: Schema.optional<Schema.Number>;
+    readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+      readonly lines: Schema.optional<Schema.Number>;
+      readonly functions: Schema.optional<Schema.Number>;
+      readonly branches: Schema.optional<Schema.Number>;
+      readonly statements: Schema.optional<Schema.Number>;
+    }>]>>;
   }>]>>, never>;
 }>;
 /** @public */
-type ResolvedThresholds = typeof ResolvedThresholds.Type;
+export type ResolvedThresholds = typeof ResolvedThresholds.Type;
 //#endregion
 //#region src/schemas/Transport.d.ts
 /**
@@ -1235,11 +1367,11 @@ type ResolvedThresholds = typeof ResolvedThresholds.Type;
  * diff and no breaking API change at the call site.
  * @public
  */
-declare const Transport: Schema.Union<readonly [Schema.Struct<{
+export declare const Transport: Schema.Union<readonly [Schema.Struct<{
   readonly kind: Schema.Literal<"local">;
 }>]>;
 /** @public */
-type Transport = typeof Transport.Type;
+export type Transport = typeof Transport.Type;
 //#endregion
 //#region src/contracts/reporter.d.ts
 /**
@@ -1257,7 +1389,7 @@ type Transport = typeof Transport.Type;
  * var; reporters use it to gate ANSI escapes and OSC-8 hyperlinks.
  * @public
  */
-interface ResolvedReporterConfig {
+export interface ResolvedReporterConfig {
   readonly dbPath?: string;
   readonly projectFilter?: string;
   /**
@@ -1333,7 +1465,7 @@ interface ResolvedReporterConfig {
  * named-field object. Reporters destructure only what they consume.
  * @public
  */
-interface ReporterKit {
+export interface ReporterKit {
   readonly config: ResolvedReporterConfig;
   readonly stdEnv: Environment;
   /**
@@ -1369,7 +1501,7 @@ interface ReporterKit {
  * where coverage trends were computed.
  * @public
  */
-interface ReporterRenderInput {
+export interface ReporterRenderInput {
   readonly reports: ReadonlyArray<AgentReport>;
   readonly classifications: ReadonlyMap<string, TestClassification>;
   readonly trendSummary?: {
@@ -1403,7 +1535,7 @@ interface ReporterRenderInput {
  * no console output at all.
  * @public
  */
-interface VitestAgentReporter {
+export interface VitestAgentReporter {
   readonly render: (input: ReporterRenderInput, kit: ReporterKit) => ReadonlyArray<RenderedOutput>;
 }
 /**
@@ -1425,7 +1557,7 @@ interface VitestAgentReporter {
  * the plugin own the kit assembly.
  * @public
  */
-type VitestAgentReporterFactory = (kit: ReporterKit) => VitestAgentReporter | ReadonlyArray<VitestAgentReporter>;
+export type VitestAgentReporterFactory = (kit: ReporterKit) => VitestAgentReporter | ReadonlyArray<VitestAgentReporter>;
 //#endregion
 //#region src/schemas/Identity.d.ts
 /**
@@ -1434,18 +1566,18 @@ type VitestAgentReporterFactory = (kit: ReporterKit) => VitestAgentReporter | Re
  * agent's lifetime.
  * @public
  */
-declare const AgentId: Schema.brand<Schema.String, "AgentId">;
+export declare const AgentId: Schema.brand<Schema.String, "AgentId">;
 /** @public */
-type AgentId = Schema.Schema.Type<typeof AgentId>;
+export type AgentId = Schema.Schema.Type<typeof AgentId>;
 /**
  * The unit "all work on this feature" rolls up to. Survives
  * `claude --resume` and parallel windows; lives in the host's
  * transcript filename for Claude Code.
  * @public
  */
-declare const ConversationId: Schema.brand<Schema.String, "ConversationId">;
+export declare const ConversationId: Schema.brand<Schema.String, "ConversationId">;
 /** @public */
-type ConversationId = Schema.Schema.Type<typeof ConversationId>;
+export type ConversationId = Schema.Schema.Type<typeof ConversationId>;
 /**
  * The agent host process's chat id (Claude Code's per-process chat
  * UUID, etc.). Shorter-lived than a conversation; one conversation can
@@ -1453,17 +1585,17 @@ type ConversationId = Schema.Schema.Type<typeof ConversationId>;
  * `sessions.id` (the SQLite agent-run PK).
  * @public
  */
-declare const ChatId: Schema.brand<Schema.String, "ChatId">;
+export declare const ChatId: Schema.brand<Schema.String, "ChatId">;
 /** @public */
-type ChatId = Schema.Schema.Type<typeof ChatId>;
+export type ChatId = Schema.Schema.Type<typeof ChatId>;
 /**
  * One TDD orchestration task. Replaces the legacy `tdd_session_id`
  * vocabulary so "session" is unambiguous in the codebase.
  * @public
  */
-declare const TddTaskId: Schema.brand<Schema.String, "TddTaskId">;
+export declare const TddTaskId: Schema.brand<Schema.String, "TddTaskId">;
 /** @public */
-type TddTaskId = Schema.Schema.Type<typeof TddTaskId>;
+export type TddTaskId = Schema.Schema.Type<typeof TddTaskId>;
 /**
  * Filesystem-safe key for the per-project data store directory under
  * `$XDG_DATA_HOME/vitest-agent/<projectKey>/`. Resolved by the
@@ -1472,9 +1604,9 @@ type TddTaskId = Schema.Schema.Type<typeof TddTaskId>;
  * value is `ProjectIdentityNotResolvableError`, not an empty string).
  * @public
  */
-declare const ProjectKey: Schema.brand<Schema.String, "ProjectKey">;
+export declare const ProjectKey: Schema.brand<Schema.String, "ProjectKey">;
 /** @public */
-type ProjectKey = Schema.Schema.Type<typeof ProjectKey>;
+export type ProjectKey = Schema.Schema.Type<typeof ProjectKey>;
 /**
  * Who initiated the action (test run, hypothesis, note, TDD phase, …).
  * Recorded on every action row alongside `agent_id`.
@@ -1484,9 +1616,9 @@ type ProjectKey = Schema.Schema.Type<typeof ProjectKey>;
  * - `system` — a CI run, scheduler, or other non-human/non-agent actor
  * @public
  */
-declare const ActorType: Schema.Literals<readonly ["agent", "user", "system"]>;
+export declare const ActorType: Schema.Literals<readonly ["agent", "user", "system"]>;
 /** @public */
-type ActorType = typeof ActorType.Type;
+export type ActorType = typeof ActorType.Type;
 /**
  * Recommended canonical host identifiers. Open enum at the SDK level so
  * a new client doesn't require an SDK release; the MCP server defaults
@@ -1497,9 +1629,9 @@ type ActorType = typeof ActorType.Type;
  * match a known pattern — preferred over guessing.
  * @public
  */
-declare const HostKind: Schema.Literals<readonly ["claude-code", "claude-desktop", "cursor", "goose", "chatgpt", "mcp-inspector", "unknown"]>;
+export declare const HostKind: Schema.Literals<readonly ["claude-code", "claude-desktop", "cursor", "goose", "chatgpt", "mcp-inspector", "unknown"]>;
 /** @public */
-type HostKind = typeof HostKind.Type;
+export type HostKind = typeof HostKind.Type;
 //#endregion
 //#region src/errors/AgentErrors.d.ts
 declare const AgentNotFoundError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
@@ -1511,7 +1643,7 @@ declare const AgentNotFoundError_base: new <A extends Record<string, any> = {}>(
  * this agent first.
  * @public
  */
-declare class AgentNotFoundError extends AgentNotFoundError_base<{
+export declare class AgentNotFoundError extends AgentNotFoundError_base<{
   readonly agentId: AgentId;
   readonly chatId?: ChatId;
 }> {}
@@ -1523,7 +1655,7 @@ declare const SessionNotFoundError_base: new <A extends Record<string, any> = {}
  * probably hasn't fired the SessionStart equivalent for this chat yet.
  * @public
  */
-declare class SessionNotFoundError extends SessionNotFoundError_base<{
+export declare class SessionNotFoundError extends SessionNotFoundError_base<{
   readonly chatId: ChatId;
 }> {}
 declare const ConversationNotFoundError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
@@ -1534,7 +1666,7 @@ declare const ConversationNotFoundError_base: new <A extends Record<string, any>
  * require a conversation row.
  * @public
  */
-declare class ConversationNotFoundError extends ConversationNotFoundError_base<{
+export declare class ConversationNotFoundError extends ConversationNotFoundError_base<{
   readonly conversationId: ConversationId;
 }> {}
 declare const RegistrationConflictError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
@@ -1546,7 +1678,7 @@ declare const RegistrationConflictError_base: new <A extends Record<string, any>
  * caller named. Distinct from `IdempotencyHit`, which is a success.
  * @public
  */
-declare class RegistrationConflictError extends RegistrationConflictError_base<{
+export declare class RegistrationConflictError extends RegistrationConflictError_base<{
   readonly reason: string;
 }> {
   constructor(args: {
@@ -1562,7 +1694,7 @@ declare const HostMetadataParseError_base: new <A extends Record<string, any> =
  * paths that explicitly carry through `Schema.parseJson` errors.
  * @public
  */
-declare class HostMetadataParseError extends HostMetadataParseError_base<{
+export declare class HostMetadataParseError extends HostMetadataParseError_base<{
   readonly raw: string;
   readonly reason: string;
 }> {}
@@ -1574,7 +1706,7 @@ declare const SidecarTimeoutError_base: new <A extends Record<string, any> = {}>
  * `Effect.timeout`; the top-level wrapper maps it to exit code 2.
  * @public
  */
-declare class SidecarTimeoutError extends SidecarTimeoutError_base<{
+export declare class SidecarTimeoutError extends SidecarTimeoutError_base<{
   readonly operation: string;
   readonly timeoutMs: number;
 }> {
@@ -1592,7 +1724,7 @@ declare const DataStoreError_base: new <A extends Record<string, any> = {}>(args
  * Error raised when a SQLite operation fails at read, write, or migration time.
  * @public
  */
-declare class DataStoreError extends DataStoreError_base<{
+export declare class DataStoreError extends DataStoreError_base<{
   readonly operation: "read" | "write" | "migrate";
   readonly table: string;
   readonly reason: string;
@@ -1615,7 +1747,7 @@ declare class DataStoreError extends DataStoreError_base<{
  * circular `cause` references.
  * @public
  */
-declare const extractSqlReason: (e: unknown) => string;
+export declare const extractSqlReason: (e: unknown) => string;
 //#endregion
 //#region src/errors/DiscoveryError.d.ts
 declare const DiscoveryError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
@@ -1625,7 +1757,7 @@ declare const DiscoveryError_base: new <A extends Record<string, any> = {}>(args
  * Error raised when project discovery (glob, file read, or stat) fails.
  * @public
  */
-declare class DiscoveryError extends DiscoveryError_base<{
+export declare class DiscoveryError extends DiscoveryError_base<{
   readonly operation: "glob" | "read" | "stat";
   readonly path: string;
   readonly reason: string;
@@ -1651,7 +1783,7 @@ declare const PathResolutionError_base: new <A extends Record<string, any> = {}>
  * write to.
  * @public
  */
-declare class PathResolutionError extends PathResolutionError_base<{
+export declare class PathResolutionError extends PathResolutionError_base<{
   readonly reason: string;
 }> {
   constructor(args: {
@@ -1670,7 +1802,7 @@ declare class PathResolutionError extends PathResolutionError_base<{
  * "URL canonicalization rejected the value").
  * @public
  */
-interface ProjectIdentityCandidate {
+export interface ProjectIdentityCandidate {
   readonly source: string;
   readonly reason: string;
 }
@@ -1688,7 +1820,7 @@ declare const ProjectIdentityNotResolvableError_base: new <A extends Record<stri
  * went through the new resolver.
  * @public
  */
-declare class ProjectIdentityNotResolvableError extends ProjectIdentityNotResolvableError_base<{
+export declare class ProjectIdentityNotResolvableError extends ProjectIdentityNotResolvableError_base<{
   readonly tried: ReadonlyArray<ProjectIdentityCandidate>;
 }> {
   constructor(args: {
@@ -1709,7 +1841,7 @@ declare const GitCommandError_base: new <A extends Record<string, any> = {}>(arg
  * meaningfully recover from.
  * @public
  */
-declare class GitCommandError extends GitCommandError_base<{
+export declare class GitCommandError extends GitCommandError_base<{
   readonly command: string;
   readonly reason: string;
 }> {
@@ -1729,7 +1861,7 @@ declare const ProbeMissError_base: new <A extends Record<string, any> = {}>(args
  * probes).
  * @internal
  */
-declare class ProbeMissError extends ProbeMissError_base<{
+export declare class ProbeMissError extends ProbeMissError_base<{
   readonly probe: string;
 }> {}
 //#endregion
@@ -1738,7 +1870,7 @@ declare const GoalNotFoundError_base: new <A extends Record<string, any> = {}>(a
   readonly _tag: "GoalNotFoundError";
 } & Readonly<A>;
 /** @public */
-declare class GoalNotFoundError extends GoalNotFoundError_base<{
+export declare class GoalNotFoundError extends GoalNotFoundError_base<{
   readonly id: number;
   readonly reason: string;
 }> {
@@ -1751,7 +1883,7 @@ declare const BehaviorNotFoundError_base: new <A extends Record<string, any> = {
   readonly _tag: "BehaviorNotFoundError";
 } & Readonly<A>;
 /** @public */
-declare class BehaviorNotFoundError extends BehaviorNotFoundError_base<{
+export declare class BehaviorNotFoundError extends BehaviorNotFoundError_base<{
   readonly id: number;
   readonly reason: string;
 }> {
@@ -1764,7 +1896,7 @@ declare const TddTaskNotFoundError_base: new <A extends Record<string, any> = {}
   readonly _tag: "TddTaskNotFoundError";
 } & Readonly<A>;
 /** @public */
-declare class TddTaskNotFoundError extends TddTaskNotFoundError_base<{
+export declare class TddTaskNotFoundError extends TddTaskNotFoundError_base<{
   readonly id: number;
   readonly reason: string;
 }> {
@@ -1774,12 +1906,12 @@ declare class TddTaskNotFoundError extends TddTaskNotFoundError_base<{
   });
 }
 /** @public */
-type TddTaskEndOutcome = "succeeded" | "blocked" | "abandoned";
+export type TddTaskEndOutcome = "succeeded" | "blocked" | "abandoned";
 declare const TddTaskAlreadyEndedError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "TddTaskAlreadyEndedError";
 } & Readonly<A>;
 /** @public */
-declare class TddTaskAlreadyEndedError extends TddTaskAlreadyEndedError_base<{
+export declare class TddTaskAlreadyEndedError extends TddTaskAlreadyEndedError_base<{
   readonly id: number;
   readonly endedAt: string;
   readonly outcome: TddTaskEndOutcome;
@@ -1791,12 +1923,12 @@ declare class TddTaskAlreadyEndedError extends TddTaskAlreadyEndedError_base<{
   });
 }
 /** @public */
-type IllegalStatusTransitionEntity = "goal" | "behavior" | "task";
+export type IllegalStatusTransitionEntity = "goal" | "behavior" | "task";
 declare const IllegalStatusTransitionError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "IllegalStatusTransitionError";
 } & Readonly<A>;
 /** @public */
-declare class IllegalStatusTransitionError extends IllegalStatusTransitionError_base<{
+export declare class IllegalStatusTransitionError extends IllegalStatusTransitionError_base<{
   readonly entity: IllegalStatusTransitionEntity;
   readonly id: number;
   readonly from: string;
@@ -1814,15 +1946,15 @@ declare class IllegalStatusTransitionError extends IllegalStatusTransitionError_
 //#endregion
 //#region src/formatters/ci-annotations.d.ts
 /** @public */
-declare const ciAnnotationsFormatter: Formatter;
+export declare const ciAnnotationsFormatter: Formatter;
 //#endregion
 //#region src/formatters/gfm.d.ts
 /** @public */
-declare const GfmFormatter: Formatter;
+export declare const GfmFormatter: Formatter;
 //#endregion
 //#region src/formatters/json.d.ts
 /** @public */
-declare const JsonFormatter: Formatter;
+export declare const JsonFormatter: Formatter;
 //#endregion
 //#region src/formatters/markdown.d.ts
 /**
@@ -1836,15 +1968,15 @@ declare const JsonFormatter: Formatter;
  * Markdown-aware sink.
  * @public
  */
-declare const MarkdownFormatter: Formatter;
+export declare const MarkdownFormatter: Formatter;
 //#endregion
 //#region src/formatters/silent.d.ts
 /** @public */
-declare const SilentFormatter: Formatter;
+export declare const SilentFormatter: Formatter;
 //#endregion
 //#region src/formatters/terminal.d.ts
 /** @public */
-declare const TerminalFormatter: Formatter;
+export declare const TerminalFormatter: Formatter;
 //#endregion
 //#region src/schemas/Config.d.ts
 declare const VitestAgentConfig_base: Schema.Class<VitestAgentConfig, Schema.Struct<{
@@ -1869,7 +2001,7 @@ declare const VitestAgentConfig_base: Schema.Class<VitestAgentConfig, Schema.Str
  *   keying), or when you want a stable key independent of `name` changes.
  * @public
  */
-declare class VitestAgentConfig extends VitestAgentConfig_base {}
+export declare class VitestAgentConfig extends VitestAgentConfig_base {}
 //#endregion
 //#region src/services/Config.d.ts
 /**
@@ -1878,7 +2010,7 @@ declare class VitestAgentConfig extends VitestAgentConfig_base {}
  * type without referencing the `ConfigFileShape<A>` generic directly.
  * @public
  */
-type VitestAgentConfigFileService = ConfigFileShape<VitestAgentConfig>;
+export type VitestAgentConfigFileService = ConfigFileShape<VitestAgentConfig>;
 declare const VitestAgentConfigFile_base: import("effect/Context").ServiceClass<VitestAgentConfigFile, "vitest-agent/Config", ConfigFileShape<VitestAgentConfig>>;
 /**
  * Typed service class (Context tag) for the vitest-agent config file service.
@@ -1888,7 +2020,7 @@ declare const VitestAgentConfigFile_base: import("effect/Context").ServiceClass<
  * `ConfigLive(projectDir)`.
  * @public
  */
-declare class VitestAgentConfigFile extends VitestAgentConfigFile_base {}
+export declare class VitestAgentConfigFile extends VitestAgentConfigFile_base {}
 //#endregion
 //#region src/layers/ConfigLive.d.ts
 /**
@@ -1909,14 +2041,14 @@ declare class VitestAgentConfigFile extends VitestAgentConfigFile_base {}
  *   sees the right config even when invoked from elsewhere.
  * @public
  */
-declare const ConfigLive: (projectDir: string) => Layer.Layer<VitestAgentConfigFile, never, FileSystem.FileSystem | Path.Path>;
+export declare const ConfigLive: (projectDir: string) => Layer.Layer<VitestAgentConfigFile, never, FileSystem.FileSystem | Path.Path>;
 //#endregion
 //#region src/schemas/Baselines.d.ts
 /**
  * Coverage baselines -- the auto-ratcheting high-water mark.
  * @public
  */
-declare const CoverageBaselines: Schema.Struct<{
+export declare const CoverageBaselines: Schema.Struct<{
   readonly updatedAt: Schema.String;
   readonly global: Schema.Struct<{
     readonly lines: Schema.optional<Schema.Number>;
@@ -1929,17 +2061,23 @@ declare const CoverageBaselines: Schema.Struct<{
     readonly functions: Schema.optional<Schema.Number>;
     readonly branches: Schema.optional<Schema.Number>;
     readonly statements: Schema.optional<Schema.Number>;
+    readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+      readonly lines: Schema.optional<Schema.Number>;
+      readonly functions: Schema.optional<Schema.Number>;
+      readonly branches: Schema.optional<Schema.Number>;
+      readonly statements: Schema.optional<Schema.Number>;
+    }>]>>;
   }>]>>, never>;
 }>;
 /** @public */
-type CoverageBaselines = typeof CoverageBaselines.Type;
+export type CoverageBaselines = typeof CoverageBaselines.Type;
 //#endregion
 //#region src/schemas/CacheManifest.d.ts
 /**
  * A single project entry in the cache manifest.
  * @public
  */
-declare const CacheManifestEntry: Schema.Struct<{
+export declare const CacheManifestEntry: Schema.Struct<{
   readonly project: Schema.String;
   readonly reportFile: Schema.String;
   readonly historyFile: Schema.optional<Schema.String>;
@@ -1947,12 +2085,12 @@ declare const CacheManifestEntry: Schema.Struct<{
   readonly lastResult: Schema.NullOr<Schema.Literals<readonly ["passed", "failed", "interrupted"]>>;
 }>;
 /** @public */
-type CacheManifestEntry = typeof CacheManifestEntry.Type;
+export type CacheManifestEntry = typeof CacheManifestEntry.Type;
 /**
  * Root manifest file that indexes all project reports.
  * @public
  */
-declare const CacheManifest: Schema.Struct<{
+export declare const CacheManifest: Schema.Struct<{
   readonly updatedAt: Schema.String;
   readonly cacheDir: Schema.String;
   readonly projects: Schema.$Array<Schema.Struct<{
@@ -1964,24 +2102,24 @@ declare const CacheManifest: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type CacheManifest = typeof CacheManifest.Type;
+export type CacheManifest = typeof CacheManifest.Type;
 //#endregion
 //#region src/schemas/History.d.ts
 /**
  * A single test run outcome (pass or fail only).
  * @public
  */
-declare const TestRun: Schema.Struct<{
+export declare const TestRun: Schema.Struct<{
   readonly timestamp: Schema.String;
   readonly state: Schema.Literals<readonly ["passed", "failed"]>;
 }>;
 /** @public */
-type TestRun = typeof TestRun.Type;
+export type TestRun = typeof TestRun.Type;
 /**
  * History for a single test across multiple runs.
  * @public
  */
-declare const TestHistory: Schema.Struct<{
+export declare const TestHistory: Schema.Struct<{
   readonly modulePath: Schema.String;
   readonly fullName: Schema.String;
   readonly runs: Schema.$Array<Schema.Struct<{
@@ -1990,12 +2128,12 @@ declare const TestHistory: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type TestHistory = typeof TestHistory.Type;
+export type TestHistory = typeof TestHistory.Type;
 /**
  * Per-project history record containing all tracked tests.
  * @public
  */
-declare const HistoryRecord: Schema.Struct<{
+export declare const HistoryRecord: Schema.Struct<{
   readonly project: Schema.String;
   readonly updatedAt: Schema.String;
   readonly tests: Schema.$Array<Schema.Struct<{
@@ -2008,19 +2146,19 @@ declare const HistoryRecord: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type HistoryRecord = typeof HistoryRecord.Type;
+export type HistoryRecord = typeof HistoryRecord.Type;
 //#endregion
 //#region src/schemas/Tdd.d.ts
 /** @public */
-declare const GoalStatus: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+export declare const GoalStatus: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
 /** @public */
-type GoalStatus = typeof GoalStatus.Type;
+export type GoalStatus = typeof GoalStatus.Type;
 /** @public */
-declare const BehaviorStatus: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+export declare const BehaviorStatus: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
 /** @public */
-type BehaviorStatus = typeof BehaviorStatus.Type;
+export type BehaviorStatus = typeof BehaviorStatus.Type;
 /** @public */
-declare const GoalRow: Schema.Struct<{
+export declare const GoalRow: Schema.Struct<{
   readonly id: Schema.Number;
   readonly sessionId: Schema.Number;
   readonly ordinal: Schema.Number;
@@ -2029,9 +2167,9 @@ declare const GoalRow: Schema.Struct<{
   readonly createdAt: Schema.String;
 }>;
 /** @public */
-type GoalRow = typeof GoalRow.Type;
+export type GoalRow = typeof GoalRow.Type;
 /** @public */
-declare const BehaviorRow: Schema.Struct<{
+export declare const BehaviorRow: Schema.Struct<{
   readonly id: Schema.Number;
   readonly goalId: Schema.Number;
   readonly ordinal: Schema.Number;
@@ -2041,9 +2179,9 @@ declare const BehaviorRow: Schema.Struct<{
   readonly createdAt: Schema.String;
 }>;
 /** @public */
-type BehaviorRow = typeof BehaviorRow.Type;
+export type BehaviorRow = typeof BehaviorRow.Type;
 /** @public */
-declare const GoalDetail: Schema.Struct<{
+export declare const GoalDetail: Schema.Struct<{
   readonly id: Schema.Number;
   readonly sessionId: Schema.Number;
   readonly ordinal: Schema.Number;
@@ -2061,9 +2199,9 @@ declare const GoalDetail: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type GoalDetail = typeof GoalDetail.Type;
+export type GoalDetail = typeof GoalDetail.Type;
 /** @public */
-declare const BehaviorDetail: Schema.Struct<{
+export declare const BehaviorDetail: Schema.Struct<{
   readonly id: Schema.Number;
   readonly goalId: Schema.Number;
   readonly ordinal: Schema.Number;
@@ -2087,14 +2225,14 @@ declare const BehaviorDetail: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type BehaviorDetail = typeof BehaviorDetail.Type;
+export type BehaviorDetail = typeof BehaviorDetail.Type;
 //#endregion
 //#region src/schemas/Trends.d.ts
 /**
  * A single coverage trend data point recorded on a full test run.
  * @public
  */
-declare const TrendEntry: Schema.Struct<{
+export declare const TrendEntry: Schema.Struct<{
   readonly timestamp: Schema.String;
   readonly coverage: Schema.Struct<{
     readonly statements: Schema.Number;
@@ -2112,12 +2250,12 @@ declare const TrendEntry: Schema.Struct<{
   readonly targetsHash: Schema.optional<Schema.String>;
 }>;
 /** @public */
-type TrendEntry = typeof TrendEntry.Type;
+export type TrendEntry = typeof TrendEntry.Type;
 /**
  * Per-project trend record with sliding window of entries.
  * @public
  */
-declare const TrendRecord: Schema.Struct<{
+export declare const TrendRecord: Schema.Struct<{
   readonly entries: Schema.$Array<Schema.Struct<{
     readonly timestamp: Schema.String;
     readonly coverage: Schema.Struct<{
@@ -2137,13 +2275,13 @@ declare const TrendRecord: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type TrendRecord = typeof TrendRecord.Type;
+export type TrendRecord = typeof TrendRecord.Type;
 //#endregion
 //#region src/utils/validate-phase-transition.d.ts
 /** @public */
-type Phase = "spike" | "red" | "red.triangulate" | "green" | "green.fake-it" | "refactor" | "extended-red" | "green-without-red";
+export type Phase = "spike" | "red" | "red.triangulate" | "green" | "green.fake-it" | "refactor" | "extended-red" | "green-without-red";
 /** @public */
-type ArtifactKind = "test_written" | "test_failed_run" | "code_written" | "test_passed_run" | "refactor" | "test_weakened";
+export type ArtifactKind = "test_written" | "test_failed_run" | "code_written" | "test_passed_run" | "refactor" | "test_weakened";
 /**
  * Explicit test-runner marker on a `tdd_artifacts` row (issue #363). `vitest`
  * artifacts always carry a `test_case_id` when they anchor a specific test;
@@ -2152,9 +2290,9 @@ type ArtifactKind = "test_written" | "test_failed_run" | "code_written" | "test_
  * run-level artifact without weakening the vitest guard.
  * @public
  */
-type ArtifactSuite = "vitest" | "bats";
+export type ArtifactSuite = "vitest" | "bats";
 /** @public */
-interface CitedArtifact {
+export interface CitedArtifact {
   readonly id: number;
   /**
    * `tdd_phases.id` of the phase this artifact was actually recorded in — the
@@ -2181,7 +2319,7 @@ interface CitedArtifact {
   readonly suite?: ArtifactSuite;
 }
 /** @public */
-interface PhaseTransitionContext {
+export interface PhaseTransitionContext {
   readonly tdd_task_id: number;
   readonly current_phase: Phase;
   /**
@@ -2198,15 +2336,15 @@ interface PhaseTransitionContext {
   readonly requested_behavior_id: number | null;
 }
 /** @public */
-type DenialReason = "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";
+export type DenialReason = "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";
 /** @public */
-interface Remediation {
+export interface Remediation {
   readonly suggestedTool: string;
   readonly suggestedArgs: Record<string, unknown>;
   readonly humanHint: string;
 }
 /** @public */
-type PhaseTransitionResult = {
+export type PhaseTransitionResult = {
   readonly accepted: true;
   readonly phase: Phase;
 } | {
@@ -2225,7 +2363,7 @@ type PhaseTransitionResult = {
  * required artifact (`spike→red`, `*→red`, etc.) return `null`.
  * @public
  */
-declare const requiredArtifactForTransition: (from: Phase, to: Phase) => {
+export declare const requiredArtifactForTransition: (from: Phase, to: Phase) => {
   kind: ArtifactKind;
   humanHint: string;
 } | null;
@@ -2243,9 +2381,9 @@ declare const requiredArtifactForTransition: (from: Phase, to: Phase) => {
  * keeping the two in lockstep (issue #115).
  * @public
  */
-declare const transitionEnforcesBehaviorMatch: (from: Phase, to: Phase) => boolean;
+export declare const transitionEnforcesBehaviorMatch: (from: Phase, to: Phase) => boolean;
 /** @public */
-declare const validatePhaseTransition: (ctx: PhaseTransitionContext) => PhaseTransitionResult;
+export declare const validatePhaseTransition: (ctx: PhaseTransitionContext) => PhaseTransitionResult;
 //#endregion
 //#region src/schemas/Agent.d.ts
 declare const Agent_base: Schema.Class<Agent, Schema.TaggedStruct<"Agent", {
@@ -2271,7 +2409,7 @@ declare const Agent_base: Schema.Class<Agent, Schema.TaggedStruct<"Agent", {
  * two reveals a mid-session branch switch, which is itself signal.
  * @public
  */
-declare class Agent extends Agent_base {}
+export declare class Agent extends Agent_base {}
 declare const IdempotencyHit_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => Readonly<A> & {
   readonly _tag: "IdempotencyHit";
 } & import("effect/Pipeable").Pipeable;
@@ -2286,46 +2424,46 @@ declare const IdempotencyHit_base: new <A extends Record<string, any> = {}>(args
  * downstream code uses `Match.tag` to branch.
  * @public
  */
-declare class IdempotencyHit extends IdempotencyHit_base<{
+export declare class IdempotencyHit extends IdempotencyHit_base<{
   readonly existingAgentId: typeof AgentId.Type;
 }> {}
 /**
  * Sum type of the two possible outcomes of `registerAgent`.
  * @public
  */
-type RegisterAgentResult = Agent | IdempotencyHit;
+export type RegisterAgentResult = Agent | IdempotencyHit;
 /**
  * Agent tree — root agent with all descendants nested under
  * `children`. Returned by `DataStore.getAgentTree` for forensics and
  * the `vitest-agent agent list` CLI subcommand.
  * @public
  */
-interface AgentTreeNode {
+export interface AgentTreeNode {
   readonly agent: Agent;
   readonly children: ReadonlyArray<AgentTreeNode>;
 }
 //#endregion
 //#region src/services/DataStore.d.ts
 /** @public */
-interface CreateGoalInput {
+export interface CreateGoalInput {
   readonly tddTaskId: number;
   readonly goal: string;
 }
 /** @public */
-interface UpdateGoalInput {
+export interface UpdateGoalInput {
   readonly id: number;
   readonly goal?: string;
   readonly status?: GoalStatus;
 }
 /** @public */
-interface CreateBehaviorInput {
+export interface CreateBehaviorInput {
   readonly goalId: number;
   readonly behavior: string;
   readonly suggestedTestName?: string;
   readonly dependsOnBehaviorIds?: ReadonlyArray<number>;
 }
 /** @public */
-interface UpdateBehaviorInput {
+export interface UpdateBehaviorInput {
   readonly id: number;
   readonly behavior?: string;
   readonly suggestedTestName?: string | null;
@@ -2333,7 +2471,7 @@ interface UpdateBehaviorInput {
   readonly dependsOnBehaviorIds?: ReadonlyArray<number>;
 }
 /** @public */
-interface SettingsInput {
+export interface SettingsInput {
   readonly vitestVersion: string;
   readonly pool?: string;
   readonly environment?: string;
@@ -2350,7 +2488,7 @@ interface SettingsInput {
   readonly coverageProvider?: string;
 }
 /** @public */
-interface TestRunInput {
+export interface TestRunInput {
   readonly invocationId: string;
   readonly project: string;
   readonly settingsHash: string;
@@ -2402,7 +2540,7 @@ interface TestRunInput {
   readonly hostMetadata?: Record<string, unknown> | null;
 }
 /** @public */
-interface ModuleInput {
+export interface ModuleInput {
   readonly fileId: number;
   readonly relativeModuleId: string;
   readonly state: string;
@@ -2414,7 +2552,7 @@ interface ModuleInput {
   readonly heap?: number;
 }
 /** @public */
-interface TestCaseInput {
+export interface TestCaseInput {
   readonly suiteId?: number;
   readonly vitestId?: string;
   readonly name: string;
@@ -2446,7 +2584,7 @@ interface TestCaseInput {
   readonly createdTurnId?: number;
 }
 /** @public */
-interface StackFrameInput {
+export interface StackFrameInput {
   readonly ordinal: number;
   readonly method: string | null;
   readonly filePath: string;
@@ -2456,7 +2594,7 @@ interface StackFrameInput {
   readonly functionBoundaryLine?: number;
 }
 /** @public */
-interface TestErrorInput {
+export interface TestErrorInput {
   readonly testCaseId?: number;
   readonly testSuiteId?: number;
   readonly moduleId?: number;
@@ -2472,8 +2610,50 @@ interface TestErrorInput {
   readonly frames?: ReadonlyArray<StackFrameInput>;
   readonly ordinal?: number;
 }
+/**
+ * Ceiling on an inline attachment body. Vitest has already copied file
+ * attachments into `.vitest/attachments/`, so a large body is referenced
+ * by `path` rather than duplicated into `data.db`.
+ * @public
+ */
+export declare const INLINE_ATTACHMENT_BODY_CAP_BYTES: number;
+/** @public */
+export interface TestAttachmentInput {
+  readonly contentType?: string;
+  /** Post-resolution path under `.vitest/attachments/`, or an http(s) URL. */
+  readonly path?: string;
+  /** Inline body; persisted only when `byteSize` is under the 64 KiB cap. */
+  readonly body?: string;
+  /** How to read `body`. Vitest treats a string body as base64 unless `"utf-8"`. */
+  readonly bodyEncoding?: "base64" | "utf-8";
+  readonly byteSize: number;
+}
+/** @public */
+export interface TestAnnotationInput {
+  readonly testCaseId: number;
+  /** Arbitrary Vitest annotation type -- not an enum. */
+  readonly type: string;
+  readonly message: string;
+  readonly locationFile?: string;
+  readonly locationLine?: number;
+  readonly locationColumn?: number;
+  readonly attachments?: ReadonlyArray<TestAttachmentInput>;
+}
+/** @public */
+export interface TestArtifactInput {
+  readonly testCaseId: number;
+  /** `pkg:name`; `internal:` types are Vitest's own and are never written. */
+  readonly type: string;
+  readonly message?: string;
+  /** JSON of the artifact's custom fields, minus attachments and location. */
+  readonly data?: string;
+  readonly locationFile?: string;
+  readonly locationLine?: number;
+  readonly locationColumn?: number;
+  readonly attachments?: ReadonlyArray<TestAttachmentInput>;
+}
 /** @public */
-interface FileCoverageInput {
+export interface FileCoverageInput {
   readonly fileId: number;
   readonly statements: number;
   readonly branches: number;
@@ -2493,7 +2673,7 @@ interface FileCoverageInput {
   readonly tier?: "below_threshold" | "below_target";
 }
 /** @public */
-interface SuiteInput {
+export interface SuiteInput {
   readonly parentSuiteId?: number;
   readonly name: string;
   readonly fullName: string;
@@ -2507,7 +2687,7 @@ interface SuiteInput {
   readonly locationColumn?: number;
 }
 /** @public */
-interface NoteInput {
+export interface NoteInput {
   readonly title: string;
   readonly content: string;
   readonly scope: "global" | "project" | "module" | "suite" | "test" | "note";
@@ -2520,7 +2700,7 @@ interface NoteInput {
   readonly pinned?: boolean;
 }
 /** @public */
-interface SessionInput {
+export interface SessionInput {
   readonly chatId: string;
   readonly project: string;
   readonly cwd: string;
@@ -2538,7 +2718,7 @@ interface SessionInput {
   readonly conversationId?: string;
 }
 /** @public */
-interface TurnInput {
+export interface TurnInput {
   readonly sessionId: number;
   /** When omitted, writeTurn computes MAX(turnNo) + 1 for the session. */
   readonly turnNo?: number;
@@ -2547,13 +2727,13 @@ interface TurnInput {
   readonly occurredAt: string;
 }
 /** @public */
-interface FailureSignatureWriteInput {
+export interface FailureSignatureWriteInput {
   readonly signatureHash: string;
   readonly runId: number;
   readonly seenAt: string;
 }
 /** @public */
-interface HypothesisInput {
+export interface HypothesisInput {
   readonly sessionId: number;
   readonly content: string;
   readonly createdTurnId?: number;
@@ -2561,21 +2741,21 @@ interface HypothesisInput {
   readonly citedStackFrameId?: number;
 }
 /** @public */
-interface ValidateHypothesisInput {
+export interface ValidateHypothesisInput {
   readonly id: number;
   readonly outcome: "confirmed" | "refuted" | "abandoned";
   readonly validatedTurnId?: number;
   readonly validatedAt: string;
 }
 /** @public */
-interface IdempotentResponseInput {
+export interface IdempotentResponseInput {
   readonly procedurePath: string;
   readonly key: string;
   readonly resultJson: string;
   readonly createdAt: string;
 }
 /** @public */
-interface TddTaskInput {
+export interface TddTaskInput {
   readonly sessionId: number;
   readonly goal: string;
   readonly startedAt: string;
@@ -2583,14 +2763,14 @@ interface TddTaskInput {
   readonly runId?: string;
 }
 /** @public */
-interface EndTddTaskInput {
+export interface EndTddTaskInput {
   readonly id: number;
   readonly endedAt: string;
   readonly outcome: "succeeded" | "blocked" | "abandoned";
   readonly summaryNoteId?: number;
 }
 /** @public */
-interface WriteTddPhaseInput {
+export interface WriteTddPhaseInput {
   readonly tddTaskId: number;
   readonly behaviorId?: number;
   readonly phase: Phase;
@@ -2599,12 +2779,12 @@ interface WriteTddPhaseInput {
   readonly parentPhaseId?: number;
 }
 /** @public */
-interface WriteTddPhaseOutput {
+export interface WriteTddPhaseOutput {
   readonly id: number;
   readonly previousPhaseId: number | null;
 }
 /** @public */
-interface WriteTddArtifactInput {
+export interface WriteTddArtifactInput {
   readonly phaseId: number;
   readonly artifactKind: ArtifactKind;
   readonly fileId?: number;
@@ -2617,7 +2797,7 @@ interface WriteTddArtifactInput {
   readonly suite?: ArtifactSuite;
 }
 /** @public */
-interface WriteCommitInput {
+export interface WriteCommitInput {
   readonly sha: string;
   readonly parentSha?: string;
   readonly message?: string;
@@ -2626,20 +2806,20 @@ interface WriteCommitInput {
   readonly branch?: string;
 }
 /** @public */
-type ChangeKind = "added" | "modified" | "deleted" | "renamed" | "untracked-modified";
+export type ChangeKind = "added" | "modified" | "deleted" | "renamed" | "untracked-modified";
 /** @public */
-interface RunChangedFile {
+export interface RunChangedFile {
   readonly filePath: string;
   readonly changeKind: ChangeKind;
   readonly commitSha?: string;
 }
 /** @public */
-interface WriteRunChangedFilesInput {
+export interface WriteRunChangedFilesInput {
   readonly runId: number;
   readonly files: ReadonlyArray<RunChangedFile>;
 }
 /** @public */
-type RunInvocationMethod = "bash" | "mcp" | "cli";
+export type RunInvocationMethod = "bash" | "mcp" | "cli";
 /**
  * Input to `DataStore.registerAgent`.
  *
@@ -2653,7 +2833,7 @@ type RunInvocationMethod = "bash" | "mcp" | "cli";
  * same row.
  * @public
  */
-interface RegisterAgentInput {
+export interface RegisterAgentInput {
   readonly sessionId: number;
   readonly agentType: string;
   readonly parentAgentId: string | null;
@@ -2675,7 +2855,7 @@ interface RegisterAgentInput {
   readonly agentId?: string;
 }
 /** @public */
-interface AssociateRunSessionInput {
+export interface AssociateRunSessionInput {
   readonly chatId: string;
   readonly invocationMethod: RunInvocationMethod;
 }
@@ -2686,6 +2866,17 @@ declare const DataStore_base: Context.ServiceClass<DataStore, "vitest-agent/Data
   readonly writeSuites: (moduleId: number, suites: ReadonlyArray<SuiteInput>) => Effect.Effect<ReadonlyArray<number>, DataStoreError>;
   readonly writeTestCases: (moduleId: number, tests: ReadonlyArray<TestCaseInput>) => Effect.Effect<ReadonlyArray<number>, DataStoreError>;
   readonly writeErrors: (runId: number, errors: ReadonlyArray<TestErrorInput>) => Effect.Effect<void, DataStoreError>;
+  /**
+   * Persist `context.annotate` notes and their attachment descriptors.
+   * `runId` is carried for log correlation only -- `test_annotations`
+   * rows are reachable through `test_cases`.
+   */
+  readonly writeAnnotations: (runId: number, annotations: ReadonlyArray<TestAnnotationInput>) => Effect.Effect<void, DataStoreError>;
+  /**
+   * Persist `recordArtifact` payloads and their attachment
+   * descriptors. `runId` is carried for log correlation only.
+   */
+  readonly writeArtifacts: (runId: number, artifacts: ReadonlyArray<TestArtifactInput>) => Effect.Effect<void, DataStoreError>;
   readonly writeCoverage: (runId: number, coverage: ReadonlyArray<FileCoverageInput>) => Effect.Effect<void, DataStoreError>;
   readonly writeHistory: (project: string, fullName: string, modulePath: string, runId: number, timestamp: string, state: string, duration: number | null, flaky: boolean, retryCount: number, errorMessage: string | null) => Effect.Effect<void, DataStoreError>;
   readonly writeBaselines: (baselines: CoverageBaselines) => Effect.Effect<void, DataStoreError>;
@@ -2783,11 +2974,11 @@ declare const DataStore_base: Context.ServiceClass<DataStore, "vitest-agent/Data
   readonly endAgent: (agentId: string, endedAt: number) => Effect.Effect<void, AgentNotFoundError | DataStoreError>;
 }>;
 /** @public */
-declare class DataStore extends DataStore_base {}
+export declare class DataStore extends DataStore_base {}
 //#endregion
 //#region src/services/DataReader.d.ts
 /** @public */
-interface ProjectRunSummary {
+export interface ProjectRunSummary {
   readonly project: string;
   readonly lastRun: string | null;
   readonly lastResult: "passed" | "failed" | "interrupted" | null;
@@ -2797,7 +2988,7 @@ interface ProjectRunSummary {
   readonly skipped: number;
 }
 /** @public */
-interface FlakyTest {
+export interface FlakyTest {
   readonly fullName: string;
   readonly modulePath: string;
   readonly project: string;
@@ -2807,7 +2998,7 @@ interface FlakyTest {
   readonly lastTimestamp: string;
 }
 /** @public */
-interface PersistentFailure {
+export interface PersistentFailure {
   readonly fullName: string;
   readonly modulePath: string;
   readonly project: string;
@@ -2817,7 +3008,7 @@ interface PersistentFailure {
   readonly lastErrorMessage: string | null;
 }
 /** @public */
-interface TestError {
+export interface TestError {
   /** `test_errors.id` — required by `hypothesis (action: record).citedTestErrorId`. */
   readonly id: number;
   /**
@@ -2837,7 +3028,7 @@ interface TestError {
   readonly moduleFile: string | null;
 }
 /** @public */
-interface NoteRow {
+export interface NoteRow {
   readonly id: number;
   readonly title: string;
   readonly content: string;
@@ -2853,7 +3044,7 @@ interface NoteRow {
   readonly updatedAt: string;
 }
 /** @public */
-interface SettingsRow {
+export interface SettingsRow {
   readonly hash: string;
   readonly reporters: string | null;
   readonly coverageEnabled: boolean;
@@ -2868,7 +3059,7 @@ interface SettingsRow {
   readonly capturedAt: string;
 }
 /** @public */
-interface TestListEntry {
+export interface TestListEntry {
   readonly id: number;
   readonly fullName: string;
   readonly state: string;
@@ -2877,7 +3068,7 @@ interface TestListEntry {
   readonly classification: string | null;
 }
 /** @public */
-interface ModuleListEntry {
+export interface ModuleListEntry {
   readonly id: number;
   readonly file: string;
   readonly state: string;
@@ -2885,7 +3076,7 @@ interface ModuleListEntry {
   readonly duration: number | null;
 }
 /** @public */
-interface SuiteListEntry {
+export interface SuiteListEntry {
   readonly id: number;
   readonly name: string;
   readonly module: string;
@@ -2893,12 +3084,12 @@ interface SuiteListEntry {
   readonly testCount: number;
 }
 /** @public */
-interface SettingsListEntry {
+export interface SettingsListEntry {
   readonly hash: string;
   readonly capturedAt: string;
 }
 /** @public */
-interface SessionDetail {
+export interface SessionDetail {
   readonly id: number;
   readonly chatId: string;
   readonly project: string;
@@ -2914,7 +3105,7 @@ interface SessionDetail {
   readonly conversationId: string | null;
 }
 /** @public */
-interface TurnSummary {
+export interface TurnSummary {
   readonly id: number;
   readonly sessionId: number;
   readonly turnNo: number;
@@ -2923,7 +3114,7 @@ interface TurnSummary {
   readonly occurredAt: string;
 }
 /** @public */
-interface HistoryQueryOptions {
+export interface HistoryQueryOptions {
   /** Exact `full_name` match — narrows to a single test's history. */
   readonly testName?: string;
   /** Exact `module_path` match — narrows to tests in one file. */
@@ -2941,7 +3132,7 @@ interface HistoryQueryOptions {
  *
  * @public
  */
-interface ClassificationQueryOptions {
+export interface ClassificationQueryOptions {
   /** Exact `full_name` match — narrows to a single test's classification. */
   readonly testName?: string;
   /** Exact `module_path` match — narrows to tests in one file. */
@@ -2954,19 +3145,19 @@ interface ClassificationQueryOptions {
  *
  * @public
  */
-interface TestLookupOptions {
+export interface TestLookupOptions {
   /** Exact `module_path` match — picks one variant of an ambiguous `full_name`. */
   readonly modulePath?: string;
 }
 /** @public */
-interface TurnSearchOptions {
+export interface TurnSearchOptions {
   readonly sessionId?: number;
   readonly type?: string;
   readonly since?: string;
   readonly limit?: number;
 }
 /** @public */
-interface AcceptanceMetrics {
+export interface AcceptanceMetrics {
   readonly phaseEvidenceIntegrity: {
     total: number;
     compliant: number;
@@ -2989,7 +3180,7 @@ interface AcceptanceMetrics {
   };
 }
 /** @public */
-interface FailureSignatureDetail {
+export interface FailureSignatureDetail {
   readonly signatureHash: string;
   readonly firstSeenRunId: number | null;
   readonly firstSeenAt: string;
@@ -3002,7 +3193,7 @@ interface FailureSignatureDetail {
   }>;
 }
 /** @public */
-interface TddPhaseDetail {
+export interface TddPhaseDetail {
   readonly id: number;
   readonly behaviorId: number | null;
   readonly phase: string;
@@ -3011,7 +3202,7 @@ interface TddPhaseDetail {
   readonly transitionReason: string | null;
 }
 /** @public */
-interface TddArtifactDetail {
+export interface TddArtifactDetail {
   readonly id: number;
   readonly phaseId: number;
   readonly artifactKind: string;
@@ -3020,7 +3211,7 @@ interface TddArtifactDetail {
   readonly recordedAt: string;
 }
 /** @public */
-interface TddTaskDetail {
+export interface TddTaskDetail {
   readonly id: number;
   readonly sessionId: number;
   readonly goal: string;
@@ -3033,18 +3224,18 @@ interface TddTaskDetail {
   readonly artifacts: ReadonlyArray<TddArtifactDetail>;
 }
 /** @public */
-interface CurrentTddPhase {
+export interface CurrentTddPhase {
   readonly id: number;
   readonly phase: Phase;
   readonly startedAt: string;
   readonly behaviorId: number | null;
 }
 /** @public */
-interface CitedArtifactRow extends CitedArtifact {
+export interface CitedArtifactRow extends CitedArtifact {
   readonly phase_id: number;
 }
 /** @public */
-interface CommitChangesEntry {
+export interface CommitChangesEntry {
   readonly sha: string;
   readonly parentSha: string | null;
   readonly message: string | null;
@@ -3057,7 +3248,7 @@ interface CommitChangesEntry {
   }>;
 }
 /** @public */
-interface HypothesisDetail {
+export interface HypothesisDetail {
   readonly id: number;
   readonly sessionId: number;
   readonly content: string;
@@ -3067,7 +3258,7 @@ interface HypothesisDetail {
   readonly validatedAt: string | null;
 }
 /** @public */
-interface TddTaskSummary {
+export interface TddTaskSummary {
   readonly id: number;
   readonly sessionId: number;
   readonly goal: string;
@@ -3082,7 +3273,7 @@ interface TddTaskSummary {
  *
  * @public
  */
-interface TddArtifactRow {
+export interface TddArtifactRow {
   readonly id: number;
   readonly tddTaskId: number;
   readonly phaseId: number;
@@ -3096,7 +3287,7 @@ interface TddArtifactRow {
   readonly suite: ArtifactSuite;
 }
 /** @public */
-interface TagInventoryRow {
+export interface TagInventoryRow {
   /** The tag name (e.g. `"int"`, `"e2e"`, `"unit"`). */
   readonly tag: string;
   /** The Vitest project this tag was observed in. */
@@ -3111,6 +3302,45 @@ interface TagInventoryRow {
    */
   readonly testCount: number;
 }
+/** @public */
+export interface TestArtifactQueryOptions {
+  /** Disambiguates a fullName that exists in more than one module. */
+  readonly modulePath?: string;
+}
+/** @public */
+export interface PersistedAttachment {
+  readonly contentType?: string;
+  readonly path?: string;
+  readonly body?: string;
+  /** How to read `body`. Absent when nothing was stored inline. */
+  readonly bodyEncoding?: "base64" | "utf-8";
+  readonly byteSize: number | null;
+}
+/** @public */
+export interface TestAnnotationRow {
+  readonly id: number;
+  readonly type: string;
+  readonly message: string;
+  readonly location?: {
+    readonly file: string;
+    readonly line: number;
+    readonly column: number;
+  };
+  readonly attachments: ReadonlyArray<PersistedAttachment>;
+}
+/** @public */
+export interface TestArtifactRow {
+  readonly id: number;
+  readonly type: string;
+  readonly message: string | null;
+  readonly data: string | null;
+  readonly location?: {
+    readonly file: string;
+    readonly line: number;
+    readonly column: number;
+  };
+  readonly attachments: ReadonlyArray<PersistedAttachment>;
+}
 declare const DataReader_base: Context.ServiceClass<DataReader, "vitest-agent/DataReader", {
   readonly getLatestRun: (project: string) => Effect.Effect<Option.Option<AgentReport>, DataStoreError>;
   readonly getRunsByProject: () => Effect.Effect<ReadonlyArray<ProjectRunSummary>, DataStoreError>;
@@ -3123,6 +3353,10 @@ declare const DataReader_base: Context.ServiceClass<DataReader, "vitest-agent/Da
   readonly getCoverage: (project: string) => Effect.Effect<Option.Option<CoverageReport>, DataStoreError>;
   readonly getTestsForFile: (filePath: string) => Effect.Effect<ReadonlyArray<string>, DataStoreError>;
   readonly getErrors: (project: string, errorName?: string) => Effect.Effect<ReadonlyArray<TestError>, DataStoreError>;
+  /** Annotations recorded for a test in the project's latest run. */
+  readonly getAnnotationsForTest: (project: string, fullName: string, options?: TestArtifactQueryOptions) => Effect.Effect<ReadonlyArray<TestAnnotationRow>, DataStoreError>;
+  /** Artifacts recorded for a test in the project's latest run. */
+  readonly getArtifactsForTest: (project: string, fullName: string, options?: TestArtifactQueryOptions) => Effect.Effect<ReadonlyArray<TestArtifactRow>, DataStoreError>;
   readonly getNotes: (scope?: string, project?: string, testFullName?: string) => Effect.Effect<ReadonlyArray<NoteRow>, DataStoreError>;
   readonly getNoteById: (id: number) => Effect.Effect<Option.Option<NoteRow>, DataStoreError>;
   readonly searchNotes: (query: string) => Effect.Effect<ReadonlyArray<NoteRow>, DataStoreError>;
@@ -3271,19 +3505,19 @@ declare const DataReader_base: Context.ServiceClass<DataReader, "vitest-agent/Da
   }) => Effect.Effect<ReadonlyArray<TestListEntry>, DataStoreError>;
 }>;
 /** @public */
-declare class DataReader extends DataReader_base {}
+export declare class DataReader extends DataReader_base {}
 //#endregion
 //#region src/layers/DataReaderLive.d.ts
 /** @public */
-declare const DataReaderLive: Layer.Layer<DataReader, never, SqlClient>;
+export declare const DataReaderLive: Layer.Layer<DataReader, never, SqlClient>;
 //#endregion
 //#region src/layers/DataStoreLive.d.ts
 /** @public */
-declare const DataStoreLive: Layer.Layer<DataStore, never, SqlClient>;
+export declare const DataStoreLive: Layer.Layer<DataStore, never, SqlClient>;
 //#endregion
 //#region src/services/DetailResolver.d.ts
 /** @public */
-interface RunHealth {
+export interface RunHealth {
   readonly hasFailures: boolean;
   readonly belowTargets: boolean;
   readonly hasTargets?: boolean;
@@ -3292,11 +3526,11 @@ declare const DetailResolver_base: Context.ServiceClass<DetailResolver, "vitest-
   readonly resolve: (executor: Executor, health: RunHealth, explicit?: DetailLevel) => Effect.Effect<DetailLevel>;
 }>;
 /** @public */
-declare class DetailResolver extends DetailResolver_base {}
+export declare class DetailResolver extends DetailResolver_base {}
 //#endregion
 //#region src/layers/DetailResolverLive.d.ts
 /** @public */
-declare const DetailResolverLive: Layer.Layer<DetailResolver, never, never>;
+export declare const DetailResolverLive: Layer.Layer<DetailResolver, never, never>;
 //#endregion
 //#region src/services/DiscoveryRegistry.d.ts
 /**
@@ -3304,7 +3538,7 @@ declare const DetailResolverLive: Layer.Layer<DetailResolver, never, never>;
  *
  * @public
  */
-interface KnownProjectInput {
+export interface KnownProjectInput {
   readonly projectKey: string;
   readonly canonicalForm: string;
   readonly dataDbPath: string;
@@ -3316,7 +3550,7 @@ interface KnownProjectInput {
  *
  * @public
  */
-interface KnownProject {
+export interface KnownProject {
   readonly projectKey: string;
   readonly canonicalForm: string;
   readonly dataDbPath: string;
@@ -3345,11 +3579,11 @@ declare const DiscoveryRegistry_base: Context.ServiceClass<DiscoveryRegistry, "v
   readonly prune: (maxAgeDays: number) => Effect.Effect<number, DataStoreError>;
 }>;
 /** @public */
-declare class DiscoveryRegistry extends DiscoveryRegistry_base {}
+export declare class DiscoveryRegistry extends DiscoveryRegistry_base {}
 //#endregion
 //#region src/layers/DiscoveryRegistryLive.d.ts
 /** @public */
-declare const DiscoveryRegistryLive: Layer.Layer<DiscoveryRegistry, never, SqlClient>;
+export declare const DiscoveryRegistryLive: Layer.Layer<DiscoveryRegistry, never, SqlClient>;
 //#endregion
 //#region src/services/EnvironmentDetector.d.ts
 declare const EnvironmentDetector_base: Context.ServiceClass<EnvironmentDetector, "vitest-agent/EnvironmentDetector", {
@@ -3358,15 +3592,15 @@ declare const EnvironmentDetector_base: Context.ServiceClass<EnvironmentDetector
   readonly agentName: Effect.Effect<string | undefined>;
 }>;
 /** @public */
-declare class EnvironmentDetector extends EnvironmentDetector_base {}
+export declare class EnvironmentDetector extends EnvironmentDetector_base {}
 //#endregion
 //#region src/layers/EnvironmentDetectorLive.d.ts
 /** @public */
-declare const EnvironmentDetectorLive: Layer.Layer<EnvironmentDetector>;
+export declare const EnvironmentDetectorLive: Layer.Layer<EnvironmentDetector>;
 //#endregion
 //#region src/layers/EnvironmentDetectorTest.d.ts
 /** @public */
-declare const EnvironmentDetectorTest: {
+export declare const EnvironmentDetectorTest: {
   layer: (env?: Environment) => Layer.Layer<EnvironmentDetector, never, never>;
 };
 //#endregion
@@ -3375,18 +3609,18 @@ declare const ExecutorResolver_base: Context.ServiceClass<ExecutorResolver, "vit
   readonly resolve: (env: Environment) => Effect.Effect<Executor>;
 }>;
 /** @public */
-declare class ExecutorResolver extends ExecutorResolver_base {}
+export declare class ExecutorResolver extends ExecutorResolver_base {}
 //#endregion
 //#region src/layers/ExecutorResolverLive.d.ts
 /** @public */
-declare const ExecutorResolverLive: Layer.Layer<ExecutorResolver, never, never>;
+export declare const ExecutorResolverLive: Layer.Layer<ExecutorResolver, never, never>;
 //#endregion
 //#region src/services/FormatSelector.d.ts
 declare const FormatSelector_base: Context.ServiceClass<FormatSelector, "vitest-agent/FormatSelector", {
   readonly select: (executor: Executor, explicitFormat?: OutputFormat, environment?: Environment) => Effect.Effect<OutputFormat>;
 }>;
 /** @public */
-declare class FormatSelector extends FormatSelector_base {}
+export declare class FormatSelector extends FormatSelector_base {}
 //#endregion
 //#region src/layers/FormatSelectorLive.d.ts
 /**
@@ -3401,14 +3635,14 @@ declare class FormatSelector extends FormatSelector_base {}
  *   for surfaces that *do* render it (MCP tools, GitHub step summary).
  * @public
  */
-declare const FormatSelectorLive: Layer.Layer<FormatSelector, never, never>;
+export declare const FormatSelectorLive: Layer.Layer<FormatSelector, never, never>;
 //#endregion
 //#region src/services/HistoryTracker.d.ts
 /**
  * Lightweight test outcome for history classification.
  * @public
  */
-interface TestOutcome {
+export interface TestOutcome {
   readonly modulePath: string;
   readonly fullName: string;
   readonly state: "passed" | "failed";
@@ -3424,7 +3658,7 @@ interface TestOutcome {
  * key exists to prevent.
  * @public
  */
-declare const historyKey: (modulePath: string, fullName: string) => string;
+export declare const historyKey: (modulePath: string, fullName: string) => string;
 declare const HistoryTracker_base: Context.ServiceClass<HistoryTracker, "vitest-agent/HistoryTracker", {
   readonly classify: (project: string, testOutcomes: ReadonlyArray<TestOutcome>, timestamp: string) => Effect.Effect<{
     history: HistoryRecord;
@@ -3432,22 +3666,22 @@ declare const HistoryTracker_base: Context.ServiceClass<HistoryTracker, "vitest-
   }, DataStoreError>;
 }>;
 /** @public */
-declare class HistoryTracker extends HistoryTracker_base {}
+export declare class HistoryTracker extends HistoryTracker_base {}
 //#endregion
 //#region src/layers/HistoryTrackerLive.d.ts
 /** @public */
-declare const HistoryTrackerLive: Layer.Layer<HistoryTracker, never, DataReader>;
+export declare const HistoryTrackerLive: Layer.Layer<HistoryTracker, never, DataReader>;
 //#endregion
 //#region src/layers/HistoryTrackerTest.d.ts
 /** @public */
-interface HistoryTrackerTestState {
+export interface HistoryTrackerTestState {
   readonly classifyCalls: Array<{
     project: string;
     timestamp: string;
   }>;
 }
 /** @public */
-declare const HistoryTrackerTest: {
+export declare const HistoryTrackerTest: {
   readonly empty: () => HistoryTrackerTestState;
   readonly layer: (state: HistoryTrackerTestState, cannedResult?: {
     history: HistoryRecord;
@@ -3465,29 +3699,29 @@ declare const HistoryTrackerTest: {
  * output.
  * @public
  */
-declare const LoggerLive: (level?: LogLevel.LogLevel, logFile?: string) => Layer.Layer<never>;
+export declare const LoggerLive: (level?: LogLevel.LogLevel, logFile?: string) => Layer.Layer<never>;
 /** @public */
-declare function resolveLogLevel(option?: string): LogLevel.LogLevel | undefined;
+export declare function resolveLogLevel(option?: string): LogLevel.LogLevel | undefined;
 /**
  * Resolve log file from option or environment variable.
  * @public
  */
-declare function resolveLogFile(option?: string): string | undefined;
+export declare function resolveLogFile(option?: string): string | undefined;
 //#endregion
 //#region src/layers/OutputPipelineLive.d.ts
 /** @public */
-declare const OutputPipelineLive: Layer.Layer<DetailResolver | EnvironmentDetector | ExecutorResolver | FormatSelector | OutputRenderer, never, never>;
+export declare const OutputPipelineLive: Layer.Layer<DetailResolver | EnvironmentDetector | ExecutorResolver | FormatSelector | OutputRenderer, never, never>;
 //#endregion
 //#region src/services/OutputRenderer.d.ts
 declare const OutputRenderer_base: Context.ServiceClass<OutputRenderer, "vitest-agent/OutputRenderer", {
   readonly render: (reports: ReadonlyArray<AgentReport>, format: OutputFormat, context: FormatterContext) => Effect.Effect<ReadonlyArray<RenderedOutput>>;
 }>;
 /** @public */
-declare class OutputRenderer extends OutputRenderer_base {}
+export declare class OutputRenderer extends OutputRenderer_base {}
 //#endregion
 //#region src/layers/OutputRendererLive.d.ts
 /** @public */
-declare const OutputRendererLive: Layer.Layer<OutputRenderer, never, never>;
+export declare const OutputRendererLive: Layer.Layer<OutputRenderer, never, never>;
 //#endregion
 //#region src/layers/PathResolutionLive.d.ts
 /**
@@ -3510,23 +3744,23 @@ declare const OutputRendererLive: Layer.Layer<OutputRenderer, never, never>;
  *   anchor the config file resolvers and workspace discovery.
  * @public
  */
-declare const PathResolutionLive: (projectDir: string) => Layer.Layer<AppDirs | VitestAgentConfigFile | WorkspaceDiscovery, import("@effected/xdg").XdgEnvError, import("effect/FileSystem").FileSystem | import("effect/Path").Path>;
+export declare const PathResolutionLive: (projectDir: string) => Layer.Layer<AppDirs | VitestAgentConfigFile | WorkspaceDiscovery, import("@effected/xdg").XdgEnvError, import("effect/FileSystem").FileSystem | import("effect/Path").Path>;
 //#endregion
 //#region src/services/PerClientSessionMap.d.ts
 /** @public */
-interface MapSessionInput {
+export interface MapSessionInput {
   readonly hostSessionId: string;
   readonly conversationId: string;
   readonly projectKey: string;
   readonly projectDir: string;
 }
 /** @public */
-interface MapSessionOutput {
+export interface MapSessionOutput {
   readonly mainAgentId: string;
   readonly conversationId: string;
 }
 /** @public */
-interface SessionContextRow {
+export interface SessionContextRow {
   readonly hostSessionId: string;
   readonly conversationId: string;
   readonly projectKey: string;
@@ -3558,7 +3792,7 @@ declare const PerClientSessionMapReader_base: Context.ServiceClass<PerClientSess
  * methods would be a type error.
  * @public
  */
-declare class PerClientSessionMapReader extends PerClientSessionMapReader_base {}
+export declare class PerClientSessionMapReader extends PerClientSessionMapReader_base {}
 declare const PerClientSessionMapWriter_base: Context.ServiceClass<PerClientSessionMapWriter, "vitest-agent/PerClientSessionMapWriter", {
   /**
    * Upsert a conversation row. Returns the canonical conversation_id
@@ -3595,7 +3829,7 @@ declare const PerClientSessionMapWriter_base: Context.ServiceClass<PerClientSess
  * one resolve.
  * @public
  */
-declare class PerClientSessionMapWriter extends PerClientSessionMapWriter_base {}
+export declare class PerClientSessionMapWriter extends PerClientSessionMapWriter_base {}
 //#endregion
 //#region src/layers/PerClientSessionMapLive.d.ts
 /**
@@ -3604,18 +3838,18 @@ declare class PerClientSessionMapWriter extends PerClientSessionMapWriter_base {
  * methods and never declares write methods.
  * @public
  */
-declare const PerClientSessionMapReaderLive: Layer.Layer<PerClientSessionMapReader, never, SqlClient>;
+export declare const PerClientSessionMapReaderLive: Layer.Layer<PerClientSessionMapReader, never, SqlClient>;
 /**
  * Read-write layer. Provides both write methods and the Reader's read
  * methods so the same layer instance satisfies callers of either
  * tag.
  * @public
  */
-declare const PerClientSessionMapWriterLive: Layer.Layer<PerClientSessionMapWriter | PerClientSessionMapReader, never, SqlClient>;
+export declare const PerClientSessionMapWriterLive: Layer.Layer<PerClientSessionMapWriter | PerClientSessionMapReader, never, SqlClient>;
 //#endregion
 //#region src/services/ProjectDiscovery.d.ts
 /** @public */
-interface TestFileEntry {
+export interface TestFileEntry {
   readonly testFile: string;
   readonly sourceFiles: ReadonlyArray<string>;
 }
@@ -3624,15 +3858,15 @@ declare const ProjectDiscovery_base: Context.ServiceClass<ProjectDiscovery, "vit
   readonly mapTestToSource: (testFile: string) => Effect.Effect<ReadonlyArray<string>, DiscoveryError>;
 }>;
 /** @public */
-declare class ProjectDiscovery extends ProjectDiscovery_base {}
+export declare class ProjectDiscovery extends ProjectDiscovery_base {}
 //#endregion
 //#region src/layers/ProjectDiscoveryLive.d.ts
 /** @public */
-declare const ProjectDiscoveryLive: Layer.Layer<ProjectDiscovery, never, FileSystem.FileSystem>;
+export declare const ProjectDiscoveryLive: Layer.Layer<ProjectDiscovery, never, FileSystem.FileSystem>;
 //#endregion
 //#region src/layers/ProjectDiscoveryTest.d.ts
 /** @public */
-declare const ProjectDiscoveryTest: {
+export declare const ProjectDiscoveryTest: {
   readonly layer: (entries: ReadonlyArray<TestFileEntry>) => Layer.Layer<ProjectDiscovery>;
 };
 //#endregion
@@ -3649,13 +3883,13 @@ declare const ProjectDiscoveryTest: {
  *   `vitest-agent doctor`-style commands.
  * @public
  */
-interface ResolvedIdentity {
+export interface ResolvedIdentity {
   readonly projectKey: string;
   readonly canonicalForm: string;
   readonly source: ProjectIdentitySource;
 }
 /** @public */
-type ProjectIdentitySource = "explicit" | "toml" | "git-remote" | "package-repository" | "package-name";
+export type ProjectIdentitySource = "explicit" | "toml" | "git-remote" | "package-repository" | "package-name";
 /**
  * Per-source candidate values. Each is optional — an absent or empty
  * value causes the resolver to fall through to the next source.
@@ -3664,7 +3898,7 @@ type ProjectIdentitySource = "explicit" | "toml" | "git-remote" | "package-repos
  * subprocess, `package.json` read). Tests pass a literal object.
  * @public
  */
-interface ProjectIdentityCandidates {
+export interface ProjectIdentityCandidates {
   readonly explicit?: string;
   readonly toml?: string;
   readonly gitRemote?: string;
@@ -3678,7 +3912,7 @@ interface ProjectIdentityCandidates {
  * configured `AgentPlugin({ projectId: "..." })` in `vitest.config.ts`.
  * @public
  */
-interface ResolveProjectIdentityOptions {
+export interface ResolveProjectIdentityOptions {
   readonly projectId?: string;
 }
 /**
@@ -3692,7 +3926,7 @@ interface ResolveProjectIdentityOptions {
  * shape from `canonicalizeGitUrl`.
  * @public
  */
-declare const resolveProjectIdentityFromCandidates: (candidates: ProjectIdentityCandidates) => ResolvedIdentity | null;
+export declare const resolveProjectIdentityFromCandidates: (candidates: ProjectIdentityCandidates) => ResolvedIdentity | null;
 declare const ProjectIdentity_base: Context.ServiceClass<ProjectIdentity, "vitest-agent/ProjectIdentity", {
   readonly resolve: (workspaceRoot: string, options?: ResolveProjectIdentityOptions) => Effect.Effect<ResolvedIdentity, ProjectIdentityNotResolvableError>;
 }>;
@@ -3702,7 +3936,7 @@ declare const ProjectIdentity_base: Context.ServiceClass<ProjectIdentity, "vites
  * pre-built `ResolvedIdentity`.
  * @public
  */
-declare class ProjectIdentity extends ProjectIdentity_base {}
+export declare class ProjectIdentity extends ProjectIdentity_base {}
 //#endregion
 //#region src/layers/ProjectIdentityLive.d.ts
 /**
@@ -3715,7 +3949,7 @@ declare class ProjectIdentity extends ProjectIdentity_base {}
  *
  * @public
  */
-type CandidateContext = FileSystem.FileSystem | WorkspaceDiscovery | VitestAgentConfigFile | ChildProcessSpawner.ChildProcessSpawner;
+export type CandidateContext = FileSystem.FileSystem | WorkspaceDiscovery | VitestAgentConfigFile | ChildProcessSpawner.ChildProcessSpawner;
 /**
  * Live layer that wires the resolver into real I/O. Requires
  * `FileSystem`, `CommandExecutor`, `WorkspaceDiscovery`, and
@@ -3723,7 +3957,7 @@ type CandidateContext = FileSystem.FileSystem | WorkspaceDiscovery | VitestAgent
  * `NodeServices.layer` at the entry point.
  * @public
  */
-declare const ProjectIdentityLive: Layer.Layer<ProjectIdentity, never, CandidateContext>;
+export declare const ProjectIdentityLive: Layer.Layer<ProjectIdentity, never, CandidateContext>;
 /**
  * Build a Test layer that returns a fixed `ResolvedIdentity` (or
  * fails with `ProjectIdentityNotResolvableError`). Use in unit tests
@@ -3731,7 +3965,7 @@ declare const ProjectIdentityLive: Layer.Layer<ProjectIdentity, never, Candidate
  * services.
  * @public
  */
-declare const ProjectIdentityTest: (result: ResolvedIdentity | ProjectIdentityNotResolvableError) => Layer.Layer<ProjectIdentity, never, never>;
+export declare const ProjectIdentityTest: (result: ResolvedIdentity | ProjectIdentityNotResolvableError) => Layer.Layer<ProjectIdentity, never, never>;
 //#endregion
 //#region src/services/RunContext.d.ts
 declare const RunContext_base: Schema.Class<RunContext, Schema.Struct<{
@@ -3755,7 +3989,7 @@ declare const RunContext_base: Schema.Class<RunContext, Schema.Struct<{
  * and `Schema.encode(...)` for the SQLite row mapping.
  * @public
  */
-declare class RunContext extends RunContext_base {}
+export declare class RunContext extends RunContext_base {}
 declare const AgentContext_base: Schema.Class<AgentContext, Schema.Struct<{
   readonly startGitBranch: Schema.NullOr<Schema.String>;
   readonly startGitCommitSha: Schema.NullOr<Schema.String>;
@@ -3767,7 +4001,7 @@ declare const AgentContext_base: Schema.Class<AgentContext, Schema.Struct<{
  * dirty-tree state and upstream tracking are per-run concerns.
  * @public
  */
-declare class AgentContext extends AgentContext_base {}
+export declare class AgentContext extends AgentContext_base {}
 declare const RunContext$_base: Context.ServiceClass<RunContext$, "vitest-agent/RunContextService", {
   readonly captureRunContext: (cwd: string) => Effect.Effect<RunContext>;
   readonly captureAgentContext: (cwd: string) => Effect.Effect<AgentContext>;
@@ -3777,7 +4011,7 @@ declare const RunContext$_base: Context.ServiceClass<RunContext$, "vitest-agent/
  * returns whatever the test fixture passes.
  * @public
  */
-declare class RunContext$ extends RunContext$_base {}
+export declare class RunContext$ extends RunContext$_base {}
 /**
  * Re-export the service tag under a less-collision-prone name. The
  * `RunContext` Schema.Class above shares its symbol-name with the
@@ -3786,9 +4020,9 @@ declare class RunContext$ extends RunContext$_base {}
  *
  * @public
  */
-declare const RunContextService: typeof RunContext$;
+export declare const RunContextService: typeof RunContext$;
 /** @public */
-type RunContextService = RunContext$;
+export type RunContextService = RunContext$;
 //#endregion
 //#region src/layers/RunContextLive.d.ts
 /**
@@ -3799,13 +4033,13 @@ type RunContextService = RunContext$;
  * constructs.
  * @public
  */
-declare const RunContextLive: Layer.Layer<RunContextService, never, ChildProcessSpawner.ChildProcessSpawner>;
+export declare const RunContextLive: Layer.Layer<RunContextService, never, ChildProcessSpawner.ChildProcessSpawner>;
 /**
  * Build a Test layer that returns fixed `RunContext` and
  * `AgentContext` values regardless of `cwd`.
  * @public
  */
-declare const RunContextTest: (fixture: {
+export declare const RunContextTest: (fixture: {
   readonly runContext: RunContext;
   readonly agentContext: AgentContext;
 }) => Layer.Layer<RunContextService, never, never>;
@@ -3825,7 +4059,7 @@ interface FormatTriageOptions {
  * replaced with empty defaults so the caller is guaranteed a string.
  * @public
  */
-declare const formatTriageEffect: (options?: FormatTriageOptions) => Effect.Effect<string, never, DataReader>;
+export declare const formatTriageEffect: (options?: FormatTriageOptions) => Effect.Effect<string, never, DataReader>;
 //#endregion
 //#region src/lib/format-wrapup.d.ts
 /** @public */
@@ -3838,12 +4072,37 @@ interface FormatWrapupOptions {
   readonly userPromptHint?: string;
 }
 /** @public */
-declare const formatWrapupEffect: (options: FormatWrapupOptions) => Effect.Effect<string, never, DataReader>;
+export declare const formatWrapupEffect: (options: FormatWrapupOptions) => Effect.Effect<string, never, DataReader>;
 //#endregion
 //#region src/migrations/0001_initial.d.ts
 /** @internal */
 declare const migration: Effect.Effect<void, import("effect/unstable/sql/SqlError").SqlError, SqlClient>;
 //#endregion
+//#region src/migrations/0002_test_artifacts.d.ts
+/** @internal */
+declare const migration$1: Effect.Effect<void, import("effect/unstable/sql/SqlError").SqlError, SqlClient>;
+//#endregion
+//#region src/migrations/index.d.ts
+/**
+ * Every migration that must run against a per-project `data.db`, keyed by
+ * migration id in application order.
+ *
+ * This is the single source of truth for the project database's migration
+ * set: `ensureMigrated`, the sdk testing layer, `ReporterLive`, `McpLive`,
+ * `CliLive` and `SidecarLive` all pass it straight to
+ * `SqliteMigrator.fromRecord`, so adding a migration file and registering it
+ * here is enough to reach every process that opens a project database.
+ *
+ * The session-map and discovery-registry databases are separate schemas with
+ * their own migrations and are deliberately not listed here.
+ *
+ * @public
+ */
+export declare const PROJECT_MIGRATIONS: {
+  readonly "0001_initial": import("effect/Effect").Effect<void, import("effect/unstable/sql/SqlError").SqlError, import("effect/unstable/sql/SqlClient").SqlClient>;
+  readonly "0002_test_artifacts": import("effect/Effect").Effect<void, import("effect/unstable/sql/SqlError").SqlError, import("effect/unstable/sql/SqlClient").SqlClient>;
+};
+//#endregion
 //#region src/migrations/registry_0001_initial.d.ts
 /**
  * Migration for the global discovery registry SQLite at
@@ -3859,19 +4118,19 @@ declare const migration: Effect.Effect<void, import("effect/unstable/sql/SqlErro
  * the `ON CONFLICT(project_key) DO UPDATE` upsert.
  * @public
  */
-declare const migration$1: Effect.Effect<void, import("effect/unstable/sql/SqlError").SqlError, SqlClient>;
+declare const migration$2: Effect.Effect<void, import("effect/unstable/sql/SqlError").SqlError, SqlClient>;
 //#endregion
 //#region src/migrations/session_map_0001_initial.d.ts
 /** @internal */
-declare const migration$2: Effect.Effect<void, import("effect/unstable/sql/SqlError").SqlError, SqlClient>;
+declare const migration$3: Effect.Effect<void, import("effect/unstable/sql/SqlError").SqlError, SqlClient>;
 //#endregion
 //#region src/schemas/ChannelEvent.d.ts
 /** @public */
-declare const SessionOutcome: Schema.Literals<readonly ["succeeded", "blocked", "abandoned"]>;
+export declare const SessionOutcome: Schema.Literals<readonly ["succeeded", "blocked", "abandoned"]>;
 /** @public */
-type SessionOutcome = typeof SessionOutcome.Type;
+export type SessionOutcome = typeof SessionOutcome.Type;
 /** @public */
-declare const GoalsReadyEvent: Schema.Struct<{
+export declare const GoalsReadyEvent: Schema.Struct<{
   readonly type: Schema.Literal<"goals_ready">;
   readonly sessionId: Schema.Number;
   readonly goals: Schema.$Array<Schema.Struct<{
@@ -3881,9 +4140,9 @@ declare const GoalsReadyEvent: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type GoalsReadyEvent = typeof GoalsReadyEvent.Type;
+export type GoalsReadyEvent = typeof GoalsReadyEvent.Type;
 /** @public */
-declare const GoalAddedEvent: Schema.Struct<{
+export declare const GoalAddedEvent: Schema.Struct<{
   readonly type: Schema.Literal<"goal_added">;
   readonly sessionId: Schema.Number;
   readonly goal: Schema.Struct<{
@@ -3893,35 +4152,35 @@ declare const GoalAddedEvent: Schema.Struct<{
   }>;
 }>;
 /** @public */
-type GoalAddedEvent = typeof GoalAddedEvent.Type;
+export type GoalAddedEvent = typeof GoalAddedEvent.Type;
 /** @public */
-declare const GoalStartedEvent: Schema.Struct<{
+export declare const GoalStartedEvent: Schema.Struct<{
   readonly type: Schema.Literal<"goal_started">;
   readonly sessionId: Schema.Number;
   readonly goalId: Schema.Number;
 }>;
 /** @public */
-type GoalStartedEvent = typeof GoalStartedEvent.Type;
+export type GoalStartedEvent = typeof GoalStartedEvent.Type;
 /** @public */
-declare const GoalCompletedEvent: Schema.Struct<{
+export declare const GoalCompletedEvent: Schema.Struct<{
   readonly type: Schema.Literal<"goal_completed">;
   readonly sessionId: Schema.Number;
   readonly goalId: Schema.Number;
   readonly behaviorIds: Schema.$Array<Schema.Number>;
 }>;
 /** @public */
-type GoalCompletedEvent = typeof GoalCompletedEvent.Type;
+export type GoalCompletedEvent = typeof GoalCompletedEvent.Type;
 /** @public */
-declare const GoalAbandonedEvent: Schema.Struct<{
+export declare const GoalAbandonedEvent: Schema.Struct<{
   readonly type: Schema.Literal<"goal_abandoned">;
   readonly sessionId: Schema.Number;
   readonly goalId: Schema.Number;
   readonly reason: Schema.String;
 }>;
 /** @public */
-type GoalAbandonedEvent = typeof GoalAbandonedEvent.Type;
+export type GoalAbandonedEvent = typeof GoalAbandonedEvent.Type;
 /** @public */
-declare const BehaviorsReadyEvent: Schema.Struct<{
+export declare const BehaviorsReadyEvent: Schema.Struct<{
   readonly type: Schema.Literal<"behaviors_ready">;
   readonly sessionId: Schema.Number;
   readonly goalId: Schema.Number;
@@ -3932,9 +4191,9 @@ declare const BehaviorsReadyEvent: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type BehaviorsReadyEvent = typeof BehaviorsReadyEvent.Type;
+export type BehaviorsReadyEvent = typeof BehaviorsReadyEvent.Type;
 /** @public */
-declare const BehaviorAddedEvent: Schema.Struct<{
+export declare const BehaviorAddedEvent: Schema.Struct<{
   readonly type: Schema.Literal<"behavior_added">;
   readonly sessionId: Schema.Number;
   readonly goalId: Schema.Number;
@@ -3945,18 +4204,18 @@ declare const BehaviorAddedEvent: Schema.Struct<{
   }>;
 }>;
 /** @public */
-type BehaviorAddedEvent = typeof BehaviorAddedEvent.Type;
+export type BehaviorAddedEvent = typeof BehaviorAddedEvent.Type;
 /** @public */
-declare const BehaviorStartedEvent: Schema.Struct<{
+export declare const BehaviorStartedEvent: Schema.Struct<{
   readonly type: Schema.Literal<"behavior_started">;
   readonly sessionId: Schema.Number;
   readonly goalId: Schema.Number;
   readonly behaviorId: Schema.Number;
 }>;
 /** @public */
-type BehaviorStartedEvent = typeof BehaviorStartedEvent.Type;
+export type BehaviorStartedEvent = typeof BehaviorStartedEvent.Type;
 /** @public */
-declare const PhaseTransitionEvent: Schema.Struct<{
+export declare const PhaseTransitionEvent: Schema.Struct<{
   readonly type: Schema.Literal<"phase_transition">;
   readonly sessionId: Schema.Number;
   readonly goalId: Schema.Number;
@@ -3965,18 +4224,18 @@ declare const PhaseTransitionEvent: Schema.Struct<{
   readonly to: Schema.Literals<readonly ["spike", "red", "red.triangulate", "green", "green.fake-it", "refactor", "extended-red", "green-without-red"]>;
 }>;
 /** @public */
-type PhaseTransitionEvent = typeof PhaseTransitionEvent.Type;
+export type PhaseTransitionEvent = typeof PhaseTransitionEvent.Type;
 /** @public */
-declare const BehaviorCompletedEvent: Schema.Struct<{
+export declare const BehaviorCompletedEvent: Schema.Struct<{
   readonly type: Schema.Literal<"behavior_completed">;
   readonly sessionId: Schema.Number;
   readonly goalId: Schema.Number;
   readonly behaviorId: Schema.Number;
 }>;
 /** @public */
-type BehaviorCompletedEvent = typeof BehaviorCompletedEvent.Type;
+export type BehaviorCompletedEvent = typeof BehaviorCompletedEvent.Type;
 /** @public */
-declare const BehaviorAbandonedEvent: Schema.Struct<{
+export declare const BehaviorAbandonedEvent: Schema.Struct<{
   readonly type: Schema.Literal<"behavior_abandoned">;
   readonly sessionId: Schema.Number;
   readonly goalId: Schema.Number;
@@ -3984,9 +4243,9 @@ declare const BehaviorAbandonedEvent: Schema.Struct<{
   readonly reason: Schema.String;
 }>;
 /** @public */
-type BehaviorAbandonedEvent = typeof BehaviorAbandonedEvent.Type;
+export type BehaviorAbandonedEvent = typeof BehaviorAbandonedEvent.Type;
 /** @public */
-declare const BlockedEvent: Schema.Struct<{
+export declare const BlockedEvent: Schema.Struct<{
   readonly type: Schema.Literal<"blocked">;
   readonly sessionId: Schema.Number;
   readonly goalId: Schema.Number;
@@ -3995,18 +4254,18 @@ declare const BlockedEvent: Schema.Struct<{
   readonly failureSignatureHash: Schema.optional<Schema.String>;
 }>;
 /** @public */
-type BlockedEvent = typeof BlockedEvent.Type;
+export type BlockedEvent = typeof BlockedEvent.Type;
 /** @public */
-declare const SessionCompleteEvent: Schema.Struct<{
+export declare const SessionCompleteEvent: Schema.Struct<{
   readonly type: Schema.Literal<"session_complete">;
   readonly sessionId: Schema.Number;
   readonly goalIds: Schema.$Array<Schema.Number>;
   readonly outcome: Schema.Literals<readonly ["succeeded", "blocked", "abandoned"]>;
 }>;
 /** @public */
-type SessionCompleteEvent = typeof SessionCompleteEvent.Type;
+export type SessionCompleteEvent = typeof SessionCompleteEvent.Type;
 /** @public */
-declare const ChannelEvent: Schema.Union<readonly [Schema.Struct<{
+export declare const ChannelEvent: Schema.Union<readonly [Schema.Struct<{
   readonly type: Schema.Literal<"goals_ready">;
   readonly sessionId: Schema.Number;
   readonly goals: Schema.$Array<Schema.Struct<{
@@ -4091,7 +4350,7 @@ declare const ChannelEvent: Schema.Union<readonly [Schema.Struct<{
   readonly outcome: Schema.Literals<readonly ["succeeded", "blocked", "abandoned"]>;
 }>]>;
 /** @public */
-type ChannelEvent = typeof ChannelEvent.Type;
+export type ChannelEvent = typeof ChannelEvent.Type;
 /**
  * Event types whose `goalId` and `sessionId` should be resolved
  * server-side from `behaviorId` (per spec: "not trusting the
@@ -4099,9 +4358,9 @@ type ChannelEvent = typeof ChannelEvent.Type;
  * which subset to enrich vs pass through.
  * @public
  */
-declare const BehaviorScopedEventTypes: readonly ["behavior_started", "phase_transition", "behavior_completed", "behavior_abandoned", "blocked"];
+export declare const BehaviorScopedEventTypes: readonly ["behavior_started", "phase_transition", "behavior_completed", "behavior_abandoned", "blocked"];
 /** @public */
-type BehaviorScopedEventType = (typeof BehaviorScopedEventTypes)[number];
+export type BehaviorScopedEventType = (typeof BehaviorScopedEventTypes)[number];
 //#endregion
 //#region src/schemas/ConsoleLeaks.d.ts
 /**
@@ -4109,7 +4368,7 @@ type BehaviorScopedEventType = (typeof BehaviorScopedEventTypes)[number];
  * (one `console.*` call), not lines.
  * @public
  */
-declare const ConsoleLeakFile: Schema.Struct<{
+export declare const ConsoleLeakFile: Schema.Struct<{
   readonly file: Schema.String;
   readonly stdout: Schema.Number;
   readonly stderr: Schema.Number;
@@ -4117,7 +4376,7 @@ declare const ConsoleLeakFile: Schema.Struct<{
   readonly sample: Schema.optional<Schema.String>;
 }>;
 /** @public */
-type ConsoleLeakFile = typeof ConsoleLeakFile.Type;
+export type ConsoleLeakFile = typeof ConsoleLeakFile.Type;
 /**
  * Summary of console output logged inside tests that did NOT pass. Kept
  * separate from `total`/`byFile` so it can never be mistaken for a leak in a
@@ -4126,12 +4385,12 @@ type ConsoleLeakFile = typeof ConsoleLeakFile.Type;
  * genuine leaks on every red run.
  * @public
  */
-declare const ConsoleLeaksFromFailingTests: Schema.Struct<{
+export declare const ConsoleLeaksFromFailingTests: Schema.Struct<{
   readonly total: Schema.Number;
   readonly files: Schema.Number;
 }>;
 /** @public */
-type ConsoleLeaksFromFailingTests = typeof ConsoleLeaksFromFailingTests.Type;
+export type ConsoleLeaksFromFailingTests = typeof ConsoleLeaksFromFailingTests.Type;
 /**
  * Aggregate stray-console-output signal for a single test run. Omitted from
  * a report entirely when the run produced no user console output at all
@@ -4141,7 +4400,7 @@ type ConsoleLeaksFromFailingTests = typeof ConsoleLeaksFromFailingTests.Type;
  * visible without polluting the actionable leak signal (issue #263).
  * @public
  */
-declare const ConsoleLeaks: Schema.Struct<{
+export declare const ConsoleLeaks: Schema.Struct<{
   readonly total: Schema.Number;
   readonly byFile: Schema.$Array<Schema.Struct<{
     readonly file: Schema.String;
@@ -4157,7 +4416,7 @@ declare const ConsoleLeaks: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type ConsoleLeaks = typeof ConsoleLeaks.Type;
+export type ConsoleLeaks = typeof ConsoleLeaks.Type;
 //#endregion
 //#region src/schemas/CoverageLevel.d.ts
 declare const CoverageLevel_base: Schema.Class<CoverageLevel, Schema.Struct<{
@@ -4172,7 +4431,7 @@ declare const CoverageLevel_base: Schema.Class<CoverageLevel, Schema.Struct<{
  * perFile flag. Extend this class to define custom named presets.
  * @public
  */
-declare class CoverageLevel extends CoverageLevel_base {
+export declare class CoverageLevel extends CoverageLevel_base {
   /** No enforcement — all metrics at 0%. */
   static readonly none: CoverageLevel;
   /** Minimal coverage bar — all metrics at 50%. */
@@ -4203,48 +4462,57 @@ declare class CoverageLevel extends CoverageLevel_base {
 }
 /** The named preset identifiers.  * @public
  */
-type CoverageLevelName = "none" | "basic" | "standard" | "strict" | "full";
+export type CoverageLevelName = "none" | "basic" | "standard" | "strict" | "full";
 /** Accepted input forms: a preset name string or a CoverageLevel instance.  * @public
  */
-type CoverageInput = CoverageLevelName | CoverageLevel;
+export type CoverageInput = CoverageLevelName | CoverageLevel;
 /**
  * Resolves a CoverageInput (preset name or CoverageLevel instance) to a
  * CoverageLevel. When input is undefined, returns the named fallback preset.
  * Throws if a string is provided that does not match a known preset name.
  * @public
  */
-declare function resolveCoverageInput(input: CoverageInput | undefined, fallback: CoverageLevelName): CoverageLevel;
+export declare function resolveCoverageInput(input: CoverageInput | undefined, fallback: CoverageLevelName): CoverageLevel;
 /**
  * Validates that coverageTargets are not below coverageThresholds for any
  * metric, and that both agree on perFile. Throws a descriptive Error on
  * any violation.
  * @public
  */
-declare function validateCoverageConfig(thresholds: CoverageLevel, targets: CoverageLevel): void;
+export declare function validateCoverageConfig(thresholds: CoverageLevel, targets: CoverageLevel): void;
 //#endregion
 //#region src/schemas/CoverageTargets.d.ts
 /**
  * Per-metric leaf shape for coverageTargets entries. Allows optional
- * numeric targets per metric and the `100: true` shortcut.
+ * numeric targets per metric, the `100: true` shortcut, and — mirroring
+ * Vitest 5 — a per-glob `perFile` setting.
  * @public
  */
-declare const CoverageTargetsMetrics: Schema.Struct<{
+export declare const CoverageTargetsMetrics: Schema.Struct<{
   readonly lines: Schema.optional<Schema.Number>;
   readonly functions: Schema.optional<Schema.Number>;
   readonly branches: Schema.optional<Schema.Number>;
   readonly statements: Schema.optional<Schema.Number>;
   readonly 100: Schema.optional<Schema.Literal<true>>;
+  readonly perFile: Schema.optional<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+    readonly lines: Schema.optional<Schema.Number>;
+    readonly functions: Schema.optional<Schema.Number>;
+    readonly branches: Schema.optional<Schema.Number>;
+    readonly statements: Schema.optional<Schema.Number>;
+  }>]>>;
 }>;
 /** @public */
-type CoverageTargetsMetrics = typeof CoverageTargetsMetrics.Type;
+export type CoverageTargetsMetrics = typeof CoverageTargetsMetrics.Type;
 /**
  * Typed schema for the coverageTargets option.
  *
  * Mirrors Vitest's coverage.thresholds shape — per-metric positive numbers,
  * the `100: true` shortcut (only valid at key `"100"`), and glob-pattern
  * entries with metric objects. Positive numbers only; negatives and zeros
- * are rejected. `perFile` is not allowed here — inherit it from
- * `coverage.thresholds.perFile`.
+ * are rejected. A top-level `perFile` is not allowed here — set it on
+ * `coverage.thresholds.perFile`. A `perFile` inside a glob-pattern entry
+ * IS allowed, mirroring Vitest 5, where a glob entry no longer inherits
+ * the top-level setting.
  *
  * A decode-time refinement rejects `true` at any key other than `"100"`
  * so `{ statements: true }` fails parse rather than silently flowing
@@ -4252,15 +4520,21 @@ type CoverageTargetsMetrics = typeof CoverageTargetsMetrics.Type;
  * at key `"100"`.
  * @public
  */
-declare const CoverageTargets: Schema.$Record<Schema.String, Schema.Union<readonly [Schema.Number, Schema.Literal<true>, Schema.Struct<{
+export declare const CoverageTargets: Schema.$Record<Schema.String, Schema.Union<readonly [Schema.Number, Schema.Literal<true>, Schema.Struct<{
   readonly lines: Schema.optional<Schema.Number>;
   readonly functions: Schema.optional<Schema.Number>;
   readonly branches: Schema.optional<Schema.Number>;
   readonly statements: Schema.optional<Schema.Number>;
   readonly 100: Schema.optional<Schema.Literal<true>>;
+  readonly perFile: Schema.optional<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+    readonly lines: Schema.optional<Schema.Number>;
+    readonly functions: Schema.optional<Schema.Number>;
+    readonly branches: Schema.optional<Schema.Number>;
+    readonly statements: Schema.optional<Schema.Number>;
+  }>]>>;
 }>]>>;
 /** @public */
-type CoverageTargets = typeof CoverageTargets.Type;
+export type CoverageTargets = typeof CoverageTargets.Type;
 //#endregion
 //#region src/schemas/Options.d.ts
 /**
@@ -4278,23 +4552,46 @@ type CoverageTargets = typeof CoverageTargets.Type;
  *   annotations writer ships.
  * @public
  */
-declare const ConsoleOutputs: Schema.Struct<{
+export declare const ConsoleOutputs: Schema.Struct<{
   readonly human: Schema.optional<Schema.Literals<readonly ["passthrough", "silent", "stream", "agent"]>>;
   readonly agent: Schema.optional<Schema.Literals<readonly ["passthrough", "silent", "agent"]>>;
   readonly ci: Schema.optional<Schema.Literals<readonly ["passthrough", "silent", "ci-annotations"]>>;
 }>;
 /** @public */
-type ConsoleOutputs = typeof ConsoleOutputs.Type;
+export type ConsoleOutputs = typeof ConsoleOutputs.Type;
+/**
+ * Report-file settings. An object overrides the scope directory name
+ * used under `.vitest/`; the default scope is `vitest-agent`.
+ *
+ * @public
+ */
+export declare const ReportSettings: Schema.Struct<{
+  readonly scope: Schema.optional<Schema.String>;
+}>;
+/** @public */
+export type ReportSettings = typeof ReportSettings.Type;
+/**
+ * Report-file settings. `false` disables `.vitest/<scope>/` writes
+ * entirely; an object overrides the scope directory name.
+ *
+ * Default: on for the `agent` and `ci` executors, off for `human`.
+ * @public
+ */
+export declare const ReportOption: Schema.Union<readonly [Schema.Literal<false>, Schema.Struct<{
+  readonly scope: Schema.optional<Schema.String>;
+}>]>;
+/** @public */
+export type ReportOption = typeof ReportOption.Type;
 /**
  * The 2.0 user-facing options for `AgentPlugin`.
  *
- * Five fields total. Two are function-typed (`reporter`, `onRunEvent`)
+ * Six fields total. Two are function-typed (`reporter`, `onRunEvent`)
  * and live on the `AgentPluginConstructorOptions` companion interface in
  * `@vitest-agent/plugin` — Effect Schema cannot encode functions cleanly,
- * so the schema-decodable struct carries the three data-shaped fields.
+ * so the schema-decodable struct carries the four data-shaped fields.
  * @public
  */
-declare const AgentPluginOptions: Schema.Struct<{
+export declare const AgentPluginOptions: Schema.Struct<{
   readonly console: Schema.optional<Schema.Struct<{
     readonly human: Schema.optional<Schema.Literals<readonly ["passthrough", "silent", "stream", "agent"]>>;
     readonly agent: Schema.optional<Schema.Literals<readonly ["passthrough", "silent", "agent"]>>;
@@ -4306,13 +4603,22 @@ declare const AgentPluginOptions: Schema.Struct<{
     readonly branches: Schema.optional<Schema.Number>;
     readonly statements: Schema.optional<Schema.Number>;
     readonly 100: Schema.optional<Schema.Literal<true>>;
+    readonly perFile: Schema.optional<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+      readonly lines: Schema.optional<Schema.Number>;
+      readonly functions: Schema.optional<Schema.Number>;
+      readonly branches: Schema.optional<Schema.Number>;
+      readonly statements: Schema.optional<Schema.Number>;
+    }>]>>;
   }>]>>>;
   readonly transport: Schema.optional<Schema.Union<readonly [Schema.Struct<{
     readonly kind: Schema.Literal<"local">;
   }>]>>;
+  readonly report: Schema.optional<Schema.Union<readonly [Schema.Literal<false>, Schema.Struct<{
+    readonly scope: Schema.optional<Schema.String>;
+  }>]>>;
 }>;
 /** @public */
-type AgentPluginOptions = typeof AgentPluginOptions.Type;
+export type AgentPluginOptions = typeof AgentPluginOptions.Type;
 /**
  * Reporter-implementation options.
  *
@@ -4324,16 +4630,292 @@ type AgentPluginOptions = typeof AgentPluginOptions.Type;
  * (currently only `projectFilter` for per-project scoping).
  * @public
  */
-declare const AgentReporterOptions: Schema.Struct<{
+export declare const AgentReporterOptions: Schema.Struct<{
   /** Set by the plugin per-project. Filters reports to one project. */
   readonly projectFilter: Schema.optional<Schema.String>;
 }>;
 /** @public */
-type AgentReporterOptions = typeof AgentReporterOptions.Type;
+export type AgentReporterOptions = typeof AgentReporterOptions.Type;
+//#endregion
+//#region src/schemas/RunReportFile.d.ts
+/**
+ * Canonical `$schema` URL for `RunReportFile` version 1.
+ *
+ * Written as the first key of `run.json` so an editor or a JSON Schema
+ * validator can resolve the contract without knowing about vitest-agent.
+ *
+ * @public
+ */
+export declare const RUN_REPORT_FILE_SCHEMA_URL = "https://vitest-agent.dev/schemas/run-report-file-1.0.0.json";
+/**
+ * Envelope for the `run.json` report file.
+ *
+ * @public
+ */
+export declare const RunReportFile: Schema.Struct<{
+  readonly $schema: Schema.optionalKey<Schema.String>;
+  readonly schemaVersion: Schema.Literal<1>;
+  readonly generatedAt: Schema.String;
+  readonly reports: Schema.$Array<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.Number;
+      readonly passed: Schema.Number;
+      readonly failed: Schema.Number;
+      readonly skipped: Schema.Number;
+      readonly duration: Schema.Number;
+      readonly modules: Schema.optional<Schema.Number>;
+    }>;
+    readonly failed: Schema.$Array<Schema.Struct<{
+      readonly file: Schema.String;
+      readonly state: Schema.Literals<readonly ["passed", "failed", "skipped", "pending"]>;
+      readonly duration: Schema.optional<Schema.Number>;
+      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.Number>;
+        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.Number;
+        readonly branches: Schema.Number;
+        readonly functions: Schema.Number;
+        readonly lines: Schema.Number;
+      }>;
+      readonly thresholds: Schema.Struct<{
+        readonly global: Schema.Struct<{
+          readonly lines: Schema.optional<Schema.Number>;
+          readonly functions: Schema.optional<Schema.Number>;
+          readonly branches: Schema.optional<Schema.Number>;
+          readonly statements: Schema.optional<Schema.Number>;
+        }>;
+        readonly patterns: Schema.withDecodingDefaultKey<Schema.$Array<Schema.Tuple<readonly [Schema.String, Schema.Struct<{
+          readonly lines: Schema.optional<Schema.Number>;
+          readonly functions: Schema.optional<Schema.Number>;
+          readonly branches: Schema.optional<Schema.Number>;
+          readonly statements: Schema.optional<Schema.Number>;
+          readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+            readonly lines: Schema.optional<Schema.Number>;
+            readonly functions: Schema.optional<Schema.Number>;
+            readonly branches: Schema.optional<Schema.Number>;
+            readonly statements: Schema.optional<Schema.Number>;
+          }>]>>;
+        }>]>>, never>;
+      }>;
+      readonly targets: Schema.optional<Schema.Struct<{
+        readonly global: Schema.Struct<{
+          readonly lines: Schema.optional<Schema.Number>;
+          readonly functions: Schema.optional<Schema.Number>;
+          readonly branches: Schema.optional<Schema.Number>;
+          readonly statements: Schema.optional<Schema.Number>;
+        }>;
+        readonly patterns: Schema.withDecodingDefaultKey<Schema.$Array<Schema.Tuple<readonly [Schema.String, Schema.Struct<{
+          readonly lines: Schema.optional<Schema.Number>;
+          readonly functions: Schema.optional<Schema.Number>;
+          readonly branches: Schema.optional<Schema.Number>;
+          readonly statements: Schema.optional<Schema.Number>;
+          readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+            readonly lines: Schema.optional<Schema.Number>;
+            readonly functions: Schema.optional<Schema.Number>;
+            readonly branches: Schema.optional<Schema.Number>;
+            readonly statements: Schema.optional<Schema.Number>;
+          }>]>>;
+        }>]>>, never>;
+      }>>;
+      readonly baselines: Schema.optional<Schema.Struct<{
+        readonly global: Schema.Struct<{
+          readonly lines: Schema.optional<Schema.Number>;
+          readonly functions: Schema.optional<Schema.Number>;
+          readonly branches: Schema.optional<Schema.Number>;
+          readonly statements: Schema.optional<Schema.Number>;
+        }>;
+        readonly patterns: Schema.withDecodingDefaultKey<Schema.$Array<Schema.Tuple<readonly [Schema.String, Schema.Struct<{
+          readonly lines: Schema.optional<Schema.Number>;
+          readonly functions: Schema.optional<Schema.Number>;
+          readonly branches: Schema.optional<Schema.Number>;
+          readonly statements: Schema.optional<Schema.Number>;
+          readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+            readonly lines: Schema.optional<Schema.Number>;
+            readonly functions: Schema.optional<Schema.Number>;
+            readonly branches: Schema.optional<Schema.Number>;
+            readonly statements: Schema.optional<Schema.Number>;
+          }>]>>;
+        }>]>>, never>;
+      }>>;
+      readonly scoped: Schema.withDecodingDefaultKey<Schema.Boolean, never>;
+      readonly scopedFiles: Schema.optional<Schema.$Array<Schema.String>>;
+      readonly totalFiles: Schema.optional<Schema.Number>;
+      readonly lowCoverage: Schema.$Array<Schema.Struct<{
+        readonly file: Schema.String;
+        readonly summary: Schema.Struct<{
+          readonly statements: Schema.Number;
+          readonly branches: Schema.Number;
+          readonly functions: Schema.Number;
+          readonly lines: Schema.Number;
+        }>;
+        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.Number;
+          readonly branches: Schema.Number;
+          readonly functions: Schema.Number;
+          readonly lines: Schema.Number;
+        }>;
+        readonly uncoveredLines: Schema.String;
+      }>>>;
+      readonly belowTargetFiles: Schema.optional<Schema.$Array<Schema.String>>;
+    }>>;
+    readonly tagCounts: Schema.optional<Schema.$Record<Schema.String, Schema.Struct<{
+      readonly passed: Schema.optional<Schema.Number>;
+      readonly failed: Schema.optional<Schema.Number>;
+      readonly skipped: Schema.optional<Schema.Number>;
+    }>>>;
+    readonly consoleLeaks: Schema.optional<Schema.Struct<{
+      readonly total: Schema.Number;
+      readonly byFile: Schema.$Array<Schema.Struct<{
+        readonly file: Schema.String;
+        readonly stdout: Schema.Number;
+        readonly stderr: Schema.Number;
+        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.Number;
+        readonly files: Schema.Number;
+      }>>;
+    }>>;
+  }>>;
+}>;
+/** @public */
+export type RunReportFile = typeof RunReportFile.Type;
+//#endregion
+//#region src/schemas/TestArtifacts.d.ts
+/**
+ * Source position a test annotation or test artifact points at.
+ * @public
+ */
+export declare const TestArtifactLocation: Schema.Struct<{
+  readonly file: Schema.String;
+  readonly line: Schema.Number;
+  readonly column: Schema.Number;
+}>;
+/** @public */
+export type TestArtifactLocation = typeof TestArtifactLocation.Type;
+/**
+ * One attachment descriptor.
+ *
+ * `path` is the location Vitest already rewrote the attachment to
+ * (usually under `.vitest/attachments/`) or an external `http(s)` URL —
+ * vitest-agent never copies the file itself. `byteSize` is always
+ * recorded so a dangling path stays describable. Vitest treats a string
+ * `body` as base64 unless `bodyEncoding` is `"utf-8"`.
+ *
+ * `body` and `bodyEncoding` are populated only on the persistence path,
+ * for inline attachments under the 64 KiB cap. Attachments carried by
+ * `TestAnnotated` and `TestArtifactRecorded` run events are descriptors
+ * only — never assume an event attachment has a body; read the stored
+ * row when the bytes are needed.
+ * @public
+ */
+export declare const TestAttachment: Schema.Struct<{
+  readonly contentType: Schema.optional<Schema.String>;
+  readonly path: Schema.optional<Schema.String>;
+  readonly body: Schema.optional<Schema.String>;
+  readonly bodyEncoding: Schema.optional<Schema.Literals<readonly ["base64", "utf-8"]>>;
+  readonly byteSize: Schema.Number;
+}>;
+/** @public */
+export type TestAttachment = typeof TestAttachment.Type;
+/**
+ * A test annotation as recorded by `context.annotate`.
+ *
+ * `type` is an arbitrary string — Vitest applies no enum
+ * (`.repos/vitest/packages/vitest/src/runtime/runner/types.ts`).
+ * @public
+ */
+export declare const TestAnnotation: 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 attachments: Schema.$Array<Schema.Struct<{
+    readonly contentType: Schema.optional<Schema.String>;
+    readonly path: Schema.optional<Schema.String>;
+    readonly body: Schema.optional<Schema.String>;
+    readonly bodyEncoding: Schema.optional<Schema.Literals<readonly ["base64", "utf-8"]>>;
+    readonly byteSize: Schema.Number;
+  }>>;
+}>;
+/** @public */
+export type TestAnnotation = typeof TestAnnotation.Type;
+/**
+ * A test artifact as recorded by `recordArtifact`.
+ *
+ * `data` is the JSON encoding of the artifact's custom fields, minus
+ * `attachments` and `location` (both modelled separately). Artifacts
+ * whose `type` starts with `internal:` are Vitest's own and are not
+ * persisted.
+ * @public
+ */
+export declare const TestArtifact: Schema.Struct<{
+  readonly type: Schema.String;
+  readonly message: Schema.optional<Schema.String>;
+  readonly data: Schema.optional<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 body: Schema.optional<Schema.String>;
+    readonly bodyEncoding: Schema.optional<Schema.Literals<readonly ["base64", "utf-8"]>>;
+    readonly byteSize: Schema.Number;
+  }>>;
+}>;
+/** @public */
+export type TestArtifact = typeof TestArtifact.Type;
 //#endregion
 //#region src/schemas/turns/FileEditPayload.d.ts
 /** @public */
-declare const FileEditPayload: Schema.Struct<{
+export declare const FileEditPayload: Schema.Struct<{
   readonly type: Schema.Literal<"file_edit">;
   readonly file_path: Schema.String;
   readonly edit_kind: Schema.Literals<readonly ["write", "edit", "multi_edit"]>;
@@ -4342,55 +4924,55 @@ declare const FileEditPayload: Schema.Struct<{
   readonly diff: Schema.optional<Schema.String>;
 }>;
 /** @public */
-type FileEditPayload = typeof FileEditPayload.Type;
+export type FileEditPayload = typeof FileEditPayload.Type;
 //#endregion
 //#region src/schemas/turns/HookFirePayload.d.ts
 /** @public */
-declare const HookFirePayload: Schema.Struct<{
+export declare const HookFirePayload: Schema.Struct<{
   readonly type: Schema.Literal<"hook_fire">;
   readonly hook_kind: Schema.Literals<readonly ["SessionStart", "SessionEnd", "Stop", "StopFailure", "SubagentStart", "SubagentStop", "PreCompact", "PostCompact", "PreToolUse", "PostToolUse", "PostToolUseFailure", "UserPromptSubmit", "FileChanged"]>;
   readonly chat_id: Schema.optional<Schema.String>;
   readonly previous_record_failures: Schema.optional<Schema.$Array<Schema.String>>;
 }>;
 /** @public */
-type HookFirePayload = typeof HookFirePayload.Type;
+export type HookFirePayload = typeof HookFirePayload.Type;
 //#endregion
 //#region src/schemas/turns/HypothesisPayload.d.ts
 /** @public */
-declare const HypothesisPayload: Schema.Struct<{
+export declare const HypothesisPayload: Schema.Struct<{
   readonly type: Schema.Literal<"hypothesis">;
   readonly content: Schema.String;
   readonly cited_test_error_id: Schema.optional<Schema.Number>;
   readonly cited_stack_frame_id: Schema.optional<Schema.Number>;
 }>;
 /** @public */
-type HypothesisPayload = typeof HypothesisPayload.Type;
+export type HypothesisPayload = typeof HypothesisPayload.Type;
 //#endregion
 //#region src/schemas/turns/NotePayload.d.ts
 /** @public */
-declare const NotePayload: Schema.Struct<{
+export declare const NotePayload: Schema.Struct<{
   readonly type: Schema.Literal<"note">;
   readonly scope: Schema.String;
   readonly title: Schema.optional<Schema.String>;
   readonly content: Schema.String;
 }>;
 /** @public */
-type NotePayload = typeof NotePayload.Type;
+export type NotePayload = typeof NotePayload.Type;
 //#endregion
 //#region src/schemas/turns/ToolCallPayload.d.ts
 /** @public */
-declare const ToolCallPayload: Schema.Struct<{
+export declare const ToolCallPayload: Schema.Struct<{
   readonly type: Schema.Literal<"tool_call">;
   readonly tool_name: Schema.String;
   readonly tool_input: Schema.Unknown;
   readonly tool_use_id: Schema.optional<Schema.String>;
 }>;
 /** @public */
-type ToolCallPayload = typeof ToolCallPayload.Type;
+export type ToolCallPayload = typeof ToolCallPayload.Type;
 //#endregion
 //#region src/schemas/turns/ToolResultPayload.d.ts
 /** @public */
-declare const ToolResultPayload: Schema.Struct<{
+export declare const ToolResultPayload: Schema.Struct<{
   readonly type: Schema.Literal<"tool_result">;
   readonly tool_name: Schema.String;
   readonly tool_use_id: Schema.optional<Schema.String>;
@@ -4399,21 +4981,21 @@ declare const ToolResultPayload: Schema.Struct<{
   readonly duration_ms: Schema.optional<Schema.Number>;
 }>;
 /** @public */
-type ToolResultPayload = typeof ToolResultPayload.Type;
+export type ToolResultPayload = typeof ToolResultPayload.Type;
 //#endregion
 //#region src/schemas/turns/UserPromptPayload.d.ts
 /** @public */
-declare const UserPromptPayload: Schema.Struct<{
+export declare const UserPromptPayload: Schema.Struct<{
   readonly type: Schema.Literal<"user_prompt">;
   readonly prompt: Schema.String;
   readonly cc_message_id: Schema.optional<Schema.String>;
 }>;
 /** @public */
-type UserPromptPayload = typeof UserPromptPayload.Type;
+export type UserPromptPayload = typeof UserPromptPayload.Type;
 //#endregion
 //#region src/schemas/turns/index.d.ts
 /** @public */
-declare const TurnPayload: Schema.Union<readonly [Schema.Struct<{
+export declare const TurnPayload: Schema.Union<readonly [Schema.Struct<{
   readonly type: Schema.Literal<"user_prompt">;
   readonly prompt: Schema.String;
   readonly cc_message_id: Schema.optional<Schema.String>;
@@ -4453,7 +5035,7 @@ declare const TurnPayload: Schema.Union<readonly [Schema.Struct<{
   readonly cited_stack_frame_id: Schema.optional<Schema.Number>;
 }>]>;
 /** @public */
-type TurnPayload = typeof TurnPayload.Type;
+export type TurnPayload = typeof TurnPayload.Type;
 //#endregion
 //#region src/services/idempotency.d.ts
 /**
@@ -4462,9 +5044,9 @@ type TurnPayload = typeof TurnPayload.Type;
  * string, both of which could collide with caller-supplied values.
  * @public
  */
-declare const IDEMPOTENCY_ROOT_SENTINEL = "__ROOT__";
+export declare const IDEMPOTENCY_ROOT_SENTINEL = "__ROOT__";
 /** @public */
-interface IdempotencyInput {
+export interface IdempotencyInput {
   readonly agentType: string;
   readonly parentAgentId: string | null;
   readonly clientNonce: string;
@@ -4483,14 +5065,14 @@ interface IdempotencyInput {
  * future debugging.
  * @public
  */
-declare const deriveIdempotencyKey: (input: IdempotencyInput) => string;
+export declare const deriveIdempotencyKey: (input: IdempotencyInput) => string;
 //#endregion
 //#region src/sql/assemblers.d.ts
 /**
  * Minimal shape of a test_runs aggregation row used to build the manifest.
  * @public
  */
-interface ManifestRow {
+export interface ManifestRow {
   project: string;
   sub_project: string | null;
   timestamp: string;
@@ -4500,7 +5082,7 @@ interface ManifestRow {
  * Minimal shape of a test_history row used to build a history record.
  * @public
  */
-interface HistoryRow {
+export interface HistoryRow {
   module_path: string;
   full_name: string;
   timestamp: string;
@@ -4516,7 +5098,7 @@ interface HistoryRow {
  * into the `tests` array format.
  * @public
  */
-interface AssembledHistoryRecord {
+export interface AssembledHistoryRecord {
   [compositeKey: string]: {
     modulePath: string;
     fullName: string;
@@ -4530,7 +5112,7 @@ interface AssembledHistoryRecord {
  * The `dbPath` is stored as `cacheDir` so CLI tools can locate the source.
  * @public
  */
-declare function assembleManifest(rows: ManifestRow[], dbPath: string): CacheManifest;
+export declare function assembleManifest(rows: ManifestRow[], dbPath: string): CacheManifest;
 /**
  * Groups test_history rows by the composite (module_path, full_name) key
  * into a keyed record.
@@ -4544,7 +5126,7 @@ declare function assembleManifest(rows: ManifestRow[], dbPath: string): CacheMan
  * (matching the `TestRun` schema constraint).
  * @public
  */
-declare function assembleHistoryRecord(rows: HistoryRow[]): AssembledHistoryRecord;
+export declare function assembleHistoryRecord(rows: HistoryRow[]): AssembledHistoryRecord;
 //#endregion
 //#region src/utils/ansi.d.ts
 /**
@@ -4552,7 +5134,7 @@ declare function assembleHistoryRecord(rows: HistoryRow[]): AssembledHistoryReco
  *
  * @internal
  */
-interface AnsiOptions {
+export interface AnsiOptions {
   noColor?: boolean;
 }
 /**
@@ -4574,7 +5156,7 @@ interface AnsiOptions {
  * @see {@link https://no-color.org/ | NO_COLOR convention}
  * @internal
  */
-declare function ansi(text: string, color: string, options?: AnsiOptions): string;
+export declare function ansi(text: string, color: string, options?: AnsiOptions): string;
 /**
  * Strip all ANSI escape codes from a string.
  *
@@ -4583,7 +5165,7 @@ declare function ansi(text: string, color: string, options?: AnsiOptions): strin
  *
  * @internal
  */
-declare function stripAnsi(text: string): string;
+export declare function stripAnsi(text: string): string;
 //#endregion
 //#region src/utils/build-report.d.ts
 /**
@@ -4595,7 +5177,7 @@ declare function stripAnsi(text: string): string;
  *
  * @public
  */
-interface VitestParsedStack {
+export interface VitestParsedStack {
   method: string;
   file: string;
   line: number;
@@ -4609,7 +5191,7 @@ interface VitestParsedStack {
  *
  * @public
  */
-interface VitestTestError {
+export interface VitestTestError {
   message: string;
   diff?: string;
   stacks?: Array<string | VitestParsedStack>;
@@ -4622,7 +5204,7 @@ interface VitestTestError {
  *
  * @public
  */
-interface VitestTestResult {
+export interface VitestTestResult {
   state: string;
   errors?: ReadonlyArray<VitestTestError>;
 }
@@ -4631,7 +5213,7 @@ interface VitestTestResult {
  *
  * @public
  */
-interface VitestTestDiagnostic {
+export interface VitestTestDiagnostic {
   duration: number;
   flaky: boolean;
   slow: boolean;
@@ -4646,7 +5228,7 @@ interface VitestTestDiagnostic {
  *
  * @public
  */
-interface VitestTestCase {
+export interface VitestTestCase {
   type: "test";
   name: string;
   fullName: string;
@@ -4661,7 +5243,7 @@ interface VitestTestCase {
  *
  * @public
  */
-interface VitestModuleDiagnostic {
+export interface VitestModuleDiagnostic {
   duration: number;
 }
 /**
@@ -4669,7 +5251,7 @@ interface VitestModuleDiagnostic {
  *
  * @public
  */
-interface VitestModuleError {
+export interface VitestModuleError {
   message: string;
   stacks?: Array<string | VitestParsedStack>;
 }
@@ -4678,7 +5260,7 @@ interface VitestModuleError {
  *
  * @public
  */
-interface VitestTestSuite {
+export interface VitestTestSuite {
   type: "suite";
   name: string;
   fullName: string;
@@ -4713,7 +5295,7 @@ interface VitestTestSuite {
  *
  * @public
  */
-interface VitestTestModule {
+export interface VitestTestModule {
   type: "module";
   moduleId: string;
   relativeModuleId: string;
@@ -4746,7 +5328,7 @@ interface VitestTestModule {
  *
  * @public
  */
-declare function buildAgentReport(testModules: ReadonlyArray<VitestTestModule>, unhandledErrors: ReadonlyArray<VitestModuleError>, reason: "passed" | "failed" | "interrupted", options: {
+export declare function buildAgentReport(testModules: ReadonlyArray<VitestTestModule>, unhandledErrors: ReadonlyArray<VitestModuleError>, reason: "passed" | "failed" | "interrupted", options: {
   readonly omitPassingTests?: boolean;
 }, projectName?: string): AgentReport;
 /**
@@ -4763,7 +5345,7 @@ declare function buildAgentReport(testModules: ReadonlyArray<VitestTestModule>,
  * @returns the number of modules in `report.failed` with no failed test case
  * @public
  */
-declare const countSuiteFailures: (report: Pick<AgentReport, "failed">) => number;
+export declare const countSuiteFailures: (report: Pick<AgentReport, "failed">) => number;
 //#endregion
 //#region src/utils/canonicalize-git-url.d.ts
 /**
@@ -4786,7 +5368,7 @@ declare const countSuiteFailures: (report: Pick<AgentReport, "failed">) => numbe
  *    host like `github.com` is not a project identity.
  * @public
  */
-declare const canonicalizeGitUrl: (raw: string) => string | null;
+export declare const canonicalizeGitUrl: (raw: string) => string | null;
 /**
  * Convert a (possibly raw) git URL to the filesystem-safe `project_key`
  * form. The canonical `host/path` is mapped 1:1 to `host__path` so it
@@ -4794,7 +5376,7 @@ declare const canonicalizeGitUrl: (raw: string) => string | null;
  * `$XDG_DATA_HOME/vitest-agent/`.
  * @public
  */
-declare const gitUrlToProjectKey: (raw: string) => string | null;
+export declare const gitUrlToProjectKey: (raw: string) => string | null;
 //#endregion
 //#region src/utils/classify-test.d.ts
 /**
@@ -4805,7 +5387,7 @@ declare const gitUrlToProjectKey: (raw: string) => string | null;
  * @returns The test's classification
  * @public
  */
-declare function classifyTest(current: "passed" | "failed", priorRuns: ReadonlyArray<{
+export declare function classifyTest(current: "passed" | "failed", priorRuns: ReadonlyArray<{
   state: string;
 }>): TestClassification;
 //#endregion
@@ -4828,7 +5410,7 @@ declare function classifyTest(current: "passed" | "failed", priorRuns: ReadonlyA
  *
  * @public
  */
-declare const coerceErrorText: (value: unknown) => string | undefined;
+export declare const coerceErrorText: (value: unknown) => string | undefined;
 /**
  * Read a named field off an unknown error-like value and coerce it with
  * {@link coerceErrorText}, guarding the property access itself. A live getter
@@ -4843,7 +5425,7 @@ declare const coerceErrorText: (value: unknown) => string | undefined;
  *
  * @public
  */
-declare const coerceErrorField: (source: unknown, key: string) => string | undefined;
+export declare const coerceErrorField: (source: unknown, key: string) => string | undefined;
 //#endregion
 //#region src/utils/compress-lines.d.ts
 /**
@@ -4872,7 +5454,7 @@ declare const coerceErrorField: (source: unknown, key: string) => string | undef
  *
  * @public
  */
-declare function compressLines(lines: number[]): string;
+export declare function compressLines(lines: number[]): string;
 //#endregion
 //#region src/utils/compute-trend.d.ts
 /**
@@ -4883,7 +5465,7 @@ declare function compressLines(lines: number[]): string;
  * is stable for the same logical configuration.
  * @public
  */
-declare function hashTargets(targets: ResolvedThresholds | undefined): string | undefined;
+export declare function hashTargets(targets: ResolvedThresholds | undefined): string | undefined;
 /**
  * Compute a new trend entry and return the updated trend record.
  *
@@ -4891,12 +5473,12 @@ declare function hashTargets(targets: ResolvedThresholds | undefined): string |
  * cleared and the new entry becomes the first data point.
  * @public
  */
-declare function computeTrend(current: CoverageTotals, existing: TrendRecord | undefined, targets: ResolvedThresholds | undefined): TrendRecord;
+export declare function computeTrend(current: CoverageTotals, existing: TrendRecord | undefined, targets: ResolvedThresholds | undefined): TrendRecord;
 /**
  * Get the overall direction from recent entries.
  * @public
  */
-declare function getRecentDirection(record: TrendRecord, count?: number): {
+export declare function getRecentDirection(record: TrendRecord, count?: number): {
   direction: "improving" | "regressing" | "stable";
   runCount: number;
 };
@@ -4907,7 +5489,7 @@ declare function getRecentDirection(record: TrendRecord, count?: number): {
  * when the write happened inside one). Fed to buildConsoleLeaks.
  * @public
  */
-interface ConsoleLeakEntry {
+export interface ConsoleLeakEntry {
   readonly file: string;
   readonly test?: string;
   readonly type: "stdout" | "stderr";
@@ -4931,7 +5513,7 @@ interface ConsoleLeakEntry {
  * `undefined` only when there is no output at all, non-failing or failing.
  * @public
  */
-declare function buildConsoleLeaks(entries: ReadonlyArray<ConsoleLeakEntry>): ConsoleLeaks | undefined;
+export declare function buildConsoleLeaks(entries: ReadonlyArray<ConsoleLeakEntry>): ConsoleLeaks | undefined;
 /**
  * Structural subset of a Vitest runner task (File / Suite / Test) carrying
  * captured console output. Modeled locally so this util needs no `vitest`
@@ -4940,7 +5522,7 @@ declare function buildConsoleLeaks(entries: ReadonlyArray<ConsoleLeakEntry>): Co
  * reporter stripping in agent mode.
  * @public
  */
-interface ConsoleLeakTask {
+export interface ConsoleLeakTask {
   readonly type?: string;
   readonly name?: string;
   readonly fullTestName?: string;
@@ -4967,7 +5549,7 @@ interface ConsoleLeakTask {
  * enclosing file itself failed (e.g. a collection/load error).
  * @public
  */
-declare function collectConsoleLeakEntries(files: ReadonlyArray<ConsoleLeakTask>): ConsoleLeakEntry[];
+export declare function collectConsoleLeakEntries(files: ReadonlyArray<ConsoleLeakTask>): ConsoleLeakEntry[];
 //#endregion
 //#region src/utils/detect-non-default-discover-strategy.d.ts
 /**
@@ -4984,7 +5566,7 @@ declare function collectConsoleLeakEntries(files: ReadonlyArray<ConsoleLeakTask>
  * false negative would produce a confidently wrong deny.
  * @public
  */
-declare function detectNonDefaultDiscoverStrategy(source: string): boolean;
+export declare function detectNonDefaultDiscoverStrategy(source: string): boolean;
 //#endregion
 //#region src/utils/detect-pm.d.ts
 /**
@@ -5015,7 +5597,7 @@ declare function detectNonDefaultDiscoverStrategy(source: string): boolean;
  *
  * @internal
  */
-interface FileSystemAdapter {
+export interface FileSystemAdapter {
   readFile(path: string): Promise<string>;
   exists(path: string): Promise<boolean>;
 }
@@ -5035,7 +5617,7 @@ interface FileSystemAdapter {
  *
  * @internal
  */
-declare function detectPackageManager(root: string, fs: FileSystemAdapter): Promise<PackageManager | null>;
+export declare function detectPackageManager(root: string, fs: FileSystemAdapter): Promise<PackageManager | null>;
 /**
  * Return the vitest run command for the given package manager.
  *
@@ -5046,7 +5628,7 @@ declare function detectPackageManager(root: string, fs: FileSystemAdapter): Prom
  *
  * @internal
  */
-declare function getRunCommand(pm: PackageManager | null): string;
+export declare function getRunCommand(pm: PackageManager | null): string;
 //#endregion
 //#region src/utils/detect-timeout.d.ts
 /**
@@ -5055,7 +5637,7 @@ declare function getRunCommand(pm: PackageManager | null): string;
  * "timeout".
  * @public
  */
-declare const isTimeoutError: (error: {
+export declare const isTimeoutError: (error: {
   message?: string;
   name?: string;
 }) => boolean;
@@ -5068,17 +5650,17 @@ declare const isTimeoutError: (error: {
  * no-ops.
  * @public
  */
-declare function ensureMigrated(dbPath: string, logLevel?: LogLevel.LogLevel, logFile?: string): Promise<void>;
+export declare function ensureMigrated(dbPath: string, logLevel?: LogLevel.LogLevel, logFile?: string): Promise<void>;
 /**
  * Reset the migration cache. Test-only.
  *
  * @internal
  */
-declare function _resetMigrationCacheForTesting(): void;
+export declare function _resetMigrationCacheForTesting(): void;
 //#endregion
 //#region src/utils/failure-signature.d.ts
 /** @public */
-interface FailureSignatureInput {
+export interface FailureSignatureInput {
   readonly error_name: string;
   readonly assertion_message: string;
   readonly top_frame_function_name: string;
@@ -5086,9 +5668,9 @@ interface FailureSignatureInput {
   readonly top_frame_raw_line?: number;
 }
 /** @public */
-declare const normalizeAssertionShape: (message: string) => string | null;
+export declare const normalizeAssertionShape: (message: string) => string | null;
 /** @public */
-declare const computeFailureSignature: (input: FailureSignatureInput) => string;
+export declare const computeFailureSignature: (input: FailureSignatureInput) => string;
 //#endregion
 //#region src/utils/format-console.d.ts
 /**
@@ -5096,7 +5678,7 @@ declare const computeFailureSignature: (input: FailureSignatureInput) => string;
  *
  * @internal
  */
-interface ConsoleFormatOptions {
+export interface ConsoleFormatOptions {
   /** Output verbosity: `"failures"` (default), `"full"`, or `"silent"`. */
   consoleOutput: "failures" | "full" | "silent";
   /** Maximum number of low-coverage files to show in console output. */
@@ -5132,7 +5714,7 @@ interface ConsoleFormatOptions {
  *
  * @internal
  */
-declare function getWorstMetric(f: FileCoverageReport): {
+export declare function getWorstMetric(f: FileCoverageReport): {
   label: string;
   pct: number;
 };
@@ -5146,7 +5728,7 @@ declare function getWorstMetric(f: FileCoverageReport): {
  *
  * @internal
  */
-declare function relativePath(filePath: string, cwd?: string): string;
+export declare function relativePath(filePath: string, cwd?: string): string;
 /**
  * Determine the output tier based on test results and coverage state.
  *
@@ -5156,7 +5738,7 @@ declare function relativePath(filePath: string, cwd?: string): string;
  *
  * @internal
  */
-declare function determineTier(report: AgentReport): "green" | "yellow" | "red";
+export declare function determineTier(report: AgentReport): "green" | "yellow" | "red";
 /**
  * Format an {@link (AgentReport:variable)} as compact, actionable console markdown.
  *
@@ -5179,7 +5761,7 @@ declare function determineTier(report: AgentReport): "green" | "yellow" | "red";
  *
  * @internal
  */
-declare function formatConsoleMarkdown(report: AgentReport, options: ConsoleFormatOptions): string;
+export declare function formatConsoleMarkdown(report: AgentReport, options: ConsoleFormatOptions): string;
 //#endregion
 //#region src/utils/format-fatal-error.d.ts
 /**
@@ -5193,7 +5775,7 @@ declare function formatConsoleMarkdown(report: AgentReport, options: ConsoleForm
  *
  * @public
  */
-declare function formatFatalError(err: unknown): string;
+export declare function formatFatalError(err: unknown): string;
 //#endregion
 //#region src/utils/format-gfm.d.ts
 /**
@@ -5218,7 +5800,7 @@ declare function formatFatalError(err: unknown): string;
  *
  * @public
  */
-declare function formatGfm(reports: AgentReport[]): string;
+export declare function formatGfm(reports: AgentReport[]): string;
 //#endregion
 //#region src/utils/format-scoped-coverage-note.d.ts
 /**
@@ -5239,11 +5821,11 @@ declare function formatGfm(reports: AgentReport[]): string;
  * @returns the note text, e.g. `"Coverage thresholds skipped: partial run (2 of 47 test files)"`
  * @public
  */
-declare function formatScopedCoverageNote(testedFileCount: number, totalFileCount?: number): string;
+export declare function formatScopedCoverageNote(testedFileCount: number, totalFileCount?: number): string;
 //#endregion
 //#region src/utils/function-boundary.d.ts
 /** @public */
-interface FunctionBoundary {
+export interface FunctionBoundary {
   readonly line: number;
   readonly name: string;
 }
@@ -5256,15 +5838,15 @@ interface FunctionBoundary {
  * casts are all accepted.
  * @public
  */
-declare const findFunctionBoundary: (source: string, line: number) => FunctionBoundary | null;
+export declare const findFunctionBoundary: (source: string, line: number) => FunctionBoundary | null;
 //#endregion
 //#region src/utils/hyperlink.d.ts
 /** @public */
-interface Osc8Options {
+export interface Osc8Options {
   readonly enabled: boolean;
 }
 /** @public */
-declare const osc8: (url: string, label: string, options: Osc8Options) => string;
+export declare const osc8: (url: string, label: string, options: Osc8Options) => string;
 //#endregion
 //#region src/utils/match-vitest-command.d.ts
 /**
@@ -5274,7 +5856,7 @@ declare const osc8: (url: string, label: string, options: Osc8Options) => string
  * (computed once per project and cached by the sidecar).
  * @public
  */
-declare const isVitestInvocation: (command: string, vitestScripts: ReadonlySet<string>) => boolean;
+export declare const isVitestInvocation: (command: string, vitestScripts: ReadonlySet<string>) => boolean;
 /**
  * Build the env-var prefix string to prepend to a matched command.
  *
@@ -5286,7 +5868,7 @@ declare const isVitestInvocation: (command: string, vitestScripts: ReadonlySet<s
  * Bash calls, no risk of cross-contamination.
  * @public
  */
-declare const buildEnvPrefix: (input: {
+export declare const buildEnvPrefix: (input: {
   readonly conversationId: string;
   readonly agentId: string;
   readonly parentAgentId?: string;
@@ -5297,7 +5879,7 @@ declare const buildEnvPrefix: (input: {
  * unchanged. When it matches, prepends the env prefix.
  * @public
  */
-declare const rewriteBashCommand: (input: {
+export declare const rewriteBashCommand: (input: {
   readonly command: string;
   readonly vitestScripts: ReadonlySet<string>;
   readonly conversationId: string;
@@ -5312,7 +5894,7 @@ declare const rewriteBashCommand: (input: {
  * is a documented limitation.
  * @public
  */
-declare const detectVitestScripts: (scripts: Record<string, string>) => Set<string>;
+export declare const detectVitestScripts: (scripts: Record<string, string>) => Set<string>;
 //#endregion
 //#region src/utils/normalize-workspace-key.d.ts
 /**
@@ -5342,11 +5924,11 @@ declare const detectVitestScripts: (scripts: Record<string, string>) => Set<stri
  * @returns A filesystem-safe single path segment.
  * @public
  */
-declare function normalizeWorkspaceKey(name: string): string;
+export declare function normalizeWorkspaceKey(name: string): string;
 //#endregion
 //#region src/utils/probe-host-metadata.d.ts
 /** @public */
-interface HostMetadataResult {
+export interface HostMetadataResult {
   readonly source: string | null;
   readonly value: string | null;
   readonly metadata: Record<string, unknown> | null;
@@ -5371,19 +5953,19 @@ interface HostMetadataResult {
  * 9. `process.ppid` walk (handled by the Live layer)
  * @public
  */
-declare const probeHostMetadataFromEnv: (env: Record<string, string | undefined>) => HostMetadataResult;
+export declare const probeHostMetadataFromEnv: (env: Record<string, string | undefined>) => HostMetadataResult;
 //#endregion
 //#region src/utils/resolve-data-path.d.ts
 /**
  * Filename of the SQLite database that stores all reporter data.
  * @public
  */
-declare const DATABASE_FILENAME = "data.db";
+export declare const DATABASE_FILENAME = "data.db";
 /**
  * Caller-supplied overrides for `resolveDataPath`.
  * @public
  */
-interface ResolveDataPathOptions {
+export interface ResolveDataPathOptions {
   /**
    * Programmatic override for the entire data directory. Highest precedence.
    *
@@ -5423,7 +6005,7 @@ interface ResolveDataPathOptions {
  * @param options - Optional programmatic overrides.
  * @public
  */
-declare const resolveDataPath: (projectDir: string, options?: ResolveDataPathOptions) => Effect.Effect<any, import("@effected/xdg").AppDirsError | import("effect/PlatformError").PlatformError | import("@effected/config-file").ConfigReadError, AppDirs | FileSystem.FileSystem | VitestAgentConfigFile>;
+export declare const resolveDataPath: (projectDir: string, options?: ResolveDataPathOptions) => Effect.Effect<any, import("@effected/xdg").AppDirsError | import("effect/PlatformError").PlatformError | import("@effected/config-file").ConfigReadError, AppDirs | FileSystem.FileSystem | VitestAgentConfigFile>;
 //#endregion
 //#region src/utils/resolve-project-key-from-cwd.d.ts
 /**
@@ -5436,7 +6018,7 @@ declare const resolveDataPath: (projectDir: string, options?: ResolveDataPathOpt
  * empty case.
  * @public
  */
-declare const resolveProjectKeyFromCwd: (cwd: string) => string;
+export declare const resolveProjectKeyFromCwd: (cwd: string) => string;
 //#endregion
 //#region src/utils/resolve-workspace-key.d.ts
 /**
@@ -5464,7 +6046,7 @@ declare const resolveProjectKeyFromCwd: (cwd: string) => string;
  *   reporter's resolved `projectDir` (CLAUDE_PROJECT_DIR or process.cwd()).
  * @public
  */
-declare const resolveWorkspaceKey: (projectDir: string) => Effect.Effect<string, WorkspaceRootNotFoundError | WorkspaceDiscoveryFailure, WorkspaceDiscovery>;
+export declare const resolveWorkspaceKey: (projectDir: string) => Effect.Effect<string, WorkspaceRootNotFoundError | WorkspaceDiscoveryFailure, WorkspaceDiscovery>;
 //#endregion
 //#region src/utils/safe-filename.d.ts
 /**
@@ -5493,17 +6075,17 @@ declare const resolveWorkspaceKey: (projectDir: string) => Effect.Effect<string,
  *
  * @public
  */
-declare function safeFilename(name: string): string;
+export declare function safeFilename(name: string): string;
 //#endregion
 //#region src/utils/test-location.d.ts
 /** Directory holding source files whose tests may be co-located. @public */
-declare const SRC_DIR = "src";
+export declare const SRC_DIR = "src";
 /** Canonical test directory name. @public */
-declare const TEST_DIR = "__test__";
+export declare const TEST_DIR = "__test__";
 /** Support directories under `__test__/` that are never collected. @public */
-declare const TEST_HELPER_DIRS: readonly ["fixtures", "snapshots", "utils"];
+export declare const TEST_HELPER_DIRS: readonly ["fixtures", "snapshots", "utils"];
 /** Glob suffix matching every discoverable test file. @public */
-declare const TEST_FILE_GLOB_SUFFIX = "*.{test,spec}.{ts,tsx,js,jsx}";
+export declare const TEST_FILE_GLOB_SUFFIX = "*.{test,spec}.{ts,tsx,js,jsx}";
 /**
  * Directory names discovery never walks into, and therefore never collects
  * tests from. Keep in step with {@link TEST_FILE_GLOB_SUFFIX}'s extension set:
@@ -5516,7 +6098,7 @@ declare const TEST_FILE_GLOB_SUFFIX = "*.{test,spec}.{ts,tsx,js,jsx}";
  * any path that crosses one.
  * @public
  */
-declare const NON_DISCOVERABLE_DIRS: ReadonlySet<string>;
+export declare const NON_DISCOVERABLE_DIRS: ReadonlySet<string>;
 /**
  * True when `filePathOrName` ends in a discoverable test-file suffix — the
  * extension half of the layout rule, matching {@link TEST_FILE_GLOB_SUFFIX}.
@@ -5526,7 +6108,7 @@ declare const NON_DISCOVERABLE_DIRS: ReadonlySet<string>;
  * when the answer has to account for where the file sits.
  * @public
  */
-declare function isTestFileName(filePathOrName: string): boolean;
+export declare function isTestFileName(filePathOrName: string): boolean;
 /**
  * Outcome of classifying a path against the test-layout rule.
  *
@@ -5535,15 +6117,15 @@ declare function isTestFileName(filePathOrName: string): boolean;
  * - `invalid` — not a legal test location.
  * @public
  */
-type TestPathVerdict = "valid" | "excluded" | "invalid";
+export type TestPathVerdict = "valid" | "excluded" | "invalid";
 /** Result of {@link classifyTestPath}. @public */
-interface TestPathClassification {
+export interface TestPathClassification {
   readonly verdict: TestPathVerdict;
   readonly workspace: string | null;
   readonly suggestedPath: string | null;
 }
 /** Minimal workspace shape {@link classifyTestPath} needs to attribute a path. @public */
-interface WorkspaceLike {
+export interface WorkspaceLike {
   readonly name: string;
   readonly path: string;
 }
@@ -5557,7 +6139,7 @@ interface WorkspaceLike {
  * agree with {@link classifyTestPath} about which package owns it.
  * @public
  */
-declare function findOwningWorkspace(workspaces: ReadonlyArray<WorkspaceLike>, filePath: string): WorkspaceLike | null;
+export declare function findOwningWorkspace(workspaces: ReadonlyArray<WorkspaceLike>, filePath: string): WorkspaceLike | null;
 /**
  * Classifies `filePath` against the test-layout rule: a test file is
  * discoverable only at `<workspace>/src/**` or `<workspace>/__test__/**`,
@@ -5575,28 +6157,28 @@ declare function findOwningWorkspace(workspaces: ReadonlyArray<WorkspaceLike>, f
  * when it fires — `@vitest-agent/cli`'s `agent check-test-path` does.
  * @public
  */
-declare function classifyTestPath(workspaces: ReadonlyArray<WorkspaceLike>, filePath: string): TestPathClassification | null;
+export declare function classifyTestPath(workspaces: ReadonlyArray<WorkspaceLike>, filePath: string): TestPathClassification | null;
 //#endregion
 //#region src/utils/validate-coverage-targets-shape.d.ts
 /** @public */
-interface CoverageTargetsShapeError {
+export interface CoverageTargetsShapeError {
   readonly code: string;
   readonly path: string;
   readonly message: string;
 }
 /** @public */
-interface CoverageTargetsShapeWarning {
+export interface CoverageTargetsShapeWarning {
   readonly code: string;
   readonly path: string;
   readonly message: string;
 }
 /** @public */
-interface CoverageTargetsShapeInfo {
+export interface CoverageTargetsShapeInfo {
   readonly code: string;
   readonly message: string;
 }
 /** @public */
-interface CoverageTargetsShapeResult {
+export interface CoverageTargetsShapeResult {
   readonly errors: ReadonlyArray<CoverageTargetsShapeError>;
   readonly warnings: ReadonlyArray<CoverageTargetsShapeWarning>;
   readonly info: ReadonlyArray<CoverageTargetsShapeInfo>;
@@ -5610,14 +6192,16 @@ interface CoverageTargetsShapeResult {
  *   OR a literal `true` appears at any key other than `"100"`. The
  *   offending `path` is included (e.g. `"lines"`, `"src/**.ts.lines"`,
  *   or `"statements"` when misused as a boolean shortcut).
- * - `PERFILE_ON_TARGETS` — the `perFile` key appears inside coverageTargets;
- *   it should be set on `coverage.thresholds.perFile` instead.
+ * - `PERFILE_ON_TARGETS` — a top-level `perFile` key appears in
+ *   coverageTargets; the top-level setting belongs on
+ *   `coverage.thresholds.perFile`. A `perFile` inside a glob-pattern entry
+ *   is legal and is not reported.
  *
  * @param input - The raw value passed as coverageTargets.
  * @returns A result object with errors, warnings, and info arrays.
  * @public
  */
-declare function validateCoverageTargetsShape(input: unknown): CoverageTargetsShapeResult;
+export declare function validateCoverageTargetsShape(input: unknown): CoverageTargetsShapeResult;
 //#endregion
 //#region src/index.d.ts
 /**
@@ -5628,7 +6212,7 @@ declare function validateCoverageTargetsShape(input: unknown): CoverageTargetsSh
  * substituted yet. Exported for version introspection by downstream tooling.
  * @public
  */
-declare const CURRENT_SDK_VERSION: string;
+export declare const CURRENT_SDK_VERSION: string;
 //#endregion
-export { AcceptanceMetrics, ActionSeverity, ActorType, Agent, AgentConsoleMode, AgentContext, AgentId, AgentNotFoundError, AgentPluginOptions, AgentReport, AgentReporterOptions, AgentTreeNode, AnsiOptions, ArtifactKind, ArtifactSuite, AssembledHistoryRecord, AssociateRunSessionInput, BehaviorAbandonedEvent, BehaviorAddedEvent, BehaviorCompletedEvent, BehaviorDetail, BehaviorNotFoundError, BehaviorRow, BehaviorScopedEventType, BehaviorScopedEventTypes, BehaviorStartedEvent, BehaviorStatus, BehaviorsReadyEvent, BlockedEvent, CURRENT_SDK_VERSION, CacheManifest, CacheManifestEntry, CandidateContext, CellOptions, ChangeKind, ChannelEvent, ChatId, CiConsoleMode, CitedArtifact, CitedArtifactRow, ClassificationQueryOptions, CommitChangesEntry, ConfigLive, ConsoleFormatOptions, ConsoleLeakEntry, ConsoleLeakFile, ConsoleLeakTask, ConsoleLeaks, ConsoleLeaksFromFailingTests, ConsoleLogLevel, ConsoleMode, ConsoleOutputMode, ConsoleOutputs, ConversationId, ConversationNotFoundError, CoverageBaselines, FileCoverageReport as CoverageFile, FileCoverageReport, CoverageGap, CoverageInput, CoverageLevel, CoverageLevelName, CoverageMetric, CoverageRenderState, CoverageReport, CoverageTargets, CoverageTargetsMetrics, CoverageTargetsShapeError, CoverageTargetsShapeInfo, CoverageTargetsShapeResult, CoverageTargetsShapeWarning, CoverageTotals, CreateBehaviorInput, CreateGoalInput, CurrentTddPhase, DATABASE_FILENAME, DataReader, DataReaderLive, DataStore, DataStoreError, DataStoreLive, DenialReason, DetailLevel, DetailResolver, DetailResolverLive, DiscoveryError, DiscoveryRegistry, DiscoveryRegistryLive, DispatchInputs, EndTddTaskInput, Environment, EnvironmentDetector, EnvironmentDetectorLive, EnvironmentDetectorTest, Executor, ExecutorResolver, ExecutorResolverLive, FailureRecord, FailureSignatureDetail, FailureSignatureInput, FailureSignatureWriteInput, FileCoverageInput, FileEditPayload, FileSystemAdapter, FlakyTest, FormatSelector, FormatSelectorLive, type FormatTriageOptions, type FormatWrapupOptions, Formatter, FormatterContext, FunctionBoundary, GfmFormatter, GitCommandError, GoalAbandonedEvent, GoalAddedEvent, GoalCompletedEvent, GoalDetail, GoalNotFoundError, GoalRow, GoalStartedEvent, GoalStatus, GoalsReadyEvent, HistoryQueryOptions, HistoryRecord, HistoryRow, HistoryTracker, HistoryTrackerLive, HistoryTrackerTest, HistoryTrackerTestState, HookFirePayload, HookStatus, HookType, HostKind, HostMetadataParseError, HostMetadataResult, HumanConsoleMode, HypothesisDetail, HypothesisInput, HypothesisPayload, IDEMPOTENCY_ROOT_SENTINEL, IdempotencyHit, IdempotencyInput, IdempotentResponseInput, IllegalStatusTransitionEntity, IllegalStatusTransitionError, JsonFormatter, KnownProject, KnownProjectInput, LoggerLive, ManifestRow, MapSessionInput, MapSessionOutput, MarkdownFormatter, MetricThresholds, ModuleInput, ModuleListEntry, ModuleRecord, ModuleReport, NON_DISCOVERABLE_DIRS, NoteInput, NotePayload, NoteRow, Osc8Options, OutputFormat, OutputPipelineLive, OutputRenderer, OutputRendererLive, PackageManager, PathResolutionError, PathResolutionLive, PatternThresholds, PerClientSessionMapReader, PerClientSessionMapReaderLive, PerClientSessionMapWriter, PerClientSessionMapWriterLive, PersistentFailure, Phase, PhaseTransitionContext, PhaseTransitionEvent, PhaseTransitionResult, ProbeMissError, ProjectDiscovery, ProjectDiscoveryLive, ProjectDiscoveryTest, ProjectIdentity, ProjectIdentityCandidate, ProjectIdentityCandidates, ProjectIdentityLive, ProjectIdentityNotResolvableError, ProjectIdentitySource, ProjectIdentityTest, ProjectKey, ProjectRunSummary, ProjectSummary, RegisterAgentInput, RegisterAgentResult, RegistrationConflictError, Remediation, RenderState, RenderTotals, RenderedOutput, ReportError, ReportSummary, ReporterKit, ReporterRenderInput, ResolveDataPathOptions, ResolveProjectIdentityOptions, ResolvedIdentity, ResolvedReporterConfig, ResolvedThresholds, RunChangedFile, RunContext, RunContext$, RunContextLive, RunContextService, RunContextTest, RunEvent, RunEventByTag, RunHealth, RunInvocationMethod, RunOutcome, RunShape, SRC_DIR, SessionCompleteEvent, SessionContextRow, SessionDetail, SessionInput, SessionNotFoundError, SessionOutcome, SettingsInput, SettingsListEntry, SettingsRow, SidecarTimeoutError, SilentFormatter, StackFrameInput, SuggestedActionRecord, SuiteInput, SuiteListEntry, TEST_DIR, TEST_FILE_GLOB_SUFFIX, TEST_HELPER_DIRS, TagCountEntry, TagInventoryRow, TddArtifactDetail, TddArtifactRow, TddPhaseDetail, TddTaskAlreadyEndedError, TddTaskDetail, TddTaskEndOutcome, TddTaskId, TddTaskInput, TddTaskNotFoundError, TddTaskSummary, TerminalFormatter, TestCaseInput, TestClassification, TestError, TestErrorInput, TestFileEntry, TestHistory, TestListEntry, TestLookupOptions, TestOutcome, TestPathClassification, TestPathVerdict, TestRecord, TestReport, TestRun, TestRunInput, TestRunReason, TestState, ToolCallPayload, ToolResultPayload, Transport, TrendEntry, TrendRecord, TrendSummary, TurnInput, TurnPayload, TurnSearchOptions, TurnSummary, UpdateBehaviorInput, UpdateGoalInput, UserPromptPayload, ValidateHypothesisInput, VitestAgentConfig, VitestAgentConfigFile, VitestAgentConfigFileService, VitestAgentReporter, VitestAgentReporterFactory, VitestModuleDiagnostic, VitestModuleError, VitestParsedStack, VitestTestCase, VitestTestDiagnostic, VitestTestError, VitestTestModule, VitestTestResult, VitestTestSuite, WorkspaceLike, type WrapupKind, WriteCommitInput, WriteRunChangedFilesInput, WriteTddArtifactInput, WriteTddPhaseInput, WriteTddPhaseOutput, _resetMigrationCacheForTesting, ansi, assembleHistoryRecord, assembleManifest, buildAgentReport, buildConsoleLeaks, buildEnvPrefix, canonicalizeGitUrl, ciAnnotationsFormatter, classifyTest, classifyTestPath, coerceErrorField, coerceErrorText, collectConsoleLeakEntries, compressLines, computeFailureSignature, computeTrend, countSuiteFailures, deriveIdempotencyKey, detectNonDefaultDiscoverStrategy, detectPackageManager, detectVitestScripts, determineTier, ensureMigrated, extractSqlReason, findFunctionBoundary, findOwningWorkspace, formatConsoleMarkdown, formatFatalError, formatGfm, formatScopedCoverageNote, formatTriageEffect, formatWrapupEffect, getRecentDirection, getRunCommand, getWorstMetric, gitUrlToProjectKey, hashTargets, historyKey, initialRenderState, isTestFileName, isTimeoutError, isVitestInvocation, migration as migration0001, normalizeAssertionShape, normalizeWorkspaceKey, osc8, probeHostMetadataFromEnv, migration$1 as registryMigration0001, relativePath, requiredArtifactForTransition, resolveCoverageInput, resolveDataPath, resolveLogFile, resolveLogLevel, resolveProjectIdentityFromCandidates, resolveProjectKeyFromCwd, resolveWorkspaceKey, rewriteBashCommand, safeFilename, migration$2 as sessionMapMigration0001, stripAnsi, transitionEnforcesBehaviorMatch, validateCoverageConfig, validateCoverageTargetsShape, validatePhaseTransition };
+export { FileCoverageReport as CoverageFile, type FormatTriageOptions, type FormatWrapupOptions, type WrapupKind, migration as migration0001, migration$1 as migration0002, migration$2 as registryMigration0001, migration$3 as sessionMapMigration0001 };
 //# sourceMappingURL=index.d.ts.map