@demigodmode/pi-web-agent 0.4.0 → 0.5.1

package/README.md

@@ -18,6 +18,10 @@ That sounds obvious, but a lot of agent tooling gets fuzzy right there. This pac
 pi install npm:@demigodmode/pi-web-agent
 ```
 
+After installing, reload or restart Pi. Run `/web-agent` for the action menu, or `/web-agent doctor` to check whether the package loaded cleanly and whether headless rendering can find a browser.
+
+Headless rendering currently requires a detectable Chromium-family browser: Chrome, Chromium, Edge, or Brave. Firefox/Safari-only systems can still use search and plain HTTP reads, but browser-rendered fallback pages need a supported Chromium-family browser for now.
+
 Later on, update installed packages with:
 
 ```bash
@@ -65,6 +69,7 @@ Primary UI:
 Helper commands:
 
 ```text
+/web-agent doctor
 /web-agent show
 /web-agent reset project
 /web-agent reset global

package/dist/commands/web-agent-config.d.ts

@@ -1,10 +1,18 @@
 import { type ExtensionAPI } from '@mariozechner/pi-coding-agent';
 import { loadPresentationConfigLayers, type LoadedPresentationConfig } from '../presentation/config-store.js';
+import { type BrowserResolutionResult } from '../fetch/browser-resolution.js';
 import type { PresentationConfig, PresentationConfigOverride, PresentationScope } from '../presentation/types.js';
 type CommandDeps = {
     load?: () => ReturnType<typeof loadPresentationConfigLayers>;
     save?: (scope: PresentationScope, config: PresentationConfigOverride) => Promise<void>;
     reset?: (scope: PresentationScope) => Promise<void>;
+    resolveBrowser?: () => Promise<BrowserResolutionResult>;
+    runtime?: {
+        nodeVersion: string;
+        platform: string;
+        arch: string;
+    };
+    checkTypebox?: () => Promise<boolean>;
 };
 export type SettingsDraftState = {
     scope: PresentationScope;

package/dist/commands/web-agent-config.js

@@ -1,7 +1,8 @@
-import { getSettingsListTheme } from '@mariozechner/pi-coding-agent';
-import { Container, SettingsList, Text } from '@mariozechner/pi-tui';
+import { DynamicBorder, getSettingsListTheme } from '@mariozechner/pi-coding-agent';
+import { Container, SelectList, SettingsList, Text } from '@mariozechner/pi-tui';
 import { DEFAULT_PRESENTATION_CONFIG, mergePresentationConfigLayers, resolvePresentationMode } from '../presentation/config.js';
 import { loadPresentationConfigLayers, resetPresentationConfigScope, savePresentationConfigScope } from '../presentation/config-store.js';
+import { resolveBrowserExecutable } from '../fetch/browser-resolution.js';
 const PRESENTATION_TOOL_NAMES = ['web_explore'];
 function parseScopeToken(token) {
     return token === 'global' || token === 'project' ? token : undefined;
@@ -12,6 +13,15 @@ function clonePresentationConfig(config) {
         tools: { ...config.tools }
     };
 }
+async function defaultCheckTypebox() {
+    try {
+        await import('typebox');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 function formatConfigSummary(config) {
     const lines = [`defaultMode: ${config.defaultMode}`];
     for (const toolName of PRESENTATION_TOOL_NAMES) {
@@ -137,6 +147,40 @@ export function handleSettingsShortcut(data) {
     }
     return undefined;
 }
+async function openActionMenu(ctx) {
+    return ctx.ui.custom((tui, theme, _kb, done) => {
+        const container = new Container();
+        const items = [
+            { value: 'settings', label: 'Settings', description: 'Edit presentation modes' },
+            { value: 'show', label: 'Show config', description: 'Print effective config paths and modes' },
+            { value: 'doctor', label: 'Doctor', description: 'Check runtime dependencies and browser detection' },
+            { value: 'reset-project', label: 'Reset project config', description: 'Delete project-level overrides' },
+            { value: 'reset-global', label: 'Reset global config', description: 'Delete global overrides' }
+        ];
+        container.addChild(new DynamicBorder((text) => theme.fg('accent', text)));
+        container.addChild(new Text(theme.fg('accent', theme.bold('pi-web-agent')), 1, 0));
+        const list = new SelectList(items, Math.min(items.length, 8), {
+            selectedPrefix: (text) => theme.fg('accent', text),
+            selectedText: (text) => theme.fg('accent', text),
+            description: (text) => theme.fg('muted', text),
+            scrollInfo: (text) => theme.fg('dim', text),
+            noMatch: (text) => theme.fg('warning', text)
+        });
+        list.onSelect = (item) => done(item.value);
+        list.onCancel = () => done(undefined);
+        container.addChild(list);
+        container.addChild(new Text(theme.fg('dim', '↑↓ navigate • enter select • esc cancel'), 1, 0));
+        container.addChild(new DynamicBorder((text) => theme.fg('accent', text)));
+        return {
+            render: (width) => container.render(width),
+            invalidate: () => container.invalidate(),
+            handleInput: (data) => {
+                list.handleInput?.(data);
+                tui.requestRender?.();
+            }
+        };
+    });
+}
 async function openSettingsUi(ctx, loaded, initialScope) {
     return ctx.ui.custom((_tui, theme, _kb, done) => {
         let state = createSettingsDraftState(loaded, initialScope);
@@ -182,10 +226,51 @@ export function registerWebAgentConfigCommands(pi, deps = {}) {
     const load = deps.load ?? (() => loadPresentationConfigLayers());
     const save = deps.save ?? ((scope, config) => savePresentationConfigScope({}, scope, config));
     const reset = deps.reset ?? ((scope) => resetPresentationConfigScope({}, scope));
+    const resolveBrowser = deps.resolveBrowser ?? (() => resolveBrowserExecutable({}));
+    const runtime = deps.runtime ?? {
+        nodeVersion: process.version,
+        platform: process.platform,
+        arch: process.arch
+    };
+    const checkTypebox = deps.checkTypebox ?? defaultCheckTypebox;
     pi.registerCommand('web-agent', {
         description: 'Open settings or manage pi-web-agent presentation config',
         handler: async (args, ctx) => {
-            const [action, maybeScope] = (args ?? '').trim().split(/\s+/).filter(Boolean);
+            let [action, maybeScope] = (args ?? '').trim().split(/\s+/).filter(Boolean);
+            if (!action) {
+                const selectedAction = await openActionMenu(ctx);
+                if (!selectedAction)
+                    return;
+                if (selectedAction === 'reset-project') {
+                    action = 'reset';
+                    maybeScope = 'project';
+                }
+                else if (selectedAction === 'reset-global') {
+                    action = 'reset';
+                    maybeScope = 'global';
+                }
+                else {
+                    action = selectedAction;
+                }
+            }
+            if (action === 'doctor') {
+                const [typeboxOk, browser] = await Promise.all([checkTypebox(), resolveBrowser()]);
+                const lines = [
+                    'pi-web-agent: loaded',
+                    `runtime: node ${runtime.nodeVersion} ${runtime.platform} ${runtime.arch}`,
+                    `typebox: ${typeboxOk ? 'ok' : 'missing'}`
+                ];
+                if (browser.ok) {
+                    lines.push(`browser: ${browser.browser} ${browser.executablePath}`);
+                }
+                else {
+                    lines.push(`browser: missing (${browser.error.code})`);
+                    lines.push(browser.error.message);
+                    lines.push('Install Chrome, Chromium, Edge, or Brave and run /web-agent doctor again.');
+                }
+                ctx.ui.notify(lines.join('\n'), 'info');
+                return;
+            }
             if (action === 'show') {
                 const loaded = await load();
                 ctx.ui.notify([
@@ -243,7 +328,7 @@ export function registerWebAgentConfigCommands(pi, deps = {}) {
                 ctx.ui.notify(`Saved ${result.scope} config`, 'info');
                 return;
             }
-            ctx.ui.notify('Use /web-agent, /web-agent show, /web-agent reset project, or /web-agent settings', 'info');
+            ctx.ui.notify('Use /web-agent, /web-agent show, /web-agent doctor, /web-agent reset project, or /web-agent settings', 'info');
         }
     });
 }

package/dist/extension.js

@@ -1,4 +1,4 @@
-import { Type } from '@sinclair/typebox';
+import { Type } from 'typebox';
 import { registerWebAgentConfigCommands } from './commands/web-agent-config.js';
 import { DEFAULT_PRESENTATION_CONFIG, resolvePresentationMode } from './presentation/config.js';
 import { loadPresentationConfigLayers } from './presentation/config-store.js';

package/dist/fetch/browser-resolution.d.ts

@@ -1,7 +1,9 @@
+type SupportedPlatform = NodeJS.Platform | string;
+type BrowserName = 'configured' | 'chrome' | 'edge' | 'brave' | 'chromium';
 export type BrowserResolutionResult = {
     ok: true;
     executablePath: string;
-    browser: 'configured' | 'chrome' | 'edge';
+    browser: BrowserName;
 } | {
     ok: false;
     error: {
@@ -9,7 +11,10 @@ export type BrowserResolutionResult = {
         message: string;
     };
 };
-export declare function resolveBrowserExecutable({ configuredPath, fileExists }: {
+export declare function resolveBrowserExecutable({ configuredPath, platform, env, fileExists }: {
     configuredPath?: string;
+    platform?: SupportedPlatform;
+    env?: NodeJS.ProcessEnv | Record<string, string | undefined>;
     fileExists?: (path: string) => Promise<boolean>;
 }): Promise<BrowserResolutionResult>;
+export {};

package/dist/fetch/browser-resolution.js

@@ -1,14 +1,82 @@
-const WINDOWS_CANDIDATES = {
-    chrome: [
-        'C:/Program Files/Google/Chrome/Application/chrome.exe',
-        'C:/Program Files (x86)/Google/Chrome/Application/chrome.exe'
-    ],
-    edge: [
-        'C:/Program Files/Microsoft/Edge/Application/msedge.exe',
-        'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
-    ]
-};
-export async function resolveBrowserExecutable({ configuredPath, fileExists = defaultFileExists }) {
+const WINDOWS_CANDIDATES = [
+    {
+        browser: 'chrome',
+        paths: [
+            'C:/Program Files/Google/Chrome/Application/chrome.exe',
+            'C:/Program Files (x86)/Google/Chrome/Application/chrome.exe'
+        ],
+        commands: ['chrome.exe', 'chrome', 'google-chrome']
+    },
+    {
+        browser: 'edge',
+        paths: [
+            'C:/Program Files/Microsoft/Edge/Application/msedge.exe',
+            'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
+        ],
+        commands: ['msedge.exe', 'msedge', 'microsoft-edge']
+    },
+    {
+        browser: 'brave',
+        paths: [
+            'C:/Program Files/BraveSoftware/Brave-Browser/Application/brave.exe',
+            'C:/Program Files (x86)/BraveSoftware/Brave-Browser/Application/brave.exe'
+        ],
+        commands: ['brave.exe', 'brave']
+    },
+    {
+        browser: 'chromium',
+        paths: [
+            'C:/Program Files/Chromium/Application/chrome.exe',
+            'C:/Program Files (x86)/Chromium/Application/chrome.exe'
+        ],
+        commands: ['chromium.exe', 'chromium']
+    }
+];
+const MACOS_CANDIDATES = [
+    {
+        browser: 'chrome',
+        paths: ['/Applications/Google Chrome.app/Contents/MacOS/Google Chrome'],
+        commands: ['google-chrome', 'chrome']
+    },
+    {
+        browser: 'edge',
+        paths: ['/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge'],
+        commands: ['microsoft-edge', 'msedge']
+    },
+    {
+        browser: 'brave',
+        paths: ['/Applications/Brave Browser.app/Contents/MacOS/Brave Browser'],
+        commands: ['brave-browser', 'brave']
+    },
+    {
+        browser: 'chromium',
+        paths: ['/Applications/Chromium.app/Contents/MacOS/Chromium'],
+        commands: ['chromium', 'chromium-browser']
+    }
+];
+const LINUX_CANDIDATES = [
+    {
+        browser: 'chrome',
+        paths: ['/usr/bin/google-chrome', '/usr/local/bin/google-chrome', '/opt/google/chrome/chrome'],
+        commands: ['google-chrome', 'google-chrome-stable', 'chrome']
+    },
+    {
+        browser: 'edge',
+        paths: ['/usr/bin/microsoft-edge', '/opt/microsoft/msedge/msedge'],
+        commands: ['microsoft-edge', 'microsoft-edge-stable', 'msedge']
+    },
+    {
+        browser: 'brave',
+        paths: ['/usr/bin/brave-browser', '/usr/local/bin/brave-browser', '/opt/brave.com/brave/brave'],
+        commands: ['brave-browser', 'brave']
+    },
+    {
+        browser: 'chromium',
+        paths: ['/usr/bin/chromium', '/usr/bin/chromium-browser', '/snap/bin/chromium'],
+        commands: ['chromium', 'chromium-browser']
+    }
+];
+export async function resolveBrowserExecutable({ configuredPath, platform = process.platform, env = process.env, fileExists = defaultFileExists }) {
     if (configuredPath) {
         if (await fileExists(configuredPath)) {
             return {
@@ -25,14 +93,19 @@ export async function resolveBrowserExecutable({ configuredPath, fileExists = de
             }
         };
     }
-    for (const path of WINDOWS_CANDIDATES.chrome) {
-        if (await fileExists(path)) {
-            return { ok: true, executablePath: path, browser: 'chrome' };
+    const candidates = getCandidatesForPlatform(platform);
+    for (const candidate of candidates) {
+        for (const path of candidate.paths) {
+            if (await fileExists(path)) {
+                return { ok: true, executablePath: path, browser: candidate.browser };
+            }
         }
     }
-    for (const path of WINDOWS_CANDIDATES.edge) {
-        if (await fileExists(path)) {
-            return { ok: true, executablePath: path, browser: 'edge' };
+    for (const candidate of candidates) {
+        for (const path of getPathCommandCandidates(candidate.commands, platform, env)) {
+            if (await fileExists(path)) {
+                return { ok: true, executablePath: path, browser: candidate.browser };
+            }
         }
     }
     return {
@@ -43,6 +116,27 @@ export async function resolveBrowserExecutable({ configuredPath, fileExists = de
         }
     };
 }
+function getCandidatesForPlatform(platform) {
+    if (platform === 'win32')
+        return WINDOWS_CANDIDATES;
+    if (platform === 'darwin')
+        return MACOS_CANDIDATES;
+    if (platform === 'linux')
+        return LINUX_CANDIDATES;
+    return [...WINDOWS_CANDIDATES, ...MACOS_CANDIDATES, ...LINUX_CANDIDATES];
+}
+function getPathCommandCandidates(commands, platform, env) {
+    const pathValue = env.PATH ?? env.Path ?? env.path;
+    if (!pathValue)
+        return [];
+    const delimiter = platform === 'win32' ? ';' : ':';
+    const dirs = pathValue.split(delimiter).filter(Boolean);
+    const extensions = platform === 'win32' ? ['', '.exe'] : [''];
+    return dirs.flatMap((dir) => commands.flatMap((command) => extensions.map((extension) => {
+        const normalizedCommand = command.toLowerCase().endsWith(extension) ? command : `${command}${extension}`;
+        return `${dir.replace(/[\\/]$/, '')}/${normalizedCommand}`;
+    })));
+}
 async function defaultFileExists(path) {
     try {
         const { access } = await import('node:fs/promises');

package/dist/types.d.ts

@@ -19,7 +19,7 @@ export type FetchMetadata = {
     cacheHit: boolean;
     contentType?: string;
     truncated?: boolean;
-    browser?: 'configured' | 'chrome' | 'edge';
+    browser?: 'configured' | 'chrome' | 'edge' | 'brave' | 'chromium';
     navigationMs?: number;
 };
 export type ExtractedContent = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@demigodmode/pi-web-agent",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "Pi package for reliable web access with explicit search, fetch, and headless boundaries.",
   "type": "module",
   "main": "./dist/extension.js",
@@ -56,11 +56,11 @@
     "@mozilla/readability": "^0.6.0",
     "cheerio": "^1.1.0",
     "jsdom": "^26.0.0",
-    "playwright-core": "^1.54.0"
+    "playwright-core": "^1.54.0",
+    "typebox": "^1.1.37"
   },
   "devDependencies": {
-    "@mariozechner/pi-coding-agent": "^0.67.2",
-    "@sinclair/typebox": "^0.34.41",
+    "@mariozechner/pi-coding-agent": "^0.69.0",
     "@types/jsdom": "^21.1.7",
     "@types/node": "^24.0.0",
     "@vitest/coverage-v8": "^3.2.4",
@@ -69,7 +69,6 @@
     "vitest": "^3.2.0"
   },
   "peerDependencies": {
-    "@mariozechner/pi-coding-agent": "*",
-    "@sinclair/typebox": "*"
+    "@mariozechner/pi-coding-agent": "*"
   }
 }