@usine/durable 0.0.0-stage → 0.2.0

package/dist/harness.js

@@ -0,0 +1,298 @@
+import { BACKGROUND_CONTEXT, withAbortSignal } from "@earendil-works/chord/context";
+import { createRegistry, Harness, SessionFailed, } from "@earendil-works/pi-durable";
+import { Context, Deferred, Effect, Layer, Option, Result, Schema } from "effect";
+/** A failed pi-durable call. */
+export class DurableHarnessError extends Schema.TaggedError("@usine/durable/DurableHarnessError")("DurableHarnessError", {
+    /**
+     * A description of the failed operation, such as `open the durable harness`, or the
+     * `operation` passed to `use`.
+     */
+    operation: Schema.NonEmptyString,
+    /** The error message, or the storage error's message if a storage error failed the harness. */
+    message: Schema.NonEmptyString,
+    cause: Schema.Defect(),
+}) {
+}
+/**
+ * A storage error that failed the pi-durable Session. pi-durable then aborts the harness's running
+ * tasks and closes it, and every later call on it fails.
+ */
+export class DurableStorageFailed extends Schema.TaggedError("@usine/durable/DurableStorageFailed")("DurableStorageFailed", {
+    /** The failed harness's generation: 1 for the first open, and one more for each reopen. */
+    generation: Schema.Int,
+    /** The storage error's message. */
+    message: Schema.NonEmptyString,
+    cause: Schema.Defect(),
+}) {
+}
+/**
+ * The pi-durable Harness over one storage. After a storage error fails the harness, reopens the
+ * storage and resumes the tasks, unless `resume` hasn't completed yet. Stops if the reopen fails
+ * or if the reopened harness fails within a minute.
+ */
+export class DurableHarness extends Context.Service()("@usine/durable/DurableHarness") {
+}
+/** The interval in which repeats of a reported failure are counted and then logged once. */
+const REPORT_LOG_INTERVAL_MILLIS = 5_000;
+/** A reopened harness that fails within this time stops instead of reopening. */
+const REFAIL_MILLIS = 60_000;
+const RESUME_OPERATION = "resume the durable tasks";
+const messageOf = (cause) => cause instanceof Error && cause.message.length > 0 ? cause.message : String(cause) || "unknown";
+/**
+ * Returns a `DurableHarnessError` with the message of `cause`. For a `SessionFailed`, uses the
+ * message of the storage error that failed the harness.
+ */
+export const durableError = (operation, cause) => new DurableHarnessError({
+    operation,
+    message: messageOf(cause instanceof SessionFailed ? cause.cause : cause),
+    cause,
+});
+const make = Effect.fn("DurableHarness.make")(function* (options) {
+    const services = yield* Effect.context();
+    const fork = Effect.runForkWith(services);
+    const scope = yield* Effect.scope;
+    const registry = createRegistry();
+    const listeners = new Set();
+    let resumed = Option.none();
+    let finalizing = false;
+    let stopped = false;
+    /**
+     * Set while the current harness has failed. Succeeds with the reopened harness, or fails with the
+     * storage failure if no reopen follows.
+     */
+    let failed = Option.none();
+    const logRepeats = (generation, message, repeats) => {
+        fork(Effect.logWarning("pi-durable reported the same failure again", {
+            generation,
+            cause: message,
+            repeats: repeats.unlogged,
+        }));
+        repeats.unlogged = 0;
+        repeats.loggedAt = Date.now();
+    };
+    // Called synchronously from inside pi-durable.
+    function report(generation, cause) {
+        const message = messageOf(cause);
+        // pi-durable also reports the error that fails the Session; the failure handling logs it.
+        if (generation.failing) {
+            fork(Effect.logDebug("pi-durable reported a failure of a failed harness", {
+                generation: generation.number,
+                cause: message,
+            }));
+            return;
+        }
+        const repeats = generation.reports.get(message);
+        if (repeats === undefined) {
+            generation.reports.set(message, { unlogged: 0, loggedAt: Date.now() });
+            fork(Effect.logWarning("pi-durable reported a failure that did not fail its caller", {
+                generation: generation.number,
+                cause: message,
+            }));
+            return;
+        }
+        repeats.unlogged += 1;
+        if (Date.now() - repeats.loggedAt >= REPORT_LOG_INTERVAL_MILLIS) {
+            logRepeats(generation.number, message, repeats);
+        }
+    }
+    const open = Effect.fn("DurableHarness.open")(function* (number) {
+        yield* Effect.annotateCurrentSpan({ generation: number });
+        const storage = yield* options.openStorage;
+        const generation = {
+            number,
+            reports: new Map(),
+            closing: false,
+            failing: false,
+            handled: false,
+        };
+        const harness = yield* Effect.tryPromise({
+            try: () => Harness.open(storage, { models: options.models, registry, onReport: (error) => report(generation, error) }, BACKGROUND_CONTEXT),
+            catch: (cause) => durableError("open the durable harness", cause),
+        });
+        const opened = { generation, harness, storage, openedAt: Date.now() };
+        harness.subscribeClose(() => {
+            if (generation.closing)
+                return;
+            generation.failing = true;
+            handleFailure(opened);
+        });
+        harness.subscribeCommits((publication) => {
+            for (const [message, repeats] of generation.reports) {
+                if (repeats.unlogged === 0)
+                    generation.reports.delete(message);
+            }
+            for (const listener of listeners)
+                listener.onCommit(publication);
+        });
+        if (Option.isSome(resumed)) {
+            yield* resumed.value(harness, storage);
+            yield* Effect.try({
+                try: () => harness.resume(),
+                catch: (cause) => durableError(RESUME_OPERATION, cause),
+            });
+        }
+        yield* Effect.logInfo("Opened the durable harness", {
+            generation: number,
+            resumed: Option.isSome(resumed),
+        });
+        return opened;
+    });
+    const flushReports = (generation) => {
+        for (const [message, repeats] of generation.reports) {
+            if (repeats.unlogged > 0)
+                logRepeats(generation.number, message, repeats);
+        }
+    };
+    const close = Effect.fn("DurableHarness.close")(function* (opened) {
+        const generation = opened.generation;
+        yield* Effect.annotateCurrentSpan({ generation: generation.number });
+        generation.closing = true;
+        flushReports(generation);
+        yield* Effect.tryPromise({
+            try: () => opened.harness.close(BACKGROUND_CONTEXT),
+            catch: (cause) => durableError("close", cause),
+        }).pipe(Effect.tapError((error) => Effect.logError("Could not close the durable harness", {
+            generation: generation.number,
+            message: error.message,
+        })), Effect.ignore);
+    });
+    const stop = Effect.fn("DurableHarness.stop")(function* (failure, ready) {
+        stopped = true;
+        yield* Effect.logError("Stopped the durable harness: the storage failed again on reopening; durable calls fail until the orchestrator restarts", { generation: failure.generation, cause: failure.message });
+        yield* Deferred.fail(ready, failure);
+    });
+    const reopen = Effect.fn("DurableHarness.reopen")(function* (previous, ready) {
+        const number = previous.generation.number + 1;
+        yield* Effect.annotateCurrentSpan({ generation: number });
+        yield* Effect.logInfo("Reopening the durable harness", { generation: number });
+        const next = yield* open(number).pipe(Effect.result);
+        if (Result.isFailure(next)) {
+            return yield* stop(new DurableStorageFailed({
+                generation: number,
+                message: next.failure.message,
+                cause: next.failure,
+            }), ready);
+        }
+        current = next.success;
+        failed = Option.none();
+        yield* Deferred.succeed(ready, next.success);
+        yield* Effect.logInfo("Reopened the durable harness", { generation: number });
+        // A failure while opening found another harness current.
+        if (next.success.generation.failing)
+            handleFailure(next.success);
+    }, Effect.uninterruptible);
+    /** Waits until the failed harness has closed, then reopens it or completes `ready` with the failure. */
+    const recover = Effect.fn("DurableHarness.recover")(function* (opened, ready) {
+        const number = opened.generation.number;
+        yield* Effect.annotateCurrentSpan({ generation: number });
+        const end = yield* Effect.promise(() => opened.harness.closed);
+        flushReports(opened.generation);
+        const cause = end.reason === "failed" ? end.error : new Error("pi-durable closed the harness");
+        const failure = new DurableStorageFailed({
+            generation: number,
+            message: messageOf(cause),
+            cause,
+        });
+        yield* Effect.logError("A storage error failed the durable harness, and pi-durable closed it", {
+            generation: number,
+            cause: failure.message,
+        });
+        for (const listener of listeners)
+            listener.onFailure(failure);
+        if (finalizing)
+            return yield* Deferred.fail(ready, failure);
+        if (Option.isNone(resumed)) {
+            yield* Effect.logError("The durable harness failed before its tasks resumed; it stays closed", {
+                generation: number,
+                cause: failure.message,
+            });
+            return yield* Deferred.fail(ready, failure);
+        }
+        if (number > 1 && Date.now() - opened.openedAt < REFAIL_MILLIS) {
+            return yield* stop(failure, ready);
+        }
+        yield* reopen(opened, ready);
+    });
+    let current = yield* open(1);
+    // Called synchronously from inside pi-durable; the recovery runs on its own fiber.
+    function handleFailure(opened) {
+        if (opened.generation.handled || opened !== current || Option.isSome(failed))
+            return;
+        opened.generation.handled = true;
+        const ready = Deferred.makeUnsafe();
+        failed = Option.some(ready);
+        fork(recover(opened, ready).pipe(Effect.forkIn(scope)));
+    }
+    /** Returns the open harness, waiting for a reopen. Fails if the harness stays closed. */
+    const openHarness = (operation) => Effect.suspend(() => Option.match(failed, {
+        onNone: () => Effect.succeed(current),
+        onSome: (ready) => Deferred.await(ready).pipe(Effect.mapError((failure) => new DurableHarnessError({
+            operation,
+            message: stopped
+                ? `The durable harness stopped after repeated storage errors: ${failure.message}. Restart the orchestrator.`
+                : failure.message,
+            cause: failure,
+        }))),
+    }));
+    /** Whether `cause` failed the call because a storage error failed `opened`'s harness. */
+    const failedHarness = (opened, cause) => opened.generation.failing || cause instanceof SessionFailed;
+    const use = (operation, run) => Effect.gen(function* () {
+        for (let attempt = 1;; attempt += 1) {
+            const target = yield* openHarness(operation);
+            const outcome = yield* Effect.tryPromise({
+                try: (signal) => run(target.harness, withAbortSignal(signal, BACKGROUND_CONTEXT)),
+                catch: (cause) => cause,
+            }).pipe(Effect.result);
+            if (Result.isSuccess(outcome))
+                return outcome.success;
+            const cause = outcome.failure;
+            if (!failedHarness(target, cause))
+                return yield* durableError(operation, cause);
+            if (attempt === 1) {
+                yield* Effect.logInfo("Repeating a durable call after its harness failed", {
+                    operation,
+                    generation: target.generation.number,
+                });
+                continue;
+            }
+            return yield* durableError(operation, cause);
+        }
+    }).pipe(Effect.withSpan(`DurableHarness.use.${operation}`));
+    yield* Effect.addFinalizer(() => Effect.gen(function* () {
+        finalizing = true;
+        yield* close(current);
+        yield* Effect.logInfo("Closed the durable harness", {
+            generation: current.generation.number,
+        });
+    }));
+    return DurableHarness.of({
+        models: options.models,
+        defaultModel: options.defaultModel,
+        install: (extension) => Effect.sync(() => registry.install(extension)).pipe(Effect.tap(() => Effect.logDebug("Installed a durable extension", { name: extension.name }))),
+        resume: Effect.fn("DurableHarness.resume")(function* (beforeResume) {
+            const target = yield* openHarness(RESUME_OPERATION);
+            yield* beforeResume(target.harness, target.storage);
+            const started = yield* Effect.try({
+                try: () => target.harness.resume(),
+                catch: (cause) => cause,
+            }).pipe(Effect.result);
+            if (Result.isFailure(started)) {
+                if (failedHarness(target, started.failure))
+                    yield* openHarness(RESUME_OPERATION);
+                return yield* durableError(RESUME_OPERATION, started.failure);
+            }
+            resumed = Option.some(beforeResume);
+            yield* Effect.logInfo("Resumed durable task scheduling", {
+                generation: target.generation.number,
+            });
+        }),
+        use,
+        subscribe: (listener) => Effect.acquireRelease(Effect.sync(() => listeners.add(listener)), () => Effect.sync(() => listeners.delete(listener))).pipe(Effect.asVoid),
+    });
+});
+/**
+ * Opens the harness for the layer's lifetime. Closes it on release without writing any task
+ * outcome.
+ */
+export const layer = (options) => Layer.effect(DurableHarness, make(options));
+//# sourceMappingURL=harness.js.map

package/dist/harness.js.map

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

package/dist/live.d.ts

@@ -0,0 +1,15 @@
+import type { InstanceDirectory } from "@usine/core/instance";
+import { Layer } from "effect";
+/**
+ * Provides the durable harness on `.usine/durable.sqlite` with Pi's configured models and
+ * credentials.
+ */
+export declare const harnessLayer: (instanceDirectory: InstanceDirectory) => Layer.Layer<import("./harness.ts").DurableHarness, import("./harness.ts").DurableHarnessError, never>;
+/** Provides the Claude Code, Codex, and Pi child backends, selected by the Agent's harness. */
+export declare const childBackendLayer: Layer.Layer<import("@usine/agents/runtime").ChildBackend, never, import("effect/process/ChildProcessSpawner").ChildProcessSpawner | import("@usine/agents/runtime").ClaudeLoginLock>;
+/**
+ * Provides the Node `AttemptRuntime` with the real child backends. Building it resumes every
+ * unfinished Attempt.
+ */
+export declare const layer: (instanceDirectory: InstanceDirectory) => Layer.Layer<import("./attempt-runtime.ts").AttemptRuntime | import("./harness.ts").DurableHarness, import("./harness.ts").DurableHarnessError, import("effect/process/ChildProcessSpawner").ChildProcessSpawner | import("@usine/agents/runtime").ClaudeLoginLock>;
+//# sourceMappingURL=live.d.ts.map

package/dist/live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../src/live.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAsB,KAAK,EAAgB,MAAM,QAAQ,CAAC;AA+CjE;;;GAGG;AACH,eAAO,MAAM,YAAY,sBAAuB,iBAAiB,0GACc,CAAC;AAQhF,+FAA+F;AAC/F,eAAO,MAAM,iBAAiB,sLAAiE,CAAC;AAEhG;;;GAGG;AACH,eAAO,MAAM,KAAK,sBAAuB,iBAAiB,uQAIvD,CAAC"}

package/dist/live.js

@@ -0,0 +1,51 @@
+import { NodeServices } from "@effect/platform-node";
+import { getAgentDir, ModelRuntime, SettingsManager } from "@earendil-works/pi-coding-agent";
+import { openNodeSqliteStorage } from "@earendil-works/pi-durable/storage/sqlite/node";
+import { childDispatcherLayer } from "@usine/agents/children";
+import { claudeChildBackendLayer, claudeSdkLive } from "@usine/agents/claude";
+import { codexAppServerLive, codexChildBackendLayer } from "@usine/agents/codex";
+import { piChildBackendLayer, piSdkLive } from "@usine/agents/pi";
+import { Effect, FileSystem, Layer, Option, Path } from "effect";
+import { layer as attemptRuntimeLayer } from "./attempt/runtime.js";
+import { durableError, layer as durableHarnessLayer, } from "./harness.js";
+import { durableStoragePath } from "./storage-path.js";
+const nodeOptions = Effect.fn("DurableHarness.nodeOptions")(function* (instanceDirectory) {
+    const fileSystem = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const file = durableStoragePath(path, instanceDirectory);
+    const models = yield* Effect.tryPromise({
+        try: (signal) => ModelRuntime.create({ signal }),
+        catch: (cause) => durableError("load the Pi model runtime", cause),
+    });
+    // Only the Pi user's global settings: the instance folder's own `.pi/` is not trusted.
+    const settings = SettingsManager.create(instanceDirectory, getAgentDir(), {
+        projectTrusted: false,
+    });
+    const defaultModel = Option.flatMap(Option.fromNullishOr(settings.getDefaultProvider()), (provider) => Option.map(Option.fromNullishOr(settings.getDefaultModel()), (modelId) => ({
+        provider,
+        modelId,
+    })));
+    yield* Effect.logInfo("Durable harness storage", { file });
+    return {
+        openStorage: fileSystem.makeDirectory(path.dirname(file), { recursive: true }).pipe(Effect.mapError((cause) => durableError("create the durable storage folder", cause)), Effect.andThen(Effect.tryPromise({
+            try: () => openNodeSqliteStorage(file),
+            catch: (cause) => durableError("open the durable storage", cause),
+        }))),
+        models,
+        defaultModel,
+    };
+}, Effect.provide(NodeServices.layer));
+/**
+ * Provides the durable harness on `.usine/durable.sqlite` with Pi's configured models and
+ * credentials.
+ */
+export const harnessLayer = (instanceDirectory) => Layer.unwrap(Effect.map(nodeOptions(instanceDirectory), durableHarnessLayer));
+const childImplementations = Layer.mergeAll(claudeChildBackendLayer.pipe(Layer.provide(claudeSdkLive)), codexChildBackendLayer.pipe(Layer.provide(codexAppServerLive)), piChildBackendLayer.pipe(Layer.provide(piSdkLive)));
+/** Provides the Claude Code, Codex, and Pi child backends, selected by the Agent's harness. */
+export const childBackendLayer = childDispatcherLayer.pipe(Layer.provide(childImplementations));
+/**
+ * Provides the Node `AttemptRuntime` with the real child backends. Building it resumes every
+ * unfinished Attempt.
+ */
+export const layer = (instanceDirectory) => attemptRuntimeLayer.pipe(Layer.provideMerge(harnessLayer(instanceDirectory)), Layer.provide(childBackendLayer));
+//# sourceMappingURL=live.js.map

package/dist/live.js.map

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

package/dist/storage-path.d.ts

@@ -0,0 +1,4 @@
+import type { InstanceDirectory } from "@usine/core/instance";
+import type { Path } from "effect";
+export declare const durableStoragePath: (path: Path.Path, instanceDirectory: InstanceDirectory) => string;
+//# sourceMappingURL=storage-path.d.ts.map

package/dist/storage-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-path.d.ts","sourceRoot":"","sources":["../src/storage-path.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC,eAAO,MAAM,kBAAkB,SAAU,IAAI,CAAC,IAAI,qBAAqB,iBAAiB,KAAG,MACjC,CAAC"}

package/dist/storage-path.js

@@ -0,0 +1,2 @@
+export const durableStoragePath = (path, instanceDirectory) => path.join(instanceDirectory, ".usine", "durable.sqlite");
+//# sourceMappingURL=storage-path.js.map

package/dist/storage-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-path.js","sourceRoot":"","sources":["../src/storage-path.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAe,EAAE,iBAAoC,EAAU,EAAE,CAClG,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC"}

package/dist/testing.d.ts

@@ -0,0 +1,116 @@
+import type { AssistantMessage } from "@earendil-works/pi-ai";
+import { type FauxResponseStep } from "@earendil-works/pi-ai/providers/faux";
+import { ChildBackend, type ChildRequest } from "@usine/agents/runtime";
+import { type AgentSessionEvent, ParentSession } from "@usine/core/agent/session";
+import * as AttemptChannel from "@usine/core/attempt/channel";
+import { type AttemptFailure } from "@usine/core/attempt/failure";
+import { StepResult } from "@usine/core/step/result";
+import { Context, Duration, Effect, Layer, Option } from "effect";
+import { AttemptReport, type AttemptRequest, AttemptRuntime } from "./attempt-runtime.ts";
+import { type DurableHarnessOptions } from "./harness.ts";
+export type ParentStep = FauxResponseStep;
+/** The model ID that the testing layer serves. */
+export declare const PARENT_MODEL: string & import("effect/Brand").Brand<"ModelId">;
+/** Returns a parent turn that calls the `subagent` tool with `task`. */
+export declare const delegate: (task: string) => AssistantMessage;
+/** Returns a parent turn whose final answer is `text`. */
+export declare const answer: (text: string) => AssistantMessage;
+/**
+ * Returns pi-ai model access that answers requests with `steps` in order, at any reasoning effort
+ * up to `high`.
+ */
+export declare const fauxParent: (steps: ReadonlyArray<ParentStep>) => Pick<DurableHarnessOptions, "models" | "defaultModel">;
+/** A child launched by the stub backend and finished by the test. */
+export interface StubChild {
+    readonly request: ChildRequest;
+    readonly emit: (event: AgentSessionEvent) => Effect.Effect<void>;
+    /**
+     * Reads the queued operator messages, then finishes with `message` as the report. Under a Hold,
+     * the report is delayed until release.
+     */
+    readonly reply: (message: string) => Effect.Effect<void>;
+    /** Reads the queued operator messages, as a harness does at a turn boundary. */
+    readonly readQueued: Effect.Effect<void>;
+    /** Finishes with a blocked report, which fails the Attempt unless the parent relays it. */
+    readonly block: (message: string) => Effect.Effect<void>;
+    /**
+     * Finishes by asking the operator `question`, which fails the Attempt unless the parent relays
+     * it.
+     */
+    readonly ask: (question: string) => Effect.Effect<void>;
+    /**
+     * Finishes with a harness failure, which fails the Attempt with `AgentFailure` unless the parent
+     * reports otherwise.
+     */
+    readonly fail: (message: string) => Effect.Effect<void>;
+    /**
+     * Ends without a result, as a Claude child whose output stream fails: the parent's `subagent`
+     * call fails with a `stream` `SessionOperationError` whose message is `message`.
+     */
+    readonly crash: (message: string) => Effect.Effect<void>;
+    /** Completes when the parent's tool call interrupts the child (abort, cancel, or shutdown). */
+    readonly interrupted: Effect.Effect<void>;
+    readonly interventions: Effect.Effect<ReadonlyArray<AttemptChannel.OperatorAction>>;
+}
+declare const StubChildren_base: Context.ServiceClass<StubChildren, "@usine/durable/testing/StubChildren", {
+    readonly next: Effect.Effect<StubChild>;
+}>;
+/** The children launched by the stub backend, in launch order. */
+export declare class StubChildren extends StubChildren_base {
+}
+/** A `ChildBackend` whose children the test drives through `StubChildren`. */
+export declare const stubChildBackendLayer: Layer.Layer<ChildBackend | StubChildren>;
+export interface DurableTestingOptions {
+    /** The SQLite file path. To simulate a restart, build another layer on the same file. */
+    readonly database: string;
+    /** The parent model's answers, one per request. */
+    readonly parent: ReadonlyArray<ParentStep>;
+}
+/** Returns a durable Attempt runtime with a scripted parent model and stub children. */
+export declare const layer: (options: DurableTestingOptions) => Layer.Layer<AttemptRuntime | ChildBackend | import("./harness.ts").DurableHarness | StubChildren, import("./harness.ts").DurableHarnessError, never>;
+export interface StubParentContext {
+    /**
+     * The request passed to this `execute` call, which differs from the stored request on reattach.
+     */
+    readonly request: AttemptRequest;
+    /** Records an outbound envelope with the task's next sequence number. */
+    readonly emit: (payload: AttemptChannel.OutboundPayload) => Effect.Effect<void, AttemptFailure>;
+    readonly session: ParentSession;
+    /** Whether this call reattached a task started by a previous runtime. */
+    readonly reattached: boolean;
+}
+/** The stub parent's work after `Started`, returning the final message or a full report. */
+export type StubParent = (context: StubParentContext) => Effect.Effect<string | AttemptReport, AttemptFailure>;
+type StubTaskState = {
+    readonly _tag: "live";
+} | {
+    readonly _tag: "finished";
+    readonly report: AttemptReport;
+    result: Option.Option<StepResult>;
+} | {
+    readonly _tag: "canceled";
+};
+interface StubTask {
+    readonly request: AttemptRequest;
+    state: StubTaskState;
+    outbound: number;
+    inbound: number;
+}
+/** Stub runtime storage that persists across runtime rebuilds, to simulate a restart. */
+export declare class StubStorage {
+    /** The stub tasks by Attempt ID, with their creating request and state. */
+    readonly tasks: Map<string & import("effect/Brand").Brand<"AttemptId">, StubTask>;
+    /** The time stored by `recordUnsupervised`, by Attempt ID. */
+    readonly unsupervised: Map<string & import("effect/Brand").Brand<"AttemptId">, Duration.Duration>;
+}
+/** Completes immediately with `Completed: <task>`. */
+export declare const completes: StubParent;
+/** Waits `millis` milliseconds, then completes like `completes`. */
+export declare const worksFor: (millis: number) => StubParent;
+/**
+ * Returns an in-memory `AttemptRuntime` over `storage` for tests that need no parent model. An
+ * interrupted `execute` or a failing parent leaves the task live until it is canceled.
+ */
+export declare const stubAttemptRuntime: (storage: StubStorage, parent?: StubParent) => Layer.Layer<AttemptRuntime, never, never>;
+export {};
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

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