@vitest-agent/sdk 3.1.1 → 4.0.0

package/migrations/0002_test_artifacts.js

@@ -1,30 +0,0 @@
-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

@@ -1,26 +0,0 @@
-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/migrations/registry_0001_initial.js

@@ -1,39 +0,0 @@
-import { Effect } from "effect";
-import { SqlClient } from "effect/unstable/sql/SqlClient";
-
-//#region src/migrations/registry_0001_initial.ts
-/**
-* Migration for the global discovery registry SQLite at
-* `$XDG_DATA_HOME/vitest-agent/registry.db`.
-*
-* Single table `known_projects` indexed by `project_key` (the
-* filesystem-safe form from {@link ProjectIdentity}). Tooling like
-* `mcp-app` queries this table to enumerate every vitest-agent
-* project the user has ever run on this machine.
-*
-* The registry never blocks anything — its writes are best-effort.
-* Concurrent writers from multiple Claude Code windows converge via
-* the `ON CONFLICT(project_key) DO UPDATE` upsert.
-* @public
-*/
-const migration = Effect.gen(function* () {
-	const sql = yield* SqlClient;
-	yield* sql`PRAGMA journal_mode=WAL`;
-	yield* sql`PRAGMA foreign_keys=ON`;
-	yield* sql`PRAGMA busy_timeout=5000`;
-	yield* sql`
-		CREATE TABLE known_projects (
-			project_key       TEXT PRIMARY KEY,
-			canonical_form    TEXT NOT NULL,
-			data_db_path      TEXT NOT NULL,
-			git_remote_origin TEXT,
-			workspace_root    TEXT NOT NULL,
-			first_seen_at     INTEGER NOT NULL,
-			last_seen_at      INTEGER NOT NULL
-		) STRICT
-	`;
-	yield* sql`CREATE INDEX idx_known_projects_workspace_root ON known_projects(workspace_root)`;
-});
-
-//#endregion
-export { migration as default };

package/migrations/session_map_0001_initial.js

@@ -1,38 +0,0 @@
-import { Effect } from "effect";
-import { SqlClient } from "effect/unstable/sql/SqlClient";
-
-//#region src/migrations/session_map_0001_initial.ts
-/** @internal */
-const migration = Effect.gen(function* () {
-	const sql = yield* SqlClient;
-	yield* sql`PRAGMA journal_mode=WAL`;
-	yield* sql`PRAGMA foreign_keys=ON`;
-	yield* sql`PRAGMA busy_timeout=5000`;
-	yield* sql`
-		CREATE TABLE conversation_map (
-			transcript_uuid  TEXT PRIMARY KEY,
-			transcript_path  TEXT NOT NULL,
-			conversation_id  TEXT NOT NULL UNIQUE,
-			first_seen_at    INTEGER NOT NULL,
-			last_seen_at     INTEGER NOT NULL
-		) STRICT
-	`;
-	yield* sql`
-		CREATE TABLE session_map (
-			host_session_id  TEXT PRIMARY KEY,
-			conversation_id  TEXT NOT NULL REFERENCES conversation_map(conversation_id) ON DELETE RESTRICT,
-			project_key      TEXT NOT NULL,
-			project_dir      TEXT NOT NULL,
-			main_agent_id    TEXT NOT NULL,
-			started_at       INTEGER NOT NULL,
-			ended_at         INTEGER
-		) STRICT
-	`;
-	yield* sql`CREATE INDEX idx_session_map_project_key ON session_map(project_key)`;
-	yield* sql`CREATE INDEX idx_session_map_project_dir ON session_map(project_dir)`;
-	yield* sql`CREATE INDEX idx_session_map_active ON session_map(project_dir) WHERE ended_at IS NULL`;
-	yield* sql`CREATE INDEX idx_session_map_conversation_id ON session_map(conversation_id)`;
-});
-
-//#endregion
-export { migration as default };

package/services/Config.js

@@ -1,15 +0,0 @@
-import { ConfigFile } from "@effected/config-file";
-
-//#region src/services/Config.ts
-/**
-* Typed service class (Context tag) for the vitest-agent config file service.
-*
-* Both runtime packages (reporter, MCP) yield this tag to access the loaded
-* `VitestAgentConfig`. The live layer is built per `projectDir` via
-* `ConfigLive(projectDir)`.
-* @public
-*/
-var VitestAgentConfigFile = class extends ConfigFile.Service()("vitest-agent/Config") {};
-
-//#endregion
-export { VitestAgentConfigFile };

package/services/DataReader.js

@@ -1,8 +0,0 @@
-import { Context } from "effect";
-
-//#region src/services/DataReader.ts
-/** @public */
-var DataReader = class extends Context.Service()("vitest-agent/DataReader") {};
-
-//#endregion
-export { DataReader };

package/services/DataStore.js

@@ -1,15 +0,0 @@
-import { Context } from "effect";
-
-//#region src/services/DataStore.ts
-/**
-* Ceiling on an inline attachment body. Vitest has already copied file
-* attachments into `.vitest/attachments/`, so a large body is referenced
-* by `path` rather than duplicated into `data.db`.
-* @public
-*/
-const INLINE_ATTACHMENT_BODY_CAP_BYTES = 65536;
-/** @public */
-var DataStore = class extends Context.Service()("vitest-agent/DataStore") {};
-
-//#endregion
-export { DataStore, INLINE_ATTACHMENT_BODY_CAP_BYTES };

package/services/DetailResolver.js

@@ -1,8 +0,0 @@
-import { Context } from "effect";
-
-//#region src/services/DetailResolver.ts
-/** @public */
-var DetailResolver = class extends Context.Service()("vitest-agent/DetailResolver") {};
-
-//#endregion
-export { DetailResolver };

package/services/DiscoveryRegistry.js

@@ -1,8 +0,0 @@
-import { Context } from "effect";
-
-//#region src/services/DiscoveryRegistry.ts
-/** @public */
-var DiscoveryRegistry = class extends Context.Service()("vitest-agent/DiscoveryRegistry") {};
-
-//#endregion
-export { DiscoveryRegistry };

package/services/EnvironmentDetector.js

@@ -1,8 +0,0 @@
-import { Context } from "effect";
-
-//#region src/services/EnvironmentDetector.ts
-/** @public */
-var EnvironmentDetector = class extends Context.Service()("vitest-agent/EnvironmentDetector") {};
-
-//#endregion
-export { EnvironmentDetector };

package/services/ExecutorResolver.js

@@ -1,8 +0,0 @@
-import { Context } from "effect";
-
-//#region src/services/ExecutorResolver.ts
-/** @public */
-var ExecutorResolver = class extends Context.Service()("vitest-agent/ExecutorResolver") {};
-
-//#endregion
-export { ExecutorResolver };

package/services/FormatSelector.js

@@ -1,8 +0,0 @@
-import { Context } from "effect";
-
-//#region src/services/FormatSelector.ts
-/** @public */
-var FormatSelector = class extends Context.Service()("vitest-agent/FormatSelector") {};
-
-//#endregion
-export { FormatSelector };

package/services/HistoryTracker.js

@@ -1,20 +0,0 @@
-import { Context } from "effect";
-
-//#region src/services/HistoryTracker.ts
-/**
-* Builds the composite (modulePath, fullName) key used to key the internal
-* testMap and the returned classifications Map, so identically-named tests
-* in different files classify independently instead of colliding.
-*
-* Uses `JSON.stringify` for an injective encoding: a plain delimiter such as
-* a space is not collision-proof (e.g. `("a b", "c")` and `("a", "b c")` would
-* both yield `"a b c"`), which would reintroduce the very collision class this
-* key exists to prevent.
-* @public
-*/
-const historyKey = (modulePath, fullName) => JSON.stringify([modulePath, fullName]);
-/** @public */
-var HistoryTracker = class extends Context.Service()("vitest-agent/HistoryTracker") {};
-
-//#endregion
-export { HistoryTracker, historyKey };

package/services/OutputRenderer.js

@@ -1,8 +0,0 @@
-import { Context } from "effect";
-
-//#region src/services/OutputRenderer.ts
-/** @public */
-var OutputRenderer = class extends Context.Service()("vitest-agent/OutputRenderer") {};
-
-//#endregion
-export { OutputRenderer };

package/services/PerClientSessionMap.js

@@ -1,22 +0,0 @@
-import { Context } from "effect";
-
-//#region src/services/PerClientSessionMap.ts
-/**
-* Read-only side of the session map.
-*
-* Provided by `PerClientSessionMapReaderLive` (opens SQLite with
-* `?mode=ro`). MCP server depends on this tag — calls to write
-* methods would be a type error.
-* @public
-*/
-var PerClientSessionMapReader = class extends Context.Service()("vitest-agent/PerClientSessionMapReader") {};
-/**
-* Read-write side of the session map. Sidecar provides this; the
-* Writer layer also satisfies the Reader tag so consumers of either
-* one resolve.
-* @public
-*/
-var PerClientSessionMapWriter = class extends Context.Service()("vitest-agent/PerClientSessionMapWriter") {};
-
-//#endregion
-export { PerClientSessionMapReader, PerClientSessionMapWriter };

package/services/ProjectDiscovery.js

@@ -1,8 +0,0 @@
-import { Context } from "effect";
-
-//#region src/services/ProjectDiscovery.ts
-/** @public */
-var ProjectDiscovery = class extends Context.Service()("vitest-agent/ProjectDiscovery") {};
-
-//#endregion
-export { ProjectDiscovery };

package/services/ProjectIdentity.js

@@ -1,63 +0,0 @@
-import { canonicalizeGitUrl, gitUrlToProjectKey } from "../utils/canonicalize-git-url.js";
-import { normalizeWorkspaceKey } from "../utils/normalize-workspace-key.js";
-import { Context } from "effect";
-
-//#region src/services/ProjectIdentity.ts
-const isUseful = (value) => value !== void 0 && value.trim().length > 0;
-/**
-* Pure priority resolver. Returns `null` when no candidate produces a
-* usable value — the caller wraps `null` into a tagged error.
-*
-* For non-git sources the `canonicalForm` equals the original
-* (un-normalized) input so the discovery registry can display
-* `@spencerbeggs/vitest-agent` rather than the underscored form. For
-* git sources, `canonicalForm` is the slash-preserving `host/path`
-* shape from `canonicalizeGitUrl`.
-* @public
-*/
-const resolveProjectIdentityFromCandidates = (candidates) => {
-	if (isUseful(candidates.explicit)) return {
-		projectKey: normalizeWorkspaceKey(candidates.explicit),
-		canonicalForm: candidates.explicit,
-		source: "explicit"
-	};
-	if (isUseful(candidates.toml)) return {
-		projectKey: normalizeWorkspaceKey(candidates.toml),
-		canonicalForm: candidates.toml,
-		source: "toml"
-	};
-	if (isUseful(candidates.gitRemote)) {
-		const canonical = canonicalizeGitUrl(candidates.gitRemote);
-		const key = gitUrlToProjectKey(candidates.gitRemote);
-		if (canonical !== null && key !== null) return {
-			projectKey: key,
-			canonicalForm: canonical,
-			source: "git-remote"
-		};
-	}
-	if (isUseful(candidates.packageJsonRepoUrl)) {
-		const canonical = canonicalizeGitUrl(candidates.packageJsonRepoUrl);
-		const key = gitUrlToProjectKey(candidates.packageJsonRepoUrl);
-		if (canonical !== null && key !== null) return {
-			projectKey: key,
-			canonicalForm: canonical,
-			source: "package-repository"
-		};
-	}
-	if (isUseful(candidates.packageJsonName)) return {
-		projectKey: normalizeWorkspaceKey(candidates.packageJsonName),
-		canonicalForm: candidates.packageJsonName,
-		source: "package-name"
-	};
-	return null;
-};
-/**
-* Service tag. The Live layer (in `layers/ProjectIdentityLive.ts`)
-* wires up the I/O sources; tests provide a stub that returns a
-* pre-built `ResolvedIdentity`.
-* @public
-*/
-var ProjectIdentity = class extends Context.Service()("vitest-agent/ProjectIdentity") {};
-
-//#endregion
-export { ProjectIdentity, resolveProjectIdentityFromCandidates };

package/services/RunContext.js

@@ -1,53 +0,0 @@
-import { Context, Schema } from "effect";
-
-//#region src/services/RunContext.ts
-/**
-* Per-run snapshot of the workspace's git state and host context.
-* Every field is nullable: a non-git workspace has all-NULL git
-* fields, a CI run with no terminal probe match has all-NULL host
-* fields, and a worker that can't read upstream info has a NULL
-* `gitUpstream` while everything else is set.
-*
-* Declared as a `Schema.Class` so callers can `new RunContext({...})`
-* and `Schema.encode(...)` for the SQLite row mapping.
-* @public
-*/
-var RunContext = class extends Schema.Class("vitest-agent/RunContext")({
-	gitBranch: Schema.NullOr(Schema.String),
-	gitCommitSha: Schema.NullOr(Schema.String),
-	gitDirty: Schema.NullOr(Schema.Boolean),
-	gitUpstream: Schema.NullOr(Schema.String),
-	gitWorktreeDir: Schema.NullOr(Schema.String),
-	hostSource: Schema.NullOr(Schema.String),
-	hostValue: Schema.NullOr(Schema.String),
-	hostMetadata: Schema.NullOr(Schema.Unknown)
-}) {};
-/**
-* Subset of {@link RunContext} captured at agent registration. Only
-* the inheritable git context — branch, sha, worktree path. Mid-run
-* dirty-tree state and upstream tracking are per-run concerns.
-* @public
-*/
-var AgentContext = class extends Schema.Class("vitest-agent/AgentContext")({
-	startGitBranch: Schema.NullOr(Schema.String),
-	startGitCommitSha: Schema.NullOr(Schema.String),
-	startWorktreeDir: Schema.NullOr(Schema.String)
-}) {};
-/**
-* Service tag. The Live layer captures real I/O; the Test layer
-* returns whatever the test fixture passes.
-* @public
-*/
-var RunContext$ = class extends Context.Service()("vitest-agent/RunContextService") {};
-/**
-* Re-export the service tag under a less-collision-prone name. The
-* `RunContext` Schema.Class above shares its symbol-name with the
-* service tag concept; the `$` suffix on the Context.Tag class name
-* keeps both addressable from the same module.
-*
-* @public
-*/
-const RunContextService = RunContext$;
-
-//#endregion
-export { AgentContext, RunContext, RunContext$, RunContextService };

package/services/idempotency.js

@@ -1,58 +0,0 @@
-import { createHash } from "node:crypto";
-
-//#region src/services/idempotency.ts
-/**
-* Sentinel substituted for `parentAgentId` when the value is `null`.
-* Avoids ambiguity around hashing the literal string "null" or empty
-* string, both of which could collide with caller-supplied values.
-* @public
-*/
-const IDEMPOTENCY_ROOT_SENTINEL = "__ROOT__";
-/**
-* Derive the canonical idempotency key for an `agents` row.
-*
-* Algorithm:
-*   sha256(agentType + "|" + (parentAgentId ?? "__ROOT__") + "|" + clientNonce)
-*   then base32 (RFC 4648 alphabet, lowercased) truncated to 26 chars.
-*
-* 26 base32 chars = 130 bits, far beyond the birthday-bound for the
-* scoping (UNIQUE per session). The base32 alphabet is a-z2-7 — all
-* lowercase to keep the column lexicographically friendly and
-* case-insensitive on filesystems that we never hit but might in
-* future debugging.
-* @public
-*/
-const deriveIdempotencyKey = (input) => {
-	const parent = input.parentAgentId ?? "__ROOT__";
-	const message = `${input.agentType}|${parent}|${input.clientNonce}`;
-	const digest = createHash("sha256").update(message).digest();
-	return base32Encode(digest).slice(0, 26);
-};
-const BASE32_ALPHABET = "abcdefghijklmnopqrstuvwxyz234567";
-/**
-* RFC 4648 base32 encoder, lowercase, no padding. Produces ceil(8n/5)
-* characters from an `n`-byte input. SHA-256 output (32 bytes) yields
-* 52 base32 chars; the caller truncates to 26.
-*/
-const base32Encode = (bytes) => {
-	let output = "";
-	let buffer = 0;
-	let bitsInBuffer = 0;
-	for (const byte of bytes) {
-		buffer = buffer << 8 | byte;
-		bitsInBuffer += 8;
-		while (bitsInBuffer >= 5) {
-			bitsInBuffer -= 5;
-			const index = buffer >> bitsInBuffer & 31;
-			output += BASE32_ALPHABET[index];
-		}
-	}
-	if (bitsInBuffer > 0) {
-		const index = buffer << 5 - bitsInBuffer & 31;
-		output += BASE32_ALPHABET[index];
-	}
-	return output;
-};
-
-//#endregion
-export { IDEMPOTENCY_ROOT_SENTINEL, deriveIdempotencyKey };

package/sql/assemblers.js

@@ -1,69 +0,0 @@
-import { historyKey } from "../services/HistoryTracker.js";
-
-//#region src/sql/assemblers.ts
-/**
-* Builds a `CacheManifest` from an array of test_runs aggregation rows.
-*
-* Each row represents the latest run for a project/sub_project pair.
-* The `dbPath` is stored as `cacheDir` so CLI tools can locate the source.
-* @public
-*/
-function assembleManifest(rows, dbPath) {
-	return {
-		updatedAt: rows.reduce((latest, row) => {
-			return row.timestamp > latest ? row.timestamp : latest;
-		}, (/* @__PURE__ */ new Date(0)).toISOString()),
-		cacheDir: dbPath,
-		projects: rows.map((row) => {
-			const projectName = row.sub_project ? `${row.project}:${row.sub_project}` : row.project;
-			const safeProjectName = projectName.replace(/[^a-z0-9@._-]/gi, "_");
-			const reportFile = `sql:reports/${safeProjectName}.json`;
-			const historyFile = `sql:history/${safeProjectName}.history.json`;
-			const lastResult = (() => {
-				if (row.reason === "passed" || row.reason === "failed" || row.reason === "interrupted") return row.reason;
-				return null;
-			})();
-			return {
-				project: projectName,
-				reportFile,
-				historyFile,
-				lastRun: row.timestamp,
-				lastResult
-			};
-		})
-	};
-}
-/**
-* Groups test_history rows by the composite (module_path, full_name) key
-* into a keyed record.
-*
-* Returns `Record<compositeKey, { modulePath, fullName, runs: TestRun[] }>`
-* where `runs` are the accumulated test runs for that test, in the order
-* they appear in `rows`. Two rows sharing `full_name` but differing
-* `module_path` are tracked as distinct entries rather than merged.
-*
-* Only rows with state `"passed"` or `"failed"` are included in runs
-* (matching the `TestRun` schema constraint).
-* @public
-*/
-function assembleHistoryRecord(rows) {
-	const record = {};
-	for (const row of rows) {
-		const state = row.state === "passed" || row.state === "failed" ? row.state : null;
-		if (state === null) continue;
-		const key = historyKey(row.module_path, row.full_name);
-		if (!record[key]) record[key] = {
-			modulePath: row.module_path,
-			fullName: row.full_name,
-			runs: []
-		};
-		record[key].runs.push({
-			timestamp: row.timestamp,
-			state
-		});
-	}
-	return record;
-}
-
-//#endregion
-export { assembleHistoryRecord, assembleManifest };

package/testing/layers.js

@@ -1,21 +0,0 @@
-import { DataReaderLive } from "../layers/DataReaderLive.js";
-import { DataStoreLive } from "../layers/DataStoreLive.js";
-import { PROJECT_MIGRATIONS } from "../migrations/index.js";
-import { Layer } from "effect";
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import { layer } from "@effect/sql-sqlite-node/SqliteClient";
-import * as SqliteMigrator from "@effect/sql-sqlite-node/SqliteMigrator";
-
-//#region src/testing/layers.ts
-/** @public */
-function makeTestLayer(filename) {
-	const SqliteLayer = layer({ filename });
-	const PlatformLayer = NodeServices.layer;
-	const MigratorLayer = SqliteMigrator.layer({ loader: SqliteMigrator.fromRecord(PROJECT_MIGRATIONS) }).pipe(Layer.provide(Layer.merge(SqliteLayer, PlatformLayer)));
-	return Layer.mergeAll(DataStoreLive.pipe(Layer.provide(SqliteLayer)), DataReaderLive.pipe(Layer.provide(SqliteLayer)), MigratorLayer, SqliteLayer, PlatformLayer);
-}
-/** @public */
-const DataStoreTestLayer = makeTestLayer(":memory:");
-
-//#endregion
-export { DataStoreTestLayer, makeTestLayer };