dipclaw 0.1.0

package/dist/browser/actions.js

@@ -0,0 +1,212 @@
+import { takeSnapshot, getElementRef } from "./snapshot.js";
+export class BrowserActions {
+    browser;
+    logger = null;
+    constructor(browser) {
+        this.browser = browser;
+    }
+    setLogger(logger) {
+        this.logger = logger;
+    }
+    async navigate(url) {
+        const page = await this.browser.getActivePage();
+        await page.goto(url, { waitUntil: "domcontentloaded", timeout: 60000 });
+        this.logger?.log("navigate", { url });
+        return `Navigated to ${url}`;
+    }
+    async snapshot() {
+        const page = await this.browser.getActivePage();
+        const result = await takeSnapshot(page);
+        const url = page.url();
+        const title = await page.title();
+        this.logger?.log("snapshot", {
+            url,
+            title,
+            elements: result.elementRefs.size,
+        });
+        return `Page: ${title}\nURL: ${url}\n\n${result.text}`;
+    }
+    async click(ref) {
+        const elemRef = getElementRef(ref);
+        if (!elemRef) {
+            this.logger?.log("click", { ref, error: "ref not found" }, false);
+            return `Error: element reference '${ref}' not found. Take a snapshot first.`;
+        }
+        const page = await this.browser.getActivePage();
+        try {
+            const locator = page.getByRole(elemRef.role, {
+                name: elemRef.name,
+                exact: false,
+            });
+            await locator.first().click({ timeout: 5000 });
+            this.logger?.log("click", {
+                ref,
+                role: elemRef.role,
+                name: elemRef.name,
+            });
+            return `Clicked ${elemRef.role}: "${elemRef.name}"`;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            this.logger?.log("click", { ref, role: elemRef.role, name: elemRef.name, error: msg }, false);
+            return `Error clicking ${ref}: ${msg}`;
+        }
+    }
+    async type(ref, text, clear = true) {
+        const elemRef = getElementRef(ref);
+        if (!elemRef) {
+            this.logger?.log("type", { ref, text, error: "ref not found" }, false);
+            return `Error: element reference '${ref}' not found. Take a snapshot first.`;
+        }
+        const page = await this.browser.getActivePage();
+        try {
+            const locator = page.getByRole(elemRef.role, {
+                name: elemRef.name,
+                exact: false,
+            });
+            if (clear) {
+                await locator.first().fill(text, { timeout: 5000 });
+            }
+            else {
+                await locator.first().pressSequentially(text, { timeout: 5000 });
+            }
+            this.logger?.log("type", {
+                ref,
+                text,
+                clear,
+                role: elemRef.role,
+                name: elemRef.name,
+            });
+            return `Typed "${text}" into ${elemRef.role}: "${elemRef.name}"`;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            this.logger?.log("type", { ref, text, role: elemRef.role, name: elemRef.name, error: msg }, false);
+            return `Error typing into ${ref}: ${msg}`;
+        }
+    }
+    async scroll(direction, amount = 500, ref) {
+        const page = await this.browser.getActivePage();
+        const delta = direction === "down" ? amount : -amount;
+        if (ref) {
+            const elemRef = getElementRef(ref);
+            if (!elemRef) {
+                return `Error: element reference '${ref}' not found.`;
+            }
+            const locator = page.getByRole(elemRef.role, {
+                name: elemRef.name,
+            });
+            await locator.first().evaluate((el, d) => el.scrollBy(0, d), delta);
+        }
+        else {
+            await page.mouse.wheel(0, delta);
+        }
+        this.logger?.log("scroll", { direction, amount, ref });
+        return `Scrolled ${direction} by ${amount}px`;
+    }
+    async screenshot(fullPage = false) {
+        const page = await this.browser.getActivePage();
+        const buffer = await page.screenshot({
+            fullPage,
+            type: "jpeg",
+            quality: 75,
+        });
+        const base64 = buffer.toString("base64");
+        this.logger?.log("screenshot", { fullPage, size: buffer.length });
+        return { base64, text: `Screenshot taken (${buffer.length} bytes)` };
+    }
+    async evaluate(script) {
+        const page = await this.browser.getActivePage();
+        try {
+            const result = await page.evaluate(script);
+            const resultStr = typeof result === "string" ? result : JSON.stringify(result, null, 2);
+            this.logger?.log("evaluate", { script, resultLength: resultStr.length });
+            return resultStr || "(no return value)";
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            this.logger?.log("evaluate", { script, error: msg }, false);
+            return `Error: ${msg}`;
+        }
+    }
+    async wait(opts) {
+        const page = await this.browser.getActivePage();
+        const timeout = opts.timeout || 10000;
+        try {
+            if (opts.selector) {
+                await page.waitForSelector(opts.selector, { timeout });
+                this.logger?.log("wait", { selector: opts.selector });
+                return `Found element matching: ${opts.selector}`;
+            }
+            else if (opts.text) {
+                await page.getByText(opts.text).first().waitFor({ timeout });
+                this.logger?.log("wait", { text: opts.text });
+                return `Found text: "${opts.text}"`;
+            }
+            else {
+                await page.waitForLoadState("networkidle", { timeout });
+                this.logger?.log("wait", { state: "networkidle" });
+                return "Page loaded (network idle)";
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            this.logger?.log("wait", { ...opts, error: msg }, false);
+            return `Wait timeout: ${msg}`;
+        }
+    }
+    async pressKey(key) {
+        const page = await this.browser.getActivePage();
+        await page.keyboard.press(key);
+        this.logger?.log("press", { key });
+        return `Pressed key: ${key}`;
+    }
+    async selectOption(ref, value) {
+        const elemRef = getElementRef(ref);
+        if (!elemRef) {
+            return `Error: element reference '${ref}' not found.`;
+        }
+        const page = await this.browser.getActivePage();
+        try {
+            const locator = page.getByRole(elemRef.role, {
+                name: elemRef.name,
+            });
+            await locator.first().selectOption(value, { timeout: 5000 });
+            this.logger?.log("select", { ref, value, name: elemRef.name });
+            return `Selected "${value}" in ${elemRef.role}: "${elemRef.name}"`;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return `Error selecting option: ${msg}`;
+        }
+    }
+    async listTabs() {
+        const pages = await this.browser.getPages();
+        const tabs = await Promise.all(pages.map(async (p, i) => {
+            const title = await p.title();
+            return `[${i}] ${title} - ${p.url()}`;
+        }));
+        return tabs.length > 0 ? tabs.join("\n") : "(no tabs open)";
+    }
+    async closeTab(index) {
+        const pages = await this.browser.getPages();
+        if (index < 0 || index >= pages.length) {
+            return `Error: invalid tab index ${index}. Have ${pages.length} tabs.`;
+        }
+        const title = await pages[index].title();
+        await pages[index].close();
+        this.logger?.log("close_tab", { index, title });
+        return `Closed tab [${index}]: ${title}`;
+    }
+    async focusTab(index) {
+        const pages = await this.browser.getPages();
+        if (index < 0 || index >= pages.length) {
+            return `Error: invalid tab index ${index}. Have ${pages.length} tabs.`;
+        }
+        await pages[index].bringToFront();
+        const title = await pages[index].title();
+        this.logger?.log("focus_tab", { index, title });
+        return `Focused tab [${index}]: ${title}`;
+    }
+}
+//# sourceMappingURL=actions.js.map

package/dist/browser/actions.js.map

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

package/dist/browser/manager.d.ts

@@ -0,0 +1,17 @@
+import { type Page } from "playwright";
+import { type DipclawConfig } from "../config/types.js";
+export declare class BrowserManager {
+    private browser;
+    private context;
+    private chromeProcess;
+    private config;
+    private proxyAuth;
+    constructor(config: DipclawConfig);
+    launch(): Promise<void>;
+    getActivePage(): Promise<Page>;
+    getPages(): Promise<Page[]>;
+    newPage(): Promise<Page>;
+    close(): Promise<void>;
+    private setupProxyAuth;
+    isLaunched(): boolean;
+}

package/dist/browser/manager.js

@@ -0,0 +1,249 @@
+import { chromium, } from "playwright";
+import { spawn } from "node:child_process";
+import path from "node:path";
+import fs from "node:fs";
+import net from "node:net";
+import os from "node:os";
+export class BrowserManager {
+    browser = null;
+    context = null;
+    chromeProcess = null;
+    config;
+    proxyAuth = null;
+    constructor(config) {
+        this.config = config;
+    }
+    async launch() {
+        if (this.context)
+            return;
+        const userDataDir = path.join(this.config.workspace, "browser-data");
+        fs.mkdirSync(userDataDir, { recursive: true });
+        const chromePath = findChromeExecutable();
+        if (!chromePath) {
+            throw new Error("Chrome not found. Please install Google Chrome or set --chrome-path.");
+        }
+        const port = await findFreePort();
+        // Extract proxy credentials if configured
+        if (this.config.browser.proxy) {
+            const p = this.config.browser.proxy;
+            if (p.username && p.password) {
+                this.proxyAuth = { username: p.username, password: p.password };
+            }
+        }
+        const args = buildChromeArgs(userDataDir, port, this.config);
+        // Spawn system Chrome
+        this.chromeProcess = spawn(chromePath, args, {
+            stdio: ["ignore", "ignore", "pipe"],
+            env: { ...process.env, HOME: os.homedir() },
+            detached: false,
+        });
+        // Wait for Chrome to start and expose the CDP port
+        const endpoint = await waitForCdpEndpoint(port);
+        // Connect Playwright via CDP
+        this.browser = await chromium.connectOverCDP(endpoint);
+        this.context = this.browser.contexts()[0] ?? (await this.browser.newContext());
+        // Set up proxy authentication if credentials are present
+        if (this.proxyAuth) {
+            for (const page of this.context.pages()) {
+                await this.setupProxyAuth(page);
+            }
+            this.context.on("page", (page) => this.setupProxyAuth(page));
+        }
+        const proxyInfo = this.config.browser.proxy
+            ? `${this.config.browser.proxy.protocol}://${this.config.browser.proxy.host}:${this.config.browser.proxy.port}`
+            : "none";
+        console.log(`🌐 Browser launched (Chrome @ ${chromePath}, profile: ${this.config.name}, CDP port: ${port}, proxy: ${proxyInfo})`);
+    }
+    async getActivePage() {
+        if (!this.context) {
+            await this.launch();
+        }
+        const pages = this.context.pages();
+        if (pages.length === 0) {
+            return await this.context.newPage();
+        }
+        return pages[pages.length - 1];
+    }
+    async getPages() {
+        if (!this.context) {
+            await this.launch();
+        }
+        return this.context.pages();
+    }
+    async newPage() {
+        if (!this.context) {
+            await this.launch();
+        }
+        return await this.context.newPage();
+    }
+    async close() {
+        if (this.browser) {
+            await this.browser.close().catch(() => { });
+            this.browser = null;
+            this.context = null;
+        }
+        if (this.chromeProcess) {
+            const proc = this.chromeProcess;
+            this.chromeProcess = null;
+            // Wait for Chrome to fully exit and flush data (cookies, sessions) to disk
+            await new Promise((resolve) => {
+                proc.on("exit", () => resolve());
+                proc.kill("SIGTERM");
+                // Force kill after 5s if Chrome hangs
+                setTimeout(() => {
+                    proc.kill("SIGKILL");
+                    resolve();
+                }, 5000);
+            });
+        }
+    }
+    async setupProxyAuth(page) {
+        if (!this.proxyAuth)
+            return;
+        const { username, password } = this.proxyAuth;
+        const client = await this.context.newCDPSession(page);
+        await client.send("Fetch.enable", { handleAuthRequests: true });
+        client.on("Fetch.authRequired", (event) => {
+            client
+                .send("Fetch.continueWithAuth", {
+                requestId: event.requestId,
+                authChallengeResponse: {
+                    response: "ProvideCredentials",
+                    username,
+                    password,
+                },
+            })
+                .catch(() => { });
+        });
+        client.on("Fetch.requestPaused", (event) => {
+            client
+                .send("Fetch.continueRequest", { requestId: event.requestId })
+                .catch(() => { });
+        });
+    }
+    isLaunched() {
+        return this.context !== null;
+    }
+}
+// --- Chrome executable detection ---
+function findChromeExecutable() {
+    const platform = process.platform;
+    if (platform === "darwin") {
+        const paths = [
+            "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+            "/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary",
+            "/Applications/Chromium.app/Contents/MacOS/Chromium",
+            "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
+            "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
+        ];
+        for (const p of paths) {
+            if (fs.existsSync(p))
+                return p;
+        }
+    }
+    else if (platform === "linux") {
+        const paths = [
+            "/usr/bin/google-chrome",
+            "/usr/bin/google-chrome-stable",
+            "/usr/bin/chromium",
+            "/usr/bin/chromium-browser",
+            "/snap/bin/chromium",
+            "/usr/bin/microsoft-edge",
+        ];
+        for (const p of paths) {
+            if (fs.existsSync(p))
+                return p;
+        }
+    }
+    else if (platform === "win32") {
+        const prefixes = [
+            process.env["PROGRAMFILES"] || "C:\\Program Files",
+            process.env["PROGRAMFILES(X86)"] || "C:\\Program Files (x86)",
+            process.env["LOCALAPPDATA"] || "",
+        ];
+        const suffixes = [
+            "Google\\Chrome\\Application\\chrome.exe",
+            "Microsoft\\Edge\\Application\\msedge.exe",
+            "BraveSoftware\\Brave-Browser\\Application\\brave.exe",
+        ];
+        for (const prefix of prefixes) {
+            if (!prefix)
+                continue;
+            for (const suffix of suffixes) {
+                const p = path.join(prefix, suffix);
+                if (fs.existsSync(p))
+                    return p;
+            }
+        }
+    }
+    return null;
+}
+// --- Chrome launch arguments ---
+function buildChromeArgs(userDataDir, port, config) {
+    const args = [
+        `--remote-debugging-port=${port}`,
+        `--user-data-dir=${userDataDir}`,
+        "--no-first-run",
+        "--no-default-browser-check",
+        "--use-mock-keychain",
+        "--disable-background-networking",
+        "--disable-default-apps",
+        "--disable-sync",
+        "--disable-translate",
+        "--metrics-recording-only",
+        "--no-default-browser-check",
+    ];
+    if (config.browser.headless) {
+        args.push("--headless=new");
+    }
+    if (config.browser.proxy) {
+        // Chrome's --proxy-server doesn't support inline auth, pass host:port only
+        const p = config.browser.proxy;
+        args.push(`--proxy-server=${p.protocol}://${p.host}:${p.port}`);
+    }
+    if (config.browser.viewport) {
+        const vp = config.browser.viewport;
+        args.push(`--window-size=${vp.width},${vp.height}`);
+    }
+    else {
+        args.push("--start-maximized");
+    }
+    return args;
+}
+// --- Port & CDP helpers ---
+function findFreePort() {
+    return new Promise((resolve, reject) => {
+        const server = net.createServer();
+        server.listen(0, () => {
+            const addr = server.address();
+            if (addr && typeof addr === "object") {
+                const port = addr.port;
+                server.close(() => resolve(port));
+            }
+            else {
+                reject(new Error("Failed to find free port"));
+            }
+        });
+        server.on("error", reject);
+    });
+}
+async function waitForCdpEndpoint(port, timeoutMs = 15000) {
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+        try {
+            const res = await fetch(`http://127.0.0.1:${port}/json/version`);
+            if (res.ok) {
+                const json = (await res.json());
+                if (json.webSocketDebuggerUrl) {
+                    return json.webSocketDebuggerUrl;
+                }
+            }
+        }
+        catch {
+            // Chrome not ready yet
+        }
+        await new Promise((r) => setTimeout(r, 200));
+    }
+    throw new Error(`Chrome did not start within ${timeoutMs}ms (CDP port ${port})`);
+}
+//# sourceMappingURL=manager.js.map

package/dist/browser/manager.js.map

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

package/dist/browser/script-runner.d.ts

@@ -0,0 +1,49 @@
+import type { BrowserActions } from "./actions.js";
+import type { LlmClient } from "../llm/types.js";
+import type { ExecutionLogger } from "../logging/logger.js";
+export interface SkillStep {
+    action: string;
+    params: Record<string, unknown>;
+    description?: string;
+}
+export interface SkillScript {
+    name: string;
+    description: string;
+    steps: SkillStep[];
+    notes?: string[];
+}
+/** Result of executing a single step */
+export interface StepResult {
+    index: number;
+    action: string;
+    success: boolean;
+    usedFallback: boolean;
+    /** What the LLM actually did when falling back */
+    fallbackAction?: string;
+    error?: string;
+}
+/** Structured report of a full skill execution */
+export interface ExecutionReport {
+    skillName: string;
+    totalSteps: number;
+    successCount: number;
+    fallbackCount: number;
+    failedCount: number;
+    steps: StepResult[];
+    /** Overall success — all steps completed (with or without fallback) */
+    completed: boolean;
+}
+/**
+ * Runs a skill script step-by-step.
+ * Each step tries direct execution first; on failure, falls back to LLM.
+ */
+export declare class ScriptRunner {
+    private actions;
+    private llmClient;
+    private logger;
+    constructor(actions: BrowserActions, llmClient: LlmClient, logger: ExecutionLogger);
+    run(script: SkillScript, variables?: Record<string, string>): Promise<ExecutionReport>;
+    private executeStep;
+    private llmFallback;
+    private resolveVariables;
+}