@fluidgrids/workflows 2026.1027.0 → 2026.1028.1

package/dist/{assemble-BJo9TECS.d.cts → workflow-FXUkpIBc.d.cts}

@@ -1,127 +1,5 @@
-import { J as Json, a as JsonObject, m as WorkflowNode, l as WorkflowEdge, d as ConnectionRef, L as LegacyCredentialRef, R as RetryConfig, g as NodeTimeout, f as NodeErrorConfig, e as ExecutionSettings, k as WorkflowConfig, b as WorkflowInterface, j as WorkflowCode, P as Position, i as WorkflowAuthoring, W as WorkflowDefinition } from './types-Dr2Fn1Ax.cjs';
-
-/**
- * Node operation descriptors: what a builder call needs to know about the node
- * it emits. Generated clients (`.fluidgrids/nodes.ts`) are lists of these;
- * the built-in internal nodes and triggers ship here so `nodes.internal.*` and
- * `triggers.*` work without a registry.
- */
-
-/** A file reference in node inputs and outputs. */
-interface FileRef {
-    fileId: string;
-    name?: string;
-    mimeType?: string;
-    size?: number;
-}
-declare const OPERATION_TYPES: unique symbol;
-/** One node operation. `In` and `Out` type the arguments and the output. */
-interface Operation<In = Record<string, Json>, Out = Json> {
-    readonly kind: 'operation';
-    readonly nodeType: string;
-    /** Written as the node's `version` unless the call overrides it. */
-    readonly version?: string;
-    /** Written as the node's `operation_name` unless the call overrides it. */
-    readonly operation?: string;
-    readonly role?: 'trigger';
-    /** Type-level only; never present at run time. */
-    readonly [OPERATION_TYPES]?: {
-        input: In;
-        output: Out;
-    };
-}
-/** A trigger operation. */
-type TriggerOperation<In = Record<string, Json>, Out = Json> = Operation<In, Out> & {
-    readonly role: 'trigger';
-};
-/** Describe a node operation (generated clients call this). */
-declare function op<In = Record<string, Json>, Out = Json>(nodeType: string, version?: string, operation?: string): Operation<In, Out>;
-/** Describe a trigger operation (generated clients call this). */
-declare function trigger<In = Record<string, Json>, Out = Json>(nodeType: string, version?: string, operation?: string): TriggerOperation<In, Out>;
-/** True for a value made by {@link op} or {@link trigger}. */
-declare function isOperation(value: unknown): value is Operation<unknown, unknown>;
-/** Built-in trigger nodes (`wspace-workflow-svc` `triggers/manifests`). */
-declare const triggers: {
-    readonly api: TriggerOperation<Record<string, Json>, Json>;
-    readonly manual: TriggerOperation<Record<string, Json>, Json>;
-    readonly schedule: TriggerOperation<Record<string, Json>, Json>;
-    readonly webhook: TriggerOperation<Record<string, Json>, Json>;
-    readonly form: TriggerOperation<Record<string, Json>, Json>;
-    readonly errorTrigger: TriggerOperation<Record<string, Json>, Json>;
-    readonly workflowCall: TriggerOperation<Record<string, Json>, Json>;
-    readonly rssFeed: TriggerOperation<Record<string, Json>, Json>;
-    readonly httpPoll: TriggerOperation<Record<string, Json>, Json>;
-    readonly databasePoll: TriggerOperation<Record<string, Json>, Json>;
-    readonly emailImap: TriggerOperation<Record<string, Json>, Json>;
-    readonly fileUpload: TriggerOperation<Record<string, Json>, Json>;
-    readonly recordChange: TriggerOperation<Record<string, Json>, Json>;
-    readonly stateChange: TriggerOperation<Record<string, Json>, Json>;
-};
-/** Built-in internal nodes (`wspace-workflow-svc` `internalnodes/manifests`, plus the two IR v2 nodes). */
-declare const internalNodes: {
-    readonly merge: Operation<Record<string, Json>, Json>;
-    readonly if: Operation<Record<string, Json>, Json>;
-    readonly switch: Operation<Record<string, Json>, Json>;
-    readonly loop: Operation<Record<string, Json>, Json>;
-    readonly set: Operation<Record<string, Json>, Json>;
-    readonly filter: Operation<Record<string, Json>, Json>;
-    readonly aggregate: Operation<Record<string, Json>, Json>;
-    readonly wait: Operation<Record<string, Json>, Json>;
-    readonly noop: Operation<Record<string, Json>, Json>;
-    readonly code: Operation<Record<string, Json>, Json>;
-    readonly http: Operation<Record<string, Json>, Json>;
-    readonly transform: Operation<Record<string, Json>, Json>;
-    readonly validate: Operation<Record<string, Json>, Json>;
-    readonly log: Operation<Record<string, Json>, Json>;
-    readonly error: Operation<Record<string, Json>, Json>;
-    readonly subworkflow: Operation<Record<string, Json>, Json>;
-    readonly compareDatasets: Operation<Record<string, Json>, Json>;
-    readonly splitOut: Operation<Record<string, Json>, Json>;
-    readonly limit: Operation<Record<string, Json>, Json>;
-    readonly dedupe: Operation<Record<string, Json>, Json>;
-    readonly sort: Operation<Record<string, Json>, Json>;
-    readonly dataTable: Operation<Record<string, Json>, Json>;
-    readonly respondToWebhook: Operation<Record<string, Json>, Json>;
-    readonly sendAndWait: Operation<Record<string, Json>, Json>;
-    readonly codeWorkflow: Operation<Record<string, Json>, Json>;
-    readonly waitForSignal: Operation<Record<string, Json>, Json>;
-};
-/** Node clients that need no registry: the internal nodes and `custom()`. */
-declare const nodes: {
-    readonly internal: {
-        readonly merge: Operation<Record<string, Json>, Json>;
-        readonly if: Operation<Record<string, Json>, Json>;
-        readonly switch: Operation<Record<string, Json>, Json>;
-        readonly loop: Operation<Record<string, Json>, Json>;
-        readonly set: Operation<Record<string, Json>, Json>;
-        readonly filter: Operation<Record<string, Json>, Json>;
-        readonly aggregate: Operation<Record<string, Json>, Json>;
-        readonly wait: Operation<Record<string, Json>, Json>;
-        readonly noop: Operation<Record<string, Json>, Json>;
-        readonly code: Operation<Record<string, Json>, Json>;
-        readonly http: Operation<Record<string, Json>, Json>;
-        readonly transform: Operation<Record<string, Json>, Json>;
-        readonly validate: Operation<Record<string, Json>, Json>;
-        readonly log: Operation<Record<string, Json>, Json>;
-        readonly error: Operation<Record<string, Json>, Json>;
-        readonly subworkflow: Operation<Record<string, Json>, Json>;
-        readonly compareDatasets: Operation<Record<string, Json>, Json>;
-        readonly splitOut: Operation<Record<string, Json>, Json>;
-        readonly limit: Operation<Record<string, Json>, Json>;
-        readonly dedupe: Operation<Record<string, Json>, Json>;
-        readonly sort: Operation<Record<string, Json>, Json>;
-        readonly dataTable: Operation<Record<string, Json>, Json>;
-        readonly respondToWebhook: Operation<Record<string, Json>, Json>;
-        readonly sendAndWait: Operation<Record<string, Json>, Json>;
-        readonly codeWorkflow: Operation<Record<string, Json>, Json>;
-        readonly waitForSignal: Operation<Record<string, Json>, Json>;
-    };
-    /**
-     * Any node type, including ones the registry snapshot does not know. Typed
-     * as JSON in and out.
-     */
-    readonly custom: (nodeType: string, operation?: string, version?: string) => Operation<Record<string, Json>, Json>;
-};
+import { a as Json, J as JsonObject, d as ConnectionRef, L as LegacyCredentialRef, R as RetryConfig, g as NodeTimeout, f as NodeErrorConfig, e as ExecutionSettings, m as WorkflowNode, l as WorkflowEdge, k as WorkflowConfig, W as WorkflowInterface, j as WorkflowCode } from './types-BGoPzgcl.cjs';
+import { h as DurableWorkflow, O as Operation } from './workflow-J-yYixny.cjs';
 
 /**
  * Typed references and predicates for the tier-1 builder (spec 02 §3).
@@ -270,7 +148,11 @@ interface CompareRef extends NodeRef {
 }
 /** Options of an explicit edge, made with {@link edge}. */
 interface EdgeOptions {
-    /** Edge id. Default: `e-<source>-<target>[-<sourceHandle>][-<targetHandle>]`; `false` writes none. */
+    /**
+     * Edge id. Default: `e-<source>-<target>[-<sourceHandle>][-<targetHandle>]`, with
+     * `-2`, `-3`, … added in declaration order when that id is already taken;
+     * `false` writes none.
+     */
     id?: string | false;
     /** Edge type. Default `deletable` (what the canvas writes); `false` writes none. */
     type?: string | false;
@@ -379,15 +261,26 @@ interface Tier1Recording {
     edgeOrder?: Array<string | number>;
     notes: RecordedNote[];
 }
+/** A `wf.codeWorkflow` node whose `workflowFn` is resolved to an export name at collection. */
+interface DurableRef {
+    nodeId: string;
+    definition: DurableWorkflow<never, unknown>;
+}
 /** The value `defineWorkflow` returns. */
 interface Tier1Workflow {
     readonly __fluidgrids: typeof WORKFLOW_MARKER;
     readonly key: string;
     readonly recording: Tier1Recording;
+    /** `wf.codeWorkflow` calls given a function; not part of the recording JSON. */
+    readonly durableRefs?: readonly DurableRef[];
 }
 /** True for a value returned by {@link defineWorkflow}. */
 declare function isTier1Workflow(value: unknown): value is Tier1Workflow;
-/** Default edge id, the scheme the AI draft generator uses. */
+/**
+ * Default edge id, the scheme the AI draft generator uses. Ids may contain `-`,
+ * so two edges can share a default id (`a` to `b-c` and `a-b` to `c`); the
+ * builder then gives the later edges `-2`, `-3`, … in declaration order.
+ */
 declare function defaultEdgeId(source: string, target: string, sourceHandle?: string, targetHandle?: string): string;
 /** Options of `wf.if`. */
 interface IfOptions extends NodeOptions {
@@ -422,6 +315,27 @@ interface WaitForSignalOptions extends NodeOptions {
         amount: number;
         unit: string;
     };
+    /** `limitWaitUntil`: an absolute deadline (ISO 8601). Give `limit` or `until`, not both. */
+    until?: string | Date;
+    /** `first` (default) resumes with one signal; `all` collects every buffered one. */
+    consume?: 'first' | 'all';
+}
+/** Options of `wf.codeWorkflow`. */
+interface CodeWorkflowOptions extends NodeOptions {
+    /** `inputMapping`; default passthrough. */
+    input?: ArgValue;
+    /** Default `managed` (the only queue in Phase B). */
+    taskQueue?: string;
+    /** Default true. */
+    waitForCompletion?: boolean;
+    /** Node-level timeout in seconds; 0 or absent means none. */
+    timeoutSeconds?: number;
+    failOnError?: boolean;
+    /**
+     * Default (DB13, applied by the service when absent): `TERMINATE` when the
+     * node waits for completion, `ABANDON` when it does not.
+     */
+    parentClosePolicy?: 'TERMINATE' | 'ABANDON' | 'REQUEST_CANCEL';
 }
 /** Options of `wf.subworkflow`. */
 interface SubworkflowOptions extends NodeOptions {
@@ -447,8 +361,12 @@ declare class WorkflowBuilder {
     private readonly edges;
     private readonly notes;
     private readonly ids;
+    /** Ids given explicitly; a second edge with the same explicit id is an error. */
     private readonly edgeIds;
+    /** Edges whose id is the default, as indices into `edges`, with the unsuffixed default id. */
+    private readonly defaultIds;
     private edgeOrder;
+    private readonly durableRefs;
     constructor(autoIds: boolean);
     /** A reference to a node by id, for nodes declared later in the source. */
     ref(id: string): NodeRef;
@@ -476,6 +394,14 @@ declare class WorkflowBuilder {
     sendAndWait(options: NodeOptions): ApprovalRef;
     /** `internal:subworkflow`. */
     subworkflow(options: SubworkflowOptions): NodeRef;
+    /**
+     * `internal:code-workflow`: run a tier-2 function of this project as a
+     * durable child run. `fn` is a `workflow()` value (its export name is
+     * resolved when the bundle is collected) or an export name.
+     */
+    codeWorkflow(fn: DurableWorkflow<never, unknown> | string, options?: CodeWorkflowOptions): NodeRef;
+    /** The `wf.codeWorkflow` calls that named a function. */
+    durableReferences(): DurableRef[];
     /** `internal:validate`. */
     validate(options: NodeOptions): ValidateRef;
     /** `internal:compare-datasets`. */
@@ -525,45 +451,17 @@ declare class WorkflowBuilder {
     finish(key: string, document: JsonObject): Tier1Recording;
     private claimId;
     private resolveId;
+    /**
+     * Give every edge declared without an id its default id. Explicit ids are
+     * claimed first, so a default never takes an id the code names; a default that
+     * is taken gets `-2`, `-3`, … in declaration order. The result depends only on
+     * the builder calls.
+     */
+    private assignDefaultEdgeIds;
     private addEdge;
     private add;
 }
 /** Define a tier-1 workflow. The callback runs once, immediately. */
 declare function defineWorkflow(options: WorkflowOptions, build: (wf: WorkflowBuilder) => void): Tier1Workflow;
 
-declare const LAYOUT_FORMAT = "fluidgrids.layout";
-declare const LAYOUT_FORMAT_VERSION = 1;
-/**
- * The layout sidecar (`workflows/<key>.layout.json`): canvas positions, sticky
- * notes and `meta.layout`, kept out of the code so it stays readable.
- */
-interface LayoutSidecar {
-    format: typeof LAYOUT_FORMAT;
-    formatVersion: typeof LAYOUT_FORMAT_VERSION;
-    positions: Record<string, Position>;
-    stickyNotes?: JsonObject[];
-    metaLayout?: JsonObject;
-}
-/** How connection names in code resolve to connection references. */
-type ConnectionResolver = Readonly<Record<string, ConnectionRef>> | ((name: string) => ConnectionRef | undefined);
-interface AssembleOptions {
-    layout?: LayoutSidecar;
-    connections?: ConnectionResolver;
-    /** TEST-only pinned data (`workflows/<key>.pinned.json`). */
-    pinnedData?: JsonObject;
-    /** Provenance; defaults to `{ mode: 'canvas', generator: 'sdk-ts', generatorVersion }`. */
-    authoring?: WorkflowAuthoring;
-}
-/** Connection names used in code that the target workspace does not have. */
-declare class UnresolvedConnectionsError extends Error {
-    readonly names: string[];
-    constructor(names: string[]);
-}
-/** Validate a parsed layout sidecar. */
-declare function parseLayoutSidecar(value: unknown): LayoutSidecar;
-/** Assemble IR v2 from a recording. */
-declare function assembleRecording(recording: Tier1Recording, options?: AssembleOptions): WorkflowDefinition;
-/** Lower a tier-1 workflow to IR v2 (spec 10 §1 `toIR`). */
-declare function toIR(workflow: Tier1Workflow, options?: AssembleOptions): WorkflowDefinition;
-
-export { defineWorkflow as $, type AfterInput as A, BuilderError as B, type CompareRef as C, type SwitchOptions as D, type EdgeOptions as E, type FileRef as F, type SwitchRef as G, type HandleRef as H, type IfOptions as I, type Tier1Workflow as J, type TriggerOperation as K, LAYOUT_FORMAT as L, type MergeOptions as M, type NodeOptions as N, type OnErrorOption as O, PREDICATE_OPERATORS as P, WorkflowBuilder as Q, RECORDING_FORMAT as R, type SignalWaitRef as S, type Tier1Recording as T, UnresolvedConnectionsError as U, type ValidateRef as V, type WaitForSignalOptions as W, type WorkflowOptions as X, and as Y, assembleRecording as Z, defaultEdgeId as _, type AnyRef as a, edge as a0, expr as a1, internalNodes as a2, isOperation as a3, isTier1Workflow as a4, nodes as a5, op as a6, or as a7, parseLayoutSidecar as a8, toIR as a9, trigger as aa, triggers as ab, type ApprovalRef as b, type ArgValue as c, type ArgsOf as d, type AssembleOptions as e, type ConditionGroup as f, type ConditionRule as g, type ConnectionResolver as h, type EdgeSource as i, type EdgeSpec as j, type IfRef as k, LAYOUT_FORMAT_VERSION as l, type LayoutSidecar as m, type LoopOptions as n, type LoopRef as o, type NodeRef as p, type NoteOptions as q, type Operation as r, type OutputRef as s, type Predicate as t, type PredicateMethods as u, RECORDING_FORMAT_VERSION as v, type RecordedNode as w, type RecordedNote as x, type RuleValue as y, type SubworkflowOptions as z };
+export { type AfterInput as A, BuilderError as B, type CodeWorkflowOptions as C, type DurableRef as D, type EdgeOptions as E, and as F, defaultEdgeId as G, type HandleRef as H, type IfOptions as I, defineWorkflow as J, edge as K, type LoopOptions as L, type MergeOptions as M, type NodeOptions as N, type OnErrorOption as O, PREDICATE_OPERATORS as P, expr as Q, RECORDING_FORMAT as R, type SignalWaitRef as S, type Tier1Recording as T, isTier1Workflow as U, type ValidateRef as V, type WaitForSignalOptions as W, or as X, type AnyRef as a, type ApprovalRef as b, type ArgValue as c, type ArgsOf as d, type CompareRef as e, type ConditionGroup as f, type ConditionRule as g, type EdgeSource as h, type EdgeSpec as i, type IfRef as j, type LoopRef as k, type NodeRef as l, type NoteOptions as m, type OutputRef as n, type Predicate as o, type PredicateMethods as p, RECORDING_FORMAT_VERSION as q, type RecordedNode as r, type RecordedNote as s, type RuleValue as t, type SubworkflowOptions as u, type SwitchOptions as v, type SwitchRef as w, type Tier1Workflow as x, WorkflowBuilder as y, type WorkflowOptions as z };