@sift-wiki/conductor 0.2.0-beta.1 → 0.2.0

package/dist/runtime/eventOutbox.js

@@ -0,0 +1,206 @@
+import { randomUUID } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+import { defaultConfigPath } from "../config.js";
+import { attemptAuthorityFenceSchema, authorityFence } from "../protocol/fenced.js";
+import { redactSecrets } from "../redaction.js";
+import { atomicWriteOwnerOnly, isNodeError } from "./atomicFile.js";
+export const OUTBOX_SCHEMA_VERSION = 1;
+const MAX_OUTBOX_BYTES = 1024 * 1024;
+const DEFAULT_MAX_ENTRIES = 1_000;
+const eventTypeSchema = z.enum([
+    "health",
+    "progress",
+    "log",
+    "artifact",
+    "approval_requested",
+    "completed",
+    "failed",
+    "cancelled",
+]);
+const outboxEntrySchema = z.object({
+    clientEventId: z.string().min(1).max(200),
+    clientSequence: z.number().int().positive(),
+    attemptId: z.string().min(1),
+    runId: z.string().min(1),
+    authority: attemptAuthorityFenceSchema,
+    event: z.object({
+        eventType: eventTypeSchema,
+        payload: z.record(z.string(), z.unknown()).optional(),
+        occurredAt: z.iso.datetime().optional(),
+    }).strict(),
+    attempts: z.number().int().nonnegative(),
+    enqueuedAt: z.number().int().nonnegative(),
+    nextAttemptAt: z.number().int().nonnegative(),
+    lastErrorMessage: z.string().max(1_000).optional(),
+}).strict();
+const outboxFileSchema = z.object({
+    schemaVersion: z.literal(OUTBOX_SCHEMA_VERSION),
+    entries: z.array(outboxEntrySchema),
+    updatedAt: z.iso.datetime(),
+}).strict();
+const legacyOutboxFileSchema = outboxFileSchema.omit({ schemaVersion: true }).extend({
+    schemaVersion: z.literal(0),
+}).strict();
+export class DurableEventOutbox {
+    path;
+    options;
+    loaded = false;
+    snapshot = emptySnapshot();
+    constructor(path = defaultEventOutboxPath(), options = {}) {
+        this.path = path;
+        this.options = options;
+    }
+    async enqueue(input) {
+        await this.load();
+        if (this.snapshot.entries.length >= (this.options.maxEntries ?? DEFAULT_MAX_ENTRIES)) {
+            throw new Error("Durable event outbox is full; refusing to lose an acknowledged event identity.");
+        }
+        const now = this.nowMs();
+        const entry = outboxEntrySchema.parse({
+            clientEventId: this.createId(),
+            clientSequence: input.clientSequence,
+            attemptId: input.attemptId,
+            runId: input.runId,
+            authority: authorityFence(input.authority),
+            event: sanitizeEvent(input.event),
+            attempts: 0,
+            enqueuedAt: now,
+            nextAttemptAt: now,
+            ...(input.error === undefined ? {} : { lastErrorMessage: safeError(input.error) }),
+        });
+        this.snapshot.entries.push(entry);
+        await this.persist();
+        return structuredClone(entry);
+    }
+    async due(nowMs = this.nowMs()) {
+        await this.load();
+        return structuredClone(this.snapshot.entries.filter((entry) => entry.nextAttemptAt <= nowMs));
+    }
+    async acknowledge(attemptId, acknowledgedClientSequence) {
+        await this.load();
+        this.snapshot.entries = this.snapshot.entries.filter((entry) => entry.attemptId !== attemptId || entry.clientSequence > acknowledgedClientSequence);
+        await this.persist();
+    }
+    async discardAttempt(attemptId) {
+        await this.load();
+        this.snapshot.entries = this.snapshot.entries.filter((entry) => entry.attemptId !== attemptId);
+        await this.persist();
+    }
+    async listAttempt(attemptId) {
+        await this.load();
+        return structuredClone(this.snapshot.entries
+            .filter((entry) => entry.attemptId === attemptId)
+            .sort((left, right) => left.clientSequence - right.clientSequence));
+    }
+    async recordFailure(clientEventId, error, nextAttemptAt) {
+        await this.load();
+        const entry = this.snapshot.entries.find((candidate) => candidate.clientEventId === clientEventId);
+        if (entry === undefined)
+            return;
+        entry.attempts += 1;
+        entry.nextAttemptAt = nextAttemptAt;
+        entry.lastErrorMessage = safeError(error);
+        await this.persist();
+    }
+    async stats() {
+        await this.load();
+        return {
+            retainedEntries: this.snapshot.entries.length,
+            lastClientSequence: Math.max(0, ...this.snapshot.entries.map((entry) => entry.clientSequence)),
+        };
+    }
+    async load() {
+        if (this.loaded)
+            return;
+        const contents = await readOptional(this.path);
+        if (contents === undefined) {
+            this.loaded = true;
+            return;
+        }
+        const parsed = parseSnapshot(contents);
+        if (parsed !== undefined) {
+            this.snapshot = parsed.snapshot;
+            this.loaded = true;
+            if (parsed.migrated)
+                await this.persist();
+            return;
+        }
+        const backup = await readOptional(`${this.path}.last-good`);
+        const recovered = backup === undefined ? undefined : parseSnapshot(backup);
+        if (recovered === undefined) {
+            throw new Error("Durable event outbox is corrupt and has no valid last-good snapshot.");
+        }
+        this.snapshot = recovered.snapshot;
+        this.loaded = true;
+        await this.persist();
+    }
+    async persist() {
+        this.snapshot.updatedAt = new Date(this.nowMs()).toISOString();
+        const parsed = outboxFileSchema.parse(this.snapshot);
+        const contents = `${JSON.stringify(parsed, null, 2)}\n`;
+        if (Buffer.byteLength(contents, "utf8") > MAX_OUTBOX_BYTES) {
+            throw new Error(`Durable event outbox exceeds its ${String(MAX_OUTBOX_BYTES)} byte limit.`);
+        }
+        await atomicWriteOwnerOnly(this.path, contents, { ...this.options, backup: true });
+    }
+    nowMs() {
+        return (this.options.nowMs ?? Date.now)();
+    }
+    createId() {
+        return (this.options.createId ?? randomUUID)();
+    }
+}
+export function defaultEventOutboxPath(env = process.env) {
+    return path.join(path.dirname(defaultConfigPath(env)), "runtime", "event-outbox.json");
+}
+function emptySnapshot() {
+    return { schemaVersion: OUTBOX_SCHEMA_VERSION, entries: [], updatedAt: new Date(0).toISOString() };
+}
+function parseSnapshot(contents) {
+    let raw;
+    try {
+        raw = JSON.parse(contents);
+    }
+    catch {
+        return undefined;
+    }
+    const current = outboxFileSchema.safeParse(raw);
+    if (current.success)
+        return { snapshot: current.data, migrated: false };
+    const legacy = legacyOutboxFileSchema.safeParse(raw);
+    if (!legacy.success)
+        return undefined;
+    return { snapshot: { ...legacy.data, schemaVersion: OUTBOX_SCHEMA_VERSION }, migrated: true };
+}
+function sanitizeEvent(event) {
+    return {
+        ...event,
+        ...(event.payload === undefined ? {} : { payload: sanitizeJson(event.payload) }),
+    };
+}
+function sanitizeJson(value) {
+    return Object.fromEntries(Object.entries(value).map(([key, entry]) => {
+        if (typeof entry === "string")
+            return [key, redactSecrets(entry)];
+        if (Array.isArray(entry)) {
+            return [key, entry.map((item) => typeof item === "string" ? redactSecrets(item) : item)];
+        }
+        return [key, entry];
+    }));
+}
+function safeError(error) {
+    return redactSecrets(error instanceof Error ? error.message : "Unknown event delivery failure.").slice(0, 1_000);
+}
+async function readOptional(filePath) {
+    try {
+        return await readFile(filePath, "utf8");
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT")
+            return undefined;
+        throw error;
+    }
+}
+//# sourceMappingURL=eventOutbox.js.map

package/dist/runtime/eventOutbox.js.map

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

package/dist/runtime/executionJournal.d.ts

@@ -0,0 +1,102 @@
+import { z } from "zod";
+import { type AttemptAuthority } from "../protocol/fenced.js";
+import { type AtomicWriteOptions } from "./atomicFile.js";
+export declare const JOURNAL_SCHEMA_VERSION = 1;
+declare const processIdentitySchema: z.ZodObject<{
+    pid: z.ZodNumber;
+    startMarker: z.ZodString;
+}, z.core.$strict>;
+declare const journalPhaseSchema: z.ZodEnum<{
+    superseded: "superseded";
+    claimed: "claimed";
+    starting: "starting";
+    running: "running";
+    authority_uncertain: "authority_uncertain";
+    recovering: "recovering";
+    interrupted: "interrupted";
+    overtime: "overtime";
+    terminal: "terminal";
+}>;
+export declare const executionJournalSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    attemptId: z.ZodString;
+    jobId: z.ZodString;
+    runId: z.ZodString;
+    taskRecordId: z.ZodOptional<z.ZodString>;
+    localKey: z.ZodString;
+    adapterType: z.ZodString;
+    authority: z.ZodObject<{
+        attemptId: z.ZodString;
+        leaseGeneration: z.ZodNumber;
+        leaseExpiresAt: z.ZodISODateTime;
+        mustStopAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+    accessMode: z.ZodEnum<{
+        inspect: "inspect";
+        write: "write";
+    }>;
+    phase: z.ZodEnum<{
+        superseded: "superseded";
+        claimed: "claimed";
+        starting: "starting";
+        running: "running";
+        authority_uncertain: "authority_uncertain";
+        recovering: "recovering";
+        interrupted: "interrupted";
+        overtime: "overtime";
+        terminal: "terminal";
+    }>;
+    leaseHealth: z.ZodOptional<z.ZodEnum<{
+        healthy: "healthy";
+        retrying: "retrying";
+        "authority-uncertain": "authority-uncertain";
+        lost: "lost";
+    }>>;
+    provider: z.ZodObject<{
+        resumeSupported: z.ZodBoolean;
+        sessionId: z.ZodOptional<z.ZodString>;
+        processIdentity: z.ZodOptional<z.ZodObject<{
+            pid: z.ZodNumber;
+            startMarker: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    lastAcknowledgedClientSequence: z.ZodNumber;
+    nextClientSequence: z.ZodNumber;
+    settlementIdempotencyKey: z.ZodOptional<z.ZodString>;
+    lastProgressAt: z.ZodOptional<z.ZodISODateTime>;
+    noProgressObservedAt: z.ZodOptional<z.ZodISODateTime>;
+    updatedAt: z.ZodISODateTime;
+    interruptionReason: z.ZodOptional<z.ZodString>;
+    terminalResult: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            cancelled: "cancelled";
+            completed: "completed";
+            failed: "failed";
+            overtime: "overtime";
+        }>;
+        summary: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type SafeProcessIdentity = z.infer<typeof processIdentitySchema>;
+export type ExecutionJournal = z.infer<typeof executionJournalSchema>;
+export type ExecutionJournalPhase = z.infer<typeof journalPhaseSchema>;
+export type JournalReadResult = {
+    journal: ExecutionJournal;
+    recoveredFromLastGood: boolean;
+    migrated: boolean;
+};
+export declare class ExecutionJournalStore {
+    readonly directory: string;
+    private readonly writeOptions;
+    constructor(directory?: string, writeOptions?: AtomicWriteOptions);
+    write(journal: ExecutionJournal): Promise<void>;
+    read(attemptId: string): Promise<JournalReadResult | undefined>;
+    listUnfinished(): Promise<JournalReadResult[]>;
+    list(): Promise<JournalReadResult[]>;
+    delete(attemptId: string): Promise<void>;
+    private pathFor;
+    private enforceRetention;
+}
+export declare function defaultExecutionJournalDirectory(env?: NodeJS.ProcessEnv): string;
+export declare function authorityFromJournal(journal: ExecutionJournal): AttemptAuthority;
+export {};

package/dist/runtime/executionJournal.js

@@ -0,0 +1,209 @@
+import { readFile, readdir, rename, rm } from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+import { defaultConfigPath } from "../config.js";
+import { attemptAuthoritySchema } from "../protocol/fenced.js";
+import { redactSecrets } from "../redaction.js";
+import { atomicWriteOwnerOnly, isNodeError } from "./atomicFile.js";
+export const JOURNAL_SCHEMA_VERSION = 1;
+const MAX_JOURNAL_BYTES = 64 * 1024;
+const MAX_JOURNALS = 100;
+const processIdentitySchema = z.object({
+    pid: z.number().int().positive(),
+    startMarker: z.string().min(1).max(500),
+}).strict();
+const journalPhaseSchema = z.enum([
+    "claimed",
+    "starting",
+    "running",
+    "authority_uncertain",
+    "recovering",
+    "interrupted",
+    "overtime",
+    "superseded",
+    "terminal",
+]);
+const terminalResultSchema = z.object({
+    status: z.enum(["completed", "failed", "cancelled", "overtime"]),
+    summary: z.string().min(1).max(4_000),
+}).strict();
+export const executionJournalSchema = z.object({
+    schemaVersion: z.literal(JOURNAL_SCHEMA_VERSION),
+    attemptId: z.string().min(1),
+    jobId: z.string().min(1),
+    runId: z.string().min(1),
+    taskRecordId: z.string().min(1).optional(),
+    localKey: z.string().min(1),
+    adapterType: z.string().min(1),
+    authority: attemptAuthoritySchema,
+    accessMode: z.enum(["inspect", "write"]),
+    phase: journalPhaseSchema,
+    leaseHealth: z.enum(["healthy", "retrying", "authority-uncertain", "lost"]).optional(),
+    provider: z.object({
+        resumeSupported: z.boolean(),
+        sessionId: z.string().min(1).max(500).optional(),
+        processIdentity: processIdentitySchema.optional(),
+    }).strict(),
+    lastAcknowledgedClientSequence: z.number().int().nonnegative(),
+    nextClientSequence: z.number().int().positive(),
+    settlementIdempotencyKey: z.string().min(1).max(200).optional(),
+    lastProgressAt: z.iso.datetime().optional(),
+    noProgressObservedAt: z.iso.datetime().optional(),
+    updatedAt: z.iso.datetime(),
+    interruptionReason: z.string().min(1).max(1_000).optional(),
+    terminalResult: terminalResultSchema.optional(),
+}).strict();
+const legacyJournalSchema = executionJournalSchema.omit({ schemaVersion: true }).extend({
+    schemaVersion: z.literal(0),
+}).strict();
+export class ExecutionJournalStore {
+    directory;
+    writeOptions;
+    constructor(directory = defaultExecutionJournalDirectory(), writeOptions = {}) {
+        this.directory = directory;
+        this.writeOptions = writeOptions;
+    }
+    async write(journal) {
+        const parsed = executionJournalSchema.parse(sanitizeJournal(journal));
+        const contents = serializeBounded(parsed, MAX_JOURNAL_BYTES, "Execution journal");
+        await this.enforceRetention(parsed.attemptId);
+        await atomicWriteOwnerOnly(this.pathFor(parsed.attemptId), contents, {
+            ...this.writeOptions,
+            backup: true,
+        });
+    }
+    async read(attemptId) {
+        const filePath = this.pathFor(attemptId);
+        const primary = await readOptional(filePath);
+        if (primary === undefined)
+            return undefined;
+        const parsed = parseJournal(primary);
+        if (parsed !== undefined) {
+            if (parsed.migrated)
+                await this.write(parsed.journal);
+            return { ...parsed, recoveredFromLastGood: false };
+        }
+        const backup = await readOptional(`${filePath}.last-good`);
+        const recovered = backup === undefined ? undefined : parseJournal(backup);
+        if (recovered === undefined) {
+            await quarantine(filePath);
+            throw new Error("Execution recovery state is corrupt and has no valid last-good snapshot.");
+        }
+        await this.write(recovered.journal);
+        return { ...recovered, recoveredFromLastGood: true };
+    }
+    async listUnfinished() {
+        return (await this.list()).filter((result) => activeRecoveryPhase(result.journal.phase));
+    }
+    async list() {
+        let names;
+        try {
+            names = await readdir(this.directory);
+        }
+        catch (error) {
+            if (isNodeError(error) && error.code === "ENOENT")
+                return [];
+            throw error;
+        }
+        const results = [];
+        for (const name of names.filter((candidate) => candidate.endsWith(".json")).sort()) {
+            const attemptId = decodeURIComponent(name.slice(0, -5));
+            const result = await this.read(attemptId);
+            if (result !== undefined)
+                results.push(result);
+        }
+        return results;
+    }
+    async delete(attemptId) {
+        await rm(this.pathFor(attemptId), { force: true });
+        await rm(`${this.pathFor(attemptId)}.last-good`, { force: true });
+    }
+    pathFor(attemptId) {
+        return path.join(this.directory, `${encodeURIComponent(attemptId)}.json`);
+    }
+    async enforceRetention(currentAttemptId) {
+        let names;
+        try {
+            names = await readdir(this.directory);
+        }
+        catch (error) {
+            if (isNodeError(error) && error.code === "ENOENT")
+                return;
+            throw error;
+        }
+        const journals = names.filter((name) => name.endsWith(".json"));
+        if (journals.length >= MAX_JOURNALS && !journals.includes(`${encodeURIComponent(currentAttemptId)}.json`)) {
+            throw new Error(`Execution journal retention limit of ${String(MAX_JOURNALS)} was reached.`);
+        }
+    }
+}
+export function defaultExecutionJournalDirectory(env = process.env) {
+    return path.join(path.dirname(defaultConfigPath(env)), "runtime", "executions");
+}
+function parseJournal(contents) {
+    let raw;
+    try {
+        raw = JSON.parse(contents);
+    }
+    catch {
+        return undefined;
+    }
+    const current = executionJournalSchema.safeParse(raw);
+    if (current.success)
+        return { journal: current.data, migrated: false };
+    const legacy = legacyJournalSchema.safeParse(raw);
+    if (!legacy.success)
+        return undefined;
+    return {
+        journal: { ...legacy.data, schemaVersion: JOURNAL_SCHEMA_VERSION },
+        migrated: true,
+    };
+}
+function sanitizeJournal(journal) {
+    return {
+        ...journal,
+        ...(journal.interruptionReason === undefined
+            ? {}
+            : { interruptionReason: redactSecrets(journal.interruptionReason) }),
+        ...(journal.terminalResult === undefined
+            ? {}
+            : { terminalResult: { ...journal.terminalResult, summary: redactSecrets(journal.terminalResult.summary) } }),
+    };
+}
+function serializeBounded(value, maxBytes, label) {
+    const contents = `${JSON.stringify(value, null, 2)}\n`;
+    if (Buffer.byteLength(contents, "utf8") > maxBytes) {
+        throw new Error(`${label} exceeds its ${String(maxBytes)} byte limit.`);
+    }
+    return contents;
+}
+async function readOptional(filePath) {
+    try {
+        return await readFile(filePath, "utf8");
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT")
+            return undefined;
+        throw error;
+    }
+}
+async function quarantine(filePath) {
+    try {
+        await rename(filePath, `${filePath}.corrupt-${String(Date.now())}`);
+    }
+    catch (error) {
+        if (!isNodeError(error) || error.code !== "ENOENT")
+            throw error;
+    }
+}
+export function authorityFromJournal(journal) {
+    return journal.authority;
+}
+function activeRecoveryPhase(phase) {
+    return phase === "claimed"
+        || phase === "starting"
+        || phase === "running"
+        || phase === "authority_uncertain"
+        || phase === "recovering";
+}
+//# sourceMappingURL=executionJournal.js.map

package/dist/runtime/executionJournal.js.map

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

package/dist/runtime/executionSafety.d.ts

@@ -0,0 +1,76 @@
+import type { LocalAgentAdapter, Sleep } from "../adapters/types.js";
+import type { DaemonClient, DaemonTimer } from "../daemon.js";
+import type { ClaimedJob, JsonObject, LeaseRefresh, RunEventInput } from "../types.js";
+import type { LocalLogSpool } from "./localLogSpool.js";
+import type { RunEventRetryBuffer } from "./runEventRetryBuffer.js";
+import type { DurableEventOutbox } from "./eventOutbox.js";
+import type { ExecutionJournalStore } from "./executionJournal.js";
+import { FencedExecutionState } from "./fencedExecutionState.js";
+import type { LocalRuntimeSessionCache, LocalRuntimeSessionStatus } from "./localSessionCache.js";
+export type ActiveLeaseState = {
+    done: boolean;
+    cancelRequested: boolean;
+    timedOut: boolean;
+    hardStop: boolean;
+    authorityUncertain: boolean;
+};
+export type NoProgressObserver = {
+    recordProgress(): void;
+    stop(): Promise<void>;
+};
+export declare const defaultDaemonTimer: DaemonTimer;
+export declare function createFencedState(input: {
+    job: ClaimedJob;
+    adapter: LocalAgentAdapter | undefined;
+    journalStore?: ExecutionJournalStore | undefined;
+    eventOutbox?: DurableEventOutbox | undefined;
+    now: () => Date;
+}): Promise<FencedExecutionState | undefined>;
+export declare function emitRunEvent(input: {
+    client: DaemonClient;
+    credential: string;
+    job: ClaimedJob;
+    event: RunEventInput;
+    buffer?: RunEventRetryBuffer | undefined;
+    logSpool?: LocalLogSpool | undefined;
+    fencedState?: FencedExecutionState | undefined;
+    progressObserver?: NoProgressObserver | undefined;
+}): Promise<void>;
+export declare function observeRunProgress(input: {
+    job: ClaimedJob;
+    timer: DaemonTimer;
+    fencedState?: FencedExecutionState | undefined;
+    logSpool?: LocalLogSpool | undefined;
+    now: () => Date;
+}): NoProgressObserver;
+export declare function rejectExhaustedClaim(job: ClaimedJob, fencedState: FencedExecutionState | undefined): Promise<boolean>;
+export declare function refreshLeaseUntilDone(input: {
+    client: DaemonClient;
+    credential: string;
+    jobId: string;
+    sleep: Sleep;
+    sleepSignal: AbortSignal;
+    adapterAbort: AbortController;
+    state: ActiveLeaseState;
+    leaseRefreshMs: number;
+    fencedState?: FencedExecutionState | undefined;
+    monotonicNowMs?: (() => number) | undefined;
+    random?: (() => number) | undefined;
+    nowMs?: (() => number) | undefined;
+    continueInspectOnly?: boolean | undefined;
+}): Promise<void>;
+export declare function renewFencedLease(input: {
+    client: DaemonClient;
+    credential: string;
+    jobId: string;
+    fencedState: FencedExecutionState;
+    sleep: Sleep;
+    signal?: AbortSignal | undefined;
+    nowMs?: (() => number) | undefined;
+    monotonicNowMs?: (() => number) | undefined;
+    random?: (() => number) | undefined;
+}): Promise<LeaseRefresh>;
+export declare function scheduleRunTimeout(job: ClaimedJob, timer: DaemonTimer, adapterAbort: AbortController, state: {
+    timedOut: boolean;
+}, now: () => Date): unknown;
+export declare function updateLocalSession(cache: LocalRuntimeSessionCache | undefined, job: ClaimedJob, status: LocalRuntimeSessionStatus, errorSummary?: JsonObject): void;