@vitest-agent/sdk 7.0.5 → 8.0.0

package/schemas/ConsoleLeaks.js

@@ -1,3 +1,4 @@
+import { FiniteNumber } from "./Common.js";
 import { Schema } from "effect";
 
 // src/schemas/ConsoleLeaks.ts
@@ -8,8 +9,8 @@ import { Schema } from "effect";
 */
 const ConsoleLeakFile = Schema.Struct({
 	file: Schema.String,
-	stdout: Schema.Number,
-	stderr: Schema.Number,
+	stdout: FiniteNumber,
+	stderr: FiniteNumber,
 	tests: Schema.optional(Schema.Array(Schema.String)),
 	sample: Schema.optional(Schema.String)
 }).annotate({ identifier: "ConsoleLeakFile" });
@@ -22,8 +23,8 @@ const ConsoleLeakFile = Schema.Struct({
 * @public
 */
 const ConsoleLeaksFromFailingTests = Schema.Struct({
-	total: Schema.Number,
-	files: Schema.Number
+	total: FiniteNumber,
+	files: FiniteNumber
 }).annotate({ identifier: "ConsoleLeaksFromFailingTests" });
 /**
 * Aggregate stray-console-output signal for a single test run. Omitted from
@@ -35,7 +36,7 @@ const ConsoleLeaksFromFailingTests = Schema.Struct({
 * @public
 */
 const ConsoleLeaks = Schema.Struct({
-	total: Schema.Number,
+	total: FiniteNumber,
 	byFile: Schema.Array(ConsoleLeakFile),
 	truncated: Schema.optional(Schema.Boolean),
 	fromFailingTests: Schema.optional(ConsoleLeaksFromFailingTests)

package/schemas/Coverage.js

@@ -1,3 +1,4 @@
+import { FiniteNumber } from "./Common.js";
 import { MetricThresholds, PatternThresholds } from "./Thresholds.js";
 import { Effect, Schema } from "effect";
 
@@ -7,10 +8,10 @@ import { Effect, Schema } from "effect";
 * @public
 */
 const CoverageTotals = Schema.Struct({
-	statements: Schema.Number,
-	branches: Schema.Number,
-	functions: Schema.Number,
-	lines: Schema.Number
+	statements: FiniteNumber,
+	branches: FiniteNumber,
+	functions: FiniteNumber,
+	lines: FiniteNumber
 }).annotate({ identifier: "CoverageTotals" });
 /**
 * Per-file coverage data including uncovered line ranges.
@@ -58,7 +59,7 @@ const CoverageReport = Schema.Struct({
 	})),
 	scoped: Schema.Boolean.pipe(Schema.withDecodingDefaultKey(Effect.succeed(false))),
 	scopedFiles: Schema.optional(Schema.Array(Schema.String)),
-	totalFiles: Schema.optional(Schema.Number),
+	totalFiles: Schema.optional(FiniteNumber),
 	lowCoverage: Schema.Array(FileCoverageReport),
 	lowCoverageFiles: Schema.Array(Schema.String),
 	belowTarget: Schema.optional(Schema.Array(FileCoverageReport)),

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/schemas/RenderState.js

@@ -1,4 +1,5 @@
 import { ReportError, TestClassification, TestState } from "./Common.js";
+import { ConsoleLeaks } from "./ConsoleLeaks.js";
 import { MetricThresholds } from "./Thresholds.js";
 import { CoverageTotals, GlobShortfall } from "./Coverage.js";
 import { StrayOutput } from "./StrayOutput.js";
@@ -163,7 +164,13 @@ const RenderState = Schema.Struct({
 	* capture, folded from `RunFinished.strayOutput`. Absent when the run
 	* wrote nothing stray.
 	*/
-	strayOutput: Schema.optional(StrayOutput)
+	strayOutput: Schema.optional(StrayOutput),
+	/**
+	* `console.*` output Vitest captured from tests that did not fail, folded
+	* from `RunFinished.consoleLeaks`. Absent when the run logged nothing
+	* (issue #544).
+	*/
+	consoleLeaks: Schema.optional(ConsoleLeaks)
 }).annotate({ identifier: "RenderState" });
 /**
 * Initial state — what the reducer returns when no events have been

package/schemas/RunEvent.js

@@ -1,4 +1,5 @@
 import { ReportError, TestClassification, TestState } from "./Common.js";
+import { ConsoleLeaks } from "./ConsoleLeaks.js";
 import { MetricThresholds } from "./Thresholds.js";
 import { CoverageTotals, FileCoverageReport, GlobShortfall } from "./Coverage.js";
 import { StrayOutput } from "./StrayOutput.js";
@@ -226,7 +227,13 @@ const RunEvent = Schema.Union([
 		* capture (`AgentReport.strayOutput`). Optional: absent when the run
 		* wrote nothing stray, and in older replay data.
 		*/
-		strayOutput: Schema.optional(StrayOutput)
+		strayOutput: Schema.optional(StrayOutput),
+		/**
+		* `console.*` output Vitest captured from tests that did not fail
+		* (`AgentReport.consoleLeaks`). Optional: absent when the run logged
+		* nothing, and in older replay data (issue #544).
+		*/
+		consoleLeaks: Schema.optional(ConsoleLeaks)
 	})
 ]).annotate({ identifier: "RunEvent" });
 

package/schemas/StrayOutput.js

@@ -1,3 +1,4 @@
+import { FiniteNumber } from "./Common.js";
 import { Schema } from "effect";
 
 // src/schemas/StrayOutput.ts
@@ -27,10 +28,10 @@ const StrayOutputSample = Schema.Struct({
 * @public
 */
 const StrayOutput = Schema.Struct({
-	total: Schema.Number,
-	stdout: Schema.Number,
-	stderr: Schema.Number,
-	bytes: Schema.Number,
+	total: FiniteNumber,
+	stdout: FiniteNumber,
+	stderr: FiniteNumber,
+	bytes: FiniteNumber,
 	samples: Schema.Array(StrayOutputSample)
 }).annotate({ identifier: "StrayOutput" });
 

package/schemas/Thresholds.js

@@ -1,3 +1,4 @@
+import { FiniteNumber } from "./Common.js";
 import { Effect, Schema } from "effect";
 
 // src/schemas/Thresholds.ts
@@ -6,10 +7,10 @@ import { Effect, Schema } from "effect";
 * @public
 */
 const MetricThresholds = Schema.Struct({
-	lines: Schema.optional(Schema.Number),
-	functions: Schema.optional(Schema.Number),
-	branches: Schema.optional(Schema.Number),
-	statements: Schema.optional(Schema.Number)
+	lines: Schema.optional(FiniteNumber),
+	functions: Schema.optional(FiniteNumber),
+	branches: Schema.optional(FiniteNumber),
+	statements: Schema.optional(FiniteNumber)
 }).annotate({ identifier: "MetricThresholds" });
 /**
 * A `perFile` setting. Vitest 5 allows either a plain boolean or a

package/utils/console-leaks.js

@@ -99,5 +99,31 @@ function collectConsoleLeakEntries(files) {
 	}
 	return entries;
 }
+const MAX_NOTE_FILES = 3;
+/**
+* The note a renderer prints for a run's console leaks: one line naming the
+* write count, the file count and the fix, then up to three files with
+* their stream split and sample, how many files it left out, and the output
+* from failing tests that the leak count excludes. Empty when the run has no
+* leak from a passing test (output from failing tests alone is not a leak).
+* @public
+*/
+const formatConsoleLeaksNote = (leaks) => {
+	if (leaks.total === 0) return [];
+	const files = leaks.byFile.length;
+	const lines = [`Console leaks: passing tests wrote ${leaks.total} console ${leaks.total === 1 ? "line" : "lines"} in ${files} ${files === 1 ? "file" : "files"}; Vitest captured them, so they are noise an agent never sees. Remove the logging or route it through a logger the tests silence.`];
+	const shown = leaks.byFile.slice(0, MAX_NOTE_FILES);
+	for (const file of shown) {
+		const streams = [file.stdout > 0 ? `${file.stdout} stdout` : "", file.stderr > 0 ? `${file.stderr} stderr` : ""].filter((part) => part.length > 0).join(", ");
+		const sample = file.sample !== void 0 ? `: ${file.sample}` : "";
+		lines.push(`  ${file.file} (${streams})${sample}`);
+	}
+	const more = leaks.byFile.length - shown.length;
+	if (more > 0) lines.push(`  (+${more} more ${more === 1 ? "file" : "files"}${leaks.truncated === true ? ", list truncated" : ""})`);
+	else if (leaks.truncated === true) lines.push("  (file list truncated)");
+	const failing = leaks.fromFailingTests;
+	if (failing !== void 0 && failing.total > 0) lines.push(`  (${failing.total} more ${failing.total === 1 ? "line" : "lines"} from failing tests in ${failing.files} ${failing.files === 1 ? "file" : "files"}, not counted as leaks)`);
+	return lines;
+};
 
-export { buildConsoleLeaks, collectConsoleLeakEntries };
+export { buildConsoleLeaks, collectConsoleLeakEntries, formatConsoleLeaksNote };

package/version.js

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

package/utils/hyperlink.js

@@ -1,10 +0,0 @@
-// src/utils/hyperlink.ts
-const ESC = "\x1B";
-const BEL = "\x07";
-/** @public */
-const osc8 = (url, label, options) => {
-	if (!options.enabled) return label;
-	return `${ESC}]8;;${url}${BEL}${label}${ESC}]8;;${BEL}`;
-};
-
-export { osc8 };