@vitest-agent/sdk 6.0.0 → 7.0.0

package/index.d.ts

@@ -28,6 +28,35 @@ export declare const FileCoverageReport: Schema.Struct<{
 }>;
 /** @public */
 export type FileCoverageReport = typeof FileCoverageReport.Type;
+/**
+ * A threshold glob whose AGGREGATE coverage (summed covered/total across
+ * every file the glob matches, the same way Vitest evaluates a glob
+ * threshold) is below at least one of the glob's metric numbers.
+ *
+ * This is independent of the per-file lists: with an object `perFile` every
+ * matched file can pass while the glob as a whole still fails.
+ * @public
+ */
+export declare const GlobShortfall: Schema.Struct<{
+  /** The threshold glob pattern as configured. */
+  readonly pattern: Schema.String;
+  /** Aggregate coverage percentages over the files the glob matches. */
+  readonly summary: Schema.Struct<{
+    readonly statements: Schema.Number;
+    readonly branches: Schema.Number;
+    readonly functions: Schema.Number;
+    readonly lines: Schema.Number;
+  }>;
+  /** The glob's own metric numbers that were set (`perFile` excluded). */
+  readonly thresholds: 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 GlobShortfall = typeof GlobShortfall.Type;
 /**
  * Complete coverage report attached to an AgentReport.
  * @public
@@ -124,6 +153,24 @@ export declare const CoverageReport: Schema.Struct<{
     readonly uncoveredLines: Schema.String;
   }>>>;
   readonly belowTargetFiles: Schema.optional<Schema.$Array<Schema.String>>;
+  readonly globShortfalls: Schema.optional<Schema.$Array<Schema.Struct<{
+    /** The threshold glob pattern as configured. */
+    readonly pattern: Schema.String;
+    /** Aggregate coverage percentages over the files the glob matches. */
+    readonly summary: Schema.Struct<{
+      readonly statements: Schema.Number;
+      readonly branches: Schema.Number;
+      readonly functions: Schema.Number;
+      readonly lines: Schema.Number;
+    }>;
+    /** The glob's own metric numbers that were set (`perFile` excluded). */
+    readonly thresholds: 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 CoverageReport = typeof CoverageReport.Type;
@@ -249,6 +296,21 @@ export declare const CoverageRenderState: Schema.Struct<{
   readonly scoped: Schema.optional<Schema.Boolean>;
   readonly scopedFiles: Schema.optional<Schema.Number>;
   readonly totalFiles: Schema.optional<Schema.Number>;
+  readonly globShortfalls: Schema.optional<Schema.$Array<Schema.Struct<{
+    readonly pattern: Schema.String;
+    readonly summary: Schema.Struct<{
+      readonly statements: Schema.Number;
+      readonly branches: Schema.Number;
+      readonly functions: Schema.Number;
+      readonly lines: Schema.Number;
+    }>;
+    readonly thresholds: 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 CoverageRenderState = typeof CoverageRenderState.Type;
@@ -370,6 +432,21 @@ export declare const RenderState: Schema.Struct<{
     readonly scoped: Schema.optional<Schema.Boolean>;
     readonly scopedFiles: Schema.optional<Schema.Number>;
     readonly totalFiles: Schema.optional<Schema.Number>;
+    readonly globShortfalls: Schema.optional<Schema.$Array<Schema.Struct<{
+      readonly pattern: Schema.String;
+      readonly summary: Schema.Struct<{
+        readonly statements: Schema.Number;
+        readonly branches: Schema.Number;
+        readonly functions: Schema.Number;
+        readonly lines: Schema.Number;
+      }>;
+      readonly thresholds: 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 trend: Schema.NullOr<Schema.Struct<{
     readonly direction: Schema.Literals<readonly ["improving", "regressing", "stable"]>;
@@ -418,6 +495,21 @@ export declare const RenderState: Schema.Struct<{
     readonly expected: Schema.optional<Schema.String>;
     readonly received: Schema.optional<Schema.String>;
   }>>;
+  /**
+   * What the run wrote straight to the terminal, past Vitest's console
+   * capture, folded from `RunFinished.strayOutput`. Absent when the run
+   * wrote nothing stray.
+   */
+  readonly strayOutput: Schema.optional<Schema.Struct<{
+    readonly total: Schema.Number;
+    readonly stdout: Schema.Number;
+    readonly stderr: Schema.Number;
+    readonly bytes: Schema.Number;
+    readonly samples: Schema.$Array<Schema.Struct<{
+      readonly stream: Schema.Literals<readonly ["stdout", "stderr"]>;
+      readonly text: Schema.String;
+    }>>;
+  }>>;
 }>;
 /** @public */
 export type RenderState = typeof RenderState.Type;
@@ -817,6 +909,21 @@ export declare const AgentReport: Schema.Struct<{
       readonly uncoveredLines: Schema.String;
     }>>>;
     readonly belowTargetFiles: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly globShortfalls: Schema.optional<Schema.$Array<Schema.Struct<{
+      readonly pattern: Schema.String;
+      readonly summary: Schema.Struct<{
+        readonly statements: Schema.Number;
+        readonly branches: Schema.Number;
+        readonly functions: Schema.Number;
+        readonly lines: Schema.Number;
+      }>;
+      readonly thresholds: 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 tagCounts: Schema.optional<Schema.$Record<Schema.String, Schema.Struct<{
     readonly passed: Schema.optional<Schema.Number>;
@@ -838,6 +945,16 @@ export declare const AgentReport: Schema.Struct<{
       readonly files: Schema.Number;
     }>>;
   }>>;
+  readonly strayOutput: Schema.optional<Schema.Struct<{
+    readonly total: Schema.Number;
+    readonly stdout: Schema.Number;
+    readonly stderr: Schema.Number;
+    readonly bytes: Schema.Number;
+    readonly samples: Schema.$Array<Schema.Struct<{
+      readonly stream: Schema.Literals<readonly ["stdout", "stderr"]>;
+      readonly text: Schema.String;
+    }>>;
+  }>>;
 }>;
 /** @public */
 export type AgentReport = typeof AgentReport.Type;
@@ -929,13 +1046,6 @@ export type Environment = typeof Environment.Type;
 export declare const Executor: Schema.Literals<readonly ["human", "agent", "ci"]>;
 /** @public */
 export type Executor = typeof Executor.Type;
-/**
- * Output format for the reporter pipeline.
- * @public
- */
-export declare const OutputFormat: Schema.Literals<readonly ["terminal", "markdown", "json", "vitest-bypass", "silent", "ci-annotations"]>;
-/** @public */
-export type OutputFormat = typeof OutputFormat.Type;
 /**
  * Level of detail in reporter output.
  * @public
@@ -1173,6 +1283,21 @@ export declare const RunEvent: Schema.Union<readonly [Schema.TaggedStruct<"RunSt
   readonly scoped: Schema.optional<Schema.Boolean>;
   readonly scopedFiles: Schema.optional<Schema.Number>;
   readonly totalFiles: Schema.optional<Schema.Number>;
+  readonly globShortfalls: Schema.optional<Schema.$Array<Schema.Struct<{
+    readonly pattern: Schema.String;
+    readonly summary: Schema.Struct<{
+      readonly statements: Schema.Number;
+      readonly branches: Schema.Number;
+      readonly functions: Schema.Number;
+      readonly lines: Schema.Number;
+    }>;
+    readonly thresholds: 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>;
+    }>;
+  }>>>;
 }>, Schema.TaggedStruct<"ThresholdViolation", {
   readonly metric: Schema.Literals<readonly ["lines", "branches", "functions", "statements"]>;
   readonly expected: Schema.Number;
@@ -1215,6 +1340,21 @@ export declare const RunEvent: Schema.Union<readonly [Schema.TaggedStruct<"RunSt
     readonly expected: Schema.optional<Schema.String>;
     readonly received: Schema.optional<Schema.String>;
   }>>>;
+  /**
+   * What the run wrote straight to the terminal, past Vitest's console
+   * capture (`AgentReport.strayOutput`). Optional: absent when the run
+   * wrote nothing stray, and in older replay data.
+   */
+  readonly strayOutput: Schema.optional<Schema.Struct<{
+    readonly total: Schema.Number;
+    readonly stdout: Schema.Number;
+    readonly stderr: Schema.Number;
+    readonly bytes: Schema.Number;
+    readonly samples: Schema.$Array<Schema.Struct<{
+      readonly stream: Schema.Literals<readonly ["stdout", "stderr"]>;
+      readonly text: Schema.String;
+    }>>;
+  }>>;
 }>]>;
 /** @public */
 export type RunEvent = typeof RunEvent.Type;
@@ -1354,10 +1494,10 @@ export type Transport = typeof Transport.Type;
  * plugin always populates it in practice — the option exists for clarity
  * and to leave room for future "no-persistence" experiments.
  *
- * `format` and `detail` are pre-resolved by the plugin (via
- * `FormatSelector` / `DetailResolver`) but reporters that want to override
- * can ignore them. `noColor` is the resolved value of the `NO_COLOR` env
- * var; reporters use it to gate ANSI escapes and OSC-8 hyperlinks.
+ * `detail` is pre-resolved by the plugin (via `DetailResolver`) but
+ * reporters that want to override can ignore it. `noColor` is the resolved
+ * value of the `NO_COLOR` env var; reporters use it to gate ANSI escapes and
+ * OSC-8 hyperlinks.
  * @public
  */
 export interface ResolvedReporterConfig {
@@ -1396,7 +1536,6 @@ export interface ResolvedReporterConfig {
    * @internal
    */
   readonly coverageMode: "full" | "ui-only";
-  readonly format: OutputFormat;
   readonly detail: DetailLevel;
   readonly noColor: boolean;
   readonly runCommand?: string;
@@ -1518,6 +1657,24 @@ export interface VitestAgentReporter {
    * awaits it and treats a rejection as a logged warning.
    */
   readonly close?: () => Promise<void>;
+  /**
+   * Print one whole line of stray output: bytes a test process wrote
+   * straight to the terminal, past Vitest's console capture (a child
+   * process spawned with inherited stdio is the usual source). A reporter
+   * that draws in place (a live view) implements this to print the line
+   * above its drawing instead of under it, where the next redraw would
+   * strand it. Return `true` when the line was taken; `false` sends it to
+   * the terminal unchanged.
+   *
+   * The plugin calls it synchronously, from the factory's return until just
+   * before {@link VitestAgentReporter.close | close}, only for lines bound
+   * for the process's own stdout or stderr (never when Vitest was given
+   * other streams, as MCP's `run_tests` does), and only while it owns the
+   * console (any mode but `passthrough`). The line carries no trailing
+   * newline. Optional; without it every line passes through unchanged. The
+   * run's stray output is reported on `AgentReport.strayOutput` either way.
+   */
+  readonly printStrayLine?: (stream: "stdout" | "stderr", line: string) => boolean;
 }
 /**
  * Factory that the plugin's `reporter` option accepts. The plugin calls
@@ -2789,6 +2946,21 @@ export declare const RunReportFile: Schema.Struct<{
         readonly uncoveredLines: Schema.String;
       }>>>;
       readonly belowTargetFiles: Schema.optional<Schema.$Array<Schema.String>>;
+      readonly globShortfalls: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly pattern: Schema.String;
+        readonly summary: Schema.Struct<{
+          readonly statements: Schema.Number;
+          readonly branches: Schema.Number;
+          readonly functions: Schema.Number;
+          readonly lines: Schema.Number;
+        }>;
+        readonly thresholds: 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 tagCounts: Schema.optional<Schema.$Record<Schema.String, Schema.Struct<{
       readonly passed: Schema.optional<Schema.Number>;
@@ -2810,11 +2982,62 @@ export declare const RunReportFile: Schema.Struct<{
         readonly files: Schema.Number;
       }>>;
     }>>;
+    readonly strayOutput: Schema.optional<Schema.Struct<{
+      readonly total: Schema.Number;
+      readonly stdout: Schema.Number;
+      readonly stderr: Schema.Number;
+      readonly bytes: Schema.Number;
+      readonly samples: Schema.$Array<Schema.Struct<{
+        readonly stream: Schema.Literals<readonly ["stdout", "stderr"]>;
+        readonly text: Schema.String;
+      }>>;
+    }>>;
   }>>;
 }>;
 /** @public */
 export type RunReportFile = typeof RunReportFile.Type;
 //#endregion
+//#region src/schemas/StrayOutput.d.ts
+/**
+ * One line of stray output, kept as a sample: the stream it was written to,
+ * and its text with escapes stripped, cut to a sane length.
+ * @public
+ */
+export declare const StrayOutputSample: Schema.Struct<{
+  readonly stream: Schema.Literals<readonly ["stdout", "stderr"]>;
+  readonly text: Schema.String;
+}>;
+/** @public */
+export type StrayOutputSample = typeof StrayOutputSample.Type;
+/**
+ * Output a test run wrote straight to the terminal, past Vitest's console
+ * capture: bytes a worker process (or a child process it spawned with
+ * inherited stdio, such as `execFileSync("git", ...)`) wrote to its own
+ * stdout or stderr, which Vitest pipes through to the main process
+ * untouched. Distinct from `consoleLeaks`, which counts `console.*` calls
+ * Vitest did capture.
+ *
+ * A run-level signal: the bytes arrive on one stream shared by every project,
+ * so nothing attributes them to a project, file or test. Every project report
+ * of a run carries the same value. Counts are of non-blank lines; `bytes`
+ * counts everything recorded. `samples` holds the first few lines. Omitted
+ * when the run wrote nothing stray (and whenever the plugin does not own the
+ * console: `passthrough` mode records nothing).
+ * @public
+ */
+export declare const StrayOutput: Schema.Struct<{
+  readonly total: Schema.Number;
+  readonly stdout: Schema.Number;
+  readonly stderr: Schema.Number;
+  readonly bytes: Schema.Number;
+  readonly samples: Schema.$Array<Schema.Struct<{
+    readonly stream: Schema.Literals<readonly ["stdout", "stderr"]>;
+    readonly text: Schema.String;
+  }>>;
+}>;
+/** @public */
+export type StrayOutput = typeof StrayOutput.Type;
+//#endregion
 //#region src/schemas/Tdd.d.ts
 /** @public */
 export declare const GoalStatus: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
@@ -4022,6 +4245,79 @@ export declare const probeHostMetadataFromEnv: (env: Record<string, string | und
  */
 export declare function safeFilename(name: string): string;
 //#endregion
+//#region src/utils/stray-output.d.ts
+/**
+ * A stream stray output was written to.
+ * @public
+ */
+export type StrayOutputStream = "stdout" | "stderr";
+/**
+ * Records stray output for one run at a time: counts its non-blank lines per
+ * stream and its bytes, and keeps the first few lines as samples. Memory is
+ * bounded whatever is written: only the samples and one partial line per
+ * stream (itself cut to the sample length) are held.
+ * @public
+ */
+export interface StrayOutputRecorder {
+  /** Record text written to `stream`. A write made only of escape sequences is ignored. */
+  readonly write: (stream: StrayOutputStream, text: string) => void;
+  /** What the run has written so far, a trailing partial line included; `undefined` when nothing. */
+  readonly snapshot: () => StrayOutput | undefined;
+  /** Forget everything: a new run starts. */
+  readonly reset: () => void;
+}
+/**
+ * Options for {@link makeStrayOutputRecorder}.
+ * @public
+ */
+export interface StrayOutputRecorderOptions {
+  /** How many lines to keep as samples. @defaultValue 5 */
+  readonly maxSamples?: number;
+  /** How many characters of a sample to keep before cutting it with `…`. @defaultValue 160 */
+  readonly maxSampleChars?: number;
+}
+/**
+ * True when `text` is nothing but terminal escape sequences: the cursor
+ * hide/show, clear-screen and erase-scrollback writes Vitest's own `Logger`
+ * makes straight to its output stream. Empty text is not escape-only.
+ * @public
+ */
+export declare const isEscapeOnly: (text: string) => boolean;
+/**
+ * Make a {@link StrayOutputRecorder}.
+ * @public
+ */
+export declare const makeStrayOutputRecorder: (options?: StrayOutputRecorderOptions) => StrayOutputRecorder;
+/**
+ * The key a stray-output capture publishes its {@link StrayOutputSource}
+ * under, on the Vitest `Logger` whose streams it wraps. `Symbol.for`, so a
+ * plugin and an MCP server that load different copies of this package still
+ * meet on it.
+ * @public
+ */
+export declare const STRAY_OUTPUT_SOURCE: unique symbol;
+/**
+ * What a stray-output capture publishes for a reader that did not install it.
+ * @public
+ */
+export interface StrayOutputSource {
+  /** The current run's stray output, or `undefined` when it wrote none. */
+  readonly snapshot: () => StrayOutput | undefined;
+}
+/**
+ * Read the current run's stray output from a Vitest `Logger` a capture was
+ * installed on. `undefined` when none was installed, or the run wrote nothing.
+ * @public
+ */
+export declare const readStrayOutput: (logger: unknown) => StrayOutput | undefined;
+/**
+ * The note a renderer prints for a run's stray output: one line naming the
+ * count, the streams, the usual cause and the fix, then up to three sample
+ * lines and how many it left out.
+ * @public
+ */
+export declare const formatStrayOutputNote: (stray: StrayOutput) => ReadonlyArray<string>;
+//#endregion
 //#region src/utils/test-location.d.ts
 /** Directory holding source files whose tests may be co-located. @public */
 export declare const SRC_DIR = "src";

package/index.js

@@ -7,10 +7,11 @@ import { GitCommandError, ProbeMissError } from "./errors/RunContextError.js";
 import { BehaviorNotFoundError, GoalNotFoundError, IllegalStatusTransitionError, TddTaskAlreadyEndedError, TddTaskNotFoundError } from "./errors/TddErrors.js";
 import { ActorType, AgentId, ChatId, ConversationId, HostKind, ProjectKey, TddTaskId } from "./schemas/Identity.js";
 import { Agent, IdempotencyHit } from "./schemas/Agent.js";
-import { AgentConsoleMode, CiConsoleMode, ConsoleMode, ConsoleOutputMode, DetailLevel, Environment, Executor, HumanConsoleMode, OutputFormat, PackageManager, ReportError, TestClassification, TestRunReason, TestState } from "./schemas/Common.js";
+import { AgentConsoleMode, CiConsoleMode, ConsoleMode, ConsoleOutputMode, DetailLevel, Environment, Executor, HumanConsoleMode, PackageManager, ReportError, TestClassification, TestRunReason, TestState } from "./schemas/Common.js";
 import { ConsoleLeakFile, ConsoleLeaks, ConsoleLeaksFromFailingTests } from "./schemas/ConsoleLeaks.js";
 import { MetricThresholds, PatternMetricThresholds, PatternThresholds, PerFileThresholds, ResolvedThresholds } from "./schemas/Thresholds.js";
-import { CoverageReport, CoverageTotals, FileCoverageReport } from "./schemas/Coverage.js";
+import { CoverageReport, CoverageTotals, FileCoverageReport, GlobShortfall } from "./schemas/Coverage.js";
+import { StrayOutput, StrayOutputSample } from "./schemas/StrayOutput.js";
 import { AgentReport, ModuleReport, ReportSummary, TagCountEntry, TestReport } from "./schemas/AgentReport.js";
 import { CoverageBaselines } from "./schemas/Baselines.js";
 import { CacheManifest, CacheManifestEntry } from "./schemas/CacheManifest.js";
@@ -57,9 +58,10 @@ import { normalizeWorkspaceKey } from "./utils/normalize-workspace-key.js";
 import { basenamePosix, joinPosix, relativePosix, toPosix } from "./utils/posix-path.js";
 import { probeHostMetadataFromEnv } from "./utils/probe-host-metadata.js";
 import { safeFilename } from "./utils/safe-filename.js";
+import { STRAY_OUTPUT_SOURCE, formatStrayOutputNote, isEscapeOnly, makeStrayOutputRecorder, readStrayOutput } from "./utils/stray-output.js";
 import { BATS_FILE_GLOB_SUFFIX, NON_DISCOVERABLE_DIRS, SRC_DIR, TEST_DIR, TEST_FILE_GLOB_SUFFIX, TEST_HELPER_DIRS, classifyTestPath, findOwningWorkspace, isTestFileName } from "./utils/test-location.js";
 import { validateCoverageTargetsShape } from "./utils/validate-coverage-targets-shape.js";
 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, 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, OutputFormat, 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, SessionCompleteEvent, SessionNotFoundError, SessionOutcome, SidecarTimeoutError, 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, getRecentDirection, getRunCommand, getWorstMetric, gitUrlToProjectKey, hashTargets, initialRenderState, isTestFileName, isTimeoutError, isVitestInvocation, joinPosix, normalizeWorkspaceKey, osc8, probeHostMetadataFromEnv, 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, 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 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vitest-agent/sdk",
-	"version": "6.0.0",
+	"version": "7.0.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": [
@@ -41,9 +41,9 @@
 		"./package.json": "./package.json"
 	},
 	"dependencies": {
-		"acorn": "^8.18.0",
+		"acorn": "^8.19.0",
 		"acorn-typescript": "^1.4.13",
-		"effect": "^4.0.0"
+		"effect": "^4.0.2"
 	},
 	"engines": {
 		"node": ">=24.11.0"

package/schemas/5.0/run.json

@@ -526,6 +526,22 @@
 			"required": ["file", "summary", "uncoveredLines"],
 			"additionalProperties": true
 		},
+		"GlobShortfall": {
+			"type": "object",
+			"properties": {
+				"pattern": {
+					"type": "string"
+				},
+				"summary": {
+					"$ref": "#/$defs/CoverageTotals"
+				},
+				"thresholds": {
+					"$ref": "#/$defs/MetricThresholds"
+				}
+			},
+			"required": ["pattern", "summary", "thresholds"],
+			"additionalProperties": true
+		},
 		"CoverageReport": {
 			"type": "object",
 			"properties": {
@@ -665,6 +681,19 @@
 							"type": "null"
 						}
 					]
+				},
+				"globShortfalls": {
+					"anyOf": [
+						{
+							"type": "array",
+							"items": {
+								"$ref": "#/$defs/GlobShortfall"
+							}
+						},
+						{
+							"type": "null"
+						}
+					]
 				}
 			},
 			"required": ["totals", "thresholds", "lowCoverage", "lowCoverageFiles"],
@@ -858,6 +887,77 @@
 			"required": ["total", "byFile"],
 			"additionalProperties": true
 		},
+		"StrayOutputSample": {
+			"type": "object",
+			"properties": {
+				"stream": {
+					"type": "string",
+					"enum": ["stdout", "stderr"]
+				},
+				"text": {
+					"type": "string"
+				}
+			},
+			"required": ["stream", "text"],
+			"additionalProperties": true
+		},
+		"StrayOutput": {
+			"type": "object",
+			"properties": {
+				"total": {
+					"anyOf": [
+						{
+							"type": "number"
+						},
+						{
+							"type": "string",
+							"enum": ["Infinity", "-Infinity", "NaN"]
+						}
+					]
+				},
+				"stdout": {
+					"anyOf": [
+						{
+							"type": "number"
+						},
+						{
+							"type": "string",
+							"enum": ["Infinity", "-Infinity", "NaN"]
+						}
+					]
+				},
+				"stderr": {
+					"anyOf": [
+						{
+							"type": "number"
+						},
+						{
+							"type": "string",
+							"enum": ["Infinity", "-Infinity", "NaN"]
+						}
+					]
+				},
+				"bytes": {
+					"anyOf": [
+						{
+							"type": "number"
+						},
+						{
+							"type": "string",
+							"enum": ["Infinity", "-Infinity", "NaN"]
+						}
+					]
+				},
+				"samples": {
+					"type": "array",
+					"items": {
+						"$ref": "#/$defs/StrayOutputSample"
+					}
+				}
+			},
+			"required": ["total", "stdout", "stderr", "bytes", "samples"],
+			"additionalProperties": true
+		},
 		"AgentReport": {
 			"type": "object",
 			"properties": {
@@ -930,6 +1030,16 @@
 							"type": "null"
 						}
 					]
+				},
+				"strayOutput": {
+					"anyOf": [
+						{
+							"$ref": "#/$defs/StrayOutput"
+						},
+						{
+							"type": "null"
+						}
+					]
 				}
 			},
 			"required": ["timestamp", "reason", "summary", "failed", "unhandledErrors", "failedFiles"],

package/schemas/AgentReport.js

@@ -1,6 +1,7 @@
 import { ReportError, TestClassification, TestRunReason, TestState } from "./Common.js";
 import { ConsoleLeaks } from "./ConsoleLeaks.js";
 import { CoverageReport } from "./Coverage.js";
+import { StrayOutput } from "./StrayOutput.js";
 import { Schema } from "effect";
 
 //#region src/schemas/AgentReport.ts
@@ -71,7 +72,8 @@ const AgentReport = Schema.Struct({
 	failedFiles: Schema.Array(Schema.String),
 	coverage: Schema.optional(CoverageReport),
 	tagCounts: Schema.optional(Schema.Record(Schema.String, TagCountEntry)),
-	consoleLeaks: Schema.optional(ConsoleLeaks)
+	consoleLeaks: Schema.optional(ConsoleLeaks),
+	strayOutput: Schema.optional(StrayOutput)
 }).annotate({ identifier: "AgentReport" });
 
 //#endregion

package/schemas/Common.js

@@ -116,18 +116,6 @@ const Executor = Schema.Literals([
 	"ci"
 ]).annotate({ identifier: "Executor" });
 /**
-* Output format for the reporter pipeline.
-* @public
-*/
-const OutputFormat = Schema.Literals([
-	"terminal",
-	"markdown",
-	"json",
-	"vitest-bypass",
-	"silent",
-	"ci-annotations"
-]).annotate({ identifier: "OutputFormat" });
-/**
 * Level of detail in reporter output.
 * @public
 */
@@ -158,4 +146,4 @@ const ReportError = Schema.Struct({
 }).annotate({ identifier: "ReportError" });
 
 //#endregion
-export { AgentConsoleMode, CiConsoleMode, ConsoleMode, ConsoleOutputMode, DetailLevel, Environment, Executor, HumanConsoleMode, OutputFormat, PackageManager, ReportError, TestClassification, TestRunReason, TestState };
+export { AgentConsoleMode, CiConsoleMode, ConsoleMode, ConsoleOutputMode, DetailLevel, Environment, Executor, HumanConsoleMode, PackageManager, ReportError, TestClassification, TestRunReason, TestState };

package/schemas/Coverage.js

@@ -22,6 +22,23 @@ const FileCoverageReport = Schema.Struct({
 	uncoveredLines: Schema.String
 }).annotate({ identifier: "FileCoverageReport" });
 /**
+* A threshold glob whose AGGREGATE coverage (summed covered/total across
+* every file the glob matches, the same way Vitest evaluates a glob
+* threshold) is below at least one of the glob's metric numbers.
+*
+* This is independent of the per-file lists: with an object `perFile` every
+* matched file can pass while the glob as a whole still fails.
+* @public
+*/
+const GlobShortfall = Schema.Struct({
+	/** The threshold glob pattern as configured. */
+	pattern: Schema.String,
+	/** Aggregate coverage percentages over the files the glob matches. */
+	summary: CoverageTotals,
+	/** The glob's own metric numbers that were set (`perFile` excluded). */
+	thresholds: MetricThresholds
+}).annotate({ identifier: "GlobShortfall" });
+/**
 * Complete coverage report attached to an AgentReport.
 * @public
 */
@@ -45,8 +62,9 @@ const CoverageReport = Schema.Struct({
 	lowCoverage: Schema.Array(FileCoverageReport),
 	lowCoverageFiles: Schema.Array(Schema.String),
 	belowTarget: Schema.optional(Schema.Array(FileCoverageReport)),
-	belowTargetFiles: Schema.optional(Schema.Array(Schema.String))
+	belowTargetFiles: Schema.optional(Schema.Array(Schema.String)),
+	globShortfalls: Schema.optional(Schema.Array(GlobShortfall))
 }).annotate({ identifier: "CoverageReport" });
 
 //#endregion
-export { CoverageReport, CoverageTotals, FileCoverageReport };
+export { CoverageReport, CoverageTotals, FileCoverageReport, GlobShortfall };

package/schemas/RenderState.js

@@ -1,6 +1,7 @@
 import { ReportError, TestClassification, TestState } from "./Common.js";
 import { MetricThresholds } from "./Thresholds.js";
-import { CoverageTotals } from "./Coverage.js";
+import { CoverageTotals, GlobShortfall } from "./Coverage.js";
+import { StrayOutput } from "./StrayOutput.js";
 import { ActionSeverity, CoverageGap, CoverageMetric } from "./RunEvent.js";
 import { Schema } from "effect";
 
@@ -79,7 +80,8 @@ const CoverageRenderState = Schema.Struct({
 	})),
 	scoped: Schema.optional(Schema.Boolean),
 	scopedFiles: Schema.optional(Schema.Number),
-	totalFiles: Schema.optional(Schema.Number)
+	totalFiles: Schema.optional(Schema.Number),
+	globShortfalls: Schema.optional(Schema.Array(GlobShortfall))
 }).annotate({ identifier: "CoverageRenderState" });
 /**
 * A `SuggestedAction` event, denormalized into the queue the renderer reads.
@@ -155,7 +157,13 @@ const RenderState = Schema.Struct({
 	* (older replay data, hand-built fixtures) defaults to `[]`. See
 	* issue #240.
 	*/
-	unhandledErrors: Schema.Array(ReportError)
+	unhandledErrors: Schema.Array(ReportError),
+	/**
+	* What the run wrote straight to the terminal, past Vitest's console
+	* capture, folded from `RunFinished.strayOutput`. Absent when the run
+	* wrote nothing stray.
+	*/
+	strayOutput: Schema.optional(StrayOutput)
 }).annotate({ identifier: "RenderState" });
 /**
 * Initial state — what the reducer returns when no events have been

package/schemas/RunEvent.js

@@ -1,6 +1,7 @@
 import { ReportError, TestClassification, TestState } from "./Common.js";
 import { MetricThresholds } from "./Thresholds.js";
-import { CoverageTotals, FileCoverageReport } from "./Coverage.js";
+import { CoverageTotals, FileCoverageReport, GlobShortfall } from "./Coverage.js";
+import { StrayOutput } from "./StrayOutput.js";
 import { TestArtifactLocation, TestAttachment } from "./TestArtifacts.js";
 import { Schema } from "effect";
 
@@ -178,7 +179,8 @@ const RunEvent = Schema.Union([
 		gaps: Schema.Array(CoverageGap),
 		scoped: Schema.optional(Schema.Boolean),
 		scopedFiles: Schema.optional(Schema.Number),
-		totalFiles: Schema.optional(Schema.Number)
+		totalFiles: Schema.optional(Schema.Number),
+		globShortfalls: Schema.optional(Schema.Array(GlobShortfall))
 	}),
 	Schema.TaggedStruct("ThresholdViolation", {
 		metric: CoverageMetric,
@@ -218,7 +220,13 @@ const RunEvent = Schema.Union([
 		* argument to `onTestRunEnd`. Optional so hand-built fixtures
 		* and older replay data keep decoding. See issue #240.
 		*/
-		unhandledErrors: Schema.optional(Schema.Array(ReportError))
+		unhandledErrors: Schema.optional(Schema.Array(ReportError)),
+		/**
+		* What the run wrote straight to the terminal, past Vitest's console
+		* capture (`AgentReport.strayOutput`). Optional: absent when the run
+		* wrote nothing stray, and in older replay data.
+		*/
+		strayOutput: Schema.optional(StrayOutput)
 	})
 ]).annotate({ identifier: "RunEvent" });
 

package/schemas/StrayOutput.js

@@ -0,0 +1,38 @@
+import { Schema } from "effect";
+
+//#region src/schemas/StrayOutput.ts
+/**
+* One line of stray output, kept as a sample: the stream it was written to,
+* and its text with escapes stripped, cut to a sane length.
+* @public
+*/
+const StrayOutputSample = Schema.Struct({
+	stream: Schema.Literals(["stdout", "stderr"]),
+	text: Schema.String
+}).annotate({ identifier: "StrayOutputSample" });
+/**
+* Output a test run wrote straight to the terminal, past Vitest's console
+* capture: bytes a worker process (or a child process it spawned with
+* inherited stdio, such as `execFileSync("git", ...)`) wrote to its own
+* stdout or stderr, which Vitest pipes through to the main process
+* untouched. Distinct from `consoleLeaks`, which counts `console.*` calls
+* Vitest did capture.
+*
+* A run-level signal: the bytes arrive on one stream shared by every project,
+* so nothing attributes them to a project, file or test. Every project report
+* of a run carries the same value. Counts are of non-blank lines; `bytes`
+* counts everything recorded. `samples` holds the first few lines. Omitted
+* when the run wrote nothing stray (and whenever the plugin does not own the
+* console: `passthrough` mode records nothing).
+* @public
+*/
+const StrayOutput = Schema.Struct({
+	total: Schema.Number,
+	stdout: Schema.Number,
+	stderr: Schema.Number,
+	bytes: Schema.Number,
+	samples: Schema.Array(StrayOutputSample)
+}).annotate({ identifier: "StrayOutput" });
+
+//#endregion
+export { StrayOutput, StrayOutputSample };

package/utils/stray-output.js

@@ -0,0 +1,143 @@
+//#region src/utils/stray-output.ts
+const ESCAPE = /\x1b(?:\[[0-?]*[ -/]*[@-~]|\][^\x07\x1b]*(?:\x07|\x1b\\)|[@-Z\\-_]|c)/g;
+const CONTROL = /[\x00-\x08\x0b-\x1f\x7f]/g;
+/**
+* True when `text` is nothing but terminal escape sequences: the cursor
+* hide/show, clear-screen and erase-scrollback writes Vitest's own `Logger`
+* makes straight to its output stream. Empty text is not escape-only.
+* @public
+*/
+const isEscapeOnly = (text) => text.length > 0 && text.replace(ESCAPE, "").length === 0;
+const encoder = new TextEncoder();
+/**
+* Make a {@link StrayOutputRecorder}.
+* @public
+*/
+const makeStrayOutputRecorder = (options = {}) => {
+	const maxSamples = options.maxSamples ?? 5;
+	const maxChars = options.maxSampleChars ?? 160;
+	let counts = {
+		stdout: 0,
+		stderr: 0
+	};
+	let bytes = 0;
+	let samples = [];
+	let pending = {
+		stdout: {
+			text: "",
+			cut: false
+		},
+		stderr: {
+			text: "",
+			cut: false
+		}
+	};
+	const clean = (line) => line.replace(ESCAPE, "").replace(CONTROL, "").trim();
+	const sampleOf = (line) => {
+		const text = clean(line.text);
+		return line.cut || text.length > maxChars ? `${text.slice(0, maxChars)}…` : text;
+	};
+	const finish = (stream, line, into, out) => {
+		if (clean(line.text) === "") return;
+		into[stream]++;
+		if (out.length < maxSamples) out.push({
+			stream,
+			text: sampleOf(line)
+		});
+	};
+	const append = (line, text) => {
+		const room = maxChars * 4 - line.text.length;
+		if (text.length <= room) line.text += text;
+		else {
+			line.text += text.slice(0, Math.max(0, room));
+			line.cut = true;
+		}
+	};
+	return {
+		write: (stream, text) => {
+			if (text.length === 0 || isEscapeOnly(text)) return;
+			bytes += encoder.encode(text).length;
+			const parts = text.split("\n");
+			const line = pending[stream];
+			append(line, parts[0] ?? "");
+			for (let i = 1; i < parts.length; i++) {
+				finish(stream, line, counts, samples);
+				line.text = "";
+				line.cut = false;
+				append(line, parts[i] ?? "");
+			}
+		},
+		snapshot: () => {
+			const totals = { ...counts };
+			const out = [...samples];
+			finish("stdout", pending.stdout, totals, out);
+			finish("stderr", pending.stderr, totals, out);
+			const total = totals.stdout + totals.stderr;
+			if (total === 0) return void 0;
+			return {
+				total,
+				stdout: totals.stdout,
+				stderr: totals.stderr,
+				bytes,
+				samples: out
+			};
+		},
+		reset: () => {
+			counts = {
+				stdout: 0,
+				stderr: 0
+			};
+			bytes = 0;
+			samples = [];
+			pending = {
+				stdout: {
+					text: "",
+					cut: false
+				},
+				stderr: {
+					text: "",
+					cut: false
+				}
+			};
+		}
+	};
+};
+/**
+* The key a stray-output capture publishes its {@link StrayOutputSource}
+* under, on the Vitest `Logger` whose streams it wraps. `Symbol.for`, so a
+* plugin and an MCP server that load different copies of this package still
+* meet on it.
+* @public
+*/
+const STRAY_OUTPUT_SOURCE = Symbol.for("vitest-agent/stray-output");
+/**
+* Read the current run's stray output from a Vitest `Logger` a capture was
+* installed on. `undefined` when none was installed, or the run wrote nothing.
+* @public
+*/
+const readStrayOutput = (logger) => {
+	if (logger === null || typeof logger !== "object") return void 0;
+	const source = logger[STRAY_OUTPUT_SOURCE];
+	if (source === null || typeof source !== "object") return void 0;
+	const snapshot = source.snapshot;
+	return typeof snapshot === "function" ? snapshot() : void 0;
+};
+const MAX_NOTE_SAMPLES = 3;
+/**
+* The note a renderer prints for a run's stray output: one line naming the
+* count, the streams, the usual cause and the fix, then up to three sample
+* lines and how many it left out.
+* @public
+*/
+const formatStrayOutputNote = (stray) => {
+	const streams = stray.stdout > 0 && stray.stderr > 0 ? "stdout and stderr" : stray.stdout > 0 ? "stdout" : "stderr";
+	const lines = [`Stray output: tests wrote ${stray.total} ${stray.total === 1 ? "line" : "lines"} directly to ${streams}, bypassing Vitest's console capture. A child process with inherited stdio is the usual cause; pass \`stdio: "pipe"\`.`];
+	const shown = stray.samples.slice(0, MAX_NOTE_SAMPLES);
+	for (const sample of shown) lines.push(`  ${sample.stream}: ${sample.text}`);
+	const more = stray.total - shown.length;
+	if (more > 0 && shown.length > 0) lines.push(`  (+${more} more)`);
+	return lines;
+};
+
+//#endregion
+export { STRAY_OUTPUT_SOURCE, formatStrayOutputNote, isEscapeOnly, makeStrayOutputRecorder, readStrayOutput };

package/version.js

@@ -11,7 +11,7 @@
 * survives into the published artifact.
 * @public
 */
-const CURRENT_SDK_VERSION = "6.0.0";
+const CURRENT_SDK_VERSION = "7.0.0";
 
 //#endregion
 export { CURRENT_SDK_VERSION };