@smthrs/flow 0.0.0-stage → 1.0.0-rc.4

package/dist/esm/Action/make.js

@@ -0,0 +1,405 @@
+// Deep reviewed and polished by a human on 2026-08-10.
+import * as Node from "@smthrs/plan/Node";
+import * as Cause from "effect/Cause";
+import * as Context from "effect/Context";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Effectable from "effect/Effectable";
+import * as Exit from "effect/Exit";
+import * as Fiber from "effect/Fiber";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Predicate from "effect/Predicate";
+import * as Schema from "effect/Schema";
+import { makeProto } from "../Flow/internal.js";
+import * as FlowHelpers from "../Flow/Runtime.js";
+import { FlowInstance } from "../FlowRuntime/FlowInstance.js";
+import { FlowRuntime } from "../FlowRuntime/FlowRuntime.js";
+import { lowerDeclarations } from "../internal/Declarations.js";
+import * as DeclarationSite from "../internal/DeclarationSite.js";
+import { AttemptTimedOut } from "./AttemptTimedOut.js";
+import { CurrentAttempt, CurrentHeartbeat } from "./Context.js";
+import { FileBoundary } from "./FileBoundary.js";
+import { Implementations } from "./Implementations.js";
+import { ImplementationVersionMismatch } from "./ImplementationVersionMismatch.js";
+import { InfraInterruptRetriesExhausted } from "./InfraInterruptRetriesExhausted.js";
+import { TypeId } from "./TypeId.js";
+// A declared action mints a fresh inline action per dispatch. Effect caches
+// compiled parsers by AST identity, so the exit schemas are shared per
+// (success, error) pair rather than rebuilt on every dispatch.
+const exitSchemaCache = new WeakMap();
+const exitSchemasFor = (success, error, successJson, errorJson) => {
+    let byError = exitSchemaCache.get(success);
+    if (byError === undefined) {
+        byError = new WeakMap();
+        exitSchemaCache.set(success, byError);
+    }
+    let cached = byError.get(error);
+    if (cached === undefined) {
+        cached = {
+            exitSchema: Schema.Exit(successJson, errorJson, Schema.Defect()),
+            exitSchemaPartial: Schema.Exit(successJson, errorJson, Schema.Unknown)
+        };
+        byError.set(error, cached);
+    }
+    return cached;
+};
+/**
+ * Creates a flow action from an effect, using the provided schemas to
+ * encode successes and failures for durable execution.
+ *
+ * @category constructors
+ * @since 0.1.0
+ */
+const makeInline = (options) => {
+    const implementationVersion = options.implementationVersion === undefined
+        ? undefined
+        : Schema.decodeUnknownSync(Schema.NonEmptyString)(options.implementationVersion);
+    const successSchema = options.success ?? Schema.Void;
+    const errorSchema = options.error ?? Schema.Never;
+    const successSchemaJson = Schema.toCodecJson(successSchema);
+    const errorSchemaJson = Schema.toCodecJson(errorSchema);
+    const exitSchemas = exitSchemasFor(successSchema, errorSchema, successSchemaJson, errorSchemaJson);
+    let execute;
+    const attemptTimeoutMs = timeoutMs(options.name, "attemptTimeoutMs", options.attemptTimeoutMs);
+    const heartbeatTimeoutMs = timeoutMs(options.name, "heartbeatTimeoutMs", options.heartbeatTimeoutMs);
+    const executeWithInfraRetry = boundAttempt(options.name, attemptTimeoutMs, heartbeatTimeoutMs)(retryInfraInterrupt(options.name, options.interruptRetryPolicy)(options.execute));
+    const self = {
+        ...Effectable.Prototype({
+            label: "Action",
+            evaluate(_) {
+                return execute;
+            }
+        }),
+        [TypeId]: TypeId,
+        name: options.name,
+        implementationVersion,
+        successSchema,
+        errorSchema,
+        exitSchema: exitSchemas.exitSchema,
+        exitSchemaPartial: exitSchemas.exitSchemaPartial,
+        annotations: options.annotations ?? Context.empty(),
+        tier: options.tier ?? "sealed",
+        idempotencyKey: options.idempotencyKey,
+        nondeterministic: options.nondeterministic,
+        metadata: options.fileBoundary === undefined ? options.metadata : FileBoundary.make(options.fileBoundary),
+        fileBoundary: options.fileBoundary === undefined ? undefined : FileBoundary.make(options.fileBoundary),
+        retryPolicy: options.retryPolicy,
+        attemptTimeoutMs,
+        heartbeatTimeoutMs,
+        annotate(tag, value) {
+            return makeInline({
+                ...options,
+                annotations: Context.add(self.annotations, tag, value)
+            });
+        },
+        annotateMerge(context) {
+            return makeInline({
+                ...options,
+                annotations: Context.merge(self.annotations, context)
+            });
+        },
+        execute: executeWithInfraRetry,
+        executeEncoded: Effect.matchEffect(executeWithInfraRetry, {
+            onFailure: (error) => Effect.flatMap(Effect.orDie(Schema.encodeEffect(errorSchemaJson)(error)), Effect.fail),
+            onSuccess: (value) => Effect.orDie(Schema.encodeEffect(successSchemaJson)(value))
+        })
+    };
+    execute = makeExecute(self);
+    return self;
+};
+const makeDeclared = (tag, options, site) => {
+    const payloadSchema = (Schema.isSchema(options.payload)
+        ? options.payload
+        : Schema.Struct(options.payload));
+    const implementationVersion = options.implementationVersion === undefined
+        ? undefined
+        : Schema.decodeUnknownSync(Schema.NonEmptyString)(options.implementationVersion);
+    const successSchema = options.success ?? Schema.Void;
+    const errorSchema = options.error ?? Schema.Never;
+    const attemptTimeoutMs = timeoutMs(tag, "attemptTimeoutMs", options.attemptTimeoutMs);
+    const heartbeatTimeoutMs = timeoutMs(tag, "heartbeatTimeoutMs", options.heartbeatTimeoutMs);
+    const annotations = lowerDeclarations(options);
+    // The literals are already in the bag above, so an annotated copy rebuilds
+    // from options WITHOUT them: re-lowering would overwrite a `Capabilities` or
+    // `EffectEnvelope` the caller annotated on top of the declared one.
+    const lowered = {
+        ...options,
+        capabilities: undefined,
+        effects: undefined
+    };
+    // The requirement this declaration mints for itself. Context keys are
+    // compared by their string key, so re-minting one for an annotated copy of
+    // this declaration names the same slot the original does.
+    const requirement = Context.Service(`@smthrs/flow/Action/Requirement/${tag}`);
+    const self = {
+        [TypeId]: TypeId,
+        name: tag,
+        implementationVersion,
+        payloadSchema,
+        successSchema,
+        errorSchema,
+        tier: options.tier ?? "sealed",
+        idempotencyKey: options.idempotencyKey,
+        nondeterministic: options.nondeterministic,
+        retryPolicy: options.retryPolicy,
+        attemptTimeoutMs,
+        heartbeatTimeoutMs,
+        fileBoundary: options.fileBoundary,
+        annotations,
+        requirement,
+        annotate(key, value) {
+            return makeDeclared(tag, {
+                ...lowered,
+                annotations: Context.add(annotations, key, value)
+            }, site);
+        },
+        annotateMerge(context) {
+            return makeDeclared(tag, {
+                ...lowered,
+                annotations: Context.merge(annotations, context)
+            }, site);
+        },
+        call(payload) {
+            return Node.actionCall(self, tag, payload);
+        },
+        toLayer(execute, registrationOptions) {
+            if (registrationOptions?.implementationVersion !== implementationVersion) {
+                throw new ImplementationVersionMismatch({
+                    actionName: tag,
+                    declaredVersion: implementationVersion ?? null,
+                    registeredVersion: registrationOptions?.implementationVersion ?? null,
+                    message: `Action "${tag}" requires its declared implementationVersion at registration.`
+                });
+            }
+            // The flow form of this action: same tag, same schemas, and a body that
+            // is the one call to it. Registering that flow is what lets a caller
+            // `execute` the action as a durable execution of its own, and the body
+            // says truthfully what such an execution does. It stays INTERNAL — a flow
+            // carries a body and never a handler, so `Flow` has no `toLayer` for an
+            // author to reach this seam with.
+            //
+            // The private constructor preserves the ordinary flow representation
+            // without importing the public constructor back through this action.
+            const registration = DeclarationSite.annotate(makeProto({
+                _tag: tag,
+                payloadSchema,
+                successSchema,
+                errorSchema,
+                annotations,
+                body: (payload) => Node.actionCall(self, tag, payload)
+            }), DeclarationSite.capture());
+            const action = (payload) => makeInline({
+                name: tag,
+                implementationVersion,
+                success: successSchema,
+                error: errorSchema,
+                tier: self.tier,
+                idempotencyKey: typeof self.idempotencyKey === "function"
+                    ? self.idempotencyKey(payload)
+                    : self.idempotencyKey,
+                nondeterministic: self.nondeterministic,
+                retryPolicy: options.retryPolicy,
+                attemptTimeoutMs,
+                heartbeatTimeoutMs,
+                interruptRetryPolicy: options.interruptRetryPolicy,
+                fileBoundary: typeof options.fileBoundary === "function"
+                    ? options.fileBoundary(payload)
+                    : options.fileBoundary,
+                annotations,
+                execute: execute(payload)
+            });
+            // The implementation, provided under the requirement this declaration
+            // minted. That is the compile-time half: a body that called this action
+            // produced a node requiring the tag, and this layer is the only thing
+            // that answers it, so a plan cannot reach `execute` without its code.
+            //
+            // The name-keyed table is the run-time half and stays exactly as it was.
+            // A driver expanding a persisted plan has no types left to consult and
+            // resolves by tag, so the same implementation is filed there when a
+            // composition wired a table up. The table is optional on purpose: a
+            // composition that only executes handlers registered directly with the
+            // runtime has no use for it, and requiring it would change what every
+            // existing `toLayer` call site must provide.
+            const implement = Layer.effect(requirement)(Effect.gen(function* () {
+                const services = yield* Effect.context();
+                // The captured context is what the runtime's own `register` captures
+                // for the handler path: the services the implementation was wired with,
+                // overridable by whatever the run provides on top of them.
+                const provided = (payload) => Effect.flatMap(
+                // A driver assembles this payload from plan values rather than from
+                // a typed call site, so the declaration validates it exactly as
+                // `Flow.execute` validates a caller's. The cast is the erasure that
+                // hands an unknown to the constructor; `makeEffect` is what decides
+                // whether it was one.
+                Effect.orDie(payloadSchema.makeEffect(payload)), (decoded) => action(decoded)).pipe(Effect.updateContext((input) => Context.merge(services, input)));
+                const implementation = {
+                    name: tag,
+                    ...(implementationVersion === undefined ? {} : { implementationVersion }),
+                    action: provided
+                };
+                const table = yield* Effect.serviceOption(Implementations);
+                if (Option.isSome(table))
+                    yield* table.value.add(implementation, registrationOptions);
+                return implementation;
+            }));
+            return Layer.merge(Layer.effectDiscard(Effect.flatMap(FlowRuntime, (engine) => engine.register(registration, action))), implement);
+        }
+    };
+    return DeclarationSite.annotate(self, site);
+};
+/**
+ * Creates either an inline executable action or a named action
+ * declaration, selected by whether the first argument is a string.
+ *
+ * @category constructors
+ * @since 0.1.0
+ */
+export const make = ((first, second) => {
+    if (typeof first !== "string")
+        return makeInline(first);
+    const options = second;
+    return makeDeclared(first, options, options.declaredFrom === undefined ? DeclarationSite.capture() : DeclarationSite.declaredAt(options.declaredFrom));
+});
+/**
+ * Declares a SYSTEM action: one whose implementation ships with the engine
+ * rather than with the composition that calls it.
+ *
+ * It is {@link make}'s declared form in every respect except the requirement.
+ * A system declaration mints none, so `.call()` records a node that demands
+ * nothing and a body using {@link module:Sleep} or {@link module:WaitFor} does
+ * not push a layer obligation onto its callers. That is the whole difference,
+ * and it is a deliberate hole in the compile-time enforcement: the engine owns
+ * these implementations, so an author cannot be the one who forgot them.
+ *
+ * Everything else is unchanged — the layer still registers with the runtime and
+ * still files itself in {@link module:Implementations.Implementations}, so a
+ * driver resolves a system action by tag exactly like any other.
+ *
+ * @category constructors
+ * @since 0.1.0
+ */
+export const makeSystem = (tag, options) => 
+// The erasure IS the declaration: the value still provides its requirement
+// from `toLayer`, and dropping it from `call` only means nothing asks for it.
+// Providing a service no one requires is always sound; the reverse would not
+// be, which is why this is the one place the channel is written off.
+makeDeclared(tag, options, options.declaredFrom === undefined ? DeclarationSite.capture() : DeclarationSite.declaredAt(options.declaredFrom));
+/**
+ * Validates one declared attempt bound. An invalid bound is a programmer
+ * error thrown at declaration, like `Flow.make`'s `maxRounds`.
+ */
+const timeoutMs = (name, field, value) => {
+    if (value === undefined)
+        return undefined;
+    if (!Number.isSafeInteger(value) || value < 1) {
+        throw new RangeError(`Action.make: "${name}" ${field} must be a positive safe integer`);
+    }
+    return value;
+};
+/**
+ * Bounds one attempt by its declared timeouts. An expired bound interrupts the
+ * body and dies with {@link AttemptTimedOut}, which the engine's retry
+ * decision point counts as a retryable attempt failure. A defect the body
+ * raises while it is being interrupted is kept beside the timeout, so the
+ * attempt is not mistaken for a clean timeout and retried past it.
+ *
+ * Every attempt gets its own heartbeat, a no-op without `heartbeatTimeoutMs`,
+ * so a nested action never feeds the watchdog of the action that called it.
+ */
+const boundAttempt = (name, attemptTimeoutMs, heartbeatTimeoutMs) => (effect) => heartbeatTimeoutMs === undefined && attemptTimeoutMs === undefined
+    ? Effect.provideService(effect, CurrentHeartbeat, Effect.void)
+    : Effect.gen(function* () {
+        const attempt = yield* CurrentAttempt;
+        // Each heartbeat completes the signal the watchdog is waiting on and
+        // installs a fresh one. Waiting on sleeps rather than reading the clock
+        // keeps the gap immune to wall-clock adjustments.
+        let signal = Deferred.makeUnsafe();
+        const beat = Effect.sync(() => {
+            const done = signal;
+            signal = Deferred.makeUnsafe();
+            Deferred.doneUnsafe(done, Exit.void);
+        });
+        const expiries = [];
+        if (attemptTimeoutMs !== undefined) {
+            expiries.push(Effect.as(Effect.sleep(attemptTimeoutMs), "attempt"));
+        }
+        if (heartbeatTimeoutMs !== undefined) {
+            expiries.push(Effect.gen(function* () {
+                while (true) {
+                    const beaten = yield* Effect.raceFirst(Effect.as(Deferred.await(signal), true), Effect.as(Effect.sleep(heartbeatTimeoutMs), false));
+                    if (!beaten)
+                        return "heartbeat";
+                }
+            }));
+        }
+        const body = yield* Effect.forkChild(Effect.provideService(effect, CurrentHeartbeat, heartbeatTimeoutMs === undefined ? Effect.void : beat), { startImmediately: true });
+        const outcome = yield* Effect.raceFirst(Fiber.await(body), Effect.raceAll(expiries));
+        if (typeof outcome !== "string")
+            return yield* outcome;
+        yield* Fiber.interrupt(body);
+        // The interruption was requested, so the body cannot settle with an
+        // answer: an uninterruptible region it was in ends in the interrupt.
+        // What remains beside the interrupt is a defect its cleanup raised.
+        const cleanup = yield* Fiber.join(body).pipe(Effect.as([]), Effect.catchCause((cause) => Effect.succeed(cause.reasons.filter((reason) => !Cause.isInterruptReason(reason)))));
+        const timeoutMs = outcome === "attempt" ? attemptTimeoutMs : heartbeatTimeoutMs;
+        const timedOut = new AttemptTimedOut({
+            actionName: name,
+            attempt,
+            bound: outcome,
+            timeoutMs,
+            message: `Action "${name}" attempt ${attempt} ` +
+                (outcome === "attempt" ? `ran past ${timeoutMs}ms` : `sent no heartbeat for ${timeoutMs}ms`)
+        });
+        return yield* Effect.failCause(Cause.fromReasons([Cause.makeDieReason(timedOut), ...cleanup]));
+    });
+const isInfraInterrupt = (value) => Predicate.isTagged("@smthrs/flow/InfraInterrupt")(value);
+const retryInfraInterrupt = (name, policy) => (effect) => policy === undefined
+    ? effect
+    : Effect.suspend(() => {
+        let attempts = 0;
+        return effect.pipe(
+        // Each failed execution reaches this tap once, including the final
+        // failure the schedule declines to retry, so this is the real attempt
+        // count rather than an estimate derived from schedule shape.
+        Effect.tapError((error) => isInfraInterrupt(error)
+            ? Effect.sync(() => void attempts++)
+            : Effect.void), Effect.retry({
+            schedule: policy,
+            while: isInfraInterrupt
+        }), Effect.catch((error) => isInfraInterrupt(error)
+            ? Effect.die(new InfraInterruptRetriesExhausted({
+                actionName: name,
+                attempts,
+                interrupt: error,
+                message: `Action "${name}" infrastructure interrupt retry attempts exhausted after ` +
+                    `${attempts} attempts.`
+            }))
+            : Effect.fail(error)));
+    });
+// Untraced because action execution is retried in the flow hot path.
+const makeExecute = Effect.fnUntraced(function* (action) {
+    const engine = yield* FlowRuntime;
+    const instance = yield* FlowInstance;
+    const attempt = yield* CurrentAttempt;
+    yield* Effect.annotateCurrentSpan({
+        executionId: instance.executionId,
+        action: action.name,
+        attempt,
+        tier: action.tier
+    });
+    const result = yield* FlowHelpers.wrapActionResult(engine.actionExecute(action, attempt), (_) => _._tag === "Suspended");
+    // An action settles with an exit or with a suspension; a handoff is a
+    // FLOW settlement, and the engine's action path never produces one. The
+    // narrowing is written as "not complete" so the third result variant needs
+    // no unreachable arm of its own.
+    if (result._tag !== "Complete") {
+        yield* Effect.annotateCurrentSpan({ outcome: "suspended" });
+        return yield* FlowHelpers.suspend(instance);
+    }
+    yield* Effect.annotateCurrentSpan({ outcome: result.exit._tag === "Success" ? "success" : "failure" });
+    return yield* result.exit;
+}, (effect) => Effect.withSpan(effect, "Action.execute", {
+    captureStackTrace: false
+}));
+//# sourceMappingURL=make.js.map

package/dist/esm/Action/make.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make.js","sourceRoot":"","sources":["../../../src/Action/make.ts"],"names":[],"mappings":"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","sourcesContent":["// Deep reviewed and polished by a human on 2026-08-10.\n\n/**\n * Constructs executable durable action values.\n *\n * @since 0.1.0\n */\n\nimport type * as Effects from \"@smthrs/plan/Effects\"\nimport * as Node from \"@smthrs/plan/Node\"\nimport * as Cause from \"effect/Cause\"\nimport * as Context from \"effect/Context\"\nimport * as Deferred from \"effect/Deferred\"\nimport * as Effect from \"effect/Effect\"\nimport * as Effectable from \"effect/Effectable\"\nimport * as Exit from \"effect/Exit\"\nimport * as Fiber from \"effect/Fiber\"\nimport * as Layer from \"effect/Layer\"\nimport * as Option from \"effect/Option\"\nimport * as Predicate from \"effect/Predicate\"\nimport type * as Schedule from \"effect/Schedule\"\nimport * as Schema from \"effect/Schema\"\nimport type { Scope } from \"effect/Scope\"\nimport type * as Flow from \"../Flow/Flow.ts\"\nimport { makeProto } from \"../Flow/internal.ts\"\nimport * as FlowHelpers from \"../Flow/Runtime.ts\"\nimport { FlowInstance } from \"../FlowRuntime/FlowInstance.ts\"\nimport { FlowRuntime } from \"../FlowRuntime/FlowRuntime.ts\"\nimport { lowerDeclarations } from \"../internal/Declarations.ts\"\nimport * as DeclarationSite from \"../internal/DeclarationSite.ts\"\nimport type * as RetryPolicy from \"../RetryPolicy.ts\"\nimport type { Action, Declared, IdempotencyKey, Requirement, Tier } from \"./Action.ts\"\nimport { AttemptTimedOut } from \"./AttemptTimedOut.ts\"\nimport { CurrentAttempt, CurrentHeartbeat } from \"./Context.ts\"\nimport { FileBoundary } from \"./FileBoundary.ts\"\nimport { type Implementation, Implementations } from \"./Implementations.ts\"\nimport { ImplementationVersionMismatch } from \"./ImplementationVersionMismatch.ts\"\nimport type { InfraInterrupt } from \"./InfraInterrupt.ts\"\nimport { InfraInterruptRetriesExhausted } from \"./InfraInterruptRetriesExhausted.ts\"\nimport { TypeId } from \"./TypeId.ts\"\n\ninterface ExitSchemas {\n  readonly exitSchema: Schema.Exit<any, any, any>\n  readonly exitSchemaPartial: Schema.Exit<any, any, any>\n}\n\n// A declared action mints a fresh inline action per dispatch. Effect caches\n// compiled parsers by AST identity, so the exit schemas are shared per\n// (success, error) pair rather than rebuilt on every dispatch.\nconst exitSchemaCache = new WeakMap<object, WeakMap<object, ExitSchemas>>()\n\nconst exitSchemasFor = (\n  success: Schema.Constraint,\n  error: Schema.Constraint,\n  successJson: Schema.Top,\n  errorJson: Schema.Top\n): ExitSchemas => {\n  let byError = exitSchemaCache.get(success)\n  if (byError === undefined) {\n    byError = new WeakMap()\n    exitSchemaCache.set(success, byError)\n  }\n  let cached = byError.get(error)\n  if (cached === undefined) {\n    cached = {\n      exitSchema: Schema.Exit(successJson, errorJson, Schema.Defect()),\n      exitSchemaPartial: Schema.Exit(successJson, errorJson, Schema.Unknown)\n    }\n    byError.set(error, cached)\n  }\n  return cached\n}\n\n/**\n * The options of a declared action, shared by {@link make}'s declared form and\n * {@link makeSystem}.\n */\ninterface DeclaredOptions<\n  Payload extends Schema.Struct.Fields | Flow.AnyStructSchema,\n  Success extends Schema.Top,\n  Error extends Schema.Top\n> {\n  readonly payload: Payload\n  /**\n   * Native declaration whose source location this reconstructed action retains.\n   * A source with no recorded location preserves that absence. This affects\n   * diagnostics only, never identity; calls still refer to the new declaration.\n   */\n  readonly declaredFrom?: object | undefined\n  readonly implementationVersion?: string | undefined\n  readonly success?: Success | undefined\n  readonly error?: Error | undefined\n  /**\n   * The capability ceiling this action dispatches under, as string literals.\n   *\n   * It is the same ceiling {@link module:Flow/Annotations.Capabilities}\n   * carries, and declaring it here is what makes it READABLE without importing\n   * the module, exactly as `Flow.make`'s option is: a catalog projects a\n   * discovered declaration's authority from the source text of this literal,\n   * and an annotation built at run time is invisible to that projection.\n   *\n   * {@link module:Graph.build} records a `capability_outside_grant` refusal for\n   * every capability named here that the calling flow does not hold. The\n   * refusal is advisory: execution intersects this ceiling with every caller ceiling.\n   */\n  readonly capabilities?: ReadonlyArray<string> | undefined\n  /**\n   * The effect envelope this action dispatches under, as a literal.\n   *\n   * It is the same declaration {@link module:Flow/Annotations.EffectEnvelope}\n   * carries, declared here for the same reason `capabilities` is.\n   *\n   * An action is a leaf, so this envelope encloses nothing; it is checked\n   * against the envelope the calling flow granted, and\n   * {@link module:Graph.build} refuses a dispatch that reads or writes outside\n   * that grant, loosens `hermetic` to `expected`, or raises the tier. `reads`\n   * and `writes` are normalized to sorted, duplicate-free arrays.\n   */\n  readonly effects?: Effects.MakeOptions | undefined\n  readonly tier?: Tier | undefined\n  readonly idempotencyKey?:\n    | IdempotencyKey\n    | ((payload: (Payload extends Schema.Struct.Fields ? Schema.Struct<Payload> : Payload)[\"Type\"]) => IdempotencyKey)\n    | undefined\n  readonly nondeterministic?: true | undefined\n  readonly retryPolicy?: RetryPolicy.RetryPolicy | undefined\n  /**\n   * Milliseconds one attempt may run. A longer attempt is interrupted and\n   * fails with {@link module:AttemptTimedOut.AttemptTimedOut}, which\n   * `retryPolicy` retries like any other attempt failure.\n   */\n  readonly attemptTimeoutMs?: number | undefined\n  /**\n   * Milliseconds one attempt may go without calling\n   * {@link module:Context.heartbeat}, measured from the attempt's start and\n   * then from each heartbeat. A missed heartbeat fails the attempt like\n   * `attemptTimeoutMs`.\n   */\n  readonly heartbeatTimeoutMs?: number | undefined\n  readonly interruptRetryPolicy?: Schedule.Schedule<any, unknown> | undefined\n  readonly fileBoundary?:\n    | FileBoundary\n    | ((payload: (Payload extends Schema.Struct.Fields ? Schema.Struct<Payload> : Payload)[\"Type\"]) => FileBoundary)\n    | undefined\n  readonly annotations?: Context.Context<never> | undefined\n}\n\n/**\n * Creates a flow action from an effect, using the provided schemas to\n * encode successes and failures for durable execution.\n *\n * @category constructors\n * @since 0.1.0\n */\nconst makeInline = <\n  R,\n  Success extends Schema.Constraint = Schema.Void,\n  Error extends Schema.Constraint = Schema.Never\n>(options: {\n  readonly name: string\n  readonly implementationVersion?: string | undefined\n  readonly success?: Success | undefined\n  readonly error?: Error | undefined\n  readonly execute: Effect.Effect<Success[\"Type\"], Error[\"Type\"], R>\n  readonly tier?: Tier | undefined\n  readonly idempotencyKey?: IdempotencyKey | undefined\n  readonly nondeterministic?: true | undefined\n  readonly metadata?: unknown\n  readonly fileBoundary?: FileBoundary | undefined\n  readonly interruptRetryPolicy?: Schedule.Schedule<any, unknown> | undefined\n  readonly retryPolicy?: RetryPolicy.RetryPolicy | undefined\n  readonly attemptTimeoutMs?: number | undefined\n  readonly heartbeatTimeoutMs?: number | undefined\n  readonly annotations?: Context.Context<never> | undefined\n}): Action<Success, Error, Exclude<R, FlowInstance | FlowRuntime | Scope>> => {\n  const implementationVersion = options.implementationVersion === undefined\n    ? undefined\n    : Schema.decodeUnknownSync(Schema.NonEmptyString)(options.implementationVersion)\n  const successSchema = options.success ?? (Schema.Void as any as Success)\n  const errorSchema = options.error ?? (Schema.Never as any as Error)\n  const successSchemaJson = Schema.toCodecJson(successSchema)\n  const errorSchemaJson = Schema.toCodecJson(errorSchema)\n  const exitSchemas = exitSchemasFor(successSchema, errorSchema, successSchemaJson, errorSchemaJson)\n  let execute!: Effect.Effect<Success[\"Type\"], Error[\"Type\"], any>\n  const attemptTimeoutMs = timeoutMs(options.name, \"attemptTimeoutMs\", options.attemptTimeoutMs)\n  const heartbeatTimeoutMs = timeoutMs(options.name, \"heartbeatTimeoutMs\", options.heartbeatTimeoutMs)\n  const executeWithInfraRetry = boundAttempt(options.name, attemptTimeoutMs, heartbeatTimeoutMs)(\n    retryInfraInterrupt(\n      options.name,\n      options.interruptRetryPolicy\n    )(options.execute)\n  )\n  const self: Action<Success, Error, Exclude<R, FlowInstance | FlowRuntime>> = {\n    ...Effectable.Prototype<Action<Success, Error, R>>({\n      label: \"Action\",\n      evaluate(_) {\n        return execute\n      }\n    }),\n    [TypeId]: TypeId,\n    name: options.name,\n    implementationVersion,\n    successSchema,\n    errorSchema,\n    exitSchema: exitSchemas.exitSchema,\n    exitSchemaPartial: exitSchemas.exitSchemaPartial,\n    annotations: options.annotations ?? Context.empty(),\n    tier: options.tier ?? \"sealed\",\n    idempotencyKey: options.idempotencyKey,\n    nondeterministic: options.nondeterministic,\n    metadata: options.fileBoundary === undefined ? options.metadata : FileBoundary.make(options.fileBoundary),\n    fileBoundary: options.fileBoundary === undefined ? undefined : FileBoundary.make(options.fileBoundary),\n    retryPolicy: options.retryPolicy,\n    attemptTimeoutMs,\n    heartbeatTimeoutMs,\n    annotate(tag: Context.Key<any, any>, value: any) {\n      return makeInline({\n        ...options,\n        annotations: Context.add(self.annotations, tag, value)\n      })\n    },\n    annotateMerge(context: Context.Context<any>) {\n      return makeInline({\n        ...options,\n        annotations: Context.merge(self.annotations, context)\n      })\n    },\n    execute: executeWithInfraRetry,\n    executeEncoded: Effect.matchEffect(executeWithInfraRetry, {\n      onFailure: (error) => Effect.flatMap(Effect.orDie(Schema.encodeEffect(errorSchemaJson)(error)), Effect.fail),\n      onSuccess: (value) => Effect.orDie(Schema.encodeEffect(successSchemaJson)(value))\n    })\n  } as any\n  execute = makeExecute(self)\n  return self\n}\n\nconst makeDeclared = <\n  const Tag extends string,\n  Payload extends Schema.Struct.Fields | Flow.AnyStructSchema,\n  Success extends Schema.Top = Schema.Void,\n  Error extends Schema.Top = Schema.Never\n>(tag: Tag, options: DeclaredOptions<Payload, Success, Error>, site: DeclarationSite.DeclaredAt | undefined): Declared<\n  Tag,\n  Payload extends Schema.Struct.Fields ? Schema.Struct<Payload> : Payload,\n  Success,\n  Error\n> => {\n  type PayloadSchema = Payload extends Schema.Struct.Fields ? Schema.Struct<Payload> : Payload\n  const payloadSchema = (Schema.isSchema(options.payload)\n    ? options.payload\n    : Schema.Struct(options.payload)) as PayloadSchema\n  const implementationVersion = options.implementationVersion === undefined\n    ? undefined\n    : Schema.decodeUnknownSync(Schema.NonEmptyString)(options.implementationVersion)\n  const successSchema = options.success ?? (Schema.Void as unknown as Success)\n  const errorSchema = options.error ?? (Schema.Never as unknown as Error)\n  const attemptTimeoutMs = timeoutMs(tag, \"attemptTimeoutMs\", options.attemptTimeoutMs)\n  const heartbeatTimeoutMs = timeoutMs(tag, \"heartbeatTimeoutMs\", options.heartbeatTimeoutMs)\n  const annotations = lowerDeclarations(options)\n  // The literals are already in the bag above, so an annotated copy rebuilds\n  // from options WITHOUT them: re-lowering would overwrite a `Capabilities` or\n  // `EffectEnvelope` the caller annotated on top of the declared one.\n  const lowered: DeclaredOptions<Payload, Success, Error> = {\n    ...options,\n    capabilities: undefined,\n    effects: undefined\n  }\n  // The requirement this declaration mints for itself. Context keys are\n  // compared by their string key, so re-minting one for an annotated copy of\n  // this declaration names the same slot the original does.\n  const requirement = Context.Service<Requirement<Tag>, Implementation>(\n    `@smthrs/flow/Action/Requirement/${tag}`\n  )\n  const self: Declared<Tag, PayloadSchema, Success, Error> = {\n    [TypeId]: TypeId,\n    name: tag,\n    implementationVersion,\n    payloadSchema,\n    successSchema,\n    errorSchema,\n    tier: options.tier ?? \"sealed\",\n    idempotencyKey: options.idempotencyKey,\n    nondeterministic: options.nondeterministic,\n    retryPolicy: options.retryPolicy,\n    attemptTimeoutMs,\n    heartbeatTimeoutMs,\n    fileBoundary: options.fileBoundary,\n    annotations,\n    requirement,\n    annotate(key: Context.Key<any, any>, value: any) {\n      return makeDeclared(tag, {\n        ...lowered,\n        annotations: Context.add(annotations, key, value)\n      }, site)\n    },\n    annotateMerge(context: Context.Context<any>) {\n      return makeDeclared(tag, {\n        ...lowered,\n        annotations: Context.merge(annotations, context)\n      }, site)\n    },\n    call(payload) {\n      return Node.actionCall<Success[\"Type\"], Error[\"Type\"]>(self, tag, payload)\n    },\n    toLayer(execute, registrationOptions) {\n      if (registrationOptions?.implementationVersion !== implementationVersion) {\n        throw new ImplementationVersionMismatch({\n          actionName: tag,\n          declaredVersion: implementationVersion ?? null,\n          registeredVersion: registrationOptions?.implementationVersion ?? null,\n          message: `Action \"${tag}\" requires its declared implementationVersion at registration.`\n        })\n      }\n      // The flow form of this action: same tag, same schemas, and a body that\n      // is the one call to it. Registering that flow is what lets a caller\n      // `execute` the action as a durable execution of its own, and the body\n      // says truthfully what such an execution does. It stays INTERNAL — a flow\n      // carries a body and never a handler, so `Flow` has no `toLayer` for an\n      // author to reach this seam with.\n      //\n      // The private constructor preserves the ordinary flow representation\n      // without importing the public constructor back through this action.\n      const registration = DeclarationSite.annotate(\n        makeProto({\n          _tag: tag,\n          payloadSchema,\n          successSchema,\n          errorSchema,\n          annotations,\n          body: (payload) => Node.actionCall<Success[\"Type\"], Error[\"Type\"]>(self, tag, payload)\n        }),\n        DeclarationSite.capture()\n      )\n      const action = (payload: PayloadSchema[\"Type\"]) =>\n        makeInline({\n          name: tag,\n          implementationVersion,\n          success: successSchema,\n          error: errorSchema,\n          tier: self.tier,\n          idempotencyKey: typeof self.idempotencyKey === \"function\"\n            ? self.idempotencyKey(payload)\n            : self.idempotencyKey,\n          nondeterministic: self.nondeterministic,\n          retryPolicy: options.retryPolicy,\n          attemptTimeoutMs,\n          heartbeatTimeoutMs,\n          interruptRetryPolicy: options.interruptRetryPolicy,\n          fileBoundary: typeof options.fileBoundary === \"function\"\n            ? options.fileBoundary(payload)\n            : options.fileBoundary,\n          annotations,\n          execute: execute(payload)\n        })\n      // The implementation, provided under the requirement this declaration\n      // minted. That is the compile-time half: a body that called this action\n      // produced a node requiring the tag, and this layer is the only thing\n      // that answers it, so a plan cannot reach `execute` without its code.\n      //\n      // The name-keyed table is the run-time half and stays exactly as it was.\n      // A driver expanding a persisted plan has no types left to consult and\n      // resolves by tag, so the same implementation is filed there when a\n      // composition wired a table up. The table is optional on purpose: a\n      // composition that only executes handlers registered directly with the\n      // runtime has no use for it, and requiring it would change what every\n      // existing `toLayer` call site must provide.\n      const implement = Layer.effect(requirement)(Effect.gen(function*() {\n        const services = yield* Effect.context<never>()\n        // The captured context is what the runtime's own `register` captures\n        // for the handler path: the services the implementation was wired with,\n        // overridable by whatever the run provides on top of them.\n        const provided = (payload: unknown) =>\n          Effect.flatMap(\n            // A driver assembles this payload from plan values rather than from\n            // a typed call site, so the declaration validates it exactly as\n            // `Flow.execute` validates a caller's. The cast is the erasure that\n            // hands an unknown to the constructor; `makeEffect` is what decides\n            // whether it was one.\n            Effect.orDie(payloadSchema.makeEffect(payload as never)),\n            (decoded) => action(decoded)\n          ).pipe(Effect.updateContext((input) => Context.merge(services, input) as Context.Context<any>))\n        const implementation: Implementation = {\n          name: tag,\n          ...(implementationVersion === undefined ? {} : { implementationVersion }),\n          action: provided as Implementation[\"action\"]\n        }\n        const table = yield* Effect.serviceOption(Implementations)\n        if (Option.isSome(table)) yield* table.value.add(implementation, registrationOptions)\n        return implementation\n      }))\n      return Layer.merge(\n        Layer.effectDiscard(\n          Effect.flatMap(FlowRuntime, (engine) => engine.register(registration, action))\n        ),\n        implement\n      )\n    }\n  }\n  return DeclarationSite.annotate(self, site)\n}\n\n/**\n * Creates either an inline executable action or a named action\n * declaration, selected by whether the first argument is a string.\n *\n * @category constructors\n * @since 0.1.0\n */\nexport const make: {\n  <\n    const Tag extends string,\n    Payload extends Schema.Struct.Fields | Flow.AnyStructSchema,\n    Success extends Schema.Top = Schema.Void,\n    Error extends Schema.Top = Schema.Never\n  >(tag: Tag, options: DeclaredOptions<Payload, Success, Error>): Declared<\n    Tag,\n    Payload extends Schema.Struct.Fields ? Schema.Struct<Payload> : Payload,\n    Success,\n    Error\n  >\n  <\n    R,\n    Success extends Schema.Constraint = Schema.Void,\n    Error extends Schema.Constraint = Schema.Never\n  >(options: {\n    readonly name: string\n    readonly implementationVersion?: string | undefined\n    readonly success?: Success | undefined\n    readonly error?: Error | undefined\n    readonly execute: Effect.Effect<Success[\"Type\"], Error[\"Type\"], R>\n    readonly tier?: Tier | undefined\n    readonly idempotencyKey?: IdempotencyKey | undefined\n    readonly nondeterministic?: true | undefined\n    readonly metadata?: unknown\n    readonly fileBoundary?: FileBoundary | undefined\n    readonly interruptRetryPolicy?: Schedule.Schedule<any, unknown> | undefined\n    readonly retryPolicy?: RetryPolicy.RetryPolicy | undefined\n    readonly attemptTimeoutMs?: number | undefined\n    readonly heartbeatTimeoutMs?: number | undefined\n    readonly annotations?: Context.Context<never> | undefined\n  }): Action<Success, Error, Exclude<R, FlowInstance | FlowRuntime | Scope>>\n} = ((first: string | Parameters<typeof makeInline>[0], second?: object) => {\n  if (typeof first !== \"string\") return makeInline(first)\n  const options = second as Parameters<typeof makeDeclared>[1]\n  return makeDeclared(\n    first,\n    options,\n    options.declaredFrom === undefined ? DeclarationSite.capture() : DeclarationSite.declaredAt(options.declaredFrom)\n  )\n}) as any\n\n/**\n * Declares a SYSTEM action: one whose implementation ships with the engine\n * rather than with the composition that calls it.\n *\n * It is {@link make}'s declared form in every respect except the requirement.\n * A system declaration mints none, so `.call()` records a node that demands\n * nothing and a body using {@link module:Sleep} or {@link module:WaitFor} does\n * not push a layer obligation onto its callers. That is the whole difference,\n * and it is a deliberate hole in the compile-time enforcement: the engine owns\n * these implementations, so an author cannot be the one who forgot them.\n *\n * Everything else is unchanged — the layer still registers with the runtime and\n * still files itself in {@link module:Implementations.Implementations}, so a\n * driver resolves a system action by tag exactly like any other.\n *\n * @category constructors\n * @since 0.1.0\n */\nexport const makeSystem = <\n  const Tag extends string,\n  Payload extends Schema.Struct.Fields | Flow.AnyStructSchema,\n  Success extends Schema.Top = Schema.Void,\n  Error extends Schema.Top = Schema.Never\n>(tag: Tag, options: DeclaredOptions<Payload, Success, Error>): Declared<\n  Tag,\n  Payload extends Schema.Struct.Fields ? Schema.Struct<Payload> : Payload,\n  Success,\n  Error,\n  never\n> =>\n  // The erasure IS the declaration: the value still provides its requirement\n  // from `toLayer`, and dropping it from `call` only means nothing asks for it.\n  // Providing a service no one requires is always sound; the reverse would not\n  // be, which is why this is the one place the channel is written off.\n  makeDeclared(\n    tag,\n    options,\n    options.declaredFrom === undefined ? DeclarationSite.capture() : DeclarationSite.declaredAt(options.declaredFrom)\n  ) as unknown as Declared<\n    Tag,\n    Payload extends Schema.Struct.Fields ? Schema.Struct<Payload> : Payload,\n    Success,\n    Error,\n    never\n  >\n\n/**\n * Validates one declared attempt bound. An invalid bound is a programmer\n * error thrown at declaration, like `Flow.make`'s `maxRounds`.\n */\nconst timeoutMs = (name: string, field: string, value: number | undefined): number | undefined => {\n  if (value === undefined) return undefined\n  if (!Number.isSafeInteger(value) || value < 1) {\n    throw new RangeError(`Action.make: \"${name}\" ${field} must be a positive safe integer`)\n  }\n  return value\n}\n\n/**\n * Bounds one attempt by its declared timeouts. An expired bound interrupts the\n * body and dies with {@link AttemptTimedOut}, which the engine's retry\n * decision point counts as a retryable attempt failure. A defect the body\n * raises while it is being interrupted is kept beside the timeout, so the\n * attempt is not mistaken for a clean timeout and retried past it.\n *\n * Every attempt gets its own heartbeat, a no-op without `heartbeatTimeoutMs`,\n * so a nested action never feeds the watchdog of the action that called it.\n */\nconst boundAttempt = (\n  name: string,\n  attemptTimeoutMs: number | undefined,\n  heartbeatTimeoutMs: number | undefined\n) =>\n<A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R> =>\n  heartbeatTimeoutMs === undefined && attemptTimeoutMs === undefined\n    ? Effect.provideService(effect, CurrentHeartbeat, Effect.void)\n    : Effect.gen(function*() {\n      const attempt = yield* CurrentAttempt\n      // Each heartbeat completes the signal the watchdog is waiting on and\n      // installs a fresh one. Waiting on sleeps rather than reading the clock\n      // keeps the gap immune to wall-clock adjustments.\n      let signal = Deferred.makeUnsafe<void>()\n      const beat = Effect.sync(() => {\n        const done = signal\n        signal = Deferred.makeUnsafe<void>()\n        Deferred.doneUnsafe(done, Exit.void)\n      })\n      const expiries: Array<Effect.Effect<AttemptTimedOut[\"bound\"]>> = []\n      if (attemptTimeoutMs !== undefined) {\n        expiries.push(Effect.as(Effect.sleep(attemptTimeoutMs), \"attempt\" as const))\n      }\n      if (heartbeatTimeoutMs !== undefined) {\n        expiries.push(Effect.gen(function*() {\n          while (true) {\n            const beaten = yield* Effect.raceFirst(\n              Effect.as(Deferred.await(signal), true),\n              Effect.as(Effect.sleep(heartbeatTimeoutMs), false)\n            )\n            if (!beaten) return \"heartbeat\" as const\n          }\n        }))\n      }\n      const body = yield* Effect.forkChild(\n        Effect.provideService(effect, CurrentHeartbeat, heartbeatTimeoutMs === undefined ? Effect.void : beat),\n        { startImmediately: true }\n      )\n      const outcome = yield* Effect.raceFirst(\n        Fiber.await(body),\n        Effect.raceAll(expiries)\n      )\n      if (typeof outcome !== \"string\") return yield* outcome\n      yield* Fiber.interrupt(body)\n      // The interruption was requested, so the body cannot settle with an\n      // answer: an uninterruptible region it was in ends in the interrupt.\n      // What remains beside the interrupt is a defect its cleanup raised.\n      const cleanup = yield* Fiber.join(body).pipe(\n        Effect.as([]),\n        Effect.catchCause((cause) => Effect.succeed(cause.reasons.filter((reason) => !Cause.isInterruptReason(reason))))\n      )\n      const timeoutMs = outcome === \"attempt\" ? attemptTimeoutMs! : heartbeatTimeoutMs!\n      const timedOut = new AttemptTimedOut({\n        actionName: name,\n        attempt,\n        bound: outcome,\n        timeoutMs,\n        message: `Action \"${name}\" attempt ${attempt} ` +\n          (outcome === \"attempt\" ? `ran past ${timeoutMs}ms` : `sent no heartbeat for ${timeoutMs}ms`)\n      })\n      return yield* Effect.failCause(Cause.fromReasons([Cause.makeDieReason(timedOut), ...cleanup]))\n    })\n\nconst isInfraInterrupt = (value: unknown): value is InfraInterrupt =>\n  Predicate.isTagged(\"@smthrs/flow/InfraInterrupt\")(value)\n\nconst retryInfraInterrupt = (\n  name: string,\n  policy: Schedule.Schedule<any, unknown> | undefined\n) =>\n<A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R> =>\n  policy === undefined\n    ? effect\n    : Effect.suspend(() => {\n      let attempts = 0\n      return effect.pipe(\n        // Each failed execution reaches this tap once, including the final\n        // failure the schedule declines to retry, so this is the real attempt\n        // count rather than an estimate derived from schedule shape.\n        Effect.tapError((error) =>\n          isInfraInterrupt(error)\n            ? Effect.sync(() => void attempts++)\n            : Effect.void\n        ),\n        Effect.retry({\n          schedule: policy,\n          while: isInfraInterrupt\n        }),\n        Effect.catch((error) =>\n          isInfraInterrupt(error)\n            ? Effect.die(\n              new InfraInterruptRetriesExhausted({\n                actionName: name,\n                attempts,\n                interrupt: error,\n                message: `Action \"${name}\" infrastructure interrupt retry attempts exhausted after ` +\n                  `${attempts} attempts.`\n              })\n            )\n            : Effect.fail(error)\n        )\n      )\n    })\n\n// Untraced because action execution is retried in the flow hot path.\nconst makeExecute = Effect.fnUntraced(function*<\n  R,\n  Success extends Schema.Constraint = typeof Schema.Void,\n  Error extends Schema.Constraint = typeof Schema.Never\n>(action: Action<Success, Error, R>) {\n  const engine = yield* FlowRuntime\n  const instance = yield* FlowInstance\n  const attempt = yield* CurrentAttempt\n  yield* Effect.annotateCurrentSpan({\n    executionId: instance.executionId,\n    action: action.name,\n    attempt,\n    tier: action.tier\n  })\n  const result = yield* FlowHelpers.wrapActionResult(\n    engine.actionExecute(action, attempt),\n    (_) => _._tag === \"Suspended\"\n  )\n  // An action settles with an exit or with a suspension; a handoff is a\n  // FLOW settlement, and the engine's action path never produces one. The\n  // narrowing is written as \"not complete\" so the third result variant needs\n  // no unreachable arm of its own.\n  if (result._tag !== \"Complete\") {\n    yield* Effect.annotateCurrentSpan({ outcome: \"suspended\" })\n    return yield* FlowHelpers.suspend(instance)\n  }\n  yield* Effect.annotateCurrentSpan({ outcome: result.exit._tag === \"Success\" ? \"success\" : \"failure\" })\n  return yield* result.exit\n}, (effect) =>\n  Effect.withSpan(effect, \"Action.execute\", {\n    captureStackTrace: false\n  }))\n"]}

package/dist/esm/Action/raceAll.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Races actions through durable deferred execution.
+ *
+ * @since 0.1.0
+ */
+import type { NonEmptyReadonlyArray } from "effect/Array";
+import type * as Effect from "effect/Effect";
+import type { FlowInstance, FlowRuntime } from "../FlowRuntime/index.ts";
+import type { Action, Any } from "./Action.ts";
+/**
+ * Runs a non-empty collection of actions as a durable race and returns the
+ * first success using unioned success and error schemas. A losing failure is
+ * ignored while another action is still running; the race fails only when
+ * every action fails. To settle on whichever action exits first, success or
+ * failure, race `Effect.exit` of each action and unwrap the winning exit.
+ *
+ * @category racing
+ * @since 0.1.0
+ */
+export declare const raceAll: <const Actions extends NonEmptyReadonlyArray<Any>>(name: string, actions: Actions) => Effect.Effect<Actions[number] extends Action<infer _A, infer _E, infer _R> ? _A["Type"] : never, Actions[number] extends Action<infer _A, infer _E_1, infer _R_1> ? _E_1["Type"] : never, Effect.Services<Actions[number]> | (Actions[number] extends Action<infer Success, infer Error, infer _R_2> ? Success["DecodingServices"] | Success["EncodingServices"] | Error["DecodingServices"] | Error["EncodingServices"] : never) | FlowRuntime | FlowInstance>;
+//# sourceMappingURL=raceAll.d.ts.map

package/dist/esm/Action/raceAll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raceAll.d.ts","sourceRoot":"","sources":["../../../src/Action/raceAll.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAG5C,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AAE9C;;;;;;;;;GASG;AACH,eAAO,MAAM,OAAO,GAAI,KAAK,CAAC,OAAO,SAAS,qBAAqB,CAAC,GAAG,CAAC,EACtE,MAAM,MAAM,EACZ,SAAS,OAAO,KACf,MAAM,CAAC,MAAM,CACd,OAAO,CAAC,MAAM,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,EACjF,OAAO,CAAC,MAAM,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,EAAE,MAAM,IAAE,EAAE,MAAM,IAAE,CAAC,GAAG,IAAE,CAAC,MAAM,CAAC,GAAG,KAAK,EAC/E,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAChC,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,MAAM,CAAC,MAAM,OAAO,EAAE,MAAM,KAAK,EAAE,MAAM,IAAE,CAAC,GACnE,OAAO,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,GAAG,KAAK,CAAC,kBAAkB,CAAC,GAAG,KAAK,CAAC,kBAAkB,CAAC,GACjH,KAAK,CAAC,GACR,WAAW,GACX,YAAY,CAWL,CAAA"}

package/dist/esm/Action/raceAll.js

@@ -0,0 +1,20 @@
+// Deep reviewed and polished by a human on 2026-08-10.
+import * as Schema from "effect/Schema";
+import * as DurableDeferred from "../DurableDeferred.js";
+/**
+ * Runs a non-empty collection of actions as a durable race and returns the
+ * first success using unioned success and error schemas. A losing failure is
+ * ignored while another action is still running; the race fails only when
+ * every action fails. To settle on whichever action exits first, success or
+ * failure, race `Effect.exit` of each action and unwrap the winning exit.
+ *
+ * @category racing
+ * @since 0.1.0
+ */
+export const raceAll = (name, actions) => DurableDeferred.raceAll({
+    name: `Action/${name}`,
+    success: Schema.Union(actions.map((action) => action.successSchema)),
+    error: Schema.Union(actions.map((action) => action.errorSchema)),
+    effects: actions.map((action) => action)
+});
+//# sourceMappingURL=raceAll.js.map

package/dist/esm/Action/raceAll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raceAll.js","sourceRoot":"","sources":["../../../src/Action/raceAll.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAUvD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,eAAe,MAAM,uBAAuB,CAAA;AAIxD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,IAAY,EACZ,OAAgB,EAUhB,EAAE,CACF,eAAe,CAAC,OAAO,CAAC;IACtB,IAAI,EAAE,UAAU,IAAI,EAAE;IACtB,OAAO,EAAE,MAAM,CAAC,KAAK,CACnB,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAE,MAAc,CAAC,aAAa,CAAC,CACvD;IACD,KAAK,EAAE,MAAM,CAAC,KAAK,CACjB,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAE,MAAc,CAAC,WAAW,CAAC,CACrD;IACD,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAE,MAAc,CAAQ;CACzD,CAAQ,CAAA","sourcesContent":["// Deep reviewed and polished by a human on 2026-08-10.\n\n/**\n * Races actions through durable deferred execution.\n *\n * @since 0.1.0\n */\n\nimport type { NonEmptyReadonlyArray } from \"effect/Array\"\nimport type * as Effect from \"effect/Effect\"\nimport * as Schema from \"effect/Schema\"\nimport * as DurableDeferred from \"../DurableDeferred.ts\"\nimport type { FlowInstance, FlowRuntime } from \"../FlowRuntime/index.ts\"\nimport type { Action, Any } from \"./Action.ts\"\n\n/**\n * Runs a non-empty collection of actions as a durable race and returns the\n * first success using unioned success and error schemas. A losing failure is\n * ignored while another action is still running; the race fails only when\n * every action fails. To settle on whichever action exits first, success or\n * failure, race `Effect.exit` of each action and unwrap the winning exit.\n *\n * @category racing\n * @since 0.1.0\n */\nexport const raceAll = <const Actions extends NonEmptyReadonlyArray<Any>>(\n  name: string,\n  actions: Actions\n): Effect.Effect<\n  Actions[number] extends Action<infer _A, infer _E, infer _R> ? _A[\"Type\"] : never,\n  Actions[number] extends Action<infer _A, infer _E, infer _R> ? _E[\"Type\"] : never,\n  | Effect.Services<Actions[number]>\n  | (Actions[number] extends Action<infer Success, infer Error, infer _R>\n    ? Success[\"DecodingServices\"] | Success[\"EncodingServices\"] | Error[\"DecodingServices\"] | Error[\"EncodingServices\"]\n    : never)\n  | FlowRuntime\n  | FlowInstance\n> =>\n  DurableDeferred.raceAll({\n    name: `Action/${name}`,\n    success: Schema.Union(\n      actions.map((action) => (action as any).successSchema)\n    ),\n    error: Schema.Union(\n      actions.map((action) => (action as any).errorSchema)\n    ),\n    effects: actions.map((action) => (action as any)) as any\n  }) as any\n"]}

package/dist/esm/Action/retry.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Retries effects while preserving durable action identity.
+ *
+ * @since 0.1.0
+ */
+import * as Effect from "effect/Effect";
+import type * as Types from "effect/Types";
+/**
+ * Retries an effect with `Effect.retry` while updating `CurrentAttempt` for
+ * each attempt.
+ *
+ * @category error handling
+ * @since 0.1.0
+ */
+export declare const retry: {
+    <E, O extends Types.NoExcessProperties<Omit<Effect.Retry.Options<E>, "schedule">, O>>(options: O): <A, R>(self: Effect.Effect<A, E, R>) => Effect.Retry.Return<R, E, A, O>;
+    <A, E, R, O extends Types.NoExcessProperties<Omit<Effect.Retry.Options<E>, "schedule">, O>>(self: Effect.Effect<A, E, R>, options: O): Effect.Retry.Return<R, E, A, O>;
+};
+//# sourceMappingURL=retry.d.ts.map

package/dist/esm/Action/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/Action/retry.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAA;AAG1C;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,EAAE;IAClB,CAAC,CAAC,EAAE,CAAC,SAAS,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,EAClF,OAAO,EAAE,CAAC,GACT,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAC1E,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,EACxF,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC5B,OAAO,EAAE,CAAC,GACT,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;CAgEnC,CAAA"}