@pasko70/pibo 1.0.0 → 1.0.2

package/dist/core/profiles.js

@@ -3,6 +3,7 @@ export class InitialSessionContext {
     profileName;
     sessionId;
     parentSessionId;
+    model;
     skills;
     tools;
     subagents;
@@ -17,6 +18,7 @@ export class InitialSessionContext {
         this.profileName = options.profileName;
         this.sessionId = options.sessionId;
         this.parentSessionId = options.parentSessionId;
+        this.model = options.model ? { ...options.model } : undefined;
         this.skills = [...(options.skills ?? [])];
         this.tools = [...(options.tools ?? [])];
         this.subagents = [...(options.subagents ?? [])];
@@ -33,6 +35,7 @@ export class InitialSessionContextBuilder {
     profileName;
     sessionId;
     parentSessionId;
+    model;
     skills = [];
     tools = [];
     subagents = [];
@@ -54,6 +57,10 @@ export class InitialSessionContextBuilder {
         this.parentSessionId = parentSessionId;
         return this;
     }
+    withModel(model) {
+        this.model = { ...model };
+        return this;
+    }
     withBuiltinTools(mode) {
         this.builtinTools = mode;
         return this;
@@ -123,6 +130,7 @@ export class InitialSessionContextBuilder {
             profileName: this.profileName,
             sessionId: this.sessionId,
             parentSessionId: this.parentSessionId,
+            model: this.model,
             skills: this.skills,
             tools: this.tools,
             subagents: this.subagents,

package/dist/core/runtime.js

@@ -201,6 +201,7 @@ export async function createPiboRuntime(options = {}) {
             services,
             sessionManager: runtimeSessionManager,
             sessionStartEvent,
+            model: resolveProfileModel(profile, services),
             thinkingLevel: options.thinkingLevel,
             customTools,
             noTools: profile.builtinTools === "disabled" ? "builtin" : undefined,
@@ -228,6 +229,18 @@ export async function createPiboRuntime(options = {}) {
         sessionManager,
     });
 }
+function resolveProfileModel(profile, services) {
+    if (!profile.model)
+        return undefined;
+    const model = services.modelRegistry.find(profile.model.provider, profile.model.id);
+    if (!model) {
+        throw new Error(`Profile "${profile.profileName}" requests unknown model ${profile.model.provider}/${profile.model.id}.`);
+    }
+    if (!services.modelRegistry.hasConfiguredAuth(model)) {
+        throw new Error(`Profile "${profile.profileName}" requires configured auth for ${profile.model.provider}/${profile.model.id}.`);
+    }
+    return model;
+}
 export async function inspectPiboProfile(options = {}) {
     const cwd = options.cwd ?? process.cwd();
     const profile = options.profile ?? createDefaultPiboProfile();

package/dist/core/session-router.js

@@ -14,6 +14,7 @@ function profileForSession(baseProfile, piSessionId, parentPiSessionId) {
         profileName: baseProfile.profileName,
         sessionId: piSessionId,
         parentSessionId: parentPiSessionId,
+        model: baseProfile.model,
         skills: baseProfile.skills,
         tools: baseProfile.tools,
         subagents: baseProfile.subagents,

package/dist/plugins/builtin.js

@@ -98,6 +98,16 @@ export const piboCorePlugin = definePiboPlugin({
                     .createSession();
             },
         });
+        api.registerProfile({
+            name: "pibo-kimi-coding",
+            aliases: ["kimi", "kimi-coding"],
+            description: "Pibo profile pinned to Kimi For Coding. Requires KIMI_API_KEY or configured kimi-coding auth.",
+            create(context) {
+                return createBaseProfileBuilder("pibo-kimi-coding", context)
+                    .withModel({ provider: "kimi-coding", id: "kimi-for-coding" })
+                    .createSession();
+            },
+        });
         api.registerGatewayAction({
             name: "status",
             description: "Return current session status.",

package/dist/tools/desktop-env.js

@@ -88,3 +88,12 @@ export function printDesktopEnvStatus(indent = '  ') {
     console.log(`${indent}desktop: not detected`);
     console.log(`${indent}warning: headed browser mode is unavailable; use headless mode or start a desktop display first.`);
 }
+export function printLinuxVirtualDisplayHint(indent = '  ') {
+    if (process.platform !== 'linux')
+        return;
+    console.log(`${indent}linux headed browser hint:`);
+    console.log(`${indent}  Install a virtual X display if this host has no desktop session.`);
+    console.log(`${indent}  Ubuntu/Debian: sudo apt update && sudo apt install -y xvfb xauth x11-xserver-utils`);
+    console.log(`${indent}  Start one display: Xvfb :0 -screen 0 1920x1080x24 -ac -nolisten tcp`);
+    console.log(`${indent}  Then export DISPLAY=:0 before running browser-use.`);
+}

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

@@ -4,7 +4,7 @@ import { mkdir, rm } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { ErrorCode, formatCliError } from '../cli-errors.js';
-import { getDesktopProcessEnv, printDesktopEnvStatus } from './desktop-env.js';
+import { detectDesktopEnv, getDesktopProcessEnv, hasDesktopDisplay, printDesktopEnvStatus, printLinuxVirtualDisplayHint, } from './desktop-env.js';
 function getPiboHome() {
     return process.env.PIBO_HOME || join(homedir(), '.pibo');
 }
@@ -49,7 +49,7 @@ function runBuffered(command, args, env = process.env) {
         });
     });
 }
-function runInherited(command, args, env = process.env) {
+export function runInheritedCommand(command, args, env = process.env) {
     return new Promise((resolve, reject) => {
         console.log(`Running: ${command} ${args.join(' ')}`);
         const child = spawn(command, args, {
@@ -94,6 +94,9 @@ export async function printToolPythonRuntimeDoctor(name, spec) {
     console.log(`  venv: ${existsSync(paths.venvDir) ? 'present' : 'missing'}`);
     console.log(`  executable: ${existsSync(paths.executablePath) ? paths.executablePath : 'missing'}`);
     printDesktopEnvStatus('  ');
+    if (name === 'browser-use' && process.platform === 'linux' && !hasDesktopDisplay(detectDesktopEnv())) {
+        printLinuxVirtualDisplayHint('  ');
+    }
     if (existsSync(paths.executablePath)) {
         const doctor = await runBuffered(paths.executablePath, ['doctor'], getToolPythonRuntimeEnv(paths, spec));
         console.log(`  tool doctor: ${doctor.ok ? 'ok' : 'failed'}`);
@@ -133,9 +136,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('uv', ['venv', paths.venvDir, '--python', spec.pythonVersion]);
     }
-    await runInherited('uv', [
+    await runInheritedCommand('uv', [
         'pip',
         'install',
         '--python',
@@ -143,7 +146,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 { printDesktopEnvStatus } from './desktop-env.js';
+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);
@@ -97,6 +101,9 @@ export async function installCliTool(entry, runSetup) {
     console.log(`  executable: ${status.executablePath}`);
     console.log(`  home: ${status.homeDir}`);
     printDesktopEnvStatus('  ');
+    if (entry.name === 'browser-use' && process.platform === 'linux' && !hasDesktopDisplay(detectDesktopEnv())) {
+        printLinuxVirtualDisplayHint('  ');
+    }
     console.log(`  env: pibo tools env ${entry.name}`);
 }
 export async function removeCliTool(entry) {

package/package.json

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