@voyantjs/workflows-cloud-adapter 0.66.0 → 0.68.0

package/dist/auto-publish.d.ts

@@ -0,0 +1,45 @@
+import { buildManifest } from "@voyantjs/workflows/events";
+import type { WorkflowManifest } from "@voyantjs/workflows/protocol";
+import type { CfManifestStore } from "@voyantjs/workflows-orchestrator-cloudflare";
+export type WorkflowEnvironment = "production" | "preview" | "development";
+export interface AutoPublishContext {
+    manifestStore: CfManifestStore;
+    environment?: WorkflowEnvironment | string;
+    projectId?: string;
+    /**
+     * Hook to schedule the publish so it doesn't block the hot path.
+     * In a CF Worker, pass `ctx.waitUntil`. Defaults to fire-and-forget
+     * (the returned promise is unhandled).
+     */
+    waitUntil?: (promise: Promise<unknown>) => void;
+    logger?: (level: "info" | "warn" | "error", msg: string, data?: object) => void;
+    /**
+     * Internal seam — defaults to the global `__listRegisteredWorkflows()`.
+     * Tests inject a fixture registry without polluting the process-wide
+     * registry.
+     */
+    listWorkflows?: () => ReadonlyArray<{
+        id: string;
+        config?: Parameters<typeof buildManifest>[0]["workflows"][number]["config"];
+    }>;
+    /**
+     * Internal seam — defaults to the global event-filter registry.
+     */
+    listEventFilters?: () => Parameters<typeof buildManifest>[0]["eventFilters"];
+}
+/**
+ * Schedule an auto-publish of the in-process registry. Idempotent —
+ * the latch prevents repeated KV reads per isolate, and the publish
+ * itself short-circuits when the current envelope already matches the
+ * registry's versionId.
+ */
+export declare function scheduleAutoPublishManifest(ctx: AutoPublishContext): void;
+/**
+ * Build the registry-derived manifest and write it to KV when needed.
+ * Exported so tests (and the rare caller that wants synchronous
+ * semantics) can await the result. Returns the published manifest, or
+ * `null` when the registry is empty or KV already has a matching
+ * envelope.
+ */
+export declare function publishManifest(ctx: AutoPublishContext): Promise<WorkflowManifest | null>;
+//# sourceMappingURL=auto-publish.d.ts.map

package/dist/auto-publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-publish.d.ts","sourceRoot":"","sources":["../src/auto-publish.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,aAAa,EAA0B,MAAM,4BAA4B,CAAA;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAA;AAIlF,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG,SAAS,GAAG,aAAa,CAAA;AAE1E,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,eAAe,CAAA;IAC9B,WAAW,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAAA;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;IAC/C,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;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,aAAa,CAAC;QAClC,EAAE,EAAE,MAAM,CAAA;QACV,MAAM,CAAC,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAA;KAC5E,CAAC,CAAA;IACF;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAA;CAC7E;AASD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI,CA0BzE;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAqC/F"}

package/dist/auto-publish.js

@@ -0,0 +1,107 @@
+// Cold-start auto-publish of the in-process workflow registry to the
+// `WORKFLOW_MANIFESTS` KV namespace.
+//
+// Background (issue #1070): the KV manifest is only populated when a
+// tenant explicitly calls `registerManifest` (driver path) or POSTs
+// `/api/manifests` (HTTP path). Tenants that compose workflows from
+// many packages and never wire either path end up with an empty KV,
+// which means voyant-cloud's scheduler can't pull the runtime manifest
+// to seed `workflow_schedules`. The cron tick then has nothing to fire.
+//
+// This module bridges the gap: when the cloud adapter sees its first
+// request, it builds the manifest from the in-process registry and
+// writes it to KV if the current envelope is missing or its versionId
+// differs. The manifest is content-addressed, so concurrent cold
+// starts converge on the same versionId — repeated publishes are
+// no-ops after the first.
+import { __listRegisteredWorkflows } from "@voyantjs/workflows";
+import { buildManifest, getEventFilterRegistry } from "@voyantjs/workflows/events";
+const ALLOWED_ENVS = new Set(["production", "preview", "development"]);
+/**
+ * Per-store latch so we only check KV once per cold start. The store
+ * object is created from the KV binding, which is stable across
+ * requests on the same isolate.
+ */
+const PUBLISHED = new WeakSet();
+/**
+ * Schedule an auto-publish of the in-process registry. Idempotent —
+ * the latch prevents repeated KV reads per isolate, and the publish
+ * itself short-circuits when the current envelope already matches the
+ * registry's versionId.
+ */
+export function scheduleAutoPublishManifest(ctx) {
+    if (PUBLISHED.has(ctx.manifestStore))
+        return;
+    PUBLISHED.add(ctx.manifestStore);
+    const env = normalizeEnvironment(ctx.environment);
+    const work = (async () => {
+        try {
+            await publishManifest({ ...ctx, environment: env });
+        }
+        catch (err) {
+            // Cold-start publish is best-effort — never let a KV hiccup take
+            // down the request that triggered it. Clear the latch so a
+            // subsequent request re-tries.
+            PUBLISHED.delete(ctx.manifestStore);
+            ctx.logger?.("warn", "workflows: auto-publish manifest failed", {
+                error: err instanceof Error ? err.message : String(err),
+                environment: env,
+            });
+        }
+    })();
+    if (ctx.waitUntil) {
+        ctx.waitUntil(work);
+    }
+    else {
+        // No waitUntil — let it run; we already swallowed errors inside.
+        void work;
+    }
+}
+/**
+ * Build the registry-derived manifest and write it to KV when needed.
+ * Exported so tests (and the rare caller that wants synchronous
+ * semantics) can await the result. Returns the published manifest, or
+ * `null` when the registry is empty or KV already has a matching
+ * envelope.
+ */
+export async function publishManifest(ctx) {
+    const workflows = (ctx.listWorkflows ?? __listRegisteredWorkflows)();
+    if (workflows.length === 0)
+        return null;
+    const eventFilters = ctx.listEventFilters
+        ? ctx.listEventFilters()
+        : getEventFilterRegistry().list();
+    const environment = normalizeEnvironment(ctx.environment);
+    const manifest = await buildManifest({
+        projectId: ctx.projectId,
+        environment,
+        workflows: workflows.map((wf) => ({ id: wf.id, config: wf.config })),
+        eventFilters,
+    });
+    const current = await ctx.manifestStore.getCurrent(environment);
+    if (current && current.versionId === manifest.versionId) {
+        ctx.logger?.("info", "workflows: auto-publish manifest is a no-op", {
+            environment,
+            versionId: manifest.versionId,
+        });
+        return null;
+    }
+    await ctx.manifestStore.registerManifest({
+        environment,
+        versionId: manifest.versionId,
+        manifest: manifest,
+    });
+    ctx.logger?.("info", "workflows: auto-published manifest", {
+        environment,
+        versionId: manifest.versionId,
+        workflowCount: workflows.length,
+        eventFilterCount: eventFilters.length,
+    });
+    return manifest;
+}
+function normalizeEnvironment(value) {
+    if (value && ALLOWED_ENVS.has(value)) {
+        return value;
+    }
+    return "production";
+}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { type ContainerNamespaceLike, type DurableObjectNamespaceLike, type DurableObjectStorageLike, type KvNamespaceLike, type StepDispatcher, type WorkerFetchDeps } from "@voyantjs/workflows-orchestrator-cloudflare";
+export { type AutoPublishContext, publishManifest, scheduleAutoPublishManifest, type WorkflowEnvironment, } from "./auto-publish.js";
 export interface CloudWorkflowsEnv {
     /** Per-run Durable Object namespace declared by the tenant Worker. */
     WORKFLOW_RUN_DO: DurableObjectNamespaceLike;
@@ -18,6 +19,12 @@ export interface CloudWorkflowsEnv {
      * development only.
      */
     VOYANT_API_TOKENS?: string;
+    /**
+     * Deployment environment label used when the cloud adapter auto-publishes
+     * the in-process workflow registry to `WORKFLOW_MANIFESTS`. Voyant Cloud
+     * injects this on tenant workers; defaults to `"production"` when unset.
+     */
+    VOYANT_WORKFLOWS_ENVIRONMENT?: "production" | "preview" | "development" | string;
     /**
      * Prefix for the R2 S3 API URL that hosts the container bundle.
      * Expected form: `https://<account>.r2.cloudflarestorage.com/<bucket>`.
@@ -53,9 +60,33 @@ export interface CloudOrchestratorOptions<Env extends CloudWorkflowsEnv = CloudW
     tenantMeta?: WorkerFetchDeps["tenantMeta"];
     services?: import("@voyantjs/workflows/driver").ServiceResolver;
     resolveEnv?: (env: Env) => Env;
+    /**
+     * Opt out of the cold-start auto-publish of the in-process workflow
+     * registry to `WORKFLOW_MANIFESTS` KV. Default: auto-publish is on
+     * whenever the KV binding is present. Set to `false` if your deploy
+     * pipeline already POSTs `/api/manifests` and you want a single
+     * source of truth.
+     */
+    autoPublishManifest?: boolean;
+    /**
+     * Cloudflare `ctx.waitUntil` — when provided, the auto-publish
+     * background task is registered with it so the response isn't held
+     * back by the KV write. Pass `(p) => ctx.waitUntil(p)` from the
+     * outer `fetch(request, env, ctx)` handler.
+     */
+    waitUntil?: (promise: Promise<unknown>) => void;
+}
+/**
+ * Cloudflare ExecutionContext-like shape consumed by the cloud
+ * orchestrator. Declared structurally so this package doesn't pull in
+ * `@cloudflare/workers-types` — pass the real `ctx` from your worker's
+ * `fetch(request, env, ctx)` and the structural shape will match.
+ */
+export interface CloudExecutionCtx {
+    waitUntil?: (promise: Promise<unknown>) => void;
 }
 export interface CloudOrchestrator<Env extends CloudWorkflowsEnv = CloudWorkflowsEnv> {
-    fetch: (request: Request, env?: Env) => Promise<Response>;
+    fetch: (request: Request, env?: Env, ctx?: CloudExecutionCtx) => Promise<Response>;
     WorkflowRunDO: WorkflowRunDOClass<Env>;
 }
 export type WorkflowRunDOClass<Env extends CloudWorkflowsEnv = CloudWorkflowsEnv> = new (state: DurableObjectStateLike, env: Env) => WorkflowRunDO<Env>;
@@ -77,5 +108,4 @@ export declare class WorkflowRunDO<Env extends CloudWorkflowsEnv = CloudWorkflow
     protected executionOptions(): CloudExecutionOptions<Env>;
 }
 export declare function createCloudStepDispatcher<Env extends CloudWorkflowsEnv = CloudWorkflowsEnv>(env: Env, options?: CloudExecutionOptions<Env>): StepDispatcher;
-export {};
 //# sourceMappingURL=index.d.ts.map

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

@@ -7,15 +7,20 @@ import { createBearerVerifier, createHmacSigner } from "@voyantjs/workflows/auth
 import { handleStepRequest, } from "@voyantjs/workflows/handler";
 import { createInMemoryRateLimiter } from "@voyantjs/workflows/rate-limit";
 import { createCfContainerStepRunner, createInlineDispatcher, createKvManifestStore, createR2Presigner, handleDurableObjectAlarm, handleDurableObjectRequest, handleWorkerRequest, } from "@voyantjs/workflows-orchestrator-cloudflare";
+import { scheduleAutoPublishManifest } from "./auto-publish.js";
+export { publishManifest, scheduleAutoPublishManifest, } from "./auto-publish.js";
 const envCache = new WeakMap();
 const defaultExecutionOptions = {};
 export function createCloudOrchestrator(workflows, boundEnv, options = {}) {
     void workflows;
     const WorkflowRunDOWithOptions = createWorkflowRunDOClass(options);
     return {
-        fetch(request, requestEnv) {
+        fetch(request, requestEnv, ctx) {
             const env = resolveBoundEnv(boundEnv, requestEnv, options);
-            return handleCloudFetch(request, env, options);
+            const callOptions = ctx?.waitUntil
+                ? { ...options, waitUntil: options.waitUntil ?? ctx.waitUntil.bind(ctx) }
+                : options;
+            return handleCloudFetch(request, env, callOptions);
         },
         WorkflowRunDO: WorkflowRunDOWithOptions,
     };
@@ -27,7 +32,8 @@ export function mountWorkflows(app, env, options = {}) {
         app.all(`${pathPrefix}/*`, (...args) => {
             const request = extractRequest(args);
             const requestEnv = extractEnv(args, env);
-            return orchestrator.fetch(request, requestEnv);
+            const ctx = extractCtx(args);
+            return orchestrator.fetch(request, requestEnv, ctx);
         });
         return app;
     }
@@ -35,7 +41,7 @@ export function mountWorkflows(app, env, options = {}) {
         const originalFetch = app.fetch.bind(app);
         app.fetch = (request, requestEnv, ctx) => {
             if (isMountedPath(new URL(request.url).pathname, pathPrefix)) {
-                return orchestrator.fetch(request, requestEnv ?? env);
+                return orchestrator.fetch(request, requestEnv ?? env, ctx);
             }
             return originalFetch(request, requestEnv, ctx);
         };
@@ -49,6 +55,16 @@ export async function handleCloudFetch(request, env, options = {}) {
         .split(",")
         .map((s) => s.trim())
         .filter((s) => s.length > 0);
+    const manifestStore = resolveManifestStore(resolvedEnv);
+    if (manifestStore && options.autoPublishManifest !== false) {
+        const autoPublishCtx = {
+            manifestStore,
+            environment: resolvedEnv.VOYANT_WORKFLOWS_ENVIRONMENT,
+            logger: options.logger,
+            ...(options.waitUntil ? { waitUntil: options.waitUntil } : {}),
+        };
+        scheduleAutoPublishManifest(autoPublishCtx);
+    }
     return handleWorkerRequest(request, {
         runDO: resolvedEnv.WORKFLOW_RUN_DO,
         verifyRequest: options.verifyRequest ?? (tokens.length > 0 ? createBearerVerifier(tokens) : undefined),
@@ -56,9 +72,7 @@ export async function handleCloudFetch(request, env, options = {}) {
         idGenerator: options.idGenerator,
         now: options.now,
         tenantMeta: options.tenantMeta,
-        manifestStore: resolvedEnv.WORKFLOW_MANIFESTS
-            ? createKvManifestStore({ kv: resolvedEnv.WORKFLOW_MANIFESTS })
-            : undefined,
+        manifestStore,
     });
 }
 export class WorkflowRunDO {
@@ -96,6 +110,22 @@ function createWorkflowRunDOClass(options) {
         }
     };
 }
+function resolveManifestStore(env) {
+    const kv = env.WORKFLOW_MANIFESTS;
+    if (!kv)
+        return undefined;
+    const cache = cacheFor(env);
+    // Re-create when the KV binding identity changes (e.g. a test that
+    // swaps namespaces on the same env reference). In production the
+    // binding is stable across requests so this path is a cache hit and
+    // the WeakSet-based latch in scheduleAutoPublishManifest works as
+    // intended.
+    if (!cache.manifestStore || cache.manifestStoreKv !== kv) {
+        cache.manifestStoreKv = kv;
+        cache.manifestStore = createKvManifestStore({ kv });
+    }
+    return cache.manifestStore;
+}
 function resolveDispatcher(env, options = defaultExecutionOptions) {
     const cache = cacheFor(env);
     if (!cache.dispatcher || cache.dispatcherOptions !== options) {
@@ -378,3 +408,15 @@ function extractEnv(args, boundEnv) {
     const firstEnv = args[0]?.env;
     return firstEnv ?? args[1];
 }
+function extractCtx(args) {
+    // Hono passes (c, next) with executionCtx on the context; raw workers
+    // pass (request, env, ctx) directly. Probe both shapes so the auto-publish
+    // background task can register with the right waitUntil.
+    const honoCtx = args[0];
+    if (honoCtx?.executionCtx?.waitUntil)
+        return honoCtx.executionCtx;
+    const rawCtx = args[2];
+    if (rawCtx && typeof rawCtx.waitUntil === "function")
+        return rawCtx;
+    return undefined;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/workflows-cloud-adapter",
-  "version": "0.66.0",
+  "version": "0.68.0",
   "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.66.0",
-    "@voyantjs/workflows-orchestrator": "0.66.0",
-    "@voyantjs/workflows-orchestrator-cloudflare": "0.66.0"
+    "@voyantjs/workflows": "0.68.0",
+    "@voyantjs/workflows-orchestrator": "0.68.0",
+    "@voyantjs/workflows-orchestrator-cloudflare": "0.68.0"
   },
   "devDependencies": {
     "@types/node": "^20.12.0",

package/src/auto-publish.ts

@@ -0,0 +1,145 @@
+// Cold-start auto-publish of the in-process workflow registry to the
+// `WORKFLOW_MANIFESTS` KV namespace.
+//
+// Background (issue #1070): the KV manifest is only populated when a
+// tenant explicitly calls `registerManifest` (driver path) or POSTs
+// `/api/manifests` (HTTP path). Tenants that compose workflows from
+// many packages and never wire either path end up with an empty KV,
+// which means voyant-cloud's scheduler can't pull the runtime manifest
+// to seed `workflow_schedules`. The cron tick then has nothing to fire.
+//
+// This module bridges the gap: when the cloud adapter sees its first
+// request, it builds the manifest from the in-process registry and
+// writes it to KV if the current envelope is missing or its versionId
+// differs. The manifest is content-addressed, so concurrent cold
+// starts converge on the same versionId — repeated publishes are
+// no-ops after the first.
+
+import { __listRegisteredWorkflows } from "@voyantjs/workflows"
+import { buildManifest, getEventFilterRegistry } from "@voyantjs/workflows/events"
+import type { WorkflowManifest } from "@voyantjs/workflows/protocol"
+import type { CfManifestStore } from "@voyantjs/workflows-orchestrator-cloudflare"
+
+const ALLOWED_ENVS = new Set<WorkflowEnvironment>(["production", "preview", "development"])
+
+export type WorkflowEnvironment = "production" | "preview" | "development"
+
+export interface AutoPublishContext {
+  manifestStore: CfManifestStore
+  environment?: WorkflowEnvironment | string
+  projectId?: string
+  /**
+   * Hook to schedule the publish so it doesn't block the hot path.
+   * In a CF Worker, pass `ctx.waitUntil`. Defaults to fire-and-forget
+   * (the returned promise is unhandled).
+   */
+  waitUntil?: (promise: Promise<unknown>) => void
+  logger?: (level: "info" | "warn" | "error", msg: string, data?: object) => void
+  /**
+   * Internal seam — defaults to the global `__listRegisteredWorkflows()`.
+   * Tests inject a fixture registry without polluting the process-wide
+   * registry.
+   */
+  listWorkflows?: () => ReadonlyArray<{
+    id: string
+    config?: Parameters<typeof buildManifest>[0]["workflows"][number]["config"]
+  }>
+  /**
+   * Internal seam — defaults to the global event-filter registry.
+   */
+  listEventFilters?: () => Parameters<typeof buildManifest>[0]["eventFilters"]
+}
+
+/**
+ * Per-store latch so we only check KV once per cold start. The store
+ * object is created from the KV binding, which is stable across
+ * requests on the same isolate.
+ */
+const PUBLISHED = new WeakSet<CfManifestStore>()
+
+/**
+ * Schedule an auto-publish of the in-process registry. Idempotent —
+ * the latch prevents repeated KV reads per isolate, and the publish
+ * itself short-circuits when the current envelope already matches the
+ * registry's versionId.
+ */
+export function scheduleAutoPublishManifest(ctx: AutoPublishContext): void {
+  if (PUBLISHED.has(ctx.manifestStore)) return
+  PUBLISHED.add(ctx.manifestStore)
+
+  const env = normalizeEnvironment(ctx.environment)
+  const work = (async () => {
+    try {
+      await publishManifest({ ...ctx, environment: env })
+    } catch (err) {
+      // Cold-start publish is best-effort — never let a KV hiccup take
+      // down the request that triggered it. Clear the latch so a
+      // subsequent request re-tries.
+      PUBLISHED.delete(ctx.manifestStore)
+      ctx.logger?.("warn", "workflows: auto-publish manifest failed", {
+        error: err instanceof Error ? err.message : String(err),
+        environment: env,
+      })
+    }
+  })()
+
+  if (ctx.waitUntil) {
+    ctx.waitUntil(work)
+  } else {
+    // No waitUntil — let it run; we already swallowed errors inside.
+    void work
+  }
+}
+
+/**
+ * Build the registry-derived manifest and write it to KV when needed.
+ * Exported so tests (and the rare caller that wants synchronous
+ * semantics) can await the result. Returns the published manifest, or
+ * `null` when the registry is empty or KV already has a matching
+ * envelope.
+ */
+export async function publishManifest(ctx: AutoPublishContext): Promise<WorkflowManifest | null> {
+  const workflows = (ctx.listWorkflows ?? __listRegisteredWorkflows)()
+  if (workflows.length === 0) return null
+
+  const eventFilters = ctx.listEventFilters
+    ? ctx.listEventFilters()
+    : getEventFilterRegistry().list()
+
+  const environment = normalizeEnvironment(ctx.environment)
+  const manifest = await buildManifest({
+    projectId: ctx.projectId,
+    environment,
+    workflows: workflows.map((wf) => ({ id: wf.id, config: wf.config })),
+    eventFilters,
+  })
+
+  const current = await ctx.manifestStore.getCurrent(environment)
+  if (current && current.versionId === manifest.versionId) {
+    ctx.logger?.("info", "workflows: auto-publish manifest is a no-op", {
+      environment,
+      versionId: manifest.versionId,
+    })
+    return null
+  }
+
+  await ctx.manifestStore.registerManifest({
+    environment,
+    versionId: manifest.versionId,
+    manifest: manifest as unknown as Record<string, unknown>,
+  })
+  ctx.logger?.("info", "workflows: auto-published manifest", {
+    environment,
+    versionId: manifest.versionId,
+    workflowCount: workflows.length,
+    eventFilterCount: eventFilters.length,
+  })
+  return manifest
+}
+
+function normalizeEnvironment(value: string | undefined): WorkflowEnvironment {
+  if (value && ALLOWED_ENVS.has(value as WorkflowEnvironment)) {
+    return value as WorkflowEnvironment
+  }
+  return "production"
+}

package/src/index.ts

@@ -13,6 +13,7 @@ import {
 import { createInMemoryRateLimiter } from "@voyantjs/workflows/rate-limit"
 import type { StepHandler } from "@voyantjs/workflows-orchestrator"
 import {
+  type CfManifestStore,
   type ContainerNamespaceLike,
   createCfContainerStepRunner,
   createInlineDispatcher,
@@ -28,6 +29,15 @@ import {
   type WorkerFetchDeps,
 } from "@voyantjs/workflows-orchestrator-cloudflare"
 
+import { type AutoPublishContext, scheduleAutoPublishManifest } from "./auto-publish.js"
+
+export {
+  type AutoPublishContext,
+  publishManifest,
+  scheduleAutoPublishManifest,
+  type WorkflowEnvironment,
+} from "./auto-publish.js"
+
 export interface CloudWorkflowsEnv {
   /** Per-run Durable Object namespace declared by the tenant Worker. */
   WORKFLOW_RUN_DO: DurableObjectNamespaceLike
@@ -47,6 +57,12 @@ export interface CloudWorkflowsEnv {
    * development only.
    */
   VOYANT_API_TOKENS?: string
+  /**
+   * Deployment environment label used when the cloud adapter auto-publishes
+   * the in-process workflow registry to `WORKFLOW_MANIFESTS`. Voyant Cloud
+   * injects this on tenant workers; defaults to `"production"` when unset.
+   */
+  VOYANT_WORKFLOWS_ENVIRONMENT?: "production" | "preview" | "development" | string
   /**
    * Prefix for the R2 S3 API URL that hosts the container bundle.
    * Expected form: `https://<account>.r2.cloudflarestorage.com/<bucket>`.
@@ -84,10 +100,35 @@ export interface CloudOrchestratorOptions<Env extends CloudWorkflowsEnv = CloudW
   tenantMeta?: WorkerFetchDeps["tenantMeta"]
   services?: import("@voyantjs/workflows/driver").ServiceResolver
   resolveEnv?: (env: Env) => Env
+  /**
+   * Opt out of the cold-start auto-publish of the in-process workflow
+   * registry to `WORKFLOW_MANIFESTS` KV. Default: auto-publish is on
+   * whenever the KV binding is present. Set to `false` if your deploy
+   * pipeline already POSTs `/api/manifests` and you want a single
+   * source of truth.
+   */
+  autoPublishManifest?: boolean
+  /**
+   * Cloudflare `ctx.waitUntil` — when provided, the auto-publish
+   * background task is registered with it so the response isn't held
+   * back by the KV write. Pass `(p) => ctx.waitUntil(p)` from the
+   * outer `fetch(request, env, ctx)` handler.
+   */
+  waitUntil?: (promise: Promise<unknown>) => void
+}
+
+/**
+ * Cloudflare ExecutionContext-like shape consumed by the cloud
+ * orchestrator. Declared structurally so this package doesn't pull in
+ * `@cloudflare/workers-types` — pass the real `ctx` from your worker's
+ * `fetch(request, env, ctx)` and the structural shape will match.
+ */
+export interface CloudExecutionCtx {
+  waitUntil?: (promise: Promise<unknown>) => void
 }
 
 export interface CloudOrchestrator<Env extends CloudWorkflowsEnv = CloudWorkflowsEnv> {
-  fetch: (request: Request, env?: Env) => Promise<Response>
+  fetch: (request: Request, env?: Env, ctx?: CloudExecutionCtx) => Promise<Response>
   WorkflowRunDO: WorkflowRunDOClass<Env>
 }
 
@@ -96,6 +137,8 @@ type EnvCache = {
   dispatcherOptions?: CloudExecutionOptions<CloudWorkflowsEnv>
   stepHandler?: StepHandler
   stepHandlerOptions?: CloudExecutionOptions<CloudWorkflowsEnv>
+  manifestStore?: CfManifestStore
+  manifestStoreKv?: KvNamespaceLike
 }
 
 const envCache = new WeakMap<object, EnvCache>()
@@ -120,9 +163,12 @@ export function createCloudOrchestrator<Env extends CloudWorkflowsEnv = CloudWor
   const WorkflowRunDOWithOptions = createWorkflowRunDOClass<Env>(options)
 
   return {
-    fetch(request, requestEnv) {
+    fetch(request, requestEnv, ctx) {
       const env = resolveBoundEnv(boundEnv, requestEnv, options)
-      return handleCloudFetch(request, env, options)
+      const callOptions = ctx?.waitUntil
+        ? { ...options, waitUntil: options.waitUntil ?? ctx.waitUntil.bind(ctx) }
+        : options
+      return handleCloudFetch(request, env, callOptions)
     },
     WorkflowRunDO: WorkflowRunDOWithOptions,
   }
@@ -142,7 +188,8 @@ export function mountWorkflows<
     app.all(`${pathPrefix}/*`, (...args) => {
       const request = extractRequest(args)
       const requestEnv = extractEnv<Env>(args, env)
-      return orchestrator.fetch(request, requestEnv)
+      const ctx = extractCtx(args)
+      return orchestrator.fetch(request, requestEnv, ctx)
     })
     return app
   }
@@ -151,7 +198,11 @@ export function mountWorkflows<
     const originalFetch = app.fetch.bind(app)
     ;(app as { fetch: typeof app.fetch }).fetch = (request, requestEnv, ctx) => {
       if (isMountedPath(new URL(request.url).pathname, pathPrefix)) {
-        return orchestrator.fetch(request, (requestEnv as Env | undefined) ?? env)
+        return orchestrator.fetch(
+          request,
+          (requestEnv as Env | undefined) ?? env,
+          ctx as CloudExecutionCtx | undefined,
+        )
       }
       return originalFetch(request, requestEnv, ctx)
     }
@@ -174,6 +225,18 @@ export async function handleCloudFetch<Env extends CloudWorkflowsEnv = CloudWork
     .map((s) => s.trim())
     .filter((s) => s.length > 0)
 
+  const manifestStore = resolveManifestStore(resolvedEnv)
+
+  if (manifestStore && options.autoPublishManifest !== false) {
+    const autoPublishCtx: AutoPublishContext = {
+      manifestStore,
+      environment: resolvedEnv.VOYANT_WORKFLOWS_ENVIRONMENT,
+      logger: options.logger,
+      ...(options.waitUntil ? { waitUntil: options.waitUntil } : {}),
+    }
+    scheduleAutoPublishManifest(autoPublishCtx)
+  }
+
   return handleWorkerRequest(request, {
     runDO: resolvedEnv.WORKFLOW_RUN_DO,
     verifyRequest:
@@ -182,9 +245,7 @@ export async function handleCloudFetch<Env extends CloudWorkflowsEnv = CloudWork
     idGenerator: options.idGenerator,
     now: options.now,
     tenantMeta: options.tenantMeta,
-    manifestStore: resolvedEnv.WORKFLOW_MANIFESTS
-      ? createKvManifestStore({ kv: resolvedEnv.WORKFLOW_MANIFESTS })
-      : undefined,
+    manifestStore,
   })
 }
 
@@ -235,6 +296,22 @@ function createWorkflowRunDOClass<Env extends CloudWorkflowsEnv>(
   }
 }
 
+function resolveManifestStore(env: CloudWorkflowsEnv): CfManifestStore | undefined {
+  const kv = env.WORKFLOW_MANIFESTS
+  if (!kv) return undefined
+  const cache = cacheFor(env)
+  // Re-create when the KV binding identity changes (e.g. a test that
+  // swaps namespaces on the same env reference). In production the
+  // binding is stable across requests so this path is a cache hit and
+  // the WeakSet-based latch in scheduleAutoPublishManifest works as
+  // intended.
+  if (!cache.manifestStore || cache.manifestStoreKv !== kv) {
+    cache.manifestStoreKv = kv
+    cache.manifestStore = createKvManifestStore({ kv })
+  }
+  return cache.manifestStore
+}
+
 function resolveDispatcher<Env extends CloudWorkflowsEnv>(
   env: Env,
   options: CloudExecutionOptions<Env> = defaultExecutionOptions as CloudExecutionOptions<Env>,
@@ -608,3 +685,14 @@ function extractEnv<Env extends CloudWorkflowsEnv>(
   const firstEnv = (args[0] as { env?: unknown } | undefined)?.env
   return (firstEnv as Env | undefined) ?? (args[1] as Env | undefined)
 }
+
+function extractCtx(args: readonly unknown[]): CloudExecutionCtx | undefined {
+  // Hono passes (c, next) with executionCtx on the context; raw workers
+  // pass (request, env, ctx) directly. Probe both shapes so the auto-publish
+  // background task can register with the right waitUntil.
+  const honoCtx = args[0] as { executionCtx?: CloudExecutionCtx } | undefined
+  if (honoCtx?.executionCtx?.waitUntil) return honoCtx.executionCtx
+  const rawCtx = args[2] as CloudExecutionCtx | undefined
+  if (rawCtx && typeof rawCtx.waitUntil === "function") return rawCtx
+  return undefined
+}