@fluidgrids/workflows 2026.1027.0 → 2026.1028.1

package/dist/ir/index.d.cts

@@ -1,8 +1,8 @@
-import { W as WorkflowDefinition, b as WorkflowInterface, a as JsonObject, P as Position } from '../types-Dr2Fn1Ax.cjs';
-export { C as CodeBundleActivityExport, c as CodeBundleWorkflowExport, d as ConnectionRef, E as ErrorType, e as ExecutionSettings, J 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-Dr2Fn1Ax.cjs';
+import { b as WorkflowDefinition, W as WorkflowInterface, J as JsonObject, P as Position } from '../types-BGoPzgcl.cjs';
+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.cjs';
 export { S as SourceFile, b as buildIdOf, h as hashedProjection, i as irHash, s as sourceHash } from '../hash-CZkTXPCX.cjs';
-import { N as NodeManifest } from '../manifest-Duf-gHdO.cjs';
-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-Duf-gHdO.cjs';
+import { N as NodeManifest } from '../manifest-0OLw0i7k.cjs';
+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-0OLw0i7k.cjs';
 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.cjs';
 
 /**
@@ -322,6 +322,13 @@ declare const IR_V2_SCHEMA: {
                                             readonly type: "string";
                                             readonly minLength: 1;
                                         };
+                                        readonly consume: {
+                                            readonly enum: readonly ["first", "all"];
+                                        };
+                                        readonly limitWaitUntil: {
+                                            readonly type: "string";
+                                            readonly minLength: 1;
+                                        };
                                         readonly limitWait: {
                                             readonly type: "object";
                                             readonly required: readonly ["amount", "unit"];
@@ -339,6 +346,9 @@ declare const IR_V2_SCHEMA: {
                                             readonly type: "object";
                                         };
                                     };
+                                    readonly not: {
+                                        readonly required: readonly ["limitWait", "limitWaitUntil"];
+                                    };
                                 };
                             };
                         };
@@ -610,6 +620,24 @@ interface ExecutorNodeView {
     disabled: boolean;
     nodeDataNodeType: unknown;
     argsContextNodeType: unknown;
+    /**
+     * `data.operation_name` as the run-context node data carries it
+     * (`workflow-executor.service.ts:1823`).
+     */
+    dataOperationName: unknown;
+    /** The node-state row version: `data.version || '1.0.0'` (`:3955`, `:4205`, `:4292`). */
+    nodeStateVersion: unknown;
+    /**
+     * The state an adapter or tool sub-node sees: `args.state || data.args.state || {}`
+     * (`:5539`, `:6486`). Sub-nodes resolve a registered store endpoint, so this is
+     * `undefined` for internal node types.
+     */
+    subNodeState: unknown;
+    /**
+     * The operation a tool sub-node binds: `state.operation || data.operation_name`
+     * (`buildToolConfigLocally`, `:6491`). `undefined` for internal node types.
+     */
+    toolOperation: unknown;
 }
 /** The executor-visible values of one node. */
 declare function executorNodeView(node: unknown): ExecutorNodeView;
@@ -645,14 +673,6 @@ declare function isValidJsonSchema(schema: unknown): boolean;
 /** Validate a workflow definition. */
 declare function validate(definition: unknown, options?: ValidateOptions): ValidationResult;
 
-/**
- * Canonical JSON (RFC 8785, JSON Canonicalization Scheme).
- *
- * Object keys are sorted by UTF-16 code units, numbers use the ECMAScript
- * shortest round-trip form, strings use the ECMAScript escaping, and there is
- * no insignificant whitespace. The Python SDK implements the same scheme, so a
- * graph lowered by either SDK hashes to the same `irHash`.
- */
 declare class CanonicalJsonError extends Error {
     constructor(message: string);
 }

package/dist/ir/index.d.ts

@@ -1,8 +1,8 @@
-import { W as WorkflowDefinition, b as WorkflowInterface, a as JsonObject, P as Position } from '../types-Dr2Fn1Ax.js';
-export { C as CodeBundleActivityExport, c as CodeBundleWorkflowExport, d as ConnectionRef, E as ErrorType, e as ExecutionSettings, J 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-Dr2Fn1Ax.js';
+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';
 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-Bp9ZJlav.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-Bp9ZJlav.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';
 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';
 
 /**
@@ -322,6 +322,13 @@ declare const IR_V2_SCHEMA: {
                                             readonly type: "string";
                                             readonly minLength: 1;
                                         };
+                                        readonly consume: {
+                                            readonly enum: readonly ["first", "all"];
+                                        };
+                                        readonly limitWaitUntil: {
+                                            readonly type: "string";
+                                            readonly minLength: 1;
+                                        };
                                         readonly limitWait: {
                                             readonly type: "object";
                                             readonly required: readonly ["amount", "unit"];
@@ -339,6 +346,9 @@ declare const IR_V2_SCHEMA: {
                                             readonly type: "object";
                                         };
                                     };
+                                    readonly not: {
+                                        readonly required: readonly ["limitWait", "limitWaitUntil"];
+                                    };
                                 };
                             };
                         };
@@ -610,6 +620,24 @@ interface ExecutorNodeView {
     disabled: boolean;
     nodeDataNodeType: unknown;
     argsContextNodeType: unknown;
+    /**
+     * `data.operation_name` as the run-context node data carries it
+     * (`workflow-executor.service.ts:1823`).
+     */
+    dataOperationName: unknown;
+    /** The node-state row version: `data.version || '1.0.0'` (`:3955`, `:4205`, `:4292`). */
+    nodeStateVersion: unknown;
+    /**
+     * The state an adapter or tool sub-node sees: `args.state || data.args.state || {}`
+     * (`:5539`, `:6486`). Sub-nodes resolve a registered store endpoint, so this is
+     * `undefined` for internal node types.
+     */
+    subNodeState: unknown;
+    /**
+     * The operation a tool sub-node binds: `state.operation || data.operation_name`
+     * (`buildToolConfigLocally`, `:6491`). `undefined` for internal node types.
+     */
+    toolOperation: unknown;
 }
 /** The executor-visible values of one node. */
 declare function executorNodeView(node: unknown): ExecutorNodeView;
@@ -645,14 +673,6 @@ declare function isValidJsonSchema(schema: unknown): boolean;
 /** Validate a workflow definition. */
 declare function validate(definition: unknown, options?: ValidateOptions): ValidationResult;
 
-/**
- * Canonical JSON (RFC 8785, JSON Canonicalization Scheme).
- *
- * Object keys are sorted by UTF-16 code units, numbers use the ECMAScript
- * shortest round-trip form, strings use the ECMAScript escaping, and there is
- * no insignificant whitespace. The Python SDK implements the same scheme, so a
- * graph lowered by either SDK hashes to the same `irHash`.
- */
 declare class CanonicalJsonError extends Error {
     constructor(message: string);
 }

package/dist/ir/index.js

@@ -1,12 +1,15 @@
-export { diffDefinitions } from '../chunk-4DPEGDPW.js';
-import { findManifest, operationsOf, fieldsSchema } from '../chunk-GO34UHSY.js';
-export { fieldSchema, fieldsSchema, findManifest, isTriggerOperation, operationsOf } from '../chunk-GO34UHSY.js';
-import { usesMergedParameters, CODE_WORKFLOW_NODE_TYPE, INTERNAL_TRIGGER_TYPES, V2_NODE_TYPES, normalizeDefinition } from '../chunk-SS4LT2IP.js';
-export { CODE_WORKFLOW_NODE_TYPE, INTERNAL_TRIGGER_TYPES, WAIT_FOR_SIGNAL_NODE_TYPE, buildIdOf, hashedProjection, irHash, normalizeDefinition, sourceHash, usesMergedParameters } from '../chunk-SS4LT2IP.js';
+export { diffDefinitions } from '../chunk-6FSHT5IL.js';
+import { findManifest, operationsOf, fieldsSchema } from '../chunk-QAN5MZEM.js';
+export { fieldSchema, fieldsSchema, findManifest, isTriggerOperation, operationsOf } from '../chunk-QAN5MZEM.js';
+import { usesMergedParameters, CODE_WORKFLOW_NODE_TYPE, WAIT_FOR_SIGNAL_NODE_TYPE, INTERNAL_TRIGGER_TYPES, V2_NODE_TYPES, normalizeDefinition } from '../chunk-BD7ZPG53.js';
+export { CODE_WORKFLOW_NODE_TYPE, INTERNAL_TRIGGER_TYPES, WAIT_FOR_SIGNAL_NODE_TYPE, buildIdOf, hashedProjection, irHash, normalizeDefinition, sourceHash, usesMergedParameters } from '../chunk-BD7ZPG53.js';
 export { LAYOUT_COLUMN_WIDTH, LAYOUT_ROW_HEIGHT, autoLayout } from '../chunk-5LUIDMF4.js';
-export { CanonicalJsonError, canonicalJson, sha256Hex, sha256Tagged, stableStringify } from '../chunk-X4HKU3MX.js';
-import { isRecord, hasLegacyTemplate } from '../chunk-REV7ZOA4.js';
-export { formatRefExpression, formatRefTemplate, parseRefExpression, parseTemplate } from '../chunk-REV7ZOA4.js';
+export { CanonicalJsonError, canonicalJson, sha256Hex, sha256Tagged, stableStringify } from '../chunk-E2VK7J2C.js';
+import { hasLegacyTemplate } from '../chunk-7AAZGVKD.js';
+export { formatRefExpression, formatRefTemplate, parseRefExpression, parseTemplate } from '../chunk-7AAZGVKD.js';
+import { isRecord, setOwn, deepEqual } from '../chunk-PMCM2OH4.js';
+import { durationMs } from '../chunk-LNUQE6D6.js';
+export { durationMs } from '../chunk-LNUQE6D6.js';
 import { Ajv2020 } from 'ajv/dist/2020.js';
 import { CronExpressionParser } from 'cron-parser';
 
@@ -161,6 +164,8 @@ var IR_V2_SCHEMA = {
                     required: ["signalName"],
                     properties: {
                       signalName: { type: "string", minLength: 1 },
+                      consume: { enum: ["first", "all"] },
+                      limitWaitUntil: { type: "string", minLength: 1 },
                       limitWait: {
                         type: "object",
                         required: ["amount", "unit"],
@@ -170,7 +175,8 @@ var IR_V2_SCHEMA = {
                         }
                       },
                       payloadSchema: JSON_SCHEMA_OBJECT
-                    }
+                    },
+                    not: { required: ["limitWait", "limitWaitUntil"] }
                   }
                 }
               }
@@ -363,6 +369,8 @@ function executorNodeView(node) {
   const nodeData = isRecord(data?.["nodeData"]) ? data["nodeData"] : void 0;
   const argsContext = isRecord(args?.["context"]) ? args["context"] : void 0;
   const contextNode = isRecord(argsContext?.["node"]) ? argsContext["node"] : void 0;
+  const subNodeState = merged ? void 0 : args?.["state"] || dataArgs?.["state"] || {};
+  const toolOperation = merged ? void 0 : (isRecord(subNodeState) ? subNodeState["operation"] : void 0) || data?.["operation_name"];
   return {
     id: record["id"],
     type: record["type"],
@@ -377,7 +385,11 @@ function executorNodeView(node) {
     runOn: dataSettings?.["runOn"],
     disabled: record["disabled"] === true || data?.["disabled"] === true,
     nodeDataNodeType: nodeData?.["nodeType"],
-    argsContextNodeType: contextNode?.["type"]
+    argsContextNodeType: contextNode?.["type"],
+    dataOperationName: data?.["operation_name"],
+    nodeStateVersion: data?.["version"] || "1.0.0",
+    subNodeState,
+    toolOperation
   };
 }
 function executorView(definition) {
@@ -385,46 +397,6 @@ function executorView(definition) {
   const nodes = definition["data"]["nodes"];
   return Array.isArray(nodes) ? nodes.map(executorNodeView) : [];
 }
-
-// src/ir/duration.ts
-var SHORT = /^(\d+(?:\.\d+)?)(ms|s|m|h|d|w)$/;
-var ISO = /^P(?:(\d+(?:\.\d+)?)W)?(?:(\d+(?:\.\d+)?)D)?(?:T(?:(\d+(?:\.\d+)?)H)?(?:(\d+(?:\.\d+)?)M)?(?:(\d+(?:\.\d+)?)S)?)?$/;
-var SECOND_MS = 1e3;
-var MINUTE_MS = 60 * SECOND_MS;
-var HOUR_MS = 60 * MINUTE_MS;
-var DAY_MS = 24 * HOUR_MS;
-var WEEK_MS = 7 * DAY_MS;
-var UNIT_MS = {
-  ms: 1,
-  s: SECOND_MS,
-  m: MINUTE_MS,
-  h: HOUR_MS,
-  d: DAY_MS,
-  w: WEEK_MS
-};
-function durationMs(value, numberUnit) {
-  if (typeof value === "number") {
-    if (!Number.isFinite(value) || value < 0) return void 0;
-    return numberUnit === "s" ? value * 1e3 : value;
-  }
-  if (typeof value !== "string") return void 0;
-  const text = value.trim();
-  const short = SHORT.exec(text);
-  if (short?.[1] !== void 0 && short[2] !== void 0) {
-    const unit = UNIT_MS[short[2]];
-    return unit === void 0 ? void 0 : Number(short[1]) * unit;
-  }
-  const iso = ISO.exec(text);
-  if (iso && text !== "P" && text !== "PT") {
-    const [, weeks, days, hours, minutes, seconds] = iso;
-    const parts = [weeks, days, hours, minutes, seconds];
-    if (parts.every((part) => part === void 0)) return void 0;
-    return Number(weeks ?? 0) * WEEK_MS + Number(days ?? 0) * DAY_MS + Number(hours ?? 0) * HOUR_MS + Number(minutes ?? 0) * MINUTE_MS + Number(seconds ?? 0) * SECOND_MS;
-  }
-  return void 0;
-}
-
-// src/ir/schedule.ts
 var FIRE_TIMES = 10;
 var MAX_ITERATIONS = 2e4;
 var CALENDAR_FIELDS = [
@@ -638,17 +610,13 @@ function legacyMirrors(node) {
   const data = isRecord(node["data"]) ? node["data"] : void 0;
   const dataArgs = isRecord(data?.["args"]) ? data["args"] : void 0;
   if (data) {
-    for (const key of [
-      "label",
-      "operation_name",
-      "errorConfig",
-      "disabled",
-      "state",
-      "nodeVersion"
-    ]) {
+    for (const key of ["label", "errorConfig", "disabled", "state", "nodeVersion"]) {
       if (data[key] !== void 0) found.push(`data.${key}`);
     }
-    if (!merged && data["version"] !== void 0) found.push("data.version");
+    if (data["operation_name"] !== void 0 && !deepEqual(data["operation_name"], node["operation_name"]))
+      found.push("data.operation_name");
+    if (!merged && data["version"] !== void 0 && !deepEqual(data["version"], node["version"]))
+      found.push("data.version");
     for (const key of ["state", "connections", "credentials", "context"]) {
       if (dataArgs?.[key] !== void 0) found.push(`data.args.${key}`);
     }
@@ -819,6 +787,31 @@ function validate(definition, options = {}) {
         });
       }
       if (typeof state?.["taskQueue"] === "string") taskQueues.add(state["taskQueue"]);
+      const policy = state?.["parentClosePolicy"];
+      if (state?.["waitForCompletion"] === false && (policy === "TERMINATE" || policy === "REQUEST_CANCEL"))
+        warnings.push({
+          code: "codeWorkflow.closePolicyEndsChild",
+          message: `waitForCompletion is false but parentClosePolicy is ${policy}: the child is stopped when the parent run ends; use ABANDON (the default) to let it outlive the parent`,
+          ...at,
+          path: "args.state.parentClosePolicy"
+        });
+      if (state?.["waitForCompletion"] === false && typeof state["timeout"] === "number" && state["timeout"] > 0)
+        warnings.push({
+          code: "codeWorkflow.timeoutIgnored",
+          message: "timeout applies only while the node waits for the child; it has no effect when waitForCompletion is false",
+          ...at,
+          path: "args.state.timeout"
+        });
+    }
+    if (type === WAIT_FOR_SIGNAL_NODE_TYPE) {
+      const until = state?.["limitWaitUntil"];
+      if (until !== void 0 && (typeof until !== "string" || Number.isNaN(Date.parse(until))))
+        fail({
+          code: "waitForSignal.invalidDeadline",
+          message: "limitWaitUntil must be an ISO 8601 date-time",
+          ...at,
+          path: "args.state.limitWaitUntil"
+        });
     }
     const isTrigger = INTERNAL_TRIGGER_TYPES.has(type) || id !== void 0 && (incoming.get(id) ?? 0) === 0;
     if (isTrigger && state?.["startDelay"] !== void 0) {
@@ -1076,7 +1069,7 @@ function workflowInputsSchema(workflowInputs) {
     const name = (rawName ?? "").trim();
     if (!name) continue;
     const type = (rawType ?? "").trim().toLowerCase();
-    properties[name] = FIELD_TYPES.has(type) ? { type } : {};
+    setOwn(properties, name, FIELD_TYPES.has(type) ? { type } : {});
     required.push(name);
   }
   return {
@@ -1117,4 +1110,4 @@ function deriveInterface(definition, options = {}) {
   return derived;
 }
 
-export { IR_V2_SCHEMA, IR_V2_SCHEMA_ID, WORKFLOW_DOCUMENT_FORMAT, buildExportDocument, checkScheduleSpec, deriveInterface, durationMs, envelopeSchemaVersion, executorNodeView, executorView, exportDefinition, isV2Definition, isValidJsonSchema, parseWorkflowDocument, readWorkflowDocument, serializeWorkflowDocument, validate, workflowInputsSchema };
+export { IR_V2_SCHEMA, IR_V2_SCHEMA_ID, WORKFLOW_DOCUMENT_FORMAT, buildExportDocument, checkScheduleSpec, deriveInterface, envelopeSchemaVersion, executorNodeView, executorView, exportDefinition, isV2Definition, isValidJsonSchema, parseWorkflowDocument, readWorkflowDocument, serializeWorkflowDocument, validate, workflowInputsSchema };

package/dist/lower-BuSvAFqi.d.cts

@@ -0,0 +1,129 @@
+import { S as SourceFile } from './hash-CZkTXPCX.cjs';
+import { b as WorkflowDefinition, W as WorkflowInterface } from './types-BGoPzgcl.cjs';
+import { C as ConnectionResolver } from './assemble-BLqQ8lSu.cjs';
+import { E as EsbuildApi, L as LowerError } from './lower-types-nofRXw9c.cjs';
+
+/** One vendored package: its version and its files (paths relative to the package root). */
+interface VendoredPackage {
+    version: string;
+    files: Readonly<Record<string, string>>;
+}
+/** Vendored packages by name (`zod`, `@scope/pkg`). */
+type VendoredDeps = Readonly<Record<string, VendoredPackage>>;
+interface BuildBundleOptions {
+    /** Entry modules. Default: every workflow source (see `defaultEntries`). */
+    entries?: readonly string[];
+    /** Vendored pure-ESM packages. */
+    deps?: VendoredDeps;
+    esbuild?: EsbuildApi;
+    /** Largest total size of the project sources, in UTF-8 bytes. Default 1 MiB. */
+    maxSourceBytes?: number;
+    /** Largest bundle, in UTF-8 bytes. Default 1.5 MiB (4 MiB with vendored deps). */
+    maxBundleBytes?: number;
+}
+interface BuiltBundle {
+    /** The ES module. */
+    bundle: string;
+    /** `sha256:<hex>` of the bundle. */
+    buildId: string;
+    /**
+     * `sha256:<hex>` of the project sources and, when there are any, the
+     * vendored packages (as `node_modules/<name>/<path>` files), so the source
+     * archive key changes whenever the inputs of the build do.
+     */
+    sourceHash: string;
+    entries: string[];
+}
+/** Node built-in module names (without the `node:` prefix). */
+declare const NODE_BUILTINS: ReadonlySet<string>;
+/** The default entry modules: workflow sources, not generated clients, tests or declarations. */
+declare function defaultEntries(paths: readonly string[]): string[];
+/** Split a bare specifier into package name and subpath (`@a/b/c` -> `@a/b`, `./c`). */
+declare function splitSpecifier(specifier: string): {
+    name: string;
+    subpath: string;
+};
+/** The file a vendored package exports at `subpath`, relative to the package root. */
+declare function resolvePackageEntry(name: string, pkg: VendoredPackage, subpath: string): string;
+/**
+ * The `sourceHash` of a build: the project files plus the vendored packages
+ * as `node_modules/<name>/<path>`. With no vendored packages it is the plain
+ * `sourceHash` of the project files, as in Phase A.
+ */
+declare function bundleSourceHash(files: ReadonlyMap<string, string>, deps?: VendoredDeps): string;
+/** Bundle a project into one ES module. */
+declare function buildBundle(files: ReadonlyMap<string, string>, options?: BuildBundleOptions): Promise<BuiltBundle>;
+
+/** Runs a bundle and returns the string value of its `__fluidgrids` export. */
+interface Evaluator {
+    /** `esm`: the bundle as built; `iife`: a script assigning the exports to `__fluidgridsBundle`. */
+    readonly format: 'esm' | 'iife';
+    evaluate(code: string): Promise<string>;
+}
+declare const EVALUATION_GLOBAL = "__fluidgridsBundle";
+declare const ESBUILD_VERSION = "0.28.2";
+/**
+ * The workflow code read the clock or a random source while it was defined
+ * (`Date.now()`, `new Date()`, `Math.random()`, …), which would make two builds
+ * of the same source differ.
+ */
+declare class DeterminismViolationError extends LowerError {
+    constructor(message: string);
+}
+interface LowerOptions {
+    /** Modules to evaluate. Default: every `.ts` file outside `.fluidgrids/`, except tests and declarations. */
+    entries?: readonly string[];
+    esbuild?: EsbuildApi;
+    evaluator?: Evaluator;
+    connections?: ConnectionResolver;
+    /** Largest JSON the evaluation may return. Default 16 MiB. */
+    maxOutputBytes?: number;
+    /** Largest total size of the source files, in UTF-8 bytes, checked before esbuild. Default 1 MiB. */
+    maxSourceBytes?: number;
+    /** Largest bundle, in UTF-8 bytes, checked before evaluation. Default 1.5 MiB (4 MiB with deps). */
+    maxBundleBytes?: number;
+    /** Vendored pure-ESM packages the workflow code imports (see `buildBundle`). */
+    deps?: VendoredDeps;
+}
+/** A problem `lower()` found in tier-2 sources without running them. */
+interface LowerIssue {
+    code: 'durable.phaseC' | 'durable.activityTypeNotAllowed';
+    message: string;
+    module: string;
+}
+interface LoweredWorkflow {
+    key: string;
+    module: string;
+    exportName: string;
+    definition: WorkflowDefinition;
+}
+interface LowerResult {
+    /** `sha256:<hex>` of the bundle. */
+    buildId: string;
+    bundle: string;
+    /** `sha256:<hex>` of the source files. */
+    sourceHash: string;
+    workflows: LoweredWorkflow[];
+    /** The bundle's tier-2 functions, by export name (`code.exports.workflows`). */
+    durableExports: Record<string, {
+        interface: WorkflowInterface;
+        taskQueue: string;
+    }>;
+    /** Findings in tier-2 sources (Phase C features, refused activity node types). */
+    issues: LowerIssue[];
+}
+/**
+ * Bundle a project. Exported so services can compute `buildId` without
+ * evaluating; `buildBundle()` is the full form (vendored packages, limits).
+ */
+declare function bundleProject(files: ReadonlyMap<string, string>, entries: readonly string[], esbuild: EsbuildApi): Promise<string>;
+/**
+ * Find Phase C features and refused activity node types in the modules that
+ * declare tier-2 functions, without running them. The runtime and the service
+ * refuse both as well; this reports them before a push.
+ */
+declare function scanDurableSources(files: ReadonlyMap<string, string>, modules: Iterable<string>): LowerIssue[];
+/** Lower TypeScript sources (tier 1 and tier 2) to IR v2. */
+declare function lower(files: readonly SourceFile[] | Readonly<Record<string, string>>, options?: LowerOptions): Promise<LowerResult>;
+
+export { type BuildBundleOptions as B, DeterminismViolationError as D, type Evaluator as E, type LowerIssue as L, NODE_BUILTINS as N, type VendoredDeps as V, type VendoredPackage as a, type BuiltBundle as b, ESBUILD_VERSION as c, EVALUATION_GLOBAL as d, type LowerOptions as e, type LowerResult as f, type LoweredWorkflow as g, buildBundle as h, bundleProject as i, bundleSourceHash as j, defaultEntries as k, lower as l, splitSpecifier as m, resolvePackageEntry as r, scanDurableSources as s };

package/dist/lower-C_Qv_34S.d.ts

@@ -0,0 +1,129 @@
+import { S as SourceFile } from './hash-CZkTXPCX.js';
+import { b as WorkflowDefinition, W as WorkflowInterface } from './types-BGoPzgcl.js';
+import { C as ConnectionResolver } from './assemble-DWgaXHd-.js';
+import { E as EsbuildApi, L as LowerError } from './lower-types-nofRXw9c.js';
+
+/** One vendored package: its version and its files (paths relative to the package root). */
+interface VendoredPackage {
+    version: string;
+    files: Readonly<Record<string, string>>;
+}
+/** Vendored packages by name (`zod`, `@scope/pkg`). */
+type VendoredDeps = Readonly<Record<string, VendoredPackage>>;
+interface BuildBundleOptions {
+    /** Entry modules. Default: every workflow source (see `defaultEntries`). */
+    entries?: readonly string[];
+    /** Vendored pure-ESM packages. */
+    deps?: VendoredDeps;
+    esbuild?: EsbuildApi;
+    /** Largest total size of the project sources, in UTF-8 bytes. Default 1 MiB. */
+    maxSourceBytes?: number;
+    /** Largest bundle, in UTF-8 bytes. Default 1.5 MiB (4 MiB with vendored deps). */
+    maxBundleBytes?: number;
+}
+interface BuiltBundle {
+    /** The ES module. */
+    bundle: string;
+    /** `sha256:<hex>` of the bundle. */
+    buildId: string;
+    /**
+     * `sha256:<hex>` of the project sources and, when there are any, the
+     * vendored packages (as `node_modules/<name>/<path>` files), so the source
+     * archive key changes whenever the inputs of the build do.
+     */
+    sourceHash: string;
+    entries: string[];
+}
+/** Node built-in module names (without the `node:` prefix). */
+declare const NODE_BUILTINS: ReadonlySet<string>;
+/** The default entry modules: workflow sources, not generated clients, tests or declarations. */
+declare function defaultEntries(paths: readonly string[]): string[];
+/** Split a bare specifier into package name and subpath (`@a/b/c` -> `@a/b`, `./c`). */
+declare function splitSpecifier(specifier: string): {
+    name: string;
+    subpath: string;
+};
+/** The file a vendored package exports at `subpath`, relative to the package root. */
+declare function resolvePackageEntry(name: string, pkg: VendoredPackage, subpath: string): string;
+/**
+ * The `sourceHash` of a build: the project files plus the vendored packages
+ * as `node_modules/<name>/<path>`. With no vendored packages it is the plain
+ * `sourceHash` of the project files, as in Phase A.
+ */
+declare function bundleSourceHash(files: ReadonlyMap<string, string>, deps?: VendoredDeps): string;
+/** Bundle a project into one ES module. */
+declare function buildBundle(files: ReadonlyMap<string, string>, options?: BuildBundleOptions): Promise<BuiltBundle>;
+
+/** Runs a bundle and returns the string value of its `__fluidgrids` export. */
+interface Evaluator {
+    /** `esm`: the bundle as built; `iife`: a script assigning the exports to `__fluidgridsBundle`. */
+    readonly format: 'esm' | 'iife';
+    evaluate(code: string): Promise<string>;
+}
+declare const EVALUATION_GLOBAL = "__fluidgridsBundle";
+declare const ESBUILD_VERSION = "0.28.2";
+/**
+ * The workflow code read the clock or a random source while it was defined
+ * (`Date.now()`, `new Date()`, `Math.random()`, …), which would make two builds
+ * of the same source differ.
+ */
+declare class DeterminismViolationError extends LowerError {
+    constructor(message: string);
+}
+interface LowerOptions {
+    /** Modules to evaluate. Default: every `.ts` file outside `.fluidgrids/`, except tests and declarations. */
+    entries?: readonly string[];
+    esbuild?: EsbuildApi;
+    evaluator?: Evaluator;
+    connections?: ConnectionResolver;
+    /** Largest JSON the evaluation may return. Default 16 MiB. */
+    maxOutputBytes?: number;
+    /** Largest total size of the source files, in UTF-8 bytes, checked before esbuild. Default 1 MiB. */
+    maxSourceBytes?: number;
+    /** Largest bundle, in UTF-8 bytes, checked before evaluation. Default 1.5 MiB (4 MiB with deps). */
+    maxBundleBytes?: number;
+    /** Vendored pure-ESM packages the workflow code imports (see `buildBundle`). */
+    deps?: VendoredDeps;
+}
+/** A problem `lower()` found in tier-2 sources without running them. */
+interface LowerIssue {
+    code: 'durable.phaseC' | 'durable.activityTypeNotAllowed';
+    message: string;
+    module: string;
+}
+interface LoweredWorkflow {
+    key: string;
+    module: string;
+    exportName: string;
+    definition: WorkflowDefinition;
+}
+interface LowerResult {
+    /** `sha256:<hex>` of the bundle. */
+    buildId: string;
+    bundle: string;
+    /** `sha256:<hex>` of the source files. */
+    sourceHash: string;
+    workflows: LoweredWorkflow[];
+    /** The bundle's tier-2 functions, by export name (`code.exports.workflows`). */
+    durableExports: Record<string, {
+        interface: WorkflowInterface;
+        taskQueue: string;
+    }>;
+    /** Findings in tier-2 sources (Phase C features, refused activity node types). */
+    issues: LowerIssue[];
+}
+/**
+ * Bundle a project. Exported so services can compute `buildId` without
+ * evaluating; `buildBundle()` is the full form (vendored packages, limits).
+ */
+declare function bundleProject(files: ReadonlyMap<string, string>, entries: readonly string[], esbuild: EsbuildApi): Promise<string>;
+/**
+ * Find Phase C features and refused activity node types in the modules that
+ * declare tier-2 functions, without running them. The runtime and the service
+ * refuse both as well; this reports them before a push.
+ */
+declare function scanDurableSources(files: ReadonlyMap<string, string>, modules: Iterable<string>): LowerIssue[];
+/** Lower TypeScript sources (tier 1 and tier 2) to IR v2. */
+declare function lower(files: readonly SourceFile[] | Readonly<Record<string, string>>, options?: LowerOptions): Promise<LowerResult>;
+
+export { type BuildBundleOptions as B, DeterminismViolationError as D, type Evaluator as E, type LowerIssue as L, NODE_BUILTINS as N, type VendoredDeps as V, type VendoredPackage as a, type BuiltBundle as b, ESBUILD_VERSION as c, EVALUATION_GLOBAL as d, type LowerOptions as e, type LowerResult as f, type LoweredWorkflow as g, buildBundle as h, bundleProject as i, bundleSourceHash as j, defaultEntries as k, lower as l, splitSpecifier as m, resolvePackageEntry as r, scanDurableSources as s };

package/dist/lower-types-nofRXw9c.d.cts

@@ -0,0 +1,15 @@
+import * as esbuild from 'esbuild';
+
+/** Why an evaluation produced no collection. */
+type IsolateFailure = 'error' | 'timeout' | 'determinism' | 'no-collection' | 'out-of-memory' | 'crashed';
+
+/** The esbuild API surface lower() uses (`esbuild` or `esbuild-wasm`, version 0.28.2). */
+type EsbuildApi = Pick<typeof esbuild, 'build' | 'transform'>;
+/** Why lowering failed, when the cause is one a caller may want to tell apart. */
+type LowerFailureReason = IsolateFailure | 'too-large';
+declare class LowerError extends Error {
+    readonly reason?: LowerFailureReason | undefined;
+    constructor(message: string, reason?: LowerFailureReason | undefined);
+}
+
+export { type EsbuildApi as E, LowerError as L, type LowerFailureReason as a };

package/dist/lower-types-nofRXw9c.d.ts

@@ -0,0 +1,15 @@
+import * as esbuild from 'esbuild';
+
+/** Why an evaluation produced no collection. */
+type IsolateFailure = 'error' | 'timeout' | 'determinism' | 'no-collection' | 'out-of-memory' | 'crashed';
+
+/** The esbuild API surface lower() uses (`esbuild` or `esbuild-wasm`, version 0.28.2). */
+type EsbuildApi = Pick<typeof esbuild, 'build' | 'transform'>;
+/** Why lowering failed, when the cause is one a caller may want to tell apart. */
+type LowerFailureReason = IsolateFailure | 'too-large';
+declare class LowerError extends Error {
+    readonly reason?: LowerFailureReason | undefined;
+    constructor(message: string, reason?: LowerFailureReason | undefined);
+}
+
+export { type EsbuildApi as E, LowerError as L, type LowerFailureReason as a };

package/dist/{manifest-Duf-gHdO.d.cts → manifest-0OLw0i7k.d.cts}

@@ -1,4 +1,4 @@
-import { a as JsonObject } from './types-Dr2Fn1Ax.cjs';
+import { J as JsonObject } from './types-BGoPzgcl.cjs';
 
 /** One input or output field. Output fields may also be a bare type name. */
 interface ManifestField {

package/dist/{manifest-Bp9ZJlav.d.ts → manifest-C8N6HDYl.d.ts}

@@ -1,4 +1,4 @@
-import { a as JsonObject } from './types-Dr2Fn1Ax.js';
+import { J as JsonObject } from './types-BGoPzgcl.js';
 
 /** One input or output field. Output fields may also be a bare type name. */
 interface ManifestField {

package/dist/node-evaluator-CJNP4GHX.js

@@ -0,0 +1,12 @@
+export { createNodeVmEvaluator } from './chunk-XB53G2DK.js';
+import './chunk-H7KEVW2M.js';
+import './chunk-PDHLTDZB.js';
+import './chunk-5HDSBTBX.js';
+import './chunk-BD7ZPG53.js';
+import './chunk-5LUIDMF4.js';
+import './chunk-JZ4TOOLN.js';
+import './chunk-E2VK7J2C.js';
+import './chunk-7AAZGVKD.js';
+import './chunk-PMCM2OH4.js';
+import './chunk-7NQ37GZU.js';
+import './chunk-BO6OVILK.js';