camou 0.2.0 → 0.3.1

package/CHANGELOG.md

@@ -4,6 +4,32 @@ All notable changes to this project will be documented in this file.
 
 The format is loosely based on Keep a Changelog and uses semantic versioning.
 
+## [0.3.1] - 2026-03-16
+
+### Fixed
+
+- Fixed the packaged `camou` CLI so it runs correctly when executed through npm-installed bin symlinks on Linux and macOS.
+- Added regression coverage for symlinked bin execution to prevent silent no-op CLI failures in future releases.
+- Made the new CLI bin regression test path-independent so it works correctly in CI and other checkout locations.
+
+## [0.3.0] - 2026-03-16
+
+### Added
+
+- Added Linux/macOS GitHub Actions CI for test, build, and package validation.
+- Added compatibility-matrix workflows and local scripts for probing Camoufox vs `playwright-core` compatibility.
+- Added broader browser automation commands including navigation, hover, type, check/uncheck, select, scroll, `get value`, and richer wait modes.
+- Added higher-level Node API wrappers including `Camoufox`, `AsyncCamoufox`, and `resolveCamoufoxLaunchSpec()`.
+
+### Changed
+
+- Updated `README.md`, skill docs, and compatibility docs to reflect the first-class Node API and expanded command surface.
+- Improved CI reliability by removing slow spawned `tsx` subprocesses from the CLI JSON tests.
+
+### Fixed
+
+- Fixed the macOS installer integration test to use platform-aware asset names and executable paths.
+
 ## [0.2.0] - 2026-03-15
 
 ### Added

package/README.md

@@ -1,10 +1,10 @@
-# Camoucli
+# Camou
 
-Camoucli is a local-first CLI and background daemon for driving [Camoufox](https://github.com/daijro/camoufox) through Playwright, without depending on the Camoufox Python SDK.
+Camou is a local-first CLI and background daemon for driving [Camoufox](https://github.com/daijro/camoufox) through Playwright, without depending on the Camoufox Python SDK.
 
 - npm package: `camou`
 - installed command: `camou`
-- project/repo name: Camoucli
+- project/repo name: camoucli
 
 Camou is built for agent-style browser workflows:
 
@@ -113,15 +113,14 @@ Camou can also be used as a Node library, not just a CLI.
 The programmatic API is Playwright-based: it launches Camoufox for you and gives you a real Playwright `BrowserContext`, similar in spirit to the Camoufox Python wrapper.
 
 ```ts
-import { launchCamoufox } from 'camou';
+import { Camoufox } from 'camou';
 
-const camou = await launchCamoufox({
+const camou = await Camoufox.launch({
   session: 'script',
   headless: false,
 });
 
-const page = await camou.context.newPage();
-await page.goto('https://example.com');
+const page = await camou.open('https://example.com');
 console.log(await page.title());
 
 await camou.close();
@@ -130,19 +129,23 @@ await camou.close();
 If you prefer a scoped helper:
 
 ```ts
-import { withCamoufox } from 'camou';
+import { Camoufox } from 'camou';
 
-await withCamoufox({ session: 'script' }, async ({ context }) => {
-  const page = await context.newPage();
-  await page.goto('https://example.com');
+await Camoufox.with({ session: 'script' }, async (camou) => {
+  const page = await camou.open('https://example.com');
   console.log(await page.title());
 });
 ```
 
 Useful exported helpers include:
 
+- `Camoufox.launch()`
+- `Camoufox.launchContext()`
+- `Camoufox.with()`
+- `AsyncCamoufox`
 - `launchCamoufox()`
 - `launchCamoufoxContext()`
+- `resolveCamoufoxLaunchSpec()`
 - `withCamoufox()`
 - `installCamoufox()`
 - `listInstalledBrowsers()`
@@ -290,15 +293,26 @@ camou doctor
 
 ```bash
 camou open <url>
+camou back
+camou forward
+camou reload
 camou snapshot [-i]
 camou click <selectorOrRef>
+camou hover <selectorOrRef>
 camou fill <selectorOrRef> <text>
+camou type <selectorOrRef> <text>
+camou check <selectorOrRef>
+camou uncheck <selectorOrRef>
+camou select <selectorOrRef> <value>
 camou press <key>
-camou wait <selectorOrRef>
+camou scroll <direction> [amount]
+camou scrollintoview <selectorOrRef>
+camou wait [selectorOrRef] [--text <text>] [--load <state>]
 camou screenshot [path]
 camou get url
 camou get title
 camou get text <selectorOrRef>
+camou get value <selectorOrRef>
 ```
 
 ### Sessions and tabs
@@ -332,6 +346,11 @@ Most browser commands support:
 - `--json`
 - `--verbose`
 
+`wait` also supports:
+
+- `--text <text>`
+- `--load <domcontentloaded|load|networkidle>`
+
 ## Presets
 
 Built-in presets give you a small layer of tested ergonomics on top of raw config and prefs JSON.
@@ -396,6 +415,14 @@ Current local verification with `playwright-core` `1.51.1`:
 | `135.0.1-beta.24` | launches | smoke-tested successfully |
 | `135.0.1-beta.23` | incompatible | `Browser.setContrast` is not supported |
 
+The repo now also includes:
+
+- Linux/macOS CI in `.github/workflows/ci.yml`
+- a workflow-driven compatibility probe in `.github/workflows/compatibility-matrix.yml`
+- local scripts to generate compatibility reports and markdown summaries
+
+See `docs/compatibility-matrix.md` for the workflow and local tooling.
+
 ## Storage Layout
 
 Camou keeps its own runtime state and profiles, but stores browser binaries in the shared Camoufox cache layout when possible.
@@ -430,9 +457,19 @@ npm run dev -- --help
 npm run dev:daemon
 ```
 
+Compatibility tooling:
+
+```bash
+# produce a raw compatibility report JSON
+node scripts/run-compatibility-report.mjs --output compatibility-report.json
+
+# turn one or more reports into a markdown table
+node scripts/generate-compatibility-matrix.mjs compatibility-report.json
+```
+
 ## Acknowledgements
 
-Camoucli learned a lot from these projects:
+Camou learned a lot from these projects:
 
 - [vercel-labs/agent-browser](https://github.com/vercel-labs/agent-browser) for the agent-oriented command workflow and skill ecosystem patterns
 - [BUNotesAI/agent-browser-session](https://github.com/BUNotesAI/agent-browser-session) for persistent-session and named-tab ergonomics

package/dist/api.d.ts

@@ -1,11 +1,23 @@
 import type { BrowserContext, Page } from 'playwright-core';
 import type { LaunchInput, ResolvedLaunchConfig } from './camoufox/config.js';
+import { type PreparedPersistentCamoufoxLaunch } from './camoufox/launcher.js';
 import { type CamoucliPaths } from './state/paths.js';
 export interface LaunchCamoufoxOptions extends LaunchInput {
     session?: string | undefined;
     paths?: CamoucliPaths | undefined;
     verbose?: boolean | undefined;
 }
+export interface ResolvedCamoufoxLaunchSpec {
+    sessionName: string;
+    browserVersion: string;
+    executablePath: string;
+    profileDir: string;
+    downloadsDir: string;
+    artifactsDir: string;
+    resolvedConfig: ResolvedLaunchConfig;
+    userDataDir: string;
+    launchOptions: PreparedPersistentCamoufoxLaunch['launchOptions'];
+}
 export declare class CamoufoxSession {
     readonly context: BrowserContext;
     readonly sessionName: string;
@@ -25,10 +37,22 @@ export declare class CamoufoxSession {
         artifactsDir: string;
         resolvedConfig: ResolvedLaunchConfig;
     });
-    newPage(): Promise<Page>;
+    newPage(url?: string): Promise<Page>;
     pages(): Page[];
+    firstPage(): Page | undefined;
+    ensurePage(): Promise<Page>;
+    open(url: string, page?: Page): Promise<Page>;
     close(): Promise<void>;
 }
+export declare class Camoufox extends CamoufoxSession {
+    static launch(options?: LaunchCamoufoxOptions): Promise<Camoufox>;
+    static launchContext(options?: LaunchCamoufoxOptions): Promise<BrowserContext>;
+    static resolveLaunch(options?: LaunchCamoufoxOptions): Promise<ResolvedCamoufoxLaunchSpec>;
+    static with<T>(options: LaunchCamoufoxOptions, callback: (browser: Camoufox) => Promise<T> | T): Promise<T>;
+}
+export declare class AsyncCamoufox extends Camoufox {
+}
 export declare function launchCamoufox(options?: LaunchCamoufoxOptions): Promise<CamoufoxSession>;
+export declare function resolveCamoufoxLaunchSpec(options?: LaunchCamoufoxOptions): Promise<ResolvedCamoufoxLaunchSpec>;
 export declare function launchCamoufoxContext(options?: LaunchCamoufoxOptions): Promise<BrowserContext>;
 export declare function withCamoufox<T>(options: LaunchCamoufoxOptions, callback: (session: CamoufoxSession) => Promise<T> | T): Promise<T>;

package/dist/api.js

@@ -1,4 +1,4 @@
-import { launchPersistentCamoufox } from './camoufox/launcher.js';
+import { launchPersistentCamoufox, preparePersistentCamoufoxLaunch } from './camoufox/launcher.js';
 import { ensureBasePaths, getCamoucliPaths } from './state/paths.js';
 import { Logger } from './util/log.js';
 export class CamoufoxSession {
@@ -20,16 +20,63 @@ export class CamoufoxSession {
         this.artifactsDir = input.artifactsDir;
         this.resolvedConfig = input.resolvedConfig;
     }
-    async newPage() {
-        return this.context.newPage();
+    async newPage(url) {
+        const page = await this.context.newPage();
+        if (url) {
+            await page.goto(url, { waitUntil: 'domcontentloaded' });
+        }
+        return page;
     }
     pages() {
         return this.context.pages();
     }
+    firstPage() {
+        return this.pages()[0];
+    }
+    async ensurePage() {
+        return this.firstPage() ?? this.context.newPage();
+    }
+    async open(url, page) {
+        const targetPage = page ?? await this.ensurePage();
+        await targetPage.goto(url, { waitUntil: 'domcontentloaded' });
+        return targetPage;
+    }
     async close() {
         await this.context.close();
     }
 }
+export class Camoufox extends CamoufoxSession {
+    static async launch(options = {}) {
+        const session = await launchCamoufox(options);
+        return new Camoufox({
+            context: session.context,
+            sessionName: session.sessionName,
+            browserVersion: session.browserVersion,
+            executablePath: session.executablePath,
+            profileDir: session.profileDir,
+            downloadsDir: session.downloadsDir,
+            artifactsDir: session.artifactsDir,
+            resolvedConfig: session.resolvedConfig,
+        });
+    }
+    static async launchContext(options = {}) {
+        return launchCamoufoxContext(options);
+    }
+    static async resolveLaunch(options = {}) {
+        return resolveCamoufoxLaunchSpec(options);
+    }
+    static async with(options, callback) {
+        const browser = await Camoufox.launch(options);
+        try {
+            return await callback(browser);
+        }
+        finally {
+            await browser.close();
+        }
+    }
+}
+export class AsyncCamoufox extends Camoufox {
+}
 function createApiLogger(verbose = false) {
     if (!verbose) {
         return undefined;
@@ -57,6 +104,24 @@ export async function launchCamoufox(options = {}) {
         resolvedConfig: launched.resolvedConfig,
     });
 }
+export async function resolveCamoufoxLaunchSpec(options = {}) {
+    const sessionName = options.session ?? 'default';
+    const paths = options.paths ?? getCamoucliPaths();
+    await ensureBasePaths(paths);
+    const logger = createApiLogger(options.verbose);
+    const prepared = await preparePersistentCamoufoxLaunch(paths, sessionName, options, logger);
+    return {
+        sessionName,
+        browserVersion: prepared.browserVersion,
+        executablePath: prepared.installPath,
+        profileDir: prepared.sessionPaths.profileDir,
+        downloadsDir: prepared.sessionPaths.downloadsDir,
+        artifactsDir: prepared.sessionPaths.artifactsDir,
+        resolvedConfig: prepared.resolvedConfig,
+        userDataDir: prepared.userDataDir,
+        launchOptions: prepared.launchOptions,
+    };
+}
 export async function launchCamoufoxContext(options = {}) {
     const session = await launchCamoufox(options);
     return session.context;

package/dist/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/dist/browser/manager.d.ts

@@ -22,6 +22,18 @@ export declare class BrowserManager {
         tabName: string;
         url: string;
     }): Promise<Record<string, unknown>>;
+    back(input: LaunchInput & {
+        session: string;
+        tabName: string;
+    }): Promise<Record<string, unknown>>;
+    forward(input: LaunchInput & {
+        session: string;
+        tabName: string;
+    }): Promise<Record<string, unknown>>;
+    reload(input: LaunchInput & {
+        session: string;
+        tabName: string;
+    }): Promise<Record<string, unknown>>;
     snapshot(input: LaunchInput & {
         session: string;
         tabName: string;
@@ -32,17 +44,55 @@ export declare class BrowserManager {
         tabName: string;
         target: string;
     }): Promise<Record<string, unknown>>;
+    hover(input: LaunchInput & {
+        session: string;
+        tabName: string;
+        target: string;
+    }): Promise<Record<string, unknown>>;
     fill(input: LaunchInput & {
         session: string;
         tabName: string;
         target: string;
         text: string;
     }): Promise<Record<string, unknown>>;
+    type(input: LaunchInput & {
+        session: string;
+        tabName: string;
+        target: string;
+        text: string;
+    }): Promise<Record<string, unknown>>;
+    check(input: LaunchInput & {
+        session: string;
+        tabName: string;
+        target: string;
+    }): Promise<Record<string, unknown>>;
+    uncheck(input: LaunchInput & {
+        session: string;
+        tabName: string;
+        target: string;
+    }): Promise<Record<string, unknown>>;
+    select(input: LaunchInput & {
+        session: string;
+        tabName: string;
+        target: string;
+        value: string;
+    }): Promise<Record<string, unknown>>;
     press(input: LaunchInput & {
         session: string;
         tabName: string;
         key: string;
     }): Promise<Record<string, unknown>>;
+    scroll(input: LaunchInput & {
+        session: string;
+        tabName: string;
+        direction: 'up' | 'down' | 'left' | 'right';
+        amount?: number | undefined;
+    }): Promise<Record<string, unknown>>;
+    scrollIntoView(input: LaunchInput & {
+        session: string;
+        tabName: string;
+        target: string;
+    }): Promise<Record<string, unknown>>;
     screenshot(input: LaunchInput & {
         session: string;
         tabName: string;
@@ -61,10 +111,17 @@ export declare class BrowserManager {
         tabName: string;
         target: string;
     }): Promise<Record<string, unknown>>;
-    wait(input: LaunchInput & {
+    getValue(input: LaunchInput & {
         session: string;
         tabName: string;
         target: string;
+    }): Promise<Record<string, unknown>>;
+    wait(input: LaunchInput & {
+        session: string;
+        tabName: string;
+        target?: string | undefined;
+        text?: string | undefined;
+        loadState?: 'domcontentloaded' | 'load' | 'networkidle' | undefined;
         timeoutMs?: number | undefined;
     }): Promise<Record<string, unknown>>;
     listTabs(sessionName: string): Promise<Array<Record<string, unknown>>>;

package/dist/browser/manager.js

@@ -1,6 +1,6 @@
 import path from 'node:path';
 import { launchPersistentCamoufox } from '../camoufox/launcher.js';
-import { SessionError } from '../util/errors.js';
+import { SessionError, ValidationError } from '../util/errors.js';
 import { locatorForTarget } from './actions.js';
 import { clearSnapshotRefs, takeSnapshot } from './snapshot.js';
 import { createTabRuntime } from './tabs.js';
@@ -51,6 +51,36 @@ export class BrowserManager {
             title: await tab.page.title(),
         };
     }
+    async back(input) {
+        const tab = await this.ensureTab(input.session, input.tabName, input);
+        await tab.page.goBack({ waitUntil: 'domcontentloaded' }).catch(() => null);
+        return {
+            sessionName: input.session,
+            tabName: tab.name,
+            url: tab.page.url(),
+            title: await tab.page.title(),
+        };
+    }
+    async forward(input) {
+        const tab = await this.ensureTab(input.session, input.tabName, input);
+        await tab.page.goForward({ waitUntil: 'domcontentloaded' }).catch(() => null);
+        return {
+            sessionName: input.session,
+            tabName: tab.name,
+            url: tab.page.url(),
+            title: await tab.page.title(),
+        };
+    }
+    async reload(input) {
+        const tab = await this.ensureTab(input.session, input.tabName, input);
+        await tab.page.reload({ waitUntil: 'domcontentloaded' });
+        return {
+            sessionName: input.session,
+            tabName: tab.name,
+            url: tab.page.url(),
+            title: await tab.page.title(),
+        };
+    }
     async snapshot(input) {
         const tab = await this.ensureTab(input.session, input.tabName, input);
         const result = await takeSnapshot(tab.page, input.interactive);
@@ -75,6 +105,15 @@ export class BrowserManager {
             url: tab.page.url(),
         };
     }
+    async hover(input) {
+        const tab = await this.ensureTab(input.session, input.tabName, input);
+        await locatorForTarget(tab.page, tab, input.target).hover();
+        return {
+            sessionName: input.session,
+            tabName: tab.name,
+            target: input.target,
+        };
+    }
     async fill(input) {
         const tab = await this.ensureTab(input.session, input.tabName, input);
         await locatorForTarget(tab.page, tab, input.target).fill(input.text);
@@ -85,6 +124,46 @@ export class BrowserManager {
             valueLength: input.text.length,
         };
     }
+    async type(input) {
+        const tab = await this.ensureTab(input.session, input.tabName, input);
+        await locatorForTarget(tab.page, tab, input.target).type(input.text);
+        return {
+            sessionName: input.session,
+            tabName: tab.name,
+            target: input.target,
+            valueLength: input.text.length,
+        };
+    }
+    async check(input) {
+        const tab = await this.ensureTab(input.session, input.tabName, input);
+        await locatorForTarget(tab.page, tab, input.target).check();
+        return {
+            sessionName: input.session,
+            tabName: tab.name,
+            target: input.target,
+            checked: true,
+        };
+    }
+    async uncheck(input) {
+        const tab = await this.ensureTab(input.session, input.tabName, input);
+        await locatorForTarget(tab.page, tab, input.target).uncheck();
+        return {
+            sessionName: input.session,
+            tabName: tab.name,
+            target: input.target,
+            checked: false,
+        };
+    }
+    async select(input) {
+        const tab = await this.ensureTab(input.session, input.tabName, input);
+        await locatorForTarget(tab.page, tab, input.target).selectOption(input.value);
+        return {
+            sessionName: input.session,
+            tabName: tab.name,
+            target: input.target,
+            value: input.value,
+        };
+    }
     async press(input) {
         const tab = await this.ensureTab(input.session, input.tabName, input);
         await tab.page.keyboard.press(input.key);
@@ -94,6 +173,34 @@ export class BrowserManager {
             key: input.key,
         };
     }
+    async scroll(input) {
+        const tab = await this.ensureTab(input.session, input.tabName, input);
+        const amount = input.amount ?? 500;
+        const delta = input.direction === 'up'
+            ? { x: 0, y: -amount }
+            : input.direction === 'down'
+                ? { x: 0, y: amount }
+                : input.direction === 'left'
+                    ? { x: -amount, y: 0 }
+                    : { x: amount, y: 0 };
+        await tab.page.mouse.wheel(delta.x, delta.y);
+        return {
+            sessionName: input.session,
+            tabName: tab.name,
+            direction: input.direction,
+            amount,
+            url: tab.page.url(),
+        };
+    }
+    async scrollIntoView(input) {
+        const tab = await this.ensureTab(input.session, input.tabName, input);
+        await locatorForTarget(tab.page, tab, input.target).scrollIntoViewIfNeeded();
+        return {
+            sessionName: input.session,
+            tabName: tab.name,
+            target: input.target,
+        };
+    }
     async screenshot(input) {
         const tab = await this.ensureTab(input.session, input.tabName, input);
         const session = await this.ensureSession(input.session, input);
@@ -131,14 +238,37 @@ export class BrowserManager {
             text,
         };
     }
+    async getValue(input) {
+        const tab = await this.ensureTab(input.session, input.tabName, input);
+        const value = await locatorForTarget(tab.page, tab, input.target).inputValue();
+        return {
+            sessionName: input.session,
+            tabName: tab.name,
+            target: input.target,
+            value,
+        };
+    }
     async wait(input) {
         const tab = await this.ensureTab(input.session, input.tabName, input);
+        if (!input.target && !input.text && !input.loadState) {
+            throw new ValidationError('wait requires a target, --text value, or --load state.');
+        }
         const waitOptions = input.timeoutMs ? { timeout: input.timeoutMs } : undefined;
-        await locatorForTarget(tab.page, tab, input.target).waitFor(waitOptions);
+        if (input.target) {
+            await locatorForTarget(tab.page, tab, input.target).waitFor(waitOptions);
+        }
+        if (input.text) {
+            await tab.page.getByText(input.text).first().waitFor(waitOptions);
+        }
+        if (input.loadState) {
+            await tab.page.waitForLoadState(input.loadState, waitOptions);
+        }
         return {
             sessionName: input.session,
             tabName: tab.name,
-            target: input.target,
+            ...(input.target ? { target: input.target } : {}),
+            ...(input.text ? { text: input.text } : {}),
+            ...(input.loadState ? { loadState: input.loadState } : {}),
             url: tab.page.url(),
         };
     }
@@ -187,6 +317,7 @@ export class BrowserManager {
     async ensureSession(sessionName, input) {
         const existing = this.sessions.get(sessionName);
         if (existing) {
+            this.assertSessionCompatible(existing, input);
             return existing;
         }
         const inFlight = this.startingSessions.get(sessionName);