@voyantjs/workflows-cloud-adapter 0.52.0 → 0.52.2

package/dist/index.d.ts

@@ -37,6 +37,8 @@ export interface CloudWorkflowsEnv {
     VOYANT_WORKFLOW_BUNDLE_R2_BUCKET?: string;
     /** Optional signed URL TTL in seconds. Defaults to 300. */
     VOYANT_WORKFLOW_BUNDLE_URL_TTL_SECONDS?: string;
+    /** Platform-managed Cloud Run node step runner endpoint. */
+    VOYANT_WORKFLOW_NODE_RUNNER_URL?: string;
     /** Shared secret used to sign dispatches to the platform step runner. */
     VOYANT_WORKFLOW_STEP_AUTH_SECRET?: string;
 }

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -125,6 +125,9 @@ async function buildStepHandler(env, options = defaultExecutionOptions) {
     }, stepOptions);
 }
 async function createNodeStepRunner(env, options) {
+    if (env.VOYANT_WORKFLOW_NODE_RUNNER_URL) {
+        return createHttpNodeStepRunner(env, options);
+    }
     if (!env.STEP_RUNNER) {
         return createInlineNodeStepRunner(options.now);
     }
@@ -151,6 +154,106 @@ async function createNodeStepRunner(env, options) {
         }),
     });
 }
+async function createHttpNodeStepRunner(env, options) {
+    const serviceUrl = env.VOYANT_WORKFLOW_NODE_RUNNER_URL?.replace(/\/+$/, "");
+    if (!serviceUrl) {
+        throw new Error("@voyantjs/workflows-cloud-adapter: VOYANT_WORKFLOW_NODE_RUNNER_URL is empty");
+    }
+    const key = env.VOYANT_WORKFLOW_BUNDLE_KEY;
+    const hash = env.VOYANT_WORKFLOW_BUNDLE_HASH;
+    const missing = [
+        ["VOYANT_WORKFLOW_BUNDLE_KEY", key],
+        ["VOYANT_WORKFLOW_BUNDLE_HASH", hash],
+    ].filter(([, value]) => typeof value !== "string" || value.length === 0);
+    if (missing.length > 0) {
+        throw new Error(`@voyantjs/workflows-cloud-adapter: Cloud Run node runner is configured but bundle env is incomplete: ${missing
+            .map(([name]) => name)
+            .join(", ")}`);
+    }
+    const sign = env.VOYANT_WORKFLOW_STEP_AUTH_SECRET
+        ? await createHmacSigner(env.VOYANT_WORKFLOW_STEP_AUTH_SECRET)
+        : undefined;
+    return async ({ stepId, attempt, input, stepCtx, runId, workflowId, workflowVersion, projectId, organizationId, options: stepOptions, journal, }) => {
+        const startedAt = Date.now();
+        const payload = {
+            runId,
+            workflowId,
+            workflowVersion,
+            projectId,
+            organizationId,
+            stepId,
+            attempt,
+            input,
+            options: {
+                machine: stepOptions.machine,
+                timeout: typeof stepOptions.timeout === "string" || typeof stepOptions.timeout === "number"
+                    ? stepOptions.timeout
+                    : undefined,
+            },
+            bundle: {
+                key,
+                hash,
+            },
+            journal,
+        };
+        const body = JSON.stringify(payload);
+        const headers = {
+            "content-type": "application/json; charset=utf-8",
+        };
+        if (sign)
+            headers["x-voyant-step-auth"] = await sign(body);
+        let response;
+        try {
+            response = await fetch(`${serviceUrl}/step`, {
+                method: "POST",
+                headers,
+                body,
+                signal: stepCtx.signal,
+            });
+        }
+        catch (err) {
+            options.logger?.("error", "cloud-run-node: fetch threw", {
+                runId,
+                stepId,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            return failedNodeStep(attempt, startedAt, "NODE_RUNNER_DISPATCH_FAILED", err);
+        }
+        const text = await response.text();
+        if (!response.ok) {
+            options.logger?.("warn", "cloud-run-node: non-2xx response", {
+                runId,
+                stepId,
+                status: response.status,
+                body: text.slice(0, 500),
+            });
+            return failedNodeStep(attempt, startedAt, "NODE_RUNNER_HTTP_ERROR", new Error(`node runner returned HTTP ${response.status}: ${text}`));
+        }
+        try {
+            return JSON.parse(text);
+        }
+        catch (err) {
+            return failedNodeStep(attempt, startedAt, "NODE_RUNNER_INVALID_RESPONSE", new Error(`node runner returned non-JSON body: ${String(err)}`));
+        }
+    };
+}
+function failedNodeStep(attempt, startedAt, code, err) {
+    const e = err instanceof Error ? err : new Error(String(err));
+    return {
+        attempt,
+        status: "err",
+        startedAt,
+        finishedAt: Date.now(),
+        runtime: "node",
+        error: {
+            category: "RUNTIME_ERROR",
+            code,
+            message: e.message,
+            name: e.name,
+            stack: e.stack,
+        },
+    };
+}
 function createInlineNodeStepRunner(now = () => Date.now()) {
     return async ({ attempt, fn, stepCtx }) => {
         const startedAt = now();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/workflows-cloud-adapter",
-  "version": "0.52.0",
+  "version": "0.52.2",
   "description": "Tenant Worker adapter for Voyant Cloud Workflows deployments. Wires WorkflowRunDO, inline local dispatch, and platform step-runner bindings from env.",
   "license": "Apache-2.0",
   "repository": {
@@ -26,9 +26,9 @@
     "NOTICE"
   ],
   "dependencies": {
-    "@voyantjs/workflows": "0.52.0",
-    "@voyantjs/workflows-orchestrator": "0.52.0",
-    "@voyantjs/workflows-orchestrator-cloudflare": "0.52.0"
+    "@voyantjs/workflows": "0.52.2",
+    "@voyantjs/workflows-orchestrator": "0.52.2",
+    "@voyantjs/workflows-orchestrator-cloudflare": "0.52.2"
   },
   "devDependencies": {
     "@types/node": "^20.12.0",

package/src/index.ts

@@ -66,6 +66,8 @@ export interface CloudWorkflowsEnv {
   VOYANT_WORKFLOW_BUNDLE_R2_BUCKET?: string
   /** Optional signed URL TTL in seconds. Defaults to 300. */
   VOYANT_WORKFLOW_BUNDLE_URL_TTL_SECONDS?: string
+  /** Platform-managed Cloud Run node step runner endpoint. */
+  VOYANT_WORKFLOW_NODE_RUNNER_URL?: string
   /** Shared secret used to sign dispatches to the platform step runner. */
   VOYANT_WORKFLOW_STEP_AUTH_SECRET?: string
 }
@@ -284,6 +286,10 @@ async function createNodeStepRunner<Env extends CloudWorkflowsEnv>(
   env: Env,
   options: CloudExecutionOptions<Env>,
 ): Promise<StepRunner> {
+  if (env.VOYANT_WORKFLOW_NODE_RUNNER_URL) {
+    return createHttpNodeStepRunner(env, options)
+  }
+
   if (!env.STEP_RUNNER) {
     return createInlineNodeStepRunner(options.now)
   }
@@ -313,6 +319,142 @@ async function createNodeStepRunner<Env extends CloudWorkflowsEnv>(
   })
 }
 
+async function createHttpNodeStepRunner<Env extends CloudWorkflowsEnv>(
+  env: Env,
+  options: CloudExecutionOptions<Env>,
+): Promise<StepRunner> {
+  const serviceUrl = env.VOYANT_WORKFLOW_NODE_RUNNER_URL?.replace(/\/+$/, "")
+  if (!serviceUrl) {
+    throw new Error("@voyantjs/workflows-cloud-adapter: VOYANT_WORKFLOW_NODE_RUNNER_URL is empty")
+  }
+  const key = env.VOYANT_WORKFLOW_BUNDLE_KEY
+  const hash = env.VOYANT_WORKFLOW_BUNDLE_HASH
+  const missing = [
+    ["VOYANT_WORKFLOW_BUNDLE_KEY", key],
+    ["VOYANT_WORKFLOW_BUNDLE_HASH", hash],
+  ].filter(([, value]) => typeof value !== "string" || value.length === 0)
+  if (missing.length > 0) {
+    throw new Error(
+      `@voyantjs/workflows-cloud-adapter: Cloud Run node runner is configured but bundle env is incomplete: ${missing
+        .map(([name]) => name)
+        .join(", ")}`,
+    )
+  }
+  const sign = env.VOYANT_WORKFLOW_STEP_AUTH_SECRET
+    ? await createHmacSigner(env.VOYANT_WORKFLOW_STEP_AUTH_SECRET)
+    : undefined
+
+  return async ({
+    stepId,
+    attempt,
+    input,
+    stepCtx,
+    runId,
+    workflowId,
+    workflowVersion,
+    projectId,
+    organizationId,
+    options: stepOptions,
+    journal,
+  }): Promise<StepJournalEntry> => {
+    const startedAt = Date.now()
+    const payload = {
+      runId,
+      workflowId,
+      workflowVersion,
+      projectId,
+      organizationId,
+      stepId,
+      attempt,
+      input,
+      options: {
+        machine: stepOptions.machine,
+        timeout:
+          typeof stepOptions.timeout === "string" || typeof stepOptions.timeout === "number"
+            ? stepOptions.timeout
+            : undefined,
+      },
+      bundle: {
+        key,
+        hash,
+      },
+      journal,
+    }
+    const body = JSON.stringify(payload)
+    const headers: Record<string, string> = {
+      "content-type": "application/json; charset=utf-8",
+    }
+    if (sign) headers["x-voyant-step-auth"] = await sign(body)
+
+    let response: Response
+    try {
+      response = await fetch(`${serviceUrl}/step`, {
+        method: "POST",
+        headers,
+        body,
+        signal: stepCtx.signal,
+      })
+    } catch (err) {
+      options.logger?.("error", "cloud-run-node: fetch threw", {
+        runId,
+        stepId,
+        error: err instanceof Error ? err.message : String(err),
+      })
+      return failedNodeStep(attempt, startedAt, "NODE_RUNNER_DISPATCH_FAILED", err)
+    }
+
+    const text = await response.text()
+    if (!response.ok) {
+      options.logger?.("warn", "cloud-run-node: non-2xx response", {
+        runId,
+        stepId,
+        status: response.status,
+        body: text.slice(0, 500),
+      })
+      return failedNodeStep(
+        attempt,
+        startedAt,
+        "NODE_RUNNER_HTTP_ERROR",
+        new Error(`node runner returned HTTP ${response.status}: ${text}`),
+      )
+    }
+
+    try {
+      return JSON.parse(text) as StepJournalEntry
+    } catch (err) {
+      return failedNodeStep(
+        attempt,
+        startedAt,
+        "NODE_RUNNER_INVALID_RESPONSE",
+        new Error(`node runner returned non-JSON body: ${String(err)}`),
+      )
+    }
+  }
+}
+
+function failedNodeStep(
+  attempt: number,
+  startedAt: number,
+  code: string,
+  err: unknown,
+): StepJournalEntry {
+  const e = err instanceof Error ? err : new Error(String(err))
+  return {
+    attempt,
+    status: "err",
+    startedAt,
+    finishedAt: Date.now(),
+    runtime: "node",
+    error: {
+      category: "RUNTIME_ERROR",
+      code,
+      message: e.message,
+      name: e.name,
+      stack: e.stack,
+    },
+  }
+}
+
 function createInlineNodeStepRunner(now = () => Date.now()): StepRunner {
   return async ({ attempt, fn, stepCtx }): Promise<StepJournalEntry> => {
     const startedAt = now()