@swirls/looms 0.0.2 → 0.2.0

package/dist/client/client.d.ts

@@ -1,7 +1,9 @@
-import { type DefinitionInput, type DefinitionRef, type EventEnvelope, type EventInput, type JsonValue, type RunState } from '@swirls/looms/core';
+import { Schema } from 'effect';
+import { type DefinitionInput, type DefinitionRef, type EventEnvelope, type EventInput, type JsonValue, type RunState, type WorkerCallbackInput } from '@swirls/looms/core';
 export interface LoomsClientOptions {
     baseUrl?: string;
     fetch?: typeof fetch;
+    workerCallbackToken?: string;
 }
 export interface StartResult {
     runId: string;
@@ -16,42 +18,1234 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
     startRun: (args: {
         kind: string;
         definitionName: string;
+        definitionVersion?: string;
         input?: JsonValue;
         runId?: string;
-    }) => Promise<StartResult>;
+    }) => Promise<{
+        readonly runId: string;
+        readonly threadId: string;
+        readonly state: {
+            readonly runId: string;
+            readonly status: "cancelled" | "completed" | "failed" | "running";
+            readonly rootThreadId: string | null;
+            readonly startIdentity: {
+                readonly kind: string;
+                readonly definitionName: string;
+                readonly definitionVersion: string;
+                readonly input: Schema.Json;
+                readonly requestedThreadId: string | null;
+                readonly idempotencyKey: string | null;
+                readonly rootThreadId: string;
+            } | null;
+            readonly threads: {
+                readonly [x: string]: {
+                    readonly threadId: string;
+                    readonly kind: string;
+                    readonly definitionName: string;
+                    readonly definitionVersion: string;
+                    readonly parentThreadId: string | null;
+                    readonly status: "cancelled" | "completed" | "failed" | "running" | "waiting";
+                    readonly input: Schema.Json;
+                    readonly output: Schema.Json;
+                    readonly error: string | null;
+                    readonly state: Schema.Json;
+                };
+            };
+            readonly waits: {
+                readonly [x: string]: {
+                    readonly waitId: string;
+                    readonly threadId: string;
+                    readonly on: {
+                        readonly type: string | readonly string[];
+                        readonly match?: Schema.Json | undefined;
+                    } | {
+                        readonly timerAt: number;
+                    };
+                    readonly tag?: Schema.Json | undefined;
+                };
+            };
+            readonly outstandingEffects: readonly {
+                readonly effectId: string;
+                readonly threadId: string;
+                readonly causingSeq: number;
+                readonly causingEventId: string;
+                readonly effect: {
+                    readonly type: "runtime.spawn";
+                    readonly childThreadId: string;
+                    readonly kind: string;
+                    readonly definitionName: string;
+                    readonly definitionVersion: string;
+                    readonly input: Schema.Json;
+                } | {
+                    readonly type: "runtime.wait";
+                    readonly waitId: string;
+                    readonly on: {
+                        readonly type: string | readonly string[];
+                        readonly match?: Schema.Json | undefined;
+                    } | {
+                        readonly timerAt: number;
+                    };
+                    readonly tag?: Schema.Json | undefined;
+                } | {
+                    readonly type: "runtime.emit";
+                    readonly event: {
+                        readonly type: string;
+                        readonly payload: Schema.Json;
+                        readonly threadId?: string | null | undefined;
+                        readonly parentThreadId?: string | null | undefined;
+                        readonly causationId?: string | null | undefined;
+                        readonly correlationId?: string | null | undefined;
+                        readonly effectId?: string | null | undefined;
+                        readonly origin?: {
+                            readonly type: "thread";
+                            readonly threadId: string;
+                        } | {
+                            readonly type: "external";
+                            readonly actorId?: string | undefined;
+                        } | {
+                            readonly type: "system";
+                        } | undefined;
+                        readonly ephemeral?: boolean | undefined;
+                        readonly id?: string | undefined;
+                        readonly ts?: number | undefined;
+                        readonly idempotencyKey?: string | null | undefined;
+                    };
+                    readonly tag?: string | undefined;
+                } | {
+                    readonly type: "runtime.complete";
+                    readonly output: Schema.Json;
+                } | {
+                    readonly type: "runtime.fail";
+                    readonly error: string;
+                } | {
+                    readonly type: "runtime.cancel";
+                    readonly threadId: string;
+                    readonly tag?: string | undefined;
+                } | {
+                    readonly type: string;
+                    readonly input: Schema.Json;
+                    readonly tag?: string | undefined;
+                };
+            }[];
+            readonly effectExecutions: {
+                readonly [x: string]: {
+                    readonly effectId: string;
+                    readonly attempt: number;
+                    readonly status: "ambiguous" | "cancel_requested" | "dispatched" | "heartbeat" | "queued" | "retry_wait" | "running" | "started" | "timed_out";
+                    readonly nextAttemptAt: number | null;
+                    readonly deadlineAt: number | null;
+                    readonly startedAt: number | null;
+                    readonly lastHeartbeatAt: number | null;
+                    readonly lastError: string | null;
+                };
+            };
+            readonly completedEffectIds: readonly string[];
+            readonly processedIdempotencyKeys: readonly string[];
+        };
+    }>;
     /** Start a run from a definition object (agent, workflow, or your own kind). */
-    start: <TDef extends DefinitionRef>(definition: TDef, input?: DefinitionInput<TDef>) => Promise<StartResult>;
+    start: <TDef extends DefinitionRef>(definition: TDef, input?: DefinitionInput<TDef>) => Promise<{
+        readonly runId: string;
+        readonly threadId: string;
+        readonly state: {
+            readonly runId: string;
+            readonly status: "cancelled" | "completed" | "failed" | "running";
+            readonly rootThreadId: string | null;
+            readonly startIdentity: {
+                readonly kind: string;
+                readonly definitionName: string;
+                readonly definitionVersion: string;
+                readonly input: Schema.Json;
+                readonly requestedThreadId: string | null;
+                readonly idempotencyKey: string | null;
+                readonly rootThreadId: string;
+            } | null;
+            readonly threads: {
+                readonly [x: string]: {
+                    readonly threadId: string;
+                    readonly kind: string;
+                    readonly definitionName: string;
+                    readonly definitionVersion: string;
+                    readonly parentThreadId: string | null;
+                    readonly status: "cancelled" | "completed" | "failed" | "running" | "waiting";
+                    readonly input: Schema.Json;
+                    readonly output: Schema.Json;
+                    readonly error: string | null;
+                    readonly state: Schema.Json;
+                };
+            };
+            readonly waits: {
+                readonly [x: string]: {
+                    readonly waitId: string;
+                    readonly threadId: string;
+                    readonly on: {
+                        readonly type: string | readonly string[];
+                        readonly match?: Schema.Json | undefined;
+                    } | {
+                        readonly timerAt: number;
+                    };
+                    readonly tag?: Schema.Json | undefined;
+                };
+            };
+            readonly outstandingEffects: readonly {
+                readonly effectId: string;
+                readonly threadId: string;
+                readonly causingSeq: number;
+                readonly causingEventId: string;
+                readonly effect: {
+                    readonly type: "runtime.spawn";
+                    readonly childThreadId: string;
+                    readonly kind: string;
+                    readonly definitionName: string;
+                    readonly definitionVersion: string;
+                    readonly input: Schema.Json;
+                } | {
+                    readonly type: "runtime.wait";
+                    readonly waitId: string;
+                    readonly on: {
+                        readonly type: string | readonly string[];
+                        readonly match?: Schema.Json | undefined;
+                    } | {
+                        readonly timerAt: number;
+                    };
+                    readonly tag?: Schema.Json | undefined;
+                } | {
+                    readonly type: "runtime.emit";
+                    readonly event: {
+                        readonly type: string;
+                        readonly payload: Schema.Json;
+                        readonly threadId?: string | null | undefined;
+                        readonly parentThreadId?: string | null | undefined;
+                        readonly causationId?: string | null | undefined;
+                        readonly correlationId?: string | null | undefined;
+                        readonly effectId?: string | null | undefined;
+                        readonly origin?: {
+                            readonly type: "thread";
+                            readonly threadId: string;
+                        } | {
+                            readonly type: "external";
+                            readonly actorId?: string | undefined;
+                        } | {
+                            readonly type: "system";
+                        } | undefined;
+                        readonly ephemeral?: boolean | undefined;
+                        readonly id?: string | undefined;
+                        readonly ts?: number | undefined;
+                        readonly idempotencyKey?: string | null | undefined;
+                    };
+                    readonly tag?: string | undefined;
+                } | {
+                    readonly type: "runtime.complete";
+                    readonly output: Schema.Json;
+                } | {
+                    readonly type: "runtime.fail";
+                    readonly error: string;
+                } | {
+                    readonly type: "runtime.cancel";
+                    readonly threadId: string;
+                    readonly tag?: string | undefined;
+                } | {
+                    readonly type: string;
+                    readonly input: Schema.Json;
+                    readonly tag?: string | undefined;
+                };
+            }[];
+            readonly effectExecutions: {
+                readonly [x: string]: {
+                    readonly effectId: string;
+                    readonly attempt: number;
+                    readonly status: "ambiguous" | "cancel_requested" | "dispatched" | "heartbeat" | "queued" | "retry_wait" | "running" | "started" | "timed_out";
+                    readonly nextAttemptAt: number | null;
+                    readonly deadlineAt: number | null;
+                    readonly startedAt: number | null;
+                    readonly lastHeartbeatAt: number | null;
+                    readonly lastError: string | null;
+                };
+            };
+            readonly completedEffectIds: readonly string[];
+            readonly processedIdempotencyKeys: readonly string[];
+        };
+    }>;
     getRun: (runId: string) => Promise<{
-        runId: string;
-        state: RunState;
+        readonly runId: string;
+        readonly state: {
+            readonly runId: string;
+            readonly status: "cancelled" | "completed" | "failed" | "running";
+            readonly rootThreadId: string | null;
+            readonly startIdentity: {
+                readonly kind: string;
+                readonly definitionName: string;
+                readonly definitionVersion: string;
+                readonly input: Schema.Json;
+                readonly requestedThreadId: string | null;
+                readonly idempotencyKey: string | null;
+                readonly rootThreadId: string;
+            } | null;
+            readonly threads: {
+                readonly [x: string]: {
+                    readonly threadId: string;
+                    readonly kind: string;
+                    readonly definitionName: string;
+                    readonly definitionVersion: string;
+                    readonly parentThreadId: string | null;
+                    readonly status: "cancelled" | "completed" | "failed" | "running" | "waiting";
+                    readonly input: Schema.Json;
+                    readonly output: Schema.Json;
+                    readonly error: string | null;
+                    readonly state: Schema.Json;
+                };
+            };
+            readonly waits: {
+                readonly [x: string]: {
+                    readonly waitId: string;
+                    readonly threadId: string;
+                    readonly on: {
+                        readonly type: string | readonly string[];
+                        readonly match?: Schema.Json | undefined;
+                    } | {
+                        readonly timerAt: number;
+                    };
+                    readonly tag?: Schema.Json | undefined;
+                };
+            };
+            readonly outstandingEffects: readonly {
+                readonly effectId: string;
+                readonly threadId: string;
+                readonly causingSeq: number;
+                readonly causingEventId: string;
+                readonly effect: {
+                    readonly type: "runtime.spawn";
+                    readonly childThreadId: string;
+                    readonly kind: string;
+                    readonly definitionName: string;
+                    readonly definitionVersion: string;
+                    readonly input: Schema.Json;
+                } | {
+                    readonly type: "runtime.wait";
+                    readonly waitId: string;
+                    readonly on: {
+                        readonly type: string | readonly string[];
+                        readonly match?: Schema.Json | undefined;
+                    } | {
+                        readonly timerAt: number;
+                    };
+                    readonly tag?: Schema.Json | undefined;
+                } | {
+                    readonly type: "runtime.emit";
+                    readonly event: {
+                        readonly type: string;
+                        readonly payload: Schema.Json;
+                        readonly threadId?: string | null | undefined;
+                        readonly parentThreadId?: string | null | undefined;
+                        readonly causationId?: string | null | undefined;
+                        readonly correlationId?: string | null | undefined;
+                        readonly effectId?: string | null | undefined;
+                        readonly origin?: {
+                            readonly type: "thread";
+                            readonly threadId: string;
+                        } | {
+                            readonly type: "external";
+                            readonly actorId?: string | undefined;
+                        } | {
+                            readonly type: "system";
+                        } | undefined;
+                        readonly ephemeral?: boolean | undefined;
+                        readonly id?: string | undefined;
+                        readonly ts?: number | undefined;
+                        readonly idempotencyKey?: string | null | undefined;
+                    };
+                    readonly tag?: string | undefined;
+                } | {
+                    readonly type: "runtime.complete";
+                    readonly output: Schema.Json;
+                } | {
+                    readonly type: "runtime.fail";
+                    readonly error: string;
+                } | {
+                    readonly type: "runtime.cancel";
+                    readonly threadId: string;
+                    readonly tag?: string | undefined;
+                } | {
+                    readonly type: string;
+                    readonly input: Schema.Json;
+                    readonly tag?: string | undefined;
+                };
+            }[];
+            readonly effectExecutions: {
+                readonly [x: string]: {
+                    readonly effectId: string;
+                    readonly attempt: number;
+                    readonly status: "ambiguous" | "cancel_requested" | "dispatched" | "heartbeat" | "queued" | "retry_wait" | "running" | "started" | "timed_out";
+                    readonly nextAttemptAt: number | null;
+                    readonly deadlineAt: number | null;
+                    readonly startedAt: number | null;
+                    readonly lastHeartbeatAt: number | null;
+                    readonly lastError: string | null;
+                };
+            };
+            readonly completedEffectIds: readonly string[];
+            readonly processedIdempotencyKeys: readonly string[];
+        };
     }>;
     getState: (runId: string) => Promise<{
-        runId: string;
-        state: RunState;
+        readonly runId: string;
+        readonly state: {
+            readonly runId: string;
+            readonly status: "cancelled" | "completed" | "failed" | "running";
+            readonly rootThreadId: string | null;
+            readonly startIdentity: {
+                readonly kind: string;
+                readonly definitionName: string;
+                readonly definitionVersion: string;
+                readonly input: Schema.Json;
+                readonly requestedThreadId: string | null;
+                readonly idempotencyKey: string | null;
+                readonly rootThreadId: string;
+            } | null;
+            readonly threads: {
+                readonly [x: string]: {
+                    readonly threadId: string;
+                    readonly kind: string;
+                    readonly definitionName: string;
+                    readonly definitionVersion: string;
+                    readonly parentThreadId: string | null;
+                    readonly status: "cancelled" | "completed" | "failed" | "running" | "waiting";
+                    readonly input: Schema.Json;
+                    readonly output: Schema.Json;
+                    readonly error: string | null;
+                    readonly state: Schema.Json;
+                };
+            };
+            readonly waits: {
+                readonly [x: string]: {
+                    readonly waitId: string;
+                    readonly threadId: string;
+                    readonly on: {
+                        readonly type: string | readonly string[];
+                        readonly match?: Schema.Json | undefined;
+                    } | {
+                        readonly timerAt: number;
+                    };
+                    readonly tag?: Schema.Json | undefined;
+                };
+            };
+            readonly outstandingEffects: readonly {
+                readonly effectId: string;
+                readonly threadId: string;
+                readonly causingSeq: number;
+                readonly causingEventId: string;
+                readonly effect: {
+                    readonly type: "runtime.spawn";
+                    readonly childThreadId: string;
+                    readonly kind: string;
+                    readonly definitionName: string;
+                    readonly definitionVersion: string;
+                    readonly input: Schema.Json;
+                } | {
+                    readonly type: "runtime.wait";
+                    readonly waitId: string;
+                    readonly on: {
+                        readonly type: string | readonly string[];
+                        readonly match?: Schema.Json | undefined;
+                    } | {
+                        readonly timerAt: number;
+                    };
+                    readonly tag?: Schema.Json | undefined;
+                } | {
+                    readonly type: "runtime.emit";
+                    readonly event: {
+                        readonly type: string;
+                        readonly payload: Schema.Json;
+                        readonly threadId?: string | null | undefined;
+                        readonly parentThreadId?: string | null | undefined;
+                        readonly causationId?: string | null | undefined;
+                        readonly correlationId?: string | null | undefined;
+                        readonly effectId?: string | null | undefined;
+                        readonly origin?: {
+                            readonly type: "thread";
+                            readonly threadId: string;
+                        } | {
+                            readonly type: "external";
+                            readonly actorId?: string | undefined;
+                        } | {
+                            readonly type: "system";
+                        } | undefined;
+                        readonly ephemeral?: boolean | undefined;
+                        readonly id?: string | undefined;
+                        readonly ts?: number | undefined;
+                        readonly idempotencyKey?: string | null | undefined;
+                    };
+                    readonly tag?: string | undefined;
+                } | {
+                    readonly type: "runtime.complete";
+                    readonly output: Schema.Json;
+                } | {
+                    readonly type: "runtime.fail";
+                    readonly error: string;
+                } | {
+                    readonly type: "runtime.cancel";
+                    readonly threadId: string;
+                    readonly tag?: string | undefined;
+                } | {
+                    readonly type: string;
+                    readonly input: Schema.Json;
+                    readonly tag?: string | undefined;
+                };
+            }[];
+            readonly effectExecutions: {
+                readonly [x: string]: {
+                    readonly effectId: string;
+                    readonly attempt: number;
+                    readonly status: "ambiguous" | "cancel_requested" | "dispatched" | "heartbeat" | "queued" | "retry_wait" | "running" | "started" | "timed_out";
+                    readonly nextAttemptAt: number | null;
+                    readonly deadlineAt: number | null;
+                    readonly startedAt: number | null;
+                    readonly lastHeartbeatAt: number | null;
+                    readonly lastError: string | null;
+                };
+            };
+            readonly completedEffectIds: readonly string[];
+            readonly processedIdempotencyKeys: readonly string[];
+        };
     }>;
     getEvents: (runId: string, opts?: {
         fromSeq?: number;
         limit?: number;
     }) => Promise<{
-        runId: string;
-        events: EventEnvelope[];
+        readonly runId: string;
+        readonly events: readonly {
+            readonly id: string;
+            readonly runId: string;
+            readonly seq: number;
+            readonly ts: number;
+            readonly type: string;
+            readonly payload: Schema.Json;
+            readonly threadId: string | null;
+            readonly parentThreadId?: string | null | undefined;
+            readonly causationId?: string | null | undefined;
+            readonly correlationId?: string | null | undefined;
+            readonly effectId?: string | null | undefined;
+            readonly origin: {
+                readonly type: "thread";
+                readonly threadId: string;
+            } | {
+                readonly type: "external";
+                readonly actorId?: string | undefined;
+            } | {
+                readonly type: "system";
+            };
+            readonly ephemeral?: boolean | undefined;
+            readonly idempotencyKey?: string | null | undefined;
+        }[];
     }>;
     signal: (runId: string, events: ReadonlyArray<EventInput>) => Promise<{
-        runId: string;
-        state: RunState;
+        readonly runId: string;
+        readonly state: {
+            readonly runId: string;
+            readonly status: "cancelled" | "completed" | "failed" | "running";
+            readonly rootThreadId: string | null;
+            readonly startIdentity: {
+                readonly kind: string;
+                readonly definitionName: string;
+                readonly definitionVersion: string;
+                readonly input: Schema.Json;
+                readonly requestedThreadId: string | null;
+                readonly idempotencyKey: string | null;
+                readonly rootThreadId: string;
+            } | null;
+            readonly threads: {
+                readonly [x: string]: {
+                    readonly threadId: string;
+                    readonly kind: string;
+                    readonly definitionName: string;
+                    readonly definitionVersion: string;
+                    readonly parentThreadId: string | null;
+                    readonly status: "cancelled" | "completed" | "failed" | "running" | "waiting";
+                    readonly input: Schema.Json;
+                    readonly output: Schema.Json;
+                    readonly error: string | null;
+                    readonly state: Schema.Json;
+                };
+            };
+            readonly waits: {
+                readonly [x: string]: {
+                    readonly waitId: string;
+                    readonly threadId: string;
+                    readonly on: {
+                        readonly type: string | readonly string[];
+                        readonly match?: Schema.Json | undefined;
+                    } | {
+                        readonly timerAt: number;
+                    };
+                    readonly tag?: Schema.Json | undefined;
+                };
+            };
+            readonly outstandingEffects: readonly {
+                readonly effectId: string;
+                readonly threadId: string;
+                readonly causingSeq: number;
+                readonly causingEventId: string;
+                readonly effect: {
+                    readonly type: "runtime.spawn";
+                    readonly childThreadId: string;
+                    readonly kind: string;
+                    readonly definitionName: string;
+                    readonly definitionVersion: string;
+                    readonly input: Schema.Json;
+                } | {
+                    readonly type: "runtime.wait";
+                    readonly waitId: string;
+                    readonly on: {
+                        readonly type: string | readonly string[];
+                        readonly match?: Schema.Json | undefined;
+                    } | {
+                        readonly timerAt: number;
+                    };
+                    readonly tag?: Schema.Json | undefined;
+                } | {
+                    readonly type: "runtime.emit";
+                    readonly event: {
+                        readonly type: string;
+                        readonly payload: Schema.Json;
+                        readonly threadId?: string | null | undefined;
+                        readonly parentThreadId?: string | null | undefined;
+                        readonly causationId?: string | null | undefined;
+                        readonly correlationId?: string | null | undefined;
+                        readonly effectId?: string | null | undefined;
+                        readonly origin?: {
+                            readonly type: "thread";
+                            readonly threadId: string;
+                        } | {
+                            readonly type: "external";
+                            readonly actorId?: string | undefined;
+                        } | {
+                            readonly type: "system";
+                        } | undefined;
+                        readonly ephemeral?: boolean | undefined;
+                        readonly id?: string | undefined;
+                        readonly ts?: number | undefined;
+                        readonly idempotencyKey?: string | null | undefined;
+                    };
+                    readonly tag?: string | undefined;
+                } | {
+                    readonly type: "runtime.complete";
+                    readonly output: Schema.Json;
+                } | {
+                    readonly type: "runtime.fail";
+                    readonly error: string;
+                } | {
+                    readonly type: "runtime.cancel";
+                    readonly threadId: string;
+                    readonly tag?: string | undefined;
+                } | {
+                    readonly type: string;
+                    readonly input: Schema.Json;
+                    readonly tag?: string | undefined;
+                };
+            }[];
+            readonly effectExecutions: {
+                readonly [x: string]: {
+                    readonly effectId: string;
+                    readonly attempt: number;
+                    readonly status: "ambiguous" | "cancel_requested" | "dispatched" | "heartbeat" | "queued" | "retry_wait" | "running" | "started" | "timed_out";
+                    readonly nextAttemptAt: number | null;
+                    readonly deadlineAt: number | null;
+                    readonly startedAt: number | null;
+                    readonly lastHeartbeatAt: number | null;
+                    readonly lastError: string | null;
+                };
+            };
+            readonly completedEffectIds: readonly string[];
+            readonly processedIdempotencyKeys: readonly string[];
+        };
     }>;
     wake: (runId: string) => Promise<{
-        runId: string;
-        state: RunState;
+        readonly runId: string;
+        readonly state: {
+            readonly runId: string;
+            readonly status: "cancelled" | "completed" | "failed" | "running";
+            readonly rootThreadId: string | null;
+            readonly startIdentity: {
+                readonly kind: string;
+                readonly definitionName: string;
+                readonly definitionVersion: string;
+                readonly input: Schema.Json;
+                readonly requestedThreadId: string | null;
+                readonly idempotencyKey: string | null;
+                readonly rootThreadId: string;
+            } | null;
+            readonly threads: {
+                readonly [x: string]: {
+                    readonly threadId: string;
+                    readonly kind: string;
+                    readonly definitionName: string;
+                    readonly definitionVersion: string;
+                    readonly parentThreadId: string | null;
+                    readonly status: "cancelled" | "completed" | "failed" | "running" | "waiting";
+                    readonly input: Schema.Json;
+                    readonly output: Schema.Json;
+                    readonly error: string | null;
+                    readonly state: Schema.Json;
+                };
+            };
+            readonly waits: {
+                readonly [x: string]: {
+                    readonly waitId: string;
+                    readonly threadId: string;
+                    readonly on: {
+                        readonly type: string | readonly string[];
+                        readonly match?: Schema.Json | undefined;
+                    } | {
+                        readonly timerAt: number;
+                    };
+                    readonly tag?: Schema.Json | undefined;
+                };
+            };
+            readonly outstandingEffects: readonly {
+                readonly effectId: string;
+                readonly threadId: string;
+                readonly causingSeq: number;
+                readonly causingEventId: string;
+                readonly effect: {
+                    readonly type: "runtime.spawn";
+                    readonly childThreadId: string;
+                    readonly kind: string;
+                    readonly definitionName: string;
+                    readonly definitionVersion: string;
+                    readonly input: Schema.Json;
+                } | {
+                    readonly type: "runtime.wait";
+                    readonly waitId: string;
+                    readonly on: {
+                        readonly type: string | readonly string[];
+                        readonly match?: Schema.Json | undefined;
+                    } | {
+                        readonly timerAt: number;
+                    };
+                    readonly tag?: Schema.Json | undefined;
+                } | {
+                    readonly type: "runtime.emit";
+                    readonly event: {
+                        readonly type: string;
+                        readonly payload: Schema.Json;
+                        readonly threadId?: string | null | undefined;
+                        readonly parentThreadId?: string | null | undefined;
+                        readonly causationId?: string | null | undefined;
+                        readonly correlationId?: string | null | undefined;
+                        readonly effectId?: string | null | undefined;
+                        readonly origin?: {
+                            readonly type: "thread";
+                            readonly threadId: string;
+                        } | {
+                            readonly type: "external";
+                            readonly actorId?: string | undefined;
+                        } | {
+                            readonly type: "system";
+                        } | undefined;
+                        readonly ephemeral?: boolean | undefined;
+                        readonly id?: string | undefined;
+                        readonly ts?: number | undefined;
+                        readonly idempotencyKey?: string | null | undefined;
+                    };
+                    readonly tag?: string | undefined;
+                } | {
+                    readonly type: "runtime.complete";
+                    readonly output: Schema.Json;
+                } | {
+                    readonly type: "runtime.fail";
+                    readonly error: string;
+                } | {
+                    readonly type: "runtime.cancel";
+                    readonly threadId: string;
+                    readonly tag?: string | undefined;
+                } | {
+                    readonly type: string;
+                    readonly input: Schema.Json;
+                    readonly tag?: string | undefined;
+                };
+            }[];
+            readonly effectExecutions: {
+                readonly [x: string]: {
+                    readonly effectId: string;
+                    readonly attempt: number;
+                    readonly status: "ambiguous" | "cancel_requested" | "dispatched" | "heartbeat" | "queued" | "retry_wait" | "running" | "started" | "timed_out";
+                    readonly nextAttemptAt: number | null;
+                    readonly deadlineAt: number | null;
+                    readonly startedAt: number | null;
+                    readonly lastHeartbeatAt: number | null;
+                    readonly lastError: string | null;
+                };
+            };
+            readonly completedEffectIds: readonly string[];
+            readonly processedIdempotencyKeys: readonly string[];
+        };
+    }>;
+    workerCallback: (runId: string, input: WorkerCallbackInput) => Promise<{
+        readonly runId: string;
+        readonly state: {
+            readonly runId: string;
+            readonly status: "cancelled" | "completed" | "failed" | "running";
+            readonly rootThreadId: string | null;
+            readonly startIdentity: {
+                readonly kind: string;
+                readonly definitionName: string;
+                readonly definitionVersion: string;
+                readonly input: Schema.Json;
+                readonly requestedThreadId: string | null;
+                readonly idempotencyKey: string | null;
+                readonly rootThreadId: string;
+            } | null;
+            readonly threads: {
+                readonly [x: string]: {
+                    readonly threadId: string;
+                    readonly kind: string;
+                    readonly definitionName: string;
+                    readonly definitionVersion: string;
+                    readonly parentThreadId: string | null;
+                    readonly status: "cancelled" | "completed" | "failed" | "running" | "waiting";
+                    readonly input: Schema.Json;
+                    readonly output: Schema.Json;
+                    readonly error: string | null;
+                    readonly state: Schema.Json;
+                };
+            };
+            readonly waits: {
+                readonly [x: string]: {
+                    readonly waitId: string;
+                    readonly threadId: string;
+                    readonly on: {
+                        readonly type: string | readonly string[];
+                        readonly match?: Schema.Json | undefined;
+                    } | {
+                        readonly timerAt: number;
+                    };
+                    readonly tag?: Schema.Json | undefined;
+                };
+            };
+            readonly outstandingEffects: readonly {
+                readonly effectId: string;
+                readonly threadId: string;
+                readonly causingSeq: number;
+                readonly causingEventId: string;
+                readonly effect: {
+                    readonly type: "runtime.spawn";
+                    readonly childThreadId: string;
+                    readonly kind: string;
+                    readonly definitionName: string;
+                    readonly definitionVersion: string;
+                    readonly input: Schema.Json;
+                } | {
+                    readonly type: "runtime.wait";
+                    readonly waitId: string;
+                    readonly on: {
+                        readonly type: string | readonly string[];
+                        readonly match?: Schema.Json | undefined;
+                    } | {
+                        readonly timerAt: number;
+                    };
+                    readonly tag?: Schema.Json | undefined;
+                } | {
+                    readonly type: "runtime.emit";
+                    readonly event: {
+                        readonly type: string;
+                        readonly payload: Schema.Json;
+                        readonly threadId?: string | null | undefined;
+                        readonly parentThreadId?: string | null | undefined;
+                        readonly causationId?: string | null | undefined;
+                        readonly correlationId?: string | null | undefined;
+                        readonly effectId?: string | null | undefined;
+                        readonly origin?: {
+                            readonly type: "thread";
+                            readonly threadId: string;
+                        } | {
+                            readonly type: "external";
+                            readonly actorId?: string | undefined;
+                        } | {
+                            readonly type: "system";
+                        } | undefined;
+                        readonly ephemeral?: boolean | undefined;
+                        readonly id?: string | undefined;
+                        readonly ts?: number | undefined;
+                        readonly idempotencyKey?: string | null | undefined;
+                    };
+                    readonly tag?: string | undefined;
+                } | {
+                    readonly type: "runtime.complete";
+                    readonly output: Schema.Json;
+                } | {
+                    readonly type: "runtime.fail";
+                    readonly error: string;
+                } | {
+                    readonly type: "runtime.cancel";
+                    readonly threadId: string;
+                    readonly tag?: string | undefined;
+                } | {
+                    readonly type: string;
+                    readonly input: Schema.Json;
+                    readonly tag?: string | undefined;
+                };
+            }[];
+            readonly effectExecutions: {
+                readonly [x: string]: {
+                    readonly effectId: string;
+                    readonly attempt: number;
+                    readonly status: "ambiguous" | "cancel_requested" | "dispatched" | "heartbeat" | "queued" | "retry_wait" | "running" | "started" | "timed_out";
+                    readonly nextAttemptAt: number | null;
+                    readonly deadlineAt: number | null;
+                    readonly startedAt: number | null;
+                    readonly lastHeartbeatAt: number | null;
+                    readonly lastError: string | null;
+                };
+            };
+            readonly completedEffectIds: readonly string[];
+            readonly processedIdempotencyKeys: readonly string[];
+        };
+    }>;
+    listRunSummaries: () => Promise<{
+        readonly runs: readonly {
+            readonly runId: string;
+            readonly status: "cancelled" | "completed" | "failed" | "running";
+            readonly kind: string | null;
+            readonly definitionName: string | null;
+        }[];
+    }>;
+    listDefinitions: () => Promise<{
+        readonly definitions: readonly {
+            readonly kind: string;
+            readonly name: string;
+            readonly version: string;
+            readonly description?: string | undefined;
+            readonly inputSchema?: Schema.Json | undefined;
+        }[];
+        readonly projections: readonly string[];
     }>;
     replayTo: (runId: string, seq: number) => Promise<{
-        runId: string;
-        step: unknown;
+        readonly runId: string;
+        readonly step: {
+            readonly seq: number;
+            readonly event: {
+                readonly id: string;
+                readonly runId: string;
+                readonly seq: number;
+                readonly ts: number;
+                readonly type: string;
+                readonly payload: Schema.Json;
+                readonly threadId: string | null;
+                readonly parentThreadId?: string | null | undefined;
+                readonly causationId?: string | null | undefined;
+                readonly correlationId?: string | null | undefined;
+                readonly effectId?: string | null | undefined;
+                readonly origin: {
+                    readonly type: "thread";
+                    readonly threadId: string;
+                } | {
+                    readonly type: "external";
+                    readonly actorId?: string | undefined;
+                } | {
+                    readonly type: "system";
+                };
+                readonly ephemeral?: boolean | undefined;
+                readonly idempotencyKey?: string | null | undefined;
+            };
+            readonly before: {
+                readonly runId: string;
+                readonly status: "cancelled" | "completed" | "failed" | "running";
+                readonly rootThreadId: string | null;
+                readonly startIdentity: {
+                    readonly kind: string;
+                    readonly definitionName: string;
+                    readonly definitionVersion: string;
+                    readonly input: Schema.Json;
+                    readonly requestedThreadId: string | null;
+                    readonly idempotencyKey: string | null;
+                    readonly rootThreadId: string;
+                } | null;
+                readonly threads: {
+                    readonly [x: string]: {
+                        readonly threadId: string;
+                        readonly kind: string;
+                        readonly definitionName: string;
+                        readonly definitionVersion: string;
+                        readonly parentThreadId: string | null;
+                        readonly status: "cancelled" | "completed" | "failed" | "running" | "waiting";
+                        readonly input: Schema.Json;
+                        readonly output: Schema.Json;
+                        readonly error: string | null;
+                        readonly state: Schema.Json;
+                    };
+                };
+                readonly waits: {
+                    readonly [x: string]: {
+                        readonly waitId: string;
+                        readonly threadId: string;
+                        readonly on: {
+                            readonly type: string | readonly string[];
+                            readonly match?: Schema.Json | undefined;
+                        } | {
+                            readonly timerAt: number;
+                        };
+                        readonly tag?: Schema.Json | undefined;
+                    };
+                };
+                readonly outstandingEffects: readonly {
+                    readonly effectId: string;
+                    readonly threadId: string;
+                    readonly causingSeq: number;
+                    readonly causingEventId: string;
+                    readonly effect: {
+                        readonly type: "runtime.spawn";
+                        readonly childThreadId: string;
+                        readonly kind: string;
+                        readonly definitionName: string;
+                        readonly definitionVersion: string;
+                        readonly input: Schema.Json;
+                    } | {
+                        readonly type: "runtime.wait";
+                        readonly waitId: string;
+                        readonly on: {
+                            readonly type: string | readonly string[];
+                            readonly match?: Schema.Json | undefined;
+                        } | {
+                            readonly timerAt: number;
+                        };
+                        readonly tag?: Schema.Json | undefined;
+                    } | {
+                        readonly type: "runtime.emit";
+                        readonly event: {
+                            readonly type: string;
+                            readonly payload: Schema.Json;
+                            readonly threadId?: string | null | undefined;
+                            readonly parentThreadId?: string | null | undefined;
+                            readonly causationId?: string | null | undefined;
+                            readonly correlationId?: string | null | undefined;
+                            readonly effectId?: string | null | undefined;
+                            readonly origin?: {
+                                readonly type: "thread";
+                                readonly threadId: string;
+                            } | {
+                                readonly type: "external";
+                                readonly actorId?: string | undefined;
+                            } | {
+                                readonly type: "system";
+                            } | undefined;
+                            readonly ephemeral?: boolean | undefined;
+                            readonly id?: string | undefined;
+                            readonly ts?: number | undefined;
+                            readonly idempotencyKey?: string | null | undefined;
+                        };
+                        readonly tag?: string | undefined;
+                    } | {
+                        readonly type: "runtime.complete";
+                        readonly output: Schema.Json;
+                    } | {
+                        readonly type: "runtime.fail";
+                        readonly error: string;
+                    } | {
+                        readonly type: "runtime.cancel";
+                        readonly threadId: string;
+                        readonly tag?: string | undefined;
+                    } | {
+                        readonly type: string;
+                        readonly input: Schema.Json;
+                        readonly tag?: string | undefined;
+                    };
+                }[];
+                readonly effectExecutions: {
+                    readonly [x: string]: {
+                        readonly effectId: string;
+                        readonly attempt: number;
+                        readonly status: "ambiguous" | "cancel_requested" | "dispatched" | "heartbeat" | "queued" | "retry_wait" | "running" | "started" | "timed_out";
+                        readonly nextAttemptAt: number | null;
+                        readonly deadlineAt: number | null;
+                        readonly startedAt: number | null;
+                        readonly lastHeartbeatAt: number | null;
+                        readonly lastError: string | null;
+                    };
+                };
+                readonly completedEffectIds: readonly string[];
+                readonly processedIdempotencyKeys: readonly string[];
+            };
+            readonly after: {
+                readonly runId: string;
+                readonly status: "cancelled" | "completed" | "failed" | "running";
+                readonly rootThreadId: string | null;
+                readonly startIdentity: {
+                    readonly kind: string;
+                    readonly definitionName: string;
+                    readonly definitionVersion: string;
+                    readonly input: Schema.Json;
+                    readonly requestedThreadId: string | null;
+                    readonly idempotencyKey: string | null;
+                    readonly rootThreadId: string;
+                } | null;
+                readonly threads: {
+                    readonly [x: string]: {
+                        readonly threadId: string;
+                        readonly kind: string;
+                        readonly definitionName: string;
+                        readonly definitionVersion: string;
+                        readonly parentThreadId: string | null;
+                        readonly status: "cancelled" | "completed" | "failed" | "running" | "waiting";
+                        readonly input: Schema.Json;
+                        readonly output: Schema.Json;
+                        readonly error: string | null;
+                        readonly state: Schema.Json;
+                    };
+                };
+                readonly waits: {
+                    readonly [x: string]: {
+                        readonly waitId: string;
+                        readonly threadId: string;
+                        readonly on: {
+                            readonly type: string | readonly string[];
+                            readonly match?: Schema.Json | undefined;
+                        } | {
+                            readonly timerAt: number;
+                        };
+                        readonly tag?: Schema.Json | undefined;
+                    };
+                };
+                readonly outstandingEffects: readonly {
+                    readonly effectId: string;
+                    readonly threadId: string;
+                    readonly causingSeq: number;
+                    readonly causingEventId: string;
+                    readonly effect: {
+                        readonly type: "runtime.spawn";
+                        readonly childThreadId: string;
+                        readonly kind: string;
+                        readonly definitionName: string;
+                        readonly definitionVersion: string;
+                        readonly input: Schema.Json;
+                    } | {
+                        readonly type: "runtime.wait";
+                        readonly waitId: string;
+                        readonly on: {
+                            readonly type: string | readonly string[];
+                            readonly match?: Schema.Json | undefined;
+                        } | {
+                            readonly timerAt: number;
+                        };
+                        readonly tag?: Schema.Json | undefined;
+                    } | {
+                        readonly type: "runtime.emit";
+                        readonly event: {
+                            readonly type: string;
+                            readonly payload: Schema.Json;
+                            readonly threadId?: string | null | undefined;
+                            readonly parentThreadId?: string | null | undefined;
+                            readonly causationId?: string | null | undefined;
+                            readonly correlationId?: string | null | undefined;
+                            readonly effectId?: string | null | undefined;
+                            readonly origin?: {
+                                readonly type: "thread";
+                                readonly threadId: string;
+                            } | {
+                                readonly type: "external";
+                                readonly actorId?: string | undefined;
+                            } | {
+                                readonly type: "system";
+                            } | undefined;
+                            readonly ephemeral?: boolean | undefined;
+                            readonly id?: string | undefined;
+                            readonly ts?: number | undefined;
+                            readonly idempotencyKey?: string | null | undefined;
+                        };
+                        readonly tag?: string | undefined;
+                    } | {
+                        readonly type: "runtime.complete";
+                        readonly output: Schema.Json;
+                    } | {
+                        readonly type: "runtime.fail";
+                        readonly error: string;
+                    } | {
+                        readonly type: "runtime.cancel";
+                        readonly threadId: string;
+                        readonly tag?: string | undefined;
+                    } | {
+                        readonly type: string;
+                        readonly input: Schema.Json;
+                        readonly tag?: string | undefined;
+                    };
+                }[];
+                readonly effectExecutions: {
+                    readonly [x: string]: {
+                        readonly effectId: string;
+                        readonly attempt: number;
+                        readonly status: "ambiguous" | "cancel_requested" | "dispatched" | "heartbeat" | "queued" | "retry_wait" | "running" | "started" | "timed_out";
+                        readonly nextAttemptAt: number | null;
+                        readonly deadlineAt: number | null;
+                        readonly startedAt: number | null;
+                        readonly lastHeartbeatAt: number | null;
+                        readonly lastError: string | null;
+                    };
+                };
+                readonly completedEffectIds: readonly string[];
+                readonly processedIdempotencyKeys: readonly string[];
+            };
+            readonly effects: readonly ({
+                readonly type: "runtime.spawn";
+                readonly childThreadId: string;
+                readonly kind: string;
+                readonly definitionName: string;
+                readonly definitionVersion: string;
+                readonly input: Schema.Json;
+            } | {
+                readonly type: "runtime.wait";
+                readonly waitId: string;
+                readonly on: {
+                    readonly type: string | readonly string[];
+                    readonly match?: Schema.Json | undefined;
+                } | {
+                    readonly timerAt: number;
+                };
+                readonly tag?: Schema.Json | undefined;
+            } | {
+                readonly type: "runtime.emit";
+                readonly event: {
+                    readonly type: string;
+                    readonly payload: Schema.Json;
+                    readonly threadId?: string | null | undefined;
+                    readonly parentThreadId?: string | null | undefined;
+                    readonly causationId?: string | null | undefined;
+                    readonly correlationId?: string | null | undefined;
+                    readonly effectId?: string | null | undefined;
+                    readonly origin?: {
+                        readonly type: "thread";
+                        readonly threadId: string;
+                    } | {
+                        readonly type: "external";
+                        readonly actorId?: string | undefined;
+                    } | {
+                        readonly type: "system";
+                    } | undefined;
+                    readonly ephemeral?: boolean | undefined;
+                    readonly id?: string | undefined;
+                    readonly ts?: number | undefined;
+                    readonly idempotencyKey?: string | null | undefined;
+                };
+                readonly tag?: string | undefined;
+            } | {
+                readonly type: "runtime.complete";
+                readonly output: Schema.Json;
+            } | {
+                readonly type: "runtime.fail";
+                readonly error: string;
+            } | {
+                readonly type: "runtime.cancel";
+                readonly threadId: string;
+                readonly tag?: string | undefined;
+            } | {
+                readonly type: string;
+                readonly input: Schema.Json;
+                readonly tag?: string | undefined;
+            })[];
+        } | null;
     }>;
     project: (runId: string, name: string) => Promise<{
-        runId: string;
-        name: string;
-        value: unknown;
+        readonly runId: string;
+        readonly name: string;
+        readonly value: unknown;
     }>;
     subscribeEvents: (runId: string, onEvent: (event: EventEnvelope) => void, reconnectDelayMs?: number) => () => void;
     /**
@@ -61,6 +1255,7 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
     streamRun: (args: {
         kind: string;
         definitionName: string;
+        definitionVersion?: string;
         input?: JsonValue;
         runId?: string;
     }) => StreamHandle;