@voyantjs/workflows-orchestrator-cloudflare 0.38.0 → 0.39.0

package/README.md

@@ -65,6 +65,7 @@ export class WorkflowRunDO implements DurableObject {
 |---|---|
 | `POST /api/runs` | Trigger a new run. Body: `{ workflowId, workflowVersion, input, tenantMeta, runId? }`. |
 | `GET  /api/runs/:id` | Fetch the current `RunRecord`. |
+| `POST /api/runs/:id/resume` | Start a new run from a failed parent run. Body: `{ input?, workflowId?, resumeFromStep?, seedResults?, runId?, tags?, triggeredByUserId? }`. |
 | `POST /api/runs/:id/events` | Inject an `EVENT` waitpoint resolution. |
 | `POST /api/runs/:id/signals` | Inject a `SIGNAL` waitpoint resolution. |
 | `POST /api/runs/:id/tokens/:tokenId` | Inject a `MANUAL` (token) waitpoint resolution. |
@@ -73,6 +74,10 @@ export class WorkflowRunDO implements DurableObject {
 Injection bodies are `{ eventType, payload? }` / `{ name, payload? }`
 / `{ payload? }` respectively.
 
+If the parent id on `/api/runs/:id/resume` is not stored in this
+orchestrator, pass `workflowId`, `resumeFromStep`, and `seedResults`
+to resume from an external workflow-runs parent.
+
 ## Durable Object model
 
 One DO per run, keyed by `idFromName(runId)`. The DO's transactional

package/dist/durable-object.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"durable-object.d.ts","sourceRoot":"","sources":["../src/durable-object.ts"],"names":[],"mappings":"AAmBA,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAKhB,KAAK,SAAS,EAEf,MAAM,kCAAkC,CAAA;AAEzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEtD,OAAO,KAAK,EAGV,wBAAwB,EAGzB,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AAE7D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,wBAAwB,CAAA;IACjC;;;;;;;;;;;OAWG;IACH,UAAU,EAAE,cAAc,CAAA;IAC1B,aAAa,CAAC,EAAE,0BAA0B,CAAA;IAC1C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACnB;AAcD,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,QAAQ,CAAC,CA+EnB;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyCrF;AAyFD,YAAY,EAAE,SAAS,EAAE,CAAA;AAEzB,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,CAAA"}
+{"version":3,"file":"durable-object.d.ts","sourceRoot":"","sources":["../src/durable-object.ts"],"names":[],"mappings":"AAmBA,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAKhB,KAAK,SAAS,EAEf,MAAM,kCAAkC,CAAA;AAEzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEtD,OAAO,KAAK,EAGV,wBAAwB,EAGzB,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AAE7D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,wBAAwB,CAAA;IACjC;;;;;;;;;;;OAWG;IACH,UAAU,EAAE,cAAc,CAAA;IAC1B,aAAa,CAAC,EAAE,0BAA0B,CAAA;IAC1C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACnB;AAcD,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,QAAQ,CAAC,CAkFnB;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyCrF;AAyFD,YAAY,EAAE,SAAS,EAAE,CAAA;AAEzB,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,CAAA"}

package/dist/durable-object.js

@@ -51,6 +51,9 @@ export async function handleDurableObjectRequest(req, deps) {
                 ? new Date(payload.delay.wakeAt)
                 : payload.delay,
             priority: payload.priority,
+            initialJournal: payload.initialJournal,
+            initialMetadataAppliedCount: payload.initialMetadataAppliedCount,
+            timeoutMs: payload.timeoutMs,
         }, { store, handler, now: deps.now });
         await reconcileAlarm(record, store, deps);
         return json(200, record);

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 import type { Duration, EnvironmentName, RunTrigger } from "@voyantjs/workflows";
-import type { WaitpointInjection } from "@voyantjs/workflows-orchestrator";
+import type { JournalSlice, WaitpointInjection } from "@voyantjs/workflows-orchestrator";
 /**
  * Subset of Cloudflare's `DurableObjectStorage` we actually use.
  * Keyed JSON blobs; no transactional guarantees beyond what a single
@@ -59,6 +59,17 @@ export interface TriggerPayload {
     };
     priority?: number;
     triggeredBy?: RunTrigger;
+    /**
+     * Optional journal seed for failed-step resume / replay flows.
+     * Steps already present in the journal are replayed from their
+     * stored results, so the workflow starts doing new work at the
+     * first unseeded step.
+     */
+    initialJournal?: JournalSlice;
+    /** Cursor paired with `initialJournal.metadataState` for resume replay dedupe. */
+    initialMetadataAppliedCount?: number;
+    /** Compute-time budget in ms; copied from parent runs during resume. */
+    timeoutMs?: number;
     concurrencyLease?: ConcurrencyLease;
 }
 export interface ConcurrencyLease {

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AAE1E;;;;;;;;;GASG;AACH,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;IAC3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACrC,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAA;IAC/E,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACnC,4DAA4D;IAC5D,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,gCAAgC;IAChC,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9B;AAED,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAA;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,kBAAkB,CAAA;CAC9B;AAED,uBAAuB;AACvB,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;IACvB,KAAK,EAAE,OAAO,CAAA;IACd,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,MAAM,CAAA;QACjB,cAAc,EAAE,MAAM,CAAA;QACtB;;;;WAIG;QACH,YAAY,CAAC,EAAE,MAAM,CAAA;KACtB,CAAA;IACD,WAAW,CAAC,EAAE,YAAY,GAAG,SAAS,GAAG,aAAa,CAAA;IACtD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,KAAK,CAAC,EAAE,QAAQ,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,UAAU,CAAA;IACxB,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,eAAe,CAAA;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACd;AAED,sBAAsB;AACtB,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU,CAAC,WAAW,GAAG,OAAO;IAC/C,8FAA8F;IAC9F,eAAe,EAAE,WAAW,CAAA;CAC7B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AAExF;;;;;;;;;GASG;AACH,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;IAC3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACrC,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAA;IAC/E,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACnC,4DAA4D;IAC5D,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,gCAAgC;IAChC,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9B;AAED,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAA;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,kBAAkB,CAAA;CAC9B;AAED,uBAAuB;AACvB,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;IACvB,KAAK,EAAE,OAAO,CAAA;IACd,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,MAAM,CAAA;QACjB,cAAc,EAAE,MAAM,CAAA;QACtB;;;;WAIG;QACH,YAAY,CAAC,EAAE,MAAM,CAAA;KACtB,CAAA;IACD,WAAW,CAAC,EAAE,YAAY,GAAG,SAAS,GAAG,aAAa,CAAA;IACtD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,KAAK,CAAC,EAAE,QAAQ,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,UAAU,CAAA;IACxB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,YAAY,CAAA;IAC7B,kFAAkF;IAClF,2BAA2B,CAAC,EAAE,MAAM,CAAA;IACpC,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,eAAe,CAAA;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACd;AAED,sBAAsB;AACtB,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU,CAAC,WAAW,GAAG,OAAO;IAC/C,8FAA8F;IAC9F,eAAe,EAAE,WAAW,CAAA;CAC7B"}

package/dist/worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAE7D;;;;GAIG;AACH,MAAM,WAAW,0BAA0B,CAAC,EAAE,GAAG,OAAO;IACtD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,EAAE,CAAA;IAC5B,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG;QAAE,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;KAAE,CAAA;CACxD;AAED,MAAM,WAAW,eAAe,CAAC,EAAE,GAAG,OAAO;IAC3C,KAAK,EAAE,0BAA0B,CAAC,EAAE,CAAC,CAAA;IACrC;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD,uBAAuB;IACvB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/E,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,MAAM,CAAA;IAC1B,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB;;;;OAIG;IACH,aAAa,CAAC,EAAE,eAAe,CAAA;IAC/B;;;;;OAKG;IACH,UAAU,CAAC,EAAE;QACX,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,MAAM,CAAA;QACjB,cAAc,EAAE,MAAM,CAAA;QACtB,YAAY,CAAC,EAAE,MAAM,CAAA;KACtB,CAAA;CACF;AAED,wBAAsB,mBAAmB,CAAC,EAAE,EAC1C,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,eAAe,CAAC,EAAE,CAAC,GACxB,OAAO,CAAC,QAAQ,CAAC,CAuHnB"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAQ7D;;;;GAIG;AACH,MAAM,WAAW,0BAA0B,CAAC,EAAE,GAAG,OAAO;IACtD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,EAAE,CAAA;IAC5B,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG;QAAE,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;KAAE,CAAA;CACxD;AAED,MAAM,WAAW,eAAe,CAAC,EAAE,GAAG,OAAO;IAC3C,KAAK,EAAE,0BAA0B,CAAC,EAAE,CAAC,CAAA;IACrC;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD,uBAAuB;IACvB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/E,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,MAAM,CAAA;IAC1B,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB;;;;OAIG;IACH,aAAa,CAAC,EAAE,eAAe,CAAA;IAC/B;;;;;OAKG;IACH,UAAU,CAAC,EAAE;QACX,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,MAAM,CAAA;QACjB,cAAc,EAAE,MAAM,CAAA;QACtB,YAAY,CAAC,EAAE,MAAM,CAAA;KACtB,CAAA;CACF;AAED,wBAAsB,mBAAmB,CAAC,EAAE,EAC1C,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,eAAe,CAAC,EAAE,CAAC,GACxB,OAAO,CAAC,QAAQ,CAAC,CAoMnB"}

package/dist/worker.js

@@ -6,12 +6,19 @@
 // Routes (all JSON bodies):
 //   POST /api/runs                     → trigger a run
 //   GET  /api/runs/:id                 → fetch a run
+//   POST /api/runs/:id/resume          → start a new run from a failed parent step
 //   POST /api/runs/:id/signals         → inject a SIGNAL waitpoint
 //   POST /api/runs/:id/events          → inject an EVENT waitpoint
 //   POST /api/runs/:id/tokens/:token   → inject a MANUAL (token) waitpoint
 //   POST /api/runs/:id/cancel          → cancel a run
+import { buildResumeJournal, buildSeededResumeJournal, } from "@voyantjs/workflows-orchestrator";
 import { handleIngestEvent } from "./event-handler.js";
 import { handleGetManifest, handleRegisterManifest } from "./manifest-handler.js";
+const DEFAULT_TENANT_META = {
+    tenantId: "default",
+    projectId: "default",
+    organizationId: "default",
+};
 export async function handleWorkerRequest(req, deps) {
     const url = new URL(req.url);
     if (req.method === "OPTIONS") {
@@ -79,10 +86,11 @@ export async function handleWorkerRequest(req, deps) {
             return json(400, { error: "invalid_json", message: errMsg(err) });
         }
         const runId = typeof payload.runId === "string" ? payload.runId : defaultRunId(deps);
+        const publicPayload = sanitizePublicTriggerPayload(payload);
         const forward = new Request(`https://do-internal/trigger`, {
             method: "POST",
             headers: { "content-type": "application/json" },
-            body: JSON.stringify({ ...payload, runId }),
+            body: JSON.stringify({ ...publicPayload, runId }),
         });
         return forwardToRunDO(runId, forward, deps);
     }
@@ -107,6 +115,76 @@ export async function handleWorkerRequest(req, deps) {
             body: JSON.stringify(body),
         }), deps);
     }
+    if (req.method === "POST" && tail === "/resume") {
+        const body = await safeJson(req);
+        if (isErrorBody(body))
+            return json(400, body);
+        const parsed = parseResumeRunBody(body);
+        if ("error" in parsed)
+            return json(400, parsed);
+        const parent = await fetchRunRecord(runId, deps);
+        if ("error" in parent)
+            return parent.error;
+        const workflowId = parsed.body.workflowId ?? parent.record?.workflowId;
+        if (!workflowId) {
+            return json(404, {
+                error: "resume_failed",
+                message: `parent run "${runId}" not found; pass workflowId, resumeFromStep, ` +
+                    "and seedResults to resume from an external workflow-runs parent",
+            });
+        }
+        let resumeSeed;
+        try {
+            resumeSeed = parent.record
+                ? buildResumeJournal({
+                    parent: parent.record,
+                    resumeFromStep: parsed.body.resumeFromStep,
+                    seedResults: parsed.body.seedResults,
+                    now: deps.now,
+                })
+                : buildSeededResumeJournal({
+                    parentRunId: runId,
+                    resumeFromStep: requireExternalResumeFromStep(parsed.body.resumeFromStep),
+                    seedResults: requireExternalSeedResults(parsed.body.seedResults),
+                    now: deps.now,
+                });
+        }
+        catch (err) {
+            return json(400, { error: "resume_failed", message: errMsg(err) });
+        }
+        const nextRunId = parsed.body.runId ?? defaultRunId(deps);
+        const triggerRes = await forwardToRunDO(nextRunId, new Request("https://do-internal/trigger", {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({
+                workflowId,
+                workflowVersion: parent.record?.workflowVersion ?? "local",
+                input: parsed.body.hasInput ? parsed.body.input : parent.record?.input,
+                tenantMeta: parent.record?.tenantMeta ?? deps.tenantMeta ?? DEFAULT_TENANT_META,
+                environment: parent.record?.environment,
+                tags: mergeTags(parent.record?.tags, [
+                    "resume:true",
+                    `parentRunId:${parent.record?.id ?? runId}`,
+                    ...(parsed.body.tags ?? []),
+                ]),
+                runId: nextRunId,
+                triggeredBy: parsed.body.triggeredByUserId === undefined || parsed.body.triggeredByUserId === null
+                    ? { kind: "api" }
+                    : { kind: "api", actor: parsed.body.triggeredByUserId },
+                timeoutMs: parent.record?.timeoutMs,
+                initialJournal: resumeSeed.journal,
+                initialMetadataAppliedCount: resumeSeed.metadataAppliedCount,
+            }),
+        }), deps);
+        if (!triggerRes.ok)
+            return triggerRes;
+        const saved = (await triggerRes.json());
+        return json(200, {
+            saved,
+            parentRunId: parent.record?.id ?? runId,
+            resumeFromStep: resumeSeed.resumeFromStep,
+        });
+    }
     // Waitpoint injections: events, signals, tokens.
     const body = await safeJson(req);
     if (isErrorBody(body))
@@ -150,6 +228,55 @@ function parseInjection(tail, body) {
     }
     return { error: "route_not_found", message: `unknown path suffix ${tail}` };
 }
+function parseResumeRunBody(body) {
+    if (!isPlainObject(body)) {
+        return { error: "invalid_body", message: "request body must be an object" };
+    }
+    if (body.resumeFromStep !== undefined && typeof body.resumeFromStep !== "string") {
+        return { error: "invalid_body", message: "`resumeFromStep` must be a string when provided" };
+    }
+    if (body.workflowId !== undefined && typeof body.workflowId !== "string") {
+        return { error: "invalid_body", message: "`workflowId` must be a string when provided" };
+    }
+    if (body.runId !== undefined && typeof body.runId !== "string") {
+        return { error: "invalid_body", message: "`runId` must be a string when provided" };
+    }
+    if (body.triggeredByUserId !== undefined &&
+        body.triggeredByUserId !== null &&
+        typeof body.triggeredByUserId !== "string") {
+        return {
+            error: "invalid_body",
+            message: "`triggeredByUserId` must be a string or null when provided",
+        };
+    }
+    if (body.tags !== undefined && !isStringArray(body.tags)) {
+        return { error: "invalid_body", message: "`tags` must be an array of strings when provided" };
+    }
+    if (body.seedResults !== undefined && !isPlainObject(body.seedResults)) {
+        return { error: "invalid_body", message: "`seedResults` must be an object when provided" };
+    }
+    return {
+        body: {
+            hasInput: Object.hasOwn(body, "input"),
+            input: body.input,
+            workflowId: body.workflowId,
+            resumeFromStep: body.resumeFromStep,
+            seedResults: body.seedResults,
+            runId: body.runId,
+            tags: body.tags,
+            triggeredByUserId: body.triggeredByUserId,
+        },
+    };
+}
+async function fetchRunRecord(runId, deps) {
+    const res = await forwardToRunDO(runId, new Request("https://do-internal/get", { method: "GET" }), deps);
+    if (res.status === 404) {
+        return {};
+    }
+    if (!res.ok)
+        return { error: res };
+    return { record: (await res.json()) };
+}
 async function forwardToRunDO(runId, req, deps) {
     const id = deps.runDO.idFromName(runId);
     const stub = deps.runDO.get(id);
@@ -179,12 +306,42 @@ async function safeJson(req) {
     if (text.length === 0)
         return {};
     try {
-        return JSON.parse(text);
+        const parsed = JSON.parse(text);
+        if (!isPlainObject(parsed)) {
+            return { error: "invalid_body", message: "request body must be an object" };
+        }
+        return parsed;
     }
     catch (err) {
         return { error: "invalid_json", message: errMsg(err) };
     }
 }
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isStringArray(value) {
+    return Array.isArray(value) && value.every((entry) => typeof entry === "string");
+}
+function mergeTags(...groups) {
+    const tags = new Set();
+    for (const group of groups) {
+        for (const tag of group ?? [])
+            tags.add(tag);
+    }
+    return Array.from(tags);
+}
+function requireExternalResumeFromStep(resumeFromStep) {
+    if (!resumeFromStep) {
+        throw new Error("resumeFromStep is required when the parent run is not stored by this worker");
+    }
+    return resumeFromStep;
+}
+function requireExternalSeedResults(seedResults) {
+    if (!seedResults) {
+        throw new Error("seedResults is required when the parent run is not stored by this worker");
+    }
+    return seedResults;
+}
 function corsHeaders(methods) {
     return {
         "access-control-allow-origin": "*",
@@ -192,6 +349,10 @@ function corsHeaders(methods) {
         "access-control-allow-headers": "content-type, x-voyant-protocol",
     };
 }
+function sanitizePublicTriggerPayload(payload) {
+    const { initialJournal: _initialJournal, initialMetadataAppliedCount: _initialMetadataAppliedCount, timeoutMs: _timeoutMs, ...publicPayload } = payload;
+    return publicPayload;
+}
 function json(status, body) {
     return new Response(JSON.stringify(body), {
         status,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/workflows-orchestrator-cloudflare",
-  "version": "0.38.0",
+  "version": "0.39.0",
   "description": "Cloudflare Worker + Durable Object adapter for @voyantjs/workflows-orchestrator. Dispatches workflow-step requests to tenant Workers via a Workers-for-Platforms dispatch namespace.",
   "license": "Apache-2.0",
   "repository": {
@@ -26,8 +26,8 @@
     "NOTICE"
   ],
   "dependencies": {
-    "@voyantjs/workflows-orchestrator": "0.38.0",
-    "@voyantjs/workflows": "0.38.0"
+    "@voyantjs/workflows-orchestrator": "0.39.0",
+    "@voyantjs/workflows": "0.39.0"
   },
   "devDependencies": {
     "@cloudflare/vitest-pool-workers": "^0.15.1",

package/src/durable-object.ts

@@ -102,6 +102,9 @@ export async function handleDurableObjectRequest(
             ? new Date(payload.delay.wakeAt)
             : payload.delay,
         priority: payload.priority,
+        initialJournal: payload.initialJournal,
+        initialMetadataAppliedCount: payload.initialMetadataAppliedCount,
+        timeoutMs: payload.timeoutMs,
       },
       { store, handler, now: deps.now },
     )

package/src/types.ts

@@ -3,7 +3,7 @@
 // shape is enough, and tests can pass plain objects.
 
 import type { Duration, EnvironmentName, RunTrigger } from "@voyantjs/workflows"
-import type { WaitpointInjection } from "@voyantjs/workflows-orchestrator"
+import type { JournalSlice, WaitpointInjection } from "@voyantjs/workflows-orchestrator"
 
 /**
  * Subset of Cloudflare's `DurableObjectStorage` we actually use.
@@ -62,6 +62,17 @@ export interface TriggerPayload {
   delay?: Duration | { wakeAt: number }
   priority?: number
   triggeredBy?: RunTrigger
+  /**
+   * Optional journal seed for failed-step resume / replay flows.
+   * Steps already present in the journal are replayed from their
+   * stored results, so the workflow starts doing new work at the
+   * first unseeded step.
+   */
+  initialJournal?: JournalSlice
+  /** Cursor paired with `initialJournal.metadataState` for resume replay dedupe. */
+  initialMetadataAppliedCount?: number
+  /** Compute-time budget in ms; copied from parent runs during resume. */
+  timeoutMs?: number
   concurrencyLease?: ConcurrencyLease
 }
 

package/src/worker.ts

@@ -6,17 +6,29 @@
 // Routes (all JSON bodies):
 //   POST /api/runs                     → trigger a run
 //   GET  /api/runs/:id                 → fetch a run
+//   POST /api/runs/:id/resume          → start a new run from a failed parent step
 //   POST /api/runs/:id/signals         → inject a SIGNAL waitpoint
 //   POST /api/runs/:id/events          → inject an EVENT waitpoint
 //   POST /api/runs/:id/tokens/:token   → inject a MANUAL (token) waitpoint
 //   POST /api/runs/:id/cancel          → cancel a run
 
-import type { WaitpointInjection } from "@voyantjs/workflows-orchestrator"
+import {
+  buildResumeJournal,
+  buildSeededResumeJournal,
+  type RunRecord,
+  type WaitpointInjection,
+} from "@voyantjs/workflows-orchestrator"
 
 import { handleIngestEvent } from "./event-handler.js"
 import { handleGetManifest, handleRegisterManifest } from "./manifest-handler.js"
 import type { CfManifestStore } from "./manifest-kv-store.js"
 
+const DEFAULT_TENANT_META = {
+  tenantId: "default",
+  projectId: "default",
+  organizationId: "default",
+}
+
 /**
  * Minimal shape of a DO namespace. `idFromName` returns an opaque id;
  * `get(id)` returns a stub with `fetch` (matching the CF DO API).
@@ -133,10 +145,11 @@ export async function handleWorkerRequest<Id>(
       return json(400, { error: "invalid_json", message: errMsg(err) })
     }
     const runId = typeof payload.runId === "string" ? payload.runId : defaultRunId(deps)
+    const publicPayload = sanitizePublicTriggerPayload(payload)
     const forward = new Request(`https://do-internal/trigger`, {
       method: "POST",
       headers: { "content-type": "application/json" },
-      body: JSON.stringify({ ...payload, runId }),
+      body: JSON.stringify({ ...publicPayload, runId }),
     })
     return forwardToRunDO(runId, forward, deps)
   }
@@ -168,6 +181,82 @@ export async function handleWorkerRequest<Id>(
     )
   }
 
+  if (req.method === "POST" && tail === "/resume") {
+    const body = await safeJson(req)
+    if (isErrorBody(body)) return json(400, body)
+    const parsed = parseResumeRunBody(body)
+    if ("error" in parsed) return json(400, parsed)
+
+    const parent = await fetchRunRecord(runId, deps)
+    if ("error" in parent) return parent.error
+
+    const workflowId = parsed.body.workflowId ?? parent.record?.workflowId
+    if (!workflowId) {
+      return json(404, {
+        error: "resume_failed",
+        message:
+          `parent run "${runId}" not found; pass workflowId, resumeFromStep, ` +
+          "and seedResults to resume from an external workflow-runs parent",
+      })
+    }
+
+    let resumeSeed: ReturnType<typeof buildResumeJournal>
+    try {
+      resumeSeed = parent.record
+        ? buildResumeJournal({
+            parent: parent.record,
+            resumeFromStep: parsed.body.resumeFromStep,
+            seedResults: parsed.body.seedResults,
+            now: deps.now,
+          })
+        : buildSeededResumeJournal({
+            parentRunId: runId,
+            resumeFromStep: requireExternalResumeFromStep(parsed.body.resumeFromStep),
+            seedResults: requireExternalSeedResults(parsed.body.seedResults),
+            now: deps.now,
+          })
+    } catch (err) {
+      return json(400, { error: "resume_failed", message: errMsg(err) })
+    }
+
+    const nextRunId = parsed.body.runId ?? defaultRunId(deps)
+    const triggerRes = await forwardToRunDO(
+      nextRunId,
+      new Request("https://do-internal/trigger", {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({
+          workflowId,
+          workflowVersion: parent.record?.workflowVersion ?? "local",
+          input: parsed.body.hasInput ? parsed.body.input : parent.record?.input,
+          tenantMeta: parent.record?.tenantMeta ?? deps.tenantMeta ?? DEFAULT_TENANT_META,
+          environment: parent.record?.environment,
+          tags: mergeTags(parent.record?.tags, [
+            "resume:true",
+            `parentRunId:${parent.record?.id ?? runId}`,
+            ...(parsed.body.tags ?? []),
+          ]),
+          runId: nextRunId,
+          triggeredBy:
+            parsed.body.triggeredByUserId === undefined || parsed.body.triggeredByUserId === null
+              ? { kind: "api" }
+              : { kind: "api", actor: parsed.body.triggeredByUserId },
+          timeoutMs: parent.record?.timeoutMs,
+          initialJournal: resumeSeed.journal,
+          initialMetadataAppliedCount: resumeSeed.metadataAppliedCount,
+        }),
+      }),
+      deps,
+    )
+    if (!triggerRes.ok) return triggerRes
+    const saved = (await triggerRes.json()) as RunRecord
+    return json(200, {
+      saved,
+      parentRunId: parent.record?.id ?? runId,
+      resumeFromStep: resumeSeed.resumeFromStep,
+    })
+  }
+
   // Waitpoint injections: events, signals, tokens.
   const body = await safeJson(req)
   if (isErrorBody(body)) return json(400, body)
@@ -221,6 +310,78 @@ function parseInjection(
   return { error: "route_not_found", message: `unknown path suffix ${tail}` }
 }
 
+function parseResumeRunBody(body: Record<string, unknown>):
+  | {
+      body: {
+        hasInput: boolean
+        input?: unknown
+        workflowId?: string
+        resumeFromStep?: string
+        seedResults?: Record<string, unknown>
+        runId?: string
+        tags?: string[]
+        triggeredByUserId?: string | null
+      }
+    }
+  | { error: string; message: string } {
+  if (!isPlainObject(body)) {
+    return { error: "invalid_body", message: "request body must be an object" }
+  }
+  if (body.resumeFromStep !== undefined && typeof body.resumeFromStep !== "string") {
+    return { error: "invalid_body", message: "`resumeFromStep` must be a string when provided" }
+  }
+  if (body.workflowId !== undefined && typeof body.workflowId !== "string") {
+    return { error: "invalid_body", message: "`workflowId` must be a string when provided" }
+  }
+  if (body.runId !== undefined && typeof body.runId !== "string") {
+    return { error: "invalid_body", message: "`runId` must be a string when provided" }
+  }
+  if (
+    body.triggeredByUserId !== undefined &&
+    body.triggeredByUserId !== null &&
+    typeof body.triggeredByUserId !== "string"
+  ) {
+    return {
+      error: "invalid_body",
+      message: "`triggeredByUserId` must be a string or null when provided",
+    }
+  }
+  if (body.tags !== undefined && !isStringArray(body.tags)) {
+    return { error: "invalid_body", message: "`tags` must be an array of strings when provided" }
+  }
+  if (body.seedResults !== undefined && !isPlainObject(body.seedResults)) {
+    return { error: "invalid_body", message: "`seedResults` must be an object when provided" }
+  }
+  return {
+    body: {
+      hasInput: Object.hasOwn(body, "input"),
+      input: body.input,
+      workflowId: body.workflowId,
+      resumeFromStep: body.resumeFromStep,
+      seedResults: body.seedResults as Record<string, unknown> | undefined,
+      runId: body.runId,
+      tags: body.tags as string[] | undefined,
+      triggeredByUserId: body.triggeredByUserId as string | null | undefined,
+    },
+  }
+}
+
+async function fetchRunRecord<Id>(
+  runId: string,
+  deps: WorkerFetchDeps<Id>,
+): Promise<{ record?: RunRecord } | { error: Response }> {
+  const res = await forwardToRunDO(
+    runId,
+    new Request("https://do-internal/get", { method: "GET" }),
+    deps,
+  )
+  if (res.status === 404) {
+    return {}
+  }
+  if (!res.ok) return { error: res }
+  return { record: (await res.json()) as RunRecord }
+}
+
 async function forwardToRunDO<Id>(
   runId: string,
   req: Request,
@@ -255,12 +416,48 @@ async function safeJson(
   const text = await req.text()
   if (text.length === 0) return {}
   try {
-    return JSON.parse(text) as Record<string, unknown>
+    const parsed = JSON.parse(text) as unknown
+    if (!isPlainObject(parsed)) {
+      return { error: "invalid_body", message: "request body must be an object" }
+    }
+    return parsed
   } catch (err) {
     return { error: "invalid_json", message: errMsg(err) }
   }
 }
 
+function isPlainObject(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value)
+}
+
+function isStringArray(value: unknown): value is string[] {
+  return Array.isArray(value) && value.every((entry) => typeof entry === "string")
+}
+
+function mergeTags(...groups: ReadonlyArray<ReadonlyArray<string> | undefined>): string[] {
+  const tags = new Set<string>()
+  for (const group of groups) {
+    for (const tag of group ?? []) tags.add(tag)
+  }
+  return Array.from(tags)
+}
+
+function requireExternalResumeFromStep(resumeFromStep: string | undefined): string {
+  if (!resumeFromStep) {
+    throw new Error("resumeFromStep is required when the parent run is not stored by this worker")
+  }
+  return resumeFromStep
+}
+
+function requireExternalSeedResults(
+  seedResults: Record<string, unknown> | undefined,
+): Record<string, unknown> {
+  if (!seedResults) {
+    throw new Error("seedResults is required when the parent run is not stored by this worker")
+  }
+  return seedResults
+}
+
 function corsHeaders(methods: string): Record<string, string> {
   return {
     "access-control-allow-origin": "*",
@@ -269,6 +466,16 @@ function corsHeaders(methods: string): Record<string, string> {
   }
 }
 
+function sanitizePublicTriggerPayload(payload: Record<string, unknown>): Record<string, unknown> {
+  const {
+    initialJournal: _initialJournal,
+    initialMetadataAppliedCount: _initialMetadataAppliedCount,
+    timeoutMs: _timeoutMs,
+    ...publicPayload
+  } = payload
+  return publicPayload
+}
+
 function json(status: number, body: unknown): Response {
   return new Response(JSON.stringify(body), {
     status,