cueline 0.1.3 → 0.1.5

package/dist/src/browser/codex-iab/recovery-evidence.d.ts

@@ -0,0 +1,6 @@
+import type { ExpectedControllerIdentity } from "../../protocol/types.js";
+export declare function normalizedConversationUrl(url: string): string;
+export declare function isProLabel(label: string | null): label is string;
+export declare function isProModelSlug(slug: string | null): slug is string;
+export declare function normalizedMessageText(value: string | null): string;
+export declare function hasExactControllerEnvelopeIdentity(text: string, expected: ExpectedControllerIdentity): boolean;

package/dist/src/browser/codex-iab/recovery-evidence.js

@@ -0,0 +1,37 @@
+const CONTROL_ENVELOPE = /<CueLineControl>([\s\S]*?)<\/CueLineControl>/g;
+export function normalizedConversationUrl(url) {
+    try {
+        const parsed = new URL(url);
+        return `${parsed.origin}${parsed.pathname}`;
+    }
+    catch {
+        return url;
+    }
+}
+export function isProLabel(label) {
+    return /^Pro(?:\s+(?:Standard|Extended))?$/i.test(label ?? "");
+}
+export function isProModelSlug(slug) {
+    return /^gpt-\d+(?:[.-]\d+)*-pro$/i.test(slug ?? "");
+}
+export function normalizedMessageText(value) {
+    return (value ?? "").replace(/\r\n/g, "\n").trim();
+}
+export function hasExactControllerEnvelopeIdentity(text, expected) {
+    let body;
+    for (const match of text.matchAll(CONTROL_ENVELOPE))
+        body = match[1];
+    if (body === undefined)
+        return false;
+    try {
+        const parsed = JSON.parse(body.trim());
+        return (parsed.protocol === "cueline/0.1" &&
+            parsed.run_id === expected.runId &&
+            parsed.round === expected.round &&
+            parsed.request_id === expected.requestId);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=recovery-evidence.js.map

package/dist/src/browser/codex-iab/recovery-evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-evidence.js","sourceRoot":"","sources":["../../../../src/browser/codex-iab/recovery-evidence.ts"],"names":[],"mappings":"AAEA,MAAM,gBAAgB,GAAG,+CAA+C,CAAC;AAEzE,MAAM,UAAU,yBAAyB,CAAC,GAAW;IACnD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAoB;IAC7C,OAAO,qCAAqC,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAmB;IAChD,OAAO,4BAA4B,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAoB;IACxD,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,IAAY,EACZ,QAAoC;IAEpC,IAAI,IAAwB,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAAE,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACrE,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAA4B,CAAC;QAClE,OAAO,CACL,MAAM,CAAC,QAAQ,KAAK,aAAa;YACjC,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,KAAK;YAChC,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK;YAC/B,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,SAAS,CACzC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/src/browser/codex-iab/submission-url.d.ts

@@ -0,0 +1,2 @@
+import type { IabTab } from "./bootstrap.js";
+export declare function captureConversationUrlAfterSubmit(tab: IabTab, knownUrl: string | undefined, timeoutMs: number, pollIntervalMs: number, signal?: AbortSignal): Promise<string>;

package/dist/src/browser/codex-iab/submission-url.js

@@ -0,0 +1,57 @@
+import { CueLineError } from "../../core/errors.js";
+// ChatGPT can spend several seconds converting a large composer payload into
+// an attachment before the new `/c/...` route becomes visible. Keep this below
+// the common 30-second outer tool window while leaving enough time for that
+// real transition.
+const CAPTURE_TIMEOUT_MS = 15_000;
+function isConversationUrl(url) {
+    return /^https:\/\/chatgpt\.com\/c\/[A-Za-z0-9-]+/.test(url);
+}
+function normalizedConversationUrl(url) {
+    try {
+        const parsed = new URL(url);
+        return `${parsed.origin}${parsed.pathname}`;
+    }
+    catch {
+        return url;
+    }
+}
+function wait(milliseconds, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted === true) {
+            reject(signal.reason ?? new CueLineError("RUN_CANCELLED", "Run cancelled."));
+            return;
+        }
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal?.reason ?? new CueLineError("RUN_CANCELLED", "Run cancelled."));
+        };
+        const timer = setTimeout(() => {
+            signal?.removeEventListener("abort", onAbort);
+            resolve();
+        }, milliseconds);
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+export async function captureConversationUrlAfterSubmit(tab, knownUrl, timeoutMs, pollIntervalMs, signal) {
+    const expectedUrl = knownUrl !== undefined && isConversationUrl(knownUrl) ? knownUrl : undefined;
+    const deadline = Date.now() + Math.min(timeoutMs, CAPTURE_TIMEOUT_MS);
+    do {
+        const currentUrl = (await tab.url().catch(() => "")) ?? "";
+        if (isConversationUrl(currentUrl)) {
+            if (expectedUrl !== undefined &&
+                normalizedConversationUrl(currentUrl) !== normalizedConversationUrl(expectedUrl)) {
+                throw new CueLineError("CONTROLLER_RECONCILIATION_CONVERSATION_MISMATCH", "ChatGPT navigated to a different conversation after the single send click. Refusing to bind either conversation or click again.", {
+                    details: {
+                        expected_conversation_url: expectedUrl,
+                        observed_conversation_url: currentUrl,
+                    },
+                });
+            }
+            return expectedUrl ?? currentUrl;
+        }
+        await wait(Math.min(pollIntervalMs, 100), signal);
+    } while (Date.now() < deadline);
+    throw new CueLineError("CONTROLLER_CONVERSATION_URL_UNAVAILABLE", "ChatGPT accepted the single send click but did not expose an exact conversation URL in time. Refusing to return an unrecoverable controller wait or click again.");
+}
+//# sourceMappingURL=submission-url.js.map

package/dist/src/browser/codex-iab/submission-url.js.map

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

package/dist/src/browser/codex-iab/tab-discovery.d.ts

@@ -0,0 +1,3 @@
+import type { IabBrowser, IabTab } from "./bootstrap.js";
+export declare function isTabUnavailableError(error: unknown): boolean;
+export declare function acquireChatGptTab(browser: IabBrowser, conversationUrl?: string): Promise<IabTab>;

package/dist/src/browser/codex-iab/tab-discovery.js

@@ -0,0 +1,61 @@
+import { normalizedConversationUrl } from "./recovery-evidence.js";
+import { CHATGPT_URL } from "./selectors.js";
+const TAB_DISCOVERY_RETRY_MS = 100;
+export function isTabUnavailableError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return /tab not found|existing tabs: none|webview.*attach|cdp operation exceeded|target closed|page closed|browser.*disconnected/i.test(message);
+}
+export async function acquireChatGptTab(browser, conversationUrl) {
+    const matchesTarget = (url) => conversationUrl === undefined
+        ? url.startsWith(CHATGPT_URL)
+        : normalizedConversationUrl(url) === normalizedConversationUrl(conversationUrl);
+    const canDiscover = browser.tabs.selected !== undefined ||
+        browser.tabs.list !== undefined ||
+        browser.user?.openTabs !== undefined;
+    const discoveryPasses = canDiscover ? 2 : 1;
+    let discoveryError;
+    for (let pass = 0; pass < discoveryPasses; pass += 1) {
+        try {
+            const selected = await browser.tabs.selected?.();
+            if (selected && matchesTarget((await selected.url()) ?? "")) {
+                await waitUntilLoaded(selected);
+                return selected;
+            }
+        }
+        catch (error) {
+            if (!isTabUnavailableError(error))
+                throw error;
+            discoveryError = error;
+        }
+        const sessionTabs = (await browser.tabs.list?.()) ?? [];
+        const sessionCandidate = sessionTabs.find((candidate) => matchesTarget(String(candidate.url ?? "")));
+        if (sessionCandidate?.id && browser.tabs.get) {
+            const tab = await browser.tabs.get(sessionCandidate.id);
+            await waitUntilLoaded(tab);
+            return tab;
+        }
+        const openTabs = (await browser.user?.openTabs?.()) ?? [];
+        const userCandidate = openTabs.find((candidate) => matchesTarget(String(candidate.url ?? "")));
+        if (userCandidate && browser.user?.claimTab) {
+            const tab = await browser.user.claimTab(userCandidate);
+            await waitUntilLoaded(tab);
+            return tab;
+        }
+        if (pass < discoveryPasses - 1) {
+            await new Promise((resolve) => setTimeout(resolve, TAB_DISCOVERY_RETRY_MS));
+        }
+    }
+    if (discoveryError !== undefined)
+        throw discoveryError;
+    const tab = await browser.tabs.new();
+    await tab.goto(conversationUrl ?? CHATGPT_URL);
+    await waitUntilLoaded(tab);
+    return tab;
+}
+async function waitUntilLoaded(tab) {
+    await tab.playwright.waitForLoadState?.({
+        state: "domcontentloaded",
+        timeoutMs: 30_000,
+    });
+}
+//# sourceMappingURL=tab-discovery.js.map

package/dist/src/browser/codex-iab/tab-discovery.js.map

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

package/dist/src/cli/main.js

@@ -3,14 +3,14 @@ import { readdir, readFile } from "node:fs/promises";
 import { realpathSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import { cancelCueLineJob, cancelCueLineRun, loadCueLineRunStatus, routingConfigPath, } from "../api.js";
+import { cancelCueLineJob, cancelCueLineRun, confirmManualControllerSubmission, loadCueLineRunStatus, reconcileCueLineRuntime, routingConfigPath, takeoverCueLineRuntime, } 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 { readRuntimeLease } from "../state/runtime-lease.js";
-import { readEvents } from "../state/event-log.js";
+import { readAuthoritativeRunEvents } from "../state/store.js";
 import { CUELINE_VERSION } from "../version.js";
 import { installSkill, uninstallSkill } from "./skill-links.js";
 const processIo = {
@@ -18,7 +18,7 @@ const processIo = {
     stderr: (line) => process.stderr.write(`${line}\n`),
 };
 function usage() {
-    return "usage: cueline <install|uninstall|doctor|routing|jobs|run status|run cancel|run stop|job cancel|api path|config path|help|version>";
+    return "usage: cueline <install|uninstall|doctor|routing|jobs|run status|run reconcile|run takeover|run reconcile-runtime|run cancel|run stop|job cancel|api path|config path|help|version>";
 }
 function help() {
     return [
@@ -29,10 +29,13 @@ function help() {
         "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",
+        "  doctor         report Node, caller readiness, state home, and process lanes",
         "  routing        list every lane and the candidate that would be selected",
         "  jobs           list persisted local jobs with run, key, lane, mode, and PID",
         "  run status     summarize one persisted run for safe cross-session handoff",
+        "  run reconcile  confirm one manually sent controller turn; never resends it",
+        "  run takeover   explicitly retire one exact stale runtime owner",
+        "  run reconcile-runtime  settle dead ownerless workers from persisted evidence",
         "  run cancel     request safe cancellation; ownerless work becomes ambiguous",
         "  run stop       alias for `run cancel`",
         "  job cancel     request cancellation for one job in one run",
@@ -41,6 +44,24 @@ function help() {
         "  help           print this text",
         "  version        print the CueLine version",
         "",
+        "command syntax:",
+        "  cueline install",
+        "  cueline uninstall",
+        "  cueline doctor",
+        "  cueline routing",
+        "  cueline jobs [--json]",
+        "  cueline run status <run-id> [--json]",
+        "  cueline run reconcile <run-id> --request-id <request-id> --manual-send-confirmed [--conversation-url <url>] [--json]",
+        "  cueline run takeover <run-id> [--json]",
+        "  cueline run reconcile-runtime <run-id> [--json]",
+        "  cueline run cancel <run-id> [--json]",
+        "  cueline run stop <run-id> [--json]",
+        "  cueline job cancel <run-id> <job-id> [--json]",
+        "  cueline api path",
+        "  cueline config path",
+        "  cueline help",
+        "  cueline version",
+        "",
         "flags:",
         "  -h, --help     same as `cueline help`",
         "  -v, --version  same as `cueline version`",
@@ -54,8 +75,14 @@ function help() {
         "  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.",
+        "state effects:",
+        "  Read-only: doctor, routing, jobs, run status, api path, config path, help, version.",
+        "  Local setup: install and uninstall change only the package-owned skill link.",
+        "  Durable state writes: run reconcile, takeover, reconcile-runtime, cancel/stop,",
+        "  and job cancel append evidence or change local run/job state.",
+        "",
+        "No CLI command drives the browser. A live run is driven through the imported API",
+        "inside Codex, where the built-in Browser lives.",
     ].join("\n");
 }
 function errorMessage(error) {
@@ -83,7 +110,7 @@ async function routingCommand(environment, io) {
     }
     return available > 0 ? 0 : 1;
 }
-async function readLegacyJobMetadata(home) {
+async function readRunJobMetadata(home) {
     const metadata = new Map();
     let entries;
     try {
@@ -97,33 +124,59 @@ async function readLegacyJobMetadata(home) {
     for (const entry of entries) {
         if (!entry.isDirectory())
             continue;
-        const events = await readEvents(path.join(home, "runs", entry.name, "events.jsonl"));
+        const events = await readAuthoritativeRunEvents(home, entry.name);
         for (const event of events) {
-            if (event.type !== "job_registered" ||
-                typeof event.payload !== "object" ||
+            if (typeof event.payload !== "object" ||
                 event.payload === null ||
-                Array.isArray(event.payload)) {
+                Array.isArray(event.payload))
                 continue;
+            const payload = event.payload;
+            if (event.type === "job_registered") {
+                const job = payload.job;
+                if (typeof job !== "object" || job === null || Array.isArray(job))
+                    continue;
+                const record = job;
+                const spec = typeof record.spec === "object" && record.spec !== null && !Array.isArray(record.spec)
+                    ? record.spec
+                    : {};
+                if (typeof record.jobId !== "string" ||
+                    typeof record.jobKey !== "string" ||
+                    typeof spec.lane !== "string" ||
+                    typeof spec.task !== "string" ||
+                    (spec.mode !== "advise" && spec.mode !== "work"))
+                    continue;
+                metadata.set(record.jobId, {
+                    jobId: record.jobId,
+                    runId: entry.name,
+                    jobKey: record.jobKey,
+                    lane: spec.lane,
+                    mode: spec.mode,
+                    task: spec.task,
+                    execution: "foreground",
+                    status: "pending",
+                    startedAt: event.timestamp,
+                });
             }
-            const job = event.payload.job;
-            if (typeof job !== "object" || job === null || Array.isArray(job))
-                continue;
-            const record = job;
-            const spec = typeof record.spec === "object" && record.spec !== null && !Array.isArray(record.spec)
-                ? record.spec
-                : {};
-            if (typeof record.jobId !== "string" ||
-                typeof record.jobKey !== "string" ||
-                typeof spec.lane !== "string" ||
-                (spec.mode !== "advise" && spec.mode !== "work")) {
-                continue;
+            else if (event.type === "job_status" && typeof payload.job_id === "string") {
+                const existing = metadata.get(payload.job_id);
+                const status = payload.status;
+                if (existing === undefined ||
+                    (status !== "pending" &&
+                        status !== "running" &&
+                        status !== "succeeded" &&
+                        status !== "failed" &&
+                        status !== "timed_out" &&
+                        status !== "cancelled" &&
+                        status !== "ambiguous"))
+                    continue;
+                metadata.set(payload.job_id, {
+                    ...existing,
+                    status,
+                    ...(status === "pending" || status === "running"
+                        ? {}
+                        : { finishedAt: event.timestamp }),
+                });
             }
-            metadata.set(record.jobId, {
-                runId: entry.name,
-                jobKey: record.jobKey,
-                lane: spec.lane,
-                mode: spec.mode,
-            });
         }
     }
     return metadata;
@@ -136,8 +189,9 @@ async function readJobs(home) {
     }
     catch (error) {
         if (error.code === "ENOENT")
-            return [];
-        throw error;
+            names = [];
+        else
+            throw error;
     }
     const statuses = [];
     for (const name of names.filter((candidate) => candidate.endsWith(".json")).sort()) {
@@ -150,13 +204,31 @@ async function readJobs(home) {
             });
         }
     }
-    const legacyMetadata = await readLegacyJobMetadata(home);
+    const runMetadata = await readRunJobMetadata(home);
+    const persistedById = new Map(statuses.map((status) => [status.jobId, status]));
+    for (const [jobId, metadata] of runMetadata) {
+        if (!persistedById.has(jobId))
+            statuses.push(metadata);
+    }
     const ownership = new Map();
     const listed = [];
     for (const persisted of statuses) {
-        const status = { ...legacyMetadata.get(persisted.jobId), ...persisted };
-        let observedStatus = status.status;
-        if (status.status === "running") {
+        const authoritative = runMetadata.get(persisted.jobId);
+        const conflict = authoritative !== undefined && authoritative.status !== persisted.status;
+        const status = conflict
+            ? {
+                ...Object.fromEntries(Object.entries(persisted).filter(([key]) => key !== "result" && key !== "error" && key !== "finishedAt")),
+                ...authoritative,
+                execution: persisted.execution,
+                startedAt: persisted.startedAt,
+            }
+            : {
+                ...authoritative,
+                ...persisted,
+                status: authoritative?.status ?? persisted.status,
+            };
+        let observedStatus = conflict ? "conflict" : status.status;
+        if (!conflict && status.status === "running") {
             if (status.runId === undefined) {
                 observedStatus = "unverified";
             }
@@ -169,7 +241,11 @@ async function readJobs(home) {
                 observedStatus = runtime.ownership === "active" ? "running" : "orphaned";
             }
         }
-        listed.push({ ...status, observedStatus });
+        listed.push({
+            ...status,
+            ...(conflict ? { persistedStatus: persisted.status } : {}),
+            observedStatus,
+        });
     }
     return listed.sort((left, right) => left.startedAt.localeCompare(right.startedAt));
 }
@@ -184,7 +260,7 @@ async function jobsCommand(json, environment, io) {
         return 0;
     }
     for (const job of jobs) {
-        io.stdout(`${job.jobId}\t${job.runId ?? "-"}\t${job.jobKey ?? "-"}\t${job.lane ?? "-"}\t${job.mode ?? "-"}\t${job.pid ?? "-"}\t${job.execution}\t${job.observedStatus}\t${job.startedAt}`);
+        io.stdout(`${job.jobId}\t${job.runId ?? "-"}\t${job.jobKey ?? "-"}\t${job.lane ?? "-"}\t${job.mode ?? "-"}\t${job.pid ?? "-"}\t${job.execution}\t${job.observedStatus}\t${job.startedAt}\ttask=${JSON.stringify(job.task ?? "")}`);
     }
     return 0;
 }
@@ -203,6 +279,7 @@ async function runStatusCommand(runId, json, environment, io) {
     io.stdout(`run\t${status.runId}`);
     io.stdout(`version\t${CUELINE_VERSION}`);
     io.stdout(`status\t${status.status}`);
+    io.stdout(`executor\t${status.executor}`);
     io.stdout(`phase\t${status.phase}`);
     io.stdout(`runtime\t${status.runtime.ownership}${status.runtime.heartbeatAt === undefined
         ? ""
@@ -211,7 +288,7 @@ async function runStatusCommand(runId, json, environment, io) {
     io.stdout(`controller\t${controller}\tpending=${status.controller.pendingTurns}\taccepted_commands=${status.controller.acceptedCommands}\tlast_action=${status.controller.lastAcceptedAction ?? "-"}\tlast_jobs=${status.controller.lastAcceptedJobKeys.length}`);
     io.stdout(`jobs\ttotal=${status.jobs.total}\tpending=${counts.pending}\trunning=${counts.running}\tsucceeded=${counts.succeeded}\tfailed=${counts.failed}\ttimed_out=${counts.timed_out}\torphaned=${counts.orphaned}\tcancelled=${counts.cancelled}\tambiguous=${counts.ambiguous}`);
     for (const job of status.jobs.items) {
-        io.stdout(`job\t${job.jobId}\t${job.jobKey}\t${job.status}\t${job.mode}\t${job.lane}\trequired=${job.required}\tpersisted=${job.persistedStatus}`);
+        io.stdout(`job\t${job.jobId}\t${job.jobKey}\t${job.status}\t${job.mode}\t${job.lane}\trequired=${job.required}\tpersisted=${job.persistedStatus}\ttask=${JSON.stringify(job.task)}`);
     }
     io.stdout(`cancellation\trun=${status.cancellation.runRequested ? "requested" : "none"}\tjobs=${status.cancellation.jobRequests.length}`);
     io.stdout(`continue\t${status.continueAllowed ? "allowed" : "forbidden"}`);
@@ -225,26 +302,30 @@ async function doctorCommand(environment, io) {
     const nodeOk = major >= 22;
     const config = await loadRoutingConfig(configPath);
     const availability = executableAvailability(environment);
-    let availableLanes = 0;
+    let callerLanes = 0;
+    let processAvailableLanes = 0;
     for (const [lane, laneConfig] of Object.entries(config.lanes)) {
         if (!laneConfig.enabled)
             continue;
+        callerLanes += 1;
         try {
             resolveRoute(lane, config, availability);
-            availableLanes += 1;
+            processAvailableLanes += 1;
         }
         catch {
             // Doctor reports the aggregate below; `cueline routing` shows lane details.
         }
     }
-    const ok = nodeOk && availableLanes > 0;
+    const callerReady = nodeOk && callerLanes > 0;
     io.stdout(`CueLine ${CUELINE_VERSION}`);
-    io.stdout(`status\t${ok ? "ok" : "degraded"}`);
+    io.stdout(`status\t${callerReady ? "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;
+    io.stdout(`caller_ready\t${callerReady ? "yes" : "no"}`);
+    io.stdout(`caller_lanes\t${callerLanes}`);
+    io.stdout(`process_available_lanes\t${processAvailableLanes}`);
+    return callerReady ? 0 : 1;
 }
 export async function main(args = process.argv.slice(2), environment = process.env, io = processIo) {
     try {
@@ -256,6 +337,11 @@ export async function main(args = process.argv.slice(2), environment = process.e
             io.stdout(help());
             return 0;
         }
+        if (args.length > 1 &&
+            args.some((argument) => argument === "--help" || argument === "-h")) {
+            io.stdout(help());
+            return 0;
+        }
         if (args.length === 1 && ["version", "--version", "-v"].includes(args[0])) {
             io.stdout(CUELINE_VERSION);
             return 0;
@@ -283,6 +369,75 @@ export async function main(args = process.argv.slice(2), environment = process.e
             (args.length === 1 || (args.length === 2 && args[1] === "--json"))) {
             return jobsCommand(args[1] === "--json", environment, io);
         }
+        if (args[0] === "run" &&
+            args[1] === "takeover" &&
+            typeof args[2] === "string" &&
+            (args.length === 3 || (args.length === 4 && args[3] === "--json"))) {
+            const result = await takeoverCueLineRuntime(args[2], { environment });
+            if (args[3] === "--json")
+                io.stdout(JSON.stringify(result, null, 2));
+            else {
+                io.stdout(`${result.runId}\t${result.outcome}\tnext=${result.next}${result.previousOwnerId === undefined
+                    ? ""
+                    : `\tprevious_owner=${result.previousOwnerId}`}`);
+            }
+            return 0;
+        }
+        if (args[0] === "run" &&
+            args[1] === "reconcile-runtime" &&
+            typeof args[2] === "string" &&
+            (args.length === 3 || (args.length === 4 && args[3] === "--json"))) {
+            const result = await reconcileCueLineRuntime(args[2], { environment });
+            if (args[3] === "--json")
+                io.stdout(JSON.stringify(result, null, 2));
+            else {
+                io.stdout(`${result.runId}\t${result.outcome}\taffected_jobs=${result.affectedJobs}\tsurviving_jobs=${result.survivingJobs.length}`);
+            }
+            return result.outcome === "owner_alive" || result.outcome === "processes_alive" ? 1 : 0;
+        }
+        if (args[0] === "run" &&
+            args[1] === "reconcile" &&
+            typeof args[2] === "string") {
+            let requestId;
+            let conversationUrl;
+            let manualConfirmed = false;
+            let json = false;
+            let valid = true;
+            for (let index = 3; index < args.length; index += 1) {
+                const argument = args[index];
+                if (argument === "--request-id" && typeof args[index + 1] === "string") {
+                    requestId = args[index + 1];
+                    index += 1;
+                }
+                else if (argument === "--conversation-url" &&
+                    typeof args[index + 1] === "string") {
+                    conversationUrl = args[index + 1];
+                    index += 1;
+                }
+                else if (argument === "--manual-send-confirmed") {
+                    manualConfirmed = true;
+                }
+                else if (argument === "--json") {
+                    json = true;
+                }
+                else {
+                    valid = false;
+                }
+            }
+            if (!valid || !requestId || !manualConfirmed) {
+                throw new CueLineError("CLI_ARGUMENTS_INVALID", "usage: cueline run reconcile <run-id> --request-id <request-id> --manual-send-confirmed [--conversation-url <url>] [--json]");
+            }
+            const result = await confirmManualControllerSubmission(args[2], {
+                environment,
+                requestId,
+                ...(conversationUrl === undefined ? {} : { conversationUrl }),
+            });
+            if (json)
+                io.stdout(JSON.stringify(result, null, 2));
+            else
+                io.stdout(`${result.runId}\t${result.requestId}\t${result.outcome}\tno_resend`);
+            return 0;
+        }
         if (args[0] === "run" &&
             args[1] === "status" &&
             typeof args[2] === "string" &&
@@ -328,7 +483,7 @@ export async function main(args = process.argv.slice(2), environment = process.e
     }
     catch (error) {
         io.stderr(`CueLine: ${errorMessage(error)}`);
-        return 1;
+        return error instanceof CueLineError && error.code === "CLI_ARGUMENTS_INVALID" ? 2 : 1;
     }
 }
 if (process.argv[1] !== undefined &&