@atom-workflow-agent/contracts 0.1.0

package/dist/workflows/spec.d.ts

@@ -0,0 +1,427 @@
+import { z } from "zod";
+import { type JsonValue } from "../atoms/manifest.js";
+export declare const WorkflowNodeIdSchema: z.ZodString;
+export declare const WorkflowBranchIdSchema: z.ZodString;
+export declare const WorkflowAtomReferenceSchema: z.ZodString;
+export declare const WorkflowReferenceSchema: z.ZodObject<{
+    $ref: z.ZodString;
+}, z.core.$strict>;
+export type WorkflowReference = z.infer<typeof WorkflowReferenceSchema>;
+export type ReferenceLikeStringKind = "planner-draft" | "workflow";
+/** Detect binding-shaped strings that must not silently become literals. */
+export declare function classifyReferenceLikeString(value: string): ReferenceLikeStringKind | undefined;
+export declare const WorkflowMapSchema: z.ZodObject<{
+    items: z.ZodObject<{
+        $ref: z.ZodString;
+    }, z.core.$strict>;
+    maxItems: z.ZodNumber;
+    maxConcurrency: z.ZodDefault<z.ZodNumber>;
+    group: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type WorkflowMap = z.infer<typeof WorkflowMapSchema>;
+export declare const WorkflowTerminalSchema: z.ZodEnum<{
+    $end: "$end";
+    $failed: "$failed";
+    $cancelled: "$cancelled";
+}>;
+export type WorkflowTerminal = z.infer<typeof WorkflowTerminalSchema>;
+/** A statically declared control edge. Runtime never accepts a target from Atom output. */
+export declare const WorkflowTransitionSchema: z.ZodObject<{
+    to: z.ZodUnion<readonly [z.ZodEnum<{
+        $end: "$end";
+        $failed: "$failed";
+        $cancelled: "$cancelled";
+    }>, z.ZodString, z.ZodArray<z.ZodString>]>;
+    maxTraversals: z.ZodOptional<z.ZodNumber>;
+    with: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+}, z.core.$strict>;
+export type WorkflowTransition = z.infer<typeof WorkflowTransitionSchema>;
+export declare const WorkflowRetryOverrideSchema: z.ZodObject<{
+    maxAttempts: z.ZodOptional<z.ZodNumber>;
+    strategy: z.ZodOptional<z.ZodEnum<{
+        fixed: "fixed";
+        exponential: "exponential";
+    }>>;
+    baseDelayMs: z.ZodOptional<z.ZodNumber>;
+    maxDelayMs: z.ZodOptional<z.ZodNumber>;
+    jitter: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const WorkflowCacheOverrideSchema: z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    ttlMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const WorkflowNodePolicySchema: z.ZodObject<{
+    attemptTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    lifecycleTickTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    maxLifecycleTicks: z.ZodOptional<z.ZodNumber>;
+    retry: z.ZodOptional<z.ZodObject<{
+        maxAttempts: z.ZodOptional<z.ZodNumber>;
+        strategy: z.ZodOptional<z.ZodEnum<{
+            fixed: "fixed";
+            exponential: "exponential";
+        }>>;
+        baseDelayMs: z.ZodOptional<z.ZodNumber>;
+        maxDelayMs: z.ZodOptional<z.ZodNumber>;
+        jitter: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    cache: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        ttlMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type WorkflowNodePolicy = z.infer<typeof WorkflowNodePolicySchema>;
+export declare const WorkflowAtomNodeSpecSchema: z.ZodObject<{
+    next: z.ZodObject<{
+        to: z.ZodUnion<readonly [z.ZodEnum<{
+            $end: "$end";
+            $failed: "$failed";
+            $cancelled: "$cancelled";
+        }>, z.ZodString, z.ZodArray<z.ZodString>]>;
+        maxTraversals: z.ZodOptional<z.ZodNumber>;
+        with: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+    }, z.core.$strict>;
+    id: z.ZodString;
+    atom: z.ZodString;
+    dependsOn: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    input: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+    map: z.ZodOptional<z.ZodObject<{
+        items: z.ZodObject<{
+            $ref: z.ZodString;
+        }, z.core.$strict>;
+        maxItems: z.ZodNumber;
+        maxConcurrency: z.ZodDefault<z.ZodNumber>;
+        group: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    policy: z.ZodOptional<z.ZodObject<{
+        attemptTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        lifecycleTickTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        maxLifecycleTicks: z.ZodOptional<z.ZodNumber>;
+        retry: z.ZodOptional<z.ZodObject<{
+            maxAttempts: z.ZodOptional<z.ZodNumber>;
+            strategy: z.ZodOptional<z.ZodEnum<{
+                fixed: "fixed";
+                exponential: "exponential";
+            }>>;
+            baseDelayMs: z.ZodOptional<z.ZodNumber>;
+            maxDelayMs: z.ZodOptional<z.ZodNumber>;
+            jitter: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        cache: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            ttlMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    kind: z.ZodLiteral<"atom">;
+}, z.core.$strict>;
+export type WorkflowAtomNodeSpec = z.infer<typeof WorkflowAtomNodeSpecSchema>;
+export declare const WorkflowDecisionNodeSpecSchema: z.ZodObject<{
+    select: z.ZodObject<{
+        $ref: z.ZodString;
+    }, z.core.$strict>;
+    branches: z.ZodRecord<z.ZodString, z.ZodObject<{
+        to: z.ZodUnion<readonly [z.ZodEnum<{
+            $end: "$end";
+            $failed: "$failed";
+            $cancelled: "$cancelled";
+        }>, z.ZodString, z.ZodArray<z.ZodString>]>;
+        maxTraversals: z.ZodOptional<z.ZodNumber>;
+        with: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+    }, z.core.$strict>>;
+    default: z.ZodObject<{
+        to: z.ZodUnion<readonly [z.ZodEnum<{
+            $end: "$end";
+            $failed: "$failed";
+            $cancelled: "$cancelled";
+        }>, z.ZodString, z.ZodArray<z.ZodString>]>;
+        maxTraversals: z.ZodOptional<z.ZodNumber>;
+        with: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+    }, z.core.$strict>;
+    id: z.ZodString;
+    atom: z.ZodString;
+    dependsOn: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    input: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+    map: z.ZodOptional<z.ZodObject<{
+        items: z.ZodObject<{
+            $ref: z.ZodString;
+        }, z.core.$strict>;
+        maxItems: z.ZodNumber;
+        maxConcurrency: z.ZodDefault<z.ZodNumber>;
+        group: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    policy: z.ZodOptional<z.ZodObject<{
+        attemptTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        lifecycleTickTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        maxLifecycleTicks: z.ZodOptional<z.ZodNumber>;
+        retry: z.ZodOptional<z.ZodObject<{
+            maxAttempts: z.ZodOptional<z.ZodNumber>;
+            strategy: z.ZodOptional<z.ZodEnum<{
+                fixed: "fixed";
+                exponential: "exponential";
+            }>>;
+            baseDelayMs: z.ZodOptional<z.ZodNumber>;
+            maxDelayMs: z.ZodOptional<z.ZodNumber>;
+            jitter: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        cache: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            ttlMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    kind: z.ZodLiteral<"decision">;
+}, z.core.$strict>;
+export type WorkflowDecisionNodeSpec = z.infer<typeof WorkflowDecisionNodeSpecSchema>;
+/**
+ * Pure typed phi node. Exactly one mutually-exclusive incoming control path
+ * activates it; that edge supplies the complete output object through `with`.
+ */
+export declare const WorkflowMergeNodeSpecSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"merge">;
+    id: z.ZodString;
+    dependsOn: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    outputSchema: z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+    next: z.ZodObject<{
+        to: z.ZodUnion<readonly [z.ZodEnum<{
+            $end: "$end";
+            $failed: "$failed";
+            $cancelled: "$cancelled";
+        }>, z.ZodString, z.ZodArray<z.ZodString>]>;
+        maxTraversals: z.ZodOptional<z.ZodNumber>;
+        with: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type WorkflowMergeNodeSpec = z.infer<typeof WorkflowMergeNodeSpecSchema>;
+export declare const WorkflowNodeSpecSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    next: z.ZodObject<{
+        to: z.ZodUnion<readonly [z.ZodEnum<{
+            $end: "$end";
+            $failed: "$failed";
+            $cancelled: "$cancelled";
+        }>, z.ZodString, z.ZodArray<z.ZodString>]>;
+        maxTraversals: z.ZodOptional<z.ZodNumber>;
+        with: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+    }, z.core.$strict>;
+    id: z.ZodString;
+    atom: z.ZodString;
+    dependsOn: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    input: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+    map: z.ZodOptional<z.ZodObject<{
+        items: z.ZodObject<{
+            $ref: z.ZodString;
+        }, z.core.$strict>;
+        maxItems: z.ZodNumber;
+        maxConcurrency: z.ZodDefault<z.ZodNumber>;
+        group: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    policy: z.ZodOptional<z.ZodObject<{
+        attemptTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        lifecycleTickTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        maxLifecycleTicks: z.ZodOptional<z.ZodNumber>;
+        retry: z.ZodOptional<z.ZodObject<{
+            maxAttempts: z.ZodOptional<z.ZodNumber>;
+            strategy: z.ZodOptional<z.ZodEnum<{
+                fixed: "fixed";
+                exponential: "exponential";
+            }>>;
+            baseDelayMs: z.ZodOptional<z.ZodNumber>;
+            maxDelayMs: z.ZodOptional<z.ZodNumber>;
+            jitter: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        cache: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            ttlMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    kind: z.ZodLiteral<"atom">;
+}, z.core.$strict>, z.ZodObject<{
+    select: z.ZodObject<{
+        $ref: z.ZodString;
+    }, z.core.$strict>;
+    branches: z.ZodRecord<z.ZodString, z.ZodObject<{
+        to: z.ZodUnion<readonly [z.ZodEnum<{
+            $end: "$end";
+            $failed: "$failed";
+            $cancelled: "$cancelled";
+        }>, z.ZodString, z.ZodArray<z.ZodString>]>;
+        maxTraversals: z.ZodOptional<z.ZodNumber>;
+        with: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+    }, z.core.$strict>>;
+    default: z.ZodObject<{
+        to: z.ZodUnion<readonly [z.ZodEnum<{
+            $end: "$end";
+            $failed: "$failed";
+            $cancelled: "$cancelled";
+        }>, z.ZodString, z.ZodArray<z.ZodString>]>;
+        maxTraversals: z.ZodOptional<z.ZodNumber>;
+        with: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+    }, z.core.$strict>;
+    id: z.ZodString;
+    atom: z.ZodString;
+    dependsOn: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    input: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+    map: z.ZodOptional<z.ZodObject<{
+        items: z.ZodObject<{
+            $ref: z.ZodString;
+        }, z.core.$strict>;
+        maxItems: z.ZodNumber;
+        maxConcurrency: z.ZodDefault<z.ZodNumber>;
+        group: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    policy: z.ZodOptional<z.ZodObject<{
+        attemptTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        lifecycleTickTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        maxLifecycleTicks: z.ZodOptional<z.ZodNumber>;
+        retry: z.ZodOptional<z.ZodObject<{
+            maxAttempts: z.ZodOptional<z.ZodNumber>;
+            strategy: z.ZodOptional<z.ZodEnum<{
+                fixed: "fixed";
+                exponential: "exponential";
+            }>>;
+            baseDelayMs: z.ZodOptional<z.ZodNumber>;
+            maxDelayMs: z.ZodOptional<z.ZodNumber>;
+            jitter: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        cache: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            ttlMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    kind: z.ZodLiteral<"decision">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"merge">;
+    id: z.ZodString;
+    dependsOn: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    outputSchema: z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+    next: z.ZodObject<{
+        to: z.ZodUnion<readonly [z.ZodEnum<{
+            $end: "$end";
+            $failed: "$failed";
+            $cancelled: "$cancelled";
+        }>, z.ZodString, z.ZodArray<z.ZodString>]>;
+        maxTraversals: z.ZodOptional<z.ZodNumber>;
+        with: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+    }, z.core.$strict>;
+}, z.core.$strict>], "kind">;
+export type WorkflowNodeSpec = z.infer<typeof WorkflowNodeSpecSchema>;
+export declare const WorkflowSpecSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.2">;
+    name: z.ZodString;
+    inputs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+    entry: z.ZodArray<z.ZodString>;
+    nodes: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        next: z.ZodObject<{
+            to: z.ZodUnion<readonly [z.ZodEnum<{
+                $end: "$end";
+                $failed: "$failed";
+                $cancelled: "$cancelled";
+            }>, z.ZodString, z.ZodArray<z.ZodString>]>;
+            maxTraversals: z.ZodOptional<z.ZodNumber>;
+            with: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+        }, z.core.$strict>;
+        id: z.ZodString;
+        atom: z.ZodString;
+        dependsOn: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        input: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+        map: z.ZodOptional<z.ZodObject<{
+            items: z.ZodObject<{
+                $ref: z.ZodString;
+            }, z.core.$strict>;
+            maxItems: z.ZodNumber;
+            maxConcurrency: z.ZodDefault<z.ZodNumber>;
+            group: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        policy: z.ZodOptional<z.ZodObject<{
+            attemptTimeoutMs: z.ZodOptional<z.ZodNumber>;
+            lifecycleTickTimeoutMs: z.ZodOptional<z.ZodNumber>;
+            maxLifecycleTicks: z.ZodOptional<z.ZodNumber>;
+            retry: z.ZodOptional<z.ZodObject<{
+                maxAttempts: z.ZodOptional<z.ZodNumber>;
+                strategy: z.ZodOptional<z.ZodEnum<{
+                    fixed: "fixed";
+                    exponential: "exponential";
+                }>>;
+                baseDelayMs: z.ZodOptional<z.ZodNumber>;
+                maxDelayMs: z.ZodOptional<z.ZodNumber>;
+                jitter: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
+            cache: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodOptional<z.ZodBoolean>;
+                ttlMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        kind: z.ZodLiteral<"atom">;
+    }, z.core.$strict>, z.ZodObject<{
+        select: z.ZodObject<{
+            $ref: z.ZodString;
+        }, z.core.$strict>;
+        branches: z.ZodRecord<z.ZodString, z.ZodObject<{
+            to: z.ZodUnion<readonly [z.ZodEnum<{
+                $end: "$end";
+                $failed: "$failed";
+                $cancelled: "$cancelled";
+            }>, z.ZodString, z.ZodArray<z.ZodString>]>;
+            maxTraversals: z.ZodOptional<z.ZodNumber>;
+            with: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+        }, z.core.$strict>>;
+        default: z.ZodObject<{
+            to: z.ZodUnion<readonly [z.ZodEnum<{
+                $end: "$end";
+                $failed: "$failed";
+                $cancelled: "$cancelled";
+            }>, z.ZodString, z.ZodArray<z.ZodString>]>;
+            maxTraversals: z.ZodOptional<z.ZodNumber>;
+            with: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+        }, z.core.$strict>;
+        id: z.ZodString;
+        atom: z.ZodString;
+        dependsOn: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        input: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+        map: z.ZodOptional<z.ZodObject<{
+            items: z.ZodObject<{
+                $ref: z.ZodString;
+            }, z.core.$strict>;
+            maxItems: z.ZodNumber;
+            maxConcurrency: z.ZodDefault<z.ZodNumber>;
+            group: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        policy: z.ZodOptional<z.ZodObject<{
+            attemptTimeoutMs: z.ZodOptional<z.ZodNumber>;
+            lifecycleTickTimeoutMs: z.ZodOptional<z.ZodNumber>;
+            maxLifecycleTicks: z.ZodOptional<z.ZodNumber>;
+            retry: z.ZodOptional<z.ZodObject<{
+                maxAttempts: z.ZodOptional<z.ZodNumber>;
+                strategy: z.ZodOptional<z.ZodEnum<{
+                    fixed: "fixed";
+                    exponential: "exponential";
+                }>>;
+                baseDelayMs: z.ZodOptional<z.ZodNumber>;
+                maxDelayMs: z.ZodOptional<z.ZodNumber>;
+                jitter: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
+            cache: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodOptional<z.ZodBoolean>;
+                ttlMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        kind: z.ZodLiteral<"decision">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"merge">;
+        id: z.ZodString;
+        dependsOn: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        outputSchema: z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+        next: z.ZodObject<{
+            to: z.ZodUnion<readonly [z.ZodEnum<{
+                $end: "$end";
+                $failed: "$failed";
+                $cancelled: "$cancelled";
+            }>, z.ZodString, z.ZodArray<z.ZodString>]>;
+            maxTraversals: z.ZodOptional<z.ZodNumber>;
+            with: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "kind">>;
+    outputs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        $ref: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type WorkflowSpec = z.infer<typeof WorkflowSpecSchema>;
+export type WorkflowInputValue = JsonValue;
+//# sourceMappingURL=spec.d.ts.map

package/dist/workflows/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/workflows/spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAqC,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEzF,eAAO,MAAM,oBAAoB,aAAuG,CAAC;AACzI,eAAO,MAAM,sBAAsB,aAGlC,CAAC;AACF,eAAO,MAAM,2BAA2B,aAGvC,CAAC;AAGF,eAAO,MAAM,uBAAuB;;kBAAiG,CAAC;AACtI,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,MAAM,MAAM,uBAAuB,GAAG,eAAe,GAAG,UAAU,CAAC;AAEnE,4EAA4E;AAC5E,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS,CAW9F;AAED,eAAO,MAAM,iBAAiB;;;;;;;kBAQnB,CAAC;AACZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,eAAO,MAAM,sBAAsB;;;;EAA4C,CAAC;AAChF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,2FAA2F;AAC3F,eAAO,MAAM,wBAAwB;;;;;;;;kBAI1B,CAAC;AACZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,2BAA2B;;;;;;;;;kBAGwD,CAAC;AACjG,eAAO,MAAM,2BAA2B;;;kBACwD,CAAC;AACjG,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;kBAI1B,CAAC;AACZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAM1E,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA2G,CAAC;AACnJ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAYzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACtF;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;kBAM7B,CAAC;AACZ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAA0H,CAAC;AAC9J,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAKpB,CAAC;AACZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,kBAAkB,GAAG,SAAS,CAAC"}

package/dist/workflows/spec.js

@@ -0,0 +1,86 @@
+import { z } from "zod";
+import { JsonSchemaSchema, JsonValueSchema } from "../atoms/manifest.js";
+export const WorkflowNodeIdSchema = z.string().regex(/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/, "Workflow node id must be lowercase kebab-case");
+export const WorkflowBranchIdSchema = z.string().regex(/^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$/, "Decision branch id must be a lowercase identifier separated by hyphens or underscores");
+export const WorkflowAtomReferenceSchema = z.string().regex(/^[a-z][a-z0-9]*(?:\.[a-z][a-z0-9]*(?:-[a-z0-9]+)*)+@(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/, "Atom reference must contain an exact semantic version, for example page.measure@1.0.0");
+const REFERENCE_PATTERN = /^(workflow\.inputs(?:\.[A-Za-z0-9_-]+)*|dependencies\.[a-z][a-z0-9]*(?:-[a-z0-9]+)*\.output(?:\.[A-Za-z0-9_-]+)*|map\.(?:item(?:\.[A-Za-z0-9_-]+)*|index)|node\.output(?:\.[A-Za-z0-9_-]+)*|nodes\.[a-z][a-z0-9]*(?:-[a-z0-9]+)*\.activations\.lastSuccessful\.output(?:\.[A-Za-z0-9_-]+)*)$/;
+export const WorkflowReferenceSchema = z.object({ $ref: z.string().regex(REFERENCE_PATTERN, "Invalid Workflow reference") }).strict();
+/** Detect binding-shaped strings that must not silently become literals. */
+export function classifyReferenceLikeString(value) {
+    const candidate = value.trim();
+    if (/^\$(?:input|output|item)(?:\.|\[|$)/.test(candidate)
+        || /^\$index(?:\.|\[|$)/.test(candidate))
+        return "planner-draft";
+    if (/^\$ref(?:\.|:|\s|\[|$)/.test(candidate)
+        || /^(?:workflow\.inputs|map\.(?:item|index)|node\.output)(?:\.|$)/.test(candidate)
+        || /^dependencies\.[a-z][a-z0-9]*(?:-[a-z0-9]+)*\.output(?:\.|$)/.test(candidate)
+        || /^nodes\.[a-z][a-z0-9]*(?:-[a-z0-9]+)*\.activations\.lastSuccessful\.output(?:\.|$)/.test(candidate)) {
+        return "workflow";
+    }
+    return undefined;
+}
+export const WorkflowMapSchema = z.object({
+    items: WorkflowReferenceSchema,
+    /** Collection cardinality safety bound. It does not control concurrency or truncate input. */
+    maxItems: z.number().int().min(1).max(10_000),
+    /** Maximum number of collection items with active processor subgraphs. */
+    maxConcurrency: z.number().int().min(1).max(1_000).default(8),
+    /** Nodes with the same group execute as one item-wise subgraph. */
+    group: WorkflowNodeIdSchema.optional(),
+}).strict();
+export const WorkflowTerminalSchema = z.enum(["$end", "$failed", "$cancelled"]);
+/** A statically declared control edge. Runtime never accepts a target from Atom output. */
+export const WorkflowTransitionSchema = z.object({
+    to: z.union([WorkflowTerminalSchema, WorkflowNodeIdSchema, z.array(WorkflowNodeIdSchema).min(1).max(64)]),
+    maxTraversals: z.number().int().min(1).max(10_000).optional(),
+    with: z.record(z.string(), JsonValueSchema).default({}),
+}).strict();
+export const WorkflowRetryOverrideSchema = z.object({
+    maxAttempts: z.number().int().min(1).max(11).optional(), strategy: z.enum(["fixed", "exponential"]).optional(),
+    baseDelayMs: z.number().int().nonnegative().optional(), maxDelayMs: z.number().int().nonnegative().optional(), jitter: z.boolean().optional(),
+}).strict().refine((value) => Object.keys(value).length > 0, "Retry override must not be empty");
+export const WorkflowCacheOverrideSchema = z.object({ enabled: z.boolean().optional(), ttlMs: z.number().int().positive().optional() })
+    .strict().refine((value) => Object.keys(value).length > 0, "Cache override must not be empty");
+export const WorkflowNodePolicySchema = z.object({
+    attemptTimeoutMs: z.number().int().positive().max(86_400_000).optional(),
+    lifecycleTickTimeoutMs: z.number().int().positive().max(86_400_000).optional(),
+    maxLifecycleTicks: z.number().int().min(1).max(100_000).optional(), retry: WorkflowRetryOverrideSchema.optional(), cache: WorkflowCacheOverrideSchema.optional(),
+}).strict();
+const WorkflowNodeBaseShape = {
+    id: WorkflowNodeIdSchema, atom: WorkflowAtomReferenceSchema, dependsOn: z.array(WorkflowNodeIdSchema).default([]), input: JsonValueSchema,
+    map: WorkflowMapSchema.optional(), policy: WorkflowNodePolicySchema.optional(),
+};
+export const WorkflowAtomNodeSpecSchema = z.object({ kind: z.literal("atom"), ...WorkflowNodeBaseShape, next: WorkflowTransitionSchema }).strict();
+export const WorkflowDecisionNodeSpecSchema = z.object({
+    kind: z.literal("decision"), ...WorkflowNodeBaseShape,
+    select: WorkflowReferenceSchema,
+    branches: z.record(WorkflowBranchIdSchema, WorkflowTransitionSchema)
+        .refine((branches) => Object.keys(branches).length > 0, "DecisionNode must declare at least one branch")
+        .refine((branches) => Object.keys(branches).length <= 64, "DecisionNode cannot declare more than 64 branches"),
+    default: WorkflowTransitionSchema,
+}).strict().superRefine((node, context) => {
+    if (node.map)
+        context.addIssue({ code: "custom", path: ["map"], message: "DecisionNode cannot be a Map processor; select from one Atom activation" });
+    if (!(node.select.$ref === "node.output" || node.select.$ref.startsWith("node.output."))) {
+        context.addIssue({ code: "custom", path: ["select"], message: "DecisionNode select must reference its own node.output" });
+    }
+});
+/**
+ * Pure typed phi node. Exactly one mutually-exclusive incoming control path
+ * activates it; that edge supplies the complete output object through `with`.
+ */
+export const WorkflowMergeNodeSpecSchema = z.object({
+    kind: z.literal("merge"),
+    id: WorkflowNodeIdSchema,
+    dependsOn: z.array(WorkflowNodeIdSchema).default([]),
+    outputSchema: JsonSchemaSchema,
+    next: WorkflowTransitionSchema,
+}).strict();
+export const WorkflowNodeSpecSchema = z.discriminatedUnion("kind", [WorkflowAtomNodeSpecSchema, WorkflowDecisionNodeSpecSchema, WorkflowMergeNodeSpecSchema]);
+export const WorkflowSpecSchema = z.object({
+    schemaVersion: z.literal("1.2"),
+    name: z.string().regex(/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/, "Workflow name must be lowercase kebab-case"),
+    inputs: z.record(z.string(), JsonValueSchema).default({}), entry: z.array(WorkflowNodeIdSchema).min(1).max(128),
+    nodes: z.array(WorkflowNodeSpecSchema).min(1), outputs: z.record(z.string(), WorkflowReferenceSchema).default({}),
+}).strict();
+//# sourceMappingURL=spec.js.map

package/dist/workflows/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../src/workflows/spec.ts"],"names":[],"mappings":"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"}

package/dist/workflows/topology.d.ts

@@ -0,0 +1,58 @@
+import { z } from "zod";
+export declare const WorkflowTopologyViewSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    workflowRevisionId: z.ZodString;
+    irHash: z.ZodString;
+    nodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            map: "map";
+            join: "join";
+            atom: "atom";
+            merge: "merge";
+            switch: "switch";
+        }>;
+        atom: z.ZodOptional<z.ZodString>;
+        mapScope: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    controlEdges: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        source: z.ZodString;
+        targets: z.ZodArray<z.ZodString>;
+        kind: z.ZodString;
+        branch: z.ZodOptional<z.ZodString>;
+        terminal: z.ZodOptional<z.ZodString>;
+        backEdge: z.ZodBoolean;
+        maxTraversals: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    dataEdges: z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        target: z.ZodString;
+        targetPath: z.ZodString;
+        reference: z.ZodString;
+    }, z.core.$strict>>;
+    groups: z.ZodObject<{
+        entries: z.ZodArray<z.ZodString>;
+        forks: z.ZodArray<z.ZodObject<{
+            edgeId: z.ZodString;
+            targets: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+        joins: z.ZodArray<z.ZodObject<{
+            nodeId: z.ZodString;
+            dependencies: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+        maps: z.ZodArray<z.ZodObject<{
+            nodeId: z.ZodString;
+            maxItems: z.ZodNumber;
+            maxConcurrency: z.ZodNumber;
+            bodyNodeIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+        switches: z.ZodArray<z.ZodObject<{
+            nodeId: z.ZodString;
+            cases: z.ZodArray<z.ZodString>;
+            hasDefault: z.ZodBoolean;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type WorkflowTopologyView = z.infer<typeof WorkflowTopologyViewSchema>;
+//# sourceMappingURL=topology.d.ts.map

package/dist/workflows/topology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology.d.ts","sourceRoot":"","sources":["../../src/workflows/topology.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAiC5B,CAAC;AACZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/workflows/topology.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+const NodeIdSchema = z.string().trim().min(1);
+export const WorkflowTopologyViewSchema = z.object({
+    schemaVersion: z.literal("1.0"),
+    workflowRevisionId: z.string().trim().min(1),
+    irHash: z.string().trim().min(1),
+    nodes: z.array(z.object({
+        id: NodeIdSchema,
+        kind: z.enum(["atom", "switch", "map", "join", "merge"]),
+        atom: z.string().trim().min(1).optional(),
+        mapScope: z.string().trim().min(1).optional(),
+    }).strict()),
+    controlEdges: z.array(z.object({
+        id: z.string().trim().min(1),
+        source: NodeIdSchema,
+        targets: z.array(NodeIdSchema),
+        kind: z.string().trim().min(1),
+        branch: z.string().trim().min(1).optional(),
+        terminal: z.string().trim().min(1).optional(),
+        backEdge: z.boolean(),
+        maxTraversals: z.number().int().positive().optional(),
+    }).strict()),
+    dataEdges: z.array(z.object({
+        source: z.string().trim().min(1),
+        target: NodeIdSchema,
+        targetPath: z.string().trim().min(1),
+        reference: z.string().trim().min(1),
+    }).strict()),
+    groups: z.object({
+        entries: z.array(NodeIdSchema),
+        forks: z.array(z.object({ edgeId: z.string().trim().min(1), targets: z.array(NodeIdSchema) }).strict()),
+        joins: z.array(z.object({ nodeId: NodeIdSchema, dependencies: z.array(NodeIdSchema) }).strict()),
+        maps: z.array(z.object({ nodeId: NodeIdSchema, maxItems: z.number().int().positive(), maxConcurrency: z.number().int().positive(), bodyNodeIds: z.array(NodeIdSchema) }).strict()),
+        switches: z.array(z.object({ nodeId: NodeIdSchema, cases: z.array(z.string()), hasDefault: z.boolean() }).strict()),
+    }).strict(),
+}).strict();
+//# sourceMappingURL=topology.js.map

package/dist/workflows/topology.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology.js","sourceRoot":"","sources":["../../src/workflows/topology.ts"],"names":[],"mappings":"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"}