autokap 1.3.7 → 1.3.8

package/dist/browser.js

@@ -810,23 +810,45 @@ export class Browser {
         const instance = new Browser(options);
         const deviceScaleFactor = normalizeDeviceScaleFactor(options.deviceScaleFactor);
         // Enable GPU compositor on non-Linux platforms so Chrome can render
-        // 2880×1800 without saturating the CPU. Linux (Docker/CI) keeps
-        // `--disable-gpu` from CHROMIUM_ARGS because GPU is rarely available there.
-        const baseArgs = process.platform === 'linux'
-            ? CHROMIUM_ARGS
-            : CHROMIUM_ARGS.filter(arg => arg !== '--disable-gpu' && arg !== '--disable-gpu-sandbox');
-        // Pin ANGLE to the platform's native graphics API. Chrome's default
+        // 2880×1800 without saturating the CPU. Linux cloud runners get
+        // SwiftShader (multi-threaded software ANGLE) instead of `--disable-gpu`
+        // because the default CPU rasterizer caps CDP screenshots at ~165 ms each
+        // → 6 fps clips on heavy React pages. SwiftShader's JIT'd SIMD raster
+        // paths use Fly's 8 vCPUs properly (measured: ~5× faster compositor).
+        // Non-cloud Linux (GitHub Actions free runners, 2 vCPU) stays on the
+        // legacy CPU path — SwiftShader has thread-pool overhead that hurts on
+        // tight CI machines.
+        const isCloudRunner = process.env.AUTOKAP_CLOUD_RUNNER === '1';
+        const isLinuxCloud = process.platform === 'linux' && isCloudRunner;
+        const baseArgs = isLinuxCloud || process.platform !== 'linux'
+            ? CHROMIUM_ARGS.filter(arg => arg !== '--disable-gpu' && arg !== '--disable-gpu-sandbox')
+            : CHROMIUM_ARGS;
+        // Pin ANGLE to the platform's fast graphics backend. Chrome's default
         // backend is OpenGL on macOS, which is far slower than Metal for the
         // compositor (measured 4 FPS vs 32 FPS at 2880×1800 on a heavy React UI).
-        // Same story on Windows where D3D11 is the native fast path.
+        // Same story on Windows where D3D11 is the native fast path. On Linux
+        // cloud, SwiftShader is the multi-threaded software backend.
         const angleArg = process.platform === 'darwin' ? '--use-angle=metal'
             : process.platform === 'win32' ? '--use-angle=d3d11'
-                : null; // Linux: skip — GPU is rarely present in CI anyway
+                : isLinuxCloud ? '--use-angle=swiftshader'
+                    : null;
+        // Cloud-Linux extras: route GL through ANGLE, opt in to SwiftShader
+        // explicitly (Chromium 124+ requires `--enable-unsafe-swiftshader` since
+        // SwiftShader was tagged unsafe for general WebGL — for our headless
+        // captures the security caveat is irrelevant), and bypass the GPU
+        // blocklist that otherwise refuses any GPU path on unrecognized headless
+        // hardware.
+        const linuxCloudGpuArgs = isLinuxCloud ? [
+            '--use-gl=angle',
+            '--enable-unsafe-swiftshader',
+            '--ignore-gpu-blocklist',
+        ] : [];
         const clipArgs = [
             ...baseArgs,
             `--force-device-scale-factor=${deviceScaleFactor}`,
             `--window-size=${Math.round(options.viewport.width)},${Math.round(options.viewport.height)}`,
             ...(angleArg ? [angleArg] : []),
+            ...linuxCloudGpuArgs,
         ];
         // Dedicated browser process for clip capture. Not pooled because clip
         // capture installs context-level init scripts (cursor overlay).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autokap",
-  "version": "1.3.7",
+  "version": "1.3.8",
   "description": "AI-powered CLI tool for capturing clean screenshots of websites",
   "type": "module",
   "main": "./dist/index.js",