@swirls/looms 0.1.0 → 0.3.0

package/dist/core/state.js

@@ -1,7 +1,8 @@
-import { Effect, Schema } from 'effect';
+import { Effect, Predicate, Schema } from 'effect';
 import { RuntimeEffectSchema, WaitConditionSchema, } from './effects.js';
 import { JsonValueSchema } from './envelope.js';
 import { DEFAULT_DEFINITION_VERSION } from './module.js';
+import { isTerminalStatus } from './thread.js';
 export const RunStateSchema = Schema.Struct({
     runId: Schema.String,
     status: Schema.Union([
@@ -20,6 +21,7 @@ export const RunStateSchema = Schema.Struct({
         idempotencyKey: Schema.NullOr(Schema.String),
         rootThreadId: Schema.String,
     })).pipe(Schema.withDecodingDefaultKey(Effect.succeed(null))),
+    forkedFrom: Schema.NullOr(Schema.Struct({ runId: Schema.String, seq: Schema.Finite })).pipe(Schema.withDecodingDefaultKey(Effect.succeed(null))),
     threads: Schema.Record(Schema.String, Schema.Struct({
         threadId: Schema.String,
         kind: Schema.String,
@@ -80,6 +82,7 @@ export function emptyRunState(runId) {
         status: 'running',
         rootThreadId: null,
         startIdentity: null,
+        forkedFrom: null,
         threads: {},
         waits: {},
         outstandingEffects: [],
@@ -89,7 +92,27 @@ export function emptyRunState(runId) {
     };
 }
 export function isRunTerminal(state) {
-    return state.status === 'completed' || state.status === 'failed' || state.status === 'cancelled';
+    return isTerminalStatus(state.status);
+}
+/** Every thread below `threadId`, in the order they were started. */
+export function descendantThreadIds(state, threadId) {
+    return Object.values(state.threads)
+        .filter((record) => {
+        let parentThreadId = record.parentThreadId;
+        while (parentThreadId) {
+            if (parentThreadId === threadId) {
+                return true;
+            }
+            parentThreadId = state.threads[parentThreadId]?.parentThreadId ?? null;
+        }
+        return false;
+    })
+        .map((record) => record.threadId);
+}
+/** The status a `runtime.run.completed` payload ends the run with: an error means it failed. */
+export function completedRunStatus(payload) {
+    const error = Predicate.isObject(payload) ? payload.error : undefined;
+    return Predicate.isString(error) && error.length > 0 ? 'failed' : 'completed';
 }
 export function isRunParked(state) {
     if (isRunTerminal(state)) {

package/dist/core/store.d.ts

@@ -91,6 +91,7 @@ export interface StreamBounds {
     readonly tail: number;
 }
 export interface AppendOptions {
+    /** Fail unless the stream is at this tail. The batch is numbered from `expectedTail + 1`. */
     readonly expectedTail?: number;
     /**
      * Atomically claims an ingress command with the append. Reusing the key