@vitest-agent/sdk 2.5.1 → 3.1.0

package/index.js

@@ -25,7 +25,7 @@ import { HistoryTracker, historyKey } from "./services/HistoryTracker.js";
 import { DataReaderLive } from "./layers/DataReaderLive.js";
 import { ActorType, AgentId, ChatId, ConversationId, HostKind, ProjectKey, TddTaskId } from "./schemas/Identity.js";
 import { Agent, IdempotencyHit } from "./schemas/Agent.js";
-import { DataStore } from "./services/DataStore.js";
+import { DataStore, INLINE_ATTACHMENT_BODY_CAP_BYTES } from "./services/DataStore.js";
 import { coerceErrorField, coerceErrorText } from "./utils/coerce-error-text.js";
 import { DataStoreLive } from "./layers/DataStoreLive.js";
 import { DetailResolver } from "./services/DetailResolver.js";
@@ -50,7 +50,7 @@ import { PathResolutionLive } from "./layers/PathResolutionLive.js";
 import { PerClientSessionMapReader, PerClientSessionMapWriter } from "./services/PerClientSessionMap.js";
 import { PerClientSessionMapReaderLive, PerClientSessionMapWriterLive } from "./layers/PerClientSessionMapLive.js";
 import { ProjectDiscovery } from "./services/ProjectDiscovery.js";
-import { NON_DISCOVERABLE_DIRS, SRC_DIR, TEST_DIR, TEST_FILE_GLOB_SUFFIX, TEST_HELPER_DIRS, classifyTestPath, findOwningWorkspace, isTestFileName } from "./utils/test-location.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 { ProjectDiscoveryLive } from "./layers/ProjectDiscoveryLive.js";
 import { ProjectDiscoveryTest } from "./layers/ProjectDiscoveryTest.js";
 import { canonicalizeGitUrl, gitUrlToProjectKey } from "./utils/canonicalize-git-url.js";
@@ -63,11 +63,13 @@ import { RunContextLive, RunContextTest } from "./layers/RunContextLive.js";
 import { formatTriageEffect } from "./lib/format-triage.js";
 import { formatWrapupEffect } from "./lib/format-wrapup.js";
 import migration from "./migrations/0001_initial.js";
-import migration$1 from "./migrations/registry_0001_initial.js";
-import migration$2 from "./migrations/session_map_0001_initial.js";
+import migration$1 from "./migrations/0002_test_artifacts.js";
+import { PROJECT_MIGRATIONS } from "./migrations/index.js";
+import migration$2 from "./migrations/registry_0001_initial.js";
+import migration$3 from "./migrations/session_map_0001_initial.js";
 import { AgentConsoleMode, CiConsoleMode, ConsoleMode, ConsoleOutputMode, DetailLevel, Environment, Executor, HumanConsoleMode, OutputFormat, PackageManager, ReportError, TestClassification, TestRunReason, TestState } from "./schemas/Common.js";
 import { ConsoleLeakFile, ConsoleLeaks, ConsoleLeaksFromFailingTests } from "./schemas/ConsoleLeaks.js";
-import { MetricThresholds, PatternThresholds, ResolvedThresholds } from "./schemas/Thresholds.js";
+import { MetricThresholds, PatternMetricThresholds, PatternThresholds, PerFileThresholds, ResolvedThresholds } from "./schemas/Thresholds.js";
 import { CoverageReport, CoverageTotals, FileCoverageReport } from "./schemas/Coverage.js";
 import { AgentReport, ModuleReport, ReportSummary, TagCountEntry, TestReport } from "./schemas/AgentReport.js";
 import { CoverageBaselines } from "./schemas/Baselines.js";
@@ -77,9 +79,11 @@ import { CoverageLevel, resolveCoverageInput, validateCoverageConfig } from "./s
 import { CoverageTargets, CoverageTargetsMetrics } from "./schemas/CoverageTargets.js";
 import { HistoryRecord, TestHistory, TestRun } from "./schemas/History.js";
 import { Transport } from "./schemas/Transport.js";
-import { AgentPluginOptions, AgentReporterOptions, ConsoleOutputs } from "./schemas/Options.js";
+import { AgentPluginOptions, AgentReporterOptions, ConsoleOutputs, ReportOption, ReportSettings } from "./schemas/Options.js";
+import { TestAnnotation, TestArtifact, TestArtifactLocation, TestAttachment } from "./schemas/TestArtifacts.js";
 import { ActionSeverity, ConsoleLogLevel, CoverageGap, CoverageMetric, HookStatus, HookType, RunEvent } from "./schemas/RunEvent.js";
 import { CoverageRenderState, FailureRecord, ModuleRecord, RenderState, RenderTotals, SuggestedActionRecord, TestRecord, initialRenderState } from "./schemas/RenderState.js";
+import { RUN_REPORT_FILE_SCHEMA_URL, RunReportFile } from "./schemas/RunReportFile.js";
 import { BehaviorDetail, BehaviorRow, BehaviorStatus, GoalDetail, GoalRow, GoalStatus } from "./schemas/Tdd.js";
 import { TrendEntry, TrendRecord } from "./schemas/Trends.js";
 import { FileEditPayload } from "./schemas/turns/FileEditPayload.js";
@@ -119,7 +123,7 @@ import { requiredArtifactForTransition, transitionEnforcesBehaviorMatch, validat
 * substituted yet. Exported for version introspection by downstream tooling.
 * @public
 */
-const CURRENT_SDK_VERSION = "2.5.1";
+const CURRENT_SDK_VERSION = "3.1.0";
 
 //#endregion
-export { ActionSeverity, ActorType, Agent, AgentConsoleMode, AgentContext, AgentId, AgentNotFoundError, AgentPluginOptions, AgentReport, AgentReporterOptions, BehaviorAbandonedEvent, BehaviorAddedEvent, BehaviorCompletedEvent, BehaviorDetail, BehaviorNotFoundError, BehaviorRow, BehaviorScopedEventTypes, BehaviorStartedEvent, BehaviorStatus, BehaviorsReadyEvent, BlockedEvent, CURRENT_SDK_VERSION, CacheManifest, CacheManifestEntry, ChannelEvent, ChatId, CiConsoleMode, ConfigLive, ConsoleLeakFile, ConsoleLeaks, ConsoleLeaksFromFailingTests, ConsoleLogLevel, ConsoleMode, ConsoleOutputMode, ConsoleOutputs, ConversationId, ConversationNotFoundError, CoverageBaselines, FileCoverageReport as CoverageFile, CoverageGap, CoverageLevel, CoverageMetric, CoverageRenderState, CoverageReport, CoverageTargets, CoverageTargetsMetrics, CoverageTotals, DATABASE_FILENAME, DataReader, DataReaderLive, DataStore, DataStoreError, DataStoreLive, DetailLevel, DetailResolver, DetailResolverLive, DiscoveryError, DiscoveryRegistry, DiscoveryRegistryLive, Environment, EnvironmentDetector, EnvironmentDetectorLive, EnvironmentDetectorTest, Executor, ExecutorResolver, ExecutorResolverLive, FailureRecord, FileCoverageReport, FileEditPayload, FormatSelector, FormatSelectorLive, GfmFormatter, GitCommandError, GoalAbandonedEvent, GoalAddedEvent, GoalCompletedEvent, GoalDetail, GoalNotFoundError, GoalRow, GoalStartedEvent, GoalStatus, GoalsReadyEvent, HistoryRecord, HistoryTracker, HistoryTrackerLive, HistoryTrackerTest, HookFirePayload, HookStatus, HookType, HostKind, HostMetadataParseError, HumanConsoleMode, HypothesisPayload, IDEMPOTENCY_ROOT_SENTINEL, IdempotencyHit, IllegalStatusTransitionError, JsonFormatter, LoggerLive, MarkdownFormatter, MetricThresholds, ModuleRecord, ModuleReport, NON_DISCOVERABLE_DIRS, NotePayload, OutputFormat, OutputPipelineLive, OutputRenderer, OutputRendererLive, PackageManager, PathResolutionError, PathResolutionLive, PatternThresholds, PerClientSessionMapReader, PerClientSessionMapReaderLive, PerClientSessionMapWriter, PerClientSessionMapWriterLive, PhaseTransitionEvent, ProbeMissError, ProjectDiscovery, ProjectDiscoveryLive, ProjectDiscoveryTest, ProjectIdentity, ProjectIdentityLive, ProjectIdentityNotResolvableError, ProjectIdentityTest, ProjectKey, RegistrationConflictError, RenderState, RenderTotals, ReportError, ReportSummary, ResolvedThresholds, RunContext, RunContext$, RunContextLive, RunContextService, RunContextTest, RunEvent, SRC_DIR, SessionCompleteEvent, SessionNotFoundError, SessionOutcome, SidecarTimeoutError, SilentFormatter, SuggestedActionRecord, TEST_DIR, TEST_FILE_GLOB_SUFFIX, TEST_HELPER_DIRS, TagCountEntry, TddTaskAlreadyEndedError, TddTaskId, TddTaskNotFoundError, TerminalFormatter, TestClassification, TestHistory, TestRecord, TestReport, TestRun, TestRunReason, TestState, ToolCallPayload, ToolResultPayload, Transport, TrendEntry, TrendRecord, TurnPayload, UserPromptPayload, VitestAgentConfig, VitestAgentConfigFile, _resetMigrationCacheForTesting, ansi, assembleHistoryRecord, assembleManifest, buildAgentReport, buildConsoleLeaks, buildEnvPrefix, canonicalizeGitUrl, ciAnnotationsFormatter, classifyTest, classifyTestPath, coerceErrorField, coerceErrorText, collectConsoleLeakEntries, compressLines, computeFailureSignature, computeTrend, countSuiteFailures, deriveIdempotencyKey, detectNonDefaultDiscoverStrategy, detectPackageManager, detectVitestScripts, determineTier, ensureMigrated, extractSqlReason, findFunctionBoundary, findOwningWorkspace, formatConsoleMarkdown, formatFatalError, formatGfm, formatScopedCoverageNote, formatTriageEffect, formatWrapupEffect, getRecentDirection, getRunCommand, getWorstMetric, gitUrlToProjectKey, hashTargets, historyKey, initialRenderState, isTestFileName, isTimeoutError, isVitestInvocation, migration as migration0001, normalizeAssertionShape, normalizeWorkspaceKey, osc8, probeHostMetadataFromEnv, migration$1 as registryMigration0001, relativePath, requiredArtifactForTransition, resolveCoverageInput, resolveDataPath, resolveLogFile, resolveLogLevel, resolveProjectIdentityFromCandidates, resolveProjectKeyFromCwd, resolveWorkspaceKey, rewriteBashCommand, safeFilename, migration$2 as sessionMapMigration0001, stripAnsi, transitionEnforcesBehaviorMatch, validateCoverageConfig, validateCoverageTargetsShape, validatePhaseTransition };
+export { ActionSeverity, ActorType, Agent, AgentConsoleMode, AgentContext, 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, ConfigLive, ConsoleLeakFile, ConsoleLeaks, ConsoleLeaksFromFailingTests, ConsoleLogLevel, ConsoleMode, ConsoleOutputMode, ConsoleOutputs, ConversationId, ConversationNotFoundError, CoverageBaselines, FileCoverageReport as CoverageFile, CoverageGap, CoverageLevel, CoverageMetric, CoverageRenderState, CoverageReport, CoverageTargets, CoverageTargetsMetrics, CoverageTotals, DATABASE_FILENAME, DataReader, DataReaderLive, DataStore, DataStoreError, DataStoreLive, DetailLevel, DetailResolver, DetailResolverLive, DiscoveryError, DiscoveryRegistry, DiscoveryRegistryLive, Environment, EnvironmentDetector, EnvironmentDetectorLive, EnvironmentDetectorTest, Executor, ExecutorResolver, ExecutorResolverLive, FailureRecord, FileCoverageReport, FileEditPayload, FormatSelector, FormatSelectorLive, GfmFormatter, GitCommandError, GoalAbandonedEvent, GoalAddedEvent, GoalCompletedEvent, GoalDetail, GoalNotFoundError, GoalRow, GoalStartedEvent, GoalStatus, GoalsReadyEvent, HistoryRecord, HistoryTracker, HistoryTrackerLive, HistoryTrackerTest, HookFirePayload, HookStatus, HookType, HostKind, HostMetadataParseError, HumanConsoleMode, HypothesisPayload, IDEMPOTENCY_ROOT_SENTINEL, INLINE_ATTACHMENT_BODY_CAP_BYTES, IdempotencyHit, IllegalStatusTransitionError, JsonFormatter, LoggerLive, MarkdownFormatter, MetricThresholds, ModuleRecord, ModuleReport, NON_DISCOVERABLE_DIRS, NotePayload, OutputFormat, OutputPipelineLive, OutputRenderer, OutputRendererLive, PROJECT_MIGRATIONS, PackageManager, PathResolutionError, PathResolutionLive, PatternMetricThresholds, PatternThresholds, PerClientSessionMapReader, PerClientSessionMapReaderLive, PerClientSessionMapWriter, PerClientSessionMapWriterLive, PerFileThresholds, PhaseTransitionEvent, ProbeMissError, ProjectDiscovery, ProjectDiscoveryLive, ProjectDiscoveryTest, ProjectIdentity, ProjectIdentityLive, ProjectIdentityNotResolvableError, ProjectIdentityTest, ProjectKey, RUN_REPORT_FILE_SCHEMA_URL, RegistrationConflictError, RenderState, RenderTotals, ReportError, ReportOption, ReportSettings, ReportSummary, ResolvedThresholds, RunContext, RunContext$, RunContextLive, RunContextService, RunContextTest, RunEvent, RunReportFile, SRC_DIR, SessionCompleteEvent, SessionNotFoundError, SessionOutcome, SidecarTimeoutError, SilentFormatter, SuggestedActionRecord, TEST_DIR, TEST_FILE_GLOB_SUFFIX, TEST_HELPER_DIRS, TagCountEntry, TddTaskAlreadyEndedError, TddTaskId, TddTaskNotFoundError, TerminalFormatter, TestAnnotation, TestArtifact, TestArtifactLocation, TestAttachment, TestClassification, TestHistory, TestRecord, TestReport, TestRun, TestRunReason, TestState, ToolCallPayload, ToolResultPayload, Transport, TrendEntry, TrendRecord, TurnPayload, UserPromptPayload, VitestAgentConfig, VitestAgentConfigFile, _resetMigrationCacheForTesting, ansi, assembleHistoryRecord, assembleManifest, buildAgentReport, buildConsoleLeaks, buildEnvPrefix, canonicalizeGitUrl, ciAnnotationsFormatter, classifyTest, classifyTestPath, coerceErrorField, coerceErrorText, collectConsoleLeakEntries, compressLines, computeFailureSignature, computeTrend, countSuiteFailures, deriveIdempotencyKey, detectNonDefaultDiscoverStrategy, detectPackageManager, detectVitestScripts, determineTier, ensureMigrated, extractSqlReason, findFunctionBoundary, findOwningWorkspace, formatConsoleMarkdown, formatFatalError, formatGfm, formatScopedCoverageNote, formatTriageEffect, formatWrapupEffect, getRecentDirection, getRunCommand, getWorstMetric, gitUrlToProjectKey, hashTargets, historyKey, initialRenderState, isTestFileName, isTimeoutError, isVitestInvocation, migration as migration0001, migration$1 as migration0002, normalizeAssertionShape, normalizeWorkspaceKey, osc8, probeHostMetadataFromEnv, migration$2 as registryMigration0001, relativePath, requiredArtifactForTransition, resolveCoverageInput, resolveDataPath, resolveLogFile, resolveLogLevel, resolveProjectIdentityFromCandidates, resolveProjectKeyFromCwd, resolveWorkspaceKey, rewriteBashCommand, safeFilename, migration$3 as sessionMapMigration0001, stripAnsi, transitionEnforcesBehaviorMatch, validateCoverageConfig, validateCoverageTargetsShape, validatePhaseTransition };

package/layers/DataReaderLive.js

@@ -602,6 +602,94 @@ const DataReaderLive = Layer.effect(DataReader, Effect.gen(function* () {
 		table: "test_errors",
 		reason: extractSqlReason(e)
 	})));
+	const latestRunId = (project) => Effect.gen(function* () {
+		const runs = yield* sql`SELECT id FROM test_runs WHERE project = ${project} ORDER BY timestamp DESC LIMIT 1`;
+		return runs.length === 0 ? null : runs[0].id;
+	});
+	const attachmentsFor = (column, ownerId) => Effect.gen(function* () {
+		return (column === "annotation_id" ? yield* sql`SELECT content_type, path, body, body_encoding, byte_size FROM attachments WHERE annotation_id = ${ownerId} ORDER BY id` : yield* sql`SELECT content_type, path, body, body_encoding, byte_size FROM attachments WHERE artifact_id = ${ownerId} ORDER BY id`).map((r) => ({
+			...r.content_type !== null && { contentType: r.content_type },
+			...r.path !== null && { path: r.path },
+			...r.body !== null && { body: r.body },
+			...r.body_encoding !== null && { bodyEncoding: r.body_encoding },
+			byteSize: r.byte_size
+		}));
+	});
+	const getAnnotationsForTest = (project, fullName, options) => Effect.gen(function* () {
+		yield* Effect.logDebug("getAnnotationsForTest").pipe(Effect.annotateLogs({
+			project,
+			fullName
+		}));
+		const runId = yield* latestRunId(project);
+		if (runId === null) return [];
+		const modulePath = options?.modulePath ?? null;
+		const rows = yield* sql`SELECT ta.id, ta.type, ta.message, ta.location_line, ta.location_column, f.path AS location_path
+					FROM test_annotations ta
+					JOIN test_cases tc ON tc.id = ta.test_case_id
+					JOIN test_modules tm ON tm.id = tc.module_id
+					LEFT JOIN files f ON f.id = ta.location_file_id
+					WHERE tm.run_id = ${runId} AND tc.full_name = ${fullName}
+						AND (${modulePath} IS NULL OR tm.relative_module_id = ${modulePath})
+					ORDER BY ta.id`;
+		const out = [];
+		for (const r of rows) {
+			const attachments = yield* attachmentsFor("annotation_id", r.id);
+			out.push({
+				id: r.id,
+				type: r.type,
+				message: r.message,
+				...r.location_path !== null && r.location_line !== null && r.location_column !== null && { location: {
+					file: r.location_path,
+					line: r.location_line,
+					column: r.location_column
+				} },
+				attachments
+			});
+		}
+		return out;
+	}).pipe(Effect.annotateLogs("service", "DataReader"), Effect.mapError((e) => new DataStoreError({
+		operation: "read",
+		table: "test_annotations",
+		reason: extractSqlReason(e)
+	})));
+	const getArtifactsForTest = (project, fullName, options) => Effect.gen(function* () {
+		yield* Effect.logDebug("getArtifactsForTest").pipe(Effect.annotateLogs({
+			project,
+			fullName
+		}));
+		const runId = yield* latestRunId(project);
+		if (runId === null) return [];
+		const modulePath = options?.modulePath ?? null;
+		const rows = yield* sql`SELECT ta.id, ta.type, ta.message, ta.data, ta.location_line, ta.location_column, f.path AS location_path
+					FROM test_artifacts ta
+					JOIN test_cases tc ON tc.id = ta.test_case_id
+					JOIN test_modules tm ON tm.id = tc.module_id
+					LEFT JOIN files f ON f.id = ta.location_file_id
+					WHERE tm.run_id = ${runId} AND tc.full_name = ${fullName}
+						AND (${modulePath} IS NULL OR tm.relative_module_id = ${modulePath})
+					ORDER BY ta.id`;
+		const out = [];
+		for (const r of rows) {
+			const attachments = yield* attachmentsFor("artifact_id", r.id);
+			out.push({
+				id: r.id,
+				type: r.type,
+				message: r.message,
+				data: r.data,
+				...r.location_path !== null && r.location_line !== null && r.location_column !== null && { location: {
+					file: r.location_path,
+					line: r.location_line,
+					column: r.location_column
+				} },
+				attachments
+			});
+		}
+		return out;
+	}).pipe(Effect.annotateLogs("service", "DataReader"), Effect.mapError((e) => new DataStoreError({
+		operation: "read",
+		table: "test_artifacts",
+		reason: extractSqlReason(e)
+	})));
 	const getNotes = (scope, project, testFullName) => Effect.gen(function* () {
 		yield* Effect.logDebug("getNotes").pipe(Effect.annotateLogs({
 			scope: scope ?? null,
@@ -1759,6 +1847,8 @@ const DataReaderLive = Layer.effect(DataReader, Effect.gen(function* () {
 		getCoverage,
 		getTestsForFile,
 		getErrors,
+		getAnnotationsForTest,
+		getArtifactsForTest,
 		getNotes,
 		getNoteById,
 		searchNotes,

package/layers/DataStoreLive.js

@@ -2,10 +2,11 @@ import { AgentNotFoundError, RegistrationConflictError } from "../errors/AgentEr
 import { DataStoreError, extractSqlReason } from "../errors/DataStoreError.js";
 import { BehaviorNotFoundError, GoalNotFoundError, IllegalStatusTransitionError, TddTaskAlreadyEndedError, TddTaskNotFoundError } from "../errors/TddErrors.js";
 import { Agent, IdempotencyHit } from "../schemas/Agent.js";
-import { DataStore } from "../services/DataStore.js";
+import { DataStore, INLINE_ATTACHMENT_BODY_CAP_BYTES } from "../services/DataStore.js";
 import { coerceErrorText } from "../utils/coerce-error-text.js";
 import { Effect, Layer, Option } from "effect";
 import { SqlClient } from "effect/unstable/sql/SqlClient";
+import { Buffer } from "node:buffer";
 import { randomUUID } from "node:crypto";
 
 //#region src/layers/DataStoreLive.ts
@@ -163,6 +164,49 @@ const DataStoreLive = Layer.effect(DataStore, Effect.gen(function* () {
 		table: "test_errors",
 		reason: extractSqlReason(e)
 	})));
+	const writeAttachments = (owner, attachments) => Effect.gen(function* () {
+		for (const att of attachments) {
+			const artifactId = "artifactId" in owner ? owner.artifactId : null;
+			const annotationId = "annotationId" in owner ? owner.annotationId : null;
+			const storedBytes = att.body === void 0 ? 0 : Buffer.byteLength(att.body, "utf8");
+			const inline = att.body !== void 0 && Math.max(storedBytes, att.byteSize) <= 65536;
+			const body = inline ? att.body : null;
+			const bodyEncoding = inline ? att.bodyEncoding ?? null : null;
+			yield* sql`INSERT INTO attachments (artifact_id, annotation_id, content_type, path, body, body_encoding, byte_size) VALUES (${artifactId}, ${annotationId}, ${att.contentType ?? null}, ${att.path ?? null}, ${body}, ${bodyEncoding}, ${att.byteSize})`;
+		}
+	});
+	const writeAnnotations = (runId, annotations) => Effect.gen(function* () {
+		yield* Effect.logDebug("writeAnnotations").pipe(Effect.annotateLogs({
+			runId,
+			count: annotations.length
+		}));
+		for (const anno of annotations) {
+			const locationFileId = anno.locationFile !== void 0 ? yield* ensureFile(anno.locationFile) : null;
+			yield* sql`INSERT INTO test_annotations (test_case_id, type, message, location_file_id, location_line, location_column) VALUES (${anno.testCaseId}, ${anno.type}, ${anno.message}, ${locationFileId}, ${anno.locationLine ?? null}, ${anno.locationColumn ?? null})`;
+			const idRows = yield* sql`SELECT last_insert_rowid() as id`;
+			yield* writeAttachments({ annotationId: idRows[0].id }, anno.attachments ?? []);
+		}
+	}).pipe(Effect.annotateLogs("service", "DataStore"), Effect.mapError((e) => new DataStoreError({
+		operation: "write",
+		table: "test_annotations",
+		reason: extractSqlReason(e)
+	})));
+	const writeArtifacts = (runId, artifacts) => Effect.gen(function* () {
+		yield* Effect.logDebug("writeArtifacts").pipe(Effect.annotateLogs({
+			runId,
+			count: artifacts.length
+		}));
+		for (const art of artifacts) {
+			const locationFileId = art.locationFile !== void 0 ? yield* ensureFile(art.locationFile) : null;
+			yield* sql`INSERT INTO test_artifacts (test_case_id, type, message, data, location_file_id, location_line, location_column) VALUES (${art.testCaseId}, ${art.type}, ${art.message ?? null}, ${art.data ?? null}, ${locationFileId}, ${art.locationLine ?? null}, ${art.locationColumn ?? null})`;
+			const idRows = yield* sql`SELECT last_insert_rowid() as id`;
+			yield* writeAttachments({ artifactId: idRows[0].id }, art.attachments ?? []);
+		}
+	}).pipe(Effect.annotateLogs("service", "DataStore"), Effect.mapError((e) => new DataStoreError({
+		operation: "write",
+		table: "test_artifacts",
+		reason: extractSqlReason(e)
+	})));
 	const writeCoverage = (runId, coverage) => Effect.gen(function* () {
 		yield* Effect.logDebug("writeCoverage").pipe(Effect.annotateLogs({
 			runId,
@@ -183,7 +227,7 @@ const DataStoreLive = Layer.effect(DataStore, Effect.gen(function* () {
 			modulePath,
 			runId
 		}));
-		yield* sql`INSERT INTO test_history (run_id, project, module_path, full_name, timestamp, state, duration, flaky, retry_count, error_message) VALUES (${runId}, ${project}, ${modulePath}, ${fullName}, ${timestamp}, ${state}, ${duration}, ${flaky ? 1 : 0}, ${retryCount}, ${errorMessage})`;
+		yield* sql`INSERT INTO test_history (run_id, project, module_path, full_name, timestamp, state, duration, flaky, retry_count, error_message) VALUES (${runId}, ${project}, ${modulePath}, ${fullName}, ${timestamp}, ${state}, ${duration}, ${flaky ? 1 : 0}, ${retryCount}, ${errorMessage}) ON CONFLICT(project, module_path, full_name, timestamp) DO UPDATE SET run_id = excluded.run_id, state = excluded.state, duration = excluded.duration, flaky = excluded.flaky, retry_count = excluded.retry_count, error_message = excluded.error_message`;
 		yield* sql`DELETE FROM test_history WHERE id NOT IN (SELECT id FROM test_history WHERE project = ${project} AND module_path = ${modulePath} AND full_name = ${fullName} ORDER BY timestamp DESC LIMIT 10) AND project = ${project} AND module_path = ${modulePath} AND full_name = ${fullName}`;
 	}).pipe(Effect.annotateLogs("service", "DataStore"), Effect.mapError((e) => new DataStoreError({
 		operation: "write",
@@ -1193,6 +1237,8 @@ const DataStoreLive = Layer.effect(DataStore, Effect.gen(function* () {
 		writeSuites,
 		writeTestCases,
 		writeErrors,
+		writeAnnotations,
+		writeArtifacts,
 		writeCoverage,
 		writeHistory,
 		writeBaselines,

package/migrations/0002_test_artifacts.js

@@ -0,0 +1,30 @@
+import { Effect } from "effect";
+import { SqlClient } from "effect/unstable/sql/SqlClient";
+
+//#region src/migrations/0002_test_artifacts.ts
+/** @internal */
+const migration = Effect.gen(function* () {
+	const sql = yield* SqlClient;
+	yield* sql`DROP INDEX IF EXISTS idx_test_annotations_case`;
+	yield* sql`DROP INDEX IF EXISTS idx_test_annotations_type`;
+	yield* sql`DROP TABLE IF EXISTS test_annotations`;
+	yield* sql`
+		CREATE TABLE test_annotations (
+			id INTEGER PRIMARY KEY AUTOINCREMENT,
+			test_case_id INTEGER NOT NULL REFERENCES test_cases(id) ON DELETE CASCADE,
+			type TEXT NOT NULL,
+			message TEXT NOT NULL,
+			location_file_id INTEGER REFERENCES files(id),
+			location_line INTEGER,
+			location_column INTEGER
+		)
+	`;
+	yield* sql`CREATE INDEX idx_test_annotations_case ON test_annotations(test_case_id)`;
+	yield* sql`CREATE INDEX idx_test_annotations_type ON test_annotations(type)`;
+	yield* sql`ALTER TABLE test_artifacts ADD COLUMN data TEXT`;
+	yield* sql`ALTER TABLE attachments ADD COLUMN byte_size INTEGER`;
+	yield* sql`ALTER TABLE attachments ADD COLUMN body_encoding TEXT`;
+});
+
+//#endregion
+export { migration as default };

package/migrations/index.js

@@ -0,0 +1,26 @@
+import migration from "./0001_initial.js";
+import migration$1 from "./0002_test_artifacts.js";
+
+//#region src/migrations/index.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
+*/
+const PROJECT_MIGRATIONS = {
+	"0001_initial": migration,
+	"0002_test_artifacts": migration$1
+};
+
+//#endregion
+export { PROJECT_MIGRATIONS };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vitest-agent/sdk",
-	"version": "2.5.1",
+	"version": "3.1.0",
 	"private": false,
 	"description": "Shared Effect Schema, SQLite migrations, data layer, services, formatters, and utilities for vitest-agent packages.",
 	"keywords": [
@@ -42,18 +42,19 @@
 			"import": "./testing.js",
 			"default": "./testing.js"
 		},
+		"./schemas/*.json": "./schemas/*.json",
 		"./package.json": "./package.json"
 	},
 	"dependencies": {
 		"@effect/platform-node": "4.0.0-rc.112",
 		"@effect/sql-sqlite-node": "4.0.0-rc.112",
-		"@effected/config-file": "^0.6.0",
+		"@effected/config-file": "^0.7.0",
 		"@effected/jsonc": "^0.9.0",
 		"@effected/toml": "^0.6.0",
-		"@effected/walker": "^0.6.0",
-		"@effected/workspaces": "^0.20.0",
-		"@effected/xdg": "^0.4.0",
-		"@effected/yaml": "^0.13.0",
+		"@effected/walker": "^0.7.0",
+		"@effected/workspaces": "^0.20.1",
+		"@effected/xdg": "^0.4.1",
+		"@effected/yaml": "^0.14.0",
 		"acorn": "^8.18.0",
 		"acorn-typescript": "^1.4.13",
 		"ajv": "^8.20.0",

package/schemas/CoverageTargets.js

@@ -1,3 +1,4 @@
+import { PerFileThresholds } from "./Thresholds.js";
 import { Schema } from "effect";
 
 //#region src/schemas/CoverageTargets.ts
@@ -8,7 +9,8 @@ import { Schema } from "effect";
 const PositivePercent = Schema.Number.check(Schema.isGreaterThan(0));
 /**
 * 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
 */
 const CoverageTargetsMetrics = Schema.Struct({
@@ -16,7 +18,8 @@ const CoverageTargetsMetrics = Schema.Struct({
 	functions: Schema.optional(PositivePercent),
 	branches: Schema.optional(PositivePercent),
 	statements: Schema.optional(PositivePercent),
-	100: Schema.optional(Schema.Literal(true))
+	100: Schema.optional(Schema.Literal(true)),
+	perFile: Schema.optional(PerFileThresholds)
 }).annotate({ identifier: "CoverageTargetsMetrics" });
 /**
 * Typed schema for the coverageTargets option.
@@ -24,8 +27,10 @@ const CoverageTargetsMetrics = Schema.Struct({
 * 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

package/schemas/Options.js

@@ -25,18 +25,34 @@ const ConsoleOutputs = Schema.Struct({
 	ci: Schema.optional(CiConsoleMode)
 }).annotate({ identifier: "ConsoleOutputs" });
 /**
+* Report-file settings. An object overrides the scope directory name
+* used under `.vitest/`; the default scope is `vitest-agent`.
+*
+* @public
+*/
+const ReportSettings = Schema.Struct({ scope: Schema.optional(Schema.String.check(Schema.makeFilter((scope) => scope.includes("/") || scope.includes("\\") || scope === ".." || scope === "." ? `report.scope ${scope} must be a single directory name — it is resolved directly under .vitest/ and cannot nest or escape.` : void 0))) }).annotate({ identifier: "ReportSettings" });
+/**
+* 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
+*/
+const ReportOption = Schema.Union([Schema.Literal(false), ReportSettings]).annotate({ identifier: "ReportOption" });
+/**
 * 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
 */
 const AgentPluginOptions = Schema.Struct({
 	console: Schema.optional(ConsoleOutputs),
 	coverageTargets: Schema.optional(CoverageTargets),
-	transport: Schema.optional(Transport)
+	transport: Schema.optional(Transport),
+	report: Schema.optional(ReportOption)
 }).annotate({ identifier: "AgentPluginOptions" });
 /**
 * Reporter-implementation options.
@@ -54,4 +70,4 @@ const AgentReporterOptions = Schema.Struct({
 projectFilter: Schema.optional(Schema.String) }).annotate({ identifier: "AgentReporterOptions" });
 
 //#endregion
-export { AgentPluginOptions, AgentReporterOptions, ConsoleOutputs };
+export { AgentPluginOptions, AgentReporterOptions, ConsoleOutputs, ReportOption, ReportSettings };

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 { TestArtifactLocation, TestAttachment } from "./TestArtifacts.js";
 import { Schema } from "effect";
 
 //#region src/schemas/RunEvent.ts
@@ -145,13 +146,18 @@ const RunEvent = Schema.Union([
 		modulePath: Schema.String,
 		testName: Schema.String,
 		suitePath: Schema.Array(Schema.String),
-		annotation: Schema.String
+		annotation: Schema.String,
+		annotationType: Schema.String,
+		location: Schema.optional(TestArtifactLocation),
+		attachments: Schema.Array(TestAttachment)
 	}),
 	Schema.TaggedStruct("TestArtifactRecorded", {
 		modulePath: Schema.String,
 		testName: Schema.String,
 		suitePath: Schema.Array(Schema.String),
-		artifact: Schema.String
+		artifact: Schema.String,
+		location: Schema.optional(TestArtifactLocation),
+		attachments: Schema.Array(TestAttachment)
 	}),
 	Schema.TaggedStruct("WatcherReady", {}),
 	Schema.TaggedStruct("WatcherRerun", {

package/schemas/RunReportFile.js

@@ -0,0 +1,51 @@
+import { AgentReport } from "./AgentReport.js";
+import { Schema } from "effect";
+
+//#region src/schemas/RunReportFile.ts
+/**
+* The `.vitest/vitest-agent/run.json` file contract.
+*
+* This is a versioned public contract, not the raw `AgentReport`
+* encoding — a Claude Code hook or a CI step reads this file, so the
+* envelope carries its own `schemaVersion`. `reports` holds one
+* `AgentReport` per Vitest project in the run.
+*/
+/**
+* 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
+*/
+const RUN_REPORT_FILE_SCHEMA_URL = "https://vitest-agent.dev/schemas/run-report-file-1.0.0.json";
+/**
+* ISO-8601 instant, the shape `Date.prototype.toISOString` produces.
+* `Date.parse` alone is too permissive — it accepts `"Sep 7 2026"` and
+* other locale spellings a JSON Schema validator would reject — so the
+* pattern is checked first and the parse only rules out impossible
+* component values such as month 13.
+*/
+const ISO_8601_INSTANT = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/;
+const ISO_8601_MESSAGE = "generatedAt must be an ISO-8601 instant, e.g. 2026-09-07T23:45:57.308Z.";
+const IsoInstant = Schema.String.check(Schema.isPattern(ISO_8601_INSTANT, {
+	description: "An ISO-8601 instant, the shape Date.prototype.toISOString produces.",
+	message: ISO_8601_MESSAGE
+}), Schema.makeFilter((value) => Number.isNaN(Date.parse(value)) ? ISO_8601_MESSAGE : void 0)).annotate({ identifier: "IsoInstant" });
+/**
+* Envelope for the `run.json` report file.
+*
+* @public
+*/
+const RunReportFile = Schema.Struct({
+	$schema: Schema.optionalKey(Schema.String),
+	schemaVersion: Schema.Literal(1),
+	generatedAt: IsoInstant,
+	reports: Schema.Array(AgentReport)
+}).annotate({
+	identifier: "RunReportFile",
+	description: "The vitest-agent run report file (.vitest/vitest-agent/run.json): one AgentReport per Vitest project from the most recent run. Read reports[].summary for pass/fail counts and reports[].failed for the failing modules and their tests. schemaVersion is the envelope contract version; generatedAt is when the run finished."
+});
+
+//#endregion
+export { RUN_REPORT_FILE_SCHEMA_URL, RunReportFile };

package/schemas/TestArtifacts.js

@@ -0,0 +1,74 @@
+import { Schema } from "effect";
+
+//#region src/schemas/TestArtifacts.ts
+/**
+* Schemas for Vitest 5 test annotations and test artifacts.
+*
+* Vocabulary (spec §4.1): a *test annotation* is a `context.annotate`
+* note; a *test artifact* is a `recordArtifact` payload. Neither is a
+* *TDD artifact* (`tdd_artifacts`), which is red/green evidence.
+*/
+/**
+* Source position a test annotation or test artifact points at.
+* @public
+*/
+const TestArtifactLocation = Schema.Struct({
+	file: Schema.String,
+	line: Schema.Number,
+	column: Schema.Number
+}).annotate({ identifier: "TestArtifactLocation" });
+/**
+* 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
+*/
+const TestAttachment = Schema.Struct({
+	contentType: Schema.optional(Schema.String),
+	path: Schema.optional(Schema.String),
+	body: Schema.optional(Schema.String),
+	bodyEncoding: Schema.optional(Schema.Literals(["base64", "utf-8"])),
+	byteSize: Schema.Number
+}).annotate({ identifier: "TestAttachment" });
+/**
+* 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
+*/
+const TestAnnotation = Schema.Struct({
+	type: Schema.String,
+	message: Schema.String,
+	location: Schema.optional(TestArtifactLocation),
+	attachments: Schema.Array(TestAttachment)
+}).annotate({ identifier: "TestAnnotation" });
+/**
+* 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
+*/
+const TestArtifact = Schema.Struct({
+	type: Schema.String,
+	message: Schema.optional(Schema.String),
+	data: Schema.optional(Schema.String),
+	location: Schema.optional(TestArtifactLocation),
+	attachments: Schema.Array(TestAttachment)
+}).annotate({ identifier: "TestArtifact" });
+
+//#endregion
+export { TestAnnotation, TestArtifact, TestArtifactLocation, TestAttachment };

package/schemas/Thresholds.js

@@ -12,19 +12,39 @@ const MetricThresholds = Schema.Struct({
 	statements: Schema.optional(Schema.Number)
 }).annotate({ identifier: "MetricThresholds" });
 /**
+* 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
+*/
+const PerFileThresholds = Schema.Union([Schema.Boolean, MetricThresholds]).annotate({ identifier: "PerFileThresholds" });
+/**
+* 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
+*/
+const PatternMetricThresholds = Schema.Struct({
+	...MetricThresholds.fields,
+	perFile: Schema.optionalKey(PerFileThresholds)
+}).annotate({ identifier: "PatternMetricThresholds" });
+/**
 * A glob pattern paired with its metric thresholds.
 * @public
 */
-const PatternThresholds = Schema.Tuple([Schema.String, MetricThresholds]).annotate({ identifier: "PatternThresholds" });
+const PatternThresholds = Schema.Tuple([Schema.String, PatternMetricThresholds]).annotate({ identifier: "PatternThresholds" });
 /**
 * Fully resolved thresholds ready for evaluation.
 * @public
 */
 const ResolvedThresholds = Schema.Struct({
 	global: MetricThresholds,
-	perFile: Schema.Boolean.pipe(Schema.withDecodingDefaultKey(Effect.succeed(false))),
+	perFile: PerFileThresholds.pipe(Schema.withDecodingDefaultKey(Effect.succeed(false))),
 	patterns: Schema.Array(PatternThresholds).pipe(Schema.withDecodingDefaultKey(Effect.succeed([])))
 }).annotate({ identifier: "ResolvedThresholds" });
 
 //#endregion
-export { MetricThresholds, PatternThresholds, ResolvedThresholds };
+export { MetricThresholds, PatternMetricThresholds, PatternThresholds, PerFileThresholds, ResolvedThresholds };