@swirls/looms 0.2.0 → 0.3.0

package/dist/debugger/app/index.html

@@ -4,9 +4,9 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Looms debugger</title>
-    <script type="module" crossorigin src="./assets/index-Qb371t_O.js"></script>
+    <script type="module" crossorigin src="./assets/index-BevQYa-U.js"></script>
     <link rel="modulepreload" crossorigin href="./assets/rolldown-runtime-CbXtAM7H.js">
-    <link rel="stylesheet" crossorigin href="./assets/index-B3Ah8WAE.css">
+    <link rel="stylesheet" crossorigin href="./assets/index-CgDzWJg7.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/debugger/components/composer.d.ts

@@ -1,12 +1,15 @@
 import type { ReactNode } from 'react';
 /**
  * Message input with one primary action. Enter sends, Shift+Enter adds a newline,
- * and `toolbar` holds secondary controls such as delivery mode.
+ * and `toolbar` holds secondary controls such as delivery mode. `onStop` adds a
+ * Stop button beside Send while work is in progress.
  */
-export declare function Composer({ value, onChange, onSubmit, pending, disabled, placeholder, submitLabel, toolbar, error, className, }: {
+export declare function Composer({ value, onChange, onSubmit, onStop, stopping, pending, disabled, placeholder, submitLabel, toolbar, error, className, }: {
     value: string;
     onChange: (value: string) => void;
     onSubmit: () => void;
+    onStop?: () => void;
+    stopping?: boolean;
     pending?: boolean;
     disabled?: boolean;
     placeholder?: string;

package/dist/debugger/components/composer.js

@@ -1,13 +1,14 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { ArrowUp, LoaderCircle } from 'lucide-react';
+import { ArrowUp, LoaderCircle, Square } from 'lucide-react';
 import { cn } from '../lib/cn.js';
 import { Button } from '../ui/button.js';
 import { Kbd } from '../ui/panel.js';
 /**
  * Message input with one primary action. Enter sends, Shift+Enter adds a newline,
- * and `toolbar` holds secondary controls such as delivery mode.
+ * and `toolbar` holds secondary controls such as delivery mode. `onStop` adds a
+ * Stop button beside Send while work is in progress.
  */
-export function Composer({ value, onChange, onSubmit, pending = false, disabled = false, placeholder = 'Message', submitLabel = 'Send', toolbar, error, className, }) {
+export function Composer({ value, onChange, onSubmit, onStop, stopping = false, pending = false, disabled = false, placeholder = 'Message', submitLabel = 'Send', toolbar, error, className, }) {
     const canSubmit = !pending && !disabled && value.trim().length > 0;
     return (_jsxs("form", { className: cn('border-border shrink-0 border-t p-3', className), onSubmit: (event) => {
             event.preventDefault();
@@ -21,5 +22,5 @@ export function Composer({ value, onChange, onSubmit, pending = false, disabled
                                     onSubmit();
                                 }
                             }
-                        }, className: "placeholder:text-muted-foreground block field-sizing-content max-h-48 min-h-11 w-full resize-none bg-transparent px-3 pt-2.5 pb-1 text-[13px] leading-relaxed outline-none disabled:cursor-not-allowed disabled:opacity-50" }), _jsxs("div", { className: "flex h-10 items-center gap-1 pr-1.5 pl-1.5", children: [toolbar, _jsxs("span", { className: "text-muted-foreground ml-auto hidden items-center gap-1 pr-1 text-[10px] @sm:flex", children: [_jsx(Kbd, { children: "\u21B5" }), submitLabel.toLowerCase(), _jsx(Kbd, { className: "ml-1.5", children: "\u21E7\u21B5" }), "newline"] }), _jsx(Button, { type: "submit", size: "icon-sm", "aria-label": submitLabel, disabled: !canSubmit, className: "ml-auto rounded-full @sm:ml-0", children: pending ? _jsx(LoaderCircle, { className: "animate-spin" }) : _jsx(ArrowUp, {}) })] })] }), error ? _jsx("p", { className: "text-status-failed mt-2 px-1 text-[11px]", children: error }) : null] }));
+                        }, className: "placeholder:text-muted-foreground block field-sizing-content max-h-48 min-h-11 w-full resize-none bg-transparent px-3 pt-2.5 pb-1 text-[13px] leading-relaxed outline-none disabled:cursor-not-allowed disabled:opacity-50" }), _jsxs("div", { className: "flex h-10 items-center gap-1 pr-1.5 pl-1.5", children: [toolbar, _jsxs("span", { className: "text-muted-foreground ml-auto hidden items-center gap-1 pr-1 text-[10px] @sm:flex", children: [_jsx(Kbd, { children: "\u21B5" }), submitLabel.toLowerCase(), _jsx(Kbd, { className: "ml-1.5", children: "\u21E7\u21B5" }), "newline"] }), onStop ? (_jsx(Button, { type: "button", size: "icon-sm", variant: "outline", "aria-label": "Stop", title: "Stop the current turn", disabled: stopping, onClick: onStop, className: "ml-auto rounded-full @sm:ml-0", children: stopping ? (_jsx(LoaderCircle, { className: "animate-spin" })) : (_jsx(Square, { className: "fill-current" })) })) : null, _jsx(Button, { type: "submit", size: "icon-sm", "aria-label": submitLabel, disabled: !canSubmit, className: cn('rounded-full', !onStop && 'ml-auto @sm:ml-0'), children: pending ? _jsx(LoaderCircle, { className: "animate-spin" }) : _jsx(ArrowUp, {}) })] })] }), error ? _jsx("p", { className: "text-status-failed mt-2 px-1 text-[11px]", children: error }) : null] }));
 }

package/dist/debugger/components/run-tree.js

@@ -21,11 +21,8 @@ function flatten(root, collapsed) {
         }
         rows.push(next);
         if (!collapsed.has(next.node.threadId)) {
-            for (let index = next.node.children.length - 1; index >= 0; index--) {
-                const child = next.node.children[index];
-                if (child) {
-                    stack.push({ node: child, depth: next.depth + 1 });
-                }
+            for (const child of next.node.children.toReversed()) {
+                stack.push({ node: child, depth: next.depth + 1 });
             }
         }
     }

package/dist/debugger/events/catalog.js

@@ -12,9 +12,7 @@ function searchText(event, summary) {
 /** Each event type belongs to the family view with the longest matching prefix. */
 export function createEventCatalog(plugins = []) {
     const views = [...plugins.flatMap((plugin) => plugin.families ?? []), ...builtinFamilies];
-    // ES2022 has no Array#toSorted. `views` is a fresh array.
-    // oxlint-disable-next-line unicorn/no-array-sort
-    const byPrefix = views.sort((left, right) => prefixOf(right).length - prefixOf(left).length);
+    const byPrefix = views.toSorted((left, right) => prefixOf(right).length - prefixOf(left).length);
     const colors = new Map(views.map((view) => [view.family, view.color]));
     function viewOf(type) {
         return byPrefix.find((view) => type.startsWith(prefixOf(view))) ?? runtimeFamily;

package/dist/debugger/events/protocol-summarize.js

@@ -19,6 +19,13 @@ export function summarizeProtocolEvent(event) {
             };
         case 'runtime.run.cancelled':
             return { title: 'run cancelled', detail: jsonText(payload.reason) };
+        case 'runtime.run.forked':
+            return {
+                title: 'run forked',
+                detail: `from ${jsonText(payload.sourceRunId) ?? 'unknown'} at seq ${jsonNumberText(payload.sourceSeq) ?? '?'}`,
+            };
+        case 'runtime.fork.elided':
+            return { title: 'left out of fork', detail: jsonText(payload.type) };
         case 'runtime.thread.started':
             return {
                 title: 'thread started',

package/dist/debugger/lib/event-counts.d.ts

@@ -1,5 +1,5 @@
-import { type EventEnvelope } from '@swirls/looms/core';
+import { type EventEnvelope, type RunStatus } from '@swirls/looms/core';
 /** Build thread→count map via the shared EventIndex. */
 export declare function countEventsByThread(events: readonly EventEnvelope[]): Map<string, number>;
-export declare function runStatusFromEvents(events: readonly EventEnvelope[]): string;
+export declare function runStatusFromEvents(events: readonly EventEnvelope[]): RunStatus;
 export declare function startedAtFromEvents(events: readonly EventEnvelope[]): number | undefined;

package/dist/debugger/lib/event-counts.js

@@ -1,4 +1,4 @@
-import { EventIndex, isJsonObject, isJsonString } from '@swirls/looms/core';
+import { completedRunStatus, EventIndex } from '@swirls/looms/core';
 /** Build thread→count map via the shared EventIndex. */
 export function countEventsByThread(events) {
     const index = new EventIndex();
@@ -6,15 +6,11 @@ export function countEventsByThread(events) {
     return new Map(index.getCounts());
 }
 export function runStatusFromEvents(events) {
-    for (let index = events.length - 1; index >= 0; index -= 1) {
-        const event = events[index];
-        if (!event || event.type !== 'runtime.run.completed') {
-            continue;
-        }
-        const payload = isJsonObject(event.payload) ? event.payload : {};
-        return isJsonString(payload.error) && payload.error.length > 0 ? 'failed' : 'completed';
+    const ended = events.findLast((event) => event.type === 'runtime.run.cancelled' || event.type === 'runtime.run.completed');
+    if (!ended) {
+        return 'running';
     }
-    return 'running';
+    return ended.type === 'runtime.run.cancelled' ? 'cancelled' : completedRunStatus(ended.payload);
 }
 export function startedAtFromEvents(events) {
     const index = new EventIndex();

package/dist/debugger/shell/debugger-shell.js

@@ -36,7 +36,7 @@ function DebuggerFrame({ selection, onSelectionChange, }) {
                             kind: run.kind ?? undefined,
                             name: run.definitionName ?? undefined,
                             run: run.runId,
-                        }) }), _jsxs("div", { className: "ml-auto flex min-w-0 items-center gap-2", children: [error ? (_jsx("p", { className: "text-status-failed truncate text-[11px]", title: error, children: error })) : null, selection.run ? _jsx(RunControls, { runId: selection.run }) : null] })] }), _jsxs(ResizablePanelGroup, { id: "looms-debugger-columns", className: "min-h-0 flex-1", defaultLayout: layout.defaultLayout, onLayoutChanged: layout.onLayoutChanged, children: [_jsx(ResizablePanel, { id: "tree", defaultSize: "17%", minSize: "12rem", maxSize: "30%", className: "bg-sidebar", children: _jsx("section", { "aria-label": "Run tree", className: "h-full min-h-0 overflow-hidden", children: selection.run ? (_jsx(RunTreePane, { runId: selection.run, threadId: selection.thread, onSelectThread: (thread) => onSelectionChange({ ...selection, thread, seq: undefined }) })) : (_jsxs("div", { className: "flex h-full flex-col", children: [_jsx(PanelHeader, { children: _jsx(PanelTitle, { children: "Run tree" }) }), _jsx(EmptyState, { icon: _jsx(ListTree, {}), title: "No run selected", children: "Threads and child runs appear here once a run starts." })] })) }) }), _jsx(ResizableHandle, {}), _jsx(ResizablePanel, { id: "workspace", defaultSize: "29%", minSize: "16rem", children: _jsx("section", { "aria-label": "Workspace", className: "@container h-full min-h-0 overflow-hidden", children: _jsx(Workspace, { definition: selected, runId: selection.run, onStarted: (run) => onSelectionChange({ kind, name, run }) }) }) }), _jsx(ResizableHandle, {}), _jsx(ResizablePanel, { id: "events", defaultSize: "32%", minSize: "16rem", children: _jsx("section", { "aria-label": "Events", className: "h-full min-h-0 overflow-hidden", children: selection.run ? (_jsx(EventsPane, { runId: selection.run, threadId: selection.thread, seq: selection.seq, onSelectSeq: (seq) => onSelectionChange({ ...selection, seq }), onClearThread: () => onSelectionChange({ ...selection, thread: undefined }) })) : (_jsxs("div", { className: "flex h-full flex-col", children: [_jsx(PanelHeader, { children: _jsx(PanelTitle, { children: "Events" }) }), _jsx(EmptyState, { icon: _jsx(Activity, {}), title: "No events yet", children: "Events stream in live once a run starts." })] })) }) }), _jsx(ResizableHandle, {}), _jsx(ResizablePanel, { id: "projections", defaultSize: "22%", minSize: "14rem", className: "bg-sidebar", children: _jsx("section", { "aria-label": "Projections", className: "h-full min-h-0 overflow-hidden", children: _jsx(ProjectionsPanel, { runId: selection.run, names: catalog.projections }) }) })] })] }));
+                        }) }), _jsxs("div", { className: "ml-auto flex min-w-0 items-center gap-2", children: [error ? (_jsx("p", { className: "text-status-failed truncate text-[11px]", title: error, children: error })) : null, selection.run ? (_jsx(RunControls, { runId: selection.run, onForked: (run) => onSelectionChange({ kind, name, run }) })) : null] })] }), _jsxs(ResizablePanelGroup, { id: "looms-debugger-columns", className: "min-h-0 flex-1", defaultLayout: layout.defaultLayout, onLayoutChanged: layout.onLayoutChanged, children: [_jsx(ResizablePanel, { id: "tree", defaultSize: "17%", minSize: "12rem", maxSize: "30%", className: "bg-sidebar", children: _jsx("section", { "aria-label": "Run tree", className: "h-full min-h-0 overflow-hidden", children: selection.run ? (_jsx(RunTreePane, { runId: selection.run, threadId: selection.thread, onSelectThread: (thread) => onSelectionChange({ ...selection, thread, seq: undefined }) })) : (_jsxs("div", { className: "flex h-full flex-col", children: [_jsx(PanelHeader, { children: _jsx(PanelTitle, { children: "Run tree" }) }), _jsx(EmptyState, { icon: _jsx(ListTree, {}), title: "No run selected", children: "Threads and child runs appear here once a run starts." })] })) }) }), _jsx(ResizableHandle, {}), _jsx(ResizablePanel, { id: "workspace", defaultSize: "29%", minSize: "16rem", children: _jsx("section", { "aria-label": "Workspace", className: "@container h-full min-h-0 overflow-hidden", children: _jsx(Workspace, { definition: selected, runId: selection.run, onStarted: (run) => onSelectionChange({ kind, name, run }) }) }) }), _jsx(ResizableHandle, {}), _jsx(ResizablePanel, { id: "events", defaultSize: "32%", minSize: "16rem", children: _jsx("section", { "aria-label": "Events", className: "h-full min-h-0 overflow-hidden", children: selection.run ? (_jsx(EventsPane, { runId: selection.run, threadId: selection.thread, seq: selection.seq, onSelectSeq: (seq) => onSelectionChange({ ...selection, seq }), onClearThread: () => onSelectionChange({ ...selection, thread: undefined }) })) : (_jsxs("div", { className: "flex h-full flex-col", children: [_jsx(PanelHeader, { children: _jsx(PanelTitle, { children: "Events" }) }), _jsx(EmptyState, { icon: _jsx(Activity, {}), title: "No events yet", children: "Events stream in live once a run starts." })] })) }) }), _jsx(ResizableHandle, {}), _jsx(ResizablePanel, { id: "projections", defaultSize: "22%", minSize: "14rem", className: "bg-sidebar", children: _jsx("section", { "aria-label": "Projections", className: "h-full min-h-0 overflow-hidden", children: _jsx(ProjectionsPanel, { runId: selection.run, names: catalog.projections }) }) })] })] }));
 }
 export function DebuggerShell({ plugins, selection, onSelectionChange, endpoint, }) {
     return (_jsx(DebuggerProvider, { endpoint: endpoint, plugins: plugins, children: _jsx(DebuggerFrame, { selection: selection, onSelectionChange: onSelectionChange }) }));

package/dist/debugger/shell/run-controls.d.ts

@@ -1,4 +1,5 @@
 /** Run-scoped actions that live beside the run switcher. */
-export declare function RunControls({ runId }: {
+export declare function RunControls({ runId, onForked, }: {
     runId: string;
+    onForked: (runId: string) => void;
 }): import("react").JSX.Element;

package/dist/debugger/shell/run-controls.js

@@ -1,6 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { AlarmClock, CircleStop, Radio } from 'lucide-react';
-import { useState } from 'react';
+import { Effect, Fiber } from 'effect';
+import { AlarmClock, CircleStop, GitFork, Radio } from 'lucide-react';
+import { useEffect, useState } from 'react';
 import { cleanUndefined } from '@swirls/looms/core';
 import { useRunStore, useRunSummary } from '@swirls/looms/react';
 import { useDebugger } from '../context.js';
@@ -10,7 +11,7 @@ import { Input } from '../ui/input.js';
 import { Kbd } from '../ui/panel.js';
 import { Popover, PopoverContent, PopoverTrigger } from '../ui/popover.js';
 import { Textarea } from '../ui/textarea.js';
-const CANCEL_TYPE = 'runtime.thread.cancel.requested';
+const NOTICE_MS = 3_000;
 function useRunAction() {
     const [error, setError] = useState(null);
     const [pending, setPending] = useState(false);
@@ -18,7 +19,7 @@ function useRunAction() {
         setPending(true);
         setError(null);
         action()
-            .then(() => onDone?.())
+            .then((value) => onDone?.(value))
             .catch((cause) => setError(errorMessage(cause)))
             .finally(() => setPending(false));
     }
@@ -29,7 +30,7 @@ function Field({ label, hint, children }) {
 }
 function SignalForm({ runId, rootThreadId }) {
     const { client } = useDebugger();
-    const [type, setType] = useState(CANCEL_TYPE);
+    const [type, setType] = useState('');
     const [payload, setPayload] = useState('{}');
     const [thread, setThread] = useState('');
     const [sent, setSent] = useState(false);
@@ -53,7 +54,7 @@ function SignalForm({ runId, rootThreadId }) {
     return (_jsxs("form", { className: "grid gap-3", onSubmit: (event) => {
             event.preventDefault();
             submit();
-        }, children: [_jsxs("div", { children: [_jsx("p", { className: "text-[13px] font-medium", children: "Send a signal" }), _jsx("p", { className: "text-muted-foreground text-xs", children: "Append an event to this run's log." })] }), _jsx(Field, { label: "Type", children: _jsx(Input, { value: type, onChange: (event) => setType(event.target.value), className: "h-7 font-mono text-xs", autoFocus: true }) }), _jsx(Field, { label: "Thread", hint: "defaults to root", children: _jsx(Input, { value: thread, placeholder: rootThreadId ?? 'thread id', onChange: (event) => setThread(event.target.value), className: "h-7 font-mono text-xs" }) }), _jsx(Field, { label: "Payload", hint: "JSON", children: _jsx(Textarea, { value: payload, onChange: (event) => setPayload(event.target.value), onKeyDown: (event) => {
+        }, children: [_jsxs("div", { children: [_jsx("p", { className: "text-[13px] font-medium", children: "Send a signal" }), _jsx("p", { className: "text-muted-foreground text-xs", children: "Append an event to this run's log." })] }), _jsx(Field, { label: "Type", children: _jsx(Input, { value: type, placeholder: "module.event", onChange: (event) => setType(event.target.value), className: "h-7 font-mono text-xs", autoFocus: true }) }), _jsx(Field, { label: "Thread", hint: "defaults to root", children: _jsx(Input, { value: thread, placeholder: rootThreadId ?? 'thread id', onChange: (event) => setThread(event.target.value), className: "h-7 font-mono text-xs" }) }), _jsx(Field, { label: "Payload", hint: "JSON", children: _jsx(Textarea, { value: payload, onChange: (event) => setPayload(event.target.value), onKeyDown: (event) => {
                         if (event.key === 'Enter' && (event.metaKey || event.ctrlKey)) {
                             event.preventDefault();
                             submit();
@@ -61,12 +62,38 @@ function SignalForm({ runId, rootThreadId }) {
                     }, className: "max-h-48 min-h-20 font-mono text-xs", spellCheck: false }) }), _jsxs("div", { className: "flex items-center gap-2", children: [error ? (_jsx("p", { className: "text-status-failed min-w-0 flex-1 truncate text-[11px]", title: error, children: error })) : sent ? (_jsx("p", { className: "text-status-completed flex-1 text-[11px]", children: "Signal sent" })) : (_jsxs("p", { className: "text-muted-foreground flex flex-1 items-center gap-1 text-[11px]", children: [_jsx(Kbd, { children: "\u2318" }), _jsx(Kbd, { children: "\u21B5" })] })), _jsx(Button, { type: "submit", size: "sm", disabled: pending || type.length === 0, children: "Send signal" })] })] }));
 }
 /** Run-scoped actions that live beside the run switcher. */
-export function RunControls({ runId }) {
+export function RunControls({ runId, onForked, }) {
     const { client } = useDebugger();
-    const { rootThreadId, status } = useRunSummary(useRunStore(runId));
-    const { run, pending, error } = useRunAction();
-    const finished = status === 'completed' || status === 'failed' || status === 'cancelled';
-    return (_jsxs("div", { className: "flex items-center gap-0.5", children: [error ? (_jsx("span", { className: "text-status-failed mr-2 max-w-60 truncate text-[11px]", title: error, children: error })) : null, _jsxs(Button, { variant: "ghost", size: "sm", disabled: pending, onClick: () => run(() => client.wake(runId)), children: [_jsx(AlarmClock, {}), "Wake"] }), _jsxs(Button, { variant: "destructive", size: "sm", disabled: pending || finished, onClick: () => run(() => client.signal(runId, [
-                    { type: CANCEL_TYPE, payload: { threadId: rootThreadId ?? '' } },
-                ])), children: [_jsx(CircleStop, {}), "Cancel"] }), _jsxs(Popover, { children: [_jsx(PopoverTrigger, { asChild: true, children: _jsxs(Button, { variant: "ghost", size: "sm", className: "data-[state=open]:bg-accent data-[state=open]:text-foreground", children: [_jsx(Radio, {}), "Signal"] }) }), _jsx(PopoverContent, { align: "end", className: "w-80", children: _jsx(SignalForm, { runId: runId, rootThreadId: rootThreadId }) })] })] }));
+    const { rootThreadId, finished, resumable } = useRunSummary(useRunStore(runId));
+    // A wake holds its request open until the run parks, so Cancel needs its own pending state.
+    const waking = useRunAction();
+    const cancelling = useRunAction();
+    const forking = useRunAction();
+    const error = forking.error ?? cancelling.error ?? waking.error;
+    const [notice, setNotice] = useState(null);
+    useEffect(() => {
+        if (!notice) {
+            return undefined;
+        }
+        const clear = Effect.runFork(Effect.sleep(NOTICE_MS).pipe(Effect.andThen(Effect.sync(() => setNotice(null)))));
+        return () => {
+            Effect.runFork(Fiber.interrupt(clear));
+        };
+    }, [notice]);
+    function wake() {
+        setNotice(null);
+        cancelling.setError(null);
+        waking.run(() => client.wake(runId), ({ appended }) => setNotice(appended === 0
+            ? 'Nothing pending'
+            : `Woke: ${appended} new event${appended === 1 ? '' : 's'}`));
+    }
+    return (_jsxs("div", { className: "flex items-center gap-0.5", children: [error ? (_jsx("span", { className: "text-status-failed mr-2 max-w-60 truncate text-[11px]", title: error, children: error })) : notice ? (_jsx("span", { role: "status", className: "text-muted-foreground mr-2 text-[11px]", children: notice })) : null, _jsxs(Button, { variant: "ghost", size: "sm", disabled: waking.pending, title: "Process pending work: due timers, retries, and effects stalled by a restart", onClick: wake, children: [_jsx(AlarmClock, {}), "Wake"] }), resumable ? (_jsxs(Button, { variant: "ghost", size: "sm", disabled: forking.pending, title: "Start a new run that picks up where this one stopped", onClick: () => {
+                    setNotice(null);
+                    waking.setError(null);
+                    forking.run(() => client.fork(runId), (forked) => onForked(forked.runId));
+                }, children: [_jsx(GitFork, {}), "Continue"] })) : (_jsxs(Button, { variant: "destructive", size: "sm", disabled: cancelling.pending || finished, onClick: () => {
+                    setNotice(null);
+                    waking.setError(null);
+                    cancelling.run(() => client.cancel(runId));
+                }, children: [_jsx(CircleStop, {}), "Cancel"] })), _jsxs(Popover, { children: [_jsx(PopoverTrigger, { asChild: true, children: _jsxs(Button, { variant: "ghost", size: "sm", className: "data-[state=open]:bg-accent data-[state=open]:text-foreground", children: [_jsx(Radio, {}), "Signal"] }) }), _jsx(PopoverContent, { align: "end", className: "w-80", children: _jsx(SignalForm, { runId: runId, rootThreadId: rootThreadId }) })] })] }));
 }

package/dist/debugger/shell/run-search.js

@@ -43,9 +43,7 @@ function indexRuns(runs) {
             .join(' ')
             .toLowerCase(),
     }));
-    // ES2022 has no Array#toSorted. `indexed` is a fresh array.
-    // oxlint-disable-next-line unicorn/no-array-sort
-    return indexed.sort((left, right) => right.createdAt - left.createdAt);
+    return indexed.toSorted((left, right) => right.createdAt - left.createdAt);
 }
 function matches(entry, terms) {
     return terms.every((term) => entry.haystack.includes(term));

package/dist/evaluator/effects.d.ts

@@ -120,6 +120,11 @@ export declare const evaluateEffect: NoInfer<import("@swirls/looms/core").Effect
         readonly attempt: number;
         readonly deadlineAt: number | null;
     };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.fork.elided";
+    readonly payload: {
+        readonly type: string;
+    };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
     readonly type: "runtime.run.cancelled";
     readonly payload: {
@@ -131,6 +136,12 @@ export declare const evaluateEffect: NoInfer<import("@swirls/looms/core").Effect
         readonly output: Schema.Json;
         readonly error: string | null;
     };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.run.forked";
+    readonly payload: {
+        readonly sourceRunId: string;
+        readonly sourceSeq: number;
+    };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
     readonly type: "runtime.run.started";
     readonly payload: {
@@ -163,6 +174,7 @@ export declare const evaluateEffect: NoInfer<import("@swirls/looms/core").Effect
     readonly payload: {
         readonly threadId: string;
         readonly reason?: string | undefined;
+        readonly resumeSeq?: number | undefined;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
     readonly type: "runtime.thread.completed";

package/dist/evaluator/module.d.ts

@@ -155,6 +155,11 @@ export declare function evaluator(options?: EvaluatorModuleOptions): import("@sw
             readonly attempt: number;
             readonly deadlineAt: number | null;
         };
+    }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+        readonly type: "runtime.fork.elided";
+        readonly payload: {
+            readonly type: string;
+        };
     }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
         readonly type: "runtime.run.cancelled";
         readonly payload: {
@@ -166,6 +171,12 @@ export declare function evaluator(options?: EvaluatorModuleOptions): import("@sw
             readonly output: import("effect/Schema").Json;
             readonly error: string | null;
         };
+    }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+        readonly type: "runtime.run.forked";
+        readonly payload: {
+            readonly sourceRunId: string;
+            readonly sourceSeq: number;
+        };
     }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
         readonly type: "runtime.run.started";
         readonly payload: {
@@ -198,6 +209,7 @@ export declare function evaluator(options?: EvaluatorModuleOptions): import("@sw
         readonly payload: {
             readonly threadId: string;
             readonly reason?: string | undefined;
+            readonly resumeSeq?: number | undefined;
         };
     }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
         readonly type: "runtime.thread.completed";
@@ -438,6 +450,11 @@ export declare function evaluator(options?: EvaluatorModuleOptions): import("@sw
                 readonly attempt: number;
                 readonly deadlineAt: number | null;
             };
+        }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+            readonly type: "runtime.fork.elided";
+            readonly payload: {
+                readonly type: string;
+            };
         }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
             readonly type: "runtime.run.cancelled";
             readonly payload: {
@@ -449,6 +466,12 @@ export declare function evaluator(options?: EvaluatorModuleOptions): import("@sw
                 readonly output: import("effect/Schema").Json;
                 readonly error: string | null;
             };
+        }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+            readonly type: "runtime.run.forked";
+            readonly payload: {
+                readonly sourceRunId: string;
+                readonly sourceSeq: number;
+            };
         }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
             readonly type: "runtime.run.started";
             readonly payload: {
@@ -481,6 +504,7 @@ export declare function evaluator(options?: EvaluatorModuleOptions): import("@sw
             readonly payload: {
                 readonly threadId: string;
                 readonly reason?: string | undefined;
+                readonly resumeSeq?: number | undefined;
             };
         }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
             readonly type: "runtime.thread.completed";

package/dist/projectors/index-model.d.ts

@@ -1,6 +1,8 @@
-import type { EventEnvelope } from '@swirls/looms/core';
+import { type EventEnvelope } from '@swirls/looms/core';
 import type { Projector } from './projector';
+/** A run (`actorId === runId`) or one of its threads. Thread ids are unique within a run. */
 export interface ActorIndexRow {
+    runId: string;
     actorId: string;
     kind: string | null;
     status: string | null;
@@ -9,14 +11,15 @@ export interface ActorIndexRow {
     updatedAt: number;
 }
 export interface ReviewIndexRow {
+    runId: string;
     reviewId: string;
-    actorId: string;
     status: string;
     title: string;
     updatedAt: number;
 }
 export type IndexOp = {
     type: 'upsertActor';
+    runId: string;
     actorId: string;
     kind: string | null;
     status: string | null;
@@ -25,32 +28,35 @@ export type IndexOp = {
     updatedAt: number;
 } | {
     type: 'setActorStatus';
+    runId: string;
     actorId: string;
     status: string;
     updatedAt: number;
 } | {
     type: 'upsertReview';
+    runId: string;
     reviewId: string;
-    actorId: string;
     status: string;
     title: string;
     updatedAt: number;
 } | {
     type: 'setReviewStatus';
+    runId: string;
     reviewId: string;
     status: string;
     updatedAt: number;
 };
 export interface IndexBackend {
     applyOps: (ops: ReadonlyArray<IndexOp>) => Promise<void>;
-    getActor: (actorId: string) => Promise<ActorIndexRow | null>;
-    listReviews: (actorId?: string) => Promise<ReviewIndexRow[]>;
+    getActor: (runId: string, actorId: string) => Promise<ActorIndexRow | null>;
+    listReviews: (runId?: string) => Promise<ReviewIndexRow[]>;
     init?: () => Promise<void>;
     dispose?: () => Promise<void>;
 }
 export interface IndexProjector extends Projector {
-    getActor: (actorId: string) => Promise<ActorIndexRow | null>;
-    listReviews: (actorId?: string) => Promise<ReviewIndexRow[]>;
+    /** The run's row, or one of its threads when `actorId` is given. */
+    getActor: (runId: string, actorId?: string) => Promise<ActorIndexRow | null>;
+    listReviews: (runId?: string) => Promise<ReviewIndexRow[]>;
 }
 export declare function indexOpsFor(event: EventEnvelope): IndexOp[];
 export declare function createIndexProjector(name: string, backend: IndexBackend, version?: string): IndexProjector;

package/dist/projectors/index-model.js

@@ -1,4 +1,5 @@
 import { Predicate } from 'effect';
+import { completedRunStatus } from '@swirls/looms/core';
 function payloadObject(event) {
     if (!Predicate.isObject(event.payload)) {
         return {};
@@ -11,12 +12,15 @@ function readString(obj, key) {
 }
 export function indexOpsFor(event) {
     const payload = payloadObject(event);
+    const runId = event.runId;
+    const actorId = readString(payload, 'threadId') ?? event.threadId ?? runId;
     switch (event.type) {
         case 'runtime.run.started':
             return [
                 {
                     type: 'upsertActor',
-                    actorId: event.runId,
+                    runId,
+                    actorId: runId,
                     kind: readString(payload, 'kind') ?? null,
                     status: 'running',
                     definitionName: readString(payload, 'definitionName') ?? null,
@@ -28,7 +32,8 @@ export function indexOpsFor(event) {
             return [
                 {
                     type: 'upsertActor',
-                    actorId: readString(payload, 'threadId') ?? event.threadId ?? event.runId,
+                    runId,
+                    actorId,
                     kind: readString(payload, 'kind') ?? null,
                     status: 'running',
                     definitionName: readString(payload, 'definitionName') ?? null,
@@ -37,39 +42,28 @@ export function indexOpsFor(event) {
                 },
             ];
         case 'runtime.run.completed':
-        case 'runtime.thread.completed':
             return [
                 {
                     type: 'setActorStatus',
-                    actorId: readString(payload, 'threadId') ?? event.threadId ?? event.runId,
-                    status: 'completed',
+                    runId,
+                    actorId: runId,
+                    status: completedRunStatus(event.payload),
                     updatedAt: event.ts,
                 },
             ];
+        case 'runtime.thread.completed':
+            return [{ type: 'setActorStatus', runId, actorId, status: 'completed', updatedAt: event.ts }];
         case 'runtime.thread.failed':
-            return [
-                {
-                    type: 'setActorStatus',
-                    actorId: readString(payload, 'threadId') ?? event.threadId ?? event.runId,
-                    status: 'failed',
-                    updatedAt: event.ts,
-                },
-            ];
+            return [{ type: 'setActorStatus', runId, actorId, status: 'failed', updatedAt: event.ts }];
+        case 'runtime.run.cancelled':
         case 'runtime.thread.cancelled':
-            return [
-                {
-                    type: 'setActorStatus',
-                    actorId: readString(payload, 'threadId') ?? event.threadId ?? event.runId,
-                    status: 'cancelled',
-                    updatedAt: event.ts,
-                },
-            ];
+            return [{ type: 'setActorStatus', runId, actorId, status: 'cancelled', updatedAt: event.ts }];
         case 'approval.requested':
             return [
                 {
                     type: 'upsertReview',
+                    runId,
                     reviewId: readString(payload, 'approvalId') ?? 'unknown',
-                    actorId: event.runId,
                     status: 'pending',
                     title: readString(payload, 'title') ?? 'Approval',
                     updatedAt: event.ts,
@@ -79,8 +73,8 @@ export function indexOpsFor(event) {
             return [
                 {
                     type: 'upsertReview',
+                    runId,
                     reviewId: readString(payload, 'approvalId') ?? 'unknown',
-                    actorId: event.runId,
                     status: payload.outcome === 'reject' ? 'rejected' : 'approved',
                     title: 'Approval',
                     updatedAt: event.ts,
@@ -90,6 +84,7 @@ export function indexOpsFor(event) {
             return [
                 {
                     type: 'setReviewStatus',
+                    runId,
                     reviewId: readString(payload, 'approvalId') ?? 'unknown',
                     status: 'timed_out',
                     updatedAt: event.ts,
@@ -99,7 +94,7 @@ export function indexOpsFor(event) {
             return [];
     }
 }
-export function createIndexProjector(name, backend, version = '1') {
+export function createIndexProjector(name, backend, version = '2') {
     return {
         name,
         version,
@@ -109,7 +104,7 @@ export function createIndexProjector(name, backend, version = '1') {
             const ops = events.flatMap(indexOpsFor);
             return ops.length === 0 ? Promise.resolve() : backend.applyOps(ops);
         },
-        getActor: (actorId) => backend.getActor(actorId),
-        listReviews: (actorId) => backend.listReviews(actorId),
+        getActor: (runId, actorId) => backend.getActor(runId, actorId ?? runId),
+        listReviews: (runId) => backend.listReviews(runId),
     };
 }

package/dist/projectors/memory.js

@@ -1,9 +1,13 @@
 import { createIndexProjector, } from './index-model.js';
 import { runProjectorSync } from './projector.js';
+function rowKey(runId, id) {
+    return `${runId}\0${id}`;
+}
 function applyOp(actors, reviews, op) {
     switch (op.type) {
         case 'upsertActor':
-            actors.set(op.actorId, {
+            actors.set(rowKey(op.runId, op.actorId), {
+                runId: op.runId,
                 actorId: op.actorId,
                 kind: op.kind,
                 status: op.status,
@@ -13,8 +17,10 @@ function applyOp(actors, reviews, op) {
             });
             return;
         case 'setActorStatus': {
-            const existing = actors.get(op.actorId);
-            actors.set(op.actorId, {
+            const key = rowKey(op.runId, op.actorId);
+            const existing = actors.get(key);
+            actors.set(key, {
+                runId: op.runId,
                 actorId: op.actorId,
                 kind: existing?.kind ?? null,
                 status: op.status,
@@ -25,10 +31,11 @@ function applyOp(actors, reviews, op) {
             return;
         }
         case 'upsertReview': {
-            const existing = reviews.get(op.reviewId);
-            reviews.set(op.reviewId, {
+            const key = rowKey(op.runId, op.reviewId);
+            const existing = reviews.get(key);
+            reviews.set(key, {
+                runId: op.runId,
                 reviewId: op.reviewId,
-                actorId: op.actorId,
                 status: op.status,
                 title: existing?.title ?? op.title,
                 updatedAt: op.updatedAt,
@@ -36,9 +43,10 @@ function applyOp(actors, reviews, op) {
             return;
         }
         case 'setReviewStatus': {
-            const existing = reviews.get(op.reviewId);
+            const key = rowKey(op.runId, op.reviewId);
+            const existing = reviews.get(key);
             if (existing) {
-                reviews.set(op.reviewId, { ...existing, status: op.status, updatedAt: op.updatedAt });
+                reviews.set(key, { ...existing, status: op.status, updatedAt: op.updatedAt });
             }
             return;
         }
@@ -57,10 +65,10 @@ export function memory() {
                 applyOp(actors, reviews, op);
             }
         }),
-        getActor: (actorId) => runProjectorSync('memory', () => actors.get(actorId) ?? null),
-        listReviews: (actorId) => runProjectorSync('memory', () => {
+        getActor: (runId, actorId) => runProjectorSync('memory', () => actors.get(rowKey(runId, actorId)) ?? null),
+        listReviews: (runId) => runProjectorSync('memory', () => {
             const rows = [...reviews.values()];
-            return actorId ? rows.filter((row) => row.actorId === actorId) : rows;
+            return runId ? rows.filter((row) => row.runId === runId) : rows;
         }),
         dispose: () => runProjectorSync('memory', () => {
             actors.clear();