@ewhauser/world-celld 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to this project will be documented in this file.
 
+## 0.3.0 (2026-08-16)
+
+## What's Changed
+* fix: split Release Please release and PR phases by @ewhauser in https://github.com/ewhauser/world-celld/pull/16
+* feat: target Workflow 5 beta by @ewhauser in https://github.com/ewhauser/world-celld/pull/17
+* fix: enforce Workflow 5 storage contracts by @ewhauser in https://github.com/ewhauser/world-celld/pull/19
+
+
+**Full Changelog**: https://github.com/ewhauser/world-celld/compare/v0.2.0...v0.3.0
+
 ## 0.2.0 (2026-08-16)
 
 ## What's Changed

package/README.md

@@ -125,7 +125,7 @@ celld worker router
           |
           | HTTP callbacks
           v
-Workflow application /.well-known/workflow/v1/{flow|step}
+Workflow application /.well-known/workflow/v1/flow
 ```
 
 The application-side package implements the Workflow `World` interface and

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { CreateEventRequest, Event, Hook, RunCreatedEventRequest, Step, TerminalWorkflowRunStatus, ValidQueueName, WorkflowRun, World } from "@workflow/world";
+import { CreateEventParams, CreateEventRequest, Event, Hook, RunCreatedEventRequest, Step, TerminalWorkflowRunStatus, ValidQueueName, Wait, WorkflowRun, World } from "@workflow/world";
 //#region src/retention.d.ts
 type CleanupPhase = 'retained' | 'index' | 'streams' | 'queues' | 'payload' | 'tombstoned';
 interface CleanupRecord {
@@ -69,6 +69,8 @@ interface ApplyEventRequest {
   /** The effective run id (already resolved / generated by the caller). */
   runId: string;
   data: CreateEventRequest | RunCreatedEventRequest;
+  /** Workflow 5 event-log position and preload options. */
+  params?: CreateEventParams;
   /**
    * Current holder of the hook token per the global KV token index
    * (hook_created only). `null` means the token is unclaimed.
@@ -80,7 +82,7 @@ interface ApplyEventRequest {
   /** Internal world-celld retention policy captured with the event. */
   cleanup?: ScheduleCleanupRequest;
 }
-type ApplyEventErrorCode = 'RUN_NOT_FOUND' | 'STEP_NOT_FOUND' | 'HOOK_NOT_FOUND' | 'ENTITY_CONFLICT' | 'RUN_EXPIRED' | 'TOO_EARLY' | 'RUN_NOT_SUPPORTED' | 'LEGACY_RUN_NOT_SUPPORTED';
+type ApplyEventErrorCode = 'RUN_NOT_FOUND' | 'STEP_NOT_FOUND' | 'HOOK_NOT_FOUND' | 'WAIT_NOT_FOUND' | 'ENTITY_CONFLICT' | 'RUN_EXPIRED' | 'TOO_EARLY' | 'RUN_NOT_SUPPORTED';
 interface ApplyEventFailure {
   ok: false;
   code: ApplyEventErrorCode;
@@ -97,6 +99,9 @@ interface ApplyEventSuccess {
   run?: WorkflowRun;
   step?: Step;
   hook?: Hook;
+  wait?: Wait;
+  /** True when a lazy step_started atomically created its step. */
+  stepCreated?: true;
   /** Hooks whose tokens must be released from the global KV index. */
   releasedHooks: Array<{
     hookId: string;
@@ -111,6 +116,11 @@ interface ApplyEventSuccess {
   hookToIndex?: Hook;
   /** All events (ascending), preloaded for run_started responses. */
   events?: Event[];
+  /** Pagination metadata required whenever events are returned. */
+  cursor?: string | null;
+  hasMore?: boolean;
+  /** Server-owned event ceiling advertised on run lifecycle writes. */
+  maxEvents?: number;
 }
 type ApplyEventOutcome = ApplyEventSuccess | ApplyEventFailure;
 //#endregion
@@ -200,7 +210,7 @@ interface StreamDOId {
 }
 //#endregion
 //#region src/queue.d.ts
-type Pathname = 'flow' | 'step';
+type Pathname = 'flow';
 /**
  * Enqueue request accepted by a QueueDO cell. The message payload travels
  * pre-encoded with the shared tagged-JSON codec (`body`), so the cell can
@@ -223,7 +233,7 @@ interface EnqueueRequest {
   config: QueueCellConfig;
 }
 interface QueueCellConfig {
-  /** Base URL of the app; deliveries POST to `${baseUrl}/.well-known/workflow/v1/{flow|step}`. */
+  /** Base URL of the app; deliveries POST to `${baseUrl}/.well-known/workflow/v1/flow`. */
   targetBaseUrl: string;
   queueShards: number;
 }
@@ -312,7 +322,7 @@ interface CelldWorldConfig {
   deploymentId?: string;
   /**
    * Base URL the app's workflow endpoints are mounted on; QueueDO cells
-   * deliver to `${baseUrl}/.well-known/workflow/v1/{flow|step}`.
+   * deliver to `${baseUrl}/.well-known/workflow/v1/flow`.
    * Default: process.env.WORKFLOW_BASE_URL || `http://localhost:${PORT ?? 3000}`
    */
   baseUrl?: string;

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/streamer.ts","../src/queue.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/streamer.ts","../src/queue.ts","../src/config.ts","../src/index.ts"],"mappings":"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"}

package/dist/index.js

@@ -294,10 +294,7 @@ function isPermanentError(err) {
 function computeBackoff(attempt) {
 	return Math.min(60, 2 ** attempt);
 }
-const QUEUE_PATHNAMES = {
-	workflow: "flow",
-	step: "step"
-};
+const QUEUE_PATHNAME = "flow";
 function isTestMode() {
 	if (process.env.CELLD_QUEUE_MODE === "cells") return false;
 	return process.env.VITEST === "true" || process.env.NODE_ENV === "test";
@@ -321,9 +318,8 @@ function shardFor(key, shards) {
 	return (hash >>> 0) % shards;
 }
 /**
-* In-process test pump. Holds two in-memory FIFOs and HTTP-dispatches
-* envelopes to the user's server at
-* `${baseUrl}/.well-known/workflow/v1/{flow|step}`.
+* In-process test pump. Holds an in-memory FIFO and HTTP-dispatches envelopes
+* to the user's server at `${baseUrl}/.well-known/workflow/v1/flow`.
 *
 * Mirrors world-local's idempotency semantics: messages are deduplicated on
 * `idempotencyKey` while a message with the same key is in flight, and the
@@ -337,14 +333,8 @@ function createTestPump(config) {
 	const httpTimeoutMs = config.httpTimeoutMs ?? 3e5;
 	const maxAttempts = config.maxAttempts ?? 5;
 	const baseBackoffMs = config.backoffDelayMs ?? 1e3;
-	const queues = {
-		flow: [],
-		step: []
-	};
-	const wakers = {
-		flow: [],
-		step: []
-	};
+	const queues = { flow: [] };
+	const wakers = { flow: [] };
 	/** Inflight messageIds by idempotencyKey (world-local queue.js semantics). */
 	const inflightMessages = /* @__PURE__ */ new Map();
 	let running = false;
@@ -437,7 +427,6 @@ function createTestPump(config) {
 			if (running) return;
 			running = true;
 			loop("flow");
-			loop("step");
 		},
 		stop() {
 			running = false;
@@ -456,13 +445,13 @@ function createQueue(config) {
 	};
 	return {
 		async queue(queueName, message, opts) {
-			const { kind } = parseQueueName(queueName);
-			const runId = "runId" in message ? message.runId : "workflowRunId" in message ? message.workflowRunId : void 0;
+			parseQueueName(queueName);
+			const runId = "runId" in message && typeof message.runId === "string" ? message.runId : void 0;
 			if (isTestMode()) {
 				const existing = testPump.inflight(opts?.idempotencyKey);
 				if (existing) return { messageId: existing };
 				const messageId = MessageId.parse(`msg_${generateMessageId()}`);
-				testPump.push(QUEUE_PATHNAMES[kind], {
+				testPump.push(QUEUE_PATHNAME, {
 					messageId,
 					queueName,
 					attempt: 1,
@@ -476,7 +465,7 @@ function createQueue(config) {
 			const outcome = await getQueueStub(shard).enqueue({
 				messageId,
 				queueName,
-				pathname: QUEUE_PATHNAMES[kind],
+				pathname: QUEUE_PATHNAME,
 				body: stringify(message),
 				runId,
 				idempotencyKey: opts?.idempotencyKey,
@@ -589,11 +578,11 @@ function throwOutcomeError(outcome, runId, data) {
 		case "RUN_NOT_FOUND": throw new WorkflowRunNotFoundError(runId);
 		case "STEP_NOT_FOUND": throw new WorkflowWorldError(outcome.message, { status: 404 });
 		case "HOOK_NOT_FOUND": throw new HookNotFoundError(data.correlationId ?? runId);
+		case "WAIT_NOT_FOUND": throw new WorkflowWorldError(outcome.message, { status: 404 });
 		case "ENTITY_CONFLICT": throw new EntityConflictError(outcome.message);
 		case "RUN_EXPIRED": throw new RunExpiredError(outcome.message);
 		case "TOO_EARLY": throw new TooEarlyError(outcome.message, { retryAfter: outcome.retryAfterSeconds });
 		case "RUN_NOT_SUPPORTED": throw new RunNotSupportedError(outcome.runSpecVersion ?? 0, SPEC_VERSION_CURRENT);
-		case "LEGACY_RUN_NOT_SUPPORTED": throw new WorkflowWorldError(outcome.message, { status: 422 });
 	}
 }
 const parseRun = (run) => WorkflowRunSchema.parse(compact(run));
@@ -671,7 +660,7 @@ function createStorage(config) {
 			}
 		},
 		events: {
-			async create(runId, data, _params) {
+			async create(runId, data, params) {
 				let effectiveRunId;
 				if (data.eventType === "run_created" && (!runId || runId === "")) effectiveRunId = `wrun_${ulid()}`;
 				else if (!runId) throw new WorkflowWorldError("runId is required for non-run_created events", { status: 400 });
@@ -692,6 +681,7 @@ function createStorage(config) {
 					outcome = await stub.applyEvent({
 						runId: effectiveRunId,
 						data,
+						params,
 						tokenHolder,
 						cleanup
 					});
@@ -727,12 +717,20 @@ function createStorage(config) {
 						eventId: outcome.event.eventId
 					}));
 				}
+				const eventPage = outcome.events === void 0 ? {} : {
+					events: outcome.events,
+					cursor: outcome.cursor ?? null,
+					hasMore: outcome.hasMore ?? false
+				};
 				return {
 					event: outcome.event,
 					run: outcome.run,
 					step: outcome.step,
 					hook: outcome.hook,
-					events: outcome.events
+					wait: outcome.wait,
+					stepCreated: outcome.stepCreated,
+					maxEvents: outcome.maxEvents,
+					...eventPage
 				};
 			},
 			async get(runId, eventId, _params) {
@@ -756,23 +754,30 @@ function createStorage(config) {
 			},
 			async listByCorrelationId(params) {
 				const limit = params.pagination?.limit ?? 100;
-				const prefix = `correlation:${encodeURIComponent(params.correlationId)}:`;
-				const listed = await env.WORKFLOW_INDEX.list({
-					prefix,
-					limit,
-					cursor: params.pagination?.cursor,
-					reverse: params.pagination?.sortOrder === "desc"
-				});
+				const stub = getRunDO(params.runId);
+				const matches = [];
+				let scanCursor = params.pagination?.cursor;
+				let exhausted = false;
+				while (matches.length <= limit && !exhausted) {
+					const page = unwrapRead(await stub.listEvents({
+						limit: Math.min(1e3, Math.max(50, limit + 1)),
+						cursor: scanCursor,
+						sortOrder: params.pagination?.sortOrder ?? "asc"
+					}));
+					for (const event of page.data) if (event.correlationId === params.correlationId) {
+						matches.push(event);
+						if (matches.length > limit) break;
+					}
+					exhausted = !page.hasMore;
+					scanCursor = page.cursor ?? page.data.at(-1)?.eventId;
+					if (page.data.length === 0) exhausted = true;
+				}
+				const hasMore = matches.length > limit;
+				const data = matches.slice(0, limit);
 				return {
-					data: (await Promise.all(listed.keys.map(async ({ name }) => {
-						const raw = await env.WORKFLOW_INDEX.get(name);
-						if (!raw) return null;
-						const { runId, eventId } = JSON.parse(raw);
-						const outcome = await getRunDO(runId).getEvent(eventId);
-						return outcome.ok ? outcome.value : null;
-					}))).filter((event) => event !== null).map(parseEvent),
-					cursor: listed.list_complete ? null : listed.cursor ?? null,
-					hasMore: !listed.list_complete
+					data: data.map(parseEvent),
+					cursor: hasMore ? data.at(-1)?.eventId ?? null : null,
+					hasMore
 				};
 			}
 		},
@@ -858,75 +863,87 @@ function createStreamer(config) {
 		await getRunRegistryDO(runId).registerStream(runId, name);
 		registeredStreams.add(cacheKey);
 	}
-	return {
-		async writeToStream(name, runId, chunk) {
-			const resolvedRunId = await runId;
-			await registerStreamForRun(name, resolvedRunId);
-			await getStreamDO(name).writeChunk(resolvedRunId, toBytes(chunk));
-		},
-		async closeStream(name, runId) {
-			const resolvedRunId = await runId;
-			await registerStreamForRun(name, resolvedRunId);
-			await getStreamDO(name).closeStream(resolvedRunId);
-		},
-		async readFromStream(name, startIndex = 0) {
-			const stub = getStreamDO(name);
-			let nextIndex;
-			if (startIndex < 0) {
-				const info = await stub.getInfo();
-				nextIndex = Math.max(0, info.tailIndex + 1 + startIndex);
-			} else nextIndex = startIndex;
-			let cancelled = false;
-			return new ReadableStream({
-				async pull(controller) {
-					while (true) {
-						if (cancelled) return;
-						const { chunks, done } = await stub.getChunks({
-							startIndex: nextIndex,
-							limit: READ_BATCH_SIZE
-						});
-						if (chunks.length > 0) {
-							for (const chunk of chunks) controller.enqueue(chunk);
-							nextIndex += chunks.length;
-							return;
-						}
-						if (done) {
-							controller.close();
-							return;
-						}
-						await new Promise((resolve) => setTimeout(resolve, readPollMs));
+	const writeToStream = async (name, runId, chunk) => {
+		const resolvedRunId = await runId;
+		await registerStreamForRun(name, resolvedRunId);
+		await getStreamDO(name).writeChunk(resolvedRunId, toBytes(chunk));
+	};
+	const closeStream = async (name, runId) => {
+		const resolvedRunId = await runId;
+		await registerStreamForRun(name, resolvedRunId);
+		await getStreamDO(name).closeStream(resolvedRunId);
+	};
+	const readFromStream = async (name, startIndex = 0) => {
+		const stub = getStreamDO(name);
+		let nextIndex;
+		if (startIndex < 0) {
+			const info = await stub.getInfo();
+			nextIndex = Math.max(0, info.tailIndex + 1 + startIndex);
+		} else nextIndex = startIndex;
+		let cancelled = false;
+		return new ReadableStream({
+			async pull(controller) {
+				while (true) {
+					if (cancelled) return;
+					const { chunks, done } = await stub.getChunks({
+						startIndex: nextIndex,
+						limit: READ_BATCH_SIZE
+					});
+					if (chunks.length > 0) {
+						for (const chunk of chunks) controller.enqueue(chunk);
+						nextIndex += chunks.length;
+						return;
 					}
-				},
-				cancel() {
-					cancelled = true;
+					if (done) {
+						controller.close();
+						return;
+					}
+					await new Promise((resolve) => setTimeout(resolve, readPollMs));
 				}
-			});
-		},
-		async listStreamsByRunId(runId) {
-			return getRunRegistryDO(runId).listStreams();
-		},
-		async getStreamChunks(name, _runId, options) {
-			const limit = Math.min(options?.limit ?? DEFAULT_CHUNK_PAGE_SIZE, MAX_CHUNK_PAGE_SIZE);
-			const startIndex = options?.cursor ? Number.parseInt(options.cursor, 10) : 0;
-			if (Number.isNaN(startIndex) || startIndex < 0) throw new Error(`Invalid stream cursor: ${options?.cursor}`);
-			const result = await getStreamDO(name).getChunks({
-				startIndex,
-				limit: limit + 1
-			});
-			const hasMore = result.chunks.length > limit;
-			return {
-				data: result.chunks.slice(0, limit).map((chunk, offset) => ({
-					index: startIndex + offset,
-					data: chunk
-				})),
-				cursor: hasMore ? String(startIndex + limit) : null,
-				hasMore,
-				done: result.done
-			};
+			},
+			cancel() {
+				cancelled = true;
+			}
+		});
+	};
+	const listStreamsByRunId = (runId) => getRunRegistryDO(runId).listStreams();
+	const getStreamChunks = async (name, _runId, options) => {
+		const limit = Math.min(options?.limit ?? DEFAULT_CHUNK_PAGE_SIZE, MAX_CHUNK_PAGE_SIZE);
+		const startIndex = options?.cursor ? Number.parseInt(options.cursor, 10) : 0;
+		if (Number.isNaN(startIndex) || startIndex < 0) throw new Error(`Invalid stream cursor: ${options?.cursor}`);
+		const result = await getStreamDO(name).getChunks({
+			startIndex,
+			limit: limit + 1
+		});
+		const hasMore = result.chunks.length > limit;
+		return {
+			data: result.chunks.slice(0, limit).map((chunk, offset) => ({
+				index: startIndex + offset,
+				data: chunk
+			})),
+			cursor: hasMore ? String(startIndex + limit) : null,
+			hasMore,
+			done: result.done
+		};
+	};
+	const getStreamInfo = (name, _runId) => getStreamDO(name).getInfo();
+	return {
+		streams: {
+			write: (runId, name, chunk) => writeToStream(name, runId, chunk),
+			close: (runId, name) => closeStream(name, runId),
+			get: (runId, name, startIndex) => {
+				return readFromStream(name, startIndex);
+			},
+			list: listStreamsByRunId,
+			getChunks: (runId, name, options) => getStreamChunks(name, runId, options),
+			getInfo: (runId, name) => getStreamInfo(name, runId)
 		},
-		async getStreamInfo(name, _runId) {
-			return getStreamDO(name).getInfo();
-		}
+		writeToStream,
+		closeStream,
+		readFromStream,
+		listStreamsByRunId,
+		getStreamChunks,
+		getStreamInfo
 	};
 }
 //#endregion