cueline 0.1.4 → 0.1.6

package/dist/src/api-caller-work.js

@@ -0,0 +1,397 @@
+import { randomUUID } from "node:crypto";
+import { stat } from "node:fs/promises";
+import path from "node:path";
+import { CueLineError } from "./core/errors.js";
+import { jobSpecHash } from "./core/ids.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";
+const DEFAULT_CALLER_WORK_CLAIM_TTL_MS = 300_000;
+const MIN_CALLER_WORK_CLAIM_TTL_MS = 1_000;
+const MAX_CALLER_WORK_CLAIM_TTL_MS = 86_400_000;
+function assertCallerId(value) {
+    if (value.trim() === "" || value.length > 256 || /[\u0000-\u001f\u007f]/.test(value)) {
+        throw new CueLineError("CALLER_ID_INVALID", "callerId must be a non-empty printable identifier of at most 256 characters.");
+    }
+}
+function validatedTtlMs(value) {
+    const ttlMs = value ?? DEFAULT_CALLER_WORK_CLAIM_TTL_MS;
+    if (!Number.isSafeInteger(ttlMs) ||
+        ttlMs < MIN_CALLER_WORK_CLAIM_TTL_MS ||
+        ttlMs > MAX_CALLER_WORK_CLAIM_TTL_MS) {
+        throw new CueLineError("CALLER_WORK_CLAIM_TTL_INVALID", `Caller work claim ttlMs must be an integer from ${MIN_CALLER_WORK_CLAIM_TTL_MS} to ${MAX_CALLER_WORK_CLAIM_TTL_MS}.`);
+    }
+    return ttlMs;
+}
+function assertClaimProof(value) {
+    assertCallerId(value.callerId);
+    if (value.claimId.trim() === "" || !Number.isSafeInteger(value.fencingToken)) {
+        throw new CueLineError("CALLER_WORK_CLAIM_PROOF_INVALID", "Caller work proof requires a non-empty claimId and a safe integer fencingToken.");
+    }
+}
+function callerWorkJob(store, jobId) {
+    if (store.state.executor !== "caller") {
+        throw new CueLineError("CALLER_EXECUTOR_REQUIRED", `Run '${store.runId}' uses the process executor; caller work cannot be claimed.`);
+    }
+    const job = store.state.jobs[jobId];
+    if (!job) {
+        throw new CueLineError("JOB_NOT_FOUND", `No job '${jobId}' exists in run '${store.runId}'.`);
+    }
+    if (job.spec.mode !== "work") {
+        throw new CueLineError("CALLER_WORK_JOB_REQUIRED", `Job '${jobId}' is advise-only and does not use a caller work claim.`);
+    }
+    if (job.spec.workdir === undefined || !path.isAbsolute(job.spec.workdir)) {
+        throw new CueLineError("CALLER_WORKDIR_REQUIRED", `Caller work job '${jobId}' is not bound to an absolute workdir.`);
+    }
+    return job;
+}
+async function assertWorkdirAvailable(workdir) {
+    const metadata = await stat(workdir).catch((error) => {
+        throw new CueLineError("CALLER_WORKDIR_UNAVAILABLE", `Caller workdir '${workdir}' is unavailable.`, { cause: error });
+    });
+    if (!metadata.isDirectory()) {
+        throw new CueLineError("CALLER_WORKDIR_UNAVAILABLE", `Caller workdir '${workdir}' is not a directory.`);
+    }
+}
+function claimExpired(claim, now) {
+    const expiresAt = Date.parse(claim.expiresAt);
+    return !Number.isFinite(expiresAt) || expiresAt <= now.getTime();
+}
+function assertClaimClockMonotonic(claim, now) {
+    const heartbeatAt = Date.parse(claim.heartbeatAt);
+    if (!Number.isFinite(heartbeatAt) || now.getTime() < heartbeatAt) {
+        throw new CueLineError("CALLER_WORK_CLOCK_REGRESSION", `Caller work clock moved behind the durable heartbeat for claim '${claim.claimId}'; refusing a transition that the event reducer would reject.`, {
+            details: {
+                claim_id: claim.claimId,
+                heartbeat_at: claim.heartbeatAt,
+                observed_at: now.toISOString(),
+            },
+        });
+    }
+}
+function expiration(now, ttlMs) {
+    return new Date(now.getTime() + ttlMs).toISOString();
+}
+async function writeClaimJobStatus(home, store, job, status, timestamp, error) {
+    const statusStore = new JobStatusStore(home);
+    const existing = await statusStore.read(job.jobId);
+    const next = {
+        jobId: job.jobId,
+        runId: store.runId,
+        jobKey: job.jobKey,
+        lane: job.spec.lane,
+        mode: job.spec.mode,
+        execution: "foreground",
+        status,
+        startedAt: existing?.startedAt ?? timestamp,
+        ...(status === "ambiguous" ? { finishedAt: timestamp } : {}),
+        ...(error === undefined ? {} : { error }),
+    };
+    await statusStore.write(next);
+}
+async function markStartedClaimAmbiguous(store, job, claim, home, now) {
+    const reason = await persistStartedClaimAmbiguous(store, job, claim, home, now);
+    await store.snapshot();
+    throw new CueLineError("CALLER_WORK_BECAME_AMBIGUOUS", reason, {
+        details: { run_id: store.runId, job_id: job.jobId, claim_id: claim.claimId },
+    });
+}
+async function persistStartedClaimAmbiguous(store, job, claim, home, now) {
+    const reason = "Caller work claim expired after local work started; side effects cannot be inferred or retried.";
+    await store.append("caller_work_became_ambiguous", {
+        job_id: job.jobId,
+        claim_id: claim.claimId,
+        fencing_token: claim.fencingToken,
+        caller_id: claim.callerId,
+        reason,
+        detected_at: now.toISOString(),
+    });
+    await writeClaimJobStatus(home, store, job, "ambiguous", now.toISOString(), reason);
+    return reason;
+}
+async function releaseExpiredUnstartedClaim(store, job, claim, home, now) {
+    await store.append("caller_work_claim_released", {
+        job_id: job.jobId,
+        claim_id: claim.claimId,
+        fencing_token: claim.fencingToken,
+        caller_id: claim.callerId,
+        reason: "expired_before_start",
+        released_at: now.toISOString(),
+    });
+    await writeClaimJobStatus(home, store, job, "pending", now.toISOString());
+}
+async function assertClaimNotExpired(store, job, claim, home, now) {
+    assertClaimClockMonotonic(claim, now);
+    if (!claimExpired(claim, now))
+        return;
+    if (claim.startedAt !== null) {
+        await markStartedClaimAmbiguous(store, job, claim, home, now);
+    }
+    await releaseExpiredUnstartedClaim(store, job, claim, home, now);
+    await store.snapshot();
+    throw new CueLineError("CALLER_WORK_CLAIM_EXPIRED", `Caller work claim '${claim.claimId}' expired before local work started.`, { details: { run_id: store.runId, job_id: job.jobId, claim_id: claim.claimId } });
+}
+function exactClaim(job, proof) {
+    assertClaimProof(proof);
+    const claim = job.callerWork?.claim;
+    if (!claim ||
+        claim.claimId !== proof.claimId ||
+        claim.callerId !== proof.callerId ||
+        claim.fencingToken !== proof.fencingToken ||
+        claim.taskHash !== jobSpecHash(job.spec) ||
+        claim.workdir !== job.spec.workdir) {
+        throw new CueLineError("CALLER_WORK_CLAIM_MISMATCH", `Caller work proof does not match the active immutable claim for job '${job.jobId}'.`);
+    }
+    return claim;
+}
+function claimResult(runId, job, claim, outcome) {
+    return {
+        runId,
+        jobId: job.jobId,
+        outcome,
+        task: job.spec.task,
+        taskHash: claim.taskHash,
+        workdir: claim.workdir,
+        claimId: claim.claimId,
+        callerId: claim.callerId,
+        fencingToken: claim.fencingToken,
+        claimedAt: claim.claimedAt,
+        heartbeatAt: claim.heartbeatAt,
+        expiresAt: claim.expiresAt,
+        started: claim.startedAt !== null,
+    };
+}
+async function withCallerWorkStore(runId, options, operation) {
+    const environment = options.environment ?? runtimeEnvironment();
+    const home = options.home ?? defaultCueLineHome(environment);
+    const now = options.now ?? (() => new Date());
+    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,
+            });
+        }
+        return await operation(store, home, now);
+    }
+    finally {
+        await lease.release();
+    }
+}
+export async function claimCueLineCallerJob(runId, jobId, options) {
+    assertCallerId(options.callerId);
+    const ttlMs = validatedTtlMs(options.ttlMs);
+    return withCallerWorkStore(runId, options, async (store, home, now) => {
+        let job = callerWorkJob(store, jobId);
+        if (job.status !== "pending" && job.status !== "running") {
+            throw new CueLineError("CALLER_WORK_NOT_CLAIMABLE", `Caller work job '${jobId}' has status '${job.status}' and cannot be claimed.`);
+        }
+        const currentTime = now();
+        const existing = job.callerWork?.claim;
+        if (existing !== null && existing !== undefined) {
+            if (!claimExpired(existing, currentTime)) {
+                if (existing.callerId === options.callerId) {
+                    return claimResult(runId, job, existing, "already_claimed");
+                }
+                throw new CueLineError("CALLER_WORK_ALREADY_CLAIMED", `Caller work job '${jobId}' already has an active claim.`, { details: { job_id: jobId, expires_at: existing.expiresAt } });
+            }
+            if (existing.startedAt !== null) {
+                await markStartedClaimAmbiguous(store, job, existing, home, currentTime);
+            }
+            await releaseExpiredUnstartedClaim(store, job, existing, home, currentTime);
+            job = callerWorkJob(store, jobId);
+        }
+        if (job.status !== "pending") {
+            throw new CueLineError("CALLER_WORK_CLAIM_STATE_INVALID", `Caller work job '${jobId}' is running without an active claim and cannot be reclaimed safely.`);
+        }
+        const workdir = job.spec.workdir;
+        await assertWorkdirAvailable(workdir);
+        const timestamp = currentTime.toISOString();
+        const fencingToken = (job.callerWork?.nextFencingToken ?? 0) + 1;
+        const claim = {
+            claimId: `claim_${randomUUID()}`,
+            callerId: options.callerId,
+            taskHash: jobSpecHash(job.spec),
+            workdir,
+            fencingToken,
+            claimedAt: timestamp,
+            heartbeatAt: timestamp,
+            expiresAt: expiration(currentTime, ttlMs),
+            ttlMs,
+            startedAt: null,
+        };
+        await store.append("caller_work_claimed", {
+            job_id: job.jobId,
+            claim,
+        });
+        await writeClaimJobStatus(home, store, job, "pending", timestamp);
+        await store.snapshot();
+        return claimResult(runId, job, claim, "claimed");
+    });
+}
+export async function startCueLineCallerJob(runId, jobId, proof, options = {}) {
+    return withCallerWorkStore(runId, options, async (store, home, now) => {
+        const job = callerWorkJob(store, jobId);
+        const claim = exactClaim(job, proof);
+        if (job.status !== "pending" && job.status !== "running") {
+            throw new CueLineError("CALLER_WORK_NOT_STARTABLE", `Caller work job '${jobId}' has terminal status '${job.status}'.`);
+        }
+        const currentTime = now();
+        await assertClaimNotExpired(store, job, claim, home, currentTime);
+        if (claim.startedAt !== null) {
+            return {
+                runId,
+                jobId,
+                claimId: claim.claimId,
+                fencingToken: claim.fencingToken,
+                outcome: "already_started",
+                heartbeatAt: claim.heartbeatAt,
+                expiresAt: claim.expiresAt,
+            };
+        }
+        await assertWorkdirAvailable(claim.workdir);
+        const timestamp = currentTime.toISOString();
+        const expiresAt = expiration(currentTime, claim.ttlMs);
+        await store.append("caller_work_started", {
+            job_id: jobId,
+            claim_id: claim.claimId,
+            caller_id: claim.callerId,
+            fencing_token: claim.fencingToken,
+            task_hash: claim.taskHash,
+            workdir: claim.workdir,
+            started_at: timestamp,
+            expires_at: expiresAt,
+        });
+        await writeClaimJobStatus(home, store, job, "running", timestamp);
+        await store.snapshot();
+        return {
+            runId,
+            jobId,
+            claimId: claim.claimId,
+            fencingToken: claim.fencingToken,
+            outcome: "started",
+            heartbeatAt: timestamp,
+            expiresAt,
+        };
+    });
+}
+export async function heartbeatCueLineCallerJob(runId, jobId, proof, options = {}) {
+    return withCallerWorkStore(runId, options, async (store, home, now) => {
+        const job = callerWorkJob(store, jobId);
+        const claim = exactClaim(job, proof);
+        if (job.status !== "pending" && job.status !== "running") {
+            throw new CueLineError("CALLER_WORK_NOT_ACTIVE", `Caller work job '${jobId}' has terminal status '${job.status}'.`);
+        }
+        const currentTime = now();
+        await assertClaimNotExpired(store, job, claim, home, currentTime);
+        const timestamp = currentTime.toISOString();
+        const expiresAt = expiration(currentTime, claim.ttlMs);
+        await store.append("caller_work_heartbeat", {
+            job_id: jobId,
+            claim_id: claim.claimId,
+            caller_id: claim.callerId,
+            fencing_token: claim.fencingToken,
+            heartbeat_at: timestamp,
+            expires_at: expiresAt,
+        });
+        await writeClaimJobStatus(home, store, job, claim.startedAt === null ? "pending" : "running", timestamp);
+        await store.snapshot();
+        return {
+            runId,
+            jobId,
+            claimId: claim.claimId,
+            fencingToken: claim.fencingToken,
+            outcome: "heartbeat_recorded",
+            heartbeatAt: timestamp,
+            expiresAt,
+        };
+    });
+}
+export async function releaseCueLineCallerJob(runId, jobId, proof, options = {}) {
+    return withCallerWorkStore(runId, options, async (store, home, now) => {
+        const job = callerWorkJob(store, jobId);
+        const claim = exactClaim(job, proof);
+        const currentTime = now();
+        await assertClaimNotExpired(store, job, claim, home, currentTime);
+        if (claim.startedAt !== null) {
+            throw new CueLineError("CALLER_WORK_RELEASE_AFTER_START_FORBIDDEN", "A caller work claim cannot be released after local work started; submit a terminal result or let it become ambiguous.");
+        }
+        await store.append("caller_work_claim_released", {
+            job_id: jobId,
+            claim_id: claim.claimId,
+            caller_id: claim.callerId,
+            fencing_token: claim.fencingToken,
+            reason: "caller_released_before_start",
+            released_at: currentTime.toISOString(),
+        });
+        await writeClaimJobStatus(home, store, job, "pending", currentTime.toISOString());
+        await store.snapshot();
+        return {
+            runId,
+            jobId,
+            claimId: claim.claimId,
+            fencingToken: claim.fencingToken,
+            outcome: "released",
+        };
+    });
+}
+/** Internal continuation repair: settle only claims whose durable TTL has elapsed. */
+export async function reconcileExpiredCallerWorkClaims(runId, options = {}) {
+    return withCallerWorkStore(runId, options, async (store, home, now) => {
+        if (store.state.executor !== "caller")
+            return 0;
+        const currentTime = now();
+        let affected = 0;
+        for (const job of Object.values(store.state.jobs)) {
+            const claim = job.callerWork?.claim;
+            if (job.spec.mode !== "work" ||
+                (job.status !== "pending" && job.status !== "running") ||
+                claim === null ||
+                claim === undefined ||
+                !claimExpired(claim, currentTime)) {
+                continue;
+            }
+            if (claim.startedAt === null) {
+                await releaseExpiredUnstartedClaim(store, job, claim, home, currentTime);
+            }
+            else {
+                await persistStartedClaimAmbiguous(store, job, claim, home, currentTime);
+            }
+            affected += 1;
+        }
+        if (affected > 0)
+            await store.snapshot();
+        return affected;
+    });
+}
+/** Internal validation used while submitCueLineCallerJobResult owns the run lease. */
+export async function validateCallerWorkResultClaim(store, job, proof, home, now, options = {}) {
+    const claim = exactClaim(job, proof);
+    const alreadyTerminal = job.status !== "pending" && job.status !== "running";
+    if (alreadyTerminal)
+        return { claim, alreadyTerminal };
+    if (options.durableTerminalIntent === true) {
+        if (claim.startedAt === null || job.status !== "running") {
+            throw new CueLineError("CALLER_WORK_NOT_STARTED", `Caller work job '${job.jobId}' must be durably started before recovering a terminal result.`);
+        }
+        return { claim, alreadyTerminal: false };
+    }
+    await assertClaimNotExpired(store, job, claim, home, now);
+    if (claim.startedAt === null || job.status !== "running") {
+        throw new CueLineError("CALLER_WORK_NOT_STARTED", `Caller work job '${job.jobId}' must be durably started before submitting a result.`);
+    }
+    return { claim, alreadyTerminal: false };
+}
+//# sourceMappingURL=api-caller-work.js.map

package/dist/src/api-caller-work.js.map

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

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

@@ -19,6 +19,8 @@ export interface CueLineRuntimeOptions {
     cancellationPollIntervalMs?: number;
     runTimeoutMs?: number;
     executor?: "caller" | "process";
+    /** Required together with executor="process" before CueLine may spawn local processes. */
+    allowProcessExecution?: boolean;
     maxConcurrency?: number;
     laneConcurrency?: Readonly<Record<string, number>>;
 }
@@ -53,6 +55,41 @@ export interface CueLineCallerJobSubmissionResult {
     jobId: string;
     outcome: "submitted" | "already_terminal";
 }
+export interface CueLineCallerWorkClaimProof {
+    claimId: string;
+    callerId: string;
+    fencingToken: number;
+}
+export interface CueLineCallerWorkClaimOptions extends Pick<CueLineRuntimeOptions, "home" | "environment" | "now"> {
+    callerId: string;
+    ttlMs?: number;
+}
+export interface CueLineCallerWorkClaimResult extends CueLineCallerWorkClaimProof {
+    runId: string;
+    jobId: string;
+    outcome: "claimed" | "already_claimed";
+    task: string;
+    taskHash: string;
+    workdir: string;
+    claimedAt: string;
+    heartbeatAt: string;
+    expiresAt: string;
+    started: boolean;
+}
+export interface CueLineCallerWorkMutationResult {
+    runId: string;
+    jobId: string;
+    claimId: string;
+    fencingToken: number;
+    outcome: "started" | "already_started" | "heartbeat_recorded" | "released";
+    heartbeatAt?: string;
+    expiresAt?: string;
+}
+export interface CueLineCallerWorkMutationOptions extends Pick<CueLineRuntimeOptions, "home" | "environment" | "now"> {
+}
+export interface CueLineCallerJobSubmissionOptions extends Pick<CueLineRuntimeOptions, "home" | "environment" | "now"> {
+    claim?: CueLineCallerWorkClaimProof;
+}
 export interface CueLineRuntimeReconciliationResult {
     runId: string;
     outcome: "reconciled" | "owner_alive" | "processes_alive" | "already_terminal";

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

@@ -1,6 +1,6 @@
-import type { CueLineCallerJobResultInput, CueLineCallerJobSubmissionResult, CueLineRuntimeOptions, ManualControllerSubmissionConfirmation } from "./api-contracts.js";
+import type { CueLineCallerJobSubmissionOptions, 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>;
+export declare function submitCueLineCallerJobResult(runId: string, jobId: string, input: CueLineCallerJobResultInput, options?: CueLineCallerJobSubmissionOptions): Promise<CueLineCallerJobSubmissionResult>;