@swirls/looms 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @swirls/looms
 
+## 0.4.0
+
+### Minor Changes
+
+- 46be9ee: `LoomsRegister`, `RegisteredEvent`, and `AnyEventEnvelope` now live in `@swirls/looms/core`; `@swirls/looms/react` re-exports them, so existing `declare module '@swirls/looms/react'` registrations keep working. Standalone `defineProjection` reducers receive the registered event union, so client-only projections are typed without annotations. Registered event payloads were previously typed as `any`; they now carry their catalog types, so code that relied on `any` may need to narrow on `event.type` first.
+- 46be9ee: `createFold`, `useEventFold`, `EventFoldDefinition`, and `foldEvents` in `@swirls/looms/react` are now `defineLiveFold`, `useLiveFold`, `LiveFoldDefinition`, and `foldLive(fold, events)`. A live fold always sees ephemeral events, so the `includeEphemeral` option is gone; use a projection for anything that does not need them. Live folds take an optional `shape` schema that infers their state type, and passing a projection where a live fold is expected is a type error.
+
+  Live folds no longer see ephemeral events from an effect attempt that the runtime retried, so streamed text from a failed attempt disappears without reducer code. `@swirls/looms/core` exports the rule as `dropSupersededAttempts(events)`, with `retriedEffectId(event)`.
+
 ## 0.3.0
 
 ### Minor Changes

package/dist/agent/debugger/agent-chat.js

@@ -3,9 +3,10 @@ import { Bot, CornerDownRight, GitFork, MessageSquare, Settings2, User, Wrench }
 import { useMemo, useState } from 'react';
 import { createEventId, isJsonObject, isJsonString, } from '@swirls/looms/core';
 import { Button, cn, Composer, EmptyState, errorMessage, FollowList, inputForm, JsonTree, messageInput, parseStructuredJson, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, shortId, useDebugger, useStartRun, } from '@swirls/looms/debugger';
-import { createFold, useEventFold, useProjection, useRunStore, useRunSummary } from '@swirls/looms/react';
+import { useLiveFold, useProjection, useRunStore, useRunSummary } from '@swirls/looms/react';
 import { conversation, turnActivity } from '../projections.js';
 import { agentSessionMessageEvents, stopAgentTurn, userMessage } from '../signals.js';
+import { streamingText } from './streaming-text.js';
 /** Child thread of the session turn that is still open, from the events the store already has. */
 function activeSessionChild(events) {
     let child;
@@ -26,34 +27,6 @@ function activeSessionChild(events) {
     }
     return child;
 }
-const streamingFold = createFold({
-    name: 'agentStreamingText',
-    initialState: { lastMessageSeq: -1, turnStarted: false, parts: [] },
-    includeEphemeral: true,
-    reduce(state, event) {
-        if (event.type === 'agent.message' ||
-            event.type === 'agent.turn.stopped' ||
-            event.type === 'runtime.thread.cancelled') {
-            return { lastMessageSeq: event.seq, turnStarted: false, parts: [] };
-        }
-        if (event.seq <= state.lastMessageSeq) {
-            return state;
-        }
-        if (event.type === 'agent.turn.started') {
-            return { ...state, turnStarted: true };
-        }
-        if (event.type === 'agent.turn.text_delta' &&
-            isJsonObject(event.payload) &&
-            isJsonString(event.payload.delta)) {
-            return {
-                ...state,
-                turnStarted: true,
-                parts: state.parts.concat(event.payload.delta),
-            };
-        }
-        return state;
-    },
-});
 const deliveryOptions = [
     { value: 'followUp', label: 'Follow up', description: 'Queue after the current turn' },
     { value: 'steer', label: 'Steer', description: 'Redirect the active turn' },
@@ -97,7 +70,7 @@ function StreamingItem({ text }) {
 function Transcript({ runId }) {
     const store = useRunStore(runId);
     const convo = useProjection(store, conversation);
-    const streaming = useEventFold(store, streamingFold);
+    const streaming = useLiveFold(store, streamingText);
     const stream = streaming.turnStarted ? streaming.parts.join('') : null;
     const toolNames = useMemo(() => {
         const names = new Map();

package/dist/agent/debugger/streaming-text.d.ts

@@ -0,0 +1,6 @@
+/** Text the active turn has streamed since the last durable agent message. */
+export declare const streamingText: import("@swirls/looms/react").LiveFoldDefinition<{
+    readonly lastMessageSeq: number;
+    readonly turnStarted: boolean;
+    readonly parts: readonly string[];
+}, import("@swirls/looms/core").EventEnvelope>;

package/dist/agent/debugger/streaming-text.js

@@ -0,0 +1,33 @@
+import { Schema } from 'effect';
+import { isJsonObject, isJsonString } from '@swirls/looms/core';
+import { defineLiveFold } from '@swirls/looms/react';
+const StreamingTextSchema = Schema.Struct({
+    lastMessageSeq: Schema.Finite,
+    turnStarted: Schema.Boolean,
+    parts: Schema.Array(Schema.String),
+});
+/** Text the active turn has streamed since the last durable agent message. */
+export const streamingText = defineLiveFold({
+    name: 'agentStreamingText',
+    shape: StreamingTextSchema,
+    initialState: { lastMessageSeq: -1, turnStarted: false, parts: [] },
+    reduce(state, event) {
+        if (event.type === 'agent.message' ||
+            event.type === 'agent.turn.stopped' ||
+            event.type === 'runtime.thread.cancelled') {
+            return { lastMessageSeq: event.seq, turnStarted: false, parts: [] };
+        }
+        if (event.seq <= state.lastMessageSeq) {
+            return state;
+        }
+        if (event.type === 'agent.turn.started') {
+            return { ...state, turnStarted: true };
+        }
+        if (event.type === 'agent.turn.text_delta' &&
+            isJsonObject(event.payload) &&
+            isJsonString(event.payload.delta)) {
+            return { ...state, turnStarted: true, parts: state.parts.concat(event.payload.delta) };
+        }
+        return state;
+    },
+});