@pasko70/pibo 1.0.1 → 1.0.3

package/dist/tools/linux-virtual-display.js

@@ -0,0 +1,58 @@
+import { existsSync } from 'node:fs';
+import { writeFile } from 'node:fs/promises';
+import { detectDesktopEnv, hasDesktopDisplay, printLinuxVirtualDisplayHint } from './desktop-env.js';
+export const PIBO_XVFB_SERVICE_NAME = 'pibo-xvfb.service';
+export const PIBO_XVFB_SERVICE_PATH = `/etc/systemd/system/${PIBO_XVFB_SERVICE_NAME}`;
+export function createPiboXvfbServiceUnit() {
+    return [
+        '[Unit]',
+        'Description=Virtual X display for Pibo browser automation',
+        'After=network.target',
+        '',
+        '[Service]',
+        'Type=simple',
+        'ExecStart=/usr/bin/Xvfb :0 -screen 0 1920x1080x24 -ac -nolisten tcp',
+        'Restart=always',
+        'RestartSec=2',
+        '',
+        '[Install]',
+        'WantedBy=multi-user.target',
+        '',
+    ].join('\n');
+}
+function isRootUser() {
+    return typeof process.getuid === 'function' && process.getuid() === 0;
+}
+async function waitForDisplaySocket(timeoutMs = 5000) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (existsSync('/tmp/.X11-unix/X0'))
+            return true;
+        await new Promise((resolve) => setTimeout(resolve, 100));
+    }
+    return existsSync('/tmp/.X11-unix/X0');
+}
+export async function ensureLinuxVirtualDisplay(options) {
+    if (process.platform !== 'linux')
+        return false;
+    if (hasDesktopDisplay(detectDesktopEnv()))
+        return false;
+    if (!isRootUser()) {
+        console.log('No desktop display detected and automatic virtual display setup requires root.');
+        printLinuxVirtualDisplayHint('  ');
+        return false;
+    }
+    console.log('No desktop display detected. Provisioning virtual X display for browser-use.');
+    await options.runInherited('apt-get', ['update']);
+    await options.runInherited('apt-get', ['install', '-y', 'xvfb', 'xauth', 'x11-xserver-utils']);
+    await writeFile(PIBO_XVFB_SERVICE_PATH, createPiboXvfbServiceUnit(), 'utf8');
+    await options.runInherited('systemctl', ['daemon-reload']);
+    await options.runInherited('systemctl', ['enable', '--now', PIBO_XVFB_SERVICE_NAME]);
+    process.env.DISPLAY = ':0';
+    const ready = await waitForDisplaySocket();
+    if (!ready) {
+        throw new Error('Virtual X display service was installed but DISPLAY :0 did not become ready.');
+    }
+    console.log('Virtual X display ready on DISPLAY=:0');
+    return true;
+}

package/dist/tools/python-runtime.js

@@ -49,7 +49,32 @@ function runBuffered(command, args, env = process.env) {
         });
     });
 }
-function runInherited(command, args, env = process.env) {
+function isRootUser() {
+    return typeof process.getuid === 'function' && process.getuid() === 0;
+}
+async function resolveUvCommand() {
+    const uv = await runBuffered('uv', ['--version']);
+    if (uv.ok)
+        return 'uv';
+    const localUv = join(homedir(), '.local', 'bin', 'uv');
+    if (existsSync(localUv)) {
+        const local = await runBuffered(localUv, ['--version']);
+        if (local.ok)
+            return localUv;
+    }
+    if (process.platform === 'linux' && isRootUser()) {
+        console.log('uv was not found on PATH. Installing uv automatically.');
+        await runInheritedCommand('sh', ['-c', 'curl -LsSf https://astral.sh/uv/install.sh | sh']);
+        const installed = await runBuffered(localUv, ['--version'], {
+            ...process.env,
+            PATH: `${join(homedir(), '.local', 'bin')}:${process.env.PATH ?? ''}`,
+        });
+        if (installed.ok)
+            return localUv;
+    }
+    return undefined;
+}
+export function runInheritedCommand(command, args, env = process.env) {
     return new Promise((resolve, reject) => {
         console.log(`Running: ${command} ${args.join(' ')}`);
         const child = spawn(command, args, {
@@ -82,9 +107,10 @@ function runInherited(command, args, env = process.env) {
 }
 export async function printToolPythonRuntimeDoctor(name, spec) {
     const paths = getToolPythonRuntimePaths(name, spec);
-    const uv = await runBuffered('uv', ['--version']);
+    const uvCommand = await resolveUvCommand();
+    const uv = uvCommand ? await runBuffered(uvCommand, ['--version']) : { ok: false, output: 'missing' };
     const python = uv.ok
-        ? await runBuffered('uv', ['python', 'find', spec.pythonVersion])
+        ? await runBuffered(uvCommand, ['python', 'find', spec.pythonVersion])
         : { ok: false, output: 'skipped because uv is missing' };
     console.log(`${name}`);
     console.log(`  uv: ${uv.ok ? uv.output || 'ok' : `missing (${uv.output})`}`);
@@ -122,13 +148,13 @@ export async function printToolPythonRuntimeDoctor(name, spec) {
     }
 }
 export async function installToolPythonRuntime(name, spec) {
-    const uv = await runBuffered('uv', ['--version']);
-    if (!uv.ok) {
+    const uvCommand = await resolveUvCommand();
+    if (!uvCommand) {
         throw new Error(formatCliError({
             code: ErrorCode.CLIENT_ERROR,
             type: 'CLI_TOOL_UV_MISSING',
             message: 'uv was not found on PATH',
-            details: uv.output,
+            details: 'spawn uv ENOENT',
             suggestion: 'Install uv first. macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh. Windows PowerShell: irm https://astral.sh/uv/install.ps1 | iex.',
         }));
     }
@@ -136,9 +162,9 @@ export async function installToolPythonRuntime(name, spec) {
     await mkdir(paths.rootDir, { recursive: true });
     await mkdir(paths.homeDir, { recursive: true });
     if (!existsSync(paths.venvDir)) {
-        await runInherited('uv', ['venv', paths.venvDir, '--python', spec.pythonVersion]);
+        await runInheritedCommand(uvCommand, ['venv', paths.venvDir, '--python', spec.pythonVersion]);
     }
-    await runInherited('uv', [
+    await runInheritedCommand(uvCommand, [
         'pip',
         'install',
         '--python',
@@ -146,7 +172,7 @@ export async function installToolPythonRuntime(name, spec) {
         spec.packageName,
     ]);
     if (spec.postInstallArgs?.length) {
-        await runInherited(paths.executablePath, spec.postInstallArgs, getToolPythonRuntimeEnv(paths, spec));
+        await runInheritedCommand(paths.executablePath, spec.postInstallArgs, getToolPythonRuntimeEnv(paths, spec));
     }
     return paths;
 }

package/dist/tools/registry.js

@@ -1,7 +1,8 @@
 import { existsSync } from 'node:fs';
 import { detectDesktopEnv, hasDesktopDisplay, printDesktopEnvStatus, printLinuxVirtualDisplayHint } from './desktop-env.js';
 import { BROWSER_USE_GUIDE, REMOTE_BROWSER_GUIDE } from './guides.js';
-import { getToolPythonRuntimePaths, installToolPythonRuntime, printToolPythonRuntimeDoctor, removeToolPythonRuntime, } from './python-runtime.js';
+import { ensureLinuxVirtualDisplay } from './linux-virtual-display.js';
+import { getToolPythonRuntimePaths, installToolPythonRuntime, runInheritedCommand, printToolPythonRuntimeDoctor, removeToolPythonRuntime, } from './python-runtime.js';
 const MAX_AGENT_CONTEXT_SNIPPET_LENGTH = 480;
 const INSTALLED_TOOLS_CONTEXT_PATH = '.pibo/context/installed-pibo-tools.md';
 const REGISTRY = [
@@ -90,6 +91,9 @@ export function getInstalledCliToolContextFile() {
 }
 export async function installCliTool(entry, runSetup) {
     if (runSetup) {
+        if (entry.name === 'browser-use') {
+            await ensureLinuxVirtualDisplay({ runInherited: runInheritedCommand });
+        }
         await installToolPythonRuntime(entry.name, entry.runtime);
     }
     const status = getCliToolStatus(entry);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pasko70/pibo",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "type": "module",
   "description": "Minimal TypeScript wrapper around Pi Coding Agent.",
   "files": [