@swirls/looms 0.0.1 → 0.0.2

package/CHANGELOG.md

@@ -0,0 +1,46 @@
+# @swirls/looms
+
+## 0.0.2
+
+### Patch Changes
+
+- 9f3fd62: Include the package changelog in published npm artifacts.
+
+## 0.0.1
+
+### Patch Changes
+
+- e83496a: **BREAKING**: Modules own their definitions. Pass `workflow({ definitions: [checkout] })` / `agent({ definitions: [...] })` instead of a top-level `definitions` list on `createLooms`, `createRuntime`, actor cells/hosts, or Durable Objects. Omitting `modules` installs none (no longer defaults to agent/workflow/approval).
+
+  **BREAKING**: `defineModule(options, setup)` returns the finished module. Returned `effects` / `threads` / `projections` / `definitions` are registered and exposed (e.g. `payments.effects.charge`). The old scope-only + `.build()` form is replaced by `createModuleScope` for multi-file authoring.
+
+  Compose rejects duplicate definitions and definitions whose owning module does not implement the thread kind. Starting or spawning an unsupported kind fails before run events are written; folding an unsupported kind marks the thread failed instead of inventing empty state.
+
+- ee5f92f: Initial 0.0.1 OSS release: durable Effect runtime for agents and workflows, S2 adapter, HTTP client, React bindings, CLI, optional projectors, and demo app.
+- 4c8410e: Looms DX overhaul:
+
+  - Add Standard Schema `input` typing and runtime validation for `defineAgent`, `defineWorkflow`, and `defineTool`.
+  - Provide Promise-based `createLooms()` facade with lazy init, typed start overloads, and universal `fetch(req) -> Response | null`.
+  - Add Looms-native event streaming directly against EventStore and `/api/events` (eliminating the dual-log S2 bridge).
+  - Add `s2Lite()` / `startS2Lite()` auto-starting dev process manager.
+  - Typed client generics for `createLoomsClient<typeof definitions>()`.
+  - Single server setup for dev and prod in demo app with no `effect` dependency.
+
+- 4c8410e: Introduce the generic `@swirls/looms/projectors` module. Implement `Projector` or use `memory()`,
+  `postgres({ url })`, and `sqlite({ path })`. `createLooms({ projectors })` initializes projectors,
+  wraps append, and disposes them. S2 helpers now take an explicit environment bag; `serveHttp` no
+  longer reads `PORT`.
+- f1cceb0: Optimize React SDK and Debugger for high-velocity event streaming:
+
+  - **BREAKING (`@swirls/looms/react`)**: `useRunStore(runId, options)` is now a non-subscribing handle. Subscribe via fine-grained hooks (`useProjection`, `useRunEvents`, `useRunSummary`, `useThreadTree`, `useEventCounts`, `useEventBySeq`, `useLatestEvent`, `useEventFold`, `useRunSelector`). Removed `createLoomsHooks` and `pollIntervalMs` — use `LoomsRegister` or explicit `EventsOf<…>` generics instead.
+  - **BREAKING (`@swirls/looms/react`)**: Materialized tables no longer include `events_log`; the event log lives only in `store.events()` / `EventIndex`. `StoreListener` is now `() => void` (re-read via store APIs).
+  - **Incremental Projection Caching (`@swirls/looms/react`)**: `store.project(def)` and `useProjection` fold newly arrived events from cached state (O(batch)), preserving references when unchanged.
+  - **Adaptive Coalescing (`@swirls/looms/react`)**: Default `coalesce: 'adaptive'` (macrotask when quiet, animation-frame under burst); also `frame`, `immediate`, `{ delayMs }`. Notify scheduling lives in `createNotifyScheduler`. Added `store.flush()`.
+  - **Shared `EventIndex` (`@swirls/looms/core`)**: Append-only thread/seq/count/latest indexes with lazy snapshots; used by the React client store and the debugger.
+  - **Debugger (`@swirls/looms/debugger`)**: Virtualized `EventStream` with stable default catalog, catalog-aware meta cache, and `useMemo` visibility filtering.
+
+- e398380: Publish the React integration at `@swirls/looms/react` and drop the former LiveStore protocol names.
+
+  - Package and React provider are now `@swirls/looms/react` / `LoomsProvider`.
+  - Live event HTTP is `GET /api/events?runId=` (pull or SSE). Wire batches are Looms event envelopes.
+  - `LiveStoreGlobalEncoded` is now `EncodedLoomsEvent`.

package/README.md

@@ -7,3 +7,5 @@ bun add @swirls/looms
 ```
 
 Import the core runtime from `@swirls/looms`, or use explicit modules such as `@swirls/looms/agent` and `@swirls/looms/react`. See the [repository README](https://github.com/ByteSliceHQ/looms#readme) for the full guide.
+
+Release notes are available in [`CHANGELOG.md`](./CHANGELOG.md).

package/dist/workflow/effects.d.ts

@@ -14,54 +14,58 @@ export declare const scheduleEffect: NoInfer<import("@swirls/looms/core").Effect
     } | undefined;
     readonly input?: Schema.Json | undefined;
 }, WorkflowDefinitionsTag, (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "runtime.effect.failed";
+    readonly type: "workflow.node.started";
     readonly payload: {
-        readonly effectId: string;
-        readonly error: string;
+        readonly nodeId: string;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "runtime.run.completed";
+    readonly type: "workflow.node.finished";
     readonly payload: {
-        readonly output: Schema.Json;
+        readonly nodeId: string;
+        readonly result: Schema.Json;
         readonly error: string | null;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "runtime.run.started";
+    readonly type: "workflow.node.skipped";
     readonly payload: {
-        readonly rootThreadId?: string | undefined;
+        readonly nodeId: string;
+        readonly reason: string;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "workflow.spawn.requested";
+    readonly payload: {
+        readonly nodeId: string;
+        readonly childThreadId: string;
         readonly kind: string;
         readonly definitionName: string;
         readonly input: Schema.Json;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "runtime.signal.received";
+    readonly type: "workflow.sleep.requested";
     readonly payload: {
-        readonly signalType: string;
+        readonly nodeId: string;
+        readonly waitId: string;
+        readonly wakeAt: number;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "runtime.snapshot.taken";
+    readonly type: "workflow.effects.requested";
     readonly payload: {
-        readonly seq: number;
-        readonly stateHash: string;
-        readonly state?: Schema.Json | undefined;
+        readonly nodeId: string;
+        readonly effects: readonly import("@swirls/looms/core").RuntimeEffect[];
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "runtime.thread.cancelled";
+    readonly type: "runtime.run.started";
     readonly payload: {
-        readonly threadId: string;
-        readonly reason?: string | undefined;
+        readonly rootThreadId?: string | undefined;
+        readonly kind: string;
+        readonly definitionName: string;
+        readonly input: Schema.Json;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "runtime.thread.completed";
+    readonly type: "runtime.run.completed";
     readonly payload: {
-        readonly threadId: string;
         readonly output: Schema.Json;
-    };
-}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "runtime.thread.failed";
-    readonly payload: {
-        readonly threadId: string;
-        readonly error: string;
+        readonly error: string | null;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
     readonly type: "runtime.thread.started";
@@ -73,17 +77,22 @@ export declare const scheduleEffect: NoInfer<import("@swirls/looms/core").Effect
         readonly parentThreadId: string | null;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "runtime.timer.fired";
+    readonly type: "runtime.thread.completed";
     readonly payload: {
-        readonly timerId: string;
-        readonly waitId: string;
+        readonly threadId: string;
+        readonly output: Schema.Json;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "runtime.timer.set";
+    readonly type: "runtime.thread.failed";
     readonly payload: {
-        readonly timerId: string;
-        readonly waitId: string;
-        readonly wakeAt: number;
+        readonly threadId: string;
+        readonly error: string;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.thread.cancelled";
+    readonly payload: {
+        readonly threadId: string;
+        readonly reason?: string | undefined;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
     readonly type: "runtime.wait.registered";
@@ -110,44 +119,35 @@ export declare const scheduleEffect: NoInfer<import("@swirls/looms/core").Effect
         };
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "workflow.effects.requested";
-    readonly payload: {
-        readonly nodeId: string;
-        readonly effects: readonly import("@swirls/looms/core").RuntimeEffect[];
-    };
-}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "workflow.node.finished";
+    readonly type: "runtime.timer.set";
     readonly payload: {
-        readonly nodeId: string;
-        readonly result: Schema.Json;
-        readonly error: string | null;
+        readonly timerId: string;
+        readonly waitId: string;
+        readonly wakeAt: number;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "workflow.node.skipped";
+    readonly type: "runtime.timer.fired";
     readonly payload: {
-        readonly nodeId: string;
-        readonly reason: string;
+        readonly timerId: string;
+        readonly waitId: string;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "workflow.node.started";
+    readonly type: "runtime.effect.failed";
     readonly payload: {
-        readonly nodeId: string;
+        readonly effectId: string;
+        readonly error: string;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "workflow.sleep.requested";
+    readonly type: "runtime.snapshot.taken";
     readonly payload: {
-        readonly nodeId: string;
-        readonly waitId: string;
-        readonly wakeAt: number;
+        readonly seq: number;
+        readonly stateHash: string;
+        readonly state?: Schema.Json | undefined;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "workflow.spawn.requested";
+    readonly type: "runtime.signal.received";
     readonly payload: {
-        readonly nodeId: string;
-        readonly childThreadId: string;
-        readonly kind: string;
-        readonly definitionName: string;
-        readonly input: Schema.Json;
+        readonly signalType: string;
     };
 })>>;
 export declare function scheduleEvents(definition: WorkflowDefinition, binding: {
@@ -167,54 +167,58 @@ export declare const runNodeEffect: NoInfer<import("@swirls/looms/core").EffectD
         readonly [x: string]: Schema.Json;
     } | undefined;
 }, WorkflowDefinitionsTag, (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "runtime.effect.failed";
+    readonly type: "workflow.node.started";
     readonly payload: {
-        readonly effectId: string;
-        readonly error: string;
+        readonly nodeId: string;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "runtime.run.completed";
+    readonly type: "workflow.node.finished";
     readonly payload: {
-        readonly output: Schema.Json;
+        readonly nodeId: string;
+        readonly result: Schema.Json;
         readonly error: string | null;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "runtime.run.started";
+    readonly type: "workflow.node.skipped";
     readonly payload: {
-        readonly rootThreadId?: string | undefined;
+        readonly nodeId: string;
+        readonly reason: string;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "workflow.spawn.requested";
+    readonly payload: {
+        readonly nodeId: string;
+        readonly childThreadId: string;
         readonly kind: string;
         readonly definitionName: string;
         readonly input: Schema.Json;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "runtime.signal.received";
+    readonly type: "workflow.sleep.requested";
     readonly payload: {
-        readonly signalType: string;
+        readonly nodeId: string;
+        readonly waitId: string;
+        readonly wakeAt: number;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "runtime.snapshot.taken";
+    readonly type: "workflow.effects.requested";
     readonly payload: {
-        readonly seq: number;
-        readonly stateHash: string;
-        readonly state?: Schema.Json | undefined;
+        readonly nodeId: string;
+        readonly effects: readonly import("@swirls/looms/core").RuntimeEffect[];
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "runtime.thread.cancelled";
+    readonly type: "runtime.run.started";
     readonly payload: {
-        readonly threadId: string;
-        readonly reason?: string | undefined;
+        readonly rootThreadId?: string | undefined;
+        readonly kind: string;
+        readonly definitionName: string;
+        readonly input: Schema.Json;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "runtime.thread.completed";
+    readonly type: "runtime.run.completed";
     readonly payload: {
-        readonly threadId: string;
         readonly output: Schema.Json;
-    };
-}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "runtime.thread.failed";
-    readonly payload: {
-        readonly threadId: string;
-        readonly error: string;
+        readonly error: string | null;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
     readonly type: "runtime.thread.started";
@@ -226,17 +230,22 @@ export declare const runNodeEffect: NoInfer<import("@swirls/looms/core").EffectD
         readonly parentThreadId: string | null;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "runtime.timer.fired";
+    readonly type: "runtime.thread.completed";
     readonly payload: {
-        readonly timerId: string;
-        readonly waitId: string;
+        readonly threadId: string;
+        readonly output: Schema.Json;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "runtime.timer.set";
+    readonly type: "runtime.thread.failed";
     readonly payload: {
-        readonly timerId: string;
-        readonly waitId: string;
-        readonly wakeAt: number;
+        readonly threadId: string;
+        readonly error: string;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.thread.cancelled";
+    readonly payload: {
+        readonly threadId: string;
+        readonly reason?: string | undefined;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
     readonly type: "runtime.wait.registered";
@@ -263,43 +272,34 @@ export declare const runNodeEffect: NoInfer<import("@swirls/looms/core").EffectD
         };
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "workflow.effects.requested";
-    readonly payload: {
-        readonly nodeId: string;
-        readonly effects: readonly import("@swirls/looms/core").RuntimeEffect[];
-    };
-}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "workflow.node.finished";
+    readonly type: "runtime.timer.set";
     readonly payload: {
-        readonly nodeId: string;
-        readonly result: Schema.Json;
-        readonly error: string | null;
+        readonly timerId: string;
+        readonly waitId: string;
+        readonly wakeAt: number;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "workflow.node.skipped";
+    readonly type: "runtime.timer.fired";
     readonly payload: {
-        readonly nodeId: string;
-        readonly reason: string;
+        readonly timerId: string;
+        readonly waitId: string;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "workflow.node.started";
+    readonly type: "runtime.effect.failed";
     readonly payload: {
-        readonly nodeId: string;
+        readonly effectId: string;
+        readonly error: string;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "workflow.sleep.requested";
+    readonly type: "runtime.snapshot.taken";
     readonly payload: {
-        readonly nodeId: string;
-        readonly waitId: string;
-        readonly wakeAt: number;
+        readonly seq: number;
+        readonly stateHash: string;
+        readonly state?: Schema.Json | undefined;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
-    readonly type: "workflow.spawn.requested";
+    readonly type: "runtime.signal.received";
     readonly payload: {
-        readonly nodeId: string;
-        readonly childThreadId: string;
-        readonly kind: string;
-        readonly definitionName: string;
-        readonly input: Schema.Json;
+        readonly signalType: string;
     };
 })>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swirls/looms",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Pluggable event-sourced runtime for durable agents and workflows",
   "homepage": "https://github.com/ByteSliceHQ/looms#readme",
   "bugs": {
@@ -18,6 +18,7 @@
   "files": [
     "dist",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "type": "module",