@swirls/looms 0.5.0 → 0.5.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @swirls/looms
 
+## 0.5.2
+
+### Patch Changes
+
+- a51bc1a: Allow Durable Object hosts to pass an `EffectWorker` through `LoomsDurableObjectConfig.worker` so queue-routed effects can leave the cell.
+
+## 0.5.1
+
+### Patch Changes
+
+- 86280a0: Export `@swirls/looms/cloudflare/queues` so Bun/Node pull consumers can load queue helpers without importing `cloudflare:workers`.
+
 ## 0.5.0
 
 ### Minor Changes

package/dist/actor/cell.d.ts

@@ -1,5 +1,5 @@
 import { type AnyRuntimeModule, type DefinitionResolver, type EventInput, type EventStore, type EventStoreTrimCoverage, type LaunchRunArgs, type RunLauncher, type RunState, type RunStatusSnapshot, type SnapshotStore } from '@swirls/looms/core';
-import { type Authorize, type LoomsRuntime, type StartResult, type StartRunArgs, type WakeScheduler } from '@swirls/looms/runtime';
+import { type Authorize, type EffectWorker, type LoomsRuntime, type StartResult, type StartRunArgs, type WakeScheduler } from '@swirls/looms/runtime';
 export interface ActorCellOptions<TModules extends readonly AnyRuntimeModule[] = readonly AnyRuntimeModule[]> {
     readonly runId: string;
     readonly store: EventStore;
@@ -19,6 +19,11 @@ export interface ActorCellOptions<TModules extends readonly AnyRuntimeModule[] =
     readonly authorize?: Authorize;
     /** Starts runs from effect handlers. Required for schedules; there is no default inside a cell. */
     readonly launcher?: RunLauncher;
+    /**
+     * Dispatches `execution: 'worker'` effects out of the cell (for example a
+     * Cloudflare Queue producer). Without it, worker effects cannot leave the object.
+     */
+    readonly worker?: EffectWorker;
 }
 export interface ActorCell<TModules extends readonly AnyRuntimeModule[] = readonly AnyRuntimeModule[]> {
     readonly runId: string;

package/dist/actor/cell.js

@@ -14,6 +14,7 @@ export function createActorCell(options) {
         store,
         scheduler,
         launcher: options.launcher,
+        worker: options.worker,
         snapshotEvery: options.snapshotEvery,
         maxWakeIterations: options.maxWakeIterations,
         maxPendingRunOperations: options.maxPendingRunOperations,

package/dist/cloudflare/durable-object.d.ts

@@ -1,7 +1,7 @@
 import { DurableObject } from 'cloudflare:workers';
 import { type AnyRuntimeModule, type DefinitionResolver, type EventInput, type BlobStore, type EventStoreTrimCoverage, type LaunchRunArgs, type RunLauncher, type RunState, type RunStatusSnapshot } from '@swirls/looms/core';
 import type { Projector } from '@swirls/looms/projectors';
-import { type Authorize, type StartResult, type StartRunArgs } from '@swirls/looms/runtime';
+import { type Authorize, type EffectWorker, type StartResult, type StartRunArgs } from '@swirls/looms/runtime';
 export interface LoomsDurableObjectConfig {
     readonly modules: readonly AnyRuntimeModule[];
     /** Loads definitions that were not registered on a module. See `CreateRuntimeOptions`. */
@@ -23,6 +23,12 @@ export interface LoomsDurableObjectConfig {
      * land in the target's object. Without it, a fire fails instead of writing into this object.
      */
     readonly launcher?: RunLauncher;
+    /**
+     * Dispatches `execution: 'worker'` effects out of this object (typically a
+     * Cloudflare Queue producer via `cloudflareQueueWorker`). Without it, worker
+     * effects cannot leave the Durable Object.
+     */
+    readonly worker?: EffectWorker;
 }
 /**
  * Base Durable Object class for hosting a Looms actor cell.

package/dist/cloudflare/durable-object.js

@@ -56,6 +56,7 @@ export class LoomsDurableObject extends DurableObject {
                 trimAfterSnapshot: config.trimAfterSnapshot,
                 authorize: config.authorize,
                 launcher: config.launcher,
+                worker: config.worker,
             });
             const delivery = store.projectorDelivery;
             const recoverProjectors = delivery

package/dist/cloudflare/queues.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Queue producer/consumer helpers that do not import `cloudflare:workers`.
+ * Prefer this entry from Bun/Node pull consumers; use `@swirls/looms/cloudflare`
+ * only inside the Workers runtime that hosts Durable Objects.
+ */
+export { createMemoryQueue, type MemoryQueue, type MemoryQueueOptions } from './memory-queue';
+export { processQueueMessage, queueConsumer, QueueTaskError, type QueueBatchLike, type QueueConsumerOptions, type QueueTask, type QueueTaskContext, type QueueTaskHandler, type WorkerCallbackClient, } from './queue-consumer';
+export { readQueueEffectMessage, type QueueEffectMessage, type QueueMessageLike, } from './queue-message';
+export { cloudflareQueuePullSource, createQueuePullConsumer, QueuePullError, type CloudflareQueuePullSourceOptions, type PulledQueueMessage, type QueueLeaseRetry, type QueuePullConsumer, type QueuePullConsumerOptions, type QueuePullResult, type QueuePullSource, } from './queue-pull';
+export { cloudflareQueueWorker, DEFAULT_MAX_QUEUE_MESSAGE_BYTES, QueueDispatchError, type CloudflareQueueWorkerOptions, type QueueProducer, type QueueRoute, } from './queue-worker';

package/dist/cloudflare/queues.js

@@ -0,0 +1,10 @@
+/**
+ * Queue producer/consumer helpers that do not import `cloudflare:workers`.
+ * Prefer this entry from Bun/Node pull consumers; use `@swirls/looms/cloudflare`
+ * only inside the Workers runtime that hosts Durable Objects.
+ */
+export { createMemoryQueue } from './memory-queue.js';
+export { processQueueMessage, queueConsumer, QueueTaskError, } from './queue-consumer.js';
+export { readQueueEffectMessage, } from './queue-message.js';
+export { cloudflareQueuePullSource, createQueuePullConsumer, QueuePullError, } from './queue-pull.js';
+export { cloudflareQueueWorker, DEFAULT_MAX_QUEUE_MESSAGE_BYTES, QueueDispatchError, } from './queue-worker.js';

package/dist/workflow/module.d.ts

@@ -143,14 +143,6 @@ export declare function workflow(options?: WorkflowModuleOptions): import("@swir
         } | undefined;
         readonly input?: import("effect/Schema").Json | undefined;
     }, import("./definitions-store").WorkflowDefinitionsTag, (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-        readonly type: "runtime.effect.retry.scheduled";
-        readonly payload: {
-            readonly effectId: string;
-            readonly attempt: number;
-            readonly nextAttemptAt: number;
-            readonly error: string;
-        };
-    }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
         readonly type: "runtime.child.close.requested";
         readonly payload: {
             readonly policy: "terminate" | "wait";
@@ -226,6 +218,14 @@ export declare function workflow(options?: WorkflowModuleOptions): import("@swir
             readonly attempt: number;
             readonly deadlineAt: number | null;
         };
+    }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+        readonly type: "runtime.effect.retry.scheduled";
+        readonly payload: {
+            readonly effectId: string;
+            readonly attempt: number;
+            readonly nextAttemptAt: number;
+            readonly error: string;
+        };
     }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
         readonly type: "runtime.effect.timed_out";
         readonly payload: {
@@ -539,14 +539,6 @@ export declare function workflow(options?: WorkflowModuleOptions): import("@swir
             };
         } | undefined;
     }, import("./definitions-store").WorkflowDefinitionsTag, (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-        readonly type: "runtime.effect.retry.scheduled";
-        readonly payload: {
-            readonly effectId: string;
-            readonly attempt: number;
-            readonly nextAttemptAt: number;
-            readonly error: string;
-        };
-    }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
         readonly type: "runtime.child.close.requested";
         readonly payload: {
             readonly policy: "terminate" | "wait";
@@ -622,6 +614,14 @@ export declare function workflow(options?: WorkflowModuleOptions): import("@swir
             readonly attempt: number;
             readonly deadlineAt: number | null;
         };
+    }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+        readonly type: "runtime.effect.retry.scheduled";
+        readonly payload: {
+            readonly effectId: string;
+            readonly attempt: number;
+            readonly nextAttemptAt: number;
+            readonly error: string;
+        };
     }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
         readonly type: "runtime.effect.timed_out";
         readonly payload: {
@@ -1113,14 +1113,6 @@ export declare function workflow(options?: WorkflowModuleOptions): import("@swir
             } | undefined;
             readonly input?: import("effect/Schema").Json | undefined;
         }, import("./definitions-store").WorkflowDefinitionsTag, (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-            readonly type: "runtime.effect.retry.scheduled";
-            readonly payload: {
-                readonly effectId: string;
-                readonly attempt: number;
-                readonly nextAttemptAt: number;
-                readonly error: string;
-            };
-        }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
             readonly type: "runtime.child.close.requested";
             readonly payload: {
                 readonly policy: "terminate" | "wait";
@@ -1196,6 +1188,14 @@ export declare function workflow(options?: WorkflowModuleOptions): import("@swir
                 readonly attempt: number;
                 readonly deadlineAt: number | null;
             };
+        }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+            readonly type: "runtime.effect.retry.scheduled";
+            readonly payload: {
+                readonly effectId: string;
+                readonly attempt: number;
+                readonly nextAttemptAt: number;
+                readonly error: string;
+            };
         }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
             readonly type: "runtime.effect.timed_out";
             readonly payload: {
@@ -1509,14 +1509,6 @@ export declare function workflow(options?: WorkflowModuleOptions): import("@swir
                 };
             } | undefined;
         }, import("./definitions-store").WorkflowDefinitionsTag, (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-            readonly type: "runtime.effect.retry.scheduled";
-            readonly payload: {
-                readonly effectId: string;
-                readonly attempt: number;
-                readonly nextAttemptAt: number;
-                readonly error: string;
-            };
-        }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
             readonly type: "runtime.child.close.requested";
             readonly payload: {
                 readonly policy: "terminate" | "wait";
@@ -1592,6 +1584,14 @@ export declare function workflow(options?: WorkflowModuleOptions): import("@swir
                 readonly attempt: number;
                 readonly deadlineAt: number | null;
             };
+        }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+            readonly type: "runtime.effect.retry.scheduled";
+            readonly payload: {
+                readonly effectId: string;
+                readonly attempt: number;
+                readonly nextAttemptAt: number;
+                readonly error: string;
+            };
         }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
             readonly type: "runtime.effect.timed_out";
             readonly payload: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swirls/looms",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Pluggable event-sourced runtime for durable agents and workflows",
   "homepage": "https://github.com/ByteSliceHQ/looms#readme",
   "bugs": {
@@ -65,6 +65,10 @@
       "types": "./dist/cloudflare/index.d.ts",
       "import": "./dist/cloudflare/index.js"
     },
+    "./cloudflare/queues": {
+      "types": "./dist/cloudflare/queues.d.ts",
+      "import": "./dist/cloudflare/queues.js"
+    },
     "./core": {
       "types": "./dist/core/index.d.ts",
       "import": "./dist/core/index.js"