pi-agent-browser-native 0.2.48 → 0.2.49

package/extensions/agent-browser/lib/orchestration/input-plan.ts

@@ -1,375 +0,0 @@
-import { parseArgvDescriptor } from "../argv-descriptor.js";
-import { validateToolArgs, redactInvocationArgs, redactSensitiveText } from "../runtime.js";
-import { buildAgentBrowserResultCategoryDetails } from "../results/categories.js";
-import {
-	compileAgentBrowserElectron,
-	compileAgentBrowserJob,
-	compileAgentBrowserNetworkSourceLookup,
-	compileAgentBrowserQaPreset,
-	compileAgentBrowserSemanticAction,
-	compileAgentBrowserSourceLookup,
-	redactNetworkSourceLookupArgs,
-	redactNetworkSourceLookupUrl,
-	type CompiledAgentBrowserElectron,
-	type CompiledAgentBrowserJob,
-	type CompiledAgentBrowserNetworkSourceLookup,
-	type CompiledAgentBrowserQaPreset,
-	type CompiledAgentBrowserSemanticAction,
-	type CompiledAgentBrowserSourceLookup,
-} from "../input-modes.js";
-
-export interface AgentBrowserExecuteParams {
-	args?: string[];
-	electron?: unknown;
-	job?: unknown;
-	networkSourceLookup?: unknown;
-	outputPath?: string;
-	qa?: unknown;
-	semanticAction?: unknown;
-	sessionMode?: "auto" | "fresh";
-	sourceLookup?: unknown;
-	stdin?: string;
-	timeoutMs?: number;
-}
-
-export type ResolvedAgentBrowserInputKind = "args" | "electron" | "job" | "networkSourceLookup" | "qa" | "semanticAction" | "sourceLookup";
-
-type ResolvedAgentBrowserInputModeFields = {
-	compiledElectron?: CompiledAgentBrowserElectron;
-	compiledGeneratedBatch?: CompiledAgentBrowserJob | CompiledAgentBrowserNetworkSourceLookup | CompiledAgentBrowserSourceLookup;
-	compiledJob?: CompiledAgentBrowserJob;
-	compiledNetworkSourceLookup?: CompiledAgentBrowserNetworkSourceLookup;
-	compiledQaPreset?: CompiledAgentBrowserQaPreset;
-	compiledSemanticAction?: CompiledAgentBrowserSemanticAction;
-	compiledSourceLookup?: CompiledAgentBrowserSourceLookup;
-	redactedCompiledElectron?: CompiledAgentBrowserElectron;
-	redactedCompiledJob?: CompiledAgentBrowserJob;
-	redactedCompiledNetworkSourceLookup?: CompiledAgentBrowserNetworkSourceLookup;
-	redactedCompiledQaPreset?: CompiledAgentBrowserQaPreset;
-	redactedCompiledSemanticAction?: CompiledAgentBrowserSemanticAction;
-	redactedCompiledSourceLookup?: CompiledAgentBrowserSourceLookup;
-};
-
-interface ResolvedAgentBrowserInputBase {
-	redactedArgs: string[];
-	toolArgs: string[];
-	toolStdin?: string;
-}
-
-interface ResolvedAgentBrowserValidInputBase extends ResolvedAgentBrowserInputBase {
-	status: "valid";
-	validationError?: undefined;
-}
-
-export interface ResolvedAgentBrowserInvalidInput extends ResolvedAgentBrowserInputBase, ResolvedAgentBrowserInputModeFields {
-	attemptedKind?: ResolvedAgentBrowserInputKind;
-	kind: "invalid";
-	status: "invalid";
-	validationError: string;
-}
-
-export type ResolvedAgentBrowserValidInput =
-	| (ResolvedAgentBrowserValidInputBase & {
-		kind: "args";
-	})
-	| (ResolvedAgentBrowserValidInputBase & {
-		compiledElectron: CompiledAgentBrowserElectron;
-		kind: "electron";
-		redactedCompiledElectron: CompiledAgentBrowserElectron;
-	})
-	| (ResolvedAgentBrowserValidInputBase & {
-		compiledGeneratedBatch: CompiledAgentBrowserJob;
-		compiledJob: CompiledAgentBrowserJob;
-		kind: "job";
-		redactedCompiledJob: CompiledAgentBrowserJob;
-	})
-	| (ResolvedAgentBrowserValidInputBase & {
-		compiledGeneratedBatch: CompiledAgentBrowserNetworkSourceLookup;
-		compiledNetworkSourceLookup: CompiledAgentBrowserNetworkSourceLookup;
-		kind: "networkSourceLookup";
-		redactedCompiledNetworkSourceLookup: CompiledAgentBrowserNetworkSourceLookup;
-	})
-	| (ResolvedAgentBrowserValidInputBase & {
-		compiledGeneratedBatch: CompiledAgentBrowserQaPreset;
-		compiledJob: CompiledAgentBrowserQaPreset;
-		compiledQaPreset: CompiledAgentBrowserQaPreset;
-		kind: "qa";
-		redactedCompiledJob: CompiledAgentBrowserJob;
-		redactedCompiledQaPreset: CompiledAgentBrowserQaPreset;
-	})
-	| (ResolvedAgentBrowserValidInputBase & {
-		compiledSemanticAction: CompiledAgentBrowserSemanticAction;
-		kind: "semanticAction";
-		redactedCompiledSemanticAction: CompiledAgentBrowserSemanticAction;
-	})
-	| (ResolvedAgentBrowserValidInputBase & {
-		compiledGeneratedBatch: CompiledAgentBrowserSourceLookup;
-		compiledSourceLookup: CompiledAgentBrowserSourceLookup;
-		kind: "sourceLookup";
-		redactedCompiledSourceLookup: CompiledAgentBrowserSourceLookup;
-	});
-
-export type ResolvedAgentBrowserInput = ResolvedAgentBrowserInvalidInput | ResolvedAgentBrowserValidInput;
-
-function redactCompiledElectron(compiled: CompiledAgentBrowserElectron | undefined): CompiledAgentBrowserElectron | undefined {
-	if (!compiled) return undefined;
-	if (compiled.action === "list") {
-		return { ...compiled, query: compiled.query ? redactSensitiveText(compiled.query) : undefined };
-	}
-	if (compiled.action === "launch") {
-		return { ...compiled, appArgs: compiled.appArgs ? redactInvocationArgs(compiled.appArgs) : undefined };
-	}
-	return { ...compiled };
-}
-
-function redactCompiledJob(compiled: CompiledAgentBrowserJob | undefined): CompiledAgentBrowserJob | undefined {
-	const redactedSteps = compiled?.steps.map((step) => ({ ...step, args: redactInvocationArgs(step.args) }));
-	return compiled && redactedSteps
-		? { ...compiled, stdin: JSON.stringify(redactedSteps.map((step) => step.args)), steps: redactedSteps }
-		: undefined;
-}
-
-function redactCompiledSourceLookup(compiled: CompiledAgentBrowserSourceLookup | undefined): CompiledAgentBrowserSourceLookup | undefined {
-	const redactedSteps = compiled?.steps.map((step) => ({ ...step, args: redactInvocationArgs(step.args) }));
-	return compiled && redactedSteps
-		? { ...compiled, stdin: JSON.stringify(redactedSteps.map((step) => step.args)), steps: redactedSteps }
-		: undefined;
-}
-
-function redactCompiledNetworkSourceLookup(compiled: CompiledAgentBrowserNetworkSourceLookup | undefined): CompiledAgentBrowserNetworkSourceLookup | undefined {
-	const redactedSteps = compiled?.steps.map((step) => ({ ...step, args: redactNetworkSourceLookupArgs(step.args) }));
-	return compiled && redactedSteps
-		? {
-			...compiled,
-			args: redactNetworkSourceLookupArgs(compiled.args),
-			query: {
-				...compiled.query,
-				filter: redactNetworkSourceLookupUrl(compiled.query.filter),
-				url: redactNetworkSourceLookupUrl(compiled.query.url),
-			},
-			stdin: JSON.stringify(redactedSteps.map((step) => step.args)),
-			steps: redactedSteps,
-		}
-		: undefined;
-}
-
-function normalizeExplicitEvalStdinArgs(args: string[], stdin: string | undefined): { args: string[]; stdin?: string } {
-	if (stdin !== undefined) {
-		return { args, stdin };
-	}
-
-	const descriptor = parseArgvDescriptor(args);
-	if (descriptor.commandInfo.command !== "eval") {
-		return { args, stdin };
-	}
-
-	const stdinIndex = descriptor.commandTokens.indexOf("--stdin");
-	if (stdinIndex < 0 || stdinIndex >= descriptor.commandTokens.length - 1) {
-		return { args, stdin };
-	}
-
-	const commandStartIndex = args.length - descriptor.commandTokens.length;
-	const stdinValue = descriptor.commandTokens.slice(stdinIndex + 1).join(" ");
-	return {
-		args: [...args.slice(0, commandStartIndex), ...descriptor.commandTokens.slice(0, stdinIndex + 1)],
-		stdin: stdinValue,
-	};
-}
-
-export function resolveAgentBrowserInput(options: {
-	getBatchPreflightValidationError: (args: string[], stdin: string | undefined) => string | undefined;
-	managedSessionActive: boolean;
-	params: AgentBrowserExecuteParams;
-}): ResolvedAgentBrowserInput {
-	const { getBatchPreflightValidationError, managedSessionActive, params } = options;
-	const semanticActionResult = params.semanticAction === undefined ? {} : compileAgentBrowserSemanticAction(params.semanticAction);
-	const jobResult = params.job === undefined ? {} : compileAgentBrowserJob(params.job);
-	const qaResult = params.qa === undefined ? {} : compileAgentBrowserQaPreset(params.qa);
-	const sourceLookupResult = params.sourceLookup === undefined ? {} : compileAgentBrowserSourceLookup(params.sourceLookup);
-	const networkSourceLookupResult = params.networkSourceLookup === undefined ? {} : compileAgentBrowserNetworkSourceLookup(params.networkSourceLookup);
-	const electronResult = params.electron === undefined ? {} : compileAgentBrowserElectron(params.electron);
-
-	const hasExplicitArgs = Array.isArray(params.args);
-	const explicitInputModes = [
-		hasExplicitArgs,
-		Boolean(semanticActionResult.compiled),
-		Boolean(jobResult.compiled),
-		Boolean(qaResult.compiled),
-		Boolean(sourceLookupResult.compiled),
-		Boolean(networkSourceLookupResult.compiled),
-		Boolean(electronResult.compiled),
-	].filter(Boolean).length;
-	const inputModeError = explicitInputModes !== 1
-		? "Provide exactly one of args, semanticAction, job, qa, sourceLookup, networkSourceLookup, or electron."
-		: undefined;
-
-	const compiledSemanticAction = semanticActionResult.compiled;
-	const compiledQaPreset = qaResult.compiled;
-	const compiledSourceLookup = sourceLookupResult.compiled;
-	const compiledNetworkSourceLookup = networkSourceLookupResult.compiled;
-	const compiledElectron = electronResult.compiled;
-	const compiledJob = jobResult.compiled ?? compiledQaPreset;
-	const compiledGeneratedBatch = compiledNetworkSourceLookup ?? compiledSourceLookup ?? compiledJob;
-	const normalizedExplicitArgs = normalizeExplicitEvalStdinArgs(params.args ?? [], params.stdin);
-	const toolArgs = compiledElectron ? [] : compiledSemanticAction?.args ?? compiledGeneratedBatch?.args ?? normalizedExplicitArgs.args;
-	const toolStdin = compiledGeneratedBatch?.stdin ?? normalizedExplicitArgs.stdin;
-	const redactedArgs = redactInvocationArgs(toolArgs);
-	const generatedStdinError = params.stdin !== undefined
-		? compiledGeneratedBatch
-			? "Do not provide stdin with job, qa, sourceLookup, or networkSourceLookup; those modes generate their own batch stdin."
-			: compiledElectron
-				? "Do not provide stdin with electron; electron mode is host-only or manages its own input."
-				: undefined
-		: undefined;
-	const outputPathError = params.outputPath !== undefined && (typeof params.outputPath !== "string" || params.outputPath.trim().length === 0)
-		? "outputPath must be a non-empty string when provided."
-		: undefined;
-	const timeoutMsError = params.timeoutMs !== undefined && (typeof params.timeoutMs !== "number" || !Number.isSafeInteger(params.timeoutMs) || params.timeoutMs <= 0)
-		? "timeoutMs must be a positive integer when provided."
-		: compiledElectron && params.timeoutMs !== undefined
-			? "Use electron.timeoutMs for electron actions; top-level timeoutMs applies only to browser CLI subprocess calls."
-			: undefined;
-	const attachedQaSessionError = compiledQaPreset?.checks.attached
-		? params.sessionMode === "fresh"
-			? "qa.attached cannot be used with sessionMode=fresh; attach or launch a session first, then run qa.attached with the current session."
-			: !managedSessionActive
-				? "qa.attached requires an active attached session. Run electron.launch or connect to an Electron debug port first."
-				: undefined
-		: undefined;
-	const validationError = semanticActionResult.error
-		?? jobResult.error
-		?? qaResult.error
-		?? sourceLookupResult.error
-		?? networkSourceLookupResult.error
-		?? electronResult.error
-		?? inputModeError
-		?? generatedStdinError
-		?? outputPathError
-		?? timeoutMsError
-		?? attachedQaSessionError
-		?? (compiledElectron ? undefined : validateToolArgs(toolArgs) ?? getBatchPreflightValidationError(toolArgs, toolStdin));
-	const redactedCompiledJob = redactCompiledJob(compiledJob);
-	const redactedCompiledSemanticAction = compiledSemanticAction
-		? { ...compiledSemanticAction, args: redactInvocationArgs(compiledSemanticAction.args) }
-		: undefined;
-	const attemptedKind: ResolvedAgentBrowserInputKind | undefined = compiledElectron
-		? "electron"
-		: compiledNetworkSourceLookup
-			? "networkSourceLookup"
-			: compiledSourceLookup
-				? "sourceLookup"
-				: compiledQaPreset
-					? "qa"
-					: jobResult.compiled
-						? "job"
-						: compiledSemanticAction
-							? "semanticAction"
-							: hasExplicitArgs
-								? "args"
-								: undefined;
-
-	const redactedCompiledElectron = redactCompiledElectron(compiledElectron);
-	const redactedCompiledNetworkSourceLookup = redactCompiledNetworkSourceLookup(compiledNetworkSourceLookup);
-	const redactedCompiledQaPreset = compiledQaPreset && redactedCompiledJob ? { ...redactedCompiledJob, checks: compiledQaPreset.checks } : undefined;
-	const redactedCompiledSourceLookup = redactCompiledSourceLookup(compiledSourceLookup);
-	const resolvedBase: ResolvedAgentBrowserInputBase = { redactedArgs, toolArgs, toolStdin };
-	if (validationError) {
-		return {
-			...resolvedBase,
-			attemptedKind,
-			compiledElectron,
-			compiledGeneratedBatch,
-			compiledJob,
-			compiledNetworkSourceLookup,
-			compiledQaPreset,
-			compiledSemanticAction,
-			compiledSourceLookup,
-			kind: "invalid",
-			redactedCompiledElectron,
-			redactedCompiledJob,
-			redactedCompiledNetworkSourceLookup,
-			redactedCompiledQaPreset,
-			redactedCompiledSemanticAction,
-			redactedCompiledSourceLookup,
-			status: "invalid",
-			validationError,
-		};
-	}
-	if (compiledElectron && redactedCompiledElectron) {
-		return { ...resolvedBase, compiledElectron, kind: "electron", redactedCompiledElectron, status: "valid" };
-	}
-	if (compiledNetworkSourceLookup && redactedCompiledNetworkSourceLookup) {
-		return {
-			...resolvedBase,
-			compiledGeneratedBatch: compiledNetworkSourceLookup,
-			compiledNetworkSourceLookup,
-			kind: "networkSourceLookup",
-			redactedCompiledNetworkSourceLookup,
-			status: "valid",
-		};
-	}
-	if (compiledSourceLookup && redactedCompiledSourceLookup) {
-		return {
-			...resolvedBase,
-			compiledGeneratedBatch: compiledSourceLookup,
-			compiledSourceLookup,
-			kind: "sourceLookup",
-			redactedCompiledSourceLookup,
-			status: "valid",
-		};
-	}
-	if (compiledQaPreset && redactedCompiledJob && redactedCompiledQaPreset) {
-		return {
-			...resolvedBase,
-			compiledGeneratedBatch: compiledQaPreset,
-			compiledJob: compiledQaPreset,
-			compiledQaPreset,
-			kind: "qa",
-			redactedCompiledJob,
-			redactedCompiledQaPreset,
-			status: "valid",
-		};
-	}
-	if (jobResult.compiled && redactedCompiledJob) {
-		return {
-			...resolvedBase,
-			compiledGeneratedBatch: jobResult.compiled,
-			compiledJob: jobResult.compiled,
-			kind: "job",
-			redactedCompiledJob,
-			status: "valid",
-		};
-	}
-	if (compiledSemanticAction && redactedCompiledSemanticAction) {
-		return { ...resolvedBase, compiledSemanticAction, kind: "semanticAction", redactedCompiledSemanticAction, status: "valid" };
-	}
-	return { ...resolvedBase, kind: "args", status: "valid" };
-}
-
-export function buildValidationFailureResult(input: ResolvedAgentBrowserInvalidInput): {
-	content: Array<{ text: string; type: "text" }>;
-	details: Record<string, unknown>;
-	isError: true;
-} {
-	const validationError = input.validationError ?? "Invalid agent_browser input.";
-	return {
-		content: [{ type: "text", text: validationError }],
-		details: {
-			args: input.redactedArgs,
-			compiledElectron: input.redactedCompiledElectron,
-			compiledJob: input.redactedCompiledJob,
-			compiledQaPreset: input.redactedCompiledQaPreset,
-			compiledSourceLookup: input.redactedCompiledSourceLookup,
-			compiledNetworkSourceLookup: input.redactedCompiledNetworkSourceLookup,
-			compiledSemanticAction: input.redactedCompiledSemanticAction,
-			...buildAgentBrowserResultCategoryDetails({
-				args: input.redactedArgs,
-				errorText: validationError,
-				succeeded: false,
-				validationError,
-			}),
-			validationError,
-		},
-		isError: true,
-	};
-}

package/extensions/agent-browser/lib/orchestration/output-file.ts

@@ -1,86 +0,0 @@
-import { mkdir, writeFile } from "node:fs/promises";
-import { dirname, isAbsolute, resolve } from "node:path";
-
-import { isRecord } from "../parsing.js";
-import type { AgentBrowserToolResult } from "./browser-run/types.js";
-
-export interface AgentBrowserOutputFileDetails {
-	absolutePath: string;
-	bytes?: number;
-	error?: string;
-	path: string;
-	source: "content.text" | "details.data";
-	status: "failed" | "saved";
-}
-
-function normalizeRequestedOutputPath(path: string): string {
-	return path.startsWith("@") ? path.slice(1) : path;
-}
-
-function getTextContent(result: AgentBrowserToolResult): string {
-	return result.content
-		?.filter((item): item is { text: string; type: "text" } => item.type === "text")
-		.map((item) => item.text)
-		.join("\n\n") ?? "";
-}
-
-function getOutputPayload(result: AgentBrowserToolResult): { source: AgentBrowserOutputFileDetails["source"]; value: unknown } {
-	const details = isRecord(result.details) ? result.details : undefined;
-	if (details && details.data !== undefined) return { source: "details.data", value: details.data };
-	return { source: "content.text", value: getTextContent(result) };
-}
-
-function serializeOutputPayload(value: unknown): string {
-	return typeof value === "string" ? value : `${JSON.stringify(value, null, 2)}\n`;
-}
-
-function appendOutputFileNotice(result: AgentBrowserToolResult, message: string): AgentBrowserToolResult["content"] {
-	const content = [...(result.content ?? [])] as AgentBrowserToolResult["content"];
-	if (content[0]?.type === "text") {
-		content[0] = { ...content[0], text: `${content[0].text}\n\n${message}` };
-		return content;
-	}
-	return [{ type: "text", text: message }, ...content];
-}
-
-export async function applyAgentBrowserOutputPath(options: {
-	cwd: string;
-	outputPath?: string;
-	preserveTextContent?: boolean;
-	result: AgentBrowserToolResult;
-}): Promise<AgentBrowserToolResult> {
-	if (!options.outputPath) return options.result;
-	if (options.result.isError || (isRecord(options.result.details) && options.result.details.resultCategory === "failure")) return options.result;
-	const requestedPath = normalizeRequestedOutputPath(options.outputPath);
-	const absolutePath = isAbsolute(requestedPath) ? requestedPath : resolve(options.cwd, requestedPath);
-	const payload = getOutputPayload(options.result);
-	try {
-		const serialized = serializeOutputPayload(payload.value);
-		await mkdir(dirname(absolutePath), { recursive: true });
-		await writeFile(absolutePath, serialized, "utf8");
-		const bytes = Buffer.byteLength(serialized, "utf8");
-		const outputFile: AgentBrowserOutputFileDetails = { absolutePath, bytes, path: requestedPath, source: payload.source, status: "saved" };
-		const details = isRecord(options.result.details) ? { ...options.result.details, outputFile } : { outputFile };
-		return {
-			...options.result,
-			content: options.preserveTextContent ? options.result.content : appendOutputFileNotice(options.result, `Output file: ${requestedPath} (${bytes} bytes from ${payload.source}).`),
-			details,
-		};
-	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		const outputFile: AgentBrowserOutputFileDetails = { absolutePath, error: message, path: requestedPath, source: payload.source, status: "failed" };
-		const details = isRecord(options.result.details)
-			? (() => {
-				const rest = { ...options.result.details };
-				delete rest.successCategory;
-				return { ...rest, failureCategory: rest.failureCategory ?? "upstream-error", outputFile, resultCategory: "failure" };
-			})()
-			: { failureCategory: "upstream-error", outputFile, resultCategory: "failure" };
-		return {
-			...options.result,
-			content: options.preserveTextContent ? options.result.content : appendOutputFileNotice(options.result, `Output file failed: ${requestedPath} (${message}).`),
-			details,
-			isError: true,
-		};
-	}
-}