cueline 0.1.2 → 0.1.4

package/dist/src/api-contracts.d.ts

@@ -0,0 +1,77 @@
+import type { BrowserAdapter } from "./browser/browser-adapter.js";
+import type { CodexIabAdapterOptions } from "./browser/codex-iab/chatgpt-client.js";
+import type { RoutingConfig } from "./router/types.js";
+import type { JobResultStatus } from "./runners/runner-adapter.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;
+    signal?: AbortSignal;
+    cancellationPollIntervalMs?: number;
+    runTimeoutMs?: number;
+    executor?: "caller" | "process";
+    maxConcurrency?: number;
+    laneConcurrency?: Readonly<Record<string, number>>;
+}
+export interface StartCueLineRunOptions extends CueLineRuntimeOptions {
+    request: string;
+    runId?: string;
+}
+export interface ContinueCueLineRunOptions extends CueLineRuntimeOptions {
+    runId: string;
+    reconcileRequestId?: string;
+    abandonOtherPendingTurns?: boolean;
+    manualSendConfirmed?: boolean;
+}
+export interface ManualControllerSubmissionConfirmation {
+    runId: string;
+    requestId: string;
+    conversationUrl: string;
+    outcome: "confirmed" | "already_confirmed";
+}
+export interface CueLineCallerJobResultInput {
+    status: JobResultStatus;
+    stdout?: string;
+    stderr?: string;
+    output?: string;
+    error?: string;
+    exitCode?: number | null;
+    startedAt?: string;
+    finishedAt?: string;
+}
+export interface CueLineCallerJobSubmissionResult {
+    runId: string;
+    jobId: string;
+    outcome: "submitted" | "already_terminal";
+}
+export interface CueLineRuntimeReconciliationResult {
+    runId: string;
+    outcome: "reconciled" | "owner_alive" | "processes_alive" | "already_terminal";
+    affectedJobs: number;
+    survivingJobs: string[];
+}
+export interface CueLineRuntimeTakeoverResult {
+    runId: string;
+    outcome: "taken_over" | "already_available" | "already_terminal";
+    next: "continue" | "reconcile_runtime" | "none";
+    previousOwnerId?: string;
+}
+export interface CueLineRunCancellationResult {
+    runId: string;
+    outcome: "requested" | "cancelled" | "already_terminal";
+    affectedJobs: number;
+}
+export interface CueLineJobCancellationResult {
+    runId: string;
+    jobId: string;
+    outcome: "requested" | "cancelled" | "ambiguous" | "already_terminal";
+}

package/dist/src/api-contracts.js

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

package/dist/src/api-contracts.js.map

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

package/dist/src/api-controller-handoff.d.ts

@@ -0,0 +1,6 @@
+import type { CueLineCallerJobResultInput, CueLineCallerJobSubmissionResult, CueLineRuntimeOptions, ManualControllerSubmissionConfirmation } from "./api-contracts.js";
+export declare function confirmManualControllerSubmission(runId: string, options: Pick<CueLineRuntimeOptions, "home" | "environment" | "now"> & {
+    requestId: string;
+    conversationUrl?: string;
+}): Promise<ManualControllerSubmissionConfirmation>;
+export declare function submitCueLineCallerJobResult(runId: string, jobId: string, input: CueLineCallerJobResultInput, options?: Pick<CueLineRuntimeOptions, "home" | "environment" | "now">): Promise<CueLineCallerJobSubmissionResult>;

package/dist/src/api-controller-handoff.js

@@ -0,0 +1,253 @@
+import { CueLineError } from "./core/errors.js";
+import { loadPersistedRunStore } from "./core/persisted-run.js";
+import { runtimeEnvironment } from "./core/runtime.js";
+import { JobStatusStore } from "./jobs/status.js";
+import { defaultCueLineHome } from "./state/paths.js";
+import { readRuntimeLease, retireDeadRuntimeLease, RuntimeLease, } from "./state/runtime-lease.js";
+import { readAuthoritativeRunEvents } from "./state/store.js";
+function normalizedConversationUrl(value) {
+    try {
+        const parsed = new URL(value);
+        return `${parsed.origin}${parsed.pathname}`;
+    }
+    catch {
+        return value;
+    }
+}
+export async function confirmManualControllerSubmission(runId, options) {
+    const environment = options.environment ?? runtimeEnvironment();
+    const home = options.home ?? defaultCueLineHome(environment);
+    await loadPersistedRunStore(home, runId);
+    const runtime = await readRuntimeLease(home, runId, {
+        ...(options.now === undefined ? {} : { now: options.now }),
+    });
+    const retiredOwner = (runtime.ownership === "active" || runtime.ownership === "stale") &&
+        runtime.ownerId !== undefined &&
+        (await retireDeadRuntimeLease(home, runId, runtime.ownerId))
+        ? { ownerId: runtime.ownerId, ownership: runtime.ownership }
+        : undefined;
+    const lease = await RuntimeLease.claim({
+        home,
+        runId,
+        ...(options.now === undefined ? {} : { now: options.now }),
+    });
+    try {
+        const store = await loadPersistedRunStore(home, runId);
+        store.bindRuntimeOwner(lease.ownerId);
+        if (retiredOwner !== undefined) {
+            await store.append("runtime_dead_owner_retired", {
+                owner_id: retiredOwner.ownerId,
+                previous_ownership: retiredOwner.ownership,
+            });
+        }
+        const state = store.state;
+        const turn = (state.pendingControllerTurns ?? []).find((candidate) => candidate.requestId === options.requestId) ??
+            (state.abandonedControllerTurns ?? []).find((candidate) => candidate.requestId === options.requestId);
+        if (!turn) {
+            throw new CueLineError("CONTROLLER_RECONCILIATION_REQUEST_NOT_FOUND", `Controller request '${options.requestId}' is neither pending nor recoverably abandoned in run '${runId}'.`);
+        }
+        const conversationUrl = options.conversationUrl ?? turn.conversationUrl ?? state.conversationUrl;
+        if (!conversationUrl || !state.conversationUrl) {
+            throw new CueLineError("CONTROLLER_RECONCILIATION_URL_REQUIRED", "Manual submission confirmation requires the exact persisted ChatGPT conversation URL.");
+        }
+        if (normalizedConversationUrl(conversationUrl) !==
+            normalizedConversationUrl(state.conversationUrl)) {
+            throw new CueLineError("CONTROLLER_RECONCILIATION_CONVERSATION_MISMATCH", "The operator-confirmed conversation URL does not match the persisted CueLine conversation.");
+        }
+        if (turn.conversationUrl !== null &&
+            normalizedConversationUrl(conversationUrl) !==
+                normalizedConversationUrl(turn.conversationUrl)) {
+            throw new CueLineError("CONTROLLER_RECONCILIATION_CONVERSATION_MISMATCH", "The operator-confirmed conversation URL does not match the exact conversation bound to this controller turn.");
+        }
+        const events = await readAuthoritativeRunEvents(home, runId);
+        for (const event of events) {
+            if (event.type !== "controller_command_accepted")
+                continue;
+            const payload = typeof event.payload === "object" &&
+                event.payload !== null &&
+                !Array.isArray(event.payload)
+                ? event.payload
+                : {};
+            const command = typeof payload.command === "object" &&
+                payload.command !== null &&
+                !Array.isArray(payload.command)
+                ? payload.command
+                : {};
+            const acceptedRequestId = command.request_id;
+            const acceptedRound = command.round;
+            if (acceptedRequestId === options.requestId ||
+                (typeof acceptedRound === "number" && acceptedRound >= turn.round)) {
+                throw new CueLineError("CONTROLLER_RECONCILIATION_SUPERSEDED", "A command for this request or the same/newer controller round was already accepted; refusing duplicate reconciliation.");
+            }
+        }
+        if (turn.manualSendConfirmed) {
+            return {
+                runId,
+                requestId: turn.requestId,
+                conversationUrl,
+                outcome: "already_confirmed",
+            };
+        }
+        await store.append("controller_turn_manual_submission_confirmed", {
+            round: turn.round,
+            request_id: turn.requestId,
+            conversation_url: conversationUrl,
+            operator_confirmation: true,
+        });
+        await store.snapshot();
+        return { runId, requestId: turn.requestId, conversationUrl, outcome: "confirmed" };
+    }
+    finally {
+        await lease.release();
+    }
+}
+function assertCallerJobResultInput(input) {
+    if (typeof input !== "object" || input === null || Array.isArray(input)) {
+        throw new CueLineError("CALLER_JOB_RESULT_INVALID", "Caller job result must be an object.");
+    }
+    const value = input;
+    const terminalStatuses = new Set([
+        "succeeded",
+        "failed",
+        "timed_out",
+        "cancelled",
+        "ambiguous",
+    ]);
+    if (typeof value.status !== "string" || !terminalStatuses.has(value.status)) {
+        throw new CueLineError("CALLER_JOB_STATUS_INVALID", `Unsupported caller job status '${String(value.status)}'.`);
+    }
+    for (const field of [
+        "stdout",
+        "stderr",
+        "output",
+        "error",
+        "startedAt",
+        "finishedAt",
+    ]) {
+        if (value[field] !== undefined && typeof value[field] !== "string") {
+            throw new CueLineError("CALLER_JOB_RESULT_INVALID", `Caller job result field '${field}' must be a string when provided.`);
+        }
+    }
+    if (value.exitCode !== undefined &&
+        value.exitCode !== null &&
+        !Number.isSafeInteger(value.exitCode)) {
+        throw new CueLineError("CALLER_JOB_RESULT_INVALID", "Caller job result exitCode must be a safe integer or null when provided.");
+    }
+}
+export async function submitCueLineCallerJobResult(runId, jobId, input, options = {}) {
+    const environment = options.environment ?? runtimeEnvironment();
+    const home = options.home ?? defaultCueLineHome(environment);
+    const now = options.now ?? (() => new Date());
+    assertCallerJobResultInput(input);
+    await loadPersistedRunStore(home, runId);
+    const runtime = await readRuntimeLease(home, runId, { now });
+    const retiredOwner = (runtime.ownership === "active" || runtime.ownership === "stale") &&
+        runtime.ownerId !== undefined &&
+        (await retireDeadRuntimeLease(home, runId, runtime.ownerId))
+        ? { ownerId: runtime.ownerId, ownership: runtime.ownership }
+        : undefined;
+    const lease = await RuntimeLease.claim({ home, runId, now });
+    try {
+        const store = await loadPersistedRunStore(home, runId);
+        store.bindRuntimeOwner(lease.ownerId);
+        if (retiredOwner !== undefined) {
+            await store.append("runtime_dead_owner_retired", {
+                owner_id: retiredOwner.ownerId,
+                previous_ownership: retiredOwner.ownership,
+            });
+        }
+        if (store.state.executor !== "caller") {
+            throw new CueLineError("CALLER_EXECUTOR_REQUIRED", `Run '${runId}' uses the process executor; caller results are not accepted.`);
+        }
+        const job = store.state.jobs[jobId];
+        if (!job) {
+            throw new CueLineError("JOB_NOT_FOUND", `No job '${jobId}' exists in run '${runId}'.`);
+        }
+        if (job.status !== "pending" && job.status !== "running") {
+            return { runId, jobId, outcome: "already_terminal" };
+        }
+        const statusStore = new JobStatusStore(home);
+        let terminal = await statusStore.read(jobId);
+        if (terminal?.status === "pending" || terminal?.status === "running") {
+            terminal = undefined;
+        }
+        if (terminal !== undefined) {
+            if (terminal.runId !== runId || terminal.jobKey !== job.jobKey) {
+                throw new CueLineError("CALLER_JOB_RESULT_CONFLICT", `Persisted terminal evidence for '${jobId}' does not belong to this caller job.`);
+            }
+        }
+        else {
+            const stdout = input.stdout ?? "";
+            const stderr = input.stderr ?? "";
+            const output = input.output ??
+                (stdout === ""
+                    ? stderr
+                    : stderr === ""
+                        ? stdout
+                        : `${stdout}${stdout.endsWith("\n") ? "" : "\n"}${stderr}`);
+            const startedAt = input.startedAt ?? now().toISOString();
+            const finishedAt = input.finishedAt ?? now().toISOString();
+            const result = {
+                status: input.status,
+                exitCode: input.exitCode ?? (input.status === "succeeded" ? 0 : null),
+                stdout,
+                stderr,
+                output,
+                emptyOutput: output.length === 0,
+                timedOut: input.status === "timed_out",
+                cancelled: input.status === "cancelled",
+                ambiguousSideEffects: job.spec.mode === "work" && input.status !== "succeeded",
+                retryable: false,
+                startedAt,
+                finishedAt,
+            };
+            terminal = {
+                jobId,
+                runId,
+                jobKey: job.jobKey,
+                lane: job.spec.lane,
+                mode: job.spec.mode,
+                execution: "foreground",
+                status: input.status,
+                startedAt,
+                finishedAt,
+                result,
+                ...(input.error === undefined ? {} : { error: input.error }),
+            };
+            await statusStore.write(terminal);
+        }
+        const events = await readAuthoritativeRunEvents(home, runId);
+        const alreadyRecorded = events.some((event) => {
+            if (event.type !== "caller_job_result_submitted")
+                return false;
+            const payload = typeof event.payload === "object" &&
+                event.payload !== null &&
+                !Array.isArray(event.payload)
+                ? event.payload
+                : {};
+            return payload.job_id === jobId;
+        });
+        if (!alreadyRecorded) {
+            await store.append("caller_job_result_submitted", {
+                job_id: jobId,
+                status: terminal.status,
+            });
+        }
+        const terminalResult = terminal.result;
+        const controllerOutput = terminal.status === "succeeded" && terminalResult?.stdout.trim() !== ""
+            ? terminalResult?.stdout
+            : terminalResult?.output;
+        await store.append("job_status", {
+            job_id: jobId,
+            status: terminal.status,
+            ...(controllerOutput === undefined ? {} : { output: controllerOutput }),
+            ...(terminal.error === undefined ? {} : { error: terminal.error }),
+        });
+        await store.snapshot();
+        return { runId, jobId, outcome: "submitted" };
+    }
+    finally {
+        await lease.release();
+    }
+}
+//# sourceMappingURL=api-controller-handoff.js.map

package/dist/src/api-controller-handoff.js.map

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

package/dist/src/api-runtime-lifecycle.d.ts

@@ -0,0 +1,22 @@
+import type { CueLineJobCancellationResult, CueLineRunCancellationResult, CueLineRuntimeOptions, CueLineRuntimeReconciliationResult, CueLineRuntimeTakeoverResult } from "./api-contracts.js";
+import type { CueLineResult } from "./core/controller-loop.js";
+import { type CueLineRunStatusSummary } from "./core/run-status.js";
+import type { CueLineRunState } from "./core/state-machine.js";
+declare function terminalResult(state: CueLineRunState): CueLineResult;
+export declare function loadCueLineRunState(runId: string, options?: Pick<CueLineRuntimeOptions, "home" | "environment">): Promise<CueLineRunState>;
+export declare function loadCueLineRunStatus(runId: string, options?: Pick<CueLineRuntimeOptions, "home" | "environment" | "now">): Promise<CueLineRunStatusSummary>;
+/**
+ * Explicitly releases one exact stale owner. This is the operator-authorized
+ * path for shared Node/REPL hosts whose PID remains alive after the outer tool
+ * call disappeared. It never steals an active or newly-heartbeating lease.
+ */
+export declare function takeoverCueLineRuntime(runId: string, options?: Pick<CueLineRuntimeOptions, "home" | "environment" | "now">): Promise<CueLineRuntimeTakeoverResult>;
+export declare function reconcileCueLineRuntime(runId: string, options?: Pick<CueLineRuntimeOptions, "home" | "environment" | "now">): Promise<CueLineRuntimeReconciliationResult>;
+export declare function isTerminalRun(state: CueLineRunState): boolean;
+export declare function cancelCueLineRun(runId: string, options?: Pick<CueLineRuntimeOptions, "home" | "environment" | "now"> & {
+    reason?: string;
+}): Promise<CueLineRunCancellationResult>;
+export declare function cancelCueLineJob(runId: string, jobId: string, options?: Pick<CueLineRuntimeOptions, "home" | "environment" | "now"> & {
+    reason?: string;
+}): Promise<CueLineJobCancellationResult>;
+export { terminalResult };