@hy-sde-org/dsh-browser 0.1.1-rc.2

package/dist/service.d.ts

@@ -0,0 +1,157 @@
+/**
+ * The `ctx.browser` service: an agent-facing browser over Playwright Core CDP.
+ *
+ * Three backends, mirroring omp's browser tool:
+ * - **launch** — spawn a (stealth-patched) browser executable,
+ * - **attach** — connect to an existing CDP endpoint (`cdp_url`), and
+ * - **relay** — connect to the local relay server whose companion Chrome
+ *   extension drives the user's own tabs.
+ *
+ * Tabs are addressed by name (default `main`) per service instance; one
+ * browser connection is shared across tabs. The service owns no durable state
+ * and is conversation/session-scoped by the plugin row that mounts it.
+ *
+ * Port of oh-my-pi's browser (see port_omp.md item: browser tool with
+ * stealth + relay/CDP-attach). Model-facing surface lives in
+ * @hy-sde-org/dsh-tool-browser.
+ * @module @hy-sde-org/dsh-browser/service
+ */
+import { Service, type Context } from '@deepseek-ai/cordis';
+import type { BrowserConfig, BrowserKind, PageObservation, ScreenshotResult } from './types.ts';
+export type { BrowserConfig, BrowserKind, BrowserKindTag, PageObservation, ObservationEntry, ScreenshotResult } from './types.ts';
+/** Navigation wait condition accepted by the tool (Playwright dialect). */
+export type WaitUntil = 'load' | 'domcontentloaded' | 'networkidle' | 'commit';
+/** Map omp/puppeteer-style wait conditions onto Playwright's dialect. */
+export declare function normalizeWaitUntil(value: string | undefined): WaitUntil | undefined;
+/** How a tab is addressed in `close`. */
+export type CloseMode = 'single' | 'all' | 'kill';
+/** One browser connection per (cwd + kind), one tab per name. */
+export declare class BrowserService extends Service {
+    private readonly browserPath;
+    private readonly headless;
+    private readonly viewport;
+    private readonly relayUrl;
+    private readonly relayToken;
+    private readonly timeoutMs;
+    private readonly browsers;
+    private readonly tabs;
+    private relay;
+    constructor(ctx: Context, config?: BrowserConfig);
+    /**
+     * The relay endpoint this instance serves (created lazily in relay kind).
+     * @returns the relay base URL this instance binds or resolves.
+     */
+    relayEndpoint(): string;
+    private browserKeyFor;
+    private connect;
+    private openConnection;
+    /**
+     * Resolve the browser kind for a session (attach/launch/relay), like omp.
+     * @param input - optional app-path, cdp URL, or explicit relay opt-in.
+     * @returns the resolved {@link BrowserKind} to drive.
+     */
+    resolveKind(input: {
+        path?: string;
+        cdpUrl?: string;
+        relay?: boolean;
+    }): BrowserKind;
+    /**
+     * Ensure the relay server is running for this instance (idempotent).
+     * @returns the relay base URL the in-process server is bound to.
+     */
+    ensureRelay(): Promise<string>;
+    private tab;
+    /**
+     * Open (or navigate) a named tab to `url`; returns the page observation.
+     * @param name - tab id; one tab per name, one browser per cwd+kind.
+     * @param url - the URL to navigate to.
+     * @param opts - backend kind, working directory, wait condition, timeout.
+     * @returns the page observation (title, url, ARIA snapshot, size).
+     */
+    open(name: string, url: string, opts: {
+        kind: BrowserKind;
+        cwd: string;
+        waitUntil?: WaitUntil;
+        timeoutMs?: number;
+    }): Promise<PageObservation>;
+    /**
+     * Evaluate `code` in the named tab and return the JSON-serializable value.
+     * @param name - tab id.
+     * @param code - JavaScript body/expression evaluated in the tab's page.
+     * @param opts - backend kind, working directory, timeout.
+     * @returns the evaluated value (JSON-serializable).
+     */
+    run(name: string, code: string, opts: {
+        kind: BrowserKind;
+        cwd: string;
+        timeoutMs?: number;
+    }): Promise<unknown>;
+    /**
+     * Click an ARIA-ref (`aria-ref=e5`) or CSS selector in the named tab.
+     * @param name - tab id.
+     * @param selector - ARIA ref selector or CSS selector.
+     * @param opts - backend kind, working directory.
+     * @returns the re-observed page after the click.
+     */
+    click(name: string, selector: string, opts: {
+        kind: BrowserKind;
+        cwd: string;
+    }): Promise<PageObservation>;
+    /**
+     * Type text into an ARIA-ref or CSS selector in the named tab.
+     * @param name - tab id.
+     * @param selector - ARIA ref selector or CSS selector.
+     * @param text - the text to fill.
+     * @param opts - backend kind, working directory.
+     * @returns the re-observed page after the fill.
+     */
+    type(name: string, selector: string, text: string, opts: {
+        kind: BrowserKind;
+        cwd: string;
+    }): Promise<PageObservation>;
+    /**
+     * Close named tabs; `all` closes every tab, `kill` also closes browsers.
+     * @param name - tab id.
+     * @param opts - backend kind, working directory, close-all and kill flags.
+     * @returns a promise resolving once the close is initiated.
+     */
+    close(name: string, opts: {
+        kind: BrowserKind;
+        cwd: string;
+        all?: boolean;
+        kill?: boolean;
+    }): Promise<void>;
+    /**
+     * Screenshot the named tab to a PNG file; returns the written path.
+     * @param name - tab id.
+     * @param destination - the PNG file path to write.
+     * @param opts - backend kind, working directory, full-page flag.
+     * @returns the written screenshot path.
+     */
+    screenshot(name: string, destination: string, opts: {
+        kind: BrowserKind;
+        cwd: string;
+        fullPage?: boolean;
+    }): Promise<ScreenshotResult>;
+    /**
+     * Observe the named tab (title, url, size, ARIA snapshot) without navigating.
+     * @param name - tab id.
+     * @param opts - backend kind, working directory.
+     * @returns the page observation.
+     */
+    observe(name: string, opts: {
+        kind: BrowserKind;
+        cwd: string;
+    }): Promise<PageObservation>;
+    /** Observe a page: title, url, size, and the ARIA snapshot. */
+    private observePage;
+    /** Close every browser connection and stop the relay (cleanup on ctx dispose). */
+    stop(): void;
+    /** Number of open browser connections (tests / diagnostics). */
+    get browserCount(): number;
+}
+export { captureAriaSnapshot, resolveAriaRefElement } from './aria.ts';
+export { startRelayServer, type RelayServer } from './relay/server.ts';
+export { resolveRelayKind, DEFAULT_RELAY_URL } from './relay/kind.ts';
+export { DEFAULT_VIEWPORT, STEALTH_LAUNCH_ARGS, stealthIgnoreDefaultArgs, resolveUserAgentOverride, applyUserAgentOverride, type UserAgentOverride, } from './stealth.ts';
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

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

package/dist/service.js

@@ -0,0 +1,291 @@
+/**
+ * The `ctx.browser` service: an agent-facing browser over Playwright Core CDP.
+ *
+ * Three backends, mirroring omp's browser tool:
+ * - **launch** — spawn a (stealth-patched) browser executable,
+ * - **attach** — connect to an existing CDP endpoint (`cdp_url`), and
+ * - **relay** — connect to the local relay server whose companion Chrome
+ *   extension drives the user's own tabs.
+ *
+ * Tabs are addressed by name (default `main`) per service instance; one
+ * browser connection is shared across tabs. The service owns no durable state
+ * and is conversation/session-scoped by the plugin row that mounts it.
+ *
+ * Port of oh-my-pi's browser (see port_omp.md item: browser tool with
+ * stealth + relay/CDP-attach). Model-facing surface lives in
+ * @hy-sde-org/dsh-tool-browser.
+ * @module @hy-sde-org/dsh-browser/service
+ */
+import { Service } from '@deepseek-ai/cordis';
+import { chromium } from 'playwright-core';
+import { captureAriaSnapshot, resolveAriaRefElement } from "./aria.js";
+import { DEFAULT_VIEWPORT, STEALTH_LAUNCH_ARGS, applyUserAgentOverride, preparePage, resolveUserAgentOverride, stealthIgnoreDefaultArgs, } from "./stealth.js";
+import { startRelayServer } from "./relay/server.js";
+import { resolveRelayKind } from "./relay/kind.js";
+/** Map omp/puppeteer-style wait conditions onto Playwright's dialect. */
+export function normalizeWaitUntil(value) {
+    if (value === 'networkidle0' || value === 'networkidle2')
+        return 'networkidle';
+    if (value === 'load' || value === 'domcontentloaded' || value === 'networkidle' || value === 'commit') {
+        return value;
+    }
+    return undefined;
+}
+const DEFAULT_TIMEOUT_MS = 30_000;
+/** One browser connection per (cwd + kind), one tab per name. */
+export class BrowserService extends Service {
+    browserPath;
+    headless;
+    viewport;
+    relayUrl;
+    relayToken;
+    timeoutMs;
+    browsers = new Map();
+    tabs = new Map();
+    relay;
+    constructor(ctx, config = {}) {
+        super(ctx, 'browser');
+        this.browserPath = config.browserPath;
+        this.headless = config.headless ?? true;
+        this.viewport = config.viewport ?? DEFAULT_VIEWPORT;
+        this.relayUrl = config.relayUrl?.replace(/\/+$/, '') ?? 'http://127.0.0.1:9224';
+        this.relayToken = config.relayToken;
+        this.timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    }
+    /**
+     * The relay endpoint this instance serves (created lazily in relay kind).
+     * @returns the relay base URL this instance binds or resolves.
+     */
+    relayEndpoint() {
+        return this.relay ? `http://127.0.0.1:${this.relay.port}` : this.relayUrl;
+    }
+    browserKeyFor(kind, cwd) {
+        if (kind.kind === 'launch')
+            return `launch:${cwd}`;
+        return `${kind.kind}:${'cdpUrl' in kind ? kind.cdpUrl : ''}`;
+    }
+    async connect(kind, cwd) {
+        const key = this.browserKeyFor(kind, cwd);
+        const existing = this.browsers.get(key);
+        if (existing)
+            return existing;
+        const entry = await this.openConnection(kind, cwd);
+        this.browsers.set(key, entry);
+        return entry;
+    }
+    async openConnection(kind, cwd) {
+        if (kind.kind === 'launch') {
+            const executablePath = kind.path ?? this.browserPath;
+            const launchOptions = {
+                executablePath,
+                headless: this.headless,
+                args: [...STEALTH_LAUNCH_ARGS],
+                ignoreDefaultArgs: stealthIgnoreDefaultArgs(executablePath),
+            };
+            const browser = await chromium.launch(launchOptions);
+            void applyUserAgentOverride(browser, await resolveUserAgentOverride(browser));
+            return { kind, browser, headless: this.headless, cwd };
+        }
+        // attach + relay both speak Chrome CDP discovery; the relay impersonates it.
+        const browser = await chromium.connectOverCDP(kind.cdpUrl);
+        return { kind, browser, headless: false, cwd };
+    }
+    /**
+     * Resolve the browser kind for a session (attach/launch/relay), like omp.
+     * @param input - optional app-path, cdp URL, or explicit relay opt-in.
+     * @returns the resolved {@link BrowserKind} to drive.
+     */
+    resolveKind(input) {
+        if (input.cdpUrl)
+            return { kind: 'attach', cdpUrl: input.cdpUrl.replace(/\/+$/, '') };
+        if (input.path)
+            return { kind: 'launch', path: input.path };
+        const relay = resolveRelayKind({ settingEnabled: input.relay ?? false, url: this.relayUrl });
+        if (relay)
+            return { kind: 'relay', cdpUrl: relay.cdpUrl };
+        return this.browserPath !== undefined ? { kind: 'launch', path: this.browserPath } : { kind: 'launch' };
+    }
+    /**
+     * Ensure the relay server is running for this instance (idempotent).
+     * @returns the relay base URL the in-process server is bound to.
+     */
+    async ensureRelay() {
+        if (this.relay)
+            return this.relayEndpoint();
+        const port = Number(new URL(this.relayUrl).port || 80);
+        const server = await startRelayServer({
+            port,
+            ...(this.relayToken !== undefined ? { token: this.relayToken } : {}),
+            // fall back to an ephemeral port if the default is taken
+            log: () => { },
+        });
+        this.relay = server;
+        return this.relayEndpoint();
+    }
+    async tab(name, kind, cwd) {
+        const existing = this.tabs.get(name);
+        if (existing)
+            return existing;
+        const entry = await this.connect(kind, cwd);
+        const page = await entry.browser.newPage({ viewport: this.viewport });
+        if (entry.kind.kind === 'launch')
+            await preparePage(page);
+        const tab = { page, browserKey: this.browserKeyFor(kind, cwd), name };
+        this.tabs.set(name, tab);
+        return tab;
+    }
+    /**
+     * Open (or navigate) a named tab to `url`; returns the page observation.
+     * @param name - tab id; one tab per name, one browser per cwd+kind.
+     * @param url - the URL to navigate to.
+     * @param opts - backend kind, working directory, wait condition, timeout.
+     * @returns the page observation (title, url, ARIA snapshot, size).
+     */
+    async open(name, url, opts) {
+        const tab = await this.tab(name, opts.kind, opts.cwd);
+        await tab.page.goto(url, {
+            waitUntil: normalizeWaitUntil(opts.waitUntil) ?? 'load',
+            timeout: opts.timeoutMs ?? this.timeoutMs,
+        });
+        return this.observePage(tab.page);
+    }
+    /**
+     * Evaluate `code` in the named tab and return the JSON-serializable value.
+     * @param name - tab id.
+     * @param code - JavaScript body/expression evaluated in the tab's page.
+     * @param opts - backend kind, working directory, timeout.
+     * @returns the evaluated value (JSON-serializable).
+     */
+    async run(name, code, opts) {
+        const tab = await this.tab(name, opts.kind, opts.cwd);
+        return tab.page.evaluate(code);
+    }
+    /**
+     * Click an ARIA-ref (`aria-ref=e5`) or CSS selector in the named tab.
+     * @param name - tab id.
+     * @param selector - ARIA ref selector or CSS selector.
+     * @param opts - backend kind, working directory.
+     * @returns the re-observed page after the click.
+     */
+    async click(name, selector, opts) {
+        const tab = await this.tab(name, opts.kind, opts.cwd);
+        const ref = selector.trim();
+        const bareRef = ref.startsWith('aria-ref=') ? ref.split('=')[1] ?? '' : ref.startsWith('aria-ref/') || ref.startsWith('ariaref/') ? ref.split('/').pop() ?? '' : undefined;
+        if (bareRef !== undefined) {
+            const target = await resolveAriaRefElement(tab.page, bareRef);
+            if (target === null)
+                throw new Error(`browser: aria ref ${bareRef} no longer matches any element (re-snapshot)`);
+            await target.click();
+        }
+        else {
+            await tab.page.locator(ref).first().click();
+        }
+        return this.observePage(tab.page);
+    }
+    /**
+     * Type text into an ARIA-ref or CSS selector in the named tab.
+     * @param name - tab id.
+     * @param selector - ARIA ref selector or CSS selector.
+     * @param text - the text to fill.
+     * @param opts - backend kind, working directory.
+     * @returns the re-observed page after the fill.
+     */
+    async type(name, selector, text, opts) {
+        const tab = await this.tab(name, opts.kind, opts.cwd);
+        const ref = selector.trim();
+        const bareRef = ref.startsWith('aria-ref=') ? ref.split('=')[1] ?? '' : ref.startsWith('aria-ref/') || ref.startsWith('ariaref/') ? ref.split('/').pop() ?? '' : undefined;
+        if (bareRef !== undefined) {
+            const target = await resolveAriaRefElement(tab.page, bareRef);
+            if (target === null)
+                throw new Error(`browser: aria ref ${bareRef} no longer matches any element (re-snapshot)`);
+            await target.fill(text);
+        }
+        else {
+            await tab.page.locator(ref).first().fill(text);
+        }
+        return this.observePage(tab.page);
+    }
+    /**
+     * Close named tabs; `all` closes every tab, `kill` also closes browsers.
+     * @param name - tab id.
+     * @param opts - backend kind, working directory, close-all and kill flags.
+     * @returns a promise resolving once the close is initiated.
+     */
+    async close(name, opts) {
+        const entry = this.browsers.get(this.browserKeyFor(opts.kind, opts.cwd));
+        if (opts.all) {
+            for (const [tabName, tab] of this.tabs) {
+                void tab.page.close().catch(() => { });
+                this.tabs.delete(tabName);
+            }
+            if (opts.kill && entry) {
+                await entry.browser.close().catch(() => { });
+                this.browsers.delete(this.browserKeyFor(opts.kind, opts.cwd));
+            }
+            return;
+        }
+        const tab = this.tabs.get(name);
+        if (!tab)
+            return;
+        void tab.page.close().catch(() => { });
+        this.tabs.delete(name);
+        if (opts.kill && entry) {
+            void entry.browser.close().catch(() => { });
+            this.browsers.delete(this.browserKeyFor(opts.kind, opts.cwd));
+        }
+    }
+    /**
+     * Screenshot the named tab to a PNG file; returns the written path.
+     * @param name - tab id.
+     * @param destination - the PNG file path to write.
+     * @param opts - backend kind, working directory, full-page flag.
+     * @returns the written screenshot path.
+     */
+    async screenshot(name, destination, opts) {
+        const tab = await this.tab(name, opts.kind, opts.cwd);
+        await tab.page.screenshot({ path: destination, ...(opts.fullPage !== undefined ? { fullPage: opts.fullPage } : {}) });
+        return { path: destination };
+    }
+    /**
+     * Observe the named tab (title, url, size, ARIA snapshot) without navigating.
+     * @param name - tab id.
+     * @param opts - backend kind, working directory.
+     * @returns the page observation.
+     */
+    async observe(name, opts) {
+        const tab = await this.tab(name, opts.kind, opts.cwd);
+        return this.observePage(tab.page);
+    }
+    /** Observe a page: title, url, size, and the ARIA snapshot. */
+    async observePage(page) {
+        const [title, aria] = await Promise.all([page.title().catch(() => ''), captureAriaSnapshot(page, null, {})]);
+        const url = page.url();
+        const viewport = page.viewportSize();
+        return {
+            title,
+            url,
+            aria,
+            width: viewport?.width ?? 0,
+            height: viewport?.height ?? 0,
+        };
+    }
+    /** Close every browser connection and stop the relay (cleanup on ctx dispose). */
+    stop() {
+        for (const entry of this.browsers.values()) {
+            void entry.browser.close().catch(() => { });
+        }
+        this.browsers.clear();
+        this.tabs.clear();
+        this.relay?.stop();
+        this.relay = undefined;
+    }
+    /** Number of open browser connections (tests / diagnostics). */
+    get browserCount() {
+        return this.browsers.size;
+    }
+}
+export { captureAriaSnapshot, resolveAriaRefElement } from "./aria.js";
+export { startRelayServer } from "./relay/server.js";
+export { resolveRelayKind, DEFAULT_RELAY_URL } from "./relay/kind.js";
+export { DEFAULT_VIEWPORT, STEALTH_LAUNCH_ARGS, stealthIgnoreDefaultArgs, resolveUserAgentOverride, applyUserAgentOverride, } from "./stealth.js";
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

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

package/dist/stealth-scripts.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Stealth init scripts ported verbatim from oh-my-pi (MIT — see port_omp.md).
+ * Each script runs in every new document; together they hide Playwright/Puppeteer
+ * fingerprints: navigator.webdriver, automation UA + client hints, sourceURL
+ * tampering, fonts, WebGL, canvas/audio, plugins, hardware, codecs, workers, locale.
+ * Generated — regenerate from omp `packages/coding-agent/src/tools/puppeteer/*.txt`.
+ */
+import type { Page } from 'playwright-core';
+/** Run every stealth script in a freshly created page; call before navigation. */
+export declare function installStealth(page: Page): Promise<void>;
+//# sourceMappingURL=stealth-scripts.d.ts.map

package/dist/stealth-scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stealth-scripts.d.ts","sourceRoot":"","sources":["../src/stealth-scripts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAy9D3C,kFAAkF;AAClF,wBAAsB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D"}