@tangle-network/agent-runtime 0.301.0 → 0.306.2

package/dist/profiles.js

@@ -1,324 +1,8 @@
 import { i as ConfigError } from "./errors-DodWX-cb.js";
 import { t as assertExecutableAgentProfile } from "./model-policy-DydyWTQg.js";
-import { n as UI_LENSES, t as UI_FINDING_SEVERITIES } from "./substrate-B0TYNrXn.js";
 import { t as coderTaskToPrompt } from "./coder-yhVWbdWc.js";
+import { n as UI_LENSES, t as UI_FINDING_SEVERITIES } from "./substrate-B0TYNrXn.js";
 import { agentProfileSchema } from "@tangle-network/agent-interface";
-import { promises } from "node:fs";
-import path from "node:path";
-//#region src/profiles/ui-auditor/slugify.ts
-/**
-*
-* Shared slug helper used by both the in-process auditor client (for
-* screenshot filenames) and the issue writer (for issue Markdown
-* filenames). Lowercases, normalizes, strips non-alphanumeric, trims
-* dashes, caps at 80 chars. Throws when the result is empty so callers
-* never silently write to a name-less filename.
-*
-* @experimental
-*/
-/** @experimental */
-function slugify(value, fieldName) {
-	const slug = value.toLowerCase().normalize("NFKD").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80);
-	if (slug.length === 0) throw new Error(`ui-auditor: ${fieldName} slugified to empty string. Provide a non-empty value (got ${JSON.stringify(value)}).`);
-	return slug;
-}
-//#endregion
-//#region src/audit/issue-writer.ts
-/**
-*
-* UI-audit issue writer — pure I/O. Takes a workspace dir + `UiFinding[]`
-* and emits:
-*   - `<workspace>/issues/NNN--<lens>--<slug>.md` — one self-contained
-*     GitHub-issue-ready Markdown per finding, with embedded screenshot
-*     references.
-*   - `<workspace>/registry.json` — finding index for dedup and audit
-*     resume across iterations.
-*   - `<workspace>/index.md` — human-readable rollup (severity / lens /
-*     route counts plus a sorted finding list).
-*
-* The writer is deterministic, idempotent for `appendFindings()`, and
-* never invokes an LLM. It assigns the next monotonic id to a finding the
-* caller did not pre-id.
-*
-* @experimental
-*/
-const SEVERITY_ORDER = {
-	critical: 0,
-	high: 1,
-	med: 2,
-	low: 3
-};
-function assertValidWorkspaceDir(dir) {
-	if (typeof dir !== "string" || dir.length === 0) throw new Error(`audit-writer: workspaceDir must be a non-empty string (got ${JSON.stringify(dir)})`);
-	if (!path.isAbsolute(dir)) throw new Error(`audit-writer: workspaceDir must be an absolute path (got ${JSON.stringify(dir)})`);
-	if (dir.split(path.sep).includes("..")) throw new Error(`audit-writer: workspaceDir must not contain '..' segments (got ${JSON.stringify(dir)})`);
-}
-/** Create the `issues/`, `screenshots/`, and `registry.json` scaffold in a new audit workspace. @experimental */
-async function initAuditWorkspace(workspaceDir) {
-	assertValidWorkspaceDir(workspaceDir);
-	await promises.mkdir(path.join(workspaceDir, "issues"), { recursive: true });
-	await promises.mkdir(path.join(workspaceDir, "screenshots"), { recursive: true });
-	const regPath = path.join(workspaceDir, "registry.json");
-	try {
-		await promises.access(regPath);
-	} catch {
-		await promises.writeFile(regPath, JSON.stringify({
-			schemaVersion: 1,
-			findings: [],
-			routes: {}
-		}, null, 2));
-	}
-}
-/** Read and validate the `registry.json` from an audit workspace. @experimental */
-async function readAuditRegistry(workspaceDir) {
-	assertValidWorkspaceDir(workspaceDir);
-	const regPath = path.join(workspaceDir, "registry.json");
-	const text = await promises.readFile(regPath, "utf8");
-	const parsed = JSON.parse(text);
-	if (!parsed || typeof parsed !== "object") throw new Error(`audit-writer: registry.json at ${regPath} is not a JSON object`);
-	const reg = parsed;
-	if (reg.schemaVersion !== 1 || !Array.isArray(reg.findings) || typeof reg.routes !== "object") throw new Error(`audit-writer: registry.json at ${regPath} has an unrecognized shape`);
-	return reg;
-}
-async function writeAuditRegistry(workspaceDir, reg) {
-	const regPath = path.join(workspaceDir, "registry.json");
-	const tmpPath = `${regPath}.tmp-${process.pid}-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
-	await promises.writeFile(tmpPath, JSON.stringify(reg, null, 2));
-	await promises.rename(tmpPath, regPath);
-}
-const workspaceLocks = /* @__PURE__ */ new Map();
-async function withWorkspaceLock(workspaceDir, fn) {
-	const key = path.resolve(workspaceDir);
-	const prev = workspaceLocks.get(key) ?? Promise.resolve();
-	let signalDone;
-	const done = new Promise((resolve) => {
-		signalDone = resolve;
-	});
-	workspaceLocks.set(key, done);
-	try {
-		await prev;
-		return await fn();
-	} finally {
-		signalDone();
-		if (workspaceLocks.get(key) === done) workspaceLocks.delete(key);
-	}
-}
-function assertFindingShape(f, index) {
-	const where = `audit-writer: findings[${index}]`;
-	if (!UI_LENSES.includes(f.lens)) throw new Error(`${where}: invalid lens ${JSON.stringify(f.lens)}; one of ${UI_LENSES.join("|")}`);
-	if (!UI_FINDING_SEVERITIES.includes(f.severity)) throw new Error(`${where}: invalid severity ${JSON.stringify(f.severity)}; one of ${UI_FINDING_SEVERITIES.join("|")}`);
-	for (const field of [
-		"title",
-		"route",
-		"observation",
-		"impact",
-		"suggestedFix"
-	]) {
-		const v = f[field];
-		if (typeof v !== "string" || v.trim().length === 0) throw new Error(`${where}: ${field} must be a non-empty string`);
-	}
-	if (!Array.isArray(f.screenshots) || f.screenshots.length === 0) throw new Error(`${where}: screenshots must be a non-empty array`);
-	for (let i = 0; i < f.screenshots.length; i += 1) {
-		const s = f.screenshots[i];
-		if (!s || typeof s.path !== "string" || s.path.length === 0) throw new Error(`${where}.screenshots[${i}].path must be a non-empty string`);
-		if (s.path.split(/[/\\]/).includes("..")) throw new Error(`${where}.screenshots[${i}].path must not contain '..' segments`);
-	}
-}
-function nextFindingId(reg) {
-	let max = 0;
-	for (const f of reg.findings) if (typeof f.id === "number" && f.id > max) max = f.id;
-	return max + 1;
-}
-function slugifyTitle(title) {
-	return slugify(title, "title");
-}
-function renderFinding(finding) {
-	if (!finding.id) throw new Error("audit-writer: cannot render a finding without an assigned id");
-	if (finding.screenshots.length === 0) throw new Error(`audit-writer: finding #${finding.id} has no screenshots`);
-	const id = finding.id;
-	const metaLines = [`> **Issue #${String(id).padStart(3, "0")}** · **Severity:** ${finding.severity} · **Lens:** ${finding.lens}`, `> **Route:** \`${finding.route}\`${finding.url ? ` · **URL:** ${finding.url}` : ""}`];
-	if (finding.viewport) metaLines.push(`> **Viewport:** ${finding.viewport}`);
-	if (finding.selector) metaLines.push(`> **Selector:** \`${finding.selector}\``);
-	if (finding.tags && finding.tags.length > 0) metaLines.push(`> **Tags:** ${finding.tags.map((t) => `\`${t}\``).join(", ")}`);
-	if (finding.similarTo && finding.similarTo.length > 0) metaLines.push(`> **Possible duplicates:** ${finding.similarTo.map((n) => `#${String(n).padStart(3, "0")}`).join(", ")}`);
-	metaLines.push(`> _Generated: ${finding.createdAt ?? (/* @__PURE__ */ new Date()).toISOString()}_`);
-	const reproSteps = finding.reproSteps ?? `1. Open \`${finding.route}\`${finding.url ? ` (${finding.url})` : ""}\n2. Observe the area shown in the screenshot${finding.selector ? ` (selector: \`${finding.selector}\`)` : ""}.`;
-	const evidence = finding.screenshots.map((s) => `![${path.basename(s.path)}](../${s.path})`).join("\n\n");
-	return [
-		`# [UI] ${finding.title}`,
-		"",
-		metaLines.join("\n"),
-		"",
-		"## Observation",
-		finding.observation.trim(),
-		"",
-		"## Why it matters",
-		finding.impact.trim(),
-		"",
-		"## Steps to reproduce",
-		reproSteps,
-		"",
-		"## Suggested fix",
-		finding.suggestedFix.trim(),
-		"",
-		"## Evidence",
-		evidence,
-		"",
-		"---",
-		`<sub>Generated by agent-runtime/ui-auditor · lens=\`${finding.lens}\` · severity=\`${finding.severity}\`</sub>`,
-		""
-	].join("\n");
-}
-/**
-* Append findings to a workspace, writing one Markdown file per finding
-* and updating registry.json. Assigns monotonically increasing ids to
-* findings that arrived without one.
-*
-* Findings already carrying an id that collides with the registry are
-* rejected — callers must either freshly mint findings (id undefined) or
-* use a separate update path. This protects against accidental overwrite.
-*
-* @experimental
-*/
-async function appendFindings(workspaceDir, findings) {
-	assertValidWorkspaceDir(workspaceDir);
-	for (let i = 0; i < findings.length; i += 1) {
-		const f = findings[i];
-		if (!f) throw new Error(`audit-writer: findings[${i}] is undefined`);
-		assertFindingShape(f, i);
-	}
-	return withWorkspaceLock(workspaceDir, async () => {
-		await initAuditWorkspace(workspaceDir);
-		const reg = await readAuditRegistry(workspaceDir);
-		const usedIds = /* @__PURE__ */ new Set();
-		for (const f of reg.findings) if (typeof f.id === "number") usedIds.add(f.id);
-		const written = [];
-		const files = [];
-		let nextId = nextFindingId(reg);
-		for (const incoming of findings) {
-			let id = incoming.id;
-			if (id !== void 0) {
-				if (usedIds.has(id)) throw new Error(`audit-writer: incoming finding id ${id} (title=${JSON.stringify(incoming.title)}) collides with an existing registry entry`);
-			} else {
-				id = nextId;
-				while (usedIds.has(id)) id += 1;
-				nextId = id + 1;
-			}
-			usedIds.add(id);
-			const createdAt = incoming.createdAt ?? (/* @__PURE__ */ new Date()).toISOString();
-			const persisted = {
-				...incoming,
-				id,
-				createdAt
-			};
-			const slug = slugifyTitle(persisted.title);
-			const fileName = `${String(id).padStart(3, "0")}--${persisted.lens}--${slug}.md`;
-			const filePathAbs = path.join(workspaceDir, "issues", fileName);
-			const filePathRel = `issues/${fileName}`;
-			await promises.writeFile(filePathAbs, renderFinding(persisted));
-			reg.findings.push(persisted);
-			written.push(persisted);
-			files.push(filePathRel);
-		}
-		await writeAuditRegistry(workspaceDir, reg);
-		return {
-			written,
-			files
-		};
-	});
-}
-/**
-* Record screenshots taken for a route in the registry, without filing a
-* finding. Useful when the auditor wants to remember which captures
-* exist for resume / dedup purposes.
-*
-* @experimental
-*/
-async function registerCaptures(workspaceDir, options) {
-	assertValidWorkspaceDir(workspaceDir);
-	if (typeof options.route !== "string" || options.route.trim().length === 0) throw new Error("audit-writer: registerCaptures: route must be a non-empty string");
-	return withWorkspaceLock(workspaceDir, async () => {
-		await initAuditWorkspace(workspaceDir);
-		const reg = await readAuditRegistry(workspaceDir);
-		const slot = reg.routes[options.route] ?? { captures: [] };
-		if (options.url) slot.url = options.url;
-		slot.captures = [...slot.captures, ...options.captures];
-		reg.routes[options.route] = slot;
-		await writeAuditRegistry(workspaceDir, reg);
-	});
-}
-/** Compute finding counts by severity, lens, and route from an `AuditRegistry`. @experimental */
-function summarizeRegistry(reg) {
-	const bySeverity = {
-		critical: 0,
-		high: 0,
-		med: 0,
-		low: 0
-	};
-	const byLens = {};
-	const byRoute = {};
-	for (const f of reg.findings) {
-		bySeverity[f.severity] += 1;
-		byLens[f.lens] = (byLens[f.lens] ?? 0) + 1;
-		byRoute[f.route] = (byRoute[f.route] ?? 0) + 1;
-	}
-	return {
-		total: reg.findings.length,
-		bySeverity,
-		byLens,
-		byRoute
-	};
-}
-/**
-* Regenerate `<workspace>/index.md` from registry.json.
-*
-* @experimental
-*/
-async function writeAuditIndex(workspaceDir) {
-	assertValidWorkspaceDir(workspaceDir);
-	const reg = await readAuditRegistry(workspaceDir);
-	const summary = summarizeRegistry(reg);
-	const sorted = [...reg.findings].sort((a, b) => {
-		const sa = SEVERITY_ORDER[a.severity];
-		const sb = SEVERITY_ORDER[b.severity];
-		if (sa !== sb) return sa - sb;
-		return (a.id ?? 0) - (b.id ?? 0);
-	});
-	const lines = [];
-	lines.push("# UI audit index", "");
-	lines.push(`_Generated: ${(/* @__PURE__ */ new Date()).toISOString()}_`, "");
-	lines.push(`**Total findings:** ${summary.total}`, "");
-	lines.push("## By severity");
-	for (const s of [
-		"critical",
-		"high",
-		"med",
-		"low"
-	]) {
-		const n = summary.bySeverity[s] ?? 0;
-		if (n > 0) lines.push(`- **${s}** — ${n}`);
-	}
-	lines.push("", "## By lens");
-	const lensEntries = Object.entries(summary.byLens).map(([k, v]) => [k, v ?? 0]);
-	for (const [lens, n] of lensEntries.sort((a, b) => b[1] - a[1])) lines.push(`- **${lens}** — ${n}`);
-	lines.push("", "## By route");
-	const routeEntries = Object.entries(summary.byRoute).map(([k, v]) => [k, v ?? 0]);
-	for (const [route, n] of routeEntries.sort((a, b) => b[1] - a[1])) lines.push(`- \`${route}\` — ${n}`);
-	lines.push("", "## Findings", "");
-	for (const f of sorted) {
-		if (typeof f.id !== "number") continue;
-		const num = String(f.id).padStart(3, "0");
-		const slug = slugifyTitle(f.title);
-		const file = `issues/${num}--${f.lens}--${slug}.md`;
-		lines.push(`- [#${num} \`${f.severity}\` \`${f.lens}\` \`${f.route}\` — ${f.title}](${file})`);
-	}
-	lines.push("");
-	const out = path.join(workspaceDir, "index.md");
-	const body = lines.join("\n");
-	await promises.writeFile(out, body);
-	return out;
-}
-//#endregion
 //#region src/profiles/researcher.ts
 /**
 * Opinionated preset for source-grounded research
@@ -952,139 +636,6 @@ 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,
-	/^fix\s/i,
-	/^update\s/i,
-	/^better\s/i,
-	/^bad\s/i,
-	/^make\s.+\sbetter/i,
-	/\bUX\b\s*$/i,
-	/\bUI\b\s*$/i
-];
-function isGenericTitle(title) {
-	const t = title.trim();
-	if (t.length < 16) return true;
-	return GENERIC_TITLE_PATTERNS.some((re) => re.test(t));
-}
-/** Build a `Validator` that rejects off-lens findings and findings missing screenshot evidence. @experimental */
-function createUiAuditorValidator(task) {
-	return { async validate(output) {
-		const findings = output.findings;
-		const captures = output.captures;
-		const capturePaths = new Set(captures.map((c) => c.path));
-		const offLens = findings.filter((f) => f.lens !== task.lens);
-		if (offLens.length > 0) return {
-			valid: false,
-			score: 0,
-			notes: `${offLens.length} finding(s) filed under wrong lens (expected ${task.lens}; got ${offLens.map((f) => f.lens).join(", ")})`,
-			scores: { offLens: 0 }
-		};
-		const missingEvidence = findings.filter((f) => !Array.isArray(f.screenshots) || f.screenshots.length === 0);
-		if (missingEvidence.length > 0) return {
-			valid: false,
-			score: 0,
-			notes: `${missingEvidence.length} finding(s) have no screenshot evidence`,
-			scores: { evidence: 0 }
-		};
-		const unresolvedShot = findings.filter((f) => f.screenshots.some((s) => !capturePaths.has(s.path)));
-		if (unresolvedShot.length > 0) return {
-			valid: false,
-			score: 0,
-			notes: `${unresolvedShot.length} finding(s) reference screenshot paths not captured this iteration`,
-			scores: { evidence: 0 }
-		};
-		if (findings.length === 0) return {
-			valid: true,
-			score: .5,
-			notes: "No findings reported. Neither a confident pass nor a failure.",
-			scores: {
-				specificity: 0,
-				evidence: 1,
-				titles: 1
-			}
-		};
-		const specificity = findings.filter((f) => typeof f.selector === "string").length / findings.length;
-		const titles = 1 - findings.filter((f) => isGenericTitle(f.title)).length / findings.length;
-		const evidence = findings.filter((f) => Array.isArray(f.screenshots) && f.screenshots.length > 0 && f.screenshots.every((s) => capturePaths.has(s.path))).length / findings.length;
-		return {
-			valid: true,
-			score: Number((.4 * specificity + .4 * evidence + .2 * titles).toFixed(4)),
-			notes: `${findings.length} finding(s) — specificity=${specificity.toFixed(2)} evidence=${evidence.toFixed(2)} titles=${titles.toFixed(2)}`,
-			scores: {
-				specificity,
-				evidence,
-				titles
-			}
-		};
-	} };
-}
-//#endregion
-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 };
+export { LENS_BRIEFS, SHARED_AUDITOR_RULES, UI_FINDING_SEVERITIES, UI_LENSES, buildAuditorSystemPrompt, coderTaskToPrompt, createResearcherValidator, multiHarnessResearcherFanout, parseAuditorEvents, researcherProfile };
 
 //# sourceMappingURL=profiles.js.map