@usine/durable 0.0.0-stage → 0.1.0

package/dist/harness.js

@@ -0,0 +1,271 @@
+import { BACKGROUND_CONTEXT, withAbortSignal } from "@earendil-works/chord/context";
+import { createRegistry, Harness, StorageRejected, } from "@earendil-works/pi-durable";
+import { Context, Deferred, Effect, Layer, Option, Result, Schedule, Schema, Scope } 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`, `resume`, or the `operation` passed to
+     * `use`.
+     */
+    operation: Schema.NonEmptyString,
+    /** The error message, or the stop reason if the harness has stopped. */
+    message: Schema.NonEmptyString,
+    cause: Schema.Defect(),
+}) {
+}
+/**
+ * The pi-durable Harness over one storage. Reopens the storage and resumes the tasks after a
+ * poisoned Session or a stuck step, and stops if the reopened harness gets stuck within
+ * `STUCK_AGAIN_MILLIS`.
+ */
+export class DurableHarness extends Context.Service()("@usine/durable/DurableHarness") {
+}
+const POISONED_MESSAGE = "Session is poisoned";
+/**
+ * Whether `cause` is pi-durable's poisoned-Session error, which is identified only by its message
+ * prefix.
+ */
+const isPoisoned = (cause) => cause instanceof Error && cause.message.startsWith(POISONED_MESSAGE);
+/** The interval in which repeats of a reported failure are counted and then logged once. */
+const REPORT_LOG_INTERVAL_MILLIS = 5_000;
+/**
+ * The number of reports of one failure, with no adopted commit between them, after which a step
+ * counts as stuck.
+ */
+export const StuckStepReports = Context.Reference("@usine/durable/StuckStepReports", {
+    defaultValue: () => 1_000,
+});
+/**
+ * If a harness reopened after a stuck step gets stuck again within this time, it stops instead of
+ * reopening.
+ */
+const STUCK_AGAIN_MILLIS = 60_000;
+const messageOf = (cause) => cause instanceof Error && cause.message.length > 0 ? cause.message : String(cause) || "unknown";
+export const durableError = (operation, cause) => new DurableHarnessError({ operation, message: messageOf(cause), cause });
+/** Returns `storage` with `onPoison` called on every commit failure except `StorageRejected`. */
+const watchCommits = (storage, onPoison) => {
+    const commit = (writes, context) => storage.commit(writes, context).catch((cause) => {
+        if (!(cause instanceof StorageRejected))
+            onPoison(cause);
+        throw cause;
+    });
+    return new Proxy(storage, {
+        get: (target, property) => {
+            if (property === "commit")
+                return commit;
+            // SAFETY: the proxy only forwards Storage members, bound to the target because storage
+            // classes use private state.
+            const member = target[property];
+            return member instanceof Function ? member.bind(target) : member;
+        },
+    });
+};
+const make = Effect.fn("DurableHarness.make")(function* (options) {
+    const services = yield* Effect.context();
+    const fork = Effect.runForkWith(services);
+    const stuckStepReports = yield* StuckStepReports;
+    const scope = yield* Effect.scope;
+    const registry = createRegistry();
+    const listeners = new Set();
+    let resumed = Option.none();
+    let started = false;
+    let closed = false;
+    let reopening = Option.none();
+    let stopped = Option.none();
+    const open = Effect.fn("DurableHarness.open")(function* (generation, afterStuck) {
+        yield* Effect.annotateCurrentSpan({ generation });
+        const storage = yield* options.openStorage;
+        const reports = new Map();
+        const harness = yield* Effect.tryPromise({
+            try: () => Harness.open(watchCommits(storage, (cause) => requestReopen(generation, cause, "poisoned")), {
+                models: options.models,
+                registry,
+                onReport: (error) => report(generation, reports, error),
+            }, BACKGROUND_CONTEXT),
+            catch: (cause) => durableError("open", cause),
+        });
+        harness.subscribeCommits((publication) => {
+            for (const [message, repeats] of reports) {
+                if (repeats.unlogged === 0)
+                    reports.delete(message);
+                else
+                    repeats.count = 0;
+            }
+            for (const listener of listeners)
+                listener.onCommit(publication);
+        });
+        if (Option.isSome(resumed)) {
+            yield* resumed.value(harness);
+            harness.resume();
+        }
+        yield* Effect.logInfo("Opened the durable harness", {
+            generation,
+            resumed: Option.isSome(resumed),
+        });
+        return {
+            generation,
+            harness,
+            openedAt: Date.now(),
+            afterStuck,
+            reports,
+        };
+    });
+    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();
+    };
+    const close = Effect.fn("DurableHarness.close")(function* (opened) {
+        yield* Effect.annotateCurrentSpan({ generation: opened.generation });
+        for (const [message, repeats] of opened.reports) {
+            if (repeats.unlogged > 0)
+                logRepeats(opened.generation, message, repeats);
+        }
+        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: opened.generation,
+            message: error.message,
+        })), Effect.ignore);
+    });
+    const reopen = Effect.fn("DurableHarness.reopen")(function* (previous, cause, ready, reason) {
+        yield* Effect.annotateCurrentSpan({ generation: previous.generation, reason });
+        yield* Effect.logError(reason === "poisoned"
+            ? "A durable commit failed after storage admission and poisoned the Session; reopening the harness"
+            : "pi-durable keeps retrying a step that cannot succeed; reopening the harness", { generation: previous.generation, cause: messageOf(cause) });
+        yield* close(previous);
+        const next = yield* open(previous.generation + 1, reason === "stuck").pipe(Effect.tapError((error) => Effect.logError("Could not reopen the durable harness; retrying", {
+            generation: previous.generation + 1,
+            message: error.message,
+        })), Effect.retry(Schedule.spaced("1 second")), Effect.orDie);
+        current = next;
+        reopening = Option.none();
+        yield* Deferred.succeed(ready, next);
+        for (const listener of listeners)
+            listener.onReopen();
+        yield* Effect.logInfo("Reopened the durable harness", { generation: next.generation, reason });
+    });
+    let current = yield* open(1, false);
+    started = true;
+    // Called synchronously from inside pi-durable; the reopen runs on its own fiber.
+    function requestReopen(generation, cause, reason) {
+        if (!started || closed || Option.isSome(stopped) || Option.isSome(reopening))
+            return;
+        if (current.generation !== generation)
+            return;
+        const ready = Deferred.makeUnsafe();
+        reopening = Option.some(ready);
+        fork(reopen(current, cause, ready, reason).pipe(Effect.forkIn(scope)));
+    }
+    function stop(target, cause) {
+        stopped = Option.some(new Error(`pi-durable keeps retrying a step that fails with: ${messageOf(cause)}. Restart the orchestrator.`, { cause }));
+        fork(Effect.logError("Stopped the durable harness: pi-durable kept retrying a step that cannot succeed, also on a reopened harness; durable calls fail until the orchestrator restarts", { generation: target.generation, cause: messageOf(cause) }));
+        for (const listener of listeners)
+            listener.onStop();
+        fork(close(target).pipe(Effect.forkIn(scope)));
+    }
+    function stuck(generation, cause) {
+        if (!started || closed || Option.isSome(stopped) || Option.isSome(reopening))
+            return;
+        if (current.generation !== generation)
+            return;
+        const target = current;
+        // Close now, because no fiber runs while pi-durable retries in microtasks. The reopen or stop
+        // closes it again.
+        void target.harness.close(BACKGROUND_CONTEXT).catch(() => undefined);
+        if (target.afterStuck && Date.now() - target.openedAt < STUCK_AGAIN_MILLIS)
+            stop(target, cause);
+        else
+            requestReopen(generation, cause, "stuck");
+    }
+    // Called synchronously from inside pi-durable, possibly thousands of times a second.
+    function report(generation, reports, cause) {
+        const message = messageOf(cause);
+        const repeats = reports.get(message);
+        if (repeats === undefined) {
+            reports.set(message, { count: 1, unlogged: 0, loggedAt: Date.now() });
+            fork(Effect.logWarning("pi-durable reported a failure that did not fail its caller", {
+                generation,
+                cause: message,
+            }));
+        }
+        else {
+            repeats.count += 1;
+            repeats.unlogged += 1;
+            if (Date.now() - repeats.loggedAt >= REPORT_LOG_INTERVAL_MILLIS) {
+                logRepeats(generation, message, repeats);
+            }
+        }
+        if (isPoisoned(cause))
+            requestReopen(generation, cause, "poisoned");
+        else if ((repeats?.count ?? 1) >= stuckStepReports)
+            stuck(generation, cause);
+    }
+    const unlessStopped = (operation) => Option.match(stopped, {
+        onNone: () => Effect.void,
+        onSome: (reason) => Effect.fail(durableError(operation, reason)),
+    });
+    const opened = Effect.suspend(() => Option.match(reopening, {
+        onNone: () => Effect.succeed(current),
+        onSome: Deferred.await,
+    }));
+    const use = (operation, run) => Effect.gen(function* () {
+        for (let attempt = 1;; attempt += 1) {
+            yield* unlessStopped(operation);
+            const target = yield* opened;
+            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;
+            yield* unlessStopped(operation);
+            if (isPoisoned(cause))
+                requestReopen(target.generation, cause, "poisoned");
+            const replaced = Option.isSome(reopening) || current.generation !== target.generation;
+            if (attempt === 1 && replaced) {
+                yield* Effect.logInfo("Repeating a durable call on the reopened harness", {
+                    operation,
+                    generation: target.generation,
+                });
+                continue;
+            }
+            return yield* durableError(operation, cause);
+        }
+    }).pipe(Effect.withSpan(`DurableHarness.use.${operation}`));
+    yield* Effect.addFinalizer(() => Effect.gen(function* () {
+        closed = true;
+        yield* close(current);
+        yield* Effect.logInfo("Closed the durable harness", { generation: current.generation });
+    }));
+    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) {
+            yield* unlessStopped("resume");
+            const target = yield* opened;
+            yield* beforeResume(target.harness);
+            yield* Effect.try({
+                try: () => target.harness.resume(),
+                catch: (cause) => durableError("resume", cause),
+            });
+            resumed = Option.some(beforeResume);
+            yield* Effect.logInfo("Resumed durable task scheduling", { generation: target.generation });
+        }),
+        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/unstable/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/unstable/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,+LAAiE,CAAC;AAEhG;;;GAGG;AACH,eAAO,MAAM,KAAK,sBAAuB,iBAAiB,gRAIvD,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,111 @@
+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>;
+    /** 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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"}