@swirls/looms 0.0.2 → 0.1.0

package/dist/approval/effects.d.ts

@@ -34,12 +34,93 @@ export declare const requestApprovalEffect: NoInfer<import("@swirls/looms/core")
     readonly payload: {
         readonly approvalId: string;
     };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.effect.ambiguous";
+    readonly payload: {
+        readonly effectId: string;
+        readonly attempt: number;
+        readonly error: string;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.effect.attempt.started";
+    readonly payload: {
+        readonly effectId: string;
+        readonly attempt: number;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.effect.cancel.requested";
+    readonly payload: {
+        readonly effectId: string;
+        readonly attempt: number;
+        readonly deadlineAt: number | null;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.effect.cancelled";
+    readonly payload: {
+        readonly effectId: string;
+        readonly attempt: number;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.effect.completed";
+    readonly payload: {
+        readonly effectId: string;
+        readonly attempt: number;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.effect.dispatched";
+    readonly payload: {
+        readonly effectId: string;
+        readonly attempt: number;
+        readonly deadlineAt: number | null;
+    };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
     readonly type: "runtime.effect.failed";
     readonly payload: {
         readonly effectId: string;
         readonly error: string;
     };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.effect.heartbeat";
+    readonly payload: {
+        readonly effectId: string;
+        readonly attempt: number;
+        readonly heartbeatAt: number;
+        readonly deadlineAt: number | null;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.effect.queued";
+    readonly payload: {
+        readonly effectId: string;
+        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: {
+        readonly effectId: string;
+        readonly attempt: number;
+        readonly timeout: string;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.effect.worker.started";
+    readonly payload: {
+        readonly effectId: string;
+        readonly attempt: number;
+        readonly deadlineAt: number | null;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.run.cancelled";
+    readonly payload: {
+        readonly reason?: string | undefined;
+    };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
     readonly type: "runtime.run.completed";
     readonly payload: {
@@ -52,7 +133,9 @@ export declare const requestApprovalEffect: NoInfer<import("@swirls/looms/core")
         readonly rootThreadId?: string | undefined;
         readonly kind: string;
         readonly definitionName: string;
+        readonly definitionVersion: string;
         readonly input: import("effect/Schema").Json;
+        readonly requestedThreadId?: string | null | undefined;
     };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
     readonly type: "runtime.signal.received";
@@ -66,6 +149,11 @@ export declare const requestApprovalEffect: NoInfer<import("@swirls/looms/core")
         readonly stateHash: string;
         readonly state?: import("effect/Schema").Json | undefined;
     };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.thread.cancel.requested";
+    readonly payload: {
+        readonly threadId: string;
+    };
 }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
     readonly type: "runtime.thread.cancelled";
     readonly payload: {
@@ -90,6 +178,7 @@ export declare const requestApprovalEffect: NoInfer<import("@swirls/looms/core")
         readonly threadId: string;
         readonly kind: string;
         readonly definitionName: string;
+        readonly definitionVersion: string;
         readonly input: import("effect/Schema").Json;
         readonly parentThreadId: string | null;
     };

package/dist/approval/module.d.ts

@@ -56,12 +56,93 @@ export declare function approval(): import("@swirls/looms/core").RuntimeModule<"
         readonly payload: {
             readonly approvalId: string;
         };
+    }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+        readonly type: "runtime.effect.ambiguous";
+        readonly payload: {
+            readonly effectId: string;
+            readonly attempt: number;
+            readonly error: string;
+        };
+    }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+        readonly type: "runtime.effect.attempt.started";
+        readonly payload: {
+            readonly effectId: string;
+            readonly attempt: number;
+        };
+    }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+        readonly type: "runtime.effect.cancel.requested";
+        readonly payload: {
+            readonly effectId: string;
+            readonly attempt: number;
+            readonly deadlineAt: number | null;
+        };
+    }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+        readonly type: "runtime.effect.cancelled";
+        readonly payload: {
+            readonly effectId: string;
+            readonly attempt: number;
+        };
+    }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+        readonly type: "runtime.effect.completed";
+        readonly payload: {
+            readonly effectId: string;
+            readonly attempt: number;
+        };
+    }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+        readonly type: "runtime.effect.dispatched";
+        readonly payload: {
+            readonly effectId: string;
+            readonly attempt: number;
+            readonly deadlineAt: number | null;
+        };
     }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
         readonly type: "runtime.effect.failed";
         readonly payload: {
             readonly effectId: string;
             readonly error: string;
         };
+    }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+        readonly type: "runtime.effect.heartbeat";
+        readonly payload: {
+            readonly effectId: string;
+            readonly attempt: number;
+            readonly heartbeatAt: number;
+            readonly deadlineAt: number | null;
+        };
+    }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+        readonly type: "runtime.effect.queued";
+        readonly payload: {
+            readonly effectId: string;
+            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: {
+            readonly effectId: string;
+            readonly attempt: number;
+            readonly timeout: string;
+        };
+    }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+        readonly type: "runtime.effect.worker.started";
+        readonly payload: {
+            readonly effectId: string;
+            readonly attempt: number;
+            readonly deadlineAt: number | null;
+        };
+    }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+        readonly type: "runtime.run.cancelled";
+        readonly payload: {
+            readonly reason?: string | undefined;
+        };
     }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
         readonly type: "runtime.run.completed";
         readonly payload: {
@@ -74,7 +155,9 @@ export declare function approval(): import("@swirls/looms/core").RuntimeModule<"
             readonly rootThreadId?: string | undefined;
             readonly kind: string;
             readonly definitionName: string;
+            readonly definitionVersion: string;
             readonly input: import("effect/Schema").Json;
+            readonly requestedThreadId?: string | null | undefined;
         };
     }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
         readonly type: "runtime.signal.received";
@@ -88,6 +171,11 @@ export declare function approval(): import("@swirls/looms/core").RuntimeModule<"
             readonly stateHash: string;
             readonly state?: import("effect/Schema").Json | undefined;
         };
+    }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+        readonly type: "runtime.thread.cancel.requested";
+        readonly payload: {
+            readonly threadId: string;
+        };
     }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
         readonly type: "runtime.thread.cancelled";
         readonly payload: {
@@ -112,6 +200,7 @@ export declare function approval(): import("@swirls/looms/core").RuntimeModule<"
             readonly threadId: string;
             readonly kind: string;
             readonly definitionName: string;
+            readonly definitionVersion: string;
             readonly input: import("effect/Schema").Json;
             readonly parentThreadId: string | null;
         };
@@ -162,22 +251,8 @@ export declare function approval(): import("@swirls/looms/core").RuntimeModule<"
             readonly status: "approved" | "pending" | "rejected" | "timed_out";
             readonly threadId: string | null;
         }[];
-    } | {
-        items: ({
-            readonly approvalId: string;
-            readonly title: string;
-            readonly description?: string | undefined;
-            readonly status: "approved" | "pending" | "rejected" | "timed_out";
-            readonly threadId: string | null;
-        } | {
-            approvalId: string;
-            title: string;
-            description?: string | undefined;
-            threadId: string | null;
-            status: string;
-        })[];
     }>;
-}, any> & {
+}, import("effect/Context").Service.Any> & {
     readonly effects: {
         request: import("@swirls/looms/core").EffectDefinition<{
             readonly approvalId: string;
@@ -215,12 +290,93 @@ export declare function approval(): import("@swirls/looms/core").RuntimeModule<"
             readonly payload: {
                 readonly approvalId: string;
             };
+        }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+            readonly type: "runtime.effect.ambiguous";
+            readonly payload: {
+                readonly effectId: string;
+                readonly attempt: number;
+                readonly error: string;
+            };
+        }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+            readonly type: "runtime.effect.attempt.started";
+            readonly payload: {
+                readonly effectId: string;
+                readonly attempt: number;
+            };
+        }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+            readonly type: "runtime.effect.cancel.requested";
+            readonly payload: {
+                readonly effectId: string;
+                readonly attempt: number;
+                readonly deadlineAt: number | null;
+            };
+        }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+            readonly type: "runtime.effect.cancelled";
+            readonly payload: {
+                readonly effectId: string;
+                readonly attempt: number;
+            };
+        }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+            readonly type: "runtime.effect.completed";
+            readonly payload: {
+                readonly effectId: string;
+                readonly attempt: number;
+            };
+        }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+            readonly type: "runtime.effect.dispatched";
+            readonly payload: {
+                readonly effectId: string;
+                readonly attempt: number;
+                readonly deadlineAt: number | null;
+            };
         }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
             readonly type: "runtime.effect.failed";
             readonly payload: {
                 readonly effectId: string;
                 readonly error: string;
             };
+        }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+            readonly type: "runtime.effect.heartbeat";
+            readonly payload: {
+                readonly effectId: string;
+                readonly attempt: number;
+                readonly heartbeatAt: number;
+                readonly deadlineAt: number | null;
+            };
+        }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+            readonly type: "runtime.effect.queued";
+            readonly payload: {
+                readonly effectId: string;
+                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: {
+                readonly effectId: string;
+                readonly attempt: number;
+                readonly timeout: string;
+            };
+        }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+            readonly type: "runtime.effect.worker.started";
+            readonly payload: {
+                readonly effectId: string;
+                readonly attempt: number;
+                readonly deadlineAt: number | null;
+            };
+        }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+            readonly type: "runtime.run.cancelled";
+            readonly payload: {
+                readonly reason?: string | undefined;
+            };
         }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
             readonly type: "runtime.run.completed";
             readonly payload: {
@@ -233,7 +389,9 @@ export declare function approval(): import("@swirls/looms/core").RuntimeModule<"
                 readonly rootThreadId?: string | undefined;
                 readonly kind: string;
                 readonly definitionName: string;
+                readonly definitionVersion: string;
                 readonly input: import("effect/Schema").Json;
+                readonly requestedThreadId?: string | null | undefined;
             };
         }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
             readonly type: "runtime.signal.received";
@@ -247,6 +405,11 @@ export declare function approval(): import("@swirls/looms/core").RuntimeModule<"
                 readonly stateHash: string;
                 readonly state?: import("effect/Schema").Json | undefined;
             };
+        }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+            readonly type: "runtime.thread.cancel.requested";
+            readonly payload: {
+                readonly threadId: string;
+            };
         }) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
             readonly type: "runtime.thread.cancelled";
             readonly payload: {
@@ -271,6 +434,7 @@ export declare function approval(): import("@swirls/looms/core").RuntimeModule<"
                 readonly threadId: string;
                 readonly kind: string;
                 readonly definitionName: string;
+                readonly definitionVersion: string;
                 readonly input: import("effect/Schema").Json;
                 readonly parentThreadId: string | null;
             };
@@ -323,20 +487,6 @@ export declare function approval(): import("@swirls/looms/core").RuntimeModule<"
                 readonly status: "approved" | "pending" | "rejected" | "timed_out";
                 readonly threadId: string | null;
             }[];
-        } | {
-            items: ({
-                readonly approvalId: string;
-                readonly title: string;
-                readonly description?: string | undefined;
-                readonly status: "approved" | "pending" | "rejected" | "timed_out";
-                readonly threadId: string | null;
-            } | {
-                approvalId: string;
-                title: string;
-                description?: string | undefined;
-                threadId: string | null;
-                status: string;
-            })[];
         }>;
     };
 };

package/dist/approval/projections.d.ts

@@ -25,18 +25,4 @@ export declare const pendingApprovals: import("@swirls/looms/core").ProjectionDe
         readonly status: "approved" | "pending" | "rejected" | "timed_out";
         readonly threadId: string | null;
     }[];
-} | {
-    items: ({
-        readonly approvalId: string;
-        readonly title: string;
-        readonly description?: string | undefined;
-        readonly status: "approved" | "pending" | "rejected" | "timed_out";
-        readonly threadId: string | null;
-    } | {
-        approvalId: string;
-        title: string;
-        description?: string | undefined;
-        threadId: string | null;
-        status: string;
-    })[];
 }>;

package/dist/approval/projections.js

@@ -1,4 +1,4 @@
-import { Schema } from 'effect';
+import { Predicate, Schema } from 'effect';
 import { approvalModule } from './scope.js';
 export const PendingApprovalSchema = Schema.Struct({
     approvalId: Schema.String,
@@ -41,13 +41,30 @@ export const pendingApprovals = approvalModule.projection({
                 const { approvalId, outcome } = event.payload;
                 const status = outcome === 'reject' ? 'rejected' : 'approved';
                 return {
-                    items: state.items.map((item) => item.approvalId === approvalId ? { ...item, status } : item),
+                    items: state.items.map((item) => item.approvalId === approvalId && item.status === 'pending'
+                        ? { ...item, status }
+                        : item),
                 };
             }
             case 'approval.timed_out': {
                 const { approvalId } = event.payload;
                 return {
-                    items: state.items.map((item) => item.approvalId === approvalId ? { ...item, status: 'timed_out' } : item),
+                    items: state.items.map((item) => item.approvalId === approvalId && item.status === 'pending'
+                        ? { ...item, status: 'timed_out' }
+                        : item),
+                };
+            }
+            case 'runtime.wait.satisfied': {
+                const tag = event.payload.tag;
+                if (!Predicate.isObject(tag) ||
+                    !Predicate.isString(tag.approvalId) ||
+                    tag.outcome !== 'timeout') {
+                    return state;
+                }
+                return {
+                    items: state.items.map((item) => item.approvalId === tag.approvalId && item.status === 'pending'
+                        ? { ...item, status: 'timed_out' }
+                        : item),
                 };
             }
             default:

package/dist/approval/signals.d.ts

@@ -6,6 +6,8 @@ export declare function gate(args: {
     approvalId?: string;
     actions?: ApprovalAction[];
     schema?: JsonValue;
+    /** Absolute epoch milliseconds. Decision and timer waits race; the first wins. */
+    timeoutAt?: number;
 }): RuntimeEffect[];
 export type ApprovalChoice = 'approve' | 'reject' | {
     actionId: string;

package/dist/approval/signals.js

@@ -7,7 +7,7 @@ export function gate(args) {
         { id: 'approve', label: 'Approve', outcome: 'approve' },
         { id: 'reject', label: 'Reject', outcome: 'reject' },
     ];
-    return [
+    const effects = [
         invoke(requestApprovalEffect, {
             approvalId,
             title: args.title,
@@ -18,9 +18,25 @@ export function gate(args) {
         wait({
             waitId: createWaitId(approvalId, 'decision'),
             on: { type: 'approval.decided', match: { approvalId } },
-            tag: { approvalId },
+            tag: { approvalId, raceId: approvalId },
         }),
     ];
+    if (args.timeoutAt !== undefined) {
+        if (!Number.isFinite(args.timeoutAt)) {
+            throw new Error('Approval timeoutAt must be a finite epoch timestamp');
+        }
+        effects.push(wait({
+            waitId: createWaitId(approvalId, 'timeout'),
+            on: { timerAt: args.timeoutAt },
+            tag: {
+                approvalId,
+                raceId: approvalId,
+                outcome: 'timeout',
+                error: `Approval ${approvalId} timed out`,
+            },
+        }));
+    }
+    return effects;
 }
 /**
  * Build the `approval.decided` event that resolves a pending gate.

package/dist/cli/cli.js

@@ -3,4 +3,6 @@ import { BunRuntime, BunServices } from '@effect/platform-bun';
 import { Effect } from 'effect';
 import { Command } from 'effect/unstable/cli';
 import { looms, VERSION } from './commands.js';
+// This executable boundary owns the lifetime of the complete application layer.
+// oxlint-disable-next-line effecttsgo/strict-effect-provide
 looms.pipe(Command.run({ version: VERSION }), Effect.provide(BunServices.layer), BunRuntime.runMain);

package/dist/cli/commands.js

@@ -1,9 +1,10 @@
-import { Config, Console, Effect, FileSystem, Layer, Option, Path, Queue, Stdio, Stream, Terminal, } from 'effect';
+import { Config, Console, Effect, FileSystem, Layer, Option, Path, Queue, Schema, Stdio, Stream, Terminal, } from 'effect';
 import { Argument, CliError, Command, Flag } from 'effect/unstable/cli';
 import { ChildProcessSpawner } from 'effect/unstable/process';
 import { steer as steerEvent } from '@swirls/looms/agent';
 import { decision } from '@swirls/looms/approval';
 import { createLoomsClient } from '@swirls/looms/client';
+import { stringifyJson, stringifyJsonPretty } from '@swirls/looms/core';
 import { createLooms } from '@swirls/looms/runtime';
 const VERSION = '0.0.1';
 const urlFlag = Flag.string('url').pipe(Flag.withDescription('Looms host base URL (env LOOMS_URL)'), Flag.withFallbackConfig(Config.string('LOOMS_URL')), Flag.withDefault('http://127.0.0.1:8787'), Flag.map((url) => url.replace(/\/$/, '')));
@@ -11,13 +12,7 @@ function parseJsonArg(raw) {
     if (Option.isNone(raw) || raw.value === '') {
         return null;
     }
-    try {
-        // SAFETY: CLI JSON args decode to JsonValue; parse failures fall back to the raw string
-        return JSON.parse(raw.value);
-    }
-    catch {
-        return raw.value;
-    }
+    return Option.getOrElse(Schema.decodeOption(Schema.fromJsonString(Schema.Json))(raw.value), () => raw.value);
 }
 function clientFor(url) {
     return createLoomsClient({ baseUrl: url });
@@ -47,21 +42,21 @@ const start = Command.make('start', {
 }, Effect.fn('start')(function* ({ kind, name, json }) {
     const { url } = yield* loomsBase;
     const result = yield* tryClient(() => clientFor(url).startRun({ kind, definitionName: name, input: parseJsonArg(json) }));
-    yield* Console.log(JSON.stringify(result, null, 2));
+    yield* Console.log(stringifyJsonPretty(result));
 })).pipe(Command.withDescription('Start a run from a registered definition: looms start agent echo \'{"text":"hi"}\''), Command.withShortDescription('Start a run'));
 const events = Command.make('events', {
     runId: Argument.string('runId').pipe(Argument.withDescription('Run id')),
 }, Effect.fn('events')(function* ({ runId }) {
     const { url } = yield* loomsBase;
     const result = yield* tryClient(() => clientFor(url).getEvents(runId));
-    yield* Console.log(JSON.stringify(result, null, 2));
+    yield* Console.log(stringifyJsonPretty(result));
 })).pipe(Command.withDescription('List events for a run'), Command.withShortDescription('List run events'));
 const state = Command.make('state', {
     runId: Argument.string('runId').pipe(Argument.withDescription('Run id')),
 }, Effect.fn('state')(function* ({ runId }) {
     const { url } = yield* loomsBase;
     const result = yield* tryClient(() => clientFor(url).getRun(runId));
-    yield* Console.log(JSON.stringify(result, null, 2));
+    yield* Console.log(stringifyJsonPretty(result));
 })).pipe(Command.withDescription('Show run state'), Command.withShortDescription('Show run state'));
 const approve = Command.make('approve', {
     runId: Argument.string('runId').pipe(Argument.withDescription('Run id')),
@@ -78,7 +73,8 @@ const approve = Command.make('approve', {
     const outcome = accept ? 'approve' : 'reject';
     const { url } = yield* loomsBase;
     const result = yield* tryClient(() => clientFor(url).signal(runId, [decision(approvalId, outcome)]));
-    yield* Console.log(JSON.stringify(result, null, 2));
+    yield* Console.log(stringifyJsonPretty(result));
+    return undefined;
 })).pipe(Command.withDescription('Approve or reject a pending approval'), Command.withShortDescription('Decide an approval'));
 const replay = Command.make('replay', {
     runId: Argument.string('runId').pipe(Argument.withDescription('Run id')),
@@ -86,7 +82,7 @@ const replay = Command.make('replay', {
 }, Effect.fn('replay')(function* ({ runId, seq }) {
     const { url } = yield* loomsBase;
     const result = yield* tryClient(() => clientFor(url).replayTo(runId, seq));
-    yield* Console.log(JSON.stringify(result, null, 2));
+    yield* Console.log(stringifyJsonPretty(result));
 })).pipe(Command.withDescription('Replay a run to a sequence'), Command.withShortDescription('Replay to seq'));
 const signal = Command.make('signal', {
     runId: Argument.string('runId').pipe(Argument.withDescription('Run id')),
@@ -95,7 +91,7 @@ const signal = Command.make('signal', {
 }, Effect.fn('signal')(function* ({ runId, type, json }) {
     const { url } = yield* loomsBase;
     const result = yield* tryClient(() => clientFor(url).signal(runId, [{ type, payload: parseJsonArg(json) }]));
-    yield* Console.log(JSON.stringify(result, null, 2));
+    yield* Console.log(stringifyJsonPretty(result));
 })).pipe(Command.withDescription('Append an external event and wake the run'), Command.withShortDescription('Signal a run'));
 const steer = Command.make('steer', {
     runId: Argument.string('runId').pipe(Argument.withDescription('Run id')),
@@ -104,7 +100,7 @@ const steer = Command.make('steer', {
 }, Effect.fn('steer')(function* ({ runId, message, interrupt }) {
     const { url } = yield* loomsBase;
     const result = yield* tryClient(() => clientFor(url).signal(runId, [steerEvent(message.join(' '), { interrupt })]));
-    yield* Console.log(JSON.stringify(result, null, 2));
+    yield* Console.log(stringifyJsonPretty(result));
 })).pipe(Command.withDescription('Send a steering message to a running agent'), Command.withShortDescription('Steer an agent'));
 const tail = Command.make('tail', {
     runId: Argument.string('runId').pipe(Argument.withDescription('Run id')),
@@ -115,7 +111,7 @@ const tail = Command.make('tail', {
     yield* Effect.scoped(Effect.gen(function* () {
         const queue = yield* Queue.unbounded();
         yield* Effect.acquireRelease(Effect.sync(() => client.subscribeEvents(runId, (event) => {
-            Queue.offerUnsafe(queue, JSON.stringify(event));
+            Queue.offerUnsafe(queue, stringifyJson(event));
         })), (stop) => Effect.sync(() => stop()));
         yield* Stream.fromQueue(queue).pipe(Stream.runForEach((line) => Console.log(line)));
     }));