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

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;

package/dist/runtime/executionSafety.js

@@ -0,0 +1,207 @@
+import { FencedExecutionState } from "./fencedExecutionState.js";
+import { LeaseAuthorityError, LeaseManager } from "./leaseManager.js";
+import { isAbortError } from "./sleep.js";
+const DEFAULT_NO_PROGRESS_MS = 5 * 60_000;
+export const defaultDaemonTimer = {
+    schedule: (callback, ms) => setTimeout(callback, ms),
+    cancel: (handle) => clearTimeout(handle),
+};
+export async function createFencedState(input) {
+    if (input.job.authority === undefined)
+        return undefined;
+    if (input.journalStore === undefined || input.eventOutbox === undefined) {
+        throw new Error("Fenced claims require durable journal and outbox persistence before execution.");
+    }
+    return FencedExecutionState.create({
+        job: { ...input.job, authority: input.job.authority },
+        adapter: input.adapter,
+        store: input.journalStore,
+        outbox: input.eventOutbox,
+        now: input.now,
+    });
+}
+export async function emitRunEvent(input) {
+    if (input.event.eventType === "progress")
+        input.progressObserver?.recordProgress();
+    const summary = input.event.payload?.["summary"];
+    if (typeof summary === "string") {
+        input.logSpool?.append({
+            runId: input.job.runId,
+            message: summary,
+            stream: input.event.eventType === "log" ? "stdout" : "system",
+            occurredAt: input.event.occurredAt,
+        });
+    }
+    if (input.fencedState !== undefined) {
+        await input.fencedState.emit((event) => input.client.appendRunEvent(input.credential, input.job.runId, event), input.event);
+        return;
+    }
+    try {
+        await input.client.appendRunEvent(input.credential, input.job.runId, input.event);
+    }
+    catch (error) {
+        if (input.buffer === undefined)
+            throw error;
+        input.buffer.enqueue({ runId: input.job.runId, event: input.event, error });
+    }
+}
+export function observeRunProgress(input) {
+    const thresholdMs = noProgressThresholdMs(input.job);
+    let stopped = false;
+    let generation = 0;
+    let handle;
+    let pending = Promise.resolve();
+    const schedule = () => {
+        const scheduledGeneration = ++generation;
+        handle = input.timer.schedule(() => {
+            if (stopped || scheduledGeneration !== generation)
+                return;
+            handle = undefined;
+            const observedAt = input.now().toISOString();
+            pending = pending.then(async () => {
+                await input.fencedState?.recordNoProgress(observedAt);
+                input.logSpool?.append({
+                    runId: input.job.runId,
+                    occurredAt: observedAt,
+                    stream: "system",
+                    message: "No provider progress was observed during the configured interval.",
+                });
+            });
+        }, thresholdMs);
+    };
+    schedule();
+    return {
+        recordProgress() {
+            if (stopped)
+                return;
+            generation += 1;
+            if (handle !== undefined)
+                input.timer.cancel(handle);
+            schedule();
+        },
+        async stop() {
+            stopped = true;
+            generation += 1;
+            if (handle !== undefined)
+                input.timer.cancel(handle);
+            await pending;
+        },
+    };
+}
+export async function rejectExhaustedClaim(job, fencedState) {
+    if (job.maxAttempts === undefined || job.attempts <= job.maxAttempts)
+        return false;
+    await fencedState?.updatePhase("interrupted", "Sift returned a claim after its maximum attempt count was exhausted.");
+    return true;
+}
+export async function refreshLeaseUntilDone(input) {
+    for (;;) {
+        if (leaseDone(input.state))
+            return;
+        try {
+            await input.sleep(input.leaseRefreshMs, input.sleepSignal);
+        }
+        catch (error) {
+            if (isAbortError(error))
+                return;
+            throw error;
+        }
+        if (leaseDone(input.state))
+            return;
+        let refresh;
+        try {
+            refresh = input.fencedState === undefined
+                ? await input.client.refreshLease(input.credential, input.jobId)
+                : await renewFencedLease({
+                    client: input.client,
+                    credential: input.credential,
+                    jobId: input.jobId,
+                    fencedState: input.fencedState,
+                    sleep: input.sleep,
+                    signal: input.sleepSignal,
+                    nowMs: input.nowMs,
+                    monotonicNowMs: input.monotonicNowMs,
+                    random: input.random,
+                });
+        }
+        catch (error) {
+            if (error instanceof LeaseAuthorityError && input.fencedState !== undefined) {
+                input.state.authorityUncertain = true;
+                await input.fencedState.updatePhase("authority_uncertain", error.message);
+                if (input.continueInspectOnly !== true)
+                    input.adapterAbort.abort();
+                return;
+            }
+            throw error;
+        }
+        if (refresh.cancelRequested) {
+            input.state.cancelRequested = true;
+            input.adapterAbort.abort();
+            return;
+        }
+    }
+}
+export async function renewFencedLease(input) {
+    const manager = new LeaseManager({
+        sleep: input.sleep,
+        nowMs: input.nowMs,
+        monotonicNowMs: input.monotonicNowMs,
+        random: input.random,
+        onHealth: (health) => input.fencedState.updateLeaseHealth(health),
+    });
+    const refresh = await manager.renew({
+        authority: input.fencedState.authority(),
+        signal: input.signal,
+        refresh: () => input.client.refreshLease(input.credential, input.jobId, input.fencedState.authority()),
+    });
+    if (refresh.authority === undefined) {
+        throw new LeaseAuthorityError("authority_uncertain", "Fenced renewal omitted authority.");
+    }
+    await input.fencedState.updateAuthority(refresh.authority);
+    return refresh;
+}
+export function scheduleRunTimeout(job, timer, adapterAbort, state, now) {
+    if (job.authority !== undefined) {
+        const delay = Date.parse(job.authority.mustStopAt) - now().getTime();
+        return timer.schedule(() => {
+            state.timedOut = true;
+            adapterAbort.abort();
+        }, Math.max(0, delay));
+    }
+    const maxRunMinutes = job.wakeEnvelope?.limits.maxRunMinutes;
+    if (maxRunMinutes === undefined)
+        return undefined;
+    return timer.schedule(() => {
+        state.timedOut = true;
+        adapterAbort.abort();
+    }, maxRunMinutes * 60_000);
+}
+export function updateLocalSession(cache, job, status, errorSummary) {
+    if (cache === undefined)
+        return;
+    const previous = cache.read(job.runId);
+    const now = new Date().toISOString();
+    cache.upsert({
+        runId: job.runId,
+        adapterType: job.adapterType,
+        localKey: job.localKey,
+        status,
+        localOnly: true,
+        updatedAt: now,
+        startedAt: previous?.startedAt ?? now,
+        ...(status === "running" || status === "starting" ? {} : { stoppedAt: now }),
+        taskKey: job.taskRecordId ?? job.wakeEnvelope?.task.id,
+        cancelRequested: status === "cancelled",
+        ...(errorSummary === undefined ? {} : { errorSummary }),
+    });
+}
+function leaseDone(state) {
+    return state.done;
+}
+function noProgressThresholdMs(job) {
+    const minutes = job.limits["noProgressMinutes"];
+    return typeof minutes === "number" && Number.isFinite(minutes) && minutes > 0
+        ? minutes * 60_000
+        : DEFAULT_NO_PROGRESS_MS;
+}
+//# sourceMappingURL=executionSafety.js.map

package/dist/runtime/executionSafety.js.map

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

package/dist/runtime/fencedExecutionState.d.ts

@@ -0,0 +1,43 @@
+import type { LocalAgentAdapter } from "../adapters/types.js";
+import type { AttemptMutationOptions } from "../protocol/fenced.js";
+import type { ClaimedJob, JsonObject, RunEventAppendResult, RunEventDeliveryInput, RunEventInput } from "../types.js";
+import type { DurableEventOutbox } from "./eventOutbox.js";
+import { type ExecutionJournal, type ExecutionJournalPhase, type ExecutionJournalStore } from "./executionJournal.js";
+import type { LeaseHealth } from "./leaseManager.js";
+export declare class FencedExecutionState {
+    private journal;
+    private readonly store;
+    private readonly outbox;
+    private readonly now;
+    private eventChain;
+    private updateChain;
+    private constructor();
+    static create(input: {
+        job: ClaimedJob & {
+            authority: NonNullable<ClaimedJob["authority"]>;
+        };
+        adapter: LocalAgentAdapter | undefined;
+        store: ExecutionJournalStore;
+        outbox: DurableEventOutbox;
+        now?: (() => Date) | undefined;
+        createId?: (() => string) | undefined;
+    }): Promise<FencedExecutionState>;
+    authority(): {
+        attemptId: string;
+        leaseGeneration: number;
+        leaseExpiresAt: string;
+        mustStopAt: string;
+    };
+    accessMode(): "inspect" | "write";
+    settlementOptions(): AttemptMutationOptions;
+    updateAuthority(authority: ExecutionJournal["authority"]): Promise<void>;
+    updateLeaseHealth(leaseHealth: LeaseHealth): Promise<void>;
+    updatePhase(phase: ExecutionJournalPhase, interruptionReason?: string): Promise<void>;
+    recordProcessIdentity(processIdentity: NonNullable<ExecutionJournal["provider"]["processIdentity"]>): Promise<void>;
+    recordProviderSession(sessionId: string): Promise<void>;
+    recordNoProgress(observedAt: string): Promise<void>;
+    recordTerminal(status: NonNullable<ExecutionJournal["terminalResult"]>["status"], summary: JsonObject, phase?: ExecutionJournalPhase): Promise<void>;
+    emit(deliver: (event: RunEventDeliveryInput) => Promise<RunEventAppendResult>, event: RunEventInput): Promise<void>;
+    private emitInSequence;
+    private update;
+}