cueline 0.1.0

package/dist/src/browser/codex-iab/chatgpt-client.js

@@ -0,0 +1,180 @@
+import { CueLineError } from "../../core/errors.js";
+import { readPageChatState, resolveIabBrowser, } from "./bootstrap.js";
+import { CHATGPT_URL, COMPOSER_TEXTBOX_NAMES, SEND_BUTTON_NAMES } from "./selectors.js";
+const DEFAULT_TIMEOUT_MS = 30 * 60 * 1_000;
+const DEFAULT_POLL_INTERVAL_MS = 1_000;
+const DEFAULT_STABLE_MS = 1_500;
+const COMPOSER_HYDRATION_TIMEOUT_MS = 5_000;
+const CONTENTEDITABLE_COMPOSER_SELECTOR = '#prompt-textarea[contenteditable="true"]';
+function delay(milliseconds) {
+    return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+async function findUniqueLocator(tab, role, names) {
+    for (const name of names) {
+        const locator = tab.playwright.getByRole(role, { name });
+        if ((await locator.count()) === 1) {
+            return locator;
+        }
+    }
+    return undefined;
+}
+async function findHydratedComposer(tab) {
+    if (!tab.playwright.locator)
+        return undefined;
+    const composer = tab.playwright.locator(CONTENTEDITABLE_COMPOSER_SELECTOR);
+    try {
+        await composer.waitFor?.({ state: "visible", timeoutMs: COMPOSER_HYDRATION_TIMEOUT_MS });
+        return (await composer.count()) === 1 ? composer : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function isConversationUrl(url) {
+    return /^https:\/\/chatgpt\.com\/c\/[A-Za-z0-9-]+/.test(url);
+}
+function isTransientClickError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return /deadline exceeded|timed? out|timeout|detached|stale|not enabled|not visible/i.test(message);
+}
+class CodexIabAdapter {
+    #options;
+    #browser;
+    #tab;
+    constructor(options) {
+        this.#options = {
+            timeoutMs: options.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+            pollIntervalMs: options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS,
+            stableMs: options.stableMs ?? DEFAULT_STABLE_MS,
+            ...(options.browser === undefined ? {} : { browser: options.browser }),
+            ...(options.conversationUrl === undefined ? {} : { conversationUrl: options.conversationUrl }),
+        };
+    }
+    async #getBrowser() {
+        this.#browser ??= await resolveIabBrowser(this.#options.browser);
+        return this.#browser;
+    }
+    async #getTab() {
+        if (this.#tab)
+            return this.#tab;
+        const browser = await this.#getBrowser();
+        const targetUrl = this.#options.conversationUrl;
+        const matchesTarget = (url) => targetUrl ? url === targetUrl : url.startsWith(CHATGPT_URL);
+        const selected = await browser.tabs.selected?.().catch(() => undefined);
+        if (selected && matchesTarget((await selected.url().catch(() => "")) ?? "")) {
+            this.#tab = selected;
+            return selected;
+        }
+        const sessionTabs = await browser.tabs.list?.().catch(() => []);
+        const sessionCandidate = sessionTabs?.find((tab) => matchesTarget(String(tab.url ?? "")));
+        let tab;
+        if (sessionCandidate?.id && browser.tabs.get) {
+            tab = await browser.tabs.get(sessionCandidate.id);
+        }
+        const openTabs = tab === undefined ? await browser.user?.openTabs?.().catch(() => []) : [];
+        const candidate = openTabs?.find((openTab) => {
+            const url = String(openTab.url ?? "");
+            return matchesTarget(url);
+        });
+        if (tab === undefined && candidate && browser.user?.claimTab) {
+            tab = await browser.user.claimTab(candidate);
+        }
+        else if (tab === undefined) {
+            tab = await browser.tabs.new();
+            await tab.goto(targetUrl ?? CHATGPT_URL);
+        }
+        this.#tab = tab;
+        await tab.playwright.waitForLoadState?.({
+            state: "domcontentloaded",
+            timeoutMs: 30_000,
+        });
+        return tab;
+    }
+    async #submissionStarted(tab, previousUrl) {
+        const currentUrl = (await tab.url().catch(() => previousUrl)) ?? previousUrl;
+        if (!isConversationUrl(previousUrl) && isConversationUrl(currentUrl)) {
+            return true;
+        }
+        return (await readPageChatState(tab).catch(() => ({
+            isAnswering: false,
+            assistantText: "",
+            assistantMessageCount: 0,
+        }))).isAnswering;
+    }
+    async #clickSend(tab) {
+        const previousUrl = (await tab.url()) ?? "";
+        for (let attempt = 0; attempt < 2; attempt += 1) {
+            const button = await findUniqueLocator(tab, "button", SEND_BUTTON_NAMES);
+            if (!button) {
+                if (attempt > 0 && await this.#submissionStarted(tab, previousUrl)) {
+                    return;
+                }
+                throw new CueLineError("SEND_BUTTON_MISSING", "Could not find ChatGPT's send button.");
+            }
+            try {
+                await button.click({ timeoutMs: 10_000 });
+                return;
+            }
+            catch (error) {
+                if (await this.#submissionStarted(tab, previousUrl)) {
+                    return;
+                }
+                if (attempt === 1 || !isTransientClickError(error)) {
+                    throw error;
+                }
+                await tab.playwright.domSnapshot();
+                await tab.playwright.waitForTimeout(250);
+            }
+        }
+    }
+    async #waitForCompletion(tab, baseline) {
+        const deadline = Date.now() + this.#options.timeoutMs;
+        let stableText = "";
+        let stableSince = 0;
+        let responseStarted = false;
+        while (Date.now() < deadline) {
+            const state = await readPageChatState(tab);
+            if (state.isAnswering || state.assistantMessageCount > baseline.assistantMessageCount) {
+                responseStarted = true;
+            }
+            if (responseStarted && !state.isAnswering && state.assistantText !== "") {
+                if (state.assistantText !== stableText) {
+                    stableText = state.assistantText;
+                    stableSince = Date.now();
+                }
+                if (Date.now() - stableSince >= this.#options.stableMs) {
+                    return stableText;
+                }
+            }
+            else {
+                stableText = state.assistantText;
+                stableSince = Date.now();
+            }
+            await delay(this.#options.pollIntervalMs);
+        }
+        throw new CueLineError("CHATGPT_RESPONSE_TIMEOUT", "ChatGPT did not finish before timeout.");
+    }
+    async sendTurn(input) {
+        const tab = await this.#getTab();
+        const baseline = await readPageChatState(tab);
+        const composer = (await findHydratedComposer(tab)) ??
+            (await findUniqueLocator(tab, "textbox", COMPOSER_TEXTBOX_NAMES));
+        if (!composer) {
+            throw new CueLineError("COMPOSER_MISSING", "Could not find ChatGPT's message composer.");
+        }
+        await composer.fill(input.prompt, {});
+        await this.#clickSend(tab);
+        const text = await this.#waitForCompletion(tab, baseline);
+        const conversationUrl = (await tab.url()) ?? "";
+        const title = await tab.title?.();
+        return {
+            text,
+            ...(conversationUrl === "" ? {} : { conversationUrl }),
+            ...(title === undefined || title === "" ? {} : { title }),
+        };
+    }
+}
+export function createCodexIabAdapter(options = {}) {
+    return new CodexIabAdapter(options);
+}
+//# sourceMappingURL=chatgpt-client.js.map

package/dist/src/browser/codex-iab/chatgpt-client.js.map

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

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

@@ -0,0 +1,3 @@
+export declare const COMPOSER_TEXTBOX_NAMES: readonly ["Message ChatGPT", "Chat with ChatGPT", "與 ChatGPT 對話", "傳訊息給 ChatGPT", "和 ChatGPT 聊天"];
+export declare const SEND_BUTTON_NAMES: readonly ["Send prompt", "Send message", "傳送提示", "傳送訊息", "送出提示", "送出訊息"];
+export declare const CHATGPT_URL = "https://chatgpt.com/";

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

@@ -0,0 +1,17 @@
+export const COMPOSER_TEXTBOX_NAMES = [
+    "Message ChatGPT",
+    "Chat with ChatGPT",
+    "與 ChatGPT 對話",
+    "傳訊息給 ChatGPT",
+    "和 ChatGPT 聊天",
+];
+export const SEND_BUTTON_NAMES = [
+    "Send prompt",
+    "Send message",
+    "傳送提示",
+    "傳送訊息",
+    "送出提示",
+    "送出訊息",
+];
+export const CHATGPT_URL = "https://chatgpt.com/";
+//# sourceMappingURL=selectors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.js","sourceRoot":"","sources":["../../../../src/browser/codex-iab/selectors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,iBAAiB;IACjB,mBAAmB;IACnB,cAAc;IACd,cAAc;IACd,cAAc;CACN,CAAC;AAEX,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,aAAa;IACb,cAAc;IACd,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;CACE,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAG,sBAAsB,CAAC"}

package/dist/src/cli/main.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+interface CliIo {
+    stdout: (line: string) => void;
+    stderr: (line: string) => void;
+}
+export declare function main(args?: readonly string[], environment?: NodeJS.ProcessEnv, io?: CliIo): Promise<number>;
+export {};

package/dist/src/cli/main.js

@@ -0,0 +1,196 @@
+#!/usr/bin/env node
+import { readdir, readFile } from "node:fs/promises";
+import { realpathSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { routingConfigPath } from "../api.js";
+import { CueLineError } from "../core/errors.js";
+import { executableAvailability } from "../router/availability.js";
+import { loadRoutingConfig } from "../router/config-loader.js";
+import { resolveRoute } from "../router/resolver.js";
+import { defaultCueLineHome } from "../state/paths.js";
+import { CUELINE_VERSION } from "../version.js";
+import { installSkill, uninstallSkill } from "./skill-links.js";
+const processIo = {
+    stdout: (line) => process.stdout.write(`${line}\n`),
+    stderr: (line) => process.stderr.write(`${line}\n`),
+};
+function usage() {
+    return "usage: cueline <install|uninstall|doctor|routing|jobs|api path|config path|help|version>";
+}
+function help() {
+    return [
+        "CueLine — a ChatGPT web conversation directs; this machine executes.",
+        "",
+        usage(),
+        "",
+        "commands:",
+        "  install        link the bundled skill into Codex",
+        "  uninstall      remove only the skill link owned by this package",
+        "  doctor         report Node, routing config, state home, and usable lanes",
+        "  routing        list every lane and the candidate that would be selected",
+        "  jobs           list persisted local jobs, oldest first",
+        "  api path       print the bundled API module path",
+        "  config path    print the routing configuration file in effect",
+        "  help           print this text",
+        "  version        print the CueLine version",
+        "",
+        "flags:",
+        "  -h, --help     same as `cueline help`",
+        "  -v, --version  same as `cueline version`",
+        "",
+        "environment:",
+        "  CUELINE_HOME    run and job state directory (default: ~/.cueline)",
+        "  CUELINE_CONFIG  routing configuration file (default: the bundled config)",
+        "",
+        "exit codes:",
+        "  0  the command answered and the checked surface is usable",
+        "  1  the command ran but the surface is degraded or unreadable",
+        "  2  the arguments were not understood",
+        "",
+        "These commands only diagnose the local installation. A live run is driven",
+        "through the imported API inside Codex, where the built-in Browser lives.",
+    ].join("\n");
+}
+function errorMessage(error) {
+    if (error instanceof CueLineError)
+        return `${error.code}: ${error.message}`;
+    return error instanceof Error ? error.message : String(error);
+}
+async function routingCommand(environment, io) {
+    const config = await loadRoutingConfig(routingConfigPath(environment));
+    const availability = executableAvailability(environment);
+    let available = 0;
+    for (const [lane, laneConfig] of Object.entries(config.lanes)) {
+        if (!laneConfig.enabled) {
+            io.stdout(`${lane}\t-\tdisabled`);
+            continue;
+        }
+        try {
+            const route = resolveRoute(lane, config, availability);
+            available += 1;
+            io.stdout(`${lane}\t${route.candidate.id}\tavailable`);
+        }
+        catch (error) {
+            io.stdout(`${lane}\t-\tunavailable (${errorMessage(error)})`);
+        }
+    }
+    return available > 0 ? 0 : 1;
+}
+async function readJobs(home) {
+    const directory = path.join(home, "jobs");
+    let names;
+    try {
+        names = await readdir(directory);
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+    const statuses = [];
+    for (const name of names.filter((candidate) => candidate.endsWith(".json")).sort()) {
+        try {
+            statuses.push(JSON.parse(await readFile(path.join(directory, name), "utf8")));
+        }
+        catch (error) {
+            throw new CueLineError("JOB_STATUS_INVALID", `unable to parse job status: ${name}`, {
+                cause: error,
+            });
+        }
+    }
+    return statuses.sort((left, right) => left.startedAt.localeCompare(right.startedAt));
+}
+async function jobsCommand(environment, io) {
+    const jobs = await readJobs(defaultCueLineHome(environment));
+    if (jobs.length === 0) {
+        io.stdout("No jobs.");
+        return 0;
+    }
+    for (const job of jobs) {
+        io.stdout(`${job.jobId}\t${job.execution}\t${job.status}\t${job.startedAt}`);
+    }
+    return 0;
+}
+async function doctorCommand(environment, io) {
+    const configPath = routingConfigPath(environment);
+    const home = defaultCueLineHome(environment);
+    const major = Number.parseInt(process.versions.node.split(".")[0] ?? "0", 10);
+    const nodeOk = major >= 22;
+    const config = await loadRoutingConfig(configPath);
+    const availability = executableAvailability(environment);
+    let availableLanes = 0;
+    for (const [lane, laneConfig] of Object.entries(config.lanes)) {
+        if (!laneConfig.enabled)
+            continue;
+        try {
+            resolveRoute(lane, config, availability);
+            availableLanes += 1;
+        }
+        catch {
+            // Doctor reports the aggregate below; `cueline routing` shows lane details.
+        }
+    }
+    const ok = nodeOk && availableLanes > 0;
+    io.stdout(`CueLine ${CUELINE_VERSION}`);
+    io.stdout(`status\t${ok ? "ok" : "degraded"}`);
+    io.stdout(`node\t${process.versions.node}\t${nodeOk ? "ok" : "requires >=22"}`);
+    io.stdout(`config\t${configPath}\tvalid`);
+    io.stdout(`home\t${home}`);
+    io.stdout(`available_lanes\t${availableLanes}`);
+    return ok ? 0 : 1;
+}
+export async function main(args = process.argv.slice(2), environment = process.env, io = processIo) {
+    try {
+        if (args.length === 0) {
+            io.stdout(help());
+            return 0;
+        }
+        if (args.length === 1 && ["help", "--help", "-h"].includes(args[0])) {
+            io.stdout(help());
+            return 0;
+        }
+        if (args.length === 1 && ["version", "--version", "-v"].includes(args[0])) {
+            io.stdout(CUELINE_VERSION);
+            return 0;
+        }
+        if (args[0] === "config" && args[1] === "path" && args.length === 2) {
+            io.stdout(routingConfigPath(environment));
+            return 0;
+        }
+        if (args[0] === "api" && args[1] === "path" && args.length === 2) {
+            io.stdout(fileURLToPath(new URL("../api.js", import.meta.url)));
+            return 0;
+        }
+        if (args[0] === "install" && args.length === 1) {
+            io.stdout(await installSkill(environment));
+            return 0;
+        }
+        if (args[0] === "uninstall" && args.length === 1) {
+            io.stdout(await uninstallSkill(environment));
+            return 0;
+        }
+        if (args[0] === "routing" && args.length === 1) {
+            return routingCommand(environment, io);
+        }
+        if (args[0] === "jobs" && args.length === 1) {
+            return jobsCommand(environment, io);
+        }
+        if (args[0] === "doctor" && args.length === 1) {
+            return doctorCommand(environment, io);
+        }
+        io.stderr(`cueline: unrecognized command: ${args.join(" ")}`);
+        io.stderr(usage());
+        io.stderr("try `cueline help`");
+        return 2;
+    }
+    catch (error) {
+        io.stderr(`CueLine: ${errorMessage(error)}`);
+        return 1;
+    }
+}
+if (process.argv[1] !== undefined &&
+    realpathSync(fileURLToPath(import.meta.url)) === realpathSync(process.argv[1])) {
+    process.exitCode = await main();
+}
+//# sourceMappingURL=main.js.map

package/dist/src/cli/main.js.map

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

package/dist/src/cli/skill-links.d.ts

@@ -0,0 +1,2 @@
+export declare function installSkill(environment: NodeJS.ProcessEnv): Promise<string>;
+export declare function uninstallSkill(environment: NodeJS.ProcessEnv): Promise<string>;

package/dist/src/cli/skill-links.js

@@ -0,0 +1,64 @@
+import { access, lstat, mkdir, readlink, symlink, unlink } from "node:fs/promises";
+import { homedir } from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const skillSource = fileURLToPath(new URL("../../../skills/cueline", import.meta.url));
+function codexHome(environment) {
+    if (environment.CODEX_HOME)
+        return path.resolve(environment.CODEX_HOME);
+    const home = environment.HOME || homedir();
+    return path.join(home, ".codex");
+}
+function skillTarget(environment) {
+    return path.join(codexHome(environment), "skills", "cueline");
+}
+async function pathExists(candidate) {
+    try {
+        await lstat(candidate);
+        return true;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return false;
+        throw error;
+    }
+}
+async function linkMatches(target, source) {
+    try {
+        const details = await lstat(target);
+        if (!details.isSymbolicLink())
+            return false;
+        const linked = await readlink(target);
+        return path.resolve(path.dirname(target), linked) === path.resolve(source);
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return false;
+        throw error;
+    }
+}
+export async function installSkill(environment) {
+    const target = skillTarget(environment);
+    await access(path.join(skillSource, "SKILL.md"));
+    if (await linkMatches(target, skillSource)) {
+        return `CueLine skill already installed: ${target}`;
+    }
+    if (await pathExists(target)) {
+        throw new Error(`refusing to replace foreign path: ${target}`);
+    }
+    await mkdir(path.dirname(target), { recursive: true });
+    await symlink(skillSource, target, process.platform === "win32" ? "junction" : "dir");
+    return `CueLine skill installed: ${target}`;
+}
+export async function uninstallSkill(environment) {
+    const target = skillTarget(environment);
+    if (await linkMatches(target, skillSource)) {
+        await unlink(target);
+        return `CueLine skill removed: ${target}`;
+    }
+    if (await pathExists(target)) {
+        return `CueLine preserved foreign path: ${target}`;
+    }
+    return `CueLine skill not installed: ${target}`;
+}
+//# sourceMappingURL=skill-links.js.map

package/dist/src/cli/skill-links.js.map

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

package/dist/src/core/controller-loop.d.ts

@@ -0,0 +1,36 @@
+import type { BrowserAdapter } from "../browser/browser-adapter.js";
+import type { JobStatus } from "../jobs/status.js";
+import { type ControllerJobSpec } from "../protocol/types.js";
+import type { RunnerSpec } from "../runners/runner-adapter.js";
+import { type CueLineRunState, type CueLineRunStatus } from "./state-machine.js";
+export interface JobSupervisorLike {
+    start(spec: RunnerSpec): Promise<JobStatus>;
+    waitForCompletion(jobId: string): Promise<JobStatus>;
+    inspect(jobId: string): Promise<JobStatus>;
+}
+export interface ControllerRuntimeOptions {
+    browser: BrowserAdapter;
+    jobSupervisor: JobSupervisorLike;
+    resolveRunnerSpec: (jobId: string, job: ControllerJobSpec) => RunnerSpec;
+    home?: string;
+    maxRounds?: number;
+    maxRepairAttempts?: number;
+    controllerInstructions?: readonly string[];
+    now?: () => Date;
+}
+export interface ControllerLoopOptions extends ControllerRuntimeOptions {
+    request: string;
+    runId?: string;
+}
+export interface ContinueControllerLoopOptions extends ControllerRuntimeOptions {
+    runId: string;
+}
+export interface CueLineResult {
+    runId: string;
+    status: Exclude<CueLineRunStatus, "running" | "failed">;
+    finalDeliveryText?: string;
+    conversationUrl?: string;
+    state: CueLineRunState;
+}
+export declare function runControllerLoop(options: ControllerLoopOptions): Promise<CueLineResult>;
+export declare function continueControllerLoop(options: ContinueControllerLoopOptions): Promise<CueLineResult>;