@ewhauser/world-celld 0.9.0 → 0.9.1

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to this project will be documented in this file.
 
+## 0.9.1 (2026-10-13)
+
+## What's Changed
+* chore: qualify stable Workflow 5 packages for world-celld by @ewhauser in https://github.com/ewhauser/world-celld/pull/93
+* fix: repair hook index records stranded by an interrupted creation by @ewhauser in https://github.com/ewhauser/world-celld/pull/96
+
+
+**Full Changelog**: https://github.com/ewhauser/world-celld/compare/v0.9.0...v0.9.1
+
 ## 0.9.0 (2026-10-06)
 
 ## What's Changed

package/README.md

@@ -14,7 +14,7 @@ self-hosted alternative to platform-specific Workflow backends.
 
 ## World protocol compatibility
 
-This adapter supports World spec v8 with the Workflow 5 beta packages. This is
+This adapter supports World spec v8 with the Workflow 5 stable packages. This is
 a breaking upgrade for applications using a v7 Workflow runtime: that runtime
 rejects a World advertising v8. This adapter also rejects event writes to runs
 stamped v7. Keep the v7 adapter and matching Workflow packages in place until
@@ -92,6 +92,22 @@ const world = createCelldWorld({
 `WORKFLOW_BASE_URL` (or `baseUrl`) is where the native Queue bridge delivers flow
 requests. It must be reachable from every celld node.
 
+For overlapping Workflow builds, give each build a distinct `CELLD_DEPLOYMENT_ID`
+and keep its compiled workflow endpoints available while any of its runs remain
+active. Set `WORKFLOW_DEPLOYMENT_URLS` on every app that may accept hooks for those
+runs and in the primary celld worker's private `vars` to the same JSON map, for
+example `{"celld-default":"https://beta.internal","stable-v1":"https://stable.internal"}`.
+The equivalent `createCelldWorld({ deploymentUrls: { ... } })` option configures
+an app directly. Each URL must be an absolute HTTP(S) origin or base path without
+credentials, query, or fragment. Keep every mapped destination reachable from
+the Queue delivery worker. A mapped run's stored deployment ID selects its
+callback build, including for messages queued before this setting was added;
+new messages also snapshot their destination at enqueue. Missing mappings and
+unavailable destinations remain retryable rather than acknowledging the work.
+Keep the map and old build in service through the last old run and pending
+delivery. Do not change an existing deployment ID to point at different
+compiled workflow code. The in-process test queue accepts the same map.
+
 ## Deploy the worker
 
 Before deploying, you need a celld v0.6.0 fleet, `esbuild` on `PATH`, and an
@@ -227,16 +243,17 @@ post-compaction costs are recorded in
 Application options can be passed to `createCelldWorld()` unless an environment
 variable is shown below.
 
-| Option                  | Environment variable     | Default                  |
-| ----------------------- | ------------------------ | ------------------------ |
-| `fleetUrl`              | `CELLD_FLEET_URL`        | required                 |
-| `secret`                | `CELLD_WORLD_SECRET`     | required with `fleetUrl` |
-| `baseUrl`               | `WORKFLOW_BASE_URL`      | `http://localhost:$PORT` |
-| `deploymentId`          | `CELLD_DEPLOYMENT_ID`    | `celld-default`          |
-| `runRetentionMs`        | `CELLD_RUN_RETENTION_MS` | `0` (disabled)           |
-| `streamLongPollMs`      | —                        | `20000`                  |
-| `streamFlushIntervalMs` | —                        | `0`                      |
-| `rpcTimeoutMs`          | —                        | `30000` (max `300000`)   |
+| Option                  | Environment variable       | Default                  |
+| ----------------------- | -------------------------- | ------------------------ |
+| `fleetUrl`              | `CELLD_FLEET_URL`          | required                 |
+| `secret`                | `CELLD_WORLD_SECRET`       | required with `fleetUrl` |
+| `baseUrl`               | `WORKFLOW_BASE_URL`        | `http://localhost:$PORT` |
+| `deploymentId`          | `CELLD_DEPLOYMENT_ID`      | `celld-default`          |
+| `deploymentUrls`        | `WORKFLOW_DEPLOYMENT_URLS` | unset                    |
+| `runRetentionMs`        | `CELLD_RUN_RETENTION_MS`   | `0` (disabled)           |
+| `streamLongPollMs`      | —                          | `20000`                  |
+| `streamFlushIntervalMs` | —                          | `0`                      |
+| `rpcTimeoutMs`          | —                          | `30000` (max `300000`)   |
 
 The deployed worker also accepts these celld variables:
 
@@ -244,6 +261,7 @@ The deployed worker also accepts these celld variables:
 | ------------------------------- | ------- | ---------------------------------------------------- |
 | `WORLD_SECRET`                  | none    | Required bearer secret for RPC routes                |
 | `WORKFLOW_CALLBACK_SECRET`      | none    | Sent with deliveries as `x-workflow-callback-secret` |
+| `WORKFLOW_DEPLOYMENT_URLS`      | unset   | JSON map of pinned deployment IDs to callback URLs   |
 | `WORKFLOW_RETENTION_MS`         | `0`     | Maximum run age from creation; includes active runs  |
 | `WORKFLOW_RETENTION_BATCH_SIZE` | `128`   | Runs admitted by each cron sweep (maximum `1000`)    |
 

package/celld-worker/README.md

@@ -49,6 +49,15 @@ in the primary Wrangler config and redeploy to enable a maximum workflow age
 measured from run creation. celld rejects `CELLD_VAR_*` node overrides.
 `.dev.vars` overrides apply only to `celld dev`, not production deployments.
 
+To keep in-flight runs on their original compiled Workflow build, set
+`vars.WORKFLOW_DEPLOYMENT_URLS` in the private primary worker config to a JSON
+object of deployment IDs and reachable HTTP(S) callback URLs. Configure the
+same map in the applications with `WORKFLOW_DEPLOYMENT_URLS` or `deploymentUrls`.
+The worker resolves already queued run messages from the persisted run ID, so
+the map must retain old destinations until their runs and queued deliveries
+finish. Keep each old compiled app available at its mapped URL. An unknown or
+unavailable destination is retried, including a callback 404.
+
 `7776000000` is 90 days. The policy includes pending and running workflows as
 well as terminal ones. Each cron occurrence admits at most
 `WORKFLOW_RETENTION_BATCH_SIZE` runs (default `128`); the existing per-run alarm

package/celld-worker/wrangler.jsonc

@@ -48,6 +48,9 @@
     "WORLD_SECRET": "",
     // Optional: forwarded as x-workflow-callback-secret on queue deliveries.
     "WORKFLOW_CALLBACK_SECRET": "",
+    // Optional trusted JSON map of persisted deployment IDs to immutable app
+    // callback URLs. Keep celld-default mapped to its original beta build.
+    "WORKFLOW_DEPLOYMENT_URLS": "",
     // Optional fleet-wide maximum workflow age, measured from run creation.
     // Applies to pending, running, and terminal runs. "0" disables it.
     "WORKFLOW_RETENTION_MS": "0",

package/dist/index.d.ts

@@ -313,6 +313,10 @@ interface StreamDOId {
   toString(): string;
 }
 //#endregion
+//#region src/deployment-routing.d.ts
+/** Operator-owned immutable callback destinations, keyed by stored deployment ID. */
+type DeploymentUrls = Readonly<Record<string, string>>;
+//#endregion
 //#region src/queue.d.ts
 interface CelldQueueProducer {
   send(envelope: NativeQueueEnvelope, options?: NativeQueueSendOptions): Promise<NativeQueueSendResult>;
@@ -426,6 +430,8 @@ interface CelldWorldConfig {
    * Default: process.env.WORKFLOW_BASE_URL || `http://localhost:${PORT ?? 3000}`
    */
   baseUrl?: string;
+  /** Immutable callback URLs for explicitly targeted deployments. Optional. */
+  deploymentUrls?: DeploymentUrls;
   /**
    * Keep terminal run payloads for this many milliseconds before replacing
    * them with metadata-only tombstones. Zero disables automatic cleanup.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/retention.ts","../src/apply-event.ts","../src/storage.ts","../src/stream-protocol.ts","../src/streamer.ts","../src/queue.ts","../src/run-list.ts","../src/indexes.ts","../src/config.ts","../src/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/retention.ts","../src/apply-event.ts","../src/storage.ts","../src/stream-protocol.ts","../src/streamer.ts","../src/deployment-routing.ts","../src/queue.ts","../src/run-list.ts","../src/indexes.ts","../src/config.ts","../src/index.ts"],"mappings":";;;KAOY;UAEK;EACf;EACA;EACA;EACA,WAAW;;EAEX,SAAS;;EAET,cAAc;;EAEd,iBAAiB;EACjB;EACA,OAAO;EACP,OAAO;;EAEP;EACA;EACA;EACA,gBAAgB;EAChB,eAAe;EACf;EACA;;EAEA;;UAGe;EACf;EACA;;EAEA,SAAS;EACT,cAAc;EACd,iBAAiB;EACjB,WAAW;EACX,cAAc;;EAEd,SAAS;;KAGC;KAEA,eAAe;EACrB;EAAU,OAAO;;EACjB;EAAW;EAAqB;EAAiB,WAAW;;UAEjD;EACf;EACA;;UAae;EACf;EACA,OAAO;;UAGQ;EACf;;UAGe;EACf;EACA,OAAO;EACP;;UAGe;EACf;;UAGe;EACf;;UAGe;;EAEf;EACA;;UAGe;;EAEf;;EAEA;;EAEA;EACA;;UAGe;EACf;;;;UC0Ce;;EAEf;EACA,MAAM,qBAAqB;;EAE3B,SAAS;;;;;EAKT;IAAgB;IAAe;;;EAE/B;;EAEA,UAAU;;KAiFA;UAWK;EACf;EACA,MAAM;EACN;;EAEA;;EAEA;;UAGe;EACf;;EAEA,QAAQ;EACR,MAAM;EACN,OAAO;EACP,OAAO;EACP,OAAO;;EAEP;;EAEA,eAAe;IAAQ;IAAgB;;;EAEvC;IAAe;IAAsB,WAAW;;;EAEhD,cAAc;;EAEd,SAAS;;EAET;EACA;;EAEA;;EAEA;;EAEA;;EAEA;;;;;EAKA,YAAY;;KAGF,oBAAoB,oBAAoB;;;;;;;UClPnC;EACf,WAAW,SAAS,oBAAoB,QAAQ;EAChD,sBAAsB;IACpB;IACA;IACA;MACE;IAAU;;EACd,wBAAwB;IACtB;IACA;IACA;MACE,QAAQ;EACZ,sBAAsB,QADlB;EAEJ,UAAU,QAAQ,eAAe;EACjC,QAAQ,iBAAiB,QAAQ,eAAe;EAChD,SAAS,kBAAkB,QAAQ,eAAe;EAClD,WAAW;IACT;IACA;IACA;MACE,QAAQ;IAAiB,MAAM;IAAS;IAAuB;;EACnE,UAAU;IACR;IACA;IACA;MACE,QAAQ;IAAiB,MAAM;IAAQ;IAAuB;;EAClE,UAAU;IACR;IACA;IACA;MACE,QAAQ;IAAiB,MAAM;IAAQ;IAAuB;;EAClE,oBAAoB,QADhB;EAEJ,gBACE,SAFkB,yBAGjB,QADiC;EAEpC,WACE,SAFC,yBAGA,QADiC;EAEpC,gBAAgB,QADb;;UAIY;EACf,WAAW,eAAe;EAC1B,IAAI,IAAI,sBAAsB;;UAGf;EACf;;;;;;;;cChGW;;cAEA;;cAEA;;cAEA;cAKA;cACA;;cAEA;KAED;UAEK;EACf;EACA;;UAGe;EACf;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA,QAAQ;EACR,OAAO;EACP;EACA,QAAQ;;;;UClBO,sBAAsB,KAAK;EAC1C,SAAS;IACP,KAAK,eAAe,cAAc,OAAO,2BAA2B;;EAEtE,cACE,cACA,gBAAgB,iBAChB,gBAAgB,aACf;EACH,oBACE,cACA,gBAAgB,iBAChB,2BAA2B,gBAC1B;EACH,YAAY,cAAc,gBAAgB,kBAAkB;EAC5D,YACE,cACA,gBAAgB,iBAChB,OAAO,2BACN;EACH,eACE,cACA,eACA,sBACC,QAAQ,eAAe;EAC1B,mBAAmB,gBAAgB;EACnC,gBACE,cACA,eACA,UAAU,mBACT,QAAQ;EACX,cAAc,cAAc,gBAAgB,QAAQ;;;UAIrC;;;;;EAKf;;EAEA;EACA,YAAY,eAAe,QAAQ,eAAe,QAAQ;EAC1D,WAAW,SAAS,mBAAmB,SAAS,cAAc,QAAQ;EACtE,YAAY,gBAAgB;EAC5B,WAAW,eAAe,OAAO,2BAA2B;EAC5D,eAAe,eAAe,eAAe;EAC7C,eAAe;EACf,eACE,eACA,mBACA;IAAY;MACX,QAAQ;EACX,iBAAiB,eAAe,oBAAoB,QAAQ;EAC5D,aACE,eACA,mBACA;IAAY;IAAgB;MAC3B,QAAQ;;UAGI;EACf,WAAW,eAAe;EAC1B,IAAI,IAAI,aAAa;;UAGN;EACf;;;;;KCxGU,iBAAiB,SAAS;;;UCsGrB;EACf,KACE,UAAU,qBACV,UAAU,yBACT,QAAQ;;;;KCnGD,YAAY;;UAGP;EACf;EACA,WAAW;EACX;EACA;EACA;;EAEA;;UAGe;EACf,MAAM;EACN;EACA;;;;UCPe;EACf;EACA;;EAEA;EACA;EACA;;UAGe;;EAEf,MAAM;IAAQ;IAAc;IAAe;;EAC3C;EACA;;UAuBe;EACf;EACA;EACA;;KAGU;EACN;EAAgB,aAAa;;EAC7B;EAAiB,QAAQ;;;UAgDd;EACf,UACE,KAAK,aACL,4BACA,+BACC;IAAU;;EACb,SAAS,UAAU,mBAAmB,QAAQ;;;;;EAK9C,kBAAkB,SAAS,iBAAiB,QAAQ;EACpD,eAAe,gBAAgB;EAC/B,YAAY,iBAAiB;EAC7B,YAAY,eAAe,OAAO,iBAAiB,QAAQ;EAC3D,oBACE,eACA,gBACA,wBACA,OAAO,gBACP,cAAc,kBACb;EACH,uBACE,eACA,OAAO,gBACP,aAAa,kBACZ;EACH,mBAAmB,SAAS,4BAA4B,QAAQ;EAChE,UAAU,SAAS,0BAA0B,QAAQ;;;;;KC3H3C,iBAAiB;UAEZ;EACf;EACA;;UAGe;EACf,aAAa;EACb,gBAAgB;EAChB,gBAAgB;EAChB,kBAAkB;;UAGH;;;;;;;EAOf;;;;;EAKA;;;;;EAKA,MAAM;;EAEN;;;;;;EAMA;;EAEA,iBAAiB;;;;;;EAMjB;;EAEA;;EAEA;;EAEA;;;;UC3Be;EACf,UAAU,gBAAgB,QAAQ;EAClC,SAAS,gBAAgB,QAAQ;EACjC,WAAW,gBAAgB,QAAQ;EACnC,MAAM,gBAAgB,QAAQ;;KAGpB,aAAa,QAAQ;EAAkB,WAAW;;iBAS9C,iBAAiB,SAAS,mBAAmB"}

package/dist/index.js

@@ -1,4 +1,4 @@
-import { $ as normalizeStreamError, A as boundedIntegerOption, B as MAX_STREAM_LONG_POLL_MS, D as MAX_QUEUE_DERIVED_DEADLINE_HEADROOM_MS, E as MAX_QUEUE_DELIVERY_TIMEOUT_MS, F as queueDelayDeadline, G as STREAM_CHUNK_LIMIT_HEADER, H as MAX_STREAM_READ_CHUNKS, I as strictIntegerSetting, J as decodeStreamWriteResult, K as decodeStreamReadResult, L as MAX_STREAM_BATCH_BYTES, Q as isChunkLimitRejection, R as MAX_STREAM_CHUNK_BYTES, T as MAX_FLEET_RPC_TIMEOUT_MS, U as MAX_STREAM_WRITE_CHUNKS, V as MAX_STREAM_READ_BYTES, W as STREAM_BATCH_CONTENT_TYPE, X as encodeStreamWriteBatch, _ as rpcStringify, b as createWorkflowIndex, c as nativeQueueDelaySeconds, g as rpcParse, h as compact, j as checkedQueueTimestampAdd, l as queueClaimName, n as listRunsPage, v as parse, x as runIndexMetadata, y as stringify, z as MAX_STREAM_ERROR_BYTES } from "./run-list-C4B4SBYW.js";
+import { $ as encodeStreamWriteBatch, A as MAX_QUEUE_DERIVED_DEADLINE_HEADROOM_MS, B as MAX_STREAM_BATCH_BYTES, C as parseDeploymentUrls, G as MAX_STREAM_READ_CHUNKS, H as MAX_STREAM_ERROR_BYTES, J as STREAM_CHUNK_LIMIT_HEADER, K as MAX_STREAM_WRITE_CHUNKS, N as boundedIntegerOption, O as MAX_FLEET_RPC_TIMEOUT_MS, P as checkedQueueTimestampAdd, R as queueDelayDeadline, S as configuredDeploymentUrl, U as MAX_STREAM_LONG_POLL_MS, V as MAX_STREAM_CHUNK_BYTES, W as MAX_STREAM_READ_BYTES, Y as decodeStreamReadResult, Z as decodeStreamWriteResult, _ as rpcStringify, b as createWorkflowIndex, c as nativeQueueDelaySeconds, g as rpcParse, h as compact, k as MAX_QUEUE_DELIVERY_TIMEOUT_MS, l as queueClaimName, n as listRunsPage, nt as normalizeStreamError, q as STREAM_BATCH_CONTENT_TYPE, tt as isChunkLimitRejection, v as parse, w as validateDeploymentUrls, x as runIndexMetadata, y as stringify, z as strictIntegerSetting } from "./run-list-CHRaDRvU.js";
 import { CreateEventSchema, EventSchema, HookSchema, MessageId, QueuePayloadSchema, SPEC_VERSION_CURRENT, StepSchema, WaitSchema, WorkflowRunSchema, parseQueueName } from "@workflow/world";
 import { EntityConflictError, HookNotFoundError, RunExpiredError, RunNotSupportedError, TooEarlyError, WorkflowRunNotFoundError, WorkflowWorldError } from "@workflow/errors";
 import { monotonicFactory } from "ulid";
@@ -18,6 +18,7 @@ function resolveConfig(config) {
 		env: config?.env,
 		deploymentId: config?.deploymentId ?? process.env.CELLD_DEPLOYMENT_ID ?? "celld-default",
 		baseUrl: config?.baseUrl,
+		deploymentUrls: config?.deploymentUrls === void 0 ? parseDeploymentUrls(process.env.WORKFLOW_DEPLOYMENT_URLS) : validateDeploymentUrls(config.deploymentUrls),
 		runRetentionMs,
 		streamLongPollMs,
 		streamFlushIntervalMs,
@@ -609,7 +610,8 @@ function createTestPump(config) {
 		});
 	}
 	function retry(envelope, pathname, reason) {
-		if (envelope.attempt >= maxAttempts) {
+		const mappedRun = config.deploymentUrls !== void 0 && "runId" in envelope.message;
+		if (envelope.attempt >= maxAttempts && !mappedRun) {
 			release(envelope);
 			console.error(`[world-celld test pump] dropping ${envelope.messageId} after ${envelope.attempt} attempts: ${reason}`);
 			return;
@@ -627,7 +629,7 @@ function createTestPump(config) {
 		delayFor(backoff).then(() => enqueue(pathname, next));
 	}
 	async function dispatch(envelope, pathname) {
-		const url = `${resolveBaseUrl(config)}/.well-known/workflow/v1/${pathname}`;
+		const url = `${envelope.targetBaseUrl}/.well-known/workflow/v1/${pathname}`;
 		const response = await fetch(url, {
 			method: "POST",
 			headers: {
@@ -639,7 +641,7 @@ function createTestPump(config) {
 			body: stringify(envelope.message),
 			signal: AbortSignal.timeout(httpTimeoutMs)
 		});
-		if (response.ok || PERMANENT_ERROR_STATUSES.has(response.status)) {
+		if (response.ok || !config.deploymentUrls && PERMANENT_ERROR_STATUSES.has(response.status) || !("runId" in envelope.message) && PERMANENT_ERROR_STATUSES.has(response.status)) {
 			try {
 				await response.body?.cancel();
 			} catch {}
@@ -701,6 +703,7 @@ function createTestPump(config) {
 }
 function createQueue(config) {
 	const { env, deploymentId } = config;
+	const deploymentUrls = config.deploymentUrls === void 0 ? void 0 : validateDeploymentUrls(config.deploymentUrls);
 	if (!env?.WORKFLOW_QUEUE) throw new Error("world-celld queue missing WORKFLOW_QUEUE binding");
 	const generateMessageId = monotonicFactory();
 	const testPump = createTestPump(config);
@@ -711,6 +714,17 @@ function createQueue(config) {
 			if (!parsedMessage.success) throw new WorkflowWorldError("world-celld queue payload is invalid", { status: 422 });
 			if (queueDelayDeadline(Date.now(), opts?.delaySeconds ?? 0, 0, 900001) === null) throw new Error("world-celld queue delaySeconds lacks required delivery headroom");
 			const runId = "runId" in parsedMessage.data && typeof parsedMessage.data.runId === "string" ? parsedMessage.data.runId : void 0;
+			const targetIds = [
+				opts?.deploymentId,
+				"runInput" in parsedMessage.data ? parsedMessage.data.runInput?.deploymentId : void 0,
+				"runContext" in parsedMessage.data ? parsedMessage.data.runContext?.deploymentId : void 0,
+				"hookInput" in parsedMessage.data ? parsedMessage.data.hookInput?.deploymentId : void 0
+			].filter((id) => typeof id === "string");
+			if (targetIds.some((id) => id !== targetIds[0])) throw new Error("world-celld: queue deployment hints disagree");
+			const targetId = targetIds[0] ?? deploymentId;
+			if (deploymentUrls && runId && targetIds.length === 0) throw new Error("world-celld: queued run has no deployment routing hint");
+			if (!deploymentUrls && opts?.deploymentId && targetId !== deploymentId) throw new Error(`world-celld: no callback URL configured for deployment ${targetId}`);
+			const targetBaseUrl = deploymentUrls ? configuredDeploymentUrl(deploymentUrls, targetId) : resolveBaseUrl(config).replace(/\/$/, "");
 			if (isTestMode()) {
 				const existing = testPump.inflight(queueName, opts?.idempotencyKey);
 				if (existing) return { messageId: existing };
@@ -720,7 +734,8 @@ function createQueue(config) {
 					queueName,
 					attempt: 1,
 					message: parsedMessage.data,
-					idempotencyKey: opts?.idempotencyKey
+					idempotencyKey: opts?.idempotencyKey,
+					targetBaseUrl
 				}, opts?.delaySeconds);
 				return { messageId };
 			}
@@ -731,7 +746,7 @@ function createQueue(config) {
 				version: 1,
 				messageId,
 				queueName,
-				targetBaseUrl: resolveBaseUrl(config),
+				targetBaseUrl,
 				runId,
 				idempotencyKey: opts?.idempotencyKey,
 				body,
@@ -1488,7 +1503,8 @@ function createCelldWorld(config) {
 	const queue = createQueue({
 		env: { WORKFLOW_QUEUE: env.WORKFLOW_QUEUE },
 		deploymentId: resolved.deploymentId,
-		baseUrl: resolved.baseUrl
+		baseUrl: resolved.baseUrl,
+		deploymentUrls: resolved.deploymentUrls
 	});
 	const streamer = createStreamer({
 		env: { WORKFLOW_STREAMS: env.WORKFLOW_STREAMS },