pi-agent-browser-native 0.2.47 → 0.2.49

package/extensions/agent-browser/lib/process.ts

@@ -1,516 +0,0 @@
-/**
- * Purpose: Execute the upstream agent-browser binary for the pi-agent-browser extension.
- * Responsibilities: Spawn the agent-browser subprocess, forward a curated environment surface, stream optional stdin, bound in-memory output buffering, spill oversized stdout safely to a private temp file under a disk budget, and honor abort signals.
- * Scope: Process execution only; argument planning, output formatting, and pi tool registration live elsewhere.
- * Usage: Called by the extension tool after argument validation and session planning are complete.
- * Invariants/Assumptions: The binary name is always `agent-browser`; Windows routes through PowerShell to invoke npm launchers with escaped argv; callers handle semantic success/error interpretation.
- */
-
-import { type ChildProcessWithoutNullStreams, spawn } from "node:child_process";
-import { chmod, mkdir } from "node:fs/promises";
-import { env as processEnv, platform as processPlatform } from "node:process";
-
-import { GLOBAL_BOOLEAN_FLAGS_WITH_OPTIONAL_VALUES, GLOBAL_VALUE_FLAGS, getFlagName } from "./argv-grammar.js";
-import { openSecureTempFile, writeSecureTempChunk } from "./temp.js";
-
-const MAX_BUFFERED_STDOUT_BYTES = 512 * 1_024;
-const MAX_BUFFERED_STDERR_CHARS = 32_000;
-const MAX_BUFFERED_STDOUT_TAIL_CHARS = 32_000;
-const PROCESS_STDOUT_SPILL_FILE_PREFIX = "process-stdout";
-const AGENT_BROWSER_SOCKET_DIR_ENV = "AGENT_BROWSER_SOCKET_DIR";
-const AGENT_BROWSER_DEFAULT_TIMEOUT_ENV = "AGENT_BROWSER_DEFAULT_TIMEOUT";
-const PI_AGENT_BROWSER_PROCESS_TIMEOUT_ENV = "PI_AGENT_BROWSER_PROCESS_TIMEOUT_MS";
-const DEFAULT_AGENT_BROWSER_SOCKET_DIR_PREFIX = "/tmp/piab";
-export const SAFE_AGENT_BROWSER_OPERATION_TIMEOUT_MS = 25_000;
-const DEFAULT_AGENT_BROWSER_PROCESS_TIMEOUT_MS = 35_000;
-/** Grace period after `exit` before resolving when `close` is delayed by inherited stdio handles. */
-const EXIT_STDIO_GRACE_MS = 100;
-const httpProxyEnvName = "http_proxy";
-const httpsProxyEnvName = "https_proxy";
-const allProxyEnvName = "all_proxy";
-const noProxyEnvName = "no_proxy";
-const INHERITED_ENV_NAMES = new Set([
-	"ALL_PROXY",
-	"APPDATA",
-	"CI",
-	"COLORTERM",
-	"COMSPEC",
-	"DBUS_SESSION_BUS_ADDRESS",
-	"DISPLAY",
-	"FORCE_COLOR",
-	"HOME",
-	"HOMEDRIVE",
-	"HOMEPATH",
-	"HTTPS_PROXY",
-	"HTTP_PROXY",
-	"LANG",
-	"LC_ALL",
-	"LC_CTYPE",
-	"LOCALAPPDATA",
-	"LOGNAME",
-	"NO_COLOR",
-	"NO_PROXY",
-	"NODE_EXTRA_CA_CERTS",
-	"NODE_TLS_REJECT_UNAUTHORIZED",
-	"OS",
-	"PATH",
-	"PATHEXT",
-	"PWD",
-	"SHELL",
-	"SSL_CERT_DIR",
-	"SSL_CERT_FILE",
-	"SYSTEMROOT",
-	"TEMP",
-	"TERM",
-	"TMP",
-	"TMPDIR",
-	"TZ",
-	"USER",
-	"USERNAME",
-	"USERPROFILE",
-	"WAYLAND_DISPLAY",
-	"XAUTHORITY",
-	"AWS_ACCESS_KEY_ID",
-	"AWS_SECRET_ACCESS_KEY",
-	"AWS_SESSION_TOKEN",
-	"AWS_PROFILE",
-	"AWS_REGION",
-	"AWS_DEFAULT_REGION",
-	httpProxyEnvName,
-	httpsProxyEnvName,
-	allProxyEnvName,
-	noProxyEnvName,
-]);
-const INHERITED_ENV_PREFIXES = [
-	"AGENT_BROWSER_",
-	"AGENTCORE_",
-	"AI_GATEWAY_",
-	"BROWSERBASE_",
-	"BROWSERLESS_",
-	"BROWSER_USE_",
-	"KERNEL_",
-	"XDG_",
-] as const;
-
-export interface ProcessRunResult {
-	aborted: boolean;
-	exitCode: number;
-	spawnError?: Error;
-	stderr: string;
-	stdout: string;
-	stdoutSpillPath?: string;
-	timedOut: boolean;
-	timeoutMs?: number;
-}
-
-function appendTail(text: string, addition: string, maxChars: number): string {
-	const combined = text + addition;
-	return combined.length <= maxChars ? combined : combined.slice(combined.length - maxChars);
-}
-
-function quoteWindowsPowerShellArg(value: string): string {
-	return `'${value.replace(/'/g, "''")}'`;
-}
-
-const WINDOWS_LEADING_GLOBAL_VALUE_FLAGS = new Set<string>(GLOBAL_VALUE_FLAGS);
-
-/** Exported for unit tests that lock Windows launcher argv ordering. */
-export function reorderWindowsLeadingGlobalArgs(args: string[]): string[] {
-	const leadingGlobals: string[] = [];
-	let index = 0;
-	while (index < args.length && args[index]?.startsWith("-")) {
-		const token = args[index];
-		const flagName = getFlagName(token);
-		leadingGlobals.push(token);
-		index += 1;
-		if (WINDOWS_LEADING_GLOBAL_VALUE_FLAGS.has(flagName) && !token.includes("=") && index < args.length) {
-			leadingGlobals.push(args[index]);
-			index += 1;
-			continue;
-		}
-		if (GLOBAL_BOOLEAN_FLAGS_WITH_OPTIONAL_VALUES.has(flagName) && ["true", "false"].includes(args[index] ?? "")) {
-			leadingGlobals.push(args[index]);
-			index += 1;
-		}
-	}
-	if (leadingGlobals.length === 0 || index >= args.length) return args;
-	return [args[index], ...leadingGlobals, ...args.slice(index + 1)];
-}
-
-function buildAgentBrowserSpawnCommand(args: string[]): { command: string; args: string[] } {
-	if (processPlatform !== "win32") {
-		return { command: "agent-browser", args };
-	}
-	const commandLine = ["&", "agent-browser", ...reorderWindowsLeadingGlobalArgs(args).map(quoteWindowsPowerShellArg)].join(" ");
-	return { command: "powershell.exe", args: ["-NoLogo", "-NoProfile", "-ExecutionPolicy", "Bypass", "-Command", commandLine] };
-}
-
-function terminateSpawnedChild(child: ChildProcessWithoutNullStreams, signal: NodeJS.Signals): void {
-	if (processPlatform === "win32" && child.pid) {
-		const killer = spawn("taskkill.exe", ["/PID", String(child.pid), "/T", "/F"], { stdio: "ignore" });
-		killer.on("error", () => undefined);
-		killer.unref();
-	}
-	child.kill(signal);
-}
-
-/** Exported for unit tests that lock subprocess exit-code precedence. */
-export function resolveSpawnedChildExitCode(input: {
-	closeCode?: number | null;
-	exitCode?: number | null;
-	useExitFallback: boolean;
-	timedOut: boolean;
-	spawnError?: Error;
-}): number {
-	// Precedence: observed `close` code when present, then wrapper timeout (124), then
-	// post-`exit` fallback when inherited stdio delays `close`, then spawn failure (127).
-	if (input.closeCode !== null && input.closeCode !== undefined) {
-		return input.closeCode;
-	}
-	if (input.timedOut) {
-		return 124;
-	}
-	if (input.useExitFallback && input.exitCode !== null && input.exitCode !== undefined) {
-		return input.exitCode;
-	}
-	return input.spawnError ? 127 : 0;
-}
-
-interface SpawnedChildCompletionWatcher {
-	clear: () => void;
-}
-
-function watchSpawnedChildCompletion(
-	child: ChildProcessWithoutNullStreams,
-	options: {
-		graceMs: number;
-		onComplete: (exitCode: number) => void;
-		getContext: () => { timedOut: boolean; spawnError?: Error };
-	},
-): SpawnedChildCompletionWatcher {
-	let exited = false;
-	let exitCode: number | null = null;
-	let postExitTimer: NodeJS.Timeout | undefined;
-	// `completed` suppresses duplicate exit/close callbacks; `settled` in `finish` guards async spill cleanup.
-	let completed = false;
-
-	const complete = (closeCode?: number | null) => {
-		if (completed) return;
-		completed = true;
-		if (postExitTimer) {
-			clearTimeout(postExitTimer);
-			postExitTimer = undefined;
-		}
-		const context = options.getContext();
-		options.onComplete(
-			resolveSpawnedChildExitCode({
-				closeCode,
-				exitCode,
-				useExitFallback: exited,
-				timedOut: context.timedOut,
-				spawnError: context.spawnError,
-			}),
-		);
-	};
-
-	child.once("exit", (code) => {
-		exited = true;
-		exitCode = code;
-		postExitTimer = setTimeout(() => {
-			destroySpawnedChildStreams(child);
-			complete(undefined);
-		}, options.graceMs);
-		postExitTimer.unref?.();
-	});
-	child.once("close", (code) => {
-		complete(code);
-	});
-
-	return {
-		clear: () => {
-			if (postExitTimer) {
-				clearTimeout(postExitTimer);
-				postExitTimer = undefined;
-			}
-		},
-	};
-}
-
-function destroySpawnedChildStreams(child: ChildProcessWithoutNullStreams): void {
-	child.stdin?.destroy();
-	child.stdout?.destroy();
-	child.stderr?.destroy();
-}
-
-function parsePositiveIntegerEnv(value: string | undefined): number | undefined {
-	if (value === undefined || !/^\d+$/.test(value.trim())) {
-		return undefined;
-	}
-	const parsed = Number(value.trim());
-	return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : undefined;
-}
-
-function clampUpstreamDefaultTimeout(childEnv: NodeJS.ProcessEnv): void {
-	const requestedTimeout = parsePositiveIntegerEnv(childEnv[AGENT_BROWSER_DEFAULT_TIMEOUT_ENV]);
-	if (requestedTimeout === undefined || requestedTimeout > SAFE_AGENT_BROWSER_OPERATION_TIMEOUT_MS) {
-		childEnv[AGENT_BROWSER_DEFAULT_TIMEOUT_ENV] = String(SAFE_AGENT_BROWSER_OPERATION_TIMEOUT_MS);
-	}
-}
-
-export function getAgentBrowserProcessTimeoutMs(env: NodeJS.ProcessEnv = processEnv): number {
-	return parsePositiveIntegerEnv(env[PI_AGENT_BROWSER_PROCESS_TIMEOUT_ENV]) ?? DEFAULT_AGENT_BROWSER_PROCESS_TIMEOUT_MS;
-}
-
-export function getAgentBrowserSocketDir(
-	platform: NodeJS.Platform = processPlatform,
-	uid: number | undefined = typeof process.getuid === "function" ? process.getuid() : undefined,
-): string | undefined {
-	if (platform === "win32") {
-		return undefined;
-	}
-	return `${DEFAULT_AGENT_BROWSER_SOCKET_DIR_PREFIX}${typeof uid === "number" ? `-${uid}` : ""}`;
-}
-
-async function ensureAgentBrowserSocketDir(socketDir: string): Promise<boolean> {
-	try {
-		await mkdir(socketDir, { recursive: true, mode: 0o700 });
-		await chmod(socketDir, 0o700).catch(() => undefined);
-		return true;
-	} catch {
-		return false;
-	}
-}
-
-function getChildEnvName(name: string): string | undefined {
-	if (processPlatform === "win32") {
-		const upperName = name.toUpperCase();
-		if (INHERITED_ENV_NAMES.has(upperName)) return upperName;
-		return INHERITED_ENV_PREFIXES.some((prefix) => upperName.startsWith(prefix)) ? upperName : undefined;
-	}
-	if (INHERITED_ENV_NAMES.has(name) || INHERITED_ENV_PREFIXES.some((prefix) => name.startsWith(prefix))) {
-		return name;
-	}
-	return undefined;
-}
-
-export function buildAgentBrowserProcessEnv(
-	baseEnv: NodeJS.ProcessEnv = processEnv,
-	overrides: NodeJS.ProcessEnv | undefined = undefined,
-): NodeJS.ProcessEnv {
-	const childEnv: NodeJS.ProcessEnv = {};
-	for (const [name, value] of Object.entries(baseEnv)) {
-		const childName = getChildEnvName(name);
-		if (value !== undefined && childName) {
-			childEnv[childName] = value;
-		}
-	}
-
-	if (!overrides) {
-		clampUpstreamDefaultTimeout(childEnv);
-		return childEnv;
-	}
-
-	for (const [name, value] of Object.entries(overrides)) {
-		const childName = getChildEnvName(name) ?? name;
-		if (value === undefined) {
-			delete childEnv[childName];
-		} else {
-			childEnv[childName] = value;
-		}
-	}
-	clampUpstreamDefaultTimeout(childEnv);
-	return childEnv;
-}
-
-export async function runAgentBrowserProcess(options: {
-	args: string[];
-	cwd: string;
-	env?: NodeJS.ProcessEnv;
-	signal?: AbortSignal;
-	stdin?: string;
-	timeoutMs?: number;
-}): Promise<ProcessRunResult> {
-	const { args, cwd, env, signal, stdin } = options;
-	const timeoutMs = options.timeoutMs ?? getAgentBrowserProcessTimeoutMs();
-	const explicitSocketDir = env?.[AGENT_BROWSER_SOCKET_DIR_ENV];
-	let effectiveEnv = explicitSocketDir === undefined ? { ...env, [AGENT_BROWSER_SOCKET_DIR_ENV]: undefined } : env;
-	const requestedSocketDir = explicitSocketDir ?? getAgentBrowserSocketDir();
-	if (requestedSocketDir && (await ensureAgentBrowserSocketDir(requestedSocketDir))) {
-		effectiveEnv = { ...env, [AGENT_BROWSER_SOCKET_DIR_ENV]: requestedSocketDir };
-	}
-
-	return await new Promise<ProcessRunResult>((resolve) => {
-		let aborted = false;
-		let settled = false;
-		let spawnError: Error | undefined;
-		let stderr = "";
-		let stdoutBuffers: Buffer[] = [];
-		let stdoutBufferedBytes = 0;
-		let stdoutTail = "";
-		let stdoutSpillHandle: Awaited<ReturnType<typeof openSecureTempFile>>["fileHandle"] | undefined;
-		let stdoutSpillPath: string | undefined;
-		let pendingStdoutWrite = Promise.resolve();
-		let stdoutSpillError: Error | undefined;
-		let killTimer: NodeJS.Timeout | undefined;
-		let timeoutTimer: NodeJS.Timeout | undefined;
-		let abortListener: (() => void) | undefined;
-		let timedOut = false;
-		let completionWatcher: SpawnedChildCompletionWatcher | undefined;
-
-		const queueStdoutChunk = (buffer: Buffer) => {
-			stdoutTail = appendTail(stdoutTail, buffer.toString("utf8"), MAX_BUFFERED_STDOUT_TAIL_CHARS);
-			if (stdoutSpillError) return;
-			if (!stdoutSpillPath && stdoutBufferedBytes + buffer.length <= MAX_BUFFERED_STDOUT_BYTES) {
-				stdoutBuffers.push(buffer);
-				stdoutBufferedBytes += buffer.length;
-				return;
-			}
-
-			pendingStdoutWrite = pendingStdoutWrite
-				.then(async () => {
-					if (stdoutSpillError) return;
-					if (!stdoutSpillHandle || !stdoutSpillPath) {
-						const tempFile = await openSecureTempFile(PROCESS_STDOUT_SPILL_FILE_PREFIX, ".json");
-						stdoutSpillHandle = tempFile.fileHandle;
-						stdoutSpillPath = tempFile.path;
-						if (stdoutBuffers.length > 0) {
-							await writeSecureTempChunk({
-								content: Buffer.concat(stdoutBuffers),
-								fileHandle: stdoutSpillHandle,
-								path: stdoutSpillPath,
-							});
-							stdoutBuffers = [];
-							stdoutBufferedBytes = 0;
-						}
-					}
-					await writeSecureTempChunk({ content: buffer, fileHandle: stdoutSpillHandle, path: stdoutSpillPath });
-				})
-				.catch((error) => {
-					stdoutSpillError = error instanceof Error ? error : new Error(String(error));
-				});
-		};
-
-		const removeAbortListener = () => {
-			if (!signal || !abortListener) return;
-			signal.removeEventListener("abort", abortListener);
-			abortListener = undefined;
-		};
-
-		const finish = (exitCode: number) => {
-			if (settled) return;
-			settled = true;
-			void pendingStdoutWrite.finally(async () => {
-				removeAbortListener();
-				if (killTimer) {
-					clearTimeout(killTimer);
-				}
-				if (timeoutTimer) {
-					clearTimeout(timeoutTimer);
-				}
-				completionWatcher?.clear();
-				if (stdoutSpillHandle) {
-					await stdoutSpillHandle.close().catch(() => undefined);
-				}
-				if (!spawnError && stdoutSpillError) {
-					spawnError = stdoutSpillError;
-				}
-				// Idempotent teardown: streams may already be destroyed by the post-`exit` fallback.
-				destroySpawnedChildStreams(child);
-				resolve({
-					aborted,
-					exitCode,
-					spawnError,
-					stderr,
-					stdout: stdoutSpillPath ? stdoutTail : Buffer.concat(stdoutBuffers).toString("utf8"),
-					stdoutSpillPath,
-					timedOut,
-					timeoutMs: timedOut ? timeoutMs : undefined,
-				});
-			});
-		};
-
-		const spawnCommand = buildAgentBrowserSpawnCommand(args);
-		const child = spawn(spawnCommand.command, spawnCommand.args, {
-			cwd,
-			env: buildAgentBrowserProcessEnv(processEnv, effectiveEnv),
-			stdio: ["pipe", "pipe", "pipe"],
-		});
-
-		const terminateChild = (reason: "abort" | "timeout") => {
-			if (settled) return;
-			if (reason === "abort") {
-				aborted = true;
-			} else {
-				timedOut = true;
-			}
-			terminateSpawnedChild(child, "SIGTERM");
-			killTimer = setTimeout(() => {
-				terminateSpawnedChild(child, "SIGKILL");
-			}, 2_000);
-		};
-		const recordStdinError = (error: unknown) => {
-			const stdinError = error instanceof Error ? error : new Error(String(error));
-			const errorCode = (stdinError as NodeJS.ErrnoException).code;
-			if (errorCode === "EPIPE" || errorCode === "EOF" || errorCode === "ERR_STREAM_DESTROYED") {
-				return;
-			}
-			if (!spawnError) {
-				spawnError = stdinError;
-			}
-		};
-		const writeChildStdin = () => {
-			if (aborted || signal?.aborted) {
-				child.stdin.destroy();
-				return;
-			}
-			try {
-				if (stdin) {
-					child.stdin.write(stdin);
-				}
-				child.stdin.end();
-			} catch (error) {
-				recordStdinError(error);
-				child.stdin.destroy();
-			}
-		};
-
-		child.stdin.on("error", recordStdinError);
-		child.once("error", (error) => {
-			spawnError = error instanceof Error ? error : new Error(String(error));
-			finish(
-				resolveSpawnedChildExitCode({
-					useExitFallback: false,
-					timedOut,
-					spawnError,
-				}),
-			);
-		});
-		completionWatcher = watchSpawnedChildCompletion(child, {
-			graceMs: EXIT_STDIO_GRACE_MS,
-			onComplete: finish,
-			getContext: () => ({ timedOut, spawnError }),
-		});
-		child.stdout.on("data", (chunk: Buffer | string) => {
-			queueStdoutChunk(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
-		});
-		child.stderr.on("data", (chunk: Buffer | string) => {
-			stderr = appendTail(stderr, chunk.toString(), MAX_BUFFERED_STDERR_CHARS);
-		});
-
-		if (timeoutMs > 0) {
-			timeoutTimer = setTimeout(() => terminateChild("timeout"), timeoutMs);
-			timeoutTimer.unref?.();
-		}
-
-		if (signal) {
-			if (signal.aborted) {
-				terminateChild("abort");
-			} else {
-				abortListener = () => terminateChild("abort");
-				signal.addEventListener("abort", abortListener, { once: true });
-			}
-		}
-
-		writeChildStdin();
-	});
-}

package/extensions/agent-browser/lib/prompt-policy.ts

@@ -1,105 +0,0 @@
-/**
- * Purpose: Derive operator prompt constraints for browser-run preflight guards and legacy bash policy.
- * Responsibilities: Parse the latest user message into requested artifact paths and legacy bash allowance.
- * Scope: Pure prompt-text policy; enforcement lives in orchestration prompt-guards and the extension entrypoint.
- */
-
-export interface PromptRequestedArtifact {
-	kind: "recording" | "screenshot";
-	path: string;
-	required: boolean;
-}
-
-export interface PromptPolicy {
-	allowLegacyAgentBrowserBash: boolean;
-	requestedArtifacts: PromptRequestedArtifact[];
-}
-
-const BROWSER_PROMPT_PATTERNS = [
-	/\b(?:agent[_ -]?browser|browser automation|eval\s+--stdin|screenshot|snapshot|tab\s+list)\b/i,
-	/\b(?:react\s+(?:tree|inspect|renders|suspense)|web\s+vitals|core\s+web\s+vitals|pushstate)\b/i,
-	/\b(?:live\s+docs?|online\s+research|research\s+(?:online|the\s+web)|search\s+(?:online|the\s+web)|web\s+research)\b/i,
-	/\bbrowser\b.*\b(?:automation|click|fill|navigate|open|page|screenshot|site|snapshot|tab|url|visit|web(?:site| page)?)\b/i,
-	/\b(?:browse|click|fill|login|navigate|open|visit)\b.*\b(?:https?:\/\/\S+|page|site|tab|url|web(?:site| page)?)\b/i,
-];
-
-const LEGACY_BASH_ALLOW_PATTERNS = [
-	/\b(?:bash-oriented workflow|bash workflow)\b/i,
-	/\b(?:use|via|through|with)\s+bash\b/i,
-	/\bnpx\s+agent-browser\b/i,
-	/\bagent-browser\s+--(?:help|version)\b/i,
-	/\bdebug(?:ging)?\b.*\b(?:agent[_ -]?browser|agent_browser|browser integration)\b/i,
-];
-
-const PROMPT_ARTIFACT_PATH_PATTERN = /(?:^|[\s"'`(:])((?:\/[^\s"'`),;]+|[A-Za-z]:[\\/][^\s"'`),;]+|\.{1,2}[\\/][^\s"'`),;]+|[^\s"'`),;:\\/]+(?:[\\/][^\s"'`),;]+)+|[^\s"'`),;:\\/]+)\.(?:png|jpe?g|webp|gif|webm|mp4|har|pdf|trace|json))(?:[\s"'`),;.]|$)/gi;
-
-function extractPromptRequestedArtifacts(prompt: string): PromptRequestedArtifact[] {
-	const artifacts: PromptRequestedArtifact[] = [];
-	const seen = new Set<string>();
-	for (const line of prompt.split(/\r?\n/)) {
-		const lowerLine = line.toLowerCase();
-		const kind = lowerLine.includes("screenshot")
-			? "screenshot"
-			: /\b(?:screen\s+recording|recording|webm|video)\b/.test(lowerLine)
-				? "recording"
-				: undefined;
-		if (!kind) continue;
-		PROMPT_ARTIFACT_PATH_PATTERN.lastIndex = 0;
-		for (const match of line.matchAll(PROMPT_ARTIFACT_PATH_PATTERN)) {
-			const path = match[1]?.trim();
-			if (!path) continue;
-			const key = `${kind}:${path}`;
-			if (seen.has(key)) continue;
-			seen.add(key);
-			artifacts.push({
-				kind,
-				path,
-				required: kind === "screenshot" || !/\b(?:if|when)\s+(?:recording\s+)?(?:is\s+)?available\b/i.test(line),
-			});
-		}
-	}
-	return artifacts;
-}
-
-export function buildPromptPolicy(prompt: string): PromptPolicy {
-	return {
-		allowLegacyAgentBrowserBash: LEGACY_BASH_ALLOW_PATTERNS.some((pattern) => pattern.test(prompt)),
-		requestedArtifacts: extractPromptRequestedArtifacts(prompt),
-	};
-}
-
-function getMessageText(content: unknown): string {
-	if (typeof content === "string") return content;
-	if (!Array.isArray(content)) return "";
-
-	return content
-		.map((item) => {
-			if (typeof item !== "object" || item === null) return "";
-			return item.type === "text" && typeof item.text === "string" ? item.text : "";
-		})
-		.filter((text) => text.length > 0)
-		.join("\n");
-}
-
-export function shouldAppendBrowserSystemPrompt(prompt: string): boolean {
-	const normalizedPrompt = prompt.trim();
-	if (normalizedPrompt.length === 0) {
-		return false;
-	}
-	return BROWSER_PROMPT_PATTERNS.some((pattern) => pattern.test(normalizedPrompt));
-}
-
-export function getLatestUserPrompt(branch: unknown[]): string {
-	for (let index = branch.length - 1; index >= 0; index -= 1) {
-		const entry = branch[index];
-		if (typeof entry !== "object" || entry === null || !("type" in entry) || entry.type !== "message") {
-			continue;
-		}
-		const message = "message" in entry ? entry.message : undefined;
-		if (typeof message !== "object" || message === null || !("role" in message) || message.role !== "user") {
-			continue;
-		}
-		return getMessageText("content" in message ? message.content : undefined);
-	}
-	return "";
-}