@vitest-agent/sdk 2.5.1 → 3.0.0

package/index.d.ts

@@ -56,6 +56,12 @@ export 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 @@ export 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 @@ export 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>;
@@ -706,6 +724,12 @@ export 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 @@ export 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 @@ export 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>;
@@ -910,12 +946,29 @@ export declare const ReportError: Schema.Struct<{
 export type ReportError = typeof ReportError.Type;
 //#endregion
 //#region src/formatters/types.d.ts
-/** @public */
-export 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 */
 export interface FormatterContext {
   readonly detail: DetailLevel;
@@ -1087,11 +1140,36 @@ export declare const RunEvent: Schema.Union<readonly [Schema.TaggedStruct<"RunSt
   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>;
@@ -1191,6 +1269,43 @@ export declare const MetricThresholds: Schema.Struct<{
 }>;
 /** @public */
 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
@@ -1200,6 +1315,12 @@ export declare const PatternThresholds: Schema.Tuple<readonly [Schema.String, Sc
   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 PatternThresholds = typeof PatternThresholds.Type;
@@ -1214,12 +1335,23 @@ export declare const ResolvedThresholds: Schema.Struct<{
     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 */
@@ -1929,6 +2061,12 @@ export 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 */
@@ -2472,6 +2610,48 @@ export 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 */
 export interface FileCoverageInput {
   readonly fileId: number;
@@ -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>;
@@ -3111,6 +3302,45 @@ export 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>;
@@ -3844,6 +4078,31 @@ export declare const formatWrapupEffect: (options: FormatWrapupOptions) => Effec
 /** @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,11 +4118,11 @@ 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 */
@@ -4225,7 +4484,8 @@ export declare function validateCoverageConfig(thresholds: CoverageLevel, target
 //#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
  */
 export declare const CoverageTargetsMetrics: Schema.Struct<{
@@ -4234,6 +4494,12 @@ export declare const CoverageTargetsMetrics: 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>;
+  }>]>>;
 }>;
 /** @public */
 export type CoverageTargetsMetrics = typeof CoverageTargetsMetrics.Type;
@@ -4243,8 +4509,10 @@ export type CoverageTargetsMetrics = typeof CoverageTargetsMetrics.Type;
  * 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
@@ -4258,6 +4526,12 @@ export declare const CoverageTargets: Schema.$Record<Schema.String, Schema.Union
   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 */
 export type CoverageTargets = typeof CoverageTargets.Type;
@@ -4285,13 +4559,36 @@ export declare const ConsoleOutputs: Schema.Struct<{
 }>;
 /** @public */
 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
  */
 export declare const AgentPluginOptions: Schema.Struct<{
@@ -4306,10 +4603,19 @@ export 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 */
 export type AgentPluginOptions = typeof AgentPluginOptions.Type;
@@ -4331,6 +4637,282 @@ export declare const AgentReporterOptions: Schema.Struct<{
 /** @public */
 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 */
 export declare const FileEditPayload: Schema.Struct<{
@@ -5610,8 +6192,10 @@ export 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.
@@ -5630,5 +6214,5 @@ export declare function validateCoverageTargetsShape(input: unknown): CoverageTa
  */
 export declare const CURRENT_SDK_VERSION: string;
 //#endregion
-export { FileCoverageReport as CoverageFile, type FormatTriageOptions, type FormatWrapupOptions, type WrapupKind, migration as migration0001, migration$1 as registryMigration0001, migration$2 as sessionMapMigration0001 };
+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