@voyantjs/workflows-orchestrator-cloudflare 0.66.6 → 0.69.0

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export { createDurableObjectRunStore } from "./do-store.js";
 export { type DurableObjectDeps, handleDurableObjectAlarm, handleDurableObjectRequest, } from "./durable-object.js";
 export { type CfManifestEnvelope, type CfManifestStore, type CreateKvManifestStoreOptions, createInMemoryKv, createKvManifestStore, type KvNamespaceLike, } from "./manifest-kv-store.js";
 export { createR2Presigner, type PresignArgs, type R2PresignerOptions, } from "./r2-sign.js";
+export { handleGetSchedules, type ScheduleHandlerDeps, type ScheduleListResponse, type ScheduleSummary, } from "./schedule-handler.js";
 export * from "./types.js";
 export { type DurableObjectNamespaceLike, handleWorkerRequest, type WorkerFetchDeps, } from "./worker.js";
 //# 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":"AAkCA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,2BAA2B,GAC5B,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,KAAK,2BAA2B,EAChC,0BAA0B,GAC3B,MAAM,6BAA6B,CAAA;AACpC,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,4BAA4B,EAC5B,mCAAmC,GACpC,MAAM,8BAA8B,CAAA;AACrC,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,8BAA8B,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,+BAA+B,EACpC,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC3B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,EACL,KAAK,iBAAiB,EACtB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,4BAA4B,EACjC,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAA;AACrB,cAAc,YAAY,CAAA;AAC1B,OAAO,EACL,KAAK,0BAA0B,EAC/B,mBAAmB,EACnB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkCA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,2BAA2B,GAC5B,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,KAAK,2BAA2B,EAChC,0BAA0B,GAC3B,MAAM,6BAA6B,CAAA;AACpC,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,4BAA4B,EAC5B,mCAAmC,GACpC,MAAM,8BAA8B,CAAA;AACrC,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,8BAA8B,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,+BAA+B,EACpC,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC3B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,EACL,KAAK,iBAAiB,EACtB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,4BAA4B,EACjC,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,OAAO,EACL,KAAK,0BAA0B,EAC/B,mBAAmB,EACnB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -39,5 +39,6 @@ export { createDurableObjectRunStore } from "./do-store.js";
 export { handleDurableObjectAlarm, handleDurableObjectRequest, } from "./durable-object.js";
 export { createInMemoryKv, createKvManifestStore, } from "./manifest-kv-store.js";
 export { createR2Presigner, } from "./r2-sign.js";
+export { handleGetSchedules, } from "./schedule-handler.js";
 export * from "./types.js";
 export { handleWorkerRequest, } from "./worker.js";

package/dist/schedule-handler.d.ts

@@ -0,0 +1,43 @@
+import type { ManifestSchedule } from "@voyantjs/workflows/protocol";
+import type { CfManifestStore } from "./manifest-kv-store.js";
+export interface ScheduleHandlerDeps {
+    manifestStore: CfManifestStore;
+    /**
+     * Process-wide schedules toggle. The Voyant Cloud orchestrator gates
+     * scheduler ticks behind `VOYANT_WORKFLOWS_ENABLE_SCHEDULES`; the UI
+     * surfaces that flag so operators can tell at a glance whether any
+     * schedule will fire even if `enabled: true` on the registration.
+     *
+     * When omitted, the response omits `schedulesEnabledByEnv` so older
+     * UIs can ignore the field.
+     */
+    schedulesEnabledByEnv?: boolean;
+    now?: () => number;
+    logger?: (level: "info" | "warn" | "error", msg: string, data?: object) => void;
+}
+export interface ScheduleSummary {
+    workflowId: string;
+    scheduleId: string;
+    schedule: ManifestSchedule;
+    /** Epoch millis of the next computed fire, or null when undecidable. */
+    nextRunAt: number | null;
+    /**
+     * False when the registration explicitly sets `enabled: false`, or
+     * when the registration's `environments` list excludes the requested
+     * environment.
+     */
+    enabled: boolean;
+    disabledReason?: "registration_disabled" | "env_filtered";
+}
+export interface ScheduleListResponse {
+    environment: string;
+    versionId: string;
+    schedulesEnabledByEnv?: boolean;
+    data: ScheduleSummary[];
+}
+/**
+ * Handle `GET /api/schedules/:env`. Returns the projected schedule list
+ * for the current manifest, or 404 when no manifest is registered.
+ */
+export declare function handleGetSchedules(environment: string, deps: ScheduleHandlerDeps): Promise<Response>;
+//# sourceMappingURL=schedule-handler.d.ts.map

package/dist/schedule-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-handler.d.ts","sourceRoot":"","sources":["../src/schedule-handler.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,8BAA8B,CAAA;AAGtF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAI7D,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,eAAe,CAAA;IAC9B;;;;;;;;OAQG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAChF;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,wEAAwE;IACxE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAA;IAChB,cAAc,CAAC,EAAE,uBAAuB,GAAG,cAAc,CAAA;CAC1D;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,IAAI,EAAE,eAAe,EAAE,CAAA;CACxB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,QAAQ,CAAC,CAoEnB"}

package/dist/schedule-handler.js

@@ -0,0 +1,90 @@
+// HTTP handler for `/api/schedules/:env`. Reads the registered manifest
+// for the requested environment, projects each workflow's schedule blocks
+// into a flat list, and computes `nextRun` per entry via the same cron /
+// every / at logic the live scheduler uses.
+//
+// Aggregate "lastRun" is intentionally out of scope here — runs in the
+// Cloudflare orchestrator live in per-run Durable Objects, indexed by
+// runId, with no list-by-workflow path. The UI is expected to fetch
+// last-run state separately from the template-side `workflow-runs`
+// admin API (`/v1/admin/workflow-runs?workflowName=…&limit=1`).
+import { computeNextFire } from "@voyantjs/workflows-orchestrator";
+const ALLOWED_ENVS = new Set(["production", "preview", "development"]);
+/**
+ * Handle `GET /api/schedules/:env`. Returns the projected schedule list
+ * for the current manifest, or 404 when no manifest is registered.
+ */
+export async function handleGetSchedules(environment, deps) {
+    if (!ALLOWED_ENVS.has(environment)) {
+        return json(400, {
+            error: "invalid_environment",
+            message: `environment must be one of ${[...ALLOWED_ENVS].join(", ")}`,
+        });
+    }
+    const envelope = await deps.manifestStore.getCurrent(environment);
+    if (!envelope) {
+        return json(404, { error: "not_found", environment });
+    }
+    const now = deps.now ? deps.now() : Date.now();
+    const manifest = envelope.manifest;
+    const data = [];
+    for (const workflow of manifest.workflows ?? []) {
+        const schedules = Array.isArray(workflow.schedules) ? workflow.schedules : [];
+        schedules.forEach((schedule, index) => {
+            const scheduleId = `${envelope.versionId}:${workflow.id}:${schedule.name ?? index}`;
+            const registrationDisabled = schedule.enabled === false;
+            const envFiltered = Array.isArray(schedule.environments)
+                ? !schedule.environments.includes(environment)
+                : false;
+            let nextRunAt = null;
+            if (!registrationDisabled && !envFiltered) {
+                try {
+                    const fire = computeNextFire(schedule, now);
+                    nextRunAt = Number.isFinite(fire) ? fire : null;
+                }
+                catch (err) {
+                    deps.logger?.("warn", "schedules: cannot compute next fire", {
+                        workflowId: workflow.id,
+                        scheduleId,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                    nextRunAt = null;
+                }
+            }
+            const enabled = !registrationDisabled && !envFiltered;
+            const disabledReason = registrationDisabled
+                ? "registration_disabled"
+                : envFiltered
+                    ? "env_filtered"
+                    : undefined;
+            data.push({
+                workflowId: workflow.id,
+                scheduleId,
+                schedule,
+                nextRunAt,
+                enabled,
+                ...(disabledReason ? { disabledReason } : {}),
+            });
+        });
+    }
+    const response = {
+        environment,
+        versionId: envelope.versionId,
+        data,
+        ...(deps.schedulesEnabledByEnv !== undefined
+            ? { schedulesEnabledByEnv: deps.schedulesEnabledByEnv }
+            : {}),
+    };
+    return json(200, response);
+}
+function json(status, body) {
+    return new Response(JSON.stringify(body), {
+        status,
+        headers: {
+            "content-type": "application/json; charset=utf-8",
+            "access-control-allow-origin": "*",
+            "access-control-allow-methods": "GET,POST,OPTIONS",
+            "access-control-allow-headers": "content-type, x-voyant-protocol",
+        },
+    });
+}

package/dist/worker.d.ts

@@ -25,10 +25,19 @@ export interface WorkerFetchDeps<Id = unknown> {
     now?: () => number;
     /**
      * Optional KV-backed manifest store. When set, the worker also serves
-     * `/api/manifests` and `/api/events`. When unset, those routes 404 —
-     * useful for orchestrators that only expose the run surface.
+     * `/api/manifests`, `/api/schedules`, and `/api/events`. When unset,
+     * those routes 404 — useful for orchestrators that only expose the
+     * run surface.
      */
     manifestStore?: CfManifestStore;
+    /**
+     * Optional process-wide schedules toggle reported by
+     * `/api/schedules/:env`. Used by the workflow-schedules UI to show
+     * "schedules disabled by env flag" when the orchestrator is running
+     * with `VOYANT_WORKFLOWS_ENABLE_SCHEDULES` (or equivalent) turned off.
+     * When omitted, the schedules response leaves the flag out.
+     */
+    schedulesEnabledByEnv?: boolean;
     /**
      * Tenant metadata stamped on event-triggered runs. Defaults to
      * `{ tenantId: "default", projectId: "default", organizationId: "default" }`.

package/dist/worker.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAS7D;;;;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;;;;;OAKG;IACH,aAAa,CAAC,EAAE,eAAe,CAAA;IAC/B;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,OAAO,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,CAmNnB"}

package/dist/worker.js

@@ -14,6 +14,7 @@
 import { buildResumeJournal, buildSeededResumeJournal, } from "@voyantjs/workflows-orchestrator";
 import { handleIngestEvent } from "./event-handler.js";
 import { handleGetManifest, handleRegisterManifest } from "./manifest-handler.js";
+import { handleGetSchedules } from "./schedule-handler.js";
 const DEFAULT_TENANT_META = {
     tenantId: "default",
     projectId: "default",
@@ -60,6 +61,20 @@ export async function handleWorkerRequest(req, deps) {
                 logger: deps.logger,
             });
         }
+        // GET /api/schedules/:env — aggregate scheduled-workflow view.
+        const schedulesMatch = url.pathname.match(/^\/api\/schedules\/([^/]+)$/);
+        if (schedulesMatch) {
+            if (!deps.manifestStore) {
+                return json(404, { error: "schedules_not_configured" });
+            }
+            const env = decodeURIComponent(schedulesMatch[1] ?? "");
+            return handleGetSchedules(env, {
+                manifestStore: deps.manifestStore,
+                schedulesEnabledByEnv: deps.schedulesEnabledByEnv,
+                now: deps.now,
+                logger: deps.logger,
+            });
+        }
     }
     // POST /api/events — synchronous event ingest. Loads the manifest,
     // routes filters, forwards each match to the run-DO trigger flow.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/workflows-orchestrator-cloudflare",
-  "version": "0.66.6",
+  "version": "0.69.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.66.6",
-    "@voyantjs/workflows": "0.66.6"
+    "@voyantjs/workflows-orchestrator": "0.69.0",
+    "@voyantjs/workflows": "0.69.0"
   },
   "devDependencies": {
     "@cloudflare/vitest-pool-workers": "^0.15.1",

package/src/index.ts

@@ -77,6 +77,12 @@ export {
   type PresignArgs,
   type R2PresignerOptions,
 } from "./r2-sign.js"
+export {
+  handleGetSchedules,
+  type ScheduleHandlerDeps,
+  type ScheduleListResponse,
+  type ScheduleSummary,
+} from "./schedule-handler.js"
 export * from "./types.js"
 export {
   type DurableObjectNamespaceLike,

package/src/schedule-handler.ts

@@ -0,0 +1,144 @@
+// HTTP handler for `/api/schedules/:env`. Reads the registered manifest
+// for the requested environment, projects each workflow's schedule blocks
+// into a flat list, and computes `nextRun` per entry via the same cron /
+// every / at logic the live scheduler uses.
+//
+// Aggregate "lastRun" is intentionally out of scope here — runs in the
+// Cloudflare orchestrator live in per-run Durable Objects, indexed by
+// runId, with no list-by-workflow path. The UI is expected to fetch
+// last-run state separately from the template-side `workflow-runs`
+// admin API (`/v1/admin/workflow-runs?workflowName=…&limit=1`).
+
+import type { ManifestSchedule, WorkflowManifest } from "@voyantjs/workflows/protocol"
+import { computeNextFire } from "@voyantjs/workflows-orchestrator"
+
+import type { CfManifestStore } from "./manifest-kv-store.js"
+
+const ALLOWED_ENVS = new Set(["production", "preview", "development"])
+
+export interface ScheduleHandlerDeps {
+  manifestStore: CfManifestStore
+  /**
+   * Process-wide schedules toggle. The Voyant Cloud orchestrator gates
+   * scheduler ticks behind `VOYANT_WORKFLOWS_ENABLE_SCHEDULES`; the UI
+   * surfaces that flag so operators can tell at a glance whether any
+   * schedule will fire even if `enabled: true` on the registration.
+   *
+   * When omitted, the response omits `schedulesEnabledByEnv` so older
+   * UIs can ignore the field.
+   */
+  schedulesEnabledByEnv?: boolean
+  now?: () => number
+  logger?: (level: "info" | "warn" | "error", msg: string, data?: object) => void
+}
+
+export interface ScheduleSummary {
+  workflowId: string
+  scheduleId: string
+  schedule: ManifestSchedule
+  /** Epoch millis of the next computed fire, or null when undecidable. */
+  nextRunAt: number | null
+  /**
+   * False when the registration explicitly sets `enabled: false`, or
+   * when the registration's `environments` list excludes the requested
+   * environment.
+   */
+  enabled: boolean
+  disabledReason?: "registration_disabled" | "env_filtered"
+}
+
+export interface ScheduleListResponse {
+  environment: string
+  versionId: string
+  schedulesEnabledByEnv?: boolean
+  data: ScheduleSummary[]
+}
+
+/**
+ * Handle `GET /api/schedules/:env`. Returns the projected schedule list
+ * for the current manifest, or 404 when no manifest is registered.
+ */
+export async function handleGetSchedules(
+  environment: string,
+  deps: ScheduleHandlerDeps,
+): Promise<Response> {
+  if (!ALLOWED_ENVS.has(environment)) {
+    return json(400, {
+      error: "invalid_environment",
+      message: `environment must be one of ${[...ALLOWED_ENVS].join(", ")}`,
+    })
+  }
+
+  const envelope = await deps.manifestStore.getCurrent(environment)
+  if (!envelope) {
+    return json(404, { error: "not_found", environment })
+  }
+
+  const now = deps.now ? deps.now() : Date.now()
+  const manifest = envelope.manifest as unknown as WorkflowManifest
+  const data: ScheduleSummary[] = []
+
+  for (const workflow of manifest.workflows ?? []) {
+    const schedules = Array.isArray(workflow.schedules) ? workflow.schedules : []
+    schedules.forEach((schedule, index) => {
+      const scheduleId = `${envelope.versionId}:${workflow.id}:${schedule.name ?? index}`
+      const registrationDisabled = schedule.enabled === false
+      const envFiltered = Array.isArray(schedule.environments)
+        ? !schedule.environments.includes(environment as never)
+        : false
+
+      let nextRunAt: number | null = null
+      if (!registrationDisabled && !envFiltered) {
+        try {
+          const fire = computeNextFire(schedule, now)
+          nextRunAt = Number.isFinite(fire) ? fire : null
+        } catch (err) {
+          deps.logger?.("warn", "schedules: cannot compute next fire", {
+            workflowId: workflow.id,
+            scheduleId,
+            error: err instanceof Error ? err.message : String(err),
+          })
+          nextRunAt = null
+        }
+      }
+
+      const enabled = !registrationDisabled && !envFiltered
+      const disabledReason = registrationDisabled
+        ? "registration_disabled"
+        : envFiltered
+          ? "env_filtered"
+          : undefined
+
+      data.push({
+        workflowId: workflow.id,
+        scheduleId,
+        schedule,
+        nextRunAt,
+        enabled,
+        ...(disabledReason ? { disabledReason } : {}),
+      })
+    })
+  }
+
+  const response: ScheduleListResponse = {
+    environment,
+    versionId: envelope.versionId,
+    data,
+    ...(deps.schedulesEnabledByEnv !== undefined
+      ? { schedulesEnabledByEnv: deps.schedulesEnabledByEnv }
+      : {}),
+  }
+  return json(200, response)
+}
+
+function json(status: number, body: unknown): Response {
+  return new Response(JSON.stringify(body), {
+    status,
+    headers: {
+      "content-type": "application/json; charset=utf-8",
+      "access-control-allow-origin": "*",
+      "access-control-allow-methods": "GET,POST,OPTIONS",
+      "access-control-allow-headers": "content-type, x-voyant-protocol",
+    },
+  })
+}

package/src/worker.ts

@@ -22,6 +22,7 @@ import {
 import { handleIngestEvent } from "./event-handler.js"
 import { handleGetManifest, handleRegisterManifest } from "./manifest-handler.js"
 import type { CfManifestStore } from "./manifest-kv-store.js"
+import { handleGetSchedules } from "./schedule-handler.js"
 
 const DEFAULT_TENANT_META = {
   tenantId: "default",
@@ -54,10 +55,19 @@ export interface WorkerFetchDeps<Id = unknown> {
   now?: () => number
   /**
    * Optional KV-backed manifest store. When set, the worker also serves
-   * `/api/manifests` and `/api/events`. When unset, those routes 404 —
-   * useful for orchestrators that only expose the run surface.
+   * `/api/manifests`, `/api/schedules`, and `/api/events`. When unset,
+   * those routes 404 — useful for orchestrators that only expose the
+   * run surface.
    */
   manifestStore?: CfManifestStore
+  /**
+   * Optional process-wide schedules toggle reported by
+   * `/api/schedules/:env`. Used by the workflow-schedules UI to show
+   * "schedules disabled by env flag" when the orchestrator is running
+   * with `VOYANT_WORKFLOWS_ENABLE_SCHEDULES` (or equivalent) turned off.
+   * When omitted, the schedules response leaves the flag out.
+   */
+  schedulesEnabledByEnv?: boolean
   /**
    * Tenant metadata stamped on event-triggered runs. Defaults to
    * `{ tenantId: "default", projectId: "default", organizationId: "default" }`.
@@ -118,6 +128,21 @@ export async function handleWorkerRequest<Id>(
         logger: deps.logger,
       })
     }
+
+    // GET /api/schedules/:env — aggregate scheduled-workflow view.
+    const schedulesMatch = url.pathname.match(/^\/api\/schedules\/([^/]+)$/)
+    if (schedulesMatch) {
+      if (!deps.manifestStore) {
+        return json(404, { error: "schedules_not_configured" })
+      }
+      const env = decodeURIComponent(schedulesMatch[1] ?? "")
+      return handleGetSchedules(env, {
+        manifestStore: deps.manifestStore,
+        schedulesEnabledByEnv: deps.schedulesEnabledByEnv,
+        now: deps.now,
+        logger: deps.logger,
+      })
+    }
   }
 
   // POST /api/events — synchronous event ingest. Loads the manifest,