verybot 0.1.3

package/dist/cli/config.js

@@ -0,0 +1,78 @@
+import { ConfigStore } from "../config/store.js";
+import { seedConfigStore, generateGatewayToken } from "../config.js";
+import { BASE_DIR } from "../paths.js";
+/** Resolve a dot-separated path on a nested object. */
+function getByPath(obj, path) {
+    return path.split(".").reduce((o, k) => (o && typeof o === "object" ? o[k] : undefined), obj);
+}
+/** Build a nested partial object from a dot-separated path and a value. */
+function setByPath(path, value) {
+    const keys = path.split(".");
+    if (keys.length === 1)
+        return { [path]: value };
+    const root = {};
+    let current = root;
+    for (let i = 0; i < keys.length - 1; i++) {
+        current[keys[i]] = {};
+        current = current[keys[i]];
+    }
+    current[keys[keys.length - 1]] = value;
+    return root;
+}
+/** Auto-coerce CLI string values to native types. */
+function coerce(raw) {
+    if (raw === "true")
+        return true;
+    if (raw === "false")
+        return false;
+    if (raw === "null")
+        return null;
+    const num = Number(raw);
+    if (!Number.isNaN(num) && raw.trim() !== "")
+        return num;
+    return raw;
+}
+/**
+ * Handle `config get [KEY]` and `config set KEY VALUE` CLI subcommands.
+ * Operates directly on config.json — no gateway boot needed.
+ */
+export function handleConfigCommand(sub, rest) {
+    const store = new ConfigStore(BASE_DIR);
+    seedConfigStore(store);
+    if (sub === "get") {
+        const key = rest[0];
+        if (!key) {
+            console.log(JSON.stringify(store.getRedacted(), null, 2));
+            return;
+        }
+        const data = store.load();
+        const value = getByPath(data, key);
+        if (value === undefined) {
+            console.error(`Key "${key}" not found in config`);
+            process.exitCode = 1;
+            return;
+        }
+        console.log(typeof value === "string" ? value : JSON.stringify(value, null, 2));
+        return;
+    }
+    if (sub === "set") {
+        const [key, ...valueParts] = rest;
+        if (!key || valueParts.length === 0) {
+            console.error("Usage: config set KEY VALUE");
+            process.exitCode = 1;
+            return;
+        }
+        const value = coerce(valueParts.join(" "));
+        store.patch(setByPath(key, value));
+        console.log(`Set ${key}`);
+        return;
+    }
+    if (sub === "regenerate_gateway_token") {
+        const token = generateGatewayToken();
+        store.patch({ GATEWAY_TOKEN: token });
+        console.log(token);
+        return;
+    }
+    console.error("Usage: config get [KEY] | config set KEY VALUE | config regenerate_gateway_token");
+    process.exitCode = 1;
+}

package/dist/cli/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Route lightweight CLI subcommands without booting the gateway.
+ * Returns true if a subcommand was handled.
+ */
+export declare function handleCli(): boolean;

package/dist/cli/index.js

@@ -0,0 +1,13 @@
+import { handleConfigCommand } from "./config.js";
+/**
+ * Route lightweight CLI subcommands without booting the gateway.
+ * Returns true if a subcommand was handled.
+ */
+export function handleCli() {
+    const [cmd, sub, ...rest] = process.argv.slice(2);
+    if (cmd === "config") {
+        handleConfigCommand(sub, rest);
+        return true;
+    }
+    return false;
+}

package/dist/computer/browser/actions.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Thin wrappers around Playwright APIs that use BrowserManager for state.
+ * Each action returns a serializable result suitable for tool output.
+ */
+import type { BrowserManager } from "./manager.js";
+/** Prefix a tool output string with the active profile name. */
+export declare function withProfilePrefix(browser: BrowserManager, text: string): string;
+/** Navigate to a URL. Returns the page URL + title + snapshot. */
+export declare function navigate(browser: BrowserManager, url: string): Promise<string>;
+/**
+ * Take an a11y snapshot of the current page, assign refs, store them in manager.
+ * Returns raw snapshot text without a profile prefix — callers add the prefix.
+ */
+export declare function takeSnapshot(browser: BrowserManager): Promise<string>;
+/** Take a screenshot, compress it, return base64 + mediaType. */
+export declare function takeScreenshot(browser: BrowserManager, fullPage?: boolean): Promise<{
+    base64: string;
+    mediaType: string;
+}>;
+/** Click an element by ref. Returns confirmation + auto-snapshot. */
+export declare function click(browser: BrowserManager, ref: string): Promise<string>;
+/** Type text into an input by ref. Optionally submit with Enter. */
+export declare function type(browser: BrowserManager, ref: string, text: string, submit?: boolean): Promise<string>;
+/** Press a keyboard key or combo (e.g. "Enter", "Control+A"). */
+export declare function pressKey(browser: BrowserManager, key: string): Promise<string>;
+/** Switch the browser to a different named profile. Closes the current browser. */
+export declare function switchProfile(browser: BrowserManager, name: string): Promise<string>;
+/** List existing named profiles by reading BROWSER_PROFILES_DIR. */
+export declare function listProfiles(): string[];
+/** Translate Playwright errors into helpful messages for the agent. */
+export declare function toAIFriendlyError(err: unknown): string;

package/dist/computer/browser/actions.js

@@ -0,0 +1,148 @@
+/**
+ * Thin wrappers around Playwright APIs that use BrowserManager for state.
+ * Each action returns a serializable result suitable for tool output.
+ */
+import { readdirSync } from "node:fs";
+import { buildRoleSnapshotFromAriaSnapshot } from "./snapshot.js";
+import { compressScreenshot } from "./screenshot.js";
+import { BROWSER_PROFILES_DIR } from "../../paths.js";
+import { logger } from "../../logger.js";
+const NAVIGATION_TIMEOUT_MS = 30_000;
+const ACTION_TIMEOUT_MS = 10_000;
+const POST_ACTION_SETTLE_MS = 500;
+const POST_KEY_SETTLE_MS = 300;
+const TEXT_PREVIEW_LENGTH = 50;
+const ALLOWED_SCHEMES = new Set(["http:", "https:"]);
+/** Allowed keyboard keys for browser_press_key. */
+const ALLOWED_KEYS = new Set([
+    "Enter", "Escape", "Tab", "Backspace", "Delete", "Space",
+    "ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight",
+    "Home", "End", "PageUp", "PageDown",
+    "F1", "F2", "F3", "F4", "F5", "F6", "F7", "F8", "F9", "F10", "F11", "F12",
+]);
+/** Modifier+key pattern (e.g. "Control+A", "Meta+Shift+V"). */
+const MODIFIER_KEY_PATTERN = /^(Control|Meta|Alt|Shift)(\+(Control|Meta|Alt|Shift))*\+[A-Za-z0-9]$/;
+/** Prefix a tool output string with the active profile name. */
+export function withProfilePrefix(browser, text) {
+    return `[profile: ${browser.getActiveProfile()}] ${text}`;
+}
+/** Navigate to a URL. Returns the page URL + title + snapshot. */
+export async function navigate(browser, url) {
+    // Validate URL scheme to prevent SSRF (file://, javascript:, etc.)
+    const parsed = new URL(url);
+    if (!ALLOWED_SCHEMES.has(parsed.protocol)) {
+        throw new Error(`Unsupported URL scheme: ${parsed.protocol}. Only http and https are allowed.`);
+    }
+    const page = await browser.launch();
+    await page.goto(url, { waitUntil: "domcontentloaded", timeout: NAVIGATION_TIMEOUT_MS });
+    const title = await page.title();
+    // Auto-snapshot after navigation
+    const snapshot = await takeSnapshot(browser);
+    return withProfilePrefix(browser, `Navigated to: ${page.url()}\nTitle: ${title}\n\n${snapshot}`);
+}
+/**
+ * Take an a11y snapshot of the current page, assign refs, store them in manager.
+ * Returns raw snapshot text without a profile prefix — callers add the prefix.
+ */
+export async function takeSnapshot(browser) {
+    const page = browser.getPage();
+    if (!page)
+        throw new Error("Browser not open. Use browser_navigate first.");
+    const ariaText = await page.locator(":root").ariaSnapshot();
+    const { snapshot, refs } = buildRoleSnapshotFromAriaSnapshot(ariaText);
+    browser.setRoleRefs(refs);
+    const refCount = Object.keys(refs).length;
+    return `[${page.url()}]\n${snapshot}\n\n(${refCount} refs assigned — use ref like "e1" to interact)`;
+}
+/** Take a screenshot, compress it, return base64 + mediaType. */
+export async function takeScreenshot(browser, fullPage) {
+    const page = browser.getPage();
+    if (!page)
+        throw new Error("Browser not open. Use browser_navigate first.");
+    const png = await page.screenshot({ fullPage: fullPage ?? false });
+    return compressScreenshot(Buffer.from(png));
+}
+/** Click an element by ref. Returns confirmation + auto-snapshot. */
+export async function click(browser, ref) {
+    const locator = browser.refLocator(ref);
+    await locator.click({ timeout: ACTION_TIMEOUT_MS });
+    // Short wait for navigation/rendering to settle
+    const pageAfterClick = browser.getPage();
+    if (pageAfterClick)
+        await pageAfterClick.waitForTimeout(POST_ACTION_SETTLE_MS);
+    // Auto-snapshot after click
+    const snapshot = await takeSnapshot(browser);
+    return withProfilePrefix(browser, `Clicked ref=${ref}\n\n${snapshot}`);
+}
+/** Type text into an input by ref. Optionally submit with Enter. */
+export async function type(browser, ref, text, submit) {
+    const locator = browser.refLocator(ref);
+    await locator.fill(text, { timeout: ACTION_TIMEOUT_MS });
+    if (submit) {
+        await locator.press("Enter");
+        const pageAfterSubmit = browser.getPage();
+        if (pageAfterSubmit)
+            await pageAfterSubmit.waitForTimeout(POST_ACTION_SETTLE_MS);
+    }
+    // Auto-snapshot after typing
+    const snapshot = await takeSnapshot(browser);
+    const preview = text.length > TEXT_PREVIEW_LENGTH
+        ? `${text.slice(0, TEXT_PREVIEW_LENGTH)}...`
+        : text;
+    return withProfilePrefix(browser, `Typed "${preview}" into ref=${ref}${submit ? " (submitted)" : ""}\n\n${snapshot}`);
+}
+/** Press a keyboard key or combo (e.g. "Enter", "Control+A"). */
+export async function pressKey(browser, key) {
+    const page = browser.getPage();
+    if (!page)
+        throw new Error("Browser not open. Use browser_navigate first.");
+    // Validate key to prevent arbitrary keyboard sequences
+    if (!ALLOWED_KEYS.has(key) && !MODIFIER_KEY_PATTERN.test(key)) {
+        throw new Error(`Key "${key}" is not allowed. Use single keys (Enter, Escape, ArrowDown, Tab, etc.) or modifier combos (Control+A, Meta+C, etc.).`);
+    }
+    await page.keyboard.press(key);
+    await page.waitForTimeout(POST_KEY_SETTLE_MS);
+    return withProfilePrefix(browser, `Pressed key: ${key}`);
+}
+/** Switch the browser to a different named profile. Closes the current browser. */
+export async function switchProfile(browser, name) {
+    const previous = browser.getActiveProfile();
+    await browser.switchProfile(name);
+    const profiles = listProfiles();
+    return withProfilePrefix(browser, `Switched from "${previous}" to "${name}". Browser closed — it will relaunch with the new profile on next navigation.\n\nAvailable profiles: ${profiles.join(", ")}`);
+}
+/** List existing named profiles by reading BROWSER_PROFILES_DIR. */
+export function listProfiles() {
+    try {
+        const entries = readdirSync(BROWSER_PROFILES_DIR, { withFileTypes: true });
+        const profiles = entries
+            .filter((e) => e.isDirectory())
+            .map((e) => e.name);
+        // Always include "default" even if dir doesn't exist under profiles/
+        if (!profiles.includes("default"))
+            profiles.unshift("default");
+        return profiles;
+    }
+    catch (err) {
+        logger.warn(`Failed to list browser profiles: ${err instanceof Error ? err.message : err}`);
+        return ["default"];
+    }
+}
+/** Translate Playwright errors into helpful messages for the agent. */
+export function toAIFriendlyError(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (msg.includes("Timeout")) {
+        return `Action timed out -- the element may not be visible or the page may still be loading. Try taking a fresh snapshot.`;
+    }
+    if (msg.includes("not attached") || msg.includes("detached")) {
+        return `Element is no longer on the page (DOM changed). Take a fresh snapshot and use updated refs.`;
+    }
+    if (msg.includes("intercepts pointer events") || msg.includes("is not clickable")) {
+        return `Element is hidden behind another element. Try scrolling or closing overlays first.`;
+    }
+    if (msg.includes("Unknown ref") || msg.includes("not allowed") || msg.includes("Unsupported URL") || msg.includes("Profile name")) {
+        return msg;
+    }
+    logger.error(`Browser action error: ${msg}`);
+    return `Browser error: ${msg}`;
+}

package/dist/computer/browser/manager.d.ts

@@ -0,0 +1,55 @@
+import { type Page } from "playwright";
+import type { RoleRefMap } from "./snapshot.js";
+/** Validate a profile name. Throws on invalid input. */
+export declare function validateProfileName(name: string): void;
+export interface BrowserConfig {
+    headless?: boolean;
+    /**
+     * Chrome user-data-dir.
+     * - `undefined` (default): uses the shared persistent profile (`BROWSER_PROFILE_DIR`).
+     * - `"temp"`: creates a fresh temp dir per launch (used for worker isolation).
+     * - any other string: uses that path as-is.
+     */
+    profileDir?: string | "temp";
+    /** Named profile (e.g. "work", "personal"). Default: "default". */
+    profile?: string;
+    /** Custom User-Agent string. When unset, auto-detects a clean UA from the real browser. */
+    userAgent?: string;
+}
+export declare class BrowserManager {
+    private context;
+    private config;
+    private roleRefs;
+    private activeProfile;
+    constructor(config: BrowserConfig);
+    launch(): Promise<Page>;
+    /**
+     * Probe-launch the browser to read its real User-Agent, then close it.
+     * Returns a clean UA with "HeadlessChrome" replaced by "Chrome".
+     * The result is cached on the class so we only probe once per process.
+     */
+    private static _cachedCleanUA;
+    private detectCleanUA;
+    /** Resolve the user-data directory for the active named profile. */
+    private resolveProfileDir;
+    /** Close current browser and switch to a different named profile. */
+    switchProfile(name: string): Promise<void>;
+    /** Get the currently active profile name. */
+    getActiveProfile(): string;
+    /** Update config for next browser launch. Closes existing browser if headless mode changed. */
+    updateConfig(config: BrowserConfig): Promise<void>;
+    /** Get the active page, or null if browser is not launched. */
+    getPage(): Page | null;
+    /** Check if the browser is currently launched. */
+    isLaunched(): boolean;
+    /** Store role refs from the latest snapshot. */
+    setRoleRefs(refs: RoleRefMap): void;
+    /** Get stored role refs from the latest snapshot. */
+    getRoleRefs(): RoleRefMap;
+    /**
+     * Resolve a ref string (e.g. "e5") to a Playwright Locator.
+     * Ported from main project's pw-session.ts:refLocator.
+     */
+    refLocator(ref: string): import("playwright-core").Locator;
+    close(): Promise<void>;
+}