@fluidgrids/workflows 2026.1028.2 → 2026.1030.1

package/dist/ir/index.d.ts

@@ -1,8 +1,8 @@
-import { b as WorkflowDefinition, W as WorkflowInterface, J as JsonObject, P as Position } from '../types-BGoPzgcl.js';
-export { C as CodeBundleActivityExport, c as CodeBundleWorkflowExport, d as ConnectionRef, E as ErrorType, e as ExecutionSettings, a as Json, L as LegacyCredentialRef, N as NodeArgs, f as NodeErrorConfig, g as NodeTimeout, R as RetryConfig, h as RunOnSetting, i as WorkflowAuthoring, j as WorkflowCode, k as WorkflowConfig, l as WorkflowEdge, m as WorkflowNode } from '../types-BGoPzgcl.js';
+import { W as WorkflowDefinition, b as WorkflowInterface, J as JsonObject, P as Position } from '../types-V7jEEUaL.js';
+export { C as CodeBundleActivityExport, c as CodeBundleWorkflowExport, d as ConnectionRef, E as ErrorType, e as ExecutionSettings, a as Json, L as LegacyCredentialRef, N as NodeArgs, f as NodeErrorConfig, g as NodeTimeout, R as RetryConfig, h as RunOnSetting, i as WorkflowAuthoring, j as WorkflowCode, k as WorkflowConfig, l as WorkflowEdge, m as WorkflowNode, n as WorkflowRunRetryConfig } from '../types-V7jEEUaL.js';
 export { S as SourceFile, b as buildIdOf, h as hashedProjection, i as irHash, s as sourceHash } from '../hash-CZkTXPCX.js';
-import { N as NodeManifest } from '../manifest-C8N6HDYl.js';
-export { M as ManifestField, a as ManifestHandles, b as ManifestOperation, f as fieldSchema, c as fieldsSchema, d as findManifest, i as isTriggerOperation, o as operationsOf } from '../manifest-C8N6HDYl.js';
+import { N as NodeManifest } from '../manifest-D-I_twys.js';
+export { M as ManifestField, a as ManifestHandles, b as ManifestOperation, f as fieldSchema, c as fieldsSchema, d as findManifest, i as isTriggerOperation, o as operationsOf } from '../manifest-D-I_twys.js';
 export { P as PathSegment, R as RefRoot, T as TemplatePart, V as ValueRefModel, f as formatRefExpression, a as formatRefTemplate, p as parseRefExpression, b as parseTemplate } from '../expressions-DhHaqyar.js';
 
 /**
@@ -354,6 +354,205 @@ declare const IR_V2_SCHEMA: {
                         };
                     };
                 };
+            }, {
+                readonly if: {
+                    readonly properties: {
+                        readonly type: {
+                            readonly const: "internal:signal-run";
+                        };
+                    };
+                    readonly required: readonly ["type"];
+                };
+                readonly then: {
+                    readonly description: "Phase C (fluidgrids.run-control): signal another run of the workspace (05 §4). A retried node delivers once (dedupe key signal-node:<nodeStateId>:<attempt>).";
+                    readonly required: readonly ["args"];
+                    readonly properties: {
+                        readonly args: {
+                            readonly required: readonly ["state"];
+                            readonly properties: {
+                                readonly state: {
+                                    readonly type: "object";
+                                    readonly required: readonly ["signalName", "target"];
+                                    readonly properties: {
+                                        readonly signalName: {
+                                            readonly type: "string";
+                                            readonly minLength: 1;
+                                        };
+                                        readonly target: {
+                                            readonly description: "The run to signal: { runId }, { workflowKey, workflowId, firstRunId? } (the open run of that workflow id) or { parent: true }. Values may be expressions.";
+                                            readonly oneOf: readonly [{
+                                                readonly type: "object";
+                                                readonly required: readonly ["runId"];
+                                                readonly properties: {
+                                                    readonly runId: {
+                                                        readonly type: "string";
+                                                        readonly minLength: 1;
+                                                    };
+                                                };
+                                                readonly additionalProperties: false;
+                                            }, {
+                                                readonly type: "object";
+                                                readonly required: readonly ["workflowKey", "workflowId"];
+                                                readonly properties: {
+                                                    readonly workflowKey: {
+                                                        readonly type: "string";
+                                                        readonly minLength: 1;
+                                                    };
+                                                    readonly workflowId: {
+                                                        readonly type: "string";
+                                                        readonly minLength: 1;
+                                                    };
+                                                    readonly firstRunId: {
+                                                        readonly type: "string";
+                                                        readonly minLength: 1;
+                                                    };
+                                                };
+                                                readonly additionalProperties: false;
+                                            }, {
+                                                readonly type: "object";
+                                                readonly required: readonly ["parent"];
+                                                readonly properties: {
+                                                    readonly parent: {
+                                                        readonly const: true;
+                                                    };
+                                                };
+                                                readonly additionalProperties: false;
+                                            }];
+                                        };
+                                        readonly payload: {};
+                                        readonly failOnUndelivered: {
+                                            readonly type: "boolean";
+                                            readonly description: "Default true: an undelivered signal fails the node.";
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            }, {
+                readonly if: {
+                    readonly properties: {
+                        readonly type: {
+                            readonly const: "internal:set-search-attributes";
+                        };
+                    };
+                    readonly required: readonly ["type"];
+                };
+                readonly then: {
+                    readonly description: "Phase C (fluidgrids.search-attributes): upsert the run search attributes (11 §2.8); a null value removes one. Values may be expressions; the service validates them against the workspace definitions.";
+                    readonly required: readonly ["args"];
+                    readonly properties: {
+                        readonly args: {
+                            readonly required: readonly ["state"];
+                            readonly properties: {
+                                readonly state: {
+                                    readonly type: "object";
+                                    readonly required: readonly ["attributes"];
+                                    readonly properties: {
+                                        readonly attributes: {
+                                            readonly type: "object";
+                                            readonly minProperties: 1;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            }, {
+                readonly if: {
+                    readonly properties: {
+                        readonly type: {
+                            readonly const: "internal:schedule";
+                        };
+                    };
+                    readonly required: readonly ["type"];
+                };
+                readonly then: {
+                    readonly properties: {
+                        readonly args: {
+                            readonly properties: {
+                                readonly state: {
+                                    readonly description: "Phase C schedule policies (11 §2.16, §2.33; fluidgrids.schedule-policies). Every field is optional; a trigger without overlapPolicy keeps the ALLOW_ALL behaviour of earlier versions.";
+                                    readonly properties: {
+                                        readonly overlapPolicy: {
+                                            readonly enum: readonly ["SKIP", "BUFFER_ONE", "BUFFER_ALL", "CANCEL_OTHER", "TERMINATE_OTHER", "ALLOW_ALL"];
+                                        };
+                                        readonly catchupWindow: {
+                                            readonly oneOf: readonly [{
+                                                readonly type: "number";
+                                                readonly minimum: 0;
+                                            }, {
+                                                readonly type: "string";
+                                                readonly minLength: 1;
+                                            }];
+                                        };
+                                        readonly pauseOnFailure: {
+                                            readonly type: "boolean";
+                                        };
+                                        readonly limitedActions: {
+                                            readonly type: "integer";
+                                            readonly minimum: 1;
+                                        };
+                                        readonly scheduleContext: {
+                                            readonly type: "object";
+                                        };
+                                        readonly scheduleSearchAttributes: {
+                                            readonly type: "object";
+                                        };
+                                        readonly spec: {
+                                            readonly description: "One of cron, calendar or interval, plus excludeCalendars (calendar entries whose matches are skipped), startAt, endAt (ISO 8601), timezone and jitter.";
+                                            readonly properties: {
+                                                readonly cron: {
+                                                    readonly type: "string";
+                                                };
+                                                readonly calendar: {
+                                                    readonly type: "array";
+                                                    readonly items: {
+                                                        readonly type: "object";
+                                                    };
+                                                };
+                                                readonly interval: {
+                                                    readonly type: "array";
+                                                    readonly items: {
+                                                        readonly type: "object";
+                                                    };
+                                                };
+                                                readonly excludeCalendars: {
+                                                    readonly type: "array";
+                                                    readonly items: {
+                                                        readonly type: "object";
+                                                    };
+                                                };
+                                                readonly startAt: {
+                                                    readonly type: "string";
+                                                    readonly minLength: 1;
+                                                };
+                                                readonly endAt: {
+                                                    readonly type: "string";
+                                                    readonly minLength: 1;
+                                                };
+                                                readonly timezone: {
+                                                    readonly type: "string";
+                                                };
+                                                readonly jitter: {
+                                                    readonly oneOf: readonly [{
+                                                        readonly type: "number";
+                                                        readonly minimum: 0;
+                                                    }, {
+                                                        readonly type: "string";
+                                                        readonly minLength: 1;
+                                                    }];
+                                                };
+                                            };
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
             }];
         };
         readonly edge: {
@@ -412,6 +611,32 @@ declare const IR_V2_SCHEMA: {
                 readonly versioningBehavior: {
                     readonly enum: readonly ["PINNED", "AUTO_UPGRADE"];
                 };
+                readonly retry: {
+                    readonly type: "object";
+                    readonly description: "Run-level retry of DURABLE_FN runs (11 §2.17); delays are seconds or duration strings. Graph runs keep their own meaning of retry.";
+                    readonly properties: {
+                        readonly maxAttempts: {
+                            readonly type: "integer";
+                            readonly minimum: 1;
+                        };
+                        readonly initialDelay: {
+                            readonly type: readonly ["number", "string"];
+                        };
+                        readonly backoffMultiplier: {
+                            readonly type: "number";
+                            readonly minimum: 1;
+                        };
+                        readonly maxDelay: {
+                            readonly type: readonly ["number", "string"];
+                        };
+                        readonly nonRetryableErrorTypes: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                    };
+                };
             };
         };
         readonly interface: {
@@ -531,6 +756,10 @@ declare const IR_V2_SCHEMA: {
                                     readonly taskQueue: {
                                         readonly type: "string";
                                     };
+                                    readonly config: {
+                                        readonly $ref: "#/$defs/config";
+                                        readonly description: "R2: the run-level settings of this function's workflow() declaration (retry, timeout, executionTimeout, workflowTaskTimeout, versioningBehavior). The service resolves run options per workflowFn from this table, never from the definition-level config, so a same-bundle child started on its parent's definition gets its own settings. Absent: the function declares none.";
+                                    };
                                 };
                             };
                         };
@@ -556,6 +785,15 @@ declare const IR_V2_SCHEMA: {
                 readonly determinism: {
                     readonly enum: readonly ["isolate", "worker"];
                 };
+                readonly features: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly uniqueItems: true;
+                    readonly description: "Runtime features the bundle uses (C-FEATURES): localActivity, externalCancel, childOptions, canOptions, autoUpgrade, runRetry, timeouts (SDK R2); userActivity, updates, queries, searchAttributes, dynamic and interceptors (Phase C, C-R1). A bundle without the field was built before R2 and uses none.";
+                };
             };
         };
         readonly authoring: {
@@ -823,6 +1061,37 @@ declare function checkScheduleSpec(spec: unknown, options?: {
     now?: Date;
     timezone?: unknown;
 }): ScheduleCheck;
+/** A problem with a schedule trigger's policy fields (11 §2.16). */
+interface SchedulePolicyProblem {
+    field: string;
+    message: string;
+}
+/**
+ * Check the Phase C policy fields of a schedule trigger's `args.state`
+ * (`overlapPolicy`, `catchupWindow`, `pauseOnFailure`, `limitedActions`,
+ * `scheduleContext`, `scheduleSearchAttributes`). Absent fields are fine: a
+ * trigger without `overlapPolicy` keeps the legacy ALLOW_ALL behaviour.
+ */
+declare function checkSchedulePolicy(state: Record<string, unknown>): SchedulePolicyProblem | undefined;
+
+/**
+ * Schedule trigger fields of Phase C (11 §2.16, §2.33), shared by the IR
+ * schema and the schedule checker. Pure data.
+ */
+/** What a tick does while a run from an earlier tick is still open (11 §2.16). */
+declare const SCHEDULE_OVERLAP_POLICIES: readonly ["SKIP", "BUFFER_ONE", "BUFFER_ALL", "CANCEL_OTHER", "TERMINATE_OTHER", "ALLOW_ALL"];
+type ScheduleOverlapPolicy = (typeof SCHEDULE_OVERLAP_POLICIES)[number];
+/**
+ * The overlap policy the UI proposes for a new policy save. A stored trigger
+ * without `overlapPolicy` keeps the legacy ALLOW_ALL behaviour (CX14, H3).
+ */
+declare const DEFAULT_NEW_SCHEDULE_OVERLAP_POLICY: ScheduleOverlapPolicy;
+/** The default catch-up window after an outage (11 §2.16): one hour. */
+declare const DEFAULT_SCHEDULE_CATCHUP_WINDOW_SECONDS = 3600;
+/** Policy fields of the schedule trigger's `args.state` (beside `spec`). */
+declare const SCHEDULE_POLICY_FIELDS: readonly ["overlapPolicy", "catchupWindow", "pauseOnFailure", "limitedActions", "scheduleContext", "scheduleSearchAttributes"];
+/** Fields a `spec` may carry beside its one kind (`cron`, `calendar`, `interval`). */
+declare const SCHEDULE_SPEC_FIELDS: readonly ["excludeCalendars", "startAt", "endAt", "timezone", "jitter"];
 
 /**
  * Node type knowledge shared by normalisation, validation and lifting.
@@ -835,14 +1104,20 @@ declare function checkScheduleSpec(spec: unknown, options?: {
 /** Node types added by IR version 2 (spec 01 §3). */
 declare const CODE_WORKFLOW_NODE_TYPE = "internal:code-workflow";
 declare const WAIT_FOR_SIGNAL_NODE_TYPE = "internal:wait-for-signal";
+/** Phase C (run control): signal another run from the canvas (05 §4). */
+declare const SIGNAL_RUN_NODE_TYPE = "internal:signal-run";
+/** Phase C (search attributes): upsert the run's search attributes from the canvas (11 §2.8). */
+declare const SET_SEARCH_ATTRIBUTES_NODE_TYPE = "internal:set-search-attributes";
+/** The IR node types Phase C adds; the service seeds their manifests behind a switch. */
+declare const PHASE_C_NODE_TYPES: ReadonlySet<string>;
 /** Internal trigger node types seeded by wspace-workflow-svc (`triggers/manifests`). */
 declare const INTERNAL_TRIGGER_TYPES: ReadonlySet<string>;
 /**
  * True when the node goes through the internal node executor and therefore
  * sees the merged `data < config < data.args.state < args.state` parameters.
- * The two version-2 node types are internal by design and are treated the
- * same way.
+ * The version-2 node types are internal by design and are treated the same
+ * way.
  */
 declare function usesMergedParameters(type: string): boolean;
 
-export { CODE_WORKFLOW_NODE_TYPE, CanonicalJsonError, type DefinitionChange, type ExecutorNodeView, INTERNAL_TRIGGER_TYPES, IR_V2_SCHEMA, IR_V2_SCHEMA_ID, JsonObject, LAYOUT_COLUMN_WIDTH, LAYOUT_ROW_HEIGHT, NodeManifest, type ParsedWorkflowDocument, Position, type ScheduleCheck, type ValidateOptions, type ValidationIssue, type ValidationResult, WAIT_FOR_SIGNAL_NODE_TYPE, WORKFLOW_DOCUMENT_FORMAT, WorkflowDefinition, type WorkflowExportDocument, type WorkflowExportInput, WorkflowInterface, type WorkflowNodeReference, autoLayout, buildExportDocument, canonicalJson, checkScheduleSpec, deriveInterface, diffDefinitions, durationMs, envelopeSchemaVersion, executorNodeView, executorView, exportDefinition, isV2Definition, isValidJsonSchema, normalizeDefinition, parseWorkflowDocument, readWorkflowDocument, serializeWorkflowDocument, sha256Hex, sha256Tagged, stableStringify, usesMergedParameters, validate, workflowInputsSchema };
+export { CODE_WORKFLOW_NODE_TYPE, CanonicalJsonError, DEFAULT_NEW_SCHEDULE_OVERLAP_POLICY, DEFAULT_SCHEDULE_CATCHUP_WINDOW_SECONDS, type DefinitionChange, type ExecutorNodeView, INTERNAL_TRIGGER_TYPES, IR_V2_SCHEMA, IR_V2_SCHEMA_ID, JsonObject, LAYOUT_COLUMN_WIDTH, LAYOUT_ROW_HEIGHT, NodeManifest, PHASE_C_NODE_TYPES, type ParsedWorkflowDocument, Position, SCHEDULE_OVERLAP_POLICIES, SCHEDULE_POLICY_FIELDS, SCHEDULE_SPEC_FIELDS, SET_SEARCH_ATTRIBUTES_NODE_TYPE, SIGNAL_RUN_NODE_TYPE, type ScheduleCheck, type ScheduleOverlapPolicy, type SchedulePolicyProblem, type ValidateOptions, type ValidationIssue, type ValidationResult, WAIT_FOR_SIGNAL_NODE_TYPE, WORKFLOW_DOCUMENT_FORMAT, WorkflowDefinition, type WorkflowExportDocument, type WorkflowExportInput, WorkflowInterface, type WorkflowNodeReference, autoLayout, buildExportDocument, canonicalJson, checkSchedulePolicy, checkScheduleSpec, deriveInterface, diffDefinitions, durationMs, envelopeSchemaVersion, executorNodeView, executorView, exportDefinition, isV2Definition, isValidJsonSchema, normalizeDefinition, parseWorkflowDocument, readWorkflowDocument, serializeWorkflowDocument, sha256Hex, sha256Tagged, stableStringify, usesMergedParameters, validate, workflowInputsSchema };