openchrome-mcp 1.12.5 → 1.12.7

package/README.ko.md

@@ -37,16 +37,21 @@ Chrome 프로세스 하나에 격리된 탭 여러 개, 20개 병렬 레인이 ~
 
 AI:    [4개 병렬 레인, 모든 사이트 이미 인증됨]
        Best Buy $179 · Amazon $189 · Walmart $185 · eBay $172
-       2.4초 — 실시간 페이지, 봇 탐지 우회
+       실시간 페이지 · 이미 인증됨 · 봇 탐지 우회
 ```
 
 | | 기존 방식 (Playwright 등) | OpenChrome |
 |---|:---:|:---:|
-| 5개 사이트 작업 | ~250초 (매번 로그인) | **~3초** (병렬) |
-| 메모리 | ~2.5GB (브라우저 5개) | **~300MB** (Chrome 1개) |
+| 5개 사이트 작업* | ~250초 (매번 로그인) | **~3초** (병렬) |
+| 메모리* | ~2.5GB (브라우저 5개) | **~300MB** (Chrome 1개) |
 | 재인증 | 매 실행마다 | **불필요** |
 | 봇 탐지 | 차단됨 | **투명** (실제 Chrome) |
 
+<sub>\* 인증된 Chrome 1개 vs. 콜드 브라우저 N개라는 아키텍처 차이를 설명하기 위한
+예시이며, 측정된 경쟁 벤치마크 결과가 아닙니다. 정량적 속도/비용 수치는 live 또는
+recorded-real 벤치마크 행으로만 헤드라인 주장이 됩니다 —
+[`docs/benchmarks/benchmark-direction.md`](docs/benchmarks/benchmark-direction.md) 참고.</sub>
+
 ---
 
 ## 빠른 시작
@@ -98,7 +103,7 @@ MCP 클라이언트를 재시작하세요. 끝입니다 — 첫 도구 호출
 - **검증 가능한 실행** — `oc_assert`가 페이지 상태를 Outcome Contract로 검증 (pass / fail / inconclusive) — 추측 대신 계약.
 
 기본 도구 표면은 내비게이션·상호작용·읽기·추출·병렬 워크플로·계약·스킬·복구·진단에
-걸쳐 약 110개입니다. 전체 목록: [`docs/agent/capability-map.md`](docs/agent/capability-map.md).
+걸쳐 118개입니다. 전체 목록: [`docs/agent/capability-map.md`](docs/agent/capability-map.md).
 
 ---
 
@@ -180,14 +185,16 @@ query_dom → inspect → interact` 대신 **바로 실행 가능한 번호 목
 | **결과 분류기** | 클릭 후 실제로 무슨 일이 일어났는지 보고 (SUCCESS / SILENT_CLICK / WRONG_ELEMENT). |
 | **49개 신뢰성 메커니즘** | 프로세스 수명부터 MCP 게이트웨이까지 8개 방어 계층 — 단일 실패로 서버가 멈추지 않음. [`docs/architecture.md`](docs/architecture.md) 참고. |
 
-일반적인 5개 사이트 작업 기준: LLM 호출 ~80% 감소, 실제 소요 시간 ~80배 단축,
-비용 ~5배 절감.
+이 하니스는 think-act 루프를 줄이도록 설계됐습니다: LLM 왕복 감소, 실제 소요 시간
+단축, 비용 절감. 구체적인 속도/비용 배수는 live 또는 recorded-real 벤치마크 행으로
+뒷받침될 때에만 헤드라인 주장으로 게시됩니다 —
+[`docs/benchmarks/benchmark-direction.md`](docs/benchmarks/benchmark-direction.md) 참고.
 
 ---
 
 ## 알아두면 좋은 그 외 기능
 
-- **병렬 세션** — Chrome 1개, 탭/레인 N개; `workerId` + `profileDirectory`로 클라이언트별 격리. 여러 MCP 클라이언트가 안전하게 탭을 공유.
+- **병렬 세션** — Chrome 1개, 탭/레인 N개; `workerId` + `profileDirectory`로 클라이언트별 격리. 여러 MCP 클라이언트는 단일 broker/HTTP 소유자를 통해 연결할 때(`--broker` / `--connect-broker`) 하나의 Chrome을 안전하게 공유합니다. 독립 stdio 클라이언트는 `--port` / `--user-data-dir` 프로파일을 분리하세요. [`docs/mcp/topologies.md`](docs/mcp/topologies.md) 참고.
 - **봇 차단 / Turnstile 대응** — 3단계 자동 폴백 (headless → stealth → 실제 headed Chrome)으로 CDN/WAF 차단 우회. [Turnstile 가이드](docs/turnstile-guide.md).
 - **대화형 로그인** — 런처가 기본적으로 화면에 보이게 실행되므로 2FA/CAPTCHA를 한 번 완료한 뒤 영구 프로필을 재사용.
 - **세션 지속성** — `--persist-storage`로 쿠키 + localStorage를 원자적으로 저장해 headless에서 재사용.

package/README.md

@@ -37,16 +37,21 @@ You: compare "AirPods Pro" prices across Amazon, eBay, Walmart, Best Buy
 
 AI:  [4 parallel lanes, already authenticated everywhere]
      Best Buy $179 · Amazon $189 · Walmart $185 · eBay $172
-     2.4s — live pages, past bot detection
+     live pages · already authenticated · past bot detection
 ```
 
 | | Traditional (Playwright et al.) | OpenChrome |
 |---|:---:|:---:|
-| 5-site task | ~250s (login each) | **~3s** (parallel) |
-| Memory | ~2.5 GB (5 browsers) | **~300 MB** (1 Chrome) |
+| 5-site task* | ~250s (login each) | **~3s** (parallel) |
+| Memory* | ~2.5 GB (5 browsers) | **~300 MB** (1 Chrome) |
 | Re-auth | every run | **never** |
 | Bot detection | flagged | **invisible** (real Chrome) |
 
+<sub>\* Illustrative of the architectural difference (one authenticated Chrome vs. N cold
+browsers), not benchmarked competitive results. Quantitative speed/cost figures become
+headline claims only as live or recorded-real benchmark rows — see
+[`docs/benchmarks/benchmark-direction.md`](docs/benchmarks/benchmark-direction.md).</sub>
+
 ---
 
 ## Quick start
@@ -63,6 +68,9 @@ npx openchrome-mcp setup --client opencode   # OpenCode
 
 Restart your MCP client. That's it — Chrome auto-launches on first tool call.
 
+For manual Codex CLI configuration, run `openchrome config --client codex`
+and add the printed `[mcp_servers.openchrome]` block to `~/.codex/config.toml`.
+
 <details>
 <summary>Manual MCP config (Cursor / VS Code / Windsurf / others)</summary>
 
@@ -97,7 +105,7 @@ Ask your agent in plain language — these all map to OpenChrome tools:
 - **Crawling** — async `crawl_start` / `crawl_status` / `crawl_cancel` jobs with cursor pagination.
 - **Verifiable runs** — `oc_assert` checks page state against an Outcome Contract (pass / fail / inconclusive) instead of guessing.
 
-The default surface is ~110 tools across navigation, interaction, reading,
+The default surface is 118 tools across navigation, interaction, reading,
 extraction, parallel workflows, contracts, skills, recovery, and diagnostics.
 Full catalogue: [`docs/agent/capability-map.md`](docs/agent/capability-map.md).
 
@@ -182,14 +190,16 @@ wrong guess costs 10–15s of inference. OpenChrome's harness cuts that loop:
 | **Outcome classifier** | Reports what *actually* happened after a click (SUCCESS / SILENT_CLICK / WRONG_ELEMENT). |
 | **49 reliability mechanisms** | 8 defense layers from process lifecycle to MCP gateway — no single failure hangs the server. See [`docs/architecture.md`](docs/architecture.md). |
 
-Result on a typical 5-site task: ~80% fewer LLM calls, ~80x faster wall time,
-~5x cheaper.
+The harness is designed to cut the think-act loop: fewer LLM round-trips, faster
+wall time, lower cost. Specific speed/cost multipliers are published as headline
+claims only when backed by live or recorded-real benchmark rows — see
+[`docs/benchmarks/benchmark-direction.md`](docs/benchmarks/benchmark-direction.md).
 
 ---
 
 ## Other capabilities worth knowing
 
-- **Parallel sessions** — 1 Chrome, N tabs/lanes; `workerId` + `profileDirectory` give per-client isolation. Multiple MCP clients can share tabs safely.
+- **Parallel sessions** — 1 Chrome, N tabs/lanes; `workerId` + `profileDirectory` give per-client isolation. Multiple MCP clients can share one Chrome safely when they connect through a single broker/HTTP owner (`--broker` / `--connect-broker`); independent stdio clients should use separate `--port` / `--user-data-dir` profiles. See [`docs/mcp/topologies.md`](docs/mcp/topologies.md).
 - **Anti-bot / Turnstile** — 3-tier auto-fallback (headless → stealth → real headed Chrome) bypasses CDN/WAF blocks. [Turnstile guide](docs/turnstile-guide.md).
 - **Interactive login** — headed by default since the launcher runs visible; complete 2FA/CAPTCHA once, reuse the persistent profile after.
 - **Session persistence** — `--persist-storage` saves cookies + localStorage atomically for headless reuse.
@@ -214,6 +224,57 @@ Transport stability policy: [`docs/transport-lifecycle.md`](docs/transport-lifec
 
 ---
 
+## Host plugins
+
+OpenChrome ships plugin manifests for Claude Code and Codex CLI so both hosts
+load the MCP server and skill body from the **same shared source** — no
+per-host duplication.
+
+### Claude Code
+
+Load from the repo for local development:
+
+```bash
+claude --plugin-dir /path/to/openchrome
+```
+
+Or install from npm after the package is published to a marketplace:
+
+```bash
+/plugin install openchrome   # once listed in a marketplace
+```
+
+The skill body lives under `skills/openchrome/` and the `/openchrome:connect`
+slash command is registered from the top-level `commands/` directory. Run
+`/reload-plugins` after updating to pick up new content.
+
+Manifest: `.claude-plugin/plugin.json` — registers the `openchrome` MCP server
+(`openchrome serve --auto-launch`). Skills and commands are auto-discovered
+from `skills/` and `commands/`.
+
+### Codex CLI
+
+Load from the repo for local development:
+
+```bash
+codex --plugin-dir /path/to/openchrome
+```
+
+Or follow the Codex plugin installation instructions once the package is listed
+in the Codex plugin registry.
+
+Manifest: `.codex-plugin/plugin.json` — identical MCP server entry point and
+skill path; the two manifests share the same `skills/openchrome/` body.
+
+### Shared skill body
+
+Both manifests share `skills/openchrome/SKILL.md` as the single source of
+truth for skill content, and the slash command stub at `commands/connect.md`
+registers `/openchrome:connect`. The `commands/` directory sits at the plugin
+root so both hosts auto-discover it.
+
+---
+
 ## Documentation
 
 | Topic | Link |

package/dist/broker/discovery.d.ts

@@ -0,0 +1,27 @@
+export interface BrokerIdentity {
+    port: number;
+    userDataDir: string;
+    httpHost: string;
+    httpPort: number;
+    pid?: number;
+    startedAt?: string;
+    version?: string;
+    authTokenEnv?: string;
+}
+export interface BrokerMetadata {
+    schemaVersion: 1;
+    pid: number;
+    version: string;
+    startedAt: string;
+    port: number;
+    userDataDir: string;
+    endpoint: string;
+    authTokenEnv?: string;
+}
+export declare function getBrokerRegistryDir(rootDir?: string | undefined): string;
+export declare function getBrokerMetadataPath(port: number, userDataDir: string, rootDir?: string): string;
+export declare function buildBrokerMetadata(identity: BrokerIdentity): BrokerMetadata;
+export declare function publishBrokerMetadata(identity: BrokerIdentity, rootDir?: string): BrokerMetadata;
+export declare function readBrokerMetadata(port: number, userDataDir: string, rootDir?: string): BrokerMetadata | null;
+export declare function removeBrokerMetadata(port: number, userDataDir: string, pid?: number, rootDir?: string): void;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/broker/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/broker/discovery.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,CAAC,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,qBAA6C,GAAG,MAAM,CAEjG;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjG;AAMD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc,CAY5E;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,CAMhG;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAS7G;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,SAAc,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAKjH"}

package/dist/broker/discovery.js

@@ -0,0 +1,98 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBrokerRegistryDir = getBrokerRegistryDir;
+exports.getBrokerMetadataPath = getBrokerMetadataPath;
+exports.buildBrokerMetadata = buildBrokerMetadata;
+exports.publishBrokerMetadata = publishBrokerMetadata;
+exports.readBrokerMetadata = readBrokerMetadata;
+exports.removeBrokerMetadata = removeBrokerMetadata;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const version_1 = require("../version");
+const controller_lock_1 = require("../utils/controller-lock");
+function getBrokerRegistryDir(rootDir = process.env.OPENCHROME_BROKER_REGISTRY_DIR) {
+    return rootDir || path.join(os.homedir(), '.openchrome', 'brokers');
+}
+function getBrokerMetadataPath(port, userDataDir, rootDir) {
+    return path.join(getBrokerRegistryDir(rootDir), `${(0, controller_lock_1.controllerLockKey)(port, userDataDir)}.json`);
+}
+function normalizeHost(host) {
+    return host === '0.0.0.0' ? '127.0.0.1' : host;
+}
+function buildBrokerMetadata(identity) {
+    const userDataDir = (0, controller_lock_1.normalizeControllerUserDataDir)(identity.userDataDir);
+    return {
+        schemaVersion: 1,
+        pid: identity.pid ?? process.pid,
+        version: identity.version ?? (0, version_1.getVersion)(),
+        startedAt: identity.startedAt ?? new Date().toISOString(),
+        port: identity.port,
+        userDataDir,
+        endpoint: `http://${normalizeHost(identity.httpHost)}:${identity.httpPort}/mcp`,
+        ...(identity.authTokenEnv ? { authTokenEnv: identity.authTokenEnv } : {}),
+    };
+}
+function publishBrokerMetadata(identity, rootDir) {
+    const metadata = buildBrokerMetadata(identity);
+    const filePath = getBrokerMetadataPath(identity.port, metadata.userDataDir, rootDir);
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify(metadata, null, 2) + '\n', { mode: 0o600 });
+    return metadata;
+}
+function readBrokerMetadata(port, userDataDir, rootDir) {
+    const filePath = getBrokerMetadataPath(port, userDataDir, rootDir);
+    try {
+        const metadata = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        if (metadata.schemaVersion !== 1 || typeof metadata.endpoint !== 'string' || typeof metadata.pid !== 'number')
+            return null;
+        return metadata;
+    }
+    catch {
+        return null;
+    }
+}
+function removeBrokerMetadata(port, userDataDir, pid = process.pid, rootDir) {
+    const filePath = getBrokerMetadataPath(port, userDataDir, rootDir);
+    const existing = readBrokerMetadata(port, userDataDir, rootDir);
+    if (existing && existing.pid !== pid)
+        return;
+    try {
+        fs.unlinkSync(filePath);
+    }
+    catch { /* best effort */ }
+}
+//# sourceMappingURL=discovery.js.map

package/dist/broker/discovery.js.map

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

package/dist/broker/lifecycle.d.ts

@@ -0,0 +1,19 @@
+export type BrokerLifecycleMode = 'disabled' | 'owner';
+export type BrokerLifecycleState = 'idle' | 'running' | 'reconnecting' | 'stopping' | 'stopped';
+export interface BrokerLifecycleSnapshot {
+    mode: BrokerLifecycleMode;
+    state: BrokerLifecycleState;
+    startedAt: string | null;
+    updatedAt: string | null;
+    reconnectCount: number;
+    lastEvent: string | null;
+    ocStopDefaultKeepChrome: boolean;
+}
+export declare function setBrokerOwnerMode(enabled: boolean): BrokerLifecycleSnapshot;
+export declare function recordBrokerReconnect(event: 'reconnecting' | 'reconnected' | 'reconnect_failed'): BrokerLifecycleSnapshot;
+export declare function recordBrokerStopping(): BrokerLifecycleSnapshot;
+export declare function recordBrokerStopped(): BrokerLifecycleSnapshot;
+export declare function shouldOcStopKeepChromeByDefault(): boolean;
+export declare function getBrokerLifecycleSnapshot(): BrokerLifecycleSnapshot;
+export declare function resetBrokerLifecycleForTest(): void;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/broker/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/broker/lifecycle.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,OAAO,CAAC;AACvD,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,UAAU,GAAG,SAAS,CAAC;AAEhG,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,KAAK,EAAE,oBAAoB,CAAC;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,uBAAuB,EAAE,OAAO,CAAC;CAClC;AAgBD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,uBAAuB,CAS5E;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,aAAa,GAAG,kBAAkB,GAAG,uBAAuB,CAYzH;AAED,wBAAgB,oBAAoB,IAAI,uBAAuB,CAK9D;AAED,wBAAgB,mBAAmB,IAAI,uBAAuB,CAK7D;AAED,wBAAgB,+BAA+B,IAAI,OAAO,CAEzD;AAED,wBAAgB,0BAA0B,IAAI,uBAAuB,CAEpE;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAQlD"}

package/dist/broker/lifecycle.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setBrokerOwnerMode = setBrokerOwnerMode;
+exports.recordBrokerReconnect = recordBrokerReconnect;
+exports.recordBrokerStopping = recordBrokerStopping;
+exports.recordBrokerStopped = recordBrokerStopped;
+exports.shouldOcStopKeepChromeByDefault = shouldOcStopKeepChromeByDefault;
+exports.getBrokerLifecycleSnapshot = getBrokerLifecycleSnapshot;
+exports.resetBrokerLifecycleForTest = resetBrokerLifecycleForTest;
+const lifecycle = {
+    mode: 'disabled',
+    state: 'idle',
+    startedAt: null,
+    updatedAt: null,
+    reconnectCount: 0,
+    lastEvent: null,
+    ocStopDefaultKeepChrome: false,
+};
+function nowIso() {
+    return new Date().toISOString();
+}
+function setBrokerOwnerMode(enabled) {
+    const now = nowIso();
+    lifecycle.mode = enabled ? 'owner' : 'disabled';
+    lifecycle.state = enabled ? 'running' : 'idle';
+    lifecycle.startedAt = enabled ? lifecycle.startedAt ?? now : null;
+    lifecycle.updatedAt = now;
+    lifecycle.lastEvent = enabled ? 'broker_owner_started' : 'broker_owner_disabled';
+    lifecycle.ocStopDefaultKeepChrome = enabled;
+    return getBrokerLifecycleSnapshot();
+}
+function recordBrokerReconnect(event) {
+    lifecycle.updatedAt = nowIso();
+    lifecycle.lastEvent = event;
+    if (event === 'reconnecting') {
+        lifecycle.state = 'reconnecting';
+    }
+    else if (event === 'reconnected') {
+        lifecycle.state = lifecycle.mode === 'owner' ? 'running' : 'idle';
+        lifecycle.reconnectCount += 1;
+    }
+    else {
+        lifecycle.state = 'reconnecting';
+    }
+    return getBrokerLifecycleSnapshot();
+}
+function recordBrokerStopping() {
+    lifecycle.updatedAt = nowIso();
+    lifecycle.state = 'stopping';
+    lifecycle.lastEvent = 'broker_owner_stopping';
+    return getBrokerLifecycleSnapshot();
+}
+function recordBrokerStopped() {
+    lifecycle.updatedAt = nowIso();
+    lifecycle.state = 'stopped';
+    lifecycle.lastEvent = 'broker_owner_stopped';
+    return getBrokerLifecycleSnapshot();
+}
+function shouldOcStopKeepChromeByDefault() {
+    return lifecycle.ocStopDefaultKeepChrome;
+}
+function getBrokerLifecycleSnapshot() {
+    return { ...lifecycle };
+}
+function resetBrokerLifecycleForTest() {
+    lifecycle.mode = 'disabled';
+    lifecycle.state = 'idle';
+    lifecycle.startedAt = null;
+    lifecycle.updatedAt = null;
+    lifecycle.reconnectCount = 0;
+    lifecycle.lastEvent = null;
+    lifecycle.ocStopDefaultKeepChrome = false;
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/broker/lifecycle.js.map

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

package/dist/cdp/client.d.ts

@@ -295,6 +295,7 @@ export declare class CDPClient {
      * @param skipCookieBridge If true, skip cookie bridging from authenticated pages (used for pool pre-warming)
      */
     createPage(url?: string, context?: BrowserContext | null, skipCookieBridge?: boolean): Promise<Page>;
+    private findReusableStartupPage;
     /**
      * Open a new tab via Chrome's HTTP debug API without attaching CDP during load.
      * This avoids the Runtime.enable serialization artifacts that Cloudflare Turnstile

package/dist/cdp/client.d.ts.map

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

package/dist/cdp/client.js

@@ -1490,41 +1490,11 @@ class CDPClient {
             ]);
         }
         else {
-            // First-call NTP reuse: when this CDPClient hasn't created any managed
-            // pages yet AND Chrome was OpenChrome-spawned AND there's exactly one
-            // untracked page-type target whose URL looks like the startup New Tab
-            // Page, navigate THAT tab instead of opening a second one. Avoids the
-            // "extra blank tab" race that the post-hoc prune in _createTargetImpl
-            // tries (imperfectly) to clean up.
-            let reused = null;
-            if (this.targetIdIndex.size === 0 && this.getChromeLifecycleMode() === 'isolated') {
-                const candidates = browser.targets().filter(t => {
-                    if (t.type() !== 'page')
-                        return false;
-                    const tid = (0, puppeteer_helpers_1.getTargetId)(t);
-                    return !!tid && !this.targetIdIndex.has(tid);
-                });
-                if (candidates.length === 1) {
-                    const candidateUrl = candidates[0].url();
-                    const isStartupBlank = candidateUrl === '' ||
-                        candidateUrl === 'about:blank' ||
-                        candidateUrl === 'chrome://newtab/' ||
-                        candidateUrl.startsWith('chrome://new-tab-page');
-                    if (isStartupBlank) {
-                        try {
-                            reused = await candidates[0].page();
-                        }
-                        catch {
-                            reused = null;
-                        }
-                    }
-                }
-            }
-            if (reused) {
-                page = reused;
-                console.error(`[CDPClient] Reused startup NTP target ${(0, puppeteer_helpers_1.getTargetId)(reused.target())} for first createPage (URL: ${reused.url()})`);
-                // Skip cookie bridge on reuse: this is the very first managed page on
-                // this Chrome, so there are no authenticated source tabs to copy from.
+            const startupPage = await this.findReusableStartupPage(browser);
+            if (startupPage) {
+                page = startupPage;
+                skipCookieBridge = true;
+                console.error(`[CDPClient] Reused startup tab ${(0, puppeteer_helpers_1.getTargetId)(page.target())} for first default-context page`);
             }
             else {
                 // Create page in Chrome's default context
@@ -1535,30 +1505,30 @@ class CDPClient {
                         newPageTid2 = setTimeout(() => reject(new Error(`newPage() timed out after ${defaults_1.DEFAULT_NEW_PAGE_TIMEOUT_MS}ms`)), defaults_1.DEFAULT_NEW_PAGE_TIMEOUT_MS);
                     }),
                 ]);
-                // Copy cookies from an authenticated page (skip for pool pre-warming to avoid
-                // CDP session conflicts and unnecessary overhead on about:blank pages).
-                // The global skipCookieBridge flag serves as a manual override escape hatch.
-                // Overall timeout prevents cascading hangs from unresponsive source tabs.
-                if (!skipCookieBridge && !(0, global_1.getGlobalConfig)().skipCookieBridge) {
-                    const cookieScan = await this.findAuthenticatedPageTarget(targetDomain);
-                    if (cookieScan.status === 'partial' && !cookieScan.targetId) {
-                        console.error(`[CDPClient] Cookie bridge proceeding without copied cookies: ${cookieScan.warning ?? 'cookie scan incomplete'}`);
-                    }
-                    if (cookieScan.targetId) {
-                        let cookieCopyTid;
-                        await Promise.race([
-                            this.copyCookiesViaCDP(cookieScan.targetId, page),
-                            new Promise((resolve) => {
-                                cookieCopyTid = setTimeout(() => {
-                                    console.error(`[CDPClient] Cookie copy timed out after ${defaults_1.DEFAULT_COOKIE_COPY_TIMEOUT_MS}ms, proceeding without cookies`);
-                                    resolve();
-                                }, defaults_1.DEFAULT_COOKIE_COPY_TIMEOUT_MS);
-                            }),
-                        ]).finally(() => {
-                            if (cookieCopyTid)
-                                clearTimeout(cookieCopyTid);
-                        });
-                    }
+            }
+            // Copy cookies from an authenticated page (skip for pool pre-warming to avoid
+            // CDP session conflicts and unnecessary overhead on about:blank pages).
+            // The global skipCookieBridge flag serves as a manual override escape hatch.
+            // Overall timeout prevents cascading hangs from unresponsive source tabs.
+            if (!skipCookieBridge && !(0, global_1.getGlobalConfig)().skipCookieBridge) {
+                const cookieScan = await this.findAuthenticatedPageTarget(targetDomain);
+                if (cookieScan.status === 'partial' && !cookieScan.targetId) {
+                    console.error(`[CDPClient] Cookie bridge proceeding without copied cookies: ${cookieScan.warning ?? 'cookie scan incomplete'}`);
+                }
+                if (cookieScan.targetId) {
+                    let cookieCopyTid;
+                    await Promise.race([
+                        this.copyCookiesViaCDP(cookieScan.targetId, page),
+                        new Promise((resolve) => {
+                            cookieCopyTid = setTimeout(() => {
+                                console.error(`[CDPClient] Cookie copy timed out after ${defaults_1.DEFAULT_COOKIE_COPY_TIMEOUT_MS}ms, proceeding without cookies`);
+                                resolve();
+                            }, defaults_1.DEFAULT_COOKIE_COPY_TIMEOUT_MS);
+                        }),
+                    ]).finally(() => {
+                        if (cookieCopyTid)
+                            clearTimeout(cookieCopyTid);
+                    });
                 }
             }
         }
@@ -1588,7 +1558,11 @@ class CDPClient {
                 (0, domain_guard_1.assertDomainAllowed)(page.url());
             }
             catch (err) {
-                // Close the page to prevent about:blank ghost tabs on navigation failure
+                // Close the page to prevent about:blank ghost tabs on navigation failure.
+                // When `page` came from findReusableStartupPage the closed tab is the
+                // startup NTP — that's intentional: reuse is gated to isolated-mode
+                // (OpenChrome owns Chrome), so the user does not see a stuck about:blank
+                // from a failed first navigation.
                 const targetId = (0, puppeteer_helpers_1.getTargetId)(page.target());
                 this.targetIdIndex.delete(targetId);
                 await page.close().catch(() => { });
@@ -1597,6 +1571,30 @@ class CDPClient {
         }
         return page;
     }
+    async findReusableStartupPage(browser) {
+        if (this.targetIdIndex.size !== 0 || this.getChromeLifecycleMode() !== 'isolated')
+            return null;
+        const candidates = browser.targets().filter((target) => {
+            if (target.type() !== 'page')
+                return false;
+            const targetId = (0, puppeteer_helpers_1.getTargetId)(target);
+            if (!targetId || this.targetIdIndex.has(targetId))
+                return false;
+            const targetUrl = target.url();
+            return targetUrl === ''
+                || targetUrl === 'about:blank'
+                || targetUrl === 'chrome://newtab/'
+                || targetUrl.startsWith('chrome://new-tab-page');
+        });
+        if (candidates.length !== 1)
+            return null;
+        try {
+            return await candidates[0].page();
+        }
+        catch {
+            return null;
+        }
+    }
     /**
      * Open a new tab via Chrome's HTTP debug API without attaching CDP during load.
      * This avoids the Runtime.enable serialization artifacts that Cloudflare Turnstile