cueline 0.1.3 → 0.1.4

package/dist/src/core/controller-command-execution.js

@@ -0,0 +1,299 @@
+import { JobStatusStore } from "../jobs/status.js";
+import { RunStore } from "../state/store.js";
+import { throwIfCancelled } from "./controller-abort.js";
+import { controllerResultOutput } from "./controller-turn.js";
+import { asCueLineError, CueLineError } from "./errors.js";
+import { jobId } from "./ids.js";
+export function statusPayload(status) {
+    const output = controllerResultOutput(status);
+    return {
+        job_id: status.jobId,
+        status: status.status,
+        ...(output === undefined ? {} : { output }),
+        ...(status.error === undefined ? {} : { error: status.error }),
+    };
+}
+export function validateCommandBeforeAcceptance(store, command, options) {
+    if (command.action !== "dispatch")
+        return;
+    for (const spec of command.jobs) {
+        options.validateJobSpec?.(spec);
+        if (store.state.executor === "caller" && spec.mode === "work") {
+            throw new CueLineError("CALLER_WORK_REQUIRES_CLAIM", "Caller execution accepts advise jobs only until an execution claim can prevent duplicate side effects; use advise or explicitly select the process executor.");
+        }
+        const id = jobId(store.runId, spec.job_key, spec);
+        const existing = Object.values(store.state.jobs).find((job) => job.jobKey === spec.job_key);
+        if (existing !== undefined && existing.jobId !== id) {
+            throw new CueLineError("JOB_KEY_IDENTITY_MISMATCH", `job_key '${spec.job_key}' was already registered with a different immutable specification.`);
+        }
+        if (store.state.jobs[id])
+            continue;
+        if (store.state.executor !== "caller")
+            options.resolveRunnerSpec(id, spec);
+    }
+}
+async function updateRunningJobs(store, supervisor, jobIds) {
+    const selected = Object.values(store.state.jobs).filter((job) => job.status === "running" && (jobIds === undefined || jobIds.includes(job.jobId)));
+    const statuses = await Promise.all(selected.map((job) => supervisor.waitForCompletion(job.jobId)));
+    for (const status of statuses) {
+        await store.append("job_status", statusPayload(status));
+    }
+}
+async function registerDispatchedJob(store, spec, resumeExistingPending = false) {
+    const id = jobId(store.runId, spec.job_key, spec);
+    const existing = Object.values(store.state.jobs).find((job) => job.jobKey === spec.job_key);
+    if (existing !== undefined && existing.jobId !== id) {
+        throw new CueLineError("JOB_KEY_IDENTITY_MISMATCH", `job_key '${spec.job_key}' was already registered with a different immutable specification.`);
+    }
+    if (store.state.jobs[id]) {
+        if (resumeExistingPending && store.state.jobs[id]?.status === "pending") {
+            return store.state.jobs[id];
+        }
+        await store.append("notice", {
+            message: `duplicate dispatch ignored for job_key '${spec.job_key}' (${id})`,
+        });
+        return undefined;
+    }
+    const job = {
+        jobId: id,
+        jobKey: spec.job_key,
+        required: spec.required ?? true,
+        spec,
+        status: "pending",
+        output: null,
+        error: null,
+    };
+    await store.append("job_registered", { job });
+    return job;
+}
+async function startDispatchedJob(store, spec, options, resumeExistingPending = false) {
+    throwIfCancelled(options.signal);
+    const job = await registerDispatchedJob(store, spec, resumeExistingPending);
+    if (!job)
+        return undefined;
+    const id = job.jobId;
+    try {
+        const runnerSpec = options.resolveRunnerSpec(id, spec);
+        await store.append("job_status", { job_id: id, status: "running" });
+        return {
+            jobId: id,
+            backgroundAdvice: spec.mode === "advise" && spec.background === true,
+            completion: options.jobSupervisor.start({
+                ...runnerSpec,
+                runId: store.runId,
+                jobKey: spec.job_key,
+                ...(options.signal === undefined ? {} : { signal: options.signal }),
+            }).then(async (status) => statusPayload(spec.mode === "work" &&
+                (status.status === "pending" || status.status === "running")
+                ? await options.jobSupervisor.waitForCompletion(id)
+                : status), (error) => {
+                const failure = asCueLineError(error, "JOB_START_FAILED");
+                return {
+                    job_id: id,
+                    status: "failed",
+                    error: failure.message,
+                };
+            }),
+        };
+    }
+    catch (error) {
+        const failure = asCueLineError(error, "JOB_START_FAILED");
+        await store.append("job_status", {
+            job_id: id,
+            status: "failed",
+            error: failure.message,
+        });
+        return undefined;
+    }
+}
+async function executeProcessDispatch(store, specs, options, resumeExistingPending = false) {
+    const previouslyRunning = Object.values(store.state.jobs).filter((job) => job.status === "running");
+    const globalLimit = specs.some((spec) => spec.mode === "work") ||
+        previouslyRunning.some((job) => job.spec.mode === "work")
+        ? 1
+        : (options.maxConcurrency ?? 2);
+    const queued = [...specs];
+    const active = previouslyRunning.map((job) => ({
+        jobId: job.jobId,
+        lane: job.spec.lane,
+        backgroundAdvice: job.spec.mode === "advise" && job.spec.background === true,
+        waitingForTerminal: true,
+        completion: options.jobSupervisor.waitForCompletion(job.jobId).then(statusPayload, (error) => {
+            const failure = asCueLineError(error, "JOB_WAIT_FAILED");
+            return {
+                job_id: job.jobId,
+                status: "failed",
+                error: failure.message,
+            };
+        }),
+    }));
+    const activeByLane = new Map();
+    for (const entry of active) {
+        activeByLane.set(entry.lane, (activeByLane.get(entry.lane) ?? 0) + 1);
+    }
+    while (queued.length > 0 || active.length > 0) {
+        let started = false;
+        for (let index = 0; index < queued.length && active.length < globalLimit;) {
+            const spec = queued[index];
+            const laneLimit = options.laneConcurrency?.[spec.lane] ?? globalLimit;
+            const laneActive = activeByLane.get(spec.lane) ?? 0;
+            if (laneActive >= laneLimit) {
+                index += 1;
+                continue;
+            }
+            queued.splice(index, 1);
+            const job = await startDispatchedJob(store, spec, options, resumeExistingPending);
+            if (job) {
+                active.push({
+                    jobId: job.jobId,
+                    lane: spec.lane,
+                    backgroundAdvice: job.backgroundAdvice,
+                    waitingForTerminal: false,
+                    completion: job.completion,
+                });
+                activeByLane.set(spec.lane, laneActive + 1);
+            }
+            started = true;
+        }
+        if (queued.length === 0) {
+            for (let index = active.length - 1; index >= 0; index -= 1) {
+                const entry = active[index];
+                if (!entry.backgroundAdvice || !entry.waitingForTerminal)
+                    continue;
+                void entry.completion.catch(() => undefined);
+                active.splice(index, 1);
+                const remaining = (activeByLane.get(entry.lane) ?? 1) - 1;
+                if (remaining === 0)
+                    activeByLane.delete(entry.lane);
+                else
+                    activeByLane.set(entry.lane, remaining);
+            }
+        }
+        if (active.length === 0) {
+            if (!started && queued.length > 0) {
+                throw new CueLineError("JOB_CONCURRENCY_DEADLOCK", "No queued job can start under the configured concurrency limits.");
+            }
+            continue;
+        }
+        const settled = await Promise.race(active.map((entry) => entry.completion.then((payload) => ({ entry, payload }))));
+        const activeIndex = active.indexOf(settled.entry);
+        await store.append("job_status", settled.payload);
+        if (settled.entry.backgroundAdvice &&
+            !settled.entry.waitingForTerminal &&
+            settled.payload.status === "running" &&
+            queued.length > 0) {
+            settled.entry.waitingForTerminal = true;
+            settled.entry.completion = options.jobSupervisor
+                .waitForCompletion(settled.entry.jobId)
+                .then(statusPayload, (error) => {
+                const failure = asCueLineError(error, "JOB_WAIT_FAILED");
+                return {
+                    job_id: settled.entry.jobId,
+                    status: "failed",
+                    error: failure.message,
+                };
+            });
+            continue;
+        }
+        if (activeIndex >= 0)
+            active.splice(activeIndex, 1);
+        const remaining = (activeByLane.get(settled.entry.lane) ?? 1) - 1;
+        if (remaining === 0)
+            activeByLane.delete(settled.entry.lane);
+        else
+            activeByLane.set(settled.entry.lane, remaining);
+    }
+}
+async function executeCommand(store, command, options, resumePendingExecution = false) {
+    if (command.action === "dispatch") {
+        if ((options.executor ?? store.state.executor) === "caller") {
+            for (const spec of command.jobs) {
+                const job = await registerDispatchedJob(store, spec, resumePendingExecution);
+                if (job !== undefined) {
+                    const statusStore = new JobStatusStore(store.paths.home);
+                    if ((await statusStore.read(job.jobId)) === undefined) {
+                        await statusStore.write({
+                            jobId: job.jobId,
+                            runId: store.runId,
+                            jobKey: job.jobKey,
+                            lane: job.spec.lane,
+                            mode: job.spec.mode,
+                            execution: "foreground",
+                            status: "pending",
+                            startedAt: (options.now ?? (() => new Date()))().toISOString(),
+                        });
+                    }
+                }
+            }
+            const pendingIds = Object.values(store.state.jobs)
+                .filter((job) => job.status === "pending" || job.status === "running")
+                .map((job) => job.jobId);
+            await store.append("caller_jobs_ready", { job_ids: pendingIds });
+            return pendingIds.length > 0 ? "awaiting_caller" : "continue";
+        }
+        await executeProcessDispatch(store, command.jobs, options, resumePendingExecution);
+        throwIfCancelled(options.signal);
+        return "continue";
+    }
+    if (command.action === "wait") {
+        if ((options.executor ?? store.state.executor) === "caller") {
+            const active = Object.values(store.state.jobs).some((job) => (job.status === "pending" || job.status === "running") &&
+                (command.job_ids === undefined || command.job_ids.includes(job.jobId)));
+            return active ? "awaiting_caller" : "continue";
+        }
+        await updateRunningJobs(store, options.jobSupervisor, command.job_ids);
+        return "continue";
+    }
+    if (command.action === "inspect") {
+        if ((options.executor ?? store.state.executor) === "caller") {
+            const active = Object.values(store.state.jobs).some((job) => (job.status === "pending" || job.status === "running") &&
+                (command.job_ids === undefined || command.job_ids.includes(job.jobId)));
+            return active ? "awaiting_caller" : "continue";
+        }
+        const selected = Object.values(store.state.jobs).filter((job) => command.job_ids === undefined || command.job_ids.includes(job.jobId));
+        for (const job of selected) {
+            try {
+                const status = await options.jobSupervisor.inspect(job.jobId);
+                await store.append("job_status", statusPayload(status));
+            }
+            catch (error) {
+                const failure = asCueLineError(error, "JOB_INSPECT_FAILED");
+                await store.append("notice", {
+                    message: `inspection failed for '${job.jobKey}': ${failure.message}`,
+                });
+            }
+        }
+        return "continue";
+    }
+    if (command.action === "complete" || command.action === "blocked") {
+        const activeJobs = Object.values(store.state.jobs).filter((job) => job.status === "pending" || job.status === "running");
+        if (activeJobs.length > 0) {
+            await store.append("notice", {
+                message: `${command.action} rejected: jobs still pending or running: ${activeJobs
+                    .map((job) => job.jobKey)
+                    .join(", ")}`,
+            });
+            return "continue";
+        }
+    }
+    if (command.action === "complete") {
+        await store.append("run_completed", { final_delivery_text: command.final_delivery_text });
+        return "terminal";
+    }
+    await store.append("run_blocked", {
+        reason: command.reason,
+        ...(command.final_delivery_text === undefined
+            ? {}
+            : { final_delivery_text: command.final_delivery_text }),
+    });
+    return "terminal";
+}
+export async function executeAcceptedCommand(store, command, commandDigest, options, resumePendingExecution = false) {
+    const outcome = await executeCommand(store, command, options, resumePendingExecution);
+    await store.append("controller_command_execution_completed", {
+        command_hash: commandDigest,
+        action: command.action,
+    });
+    return outcome;
+}
+//# sourceMappingURL=controller-command-execution.js.map

package/dist/src/core/controller-command-execution.js.map

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

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

@@ -1,45 +1,5 @@
-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>;
-    cancel?(jobId: string): boolean;
-    cancelAll?(): number;
-}
-export interface ControllerRuntimeOptions {
-    browser: BrowserAdapter;
-    jobSupervisor: JobSupervisorLike;
-    resolveRunnerSpec: (jobId: string, job: ControllerJobSpec) => RunnerSpec;
-    home?: string;
-    maxRounds?: number;
-    maxRepairAttempts?: number;
-    controllerInstructions?: readonly string[];
-    conversationUrl?: string;
-    now?: () => Date;
-    signal?: AbortSignal;
-    cancellationPollIntervalMs?: number;
-    runTimeoutMs?: number;
-}
-export interface ControllerLoopOptions extends ControllerRuntimeOptions {
-    request: string;
-    runId?: string;
-}
-export interface ContinueControllerLoopOptions extends ControllerRuntimeOptions {
-    runId: string;
-    reconcileRequestId?: string;
-    abandonOtherPendingTurns?: boolean;
-}
-export interface CueLineResult {
-    runId: string;
-    status: Exclude<CueLineRunStatus, "running" | "failed">;
-    finalDeliveryText?: string;
-    conversationUrl?: string;
-    cancelledReason?: string;
-    state: CueLineRunState;
-}
+import type { ContinueControllerLoopOptions, ControllerLoopOptions, CreateControllerRunOptions, CueLineResult } from "./controller-types.js";
+export type { ContinueControllerLoopOptions, ControllerLoopOptions, ControllerRuntimeOptions, CreateControllerRunOptions, CueLineResult, JobSupervisorLike, } from "./controller-types.js";
+export declare function createControllerRun(options: CreateControllerRunOptions): Promise<CueLineResult>;
 export declare function runControllerLoop(options: ControllerLoopOptions): Promise<CueLineResult>;
 export declare function continueControllerLoop(options: ContinueControllerLoopOptions): Promise<CueLineResult>;