@vitest-agent/sdk 7.0.5 → 7.1.0

package/index.d.ts

@@ -1,4 +1,4 @@
-import { PubSub, Schema } from "effect";
+import { Option, PubSub, Schema } from "effect";
 /**
  * Aggregate coverage percentages across four istanbul metrics.
  * @public
@@ -1517,6 +1517,21 @@ export interface ResolvedReporterConfig {
    * @internal
    */
   readonly coverageMode: "full" | "ui-only";
+  /**
+   * Whether this run is recorded in the SQLite `data.db` (issue #625).
+   * `false` when the user passed `AgentPlugin({ persist: false })` or
+   * the `VITEST_AGENT_PERSIST` operator override turned persistence
+   * off: the run still renders, but classifications are empty and
+   * coverage carries no baseline delta or trend, because there is no
+   * history to read. Independent of `coverageMode` — a UI-only run
+   * (`coverage.enabled: false`) skips persistence too, with this field
+   * still reporting what the user asked for.
+   *
+   * The plugin always populates it; it is optional only because a
+   * consumer constructing `ResolvedReporterConfig` by hand may omit it,
+   * in which case treat it as `true`.
+   */
+  readonly persist?: boolean;
   readonly detail: DetailLevel;
   readonly noColor: boolean;
   readonly runCommand?: string;
@@ -2395,16 +2410,46 @@ export type ChannelEvent = typeof ChannelEvent.Type;
 export declare const BehaviorScopedEventTypes: readonly ["behavior_started", "phase_transition", "behavior_completed", "behavior_abandoned", "blocked"];
 /** @public */
 export type BehaviorScopedEventType = (typeof BehaviorScopedEventTypes)[number];
+declare const RetentionConfig_base: Schema.Class<RetentionConfig, Schema.Struct<{
+  readonly enabled: Schema.optionalKey<Schema.Boolean>;
+  readonly keepRuns: Schema.optionalKey<Schema.Int>;
+  readonly maxAgeDays: Schema.optionalKey<Schema.Int>;
+}>, {}>;
+/**
+ * The optional `[retention]` table of `vitest-agent.config.toml`: how many
+ * `test_runs` rows (and their cascaded modules, cases, errors, coverage
+ * rows) the per-project `data.db` keeps.
+ *
+ * Every field is optional. An absent table means the default policy
+ * (`RunRetentionPolicy.DEFAULT_KEEP_RUNS` newest runs per project, no age
+ * limit); `enabled = false` turns run pruning off entirely.
+ *
+ * Fields:
+ * - `enabled` — `false` disables run retention. Defaults to `true`.
+ * - `keepRuns` — the newest N runs per project to keep. A positive integer;
+ *   defaults to `RunRetentionPolicy.DEFAULT_KEEP_RUNS`.
+ * - `maxAgeDays` — additionally drop any run older than this many days,
+ *   even inside the newest N. A positive integer; no age limit by default.
+ *
+ * @remarks
+ * `keepRuns = 0` is rejected rather than read as "keep nothing": the run
+ * being written is always kept, and `enabled = false` is the explicit
+ * off switch, so a zero would have two readings.
+ * @public
+ */
+export declare class RetentionConfig extends RetentionConfig_base {}
 declare const VitestAgentConfig_base: Schema.Class<VitestAgentConfig, Schema.Struct<{
   readonly cacheDir: Schema.optional<Schema.String>;
   readonly projectKey: Schema.optional<Schema.String>;
+  readonly retention: Schema.optionalKey<typeof RetentionConfig>;
 }>, {}>;
 /**
  * Schema for the optional `vitest-agent.config.toml` file.
  *
- * Both fields are optional. When the file is absent or these fields are
+ * Every field is optional. When the file is absent or these fields are
  * unset, `resolveDataPath` falls back to deriving the path from the
- * workspace's `package.json` `name` under the XDG data directory.
+ * workspace's `package.json` `name` under the XDG data directory, and run
+ * retention uses the default policy.
  *
  * Fields:
  * - `cacheDir` — absolute path overriding the entire data directory. Highest
@@ -2415,9 +2460,39 @@ declare const VitestAgentConfig_base: Schema.Class<VitestAgentConfig, Schema.Str
  *   directory. Use this when two unrelated projects on the same machine
  *   share a `package.json` `name` (the collision case for workspace-name
  *   keying), or when you want a stable key independent of `name` changes.
+ * - `retention` — the `[retention]` table; see `RetentionConfig`.
  * @public
  */
 export declare class VitestAgentConfig extends VitestAgentConfig_base {}
+declare const RunRetentionPolicy_base: Schema.Class<RunRetentionPolicy, Schema.Struct<{
+  readonly keepRuns: Schema.Int;
+  readonly maxAgeDays: Schema.optionalKey<Schema.Int>;
+}>, {}>;
+/**
+ * The resolved run-retention policy a `data.db` prune applies: keep the
+ * newest `keepRuns` runs of every project, and drop any run older than
+ * `maxAgeDays` days when set. The run being persisted is never pruned.
+ *
+ * @remarks
+ * The default of 200 runs per project is sized against what reads the
+ * data: failure classification reads the newest 10 `test_history` rows per
+ * test and coverage trends keep 50 entries, so 200 leaves both a wide
+ * margin while bounding a 7k-test suite (about 3 MB per run) to a few
+ * hundred megabytes instead of growing without bound (issue 623, where an
+ * unpruned database reached 880 MB over 4,484 runs). `maxAgeDays` is the
+ * lever for a project that runs rarely but wants a calendar bound.
+ * @public
+ */
+export declare class RunRetentionPolicy extends RunRetentionPolicy_base {
+  /** Newest runs per project kept when the config names no `keepRuns`. */
+  static readonly DEFAULT_KEEP_RUNS = 200;
+  /**
+   * Resolve the policy a loaded config asks for: `Option.none()` when
+   * `retention.enabled` is `false`, otherwise the configured values over
+   * the defaults.
+   */
+  static fromConfig(config: VitestAgentConfig): Option.Option<RunRetentionPolicy>;
+}
 /**
  * Per-file stray-console-output detail. Counts are of console writes
  * (one `console.*` call), not lines.
@@ -2676,10 +2751,10 @@ export type ReportOption = typeof ReportOption.Type;
 /**
  * The 2.0 user-facing options for `AgentPlugin`.
  *
- * Six fields total. Two are function-typed (`reporter`, `onRunEvent`)
+ * Seven 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 four data-shaped fields.
+ * so the schema-decodable struct carries the five data-shaped fields.
  * @public
  */
 export declare const AgentPluginOptions: Schema.Struct<{
@@ -2707,6 +2782,34 @@ export declare const AgentPluginOptions: Schema.Struct<{
   readonly report: Schema.optional<Schema.Union<readonly [Schema.Literal<false>, Schema.Struct<{
     readonly scope: Schema.optional<Schema.String>;
   }>]>>;
+  /**
+   * Whether a run is recorded in the SQLite `data.db` (default `true`).
+   *
+   * `false` is the explicit opt-out for a runner where nothing reads the
+   * database back — a throwaway CI job, say. The run still renders every
+   * console and report-file output, still emits every `RunEvent`, and
+   * Vitest still enforces `coverage.thresholds` through its own
+   * mechanism; only the database writes are skipped: run rows, test
+   * cases, failure history, coverage rows and trends, and the baselines
+   * they feed. Consequences a renderer sees: failure classifications are
+   * empty (there is no history to classify against, so no test is
+   * labelled `stable`, `new-failure`, `persistent`, `flaky` or
+   * `recovered`), and coverage renders without a baseline delta or a
+   * trend line. The `data.db` file is never created or opened.
+   *
+   * The opt-out is never automatic: `CI=true` does not imply it, because
+   * some CI setups cache `data.db` between jobs and query it. The
+   * `VITEST_AGENT_PERSIST` environment variable (`0` / `false` / `off`
+   * to disable, `1` / `true` / `on` to enable) is the operator spelling
+   * for a runner whose config cannot be edited, and it wins over this
+   * option in either direction; any other value is ignored with one
+   * stderr line.
+   *
+   * `coverage.enabled: false` in Vitest's own config already skips
+   * persistence (UI-only mode, Decision 38) — this option is for a run
+   * that keeps coverage on and still wants no database.
+   */
+  readonly persist: Schema.optional<Schema.Boolean>;
 }>;
 /** @public */
 export type AgentPluginOptions = typeof AgentPluginOptions.Type;

package/index.js

@@ -16,7 +16,7 @@ import { AgentReport, ModuleReport, ReportSummary, TagCountEntry, TestReport } f
 import { CoverageBaselines } from "./schemas/Baselines.js";
 import { CacheManifest, CacheManifestEntry } from "./schemas/CacheManifest.js";
 import { BehaviorAbandonedEvent, BehaviorAddedEvent, BehaviorCompletedEvent, BehaviorScopedEventTypes, BehaviorStartedEvent, BehaviorsReadyEvent, BlockedEvent, ChannelEvent, GoalAbandonedEvent, GoalAddedEvent, GoalCompletedEvent, GoalStartedEvent, GoalsReadyEvent, PhaseTransitionEvent, SessionCompleteEvent, SessionOutcome } from "./schemas/ChannelEvent.js";
-import { VitestAgentConfig } from "./schemas/Config.js";
+import { RetentionConfig, RunRetentionPolicy, VitestAgentConfig } from "./schemas/Config.js";
 import { CoverageLevel, resolveCoverageInput, validateCoverageConfig } from "./schemas/CoverageLevel.js";
 import { CoverageTargets, CoverageTargetsMetrics } from "./schemas/CoverageTargets.js";
 import { HistoryRecord, TestHistory, TestRun } from "./schemas/History.js";
@@ -64,4 +64,4 @@ import { validateCoverageTargetsShape } from "./utils/validate-coverage-targets-
 import { requiredArtifactForTransition, transitionEnforcesBehaviorMatch, validatePhaseTransition } from "./utils/validate-phase-transition.js";
 import { CURRENT_SDK_VERSION } from "./version.js";
 
-export { ActionSeverity, ActorType, Agent, AgentConsoleMode, AgentId, AgentNotFoundError, AgentPluginOptions, AgentReport, AgentReporterOptions, BATS_FILE_GLOB_SUFFIX, BehaviorAbandonedEvent, BehaviorAddedEvent, BehaviorCompletedEvent, BehaviorDetail, BehaviorNotFoundError, BehaviorRow, BehaviorScopedEventTypes, BehaviorStartedEvent, BehaviorStatus, BehaviorsReadyEvent, BlockedEvent, CURRENT_SDK_VERSION, CacheManifest, CacheManifestEntry, ChannelEvent, ChatId, CiConsoleMode, ConsoleLeakFile, ConsoleLeaks, ConsoleLeaksFromFailingTests, ConsoleLogLevel, ConsoleMode, ConsoleOutputMode, ConsoleOutputs, ConversationId, ConversationNotFoundError, CoverageBaselines, FileCoverageReport as CoverageFile, CoverageGap, CoverageLevel, CoverageMetric, CoverageRenderState, CoverageReport, CoverageTargets, CoverageTargetsMetrics, CoverageTotals, DataStoreError, DetailLevel, DiscoveryError, Environment, Executor, FailureRecord, FileCoverageReport, FileEditPayload, GitCommandError, GlobShortfall, GoalAbandonedEvent, GoalAddedEvent, GoalCompletedEvent, GoalDetail, GoalNotFoundError, GoalRow, GoalStartedEvent, GoalStatus, GoalsReadyEvent, HistoryRecord, HookFirePayload, HookStatus, HookType, HostKind, HostMetadataParseError, HumanConsoleMode, HypothesisPayload, IdempotencyHit, IllegalStatusTransitionError, MetricThresholds, ModuleRecord, ModuleReport, NON_DISCOVERABLE_DIRS, NotePayload, PackageManager, PathResolutionError, PatternMetricThresholds, PatternThresholds, PerFileThresholds, PhaseTransitionEvent, ProbeMissError, ProjectIdentityNotResolvableError, ProjectKey, RUN_REPORT_FILE_SCHEMA_URL, RegistrationConflictError, RenderState, RenderTotals, ReportError, ReportOption, ReportSettings, ReportSummary, ResolvedThresholds, RunEvent, RunReportFile, SRC_DIR, STRAY_OUTPUT_SOURCE, SessionCompleteEvent, SessionNotFoundError, SessionOutcome, SidecarTimeoutError, StrayOutput, StrayOutputSample, SuggestedActionRecord, TEST_DIR, TEST_FILE_GLOB_SUFFIX, TEST_HELPER_DIRS, TagCountEntry, TddTaskAlreadyEndedError, TddTaskId, TddTaskNotFoundError, TestAnnotation, TestArtifact, TestArtifactLocation, TestAttachment, TestClassification, TestHistory, TestRecord, TestReport, TestRun, TestRunReason, TestState, ToolCallPayload, ToolResultPayload, Transport, TrendEntry, TrendRecord, TurnPayload, UserPromptPayload, VitestAgentConfig, ansi, basenamePosix, buildAgentReport, buildConsoleLeaks, buildEnvPrefix, canonicalizeGitUrl, classifyTest, classifyTestPath, coerceErrorField, coerceErrorText, collectConsoleLeakEntries, compressLines, computeTrend, countSuiteFailures, detectNonDefaultDiscoverStrategy, detectPackageManager, detectVitestScripts, determineTier, extractSqlReason, findFunctionBoundary, findOwningWorkspace, formatConsoleMarkdown, formatFatalError, formatGfm, formatScopedCoverageNote, formatStrayOutputNote, getRecentDirection, getRunCommand, getWorstMetric, gitUrlToProjectKey, hashTargets, initialRenderState, isEscapeOnly, isTestFileName, isTimeoutError, isVitestInvocation, joinPosix, makeStrayOutputRecorder, normalizeWorkspaceKey, osc8, probeHostMetadataFromEnv, readStrayOutput, relativePath, relativePosix, requiredArtifactForTransition, resolveCoverageInput, rewriteBashCommand, safeFilename, stripAnsi, toPosix, transitionEnforcesBehaviorMatch, validateCoverageConfig, validateCoverageTargetsShape, validatePhaseTransition };
+export { ActionSeverity, ActorType, Agent, AgentConsoleMode, AgentId, AgentNotFoundError, AgentPluginOptions, AgentReport, AgentReporterOptions, BATS_FILE_GLOB_SUFFIX, BehaviorAbandonedEvent, BehaviorAddedEvent, BehaviorCompletedEvent, BehaviorDetail, BehaviorNotFoundError, BehaviorRow, BehaviorScopedEventTypes, BehaviorStartedEvent, BehaviorStatus, BehaviorsReadyEvent, BlockedEvent, CURRENT_SDK_VERSION, CacheManifest, CacheManifestEntry, ChannelEvent, ChatId, CiConsoleMode, ConsoleLeakFile, ConsoleLeaks, ConsoleLeaksFromFailingTests, ConsoleLogLevel, ConsoleMode, ConsoleOutputMode, ConsoleOutputs, ConversationId, ConversationNotFoundError, CoverageBaselines, FileCoverageReport as CoverageFile, CoverageGap, CoverageLevel, CoverageMetric, CoverageRenderState, CoverageReport, CoverageTargets, CoverageTargetsMetrics, CoverageTotals, DataStoreError, DetailLevel, DiscoveryError, Environment, Executor, FailureRecord, FileCoverageReport, FileEditPayload, GitCommandError, GlobShortfall, GoalAbandonedEvent, GoalAddedEvent, GoalCompletedEvent, GoalDetail, GoalNotFoundError, GoalRow, GoalStartedEvent, GoalStatus, GoalsReadyEvent, HistoryRecord, HookFirePayload, HookStatus, HookType, HostKind, HostMetadataParseError, HumanConsoleMode, HypothesisPayload, IdempotencyHit, IllegalStatusTransitionError, MetricThresholds, ModuleRecord, ModuleReport, NON_DISCOVERABLE_DIRS, NotePayload, PackageManager, PathResolutionError, PatternMetricThresholds, PatternThresholds, PerFileThresholds, PhaseTransitionEvent, ProbeMissError, ProjectIdentityNotResolvableError, ProjectKey, RUN_REPORT_FILE_SCHEMA_URL, RegistrationConflictError, RenderState, RenderTotals, ReportError, ReportOption, ReportSettings, ReportSummary, ResolvedThresholds, RetentionConfig, RunEvent, RunReportFile, RunRetentionPolicy, SRC_DIR, STRAY_OUTPUT_SOURCE, SessionCompleteEvent, SessionNotFoundError, SessionOutcome, SidecarTimeoutError, StrayOutput, StrayOutputSample, SuggestedActionRecord, TEST_DIR, TEST_FILE_GLOB_SUFFIX, TEST_HELPER_DIRS, TagCountEntry, TddTaskAlreadyEndedError, TddTaskId, TddTaskNotFoundError, TestAnnotation, TestArtifact, TestArtifactLocation, TestAttachment, TestClassification, TestHistory, TestRecord, TestReport, TestRun, TestRunReason, TestState, ToolCallPayload, ToolResultPayload, Transport, TrendEntry, TrendRecord, TurnPayload, UserPromptPayload, VitestAgentConfig, ansi, basenamePosix, buildAgentReport, buildConsoleLeaks, buildEnvPrefix, canonicalizeGitUrl, classifyTest, classifyTestPath, coerceErrorField, coerceErrorText, collectConsoleLeakEntries, compressLines, computeTrend, countSuiteFailures, detectNonDefaultDiscoverStrategy, detectPackageManager, detectVitestScripts, determineTier, extractSqlReason, findFunctionBoundary, findOwningWorkspace, formatConsoleMarkdown, formatFatalError, formatGfm, formatScopedCoverageNote, formatStrayOutputNote, getRecentDirection, getRunCommand, getWorstMetric, gitUrlToProjectKey, hashTargets, initialRenderState, isEscapeOnly, isTestFileName, isTimeoutError, isVitestInvocation, joinPosix, makeStrayOutputRecorder, normalizeWorkspaceKey, osc8, probeHostMetadataFromEnv, readStrayOutput, relativePath, relativePosix, requiredArtifactForTransition, resolveCoverageInput, rewriteBashCommand, safeFilename, stripAnsi, toPosix, transitionEnforcesBehaviorMatch, validateCoverageConfig, validateCoverageTargetsShape, validatePhaseTransition };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vitest-agent/sdk",
-	"version": "7.0.5",
+	"version": "7.1.0",
 	"private": false,
 	"description": "Platform-free core for the vitest-agent package family: Effect Schema definitions, reporter and dispatcher contracts, errors, and pure utilities.",
 	"keywords": [

package/schemas/Config.js

@@ -1,12 +1,42 @@
-import { Schema } from "effect";
+import { Option, Schema } from "effect";
 
 // src/schemas/Config.ts
+/** A whole number of runs or days, at least one. */
+const PositiveInt = Schema.Int.check(Schema.isGreaterThanOrEqualTo(1));
+/**
+* The optional `[retention]` table of `vitest-agent.config.toml`: how many
+* `test_runs` rows (and their cascaded modules, cases, errors, coverage
+* rows) the per-project `data.db` keeps.
+*
+* Every field is optional. An absent table means the default policy
+* (`RunRetentionPolicy.DEFAULT_KEEP_RUNS` newest runs per project, no age
+* limit); `enabled = false` turns run pruning off entirely.
+*
+* Fields:
+* - `enabled` — `false` disables run retention. Defaults to `true`.
+* - `keepRuns` — the newest N runs per project to keep. A positive integer;
+*   defaults to `RunRetentionPolicy.DEFAULT_KEEP_RUNS`.
+* - `maxAgeDays` — additionally drop any run older than this many days,
+*   even inside the newest N. A positive integer; no age limit by default.
+*
+* @remarks
+* `keepRuns = 0` is rejected rather than read as "keep nothing": the run
+* being written is always kept, and `enabled = false` is the explicit
+* off switch, so a zero would have two readings.
+* @public
+*/
+var RetentionConfig = class extends Schema.Class("RetentionConfig")({
+	enabled: Schema.optionalKey(Schema.Boolean),
+	keepRuns: Schema.optionalKey(PositiveInt),
+	maxAgeDays: Schema.optionalKey(PositiveInt)
+}) {};
 /**
 * Schema for the optional `vitest-agent.config.toml` file.
 *
-* Both fields are optional. When the file is absent or these fields are
+* Every field is optional. When the file is absent or these fields are
 * unset, `resolveDataPath` falls back to deriving the path from the
-* workspace's `package.json` `name` under the XDG data directory.
+* workspace's `package.json` `name` under the XDG data directory, and run
+* retention uses the default policy.
 *
 * Fields:
 * - `cacheDir` — absolute path overriding the entire data directory. Highest
@@ -17,11 +47,48 @@ import { Schema } from "effect";
 *   directory. Use this when two unrelated projects on the same machine
 *   share a `package.json` `name` (the collision case for workspace-name
 *   keying), or when you want a stable key independent of `name` changes.
+* - `retention` — the `[retention]` table; see `RetentionConfig`.
 * @public
 */
 var VitestAgentConfig = class extends Schema.Class("VitestAgentConfig")({
 	cacheDir: Schema.optional(Schema.String),
-	projectKey: Schema.optional(Schema.String)
+	projectKey: Schema.optional(Schema.String),
+	retention: Schema.optionalKey(RetentionConfig)
 }) {};
+/**
+* The resolved run-retention policy a `data.db` prune applies: keep the
+* newest `keepRuns` runs of every project, and drop any run older than
+* `maxAgeDays` days when set. The run being persisted is never pruned.
+*
+* @remarks
+* The default of 200 runs per project is sized against what reads the
+* data: failure classification reads the newest 10 `test_history` rows per
+* test and coverage trends keep 50 entries, so 200 leaves both a wide
+* margin while bounding a 7k-test suite (about 3 MB per run) to a few
+* hundred megabytes instead of growing without bound (issue 623, where an
+* unpruned database reached 880 MB over 4,484 runs). `maxAgeDays` is the
+* lever for a project that runs rarely but wants a calendar bound.
+* @public
+*/
+var RunRetentionPolicy = class RunRetentionPolicy extends Schema.Class("RunRetentionPolicy")({
+	keepRuns: PositiveInt,
+	maxAgeDays: Schema.optionalKey(PositiveInt)
+}) {
+	/** Newest runs per project kept when the config names no `keepRuns`. */
+	static DEFAULT_KEEP_RUNS = 200;
+	/**
+	* Resolve the policy a loaded config asks for: `Option.none()` when
+	* `retention.enabled` is `false`, otherwise the configured values over
+	* the defaults.
+	*/
+	static fromConfig(config) {
+		const retention = config.retention;
+		if (retention?.enabled === false) return Option.none();
+		return Option.some(RunRetentionPolicy.make({
+			keepRuns: retention?.keepRuns ?? RunRetentionPolicy.DEFAULT_KEEP_RUNS,
+			...retention?.maxAgeDays !== void 0 && { maxAgeDays: retention.maxAgeDays }
+		}));
+	}
+};
 
-export { VitestAgentConfig };
+export { RetentionConfig, RunRetentionPolicy, VitestAgentConfig };

package/schemas/Options.js

@@ -42,17 +42,45 @@ const ReportOption = Schema.Union([Schema.Literal(false), ReportSettings]).annot
 /**
 * The 2.0 user-facing options for `AgentPlugin`.
 *
-* Six fields total. Two are function-typed (`reporter`, `onRunEvent`)
+* Seven 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 four data-shaped fields.
+* so the schema-decodable struct carries the five data-shaped fields.
 * @public
 */
 const AgentPluginOptions = Schema.Struct({
 	console: Schema.optional(ConsoleOutputs),
 	coverageTargets: Schema.optional(CoverageTargets),
 	transport: Schema.optional(Transport),
-	report: Schema.optional(ReportOption)
+	report: Schema.optional(ReportOption),
+	/**
+	* Whether a run is recorded in the SQLite `data.db` (default `true`).
+	*
+	* `false` is the explicit opt-out for a runner where nothing reads the
+	* database back — a throwaway CI job, say. The run still renders every
+	* console and report-file output, still emits every `RunEvent`, and
+	* Vitest still enforces `coverage.thresholds` through its own
+	* mechanism; only the database writes are skipped: run rows, test
+	* cases, failure history, coverage rows and trends, and the baselines
+	* they feed. Consequences a renderer sees: failure classifications are
+	* empty (there is no history to classify against, so no test is
+	* labelled `stable`, `new-failure`, `persistent`, `flaky` or
+	* `recovered`), and coverage renders without a baseline delta or a
+	* trend line. The `data.db` file is never created or opened.
+	*
+	* The opt-out is never automatic: `CI=true` does not imply it, because
+	* some CI setups cache `data.db` between jobs and query it. The
+	* `VITEST_AGENT_PERSIST` environment variable (`0` / `false` / `off`
+	* to disable, `1` / `true` / `on` to enable) is the operator spelling
+	* for a runner whose config cannot be edited, and it wins over this
+	* option in either direction; any other value is ignored with one
+	* stderr line.
+	*
+	* `coverage.enabled: false` in Vitest's own config already skips
+	* persistence (UI-only mode, Decision 38) — this option is for a run
+	* that keeps coverage on and still wants no database.
+	*/
+	persist: Schema.optional(Schema.Boolean)
 }).annotate({ identifier: "AgentPluginOptions" });
 /**
 * Reporter-implementation options.

package/version.js

@@ -11,6 +11,6 @@
 * survives into the published artifact.
 * @public
 */
-const CURRENT_SDK_VERSION = "7.0.5";
+const CURRENT_SDK_VERSION = "7.1.0";
 
 export { CURRENT_SDK_VERSION };