@fluidgrids/workflows 2026.1027.1 → 2026.1028.2

package/dist/index.cjs

@@ -1,117 +1,215 @@
 'use strict';
 
-var chunkTQF7MYEN_cjs = require('./chunk-TQF7MYEN.cjs');
+var chunkUK3WM7YZ_cjs = require('./chunk-UK3WM7YZ.cjs');
+var chunkSAOBPYYJ_cjs = require('./chunk-SAOBPYYJ.cjs');
 require('./chunk-G4UEPUGO.cjs');
-var chunk6AIAC2FP_cjs = require('./chunk-6AIAC2FP.cjs');
-require('./chunk-E3APHA6O.cjs');
+var chunkGVTZMA5C_cjs = require('./chunk-GVTZMA5C.cjs');
+require('./chunk-TBDXTV22.cjs');
+require('./chunk-SAENRNBJ.cjs');
+var chunkFMSW2HDF_cjs = require('./chunk-FMSW2HDF.cjs');
+require('./chunk-FR7KYWRO.cjs');
+var chunkDHTLALBL_cjs = require('./chunk-DHTLALBL.cjs');
+require('./chunk-Z2Y65YOY.cjs');
 
 
 
 Object.defineProperty(exports, "COLLECTION_FORMAT", {
   enumerable: true,
-  get: function () { return chunkTQF7MYEN_cjs.COLLECTION_FORMAT; }
+  get: function () { return chunkUK3WM7YZ_cjs.COLLECTION_FORMAT; }
+});
+Object.defineProperty(exports, "collectWorkflowExports", {
+  enumerable: true,
+  get: function () { return chunkUK3WM7YZ_cjs.collectWorkflowExports; }
 });
 Object.defineProperty(exports, "LAYOUT_FORMAT", {
   enumerable: true,
-  get: function () { return chunkTQF7MYEN_cjs.LAYOUT_FORMAT; }
+  get: function () { return chunkSAOBPYYJ_cjs.LAYOUT_FORMAT; }
 });
 Object.defineProperty(exports, "LAYOUT_FORMAT_VERSION", {
   enumerable: true,
-  get: function () { return chunkTQF7MYEN_cjs.LAYOUT_FORMAT_VERSION; }
+  get: function () { return chunkSAOBPYYJ_cjs.LAYOUT_FORMAT_VERSION; }
 });
 Object.defineProperty(exports, "RECORDING_FORMAT", {
   enumerable: true,
-  get: function () { return chunkTQF7MYEN_cjs.RECORDING_FORMAT; }
+  get: function () { return chunkSAOBPYYJ_cjs.RECORDING_FORMAT; }
 });
 Object.defineProperty(exports, "RECORDING_FORMAT_VERSION", {
   enumerable: true,
-  get: function () { return chunkTQF7MYEN_cjs.RECORDING_FORMAT_VERSION; }
-});
-Object.defineProperty(exports, "SDK_VERSION", {
-  enumerable: true,
-  get: function () { return chunkTQF7MYEN_cjs.SDK_VERSION; }
+  get: function () { return chunkSAOBPYYJ_cjs.RECORDING_FORMAT_VERSION; }
 });
 Object.defineProperty(exports, "UnresolvedConnectionsError", {
   enumerable: true,
-  get: function () { return chunkTQF7MYEN_cjs.UnresolvedConnectionsError; }
+  get: function () { return chunkSAOBPYYJ_cjs.UnresolvedConnectionsError; }
 });
 Object.defineProperty(exports, "WorkflowBuilder", {
   enumerable: true,
-  get: function () { return chunkTQF7MYEN_cjs.WorkflowBuilder; }
+  get: function () { return chunkSAOBPYYJ_cjs.WorkflowBuilder; }
 });
 Object.defineProperty(exports, "assembleRecording", {
   enumerable: true,
-  get: function () { return chunkTQF7MYEN_cjs.assembleRecording; }
-});
-Object.defineProperty(exports, "collectWorkflowExports", {
-  enumerable: true,
-  get: function () { return chunkTQF7MYEN_cjs.collectWorkflowExports; }
+  get: function () { return chunkSAOBPYYJ_cjs.assembleRecording; }
 });
 Object.defineProperty(exports, "defaultEdgeId", {
   enumerable: true,
-  get: function () { return chunkTQF7MYEN_cjs.defaultEdgeId; }
+  get: function () { return chunkSAOBPYYJ_cjs.defaultEdgeId; }
 });
 Object.defineProperty(exports, "defineWorkflow", {
   enumerable: true,
-  get: function () { return chunkTQF7MYEN_cjs.defineWorkflow; }
+  get: function () { return chunkSAOBPYYJ_cjs.defineWorkflow; }
 });
 Object.defineProperty(exports, "edge", {
   enumerable: true,
-  get: function () { return chunkTQF7MYEN_cjs.edge; }
+  get: function () { return chunkSAOBPYYJ_cjs.edge; }
 });
 Object.defineProperty(exports, "internalNodes", {
   enumerable: true,
-  get: function () { return chunkTQF7MYEN_cjs.internalNodes; }
+  get: function () { return chunkSAOBPYYJ_cjs.internalNodes; }
 });
 Object.defineProperty(exports, "isOperation", {
   enumerable: true,
-  get: function () { return chunkTQF7MYEN_cjs.isOperation; }
+  get: function () { return chunkSAOBPYYJ_cjs.isOperation; }
 });
 Object.defineProperty(exports, "isTier1Workflow", {
   enumerable: true,
-  get: function () { return chunkTQF7MYEN_cjs.isTier1Workflow; }
+  get: function () { return chunkSAOBPYYJ_cjs.isTier1Workflow; }
 });
 Object.defineProperty(exports, "nodes", {
   enumerable: true,
-  get: function () { return chunkTQF7MYEN_cjs.nodes; }
+  get: function () { return chunkSAOBPYYJ_cjs.nodes; }
 });
 Object.defineProperty(exports, "op", {
   enumerable: true,
-  get: function () { return chunkTQF7MYEN_cjs.op; }
+  get: function () { return chunkSAOBPYYJ_cjs.op; }
 });
 Object.defineProperty(exports, "parseLayoutSidecar", {
   enumerable: true,
-  get: function () { return chunkTQF7MYEN_cjs.parseLayoutSidecar; }
+  get: function () { return chunkSAOBPYYJ_cjs.parseLayoutSidecar; }
 });
 Object.defineProperty(exports, "toIR", {
   enumerable: true,
-  get: function () { return chunkTQF7MYEN_cjs.toIR; }
+  get: function () { return chunkSAOBPYYJ_cjs.toIR; }
 });
 Object.defineProperty(exports, "trigger", {
   enumerable: true,
-  get: function () { return chunkTQF7MYEN_cjs.trigger; }
+  get: function () { return chunkSAOBPYYJ_cjs.trigger; }
 });
 Object.defineProperty(exports, "triggers", {
   enumerable: true,
-  get: function () { return chunkTQF7MYEN_cjs.triggers; }
+  get: function () { return chunkSAOBPYYJ_cjs.triggers; }
 });
 Object.defineProperty(exports, "BuilderError", {
   enumerable: true,
-  get: function () { return chunk6AIAC2FP_cjs.BuilderError; }
+  get: function () { return chunkGVTZMA5C_cjs.BuilderError; }
 });
 Object.defineProperty(exports, "PREDICATE_OPERATORS", {
   enumerable: true,
-  get: function () { return chunk6AIAC2FP_cjs.PREDICATE_OPERATORS; }
+  get: function () { return chunkGVTZMA5C_cjs.PREDICATE_OPERATORS; }
 });
 Object.defineProperty(exports, "and", {
   enumerable: true,
-  get: function () { return chunk6AIAC2FP_cjs.and; }
+  get: function () { return chunkGVTZMA5C_cjs.and; }
 });
 Object.defineProperty(exports, "expr", {
   enumerable: true,
-  get: function () { return chunk6AIAC2FP_cjs.expr; }
+  get: function () { return chunkGVTZMA5C_cjs.expr; }
 });
 Object.defineProperty(exports, "or", {
   enumerable: true,
-  get: function () { return chunk6AIAC2FP_cjs.or; }
+  get: function () { return chunkGVTZMA5C_cjs.or; }
+});
+Object.defineProperty(exports, "ActivityFailure", {
+  enumerable: true,
+  get: function () { return chunkFMSW2HDF_cjs.ActivityFailure; }
+});
+Object.defineProperty(exports, "ApplicationError", {
+  enumerable: true,
+  get: function () { return chunkFMSW2HDF_cjs.ApplicationError; }
+});
+Object.defineProperty(exports, "CancelledFailure", {
+  enumerable: true,
+  get: function () { return chunkFMSW2HDF_cjs.CancelledFailure; }
+});
+Object.defineProperty(exports, "ChildRunFailure", {
+  enumerable: true,
+  get: function () { return chunkFMSW2HDF_cjs.ChildRunFailure; }
+});
+Object.defineProperty(exports, "DeterminismViolation", {
+  enumerable: true,
+  get: function () { return chunkFMSW2HDF_cjs.DeterminismViolation; }
+});
+Object.defineProperty(exports, "HistoryLimitExceeded", {
+  enumerable: true,
+  get: function () { return chunkFMSW2HDF_cjs.HistoryLimitExceeded; }
+});
+Object.defineProperty(exports, "PhaseCFeatureError", {
+  enumerable: true,
+  get: function () { return chunkFMSW2HDF_cjs.PhaseCFeatureError; }
+});
+Object.defineProperty(exports, "ServerFailure", {
+  enumerable: true,
+  get: function () { return chunkFMSW2HDF_cjs.ServerFailure; }
+});
+Object.defineProperty(exports, "TerminatedFailure", {
+  enumerable: true,
+  get: function () { return chunkFMSW2HDF_cjs.TerminatedFailure; }
+});
+Object.defineProperty(exports, "TimeoutFailure", {
+  enumerable: true,
+  get: function () { return chunkFMSW2HDF_cjs.TimeoutFailure; }
+});
+Object.defineProperty(exports, "WorkflowFailure", {
+  enumerable: true,
+  get: function () { return chunkFMSW2HDF_cjs.WorkflowFailure; }
+});
+Object.defineProperty(exports, "defineQuery", {
+  enumerable: true,
+  get: function () { return chunkFMSW2HDF_cjs.defineQuery; }
+});
+Object.defineProperty(exports, "defineSignal", {
+  enumerable: true,
+  get: function () { return chunkFMSW2HDF_cjs.defineSignal; }
+});
+Object.defineProperty(exports, "defineUpdate", {
+  enumerable: true,
+  get: function () { return chunkFMSW2HDF_cjs.defineUpdate; }
+});
+Object.defineProperty(exports, "errorToFailure", {
+  enumerable: true,
+  get: function () { return chunkFMSW2HDF_cjs.errorToFailure; }
+});
+Object.defineProperty(exports, "failureToError", {
+  enumerable: true,
+  get: function () { return chunkFMSW2HDF_cjs.failureToError; }
+});
+Object.defineProperty(exports, "isCancellation", {
+  enumerable: true,
+  get: function () { return chunkFMSW2HDF_cjs.isCancellation; }
+});
+Object.defineProperty(exports, "toMs", {
+  enumerable: true,
+  get: function () { return chunkFMSW2HDF_cjs.toMs; }
+});
+Object.defineProperty(exports, "DURABLE_MARKER", {
+  enumerable: true,
+  get: function () { return chunkDHTLALBL_cjs.DURABLE_MARKER; }
+});
+Object.defineProperty(exports, "SDK_VERSION", {
+  enumerable: true,
+  get: function () { return chunkDHTLALBL_cjs.SDK_VERSION; }
+});
+Object.defineProperty(exports, "interfaceOf", {
+  enumerable: true,
+  get: function () { return chunkDHTLALBL_cjs.interfaceOf; }
+});
+Object.defineProperty(exports, "isDurableWorkflow", {
+  enumerable: true,
+  get: function () { return chunkDHTLALBL_cjs.isDurableWorkflow; }
+});
+Object.defineProperty(exports, "jsonSchemaOf", {
+  enumerable: true,
+  get: function () { return chunkDHTLALBL_cjs.jsonSchemaOf; }
+});
+Object.defineProperty(exports, "workflow", {
+  enumerable: true,
+  get: function () { return chunkDHTLALBL_cjs.workflow; }
 });

package/dist/index.d.cts

@@ -1,11 +1,17 @@
-import { T as Tier1Recording } from './assemble-DEf3znGD.cjs';
-export { A as AfterInput, a as AnyRef, b as ApprovalRef, c as ArgValue, d as ArgsOf, e as AssembleOptions, B as BuilderError, C as CompareRef, f as ConditionGroup, g as ConditionRule, h as ConnectionResolver, E as EdgeOptions, i as EdgeSource, j as EdgeSpec, F as FileRef, H as HandleRef, I as IfOptions, k as IfRef, L as LAYOUT_FORMAT, l as LAYOUT_FORMAT_VERSION, m as LayoutSidecar, n as LoopOptions, o as LoopRef, M as MergeOptions, N as NodeOptions, p as NodeRef, q as NoteOptions, O as OnErrorOption, r as Operation, s as OutputRef, P as PREDICATE_OPERATORS, t as Predicate, u as PredicateMethods, R as RECORDING_FORMAT, v as RECORDING_FORMAT_VERSION, w as RecordedNode, x as RecordedNote, y as RuleValue, S as SignalWaitRef, z as SubworkflowOptions, D as SwitchOptions, G as SwitchRef, J as Tier1Workflow, K as TriggerOperation, U as UnresolvedConnectionsError, V as ValidateRef, W as WaitForSignalOptions, Q as WorkflowBuilder, X as WorkflowOptions, Y as and, Z as assembleRecording, _ as defaultEdgeId, $ as defineWorkflow, a0 as edge, a1 as expr, a2 as internalNodes, a3 as isOperation, a4 as isTier1Workflow, a5 as nodes, a6 as op, a7 as or, a8 as parseLayoutSidecar, a9 as toIR, aa as trigger, ab as triggers } from './assemble-DEf3znGD.cjs';
-export { J as Json, a as JsonObject, W as WorkflowDefinition } from './types-Dr2Fn1Ax.cjs';
+import { T as Tier1Recording } from './workflow-FXUkpIBc.cjs';
+export { A as AfterInput, a as AnyRef, b as ApprovalRef, c as ArgValue, d as ArgsOf, B as BuilderError, C as CodeWorkflowOptions, e as CompareRef, f as ConditionGroup, g as ConditionRule, D as DurableRef, E as EdgeOptions, h as EdgeSource, i as EdgeSpec, H as HandleRef, I as IfOptions, j as IfRef, L as LoopOptions, k as LoopRef, M as MergeOptions, N as NodeOptions, l as NodeRef, m as NoteOptions, O as OnErrorOption, n as OutputRef, P as PREDICATE_OPERATORS, o as Predicate, p as PredicateMethods, R as RECORDING_FORMAT, q as RECORDING_FORMAT_VERSION, r as RecordedNode, s as RecordedNote, t as RuleValue, S as SignalWaitRef, u as SubworkflowOptions, v as SwitchOptions, w as SwitchRef, x as Tier1Workflow, V as ValidateRef, W as WaitForSignalOptions, y as WorkflowBuilder, z as WorkflowOptions, F as and, G as defaultEdgeId, J as defineWorkflow, K as edge, Q as expr, U as isTier1Workflow, X as or } from './workflow-FXUkpIBc.cjs';
+export { C as CancellationScope, a as CancellationScopeFunction, b as CancellationScopeOptions, c as ChildHandle, d as ChildOptions, e as ChildTarget, f as ContinueAsNewOptions, D as DURABLE_MARKER, g as DefinitionOptions, h as DurableWorkflow, i as DurableWorkflowOptions, j as Duration, E as ExternalRunHandle, F as FileRef, O as Operation, Q as QueryDefinition, R as RunOptions, S as Saga, k as SchemaLike, l as SignalDefinition, T as TriggerOperation, m as TriggerSpec, U as UpdateDefinition, W as WorkflowContext, n as WorkflowInfo, o as WorkflowLogger, p as defineQuery, q as defineSignal, r as defineUpdate, s as interfaceOf, t as internalNodes, u as isDurableWorkflow, v as isOperation, w as jsonSchemaOf, x as nodes, y as op, z as toMs, A as trigger, B as triggers, G as workflow } from './workflow-J-yYixny.cjs';
+export { A as AssembleOptions, C as ConnectionResolver, L as LAYOUT_FORMAT, a as LAYOUT_FORMAT_VERSION, b as LayoutSidecar, U as UnresolvedConnectionsError, c as assembleRecording, p as parseLayoutSidecar, t as toIR } from './assemble-BLqQ8lSu.cjs';
+import { W as WorkflowInterface, J as JsonObject, E as ErrorType, a as Json } from './types-BGoPzgcl.cjs';
+export { b as WorkflowDefinition } from './types-BGoPzgcl.cjs';
+import { F as Failure } from './types-CpBBjaGX.cjs';
+export { P as ParentClosePolicy, R as RetryPolicy } from './types-CpBBjaGX.cjs';
 
 /**
- * Runs inside the evaluation isolate at the end of a tier-1 bundle: gathers the
- * recordings of every exported `defineWorkflow` value as one JSON string, the
- * only thing that leaves the isolate.
+ * Runs inside the evaluation isolate at the end of a bundle: gathers the
+ * recordings of every exported `defineWorkflow` value and the declarations of
+ * every exported tier-2 `workflow()` as one JSON string, the only thing that
+ * leaves the isolate.
  */
 
 declare const COLLECTION_FORMAT = "fluidgrids.tier1-collection";
@@ -14,14 +20,136 @@ interface CollectedWorkflow {
     exportName: string;
     recording: Tier1Recording;
 }
+/** The trigger a standalone tier-2 workflow declares. */
+interface CollectedTrigger {
+    nodeType: string;
+    version?: string;
+    operation?: string;
+    args?: JsonObject;
+    id?: string;
+}
+/** One exported tier-2 workflow (C-ABI `durable` entries of the collection). */
+interface CollectedDurableWorkflow {
+    module: string;
+    exportName: string;
+    /** The workflow key it gets when standalone. */
+    name: string;
+    title?: string;
+    description?: string;
+    taskQueue: string;
+    interface: WorkflowInterface;
+    standalone?: boolean;
+    trigger?: CollectedTrigger;
+}
 interface Tier1Collection {
     format: typeof COLLECTION_FORMAT;
     workflows: CollectedWorkflow[];
+    /** Tier-2 functions; absent when the bundle has none. */
+    durable?: CollectedDurableWorkflow[];
 }
-/** Collect the tier-1 workflows exported by each module, as JSON. */
+/** Collect the workflows exported by each module, as JSON. */
 declare function collectWorkflowExports(modules: ReadonlyArray<readonly [string, Record<string, unknown>]>): string;
 
+/**
+ * Failure classes of tier-2 workflow code (spec 02 §4, 11 §2.25).
+ *
+ * The rule a workflow task applies to a throw (11 §2.37): one of these classes
+ * (or a class listed in `failureErrorTypes`) fails the run; anything else,
+ * such as a `TypeError`, fails only the workflow task, which is retried until a
+ * hotfix cures it. `DeterminismViolation` and `HistoryLimitExceeded` always
+ * fail the task.
+ *
+ * Pure JavaScript: the classes run inside the isolate.
+ */
+
+/** Base class of every failure that crosses the history boundary. */
+declare class WorkflowFailure extends Error {
+    /** The shared error type the engine classifies this failure as. */
+    readonly errorType: ErrorType;
+    constructor(message: string, errorType: ErrorType, options?: {
+        cause?: unknown;
+    });
+}
+interface ApplicationErrorOptions {
+    /** Free-form type (Temporal's model). An `ErrorType` value also sets `errorType`. */
+    type?: string;
+    /** The shared error type; default from `type` when it is one, else `UNKNOWN`. */
+    errorType?: ErrorType;
+    nonRetryable?: boolean;
+    details?: Json;
+    /** Milliseconds or a duration string; overrides the next retry's delay only. */
+    nextRetryDelay?: number;
+    category?: 'BENIGN';
+    cause?: unknown;
+}
+/** An application failure: raised by activities or workflow code. Fails the run when thrown from a workflow. */
+declare class ApplicationError extends WorkflowFailure {
+    readonly type: string | undefined;
+    readonly nonRetryable: boolean;
+    readonly details: Json | undefined;
+    readonly nextRetryDelayMs: number | undefined;
+    readonly category: 'BENIGN' | undefined;
+    constructor(message: string, options?: ApplicationErrorOptions);
+}
+/** The final failure of an activity, after its retries. `cause` is the last attempt's failure. */
+declare class ActivityFailure extends WorkflowFailure {
+    readonly activityId: string;
+    readonly nodeType: string;
+    readonly operation: string;
+    constructor(message: string, activityId: string, nodeType: string, operation: string, cause: Error);
+}
+/** A child run failed, timed out, was cancelled or terminated; `cause` says which. */
+declare class ChildRunFailure extends WorkflowFailure {
+    readonly childId: string;
+    readonly childRunId: string | undefined;
+    constructor(message: string, childId: string, childRunId: string | undefined, cause: Error);
+}
+/** A child or external run was terminated. */
+declare class TerminatedFailure extends WorkflowFailure {
+    constructor(message?: string);
+}
+/** An engine-originated failure: quota, worker unavailable, history cap, codec error. */
+declare class ServerFailure extends WorkflowFailure {
+    readonly nonRetryable: boolean;
+    constructor(message: string, nonRetryable?: boolean, errorType?: ErrorType);
+}
+/** Cancellation reached this code. */
+declare class CancelledFailure extends WorkflowFailure {
+    constructor(message?: string);
+}
+/** A timer-bounded wait, an activity or a child timed out. */
+declare class TimeoutFailure extends WorkflowFailure {
+    readonly timeoutType: string;
+    constructor(message: string, timeoutType: string);
+}
+/**
+ * Replay mismatch or a forbidden API in workflow code. Fails the workflow task
+ * (cause `NON_DETERMINISM`), never the run.
+ */
+declare class DeterminismViolation extends Error {
+    constructor(message: string);
+}
+/** Thrown from the next command once the history passes 95 % of its cap; continue as new. */
+declare class HistoryLimitExceeded extends Error {
+    constructor(message: string);
+}
+/**
+ * A Phase C feature (user activities, custom queries and updates, search
+ * attributes, sinks, interceptors) used in Phase B. Fails the workflow task
+ * with `UNSUPPORTED_COMMAND`; `validate` reports `durable.phaseC` at push time.
+ */
+declare class PhaseCFeatureError extends Error {
+    readonly code = "durable.phaseC";
+    constructor(feature: string);
+}
+/** True when `error` is (or wraps) a cancellation. */
+declare function isCancellation(error: unknown): boolean;
+/** The stored form of an error (11 §2.25). */
+declare function errorToFailure(error: unknown, source?: string, depth?: number): Failure;
+/** The error class a stored failure stands for, with its cause chain. */
+declare function failureToError(failure: Failure, depth?: number): WorkflowFailure;
+
 /** The version of @fluidgrids/workflows. */
-declare const SDK_VERSION = "2026.1027.1";
+declare const SDK_VERSION = "2026.1028.2";
 
-export { COLLECTION_FORMAT, type CollectedWorkflow, SDK_VERSION, type Tier1Collection, Tier1Recording, collectWorkflowExports };
+export { ActivityFailure, ApplicationError, type ApplicationErrorOptions, COLLECTION_FORMAT, CancelledFailure, ChildRunFailure, type CollectedDurableWorkflow, type CollectedTrigger, type CollectedWorkflow, DeterminismViolation, Failure, HistoryLimitExceeded, Json, JsonObject, PhaseCFeatureError, SDK_VERSION, ServerFailure, TerminatedFailure, type Tier1Collection, Tier1Recording, TimeoutFailure, WorkflowFailure, collectWorkflowExports, errorToFailure, failureToError, isCancellation };

package/dist/index.d.ts

@@ -1,11 +1,17 @@
-import { T as Tier1Recording } from './assemble-CrpUyd_3.js';
-export { A as AfterInput, a as AnyRef, b as ApprovalRef, c as ArgValue, d as ArgsOf, e as AssembleOptions, B as BuilderError, C as CompareRef, f as ConditionGroup, g as ConditionRule, h as ConnectionResolver, E as EdgeOptions, i as EdgeSource, j as EdgeSpec, F as FileRef, H as HandleRef, I as IfOptions, k as IfRef, L as LAYOUT_FORMAT, l as LAYOUT_FORMAT_VERSION, m as LayoutSidecar, n as LoopOptions, o as LoopRef, M as MergeOptions, N as NodeOptions, p as NodeRef, q as NoteOptions, O as OnErrorOption, r as Operation, s as OutputRef, P as PREDICATE_OPERATORS, t as Predicate, u as PredicateMethods, R as RECORDING_FORMAT, v as RECORDING_FORMAT_VERSION, w as RecordedNode, x as RecordedNote, y as RuleValue, S as SignalWaitRef, z as SubworkflowOptions, D as SwitchOptions, G as SwitchRef, J as Tier1Workflow, K as TriggerOperation, U as UnresolvedConnectionsError, V as ValidateRef, W as WaitForSignalOptions, Q as WorkflowBuilder, X as WorkflowOptions, Y as and, Z as assembleRecording, _ as defaultEdgeId, $ as defineWorkflow, a0 as edge, a1 as expr, a2 as internalNodes, a3 as isOperation, a4 as isTier1Workflow, a5 as nodes, a6 as op, a7 as or, a8 as parseLayoutSidecar, a9 as toIR, aa as trigger, ab as triggers } from './assemble-CrpUyd_3.js';
-export { J as Json, a as JsonObject, W as WorkflowDefinition } from './types-Dr2Fn1Ax.js';
+import { T as Tier1Recording } from './workflow-Bpr3vnA_.js';
+export { A as AfterInput, a as AnyRef, b as ApprovalRef, c as ArgValue, d as ArgsOf, B as BuilderError, C as CodeWorkflowOptions, e as CompareRef, f as ConditionGroup, g as ConditionRule, D as DurableRef, E as EdgeOptions, h as EdgeSource, i as EdgeSpec, H as HandleRef, I as IfOptions, j as IfRef, L as LoopOptions, k as LoopRef, M as MergeOptions, N as NodeOptions, l as NodeRef, m as NoteOptions, O as OnErrorOption, n as OutputRef, P as PREDICATE_OPERATORS, o as Predicate, p as PredicateMethods, R as RECORDING_FORMAT, q as RECORDING_FORMAT_VERSION, r as RecordedNode, s as RecordedNote, t as RuleValue, S as SignalWaitRef, u as SubworkflowOptions, v as SwitchOptions, w as SwitchRef, x as Tier1Workflow, V as ValidateRef, W as WaitForSignalOptions, y as WorkflowBuilder, z as WorkflowOptions, F as and, G as defaultEdgeId, J as defineWorkflow, K as edge, Q as expr, U as isTier1Workflow, X as or } from './workflow-Bpr3vnA_.js';
+export { C as CancellationScope, a as CancellationScopeFunction, b as CancellationScopeOptions, c as ChildHandle, d as ChildOptions, e as ChildTarget, f as ContinueAsNewOptions, D as DURABLE_MARKER, g as DefinitionOptions, h as DurableWorkflow, i as DurableWorkflowOptions, j as Duration, E as ExternalRunHandle, F as FileRef, O as Operation, Q as QueryDefinition, R as RunOptions, S as Saga, k as SchemaLike, l as SignalDefinition, T as TriggerOperation, m as TriggerSpec, U as UpdateDefinition, W as WorkflowContext, n as WorkflowInfo, o as WorkflowLogger, p as defineQuery, q as defineSignal, r as defineUpdate, s as interfaceOf, t as internalNodes, u as isDurableWorkflow, v as isOperation, w as jsonSchemaOf, x as nodes, y as op, z as toMs, A as trigger, B as triggers, G as workflow } from './workflow-C2a05WUJ.js';
+export { A as AssembleOptions, C as ConnectionResolver, L as LAYOUT_FORMAT, a as LAYOUT_FORMAT_VERSION, b as LayoutSidecar, U as UnresolvedConnectionsError, c as assembleRecording, p as parseLayoutSidecar, t as toIR } from './assemble-DWgaXHd-.js';
+import { W as WorkflowInterface, J as JsonObject, E as ErrorType, a as Json } from './types-BGoPzgcl.js';
+export { b as WorkflowDefinition } from './types-BGoPzgcl.js';
+import { F as Failure } from './types-DV-HX_Gt.js';
+export { P as ParentClosePolicy, R as RetryPolicy } from './types-DV-HX_Gt.js';
 
 /**
- * Runs inside the evaluation isolate at the end of a tier-1 bundle: gathers the
- * recordings of every exported `defineWorkflow` value as one JSON string, the
- * only thing that leaves the isolate.
+ * Runs inside the evaluation isolate at the end of a bundle: gathers the
+ * recordings of every exported `defineWorkflow` value and the declarations of
+ * every exported tier-2 `workflow()` as one JSON string, the only thing that
+ * leaves the isolate.
  */
 
 declare const COLLECTION_FORMAT = "fluidgrids.tier1-collection";
@@ -14,14 +20,136 @@ interface CollectedWorkflow {
     exportName: string;
     recording: Tier1Recording;
 }
+/** The trigger a standalone tier-2 workflow declares. */
+interface CollectedTrigger {
+    nodeType: string;
+    version?: string;
+    operation?: string;
+    args?: JsonObject;
+    id?: string;
+}
+/** One exported tier-2 workflow (C-ABI `durable` entries of the collection). */
+interface CollectedDurableWorkflow {
+    module: string;
+    exportName: string;
+    /** The workflow key it gets when standalone. */
+    name: string;
+    title?: string;
+    description?: string;
+    taskQueue: string;
+    interface: WorkflowInterface;
+    standalone?: boolean;
+    trigger?: CollectedTrigger;
+}
 interface Tier1Collection {
     format: typeof COLLECTION_FORMAT;
     workflows: CollectedWorkflow[];
+    /** Tier-2 functions; absent when the bundle has none. */
+    durable?: CollectedDurableWorkflow[];
 }
-/** Collect the tier-1 workflows exported by each module, as JSON. */
+/** Collect the workflows exported by each module, as JSON. */
 declare function collectWorkflowExports(modules: ReadonlyArray<readonly [string, Record<string, unknown>]>): string;
 
+/**
+ * Failure classes of tier-2 workflow code (spec 02 §4, 11 §2.25).
+ *
+ * The rule a workflow task applies to a throw (11 §2.37): one of these classes
+ * (or a class listed in `failureErrorTypes`) fails the run; anything else,
+ * such as a `TypeError`, fails only the workflow task, which is retried until a
+ * hotfix cures it. `DeterminismViolation` and `HistoryLimitExceeded` always
+ * fail the task.
+ *
+ * Pure JavaScript: the classes run inside the isolate.
+ */
+
+/** Base class of every failure that crosses the history boundary. */
+declare class WorkflowFailure extends Error {
+    /** The shared error type the engine classifies this failure as. */
+    readonly errorType: ErrorType;
+    constructor(message: string, errorType: ErrorType, options?: {
+        cause?: unknown;
+    });
+}
+interface ApplicationErrorOptions {
+    /** Free-form type (Temporal's model). An `ErrorType` value also sets `errorType`. */
+    type?: string;
+    /** The shared error type; default from `type` when it is one, else `UNKNOWN`. */
+    errorType?: ErrorType;
+    nonRetryable?: boolean;
+    details?: Json;
+    /** Milliseconds or a duration string; overrides the next retry's delay only. */
+    nextRetryDelay?: number;
+    category?: 'BENIGN';
+    cause?: unknown;
+}
+/** An application failure: raised by activities or workflow code. Fails the run when thrown from a workflow. */
+declare class ApplicationError extends WorkflowFailure {
+    readonly type: string | undefined;
+    readonly nonRetryable: boolean;
+    readonly details: Json | undefined;
+    readonly nextRetryDelayMs: number | undefined;
+    readonly category: 'BENIGN' | undefined;
+    constructor(message: string, options?: ApplicationErrorOptions);
+}
+/** The final failure of an activity, after its retries. `cause` is the last attempt's failure. */
+declare class ActivityFailure extends WorkflowFailure {
+    readonly activityId: string;
+    readonly nodeType: string;
+    readonly operation: string;
+    constructor(message: string, activityId: string, nodeType: string, operation: string, cause: Error);
+}
+/** A child run failed, timed out, was cancelled or terminated; `cause` says which. */
+declare class ChildRunFailure extends WorkflowFailure {
+    readonly childId: string;
+    readonly childRunId: string | undefined;
+    constructor(message: string, childId: string, childRunId: string | undefined, cause: Error);
+}
+/** A child or external run was terminated. */
+declare class TerminatedFailure extends WorkflowFailure {
+    constructor(message?: string);
+}
+/** An engine-originated failure: quota, worker unavailable, history cap, codec error. */
+declare class ServerFailure extends WorkflowFailure {
+    readonly nonRetryable: boolean;
+    constructor(message: string, nonRetryable?: boolean, errorType?: ErrorType);
+}
+/** Cancellation reached this code. */
+declare class CancelledFailure extends WorkflowFailure {
+    constructor(message?: string);
+}
+/** A timer-bounded wait, an activity or a child timed out. */
+declare class TimeoutFailure extends WorkflowFailure {
+    readonly timeoutType: string;
+    constructor(message: string, timeoutType: string);
+}
+/**
+ * Replay mismatch or a forbidden API in workflow code. Fails the workflow task
+ * (cause `NON_DETERMINISM`), never the run.
+ */
+declare class DeterminismViolation extends Error {
+    constructor(message: string);
+}
+/** Thrown from the next command once the history passes 95 % of its cap; continue as new. */
+declare class HistoryLimitExceeded extends Error {
+    constructor(message: string);
+}
+/**
+ * A Phase C feature (user activities, custom queries and updates, search
+ * attributes, sinks, interceptors) used in Phase B. Fails the workflow task
+ * with `UNSUPPORTED_COMMAND`; `validate` reports `durable.phaseC` at push time.
+ */
+declare class PhaseCFeatureError extends Error {
+    readonly code = "durable.phaseC";
+    constructor(feature: string);
+}
+/** True when `error` is (or wraps) a cancellation. */
+declare function isCancellation(error: unknown): boolean;
+/** The stored form of an error (11 §2.25). */
+declare function errorToFailure(error: unknown, source?: string, depth?: number): Failure;
+/** The error class a stored failure stands for, with its cause chain. */
+declare function failureToError(failure: Failure, depth?: number): WorkflowFailure;
+
 /** The version of @fluidgrids/workflows. */
-declare const SDK_VERSION = "2026.1027.1";
+declare const SDK_VERSION = "2026.1028.2";
 
-export { COLLECTION_FORMAT, type CollectedWorkflow, SDK_VERSION, type Tier1Collection, Tier1Recording, collectWorkflowExports };
+export { ActivityFailure, ApplicationError, type ApplicationErrorOptions, COLLECTION_FORMAT, CancelledFailure, ChildRunFailure, type CollectedDurableWorkflow, type CollectedTrigger, type CollectedWorkflow, DeterminismViolation, Failure, HistoryLimitExceeded, Json, JsonObject, PhaseCFeatureError, SDK_VERSION, ServerFailure, TerminatedFailure, type Tier1Collection, Tier1Recording, TimeoutFailure, WorkflowFailure, collectWorkflowExports, errorToFailure, failureToError, isCancellation };

package/dist/index.js

@@ -1,4 +1,9 @@
-export { COLLECTION_FORMAT, LAYOUT_FORMAT, LAYOUT_FORMAT_VERSION, RECORDING_FORMAT, RECORDING_FORMAT_VERSION, SDK_VERSION, UnresolvedConnectionsError, WorkflowBuilder, assembleRecording, collectWorkflowExports, defaultEdgeId, defineWorkflow, edge, internalNodes, isOperation, isTier1Workflow, nodes, op, parseLayoutSidecar, toIR, trigger, triggers } from './chunk-EEAIM35V.js';
+export { COLLECTION_FORMAT, collectWorkflowExports } from './chunk-XKJA7KX3.js';
+export { LAYOUT_FORMAT, LAYOUT_FORMAT_VERSION, RECORDING_FORMAT, RECORDING_FORMAT_VERSION, UnresolvedConnectionsError, WorkflowBuilder, assembleRecording, defaultEdgeId, defineWorkflow, edge, internalNodes, isOperation, isTier1Workflow, nodes, op, parseLayoutSidecar, toIR, trigger, triggers } from './chunk-HWJZVOG7.js';
 import './chunk-5LUIDMF4.js';
-export { BuilderError, PREDICATE_OPERATORS, and, expr, or } from './chunk-UB2BHU2M.js';
-import './chunk-UJNHTS6D.js';
+export { BuilderError, PREDICATE_OPERATORS, and, expr, or } from './chunk-JZ4TOOLN.js';
+import './chunk-7AAZGVKD.js';
+import './chunk-PMCM2OH4.js';
+export { ActivityFailure, ApplicationError, CancelledFailure, ChildRunFailure, DeterminismViolation, HistoryLimitExceeded, PhaseCFeatureError, ServerFailure, TerminatedFailure, TimeoutFailure, WorkflowFailure, defineQuery, defineSignal, defineUpdate, errorToFailure, failureToError, isCancellation, toMs } from './chunk-C5OLWZ42.js';
+import './chunk-LNUQE6D6.js';
+export { DURABLE_MARKER, SDK_VERSION, interfaceOf, isDurableWorkflow, jsonSchemaOf, workflow } from './chunk-N23SKIG4.js';