Function getOrLaunchSession

packages/cli/src/utils/browser-manager.ts:83–151

(
	sessionName: string,
	headed = false,
)

}

export async function getOrLaunchSession(
	sessionName: string,
	headed = false,
): Promise<{session: BrowserSession; error?: string}> {
	// Return existing session if alive
	const existing = sessionMap.get(sessionName);
	if (existing) {
		if (existing.page.isClosed()) {
			existing.page = await existing.context.newPage();
		}
		return {session: existing};
	}

	// Look up profile from session config
	const sessionConfig = getSessionConfig(sessionName);
	if (!sessionConfig) {
		return {
			session: undefined as unknown as BrowserSession,
			error: `Session "${sessionName}" is not configured. Run: corebrain browser create-session ${sessionName} --profile <profile>`,
		};
	}

	try {
		const {chromium} = await import('playwright');

		const profileDir = getProfileDir(sessionConfig.profile);
		fs.mkdirSync(profileDir, {recursive: true});

		const browserConfig = getBrowserExecutable();
		const launchOptions: import('playwright').LaunchOptions = {
			headless: !headed,
			args: ['--remote-debugging-port=0'],
		};
		if (browserConfig.type !== 'default' && browserConfig.path) {
			launchOptions.executablePath = browserConfig.path;
		}

		const context = await chromium.launchPersistentContext(profileDir, launchOptions);

		context.on('close', () => {
			sessionMap.delete(sessionName);
		});

		const page = context.pages()[0] ?? (await context.newPage());

		const cdp = await captureCdpEndpoint(profileDir);

		const session: BrowserSession = {
			context,
			page,
			sessionName,
			profile: sessionConfig.profile,
			profileDir,
			headed: false,
			createdAt: Date.now(),
			cdpPort: cdp?.port,
			cdpWsEndpoint: cdp?.wsEndpoint,
			cdpHttpEndpoint: cdp?.httpEndpoint,