@usine/executor 0.1.0 → 0.2.0

package/dist/executor.d.ts

@@ -0,0 +1,118 @@
+import { Agent } from "@usine/core/agent";
+import { BrainSpec } from "@usine/core/agent/brain";
+import { AttemptId } from "@usine/core/attempt";
+import * as AttemptChannel from "@usine/core/attempt/channel";
+import { AttemptFailure } from "@usine/core/attempt/failure";
+import { RepositoryName } from "@usine/core/repository";
+import { WorkerName, WorkerKind } from "@usine/core/worker";
+import { StepResult } from "@usine/core/step/result";
+import { Context, Effect, Redacted, Schema, Scope } from "effect";
+/** The Worker operation that failed during readiness checks or an Attempt's lifecycle. */
+export declare const ExecutorOperation: Schema.Literals<readonly ["preflight", "prepare", "launch", "cancel", "cleanup"]>;
+export type ExecutorOperation = typeof ExecutorOperation.Type;
+/** A prerequisite a Worker must satisfy before it can accept Attempts. */
+export declare const WorkerCapability: Schema.Literals<readonly ["machine", "toolchain", "run-host", "harness-login", "credentials"]>;
+export type WorkerCapability = typeof WorkerCapability.Type;
+declare const ExecutorOperationError_base: Schema.Class<ExecutorOperationError, Schema.TaggedStruct<"ExecutorOperationError", {
+    readonly operation: Schema.Literals<readonly ["preflight", "prepare", "launch", "cancel", "cleanup"]>;
+    readonly message: Schema.NonEmptyString;
+    readonly cause: Schema.Defect;
+}>, import("effect/Cause").YieldableError>;
+/** A Worker operation failed before its requested work completed. */
+export declare class ExecutorOperationError extends ExecutorOperationError_base {
+}
+declare const CredentialUnavailableError_base: Schema.Class<CredentialUnavailableError, Schema.TaggedStruct<"CredentialUnavailableError", {
+    readonly repository: Schema.brand<Schema.String, "RepositoryName">;
+    readonly message: Schema.NonEmptyString;
+    readonly cause: Schema.Defect;
+}>, import("effect/Cause").YieldableError>;
+/** A Worker could not obtain access to the repository assigned to an Attempt. */
+export declare class CredentialUnavailableError extends CredentialUnavailableError_base {
+}
+declare const WorkerCapabilityError_base: Schema.Class<WorkerCapabilityError, Schema.TaggedStruct<"WorkerCapabilityError", {
+    readonly worker: Schema.brand<Schema.String, "WorkerName">;
+    readonly capability: Schema.Literals<readonly ["machine", "toolchain", "run-host", "harness-login", "credentials"]>;
+    readonly message: Schema.NonEmptyString;
+    readonly cause: Schema.Defect;
+}>, import("effect/Cause").YieldableError>;
+/** A verify-only preflight found a Worker capability missing or incompatible. */
+export declare class WorkerCapabilityError extends WorkerCapabilityError_base {
+}
+/** A readiness, access, or lifecycle failure reported by a Worker operation. */
+export declare const ExecutorError: Schema.Union<readonly [typeof ExecutorOperationError, typeof CredentialUnavailableError, typeof WorkerCapabilityError]>;
+export type ExecutorError = typeof ExecutorError.Type;
+/** Logs every preflight refusal so a missing capability is explainable from logs alone. */
+export declare const logPreflightFailure: <A, R>(effect: Effect.Effect<A, ExecutorError, R>) => Effect.Effect<A, ExecutorError, R>;
+/** Process command for a one-shot run host or a preflight capability probe. */
+export interface RunHostCommand {
+    readonly command: string;
+    readonly args: ReadonlyArray<string>;
+}
+declare const CheckoutRequest_base: Schema.Class<CheckoutRequest, Schema.Struct<{
+    readonly attemptId: Schema.brand<Schema.NonEmptyString, "AttemptId">;
+    readonly worker: Schema.brand<Schema.String, "WorkerName">;
+    readonly repository: Schema.brand<Schema.String, "RepositoryName">;
+    readonly revision: Schema.brand<Schema.String, "RepositoryRevision">;
+    readonly payload: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    readonly task: Schema.brand<Schema.String, "AttemptTask">;
+    readonly agent: typeof Agent;
+    readonly parentModel: Schema.Option<Schema.brand<Schema.String, "ModelId">>;
+    readonly maxChildren: Schema.brand<Schema.Int, "ChildSessionBudget">;
+    /** Maximum minutes of live run-host execution; preparation and resource cleanup are outside this budget. */
+    readonly maxAttemptMinutes: Schema.Int;
+    readonly parentEffort: Schema.Literals<readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"]>;
+}>, {}>;
+/** The repository, revision, and Agent task assigned to a Worker for one fresh Attempt checkout. */
+export declare class CheckoutRequest extends CheckoutRequest_base {
+}
+/** One Attempt's disposable checkout directory. */
+export declare const WorktreePath: Schema.brand<Schema.NonEmptyString, "WorktreePath">;
+export type WorktreePath = typeof WorktreePath.Type;
+declare const AttemptWorkspace_base: Schema.Class<AttemptWorkspace, Schema.Struct<{
+    readonly worker: Schema.brand<Schema.String, "WorkerName">;
+    readonly spec: typeof AttemptChannel.RunSpec;
+    readonly worktree: Schema.brand<Schema.NonEmptyString, "WorktreePath">;
+}>, {}>;
+/** The serializable location and RunSpec of an Attempt checkout. Owning this record does not grant access to live resources or credentials. */
+export declare class AttemptWorkspace extends AttemptWorkspace_base {
+}
+/**
+ * One prepared Attempt with a scoped checkout and repository access. Use it within
+ * the scope that prepared it. Closing that scope stops any active run host before
+ * removing the checkout and releasing credentials, including when launch never starts.
+ */
+export interface PreparedAttempt {
+    /** Checkout metadata suitable for inspection or serialization; contains no credentials. */
+    readonly workspace: AttemptWorkspace;
+    /**
+     * Runs this Attempt once, recording channel activity through `io`. Completion,
+     * failure, or interruption releases its resources before returning. Cleanup
+     * failures are logged without replacing the agent's outcome or retrying its work.
+     * Reusing an Attempt after launch or release fails with an infrastructure error.
+     */
+    readonly launch: (io: AttemptChannel.Sink) => Effect.Effect<StepResult, AttemptFailure>;
+}
+declare const CredentialProvider_base: Context.ServiceClass<CredentialProvider, "@usine/executor/CredentialProvider", {
+    readonly issue: (repository: RepositoryName, attemptId: AttemptId) => Effect.Effect<Redacted.Redacted<string>, CredentialUnavailableError>;
+}>;
+/** Mints exactly one repository-scoped credential for each prepared Attempt. */
+export declare class CredentialProvider extends CredentialProvider_base {
+}
+declare const Executor_base: Context.ServiceClass<Executor, "@usine/executor/Executor", {
+    readonly kind: WorkerKind;
+    /** Verifies Git, the run host, and each rostered brain in the Worker environment; never installs tools or logs in. */
+    readonly preflight: (worker: WorkerName, brains: ReadonlyArray<BrainSpec>) => Effect.Effect<void, ExecutorError>;
+    /**
+     * Verifies the assigned brain before acquiring a fresh Attempt in the caller's scope. Clone, fetch, and lock waits
+     * remain interruptible; partial preparation releases everything already acquired
+     * before reporting failure. Each request must identify a fresh Attempt.
+     */
+    readonly prepare: (request: CheckoutRequest) => Effect.Effect<PreparedAttempt, ExecutorError, Scope.Scope>;
+    /** Requests an active Attempt to stop, allowing a grace period before forcing termination. */
+    readonly cancel: (attemptId: AttemptId) => Effect.Effect<void, ExecutorError>;
+}>;
+/** Prepares isolated checkouts, runs Attempts on a Worker, and releases their resources (ADR 0006). */
+export declare class Executor extends Executor_base {
+}
+export {};
+//# sourceMappingURL=executor.d.ts.map

package/dist/executor.d.ts.map

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

package/dist/executor.js

@@ -0,0 +1,98 @@
+import { Agent } from "@usine/core/agent";
+import { BrainSpec, Effort, ModelId } from "@usine/core/agent/brain";
+import { ChildSessionBudget } from "@usine/core/agent/session";
+import { AttemptTask, AttemptId } from "@usine/core/attempt";
+import * as AttemptChannel from "@usine/core/attempt/channel";
+import { AttemptFailure } from "@usine/core/attempt/failure";
+import { RepositoryName, RepositoryRevision } from "@usine/core/repository";
+import { WorkerName, WorkerKind } from "@usine/core/worker";
+import { StepResult } from "@usine/core/step/result";
+import { Context, Effect, Redacted, Schema, Scope } from "effect";
+/** The Worker operation that failed during readiness checks or an Attempt's lifecycle. */
+export const ExecutorOperation = Schema.Literals([
+    "preflight",
+    "prepare",
+    "launch",
+    "cancel",
+    "cleanup",
+]);
+/** A prerequisite a Worker must satisfy before it can accept Attempts. */
+export const WorkerCapability = Schema.Literals([
+    "machine",
+    "toolchain",
+    "run-host",
+    "harness-login",
+    "credentials",
+]);
+/** A Worker operation failed before its requested work completed. */
+export class ExecutorOperationError extends Schema.TaggedError("@usine/executor/ExecutorOperationError")("ExecutorOperationError", {
+    operation: ExecutorOperation,
+    message: Schema.NonEmptyString,
+    cause: Schema.Defect(),
+}) {
+}
+/** A Worker could not obtain access to the repository assigned to an Attempt. */
+export class CredentialUnavailableError extends Schema.TaggedError("@usine/executor/CredentialUnavailableError")("CredentialUnavailableError", {
+    repository: RepositoryName,
+    message: Schema.NonEmptyString,
+    cause: Schema.Defect(),
+}) {
+}
+/** A verify-only preflight found a Worker capability missing or incompatible. */
+export class WorkerCapabilityError extends Schema.TaggedError("@usine/executor/WorkerCapabilityError")("WorkerCapabilityError", {
+    worker: WorkerName,
+    capability: WorkerCapability,
+    message: Schema.NonEmptyString,
+    cause: Schema.Defect(),
+}) {
+}
+/** A readiness, access, or lifecycle failure reported by a Worker operation. */
+export const ExecutorError = Schema.Union([
+    ExecutorOperationError,
+    CredentialUnavailableError,
+    WorkerCapabilityError,
+]);
+/** Logs every preflight refusal so a missing capability is explainable from logs alone. */
+export const logPreflightFailure = (effect) => Effect.tapError(effect, (error) => error instanceof WorkerCapabilityError
+    ? Effect.logError("Worker preflight failed", {
+        error: error._tag,
+        message: error.message,
+        worker: error.worker,
+        capability: error.capability,
+    })
+    : Effect.logError("Worker preflight failed", {
+        error: error._tag,
+        message: error.message,
+    }));
+/** The repository, revision, and Agent task assigned to a Worker for one fresh Attempt checkout. */
+export class CheckoutRequest extends Schema.Class("@usine/executor/CheckoutRequest")({
+    attemptId: AttemptId,
+    worker: WorkerName,
+    repository: RepositoryName,
+    revision: RepositoryRevision,
+    payload: Schema.Json,
+    task: AttemptTask,
+    agent: Agent,
+    parentModel: Schema.Option(ModelId),
+    maxChildren: ChildSessionBudget,
+    /** Maximum minutes of live run-host execution; preparation and resource cleanup are outside this budget. */
+    maxAttemptMinutes: Schema.Int.check(Schema.isGreaterThan(0)),
+    parentEffort: Effort,
+}) {
+}
+/** One Attempt's disposable checkout directory. */
+export const WorktreePath = Schema.NonEmptyString.pipe(Schema.brand("WorktreePath"));
+/** The serializable location and RunSpec of an Attempt checkout. Owning this record does not grant access to live resources or credentials. */
+export class AttemptWorkspace extends Schema.Class("@usine/executor/AttemptWorkspace")({
+    worker: WorkerName,
+    spec: AttemptChannel.RunSpec,
+    worktree: WorktreePath,
+}) {
+}
+/** Mints exactly one repository-scoped credential for each prepared Attempt. */
+export class CredentialProvider extends Context.Service()("@usine/executor/CredentialProvider") {
+}
+/** Prepares isolated checkouts, runs Attempts on a Worker, and releases their resources (ADR 0006). */
+export class Executor extends Context.Service()("@usine/executor/Executor") {
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

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

package/dist/harness-preflight.d.ts

@@ -0,0 +1,6 @@
+import { BrainSpec } from "@usine/core/agent/brain";
+import { Effect } from "effect";
+import { ExecutorOperationError, type RunHostCommand, WorkerCapabilityError } from "./executor.ts";
+/** Uses the installed run host so both adapters check the same worker-side harness contract. */
+export declare const verifyHarnesses: (worker: string & import("effect/Brand").Brand<"WorkerName">, brains: readonly BrainSpec[], runHost: RunHostCommand, execute: (command: string, args: ReadonlyArray<string>) => Effect.Effect<string, ExecutorOperationError>) => Effect.Effect<undefined, import("./executor.ts").CredentialUnavailableError | ExecutorOperationError | WorkerCapabilityError, never>;
+//# sourceMappingURL=harness-preflight.d.ts.map

package/dist/harness-preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-preflight.d.ts","sourceRoot":"","sources":["../src/harness-preflight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAGpD,OAAO,EAAgB,MAAM,EAAU,MAAM,QAAQ,CAAC;AACtD,OAAO,EAEL,sBAAsB,EACtB,KAAK,cAAc,EACnB,qBAAqB,EACtB,MAAM,eAAe,CAAC;AAEvB,gGAAgG;AAChG,eAAO,MAAM,eAAe,0IAKf,MAAM,QACT,aAAa,CAAC,MAAM,CAAC,KACxB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,yIA2D7B,CAAC"}

package/dist/harness-preflight.js

@@ -0,0 +1,50 @@
+import { BrainSpec } from "@usine/core/agent/brain";
+import { HarnessReadiness } from "@usine/core/agent/capability";
+import { Array as Arr, Effect, Schema } from "effect";
+import { logPreflightFailure, ExecutorOperationError, WorkerCapabilityError, } from "./executor.js";
+/** Uses the installed run host so both adapters check the same worker-side harness contract. */
+export const verifyHarnesses = Effect.fn("Executor.verifyHarnesses")(function* (worker, brains, runHost, execute) {
+    yield* Effect.annotateCurrentSpan({ worker });
+    const distinct = Arr.dedupe(brains);
+    for (const brain of distinct) {
+        // Only a worker's readiness report proves a capability gap. Transport
+        // failures and timeouts remain infrastructure failures eligible for retry.
+        const response = yield* execute(runHost.command, [
+            ...runHost.args,
+            "--preflight",
+            Schema.encodeSync(Schema.fromJsonString(BrainSpec))(brain),
+        ]).pipe(Effect.timeout("75 seconds"), Effect.catchTag("TimeoutError", (cause) => new ExecutorOperationError({
+            operation: "preflight",
+            message: `Worker ${worker} did not finish probing ${brain.harness} readiness`,
+            cause,
+        })));
+        const result = yield* Schema.decodeUnknownEffect(Schema.fromJsonString(HarnessReadiness))(response, { onExcessProperty: "error" }).pipe(Effect.mapError(() => new WorkerCapabilityError({
+            worker,
+            capability: "run-host",
+            message: `Worker ${worker} returned an invalid harness preflight response; update its run host`,
+            cause: new Error("invalid harness readiness response"),
+        })));
+        if (result.harness !== brain.harness)
+            return yield* new WorkerCapabilityError({
+                worker,
+                capability: "run-host",
+                message: `Worker ${worker} returned readiness for the wrong harness`,
+                cause: new Error("harness readiness mismatch"),
+            });
+        if (result._tag === "HarnessUnavailableError")
+            return yield* new WorkerCapabilityError({
+                worker,
+                capability: result.capability === "login" ? "harness-login" : "toolchain",
+                message: result.message,
+                cause: result,
+            });
+        yield* Effect.logInfo("Worker harness preflight verified", {
+            worker,
+            harness: brain.harness,
+            model: brain.model,
+        });
+    }
+    if (distinct.length === 0)
+        yield* Effect.logDebug("No rostered harnesses to preflight", { worker });
+}, logPreflightFailure);
+//# sourceMappingURL=harness-preflight.js.map

package/dist/harness-preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-preflight.js","sourceRoot":"","sources":["../src/harness-preflight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,EAAE,KAAK,IAAI,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACtD,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EAEtB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,gGAAgG;AAChG,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,EAAE,CAAC,0BAA0B,CAAC,CAAC,QAAQ,CAAC,EAC5E,MAAkB,EAClB,MAAgC,EAChC,OAAuB,EACvB,OAGkD;IAElD,KAAK,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpC,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,sEAAsE;QACtE,2EAA2E;QAC3E,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE;YAC/C,GAAG,OAAO,CAAC,IAAI;YACf,aAAa;YACb,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;SAC3D,CAAC,CAAC,IAAI,CACL,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAC5B,MAAM,CAAC,QAAQ,CACb,cAAc,EACd,CAAC,KAAK,EAAE,EAAE,CACR,IAAI,sBAAsB,CAAC;YACzB,SAAS,EAAE,WAAW;YACtB,OAAO,EAAE,UAAU,MAAM,2BAA2B,KAAK,CAAC,OAAO,YAAY;YAC7E,KAAK;SACN,CAAC,CACL,CACF,CAAC;QACF,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CACvF,QAAQ,EACR,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAC9B,CAAC,IAAI,CACJ,MAAM,CAAC,QAAQ,CACb,GAAG,EAAE,CACH,IAAI,qBAAqB,CAAC;YACxB,MAAM;YACN,UAAU,EAAE,UAAU;YACtB,OAAO,EAAE,UAAU,MAAM,sEAAsE;YAC/F,KAAK,EAAE,IAAI,KAAK,CAAC,oCAAoC,CAAC;SACvD,CAAC,CACL,CACF,CAAC;QACF,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO;YAClC,OAAO,KAAK,CAAC,CAAC,IAAI,qBAAqB,CAAC;gBACtC,MAAM;gBACN,UAAU,EAAE,UAAU;gBACtB,OAAO,EAAE,UAAU,MAAM,2CAA2C;gBACpE,KAAK,EAAE,IAAI,KAAK,CAAC,4BAA4B,CAAC;aAC/C,CAAC,CAAC;QACL,IAAI,MAAM,CAAC,IAAI,KAAK,yBAAyB;YAC3C,OAAO,KAAK,CAAC,CAAC,IAAI,qBAAqB,CAAC;gBACtC,MAAM;gBACN,UAAU,EAAE,MAAM,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,WAAW;gBACzE,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,KAAK,EAAE,MAAM;aACd,CAAC,CAAC;QACL,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,mCAAmC,EAAE;YACzD,MAAM;YACN,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAC;IACL,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QACvB,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,oCAAoC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AAC7E,CAAC,EAAE,mBAAmB,CAAC,CAAC"}

package/dist/invalid-frame.d.ts

@@ -10,7 +10,7 @@ export interface InvalidFrameDiagnostic {
     readonly source: FrameSource;
     readonly version: number | undefined;
 }
-/** Redacted frame diagnostics: shape and schema metadata only, never frame content. */
+/** Describes an invalid frame by shape and schema metadata only, never by its content. */
 export declare const invalidFrameDiagnostic: (line: string, cause: unknown) => InvalidFrameDiagnostic;
 export declare const invalidFrameMessage: (diagnostic: InvalidFrameDiagnostic) => string;
 export {};

package/dist/invalid-frame.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"invalid-frame.d.ts","sourceRoot":"","sources":["../src/invalid-frame.ts"],"names":[],"mappings":"AAiEA,KAAK,WAAW,GAAG,YAAY,GAAG,MAAM,GAAG,UAAU,CAAC;AAEtD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;QAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAeD,uFAAuF;AACvF,eAAO,MAAM,sBAAsB,SAAU,MAAM,SAAS,OAAO,KAAG,sBAgCrE,CAAC;AAEF,eAAO,MAAM,mBAAmB,eAAgB,sBAAsB,KAAG,MAUxE,CAAC"}
+{"version":3,"file":"invalid-frame.d.ts","sourceRoot":"","sources":["../src/invalid-frame.ts"],"names":[],"mappings":"AAkEA,KAAK,WAAW,GAAG,YAAY,GAAG,MAAM,GAAG,UAAU,CAAC;AAEtD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;QAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAeD,0FAA0F;AAC1F,eAAO,MAAM,sBAAsB,SAAU,MAAM,SAAS,OAAO,KAAG,sBAgCrE,CAAC;AAEF,eAAO,MAAM,mBAAmB,eAAgB,sBAAsB,KAAG,MAUxE,CAAC"}

package/dist/invalid-frame.js

@@ -56,6 +56,7 @@ const SAFE_PATH_SEGMENTS = new Set([
     "windowDurationMinutes",
     "resetsAt",
     "parentModel",
+    "parentEffort",
     "result",
     "failure",
 ]);
@@ -66,7 +67,7 @@ const safeIssuePath = (path) => path
     return SAFE_PATH_SEGMENTS.has(value) ? value : "<unexpected>";
 })
     .join(".");
-/** Redacted frame diagnostics: shape and schema metadata only, never frame content. */
+/** Describes an invalid frame by shape and schema metadata only, never by its content. */
 export const invalidFrameDiagnostic = (line, cause) => {
     const byteLength = encoder.encode(line).byteLength;
     const parsed = decodeJsonOption(line);

package/dist/invalid-frame.js.map

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

package/dist/keyed-lock.d.ts

@@ -4,8 +4,8 @@ export interface KeyedLock<in K> {
 }
 /**
  * One mutex per key. `PartitionedSemaphore` is not this: its `permits` option
- * is a single shared pool and the partition key only orders waiters, so
- * `make({ permits: 1 })` serializes every key behind one global permit.
+ * is one shared pool and the partition key only orders waiters, so
+ * `make({ permits: 1 })` serializes every key behind a single global permit.
  */
 export declare const keyedLockFor: <K>() => Effect.Effect<KeyedLock<K>>;
 //# sourceMappingURL=keyed-lock.d.ts.map

package/dist/keyed-lock.js

@@ -1,8 +1,8 @@
 import { Effect, Ref, Semaphore } from "effect";
 /**
  * One mutex per key. `PartitionedSemaphore` is not this: its `permits` option
- * is a single shared pool and the partition key only orders waiters, so
- * `make({ permits: 1 })` serializes every key behind one global permit.
+ * is one shared pool and the partition key only orders waiters, so
+ * `make({ permits: 1 })` serializes every key behind a single global permit.
  */
 export const keyedLockFor = () => Effect.map(Ref.make(new Map()), (locks) => ({
     withLock: (key) => {

package/dist/local/local.d.ts

@@ -0,0 +1,20 @@
+import { RepositoryName } from "@usine/core/repository";
+import { InstanceDirectory } from "@usine/core/instance";
+import { Effect, FileSystem, Layer, Path } from "effect";
+import { ChildProcessSpawner } from "effect/unstable/process";
+import { CredentialProvider, Executor, type RunHostCommand } from "../executor.ts";
+export type { RunHostCommand } from "../executor.ts";
+/** Storage and run-host settings for Attempts executed on the local machine. */
+export interface LocalExecutorOptions {
+    /** Factory folder under which local Worker caches and Attempt checkouts are stored. */
+    readonly instanceDirectory: InstanceDirectory;
+    /** How to launch the one-shot run host; the composition root resolves it. */
+    readonly runHost: RunHostCommand;
+    /** Repository fetch URL override, for example a local mirror; defaults to the GitHub HTTPS clone URL. */
+    readonly repositoryUrl?: (repository: RepositoryName) => string;
+    /** Grace for delivering a stop request, then for the run host to exit; each wait is bounded separately. Defaults to two seconds. */
+    readonly interruptGrace?: Parameters<typeof Effect.timeoutOption>[1];
+}
+/** Runs Attempts in isolated checkouts on the local machine. Requires Node; worker contracts are platform-free. */
+export declare const layer: (options: LocalExecutorOptions) => Layer.Layer<Executor, never, CredentialProvider | FileSystem.FileSystem | Path.Path | ChildProcessSpawner.ChildProcessSpawner>;
+//# sourceMappingURL=local.d.ts.map

package/dist/local/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/local/local.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EACL,MAAM,EACN,UAAU,EACV,KAAK,EACL,IAAI,EAML,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAgB,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE5E,OAAO,EAEL,kBAAkB,EAClB,QAAQ,EAKR,KAAK,cAAc,EAGpB,MAAM,gBAAgB,CAAC;AAaxB,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,gFAAgF;AAChF,MAAM,WAAW,oBAAoB;IACnC,uFAAuF;IACvF,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,yGAAyG;IACzG,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,cAAc,KAAK,MAAM,CAAC;IAChE,oIAAoI;IACpI,QAAQ,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC,OAAO,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;CACtE;AAmVD,mHAAmH;AACnH,eAAO,MAAM,KAAK,YACP,oBAAoB,KAC5B,KAAK,CAAC,KAAK,CACZ,QAAQ,EACR,KAAK,EACL,kBAAkB,GAAG,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC,mBAAmB,CAC3C,CAAC"}