@untestutils/ai 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 s00d
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/agent/run.d.mts

@@ -0,0 +1,4 @@
+import { type RunAgentOptions } from "./types.mjs";
+export declare function runAgent(opts: RunAgentOptions): Promise<string>;
+/** Like runAgent but returns raw model text (for multi-file cover). */
+export declare function runAgentRaw(opts: RunAgentOptions): Promise<string>;

package/dist/agent/run.d.ts

@@ -0,0 +1,19 @@
+import { type RunAgentOptions } from './types';
+export declare function runAgent(opts: RunAgentOptions): Promise<string>;
+/** Like runAgent but returns raw model text (for multi-file cover). */
+export declare function runAgentRaw(opts: RunAgentOptions): Promise<string>;
+/** @internal back-compat for older coverage tests */
+export declare function runLlmGenerate(opts: {
+    system: string;
+    prompt: string;
+    tree?: unknown[];
+    focus?: string[];
+    recipes?: string[];
+    tools: {
+        list_dir: (path?: string) => Promise<unknown>;
+        read_file: (path: string) => Promise<unknown>;
+        grep: (pattern: string, path?: string) => Promise<unknown>;
+    };
+    maxSteps?: number;
+}): Promise<string>;
+//# sourceMappingURL=run.d.ts.map

package/dist/agent/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/agent/run.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkC,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAqB/E,wBAAsB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA4DrE;AAED,uEAAuE;AACvE,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBxE;AAED,qDAAqD;AACrD,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE;QACL,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9C,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KAC5D,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+ClB"}

package/dist/agent/run.mjs

@@ -0,0 +1,140 @@
+import { envFlag } from "@untestutils/core";
+import { _internals, resolveModel } from "../model.mjs";
+import { extractTsFence } from "./types.mjs";
+function buildAiTools(toolFactory, tools) {
+	const toolsObj = {};
+	for (const t of tools) {
+		toolsObj[t.name] = toolFactory({
+			description: t.description,
+			inputSchema: t.inputSchema,
+			execute: async (args) => t.execute(args ?? {})
+		});
+	}
+	return toolsObj;
+}
+export async function runAgent(opts) {
+	if (process.env.UNTESTUTILS_AI_MOCK === "1") {
+		const recipe = opts.mockRecipe ?? "basic";
+		const kind = opts.mockKind ?? (/\bconvert\b/i.test(opts.system) ? "convert" : /\bfix broken\b|\byou fix\b/i.test(opts.system) ? "fix" : /\bmissing\b/i.test(opts.system) ? "cover" : "generate");
+		if (kind === "convert") {
+			return `import { describe, test, expect, useHarness } from 'untestutils/vitest'\n\ndescribe('converted', () => {\n  test('placeholder from mock convert', async () => {\n    const app = await useHarness('${recipe}')\n    expect(app.url || app.dir).toBeTruthy()\n  })\n})\n`;
+		}
+		if (kind === "fix") {
+			return `import { describe, test, expect, useHarness } from 'untestutils/vitest'\n\ndescribe('fixed', () => {\n  test('placeholder from mock fix', async () => {\n    const app = await useHarness('${recipe}')\n    expect(app.url || app.dir).toBeTruthy()\n  })\n})\n`;
+		}
+		if (kind === "cover") {
+			return `import { describe, test, expect, useHarness } from 'untestutils/vitest'\n\ndescribe('coverage', () => {\n  test('placeholder from mock cover', async () => {\n    const app = await useHarness('${recipe}')\n    const html = await app.$fetch('/')\n    expect(html).toBeTruthy()\n  })\n})\n`;
+		}
+		const focus = opts.prompt.match(/Focus[^\n]*:\s*([^\n]+)/i);
+		if (focus?.[1] && focus[1] !== "(none)") {
+			const first = focus[1].split(",")[0]?.trim();
+			if (first) {
+				const read = opts.tools.find((t) => t.name === "read_file");
+				if (read) await read.execute({ path: first }).catch(() => "");
+			}
+		}
+		return `import { describe, test, expect } from 'vitest'\nimport { useHarness } from 'untestutils'\n\ndescribe('ai-generated', () => {\n  test('placeholder from mock', async () => {\n    const app = await useHarness('${recipe}')\n    expect(app.url || app.dir).toBeTruthy()\n  })\n})\n`;
+	}
+	if (!envFlag("UNTESTUTILS_AI", false) && process.env.UNTESTUTILS_AI_MOCK !== "1") {}
+	try {
+		const ai = await _internals.importAi();
+		const { generateText, tool } = ai;
+		const stepCountIs = ai.stepCountIs;
+		const model = await resolveModel();
+		const maxSteps = opts.maxSteps ?? 16;
+		const result = await generateText({
+			model,
+			system: opts.system,
+			prompt: opts.prompt,
+			tools: buildAiTools(tool, opts.tools),
+			...stepCountIs ? { stopWhen: stepCountIs(maxSteps) } : {}
+		});
+		return extractTsFence(result.text);
+	} catch (e) {
+		if (String(e).includes("Cannot find package 'ai'") || String(e).includes("MODULE_NOT_FOUND")) {
+			throw new Error(`[untestutils/ai] install peer "ai" and a provider. Or set UNTESTUTILS_AI_MOCK=1. Cause: ${e}`);
+		}
+		throw e;
+	}
+}
+
+export async function runAgentRaw(opts) {
+	if (process.env.UNTESTUTILS_AI_MOCK === "1") {
+		return `\`\`\`ts file:tests/e2e/generated-cover.test.ts\n${await runAgent({
+			...opts,
+			mockKind: opts.mockKind ?? "cover"
+		})}\n\`\`\``;
+	}
+	const ai = await _internals.importAi();
+	const { generateText, tool } = ai;
+	const stepCountIs = ai.stepCountIs;
+	const model = await resolveModel();
+	const maxSteps = opts.maxSteps ?? 20;
+	const result = await generateText({
+		model,
+		system: opts.system,
+		prompt: opts.prompt,
+		tools: buildAiTools(tool, opts.tools),
+		...stepCountIs ? { stopWhen: stepCountIs(maxSteps) } : {}
+	});
+	return result.text;
+}
+
+export async function runLlmGenerate(opts) {
+	const tools = [
+		{
+			name: "list_dir",
+			description: "List directory under project root",
+			inputSchema: {
+				type: "object",
+				properties: { path: {
+					type: "string",
+					description: "Relative directory"
+				} }
+			},
+			execute: async (args) => opts.tools.list_dir(args.path ? String(args.path) : undefined)
+		},
+		{
+			name: "read_file",
+			description: "Read a file under project root",
+			inputSchema: {
+				type: "object",
+				properties: { path: {
+					type: "string",
+					description: "Relative file path"
+				} },
+				required: ["path"]
+			},
+			execute: async (args) => opts.tools.read_file(String(args.path))
+		},
+		{
+			name: "grep",
+			description: "Search files for a regex pattern",
+			inputSchema: {
+				type: "object",
+				properties: {
+					pattern: {
+						type: "string",
+						description: "Regex"
+					},
+					path: {
+						type: "string",
+						description: "Relative start path"
+					}
+				},
+				required: ["pattern"]
+			},
+			execute: async (args) => opts.tools.grep(String(args.pattern), args.path ? String(args.path) : undefined)
+		}
+	];
+	return runAgent({
+		system: opts.system,
+		maxSteps: opts.maxSteps,
+		tools,
+		prompt: [
+			opts.prompt,
+			`Focus: ${(opts.focus ?? []).join(", ") || "(none)"}`,
+			`Recipes: ${(opts.recipes ?? []).join(", ") || "(none)"}`
+		].join("\n")
+	});
+}

package/dist/agent/types.d.mts

@@ -0,0 +1,33 @@
+export interface ToolParameter {
+	type: "object";
+	properties: Record<string, {
+		type: string;
+		description?: string;
+	}>;
+	required?: string[];
+}
+export interface AgentTool {
+	name: string;
+	description: string;
+	inputSchema: ToolParameter;
+	execute: (args: Record<string, unknown>) => Promise<unknown>;
+}
+export interface AgentToolBag {
+	tools: AgentTool[];
+	readPaths: () => string[];
+	dispose?: () => Promise<void>;
+}
+export interface RunAgentOptions {
+	system: string;
+	prompt: string;
+	tools: AgentTool[];
+	maxSteps?: number;
+	/** Mock mode key for deterministic fixtures */
+	mockKind?: "generate" | "convert" | "fix" | "cover";
+	mockRecipe?: string;
+}
+export declare function extractTsFence(text: string): string;
+export declare function extractLabeledTsFiles(text: string): {
+	path?: string;
+	code: string;
+}[];

package/dist/agent/types.d.ts

@@ -0,0 +1,34 @@
+export interface ToolParameter {
+    type: 'object';
+    properties: Record<string, {
+        type: string;
+        description?: string;
+    }>;
+    required?: string[];
+}
+export interface AgentTool {
+    name: string;
+    description: string;
+    inputSchema: ToolParameter;
+    execute: (args: Record<string, unknown>) => Promise<unknown>;
+}
+export interface AgentToolBag {
+    tools: AgentTool[];
+    readPaths: () => string[];
+    dispose?: () => Promise<void>;
+}
+export interface RunAgentOptions {
+    system: string;
+    prompt: string;
+    tools: AgentTool[];
+    maxSteps?: number;
+    /** Mock mode key for deterministic fixtures */
+    mockKind?: 'generate' | 'convert' | 'fix' | 'cover';
+    mockRecipe?: string;
+}
+export declare function extractTsFence(text: string): string;
+export declare function extractLabeledTsFiles(text: string): {
+    path?: string;
+    code: string;
+}[];
+//# sourceMappingURL=types.d.ts.map

package/dist/agent/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,aAAa,CAAC;IAC3B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAInD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAarF"}

package/dist/agent/types.mjs

@@ -0,0 +1,22 @@
+export function extractTsFence(text) {
+	const match = text.match(/```ts\n([\s\S]*?)```/) || text.match(/```typescript\n([\s\S]*?)```/);
+	if (!match) throw new Error("[untestutils/ai] model did not return a ts fence");
+	return match[1];
+}
+export function extractLabeledTsFiles(text) {
+	const blocks = [];
+	const re = /```(?:ts|typescript)(?:\s+([^\n]+))?\n([\s\S]*?)```/g;
+	let m;
+	while (m = re.exec(text)) {
+		const label = m[1]?.trim();
+		const path = label?.startsWith("file:") ? label.slice(5).trim() : label;
+		blocks.push({
+			path: path || undefined,
+			code: m[2]
+		});
+	}
+	if (blocks.length === 0) {
+		blocks.push({ code: extractTsFence(text) });
+	}
+	return blocks;
+}

package/dist/index.d.mts

@@ -0,0 +1,19 @@
+export { buildFileTree, treeSignature, fingerprint, listTestFiles, IGNORE } from "./tree.mjs";
+export type { FileTreeEntry } from "./tree.mjs";
+export { loadPrompt, loadSystemPrompt, loadConvertPrompt, loadFixPrompt, loadCoverPrompt, aiFs } from "./prompts.mjs";
+export type { PromptName } from "./prompts.mjs";
+export { resolveModel, _internals } from "./model.mjs";
+export { createFsTools, createAiTools } from "./tools/fs.mjs";
+export { createBrowserTools } from "./tools/browser.mjs";
+export { createAgentToolkit } from "./tools/registry.mjs";
+export type { CreateAgentToolkitOptions } from "./tools/registry.mjs";
+export { runAgent, runAgentRaw, runLlmGenerate } from "./agent/run.mjs";
+export { extractTsFence, extractLabeledTsFiles } from "./agent/types.mjs";
+export type { AgentTool, AgentToolBag, RunAgentOptions } from "./agent/types.mjs";
+export { aiTest, aiTestFromFile, convertTestFile, AI_PROMPT_VERSION, CONVERT_PROMPT_VERSION } from "./workflows/generate.mjs";
+export type { AiTestOptions, ConvertTestOptions } from "./workflows/generate.mjs";
+export type { GenerateResult } from "./workflows/types.mjs";
+export { fixBrokenTests } from "./workflows/fix.mjs";
+export type { FixTestsOptions } from "./workflows/fix.mjs";
+export { coverMissingTests } from "./workflows/cover.mjs";
+export type { CoverTestsOptions, CoverResult } from "./workflows/cover.mjs";

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export { buildFileTree, treeSignature, fingerprint, listTestFiles, IGNORE } from './tree';
+export type { FileTreeEntry } from './tree';
+export { loadPrompt, loadSystemPrompt, loadConvertPrompt, loadFixPrompt, loadCoverPrompt, aiFs, } from './prompts';
+export type { PromptName } from './prompts';
+export { resolveModel, _internals } from './model';
+export { createFsTools, createAiTools } from './tools/fs';
+export { createBrowserTools } from './tools/browser';
+export { createAgentToolkit } from './tools/registry';
+export type { CreateAgentToolkitOptions } from './tools/registry';
+export { runAgent, runAgentRaw, runLlmGenerate } from './agent/run';
+export { extractTsFence, extractLabeledTsFiles } from './agent/types';
+export type { AgentTool, AgentToolBag, RunAgentOptions } from './agent/types';
+export { aiTest, aiTestFromFile, convertTestFile, AI_PROMPT_VERSION, CONVERT_PROMPT_VERSION, } from './workflows/generate';
+export type { AiTestOptions, ConvertTestOptions } from './workflows/generate';
+export type { GenerateResult } from './workflows/types';
+export { fixBrokenTests } from './workflows/fix';
+export type { FixTestsOptions } from './workflows/fix';
+export { coverMissingTests } from './workflows/cover';
+export type { CoverTestsOptions, CoverResult } from './workflows/cover';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC1F,YAAY,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE5C,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,IAAI,GACL,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAElE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAM9E,OAAO,EACL,MAAM,EACN,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.mjs

@@ -0,0 +1,14 @@
+export { buildFileTree, treeSignature, fingerprint, listTestFiles, IGNORE } from "./tree.mjs";
+export { loadPrompt, loadSystemPrompt, loadConvertPrompt, loadFixPrompt, loadCoverPrompt, aiFs } from "./prompts.mjs";
+export { resolveModel, _internals } from "./model.mjs";
+export { createFsTools, createAiTools } from "./tools/fs.mjs";
+export { createBrowserTools } from "./tools/browser.mjs";
+export { createAgentToolkit } from "./tools/registry.mjs";
+export { runAgent, runAgentRaw, runLlmGenerate } from "./agent/run.mjs";
+export { extractTsFence, extractLabeledTsFiles } from "./agent/types.mjs";
+import { runLlmGenerate } from "./agent/run.mjs";
+import { _internals } from "./model.mjs";
+_internals.runLlmGenerate = runLlmGenerate;
+export { aiTest, aiTestFromFile, convertTestFile, AI_PROMPT_VERSION, CONVERT_PROMPT_VERSION } from "./workflows/generate.mjs";
+export { fixBrokenTests } from "./workflows/fix.mjs";
+export { coverMissingTests } from "./workflows/cover.mjs";

package/dist/model.d.mts

@@ -0,0 +1 @@
+export declare function resolveModel(): Promise<unknown>;

package/dist/model.d.ts

@@ -0,0 +1,14 @@
+import type { runLlmGenerate } from './agent/run';
+/** @internal test seams for LLM path */
+export declare const _internals: {
+    importAi: () => Promise<typeof import("ai")>;
+    importAnthropic: () => Promise<typeof import("@ai-sdk/anthropic")>;
+    importXai: () => Promise<typeof import("@ai-sdk/xai")>;
+    importGoogle: () => Promise<typeof import("@ai-sdk/google")>;
+    importOpenai: () => Promise<typeof import("@ai-sdk/openai")>;
+    /** Bound after define — coverage tests spy imports then call via _internals */
+    resolveModel: () => Promise<unknown>;
+    runLlmGenerate: typeof runLlmGenerate;
+};
+export declare function resolveModel(): Promise<unknown>;
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,wCAAwC;AACxC,eAAO,MAAM,UAAU;;;;;;IAMrB,+EAA+E;kBAC9C,MAAM,OAAO,CAAC,OAAO,CAAC;oBACpB,OAAO,cAAc;CACzD,CAAC;AAEF,wBAAsB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAgBrD"}

package/dist/model.mjs

@@ -0,0 +1,29 @@
+
+export const _internals = {
+	importAi: () => import("ai"),
+	importAnthropic: () => import("@ai-sdk/anthropic"),
+	importXai: () => import("@ai-sdk/xai"),
+	importGoogle: () => import("@ai-sdk/google"),
+	importOpenai: () => import("@ai-sdk/openai"),
+	
+	resolveModel: null,
+	runLlmGenerate: null
+};
+export async function resolveModel() {
+	const provider = process.env.UNTESTUTILS_AI_PROVIDER || "openai";
+	if (provider === "anthropic") {
+		const { anthropic } = await _internals.importAnthropic();
+		return anthropic(process.env.UNTESTUTILS_AI_MODEL || "claude-sonnet-4-20250514");
+	}
+	if (provider === "xai") {
+		const { xai } = await _internals.importXai();
+		return xai(process.env.UNTESTUTILS_AI_MODEL || "grok-3");
+	}
+	if (provider === "google") {
+		const { google } = await _internals.importGoogle();
+		return google(process.env.UNTESTUTILS_AI_MODEL || "gemini-2.0-flash");
+	}
+	const { openai } = await _internals.importOpenai();
+	return openai(process.env.UNTESTUTILS_AI_MODEL || "gpt-4.1");
+}
+_internals.resolveModel = resolveModel;

package/dist/prompts/convert-v1.md

@@ -0,0 +1,28 @@
+# untestutils convert
+
+Rewrite the given test to untestutils. Keep intent. English only. One \`\`\`ts fence.
+
+Map: `@nuxt/test-utils` `setup`/`createPage`/`$fetch` → `useHarness` + `app.$fetch` / vitest `page`/`goto`. Hardcoded `localhost` → harness `url`/`baseURL`. Plain `@playwright/test` → `untestutils/playwright` + `test.use({ harness })`. Drop obsolete setup when harness covers it. Real recipe ids only.
+
+```ts
+// after (vitest)
+import { describe, test, expect, useHarness } from 'untestutils/vitest'
+describe('home', () => {
+  test('renders', async ({ page, goto }) => {
+    const app = await useHarness('app')
+    expect(await app.$fetch('/')).toContain('Welcome')
+    await goto('/', { waitUntil: 'hydration' })
+    await expect(page.getByRole('heading', { name: 'Welcome' })).toBeVisible()
+  })
+})
+```
+
+```ts
+// after (playwright)
+import { test, expect } from 'untestutils/playwright'
+test.use({ harness: 'site' })
+test('home', async ({ page }) => {
+  await page.goto('/')
+  await expect(page.getByTestId('title')).toHaveText('Home')
+})
+```

package/dist/prompts/cover-v1.md

@@ -0,0 +1,36 @@
+# untestutils cover
+
+Write missing high-value e2e tests only (gaps vs existing tests). English only. Inventory first; if base URL → `browser_goto` + `browser_snapshot`. Real recipe ids. Prefer outDir. Few focused tests, meaningful asserts. No sleeps/invented UI.
+
+Output: one \`\`\`ts fence, or multiple \`\`\`ts file:relative/path.test.ts
+
+```ts
+import { describe, test, expect, useHarness } from 'untestutils/vitest'
+describe('about', () => {
+  test('serves about', async () => {
+    const app = await useHarness('site')
+    expect(await app.$fetch('/about')).toContain('About')
+  })
+})
+```
+
+```ts
+import { describe, test, expect, useHarness } from 'untestutils/vitest'
+test('form', async ({ page, goto }) => {
+  await useHarness('site')
+  await goto('/contact')
+  await page.getByLabel('Email').fill('user@example.com')
+  await page.getByRole('button', { name: 'Send' }).click()
+  await expect(page.getByRole('status')).toContainText('Thanks')
+})
+```
+
+```ts
+import { test, expect } from 'untestutils/playwright'
+test.use({ harness: 'site' })
+test('privacy', async ({ page }) => {
+  await page.goto('/')
+  await page.getByRole('link', { name: 'Privacy' }).click()
+  await expect(page.getByRole('heading', { name: 'Privacy' })).toBeVisible()
+})
+```

package/dist/prompts/fix-v1.md

@@ -0,0 +1,20 @@
+# untestutils fix
+
+Fix the broken untestutils test. Keep intent — no skip, no weaker asserts, no sleep. English only. Tools/browser first if available. One \`\`\`ts fence, full file.
+
+Typical fixes: real recipe id; `getByRole`/`getByTestId` instead of brittle CSS; Nuxt → `goto('/', { waitUntil: 'hydration' })`; fetch via `useHarness` + `$fetch` not hardcoded host; playwright needs `test.use({ harness })`. Ground text/selectors in snapshot/source.
+
+```ts
+// bad → good
+await goto('/'); await page.locator('div > h1.x').click()
+await goto('/', { waitUntil: 'hydration' }); await page.getByRole('heading', { name: 'Home' }).click()
+```
+
+```ts
+import { describe, test, expect, useHarness } from 'untestutils/vitest'
+test('title', async ({ page, goto }) => {
+  await useHarness('site')
+  await goto('/')
+  await expect(page.getByRole('heading', { name: 'Home' })).toBeVisible()
+})
+```

package/dist/prompts/v1.md

@@ -0,0 +1,37 @@
+# untestutils test author
+
+English code/comments only. Explore tools first (`list_dir`/`read_file`/`grep`; prefer focus). Use real recipe ids from the project. One \`\`\`ts fence, full file, no prose outside.
+
+APIs: `useHarness`, `$fetch`, `url`/`dir`/`files`, vitest fixtures `page`/`goto`/`baseURL`/`request`, or playwright `test.use({ harness })`. Prefer `getByRole`/`getByText`/`getByTestId`. No sleeps. No invented UI/secrets.
+
+Shapes:
+
+```ts
+import { describe, test, expect, useHarness } from 'untestutils/vitest'
+describe('home', () => {
+  test('title', async () => {
+    const app = await useHarness('site')
+    expect(await app.$fetch('/')).toContain('Welcome')
+  })
+})
+```
+
+```ts
+import { describe, test, expect, useHarness } from 'untestutils/vitest'
+test('nav', async ({ page, goto }) => {
+  await useHarness('site')
+  await goto('/') // Nuxt: goto('/', { waitUntil: 'hydration' })
+  await page.getByRole('link', { name: 'About' }).click()
+  await expect(page.getByRole('heading', { name: 'About' })).toBeVisible()
+})
+```
+
+```ts
+import { test, expect } from 'untestutils/playwright'
+test.use({ harness: 'site' })
+test('home', async ({ page, baseURL }) => {
+  expect(baseURL).toBeTruthy()
+  await page.goto('/')
+  await expect(page.getByTestId('title')).toHaveText('Home')
+})
+```

package/dist/prompts.d.ts

@@ -0,0 +1,14 @@
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+/** @internal */
+export declare const aiFs: {
+    existsSync: typeof existsSync;
+    readFile: typeof readFile;
+};
+export type PromptName = 'v1' | 'convert-v1' | 'fix-v1' | 'cover-v1';
+export declare function loadPrompt(name: PromptName): Promise<string>;
+export declare const loadSystemPrompt: () => Promise<string>;
+export declare const loadConvertPrompt: () => Promise<string>;
+export declare const loadFixPrompt: () => Promise<string>;
+export declare const loadCoverPrompt: () => Promise<string>;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAI5C,gBAAgB;AAChB,eAAO,MAAM,IAAI;;;CAGhB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,YAAY,GAAG,QAAQ,GAAG,UAAU,CAAC;AASrE,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAWlE;AAED,eAAO,MAAM,gBAAgB,uBAAyB,CAAC;AACvD,eAAO,MAAM,iBAAiB,uBAAiC,CAAC;AAChE,eAAO,MAAM,aAAa,uBAA6B,CAAC;AACxD,eAAO,MAAM,eAAe,uBAA+B,CAAC"}

package/dist/prompts.mjs

@@ -0,0 +1,31 @@
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { dirname, join, resolve } from "pathe";
+import { fileURLToPath } from "node:url";
+
+export const aiFs = {
+	existsSync,
+	readFile
+};
+const DEFAULTS = {
+	v1: `English untestutils tests. Tools first. useHarness+$fetch or page/goto; playwright test.use({harness}). One ts fence.`,
+	"convert-v1": `Convert to untestutils (useHarness / untestutils/vitest|playwright). Keep intent. English. One ts fence.`,
+	"fix-v1": `Fix broken untestutils test. Keep intent; no sleep/skip. Real selectors/recipe. English. One ts fence.`,
+	"cover-v1": `Missing high-value e2e only. Inventory+snapshot. English. ts fence or ts file:path.`
+};
+export async function loadPrompt(name) {
+	const file = `${name}.md`;
+	const candidates = [
+		join(dirname(fileURLToPath(import.meta.url)), "prompts", file),
+		resolve(process.cwd(), "src/ai/prompts", file),
+		resolve(process.cwd(), "packages/ai/src/prompts", file)
+	];
+	for (const c of candidates) {
+		if (aiFs.existsSync(c)) return aiFs.readFile(c, "utf8");
+	}
+	return DEFAULTS[name];
+}
+export const loadSystemPrompt = () => loadPrompt("v1");
+export const loadConvertPrompt = () => loadPrompt("convert-v1");
+export const loadFixPrompt = () => loadPrompt("fix-v1");
+export const loadCoverPrompt = () => loadPrompt("cover-v1");

package/dist/tools/browser.d.mts

@@ -0,0 +1,9 @@
+import type { AgentToolBag } from "../agent/types.mjs";
+/**
+* Playwright-backed page tools for the shared AI agent.
+* Optional peer: playwright-core. Used by CLI fix/cover workflows.
+*/
+export declare function createBrowserTools(opts?: {
+	baseURL?: string;
+	headless?: boolean;
+}): AgentToolBag;

package/dist/tools/browser.d.ts

@@ -0,0 +1,10 @@
+import type { AgentToolBag } from '../agent/types';
+/**
+ * Playwright-backed page tools for the shared AI agent.
+ * Optional peer: playwright-core. Used by CLI fix/cover workflows.
+ */
+export declare function createBrowserTools(opts?: {
+    baseURL?: string;
+    headless?: boolean;
+}): AgentToolBag;
+//# sourceMappingURL=browser.d.ts.map

package/dist/tools/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/tools/browser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,GAAE;IACJ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACf,GACL,YAAY,CAqId"}