@fluidgrids/workflows 2026.1027.0 → 2026.1028.1

package/dist/{types-Dr2Fn1Ax.d.ts → types-BGoPzgcl.d.cts}

@@ -222,4 +222,4 @@ interface WorkflowDefinition {
     [key: string]: unknown;
 }
 
-export type { CodeBundleActivityExport as C, ErrorType as E, Json as J, LegacyCredentialRef as L, NodeArgs as N, Position as P, RetryConfig as R, WorkflowDefinition as W, JsonObject as a, WorkflowInterface as b, CodeBundleWorkflowExport as c, ConnectionRef as d, ExecutionSettings as e, NodeErrorConfig as f, NodeTimeout as g, RunOnSetting as h, WorkflowAuthoring as i, WorkflowCode as j, WorkflowConfig as k, WorkflowEdge as l, WorkflowNode as m };
+export type { CodeBundleActivityExport as C, ErrorType as E, JsonObject as J, LegacyCredentialRef as L, NodeArgs as N, Position as P, RetryConfig as R, WorkflowInterface as W, Json as a, WorkflowDefinition as b, CodeBundleWorkflowExport as c, ConnectionRef as d, ExecutionSettings as e, NodeErrorConfig as f, NodeTimeout as g, RunOnSetting as h, WorkflowAuthoring as i, WorkflowCode as j, WorkflowConfig as k, WorkflowEdge as l, WorkflowNode as m };

package/dist/{types-Dr2Fn1Ax.d.cts → types-BGoPzgcl.d.ts}

@@ -222,4 +222,4 @@ interface WorkflowDefinition {
     [key: string]: unknown;
 }
 
-export type { CodeBundleActivityExport as C, ErrorType as E, Json as J, LegacyCredentialRef as L, NodeArgs as N, Position as P, RetryConfig as R, WorkflowDefinition as W, JsonObject as a, WorkflowInterface as b, CodeBundleWorkflowExport as c, ConnectionRef as d, ExecutionSettings as e, NodeErrorConfig as f, NodeTimeout as g, RunOnSetting as h, WorkflowAuthoring as i, WorkflowCode as j, WorkflowConfig as k, WorkflowEdge as l, WorkflowNode as m };
+export type { CodeBundleActivityExport as C, ErrorType as E, JsonObject as J, LegacyCredentialRef as L, NodeArgs as N, Position as P, RetryConfig as R, WorkflowInterface as W, Json as a, WorkflowDefinition as b, CodeBundleWorkflowExport as c, ConnectionRef as d, ExecutionSettings as e, NodeErrorConfig as f, NodeTimeout as g, RunOnSetting as h, WorkflowAuthoring as i, WorkflowCode as j, WorkflowConfig as k, WorkflowEdge as l, WorkflowNode as m };

package/dist/types-CpBBjaGX.d.cts

@@ -0,0 +1,380 @@
+import { J as JsonObject, E as ErrorType, a as Json } from './types-BGoPzgcl.cjs';
+
+/**
+ * The durable-function history contract (PLAN-B C-HIST, C-CMD, C-ABI):
+ * event types, command types, workflow-task failure causes, failures and the
+ * records the service stores in `workflow_run_events`.
+ *
+ * This module is pure data and types. It has no imports with side effects, so
+ * the runtime that runs inside the isolate can bundle it, and the service, the
+ * workers and the Python SDK read the same lists through the JSON Schemas in
+ * `schema/` (generated from `schema.ts`).
+ */
+
+/** Version of the runtime ABI and of the history file format. */
+declare const HISTORY_PROTOCOL = 1;
+/** Every value of the `type` column of `workflow_run_events`, UPPER_SNAKE (DB4). */
+declare const EVENT_TYPES: readonly ["WORKFLOW_STARTED", "WORKFLOW_TASK_SCHEDULED", "WORKFLOW_TASK_STARTED", "WORKFLOW_TASK_COMPLETED", "WORKFLOW_TASK_FAILED", "WORKFLOW_TASK_TIMED_OUT", "ACTIVITY_SCHEDULED", "ACTIVITY_STARTED", "ACTIVITY_HEARTBEAT", "ACTIVITY_COMPLETED", "ACTIVITY_FAILED", "ACTIVITY_TIMED_OUT", "ACTIVITY_CANCEL_REQUESTED", "ACTIVITY_CANCELLED", "ACTIVITY_PAUSED", "ACTIVITY_UNPAUSED", "ACTIVITY_RESET", "ACTIVITY_OPTIONS_UPDATED", "TIMER_STARTED", "TIMER_FIRED", "TIMER_CANCELLED", "SIGNAL_RECEIVED", "UPDATE_ADMITTED", "UPDATE_ACCEPTED", "UPDATE_COMPLETED", "CHILD_RUN_INITIATED", "CHILD_RUN_STARTED", "CHILD_RUN_COMPLETED", "CHILD_RUN_FAILED", "CHILD_RUN_CANCELLED", "CHILD_RUN_TERMINATED", "CHILD_RUN_TIMED_OUT", "EXTERNAL_RUN_CANCEL_REQUESTED", "EXTERNAL_RUN_CANCEL_RESOLVED", "EXTERNAL_RUN_SIGNALED", "SIDE_EFFECT_RECORDED", "LOCAL_ACTIVITY_COMPLETED", "LOCAL_ACTIVITY_FAILED", "SEARCH_ATTRIBUTES_UPSERTED", "CONTEXT_UPSERTED", "MARKER_RECORDED", "WORKFLOW_CANCEL_REQUESTED", "WORKFLOW_RESET", "VERSIONING_OVERRIDE_SET", "WORKFLOW_COMPLETED", "WORKFLOW_FAILED", "WORKFLOW_CANCELLED", "WORKFLOW_TERMINATED", "WORKFLOW_TIMED_OUT", "WORKFLOW_CONTINUED_AS_NEW"];
+type RunEventType = (typeof EVENT_TYPES)[number];
+/** Every command a workflow task may return (C-CMD), UPPER_SNAKE. */
+declare const COMMAND_TYPES: readonly ["SCHEDULE_ACTIVITY", "REQUEST_CANCEL_ACTIVITY", "START_TIMER", "CANCEL_TIMER", "START_CHILD_RUN", "SIGNAL_RUN", "RECORD_SIDE_EFFECT", "RECORD_MARKER", "COMPLETE_WORKFLOW", "FAIL_WORKFLOW", "CANCEL_WORKFLOW", "UPSERT_CONTEXT", "RECORD_LOCAL_ACTIVITY", "CONTINUE_AS_NEW", "REQUEST_CANCEL_EXTERNAL_RUN", "UPSERT_SEARCH_ATTRIBUTES", "ACCEPT_UPDATE", "REJECT_UPDATE", "COMPLETE_UPDATE"];
+type CommandType = (typeof COMMAND_TYPES)[number];
+/** Commands of the Phase B core release. */
+declare const PHASE_B_CORE_COMMANDS: ReadonlySet<CommandType>;
+/** Commands of the Phase B parity releases (defined now, enabled by the service per release). */
+declare const PHASE_B_PARITY_COMMANDS: ReadonlySet<CommandType>;
+/** Commands that are defined but refused in Phase B (`UNSUPPORTED_COMMAND`). */
+declare const PHASE_C_COMMANDS: ReadonlySet<CommandType>;
+/** Commands that end the run; one may appear, and only last in a batch. */
+declare const TERMINAL_COMMANDS: ReadonlySet<CommandType>;
+/** Why a workflow task failed (`WorkflowTaskFailureCause`). A task failure never fails the run. */
+declare const TASK_FAILURE_CAUSES: readonly ["NON_DETERMINISM", "TASK_TIMEOUT", "ISOLATE_MEMORY", "PROTOCOL_MISMATCH", "BUNDLE_UNAVAILABLE", "BUNDLE_INTEGRITY", "WORKFLOW_CODE_ERROR", "HISTORY_LIMIT", "UNSUPPORTED_COMMAND", "INVALID_REQUEST", "INTERNAL"];
+type WorkflowTaskFailureCause = (typeof TASK_FAILURE_CAUSES)[number];
+/** The shared `ErrorType` enum, as a list. */
+declare const ERROR_TYPES: readonly ErrorType[];
+/** `ExecutionKind`. */
+declare const EXECUTION_KINDS: readonly ["GRAPH", "DURABLE_FN"];
+type ExecutionKind = (typeof EXECUTION_KINDS)[number];
+/** `ParentClosePolicy`. */
+declare const PARENT_CLOSE_POLICIES: readonly ["TERMINATE", "ABANDON", "REQUEST_CANCEL"];
+type ParentClosePolicy = (typeof PARENT_CLOSE_POLICIES)[number];
+/** Activity cancellation types (11 §2.5). */
+declare const ACTIVITY_CANCELLATION_TYPES: readonly ["WAIT_CANCELLATION_COMPLETED", "TRY_CANCEL", "ABANDON"];
+type ActivityCancellationType = (typeof ACTIVITY_CANCELLATION_TYPES)[number];
+/** Child cancellation types (11 §2.5). */
+declare const CHILD_CANCELLATION_TYPES: readonly ["WAIT_CANCELLATION_COMPLETED", "WAIT_CANCELLATION_REQUESTED", "TRY_CANCEL", "ABANDON"];
+type ChildCancellationType = (typeof CHILD_CANCELLATION_TYPES)[number];
+/** Where a failure came from (11 §2.25). */
+type FailureSource = 'sdk-ts' | 'sdk-py' | 'engine' | `node:${string}`;
+/**
+ * A failure as it is stored in history and passed between the SDK, the
+ * service and the workers (11 §2.25). `type` is the free-form application
+ * type; `errorType` is always one value of the shared enum.
+ */
+interface Failure {
+    errorType: ErrorType;
+    message: string;
+    type?: string;
+    details?: Json;
+    nonRetryable?: boolean;
+    /** Overrides the retry policy's delay for the next attempt only. */
+    nextRetryDelayMs?: number;
+    category?: 'BENIGN';
+    /** For timeouts: `START_TO_CLOSE`, `SCHEDULE_TO_START`, `SCHEDULE_TO_CLOSE`, `HEARTBEAT`, `WORKFLOW_RUN`, `WORKFLOW_EXECUTION`. */
+    timeoutType?: string;
+    cause?: Failure;
+    stackTrace?: string;
+    source?: string;
+}
+/**
+ * The retry policy an activity carries (`retryConfig` plus Temporal's
+ * deny-list). `maxRetries` absent means unlimited attempts, bounded by
+ * `scheduleToCloseTimeout`.
+ */
+interface RetryPolicy {
+    maxRetries?: number;
+    /** Delay before the first retry, in milliseconds. */
+    retryDelay: number;
+    backoffMultiplier?: number;
+    /** Largest delay, in milliseconds. */
+    maxDelay?: number;
+    /** Allow-list on `errorType`. */
+    retryOnErrorTypes?: ErrorType[];
+    /** Deny-list on the free-form `Failure.type`; wins over the allow-list. */
+    nonRetryableErrorTypes?: string[];
+}
+/** One stored history event, as the service returns it (offloaded payloads already inlined). */
+interface RunEventRecord {
+    /** 1-based, gapless. */
+    seq: number;
+    type: RunEventType;
+    /** The workflow task that produced the event, for command events and task events. */
+    taskId?: string | null;
+    payload: JsonObject;
+    /** ISO 8601 timestamp. */
+    createdAt: string;
+    dedupeKey?: string | null;
+}
+/** An event the service is to append (no `seq` or timestamp yet). */
+interface RunEventDraft {
+    type: RunEventType;
+    taskId?: string;
+    payload: JsonObject;
+}
+/** Headers carried on commands and events (interceptors, Phase C). */
+type Headers = Record<string, string>;
+interface CommandBase {
+    headers?: Headers;
+}
+/** Signal and cancel targets. `workflowKey`/`workflowId` addressing is parity (11 §2.1). */
+type RunTarget = {
+    runId: string;
+} | {
+    parent: true;
+} | {
+    childId: string;
+} | {
+    workflowKey: string;
+    workflowId: string;
+};
+interface ScheduleActivityCommand extends CommandBase {
+    type: 'SCHEDULE_ACTIVITY';
+    activityId: string;
+    kind: 'node';
+    nodeType: string;
+    nodeVersion?: string;
+    operation: string;
+    args: Json;
+    connection?: string;
+    retry: RetryPolicy;
+    startToCloseTimeout?: number;
+    scheduleToCloseTimeout?: number;
+    scheduleToStartTimeout?: number;
+    heartbeatTimeout?: number;
+    cancellationType?: ActivityCancellationType;
+    priority?: number;
+    summary?: string;
+    runOn?: string;
+}
+interface RequestCancelActivityCommand extends CommandBase {
+    type: 'REQUEST_CANCEL_ACTIVITY';
+    activityId: string;
+}
+interface StartTimerCommand extends CommandBase {
+    type: 'START_TIMER';
+    timerId: string;
+    durationMs: number;
+    summary?: string;
+}
+interface CancelTimerCommand extends CommandBase {
+    type: 'CANCEL_TIMER';
+    timerId: string;
+}
+/** Child start options (11 §2.35); everything but `parentClosePolicy` is optional. */
+interface ChildRunOptions {
+    parentClosePolicy: ParentClosePolicy;
+    cancellationType?: ChildCancellationType;
+    taskQueue?: string;
+    workflowId?: string;
+    priority?: number;
+    summary?: string;
+    details?: string;
+    context?: JsonObject;
+    executionTimeout?: number;
+    runTimeout?: number;
+    workflowTaskTimeout?: number;
+    startDelay?: number;
+    [key: string]: Json | undefined;
+}
+interface StartChildRunCommand extends CommandBase {
+    type: 'START_CHILD_RUN';
+    childId: string;
+    /** Another workflow (graph or durable) by key. */
+    workflowKey?: string;
+    /** A function of the same bundle, by export name. */
+    workflowFn?: string;
+    /** `active`, `vN` or `@alias`; default `active`. */
+    version?: string;
+    input: Json;
+    options: ChildRunOptions;
+}
+interface SignalRunCommand extends CommandBase {
+    type: 'SIGNAL_RUN';
+    externalId: string;
+    target: RunTarget;
+    name: string;
+    payload: Json;
+}
+interface RecordSideEffectCommand extends CommandBase {
+    type: 'RECORD_SIDE_EFFECT';
+    sideEffectId: string;
+    value: Json;
+}
+interface RecordMarkerCommand extends CommandBase {
+    type: 'RECORD_MARKER';
+    markerId: string;
+    data: Json;
+}
+interface CompleteWorkflowCommand extends CommandBase {
+    type: 'COMPLETE_WORKFLOW';
+    output: Json;
+}
+interface FailWorkflowCommand extends CommandBase {
+    type: 'FAIL_WORKFLOW';
+    failure: Failure;
+}
+interface CancelWorkflowCommand extends CommandBase {
+    type: 'CANCEL_WORKFLOW';
+}
+interface UpsertContextCommand extends CommandBase {
+    type: 'UPSERT_CONTEXT';
+    entries: JsonObject;
+}
+interface RecordLocalActivityCommand extends CommandBase {
+    type: 'RECORD_LOCAL_ACTIVITY';
+    localActivityId: string;
+    result?: Json;
+    failure?: Failure;
+    attempts: number;
+}
+interface ContinueAsNewCommand extends CommandBase {
+    type: 'CONTINUE_AS_NEW';
+    input: Json;
+    options: JsonObject;
+}
+interface RequestCancelExternalRunCommand extends CommandBase {
+    type: 'REQUEST_CANCEL_EXTERNAL_RUN';
+    externalId: string;
+    target: RunTarget;
+}
+interface UpsertSearchAttributesCommand extends CommandBase {
+    type: 'UPSERT_SEARCH_ATTRIBUTES';
+    attributes: JsonObject;
+}
+interface AcceptUpdateCommand extends CommandBase {
+    type: 'ACCEPT_UPDATE';
+    updateId: string;
+}
+interface RejectUpdateCommand extends CommandBase {
+    type: 'REJECT_UPDATE';
+    updateId: string;
+    failure: Failure;
+}
+interface CompleteUpdateCommand extends CommandBase {
+    type: 'COMPLETE_UPDATE';
+    updateId: string;
+    result?: Json;
+    failure?: Failure;
+}
+/** One command, a flat object discriminated by `type` (DB4). */
+type WorkflowCommand = ScheduleActivityCommand | RequestCancelActivityCommand | StartTimerCommand | CancelTimerCommand | StartChildRunCommand | SignalRunCommand | RecordSideEffectCommand | RecordMarkerCommand | CompleteWorkflowCommand | FailWorkflowCommand | CancelWorkflowCommand | UpsertContextCommand | RecordLocalActivityCommand | ContinueAsNewCommand | RequestCancelExternalRunCommand | UpsertSearchAttributesCommand | AcceptUpdateCommand | RejectUpdateCommand | CompleteUpdateCommand;
+/** History caps (C-HIST). */
+interface HistoryLimit {
+    events: number;
+    bytes: number;
+}
+declare const DEFAULT_HISTORY_LIMIT: HistoryLimit;
+/** Fraction of the cap at which `continueAsNewSuggested` turns true. */
+declare const CONTINUE_AS_NEW_SUGGESTED_RATIO = 0.8;
+/** Fraction of the cap at which the next command throws `HistoryLimitExceeded`. */
+declare const HISTORY_LIMIT_EXCEEDED_RATIO = 0.95;
+/** What a task knows about its run (C-ABI `WorkflowInfoSnapshot`). */
+interface WorkflowInfoSnapshot {
+    runId: string;
+    workspaceId: string;
+    workflowKey?: string;
+    version?: number | string;
+    buildId?: string;
+    businessId?: string;
+    attempt?: number;
+    taskQueue?: string;
+    parentRunId?: string | null;
+    rootRunId?: string | null;
+    firstRunId?: string | null;
+    continuedFromRunId?: string | null;
+    lastResult?: Json;
+    lastFailure?: Failure | null;
+    startedAt?: string;
+    runStartedAt?: string;
+    historyLimit?: HistoryLimit;
+    timeouts?: {
+        executionTimeout?: number;
+        runTimeout?: number;
+        workflowTaskTimeout?: number;
+    };
+    headers?: Headers;
+    priority?: number;
+    summary?: string;
+    details?: string;
+    context?: JsonObject;
+}
+/** A built-in query (11 §2.21). Custom queries are Phase C. */
+type BuiltInQueryName = '__stack_trace' | '__enhanced_stack_trace' | '__metadata';
+declare const BUILT_IN_QUERIES: readonly BuiltInQueryName[];
+/** The input of one workflow task (C-ABI). */
+interface WorkflowTaskRequest {
+    protocol: number;
+    kind: 'task' | 'query' | 'verify';
+    workflowFn: string;
+    info: WorkflowInfoSnapshot;
+    history: RunEventRecord[];
+    /** The task's start time; the clock for new side effects only. */
+    nowMs: number;
+    localActivityResults?: Array<{
+        localActivityId: string;
+        result?: Json;
+        failure?: Failure;
+        attempts: number;
+    }>;
+    queries?: Array<{
+        queryId: string;
+        name: BuiltInQueryName;
+        args?: Json;
+    }>;
+}
+/** A local activity the task wants run before it can continue (parity). */
+interface LocalActivityRequest {
+    localActivityId: string;
+    nodeType: string;
+    operation: string;
+    args: Json;
+    connection?: string;
+    retry?: RetryPolicy;
+    startToCloseTimeout?: number;
+}
+interface TaskLogLine {
+    level: 'debug' | 'info' | 'warn' | 'error';
+    message: string;
+    data?: Json;
+}
+/** The output of one workflow task (C-ABI). */
+interface WorkflowTaskResult {
+    protocol: number;
+    outcome: 'commands' | 'failed' | 'localActivityRequested';
+    commands: WorkflowCommand[];
+    localActivityRequests?: LocalActivityRequest[];
+    queryResults?: Array<{
+        queryId: string;
+        value?: Json;
+        error?: string;
+    }>;
+    failure?: {
+        cause: WorkflowTaskFailureCause;
+        message: string;
+        stackTrace?: string;
+        seq?: number;
+        errorType?: string;
+    };
+    logs: TaskLogLine[];
+    stackTrace?: string;
+}
+/**
+ * The event each command appends (C-CMD). `REJECT_UPDATE` appends nothing: a
+ * rejected update leaves no history (11 §2.39). `RECORD_LOCAL_ACTIVITY`
+ * appends `LOCAL_ACTIVITY_COMPLETED` or `LOCAL_ACTIVITY_FAILED` by outcome.
+ */
+declare const COMMAND_EVENT_TYPES: Readonly<Record<CommandType, RunEventType | null>>;
+/**
+ * Events a command appends. During replay each one is matched against the
+ * command the code issues at the same position (spec 04 §4).
+ * `EXTERNAL_RUN_SIGNALED` is a command event only in its initiated form (no
+ * `resolved`); the service's delivery outcome is an input event of the same
+ * type with `resolved: true`.
+ */
+declare const COMMAND_EVENTS: ReadonlySet<RunEventType>;
+/** Events that deliver something to the workflow code (resolve an awaitable or run a handler). */
+declare const INPUT_EVENTS: ReadonlySet<RunEventType>;
+/** Events that end the run. */
+declare const TERMINAL_EVENTS: ReadonlySet<RunEventType>;
+/** True when the event delivers something to the code (see {@link INPUT_EVENTS}). */
+declare function isInputEvent(event: {
+    type: RunEventType;
+    payload: JsonObject;
+}): boolean;
+/** True when the event was appended for a command (see {@link COMMAND_EVENTS}). */
+declare function isCommandEvent(event: {
+    type: RunEventType;
+    payload: JsonObject;
+}): boolean;
+
+export { type StartTimerCommand as $, ACTIVITY_CANCELLATION_TYPES as A, BUILT_IN_QUERIES as B, type ChildCancellationType as C, DEFAULT_HISTORY_LIMIT as D, ERROR_TYPES as E, type Failure as F, PHASE_B_PARITY_COMMANDS as G, HISTORY_LIMIT_EXCEEDED_RATIO as H, INPUT_EVENTS as I, PHASE_C_COMMANDS as J, type RecordLocalActivityCommand as K, type LocalActivityRequest as L, type RecordMarkerCommand as M, type RecordSideEffectCommand as N, type RejectUpdateCommand as O, type ParentClosePolicy as P, type RequestCancelActivityCommand as Q, type RetryPolicy as R, type RequestCancelExternalRunCommand as S, type RunEventDraft as T, type RunEventRecord as U, type RunEventType as V, type WorkflowCommand as W, type RunTarget as X, type ScheduleActivityCommand as Y, type SignalRunCommand as Z, type StartChildRunCommand as _, type WorkflowTaskFailureCause as a, TASK_FAILURE_CAUSES as a0, TERMINAL_COMMANDS as a1, TERMINAL_EVENTS as a2, type TaskLogLine as a3, type UpsertContextCommand as a4, type UpsertSearchAttributesCommand as a5, type WorkflowInfoSnapshot as a6, type WorkflowTaskRequest as a7, type WorkflowTaskResult as a8, isCommandEvent as a9, isInputEvent as aa, type AcceptUpdateCommand as b, type ActivityCancellationType as c, type BuiltInQueryName as d, CHILD_CANCELLATION_TYPES as e, COMMAND_EVENTS as f, COMMAND_EVENT_TYPES as g, COMMAND_TYPES as h, CONTINUE_AS_NEW_SUGGESTED_RATIO as i, type CancelTimerCommand as j, type CancelWorkflowCommand as k, type ChildRunOptions as l, type CommandType as m, type CompleteUpdateCommand as n, type CompleteWorkflowCommand as o, type ContinueAsNewCommand as p, EVENT_TYPES as q, EXECUTION_KINDS as r, type ExecutionKind as s, type FailWorkflowCommand as t, type FailureSource as u, HISTORY_PROTOCOL as v, type Headers as w, type HistoryLimit as x, PARENT_CLOSE_POLICIES as y, PHASE_B_CORE_COMMANDS as z };