Function openTerminalWindow

site/e2e/helpers.ts:1249–1279

(
	page: Page,
	context: BrowserContext,
	workspaceName: string,
	agentName = "dev",
)

};

export async function openTerminalWindow(
	page: Page,
	context: BrowserContext,
	workspaceName: string,
	agentName = "dev",
): Promise<Page> {
	// Wait for the web terminal to open in a new tab
	const pagePromise = context.waitForEvent("page");
	await page
		.getByRole("link", { name: /terminal/i })
		.click({ timeout: 60_000 });
	const terminal = await pagePromise;
	await terminal.waitForLoadState("domcontentloaded");

	// Specify that the shell should be `bash`, to prevent inheriting a shell that
	// isn't POSIX compatible, such as Fish.
	const user = currentUser(page);
	const commandQuery = `?command=${encodeURIComponent("/usr/bin/env bash")}`;
	await expectUrl(terminal).toHavePathName(
		`/@${user.username}/${workspaceName}.${agentName}/terminal`,
	);
	await terminal.goto(
		`/@${user.username}/${workspaceName}.${agentName}/terminal${commandQuery}`,
	);

	// The terminal command confirmation dialog requires explicit user
	// approval before the command executes.
	await terminal.getByRole("button", { name: "Run command" }).click();

	return terminal;
}

type UserValues = {
	name: string;