@swirls/looms 0.3.0 → 0.5.0

package/dist/workflow/effects.d.ts

@@ -23,6 +23,19 @@ export declare const scheduleEffect: NoInfer<import("@swirls/looms/core").Effect
     } | undefined;
     readonly input?: Schema.Json | undefined;
 }, WorkflowDefinitionsTag, (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.child.close.requested";
+    readonly payload: {
+        readonly policy: "terminate" | "wait";
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.child.settled";
+    readonly payload: {
+        readonly runId: string;
+        readonly status: "cancelled" | "completed" | "failed";
+        readonly output: Schema.Json;
+        readonly error: string | null;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
     readonly type: "runtime.effect.ambiguous";
     readonly payload: {
         readonly effectId: string;
@@ -66,6 +79,8 @@ export declare const scheduleEffect: NoInfer<import("@swirls/looms/core").Effect
     readonly payload: {
         readonly effectId: string;
         readonly error: string;
+        readonly nonRetryable?: boolean | undefined;
+        readonly retryAfterMs?: number | undefined;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
     readonly type: "runtime.effect.heartbeat";
@@ -74,6 +89,7 @@ export declare const scheduleEffect: NoInfer<import("@swirls/looms/core").Effect
         readonly attempt: number;
         readonly heartbeatAt: number;
         readonly deadlineAt: number | null;
+        readonly details?: Schema.Json | undefined;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
     readonly type: "runtime.effect.queued";
@@ -126,6 +142,16 @@ export declare const scheduleEffect: NoInfer<import("@swirls/looms/core").Effect
         readonly sourceRunId: string;
         readonly sourceSeq: number;
     };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.run.launched";
+    readonly payload: {
+        readonly runId: string;
+        readonly kind: string;
+        readonly definitionName: string;
+        readonly definitionVersion: string;
+        readonly effectId: string;
+        readonly close: "terminate" | "wait";
+    };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
     readonly type: "runtime.run.started";
     readonly payload: {
@@ -135,6 +161,20 @@ export declare const scheduleEffect: NoInfer<import("@swirls/looms/core").Effect
         readonly definitionVersion: string;
         readonly input: Schema.Json;
         readonly requestedThreadId?: string | null | undefined;
+        readonly launchedBy?: {
+            readonly runId: string;
+            readonly threadId: string;
+            readonly effectId: string;
+            readonly causationId: string;
+            readonly causationSeq: number;
+        } | undefined;
+        readonly attributes?: {
+            readonly [x: string]: string;
+        } | undefined;
+        readonly trace?: {
+            readonly traceparent: string;
+            readonly tracestate?: string | undefined;
+        } | undefined;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
     readonly type: "runtime.signal.received";
@@ -258,6 +298,9 @@ export declare const scheduleEffect: NoInfer<import("@swirls/looms/core").Effect
                     readonly actorId?: string | undefined;
                 } | {
                     readonly type: "system";
+                } | {
+                    readonly type: "run";
+                    readonly runId: string;
                 } | undefined;
                 readonly ephemeral?: boolean | undefined;
                 readonly id?: string | undefined;
@@ -275,10 +318,24 @@ export declare const scheduleEffect: NoInfer<import("@swirls/looms/core").Effect
             readonly type: "runtime.cancel";
             readonly threadId: string;
             readonly tag?: string | undefined;
+        } | {
+            readonly type: "runtime.launch";
+            readonly runId: string;
+            readonly kind: string;
+            readonly definitionName: string;
+            readonly definitionVersion: string;
+            readonly input: Schema.Json;
+            readonly close: "terminate" | "wait";
+            readonly tag?: string | undefined;
+        } | {
+            readonly type: "runtime.cancelRun";
+            readonly runId: string;
+            readonly tag?: string | undefined;
         } | {
             readonly type: string;
             readonly input: Schema.Json;
             readonly tag?: string | undefined;
+            readonly at?: number | undefined;
         })[];
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
@@ -292,6 +349,8 @@ export declare const scheduleEffect: NoInfer<import("@swirls/looms/core").Effect
         readonly items: readonly Schema.Json[];
         readonly concurrency: number;
         readonly limitBytes: number;
+        readonly execution: "run" | "thread";
+        readonly close: "terminate" | "wait";
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
     readonly type: "workflow.node.finished";
@@ -331,6 +390,8 @@ export declare const scheduleEffect: NoInfer<import("@swirls/looms/core").Effect
         readonly definitionVersion: string;
         readonly input: Schema.Json;
         readonly loopIndex: number | null;
+        readonly execution: "run" | "thread";
+        readonly close: "terminate" | "wait";
     };
 })>>;
 export declare function scheduleEvents(definition: WorkflowDefinition, binding: {
@@ -362,6 +423,19 @@ export declare const runNodeEffect: NoInfer<import("@swirls/looms/core").EffectD
         };
     } | undefined;
 }, WorkflowDefinitionsTag, (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.child.close.requested";
+    readonly payload: {
+        readonly policy: "terminate" | "wait";
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.child.settled";
+    readonly payload: {
+        readonly runId: string;
+        readonly status: "cancelled" | "completed" | "failed";
+        readonly output: Schema.Json;
+        readonly error: string | null;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
     readonly type: "runtime.effect.ambiguous";
     readonly payload: {
         readonly effectId: string;
@@ -405,6 +479,8 @@ export declare const runNodeEffect: NoInfer<import("@swirls/looms/core").EffectD
     readonly payload: {
         readonly effectId: string;
         readonly error: string;
+        readonly nonRetryable?: boolean | undefined;
+        readonly retryAfterMs?: number | undefined;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
     readonly type: "runtime.effect.heartbeat";
@@ -413,6 +489,7 @@ export declare const runNodeEffect: NoInfer<import("@swirls/looms/core").EffectD
         readonly attempt: number;
         readonly heartbeatAt: number;
         readonly deadlineAt: number | null;
+        readonly details?: Schema.Json | undefined;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
     readonly type: "runtime.effect.queued";
@@ -465,6 +542,16 @@ export declare const runNodeEffect: NoInfer<import("@swirls/looms/core").EffectD
         readonly sourceRunId: string;
         readonly sourceSeq: number;
     };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.run.launched";
+    readonly payload: {
+        readonly runId: string;
+        readonly kind: string;
+        readonly definitionName: string;
+        readonly definitionVersion: string;
+        readonly effectId: string;
+        readonly close: "terminate" | "wait";
+    };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
     readonly type: "runtime.run.started";
     readonly payload: {
@@ -474,6 +561,20 @@ export declare const runNodeEffect: NoInfer<import("@swirls/looms/core").EffectD
         readonly definitionVersion: string;
         readonly input: Schema.Json;
         readonly requestedThreadId?: string | null | undefined;
+        readonly launchedBy?: {
+            readonly runId: string;
+            readonly threadId: string;
+            readonly effectId: string;
+            readonly causationId: string;
+            readonly causationSeq: number;
+        } | undefined;
+        readonly attributes?: {
+            readonly [x: string]: string;
+        } | undefined;
+        readonly trace?: {
+            readonly traceparent: string;
+            readonly tracestate?: string | undefined;
+        } | undefined;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
     readonly type: "runtime.signal.received";
@@ -597,6 +698,9 @@ export declare const runNodeEffect: NoInfer<import("@swirls/looms/core").EffectD
                     readonly actorId?: string | undefined;
                 } | {
                     readonly type: "system";
+                } | {
+                    readonly type: "run";
+                    readonly runId: string;
                 } | undefined;
                 readonly ephemeral?: boolean | undefined;
                 readonly id?: string | undefined;
@@ -614,10 +718,24 @@ export declare const runNodeEffect: NoInfer<import("@swirls/looms/core").EffectD
             readonly type: "runtime.cancel";
             readonly threadId: string;
             readonly tag?: string | undefined;
+        } | {
+            readonly type: "runtime.launch";
+            readonly runId: string;
+            readonly kind: string;
+            readonly definitionName: string;
+            readonly definitionVersion: string;
+            readonly input: Schema.Json;
+            readonly close: "terminate" | "wait";
+            readonly tag?: string | undefined;
+        } | {
+            readonly type: "runtime.cancelRun";
+            readonly runId: string;
+            readonly tag?: string | undefined;
         } | {
             readonly type: string;
             readonly input: Schema.Json;
             readonly tag?: string | undefined;
+            readonly at?: number | undefined;
         })[];
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
@@ -631,6 +749,8 @@ export declare const runNodeEffect: NoInfer<import("@swirls/looms/core").EffectD
         readonly items: readonly Schema.Json[];
         readonly concurrency: number;
         readonly limitBytes: number;
+        readonly execution: "run" | "thread";
+        readonly close: "terminate" | "wait";
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
     readonly type: "workflow.node.finished";
@@ -670,6 +790,8 @@ export declare const runNodeEffect: NoInfer<import("@swirls/looms/core").EffectD
         readonly definitionVersion: string;
         readonly input: Schema.Json;
         readonly loopIndex: number | null;
+        readonly execution: "run" | "thread";
+        readonly close: "terminate" | "wait";
     };
 })>>;
 export {};

package/dist/workflow/effects.js

@@ -50,10 +50,12 @@ export const scheduleEffect = workflowModule.effect({
     execute: (input, ctx) => Effect.gen(function* () {
         const workflows = yield* WorkflowDefinitionsTag;
         const definition = input.definitionName
-            ? workflows.get(input.definitionName, input.definitionVersion)
+            ? yield* workflows.resolve(input.definitionName, input.definitionVersion)
             : undefined;
         if (!definition) {
-            return [];
+            return input.definitionName
+                ? threadFailed(ctx.threadId, `Unknown workflow definition ${input.definitionName}@${input.definitionVersion}`)
+                : [];
         }
         const nodes = { ...input.nodes };
         for (const node of definition.nodes) {
@@ -150,7 +152,7 @@ export const runNodeEffect = workflowModule.effect({
     execute: (input, ctx) => Effect.gen(function* () {
         const workflows = yield* WorkflowDefinitionsTag;
         const definition = input.definitionName
-            ? workflows.get(input.definitionName, input.definitionVersion)
+            ? yield* workflows.resolve(input.definitionName, input.definitionVersion)
             : undefined;
         const run = {
             threadId: ctx.threadId,
@@ -225,7 +227,7 @@ function nodeResultEvents(definition, nodeType, run, result) {
                     (nodeType === 'workflow'
                         ? nodeChildWorkflowId(threadId, nodeId, attempt)
                         : createThreadId());
-                return spawnRequested(run, childThreadId, result, result.input);
+                return spawnRequested(definition, run, childThreadId, result, result.input);
             }
             case 'sleep': {
                 const now = yield* Clock.currentTimeMillis;
@@ -268,6 +270,7 @@ function nodeResultEvents(definition, nodeType, run, result) {
                             items: result.items,
                             concurrency: result.concurrency,
                             limitBytes,
+                            ...childPolicy(definition),
                         },
                         threadId,
                     },
@@ -279,7 +282,7 @@ function nodeResultEvents(definition, nodeType, run, result) {
                     return finished(run, run.iteration?.previous ?? null, null);
                 }
                 const childThreadId = iterationChildWorkflowId(threadId, nodeId, 'loop', attempt, index);
-                return spawnRequested(run, childThreadId, result, result.input, index);
+                return spawnRequested(definition, run, childThreadId, result, result.input, index);
             }
             default: {
                 const exhaustiveCheck = result;
@@ -288,7 +291,13 @@ function nodeResultEvents(definition, nodeType, run, result) {
         }
     });
 }
-function spawnRequested(run, childThreadId, child, input, loopIndex = null) {
+function childPolicy(definition) {
+    return {
+        execution: definition.childExecution ?? 'thread',
+        close: definition.childClose ?? 'terminate',
+    };
+}
+function spawnRequested(definition, run, childThreadId, child, input, loopIndex = null) {
     return [
         {
             type: 'workflow.spawn.requested',
@@ -301,6 +310,7 @@ function spawnRequested(run, childThreadId, child, input, loopIndex = null) {
                 definitionVersion: child.version,
                 input,
                 loopIndex,
+                ...childPolicy(definition),
             },
             threadId: run.threadId,
         },

package/dist/workflow/events.d.ts

@@ -24,6 +24,8 @@ export declare const WorkflowSpawnRequestedPayloadSchema: Schema.Struct<{
     readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
     /** Set for `loop` iterations: the node re-runs after this child instead of finishing. */
     readonly loopIndex: Schema.withDecodingDefaultKey<Schema.NullOr<Schema.Finite>, never>;
+    readonly execution: Schema.withDecodingDefaultKey<Schema.Union<readonly [Schema.Literal<"thread">, Schema.Literal<"run">]>, never>;
+    readonly close: Schema.withDecodingDefaultKey<Schema.Union<readonly [Schema.Literal<"terminate">, Schema.Literal<"wait">]>, never>;
 }>;
 export declare const WorkflowMapRequestedPayloadSchema: Schema.Struct<{
     readonly nodeId: Schema.String;
@@ -34,6 +36,8 @@ export declare const WorkflowMapRequestedPayloadSchema: Schema.Struct<{
     readonly items: Schema.$Array<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
     readonly concurrency: Schema.Finite;
     readonly limitBytes: Schema.Finite;
+    readonly execution: Schema.withDecodingDefaultKey<Schema.Union<readonly [Schema.Literal<"thread">, Schema.Literal<"run">]>, never>;
+    readonly close: Schema.withDecodingDefaultKey<Schema.Union<readonly [Schema.Literal<"terminate">, Schema.Literal<"wait">]>, never>;
 }>;
 export declare const WorkflowSleepRequestedPayloadSchema: Schema.Struct<{
     readonly nodeId: Schema.String;
@@ -77,6 +81,9 @@ export declare const WorkflowEffectsRequestedPayloadSchema: Schema.Struct<{
                 readonly actorId: Schema.optional<Schema.String>;
             }>, Schema.Struct<{
                 readonly type: Schema.Literal<"system">;
+            }>, Schema.Struct<{
+                readonly type: Schema.Literal<"run">;
+                readonly runId: Schema.String;
             }>]>>;
             readonly ephemeral: Schema.optional<Schema.Boolean>;
             readonly id: Schema.optional<Schema.String>;
@@ -94,10 +101,24 @@ export declare const WorkflowEffectsRequestedPayloadSchema: Schema.Struct<{
         readonly type: Schema.Literal<"runtime.cancel">;
         readonly threadId: Schema.String;
         readonly tag: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"runtime.launch">;
+        readonly runId: Schema.String;
+        readonly kind: Schema.String;
+        readonly definitionName: Schema.String;
+        readonly definitionVersion: Schema.withDecodingDefaultKey<Schema.String, never>;
+        readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+        readonly close: Schema.withDecodingDefaultKey<Schema.Union<readonly [Schema.Literal<"terminate">, Schema.Literal<"wait">]>, never>;
+        readonly tag: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"runtime.cancelRun">;
+        readonly runId: Schema.String;
+        readonly tag: Schema.optional<Schema.String>;
     }>, Schema.Struct<{
         readonly type: Schema.String;
         readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
         readonly tag: Schema.optional<Schema.String>;
+        readonly at: Schema.optional<Schema.Finite>;
     }>]>>;
 }>;
 export declare const workflowCatalog: import("@swirls/looms/core").EventCatalog<"workflow", {
@@ -125,6 +146,8 @@ export declare const workflowCatalog: import("@swirls/looms/core").EventCatalog<
         readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
         /** Set for `loop` iterations: the node re-runs after this child instead of finishing. */
         readonly loopIndex: Schema.withDecodingDefaultKey<Schema.NullOr<Schema.Finite>, never>;
+        readonly execution: Schema.withDecodingDefaultKey<Schema.Union<readonly [Schema.Literal<"thread">, Schema.Literal<"run">]>, never>;
+        readonly close: Schema.withDecodingDefaultKey<Schema.Union<readonly [Schema.Literal<"terminate">, Schema.Literal<"wait">]>, never>;
     }>;
     'map.requested': Schema.Struct<{
         readonly nodeId: Schema.String;
@@ -135,6 +158,8 @@ export declare const workflowCatalog: import("@swirls/looms/core").EventCatalog<
         readonly items: Schema.$Array<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
         readonly concurrency: Schema.Finite;
         readonly limitBytes: Schema.Finite;
+        readonly execution: Schema.withDecodingDefaultKey<Schema.Union<readonly [Schema.Literal<"thread">, Schema.Literal<"run">]>, never>;
+        readonly close: Schema.withDecodingDefaultKey<Schema.Union<readonly [Schema.Literal<"terminate">, Schema.Literal<"wait">]>, never>;
     }>;
     'sleep.requested': Schema.Struct<{
         readonly nodeId: Schema.String;
@@ -178,6 +203,9 @@ export declare const workflowCatalog: import("@swirls/looms/core").EventCatalog<
                     readonly actorId: Schema.optional<Schema.String>;
                 }>, Schema.Struct<{
                     readonly type: Schema.Literal<"system">;
+                }>, Schema.Struct<{
+                    readonly type: Schema.Literal<"run">;
+                    readonly runId: Schema.String;
                 }>]>>;
                 readonly ephemeral: Schema.optional<Schema.Boolean>;
                 readonly id: Schema.optional<Schema.String>;
@@ -195,10 +223,24 @@ export declare const workflowCatalog: import("@swirls/looms/core").EventCatalog<
             readonly type: Schema.Literal<"runtime.cancel">;
             readonly threadId: Schema.String;
             readonly tag: Schema.optional<Schema.String>;
+        }>, Schema.Struct<{
+            readonly type: Schema.Literal<"runtime.launch">;
+            readonly runId: Schema.String;
+            readonly kind: Schema.String;
+            readonly definitionName: Schema.String;
+            readonly definitionVersion: Schema.withDecodingDefaultKey<Schema.String, never>;
+            readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+            readonly close: Schema.withDecodingDefaultKey<Schema.Union<readonly [Schema.Literal<"terminate">, Schema.Literal<"wait">]>, never>;
+            readonly tag: Schema.optional<Schema.String>;
+        }>, Schema.Struct<{
+            readonly type: Schema.Literal<"runtime.cancelRun">;
+            readonly runId: Schema.String;
+            readonly tag: Schema.optional<Schema.String>;
         }>, Schema.Struct<{
             readonly type: Schema.String;
             readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
             readonly tag: Schema.optional<Schema.String>;
+            readonly at: Schema.optional<Schema.Finite>;
         }>]>>;
     }>;
 }>;

package/dist/workflow/events.js

@@ -30,6 +30,8 @@ export const WorkflowSpawnRequestedPayloadSchema = Schema.Struct({
     input: Schema.Json,
     /** Set for `loop` iterations: the node re-runs after this child instead of finishing. */
     loopIndex: Schema.NullOr(Schema.Finite).pipe(Schema.withDecodingDefaultKey(Effect.succeed(null))),
+    execution: Schema.Union([Schema.Literal('thread'), Schema.Literal('run')]).pipe(Schema.withDecodingDefaultKey(Effect.succeed('thread'))),
+    close: Schema.Union([Schema.Literal('terminate'), Schema.Literal('wait')]).pipe(Schema.withDecodingDefaultKey(Effect.succeed('terminate'))),
 });
 export const WorkflowMapRequestedPayloadSchema = Schema.Struct({
     nodeId: Schema.String,
@@ -40,6 +42,8 @@ export const WorkflowMapRequestedPayloadSchema = Schema.Struct({
     items: Schema.Array(Schema.Json),
     concurrency: Schema.Finite,
     limitBytes: Schema.Finite,
+    execution: Schema.Union([Schema.Literal('thread'), Schema.Literal('run')]).pipe(Schema.withDecodingDefaultKey(Effect.succeed('thread'))),
+    close: Schema.Union([Schema.Literal('terminate'), Schema.Literal('wait')]).pipe(Schema.withDecodingDefaultKey(Effect.succeed('terminate'))),
 });
 export const WorkflowSleepRequestedPayloadSchema = Schema.Struct({
     nodeId: Schema.String,