@anweat/dsh-browser 0.1.7 → 0.1.9

package/lib/usage-policy.js

@@ -0,0 +1,171 @@
+/** Bounded, approval-independent buffering for browser and crawler traffic. */
+const DEFAULT_POLICY = {
+    minDelayMs: 750,
+    maxConcurrency: 2,
+    burst: 3,
+    maxPagesPerRun: 20,
+    maxDepth: 2,
+    retryLimit: 2,
+    backoffBaseMs: 1_000,
+    cooldownMs: 30_000,
+};
+function boundedInteger(name, value, fallback, min, max) {
+    const resolved = value ?? fallback;
+    if (!Number.isInteger(resolved) || Number(resolved) < min || Number(resolved) > max) {
+        throw new Error(`usagePolicy.${name} must be an integer from ${min} to ${max}`);
+    }
+    return Number(resolved);
+}
+export function resolveUsagePolicy(input) {
+    return {
+        minDelayMs: boundedInteger('minDelayMs', input?.minDelayMs, DEFAULT_POLICY.minDelayMs, 0, 60_000),
+        maxConcurrency: boundedInteger('maxConcurrency', input?.maxConcurrency, DEFAULT_POLICY.maxConcurrency, 1, 8),
+        burst: boundedInteger('burst', input?.burst, DEFAULT_POLICY.burst, 1, 20),
+        maxPagesPerRun: boundedInteger('maxPagesPerRun', input?.maxPagesPerRun, DEFAULT_POLICY.maxPagesPerRun, 1, 100),
+        maxDepth: boundedInteger('maxDepth', input?.maxDepth, DEFAULT_POLICY.maxDepth, 0, 5),
+        retryLimit: boundedInteger('retryLimit', input?.retryLimit, DEFAULT_POLICY.retryLimit, 0, 5),
+        backoffBaseMs: boundedInteger('backoffBaseMs', input?.backoffBaseMs, DEFAULT_POLICY.backoffBaseMs, 1, 60_000),
+        cooldownMs: boundedInteger('cooldownMs', input?.cooldownMs, DEFAULT_POLICY.cooldownMs, 100, 300_000),
+    };
+}
+function abortedError() {
+    return new Error('usage policy wait aborted');
+}
+function delay(ms, signal) {
+    if (signal?.aborted)
+        return Promise.reject(abortedError());
+    if (ms <= 0)
+        return Promise.resolve();
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            signal?.removeEventListener('abort', onAbort);
+            reject(abortedError());
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+export class UsageGovernor {
+    policy;
+    active = 0;
+    globalWaiters = [];
+    hosts = new Map();
+    queued = 0;
+    totalRuns = 0;
+    totalWaitMs = 0;
+    backoffEvents = 0;
+    constructor(policy) {
+        this.policy = policy;
+    }
+    host(url) {
+        let key;
+        try {
+            key = new URL(url).hostname.toLowerCase();
+        }
+        catch {
+            throw new Error('usage policy requires an absolute HTTP(S) URL');
+        }
+        if (!key)
+            throw new Error('usage policy requires a URL hostname');
+        let state = this.hosts.get(key);
+        if (!state) {
+            state = { starts: [], blockedUntil: 0, consecutiveFailures: 0 };
+            this.hosts.set(key, state);
+        }
+        return { key, state };
+    }
+    async acquireGlobal(signal) {
+        if (signal?.aborted)
+            throw abortedError();
+        if (this.active < this.policy.maxConcurrency) {
+            this.active++;
+            return;
+        }
+        this.queued++;
+        await new Promise((resolve, reject) => {
+            const resume = () => {
+                signal?.removeEventListener('abort', onAbort);
+                this.queued--;
+                resolve();
+            };
+            const onAbort = () => {
+                const index = this.globalWaiters.indexOf(resume);
+                if (index >= 0)
+                    this.globalWaiters.splice(index, 1);
+                signal?.removeEventListener('abort', onAbort);
+                this.queued--;
+                reject(abortedError());
+            };
+            this.globalWaiters.push(resume);
+            signal?.addEventListener('abort', onAbort, { once: true });
+        });
+    }
+    releaseGlobal() {
+        const next = this.globalWaiters.shift();
+        if (next)
+            next();
+        else
+            this.active--;
+    }
+    async acquireHost(state, signal) {
+        while (true) {
+            const now = Date.now();
+            const windowStart = now - this.policy.minDelayMs;
+            state.starts = state.starts.filter(start => start > windowStart);
+            const burstReady = state.starts.length < this.policy.burst;
+            const readyAt = Math.max(state.blockedUntil, burstReady ? now : (state.starts[0] ?? now) + this.policy.minDelayMs);
+            if (readyAt <= now) {
+                state.starts.push(now);
+                return;
+            }
+            const waitMs = readyAt - now;
+            this.totalWaitMs += waitMs;
+            await delay(waitMs, signal);
+        }
+    }
+    async run(url, operation, signal) {
+        const { state } = this.host(url);
+        await this.acquireGlobal(signal);
+        try {
+            await this.acquireHost(state, signal);
+            this.totalRuns++;
+            return await operation();
+        }
+        finally {
+            this.releaseGlobal();
+        }
+    }
+    /** Record server pressure. Returns the applied host cooldown in milliseconds. */
+    noteResponse(url, status, retryAfterMs) {
+        const { state } = this.host(url);
+        if (status >= 200 && status < 400) {
+            state.consecutiveFailures = 0;
+            return 0;
+        }
+        if (![429, 502, 503, 504].includes(status))
+            return 0;
+        state.consecutiveFailures++;
+        this.backoffEvents++;
+        const exponential = this.policy.backoffBaseMs * (2 ** Math.max(0, state.consecutiveFailures - 1));
+        const applied = Math.min(Math.max(retryAfterMs ?? exponential, 0), this.policy.cooldownMs);
+        state.blockedUntil = Math.max(state.blockedUntil, Date.now() + applied);
+        return applied;
+    }
+    snapshot() {
+        const now = Date.now();
+        return {
+            active: this.active,
+            queued: this.queued,
+            trackedHosts: this.hosts.size,
+            coolingHosts: [...this.hosts.values()].filter(state => state.blockedUntil > now).length,
+            totalRuns: this.totalRuns,
+            totalWaitMs: this.totalWaitMs,
+            backoffEvents: this.backoffEvents,
+        };
+    }
+}
+//# sourceMappingURL=usage-policy.js.map

package/lib/usage-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-policy.js","sourceRoot":"","sources":["../src/usage-policy.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAwB/E,MAAM,cAAc,GAAgB;IAClC,UAAU,EAAE,GAAG;IACf,cAAc,EAAE,CAAC;IACjB,KAAK,EAAE,CAAC;IACR,cAAc,EAAE,EAAE;IAClB,QAAQ,EAAE,CAAC;IACX,UAAU,EAAE,CAAC;IACb,aAAa,EAAE,KAAK;IACpB,UAAU,EAAE,MAAM;CACnB,CAAA;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,KAAc,EAAE,QAAgB,EAAE,GAAW,EAAE,GAAW;IAC9F,MAAM,QAAQ,GAAG,KAAK,IAAI,QAAQ,CAAA;IAClC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,GAAG,EAAE,CAAC;QACpF,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,4BAA4B,GAAG,OAAO,GAAG,EAAE,CAAC,CAAA;IACjF,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAmC;IACpE,OAAO;QACL,UAAU,EAAE,cAAc,CAAC,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,cAAc,CAAC,UAAU,EAAE,CAAC,EAAE,MAAM,CAAC;QACjG,cAAc,EAAE,cAAc,CAAC,gBAAgB,EAAE,KAAK,EAAE,cAAc,EAAE,cAAc,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5G,KAAK,EAAE,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QACzE,cAAc,EAAE,cAAc,CAAC,gBAAgB,EAAE,KAAK,EAAE,cAAc,EAAE,cAAc,CAAC,cAAc,EAAE,CAAC,EAAE,GAAG,CAAC;QAC9G,QAAQ,EAAE,cAAc,CAAC,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QACpF,UAAU,EAAE,cAAc,CAAC,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,cAAc,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5F,aAAa,EAAE,cAAc,CAAC,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,cAAc,CAAC,aAAa,EAAE,CAAC,EAAE,MAAM,CAAC;QAC7G,UAAU,EAAE,cAAc,CAAC,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,cAAc,CAAC,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC;KACrG,CAAA;AACH,CAAC;AAQD,SAAS,YAAY;IACnB,OAAO,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;AAC/C,CAAC;AAED,SAAS,KAAK,CAAC,EAAU,EAAE,MAAoB;IAC7C,IAAI,MAAM,EAAE,OAAO;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAA;IAC1D,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IACrC,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAC7C,OAAO,EAAE,CAAA;QACX,CAAC,EAAE,EAAE,CAAC,CAAA;QACN,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAC7C,MAAM,CAAC,YAAY,EAAE,CAAC,CAAA;QACxB,CAAC,CAAA;QACD,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IAC5D,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,OAAO,aAAa;IASH;IARb,MAAM,GAAG,CAAC,CAAA;IACD,aAAa,GAAmB,EAAE,CAAA;IAClC,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAA;IAC7C,MAAM,GAAG,CAAC,CAAA;IACV,SAAS,GAAG,CAAC,CAAA;IACb,WAAW,GAAG,CAAC,CAAA;IACf,aAAa,GAAG,CAAC,CAAA;IAEzB,YAAqB,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpC,IAAI,CAAC,GAAW;QACtB,IAAI,GAAW,CAAA;QACf,IAAI,CAAC;YAAC,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;QAAC,CAAC;QAC5H,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;QACjE,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,mBAAmB,EAAE,CAAC,EAAE,CAAA;YAC/D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAC5B,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAA;IACvB,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,MAAoB;QAC9C,IAAI,MAAM,EAAE,OAAO;YAAE,MAAM,YAAY,EAAE,CAAA;QACzC,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAC7C,IAAI,CAAC,MAAM,EAAE,CAAA;YACb,OAAM;QACR,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,CAAA;QACb,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,MAAM,GAAG,GAAG,EAAE;gBAClB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;gBAC7C,IAAI,CAAC,MAAM,EAAE,CAAA;gBACb,OAAO,EAAE,CAAA;YACX,CAAC,CAAA;YACD,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;gBAChD,IAAI,KAAK,IAAI,CAAC;oBAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;gBACnD,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;gBAC7C,IAAI,CAAC,MAAM,EAAE,CAAA;gBACb,MAAM,CAAC,YAAY,EAAE,CAAC,CAAA;YACxB,CAAC,CAAA;YACD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAC/B,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QAC5D,CAAC,CAAC,CAAA;IACJ,CAAC;IAEO,aAAa;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAA;QACvC,IAAI,IAAI;YAAE,IAAI,EAAE,CAAA;;YACX,IAAI,CAAC,MAAM,EAAE,CAAA;IACpB,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,KAAgB,EAAE,MAAoB;QAC9D,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YACtB,MAAM,WAAW,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAA;YAChD,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,GAAG,WAAW,CAAC,CAAA;YAChE,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAA;YAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CACtB,KAAK,CAAC,YAAY,EAClB,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CACrE,CAAA;YACD,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC;gBACnB,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBACtB,OAAM;YACR,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,GAAG,GAAG,CAAA;YAC5B,IAAI,CAAC,WAAW,IAAI,MAAM,CAAA;YAC1B,MAAM,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC7B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,SAA2B,EAAE,MAAoB;QACzE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAChC,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;QAChC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;YACrC,IAAI,CAAC,SAAS,EAAE,CAAA;YAChB,OAAO,MAAM,SAAS,EAAE,CAAA;QAC1B,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,aAAa,EAAE,CAAA;QACtB,CAAC;IACH,CAAC;IAED,iFAAiF;IACjF,YAAY,CAAC,GAAW,EAAE,MAAc,EAAE,YAAqB;QAC7D,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAChC,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;YAClC,KAAK,CAAC,mBAAmB,GAAG,CAAC,CAAA;YAC7B,OAAO,CAAC,CAAA;QACV,CAAC;QACD,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,CAAC,CAAA;QACpD,KAAK,CAAC,mBAAmB,EAAE,CAAA;QAC3B,IAAI,CAAC,aAAa,EAAE,CAAA;QACpB,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,mBAAmB,GAAG,CAAC,CAAC,CAAC,CAAA;QACjG,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,WAAW,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;QAC1F,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAA;QACvE,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,QAAQ;QACN,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YAC7B,YAAY,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,MAAM;YACvF,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAA;IACH,CAAC;CACF"}

package/package.json

@@ -1,78 +1,133 @@
-{
-  "name": "@anweat/dsh-browser",
-  "version": "0.1.7",
-  "description": "Self-contained browser runtime plugin for DeepSeek Harness (scoped @anweat) — bundles Playwright (chromium) and OpenCLI as plugin-local dependencies (with global-reuse fallback), exposes a `browser` service and interactive browser tools.",
-  "license": "MIT",
-  "type": "module",
-  "main": "lib/index.js",
-  "types": "lib/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./lib/index.d.ts",
-      "default": "./lib/index.js"
-    },
-    "./cordis.patch.yml": "./cordis.patch.yml",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "lib",
-    "cordis.patch.yml",
-    "README.md",
-    "scripts",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": "^22.19 || >=24"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "test": "node --test --experimental-transform-types test/*.test.ts",
-    "prepublishOnly": "npm run build",
-    "prepare": "npm run build"
-  },
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-tools": "^0.1.1-rc.2",
-    "@deepseek-ai/schemastery": "^3.18.1"
-  },
-  "peerDependenciesMeta": {
-    "@deepseek-ai/cordis": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-tools": {
-      "optional": true
-    },
-    "@deepseek-ai/schemastery": {
-      "optional": true
-    }
-  },
-  "dependencies": {
-    "@jackwener/opencli": "^1.8.6",
-    "playwright": "^1.60.0"
-  },
-  "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-tools": "^0.1.1-rc.2",
-    "@deepseek-ai/schemastery": "^3.18.1",
-    "typescript": "^5.6.0",
-    "@types/node": "^22.0.0"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    }
-  },
-  "packageManager": "pnpm@11.7.0",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/anweat/dsh-browser.git"
-  },
-  "keywords": [
-    "dsh",
-    "deepseek-harness",
-    "plugin",
-    "browser",
-    "playwright",
-    "opencli"
-  ]
-}
+{
+  "name": "@anweat/dsh-browser",
+  "version": "0.1.9",
+  "description": "Self-contained browser runtime plugin for DeepSeek Harness (scoped @anweat) — bundles Playwright (chromium) and OpenCLI as plugin-local dependencies (with global-reuse fallback), exposes a `browser` service and interactive browser tools.",
+  "license": "MIT",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "scripts",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": "^22.19 || >=24"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-tools": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-connection": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-settings": "^0.1.1-rc.2",
+    "@deepseek-ai/schemastery": "^3.18.1"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tools": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-connection": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-locale": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-runtime": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-settings": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-settings-plugins": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-slots": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-settings": {
+      "optional": true
+    },
+    "@deepseek-ai/schemastery": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@jackwener/opencli": "^1.8.6",
+    "patchright": "^1.62.1",
+    "playwright": "^1.60.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-tools": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-connection": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-settings": "^0.1.1-rc.2",
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.1",
+    "react": "^18.2.0",
+    "react-dom": "18.2.0",
+    "tsdown": "^0.22.2",
+    "typescript": "^5.6.0",
+    "@types/node": "^22.0.0"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-settings-plugins"
+      ],
+      "platform": "web"
+    },
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anweat/dsh-browser.git"
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "plugin",
+    "browser",
+    "playwright",
+    "opencli"
+  ],
+  "scripts": {
+    "build": "node scripts/clean-lib.mjs && tsc -p tsconfig.json && tsdown",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test --experimental-transform-types test/*.test.ts",
+    "test:client-bundle": "node scripts/check-client-bundle.mjs",
+    "verify": "pnpm run typecheck && pnpm run build && pnpm test && pnpm run test:client-bundle"
+  }
+}

package/scripts/check-client-bundle.mjs

@@ -0,0 +1,15 @@
+import assert from 'node:assert/strict'
+import { readFile } from 'node:fs/promises'
+
+const source = await readFile(new URL('../lib/client.js', import.meta.url), 'utf8')
+const sourceMap = JSON.parse(await readFile(new URL('../lib/client.js.map', import.meta.url), 'utf8'))
+const imports = [...source.matchAll(/\brequire\((['"])([^'"]+)\1\)/g)].map(match => match[2])
+const allowed = new Set(['react', 'react/jsx-runtime', 'react-dom', 'react-dom/client', '@deepseek-ai/cordis', '@deepseek-ai/dsh-client-runtime/client', '@deepseek-ai/dsh-client-ui-slots'])
+const forbidden = [...new Set(imports.filter(id => !allowed.has(id)))].sort()
+
+assert.deepEqual(forbidden, [], `client bundle contains unavailable imports: ${forbidden.join(', ')}`)
+assert.match(source, /settings\.plugin\.item/)
+assert.match(source, /dsh-browser/)
+assert.match(source, /Browser automation/)
+assert.equal('sourcesContent' in sourceMap, false, 'client source map must exclude source contents')
+console.log(`client bundle check passed (${[...new Set(imports)].length} module-table imports)`)

package/scripts/clean-lib.mjs

@@ -0,0 +1,3 @@
+import { rm } from 'node:fs/promises'
+
+await rm(new URL('../lib', import.meta.url), { recursive: true, force: true })