@usine/executor 0.0.1 → 0.2.0

package/dist/run-host-session.js

@@ -0,0 +1,241 @@
+import * as AttemptChannel from "@usine/core/attempt/channel";
+import { AgentFailure, AttemptFailure, InfraFailure } from "@usine/core/attempt/failure";
+import { AttemptId } from "@usine/core/attempt";
+import { StepResult } from "@usine/core/step/result";
+import { Cause, DateTime, Effect, Fiber, Option, Queue, Ref, Result, Schema, Scope, Stream, } from "effect";
+import { ExecutorError, ExecutorOperationError } from "./executor.js";
+import { invalidFrameDiagnostic, invalidFrameMessage } from "./invalid-frame.js";
+const STDERR_TAIL_BYTES = 4_096;
+/** Sending SIGKILL is its own bounded step, unrelated to the interrupt grace. */
+const KILL_TIMEOUT = "5 seconds";
+const inputFrameToJson = Schema.encodeSync(AttemptChannel.InputFrameFromJson);
+/** Rejects a frame with any unknown key; the protocol is strict by contract. */
+const decodeOutboundEnvelope = (line) => Schema.decodeUnknownEffect(AttemptChannel.OutboundEnvelopeFromJson)(line, {
+    onExcessProperty: "error",
+});
+const isExecutorError = Schema.is(ExecutorError);
+const encoder = new TextEncoder();
+const frame = (input) => encoder.encode(`${inputFrameToJson(input)}\n`);
+const infrastructureFailure = (message, cause) => new InfraFailure({ message, cause });
+const violationFailure = (violation) => infrastructureFailure(violation.message, new Error(violation.detail));
+const cancelError = (attemptId, cause) => new ExecutorOperationError({
+    operation: "cancel",
+    message: `Could not cancel Attempt ${attemptId}`,
+    cause,
+});
+/** The run-host byte-channel session every process-backed Executor shares. */
+export const runHostSessionFor = Effect.fn("RunHostSession.for")(function* (options) {
+    const activeAttempts = yield* Ref.make(new Map());
+    const hardKill = Effect.fn("RunHostSession.hardKill")(function* (attemptId, active, reason) {
+        yield* Effect.logWarning("Hard-killing the run host", {
+            attemptId,
+            worker: active.worker,
+            host: active.host,
+            reason,
+        });
+        // The kill failure is logged, never propagated, so it cannot mask the
+        // failure that forced the hard kill.
+        yield* active.handle.kill({ killSignal: "SIGKILL" }).pipe(Effect.timeout(KILL_TIMEOUT), Effect.tapError((error) => Effect.logError("Run-host hard kill failed", {
+            attemptId,
+            worker: active.worker,
+            host: active.host,
+            reason,
+            message: String(error),
+        })), Effect.ignore);
+        yield* Effect.logWarning("Run-host hard-kill signal sent", {
+            attemptId,
+            worker: active.worker,
+            host: active.host,
+            reason,
+        });
+    });
+    const cancelActive = Effect.fn("RunHostSession.cancelActive")(function* (attemptId, active) {
+        return yield* Effect.uninterruptible(Effect.gen(function* () {
+            yield* Effect.annotateCurrentSpan({
+                attemptId,
+                worker: active.worker,
+                host: active.host,
+            });
+            const first = yield* Ref.modify(active.cancelStarted, (started) => [!started, true]);
+            if (!first) {
+                yield* Effect.logDebug("Attempt cancellation was already started", {
+                    attemptId,
+                    worker: active.worker,
+                    host: active.host,
+                });
+                return;
+            }
+            yield* Effect.logInfo("Sending the interrupt envelope", {
+                attemptId,
+                worker: active.worker,
+                host: active.host,
+            });
+            const sequence = yield* Ref.getAndUpdate(active.sequence, (value) => value + 1);
+            const envelope = new AttemptChannel.InboundEnvelope({
+                version: AttemptChannel.PROTOCOL_VERSION,
+                attemptId,
+                sequence: AttemptChannel.Sequence.make(sequence),
+                sentAt: yield* DateTime.now,
+                payload: new AttemptChannel.Interrupt(),
+            });
+            const delivered = yield* active.io.append("inbound", envelope).pipe(Effect.andThen(Queue.offer(active.input, frame(envelope))), 
+            // The transcript store sits outside the process adapter and may be
+            // parked; the bound keeps the uninterruptible cancellation handshake
+            // moving on to the hard kill.
+            Effect.timeoutOption(options.interruptGrace), Effect.result);
+            if (Result.isFailure(delivered)) {
+                yield* Effect.logWarning("Interrupt could not be delivered", {
+                    attemptId,
+                    worker: active.worker,
+                    host: active.host,
+                    message: String(delivered.failure),
+                });
+                yield* hardKill(attemptId, active, "delivery-failed");
+                return yield* delivered.failure;
+            }
+            if (Option.isNone(delivered.success)) {
+                const cause = new Error("interrupt delivery exceeded the cancellation grace");
+                yield* Effect.logWarning("Interrupt delivery timed out", {
+                    attemptId,
+                    worker: active.worker,
+                    host: active.host,
+                });
+                yield* hardKill(attemptId, active, "delivery-failed");
+                return yield* cancelError(attemptId, cause);
+            }
+            const completed = yield* active.handle.exitCode.pipe(Effect.timeoutOption(options.interruptGrace));
+            if (Option.isNone(completed)) {
+                yield* Effect.logWarning("Interrupt grace expired", {
+                    attemptId,
+                    worker: active.worker,
+                    host: active.host,
+                });
+                yield* hardKill(attemptId, active, "grace-expired");
+            }
+            else {
+                yield* Effect.logInfo("Run host stopped within the interrupt grace", {
+                    attemptId,
+                    worker: active.worker,
+                    host: active.host,
+                });
+            }
+        }));
+    });
+    const cancel = Effect.fn("RunHostSession.cancel")(function* (attemptId) {
+        const active = (yield* Ref.get(activeAttempts)).get(attemptId);
+        if (active === undefined) {
+            yield* Effect.logDebug("Attempt cancellation was a no-op", { attemptId });
+            return;
+        }
+        yield* cancelActive(attemptId, active).pipe(Effect.mapError((cause) => isExecutorError(cause) ? cause : cancelError(attemptId, cause)));
+    });
+    const launch = Effect.fn("RunHostSession.launch")(function* (prepared, io, spawn) {
+        const attemptId = prepared.spec.attemptId;
+        yield* Effect.annotateCurrentSpan({ attemptId, worker: prepared.worker });
+        const execute = Effect.scoped(Effect.gen(function* () {
+            const input = yield* Queue.make();
+            const { handle, host, scrub } = yield* spawn(input);
+            yield* Effect.annotateCurrentSpan({ host });
+            const active = {
+                cancelStarted: yield* Ref.make(false),
+                handle,
+                host,
+                input,
+                io,
+                sequence: yield* Ref.make(1),
+                worker: prepared.worker,
+            };
+            yield* Ref.update(activeAttempts, (current) => {
+                const next = new Map(current);
+                next.set(attemptId, active);
+                return next;
+            });
+            yield* Queue.offer(input, frame(new AttemptChannel.Start({
+                version: AttemptChannel.PROTOCOL_VERSION,
+                spec: prepared.spec,
+            })));
+            const stderr = yield* Ref.make("");
+            const stderrFiber = yield* handle.stderr.pipe(Stream.decodeText(), Stream.runForEach((chunk) => Ref.update(stderr, (current) => `${current}${chunk}`.slice(-STDERR_TAIL_BYTES))), Effect.forkChild);
+            const terminal = yield* Ref.make(Option.none());
+            const progress = yield* Ref.make(AttemptChannel.initialProgress);
+            yield* handle.stdout.pipe(Stream.decodeText(), Stream.splitLines, Stream.runForEach((rawLine) => Effect.gen(function* () {
+                // Frames include raw tool inputs and outputs; scrub the credential
+                // from the line before it is decoded or persisted.
+                const line = scrub(rawLine);
+                const decoded = yield* decodeOutboundEnvelope(line).pipe(Effect.result);
+                if (Result.isFailure(decoded)) {
+                    const diagnostic = invalidFrameDiagnostic(line, decoded.failure);
+                    if (diagnostic.source === "effect-log") {
+                        yield* Effect.logWarning("Dropped a run-host diagnostic from protocol output", {
+                            attemptId,
+                            ...diagnostic,
+                        });
+                        return;
+                    }
+                    yield* Effect.logError("Run host emitted an invalid frame", {
+                        attemptId,
+                        ...diagnostic,
+                    });
+                    return yield* infrastructureFailure(invalidFrameMessage(diagnostic), decoded.failure);
+                }
+                const envelope = decoded.success;
+                const admitted = AttemptChannel.admit(yield* Ref.get(progress), attemptId, envelope);
+                if (Result.isFailure(admitted))
+                    return yield* violationFailure(admitted.failure);
+                yield* Ref.set(progress, admitted.success);
+                yield* io.append("outbound", envelope);
+                const payload = envelope.payload;
+                if (payload._tag === "Final" ||
+                    payload._tag === "Failed" ||
+                    payload._tag === "Interrupted") {
+                    yield* Effect.logInfo("Run host reached its terminal envelope", {
+                        attemptId,
+                        terminal: payload._tag,
+                        sequence: envelope.sequence,
+                    });
+                    yield* Ref.set(terminal, Option.some(payload));
+                    yield* Queue.end(input);
+                }
+            })), Effect.mapError((error) => Schema.is(AttemptFailure)(error)
+                ? error
+                : infrastructureFailure("The run-host channel failed", error)));
+            const exitCode = yield* handle.exitCode.pipe(Effect.mapError((cause) => infrastructureFailure("Could not read the run-host exit code", cause)));
+            yield* Fiber.join(stderrFiber).pipe(Effect.tapError((error) => Effect.logWarning("Could not finish reading run-host stderr", {
+                attemptId,
+                message: String(error),
+            })), Effect.ignore);
+            yield* Effect.logInfo("Run host exited", {
+                attemptId,
+                exitCode: String(exitCode),
+            });
+            const ended = yield* Ref.get(terminal);
+            const errorOutput = scrub((yield* Ref.get(stderr)).trim());
+            if (Option.isNone(ended)) {
+                return yield* infrastructureFailure("The run-host channel closed without a final envelope", new Error(`run host exited with code ${String(exitCode)}: ${errorOutput}`));
+            }
+            if (ended.value._tag === "Failed")
+                return yield* ended.value.failure;
+            if (ended.value._tag === "Interrupted") {
+                return yield* new AgentFailure({
+                    message: "The run host confirmed the interrupt and stopped",
+                });
+            }
+            if (Number(exitCode) !== 0) {
+                return yield* infrastructureFailure(`The run host exited with code ${String(exitCode)} after its final envelope`, new Error(errorOutput));
+            }
+            return ended.value.result;
+        }).pipe(Effect.onInterrupt(() => cancel(attemptId).pipe(Effect.tapError((error) => Effect.logWarning("Cancel-on-interrupt failed", {
+            attemptId,
+            message: String(error),
+        })), Effect.ignore))));
+        return yield* execute.pipe(Effect.ensuring(Ref.update(activeAttempts, (current) => {
+            const next = new Map(current);
+            next.delete(attemptId);
+            return next;
+        })), Effect.mapError((error) => Schema.is(AttemptFailure)(error)
+            ? error
+            : infrastructureFailure("The executor failed while running the run host", error)));
+    });
+    return { cancel, launch };
+});
+//# sourceMappingURL=run-host-session.js.map

package/dist/run-host-session.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@usine/executor",
-  "version": "0.0.1",
-  "description": "The usine executor seam: the five-operation worker contract, with local and exe.dev executors.",
+  "version": "0.2.0",
+  "description": "The usine scoped Worker contract with local and exe.dev adapters.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -15,15 +15,29 @@
   "sideEffects": false,
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
+      "types": "./dist/executor.d.ts",
+      "default": "./dist/executor.js"
+    },
+    "./exe-dev": {
+      "types": "./dist/exe-dev/exe-dev.d.ts",
+      "default": "./dist/exe-dev/exe-dev.js"
+    },
+    "./local": {
+      "types": "./dist/local/local.d.ts",
+      "default": "./dist/local/local.js"
     }
   },
   "publishConfig": {
     "access": "public"
   },
+  "dependencies": {
+    "@usine/core": "0.2.0"
+  },
   "devDependencies": {
+    "@effect/vitest": "4.0.0-rc.111",
+    "effect": "4.0.0-rc.111",
     "typescript": "7.0.2",
+    "vitest": "4.1.11",
     "@usine/tsconfig": "0.0.0"
   },
   "peerDependencies": {
@@ -33,6 +47,8 @@
     "node": ">=22"
   },
   "scripts": {
-    "build": "tsc -b"
+    "build": "tsc -b",
+    "check": "tsc -p tsconfig.check.json",
+    "test": "vitest run"
   }
 }

package/dist/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * @usine/executor — The usine executor seam: the five-operation worker contract, with local and exe.dev executors.
- *
- * Not implemented yet: this 0.0.x release reserves the block's seam while the
- * engine grows.
- */
-export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC"}

package/dist/index.js

@@ -1,8 +0,0 @@
-/**
- * @usine/executor — The usine executor seam: the five-operation worker contract, with local and exe.dev executors.
- *
- * Not implemented yet: this 0.0.x release reserves the block's seam while the
- * engine grows.
- */
-export {};
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC"}