abelworkflow 0.9.2 → 1.0.0-rc.1

package/skills/dev-browser/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: dev-browser
-description: Browser automation with persistent page state. Use when users ask to navigate websites, fill forms, take screenshots, extract web data, test web apps, or automate browser workflows. Trigger phrases include "go to [url]", "click on", "fill out the form", "take a screenshot", "scrape", "automate", "test the website", "log into", or any browser interaction request.
+description: Browser automation with page state shared while the server process runs. Use when users ask to navigate websites, fill forms, take screenshots, extract web data, test web apps, or automate browser workflows. Trigger phrases include "go to [url]", "click on", "fill out the form", "take a screenshot", "scrape", "automate", "test the website", "log into", or any browser interaction request.
 ---
 
 # Dev Browser Skill
 
-Browser automation that maintains page state across script executions. Write small, focused scripts to accomplish tasks incrementally. Once you've proven out part of a workflow and there is repeated work to be done, you can write a script to do the repeated work in a single execution.
+Browser automation that maintains page state across script executions while the server process runs. Write small, focused scripts to accomplish tasks incrementally.
 
 ## Choosing Your Approach
 
@@ -22,13 +22,13 @@ Two supported startup modes are available on **Linux** and **native Windows**. R
 Launches a new Chromium browser for fresh automation sessions.
 
 ```text
-npx tsx scripts/start.ts standalone
+node dist/scripts/start.js standalone
 ```
 
 Add `--headless` if needed:
 
 ```text
-npx tsx scripts/start.ts standalone --headless
+node dist/scripts/start.js standalone --headless
 ```
 
 Wait for the stable readiness line `Ready` before running scripts.
@@ -43,7 +43,7 @@ Connects to the user's existing Chrome browser. Use this when:
 Start the relay server with:
 
 ```text
-npx tsx scripts/start.ts extension
+node dist/scripts/start.js extension
 ```
 
 Wait for `Waiting for extension to connect...`. Once the browser extension attaches, the relay logs `Extension connected`.
@@ -54,25 +54,32 @@ If the extension hasn't connected yet, tell the user to launch and activate it.
 
 | Mode | Linux | Native Windows | Readiness signal | Notes |
 |------|-------|----------------|------------------|-------|
-| standalone mode | Supported | Supported | `Ready` | Launches a managed Chromium profile under `profiles/` |
+| standalone mode | Supported | Supported | `Ready` | Uses a process-owned temporary Chromium profile and cleans it on exit |
 | extension mode | Supported | Supported | `Waiting for extension to connect...` then `Extension connected` | Requires the external browser extension to attach |
 
 ## Verification Checklist
 
-- Start `standalone mode` with `npx tsx scripts/start.ts standalone`
+- Start `standalone mode` with `node dist/scripts/start.js standalone`
 - Observe the readiness line `Ready`
 - Connect with `connect()` and create a named page
-- Start `extension mode` with `npx tsx scripts/start.ts extension`
+- Start `extension mode` with `node dist/scripts/start.js extension`
 - Observe `Waiting for extension to connect...`
 - Attach the browser extension and confirm `Extension connected`
 
 ## Known Differences
 
-- `standalone mode` launches and owns its own Chromium profile under this skill directory.
+- `standalone mode` owns a temporary Chromium profile only for the server process lifetime and cleans it on exit.
 - `extension mode` depends on the external browser extension and the user's existing Chrome session.
 - In `extension mode`, relay readiness means the server is waiting for the extension; it does not imply browser control is available until `Extension connected` appears.
 - `standalone mode` is the default path for deterministic local automation; `extension mode` is for working inside an already-authenticated browser.
 
+## Relay Origin Boundary
+
+- State-changing `/pages` requests accept only originless JSON clients; browser-origin and non-JSON mutations are rejected before backend calls.
+- `/cdp` accepts only originless WebSocket clients, which is the normal behavior of the Node client. Browser pages always send an `Origin` and are rejected.
+- `/extension` accepts originless protocol clients and valid `chrome-extension://` origins. HTTP(S), `null`, malformed, and other origins are rejected.
+- Rejected sockets close with WebSocket policy code `1008` before they can own a client ID, replace the extension, or route buffered messages.
+
 ## Non-goal Environments
 
 - `WSL` and `Git Bash` are not part of the supported Windows path for this skill.
@@ -81,37 +88,45 @@ If the extension hasn't connected yet, tell the user to launch and activate it.
 
 ## Writing Scripts
 
-Use small TypeScript files under `tmp/` instead of shell heredocs. Run them from the same `dev-browser` skill directory so the `@/` import alias resolves correctly.
+Treat the installed `dev-browser` skill directory as read-only. Store scripts and artifacts in the OS temporary directory or task workspace, never inside the skill directory, and delete files you created when the task ends.
 
-Example script (`tmp/example.ts`):
+External scripts cannot use package self-resolution, so pass the installed skill directory as the first argument and import its compiled client by file URL. Example:
 
-```typescript
-import { connect, waitForPageLoad } from "@/client.js";
+```javascript
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+
+const skillDir = process.argv[2];
+if (!skillDir) throw new Error("Pass the installed dev-browser skill directory");
+const { connect, waitForPageLoad } = await import(
+  pathToFileURL(join(skillDir, "dist", "src", "client.js")).href
+);
 
 const client = await connect();
 const page = await client.page("example", { viewport: { width: 1920, height: 1080 } });
 
 await page.goto("https://example.com");
 await waitForPageLoad(page);
+const screenshotPath = join(tmpdir(), "dev-browser-screenshot.png");
+await page.screenshot({ path: screenshotPath });
 
-console.log({ title: await page.title(), url: page.url() });
+console.log({ title: await page.title(), url: page.url(), screenshotPath });
 await client.disconnect();
 ```
 
-Run it with:
+This invocation works in Linux shells, PowerShell, and Command Prompt when the two paths are quoted:
 
 ```text
-npx tsx tmp/example.ts
+node "PATH_TO_SCRIPT.mjs" "PATH_TO_INSTALLED_DEV_BROWSER"
 ```
 
-**Write to `tmp/` files only when** the script needs reuse, is complex, or user explicitly requests it.
-
 ### Key Principles
 
 1. **Small scripts**: Each script does ONE thing (navigate, click, fill, check)
 2. **Evaluate state**: Log/return state at the end to decide next steps
 3. **Descriptive page names**: Use `"checkout"`, `"login"`, not `"main"`
-4. **Disconnect to exit**: `await client.disconnect()` - pages persist on server
+4. **Disconnect to exit**: `await client.disconnect()` - pages persist while the server process runs
 5. **Plain JS in evaluate**: `page.evaluate()` runs in browser - no TypeScript syntax
 
 ## Workflow Loop
@@ -156,7 +171,7 @@ const pageWithSize = await client.page("name", { viewport: { width: 1920, height
 
 const pages = await client.list(); // List all page names
 await client.close("name"); // Close a page
-await client.disconnect(); // Disconnect (pages persist)
+await client.disconnect(); // Disconnect (pages persist while the server runs)
 
 // ARIA Snapshot methods
 const snapshot = await client.getAISnapshot("name"); // Get accessibility tree
@@ -167,9 +182,7 @@ The `page` object is a standard Playwright Page.
 
 ## Waiting
 
-```typescript
-import { waitForPageLoad } from "@/client.js";
-
+```javascript
 await waitForPageLoad(page); // After navigation
 await page.waitForSelector(".results"); // For specific elements
 await page.waitForURL("**/success"); // For specific URL
@@ -179,11 +192,18 @@ await page.waitForURL("**/success"); // For specific URL
 
 ### Screenshots
 
-```typescript
-await page.screenshot({ path: "tmp/screenshot.png" });
-await page.screenshot({ path: "tmp/full.png", fullPage: true });
+```javascript
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+const screenshotPath = join(tmpdir(), "dev-browser-screenshot.png");
+const fullScreenshotPath = join(tmpdir(), "dev-browser-full.png");
+await page.screenshot({ path: screenshotPath });
+await page.screenshot({ path: fullScreenshotPath, fullPage: true });
 ```
 
+Inspect the files, then remove them no later than task completion.
+
 ### ARIA Snapshot (Element Discovery)
 
 Use `getAISnapshot()` to discover page elements. Returns YAML-formatted accessibility tree:
@@ -222,26 +242,26 @@ await element.click();
 
 ## Error Recovery
 
-Page state persists after failures. To inspect the current state, save a short script such as `tmp/debug.ts` and run it from the `dev-browser` skill directory:
-
-```typescript
-import { connect } from "@/client.js";
+Page state persists after failures while the server process runs. Reuse the external script pattern above from the OS temporary directory or task workspace:
 
+```javascript
 const client = await connect();
 const page = await client.page("hackernews");
 
-await page.screenshot({ path: "tmp/debug.png" });
+const debugScreenshotPath = join(tmpdir(), "dev-browser-debug.png");
+await page.screenshot({ path: debugScreenshotPath });
 console.log({
   url: page.url(),
   title: await page.title(),
   bodyText: await page.textContent("body").then((t) => t?.slice(0, 200)),
+  debugScreenshotPath,
 });
 
 await client.disconnect();
 ```
 
-Run it with:
+Run it with the same cross-platform invocation and delete the debug script and screenshot when finished:
 
 ```text
-npx tsx tmp/debug.ts
+node "PATH_TO_DEBUG_SCRIPT.mjs" "PATH_TO_INSTALLED_DEV_BROWSER"
 ```

package/skills/dev-browser/dist/scripts/start.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=start.d.ts.map

package/skills/dev-browser/dist/scripts/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../scripts/start.ts"],"names":[],"mappings":""}

package/skills/dev-browser/dist/scripts/start.js

@@ -0,0 +1,118 @@
+import { existsSync, readFileSync } from "node:fs";
+import { spawn } from "node:child_process";
+import { createRequire } from "node:module";
+import { join } from "node:path";
+import { formatHttpUrl, parseEntrypointArgs, resolveHostForProbe } from "../src/entrypoint.js";
+import { getInvalidRuntimeDependencies, getLockedRuntimeDependencies, getPlaywrightInstallCommand, getRuntimeDependencyInstallCommand, isPlaywrightChromiumInstalled, isTcpPortInUse, resolveSkillDirFromEntrypoint, resolveRuntimePaths, shouldUseShellForPackageCommands, } from "../src/runtime.js";
+import { ensurePlaywrightChromium, preflightStandaloneStartup, runEntrypoint, } from "../src/startup.js";
+const runtimePaths = resolveRuntimePaths(resolveSkillDirFromEntrypoint(import.meta.url));
+const useShell = shouldUseShellForPackageCommands(process.platform);
+const require = createRequire(import.meta.url);
+async function main() {
+    const args = parseEntrypointArgs(process.argv.slice(2));
+    await ensureSkillDependencies();
+    await runEntrypoint(args, {
+        runtimePaths,
+        serveStandalone: async (options) => {
+            const { serve } = await import("../src/index.js");
+            return serve(options);
+        },
+        serveExtension: async (options) => {
+            const { serveRelay } = await import("../src/relay.js");
+            return serveRelay(options);
+        },
+        registerShutdown,
+        keepAlive: () => new Promise(() => { }),
+        log: (line) => console.log(line),
+        ensureBrowser: async () => {
+            const { registry } = require("playwright-core/lib/server/registry/index");
+            await ensurePlaywrightChromium({
+                isInstalled: () => isPlaywrightChromiumInstalled({
+                    headless: args.headless,
+                    findExecutable: (name) => registry.findExecutable(name),
+                    exists: existsSync,
+                }),
+                installCommand: getPlaywrightInstallCommand({ skillDir: runtimePaths.skillDir }),
+                runCommand,
+                log: (line) => console.log(line),
+            });
+        },
+        preflightStandalone: () => preflightStandaloneStartup(args, {
+            checkServer: async (host, port) => {
+                try {
+                    const response = await fetch(formatHttpUrl(resolveHostForProbe(host), port), {
+                        signal: AbortSignal.timeout(1000),
+                    });
+                    if (!response.ok) {
+                        return { ok: false };
+                    }
+                    const info = (await response.json());
+                    return { ok: true, info };
+                }
+                catch {
+                    return { ok: false };
+                }
+            },
+            isPortInUse: isTcpPortInUse,
+            log: (line) => console.log(line),
+        }),
+    });
+}
+async function ensureSkillDependencies() {
+    const packageLock = JSON.parse(readFileSync(join(runtimePaths.skillDir, "package-lock.json"), "utf8"));
+    const invalidDependencies = getInvalidRuntimeDependencies({
+        skillDir: runtimePaths.skillDir,
+        lockedDependencies: getLockedRuntimeDependencies(packageLock),
+        readPackageVersion: (path) => {
+            try {
+                const installed = JSON.parse(readFileSync(path, "utf8"));
+                return typeof installed.version === "string" ? installed.version : undefined;
+            }
+            catch {
+                return undefined;
+            }
+        },
+    });
+    if (invalidDependencies.length === 0)
+        return;
+    console.log("dev-browser dependencies missing or out of date. Installing local packages...");
+    const installCommand = getRuntimeDependencyInstallCommand();
+    await runCommand(installCommand.command, installCommand.args);
+    console.log("dev-browser dependencies installed.");
+}
+async function runCommand(command, args) {
+    await new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            cwd: runtimePaths.skillDir,
+            stdio: "inherit",
+            shell: useShell && command === "npm",
+            windowsHide: useShell && command === "npm",
+        });
+        child.on("error", reject);
+        child.on("close", (code) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            reject(new Error(`${command} ${args.join(" ")} exited with code ${code}`));
+        });
+    });
+}
+function registerShutdown(stop) {
+    let shutdownPromise;
+    const shutdown = () => {
+        shutdownPromise ??= (async () => {
+            await stop();
+            process.exit(0);
+        })();
+        return shutdownPromise;
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    process.on("SIGHUP", shutdown);
+}
+main().catch((error) => {
+    console.error("Failed to start dev-browser:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=start.js.map

package/skills/dev-browser/dist/scripts/start.js.map

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

package/skills/dev-browser/dist/src/client.d.ts

@@ -0,0 +1,93 @@
+import { type Page, type ElementHandle } from "playwright";
+import type { ViewportSize } from "./types.js";
+/**
+ * Options for waiting for page load
+ */
+export interface WaitForPageLoadOptions {
+    /** Maximum time to wait in ms (default: 10000) */
+    timeout?: number;
+    /** How often to check page state in ms (default: 50) */
+    pollInterval?: number;
+    /** Minimum time to wait even if page appears ready in ms (default: 100) */
+    minimumWait?: number;
+    /** Wait for network to be idle (no pending requests) (default: true) */
+    waitForNetworkIdle?: boolean;
+}
+/**
+ * Result of waiting for page load
+ */
+export interface WaitForPageLoadResult {
+    /** Whether the page is considered loaded */
+    success: boolean;
+    /** Document ready state when finished */
+    readyState: string;
+    /** Number of pending network requests when finished */
+    pendingRequests: number;
+    /** Time spent waiting in ms */
+    waitTimeMs: number;
+    /** Whether timeout was reached */
+    timedOut: boolean;
+}
+/**
+ * Wait for a page to finish loading using document.readyState and performance API.
+ *
+ * Uses browser-use's approach of:
+ * - Checking document.readyState for 'complete'
+ * - Monitoring pending network requests via Performance API
+ * - Filtering out ads, tracking, and non-critical resources
+ * - Graceful timeout handling (continues even if timeout reached)
+ */
+export declare function waitForPageLoad(page: Page, options?: WaitForPageLoadOptions): Promise<WaitForPageLoadResult>;
+/** Server mode information */
+export interface ServerInfo {
+    wsEndpoint: string;
+    mode: "standalone" | "extension";
+    extensionConnected?: boolean;
+}
+/**
+ * Options for creating or getting a page
+ */
+export interface PageOptions {
+    /** Viewport size for new pages */
+    viewport?: ViewportSize;
+}
+export interface DevBrowserClient {
+    page: (name: string, options?: PageOptions) => Promise<Page>;
+    list: () => Promise<string[]>;
+    close: (name: string) => Promise<void>;
+    disconnect: () => Promise<void>;
+    /**
+     * Get AI-friendly ARIA snapshot for a page.
+     * Returns YAML format with refs like [ref=e1], [ref=e2].
+     * Refs are stored on window.__devBrowserRefs for cross-connection persistence.
+     */
+    getAISnapshot: (name: string) => Promise<string>;
+    /**
+     * Get an element handle by its ref from the last getAISnapshot call.
+     * Refs persist across Playwright connections.
+     */
+    selectSnapshotRef: (name: string, ref: string) => Promise<ElementHandle | null>;
+    /**
+     * Get server information including mode and extension connection status.
+     */
+    getServerInfo: () => Promise<ServerInfo>;
+}
+interface TargetLookupSession {
+    send(method: "Target.getTargetInfo"): Promise<{
+        targetInfo: {
+            targetId: string;
+        };
+    }>;
+    detach(): Promise<void>;
+}
+interface TargetLookupContext<TPage> {
+    pages(): TPage[];
+    newCDPSession(page: TPage): Promise<TargetLookupSession>;
+}
+interface TargetLookupBrowser<TPage> {
+    contexts(): Array<TargetLookupContext<TPage>>;
+}
+export declare function findPageByTargetId<TPage>(browser: TargetLookupBrowser<TPage>, targetId: string): Promise<TPage | null>;
+export declare function connect(serverUrl?: string): Promise<DevBrowserClient>;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/skills/dev-browser/dist/src/client.d.ts.map

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