patchwork-os 0.2.0-alpha.28 → 0.2.0-alpha.29

package/dist/schemas/recipe.v1.json

@@ -191,6 +191,14 @@
                 "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)"
+              },
               "agent": {
                 "type": "object",
                 "required": [
@@ -265,6 +273,14 @@
                 "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": {
@@ -278,8 +294,17 @@
           },
           {
             "type": "object",
-            "required": [
-              "recipe"
+            "anyOf": [
+              {
+                "required": [
+                  "recipe"
+                ]
+              },
+              {
+                "required": [
+                  "chain"
+                ]
+              }
             ],
             "properties": {
               "id": {
@@ -314,10 +339,22 @@
                 "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",
@@ -330,6 +367,244 @@
                 "description": "Output key for the nested recipe result"
               }
             }
+          },
+          {
+            "type": "object",
+            "required": [
+              "parallel"
+            ],
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Optional group id — used as awaits target by later steps"
+              },
+              "awaits": {
+                "type": "array",
+                "description": "Step IDs that must complete before this group starts",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "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": "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)"
+                        },
+                        "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"
+                            }
+                          }
+                        }
+                      }
+                    },
+                    {
+                      "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)"
+                        },
+                        "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)"
+                        },
+                        "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"
+                        }
+                      }
+                    }
+                  ]
+                }
+              }
+            }
           }
         ]
       }
@@ -381,9 +656,14 @@
       "properties": {
         "retry": {
           "type": "number",
-          "description": "Number of retries",
+          "description": "Number of retries per failing step (overridden by step.retry)",
           "default": 0
         },
+        "retryDelay": {
+          "type": "number",
+          "description": "Milliseconds between retries (overridden by step.retryDelay)",
+          "default": 1000
+        },
         "fallback": {
           "type": "string",
           "enum": [
@@ -391,11 +671,11 @@
             "abort",
             "deliver_original"
           ],
-          "description": "Fallback action on error"
+          "description": "log_only / deliver_original: treat step failure as non-fatal (like optional); fail-open. abort (default): propagate failure."
         },
         "notify": {
           "type": "boolean",
-          "description": "Whether to notify on error",
+          "description": "Reserved. yamlRunner currently posts Slack notifications on any step failure when slack is connected; gating on this flag is not yet wired.",
           "default": true
         }
       }

package/dist/server.d.ts

@@ -59,6 +59,17 @@ export declare class Server extends EventEmitter<ServerEvents> {
     }) | null;
     /** Patchwork: set by bridge to list installed recipes for the dashboard. */
     recipesFn: (() => Record<string, unknown>) | null;
+    /** Patchwork: set by bridge to load raw recipe source content by name. */
+    loadRecipeContentFn: ((name: string) => {
+        content: string;
+        path: string;
+    } | null) | null;
+    /** Patchwork: set by bridge to save raw recipe source content by name. */
+    saveRecipeContentFn: ((name: string, content: string) => {
+        ok: boolean;
+        path?: string;
+        error?: string;
+    }) | null;
     /** Patchwork: set by bridge to save a new recipe draft to disk. */
     saveRecipeFn: ((draft: RecipeDraft) => {
         ok: boolean;

package/dist/server.js

@@ -3,7 +3,8 @@ import http from "node:http";
 import os from "node:os";
 import path from "node:path";
 import { WebSocket, WebSocketServer as WsServer } from "ws";
-import { routeApprovalRequest } from "./approvalHttp.js";
+import { computeSummary as computeActivationSummary, loadMetrics as loadActivationMetrics, } from "./activationMetrics.js";
+import { handleApprovalsStream, routeApprovalRequest } from "./approvalHttp.js";
 import { getApprovalQueue } from "./approvalQueue.js";
 import { saveBridgeConfigDriver } from "./config.js";
 import { timingSafeStringEqual } from "./crypto.js";
@@ -90,6 +91,10 @@ export class Server extends EventEmitter {
     tasksFn = null;
     /** Patchwork: set by bridge to list installed recipes for the dashboard. */
     recipesFn = null;
+    /** Patchwork: set by bridge to load raw recipe source content by name. */
+    loadRecipeContentFn = null;
+    /** Patchwork: set by bridge to save raw recipe source content by name. */
+    saveRecipeContentFn = null;
     /** Patchwork: set by bridge to save a new recipe draft to disk. */
     saveRecipeFn = null;
     /** Patchwork: set by bridge to query the recipe run audit log. */
@@ -1511,6 +1516,22 @@ export class Server extends EventEmitter {
                 });
                 return;
             }
+            if (parsedUrl.pathname === "/activation-metrics" &&
+                req.method === "GET") {
+                try {
+                    const metrics = loadActivationMetrics();
+                    const summary = computeActivationSummary(metrics);
+                    res.writeHead(200, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify({ metrics, summary }));
+                }
+                catch (err) {
+                    res.writeHead(500, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify({
+                        error: err instanceof Error ? err.message : String(err),
+                    }));
+                }
+                return;
+            }
             if (parsedUrl.pathname === "/runs" && req.method === "GET") {
                 try {
                     const sp = parsedUrl.searchParams;
@@ -1662,6 +1683,60 @@ export class Server extends EventEmitter {
                 });
                 return;
             }
+            const recipeContentMatch = /^\/recipes\/([^/]+)$/.exec(parsedUrl.pathname);
+            if (recipeContentMatch && req.method === "GET") {
+                const name = decodeURIComponent(recipeContentMatch[1]);
+                if (!this.loadRecipeContentFn) {
+                    res.writeHead(503, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify({ ok: false, error: "Recipe content unavailable" }));
+                    return;
+                }
+                const result = this.loadRecipeContentFn(name);
+                if (!result) {
+                    res.writeHead(404, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify({ ok: false, error: "Recipe not found" }));
+                    return;
+                }
+                res.writeHead(200, { "Content-Type": "application/json" });
+                res.end(JSON.stringify(result));
+                return;
+            }
+            if (recipeContentMatch && req.method === "PUT") {
+                const name = decodeURIComponent(recipeContentMatch[1]);
+                const chunks = [];
+                req.on("data", (c) => chunks.push(c));
+                req.on("end", () => {
+                    try {
+                        const body = JSON.parse(Buffer.concat(chunks).toString("utf-8"));
+                        if (typeof body.content !== "string") {
+                            res.writeHead(400, { "Content-Type": "application/json" });
+                            res.end(JSON.stringify({
+                                ok: false,
+                                error: "content (string) required",
+                            }));
+                            return;
+                        }
+                        if (!this.saveRecipeContentFn) {
+                            res.writeHead(503, { "Content-Type": "application/json" });
+                            res.end(JSON.stringify({
+                                ok: false,
+                                error: "Recipe content saving unavailable",
+                            }));
+                            return;
+                        }
+                        const result = this.saveRecipeContentFn(name, body.content);
+                        res.writeHead(result.ok ? 200 : 400, {
+                            "Content-Type": "application/json",
+                        });
+                        res.end(JSON.stringify(result));
+                    }
+                    catch {
+                        res.writeHead(400, { "Content-Type": "application/json" });
+                        res.end(JSON.stringify({ ok: false, error: "Invalid JSON body" }));
+                    }
+                });
+                return;
+            }
             if (req.url === "/recipes" && req.method === "GET") {
                 try {
                     const data = this.recipesFn?.() ?? { recipesDir: null, recipes: [] };
@@ -1777,6 +1852,29 @@ export class Server extends EventEmitter {
                             cfg.driver = driver;
                             saveBridgeConfigDriver(driver, this.bridgeConfigPath);
                         }
+                        if (body.model !== undefined) {
+                            const validModels = [
+                                "claude",
+                                "openai",
+                                "gemini",
+                                "grok",
+                                "local",
+                            ];
+                            if (!validModels.includes(body.model)) {
+                                res.writeHead(400, { "Content-Type": "application/json" });
+                                res.end(JSON.stringify({
+                                    error: `model must be one of: ${validModels.join(", ")}`,
+                                }));
+                                return;
+                            }
+                            cfg.model = body.model;
+                            if (body.model === "local") {
+                                if (body.localEndpoint !== undefined)
+                                    cfg.localEndpoint = body.localEndpoint.trim() || undefined;
+                                if (body.localModel !== undefined)
+                                    cfg.localModel = body.localModel.trim() || undefined;
+                            }
+                        }
                         if (body.apiKey) {
                             const { provider, key } = body.apiKey;
                             const validProviders = ["anthropic", "openai", "google", "xai"];
@@ -1808,7 +1906,9 @@ export class Server extends EventEmitter {
                             this.pushServiceBaseUrl =
                                 body.pushServiceBaseUrl.trim() || undefined;
                         }
-                        const restartRequired = driverRaw !== undefined || body.apiKey !== undefined;
+                        const restartRequired = driverRaw !== undefined ||
+                            body.apiKey !== undefined ||
+                            body.model !== undefined;
                         res.writeHead(200, { "Content-Type": "application/json" });
                         res.end(JSON.stringify({ ok: true, restartRequired }));
                     }
@@ -1874,6 +1974,11 @@ export class Server extends EventEmitter {
                 }
                 return;
             }
+            // SSE stream for live approval queue updates.
+            if (parsedUrl.pathname === "/approvals/stream" && req.method === "GET") {
+                handleApprovalsStream(res, { queue: getApprovalQueue() }, parsedUrl.searchParams.get("session"));
+                return;
+            }
             // Patchwork approval surface — PreToolUse hook + dashboard approve/reject.
             // Bearer auth already checked above.
             if (parsedUrl.pathname === "/approvals" ||