@skaile/workspaces 2.2.0 → 2.4.0

package/dist/factory-assets/connectors/flow/contract/expression.d.ts

@@ -22,6 +22,50 @@ export interface FlowExpressionContext {
         };
     }>;
 }
+/** Runtime or agent provenance retained for one value used by a node binding. */
+export type BindingOrigin = {
+    source: "literal";
+    path: string;
+    obtainedBy: "runtime";
+} | {
+    source: "flow-input";
+    path: string;
+    obtainedBy: "runtime";
+} | {
+    source: "default";
+    path: string;
+    obtainedBy: "runtime";
+} | {
+    source: "node-status";
+    nodeId: string;
+    path: string;
+    obtainedBy: "runtime";
+} | {
+    source: "node-output";
+    nodeId: string;
+    path: string;
+    obtainedBy: "agent" | "runtime";
+};
+/** A resolved JSON value together with every source that contributed to it. */
+export interface ResolvedBinding {
+    /** Runtime value passed to the node executor. */
+    value: unknown;
+    /** Stable, de-duplicated provenance in authored traversal order. */
+    origins: BindingOrigin[];
+}
+/** All named node inputs, keeping executor values separate from provenance. */
+export interface ResolvedNodeBindings {
+    /** Resolved values keyed by authored binding name. */
+    values: Record<string, unknown>;
+    /** Provenance keyed by authored binding name. */
+    origins: Record<string, BindingOrigin[]>;
+}
+/** How each producer node obtained its output fields. */
+export type NodeOutputOrigin = Record<string, "agent" | "runtime">;
+/** @internal Binding names excluded from both authored and direct typed inputs. */
+export declare const FLOW_BINDING_NAME_PATTERN: RegExp;
+/** @internal Collect bounded expressions embedded in a JSON binding value. */
+export declare function collectFlowBindingExpressions(value: unknown): string[];
 /** Deterministic syntax, budget, or path failure raised by the Flow evaluator. */
 export declare class FlowExpressionError extends Error {
     /** Stable error name for callers that classify evaluator failures. */
@@ -43,4 +87,15 @@ export declare function inspectFlowExpression(expression: string, requireBoolean
 export declare function evaluateFlowExpression(expression: string, context: FlowExpressionContext): boolean;
 /** Proposal-compatible short name for {@link evaluateFlowExpression}. */
 export declare function evaluate(expression: string, context: FlowExpressionContext): boolean;
+/** @internal Serialize a JSON-compatible value with deterministic object-key ordering. */
+export declare function stableFlowJson(value: unknown): string;
+/**
+ * Resolves authored node inputs through the bounded Flow expression grammar.
+ *
+ * Exact `${...}` placeholders retain their JSON type. Placeholders embedded in
+ * text use deterministic interpolation, while arrays and objects are traversed
+ * recursively. Runtime values and provenance remain separate so executors do not
+ * need to understand trust metadata.
+ */
+export declare function resolveFlowBindings(bindings: Record<string, unknown> | undefined, context: FlowExpressionContext, nodeOutputOrigin?: NodeOutputOrigin, flowInputOrigins?: Record<string, BindingOrigin[]>): ResolvedNodeBindings;
 //# sourceMappingURL=expression.d.ts.map

package/dist/factory-assets/connectors/flow/contract/expression.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expression.d.ts","sourceRoot":"","sources":["../../../../../factory-assets/connectors/flow/contract/expression.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,eAAO,MAAM,sBAAsB;;;;;;EAMjC,CAAC;AAEH,0EAA0E;AAC1E,MAAM,WAAW,qBAAqB;IACpC,wDAAwD;IACxD,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IACzB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;CAC3E;AAED,kFAAkF;AAClF,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,sEAAsE;IACtE,SAAkB,IAAI,yBAAyB;CAChD;AAwXD,+FAA+F;AAC/F,MAAM,WAAW,uBAAuB;IACtC,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,2GAA2G;AAC3G,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,cAAc,UAAO,GACpB,uBAAuB,EAAE,CAkB3B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAQT;AAED,yEAAyE;AACzE,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAEpF"}
+{"version":3,"file":"expression.d.ts","sourceRoot":"","sources":["../../../../../factory-assets/connectors/flow/contract/expression.ts"],"names":[],"mappings":"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"}

package/dist/factory-assets/connectors/flow/contract/flow.v2.schema.json

@@ -43,9 +43,7 @@
           "$ref": "#/$defs/__schema1"
         }
       },
-      "required": [
-        "schema"
-      ],
+      "required": ["schema"],
       "additionalProperties": false
     },
     "output": {
@@ -61,9 +59,7 @@
           }
         }
       },
-      "required": [
-        "schema"
-      ],
+      "required": ["schema"],
       "additionalProperties": false
     },
     "defaults": {
@@ -71,11 +67,7 @@
       "properties": {
         "approval": {
           "type": "string",
-          "enum": [
-            "checkpoint",
-            "auto",
-            "manual"
-          ]
+          "enum": ["checkpoint", "auto", "manual"]
         },
         "researchDepth": {
           "type": "string",
@@ -155,10 +147,7 @@
                     }
                   }
                 },
-                "required": [
-                  "kind",
-                  "instruction"
-                ],
+                "required": ["kind", "instruction"],
                 "additionalProperties": false
               },
               {
@@ -184,10 +173,7 @@
                     }
                   }
                 },
-                "required": [
-                  "kind",
-                  "instruction"
-                ],
+                "required": ["kind", "instruction"],
                 "additionalProperties": false
               },
               {
@@ -199,11 +185,7 @@
                   },
                   "runtime": {
                     "type": "string",
-                    "enum": [
-                      "shell",
-                      "node",
-                      "python"
-                    ]
+                    "enum": ["shell", "node", "python"]
                   },
                   "command": {
                     "type": "string",
@@ -243,10 +225,7 @@
                     }
                   }
                 },
-                "required": [
-                  "kind",
-                  "command"
-                ],
+                "required": ["kind", "command"],
                 "additionalProperties": false
               },
               {
@@ -259,18 +238,11 @@
                   "onFail": {
                     "default": "escalate",
                     "type": "string",
-                    "enum": [
-                      "escalate",
-                      "fail"
-                    ]
+                    "enum": ["escalate", "fail"]
                   },
                   "runtime": {
                     "type": "string",
-                    "enum": [
-                      "shell",
-                      "node",
-                      "python"
-                    ]
+                    "enum": ["shell", "node", "python"]
                   },
                   "command": {
                     "type": "string",
@@ -310,10 +282,7 @@
                     }
                   }
                 },
-                "required": [
-                  "kind",
-                  "command"
-                ],
+                "required": ["kind", "command"],
                 "additionalProperties": false
               },
               {
@@ -340,9 +309,7 @@
                             "type": "boolean"
                           }
                         },
-                        "required": [
-                          "kind"
-                        ],
+                        "required": ["kind"],
                         "additionalProperties": false
                       },
                       {
@@ -371,10 +338,7 @@
                                   "minLength": 1
                                 }
                               },
-                              "required": [
-                                "id",
-                                "label"
-                              ],
+                              "required": ["id", "label"],
                               "additionalProperties": false
                             }
                           },
@@ -382,10 +346,7 @@
                             "type": "boolean"
                           }
                         },
-                        "required": [
-                          "kind",
-                          "options"
-                        ],
+                        "required": ["kind", "options"],
                         "additionalProperties": false
                       },
                       {
@@ -441,10 +402,7 @@
                                         "minLength": 1
                                       }
                                     },
-                                    "required": [
-                                      "id",
-                                      "label"
-                                    ],
+                                    "required": ["id", "label"],
                                     "additionalProperties": false
                                   }
                                 },
@@ -456,19 +414,12 @@
                                   }
                                 }
                               },
-                              "required": [
-                                "id",
-                                "label",
-                                "type"
-                              ],
+                              "required": ["id", "label", "type"],
                               "additionalProperties": false
                             }
                           }
                         },
-                        "required": [
-                          "kind",
-                          "fields"
-                        ],
+                        "required": ["kind", "fields"],
                         "additionalProperties": false
                       },
                       {
@@ -493,9 +444,7 @@
                             "type": "boolean"
                           }
                         },
-                        "required": [
-                          "kind"
-                        ],
+                        "required": ["kind"],
                         "additionalProperties": false
                       }
                     ]
@@ -508,11 +457,7 @@
                     }
                   }
                 },
-                "required": [
-                  "kind",
-                  "prompt",
-                  "schema"
-                ],
+                "required": ["kind", "prompt", "schema"],
                 "additionalProperties": false
               },
               {
@@ -544,10 +489,7 @@
                           ]
                         }
                       },
-                      "required": [
-                        "when",
-                        "target"
-                      ],
+                      "required": ["when", "target"],
                       "additionalProperties": false
                     }
                   },
@@ -559,10 +501,32 @@
                     }
                   }
                 },
-                "required": [
-                  "kind",
-                  "routes"
-                ],
+                "required": ["kind", "routes"],
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "kind": {
+                    "type": "string",
+                    "const": "sub-flow"
+                  },
+                  "flow": {
+                    "type": "string",
+                    "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+                  },
+                  "passContext": {
+                    "type": "boolean"
+                  },
+                  "assets": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "minLength": 1
+                    }
+                  }
+                },
+                "required": ["kind", "flow"],
                 "additionalProperties": false
               }
             ]
@@ -584,16 +548,15 @@
                       "minLength": 1
                     }
                   },
-                  "required": [
-                    "expr"
-                  ],
+                  "required": ["expr"],
                   "additionalProperties": false
                 }
               },
               "input": {
                 "type": "object",
                 "propertyNames": {
-                  "type": "string"
+                  "type": "string",
+                  "pattern": "^(?!__proto__$)"
                 },
                 "additionalProperties": {
                   "$ref": "#/$defs/__schema4"
@@ -622,16 +585,10 @@
                         },
                         "lifetime": {
                           "type": "string",
-                          "enum": [
-                            "session",
-                            "persistent"
-                          ]
+                          "enum": ["session", "persistent"]
                         }
                       },
-                      "required": [
-                        "kind",
-                        "lifetime"
-                      ],
+                      "required": ["kind", "lifetime"],
                       "additionalProperties": false
                     }
                   }
@@ -646,16 +603,10 @@
             "properties": {
               "approval": {
                 "type": "string",
-                "enum": [
-                  "none",
-                  "optional",
-                  "mandatory"
-                ]
+                "enum": ["none", "optional", "mandatory"]
               }
             },
-            "required": [
-              "approval"
-            ],
+            "required": ["approval"],
             "additionalProperties": false
           },
           "control": {
@@ -676,17 +627,15 @@
               "parallelGroup": {
                 "type": "string",
                 "minLength": 1
+              },
+              "subagent": {
+                "type": "boolean"
               }
             },
             "additionalProperties": false
           }
         },
-        "required": [
-          "id",
-          "label",
-          "description",
-          "run"
-        ],
+        "required": ["id", "label", "description", "run"],
         "additionalProperties": false
       }
     },
@@ -709,19 +658,10 @@
           },
           "type": {
             "type": "string",
-            "enum": [
-              "flow",
-              "parallel",
-              "optional"
-            ]
+            "enum": ["flow", "parallel", "optional"]
           }
         },
-        "required": [
-          "id",
-          "source",
-          "target",
-          "type"
-        ],
+        "required": ["id", "source", "target", "type"],
         "additionalProperties": false
       }
     },
@@ -752,11 +692,7 @@
           "properties": {
             "input_style": {
               "type": "string",
-              "enum": [
-                "freeform",
-                "structured",
-                "repo"
-              ]
+              "enum": ["freeform", "structured", "repo"]
             },
             "placeholder": {
               "type": "string",
@@ -770,23 +706,14 @@
               }
             }
           },
-          "required": [
-            "input_style"
-          ],
+          "required": ["input_style"],
           "additionalProperties": false
         }
       },
       "additionalProperties": false
     }
   },
-  "required": [
-    "schemaVersion",
-    "id",
-    "version",
-    "name",
-    "nodes",
-    "edges"
-  ],
+  "required": ["schemaVersion", "id", "version", "name", "nodes", "edges"],
   "additionalProperties": false,
   "$defs": {
     "__schema0": {

package/dist/factory-assets/connectors/flow/contract/index.d.ts

@@ -1,6 +1,6 @@
 export { FlowDefinitionSchema, type FlowAssetRef, type FlowDefinition, type FlowEdge, type FlowInputContract, type FlowNode, type FlowNodeBindings, type FlowNodeContract, type FlowNodeControl, type FlowNodeKind, type FlowNodePrecondition, type FlowNodeRun, type FlowOutputContract, type FlowRoute, } from "./schema.js";
 export { normalizeV1, parseFlowDefinition, type FlowDefinitionIssue, type FlowDefinitionParseResult, type LegacyCompatibilityEdge, type ParsedFlowDefinition, } from "./normalize.js";
-export { evaluate, evaluateFlowExpression, FLOW_EXPRESSION_LIMITS, FlowExpressionError, type FlowExpressionContext, } from "./expression.js";
+export { evaluate, evaluateFlowExpression, FLOW_EXPRESSION_LIMITS, FlowExpressionError, resolveFlowBindings, type BindingOrigin, type FlowExpressionContext, type NodeOutputOrigin, type ResolvedBinding, type ResolvedNodeBindings, } from "./expression.js";
 export { canonicalizeFlowDefinition, hashFlowDefinition } from "./hash.js";
 export { FLOW_DEFINITION_JSON_SCHEMA_ID, generateFlowDefinitionJsonSchema, } from "./json-schema.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/factory-assets/connectors/flow/contract/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../factory-assets/connectors/flow/contract/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,SAAS,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,GAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,QAAQ,EACR,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,qBAAqB,GAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC3E,OAAO,EACL,8BAA8B,EAC9B,gCAAgC,GACjC,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../factory-assets/connectors/flow/contract/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,SAAS,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,GAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,QAAQ,EACR,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC3E,OAAO,EACL,8BAA8B,EAC9B,gCAAgC,GACjC,MAAM,kBAAkB,CAAC"}

package/dist/factory-assets/connectors/flow/contract/normalize.d.ts

@@ -30,6 +30,9 @@ export type FlowDefinitionParseResult = {
  * Non-executable legacy nodes become inert placeholders so dependency and terminal semantics survive.
  */
 export declare function normalizeV1(data: unknown): FlowDefinitionParseResult;
-/** Protects version intent: only an absent own schema version permits compatibility normalization. */
+/**
+ * Parses strict v2 or normalizes v1, reusing an unchanged successful result across boundaries.
+ * Only an absent own schema version permits compatibility normalization.
+ */
 export declare function parseFlowDefinition(data: unknown): FlowDefinitionParseResult;
 //# sourceMappingURL=normalize.d.ts.map

package/dist/factory-assets/connectors/flow/contract/normalize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../../../factory-assets/connectors/flow/contract/normalize.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAqDrB,iGAAiG;AACjG,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,+FAA+F;AAC/F,MAAM,MAAM,uBAAuB,GAAG;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B,6FAA6F;AAC7F,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,GAAG;IACjE,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,uBAAuB,CAAC,CAAC;CACzE,CAAC;AAEF,yFAAyF;AACzF,MAAM,MAAM,yBAAyB,GACjC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAA;CAAE,GACxC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,mBAAmB,EAAE,CAAA;CAAE,CAAC;AAgFjD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,yBAAyB,CAuHpE;AAED,sGAAsG;AACtG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,yBAAyB,CAM5E"}
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../../../factory-assets/connectors/flow/contract/normalize.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AA2GrB,iGAAiG;AACjG,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,+FAA+F;AAC/F,MAAM,MAAM,uBAAuB,GAAG;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B,6FAA6F;AAC7F,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,GAAG;IACjE,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,uBAAuB,CAAC,CAAC;CACzE,CAAC;AAEF,yFAAyF;AACzF,MAAM,MAAM,yBAAyB,GACjC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAA;CAAE,GACxC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,mBAAmB,EAAE,CAAA;CAAE,CAAC;AAsFjD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,yBAAyB,CAsJpE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,yBAAyB,CAY5E"}

package/dist/factory-assets/connectors/flow/contract/schema.d.ts

@@ -22,7 +22,7 @@ export declare function parseFlowDefinitionStructure(data: unknown): z.ZodSafePa
             command: string;
             kind: "function";
             assets?: string[] | undefined;
-            runtime?: "node" | "shell" | "python" | undefined;
+            runtime?: "shell" | "node" | "python" | undefined;
             cwd?: string | undefined;
             successExit?: number[] | undefined;
             capture?: {
@@ -32,9 +32,9 @@ export declare function parseFlowDefinitionStructure(data: unknown): z.ZodSafePa
         } | {
             command: string;
             kind: "check";
-            onFail: "fail" | "escalate";
+            onFail: "escalate" | "fail";
             assets?: string[] | undefined;
-            runtime?: "node" | "shell" | "python" | undefined;
+            runtime?: "shell" | "node" | "python" | undefined;
             cwd?: string | undefined;
             successExit?: number[] | undefined;
             capture?: {
@@ -83,6 +83,11 @@ export declare function parseFlowDefinitionStructure(data: unknown): z.ZodSafePa
                 target: string | null;
             }[];
             assets?: string[] | undefined;
+        } | {
+            kind: "sub-flow";
+            flow: string;
+            assets?: string[] | undefined;
+            passContext?: boolean | undefined;
         };
         phase?: string | undefined;
         contract?: {
@@ -107,6 +112,7 @@ export declare function parseFlowDefinitionStructure(data: unknown): z.ZodSafePa
             retries?: number | undefined;
             timeoutSec?: number | undefined;
             parallelGroup?: string | undefined;
+            subagent?: boolean | undefined;
         } | undefined;
     }[];
     edges: {
@@ -194,8 +200,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
         }, z.core.$strict>, z.ZodObject<{
             assets: z.ZodOptional<z.ZodArray<z.ZodString>>;
             runtime: z.ZodOptional<z.ZodEnum<{
-                node: "node";
                 shell: "shell";
+                node: "node";
                 python: "python";
             }>>;
             command: z.ZodString;
@@ -209,8 +215,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
         }, z.core.$strict>, z.ZodObject<{
             assets: z.ZodOptional<z.ZodArray<z.ZodString>>;
             runtime: z.ZodOptional<z.ZodEnum<{
-                node: "node";
                 shell: "shell";
+                node: "node";
                 python: "python";
             }>>;
             command: z.ZodString;
@@ -222,8 +228,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
             }, z.core.$strict>>;
             kind: z.ZodLiteral<"check">;
             onFail: z.ZodDefault<z.ZodEnum<{
-                fail: "fail";
                 escalate: "escalate";
+                fail: "fail";
             }>>;
         }, z.core.$strict>, z.ZodObject<{
             assets: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -275,13 +281,18 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
                 when: z.ZodString;
                 target: z.ZodNullable<z.ZodString>;
             }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            assets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            kind: z.ZodLiteral<"sub-flow">;
+            flow: z.ZodString;
+            passContext: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>], "kind">;
         contract: z.ZodOptional<z.ZodObject<{
             requires: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 expr: z.ZodString;
                 message: z.ZodOptional<z.ZodString>;
             }, z.core.$strict>>>;
-            input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+            input: z.ZodOptional<z.ZodPreprocess<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>>;
             output: z.ZodOptional<z.ZodObject<{
                 fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
                 artifacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -305,6 +316,7 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
             retries: z.ZodOptional<z.ZodNumber>;
             timeoutSec: z.ZodOptional<z.ZodNumber>;
             parallelGroup: z.ZodOptional<z.ZodString>;
+            subagent: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
     edges: z.ZodArray<z.ZodObject<{
@@ -341,7 +353,7 @@ export type FlowNode = FlowDefinition["nodes"][number];
 export type FlowEdge = FlowDefinition["edges"][number];
 /** Closed execution-owner declaration with no dispatch or conversation-mode switches. */
 export type FlowNodeRun = FlowNode["run"];
-/** Closed vocabulary of the six supported execution-owner identities. */
+/** Closed vocabulary of the seven supported execution-owner identities. */
 export type FlowNodeKind = FlowNodeRun["kind"];
 /** Validation boundary applied to values entering a Flow run. */
 export type FlowInputContract = NonNullable<FlowDefinition["input"]>;

package/dist/factory-assets/connectors/flow/contract/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../../factory-assets/connectors/flow/contract/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAyMzB,sFAAsF;AACtF,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAEzD;AA6CD,qFAAqF;AACrF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAgL/B,CAAC;AAEH,wFAAwF;AACxF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,4EAA4E;AAC5E,MAAM,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,0FAA0F;AAC1F,MAAM,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,yFAAyF;AACzF,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;AAE1C,yEAAyE;AACzE,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AAE/C,iEAAiE;AACjE,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;AAErE,gEAAgE;AAChE,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEvE,sGAAsG;AACtG,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;AAEjE,8EAA8E;AAC9E,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;AAE/D,uEAAuE;AACvE,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAE1E,kGAAkG;AAClG,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,SAC5E,KAAK,CAAC,MAAM,CAAC,CAAC,GACd,SAAS,GACT,CAAC,GACD,KAAK,CAAC;AAEV,qFAAqF;AACrF,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnF,sFAAsF;AACtF,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../../factory-assets/connectors/flow/contract/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AA2OzB,sFAAsF;AACtF,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAEzD;AAoCD,qFAAqF;AACrF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAsL/B,CAAC;AAEH,wFAAwF;AACxF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,4EAA4E;AAC5E,MAAM,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,0FAA0F;AAC1F,MAAM,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,yFAAyF;AACzF,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;AAE1C,2EAA2E;AAC3E,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AAE/C,iEAAiE;AACjE,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;AAErE,gEAAgE;AAChE,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEvE,sGAAsG;AACtG,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;AAEjE,8EAA8E;AAC9E,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;AAE/D,uEAAuE;AACvE,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAE1E,kGAAkG;AAClG,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,SAC5E,KAAK,CAAC,MAAM,CAAC,CAAC,GACd,SAAS,GACT,CAAC,GACD,KAAK,CAAC;AAEV,qFAAqF;AACrF,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnF,sFAAsF;AACtF,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC"}