@lunora/workflow 1.0.0-alpha.4 → 1.0.0-alpha.6

package/dist/do/index.d.mts

@@ -1,5 +1,5 @@
 import { WorkflowEntrypoint, WorkflowEvent, WorkflowStep } from 'cloudflare:workers';
-import { W as WorkflowDefinition } from "../packem_shared/types.d-Fdeu2P2C.mjs";
+import { W as WorkflowDefinition } from "../packem_shared/types.d-C9W6rEWv.mjs";
 import '@lunora/values';
 /**
 * Base class for the generated `WorkflowEntrypoint` classes. Applies a

package/dist/do/index.d.ts

@@ -1,5 +1,5 @@
 import { WorkflowEntrypoint, WorkflowEvent, WorkflowStep } from 'cloudflare:workers';
-import { W as WorkflowDefinition } from "../packem_shared/types.d-Fdeu2P2C.js";
+import { W as WorkflowDefinition } from "../packem_shared/types.d-C9W6rEWv.js";
 import '@lunora/values';
 /**
 * Base class for the generated `WorkflowEntrypoint` classes. Applies a

package/dist/do/index.mjs

@@ -1,8 +1,8 @@
 import { WorkflowEntrypoint } from 'cloudflare:workers';
 import { NonRetryableError } from 'cloudflare:workflows';
 import { convertNonRetryableError } from '../packem_shared/NonRetryableError-Dn2dTyBS.mjs';
-import { stripBranchMarker, signalBranchParent, extractBranchMarker, errorOutcome, okOutcome } from '../packem_shared/MAX_BRANCHES-C9MJIFii.mjs';
-import { createWorkflowRunContext } from '../packem_shared/createWorkflowRunContext-BsMyGuMR.mjs';
+import { stripBranchMarker, signalBranchParent, extractBranchMarker, errorOutcome, okOutcome } from '../packem_shared/MAX_BRANCHES-D6cQabJ1.mjs';
+import { createWorkflowRunContext } from '../packem_shared/createWorkflowRunContext-C09mSbgk.mjs';
 
 class LunoraWorkflow extends WorkflowEntrypoint {
   /** The `lunora/workflows.ts` export name, for log correlation. */

package/dist/index.d.mts

@@ -1,5 +1,6 @@
-import { a as Workflows, L as LunoraWorkflowsOptions, S as StepArgsValidator, b as StepConfig, c as StepDefinition, d as WorkflowConfig, W as WorkflowDefinition, e as WorkflowBranch, f as WorkflowInstanceStatus, g as WorkflowEventLike, h as WorkflowStepLike, i as WorkflowRunContext, j as WorkflowLogger, k as WorkflowRunFunction, l as WorkflowRunStepFunction } from "./packem_shared/types.d-Fdeu2P2C.mjs";
-export type { A as ArgsOf, F as FunctionReference, I as InferStepArgs, R as RunFunctionOptions, m as RunStepOptions, n as StepHandler, o as StepRollbackContext, p as StepRollbackHandler, q as StepRunContext, r as WorkflowBindingLike, s as WorkflowBranchOutputs, t as WorkflowCreateOptions, u as WorkflowHandle, v as WorkflowHandler, w as WorkflowInstanceLike, x as WorkflowParallelFunction, y as WorkflowRollbackContextLike, z as WorkflowRollbackHandlerLike, B as WorkflowSpawnFunction, C as WorkflowSpawnOptions, D as WorkflowStatusResult, E as WorkflowStepConfigLike, G as WorkflowStepContextLike, H as WorkflowStepRollbackOptionsLike } from "./packem_shared/types.d-Fdeu2P2C.mjs";
+import { a as Workflows, L as LunoraWorkflowsOptions, S as StepArgsValidator, b as StepConfig, c as StepDefinition, d as WorkflowConfig, W as WorkflowDefinition, e as WorkflowBranch, f as WorkflowInstanceStatus, g as WorkflowEventLike, h as WorkflowStepLike, i as WorkflowRunContext, j as WorkflowLogger, k as WorkflowRunFunction, l as WorkflowRunStepFunction } from "./packem_shared/types.d-C9W6rEWv.mjs";
+export type { A as ArgsOf, B as BranchCompensationParams, F as FunctionReference, I as InferStepArgs, R as RunFunctionOptions, m as RunStepOptions, n as StepHandler, o as StepRollbackContext, p as StepRollbackHandler, q as StepRunContext, r as WorkflowBindingLike, s as WorkflowBranchOutputs, t as WorkflowCreateOptions, u as WorkflowHandle, v as WorkflowHandler, w as WorkflowInstanceLike, x as WorkflowParallelFunction, y as WorkflowRollbackContextLike, z as WorkflowRollbackHandlerLike, C as WorkflowSpawnFunction, D as WorkflowSpawnOptions, E as WorkflowStatusResult, G as WorkflowStepConfigLike, H as WorkflowStepContextLike, J as WorkflowStepRollbackOptionsLike } from "./packem_shared/types.d-C9W6rEWv.mjs";
+import { LunoraError } from '@lunora/errors';
 import '@lunora/values';
 /** Wiring info for one declared workflow, emitted by codegen into the generated shard. */
 interface WorkflowBindingSpec {
@@ -142,6 +143,7 @@ declare const MAX_BRANCHES = 100;
 * tuple — e.g. `branch("imageTag", { key })` typed as `branch` of `{ tags }`.
 */
 declare const branch: <Output = unknown>(workflow: string, params?: Record<string, unknown>, options?: {
+  compensateWith?: string;
   id?: string;
   timeout?: number | string;
 }) => WorkflowBranch<Output>;
@@ -193,8 +195,7 @@ interface WorkflowInstancePage {
   totalCount?: number;
 }
 /** Thrown when the REST API responds non-2xx or `success: false`; carries the status plus body for the caller to surface. */
-declare class WorkflowsRestError extends Error {
-  readonly status: number;
+declare class WorkflowsRestError extends LunoraError {
   constructor(status: number, body: string);
 }
 /** The observe client: list instances, read one instance's steps, and (with Edit scope) mutate its status. */

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-import { a as Workflows, L as LunoraWorkflowsOptions, S as StepArgsValidator, b as StepConfig, c as StepDefinition, d as WorkflowConfig, W as WorkflowDefinition, e as WorkflowBranch, f as WorkflowInstanceStatus, g as WorkflowEventLike, h as WorkflowStepLike, i as WorkflowRunContext, j as WorkflowLogger, k as WorkflowRunFunction, l as WorkflowRunStepFunction } from "./packem_shared/types.d-Fdeu2P2C.js";
-export type { A as ArgsOf, F as FunctionReference, I as InferStepArgs, R as RunFunctionOptions, m as RunStepOptions, n as StepHandler, o as StepRollbackContext, p as StepRollbackHandler, q as StepRunContext, r as WorkflowBindingLike, s as WorkflowBranchOutputs, t as WorkflowCreateOptions, u as WorkflowHandle, v as WorkflowHandler, w as WorkflowInstanceLike, x as WorkflowParallelFunction, y as WorkflowRollbackContextLike, z as WorkflowRollbackHandlerLike, B as WorkflowSpawnFunction, C as WorkflowSpawnOptions, D as WorkflowStatusResult, E as WorkflowStepConfigLike, G as WorkflowStepContextLike, H as WorkflowStepRollbackOptionsLike } from "./packem_shared/types.d-Fdeu2P2C.js";
+import { a as Workflows, L as LunoraWorkflowsOptions, S as StepArgsValidator, b as StepConfig, c as StepDefinition, d as WorkflowConfig, W as WorkflowDefinition, e as WorkflowBranch, f as WorkflowInstanceStatus, g as WorkflowEventLike, h as WorkflowStepLike, i as WorkflowRunContext, j as WorkflowLogger, k as WorkflowRunFunction, l as WorkflowRunStepFunction } from "./packem_shared/types.d-C9W6rEWv.js";
+export type { A as ArgsOf, B as BranchCompensationParams, F as FunctionReference, I as InferStepArgs, R as RunFunctionOptions, m as RunStepOptions, n as StepHandler, o as StepRollbackContext, p as StepRollbackHandler, q as StepRunContext, r as WorkflowBindingLike, s as WorkflowBranchOutputs, t as WorkflowCreateOptions, u as WorkflowHandle, v as WorkflowHandler, w as WorkflowInstanceLike, x as WorkflowParallelFunction, y as WorkflowRollbackContextLike, z as WorkflowRollbackHandlerLike, C as WorkflowSpawnFunction, D as WorkflowSpawnOptions, E as WorkflowStatusResult, G as WorkflowStepConfigLike, H as WorkflowStepContextLike, J as WorkflowStepRollbackOptionsLike } from "./packem_shared/types.d-C9W6rEWv.js";
+import { LunoraError } from '@lunora/errors';
 import '@lunora/values';
 /** Wiring info for one declared workflow, emitted by codegen into the generated shard. */
 interface WorkflowBindingSpec {
@@ -142,6 +143,7 @@ declare const MAX_BRANCHES = 100;
 * tuple — e.g. `branch("imageTag", { key })` typed as `branch` of `{ tags }`.
 */
 declare const branch: <Output = unknown>(workflow: string, params?: Record<string, unknown>, options?: {
+  compensateWith?: string;
   id?: string;
   timeout?: number | string;
 }) => WorkflowBranch<Output>;
@@ -193,8 +195,7 @@ interface WorkflowInstancePage {
   totalCount?: number;
 }
 /** Thrown when the REST API responds non-2xx or `success: false`; carries the status plus body for the caller to surface. */
-declare class WorkflowsRestError extends Error {
-  readonly status: number;
+declare class WorkflowsRestError extends LunoraError {
   constructor(status: number, body: string);
 }
 /** The observe client: list instances, read one instance's steps, and (with Edit scope) mutate its status. */

package/dist/index.mjs

@@ -1,9 +1,9 @@
-export { createWorkflowContext } from './packem_shared/createWorkflowContext-D6thzmlF.mjs';
-export { default as createWorkflows } from './packem_shared/createWorkflows-BoSYVIXg.mjs';
+export { createWorkflowContext } from './packem_shared/createWorkflowContext-DfSgBq5I.mjs';
+export { default as createWorkflows } from './packem_shared/createWorkflows-BC1Mwjwe.mjs';
 export { defineStep, isStepDefinition } from './packem_shared/defineStep-DJQtLw7g.mjs';
 export { defineWorkflow, isWorkflowDefinition, workflowBindingName, workflowClassName, workflowDefaultName } from './packem_shared/defineWorkflow-DbUC-oCN.mjs';
 export { NonRetryableError, convertNonRetryableError, isNonRetryableError, toNativeNonRetryableError } from './packem_shared/NonRetryableError-Dn2dTyBS.mjs';
-export { MAX_BRANCHES, branch } from './packem_shared/MAX_BRANCHES-C9MJIFii.mjs';
-export { WorkflowsRestError, createWorkflowsRestClient } from './packem_shared/WorkflowsRestError-b06i7K5j.mjs';
-export { createWorkflowRunContext } from './packem_shared/createWorkflowRunContext-BsMyGuMR.mjs';
+export { MAX_BRANCHES, branch } from './packem_shared/MAX_BRANCHES-D6cQabJ1.mjs';
+export { WorkflowsRestError, createWorkflowsRestClient } from './packem_shared/WorkflowsRestError-zmjOxTR1.mjs';
+export { createWorkflowRunContext } from './packem_shared/createWorkflowRunContext-C09mSbgk.mjs';
 export { createRunStep, validateStepArgs } from './packem_shared/createRunStep-8jOXxP2o.mjs';

package/dist/packem_shared/{MAX_BRANCHES-C9MJIFii.mjs → MAX_BRANCHES-D6cQabJ1.mjs}

@@ -5,9 +5,10 @@ const BRANCH_MARKER_KEY = "__lunoraBranch";
 const SPAWN_STEP_PREFIX = "lunora:spawn:";
 const AWAIT_STEP_PREFIX = "lunora:await:";
 const SIGNAL_STEP_PREFIX = "lunora:signal:";
+const COMPENSATE_STEP_PREFIX = "lunora:compensate:";
 const BRANCH_EVENT_PREFIX = "lunora:branch:";
 const branch = (workflow, params, options) => {
-  return { id: options?.id, params, timeout: options?.timeout, workflow };
+  return { compensateWith: options?.compensateWith, id: options?.id, params, timeout: options?.timeout, workflow };
 };
 const serializeError = (error) => {
   if (error instanceof Error) {
@@ -21,6 +22,26 @@ const okOutcome = (value) => {
 const errorOutcome = (error) => {
   return { error: serializeError(error), status: "error" };
 };
+const compensateCompleted = async (deps, completed, error) => {
+  for (let cursor = completed.length - 1; cursor >= 0; cursor -= 1) {
+    const done = completed[cursor];
+    const compensateWith = done?.plan.item.compensateWith;
+    if (done === void 0 || compensateWith === void 0) {
+      continue;
+    }
+    await deps.step.do(`${COMPENSATE_STEP_PREFIX}${done.plan.childId}`, async () => {
+      const compensateId = `${done.plan.childId}:compensate`;
+      const compensationParams = {
+        branch: done.plan.item.workflow,
+        error,
+        index: done.plan.index,
+        output: done.output
+      };
+      await deps.resolveBinding(compensateWith).create({ id: compensateId, params: compensationParams });
+      return compensateId;
+    });
+  }
+};
 const createParallel = (deps) => {
   const run = async (branches) => {
     if (branches.length === 0) {
@@ -46,6 +67,7 @@ const createParallel = (deps) => {
       )
     );
     const results = [];
+    const completed = [];
     for (const plan of planned) {
       const event = await deps.step.waitForEvent(`${AWAIT_STEP_PREFIX}${plan.childId}`, {
         timeout: plan.item.timeout,
@@ -53,8 +75,10 @@ const createParallel = (deps) => {
       });
       const outcome = event.payload;
       if (outcome.status === "error") {
+        await compensateCompleted(deps, completed, outcome.error);
         throw new NonRetryableError(`ctx.parallel: branch "${plan.item.workflow}" (#${String(plan.index)}) failed: ${outcome.error.message}`);
       }
+      completed.push({ output: outcome.value, plan });
       results.push(outcome.value);
     }
     return results;

package/dist/packem_shared/{WorkflowsRestError-b06i7K5j.mjs → WorkflowsRestError-zmjOxTR1.mjs}

@@ -1,3 +1,5 @@
+import { LunoraError } from '@lunora/errors';
+
 const API_BASE = "https://api.cloudflare.com/client/v4/accounts";
 const KNOWN_STATUSES = {
   complete: true,
@@ -41,12 +43,9 @@ const toStep = (raw) => {
     type: asString(raw["type"])
   };
 };
-class WorkflowsRestError extends Error {
-  status;
+class WorkflowsRestError extends LunoraError {
   constructor(status, body) {
-    super(`Cloudflare Workflows REST API returned ${String(status)}: ${body}`);
-    this.name = "WorkflowsRestError";
-    this.status = status;
+    super("WORKFLOWS_REST_ERROR", `Cloudflare Workflows REST API returned ${String(status)}: ${body}`, { name: "WorkflowsRestError", status });
   }
 }
 const createWorkflowsRestClient = (config) => {

package/dist/packem_shared/{createWorkflowContext-D6thzmlF.mjs → createWorkflowContext-DfSgBq5I.mjs}

@@ -1,4 +1,4 @@
-import createWorkflows from './createWorkflows-BoSYVIXg.mjs';
+import createWorkflows from './createWorkflows-BC1Mwjwe.mjs';
 
 const createWorkflowContext = (env, specs) => {
   const bindings = {};

package/dist/packem_shared/{createWorkflowRunContext-BsMyGuMR.mjs → createWorkflowRunContext-C09mSbgk.mjs}

@@ -1,5 +1,6 @@
+import { LunoraError } from '@lunora/errors';
 import { workflowBindingName } from './defineWorkflow-DbUC-oCN.mjs';
-import { createSpawn, createParallel } from './MAX_BRANCHES-C9MJIFii.mjs';
+import { createSpawn, createParallel } from './MAX_BRANCHES-D6cQabJ1.mjs';
 import { createRunStep } from './createRunStep-8jOXxP2o.mjs';
 
 const createDispatchLogger = (prefix) => {
@@ -37,11 +38,11 @@ const createDispatchRunner = (options) => {
     }
     const origin = options.env.LUNORA_ORIGIN_URL;
     if (typeof origin !== "string" || origin.length === 0) {
-      throw new Error(`${label}: \`LUNORA_ORIGIN_URL\` must be set on the Worker env so a handler can call back into Lunora functions`);
+      throw new LunoraError("INTERNAL", `${label}: \`LUNORA_ORIGIN_URL\` must be set on the Worker env so a handler can call back into Lunora functions`);
     }
     const token = options.env.LUNORA_ADMIN_TOKEN;
     if (typeof token !== "string" || token.length === 0) {
-      throw new Error(`${label}: \`LUNORA_ADMIN_TOKEN\` must be set on the Worker env to authenticate function dispatch`);
+      throw new LunoraError("INTERNAL", `${label}: \`LUNORA_ADMIN_TOKEN\` must be set on the Worker env to authenticate function dispatch`);
     }
     const url = `${trimTrailingSlashes(origin)}${SCHEDULER_DISPATCH_PATH}`;
     const response = await fetchImpl(url, {
@@ -50,7 +51,7 @@ const createDispatchRunner = (options) => {
       method: "POST"
     });
     if (!response.ok) {
-      throw new Error(`${label}: function dispatch failed (${String(response.status)}): ${await response.text()}`);
+      throw new LunoraError("INTERNAL", `${label}: function dispatch failed (${String(response.status)}): ${await response.text()}`);
     }
     const text = await response.text();
     if (text.length === 0) {
@@ -71,7 +72,8 @@ const createWorkflowRunContext = (options) => {
     const bindingName = workflowBindingName(workflow);
     const binding = options.env[bindingName];
     if (!binding || typeof binding.create !== "function" || typeof binding.get !== "function") {
-      throw new Error(
+      throw new LunoraError(
+        "INTERNAL",
         `@lunora/workflow: cannot spawn child workflow "${workflow}" — no Workflow binding "${bindingName}" on env (is it declared in lunora/workflows.ts?)`
       );
     }

package/dist/packem_shared/{createWorkflows-BoSYVIXg.mjs → createWorkflows-BC1Mwjwe.mjs}

@@ -1,3 +1,5 @@
+import { LunoraError } from '@lunora/errors';
+
 const handleFor = (binding) => {
   return {
     create: async (options) => binding.create(options),
@@ -13,7 +15,7 @@ const createWorkflows = (options) => {
       if (binding === void 0) {
         const known = Object.keys(bindings);
         const suffix = known.length === 0 ? "no workflows are declared" : `known workflows: ${known.join(", ")}`;
-        throw new Error(`@lunora/workflow: no workflow named "${name}" (${suffix})`);
+        throw new LunoraError("INTERNAL", `@lunora/workflow: no workflow named "${name}" (${suffix})`);
       }
       return handleFor(binding);
     }

package/dist/packem_shared/{types.d-Fdeu2P2C.d.mts → types.d-C9W6rEWv.d.mts}

@@ -272,6 +272,16 @@ type WorkflowRunStepFunction = <A extends StepArgsValidator, Result>(step: StepD
 interface WorkflowBranch<Output = unknown> {
   /** Phantom marker for the branch output type — never present at runtime. */
   readonly __output?: Output;
+  /**
+  * Optional group-saga compensation (plan 075 Phase 3): the `lunora/workflows.ts`
+  * export name of a workflow to run if a **sibling** branch in the same
+  * `ctx.parallel(...)` group fails **after** this branch has already completed.
+  * It is spawned fire-and-forget (a durable, replay-safe idempotent create) with
+  * {@link BranchCompensationParams} as its `ctx.params`. Omit for no
+  * compensation — a group where no branch sets this behaves exactly as a plain
+  * fan-out (fail-fast, no rollback).
+  */
+  readonly compensateWith?: string;
   /** Optional explicit child instance id (defaults to a deterministic parent-derived id). */
   readonly id?: string;
   /** The params the child instance is created with — surfaced as the child's `ctx.params`. */
@@ -281,6 +291,27 @@ interface WorkflowBranch<Output = unknown> {
   /** The `lunora/workflows.ts` export name of the child workflow to run. */
   readonly workflow: string;
 }
+/**
+* The `ctx.params` a group-saga compensation workflow (a branch's
+* {@link WorkflowBranch.compensateWith}) receives when a sibling's failure rolls
+* back the group. Everything is plain-serialisable — the compensation is an
+* ordinary declared workflow, so it can `ctx.runStep(...)` its own undo logic.
+*/
+interface BranchCompensationParams {
+  /** Index signature: this is a workflow `params` bag, so it is a valid `Record&lt;string, unknown>` payload. */
+  [key: string]: unknown;
+  /** The export name of the completed branch being compensated. */
+  branch: string;
+  /** The serialised error of the sibling branch whose failure triggered the group rollback. */
+  error: {
+    message: string;
+    name: string;
+  };
+  /** Declaration-order index of the completed branch being compensated. */
+  index: number;
+  /** The completed branch's output value — what it returned before the group failed. */
+  output?: unknown;
+}
 /** Map a tuple of {@link WorkflowBranch}es to the tuple of their output types, preserving order. */
 type WorkflowBranchOutputs<B extends ReadonlyArray<WorkflowBranch>> = { -readonly [K in keyof B]: B[K] extends WorkflowBranch<infer Output> ? Output : never };
 /**
@@ -391,4 +422,4 @@ interface LunoraWorkflowsOptions {
   */
   bindings: Record<string, WorkflowBindingLike>;
 }
-export { ArgsOf as A, WorkflowSpawnFunction as B, WorkflowSpawnOptions as C, WorkflowStatusResult as D, WorkflowStepConfigLike as E, FunctionReference as F, WorkflowStepContextLike as G, WorkflowStepRollbackOptionsLike as H, InferStepArgs as I, LunoraWorkflowsOptions as L, RunFunctionOptions as R, StepArgsValidator as S, WorkflowDefinition as W, Workflows as a, StepConfig as b, StepDefinition as c, WorkflowConfig as d, WorkflowBranch as e, WorkflowInstanceStatus as f, WorkflowEventLike as g, WorkflowStepLike as h, WorkflowRunContext as i, WorkflowLogger as j, WorkflowRunFunction as k, WorkflowRunStepFunction as l, RunStepOptions as m, StepHandler as n, StepRollbackContext as o, StepRollbackHandler as p, StepRunContext as q, WorkflowBindingLike as r, WorkflowBranchOutputs as s, WorkflowCreateOptions as t, WorkflowHandle as u, WorkflowHandler as v, WorkflowInstanceLike as w, WorkflowParallelFunction as x, WorkflowRollbackContextLike as y, WorkflowRollbackHandlerLike as z };
+export { ArgsOf as A, BranchCompensationParams as B, WorkflowSpawnFunction as C, WorkflowSpawnOptions as D, WorkflowStatusResult as E, FunctionReference as F, WorkflowStepConfigLike as G, WorkflowStepContextLike as H, InferStepArgs as I, WorkflowStepRollbackOptionsLike as J, LunoraWorkflowsOptions as L, RunFunctionOptions as R, StepArgsValidator as S, WorkflowDefinition as W, Workflows as a, StepConfig as b, StepDefinition as c, WorkflowConfig as d, WorkflowBranch as e, WorkflowInstanceStatus as f, WorkflowEventLike as g, WorkflowStepLike as h, WorkflowRunContext as i, WorkflowLogger as j, WorkflowRunFunction as k, WorkflowRunStepFunction as l, RunStepOptions as m, StepHandler as n, StepRollbackContext as o, StepRollbackHandler as p, StepRunContext as q, WorkflowBindingLike as r, WorkflowBranchOutputs as s, WorkflowCreateOptions as t, WorkflowHandle as u, WorkflowHandler as v, WorkflowInstanceLike as w, WorkflowParallelFunction as x, WorkflowRollbackContextLike as y, WorkflowRollbackHandlerLike as z };

package/dist/packem_shared/{types.d-Fdeu2P2C.d.ts → types.d-C9W6rEWv.d.ts}

@@ -272,6 +272,16 @@ type WorkflowRunStepFunction = <A extends StepArgsValidator, Result>(step: StepD
 interface WorkflowBranch<Output = unknown> {
   /** Phantom marker for the branch output type — never present at runtime. */
   readonly __output?: Output;
+  /**
+  * Optional group-saga compensation (plan 075 Phase 3): the `lunora/workflows.ts`
+  * export name of a workflow to run if a **sibling** branch in the same
+  * `ctx.parallel(...)` group fails **after** this branch has already completed.
+  * It is spawned fire-and-forget (a durable, replay-safe idempotent create) with
+  * {@link BranchCompensationParams} as its `ctx.params`. Omit for no
+  * compensation — a group where no branch sets this behaves exactly as a plain
+  * fan-out (fail-fast, no rollback).
+  */
+  readonly compensateWith?: string;
   /** Optional explicit child instance id (defaults to a deterministic parent-derived id). */
   readonly id?: string;
   /** The params the child instance is created with — surfaced as the child's `ctx.params`. */
@@ -281,6 +291,27 @@ interface WorkflowBranch<Output = unknown> {
   /** The `lunora/workflows.ts` export name of the child workflow to run. */
   readonly workflow: string;
 }
+/**
+* The `ctx.params` a group-saga compensation workflow (a branch's
+* {@link WorkflowBranch.compensateWith}) receives when a sibling's failure rolls
+* back the group. Everything is plain-serialisable — the compensation is an
+* ordinary declared workflow, so it can `ctx.runStep(...)` its own undo logic.
+*/
+interface BranchCompensationParams {
+  /** Index signature: this is a workflow `params` bag, so it is a valid `Record&lt;string, unknown>` payload. */
+  [key: string]: unknown;
+  /** The export name of the completed branch being compensated. */
+  branch: string;
+  /** The serialised error of the sibling branch whose failure triggered the group rollback. */
+  error: {
+    message: string;
+    name: string;
+  };
+  /** Declaration-order index of the completed branch being compensated. */
+  index: number;
+  /** The completed branch's output value — what it returned before the group failed. */
+  output?: unknown;
+}
 /** Map a tuple of {@link WorkflowBranch}es to the tuple of their output types, preserving order. */
 type WorkflowBranchOutputs<B extends ReadonlyArray<WorkflowBranch>> = { -readonly [K in keyof B]: B[K] extends WorkflowBranch<infer Output> ? Output : never };
 /**
@@ -391,4 +422,4 @@ interface LunoraWorkflowsOptions {
   */
   bindings: Record<string, WorkflowBindingLike>;
 }
-export { ArgsOf as A, WorkflowSpawnFunction as B, WorkflowSpawnOptions as C, WorkflowStatusResult as D, WorkflowStepConfigLike as E, FunctionReference as F, WorkflowStepContextLike as G, WorkflowStepRollbackOptionsLike as H, InferStepArgs as I, LunoraWorkflowsOptions as L, RunFunctionOptions as R, StepArgsValidator as S, WorkflowDefinition as W, Workflows as a, StepConfig as b, StepDefinition as c, WorkflowConfig as d, WorkflowBranch as e, WorkflowInstanceStatus as f, WorkflowEventLike as g, WorkflowStepLike as h, WorkflowRunContext as i, WorkflowLogger as j, WorkflowRunFunction as k, WorkflowRunStepFunction as l, RunStepOptions as m, StepHandler as n, StepRollbackContext as o, StepRollbackHandler as p, StepRunContext as q, WorkflowBindingLike as r, WorkflowBranchOutputs as s, WorkflowCreateOptions as t, WorkflowHandle as u, WorkflowHandler as v, WorkflowInstanceLike as w, WorkflowParallelFunction as x, WorkflowRollbackContextLike as y, WorkflowRollbackHandlerLike as z };
+export { ArgsOf as A, BranchCompensationParams as B, WorkflowSpawnFunction as C, WorkflowSpawnOptions as D, WorkflowStatusResult as E, FunctionReference as F, WorkflowStepConfigLike as G, WorkflowStepContextLike as H, InferStepArgs as I, WorkflowStepRollbackOptionsLike as J, LunoraWorkflowsOptions as L, RunFunctionOptions as R, StepArgsValidator as S, WorkflowDefinition as W, Workflows as a, StepConfig as b, StepDefinition as c, WorkflowConfig as d, WorkflowBranch as e, WorkflowInstanceStatus as f, WorkflowEventLike as g, WorkflowStepLike as h, WorkflowRunContext as i, WorkflowLogger as j, WorkflowRunFunction as k, WorkflowRunStepFunction as l, RunStepOptions as m, StepHandler as n, StepRollbackContext as o, StepRollbackHandler as p, StepRunContext as q, WorkflowBindingLike as r, WorkflowBranchOutputs as s, WorkflowCreateOptions as t, WorkflowHandle as u, WorkflowHandler as v, WorkflowInstanceLike as w, WorkflowParallelFunction as x, WorkflowRollbackContextLike as y, WorkflowRollbackHandlerLike as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/workflow",
-  "version": "1.0.0-alpha.4",
+  "version": "1.0.0-alpha.6",
   "description": "Durable workflows for Lunora: defineWorkflow over Cloudflare Workflows, generated WorkflowEntrypoint classes, and the ctx.workflows surface",
   "keywords": [
     "cloudflare",
@@ -48,7 +48,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/values": "1.0.0-alpha.3"
+    "@lunora/errors": "1.0.0-alpha.1",
+    "@lunora/values": "1.0.0-alpha.4"
   },
   "engines": {
     "node": "^22.15.0 || >=24.11.0"