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

package/dist/stealth-scripts.js.map

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

package/dist/stealth.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Stealth browser launch + user-agent spoofing, ported from oh-my-pi's
+ * `packages/coding-agent/src/tools/browser/launch.ts` (MIT, see port_omp.md).
+ *
+ * Puppeteer's `--enable-automation` flag sets `navigator.webdriver=true` and
+ * shows the "controlled by automated software" infobar. Playwright's default
+ * launch adds a similar set; we suppress the machine-tell flags and apply an
+ * `Emulation.setUserAgentOverride` (+ client hints) on every target so a
+ * launched browser looks like a normal Chrome install.
+ * @module @hy-sde-org/dsh-browser/stealth
+ */
+import type { Browser, CDPSession, Page } from 'playwright-core';
+/** Default viewport used for launched browsers. */
+export declare const DEFAULT_VIEWPORT: {
+    readonly width: 1365;
+    readonly height: 768;
+    readonly deviceScaleFactor: 1.25;
+};
+/** Default flags suppressed: Edge keeps `--enable-automation` (stability). */
+export declare function stealthIgnoreDefaultArgs(executablePath?: string): string[];
+/** Additional launch args reducing automation fingerprints. */
+export declare const STEALTH_LAUNCH_ARGS: readonly ["--disable-blink-features=AutomationControlled", "--no-first-run", "--no-default-browser-check", "--disable-background-networking", "--disable-component-update", "--disable-sync", "--disable-features=Translate,PrivacySandboxSettings4", "--disable-domain-reliability", "--disable-breakpad"];
+/** User-agent + client-hints override, mirroring omp's `UserAgentOverride`. */
+export interface UserAgentOverride {
+    userAgent: string;
+    platform: string;
+    acceptLanguage: string;
+    userAgentMetadata: {
+        brands: Array<{
+            brand: string;
+            version: string;
+        }>;
+        fullVersion: string;
+        fullVersionList: Array<{
+            brand: string;
+            version: string;
+        }>;
+        platform: string;
+        platformVersion: string;
+        architecture: string;
+        bitness: string;
+        model: string;
+        mobile: boolean;
+    };
+}
+/** Derive a realistic chrome UA (+ client hints) from a Playwright browser. */
+export declare function resolveUserAgentOverride(browser: Browser): Promise<UserAgentOverride>;
+/**
+ * Apply the UA override on the browser session. Playwright (unlike Puppeteer)
+ * does not expose child sessions through `CDPSession.connection`, so the
+ * per-target override is applied on each page through
+ * {@link applyUserAgentToPage} after creation — the service calls both for
+ * every launched page.
+ */
+export declare function configureUserAgentTargets(browser: Browser, override: UserAgentOverride): Promise<CDPSession | null>;
+/** Apply the UA override to one page (launched or attached). */
+export declare function applyUserAgentToPage(page: Page, override: UserAgentOverride): Promise<void>;
+/** Apply all stealth init scripts to a just-created page (before navigation). */
+export declare function preparePage(page: Page): Promise<void>;
+/** Apply the spoofed UA override to a new browser connection (once per browser). */
+export declare function applyUserAgentOverride(browser: Browser, override: UserAgentOverride): Promise<CDPSession | null>;
+//# sourceMappingURL=stealth.d.ts.map

package/dist/stealth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stealth.d.ts","sourceRoot":"","sources":["../src/stealth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAGhE,mDAAmD;AACnD,eAAO,MAAM,gBAAgB;;;;CAAiE,CAAA;AAuB9F,8EAA8E;AAC9E,wBAAgB,wBAAwB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAG1E;AAED,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB,6SAUtB,CAAA;AAEV,+EAA+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE;QACjB,MAAM,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;QACjD,WAAW,EAAE,MAAM,CAAA;QACnB,eAAe,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;QAC1D,QAAQ,EAAE,MAAM,CAAA;QAChB,eAAe,EAAE,MAAM,CAAA;QACvB,YAAY,EAAE,MAAM,CAAA;QACpB,OAAO,EAAE,MAAM,CAAA;QACf,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,OAAO,CAAA;KAChB,CAAA;CACF;AAYD,+EAA+E;AAC/E,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA2E3F;AAoBD;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAQ5B;AAED,gEAAgE;AAChE,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQjG;AAED,iFAAiF;AACjF,wBAAsB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3D;AAED,oFAAoF;AACpF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAEhH"}

package/dist/stealth.js

@@ -0,0 +1,194 @@
+/**
+ * Stealth browser launch + user-agent spoofing, ported from oh-my-pi's
+ * `packages/coding-agent/src/tools/browser/launch.ts` (MIT, see port_omp.md).
+ *
+ * Puppeteer's `--enable-automation` flag sets `navigator.webdriver=true` and
+ * shows the "controlled by automated software" infobar. Playwright's default
+ * launch adds a similar set; we suppress the machine-tell flags and apply an
+ * `Emulation.setUserAgentOverride` (+ client hints) on every target so a
+ * launched browser looks like a normal Chrome install.
+ * @module @hy-sde-org/dsh-browser/stealth
+ */
+import { installStealth } from "./stealth-scripts.js";
+/** Default viewport used for launched browsers. */
+export const DEFAULT_VIEWPORT = { width: 1365, height: 768, deviceScaleFactor: 1.25 };
+const ENABLE_AUTOMATION_FLAG = '--enable-automation';
+/** Puppeteer/Playwright automation-tell launch flags to suppress (when present). */
+const STEALTH_IGNORE_DEFAULT_ARGS = [
+    ENABLE_AUTOMATION_FLAG,
+    '--disable-extensions',
+    '--disable-default-apps',
+    '--disable-component-extensions-with-background-pages',
+    '--disable-popup-blocking',
+    '--disable-client-side-phishing-detection',
+    '--allow-pre-commit-input',
+    '--disable-ipc-flooding-protection',
+    '--metrics-recording-only',
+];
+function isEdgeExecutable(executablePath) {
+    if (!executablePath)
+        return false;
+    const name = executablePath.replaceAll('\\', '/').split('/').pop()?.toLowerCase() ?? '';
+    return name === 'msedge.exe' || name === 'microsoft edge' || name.startsWith('microsoft-edge');
+}
+/** Default flags suppressed: Edge keeps `--enable-automation` (stability). */
+export function stealthIgnoreDefaultArgs(executablePath) {
+    if (!isEdgeExecutable(executablePath))
+        return [...STEALTH_IGNORE_DEFAULT_ARGS];
+    return STEALTH_IGNORE_DEFAULT_ARGS.filter(arg => arg !== ENABLE_AUTOMATION_FLAG);
+}
+/** Additional launch args reducing automation fingerprints. */
+export const STEALTH_LAUNCH_ARGS = [
+    '--disable-blink-features=AutomationControlled',
+    '--no-first-run',
+    '--no-default-browser-check',
+    '--disable-background-networking',
+    '--disable-component-update',
+    '--disable-sync',
+    '--disable-features=Translate,PrivacySandboxSettings4',
+    '--disable-domain-reliability',
+    '--disable-breakpad',
+];
+function hostArchitecture() {
+    if (process.arch === 'arm64')
+        return 'arm';
+    if (process.arch.includes('64'))
+        return 'x86';
+    return '';
+}
+function hostBitness() {
+    return process.arch.includes('64') ? '64' : '';
+}
+/** Derive a realistic chrome UA (+ client hints) from a Playwright browser. */
+export async function resolveUserAgentOverride(browser) {
+    let rawUserAgent = '';
+    try {
+        const session = await browser.newBrowserCDPSession();
+        const version = (await session.send('Browser.getVersion'));
+        rawUserAgent = version.userAgent ?? '';
+        await session.detach();
+    }
+    catch {
+        rawUserAgent = '';
+    }
+    if (!rawUserAgent) {
+        const version = browser.version();
+        rawUserAgent = `Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/${version} Safari/537.36`;
+    }
+    let userAgent = rawUserAgent.replace('HeadlessChrome/', 'Chrome/');
+    if (userAgent.includes('Linux') && !userAgent.includes('Android')) {
+        userAgent = userAgent.replace(/\(([^)]+)\)/, '(Windows NT 10.0; Win64; x64)');
+    }
+    const uaVersionMatch = userAgent.match(/Chrome\/([\d.]+)/);
+    const browserVersionMatch = (browser.version()).match(/\/([\d.]+)/);
+    const legacyVersion = uaVersionMatch?.[1] ?? browserVersionMatch?.[1] ?? '0';
+    const fullVersion = browserVersionMatch?.[1] ?? legacyVersion;
+    const majorVersion = Number.parseInt(legacyVersion.split('.')[0] ?? '0', 10) || 0;
+    const isAndroid = userAgent.includes('Android');
+    const isMac = userAgent.includes('Mac OS X');
+    const isWindows = userAgent.includes('Windows');
+    const platform = isMac ? 'MacIntel' : isAndroid ? 'Android' : userAgent.includes('Linux') ? 'Linux' : 'Win32';
+    const platformFull = isMac ? 'macOS' : isAndroid ? 'Android' : userAgent.includes('Linux') ? 'Linux' : 'Windows';
+    const platformVersion = isMac
+        ? ''
+        : isAndroid
+            ? (userAgent.match(/Android ([^;]+)/)?.[1] ?? '')
+            : isWindows
+                ? (userAgent.match(/Windows NT ([\d.]+)/)?.[1] ?? '')
+                : '';
+    const architecture = isAndroid ? '' : hostArchitecture();
+    const bitness = isAndroid ? '' : hostBitness();
+    const model = isAndroid ? (userAgent.match(/Android.*?;\s([^)]+)/)?.[1] ?? '') : '';
+    const brandOrders = [
+        [0, 1, 2],
+        [0, 2, 1],
+        [1, 0, 2],
+        [1, 2, 0],
+        [2, 0, 1],
+        [2, 1, 0],
+    ];
+    const order = brandOrders[majorVersion % brandOrders.length] ?? brandOrders[0];
+    const escapedChars = [' ', ' ', ';'];
+    const greaseyBrand = `Not${escapedChars[order[0]]}A${escapedChars[order[1]]}${escapedChars[order[2]]}Brand`;
+    const brands = [];
+    brands[order[0]] = { brand: greaseyBrand, version: '99' };
+    brands[order[1]] = { brand: 'Chromium', version: String(majorVersion) };
+    brands[order[2]] = { brand: 'Google Chrome', version: String(majorVersion) };
+    const fullVersionList = brands.map(({ brand }) => ({
+        brand,
+        version: brand === greaseyBrand ? '99.0.0.0' : fullVersion,
+    }));
+    return {
+        userAgent,
+        platform,
+        acceptLanguage: 'en-US,en',
+        userAgentMetadata: {
+            brands,
+            fullVersion,
+            fullVersionList,
+            platform: platformFull,
+            platformVersion,
+            architecture,
+            bitness,
+            model,
+            mobile: isAndroid,
+        },
+    };
+}
+async function sendUserAgentOverride(session, override) {
+    try {
+        await session.send('Network.enable');
+    }
+    catch {
+        // page/browser may already have Network enabled — ignore
+    }
+    try {
+        await session.send('Network.setUserAgentOverride', { ...override });
+    }
+    catch {
+        // ignore per-target failure; Emulation override below is the important one
+    }
+    try {
+        await session.send('Emulation.setUserAgentOverride', { ...override });
+    }
+    catch {
+        // ignore
+    }
+}
+/**
+ * Apply the UA override on the browser session. Playwright (unlike Puppeteer)
+ * does not expose child sessions through `CDPSession.connection`, so the
+ * per-target override is applied on each page through
+ * {@link applyUserAgentToPage} after creation — the service calls both for
+ * every launched page.
+ */
+export async function configureUserAgentTargets(browser, override) {
+    try {
+        const session = await browser.newBrowserCDPSession();
+        await sendUserAgentOverride(session, override);
+        return session;
+    }
+    catch {
+        return null;
+    }
+}
+/** Apply the UA override to one page (launched or attached). */
+export async function applyUserAgentToPage(page, override) {
+    try {
+        const session = await page.context().newCDPSession(page);
+        await sendUserAgentOverride(session, override);
+        await session.detach();
+    }
+    catch {
+        // per-page override is best-effort; the browser-session override still applies
+    }
+}
+/** Apply all stealth init scripts to a just-created page (before navigation). */
+export async function preparePage(page) {
+    await installStealth(page);
+}
+/** Apply the spoofed UA override to a new browser connection (once per browser). */
+export function applyUserAgentOverride(browser, override) {
+    return configureUserAgentTargets(browser, override);
+}
+//# sourceMappingURL=stealth.js.map

package/dist/stealth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stealth.js","sourceRoot":"","sources":["../src/stealth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAErD,mDAAmD;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAW,CAAA;AAE9F,MAAM,sBAAsB,GAAG,qBAAqB,CAAA;AAEpD,oFAAoF;AACpF,MAAM,2BAA2B,GAAG;IAClC,sBAAsB;IACtB,sBAAsB;IACtB,wBAAwB;IACxB,sDAAsD;IACtD,0BAA0B;IAC1B,0CAA0C;IAC1C,0BAA0B;IAC1B,mCAAmC;IACnC,0BAA0B;CAC3B,CAAA;AAED,SAAS,gBAAgB,CAAC,cAAkC;IAC1D,IAAI,CAAC,cAAc;QAAE,OAAO,KAAK,CAAA;IACjC,MAAM,IAAI,GAAG,cAAc,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;IACvF,OAAO,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,gBAAgB,IAAI,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAA;AAChG,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,wBAAwB,CAAC,cAAuB;IAC9D,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC;QAAE,OAAO,CAAC,GAAG,2BAA2B,CAAC,CAAA;IAC9E,OAAO,2BAA2B,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,sBAAsB,CAAC,CAAA;AAClF,CAAC;AAED,+DAA+D;AAC/D,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,+CAA+C;IAC/C,gBAAgB;IAChB,4BAA4B;IAC5B,iCAAiC;IACjC,4BAA4B;IAC5B,gBAAgB;IAChB,sDAAsD;IACtD,8BAA8B;IAC9B,oBAAoB;CACZ,CAAA;AAoBV,SAAS,gBAAgB;IACvB,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,KAAK,CAAA;IAC1C,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAA;IAC7C,OAAO,EAAE,CAAA;AACX,CAAC;AAED,SAAS,WAAW;IAClB,OAAO,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAA;AAChD,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,OAAgB;IAC7D,IAAI,YAAY,GAAG,EAAE,CAAA;IACrB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAO,OAA0E,CAAC,oBAAoB,EAAE,CAAA;QACxH,MAAM,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAA2B,CAAA;QACpF,YAAY,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAA;QACtC,MAAM,OAAO,CAAC,MAAM,EAAE,CAAA;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,YAAY,GAAG,EAAE,CAAA;IACnB,CAAC;IACD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAA;QACjC,YAAY,GAAG,2FAA2F,OAAO,gBAAgB,CAAA;IACnI,CAAC;IACD,IAAI,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAA;IAClE,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAClE,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,aAAa,EAAE,+BAA+B,CAAC,CAAA;IAC/E,CAAC;IACD,MAAM,cAAc,GAAG,SAAS,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAA;IAC1D,MAAM,mBAAmB,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;IACnE,MAAM,aAAa,GAAG,cAAc,EAAE,CAAC,CAAC,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAA;IAC5E,MAAM,WAAW,GAAG,mBAAmB,EAAE,CAAC,CAAC,CAAC,IAAI,aAAa,CAAA;IAC7D,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;IACjF,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;IAC/C,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;IAC5C,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;IAC/C,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAA;IAC7G,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;IAChH,MAAM,eAAe,GAAG,KAAK;QAC3B,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,SAAS;YACT,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACjD,CAAC,CAAC,SAAS;gBACT,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBACrD,CAAC,CAAC,EAAE,CAAA;IACV,MAAM,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAA;IACxD,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;IAC9C,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAEnF,MAAM,WAAW,GAAG;QAClB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACT,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACT,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACT,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACT,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACT,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;KACD,CAAA;IACV,MAAM,KAAK,GAAG,WAAW,CAAC,YAAY,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAA;IAC9E,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAU,CAAA;IAC7C,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;IAC3G,MAAM,MAAM,GAA8C,EAAE,CAAA;IAC5D,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IACzD,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,YAAY,CAAC,EAAE,CAAA;IACvE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,CAAC,YAAY,CAAC,EAAE,CAAA;IAC5E,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACjD,KAAK;QACL,OAAO,EAAE,KAAK,KAAK,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW;KAC3D,CAAC,CAAC,CAAA;IAEH,OAAO;QACL,SAAS;QACT,QAAQ;QACR,cAAc,EAAE,UAAU;QAC1B,iBAAiB,EAAE;YACjB,MAAM;YACN,WAAW;YACX,eAAe;YACf,QAAQ,EAAE,YAAY;YACtB,eAAe;YACf,YAAY;YACZ,OAAO;YACP,KAAK;YACL,MAAM,EAAE,SAAS;SAClB;KACF,CAAA;AACH,CAAC;AAED,KAAK,UAAU,qBAAqB,CAAC,OAAmB,EAAE,QAA2B;IACnF,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,yDAAyD;IAC3D,CAAC;IACD,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAA;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,2EAA2E;IAC7E,CAAC;IACD,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC,gCAAgC,EAAE,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAA;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAgB,EAChB,QAA2B;IAE3B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAO,OAA0E,CAAC,oBAAoB,EAAE,CAAA;QACxH,MAAM,qBAAqB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;QAC9C,OAAO,OAAO,CAAA;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAU,EAAE,QAA2B;IAChF,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;QACxD,MAAM,qBAAqB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;QAC9C,MAAM,OAAO,CAAC,MAAM,EAAE,CAAA;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,+EAA+E;IACjF,CAAC;AACH,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAU;IAC1C,MAAM,cAAc,CAAC,IAAI,CAAC,CAAA;AAC5B,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,sBAAsB,CAAC,OAAgB,EAAE,QAA2B;IAClF,OAAO,yBAAyB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;AACrD,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Types shared across the browser service, its tool consumer, and tests.
+ * @module @hy-sde-org/dsh-browser/types
+ */
+/** Which browser backend a tab belongs to. */
+export type BrowserKind = {
+    kind: 'launch';
+    path?: string;
+} | {
+    kind: 'attach';
+    cdpUrl: string;
+} | {
+    kind: 'relay';
+    cdpUrl: string;
+};
+export type BrowserKindTag = BrowserKind['kind'];
+/** One live element snapshot row inside an observation's aria tree. */
+export interface ObservationEntry {
+    ref: string;
+    role: string;
+    name: string;
+    description?: string;
+    /** "checked", "pressed", … */
+    state?: string;
+}
+/** Page observation returned by the service to the tool. */
+export interface PageObservation {
+    title: string;
+    url: string;
+    aria: string;
+    width: number;
+    height: number;
+}
+export interface ScreenshotResult {
+    path: string;
+    width?: number;
+    height?: number;
+}
+/** Service configuration for `ctx.browser` (config row values). */
+export interface BrowserConfig {
+    /** Resolvable browser executable path; empty lets Playwright find one. */
+    browserPath?: string;
+    /** Headless mode for launched browsers (default true). */
+    headless?: boolean;
+    /** Default viewport for launched browsers. */
+    viewport?: {
+        width: number;
+        height: number;
+        deviceScaleFactor?: number;
+    };
+    /** Relay endpoint (default `http://127.0.0.1:9224`). */
+    relayUrl?: string;
+    /** Token the extension must present at `ws://…/ext?token=` (unset = open). */
+    relayToken?: string;
+    /** Timeout in ms applied to navigation calls (default 30_000). */
+    timeoutMs?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8CAA8C;AAC9C,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAErC,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;AAEhD,uEAAuE;AACvE,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACxE,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB"}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Types shared across the browser service, its tool consumer, and tests.
+ * @module @hy-sde-org/dsh-browser/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/examples/agent-preset/agent.cordis.yml

@@ -0,0 +1,19 @@
+# User agent preset for @hy-sde-org/dsh-browser on OFFICIAL DeepSeek Harness
+# releases (dsh-v0.1.1-rc.2 and later).
+#
+# Install: copy this directory to ~/.dsh/.agent-presets/<id>/ (pick any id),
+# then select the preset in the Web UI preset picker (or `dsh agent` CLI).
+#
+# The `browser` SERVICE row is added host-wide by the plugin's own
+# cordis.patch.yml when you run `dsh plugin add`; this preset contributes
+# ONLY the model-facing tool row. `@hy-sde-org/dsh-tool-browser` registers no
+# service of its own — it resolves the host instance across the plane
+# boundary, so no realm/isolate is needed here.
+#
+# Copy any other rows from the preset you normally use (persona, bash, todo,
+# ask-user, skills, ...) next to these; only the browser row is special. If
+# the package isn't installed, the loader reports the missing plugin on boot.
+
+- id: tool-browser
+  name: '@hy-sde-org/dsh-tool-browser'
+  config: {}

package/examples/agent-preset/preset.yml

@@ -0,0 +1,3 @@
+name: Agentic Browser
+description: Coding agent with an agentic browser tool — open/run/state over launch (stealth), CDP-attach, or the local relay + extension over the host ctx.browser service. For stock DeepSeek Harness releases (rc.2+).
+order: 8

package/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "@hy-sde-org/dsh-browser",
+  "version": "0.1.1-rc.2",
+  "description": "Agentic browser plumbing for DeepSeek Harness: the host ctx.browser service (launch with stealth, CDP-attach, and a local relay + companion Chrome extension driving the user's own tabs) backing the browser tool in @hy-sde-org/dsh-tool-browser — a standalone plugin with no upstream harness changes required.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "default": "./dist/types.js"
+    },
+    "./service": {
+      "types": "./dist/service.d.ts",
+      "default": "./dist/service.js"
+    },
+    "./stealth": {
+      "types": "./dist/stealth.d.ts",
+      "default": "./dist/stealth.js"
+    },
+    "./aria": {
+      "types": "./dist/aria.d.ts",
+      "default": "./dist/aria.js"
+    },
+    "./relay": {
+      "types": "./dist/relay/index.d.ts",
+      "default": "./dist/relay/index.js"
+    },
+    "./invariant": {
+      "types": "./dist/invariant.d.ts",
+      "default": "./dist/invariant.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "assets",
+    "cordis.patch.yml",
+    "examples/agent-preset/agent.cordis.yml",
+    "examples/agent-preset/preset.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hy-sde/dsh-browser.git"
+  },
+  "license": "MIT",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "playwright-core": "^1.61.1",
+    "ws": "^8.21.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
+    "@types/node": "^24.0.0",
+    "@types/ws": "^8.5.0",
+    "playwright-core": "^1.61.1",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.7",
+    "ws": "^8.21.0"
+  },
+  "keywords": [
+    "deepseek",
+    "agent",
+    "harness",
+    "dsh-plugin",
+    "browser",
+    "cdp",
+    "chrome"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc -p tsconfig.build.json && cp -r src/assets dist/assets",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}