Function resolveLinuxSurface

src/platforms/linux/snapshot.ts:12–23

* Map the session-level surface to an AT-SPI2 surface. * Linux supports 'desktop' and 'frontmost-app'. The 'app' surface * (used for in-app XCTest sessions) is treated as 'frontmost-app' on Linux. * The 'menubar' surface is not yet supported; it falls back to 'desktop'.

(surface: SessionSurface | undefined)

 * The 'menubar' surface is not yet supported; it falls back to 'desktop'.
 */
function resolveLinuxSurface(surface: SessionSurface | undefined): SnapshotSurface {
  if (surface === 'desktop') return 'desktop';
  if (surface === 'frontmost-app' || surface === 'app') return 'frontmost-app';
  if (surface === 'menubar') {
    emitDiagnostic({
      level: 'warn',
      phase: 'linux_snapshot',
      data: { message: 'menubar surface is not supported on Linux, falling back to desktop' },
    });
  }
  return 'desktop';
}

export async function snapshotLinux(surface: SessionSurface | undefined): Promise<{
  nodes: RawSnapshotNode[];