patchwork-os 0.2.0-beta.1 → 0.2.0-beta.10.canary.95

package/dist/schemas/recipe.v1.json

@@ -26,7 +26,8 @@
       "description": "Human-readable description of what this recipe does"
     },
     "maxConcurrency": {
-      "type": "number",
+      "type": "integer",
+      "minimum": 1,
       "description": "Maximum number of chained steps that may execute in parallel"
     },
     "maxDepth": {
@@ -199,6 +200,49 @@
                 "type": "number",
                 "description": "Milliseconds to wait between retries (default 1000)"
               },
+              "timeout_ms": {
+                "type": "number",
+                "description": "Wall-clock timeout in milliseconds. If the step takes longer, the run halts with category step_timeout. Agent steps are not subject to this timeout."
+              },
+              "expect": {
+                "type": "object",
+                "description": "Per-step assertions evaluated against the step output. Multiple fields are AND-composed.",
+                "properties": {
+                  "schema": {
+                    "type": "object",
+                    "description": "JSON Schema validated against the step output via AJV"
+                  },
+                  "equals": {
+                    "description": "Deep-equal comparison. Strings compared verbatim; objects/arrays compared via JSON canonical form."
+                  },
+                  "matches": {
+                    "type": "string",
+                    "description": "Regex (string source, no flags) matched against the stringified output. Max 500 chars."
+                  },
+                  "contains": {
+                    "oneOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      }
+                    ],
+                    "description": "Substring(s) that must appear in the stringified output. Array → all must be present."
+                  },
+                  "on_fail": {
+                    "type": "string",
+                    "enum": [
+                      "halt",
+                      "warn"
+                    ],
+                    "description": "halt (default): step becomes error on assertion failure. warn: step passes but failure list is attached to stepResult.expectWarnings."
+                  }
+                }
+              },
               "agent": {
                 "type": "object",
                 "required": [
@@ -230,6 +274,17 @@
                   "into": {
                     "type": "string",
                     "description": "Variable name to store output in context"
+                  },
+                  "mcpAccess": {
+                    "type": "boolean",
+                    "description": "When true, grants the agent step access to MCP tools registered on the bridge. Defaults to false for subprocess driver steps."
+                  },
+                  "kind": {
+                    "type": "string",
+                    "enum": [
+                      "judge"
+                    ],
+                    "description": "When set to 'judge', the agent step emits a structured verdictReason and stores the verdict in the run log."
                   }
                 }
               }
@@ -281,6 +336,49 @@
                 "type": "number",
                 "description": "Milliseconds to wait between retries (default 1000)"
               },
+              "timeout_ms": {
+                "type": "number",
+                "description": "Wall-clock timeout in milliseconds. If the step takes longer, the run halts with category step_timeout. Agent steps are not subject to this timeout."
+              },
+              "expect": {
+                "type": "object",
+                "description": "Per-step assertions evaluated against the step output. Multiple fields are AND-composed.",
+                "properties": {
+                  "schema": {
+                    "type": "object",
+                    "description": "JSON Schema validated against the step output via AJV"
+                  },
+                  "equals": {
+                    "description": "Deep-equal comparison. Strings compared verbatim; objects/arrays compared via JSON canonical form."
+                  },
+                  "matches": {
+                    "type": "string",
+                    "description": "Regex (string source, no flags) matched against the stringified output. Max 500 chars."
+                  },
+                  "contains": {
+                    "oneOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      }
+                    ],
+                    "description": "Substring(s) that must appear in the stringified output. Array → all must be present."
+                  },
+                  "on_fail": {
+                    "type": "string",
+                    "enum": [
+                      "halt",
+                      "warn"
+                    ],
+                    "description": "halt (default): step becomes error on assertion failure. warn: step passes but failure list is attached to stepResult.expectWarnings."
+                  }
+                }
+              },
               "tool": {
                 "type": "string",
                 "not": {
@@ -347,6 +445,49 @@
                 "type": "number",
                 "description": "Milliseconds to wait between retries (default 1000)"
               },
+              "timeout_ms": {
+                "type": "number",
+                "description": "Wall-clock timeout in milliseconds. If the step takes longer, the run halts with category step_timeout. Agent steps are not subject to this timeout."
+              },
+              "expect": {
+                "type": "object",
+                "description": "Per-step assertions evaluated against the step output. Multiple fields are AND-composed.",
+                "properties": {
+                  "schema": {
+                    "type": "object",
+                    "description": "JSON Schema validated against the step output via AJV"
+                  },
+                  "equals": {
+                    "description": "Deep-equal comparison. Strings compared verbatim; objects/arrays compared via JSON canonical form."
+                  },
+                  "matches": {
+                    "type": "string",
+                    "description": "Regex (string source, no flags) matched against the stringified output. Max 500 chars."
+                  },
+                  "contains": {
+                    "oneOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      }
+                    ],
+                    "description": "Substring(s) that must appear in the stringified output. Array → all must be present."
+                  },
+                  "on_fail": {
+                    "type": "string",
+                    "enum": [
+                      "halt",
+                      "warn"
+                    ],
+                    "description": "halt (default): step becomes error on assertion failure. warn: step passes but failure list is attached to stepResult.expectWarnings."
+                  }
+                }
+              },
               "recipe": {
                 "type": "string",
                 "description": "Nested recipe name or path"
@@ -386,223 +527,745 @@
                 }
               },
               "parallel": {
-                "type": "array",
-                "description": "Run these steps concurrently. All must finish before later steps that await this group.",
-                "items": {
-                  "oneOf": [
-                    {
-                      "type": "object",
-                      "required": [
-                        "agent"
-                      ],
-                      "properties": {
-                        "id": {
-                          "type": "string",
-                          "description": "Unique chained step identifier used for outputs and dependencies"
-                        },
-                        "awaits": {
-                          "type": "array",
-                          "description": "Step IDs that must complete before this step runs",
-                          "items": {
-                            "type": "string"
-                          }
-                        },
-                        "when": {
-                          "type": "string",
-                          "description": "Template condition that controls whether this step runs"
-                        },
-                        "optional": {
-                          "type": "boolean",
-                          "description": "Whether step failure should be tolerated"
-                        },
-                        "risk": {
-                          "type": "string",
-                          "enum": [
-                            "low",
-                            "medium",
-                            "high"
+                "description": "Run these steps concurrently. Array form: steps run in parallel. Object form: map-reduce — each item in `each` is bound to `as` and the steps array runs once per item.",
+                "oneOf": [
+                  {
+                    "type": "array",
+                    "description": "Run these steps concurrently.",
+                    "items": {
+                      "oneOf": [
+                        {
+                          "type": "object",
+                          "required": [
+                            "agent"
                           ],
-                          "description": "Risk level for this step"
-                        },
-                        "transform": {
-                          "type": "string",
-                          "description": "Template rendered after tool execution. Use $result to reference the tool output. Supports all template expressions."
-                        },
-                        "retry": {
-                          "type": "number",
-                          "description": "Number of times to retry this step on failure (overrides recipe-level on_error.retry)"
-                        },
-                        "retryDelay": {
-                          "type": "number",
-                          "description": "Milliseconds to wait between retries (default 1000)"
+                          "properties": {
+                            "id": {
+                              "type": "string",
+                              "description": "Unique chained step identifier used for outputs and dependencies"
+                            },
+                            "awaits": {
+                              "type": "array",
+                              "description": "Step IDs that must complete before this step runs",
+                              "items": {
+                                "type": "string"
+                              }
+                            },
+                            "when": {
+                              "type": "string",
+                              "description": "Template condition that controls whether this step runs"
+                            },
+                            "optional": {
+                              "type": "boolean",
+                              "description": "Whether step failure should be tolerated"
+                            },
+                            "risk": {
+                              "type": "string",
+                              "enum": [
+                                "low",
+                                "medium",
+                                "high"
+                              ],
+                              "description": "Risk level for this step"
+                            },
+                            "transform": {
+                              "type": "string",
+                              "description": "Template rendered after tool execution. Use $result to reference the tool output. Supports all template expressions."
+                            },
+                            "retry": {
+                              "type": "number",
+                              "description": "Number of times to retry this step on failure (overrides recipe-level on_error.retry)"
+                            },
+                            "retryDelay": {
+                              "type": "number",
+                              "description": "Milliseconds to wait between retries (default 1000)"
+                            },
+                            "timeout_ms": {
+                              "type": "number",
+                              "description": "Wall-clock timeout in milliseconds. If the step takes longer, the run halts with category step_timeout. Agent steps are not subject to this timeout."
+                            },
+                            "expect": {
+                              "type": "object",
+                              "description": "Per-step assertions evaluated against the step output. Multiple fields are AND-composed.",
+                              "properties": {
+                                "schema": {
+                                  "type": "object",
+                                  "description": "JSON Schema validated against the step output via AJV"
+                                },
+                                "equals": {
+                                  "description": "Deep-equal comparison. Strings compared verbatim; objects/arrays compared via JSON canonical form."
+                                },
+                                "matches": {
+                                  "type": "string",
+                                  "description": "Regex (string source, no flags) matched against the stringified output. Max 500 chars."
+                                },
+                                "contains": {
+                                  "oneOf": [
+                                    {
+                                      "type": "string"
+                                    },
+                                    {
+                                      "type": "array",
+                                      "items": {
+                                        "type": "string"
+                                      }
+                                    }
+                                  ],
+                                  "description": "Substring(s) that must appear in the stringified output. Array → all must be present."
+                                },
+                                "on_fail": {
+                                  "type": "string",
+                                  "enum": [
+                                    "halt",
+                                    "warn"
+                                  ],
+                                  "description": "halt (default): step becomes error on assertion failure. warn: step passes but failure list is attached to stepResult.expectWarnings."
+                                }
+                              }
+                            },
+                            "agent": {
+                              "type": "object",
+                              "required": [
+                                "prompt"
+                              ],
+                              "description": "Agent step configuration",
+                              "properties": {
+                                "prompt": {
+                                  "type": "string"
+                                },
+                                "model": {
+                                  "type": "string"
+                                },
+                                "driver": {
+                                  "type": "string",
+                                  "enum": [
+                                    "claude",
+                                    "claude-code",
+                                    "api",
+                                    "openai",
+                                    "grok",
+                                    "gemini",
+                                    "anthropic"
+                                  ]
+                                },
+                                "into": {
+                                  "type": "string"
+                                },
+                                "mcpAccess": {
+                                  "type": "boolean",
+                                  "description": "When true, grants the agent step access to MCP tools registered on the bridge. Defaults to false for subprocess driver steps."
+                                },
+                                "kind": {
+                                  "type": "string",
+                                  "enum": [
+                                    "judge"
+                                  ],
+                                  "description": "When set to 'judge', the agent step emits a structured verdictReason and stores the verdict in the run log."
+                                }
+                              }
+                            }
+                          }
                         },
-                        "agent": {
+                        {
                           "type": "object",
                           "required": [
-                            "prompt"
+                            "tool"
                           ],
-                          "description": "Agent step configuration",
                           "properties": {
-                            "prompt": {
-                              "type": "string"
+                            "id": {
+                              "type": "string",
+                              "description": "Unique chained step identifier used for outputs and dependencies"
                             },
-                            "model": {
-                              "type": "string"
+                            "awaits": {
+                              "type": "array",
+                              "description": "Step IDs that must complete before this step runs",
+                              "items": {
+                                "type": "string"
+                              }
                             },
-                            "driver": {
+                            "when": {
+                              "type": "string",
+                              "description": "Template condition that controls whether this step runs"
+                            },
+                            "optional": {
+                              "type": "boolean",
+                              "description": "Whether step failure should be tolerated"
+                            },
+                            "risk": {
                               "type": "string",
                               "enum": [
-                                "claude",
-                                "claude-code",
-                                "api",
-                                "openai",
-                                "grok",
-                                "gemini",
-                                "anthropic"
-                              ]
+                                "low",
+                                "medium",
+                                "high"
+                              ],
+                              "description": "Risk level for this step"
+                            },
+                            "transform": {
+                              "type": "string",
+                              "description": "Template rendered after tool execution. Use $result to reference the tool output. Supports all template expressions."
+                            },
+                            "retry": {
+                              "type": "number",
+                              "description": "Number of times to retry this step on failure (overrides recipe-level on_error.retry)"
+                            },
+                            "retryDelay": {
+                              "type": "number",
+                              "description": "Milliseconds to wait between retries (default 1000)"
+                            },
+                            "timeout_ms": {
+                              "type": "number",
+                              "description": "Wall-clock timeout in milliseconds. If the step takes longer, the run halts with category step_timeout. Agent steps are not subject to this timeout."
+                            },
+                            "expect": {
+                              "type": "object",
+                              "description": "Per-step assertions evaluated against the step output. Multiple fields are AND-composed.",
+                              "properties": {
+                                "schema": {
+                                  "type": "object",
+                                  "description": "JSON Schema validated against the step output via AJV"
+                                },
+                                "equals": {
+                                  "description": "Deep-equal comparison. Strings compared verbatim; objects/arrays compared via JSON canonical form."
+                                },
+                                "matches": {
+                                  "type": "string",
+                                  "description": "Regex (string source, no flags) matched against the stringified output. Max 500 chars."
+                                },
+                                "contains": {
+                                  "oneOf": [
+                                    {
+                                      "type": "string"
+                                    },
+                                    {
+                                      "type": "array",
+                                      "items": {
+                                        "type": "string"
+                                      }
+                                    }
+                                  ],
+                                  "description": "Substring(s) that must appear in the stringified output. Array → all must be present."
+                                },
+                                "on_fail": {
+                                  "type": "string",
+                                  "enum": [
+                                    "halt",
+                                    "warn"
+                                  ],
+                                  "description": "halt (default): step becomes error on assertion failure. warn: step passes but failure list is attached to stepResult.expectWarnings."
+                                }
+                              }
+                            },
+                            "tool": {
+                              "type": "string",
+                              "not": {
+                                "enum": []
+                              }
                             },
                             "into": {
                               "type": "string"
                             }
                           }
-                        }
-                      }
-                    },
-                    {
-                      "type": "object",
-                      "required": [
-                        "tool"
-                      ],
-                      "properties": {
-                        "id": {
-                          "type": "string",
-                          "description": "Unique chained step identifier used for outputs and dependencies"
                         },
-                        "awaits": {
-                          "type": "array",
-                          "description": "Step IDs that must complete before this step runs",
-                          "items": {
-                            "type": "string"
-                          }
-                        },
-                        "when": {
-                          "type": "string",
-                          "description": "Template condition that controls whether this step runs"
-                        },
-                        "optional": {
-                          "type": "boolean",
-                          "description": "Whether step failure should be tolerated"
-                        },
-                        "risk": {
-                          "type": "string",
-                          "enum": [
-                            "low",
-                            "medium",
-                            "high"
+                        {
+                          "type": "object",
+                          "anyOf": [
+                            {
+                              "required": [
+                                "recipe"
+                              ]
+                            },
+                            {
+                              "required": [
+                                "chain"
+                              ]
+                            }
                           ],
-                          "description": "Risk level for this step"
-                        },
-                        "transform": {
-                          "type": "string",
-                          "description": "Template rendered after tool execution. Use $result to reference the tool output. Supports all template expressions."
-                        },
-                        "retry": {
-                          "type": "number",
-                          "description": "Number of times to retry this step on failure (overrides recipe-level on_error.retry)"
-                        },
-                        "retryDelay": {
-                          "type": "number",
-                          "description": "Milliseconds to wait between retries (default 1000)"
-                        },
-                        "tool": {
-                          "type": "string",
-                          "not": {
-                            "enum": []
+                          "properties": {
+                            "id": {
+                              "type": "string",
+                              "description": "Unique chained step identifier used for outputs and dependencies"
+                            },
+                            "awaits": {
+                              "type": "array",
+                              "description": "Step IDs that must complete before this step runs",
+                              "items": {
+                                "type": "string"
+                              }
+                            },
+                            "when": {
+                              "type": "string",
+                              "description": "Template condition that controls whether this step runs"
+                            },
+                            "optional": {
+                              "type": "boolean",
+                              "description": "Whether step failure should be tolerated"
+                            },
+                            "risk": {
+                              "type": "string",
+                              "enum": [
+                                "low",
+                                "medium",
+                                "high"
+                              ],
+                              "description": "Risk level for this step"
+                            },
+                            "transform": {
+                              "type": "string",
+                              "description": "Template rendered after tool execution. Use $result to reference the tool output. Supports all template expressions."
+                            },
+                            "retry": {
+                              "type": "number",
+                              "description": "Number of times to retry this step on failure (overrides recipe-level on_error.retry)"
+                            },
+                            "retryDelay": {
+                              "type": "number",
+                              "description": "Milliseconds to wait between retries (default 1000)"
+                            },
+                            "timeout_ms": {
+                              "type": "number",
+                              "description": "Wall-clock timeout in milliseconds. If the step takes longer, the run halts with category step_timeout. Agent steps are not subject to this timeout."
+                            },
+                            "expect": {
+                              "type": "object",
+                              "description": "Per-step assertions evaluated against the step output. Multiple fields are AND-composed.",
+                              "properties": {
+                                "schema": {
+                                  "type": "object",
+                                  "description": "JSON Schema validated against the step output via AJV"
+                                },
+                                "equals": {
+                                  "description": "Deep-equal comparison. Strings compared verbatim; objects/arrays compared via JSON canonical form."
+                                },
+                                "matches": {
+                                  "type": "string",
+                                  "description": "Regex (string source, no flags) matched against the stringified output. Max 500 chars."
+                                },
+                                "contains": {
+                                  "oneOf": [
+                                    {
+                                      "type": "string"
+                                    },
+                                    {
+                                      "type": "array",
+                                      "items": {
+                                        "type": "string"
+                                      }
+                                    }
+                                  ],
+                                  "description": "Substring(s) that must appear in the stringified output. Array → all must be present."
+                                },
+                                "on_fail": {
+                                  "type": "string",
+                                  "enum": [
+                                    "halt",
+                                    "warn"
+                                  ],
+                                  "description": "halt (default): step becomes error on assertion failure. warn: step passes but failure list is attached to stepResult.expectWarnings."
+                                }
+                              }
+                            },
+                            "recipe": {
+                              "type": "string",
+                              "description": "Nested recipe name or path"
+                            },
+                            "chain": {
+                              "type": "string",
+                              "description": "Alias for nested recipe name or path"
+                            },
+                            "vars": {
+                              "type": "object",
+                              "description": "Template variables passed into a nested recipe step",
+                              "additionalProperties": {
+                                "type": "string"
+                              }
+                            },
+                            "output": {
+                              "type": "string",
+                              "description": "Output key for the nested recipe result"
+                            }
                           }
-                        },
-                        "into": {
-                          "type": "string"
                         }
-                      }
-                    },
-                    {
-                      "type": "object",
-                      "anyOf": [
-                        {
-                          "required": [
-                            "recipe"
-                          ]
-                        },
-                        {
-                          "required": [
-                            "chain"
+                      ]
+                    }
+                  },
+                  {
+                    "type": "object",
+                    "description": "Map-reduce form — iterate over a collection and run steps once per item.",
+                    "required": [
+                      "each",
+                      "steps"
+                    ],
+                    "properties": {
+                      "each": {
+                        "type": "string",
+                        "description": "Template expression that resolves to an array of items to iterate over (e.g. '{{outputs.list}}')."
+                      },
+                      "as": {
+                        "type": "string",
+                        "description": "Variable name each item is bound to inside the steps (default: 'item')."
+                      },
+                      "steps": {
+                        "type": "array",
+                        "description": "Steps to run for each item in the collection.",
+                        "items": {
+                          "oneOf": [
+                            {
+                              "type": "object",
+                              "required": [
+                                "agent"
+                              ],
+                              "properties": {
+                                "id": {
+                                  "type": "string",
+                                  "description": "Unique chained step identifier used for outputs and dependencies"
+                                },
+                                "awaits": {
+                                  "type": "array",
+                                  "description": "Step IDs that must complete before this step runs",
+                                  "items": {
+                                    "type": "string"
+                                  }
+                                },
+                                "when": {
+                                  "type": "string",
+                                  "description": "Template condition that controls whether this step runs"
+                                },
+                                "optional": {
+                                  "type": "boolean",
+                                  "description": "Whether step failure should be tolerated"
+                                },
+                                "risk": {
+                                  "type": "string",
+                                  "enum": [
+                                    "low",
+                                    "medium",
+                                    "high"
+                                  ],
+                                  "description": "Risk level for this step"
+                                },
+                                "transform": {
+                                  "type": "string",
+                                  "description": "Template rendered after tool execution. Use $result to reference the tool output. Supports all template expressions."
+                                },
+                                "retry": {
+                                  "type": "number",
+                                  "description": "Number of times to retry this step on failure (overrides recipe-level on_error.retry)"
+                                },
+                                "retryDelay": {
+                                  "type": "number",
+                                  "description": "Milliseconds to wait between retries (default 1000)"
+                                },
+                                "timeout_ms": {
+                                  "type": "number",
+                                  "description": "Wall-clock timeout in milliseconds. If the step takes longer, the run halts with category step_timeout. Agent steps are not subject to this timeout."
+                                },
+                                "expect": {
+                                  "type": "object",
+                                  "description": "Per-step assertions evaluated against the step output. Multiple fields are AND-composed.",
+                                  "properties": {
+                                    "schema": {
+                                      "type": "object",
+                                      "description": "JSON Schema validated against the step output via AJV"
+                                    },
+                                    "equals": {
+                                      "description": "Deep-equal comparison. Strings compared verbatim; objects/arrays compared via JSON canonical form."
+                                    },
+                                    "matches": {
+                                      "type": "string",
+                                      "description": "Regex (string source, no flags) matched against the stringified output. Max 500 chars."
+                                    },
+                                    "contains": {
+                                      "oneOf": [
+                                        {
+                                          "type": "string"
+                                        },
+                                        {
+                                          "type": "array",
+                                          "items": {
+                                            "type": "string"
+                                          }
+                                        }
+                                      ],
+                                      "description": "Substring(s) that must appear in the stringified output. Array → all must be present."
+                                    },
+                                    "on_fail": {
+                                      "type": "string",
+                                      "enum": [
+                                        "halt",
+                                        "warn"
+                                      ],
+                                      "description": "halt (default): step becomes error on assertion failure. warn: step passes but failure list is attached to stepResult.expectWarnings."
+                                    }
+                                  }
+                                },
+                                "agent": {
+                                  "type": "object",
+                                  "required": [
+                                    "prompt"
+                                  ],
+                                  "description": "Agent step configuration",
+                                  "properties": {
+                                    "prompt": {
+                                      "type": "string"
+                                    },
+                                    "model": {
+                                      "type": "string"
+                                    },
+                                    "driver": {
+                                      "type": "string",
+                                      "enum": [
+                                        "claude",
+                                        "claude-code",
+                                        "api",
+                                        "openai",
+                                        "grok",
+                                        "gemini",
+                                        "anthropic"
+                                      ]
+                                    },
+                                    "into": {
+                                      "type": "string"
+                                    },
+                                    "mcpAccess": {
+                                      "type": "boolean",
+                                      "description": "When true, grants the agent step access to MCP tools registered on the bridge. Defaults to false for subprocess driver steps."
+                                    },
+                                    "kind": {
+                                      "type": "string",
+                                      "enum": [
+                                        "judge"
+                                      ],
+                                      "description": "When set to 'judge', the agent step emits a structured verdictReason and stores the verdict in the run log."
+                                    }
+                                  }
+                                }
+                              }
+                            },
+                            {
+                              "type": "object",
+                              "required": [
+                                "tool"
+                              ],
+                              "properties": {
+                                "id": {
+                                  "type": "string",
+                                  "description": "Unique chained step identifier used for outputs and dependencies"
+                                },
+                                "awaits": {
+                                  "type": "array",
+                                  "description": "Step IDs that must complete before this step runs",
+                                  "items": {
+                                    "type": "string"
+                                  }
+                                },
+                                "when": {
+                                  "type": "string",
+                                  "description": "Template condition that controls whether this step runs"
+                                },
+                                "optional": {
+                                  "type": "boolean",
+                                  "description": "Whether step failure should be tolerated"
+                                },
+                                "risk": {
+                                  "type": "string",
+                                  "enum": [
+                                    "low",
+                                    "medium",
+                                    "high"
+                                  ],
+                                  "description": "Risk level for this step"
+                                },
+                                "transform": {
+                                  "type": "string",
+                                  "description": "Template rendered after tool execution. Use $result to reference the tool output. Supports all template expressions."
+                                },
+                                "retry": {
+                                  "type": "number",
+                                  "description": "Number of times to retry this step on failure (overrides recipe-level on_error.retry)"
+                                },
+                                "retryDelay": {
+                                  "type": "number",
+                                  "description": "Milliseconds to wait between retries (default 1000)"
+                                },
+                                "timeout_ms": {
+                                  "type": "number",
+                                  "description": "Wall-clock timeout in milliseconds. If the step takes longer, the run halts with category step_timeout. Agent steps are not subject to this timeout."
+                                },
+                                "expect": {
+                                  "type": "object",
+                                  "description": "Per-step assertions evaluated against the step output. Multiple fields are AND-composed.",
+                                  "properties": {
+                                    "schema": {
+                                      "type": "object",
+                                      "description": "JSON Schema validated against the step output via AJV"
+                                    },
+                                    "equals": {
+                                      "description": "Deep-equal comparison. Strings compared verbatim; objects/arrays compared via JSON canonical form."
+                                    },
+                                    "matches": {
+                                      "type": "string",
+                                      "description": "Regex (string source, no flags) matched against the stringified output. Max 500 chars."
+                                    },
+                                    "contains": {
+                                      "oneOf": [
+                                        {
+                                          "type": "string"
+                                        },
+                                        {
+                                          "type": "array",
+                                          "items": {
+                                            "type": "string"
+                                          }
+                                        }
+                                      ],
+                                      "description": "Substring(s) that must appear in the stringified output. Array → all must be present."
+                                    },
+                                    "on_fail": {
+                                      "type": "string",
+                                      "enum": [
+                                        "halt",
+                                        "warn"
+                                      ],
+                                      "description": "halt (default): step becomes error on assertion failure. warn: step passes but failure list is attached to stepResult.expectWarnings."
+                                    }
+                                  }
+                                },
+                                "tool": {
+                                  "type": "string",
+                                  "not": {
+                                    "enum": []
+                                  }
+                                },
+                                "into": {
+                                  "type": "string"
+                                }
+                              }
+                            },
+                            {
+                              "type": "object",
+                              "anyOf": [
+                                {
+                                  "required": [
+                                    "recipe"
+                                  ]
+                                },
+                                {
+                                  "required": [
+                                    "chain"
+                                  ]
+                                }
+                              ],
+                              "properties": {
+                                "id": {
+                                  "type": "string",
+                                  "description": "Unique chained step identifier used for outputs and dependencies"
+                                },
+                                "awaits": {
+                                  "type": "array",
+                                  "description": "Step IDs that must complete before this step runs",
+                                  "items": {
+                                    "type": "string"
+                                  }
+                                },
+                                "when": {
+                                  "type": "string",
+                                  "description": "Template condition that controls whether this step runs"
+                                },
+                                "optional": {
+                                  "type": "boolean",
+                                  "description": "Whether step failure should be tolerated"
+                                },
+                                "risk": {
+                                  "type": "string",
+                                  "enum": [
+                                    "low",
+                                    "medium",
+                                    "high"
+                                  ],
+                                  "description": "Risk level for this step"
+                                },
+                                "transform": {
+                                  "type": "string",
+                                  "description": "Template rendered after tool execution. Use $result to reference the tool output. Supports all template expressions."
+                                },
+                                "retry": {
+                                  "type": "number",
+                                  "description": "Number of times to retry this step on failure (overrides recipe-level on_error.retry)"
+                                },
+                                "retryDelay": {
+                                  "type": "number",
+                                  "description": "Milliseconds to wait between retries (default 1000)"
+                                },
+                                "timeout_ms": {
+                                  "type": "number",
+                                  "description": "Wall-clock timeout in milliseconds. If the step takes longer, the run halts with category step_timeout. Agent steps are not subject to this timeout."
+                                },
+                                "expect": {
+                                  "type": "object",
+                                  "description": "Per-step assertions evaluated against the step output. Multiple fields are AND-composed.",
+                                  "properties": {
+                                    "schema": {
+                                      "type": "object",
+                                      "description": "JSON Schema validated against the step output via AJV"
+                                    },
+                                    "equals": {
+                                      "description": "Deep-equal comparison. Strings compared verbatim; objects/arrays compared via JSON canonical form."
+                                    },
+                                    "matches": {
+                                      "type": "string",
+                                      "description": "Regex (string source, no flags) matched against the stringified output. Max 500 chars."
+                                    },
+                                    "contains": {
+                                      "oneOf": [
+                                        {
+                                          "type": "string"
+                                        },
+                                        {
+                                          "type": "array",
+                                          "items": {
+                                            "type": "string"
+                                          }
+                                        }
+                                      ],
+                                      "description": "Substring(s) that must appear in the stringified output. Array → all must be present."
+                                    },
+                                    "on_fail": {
+                                      "type": "string",
+                                      "enum": [
+                                        "halt",
+                                        "warn"
+                                      ],
+                                      "description": "halt (default): step becomes error on assertion failure. warn: step passes but failure list is attached to stepResult.expectWarnings."
+                                    }
+                                  }
+                                },
+                                "recipe": {
+                                  "type": "string",
+                                  "description": "Nested recipe name or path"
+                                },
+                                "chain": {
+                                  "type": "string",
+                                  "description": "Alias for nested recipe name or path"
+                                },
+                                "vars": {
+                                  "type": "object",
+                                  "description": "Template variables passed into a nested recipe step",
+                                  "additionalProperties": {
+                                    "type": "string"
+                                  }
+                                },
+                                "output": {
+                                  "type": "string",
+                                  "description": "Output key for the nested recipe result"
+                                }
+                              }
+                            }
                           ]
                         }
-                      ],
-                      "properties": {
-                        "id": {
-                          "type": "string",
-                          "description": "Unique chained step identifier used for outputs and dependencies"
-                        },
-                        "awaits": {
-                          "type": "array",
-                          "description": "Step IDs that must complete before this step runs",
-                          "items": {
-                            "type": "string"
-                          }
-                        },
-                        "when": {
-                          "type": "string",
-                          "description": "Template condition that controls whether this step runs"
-                        },
-                        "optional": {
-                          "type": "boolean",
-                          "description": "Whether step failure should be tolerated"
-                        },
-                        "risk": {
-                          "type": "string",
-                          "enum": [
-                            "low",
-                            "medium",
-                            "high"
-                          ],
-                          "description": "Risk level for this step"
-                        },
-                        "transform": {
-                          "type": "string",
-                          "description": "Template rendered after tool execution. Use $result to reference the tool output. Supports all template expressions."
-                        },
-                        "retry": {
-                          "type": "number",
-                          "description": "Number of times to retry this step on failure (overrides recipe-level on_error.retry)"
-                        },
-                        "retryDelay": {
-                          "type": "number",
-                          "description": "Milliseconds to wait between retries (default 1000)"
-                        },
-                        "recipe": {
-                          "type": "string",
-                          "description": "Nested recipe name or path"
-                        },
-                        "chain": {
-                          "type": "string",
-                          "description": "Alias for nested recipe name or path"
-                        },
-                        "vars": {
-                          "type": "object",
-                          "description": "Template variables passed into a nested recipe step",
-                          "additionalProperties": {
-                            "type": "string"
-                          }
-                        },
-                        "output": {
-                          "type": "string",
-                          "description": "Output key for the nested recipe result"
-                        }
                       }
                     }
-                  ]
-                }
+                  }
+                ]
               }
             }
           }
@@ -675,10 +1338,36 @@
         },
         "notify": {
           "type": "boolean",
-          "description": "Reserved. yamlRunner currently posts Slack notifications on any step failure when slack is connected; gating on this flag is not yet wired.",
+          "description": "When false, suppresses Slack notifications on step failure even when a Slack connector is connected.",
           "default": true
         }
       }
+    },
+    "budget": {
+      "type": "object",
+      "description": "Per-recipe token budget (PR2b). When set, the runner tracks cumulative tokens across API driver calls; on breach the run halts with budget_exceeded. Subscription drivers (Claude CLI) don't report token counts and are skipped.",
+      "properties": {
+        "tokensMax": {
+          "type": "number",
+          "description": "Cumulative input + output tokens allowed across the whole run"
+        },
+        "onBreach": {
+          "type": "string",
+          "enum": [
+            "halt",
+            "warn"
+          ],
+          "description": "halt (default): stop run on next admission check. warn: continue but record the breach in the run log.",
+          "default": "halt"
+        }
+      }
+    },
+    "servers": {
+      "type": "array",
+      "description": "Plugin package specifiers (npm package names or file paths) whose tools are loaded and available to steps in this recipe. Loaded once at run start.",
+      "items": {
+        "type": "string"
+      }
     }
   }
 }