@swirls/looms 0.3.0 → 0.5.0

package/dist/client/client.d.ts

@@ -1,9 +1,14 @@
 import { Schema } from 'effect';
-import { type DefinitionInput, type DefinitionRef, type EventEnvelope, type EventInput, type JsonValue, type RunState, type WorkerCallbackInput } from '@swirls/looms/core';
+import { type DefinitionInput, type DefinitionRef, type EventEnvelope, type EventInput, type JsonValue, type RunAttributes, type RunState, type SecretContext, type SubscriptionTransport, type TraceContext, type WorkerCallback, type WorkerCallbackInput, type WorkerCallbackResult, type WorkerSecretsResult } from '@swirls/looms/core';
 export interface LoomsClientOptions {
     baseUrl?: string;
     fetch?: typeof fetch;
     workerCallbackToken?: string;
+    /**
+     * Appended as `grant` to the event-stream URL, for both SSE and WebSocket subscriptions. A read
+     * grant cannot authorize other requests, so it is not sent on them.
+     */
+    grant?: string;
 }
 export interface StartResult {
     runId: string;
@@ -21,6 +26,10 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
         definitionVersion?: string;
         input?: JsonValue;
         runId?: string;
+        attributes?: RunAttributes;
+        secrets?: SecretContext;
+        /** Sent as the W3C `traceparent` and `tracestate` headers. */
+        trace?: TraceContext;
     }) => Promise<{
         readonly runId: string;
         readonly threadId: string;
@@ -36,7 +45,25 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                 readonly requestedThreadId: string | null;
                 readonly idempotencyKey: string | null;
                 readonly rootThreadId: string;
+                readonly launchedBy: {
+                    readonly runId: string;
+                    readonly threadId: string;
+                    readonly effectId: string;
+                    readonly causationId: string;
+                    readonly causationSeq: number;
+                } | null;
+                readonly correlationId: string | null;
+                readonly attributes: {
+                    readonly [x: string]: string;
+                };
+                readonly trace: {
+                    readonly traceparent: string;
+                    readonly tracestate?: string | undefined;
+                } | null;
             } | null;
+            readonly attributes: {
+                readonly [x: string]: string;
+            };
             readonly forkedFrom: {
                 readonly runId: string;
                 readonly seq: number;
@@ -108,6 +135,9 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                             readonly actorId?: string | undefined;
                         } | {
                             readonly type: "system";
+                        } | {
+                            readonly type: "run";
+                            readonly runId: string;
                         } | undefined;
                         readonly ephemeral?: boolean | undefined;
                         readonly id?: string | undefined;
@@ -125,10 +155,24 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                     readonly type: "runtime.cancel";
                     readonly threadId: string;
                     readonly tag?: string | undefined;
+                } | {
+                    readonly type: "runtime.launch";
+                    readonly runId: string;
+                    readonly kind: string;
+                    readonly definitionName: string;
+                    readonly definitionVersion: string;
+                    readonly input: Schema.Json;
+                    readonly close: "terminate" | "wait";
+                    readonly tag?: string | undefined;
+                } | {
+                    readonly type: "runtime.cancelRun";
+                    readonly runId: string;
+                    readonly tag?: string | undefined;
                 } | {
                     readonly type: string;
                     readonly input: Schema.Json;
                     readonly tag?: string | undefined;
+                    readonly at?: number | undefined;
                 };
             }[];
             readonly effectExecutions: {
@@ -140,11 +184,18 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                     readonly deadlineAt: number | null;
                     readonly startedAt: number | null;
                     readonly lastHeartbeatAt: number | null;
+                    readonly heartbeatDetails: Schema.Json;
                     readonly lastError: string | null;
                 };
             };
             readonly completedEffectIds: readonly string[];
             readonly processedIdempotencyKeys: readonly string[];
+            readonly launchedRuns: readonly {
+                readonly runId: string;
+                readonly close: "terminate" | "wait";
+            }[];
+            readonly closeWaiting: boolean;
+            readonly childCloseSent: boolean;
         };
     }>;
     /** Start a run from a definition object (agent, workflow, or your own kind). */
@@ -163,7 +214,25 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                 readonly requestedThreadId: string | null;
                 readonly idempotencyKey: string | null;
                 readonly rootThreadId: string;
+                readonly launchedBy: {
+                    readonly runId: string;
+                    readonly threadId: string;
+                    readonly effectId: string;
+                    readonly causationId: string;
+                    readonly causationSeq: number;
+                } | null;
+                readonly correlationId: string | null;
+                readonly attributes: {
+                    readonly [x: string]: string;
+                };
+                readonly trace: {
+                    readonly traceparent: string;
+                    readonly tracestate?: string | undefined;
+                } | null;
             } | null;
+            readonly attributes: {
+                readonly [x: string]: string;
+            };
             readonly forkedFrom: {
                 readonly runId: string;
                 readonly seq: number;
@@ -235,6 +304,9 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                             readonly actorId?: string | undefined;
                         } | {
                             readonly type: "system";
+                        } | {
+                            readonly type: "run";
+                            readonly runId: string;
                         } | undefined;
                         readonly ephemeral?: boolean | undefined;
                         readonly id?: string | undefined;
@@ -252,10 +324,24 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                     readonly type: "runtime.cancel";
                     readonly threadId: string;
                     readonly tag?: string | undefined;
+                } | {
+                    readonly type: "runtime.launch";
+                    readonly runId: string;
+                    readonly kind: string;
+                    readonly definitionName: string;
+                    readonly definitionVersion: string;
+                    readonly input: Schema.Json;
+                    readonly close: "terminate" | "wait";
+                    readonly tag?: string | undefined;
+                } | {
+                    readonly type: "runtime.cancelRun";
+                    readonly runId: string;
+                    readonly tag?: string | undefined;
                 } | {
                     readonly type: string;
                     readonly input: Schema.Json;
                     readonly tag?: string | undefined;
+                    readonly at?: number | undefined;
                 };
             }[];
             readonly effectExecutions: {
@@ -267,11 +353,18 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                     readonly deadlineAt: number | null;
                     readonly startedAt: number | null;
                     readonly lastHeartbeatAt: number | null;
+                    readonly heartbeatDetails: Schema.Json;
                     readonly lastError: string | null;
                 };
             };
             readonly completedEffectIds: readonly string[];
             readonly processedIdempotencyKeys: readonly string[];
+            readonly launchedRuns: readonly {
+                readonly runId: string;
+                readonly close: "terminate" | "wait";
+            }[];
+            readonly closeWaiting: boolean;
+            readonly childCloseSent: boolean;
         };
     }>;
     getRun: (runId: string) => Promise<{
@@ -288,7 +381,25 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                 readonly requestedThreadId: string | null;
                 readonly idempotencyKey: string | null;
                 readonly rootThreadId: string;
+                readonly launchedBy: {
+                    readonly runId: string;
+                    readonly threadId: string;
+                    readonly effectId: string;
+                    readonly causationId: string;
+                    readonly causationSeq: number;
+                } | null;
+                readonly correlationId: string | null;
+                readonly attributes: {
+                    readonly [x: string]: string;
+                };
+                readonly trace: {
+                    readonly traceparent: string;
+                    readonly tracestate?: string | undefined;
+                } | null;
             } | null;
+            readonly attributes: {
+                readonly [x: string]: string;
+            };
             readonly forkedFrom: {
                 readonly runId: string;
                 readonly seq: number;
@@ -360,6 +471,9 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                             readonly actorId?: string | undefined;
                         } | {
                             readonly type: "system";
+                        } | {
+                            readonly type: "run";
+                            readonly runId: string;
                         } | undefined;
                         readonly ephemeral?: boolean | undefined;
                         readonly id?: string | undefined;
@@ -377,10 +491,24 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                     readonly type: "runtime.cancel";
                     readonly threadId: string;
                     readonly tag?: string | undefined;
+                } | {
+                    readonly type: "runtime.launch";
+                    readonly runId: string;
+                    readonly kind: string;
+                    readonly definitionName: string;
+                    readonly definitionVersion: string;
+                    readonly input: Schema.Json;
+                    readonly close: "terminate" | "wait";
+                    readonly tag?: string | undefined;
+                } | {
+                    readonly type: "runtime.cancelRun";
+                    readonly runId: string;
+                    readonly tag?: string | undefined;
                 } | {
                     readonly type: string;
                     readonly input: Schema.Json;
                     readonly tag?: string | undefined;
+                    readonly at?: number | undefined;
                 };
             }[];
             readonly effectExecutions: {
@@ -392,11 +520,18 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                     readonly deadlineAt: number | null;
                     readonly startedAt: number | null;
                     readonly lastHeartbeatAt: number | null;
+                    readonly heartbeatDetails: Schema.Json;
                     readonly lastError: string | null;
                 };
             };
             readonly completedEffectIds: readonly string[];
             readonly processedIdempotencyKeys: readonly string[];
+            readonly launchedRuns: readonly {
+                readonly runId: string;
+                readonly close: "terminate" | "wait";
+            }[];
+            readonly closeWaiting: boolean;
+            readonly childCloseSent: boolean;
         };
     }>;
     getState: (runId: string) => Promise<{
@@ -413,7 +548,25 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                 readonly requestedThreadId: string | null;
                 readonly idempotencyKey: string | null;
                 readonly rootThreadId: string;
+                readonly launchedBy: {
+                    readonly runId: string;
+                    readonly threadId: string;
+                    readonly effectId: string;
+                    readonly causationId: string;
+                    readonly causationSeq: number;
+                } | null;
+                readonly correlationId: string | null;
+                readonly attributes: {
+                    readonly [x: string]: string;
+                };
+                readonly trace: {
+                    readonly traceparent: string;
+                    readonly tracestate?: string | undefined;
+                } | null;
             } | null;
+            readonly attributes: {
+                readonly [x: string]: string;
+            };
             readonly forkedFrom: {
                 readonly runId: string;
                 readonly seq: number;
@@ -485,6 +638,9 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                             readonly actorId?: string | undefined;
                         } | {
                             readonly type: "system";
+                        } | {
+                            readonly type: "run";
+                            readonly runId: string;
                         } | undefined;
                         readonly ephemeral?: boolean | undefined;
                         readonly id?: string | undefined;
@@ -502,10 +658,24 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                     readonly type: "runtime.cancel";
                     readonly threadId: string;
                     readonly tag?: string | undefined;
+                } | {
+                    readonly type: "runtime.launch";
+                    readonly runId: string;
+                    readonly kind: string;
+                    readonly definitionName: string;
+                    readonly definitionVersion: string;
+                    readonly input: Schema.Json;
+                    readonly close: "terminate" | "wait";
+                    readonly tag?: string | undefined;
+                } | {
+                    readonly type: "runtime.cancelRun";
+                    readonly runId: string;
+                    readonly tag?: string | undefined;
                 } | {
                     readonly type: string;
                     readonly input: Schema.Json;
                     readonly tag?: string | undefined;
+                    readonly at?: number | undefined;
                 };
             }[];
             readonly effectExecutions: {
@@ -517,11 +687,18 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                     readonly deadlineAt: number | null;
                     readonly startedAt: number | null;
                     readonly lastHeartbeatAt: number | null;
+                    readonly heartbeatDetails: Schema.Json;
                     readonly lastError: string | null;
                 };
             };
             readonly completedEffectIds: readonly string[];
             readonly processedIdempotencyKeys: readonly string[];
+            readonly launchedRuns: readonly {
+                readonly runId: string;
+                readonly close: "terminate" | "wait";
+            }[];
+            readonly closeWaiting: boolean;
+            readonly childCloseSent: boolean;
         };
     }>;
     getEvents: (runId: string, opts?: {
@@ -549,6 +726,9 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                 readonly actorId?: string | undefined;
             } | {
                 readonly type: "system";
+            } | {
+                readonly type: "run";
+                readonly runId: string;
             };
             readonly ephemeral?: boolean | undefined;
             readonly idempotencyKey?: string | null | undefined;
@@ -568,7 +748,25 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                 readonly requestedThreadId: string | null;
                 readonly idempotencyKey: string | null;
                 readonly rootThreadId: string;
+                readonly launchedBy: {
+                    readonly runId: string;
+                    readonly threadId: string;
+                    readonly effectId: string;
+                    readonly causationId: string;
+                    readonly causationSeq: number;
+                } | null;
+                readonly correlationId: string | null;
+                readonly attributes: {
+                    readonly [x: string]: string;
+                };
+                readonly trace: {
+                    readonly traceparent: string;
+                    readonly tracestate?: string | undefined;
+                } | null;
             } | null;
+            readonly attributes: {
+                readonly [x: string]: string;
+            };
             readonly forkedFrom: {
                 readonly runId: string;
                 readonly seq: number;
@@ -640,6 +838,9 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                             readonly actorId?: string | undefined;
                         } | {
                             readonly type: "system";
+                        } | {
+                            readonly type: "run";
+                            readonly runId: string;
                         } | undefined;
                         readonly ephemeral?: boolean | undefined;
                         readonly id?: string | undefined;
@@ -657,10 +858,24 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                     readonly type: "runtime.cancel";
                     readonly threadId: string;
                     readonly tag?: string | undefined;
+                } | {
+                    readonly type: "runtime.launch";
+                    readonly runId: string;
+                    readonly kind: string;
+                    readonly definitionName: string;
+                    readonly definitionVersion: string;
+                    readonly input: Schema.Json;
+                    readonly close: "terminate" | "wait";
+                    readonly tag?: string | undefined;
+                } | {
+                    readonly type: "runtime.cancelRun";
+                    readonly runId: string;
+                    readonly tag?: string | undefined;
                 } | {
                     readonly type: string;
                     readonly input: Schema.Json;
                     readonly tag?: string | undefined;
+                    readonly at?: number | undefined;
                 };
             }[];
             readonly effectExecutions: {
@@ -672,11 +887,18 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                     readonly deadlineAt: number | null;
                     readonly startedAt: number | null;
                     readonly lastHeartbeatAt: number | null;
+                    readonly heartbeatDetails: Schema.Json;
                     readonly lastError: string | null;
                 };
             };
             readonly completedEffectIds: readonly string[];
             readonly processedIdempotencyKeys: readonly string[];
+            readonly launchedRuns: readonly {
+                readonly runId: string;
+                readonly close: "terminate" | "wait";
+            }[];
+            readonly closeWaiting: boolean;
+            readonly childCloseSent: boolean;
         };
     }>;
     wake: (runId: string) => Promise<{
@@ -693,7 +915,25 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                 readonly requestedThreadId: string | null;
                 readonly idempotencyKey: string | null;
                 readonly rootThreadId: string;
+                readonly launchedBy: {
+                    readonly runId: string;
+                    readonly threadId: string;
+                    readonly effectId: string;
+                    readonly causationId: string;
+                    readonly causationSeq: number;
+                } | null;
+                readonly correlationId: string | null;
+                readonly attributes: {
+                    readonly [x: string]: string;
+                };
+                readonly trace: {
+                    readonly traceparent: string;
+                    readonly tracestate?: string | undefined;
+                } | null;
             } | null;
+            readonly attributes: {
+                readonly [x: string]: string;
+            };
             readonly forkedFrom: {
                 readonly runId: string;
                 readonly seq: number;
@@ -765,6 +1005,9 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                             readonly actorId?: string | undefined;
                         } | {
                             readonly type: "system";
+                        } | {
+                            readonly type: "run";
+                            readonly runId: string;
                         } | undefined;
                         readonly ephemeral?: boolean | undefined;
                         readonly id?: string | undefined;
@@ -782,10 +1025,24 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                     readonly type: "runtime.cancel";
                     readonly threadId: string;
                     readonly tag?: string | undefined;
+                } | {
+                    readonly type: "runtime.launch";
+                    readonly runId: string;
+                    readonly kind: string;
+                    readonly definitionName: string;
+                    readonly definitionVersion: string;
+                    readonly input: Schema.Json;
+                    readonly close: "terminate" | "wait";
+                    readonly tag?: string | undefined;
+                } | {
+                    readonly type: "runtime.cancelRun";
+                    readonly runId: string;
+                    readonly tag?: string | undefined;
                 } | {
                     readonly type: string;
                     readonly input: Schema.Json;
                     readonly tag?: string | undefined;
+                    readonly at?: number | undefined;
                 };
             }[];
             readonly effectExecutions: {
@@ -797,11 +1054,18 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                     readonly deadlineAt: number | null;
                     readonly startedAt: number | null;
                     readonly lastHeartbeatAt: number | null;
+                    readonly heartbeatDetails: Schema.Json;
                     readonly lastError: string | null;
                 };
             };
             readonly completedEffectIds: readonly string[];
             readonly processedIdempotencyKeys: readonly string[];
+            readonly launchedRuns: readonly {
+                readonly runId: string;
+                readonly close: "terminate" | "wait";
+            }[];
+            readonly closeWaiting: boolean;
+            readonly childCloseSent: boolean;
         };
         readonly appended: number;
     }>;
@@ -820,7 +1084,25 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                 readonly requestedThreadId: string | null;
                 readonly idempotencyKey: string | null;
                 readonly rootThreadId: string;
+                readonly launchedBy: {
+                    readonly runId: string;
+                    readonly threadId: string;
+                    readonly effectId: string;
+                    readonly causationId: string;
+                    readonly causationSeq: number;
+                } | null;
+                readonly correlationId: string | null;
+                readonly attributes: {
+                    readonly [x: string]: string;
+                };
+                readonly trace: {
+                    readonly traceparent: string;
+                    readonly tracestate?: string | undefined;
+                } | null;
             } | null;
+            readonly attributes: {
+                readonly [x: string]: string;
+            };
             readonly forkedFrom: {
                 readonly runId: string;
                 readonly seq: number;
@@ -892,6 +1174,9 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                             readonly actorId?: string | undefined;
                         } | {
                             readonly type: "system";
+                        } | {
+                            readonly type: "run";
+                            readonly runId: string;
                         } | undefined;
                         readonly ephemeral?: boolean | undefined;
                         readonly id?: string | undefined;
@@ -909,10 +1194,24 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                     readonly type: "runtime.cancel";
                     readonly threadId: string;
                     readonly tag?: string | undefined;
+                } | {
+                    readonly type: "runtime.launch";
+                    readonly runId: string;
+                    readonly kind: string;
+                    readonly definitionName: string;
+                    readonly definitionVersion: string;
+                    readonly input: Schema.Json;
+                    readonly close: "terminate" | "wait";
+                    readonly tag?: string | undefined;
+                } | {
+                    readonly type: "runtime.cancelRun";
+                    readonly runId: string;
+                    readonly tag?: string | undefined;
                 } | {
                     readonly type: string;
                     readonly input: Schema.Json;
                     readonly tag?: string | undefined;
+                    readonly at?: number | undefined;
                 };
             }[];
             readonly effectExecutions: {
@@ -924,11 +1223,18 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                     readonly deadlineAt: number | null;
                     readonly startedAt: number | null;
                     readonly lastHeartbeatAt: number | null;
+                    readonly heartbeatDetails: Schema.Json;
                     readonly lastError: string | null;
                 };
             };
             readonly completedEffectIds: readonly string[];
             readonly processedIdempotencyKeys: readonly string[];
+            readonly launchedRuns: readonly {
+                readonly runId: string;
+                readonly close: "terminate" | "wait";
+            }[];
+            readonly closeWaiting: boolean;
+            readonly childCloseSent: boolean;
         };
     }>;
     /** Start a new run that continues where a finished run ended. */
@@ -949,7 +1255,25 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                 readonly requestedThreadId: string | null;
                 readonly idempotencyKey: string | null;
                 readonly rootThreadId: string;
+                readonly launchedBy: {
+                    readonly runId: string;
+                    readonly threadId: string;
+                    readonly effectId: string;
+                    readonly causationId: string;
+                    readonly causationSeq: number;
+                } | null;
+                readonly correlationId: string | null;
+                readonly attributes: {
+                    readonly [x: string]: string;
+                };
+                readonly trace: {
+                    readonly traceparent: string;
+                    readonly tracestate?: string | undefined;
+                } | null;
             } | null;
+            readonly attributes: {
+                readonly [x: string]: string;
+            };
             readonly forkedFrom: {
                 readonly runId: string;
                 readonly seq: number;
@@ -1021,6 +1345,9 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                             readonly actorId?: string | undefined;
                         } | {
                             readonly type: "system";
+                        } | {
+                            readonly type: "run";
+                            readonly runId: string;
                         } | undefined;
                         readonly ephemeral?: boolean | undefined;
                         readonly id?: string | undefined;
@@ -1039,134 +1366,23 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                     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 forkedFrom: {
-                readonly runId: string;
-                readonly seq: number;
-            } | 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 type: "runtime.launch";
+                    readonly runId: 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 close: "terminate" | "wait";
                     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 type: "runtime.cancelRun";
+                    readonly runId: string;
                     readonly tag?: string | undefined;
                 } | {
                     readonly type: string;
                     readonly input: Schema.Json;
                     readonly tag?: string | undefined;
+                    readonly at?: number | undefined;
                 };
             }[];
             readonly effectExecutions: {
@@ -1178,19 +1394,31 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                     readonly deadlineAt: number | null;
                     readonly startedAt: number | null;
                     readonly lastHeartbeatAt: number | null;
+                    readonly heartbeatDetails: Schema.Json;
                     readonly lastError: string | null;
                 };
             };
             readonly completedEffectIds: readonly string[];
             readonly processedIdempotencyKeys: readonly string[];
+            readonly launchedRuns: readonly {
+                readonly runId: string;
+                readonly close: "terminate" | "wait";
+            }[];
+            readonly closeWaiting: boolean;
+            readonly childCloseSent: boolean;
         };
     }>;
+    workerCallback: (runId: string, input: WorkerCallbackInput) => Promise<WorkerCallbackResult>;
+    workerSecrets: (runId: string, attempt: WorkerCallback) => Promise<WorkerSecretsResult>;
     listRunSummaries: () => Promise<{
         readonly runs: readonly {
             readonly runId: string;
             readonly status: "cancelled" | "completed" | "failed" | "running";
             readonly kind: string | null;
             readonly definitionName: string | null;
+            readonly attributes: {
+                readonly [x: string]: string;
+            };
         }[];
     }>;
     listDefinitions: () => Promise<{
@@ -1227,6 +1455,9 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                     readonly actorId?: string | undefined;
                 } | {
                     readonly type: "system";
+                } | {
+                    readonly type: "run";
+                    readonly runId: string;
                 };
                 readonly ephemeral?: boolean | undefined;
                 readonly idempotencyKey?: string | null | undefined;
@@ -1243,7 +1474,25 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                     readonly requestedThreadId: string | null;
                     readonly idempotencyKey: string | null;
                     readonly rootThreadId: string;
+                    readonly launchedBy: {
+                        readonly runId: string;
+                        readonly threadId: string;
+                        readonly effectId: string;
+                        readonly causationId: string;
+                        readonly causationSeq: number;
+                    } | null;
+                    readonly correlationId: string | null;
+                    readonly attributes: {
+                        readonly [x: string]: string;
+                    };
+                    readonly trace: {
+                        readonly traceparent: string;
+                        readonly tracestate?: string | undefined;
+                    } | null;
                 } | null;
+                readonly attributes: {
+                    readonly [x: string]: string;
+                };
                 readonly forkedFrom: {
                     readonly runId: string;
                     readonly seq: number;
@@ -1315,6 +1564,9 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                                 readonly actorId?: string | undefined;
                             } | {
                                 readonly type: "system";
+                            } | {
+                                readonly type: "run";
+                                readonly runId: string;
                             } | undefined;
                             readonly ephemeral?: boolean | undefined;
                             readonly id?: string | undefined;
@@ -1332,10 +1584,24 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                         readonly type: "runtime.cancel";
                         readonly threadId: string;
                         readonly tag?: string | undefined;
+                    } | {
+                        readonly type: "runtime.launch";
+                        readonly runId: string;
+                        readonly kind: string;
+                        readonly definitionName: string;
+                        readonly definitionVersion: string;
+                        readonly input: Schema.Json;
+                        readonly close: "terminate" | "wait";
+                        readonly tag?: string | undefined;
+                    } | {
+                        readonly type: "runtime.cancelRun";
+                        readonly runId: string;
+                        readonly tag?: string | undefined;
                     } | {
                         readonly type: string;
                         readonly input: Schema.Json;
                         readonly tag?: string | undefined;
+                        readonly at?: number | undefined;
                     };
                 }[];
                 readonly effectExecutions: {
@@ -1347,11 +1613,18 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                         readonly deadlineAt: number | null;
                         readonly startedAt: number | null;
                         readonly lastHeartbeatAt: number | null;
+                        readonly heartbeatDetails: Schema.Json;
                         readonly lastError: string | null;
                     };
                 };
                 readonly completedEffectIds: readonly string[];
                 readonly processedIdempotencyKeys: readonly string[];
+                readonly launchedRuns: readonly {
+                    readonly runId: string;
+                    readonly close: "terminate" | "wait";
+                }[];
+                readonly closeWaiting: boolean;
+                readonly childCloseSent: boolean;
             };
             readonly after: {
                 readonly runId: string;
@@ -1365,7 +1638,25 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                     readonly requestedThreadId: string | null;
                     readonly idempotencyKey: string | null;
                     readonly rootThreadId: string;
+                    readonly launchedBy: {
+                        readonly runId: string;
+                        readonly threadId: string;
+                        readonly effectId: string;
+                        readonly causationId: string;
+                        readonly causationSeq: number;
+                    } | null;
+                    readonly correlationId: string | null;
+                    readonly attributes: {
+                        readonly [x: string]: string;
+                    };
+                    readonly trace: {
+                        readonly traceparent: string;
+                        readonly tracestate?: string | undefined;
+                    } | null;
                 } | null;
+                readonly attributes: {
+                    readonly [x: string]: string;
+                };
                 readonly forkedFrom: {
                     readonly runId: string;
                     readonly seq: number;
@@ -1437,6 +1728,9 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                                 readonly actorId?: string | undefined;
                             } | {
                                 readonly type: "system";
+                            } | {
+                                readonly type: "run";
+                                readonly runId: string;
                             } | undefined;
                             readonly ephemeral?: boolean | undefined;
                             readonly id?: string | undefined;
@@ -1454,10 +1748,24 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                         readonly type: "runtime.cancel";
                         readonly threadId: string;
                         readonly tag?: string | undefined;
+                    } | {
+                        readonly type: "runtime.launch";
+                        readonly runId: string;
+                        readonly kind: string;
+                        readonly definitionName: string;
+                        readonly definitionVersion: string;
+                        readonly input: Schema.Json;
+                        readonly close: "terminate" | "wait";
+                        readonly tag?: string | undefined;
+                    } | {
+                        readonly type: "runtime.cancelRun";
+                        readonly runId: string;
+                        readonly tag?: string | undefined;
                     } | {
                         readonly type: string;
                         readonly input: Schema.Json;
                         readonly tag?: string | undefined;
+                        readonly at?: number | undefined;
                     };
                 }[];
                 readonly effectExecutions: {
@@ -1469,11 +1777,18 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                         readonly deadlineAt: number | null;
                         readonly startedAt: number | null;
                         readonly lastHeartbeatAt: number | null;
+                        readonly heartbeatDetails: Schema.Json;
                         readonly lastError: string | null;
                     };
                 };
                 readonly completedEffectIds: readonly string[];
                 readonly processedIdempotencyKeys: readonly string[];
+                readonly launchedRuns: readonly {
+                    readonly runId: string;
+                    readonly close: "terminate" | "wait";
+                }[];
+                readonly closeWaiting: boolean;
+                readonly childCloseSent: boolean;
             };
             readonly effects: readonly ({
                 readonly type: "runtime.spawn";
@@ -1510,6 +1825,9 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                         readonly actorId?: string | undefined;
                     } | {
                         readonly type: "system";
+                    } | {
+                        readonly type: "run";
+                        readonly runId: string;
                     } | undefined;
                     readonly ephemeral?: boolean | undefined;
                     readonly id?: string | undefined;
@@ -1527,10 +1845,24 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
                 readonly type: "runtime.cancel";
                 readonly threadId: string;
                 readonly tag?: string | undefined;
+            } | {
+                readonly type: "runtime.launch";
+                readonly runId: string;
+                readonly kind: string;
+                readonly definitionName: string;
+                readonly definitionVersion: string;
+                readonly input: Schema.Json;
+                readonly close: "terminate" | "wait";
+                readonly tag?: string | undefined;
+            } | {
+                readonly type: "runtime.cancelRun";
+                readonly runId: string;
+                readonly tag?: string | undefined;
             } | {
                 readonly type: string;
                 readonly input: Schema.Json;
                 readonly tag?: string | undefined;
+                readonly at?: number | undefined;
             })[];
         } | null;
     }>;
@@ -1539,7 +1871,7 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
         readonly name: string;
         readonly value: unknown;
     }>;
-    subscribeEvents: (runId: string, onEvent: (event: EventEnvelope) => void, reconnectDelayMs?: number) => () => void;
+    subscribeEvents: (runId: string, onEvent: (event: EventEnvelope) => void, third?: number | SubscribeEventsOptions) => () => void;
     /**
      * Subscribe to the run log, then start execution so deltas arrive live.
      * Yields events in store order, including live module events such as `agent.turn.text_delta`.
@@ -1550,7 +1882,24 @@ export declare function createLoomsClient(options?: LoomsClientOptions): {
         definitionVersion?: string;
         input?: JsonValue;
         runId?: string;
+        trace?: TraceContext;
     }) => StreamHandle;
     stream: <TDef extends DefinitionRef>(definition: TDef, input?: DefinitionInput<TDef>) => StreamHandle;
 };
 export type LoomsClient = ReturnType<typeof createLoomsClient>;
+export interface SubscribeEventsOptions {
+    readonly transport?: SubscriptionTransport;
+    readonly reconnectDelayMs?: number;
+    readonly threadId?: string;
+    readonly includeEphemeral?: boolean;
+    readonly webSocket?: SubscriptionSocketConstructor;
+}
+export interface SubscriptionSocket {
+    addEventListener(type: string, listener: (event: {
+        readonly data?: unknown;
+    }) => void): void;
+    close(code?: number, reason?: string): void;
+}
+export interface SubscriptionSocketConstructor {
+    new (url: string): SubscriptionSocket;
+}