cueline 0.1.0

package/README.zh-TW.md

@@ -0,0 +1,144 @@
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="docs/assets/cueline-banner-dark.svg">
+  <img alt="CueLine — ChatGPT 下指令，你的機器執行。" src="docs/assets/cueline-banner-light.svg" width="100%">
+</picture>
+
+<p align="center">
+  <a href="https://github.com/Seraphim0916/cueline/actions/workflows/ci.yml"><img alt="ci" src="https://github.com/Seraphim0916/cueline/actions/workflows/ci.yml/badge.svg"></a>
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> · <b>繁體中文</b> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.ko.md">한국어</a>
+</p>
+
+**CueLine 把方向盤交給一個已經開著的 ChatGPT 網頁對話：由它規劃整趟執行、喊出每一步；而 CueLine 負責檢查每一道指令，並在你這台機器上把事情真的做完。**
+
+那個網頁碰不到你的機器。它每一輪只吐出一小段文字指令。CueLine 判斷這道指令格式對不對、屬不屬於這次執行、對應到哪個本機工作行程（worker）——然後才執行它、保留證據，再把證據交回去。
+
+CueLine 是獨立實作，**沒有任何 runtime npm 相依套件**，也不是 Omnilane 或 GPT Relay 的包裝層。
+
+## 一次執行實際上怎麼跑
+
+<img alt="一次 CueLine 執行像一本提示本：機器送出觀測，主控端喊出一道指令，已註冊的 runner 執行它，直到主控端喊 complete。" src="docs/assets/cueline-loop-zh-TW.svg" width="100%">
+
+每一輪：CueLine 先把自己「即將問什麼」寫進紀錄，送出一份觀測（observation）到對話裡，再讀回**恰好一個** `<CueLineControl>` 封包。主控端從五個動作裡挑一個——`dispatch`、`wait`、`inspect`、`complete`、`blocked`——封包以外的任何文字都不會被執行。指令若寫錯 run、寫錯輪次，或工作定義有問題，會被退回去做有次數上限的修正，而不是靠猜。迴圈停在 `complete` 或 `blocked`，或是輪數用完（預設 12 輪）。
+
+主控端決定*該發生什麼*；本機這一側決定*能不能發生、怎麼發生*：通道（lane）必須啟用、候選項必須在任何程序啟動**之前**就確認可用、`argv[0]` 必須早已由你的路由設定註冊過。沒有任何東西會經過 shell。工作行程一旦啟動，就不會偷偷改用第二個候選項——失敗是以證據的形式回報，不是自動重試。
+
+這是允許清單（allow-list），不是沙箱。已註冊的工作行程擁有跟 CueLine 行程本身相同的權限；`advise` 對應 Codex 的唯讀沙箱、`work` 對應 `workspace-write`，但你註冊了什麼，就等於你授權了什麼。
+
+## 五分鐘上手
+
+你需要 Node.js 22 以上、帶內建瀏覽器的 Codex，以及——若要用內建的預設通道——`PATH` 上有 `codex` CLI。
+
+```bash
+git clone https://github.com/Seraphim0916/cueline.git
+cd cueline
+npm ci
+npm run build
+./install.sh      # 建立 ~/.codex/skills/cueline 與 ~/.local/bin/cueline 兩個符號連結
+cueline doctor
+```
+
+`install.sh` 只建立那兩個符號連結，不做別的；它拒絕覆寫不屬於自己的路徑，而 `./install.sh --uninstall` 也只移除自己建立的連結。
+
+接著，在 Codex 裡：
+
+1. 用 Codex 的內建瀏覽器開啟 `https://chatgpt.com` 並登入。
+2. 讓你要當主控的那個對話保持選取狀態——該頁面當下選的模型就是主控端。CueLine 不會替你切換模型，也不會檢查你的訂閱方案。
+3. 請 Codex 用 CueLine 處理這件事：*「用 CueLine：檢視這個 repository，提出下一步變更，並附上證據。」*
+4. 留著回傳的 `runId`。中斷的執行要續跑，就靠它。
+
+內建的 `cueline` skill 是從 Codex 自己的 Node runtime 驅動這個套件的——內建瀏覽器的物件就活在那裡。另外開一個單獨的 `node` 行程並不會繼承它。
+
+## 從程式碼驅動
+
+```js
+import { createCodexIabAdapter, runCueLine } from "cueline";
+
+const result = await runCueLine({
+  request: "Inspect the repository, delegate an implementation plan, and report the evidence.",
+  browser: createCodexIabAdapter(),
+  // 選填：conversationUrl、routingConfig / routingConfigPath、home、cwd、limits。
+});
+
+if (result.status === "complete") {
+  console.log(result.finalDeliveryText);
+}
+```
+
+`startCueLineRun` 是明確的啟動入口（`runCueLine` 是它的別名）。`continueCueLineRun({ runId })` 會在同一個對話裡續跑被中斷的執行，並沿用已保存的對話網址，除非你另外傳入新的 adapter。`loadCueLineRunState(runId)` 只讀取已保存的狀態，不驅動任何東西。已經走到 `complete` 或 `blocked` 的執行會原樣回傳，絕不會被再派工一次。
+
+## CLI
+
+CLI 不驅動瀏覽器。它只告訴你本機這一半健不健康。
+
+```console
+$ cueline doctor
+CueLine 0.1.0
+status	ok
+node	22.14.0	ok
+config	/Users/you/cueline/config/routing.default.json	valid
+home	/Users/you/.cueline
+available_lanes	1
+
+$ cueline routing
+default	codex-default	available
+
+$ cueline jobs
+No jobs.
+
+$ cueline config path
+/Users/you/cueline/config/routing.default.json
+```
+
+Node 版本太舊、或沒有任何通道解析得出來時，`cueline doctor` 會以非零狀態結束，因此可以直接拿來當前置檢查。`cueline routing` 會告訴你某個通道為什麼不可用，而不是安靜地改選別的。`cueline help` 會列出全部。
+
+## 設定
+
+`CUELINE_CONFIG` 用來指定路由設定檔；`CUELINE_HOME` 用來搬動本機狀態（預設 `~/.cueline`）。
+
+內建的 `default` 通道只有一個候選項 `codex-default`：以 stdin 傳入任務執行 `codex exec`，`advise` 用 `read-only`、`work` 用 `workspace-write`。要註冊別的工作行程，複製一份 [`config/routing.default.json`](config/routing.default.json)、加入你的候選項，再把 `CUELINE_CONFIG` 指過去——`argv[0]` 裡的執行檔就是透過這個動作被註冊的，而且它也必須在 `PATH` 上，通道才解析得出來。
+
+狀態放在 `CUELINE_HOME` 底下：
+
+```text
+runs/<run-id>/events.jsonl    只追加、具權威性
+runs/<run-id>/snapshot.json   重播的最佳化產物，可丟棄
+jobs/<job-id>.json            每個工作的執行證據
+```
+
+事件日誌才是紀錄本身：主控端的這一輪在送出之前就先寫下、工作在行程啟動之前就先註冊，所以「意圖」與「副作用」之間若被中斷，會留下痕跡。壞掉的快照會被忽略、從第 1 號事件重建，而不是硬信它。
+
+## 驗證
+
+```bash
+npm ci
+npm run typecheck
+npm test
+npm run smoke:fake
+bash test/shell/install.test.sh
+npm pack --dry-run
+```
+
+`npm run smoke:fake` 會用假的瀏覽器與假的 runner，離線跑完整個主控迴圈。它證明的是迴圈，不是線上頁面——只有真正透過內建瀏覽器完成一輪，才能證明後者。
+
+## 0.1 的限制
+
+只支援純文字。一次執行只對應一個對話。不切換模型、不支援圖片、不支援檔案上傳，也不支援 Deep Research、Projects 或 Apps。工作行程一旦啟動就沒有自動重試或改道——失敗的 `work` 工作會被標記為副作用不明確後回報，因為 CueLine 無法證明它做到哪裡。macOS 是主要的桌面目標、Linux 是 CI 目標；Windows 未經驗證，而且 `install.sh` 不是 Windows 安裝程式。adapter 依賴 ChatGPT 網頁目前的介面，所以介面一改，會以明確的 `COMPOSER_MISSING`、`SEND_BUTTON_MISSING` 或回應逾時浮現——絕不會變成捏造的答案。
+
+完整矩陣見 [compatibility](docs/compatibility.md)。
+
+## 文件
+
+[architecture](docs/architecture.md) · [controller protocol](docs/controller-protocol.md) · [runner contract](docs/runner-contract.md) · [state and recovery](docs/state-and-recovery.md) · [compatibility](docs/compatibility.md) · [provenance](docs/provenance.md)（皆為英文）
+
+## 開發
+
+TypeScript、ESM，只用 Node 內建模組。`npm run build` 會編譯到 `dist/`；測試以 `node --test` 跑編譯後的產物。CI 涵蓋 Ubuntu 與 macOS 上的 Node 22 與 24。
+
+CueLine 是獨立專案，與 OpenAI 或任何其他公司皆無隸屬關係，亦未獲其背書或贊助。見 [provenance](docs/provenance.md) 與 [third-party notices](THIRD_PARTY_NOTICES.md)。
+
+## 授權
+
+MIT。見 [LICENSE](LICENSE)。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,11 @@
+# Third-party notices
+
+CueLine independently implements a deterministic model-routing pattern informed by Omnilane. It does not import Omnilane at runtime.
+
+Omnilane is licensed under the MIT License:
+
+> Copyright (c) 2026 Seraphim0916
+
+The complete MIT terms are reproduced in `LICENSE`; they permit use, modification, and redistribution when the copyright and permission notice are preserved.
+
+GPT Relay was inspected as a behavioral reference for browser interaction and recovery boundaries. CueLine does not copy or redistribute GPT Relay source code, assets, credentials, cookies, or session data.

package/bin/cueline

@@ -0,0 +1,14 @@
+#!/usr/bin/env sh
+set -eu
+
+SELF=$0
+while test -L "$SELF"; do
+  SELF_DIR=$(CDPATH= cd -- "$(dirname -- "$SELF")" && pwd)
+  LINK_TARGET=$(readlink "$SELF")
+  case $LINK_TARGET in
+    /*) SELF=$LINK_TARGET ;;
+    *) SELF=$SELF_DIR/$LINK_TARGET ;;
+  esac
+done
+ROOT=$(CDPATH= cd -- "$(dirname -- "$SELF")/.." && pwd)
+exec node "$ROOT/dist/src/cli/main.js" "$@"

package/config/routing.default.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "./routing.schema.json",
+  "version": 1,
+  "lanes": {
+    "default": {
+      "enabled": true,
+      "candidates": [
+        {
+          "id": "codex-default",
+          "argv": [
+            "codex",
+            "exec",
+            "--skip-git-repo-check",
+            "--ephemeral",
+            "--color",
+            "never",
+            "-C",
+            "{workdir}",
+            "-s",
+            "{sandbox}",
+            "-"
+          ],
+          "task_input": "stdin"
+        }
+      ]
+    }
+  }
+}

package/config/routing.schema.json

@@ -0,0 +1,58 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "CueLine routing configuration",
+  "type": "object",
+  "required": ["version", "lanes"],
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "version": {
+      "const": 1
+    },
+    "lanes": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": {
+        "type": "object",
+        "required": ["enabled", "candidates"],
+        "properties": {
+          "enabled": {
+            "type": "boolean"
+          },
+          "candidates": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "required": ["id", "argv"],
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "argv": {
+                  "type": "array",
+                  "minItems": 1,
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                },
+                "task_input": {
+                  "enum": ["argv", "stdin"]
+                },
+                "enabled": {
+                  "type": "boolean"
+                }
+              },
+              "additionalProperties": false
+            }
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/dist/src/api.d.ts

@@ -0,0 +1,34 @@
+import type { BrowserAdapter } from "./browser/browser-adapter.js";
+import { createCodexIabAdapter, type CodexIabAdapterOptions } from "./browser/codex-iab/chatgpt-client.js";
+import { type CueLineResult } from "./core/controller-loop.js";
+import { type CueLineRunState } from "./core/state-machine.js";
+import type { RoutingConfig } from "./router/types.js";
+export interface CueLineRuntimeOptions {
+    browser?: BrowserAdapter;
+    browserOptions?: Omit<CodexIabAdapterOptions, "conversationUrl">;
+    conversationUrl?: string;
+    routingConfig?: RoutingConfig;
+    routingConfigPath?: string;
+    home?: string;
+    cwd?: string;
+    environment?: NodeJS.ProcessEnv;
+    defaultTimeoutMs?: number;
+    maxRounds?: number;
+    maxRepairAttempts?: number;
+    now?: () => Date;
+}
+export interface StartCueLineRunOptions extends CueLineRuntimeOptions {
+    request: string;
+    runId?: string;
+}
+export interface ContinueCueLineRunOptions extends CueLineRuntimeOptions {
+    runId: string;
+}
+export declare function defaultRoutingConfigPath(): string;
+export declare function routingConfigPath(environment?: NodeJS.ProcessEnv, explicitPath?: string): string;
+export declare function loadCueLineRunState(runId: string, options?: Pick<CueLineRuntimeOptions, "home" | "environment">): Promise<CueLineRunState>;
+export declare function startCueLineRun(options: StartCueLineRunOptions): Promise<CueLineResult>;
+export declare function runCueLine(options: StartCueLineRunOptions): Promise<CueLineResult>;
+export declare function continueCueLineRun(options: ContinueCueLineRunOptions): Promise<CueLineResult>;
+export { createCodexIabAdapter };
+export type { BrowserAdapter, CueLineResult, CueLineRunState, RoutingConfig };

package/dist/src/api.js

@@ -0,0 +1,153 @@
+import { fileURLToPath } from "node:url";
+import { createCodexIabAdapter, } from "./browser/codex-iab/chatgpt-client.js";
+import { continueControllerLoop, runControllerLoop, } from "./core/controller-loop.js";
+import { CueLineError } from "./core/errors.js";
+import { runtimeCwd, runtimeEnvironment } from "./core/runtime.js";
+import { initialRunState, reduceRunState, } from "./core/state-machine.js";
+import { JobStatusStore } from "./jobs/status.js";
+import { JobSupervisor } from "./jobs/supervisor.js";
+import { executableAvailability } from "./router/availability.js";
+import { loadRoutingConfig } from "./router/config-loader.js";
+import { materializeRunnerSpec } from "./router/materialize.js";
+import { resolveRoute } from "./router/resolver.js";
+import { ProcessRunner } from "./runners/process-runner.js";
+import { RunnerRegistry } from "./runners/registry.js";
+import { defaultCueLineHome } from "./state/paths.js";
+import { RunStore } from "./state/store.js";
+function assertNotNested(environment) {
+    if (environment.CUELINE_DEPTH !== undefined) {
+        throw new CueLineError("NESTED_ROUTING_REJECTED", "nested CueLine routing is not allowed");
+    }
+}
+export function defaultRoutingConfigPath() {
+    return fileURLToPath(new URL("../../config/routing.default.json", import.meta.url));
+}
+export function routingConfigPath(environment = runtimeEnvironment(), explicitPath) {
+    return explicitPath ?? environment.CUELINE_CONFIG ?? defaultRoutingConfigPath();
+}
+async function persistedRunState(home, runId) {
+    const store = await RunStore.load({
+        home,
+        runId,
+        initialState: initialRunState(runId, ""),
+        reducer: reduceRunState,
+    });
+    const state = store.state;
+    if (state.request === "") {
+        throw new CueLineError("RUN_NOT_FOUND", `No persisted CueLine run '${runId}' was found.`);
+    }
+    return state;
+}
+function terminalResult(state) {
+    if (state.status !== "complete" && state.status !== "blocked") {
+        throw new CueLineError("RUN_NOT_TERMINAL", "CueLine result requested before a terminal state.");
+    }
+    return {
+        runId: state.runId,
+        status: state.status,
+        ...(state.finalDeliveryText === null ? {} : { finalDeliveryText: state.finalDeliveryText }),
+        ...(state.conversationUrl === null ? {} : { conversationUrl: state.conversationUrl }),
+        state,
+    };
+}
+export async function loadCueLineRunState(runId, options = {}) {
+    const environment = options.environment ?? runtimeEnvironment();
+    return persistedRunState(options.home ?? defaultCueLineHome(environment), runId);
+}
+async function resolvedRoutingConfig(options, environment) {
+    return (options.routingConfig ??
+        (await loadRoutingConfig(routingConfigPath(environment, options.routingConfigPath))));
+}
+function registryFor(config) {
+    const executables = new Set();
+    for (const lane of Object.values(config.lanes)) {
+        for (const candidate of lane.candidates) {
+            const executable = candidate.argv[0];
+            if (candidate.enabled !== false && executable !== undefined)
+                executables.add(executable);
+        }
+    }
+    return new RunnerRegistry([...executables].map((executable) => ({ id: executable, executable })));
+}
+function routingInstruction(config, availability) {
+    const lanes = Object.entries(config.lanes)
+        .filter(([, lane]) => lane.enabled)
+        .map(([name, lane]) => {
+        const candidates = lane.candidates
+            .filter((candidate) => candidate.enabled !== false && availability.isAvailable(candidate, name))
+            .map((candidate) => candidate.id);
+        return `${name} [${candidates.length > 0 ? candidates.join(", ") : "unavailable"}]`;
+    });
+    return `Available routing lanes: ${lanes.join("; ")}. Use only a listed available lane and optional runner id.`;
+}
+async function prepareRuntime(options, persistedConversationUrl) {
+    const environment = options.environment ?? runtimeEnvironment();
+    const home = options.home ?? defaultCueLineHome(environment);
+    const cwd = options.cwd ?? runtimeCwd();
+    const config = await resolvedRoutingConfig(options, environment);
+    const availability = executableAvailability(environment, cwd);
+    const registry = registryFor(config);
+    const runner = new ProcessRunner(registry, { environment });
+    const jobSupervisor = new JobSupervisor(runner, {
+        statusStore: new JobStatusStore(home),
+    });
+    const conversationUrl = options.conversationUrl ?? persistedConversationUrl;
+    const browser = options.browser ??
+        createCodexIabAdapter({
+            ...options.browserOptions,
+            ...(conversationUrl === undefined ? {} : { conversationUrl }),
+        });
+    return {
+        browser,
+        jobSupervisor,
+        resolveRunnerSpec(jobId, job) {
+            const route = resolveRoute(job.lane, config, availability, job.runner);
+            return materializeRunnerSpec(jobId, job, route, {
+                cwd,
+                ...(options.defaultTimeoutMs === undefined
+                    ? {}
+                    : { timeoutMs: options.defaultTimeoutMs }),
+            });
+        },
+        controllerInstructions: [routingInstruction(config, availability)],
+        home,
+    };
+}
+export async function startCueLineRun(options) {
+    assertNotNested(options.environment ?? runtimeEnvironment());
+    const runtime = await prepareRuntime(options);
+    return runControllerLoop({
+        request: options.request,
+        ...(options.runId === undefined ? {} : { runId: options.runId }),
+        ...runtime,
+        ...(options.maxRounds === undefined ? {} : { maxRounds: options.maxRounds }),
+        ...(options.maxRepairAttempts === undefined
+            ? {}
+            : { maxRepairAttempts: options.maxRepairAttempts }),
+        ...(options.now === undefined ? {} : { now: options.now }),
+    });
+}
+export async function runCueLine(options) {
+    return startCueLineRun(options);
+}
+export async function continueCueLineRun(options) {
+    const environment = options.environment ?? runtimeEnvironment();
+    const home = options.home ?? defaultCueLineHome(environment);
+    const state = await persistedRunState(home, options.runId);
+    if (state.status === "complete" || state.status === "blocked") {
+        return terminalResult(state);
+    }
+    assertNotNested(environment);
+    const runtime = await prepareRuntime(options, state.conversationUrl ?? undefined);
+    return continueControllerLoop({
+        runId: options.runId,
+        ...runtime,
+        ...(options.maxRounds === undefined ? {} : { maxRounds: options.maxRounds }),
+        ...(options.maxRepairAttempts === undefined
+            ? {}
+            : { maxRepairAttempts: options.maxRepairAttempts }),
+        ...(options.now === undefined ? {} : { now: options.now }),
+    });
+}
+export { createCodexIabAdapter };
+//# sourceMappingURL=api.js.map

package/dist/src/api.js.map

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

package/dist/src/browser/browser-adapter.d.ts

@@ -0,0 +1,15 @@
+export interface BrowserTurnInput {
+    runId: string;
+    round: number;
+    requestId: string;
+    prompt: string;
+    repairAttempt?: number;
+}
+export interface ControllerTurn {
+    text: string;
+    conversationUrl?: string;
+    title?: string;
+}
+export interface BrowserAdapter {
+    sendTurn(input: BrowserTurnInput): Promise<ControllerTurn>;
+}

package/dist/src/browser/browser-adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=browser-adapter.js.map

package/dist/src/browser/browser-adapter.js.map

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

package/dist/src/browser/codex-iab/bootstrap.d.ts

@@ -0,0 +1,66 @@
+export interface PageChatState {
+    isAnswering: boolean;
+    assistantText: string;
+    assistantMessageCount: number;
+}
+export interface IabLocator {
+    count(): Promise<number>;
+    fill(value: string, options?: Record<string, unknown>): Promise<void>;
+    click(options?: {
+        timeoutMs?: number;
+    }): Promise<void>;
+    waitFor?(options: {
+        state: "visible";
+        timeoutMs: number;
+    }): Promise<void>;
+}
+export interface IabPlaywright {
+    getByRole(role: string, query: {
+        name: string;
+    }): IabLocator;
+    locator?(selector: string): IabLocator;
+    evaluate<Result, Argument = undefined>(pageFunction: (argument: Argument) => Result | Promise<Result>, argument?: Argument): Promise<Result>;
+    domSnapshot(): Promise<unknown>;
+    waitForTimeout(milliseconds: number): Promise<void>;
+    waitForLoadState?(options: {
+        state: string;
+        timeoutMs: number;
+    }): Promise<void>;
+}
+export interface IabTab {
+    id?: string;
+    goto(url: string): Promise<void>;
+    url(): Promise<string | undefined>;
+    title?(): Promise<string>;
+    playwright: IabPlaywright;
+}
+export interface IabOpenTab {
+    id?: string;
+    url?: string;
+    title?: string;
+}
+export interface IabBrowser {
+    documentation?(): Promise<unknown>;
+    tabs: {
+        new: () => Promise<IabTab>;
+        selected?: () => Promise<IabTab | undefined>;
+        list?: () => Promise<IabOpenTab[]>;
+        get?: (id: string) => Promise<IabTab>;
+    };
+    user?: {
+        openTabs?(): Promise<IabOpenTab[]>;
+        claimTab?(tab: IabOpenTab): Promise<IabTab>;
+    };
+}
+interface BrowserAgent {
+    browsers?: {
+        get?(type: string): Promise<IabBrowser>;
+    };
+}
+declare global {
+    var iab: IabBrowser | undefined;
+    var agent: BrowserAgent | undefined;
+}
+export declare function resolveIabBrowser(requested?: IabBrowser): Promise<IabBrowser>;
+export declare function readPageChatState(tab: IabTab): Promise<PageChatState>;
+export {};

package/dist/src/browser/codex-iab/bootstrap.js

@@ -0,0 +1,41 @@
+import { CueLineError } from "../../core/errors.js";
+export async function resolveIabBrowser(requested) {
+    if (requested) {
+        await requested.documentation?.();
+        return requested;
+    }
+    if (globalThis.iab) {
+        await globalThis.iab.documentation?.();
+        return globalThis.iab;
+    }
+    if (globalThis.agent?.browsers?.get) {
+        const browser = await globalThis.agent.browsers.get("iab");
+        await browser.documentation?.();
+        globalThis.iab = browser;
+        return browser;
+    }
+    throw new CueLineError("IAB_BROWSER_MISSING", "Codex did not expose the in-app Browser runtime. Run CueLine from a Codex task with the built-in Browser available or inject an IabBrowser.");
+}
+export async function readPageChatState(tab) {
+    return tab.playwright.evaluate(() => {
+        const buttons = Array.from(document.querySelectorAll("button"));
+        const isAnswering = buttons.some((button) => {
+            const label = [button.getAttribute("aria-label"), button.textContent]
+                .filter(Boolean)
+                .join(" ")
+                .replace(/\s+/g, " ")
+                .trim();
+            return /stop/i.test(label) && /(answer|generat|respond|stream|thinking)/i.test(label);
+        });
+        const assistantMessages = Array.from(document.querySelectorAll('[data-message-author-role="assistant"]'));
+        const last = assistantMessages.at(-1);
+        const visibleText = last !== undefined && "innerText" in last
+            ? String(last.innerText ?? last.textContent ?? "")
+            : last?.textContent ?? "";
+        const assistantText = visibleText
+            .replace(/\u00a0/g, " ")
+            .trim();
+        return { isAnswering, assistantText, assistantMessageCount: assistantMessages.length };
+    });
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/src/browser/codex-iab/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../../../src/browser/codex-iab/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAmEpD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,SAAsB;IAC5D,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,SAAS,CAAC,aAAa,EAAE,EAAE,CAAC;QAClC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,UAAU,CAAC,GAAG,EAAE,CAAC;QACnB,MAAM,UAAU,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,CAAC;QACvC,OAAO,UAAU,CAAC,GAAG,CAAC;IACxB,CAAC;IACD,IAAI,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3D,MAAM,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;QAChC,UAAU,CAAC,GAAG,GAAG,OAAO,CAAC;QACzB,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,IAAI,YAAY,CACpB,qBAAqB,EACrB,6IAA6I,CAC9I,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAW;IACjD,OAAO,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE;QAClC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChE,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YAC1C,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;iBAClE,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,GAAG,CAAC;iBACT,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;iBACpB,IAAI,EAAE,CAAC;YACV,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,2CAA2C,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxF,CAAC,CAAC,CAAC;QAEH,MAAM,iBAAiB,GAAG,KAAK,CAAC,IAAI,CAClC,QAAQ,CAAC,gBAAgB,CAAC,wCAAwC,CAAC,CACpE,CAAC;QACF,MAAM,IAAI,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,WAAW,GACf,IAAI,KAAK,SAAS,IAAI,WAAW,IAAI,IAAI;YACvC,CAAC,CAAC,MAAM,CAAE,IAAyC,CAAC,SAAS,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;YACxF,CAAC,CAAC,IAAI,EAAE,WAAW,IAAI,EAAE,CAAC;QAC9B,MAAM,aAAa,GAAG,WAAW;aAC9B,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;aACvB,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,qBAAqB,EAAE,iBAAiB,CAAC,MAAM,EAAE,CAAC;IACzF,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/browser/codex-iab/chatgpt-client.d.ts

@@ -0,0 +1,10 @@
+import type { BrowserAdapter } from "../browser-adapter.js";
+import { type IabBrowser } from "./bootstrap.js";
+export interface CodexIabAdapterOptions {
+    browser?: IabBrowser;
+    conversationUrl?: string;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    stableMs?: number;
+}
+export declare function createCodexIabAdapter(options?: CodexIabAdapterOptions): BrowserAdapter;