cueline 0.1.2 → 0.1.4

package/dist/src/runners/runner-adapter.d.ts

@@ -1,8 +1,10 @@
 import type { JobMode } from "../protocol/types.js";
 export type JobExecution = "foreground" | "background";
-export type JobResultStatus = "succeeded" | "failed" | "timed_out" | "ambiguous";
+export type JobResultStatus = "succeeded" | "failed" | "timed_out" | "cancelled" | "ambiguous";
 export interface RunnerSpec {
     jobId: string;
+    runId?: string;
+    jobKey?: string;
     argv: readonly string[];
     stdin?: string;
     mode: JobMode;
@@ -12,6 +14,7 @@ export interface RunnerSpec {
     task?: string;
     cwd?: string;
     env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
 }
 export interface JobResult {
     status: JobResultStatus;
@@ -21,12 +24,16 @@ export interface JobResult {
     output: string;
     emptyOutput: boolean;
     timedOut: boolean;
+    cancelled: boolean;
     ambiguousSideEffects: boolean;
     retryable: false;
     startedAt: string;
     finishedAt: string;
 }
+export interface RunnerRunHooks {
+    onSpawn?(pid: number): void | Promise<void>;
+}
 export interface RunnerAdapter {
-    run(spec: RunnerSpec): Promise<JobResult>;
+    run(spec: RunnerSpec, hooks?: RunnerRunHooks): Promise<JobResult>;
 }
 export declare function executionFor(spec: Pick<RunnerSpec, "background">): JobExecution;

package/dist/src/runners/runner-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner-adapter.js","sourceRoot":"","sources":["../../../src/runners/runner-adapter.ts"],"names":[],"mappings":"AAoCA,MAAM,UAAU,YAAY,CAAC,IAAoC;IAC/D,OAAO,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC;AAChE,CAAC"}
+{"version":3,"file":"runner-adapter.js","sourceRoot":"","sources":["../../../src/runners/runner-adapter.ts"],"names":[],"mappings":"AAiDA,MAAM,UAAU,YAAY,CAAC,IAAoC;IAC/D,OAAO,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC;AAChE,CAAC"}

package/dist/src/state/atomic-write.js

@@ -2,10 +2,24 @@ import { randomUUID } from "node:crypto";
 import { mkdir, open, rename, unlink } from "node:fs/promises";
 import path from "node:path";
 import { canonicalJson } from "../core/ids.js";
-import { runtimePidTag } from "../core/runtime.js";
+import { runtimePidTag, runtimePlatform } from "../core/runtime.js";
+async function syncDirectory(directory) {
+    if (runtimePlatform() === "win32")
+        return;
+    const handle = await open(directory, "r");
+    try {
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+}
 export async function atomicWriteJson(target, value) {
     const directory = path.dirname(target);
-    await mkdir(directory, { recursive: true });
+    const created = await mkdir(directory, { recursive: true });
+    if (created !== undefined) {
+        await syncDirectory(path.dirname(created));
+    }
     const temporary = path.join(directory, `.${path.basename(target)}.${runtimePidTag()}.${randomUUID()}.tmp`);
     let handle;
     try {
@@ -15,6 +29,7 @@ export async function atomicWriteJson(target, value) {
         await handle.close();
         handle = undefined;
         await rename(temporary, target);
+        await syncDirectory(directory);
     }
     catch (error) {
         if (handle !== undefined) {

package/dist/src/state/atomic-write.js.map

@@ -1 +1 @@
-{"version":3,"file":"atomic-write.js","sourceRoot":"","sources":["../../../src/state/atomic-write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,KAAc;IAClE,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CACzB,SAAS,EACT,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,aAAa,EAAE,IAAI,UAAU,EAAE,MAAM,CACnE,CAAC;IACF,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QAC5C,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5D,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,GAAG,SAAS,CAAC;QACnB,MAAM,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC9C,CAAC;QACD,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"atomic-write.js","sourceRoot":"","sources":["../../../src/state/atomic-write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEpE,KAAK,UAAU,aAAa,CAAC,SAAiB;IAC5C,IAAI,eAAe,EAAE,KAAK,OAAO;QAAE,OAAO;IAC1C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,KAAc;IAClE,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CACzB,SAAS,EACT,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,aAAa,EAAE,IAAI,UAAU,EAAE,MAAM,CACnE,CAAC;IACF,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QAC5C,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5D,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,GAAG,SAAS,CAAC;QACnB,MAAM,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAChC,MAAM,aAAa,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC9C,CAAC;QACD,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/src/state/cancellation.d.ts

@@ -0,0 +1,42 @@
+declare const CANCELLATION_PROTOCOL = "cueline/cancellation/0.1";
+export interface RunCancellationRequest {
+    protocol: typeof CANCELLATION_PROTOCOL;
+    run_id: string;
+    target: "run";
+    reason: string;
+    requested_at: string;
+}
+export interface JobCancellationRequest {
+    protocol: typeof CANCELLATION_PROTOCOL;
+    run_id: string;
+    target: "job";
+    job_id: string;
+    reason: string;
+    requested_at: string;
+}
+export interface CancellationObservation {
+    runRequested: boolean;
+    jobRequests: string[];
+}
+export interface CancellationWatcherOptions {
+    home: string;
+    runId: string;
+    intervalMs?: number;
+    onRun(request: RunCancellationRequest): void | Promise<void>;
+    onJob(request: JobCancellationRequest): boolean | void | Promise<boolean | void>;
+    onError(error: unknown): void;
+}
+export declare function requestRunCancellation(home: string, runId: string, reason: string, now?: () => Date): Promise<RunCancellationRequest>;
+export declare function requestJobCancellation(home: string, runId: string, jobId: string, reason: string, now?: () => Date): Promise<JobCancellationRequest>;
+export declare function readRunCancellation(home: string, runId: string): Promise<RunCancellationRequest | undefined>;
+export declare function readJobCancellations(home: string, runId: string): Promise<JobCancellationRequest[]>;
+export declare function readCancellationObservation(home: string, runId: string): Promise<CancellationObservation>;
+export declare class CancellationWatcher {
+    #private;
+    private readonly options;
+    constructor(options: CancellationWatcherOptions);
+    start(): void;
+    stop(): Promise<void>;
+    private poll;
+}
+export {};

package/dist/src/state/cancellation.js

@@ -0,0 +1,168 @@
+import { readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { CueLineError } from "../core/errors.js";
+import { atomicWriteJson } from "./atomic-write.js";
+import { runPaths } from "./paths.js";
+const CANCELLATION_PROTOCOL = "cueline/cancellation/0.1";
+const JOB_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_-]*$/;
+function assertJobId(jobId) {
+    if (!JOB_ID_PATTERN.test(jobId)) {
+        throw new CueLineError("JOB_ID_INVALID", "job id contains unsupported path characters", {
+            details: { jobId },
+        });
+    }
+}
+function assertReason(reason) {
+    if (reason.trim() === "") {
+        throw new CueLineError("CANCELLATION_REASON_INVALID", "cancellation reason must contain at least one non-whitespace character");
+    }
+}
+function isNotFound(error) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+function parseRequest(source, runId) {
+    const value = JSON.parse(source);
+    if (value.protocol !== CANCELLATION_PROTOCOL ||
+        value.run_id !== runId ||
+        (value.target !== "run" && value.target !== "job") ||
+        typeof value.reason !== "string" ||
+        value.reason.trim() === "" ||
+        typeof value.requested_at !== "string" ||
+        (value.target === "job" &&
+            (typeof value.job_id !== "string" || !JOB_ID_PATTERN.test(value.job_id)))) {
+        throw new CueLineError("CANCELLATION_REQUEST_INVALID", `CueLine run '${runId}' has an invalid cancellation request.`);
+    }
+    if (value.target === "run") {
+        return {
+            protocol: CANCELLATION_PROTOCOL,
+            run_id: runId,
+            target: "run",
+            reason: value.reason,
+            requested_at: value.requested_at,
+        };
+    }
+    return {
+        protocol: CANCELLATION_PROTOCOL,
+        run_id: runId,
+        target: "job",
+        job_id: value.job_id,
+        reason: value.reason,
+        requested_at: value.requested_at,
+    };
+}
+export async function requestRunCancellation(home, runId, reason, now = () => new Date()) {
+    assertReason(reason);
+    const request = {
+        protocol: CANCELLATION_PROTOCOL,
+        run_id: runId,
+        target: "run",
+        reason,
+        requested_at: now().toISOString(),
+    };
+    await atomicWriteJson(runPaths(home, runId).runCancellation, request);
+    return request;
+}
+export async function requestJobCancellation(home, runId, jobId, reason, now = () => new Date()) {
+    assertJobId(jobId);
+    assertReason(reason);
+    const request = {
+        protocol: CANCELLATION_PROTOCOL,
+        run_id: runId,
+        target: "job",
+        job_id: jobId,
+        reason,
+        requested_at: now().toISOString(),
+    };
+    await atomicWriteJson(path.join(runPaths(home, runId).jobCancellationsDir, `${jobId}.json`), request);
+    return request;
+}
+export async function readRunCancellation(home, runId) {
+    try {
+        const request = parseRequest(await readFile(runPaths(home, runId).runCancellation, "utf8"), runId);
+        if (request.target !== "run") {
+            throw new CueLineError("CANCELLATION_REQUEST_INVALID", `CueLine run '${runId}' has a job request in its run cancellation path.`);
+        }
+        return request;
+    }
+    catch (error) {
+        if (isNotFound(error))
+            return undefined;
+        throw error;
+    }
+}
+export async function readJobCancellations(home, runId) {
+    const directory = runPaths(home, runId).jobCancellationsDir;
+    let names;
+    try {
+        names = await readdir(directory);
+    }
+    catch (error) {
+        if (isNotFound(error))
+            return [];
+        throw error;
+    }
+    const requests = [];
+    for (const name of names.filter((candidate) => candidate.endsWith(".json")).sort()) {
+        const request = parseRequest(await readFile(path.join(directory, name), "utf8"), runId);
+        if (request.target !== "job") {
+            throw new CueLineError("CANCELLATION_REQUEST_INVALID", `CueLine run '${runId}' has a run request in its job cancellation directory.`);
+        }
+        requests.push(request);
+    }
+    return requests;
+}
+export async function readCancellationObservation(home, runId) {
+    const [runRequest, jobRequests] = await Promise.all([
+        readRunCancellation(home, runId),
+        readJobCancellations(home, runId),
+    ]);
+    return {
+        runRequested: runRequest !== undefined,
+        jobRequests: jobRequests.map((request) => request.job_id),
+    };
+}
+export class CancellationWatcher {
+    options;
+    #seenJobs = new Set();
+    #sawRun = false;
+    #timer;
+    #pollChain = Promise.resolve();
+    constructor(options) {
+        this.options = options;
+    }
+    start() {
+        if (this.#timer !== undefined)
+            return;
+        const schedule = () => {
+            this.#pollChain = this.#pollChain.then(() => this.poll()).catch((error) => {
+                this.options.onError(error);
+            });
+        };
+        schedule();
+        this.#timer = setInterval(schedule, this.options.intervalMs ?? 250);
+        this.#timer.unref();
+    }
+    async stop() {
+        if (this.#timer !== undefined)
+            clearInterval(this.#timer);
+        this.#timer = undefined;
+        await this.#pollChain;
+    }
+    async poll() {
+        if (!this.#sawRun) {
+            const request = await readRunCancellation(this.options.home, this.options.runId);
+            if (request !== undefined) {
+                this.#sawRun = true;
+                await this.options.onRun(request);
+            }
+        }
+        for (const request of await readJobCancellations(this.options.home, this.options.runId)) {
+            if (this.#seenJobs.has(request.job_id))
+                continue;
+            const handled = await this.options.onJob(request);
+            if (handled !== false)
+                this.#seenJobs.add(request.job_id);
+        }
+    }
+}
+//# sourceMappingURL=cancellation.js.map

package/dist/src/state/cancellation.js.map

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

package/dist/src/state/event-log.d.ts

@@ -1,8 +1,24 @@
+declare const EVENT_SEGMENT_FENCE_PROTOCOL = "cueline/event-segment-fence/0.1";
+export interface EventLegacyFence {
+    protocol: typeof EVENT_SEGMENT_FENCE_PROTOCOL;
+    legacy_event_count: number;
+    legacy_byte_length: number;
+    legacy_sha256: string;
+}
+export interface ReadEventsOptions {
+    /** A takeover-committed legacy prefix that must win over later JSONL suffixes. */
+    legacyFence?: EventLegacyFence;
+}
 export interface RunEvent {
     sequence: number;
     timestamp: string;
     type: string;
     payload: unknown;
+    runtime_owner_id?: string;
 }
+/** Captures a complete legacy prefix without publishing it as authoritative. */
+export declare function captureEventLegacyFence(file: string): Promise<EventLegacyFence>;
 export declare function appendEvent(file: string, event: RunEvent): Promise<void>;
-export declare function readEvents(file: string): Promise<RunEvent[]>;
+export declare function createEventLog(file: string, event: RunEvent): Promise<void>;
+export declare function readEvents(file: string, options?: ReadEventsOptions): Promise<RunEvent[]>;
+export {};