pi-agent-browser-native 0.2.47 → 0.2.49

package/extensions/agent-browser/lib/results/next-actions.ts

@@ -1,117 +0,0 @@
-/**
- * Purpose: Own machine-readable agent_browser next-action contracts and merge policy.
- * Responsibilities: Define the stable nextAction shape, build basic argv follow-ups, and provide deterministic action-list collection helpers.
- * Scope: Result follow-up action mechanics only; command-specific recovery and artifact policies live in neighboring modules.
- * Usage: Imported by result presentation helpers and the extension entrypoint when attaching details.nextActions.
- * Invariants/Assumptions: Action ids are stable machine-readable contracts; dedupe preserves first occurrence order.
- */
-
-export interface AgentBrowserNextAction {
-	artifactPath?: string;
-	id: string;
-	params?: {
-		args?: string[];
-		electron?: {
-			action: "cleanup" | "list" | "launch" | "probe" | "status";
-			all?: boolean;
-			handoff?: "connect" | "snapshot" | "tabs";
-			launchId?: string;
-		};
-		networkSourceLookup?: {
-			filter?: string;
-			requestId?: string;
-			session?: string;
-			url?: string;
-		};
-		sessionMode?: "auto" | "fresh";
-		stdin?: string;
-	};
-	reason: string;
-	safety?: string;
-	tool: "agent_browser";
-}
-
-export function withOptionalSessionArgs(sessionName: string | undefined, args: string[]): string[] {
-	return sessionName && args[0] !== "--session" ? ["--session", sessionName, ...args] : args;
-}
-
-export function buildNextToolAction(options: {
-	args: string[];
-	id: string;
-	reason: string;
-	safety?: string;
-	sessionMode?: "auto" | "fresh";
-	stdin?: string;
-}): AgentBrowserNextAction {
-	return {
-		id: options.id,
-		params: {
-			args: options.args,
-			...(options.sessionMode ? { sessionMode: options.sessionMode } : {}),
-			...(options.stdin ? { stdin: options.stdin } : {}),
-		},
-		reason: options.reason,
-		...(options.safety ? { safety: options.safety } : {}),
-		tool: "agent_browser",
-	};
-}
-
-export function appendUniqueAgentBrowserNextActions(
-	target: AgentBrowserNextAction[],
-	additions: AgentBrowserNextAction[] | undefined,
-): AgentBrowserNextAction[] {
-	if (!additions || additions.length === 0) return target;
-	const existingIds = new Set(target.map((action) => action.id));
-	for (const action of additions) {
-		if (existingIds.has(action.id)) continue;
-		target.push(action);
-		existingIds.add(action.id);
-	}
-	return target;
-}
-
-export function isStandaloneSnapshotNextAction(action: AgentBrowserNextAction): boolean {
-	const args = action.params?.args;
-	if (!args || action.params?.stdin) return false;
-	const commandIndex = args[0] === "--session" ? 2 : 0;
-	return args[commandIndex] === "snapshot";
-}
-
-export function alignPageChangeSummaryNextActionIds<T extends { nextActionIds?: string[] }>(
-	summary: T | undefined,
-	nextActions: AgentBrowserNextAction[] | undefined,
-): T | undefined {
-	if (!summary?.nextActionIds || !nextActions) return summary;
-	const nextActionIds = new Set(nextActions.map((action) => action.id));
-	const alignedIds = summary.nextActionIds.filter((id) => nextActionIds.has(id));
-	return alignedIds.length > 0 ? { ...summary, nextActionIds: alignedIds } : { ...summary, nextActionIds: undefined };
-}
-
-export class AgentBrowserNextActionCollector {
-	private actions: AgentBrowserNextAction[];
-
-	constructor(initialActions: AgentBrowserNextAction[] | undefined = undefined) {
-		this.actions = initialActions ? [...initialActions] : [];
-	}
-
-	append(actions: AgentBrowserNextAction[] | undefined): void {
-		if (!actions || actions.length === 0) return;
-		this.actions.push(...actions);
-	}
-
-	appendUnique(actions: AgentBrowserNextAction[] | undefined): void {
-		appendUniqueAgentBrowserNextActions(this.actions, actions);
-	}
-
-	replace(actions: AgentBrowserNextAction[] | undefined): void {
-		this.actions = actions ? [...actions] : [];
-	}
-
-	removeWhere(predicate: (action: AgentBrowserNextAction) => boolean): void {
-		this.actions = this.actions.filter((action) => !predicate(action));
-	}
-
-	toArray(): AgentBrowserNextAction[] | undefined {
-		return this.actions.length > 0 ? [...this.actions] : undefined;
-	}
-}