import { createServer, type Server } from 'node:http' import type { AddressInfo } from 'node:net' import type { ElectronApplication, Page } from '@stablyai/playwright-test' import { expect, test } from './helpers/orca-app' import { launchHeadlessPairedRuntimeHost } from './helpers/headless-paired-runtime-host' import { launchPairedElectronClient, type PairedElectronClient } from './helpers/paired-electron-client' import { collectCleanupFailures, launchPackagedPairedClient, packagedExecutable, packagedExecutableMissing, PACKAGED_EXECUTABLE_ENV, type PackagedPairedClient } from './helpers/packaged-old-orca' const CLIENT_HOST_CAPABILITY = 'browser.clientHost.v1' const TUNNEL_CAPABILITY = 'network.browserTunnel.v1' type BrowserFixture = { close(): Promise url: string } type BrowserCreateResult = { browserPageId: string } type PackagedPlacementCleanup = () => Promise | void async function withPackagedPlacementCleanup( run: (registerCleanup: (cleanup: PackagedPlacementCleanup) => void) => Promise ): Promise { const cleanups: PackagedPlacementCleanup[] = [] let testError: unknown try { await run((cleanup) => cleanups.unshift(cleanup)) } catch (error) { testError = error } const cleanupErrors = await collectCleanupFailures(cleanups) if (testError !== undefined && cleanupErrors.length > 0) { throw new AggregateError([testError, ...cleanupErrors], 'Placement test and cleanup failed') } if (testError !== undefined) { throw testError } if (cleanupErrors.length > 0) { throw new AggregateError(cleanupErrors, 'Packaged placement cleanup failed') } } async function closeServer(server: Server): Promise { await new Promise((resolve, reject) => { server.closeAllConnections() server.close((error) => (error ? reject(error) : resolve())) }) } async function startBrowserFixture(): Promise { const server = createServer((_request, response) => { response.writeHead(200, { 'cache-control': 'no-store', 'content-type': 'text/html; charset=utf-8' }) response.end( '

packaged-skew-marker

' ) }) await new Promise((resolve, reject) => { server.once('error', reject) server.listen(0, '127.0.0.1', () => { server.off('error', reject) resolve() }) }) return { close: () => closeServer(server), url: `http://127.0.0.1:${(server.address() as AddressInfo).port}/browser` } } async function readOwnedPageUrls(app: ElectronApplication, url: string): Promise { return app.evaluate( ({ webContents }, prefix) => webContents .getAllWebContents() .map((contents) => contents.getURL()) .filter((candidate) => candidate.startsWith(prefix)), url ) } async function createBrowserThroughPackagedClient(args: { client: PackagedPairedClient url: string worktreePath: string }): Promise { return args.client.page.evaluate( async ({ environmentId, url, worktreePath }) => { const response = await window.api.runtimeEnvironments.call({ selector: environmentId, method: 'browser.tabCreate', params: { activate: true, url, waitForRegistration: true, worktree: `path:${worktreePath}` }, timeoutMs: 60_000 }) if (!response.ok) { throw new Error(`${response.error.code}: ${response.error.message}`) } return response.result as BrowserCreateResult }, { environmentId: args.client.environmentId, url: args.url, worktreePath: args.worktreePath } ) } async function readRemoteSnapshot(args: { environmentId: string page: Page pageId: string worktreePath: string }): Promise { return args.page.evaluate( async ({ environmentId, pageId, worktreePath }) => { const response = await window.api.runtimeEnvironments.call({ selector: environmentId, method: 'browser.snapshot', params: { page: pageId, worktree: `path:${worktreePath}` }, timeoutMs: 30_000 }) if (!response.ok) { throw new Error(`${response.error.code}: ${response.error.message}`) } return (response.result as { snapshot: string }).snapshot }, { environmentId: args.environmentId, pageId: args.pageId, worktreePath: args.worktreePath } ) } async function findPairedWorktreeId(page: Page, repoPath: string): Promise { await expect .poll( () => page.evaluate( (candidatePath) => window.__store ?.getState() .allWorktrees() .find((worktree) => worktree.path === candidatePath)?.id ?? null, repoPath ), { timeout: 60_000 } ) .not.toBeNull() const worktreeId = await page.evaluate( (candidatePath) => window.__store ?.getState() .allWorktrees() .find((worktree) => worktree.path === candidatePath)?.id ?? null, repoPath ) if (!worktreeId) { throw new Error('Paired worktree disappeared after discovery') } return worktreeId } async function createBrowserThroughCurrentClient(args: { client: PairedElectronClient url: string worktreeId: string }): Promise<{ localPageId: string; remotePageId: string }> { await args.client.page.evaluate( async ({ environmentId, url, worktreeId }) => { const state = window.__store?.getState() if (!state) { throw new Error('Current client store is unavailable') } state.setActiveWorktree(worktreeId, `runtime:${environmentId}`) const groupId = state.activeGroupIdByWorktree[worktreeId] if (!groupId) { throw new Error('Current client has no active tab group') } state.setBrowserDefaultUrl(url) await state.openNewBrowserTabInActiveWorkspace(groupId) }, { environmentId: args.client.environmentId, url: args.url, worktreeId: args.worktreeId } ) await expect .poll( () => args.client.page.evaluate( ({ url, worktreeId }) => { const state = window.__store?.getState() for (const workspace of state?.browserTabsByWorktree[worktreeId] ?? []) { for (const browserPage of state?.browserPagesByWorkspace[workspace.id] ?? []) { if (!browserPage.url.startsWith(url)) { continue } const handle = state?.remoteBrowserPageHandlesByPageId[browserPage.id] return { localPageId: browserPage.id, placementKind: handle?.placement?.kind ?? null, remotePageId: handle?.remotePageId ?? browserPage.id } } } return null }, { url: args.url, worktreeId: args.worktreeId } ), { timeout: 60_000 } ) .toMatchObject({ placementKind: null }) const mirrored = await args.client.page.evaluate( ({ url, worktreeId }) => { const state = window.__store?.getState() for (const workspace of state?.browserTabsByWorktree[worktreeId] ?? []) { for (const browserPage of state?.browserPagesByWorkspace[workspace.id] ?? []) { if (browserPage.url.startsWith(url)) { const handle = state?.remoteBrowserPageHandlesByPageId[browserPage.id] return { localPageId: browserPage.id, remotePageId: handle?.remotePageId ?? browserPage.id } } } } return null }, { url: args.url, worktreeId: args.worktreeId } ) if (!mirrored) { throw new Error('Server-hosted browser page disappeared after materialization') } return mirrored } test.describe('packaged mixed-version browser placement', () => { test.skip( packagedExecutableMissing, `${PACKAGED_EXECUTABLE_ENV} must point at an older packaged Orca executable` ) test('keeps an old packaged client on the current server-hosted path', async ({ testRepoPath }, testInfo) => { test.setTimeout(300_000) await withPackagedPlacementCleanup(async (registerCleanup) => { const host = await launchHeadlessPairedRuntimeHost() registerCleanup(() => host.dispose()) const fixture = await startBrowserFixture() registerCleanup(() => fixture.close()) await host.client.call('repo.add', { path: testRepoPath, kind: 'git' }) const client = await launchPackagedPairedClient({ executablePath: packagedExecutable!, offer: host.offer, testInfo, name: 'STA-4150 packaged old client' }) registerCleanup(() => client.dispose()) expect(client.status.capabilities).not.toContain(CLIENT_HOST_CAPABILITY) expect(client.status.capabilities).not.toContain(TUNNEL_CAPABILITY) const created = await createBrowserThroughPackagedClient({ client, url: fixture.url, worktreePath: testRepoPath }) await expect.poll(() => readOwnedPageUrls(host.app, fixture.url)).toHaveLength(1) expect(await readOwnedPageUrls(client.app, fixture.url)).toHaveLength(0) expect( await readRemoteSnapshot({ environmentId: client.environmentId, page: client.page, pageId: created.browserPageId, worktreePath: testRepoPath }) ).toContain('packaged-skew-marker') expect(client.version).toMatch(/^1\./) }) }) test('keeps a current client on an old packaged server-hosted path', async ({ testRepoPath }, testInfo) => { test.setTimeout(300_000) await withPackagedPlacementCleanup(async (registerCleanup) => { const host = await launchHeadlessPairedRuntimeHost({ executablePath: packagedExecutable!, // Why: the old macOS helper has a 103-byte Unix socket ceiling. ...(process.platform === 'darwin' ? { agentBrowserSocketParent: '/tmp', userDataParent: '/tmp' } : {}) }) registerCleanup(() => host.dispose()) const fixture = await startBrowserFixture() registerCleanup(() => fixture.close()) await host.client.call('repo.add', { path: testRepoPath, kind: 'git' }) await host.client.call('terminal.create', { worktree: `path:${testRepoPath}`, title: 'Packaged mixed-version browser canary' }) const client: PairedElectronClient = await launchPairedElectronClient( host.offer, testInfo, 'STA-4150 current client to packaged old host' ) registerCleanup(() => client.dispose()) const status = await client.page.evaluate(async (environmentId) => { const response = await window.api.runtimeEnvironments.getStatus({ selector: environmentId, timeoutMs: 30_000 }) if (!response.ok) { throw new Error(`${response.error.code}: ${response.error.message}`) } return response.result }, client.environmentId) expect(status.capabilities).not.toContain(CLIENT_HOST_CAPABILITY) expect(status.capabilities).not.toContain(TUNNEL_CAPABILITY) const worktreeId = await findPairedWorktreeId(client.page, testRepoPath) const created = await createBrowserThroughCurrentClient({ client, url: fixture.url, worktreeId }) await client.page.evaluate( ({ localPageId, worktreeId }) => window.__store?.getState().focusBrowserTabInWorktree(worktreeId, localPageId, { surfacePane: true }), { localPageId: created.localPageId, worktreeId } ) await expect(client.page.getByTestId('remote-browser-frame').first()).toBeVisible({ timeout: 60_000 }) await expect.poll(() => readOwnedPageUrls(host.app, fixture.url)).toHaveLength(1) expect(await readOwnedPageUrls(client.app, fixture.url)).toHaveLength(0) expect( await readRemoteSnapshot({ environmentId: client.environmentId, page: client.page, pageId: created.remotePageId, worktreePath: testRepoPath }) ).toContain('packaged-skew-marker') }) }) })