@tangle-network/agent-runtime 0.128.0 → 0.131.0

package/dist/profiles.d.ts

@@ -1,4 +1,4 @@
-import { E as SandboxClient, k as Validator, r as Driver, t as AgentRunSpec, w as OutputAdapter } from "./types-DnNGJ5Gz.js";
+import { k as Validator, r as Driver, t as AgentRunSpec, w as OutputAdapter } from "./types-ebIY0dMG.js";
 import { a as UiFindingSeverity, c as coderTaskToPrompt, i as UiFindingScreenshot, n as UI_LENSES, o as UiLens, r as UiFinding, s as CoderTask, t as UI_FINDING_SEVERITIES } from "./substrate-BcnuSHXm.js";
 import { AgentProfile } from "@tangle-network/agent-interface";
 import { SandboxEvent } from "@tangle-network/sandbox";
@@ -170,13 +170,11 @@ interface ResearchOutput {
 }
 /** Options for the source-grounded researcher profile preset. @experimental */
 interface ResearcherProfileOptions {
-  /** Sandbox-SDK backend.type. Default `'opencode/zai-coding-plan/glm-5.1'`. */
-  harness?: string;
-  /** Default model id passed in `AgentProfile.model.default`. */
-  model?: string;
+  /** Caller-owned exact harness/provider/model identity. */
+  profile: AgentProfile;
   /** Custom system prompt replacement. Default = built-in researcher preset. */
   systemPrompt?: string;
-  /** Stable name for `AgentRunSpec.name`. Default = `researcher-${harness}`. */
+  /** Stable name for `AgentRunSpec.name`. Default = `profile.name`. */
   name?: string;
   /**
    * Default 0.7. Minimum (citations with quote) / items ratio for `valid=true`.
@@ -185,7 +183,7 @@ interface ResearcherProfileOptions {
   citationDensityMin?: number;
 }
 /** Build a source-grounded researcher profile with output parsing and validation. @experimental */
-declare function researcherProfile(options?: ResearcherProfileOptions & {
+declare function researcherProfile(options: ResearcherProfileOptions & {
   task?: ResearchTask;
 }): {
   profile: AgentProfile;
@@ -196,10 +194,8 @@ declare function researcherProfile(options?: ResearcherProfileOptions & {
 };
 /** @experimental */
 interface MultiHarnessResearcherFanoutOptions {
-  /** Backend.type identifiers, one per parallel agent. */
-  harnesses?: string[];
-  /** Optional per-harness model override. Indexed parallel to `harnesses`. */
-  models?: (string | undefined)[];
+  /** Exact execution profiles, one per parallel researcher. */
+  profiles: ReadonlyArray<AgentProfile>;
   /** Default citation density floor for the shared validator. */
   citationDensityMin?: number;
   /** Optional task — narrows the validator's namespace check. */
@@ -212,7 +208,7 @@ interface MultiHarnessResearcherFanoutOptions {
  *
  * @experimental
  */
-declare function multiHarnessResearcherFanout(options?: MultiHarnessResearcherFanoutOptions): {
+declare function multiHarnessResearcherFanout(options: MultiHarnessResearcherFanoutOptions): {
   agentRuns: AgentRunSpec<ResearchTask>[];
   output: OutputAdapter<ResearchOutput>;
   validator: Validator<ResearchOutput>;
@@ -242,6 +238,18 @@ declare function createResearcherValidator(task: ResearchTask, config?: {
   namespaceCheck?: boolean;
 }): Validator<ResearchOutput>;
 //#endregion
+//#region src/profiles/ui-auditor/lens-prompts.d.ts
+/** Cross-lens rules injected into every UI audit iteration: finding quality standards and scope limits. @experimental */
+declare const SHARED_AUDITOR_RULES: string;
+/** Per-lens auditor briefs: concrete signals to look for and cross-lens distinctions to respect. @experimental */
+declare const LENS_BRIEFS: Record<UiLens, string>;
+/**
+ * Build a system prompt for a single auditor iteration.
+ *
+ * @experimental
+ */
+declare function buildAuditorSystemPrompt(lens: UiLens): string;
+//#endregion
 //#region src/profiles/ui-auditor/task.d.ts
 /** @experimental */
 interface UiAuditViewport {
@@ -325,171 +333,10 @@ interface UiAuditOutput {
   notes?: string;
 }
 //#endregion
-//#region src/profiles/ui-auditor/judge.d.ts
-/** @experimental */
-interface UiJudgeTokenUsage {
-  input: number;
-  output: number;
-}
-/** @experimental */
-interface UiJudgeInput {
-  lens: UiLens;
-  captures: readonly UiAuditCapture[];
-  /** Free-form product context the consumer wants the judge to know. */
-  productContext?: string;
-  /** Findings already on file across earlier iterations — for similarTo linkage. */
-  knownFindingIds?: readonly number[];
-  /** The full prompt the loop kernel synthesized for this iteration. */
-  promptText: string;
-  /** Cooperative cancellation. */
-  signal: AbortSignal;
-}
-/** @experimental */
-interface UiJudgeOutput {
-  findings: UiFinding[];
-  /** Optional triage commentary. */
-  notes?: string;
-  /** Optional usage; folded into the kernel cost ledger when present. */
-  tokenUsage?: UiJudgeTokenUsage;
-  /** Optional total cost in USD. */
-  costUsd?: number;
-}
-/** @experimental */
-type UiJudge = (input: UiJudgeInput) => Promise<UiJudgeOutput>;
-//#endregion
-//#region src/profiles/ui-auditor/in-process-client.d.ts
-/** @experimental */
-interface InProcessUiAuditClientOptions {
-  /**
-   * Absolute path under which screenshots are written. Each capture lands
-   * at `<workspaceDir>/screenshots/<filename>`; finding screenshot paths
-   * are workspace-relative (`screenshots/<filename>`).
-   */
-  workspaceDir: string;
-  /** The vision judge that turns captures into findings. */
-  judge: UiJudge;
-  /**
-   * Navigation policy.
-   *
-   * `'strict'` (default) waits for `networkidle` and fails the iteration
-   * if the page does not settle. `'spa'` waits for `domcontentloaded` —
-   * use for single-page apps that hold open long-poll/websocket
-   * connections and never settle.
-   */
-  navPolicy?: 'strict' | 'spa';
-  /**
-   * Browser launch override. Default: chromium headless via Playwright.
-   * Consumers pass a custom factory to target a remote browser, a
-   * different channel, or a fleet adapter.
-   */
-  launchBrowser?: () => Promise<BrowserHandle>;
-}
-/** @experimental */
-interface BrowserHandle {
-  newContext(options?: {
-    viewport?: {
-      width: number;
-      height: number;
-    };
-  }): Promise<BrowserContextHandle>;
-  close(): Promise<void>;
-}
-/** @experimental */
-interface BrowserContextHandle {
-  newPage(): Promise<PageHandle>;
-  close(): Promise<void>;
-}
-/** @experimental */
-interface PageHandle {
-  setViewportSize(size: {
-    width: number;
-    height: number;
-  }): Promise<void>;
-  goto(url: string, options?: {
-    waitUntil?: string;
-    timeout?: number;
-  }): Promise<unknown>;
-  waitForSelector(selector: string, options?: {
-    timeout?: number;
-  }): Promise<unknown>;
-  waitForTimeout(ms: number): Promise<void>;
-  screenshot(options: {
-    path: string;
-    fullPage?: boolean;
-  }): Promise<void>;
-  locator(selector: string): {
-    first(): {
-      screenshot(options: {
-        path: string;
-      }): Promise<void>;
-    };
-  };
-}
-/** Create a `SandboxClient` that drives a local Playwright browser for in-process UI audits. @experimental */
-declare function createInProcessUiAuditClient(options: InProcessUiAuditClientOptions): SandboxClient & {
-  /**
-   * Close the underlying browser. Idempotent.
-   *
-   * Contract: callers MUST ensure no iterations are in flight when this is
-   * called. The kernel respects this — `runAgentRounds` awaits every iteration
-   * before returning, so `await runAgentRounds(...); await client.close()` is the
-   * intended pattern (see `examples/ui-audit`). If `close()` is invoked
-   * concurrently with a running iteration, the browser teardown will race
-   * against in-flight page operations; the iteration will surface an
-   * AggregateError carrying both the iteration error and the close error,
-   * but no work is lost silently.
-   */
-  close(): Promise<void>;
-};
-//#endregion
-//#region src/profiles/ui-auditor/lens-prompts.d.ts
-/** Cross-lens rules injected into every UI audit iteration: finding quality standards and scope limits. @experimental */
-declare const SHARED_AUDITOR_RULES: string;
-/** Per-lens auditor briefs: concrete signals to look for and cross-lens distinctions to respect. @experimental */
-declare const LENS_BRIEFS: Record<UiLens, string>;
-/**
- * Build a system prompt for a single auditor iteration.
- *
- * @experimental
- */
-declare function buildAuditorSystemPrompt(lens: UiLens): string;
-//#endregion
 //#region src/profiles/ui-auditor/output-adapter.d.ts
 /** Parse raw `SandboxEvent` emissions from an audit iteration into structured `UiAuditOutput`. @experimental */
 declare function parseAuditorEvents(events: SandboxEvent[]): UiAuditOutput;
 //#endregion
-//#region src/profiles/ui-auditor/profile.d.ts
-/** @experimental */
-interface UiAuditorProfileOptions {
-  /**
-   * Stable name surfaced in trace events. Defaults to `ui-auditor`.
-   */
-  name?: string;
-  /**
-   * Optional model identifier passed in `AgentProfile.model.default`.
-   * The consumer's `SandboxClient` chooses how to interpret it.
-   */
-  model?: string;
-  /**
-   * Task bound to the validator. Without it the validator uses the lens
-   * embedded in the iteration output as its expectation — fine for one-off
-   * use; less strict than passing the task explicitly.
-   */
-  task?: UiAuditTask;
-}
-/**
- * Preset `runAgentRounds` bundle for vision-driven UI audits: returns the `AgentRunSpec`, output adapter, validator, and prompt formatter the loop kernel needs.
- *
- * @experimental
- */
-declare function uiAuditorProfile(options?: UiAuditorProfileOptions): {
-  profile: AgentProfile;
-  taskToPrompt: (task: UiAuditTask) => string;
-  output: OutputAdapter<UiAuditOutput>;
-  validator: Validator<UiAuditOutput>;
-  agentRunSpec: AgentRunSpec<UiAuditTask>;
-};
-//#endregion
 //#region src/profiles/ui-auditor/prompt.d.ts
 /** Wrap a `UiAuditTask` in a machine-readable envelope so iterations are self-describing. @experimental */
 declare function encodeAuditTaskEnvelope(task: UiAuditTask): string;
@@ -508,5 +355,5 @@ declare function formatAuditorPrompt(task: UiAuditTask): string;
 /** Build a `Validator` that rejects off-lens findings and findings missing screenshot evidence. @experimental */
 declare function createUiAuditorValidator(task: UiAuditTask): Validator<UiAuditOutput>;
 //#endregion
-export { type AppendFindingsResult, type AuditIndex, type AuditRegistry, type AuditRegistryCapture, type BrowserContextHandle, type BrowserHandle, type CoderTask, type InProcessUiAuditClientOptions, type KnowledgeItem, type KnowledgeUpdate, LENS_BRIEFS, type MultiHarnessResearcherFanoutOptions, type PageHandle, type RegisterCapturesOptions, type ResearchOutput, type ResearchSource, type ResearchTask, type ResearcherProfileOptions, SHARED_AUDITOR_RULES, UI_FINDING_SEVERITIES, UI_LENSES, type UiAuditCapture, type UiAuditCaptureRequest, type UiAuditOutput, type UiAuditTask, type UiAuditViewport, type UiAuditorProfileOptions, type UiFinding, type UiFindingScreenshot, type UiFindingSeverity, type UiJudge, type UiJudgeInput, type UiJudgeOutput, type UiJudgeTokenUsage, type UiLens, appendFindings, buildAuditorSystemPrompt, coderTaskToPrompt, createInProcessUiAuditClient, createResearcherValidator, createUiAuditorValidator, decodeAuditTaskEnvelope, encodeAuditTaskEnvelope, formatAuditorPrompt, initAuditWorkspace, multiHarnessResearcherFanout, parseAuditorEvents, readAuditRegistry, registerCaptures, researcherProfile, summarizeRegistry, uiAuditorProfile, writeAuditIndex };
+export { type AppendFindingsResult, type AuditIndex, type AuditRegistry, type AuditRegistryCapture, type CoderTask, type KnowledgeItem, type KnowledgeUpdate, LENS_BRIEFS, type MultiHarnessResearcherFanoutOptions, type RegisterCapturesOptions, type ResearchOutput, type ResearchSource, type ResearchTask, type ResearcherProfileOptions, SHARED_AUDITOR_RULES, UI_FINDING_SEVERITIES, UI_LENSES, type UiAuditCapture, type UiAuditCaptureRequest, type UiAuditOutput, type UiAuditTask, type UiAuditViewport, type UiFinding, type UiFindingScreenshot, type UiFindingSeverity, type UiLens, appendFindings, buildAuditorSystemPrompt, coderTaskToPrompt, createResearcherValidator, createUiAuditorValidator, decodeAuditTaskEnvelope, encodeAuditTaskEnvelope, formatAuditorPrompt, initAuditWorkspace, multiHarnessResearcherFanout, parseAuditorEvents, readAuditRegistry, registerCaptures, researcherProfile, summarizeRegistry, writeAuditIndex };
 //# sourceMappingURL=profiles.d.ts.map

package/dist/profiles.js

@@ -1,8 +1,8 @@
-import { n as multiHarnessResearcherFanout, r as researcherProfile, t as createResearcherValidator } from "./researcher-CoVqNhfI.js";
+import { i as researcherProfile, n as createResearcherValidator, r as multiHarnessResearcherFanout } from "./researcher-Skz5-Uc8.js";
 import { n as UI_LENSES, t as UI_FINDING_SEVERITIES } from "./substrate-B0TYNrXn.js";
 import { t as coderTaskToPrompt } from "./coder-yhVWbdWc.js";
-import { promises } from "node:fs";
 import path from "node:path";
+import { promises } from "node:fs";
 //#region src/profiles/ui-auditor/slugify.ts
 /**
 *
@@ -317,241 +317,6 @@ async function writeAuditIndex(workspaceDir) {
 	return out;
 }
 //#endregion
-//#region src/profiles/ui-auditor/prompt.ts
-const ENVELOPE_BEGIN = "<<UI_AUDIT_TASK>>";
-const ENVELOPE_END = "<<UI_AUDIT_TASK_END>>";
-/** Wrap a `UiAuditTask` in a machine-readable envelope so iterations are self-describing. @experimental */
-function encodeAuditTaskEnvelope(task) {
-	return `${ENVELOPE_BEGIN}${JSON.stringify(task)}${ENVELOPE_END}`;
-}
-/**
-* Parse a task envelope back out of a prompt string. Returns undefined if
-* the prompt does not contain a complete envelope OR if the payload is
-* not valid JSON.
-*
-* @experimental
-*/
-function decodeAuditTaskEnvelope(prompt) {
-	const start = prompt.indexOf(ENVELOPE_BEGIN);
-	if (start === -1) return void 0;
-	const payloadStart = start + 17;
-	const end = prompt.indexOf(ENVELOPE_END, payloadStart);
-	if (end === -1) return void 0;
-	const payload = prompt.slice(payloadStart, end);
-	try {
-		const parsed = JSON.parse(payload);
-		if (!parsed || typeof parsed !== "object") return void 0;
-		const t = parsed;
-		if (typeof t.lens !== "string" || !Array.isArray(t.captures)) return void 0;
-		return t;
-	} catch {
-		return;
-	}
-}
-/** Produce the user message for one audit iteration: lens, captures to take, and the task envelope. @experimental */
-function formatAuditorPrompt(task) {
-	const lines = [];
-	lines.push(`# UI audit iteration — lens: ${task.lens}`);
-	lines.push("");
-	if (task.productContext && task.productContext.trim().length > 0) {
-		lines.push("## Product context");
-		lines.push(task.productContext.trim());
-		lines.push("");
-	}
-	lines.push("## Captures to take");
-	task.captures.forEach((cap, i) => {
-		const detail = [
-			`viewport=${cap.viewport ? `${cap.viewport.width}x${cap.viewport.height}` : "1280x800 (default)"}`,
-			cap.fullPage ? "fullPage=true" : null,
-			cap.elementSelector ? `selector=\`${cap.elementSelector}\`` : null,
-			cap.waitFor ? `waitFor=\`${cap.waitFor}\`` : null,
-			cap.waitMs !== void 0 ? `waitMs=${cap.waitMs}` : null,
-			cap.label ? `label=${cap.label}` : null
-		].filter((s) => s !== null).join(" · ");
-		lines.push(`${i + 1}. route=\`${cap.route}\` url=${cap.url} ${detail ? `(${detail})` : ""}`);
-	});
-	lines.push("");
-	if (task.knownFindingIds && task.knownFindingIds.length > 0) {
-		lines.push("## Known findings (link via similarTo, do not refile)");
-		lines.push(task.knownFindingIds.map((n) => `#${String(n).padStart(3, "0")}`).join(", "));
-		lines.push("");
-	}
-	lines.push("## Output format");
-	lines.push("Emit a single JSON object with the shape `{ findings: UiFinding[], notes?: string }` where every finding has the fields enumerated in your system prompt. The screenshots field on each finding must reference the captures above by path. Do not emit findings outside the lens.");
-	return lines.join("\n");
-}
-//#endregion
-//#region src/profiles/ui-auditor/in-process-client.ts
-function asSandboxEvent(type, data) {
-	return {
-		type,
-		data
-	};
-}
-const DEFAULT_VIEWPORT = {
-	width: 1280,
-	height: 800
-};
-const NAV_TIMEOUT_MS = 3e4;
-async function defaultLaunch() {
-	const mod = await import("playwright");
-	if (!mod?.chromium || typeof mod.chromium.launch !== "function") throw new Error("ui-auditor: playwright is not installed. Install `playwright` (and run `playwright install chromium`) or pass a custom `launchBrowser` to createInProcessUiAuditClient.");
-	return mod.chromium.launch({ headless: true });
-}
-function nowStamp() {
-	const d = /* @__PURE__ */ new Date();
-	const pad = (n) => String(n).padStart(2, "0");
-	return `${d.getUTCFullYear()}${pad(d.getUTCMonth() + 1)}${pad(d.getUTCDate())}-${pad(d.getUTCHours())}${pad(d.getUTCMinutes())}${pad(d.getUTCSeconds())}-${String(d.getUTCMilliseconds()).padStart(3, "0")}`;
-}
-function viewportOf(req) {
-	return req.viewport ?? DEFAULT_VIEWPORT;
-}
-function captureFilename(req) {
-	const vp = viewportOf(req);
-	const labelPart = req.label ? `--${slugify(req.label, "label")}` : "";
-	return `${slugify(req.route, "route")}--${vp.width}x${vp.height}${labelPart}--${nowStamp()}.png`;
-}
-function assertHttpUrl(url) {
-	let parsed;
-	try {
-		parsed = new URL(url);
-	} catch {
-		throw new Error(`ui-auditor: capture url is not parseable (got ${JSON.stringify(url)})`);
-	}
-	if (parsed.protocol !== "http:" && parsed.protocol !== "https:") throw new Error(`ui-auditor: capture url must use http or https (got ${parsed.protocol} in ${JSON.stringify(url)})`);
-}
-async function captureOne(page, req, outAbsPath, signal, navPolicy) {
-	signal.throwIfAborted();
-	assertHttpUrl(req.url);
-	await page.setViewportSize(viewportOf(req));
-	const waitUntil = navPolicy === "spa" ? "domcontentloaded" : "networkidle";
-	await page.goto(req.url, {
-		waitUntil,
-		timeout: NAV_TIMEOUT_MS
-	});
-	if (req.waitFor) await page.waitForSelector(req.waitFor, { timeout: 15e3 });
-	const extra = req.waitMs ?? 500;
-	if (extra > 0) await page.waitForTimeout(extra);
-	signal.throwIfAborted();
-	if (req.elementSelector) await page.locator(req.elementSelector).first().screenshot({ path: outAbsPath });
-	else await page.screenshot({
-		path: outAbsPath,
-		fullPage: req.fullPage === true
-	});
-}
-function makeSandboxId() {
-	const rand = () => Math.random().toString(16).slice(2, 10);
-	return `ui-audit-${rand()}${rand()}`;
-}
-/** Create a `SandboxClient` that drives a local Playwright browser for in-process UI audits. @experimental */
-function createInProcessUiAuditClient(options) {
-	const launch = options.launchBrowser ?? defaultLaunch;
-	const navPolicy = options.navPolicy ?? "strict";
-	let browserPromise;
-	let closed = false;
-	async function getBrowser() {
-		if (closed) throw new Error("ui-auditor: client is closed; create a new client to run another iteration");
-		if (!browserPromise) browserPromise = launch();
-		return browserPromise;
-	}
-	async function* runIteration(promptText, signal) {
-		const task = decodeAuditTaskEnvelope(promptText);
-		if (!task) throw new Error("ui-auditor: prompt is missing a UI_AUDIT_TASK envelope. Use uiAuditorProfile().taskToPrompt to format prompts, or pass an envelope-prefixed prompt manually.");
-		if (task.captures.length === 0) throw new Error("ui-auditor: task has zero captures; nothing to audit.");
-		yield asSandboxEvent("audit.lens", { lens: task.lens });
-		const context = await (await getBrowser()).newContext({ viewport: DEFAULT_VIEWPORT });
-		let primaryError;
-		let closeError;
-		try {
-			const page = await context.newPage();
-			const captures = [];
-			const fs = await import("node:fs/promises");
-			const path = await import("node:path");
-			const shotsDir = path.join(options.workspaceDir, "screenshots");
-			await fs.mkdir(shotsDir, { recursive: true });
-			for (const req of task.captures) {
-				signal.throwIfAborted();
-				const filename = captureFilename(req);
-				const absPath = path.join(shotsDir, filename);
-				const relPath = `screenshots/${filename}`;
-				await captureOne(page, req, absPath, signal, navPolicy);
-				const vp = viewportOf(req);
-				const cap = {
-					path: relPath,
-					viewport: `${vp.width}x${vp.height}`,
-					fullPage: req.fullPage === true,
-					route: req.route,
-					url: req.url,
-					capturedAt: (/* @__PURE__ */ new Date()).toISOString()
-				};
-				if (req.elementSelector) cap.elementSelector = req.elementSelector;
-				if (req.label) cap.label = req.label;
-				captures.push(cap);
-				yield asSandboxEvent("audit.capture", cap);
-			}
-			const judgeOut = await options.judge({
-				lens: task.lens,
-				captures,
-				productContext: task.productContext,
-				knownFindingIds: task.knownFindingIds,
-				promptText,
-				signal
-			});
-			for (const finding of judgeOut.findings) yield asSandboxEvent("audit.finding", finding);
-			if (judgeOut.notes && judgeOut.notes.trim().length > 0) yield asSandboxEvent("audit.notes", { notes: judgeOut.notes });
-			const usage = judgeOut.tokenUsage ?? {
-				input: 0,
-				output: 0
-			};
-			yield asSandboxEvent("done", {
-				tokenUsage: {
-					inputTokens: usage.input,
-					outputTokens: usage.output
-				},
-				totalCostUsd: judgeOut.costUsd ?? 0
-			});
-		} catch (err) {
-			primaryError = err;
-		} finally {
-			try {
-				await context.close();
-			} catch (err) {
-				closeError = err;
-			}
-		}
-		if (primaryError !== void 0 && closeError !== void 0) throw new AggregateError([primaryError, closeError], "ui-auditor: iteration failed AND context.close() failed; both errors attached.");
-		if (primaryError !== void 0) throw primaryError;
-		if (closeError !== void 0) throw closeError;
-	}
-	function makeSyntheticSandbox() {
-		return {
-			id: makeSandboxId(),
-			streamPrompt(message, opts) {
-				return runIteration(message, opts?.signal ?? new AbortController().signal);
-			},
-			async delete() {}
-		};
-	}
-	return {
-		async create(_options) {
-			return makeSyntheticSandbox();
-		},
-		describePlacement(box) {
-			const id = box.id;
-			return {
-				kind: "sibling",
-				sandboxId: typeof id === "string" ? id : void 0
-			};
-		},
-		async close() {
-			closed = true;
-			const pending = browserPromise;
-			browserPromise = void 0;
-			if (pending) await (await pending).close();
-		}
-	};
-}
-//#endregion
 //#region src/profiles/ui-auditor/lens-prompts.ts
 /** Cross-lens rules injected into every UI audit iteration: finding quality standards and scope limits. @experimental */
 const SHARED_AUDITOR_RULES = `
@@ -734,6 +499,70 @@ function parseAuditorEvents(events) {
 	return out;
 }
 //#endregion
+//#region src/profiles/ui-auditor/prompt.ts
+const ENVELOPE_BEGIN = "<<UI_AUDIT_TASK>>";
+const ENVELOPE_END = "<<UI_AUDIT_TASK_END>>";
+/** Wrap a `UiAuditTask` in a machine-readable envelope so iterations are self-describing. @experimental */
+function encodeAuditTaskEnvelope(task) {
+	return `${ENVELOPE_BEGIN}${JSON.stringify(task)}${ENVELOPE_END}`;
+}
+/**
+* Parse a task envelope back out of a prompt string. Returns undefined if
+* the prompt does not contain a complete envelope OR if the payload is
+* not valid JSON.
+*
+* @experimental
+*/
+function decodeAuditTaskEnvelope(prompt) {
+	const start = prompt.indexOf(ENVELOPE_BEGIN);
+	if (start === -1) return void 0;
+	const payloadStart = start + 17;
+	const end = prompt.indexOf(ENVELOPE_END, payloadStart);
+	if (end === -1) return void 0;
+	const payload = prompt.slice(payloadStart, end);
+	try {
+		const parsed = JSON.parse(payload);
+		if (!parsed || typeof parsed !== "object") return void 0;
+		const t = parsed;
+		if (typeof t.lens !== "string" || !Array.isArray(t.captures)) return void 0;
+		return t;
+	} catch {
+		return;
+	}
+}
+/** Produce the user message for one audit iteration: lens, captures to take, and the task envelope. @experimental */
+function formatAuditorPrompt(task) {
+	const lines = [];
+	lines.push(`# UI audit iteration — lens: ${task.lens}`);
+	lines.push("");
+	if (task.productContext && task.productContext.trim().length > 0) {
+		lines.push("## Product context");
+		lines.push(task.productContext.trim());
+		lines.push("");
+	}
+	lines.push("## Captures to take");
+	task.captures.forEach((cap, i) => {
+		const detail = [
+			`viewport=${cap.viewport ? `${cap.viewport.width}x${cap.viewport.height}` : "1280x800 (default)"}`,
+			cap.fullPage ? "fullPage=true" : null,
+			cap.elementSelector ? `selector=\`${cap.elementSelector}\`` : null,
+			cap.waitFor ? `waitFor=\`${cap.waitFor}\`` : null,
+			cap.waitMs !== void 0 ? `waitMs=${cap.waitMs}` : null,
+			cap.label ? `label=${cap.label}` : null
+		].filter((s) => s !== null).join(" · ");
+		lines.push(`${i + 1}. route=\`${cap.route}\` url=${cap.url} ${detail ? `(${detail})` : ""}`);
+	});
+	lines.push("");
+	if (task.knownFindingIds && task.knownFindingIds.length > 0) {
+		lines.push("## Known findings (link via similarTo, do not refile)");
+		lines.push(task.knownFindingIds.map((n) => `#${String(n).padStart(3, "0")}`).join(", "));
+		lines.push("");
+	}
+	lines.push("## Output format");
+	lines.push("Emit a single JSON object with the shape `{ findings: UiFinding[], notes?: string }` where every finding has the fields enumerated in your system prompt. The screenshots field on each finding must reference the captures above by path. Do not emit findings outside the lens.");
+	return lines.join("\n");
+}
+//#endregion
 //#region src/profiles/ui-auditor/validator.ts
 const GENERIC_TITLE_PATTERNS = [
 	/^improve\s/i,
@@ -803,44 +632,6 @@ function createUiAuditorValidator(task) {
 	} };
 }
 //#endregion
-//#region src/profiles/ui-auditor/profile.ts
-/**
-* Preset `runAgentRounds` bundle for vision-driven UI audits: returns the `AgentRunSpec`, output adapter, validator, and prompt formatter the loop kernel needs.
-*
-* @experimental
-*/
-function uiAuditorProfile(options = {}) {
-	const name = options.name ?? "ui-auditor";
-	const profile = {
-		name,
-		description: "Vision-driven UI auditor. One lens per iteration.",
-		prompt: { systemPrompt: "" },
-		model: options.model ? { default: options.model } : void 0,
-		tools: {
-			browser: true,
-			vision: true
-		},
-		metadata: { role: "ui-auditor" }
-	};
-	const output = { parse: parseAuditorEvents };
-	const validator = options.task ? createUiAuditorValidator(options.task) : createUiAuditorValidator({
-		lens: "other",
-		captures: []
-	});
-	const taskToPrompt = (task) => `${encodeAuditTaskEnvelope(task)}\n${buildAuditorSystemPrompt(task.lens)}\n\n${formatAuditorPrompt(task)}`;
-	return {
-		profile,
-		taskToPrompt,
-		output,
-		validator,
-		agentRunSpec: {
-			name,
-			profile,
-			taskToPrompt
-		}
-	};
-}
-//#endregion
-export { LENS_BRIEFS, SHARED_AUDITOR_RULES, UI_FINDING_SEVERITIES, UI_LENSES, appendFindings, buildAuditorSystemPrompt, coderTaskToPrompt, createInProcessUiAuditClient, createResearcherValidator, createUiAuditorValidator, decodeAuditTaskEnvelope, encodeAuditTaskEnvelope, formatAuditorPrompt, initAuditWorkspace, multiHarnessResearcherFanout, parseAuditorEvents, readAuditRegistry, registerCaptures, researcherProfile, summarizeRegistry, uiAuditorProfile, writeAuditIndex };
+export { LENS_BRIEFS, SHARED_AUDITOR_RULES, UI_FINDING_SEVERITIES, UI_LENSES, appendFindings, buildAuditorSystemPrompt, coderTaskToPrompt, createResearcherValidator, createUiAuditorValidator, decodeAuditTaskEnvelope, encodeAuditTaskEnvelope, formatAuditorPrompt, initAuditWorkspace, multiHarnessResearcherFanout, parseAuditorEvents, readAuditRegistry, registerCaptures, researcherProfile, summarizeRegistry, writeAuditIndex };
 
 //# sourceMappingURL=profiles.js.map