@swirls/looms 0.1.0 → 0.2.0

package/dist/runtime/server/routes/definitions.js

@@ -0,0 +1,20 @@
+import { Effect } from 'effect';
+import { publishDefinition } from '@swirls/looms/core';
+import { route } from '../route-table.js';
+export function definitionRoutes({ runtime }) {
+    return [
+        route({
+            method: 'GET',
+            path: '/definitions',
+            name: 'definitions.list',
+            access: 'read',
+            handle: () => {
+                const catalog = {
+                    definitions: runtime.registry.definitions.map(publishDefinition),
+                    projections: [...runtime.registry.projections.keys()],
+                };
+                return Effect.succeed(Response.json(catalog));
+            },
+        }),
+    ];
+}

package/dist/runtime/server/routes/runs.js

@@ -72,7 +72,14 @@ export function runRoutes({ runtime, store }) {
             path: '/runs',
             name: 'runs.list',
             access: 'read',
-            handle: () => provideStore(runtime.listRuns, store).pipe(Effect.map((runIds) => Response.json({ runIds }))),
+            handle: () => provideStore(runtime.listRuns.pipe(Effect.map((runIds) => Response.json({ runIds }))), store),
+        }),
+        route({
+            method: 'GET',
+            path: '/runs/summaries',
+            name: 'runs.summaries',
+            access: 'read',
+            handle: () => provideStore(runtime.listRunSummaries.pipe(Effect.map((runs) => Response.json({ runs }))), store),
         }),
         route({
             method: 'POST',

package/dist/runtime/server.d.ts

@@ -1,4 +1,6 @@
-export { createFetchHandler, isLoomsApiPath, type FetchHandlerOptions, } from './server/fetch-handler';
+export { createFetchHandler, handlesPath, type FetchHandlerOptions } from './server/fetch-handler';
+export { isLoomsApiPath } from './server/http';
+export { mountDebugger, type DebuggerMount } from './server/debugger-host';
 export { authAllowed, authDenied, bearerAuth, defaultAuthorize, type AuthDecision, type AuthorizedAccess, type Authorize, type BearerTokens, type RouteAccess, type RouteInfo, } from './server/auth';
 export interface RunningServer {
     port: number;

package/dist/runtime/server.js

@@ -1,4 +1,6 @@
-export { createFetchHandler, isLoomsApiPath, } from './server/fetch-handler.js';
+export { createFetchHandler, handlesPath } from './server/fetch-handler.js';
+export { isLoomsApiPath } from './server/http.js';
+export { mountDebugger } from './server/debugger-host.js';
 export { authAllowed, authDenied, bearerAuth, defaultAuthorize, } from './server/auth.js';
 export function serveHttp(fetchHandler, options) {
     const port = options?.port ?? 8787;

package/dist/runtime/types.d.ts

@@ -1,5 +1,5 @@
 import type { Effect } from 'effect';
-import type { AnyRuntimeModule, ComposedRegistry, EventEnvelope, EventInput, WorkerCallbackInput, EventStore, EventStoreAppendError, EventStoreError, EventStoreFencedError, EventStoreTag, EventStoreTrimCoverage, EventStoreTruncationError, JsonValue, ProjectionDefinition, ReplayStep, RunState, SnapshotStore } from '@swirls/looms/core';
+import type { AnyRuntimeModule, ComposedRegistry, EventEnvelope, EventInput, WorkerCallbackInput, EventStore, EventStoreAppendError, EventStoreError, EventStoreFencedError, EventStoreTag, EventStoreTrimCoverage, EventStoreTruncationError, JsonValue, ProjectionDefinition, ReplayStep, RunState, RunSummary, SnapshotStore, SnapshotStoreError } from '@swirls/looms/core';
 import type { EventStoreTrimmedError } from '@swirls/looms/core';
 import type { DuplicateEffectDispatchError, MaxWakeIterationsError } from './errors';
 import type { RuntimeObserver } from './observer';
@@ -108,6 +108,8 @@ export interface LoomsRuntime<TModules extends readonly AnyRuntimeModule[] = rea
     /** Applies a worker's report about one effect attempt; stale or foreign reports are ignored. */
     workerCallback(runId: string, input: WorkerCallbackInput): Effect.Effect<RunState, Error | EventStoreAppendError | EventStoreError, EventStoreTag>;
     readonly listRuns: Effect.Effect<string[], EventStoreError, EventStoreTag>;
+    /** Indexed run rows. Folds a run only when its header has not been written yet. */
+    readonly listRunSummaries: Effect.Effect<readonly RunSummary[], EventStoreError | EventStoreTrimmedError | EventStoreTruncationError | SnapshotStoreError, EventStoreTag>;
     readonly rescanTimers: Effect.Effect<number, EventStoreTruncationError | EventStoreTrimmedError | EventStoreError, EventStoreTag>;
     /** Reschedule every durable timer and effect deadline after restart or repair. */
     readonly recoverDeadlines: Effect.Effect<number, EventStoreTruncationError | EventStoreTrimmedError | EventStoreError, EventStoreTag>;

package/dist/s2/snapshot-store.js

@@ -1,6 +1,6 @@
 import { AppendInput, AppendRecord, S2, S2Endpoints, S2Error } from '@s2-dev/streamstore';
 import { Effect, Layer, Option, Schema, Stream } from 'effect';
-import { createKeyedSerializer, assertSnapshotByteLimit, RunStateSchema, SnapshotStoreError, SnapshotPayloadTooLargeError, SnapshotStoreTag, } from '@swirls/looms/core';
+import { createKeyedSerializer, assertSnapshotByteLimit, RunStateSchema, RunSummarySchema, SnapshotStoreError, SnapshotPayloadTooLargeError, SnapshotStoreTag, } from '@swirls/looms/core';
 import { S2ConfigSchema } from './config.js';
 import { paginateS2Stream } from './pagination.js';
 const DEFAULT_PREFIX = 'snapshots';
@@ -18,6 +18,9 @@ const SnapshotFrameSchema = Schema.Struct({
 const SnapshotFrameJson = Schema.fromJsonString(SnapshotFrameSchema);
 const decodeFrame = Schema.decodeSync(SnapshotFrameJson);
 const encodeFrame = Schema.encodeSync(SnapshotFrameJson);
+const HeaderJson = Schema.fromJsonString(RunSummarySchema);
+const decodeHeader = Schema.decodeUnknownOption(HeaderJson);
+const encodeHeader = Schema.encodeSync(HeaderJson);
 export function frameSnapshot(snapshot, maxChunkBytes = DEFAULT_MAX_CHUNK_BYTES) {
     const json = JSON.stringify(snapshot.state);
     const chunks = Math.max(1, Math.ceil(json.length / maxChunkBytes));
@@ -171,7 +174,9 @@ export function s2SnapshotStore(config) {
     const prefix = parsed.snapshotPrefix ?? DEFAULT_PREFIX;
     const appends = createKeyedSerializer();
     const ensured = new Set();
+    const headers = new Map();
     let basinEnsured = false;
+    let headersLoaded = false;
     const streamName = (runId) => `${prefix}/${runId}`;
     const ensureBasin = Effect.suspend(() => {
         if (basinEnsured) {
@@ -297,6 +302,43 @@ export function s2SnapshotStore(config) {
                 catch: (cause) => toSnapshotError(cause, `Failed to prune snapshots for ${runId}`),
             });
         }),
+        saveHeader: (header) => Effect.gen(function* () {
+            const stream = yield* ensureStream('__headers');
+            yield* Effect.tryPromise({
+                try: () => appends.run('__headers', () => stream.append(AppendInput.create([AppendRecord.string({ body: encodeHeader(header) })]))),
+                catch: (cause) => toSnapshotError(cause, `Failed to save run header for ${header.runId}`),
+            });
+            headers.set(header.runId, header);
+        }),
+        listHeaders: Effect.gen(function* () {
+            if (headersLoaded) {
+                return [...headers.values()];
+            }
+            const stream = yield* ensureStream('__headers');
+            const records = yield* paginateS2Stream((cursor, count) => Effect.tryPromise({
+                try: () => stream.read({
+                    start: { from: { seqNum: cursor }, clamp: true },
+                    stop: { limits: { count } },
+                    ignoreCommandRecords: true,
+                }),
+                catch: (cause) => toSnapshotError(cause, 'Failed to read run headers'),
+            }).pipe(Effect.catchIf((error) => error.cause instanceof S2Error &&
+                (error.cause.status === 404 || error.cause.status === 416), () => Effect.succeed(null)))).pipe(Stream.runCollect);
+            const loaded = new Map();
+            for (const record of records) {
+                const decoded = decodeHeader(record.body);
+                if (Option.isSome(decoded)) {
+                    loaded.set(decoded.value.runId, decoded.value);
+                }
+            }
+            for (const [runId, header] of loaded) {
+                if (!headers.has(runId)) {
+                    headers.set(runId, header);
+                }
+            }
+            headersLoaded = true;
+            return [...headers.values()];
+        }),
     };
     return service;
 }

package/dist/workflow/debugger/index.d.ts

@@ -0,0 +1,4 @@
+import type { DebuggerPlugin } from '@swirls/looms/debugger';
+import { WorkflowNodesView } from './nodes-view';
+export declare const workflowDebugger: DebuggerPlugin;
+export { WorkflowNodesView };

package/dist/workflow/debugger/index.js

@@ -0,0 +1,11 @@
+import { nodes } from '../projections.js';
+import { WorkflowNodesView } from './nodes-view.js';
+import { summarizeWorkflowEvent } from './summarize.js';
+export const workflowDebugger = {
+    name: 'workflow',
+    families: [
+        { family: 'workflow', color: 'oklch(0.76 0.12 300)', summarize: summarizeWorkflowEvent },
+    ],
+    projections: [{ name: nodes.name, component: WorkflowNodesView }],
+};
+export { WorkflowNodesView };

package/dist/workflow/debugger/nodes-view.d.ts

@@ -0,0 +1,3 @@
+export declare function WorkflowNodesView({ runId }: {
+    runId: string;
+}): import("react").JSX.Element;

package/dist/workflow/debugger/nodes-view.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { asJson } from '@swirls/looms/core';
+import { JsonTree, StatusBadge } from '@swirls/looms/debugger';
+import { useProjection, useRunStore } from '@swirls/looms/react';
+import { nodes } from '../projections.js';
+export function WorkflowNodesView({ runId }) {
+    const state = useProjection(useRunStore(runId), nodes);
+    const entries = Object.entries(state.nodes);
+    if (entries.length === 0) {
+        return _jsx("p", { className: "text-muted-foreground text-xs", children: "No nodes yet." });
+    }
+    return (_jsx("ul", { className: "grid gap-2", children: entries.map(([id, node]) => (_jsxs("li", { className: "border-border bg-card/60 rounded-lg border p-2.5 text-xs", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "min-w-0 flex-1 truncate font-mono font-medium", children: id }), _jsx(StatusBadge, { status: node.status })] }), node.result !== null ? (_jsx(JsonTree, { value: asJson(node.result), className: "mt-1.5" })) : null, node.error ? _jsx("p", { className: "text-status-failed mt-1.5", children: node.error }) : null] }, id))) }));
+}

package/dist/workflow/debugger/summarize.d.ts

@@ -0,0 +1,2 @@
+import { type DebuggerEvent, type EventSummary } from '@swirls/looms/debugger';
+export declare function summarizeWorkflowEvent(event: DebuggerEvent): EventSummary | undefined;

package/dist/workflow/debugger/summarize.js

@@ -0,0 +1,30 @@
+import { compactJson, jsonFields, jsonText, } from '@swirls/looms/debugger';
+export function summarizeWorkflowEvent(event) {
+    const payload = jsonFields(event.payload);
+    switch (event.type) {
+        case 'workflow.node.started':
+            return { title: 'node started', detail: jsonText(payload.nodeId) };
+        case 'workflow.node.finished':
+            return {
+                title: jsonText(payload.error) ? 'node failed' : 'node finished',
+                detail: jsonText(payload.error) ??
+                    `${jsonText(payload.nodeId) ?? ''} ${compactJson(payload.result ?? null)}`,
+            };
+        case 'workflow.node.skipped':
+            return {
+                title: 'node skipped',
+                detail: `${jsonText(payload.nodeId) ?? ''} · ${jsonText(payload.reason) ?? ''}`,
+            };
+        case 'workflow.spawn.requested':
+            return {
+                title: 'workflow spawn',
+                detail: `${jsonText(payload.definitionName) ?? 'unknown'} from ${jsonText(payload.nodeId) ?? ''}`,
+            };
+        case 'workflow.sleep.requested':
+            return { title: 'sleep', detail: jsonText(payload.nodeId) };
+        case 'workflow.effects.requested':
+            return { title: 'workflow effects', detail: jsonText(payload.nodeId) };
+        default:
+            return undefined;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swirls/looms",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Pluggable event-sourced runtime for durable agents and workflows",
   "homepage": "https://github.com/ByteSliceHQ/looms#readme",
   "bugs": {
@@ -37,6 +37,10 @@
       "types": "./dist/agent/index.d.ts",
       "import": "./dist/agent/index.js"
     },
+    "./agent/debugger": {
+      "types": "./dist/agent/debugger/index.d.ts",
+      "import": "./dist/agent/debugger/index.js"
+    },
     "./ai-vercel": {
       "types": "./dist/ai-vercel/index.d.ts",
       "import": "./dist/ai-vercel/index.js"
@@ -45,6 +49,10 @@
       "types": "./dist/approval/index.d.ts",
       "import": "./dist/approval/index.js"
     },
+    "./approval/debugger": {
+      "types": "./dist/approval/debugger/index.d.ts",
+      "import": "./dist/approval/debugger/index.js"
+    },
     "./cli": {
       "types": "./dist/cli/index.d.ts",
       "import": "./dist/cli/index.js"
@@ -65,6 +73,10 @@
       "types": "./dist/debugger/index.d.ts",
       "import": "./dist/debugger/index.js"
     },
+    "./debugger/server": {
+      "types": "./dist/debugger/server/index.d.ts",
+      "import": "./dist/debugger/server/index.js"
+    },
     "./evaluator": {
       "types": "./dist/evaluator/index.d.ts",
       "import": "./dist/evaluator/index.js"
@@ -93,6 +105,10 @@
       "types": "./dist/workflow/index.d.ts",
       "import": "./dist/workflow/index.js"
     },
+    "./workflow/debugger": {
+      "types": "./dist/workflow/debugger/index.d.ts",
+      "import": "./dist/workflow/debugger/index.js"
+    },
     "./core/sqlite-store": {
       "types": "./dist/core/sqlite-store.d.ts",
       "import": "./dist/core/sqlite-store.js"
@@ -132,9 +148,11 @@
     "@standard-schema/spec": "^1.1.0",
     "@tanstack/react-virtual": "^3.14.11",
     "clsx": "^2.1.1",
+    "cmdk": "^1.1.1",
     "effect": "4.0.0-rc.112",
     "lucide-react": "^1.43.0",
     "radix-ui": "^1.6.7",
+    "react-resizable-panels": "^4.13.3",
     "tailwind-merge": "^3.6.0"
   },
   "devDependencies": {
@@ -148,6 +166,7 @@
     "@looms/cloudflare": "workspace:*",
     "@looms/core": "workspace:*",
     "@looms/debugger": "workspace:*",
+    "@looms/debugger-app": "workspace:*",
     "@looms/evaluator": "workspace:*",
     "@looms/projectors": "workspace:*",
     "@looms/react": "workspace:*",

package/dist/debugger/events/domain-summarize.d.ts

@@ -1,3 +0,0 @@
-import type { DebuggerEvent } from '../contracts';
-import type { EventSummary } from './family';
-export declare function summarizeDomainEvent(event: DebuggerEvent): EventSummary | undefined;

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

@@ -1,107 +0,0 @@
-import { isJsonNumber, isJsonObject, isJsonString } from '@swirls/looms/core';
-import { compactJson } from '../lib/cn.js';
-function obj(value) {
-    return isJsonObject(value) ? value : {};
-}
-function text(value) {
-    return isJsonString(value) ? value : undefined;
-}
-function numeric(value) {
-    return isJsonNumber(value) ? String(value) : undefined;
-}
-function messageContent(payload) {
-    const message = obj(payload ?? null).message;
-    return isJsonObject(message) && isJsonString(message.content) ? message.content : undefined;
-}
-function toolCallSummary(payload) {
-    const call = obj(payload ?? null).toolCall;
-    if (!isJsonObject(call)) {
-        return { name: 'tool', args: null };
-    }
-    const summary = {
-        name: isJsonString(call.name) ? call.name : 'tool',
-        args: call.arguments ?? null,
-    };
-    return summary;
-}
-export function summarizeDomainEvent(event) {
-    const payload = obj(event.payload);
-    switch (event.type) {
-        case 'agent.message.received':
-            return { title: 'user message', detail: messageContent(event.payload) };
-        case 'agent.turn.started':
-            return { title: 'turn started', detail: `turn ${numeric(payload.turn) ?? ''}` };
-        case 'agent.turn.text_delta':
-            return { title: 'text delta', detail: text(payload.delta) };
-        case 'agent.message':
-            return { title: 'agent message', detail: messageContent(event.payload) };
-        case 'agent.tool_call.requested': {
-            const call = toolCallSummary(event.payload);
-            return { title: `tool ${call.name}`, detail: compactJson(call.args) };
-        }
-        case 'agent.tool.result':
-            return {
-                title: text(payload.error)
-                    ? `tool error ${text(payload.name)}`
-                    : `tool result ${text(payload.name)}`,
-                detail: text(payload.error) ?? compactJson(payload.result ?? null),
-            };
-        case 'agent.steered':
-            return { title: 'steered', detail: messageContent(event.payload) };
-        case 'agent.spawn.requested':
-            return {
-                title: 'agent spawn',
-                detail: `${text(payload.kind) ?? 'agent'}:${text(payload.definitionName) ?? 'unknown'}`,
-            };
-        case 'agent.effects.requested':
-            return { title: 'agent effects', detail: text(payload.toolCallId) };
-        case 'workflow.node.started':
-            return { title: 'node started', detail: text(payload.nodeId) };
-        case 'workflow.node.finished':
-            return {
-                title: text(payload.error) ? 'node failed' : 'node finished',
-                detail: text(payload.error) ??
-                    `${text(payload.nodeId) ?? ''} ${compactJson(payload.result ?? null)}`,
-            };
-        case 'workflow.node.skipped':
-            return {
-                title: 'node skipped',
-                detail: `${text(payload.nodeId) ?? ''} · ${text(payload.reason) ?? ''}`,
-            };
-        case 'workflow.spawn.requested':
-            return {
-                title: 'workflow spawn',
-                detail: `${text(payload.definitionName) ?? 'unknown'} from ${text(payload.nodeId) ?? ''}`,
-            };
-        case 'workflow.sleep.requested':
-            return { title: 'sleep', detail: text(payload.nodeId) };
-        case 'workflow.effects.requested':
-            return { title: 'workflow effects', detail: text(payload.nodeId) };
-        case 'approval.requested':
-            return { title: 'approval requested', detail: text(payload.title) };
-        case 'approval.decided':
-            return {
-                title: `approval ${text(payload.outcome) ?? 'decided'}`,
-                detail: text(payload.approvalId),
-            };
-        case 'approval.timed_out':
-            return { title: 'approval timed out', detail: text(payload.approvalId) };
-        case 'payments.charge.requested':
-            return {
-                title: 'charge requested',
-                detail: `${numeric(payload.amount) ?? ''} ${text(payload.currency) ?? ''}`.trim(),
-            };
-        case 'payments.charge.authorized':
-            return {
-                title: 'charge authorized',
-                detail: `${numeric(payload.amount) ?? ''} ${text(payload.currency) ?? ''}`.trim(),
-            };
-        case 'payments.charge.declined':
-            return {
-                title: 'charge declined',
-                detail: `${numeric(payload.amount) ?? ''} ${text(payload.currency) ?? ''} · ${text(payload.reason) ?? ''}`.trim(),
-            };
-        default:
-            return undefined;
-    }
-}

package/dist/debugger/events/family.d.ts

@@ -1,8 +0,0 @@
-export declare const DEFAULT_FAMILIES: readonly ['runtime', 'agent', 'workflow', 'approval', 'payments', 'wait'];
-export type EventFamily = (typeof DEFAULT_FAMILIES)[number];
-export type EventSummary = {
-    title: string;
-    detail?: string;
-};
-export declare function familyFromPrefix(type: string): EventFamily;
-export declare function familyClass(family: string): string;

package/dist/debugger/events/family.js

@@ -1,44 +0,0 @@
-export const DEFAULT_FAMILIES = [
-    'runtime',
-    'agent',
-    'workflow',
-    'approval',
-    'payments',
-    'wait',
-];
-export function familyFromPrefix(type) {
-    if (type.startsWith('agent.')) {
-        return 'agent';
-    }
-    if (type.startsWith('workflow.')) {
-        return 'workflow';
-    }
-    if (type.startsWith('approval.')) {
-        return 'approval';
-    }
-    if (type.startsWith('payments.')) {
-        return 'payments';
-    }
-    if (type.startsWith('runtime.wait')) {
-        return 'wait';
-    }
-    return 'runtime';
-}
-export function familyClass(family) {
-    switch (family) {
-        case 'agent':
-            return 'bg-family-agent';
-        case 'workflow':
-            return 'bg-family-workflow';
-        case 'approval':
-            return 'bg-family-approval';
-        case 'payments':
-            return 'bg-family-payments';
-        case 'wait':
-            return 'bg-family-wait';
-        case 'runtime':
-            return 'bg-family-runtime';
-        default:
-            return 'bg-family-runtime';
-    }
-}