@prismatic-io/lux 0.0.1

package/lib/orchestrator/driver-session.d.ts

@@ -0,0 +1,177 @@
+import { type AgentDriver, type Answer, type Answerer, type AnswererContext, type AnswerHistoryEntry, type Done, type ErrorEvent, type Interrupt, type Progress } from "../core/index.js";
+import type { OpenedRunDir } from "./run-dir.js";
+import type { RunTraceLimitFailure } from "./trace-limits.js";
+export type DriverSessionOutcome = {
+    kind: "done";
+    done: Done;
+} | {
+    kind: "error";
+    error: ErrorEvent;
+    operationalFailure?: {
+        phase: "answerer" | "driver-transport" | "trace" | "abort";
+        reason: string;
+    };
+};
+export type DriverSession = {
+    outcome: Promise<DriverSessionOutcome>;
+    fail: (reason: string) => void;
+};
+type DeferredInterrupt = {
+    interrupt: Interrupt;
+    complete: () => void;
+};
+type CompletedAnswer = {
+    answer: Answer;
+    durationMs: number;
+};
+export type DriverSessionEffects = {
+    answer: (interrupt: Interrupt) => Promise<CompletedAnswer>;
+    respond: (interrupt: Interrupt, completed: CompletedAnswer) => Promise<void>;
+    progress: (progress: Progress) => void;
+    terminal: (outcome: DriverSessionOutcome, alreadyRecorded: boolean) => void;
+};
+type DriverSessionContext = {
+    effects: DriverSessionEffects;
+    current: DeferredInterrupt | null;
+    queued: DeferredInterrupt[];
+    terminal: DriverSessionOutcome | null;
+    completedAnswer: CompletedAnswer | null;
+};
+type DriverSessionEvent = {
+    type: "interrupt";
+    pending: DeferredInterrupt;
+} | {
+    type: "progress";
+    progress: Progress;
+} | {
+    type: "done";
+    done: Done;
+    recorded?: boolean;
+} | {
+    type: "error";
+    error: ErrorEvent;
+    recorded?: boolean;
+} | {
+    type: "abort";
+    recorded?: boolean;
+} | {
+    type: "fail";
+    reason: string;
+    recorded?: boolean;
+} | {
+    type: "traceLimit";
+    failure: RunTraceLimitFailure;
+};
+declare const driverSessionMachine: import("xstate").StateMachine<DriverSessionContext, DriverSessionEvent, {
+    [x: string]: import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<void, {
+        effects: DriverSessionEffects;
+        interrupt: Interrupt;
+        completed: CompletedAnswer;
+    }, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<CompletedAnswer, {
+        effects: DriverSessionEffects;
+        interrupt: Interrupt;
+    }, import("xstate").EventObject>> | undefined;
+}, {
+    src: "answer";
+    logic: import("xstate").PromiseActorLogic<CompletedAnswer, {
+        effects: DriverSessionEffects;
+        interrupt: Interrupt;
+    }, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "respond";
+    logic: import("xstate").PromiseActorLogic<void, {
+        effects: DriverSessionEffects;
+        interrupt: Interrupt;
+        completed: CompletedAnswer;
+    }, import("xstate").EventObject>;
+    id: string | undefined;
+}, {
+    type: "beginInterrupt";
+    params: import("xstate").NonReducibleUnknown;
+} | {
+    type: "completeCurrentInterrupt";
+    params: import("xstate").NonReducibleUnknown;
+} | {
+    type: "queueInterrupt";
+    params: import("xstate").NonReducibleUnknown;
+} | {
+    type: "recordDone";
+    params: unknown;
+} | {
+    type: "recordError";
+    params: unknown;
+} | {
+    type: "recordInteractionFailure";
+    params: unknown;
+} | {
+    type: "recordProgress";
+    params: unknown;
+} | {
+    type: "recordTraceLimit";
+    params: unknown;
+} | {
+    type: "releaseInterrupts";
+    params: unknown;
+} | {
+    type: "rememberCompletedAnswer";
+    params: import("xstate").NonReducibleUnknown;
+} | {
+    type: "rememberDone";
+    params: import("xstate").NonReducibleUnknown;
+} | {
+    type: "rememberError";
+    params: import("xstate").NonReducibleUnknown;
+} | {
+    type: "rememberInteractionFailure";
+    params: import("xstate").NonReducibleUnknown;
+} | {
+    type: "rememberTraceLimit";
+    params: import("xstate").NonReducibleUnknown;
+} | {
+    type: "takeNextInterrupt";
+    params: import("xstate").NonReducibleUnknown;
+}, {
+    type: "hasDoneTerminal";
+    params: unknown;
+} | {
+    type: "hasErrorTerminal";
+    params: unknown;
+} | {
+    type: "hasNoTerminal";
+    params: unknown;
+} | {
+    type: "hasQueuedInterrupt";
+    params: unknown;
+} | {
+    type: "hasTraceTerminal";
+    params: unknown;
+}, never, "answering" | "failed" | "responding" | "selecting" | "succeeded" | "waiting", string, {
+    effects: DriverSessionEffects;
+}, DriverSessionOutcome, import("xstate").EventObject, import("xstate").MetaObject, {
+    id: "lux-driver-session";
+    states: {
+        readonly waiting: {};
+        readonly answering: {};
+        readonly responding: {};
+        readonly selecting: {};
+        readonly succeeded: {};
+        readonly failed: {};
+    };
+}>;
+export declare const createDriverSession: (options: {
+    driver: AgentDriver;
+    answerer: Answerer;
+    context: AnswererContext;
+    runDir: OpenedRunDir;
+    interruptCounts: {
+        ask: number;
+        approve: number;
+        custom: number;
+    };
+    history: AnswerHistoryEntry[];
+    abortSignal?: AbortSignal;
+    onToolCall: () => void;
+}) => DriverSession;
+export { driverSessionMachine };
+//# sourceMappingURL=driver-session.d.ts.map

package/lib/orchestrator/driver-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-session.d.ts","sourceRoot":"","sources":["../../src/orchestrator/driver-session.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,kBAAkB,EAEvB,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,QAAQ,EAEd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAC5B;IACE,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,UAAU,CAAC;IAClB,kBAAkB,CAAC,EAAE;QACnB,KAAK,EAAE,UAAU,GAAG,kBAAkB,GAAG,OAAO,GAAG,OAAO,CAAC;QAC3D,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC;AAEN,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACvC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IAC3D,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IACvC,QAAQ,EAAE,CAAC,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7E,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC1B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAClC,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACtC,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;CACzC,CAAC;AAEF,KAAK,kBAAkB,GACnB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAqD1D,QAAA,MAAM,oBAAoB;;iBAcT,oBAAoB;mBAClB,SAAS;mBACT,eAAe;;iBARkB,oBAAoB;mBAAa,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aALlE,oBAAoB;;;;;;;;;;;EAwO9C,CAAC;AAcH,eAAO,MAAM,mBAAmB,YAAa;IAC3C,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,eAAe,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB,KAAG,aA+HH,CAAC;AAGF,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/lib/orchestrator/driver-session.js

@@ -0,0 +1,396 @@
+import { assign, createActor, fromPromise, setup, toPromise } from "xstate";
+import { AnswerSchema, } from "../core/index.js";
+class InteractionFailure extends Error {
+    outcome;
+    terminalRecorded;
+    constructor(outcome, terminalRecorded = false) {
+        super(outcome.kind === "error" ? outcome.error.reason : "driver interaction failed");
+        this.outcome = outcome;
+        this.terminalRecorded = terminalRecorded;
+    }
+}
+const interactionFailure = (error) => error instanceof InteractionFailure
+    ? error.outcome
+    : {
+        kind: "error",
+        error: { exitReason: "error", reason: "driver interaction failed" },
+    };
+const doneOutcome = (event) => event.type === "done"
+    ? { kind: "done", done: event.done }
+    : {
+        kind: "error",
+        error: { exitReason: "error", reason: "invalid driver completion event" },
+    };
+const errorOutcome = (event) => {
+    if (event.type === "error")
+        return { kind: "error", error: event.error };
+    const reason = event.type === "fail" ? event.reason : "run aborted";
+    return {
+        kind: "error",
+        error: { exitReason: "error", reason },
+        ...(event.type === "abort" ? { operationalFailure: { phase: "abort", reason } } : {}),
+    };
+};
+const traceLimitOutcome = (event) => {
+    const reason = event.type === "traceLimit" ? event.failure.reason : "run trace exceeded its limit";
+    return {
+        kind: "error",
+        error: { exitReason: "error", reason },
+        operationalFailure: { phase: "trace", reason },
+    };
+};
+const driverSessionMachine = setup({
+    types: {
+        context: {},
+        input: {},
+        events: {},
+        output: {},
+    },
+    actors: {
+        answer: fromPromise(({ input }) => input.effects.answer(input.interrupt)),
+        respond: fromPromise(({ input }) => input.effects.respond(input.interrupt, input.completed)),
+    },
+    guards: {
+        hasNoTerminal: ({ context }) => context.terminal === null,
+        hasDoneTerminal: ({ context }) => context.terminal?.kind === "done",
+        hasErrorTerminal: ({ context }) => context.terminal?.kind === "error",
+        hasTraceTerminal: ({ context }) => context.terminal?.kind === "error" && context.terminal.operationalFailure?.phase === "trace",
+        hasQueuedInterrupt: ({ context }) => context.queued.length > 0,
+    },
+    actions: {
+        beginInterrupt: assign({
+            current: ({ event }) => (event.type === "interrupt" ? event.pending : null),
+        }),
+        queueInterrupt: assign({
+            queued: ({ context, event }) => event.type === "interrupt" ? [...context.queued, event.pending] : context.queued,
+        }),
+        takeNextInterrupt: assign(({ context }) => ({
+            current: context.queued[0] ?? null,
+            queued: context.queued.slice(1),
+        })),
+        completeCurrentInterrupt: assign(({ context }) => {
+            context.current?.complete();
+            return { current: null, completedAnswer: null };
+        }),
+        releaseInterrupts: ({ context }) => {
+            context.current?.complete();
+            for (const pending of context.queued)
+                pending.complete();
+        },
+        recordProgress: ({ context, event }) => {
+            if (event.type === "progress")
+                context.effects.progress(event.progress);
+        },
+        recordDone: ({ context, event }) => {
+            context.effects.terminal(doneOutcome(event), event.type === "done" && event.recorded === true);
+        },
+        rememberDone: assign({
+            terminal: ({ event }) => doneOutcome(event),
+        }),
+        recordError: ({ context, event }) => {
+            context.effects.terminal(errorOutcome(event), "recorded" in event && event.recorded === true);
+        },
+        rememberError: assign({
+            terminal: ({ event }) => errorOutcome(event),
+        }),
+        recordTraceLimit: ({ context, event }) => {
+            context.effects.terminal(traceLimitOutcome(event), true);
+        },
+        rememberTraceLimit: assign({
+            terminal: ({ event }) => traceLimitOutcome(event),
+        }),
+        recordInteractionFailure: ({ context, event }) => {
+            if ("error" in event) {
+                context.effects.terminal(interactionFailure(event.error), event.error instanceof InteractionFailure && event.error.terminalRecorded);
+            }
+        },
+        rememberInteractionFailure: assign({
+            terminal: ({ event }) => "error" in event ? interactionFailure(event.error) : errorOutcome(event),
+        }),
+        rememberCompletedAnswer: assign({
+            completedAnswer: ({ event }) => "output" in event ? event.output : null,
+        }),
+    },
+}).createMachine({
+    id: "lux-driver-session",
+    context: ({ input }) => ({
+        effects: input.effects,
+        current: null,
+        queued: [],
+        terminal: null,
+        completedAnswer: null,
+    }),
+    initial: "waiting",
+    states: {
+        waiting: {
+            on: {
+                interrupt: { target: "answering", actions: "beginInterrupt" },
+                progress: { actions: "recordProgress" },
+                done: { target: "succeeded", actions: ["recordDone", "rememberDone"] },
+                error: { target: "failed", actions: ["recordError", "rememberError"] },
+                abort: { target: "failed", actions: ["recordError", "rememberError"] },
+                fail: { target: "failed", actions: ["recordError", "rememberError"] },
+                traceLimit: {
+                    target: "failed",
+                    actions: ["recordTraceLimit", "rememberTraceLimit"],
+                },
+            },
+        },
+        answering: {
+            invoke: {
+                src: "answer",
+                input: ({ context }) => {
+                    if (!context.current)
+                        throw new Error("driver session has no current interrupt");
+                    return { effects: context.effects, interrupt: context.current.interrupt };
+                },
+                onDone: [
+                    {
+                        guard: ({ context }) => context.terminal !== null,
+                        target: "selecting",
+                        actions: "completeCurrentInterrupt",
+                    },
+                    { target: "responding", actions: "rememberCompletedAnswer" },
+                ],
+                onError: [
+                    {
+                        guard: "hasTraceTerminal",
+                        target: "selecting",
+                        actions: "completeCurrentInterrupt",
+                    },
+                    {
+                        target: "failed",
+                        actions: ["recordInteractionFailure", "rememberInteractionFailure"],
+                    },
+                ],
+            },
+            on: {
+                interrupt: { actions: "queueInterrupt" },
+                progress: { actions: "recordProgress" },
+                done: {
+                    guard: "hasNoTerminal",
+                    actions: ["recordDone", "rememberDone"],
+                },
+                error: {
+                    guard: "hasNoTerminal",
+                    actions: ["recordError", "rememberError"],
+                },
+                abort: {
+                    guard: "hasNoTerminal",
+                    actions: ["recordError", "rememberError"],
+                },
+                fail: {
+                    guard: "hasNoTerminal",
+                    actions: ["recordError", "rememberError"],
+                },
+                traceLimit: {
+                    actions: ["recordTraceLimit", "rememberTraceLimit"],
+                },
+            },
+        },
+        responding: {
+            invoke: {
+                src: "respond",
+                input: ({ context }) => {
+                    if (!context.current || !context.completedAnswer) {
+                        throw new Error("driver session has no completed answer to send");
+                    }
+                    return {
+                        effects: context.effects,
+                        interrupt: context.current.interrupt,
+                        completed: context.completedAnswer,
+                    };
+                },
+                onDone: { target: "selecting", actions: "completeCurrentInterrupt" },
+                onError: [
+                    {
+                        guard: "hasTraceTerminal",
+                        target: "selecting",
+                        actions: "completeCurrentInterrupt",
+                    },
+                    {
+                        target: "failed",
+                        actions: ["recordInteractionFailure", "rememberInteractionFailure"],
+                    },
+                ],
+            },
+            on: {
+                interrupt: { actions: "queueInterrupt" },
+                progress: { actions: "recordProgress" },
+                done: {
+                    guard: "hasNoTerminal",
+                    actions: ["recordDone", "rememberDone"],
+                },
+                error: {
+                    guard: "hasNoTerminal",
+                    actions: ["recordError", "rememberError"],
+                },
+                abort: {
+                    guard: "hasNoTerminal",
+                    actions: ["recordError", "rememberError"],
+                },
+                fail: {
+                    guard: "hasNoTerminal",
+                    actions: ["recordError", "rememberError"],
+                },
+                traceLimit: {
+                    actions: ["recordTraceLimit", "rememberTraceLimit"],
+                },
+            },
+        },
+        selecting: {
+            always: [
+                { guard: "hasDoneTerminal", target: "succeeded" },
+                { guard: "hasErrorTerminal", target: "failed" },
+                {
+                    guard: "hasQueuedInterrupt",
+                    target: "answering",
+                    actions: "takeNextInterrupt",
+                },
+                { target: "waiting" },
+            ],
+        },
+        succeeded: { type: "final", entry: "releaseInterrupts" },
+        failed: { type: "final", entry: "releaseInterrupts" },
+    },
+    output: ({ context }) => context.terminal ?? {
+        kind: "error",
+        error: { exitReason: "error", reason: "driver session ended without a terminal event" },
+    },
+});
+const messageOf = (error) => error instanceof Error ? error.message : String(error);
+const interactionError = (phase, reason) => ({
+    kind: "error",
+    error: { exitReason: "error", reason },
+    operationalFailure: { phase, reason },
+});
+export const createDriverSession = (options) => {
+    const { driver, answerer, context, runDir, interruptCounts, history, abortSignal, onToolCall } = options;
+    const recordedInteractionFailure = (phase, reason) => {
+        const outcome = interactionError(phase, reason);
+        const failure = runDir.events.append({
+            type: "error",
+            exitReason: "error",
+            reason,
+            ts: Date.now(),
+        });
+        return failure
+            ? new InteractionFailure(traceLimitOutcome({ type: "traceLimit", failure }), true)
+            : new InteractionFailure(outcome, true);
+    };
+    const rejectedTraceEvent = (failure) => new InteractionFailure(traceLimitOutcome({ type: "traceLimit", failure }), true);
+    const effects = {
+        answer: async (interrupt) => {
+            const failure = runDir.events.append({ type: "interrupt", ...interrupt, ts: Date.now() });
+            if (failure)
+                throw rejectedTraceEvent(failure);
+            interruptCounts[interrupt.kind]++;
+            const startedAt = Date.now();
+            try {
+                const answer = AnswerSchema.parse(await answerer.answer(interrupt, context));
+                if (answer.kind !== interrupt.kind || answer.id !== interrupt.id) {
+                    throw new Error(`answer correlation mismatch: expected ${interrupt.kind} interrupt '${interrupt.id}', received ${answer.kind} answer '${answer.id}'`);
+                }
+                return { answer, durationMs: Date.now() - startedAt };
+            }
+            catch (error) {
+                const reason = `answerer failed: ${messageOf(error)}`;
+                throw recordedInteractionFailure("answerer", reason);
+            }
+        },
+        respond: async (interrupt, completed) => {
+            const failure = runDir.events.append({
+                type: "responded",
+                ...completed.answer,
+                ts: Date.now(),
+            });
+            if (failure)
+                throw rejectedTraceEvent(failure);
+            history.push({ interrupt, ...completed });
+            try {
+                await driver.respond(completed.answer);
+            }
+            catch (error) {
+                const reason = `driver respond failed: ${messageOf(error)}`;
+                throw recordedInteractionFailure("driver-transport", reason);
+            }
+        },
+        progress: (progress) => {
+            if (runDir.events.append({ type: "progress", ...progress }))
+                return;
+            if (progress.kind === "tool-call")
+                onToolCall();
+        },
+        terminal: (terminalOutcome, alreadyRecorded) => {
+            if (alreadyRecorded)
+                return;
+            if (terminalOutcome.kind === "done") {
+                runDir.events.append({ type: "done", ...terminalOutcome.done, ts: Date.now() });
+            }
+            else {
+                runDir.events.append({ type: "error", ...terminalOutcome.error, ts: Date.now() });
+            }
+        },
+    };
+    const actor = createActor(driverSessionMachine, { input: { effects } });
+    const onInterrupt = (interrupt) => {
+        if (actor.getSnapshot().status === "done")
+            return Promise.resolve();
+        return new Promise((complete) => {
+            actor.send({ type: "interrupt", pending: { interrupt, complete } });
+        });
+    };
+    const onProgress = (progress) => {
+        if (actor.getSnapshot().status === "active")
+            actor.send({ type: "progress", progress });
+    };
+    const sendRecordedTerminal = (event, terminalEvent) => {
+        if (actor.getSnapshot().status !== "active")
+            return;
+        if (runDir.events.append(event))
+            return;
+        actor.send({ ...terminalEvent, recorded: true });
+    };
+    const onDone = (done) => {
+        sendRecordedTerminal({ type: "done", ...done, ts: Date.now() }, { type: "done", done });
+    };
+    const onError = (error) => {
+        sendRecordedTerminal({ type: "error", ...error, ts: Date.now() }, { type: "error", error });
+    };
+    const onAbort = () => {
+        sendRecordedTerminal({ type: "error", exitReason: "error", reason: "run aborted", ts: Date.now() }, { type: "abort" });
+    };
+    const onTraceLimit = (failure) => {
+        if (actor.getSnapshot().status === "active")
+            actor.send({ type: "traceLimit", failure });
+    };
+    let stopListeningForTraceLimit = () => { };
+    const unbind = () => {
+        driver.off("interrupt", onInterrupt);
+        driver.off("progress", onProgress);
+        driver.off("done", onDone);
+        driver.off("error", onError);
+        abortSignal?.removeEventListener("abort", onAbort);
+        stopListeningForTraceLimit();
+    };
+    driver.on("interrupt", onInterrupt);
+    driver.on("progress", onProgress);
+    driver.on("done", onDone);
+    driver.on("error", onError);
+    if (!abortSignal?.aborted)
+        abortSignal?.addEventListener("abort", onAbort, { once: true });
+    actor.start();
+    stopListeningForTraceLimit = runDir.events.onLimitExceeded(onTraceLimit);
+    if (abortSignal?.aborted)
+        onAbort();
+    const outcome = toPromise(actor).finally(unbind);
+    return {
+        outcome,
+        fail: (reason) => {
+            sendRecordedTerminal({ type: "error", exitReason: "error", reason, ts: Date.now() }, { type: "fail", reason });
+        },
+    };
+};
+// Internal export for transition-level tests.
+export { driverSessionMachine };
+//# sourceMappingURL=driver-session.js.map

package/lib/orchestrator/driver-session.js.map

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

package/lib/orchestrator/evaluator-identity.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Hash the exact Lux source/build tree executing the evaluation. Package
+ * versions alone are insufficient in development, where evaluator semantics
+ * can change without a release bump.
+ */
+export declare const evaluatorImplementationHash: (distributionRoot?: string) => Promise<string>;
+//# sourceMappingURL=evaluator-identity.d.ts.map

package/lib/orchestrator/evaluator-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator-identity.d.ts","sourceRoot":"","sources":["../../src/orchestrator/evaluator-identity.ts"],"names":[],"mappings":"AAwBA;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,sBACpB,MAAM,KACvB,OAAO,CAAC,MAAM,CAahB,CAAC"}

package/lib/orchestrator/evaluator-identity.js

@@ -0,0 +1,42 @@
+import { readFile } from "node:fs/promises";
+import { dirname, extname, join, relative, resolve, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+import { contentHash, valueHash } from "../core/index.js";
+import { walkAuthoredFiles } from "./fs-read.js";
+const currentDistributionRoot = () => {
+    const modulePath = fileURLToPath(import.meta.url);
+    const parent = dirname(dirname(modulePath));
+    const leaf = parent.split(sep).at(-1);
+    if (leaf !== "src" && leaf !== "lib") {
+        throw new Error(`cannot locate Lux evaluator distribution from ${modulePath}`);
+    }
+    return parent;
+};
+const isRuntimeImplementation = (path) => {
+    if (path.endsWith(".test.ts") || path.endsWith(".test.js"))
+        return false;
+    if (path.endsWith("test-helpers.ts") || path.endsWith("test-helpers.js"))
+        return false;
+    if (path.split(sep).includes("fixtures"))
+        return false;
+    const extension = extname(path);
+    return extension === ".ts" || extension === ".js" || extension === ".json";
+};
+/**
+ * Hash the exact Lux source/build tree executing the evaluation. Package
+ * versions alone are insufficient in development, where evaluator semantics
+ * can change without a release bump.
+ */
+export const evaluatorImplementationHash = async (distributionRoot = currentDistributionRoot()) => {
+    const root = resolve(distributionRoot);
+    const files = (await walkAuthoredFiles(root)).filter(isRuntimeImplementation);
+    if (files.length === 0) {
+        throw new Error(`Lux evaluator distribution has no implementation files: ${root}`);
+    }
+    const evidence = await Promise.all(files.map(async (path) => ({
+        path: relative(root, join(root, path)).split(sep).join("/"),
+        hash: contentHash(await readFile(join(root, path))),
+    })));
+    return valueHash(evidence);
+};
+//# sourceMappingURL=evaluator-identity.js.map

package/lib/orchestrator/evaluator-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator-identity.js","sourceRoot":"","sources":["../../src/orchestrator/evaluator-identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,uBAAuB,GAAG,GAAW,EAAE;IAC3C,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,iDAAiD,UAAU,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAAC,IAAY,EAAW,EAAE;IACxD,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IACzE,IAAI,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAAE,OAAO,KAAK,CAAC;IACvF,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IACvD,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,SAAS,KAAK,KAAK,IAAI,SAAS,KAAK,KAAK,IAAI,SAAS,KAAK,OAAO,CAAC;AAC7E,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,KAAK,EAC9C,gBAAgB,GAAW,uBAAuB,EAAE,EACnC,EAAE;IACnB,MAAM,IAAI,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,CAAC,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;IAC9E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,2DAA2D,IAAI,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACzB,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAC3D,IAAI,EAAE,WAAW,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;KACpD,CAAC,CAAC,CACJ,CAAC;IACF,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC7B,CAAC,CAAC"}