patchwork-os 0.2.0-beta.10.canary.98 → 0.2.0-beta.11

package/dist/schemas/recipe.v1.json

@@ -87,7 +87,63 @@
         },
         "filter": {
           "type": "string",
-          "description": "File filter pattern (for file_watch trigger)"
+          "description": "File filter pattern (for file_watch trigger). For on_test_run triggers, one of: any | failure | pass-after-fail."
+        },
+        "vars": {
+          "type": "array",
+          "description": "Declared input variables resolvable as {{name}} in steps. Place declared variables here (NOT at recipe root — top-level vars are ignored at runtime).",
+          "items": {
+            "type": "object",
+            "required": [
+              "name"
+            ],
+            "properties": {
+              "name": {
+                "type": "string",
+                "pattern": "^[A-Za-z_][A-Za-z0-9_]{0,63}$",
+                "description": "Variable name (letter/underscore start; letters, digits, underscores; max 64 chars)."
+              },
+              "required": {
+                "type": "boolean",
+                "description": "Whether the variable must be supplied."
+              },
+              "default": {
+                "description": "Default value when not supplied."
+              },
+              "description": {
+                "type": "string",
+                "description": "Human-readable description of the variable."
+              }
+            }
+          }
+        },
+        "inputs": {
+          "type": "array",
+          "description": "Alias for trigger.vars — declared input variables resolvable as {{name}} in steps.",
+          "items": {
+            "type": "object",
+            "required": [
+              "name"
+            ],
+            "properties": {
+              "name": {
+                "type": "string",
+                "pattern": "^[A-Za-z_][A-Za-z0-9_]{0,63}$",
+                "description": "Variable name (letter/underscore start; letters, digits, underscores; max 64 chars)."
+              },
+              "required": {
+                "type": "boolean",
+                "description": "Whether the variable must be supplied."
+              },
+              "default": {
+                "description": "Default value when not supplied."
+              },
+              "description": {
+                "type": "string",
+                "description": "Human-readable description of the variable."
+              }
+            }
+          }
         },
         "eventSource": {
           "type": "string",
@@ -285,6 +341,50 @@
                       "judge"
                     ],
                     "description": "When set to 'judge', the agent step emits a structured verdictReason and stores the verdict in the run log."
+                  },
+                  "reviews": {
+                    "type": "string",
+                    "description": "Step output key the judge reviews (its `into`, default 'agent_output'). Required for the judge→refine loop."
+                  },
+                  "max_revisions": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "description": "OPT-IN judge→refine loop. Max revise→re-judge cycles when the verdict is 'request_changes' (0/absent = augment-only, no loop). Requires kind:judge + reviews."
+                  },
+                  "on_exhausted": {
+                    "type": "string",
+                    "enum": [
+                      "halt",
+                      "proceed"
+                    ],
+                    "description": "When the revision budget is exhausted and the judge still requests changes: 'halt' (default) fails the run; 'proceed' continues with the last draft."
+                  },
+                  "downshift": {
+                    "type": "array",
+                    "description": "OPT-IN cost-aware routing (Phase 4). Ordered cheaper fallbacks tried when budget.usdMax is set and the remaining budget is too tight for the preferred driver/model. Each entry overrides driver and/or model. Absent → preferred model always used.",
+                    "items": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "minProperties": 1,
+                      "properties": {
+                        "driver": {
+                          "type": "string",
+                          "enum": [
+                            "claude",
+                            "claude-code",
+                            "api",
+                            "openai",
+                            "grok",
+                            "gemini",
+                            "anthropic",
+                            "local"
+                          ]
+                        },
+                        "model": {
+                          "type": "string"
+                        }
+                      }
+                    }
                   }
                 }
               }
@@ -631,10 +731,12 @@
                               "description": "Agent step configuration",
                               "properties": {
                                 "prompt": {
-                                  "type": "string"
+                                  "type": "string",
+                                  "description": "Prompt to send to the AI (supports {{templates}})"
                                 },
                                 "model": {
-                                  "type": "string"
+                                  "type": "string",
+                                  "description": "Model to use for the agent step"
                                 },
                                 "driver": {
                                   "type": "string",
@@ -646,10 +748,12 @@
                                     "grok",
                                     "gemini",
                                     "anthropic"
-                                  ]
+                                  ],
+                                  "description": "Driver for agent execution"
                                 },
                                 "into": {
-                                  "type": "string"
+                                  "type": "string",
+                                  "description": "Variable name to store output in context"
                                 },
                                 "mcpAccess": {
                                   "type": "boolean",
@@ -661,6 +765,50 @@
                                     "judge"
                                   ],
                                   "description": "When set to 'judge', the agent step emits a structured verdictReason and stores the verdict in the run log."
+                                },
+                                "reviews": {
+                                  "type": "string",
+                                  "description": "Step output key the judge reviews (its `into`, default 'agent_output'). Required for the judge→refine loop."
+                                },
+                                "max_revisions": {
+                                  "type": "integer",
+                                  "minimum": 0,
+                                  "description": "OPT-IN judge→refine loop. Max revise→re-judge cycles when the verdict is 'request_changes' (0/absent = augment-only, no loop). Requires kind:judge + reviews."
+                                },
+                                "on_exhausted": {
+                                  "type": "string",
+                                  "enum": [
+                                    "halt",
+                                    "proceed"
+                                  ],
+                                  "description": "When the revision budget is exhausted and the judge still requests changes: 'halt' (default) fails the run; 'proceed' continues with the last draft."
+                                },
+                                "downshift": {
+                                  "type": "array",
+                                  "description": "OPT-IN cost-aware routing (Phase 4). Ordered cheaper fallbacks tried when budget.usdMax is set and the remaining budget is too tight for the preferred driver/model. Each entry overrides driver and/or model. Absent → preferred model always used.",
+                                  "items": {
+                                    "type": "object",
+                                    "additionalProperties": false,
+                                    "minProperties": 1,
+                                    "properties": {
+                                      "driver": {
+                                        "type": "string",
+                                        "enum": [
+                                          "claude",
+                                          "claude-code",
+                                          "api",
+                                          "openai",
+                                          "grok",
+                                          "gemini",
+                                          "anthropic",
+                                          "local"
+                                        ]
+                                      },
+                                      "model": {
+                                        "type": "string"
+                                      }
+                                    }
+                                  }
                                 }
                               }
                             }
@@ -1006,10 +1154,12 @@
                                   "description": "Agent step configuration",
                                   "properties": {
                                     "prompt": {
-                                      "type": "string"
+                                      "type": "string",
+                                      "description": "Prompt to send to the AI (supports {{templates}})"
                                     },
                                     "model": {
-                                      "type": "string"
+                                      "type": "string",
+                                      "description": "Model to use for the agent step"
                                     },
                                     "driver": {
                                       "type": "string",
@@ -1021,10 +1171,12 @@
                                         "grok",
                                         "gemini",
                                         "anthropic"
-                                      ]
+                                      ],
+                                      "description": "Driver for agent execution"
                                     },
                                     "into": {
-                                      "type": "string"
+                                      "type": "string",
+                                      "description": "Variable name to store output in context"
                                     },
                                     "mcpAccess": {
                                       "type": "boolean",
@@ -1036,6 +1188,50 @@
                                         "judge"
                                       ],
                                       "description": "When set to 'judge', the agent step emits a structured verdictReason and stores the verdict in the run log."
+                                    },
+                                    "reviews": {
+                                      "type": "string",
+                                      "description": "Step output key the judge reviews (its `into`, default 'agent_output'). Required for the judge→refine loop."
+                                    },
+                                    "max_revisions": {
+                                      "type": "integer",
+                                      "minimum": 0,
+                                      "description": "OPT-IN judge→refine loop. Max revise→re-judge cycles when the verdict is 'request_changes' (0/absent = augment-only, no loop). Requires kind:judge + reviews."
+                                    },
+                                    "on_exhausted": {
+                                      "type": "string",
+                                      "enum": [
+                                        "halt",
+                                        "proceed"
+                                      ],
+                                      "description": "When the revision budget is exhausted and the judge still requests changes: 'halt' (default) fails the run; 'proceed' continues with the last draft."
+                                    },
+                                    "downshift": {
+                                      "type": "array",
+                                      "description": "OPT-IN cost-aware routing (Phase 4). Ordered cheaper fallbacks tried when budget.usdMax is set and the remaining budget is too tight for the preferred driver/model. Each entry overrides driver and/or model. Absent → preferred model always used.",
+                                      "items": {
+                                        "type": "object",
+                                        "additionalProperties": false,
+                                        "minProperties": 1,
+                                        "properties": {
+                                          "driver": {
+                                            "type": "string",
+                                            "enum": [
+                                              "claude",
+                                              "claude-code",
+                                              "api",
+                                              "openai",
+                                              "grok",
+                                              "gemini",
+                                              "anthropic",
+                                              "local"
+                                            ]
+                                          },
+                                          "model": {
+                                            "type": "string"
+                                          }
+                                        }
+                                      }
                                     }
                                   }
                                 }
@@ -1345,19 +1541,29 @@
     },
     "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.",
+      "description": "Per-recipe budget. Set tokensMax and/or usdMax; on breach the run halts with budget_exceeded (or warns). Enforced for API drivers that report token usage and (for usdMax) have a price-table entry; subscription drivers (Claude CLI) report no tokens and are skipped (fail-open with a one-time warning).",
       "properties": {
         "tokensMax": {
           "type": "number",
+          "exclusiveMinimum": 0,
           "description": "Cumulative input + output tokens allowed across the whole run"
         },
+        "usdMax": {
+          "type": "number",
+          "exclusiveMinimum": 0,
+          "description": "Cumulative USD allowed across the whole run, priced from token usage via the model price table. Unpriced models / subscription drivers fail open (never halt on them)."
+        },
+        "estimateUnmeasured": {
+          "type": "boolean",
+          "description": "OPT-IN (default false). Estimate the notional list-price USD an unmeasured/subscription call would have cost and surface a ≈$ figure. Label only — never counted toward usdMax, never halts. Requires usdMax."
+        },
         "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.",
+          "description": "halt (default): stop run on next admission check. warn: continue but record the breach in the run log. Applies to both tokensMax and usdMax.",
           "default": "halt"
         }
       }

package/dist/server.d.ts

@@ -183,6 +183,9 @@ export declare class Server extends EventEmitter<ServerEvents> {
     }) => import("./recipes/judgeSummary.js").JudgeSummary) | null;
     /** Patchwork: set by bridge to generate a dry-run plan for a recipe by name. */
     runPlanFn: ((recipeName: string) => Promise<Record<string, unknown>>) | null;
+    /** Patchwork: set by bridge to generate a What-If Preview simulation for a
+     *  recipe by name (static counterfactual; superset of the dry-run plan). */
+    simulateFn: ((recipeName: string) => Promise<Record<string, unknown>>) | null;
     /** Patchwork (VD-4): mocked replay of an existing run. Returns the new
      *  run's seq plus any unmocked steps the caller may want to surface. */
     runReplayFn: ((seq: number) => Promise<{

package/dist/server.js

@@ -141,6 +141,9 @@ export class Server extends EventEmitter {
     judgeSummaryFn = null;
     /** Patchwork: set by bridge to generate a dry-run plan for a recipe by name. */
     runPlanFn = null;
+    /** Patchwork: set by bridge to generate a What-If Preview simulation for a
+     *  recipe by name (static counterfactual; superset of the dry-run plan). */
+    simulateFn = null;
     /** Patchwork (VD-4): mocked replay of an existing run. Returns the new
      *  run's seq plus any unmocked steps the caller may want to surface. */
     runReplayFn = null;
@@ -1163,6 +1166,7 @@ export class Server extends EventEmitter {
                 haltSummaryFn: this.haltSummaryFn,
                 judgeSummaryFn: this.judgeSummaryFn,
                 runPlanFn: this.runPlanFn,
+                simulateFn: this.simulateFn,
                 runReplayFn: this.runReplayFn,
                 runRecipeFn: this.runRecipeFn,
                 onRecipesChangedFn: this.onRecipesChangedFn,