@kitman-sh/loops 0.7.4 → 0.7.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kitman-sh/loops",
-  "version": "0.7.4",
+  "version": "0.7.5",
   "type": "module",
   "license": "UNLICENSED",
   "exports": {
@@ -15,7 +15,7 @@
     "types"
   ],
   "dependencies": {
-    "@kitman-sh/sdk": "0.7.4",
+    "@kitman-sh/sdk": "0.7.5",
     "effect": "^4.0.4"
   }
 }

package/types/packages/core/src/loop.d.ts

@@ -1497,6 +1497,24 @@ export declare const StepSessionUpdate: Schema.Struct<{
     readonly content: Schema.String;
 }>;
 export type StepSessionUpdate = (typeof StepSessionUpdate)['Type'];
+/** A SessionUpdate an agent Step recorded on one of its StepAttempts. */
+export declare const StepAttemptSessionUpdate: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly kind: Schema.String;
+    readonly content: Schema.String;
+    readonly createdAt: Schema.String;
+}>;
+export type StepAttemptSessionUpdate = (typeof StepAttemptSessionUpdate)['Type'];
+export declare const StepAttemptSessionUpdateList: Schema.Struct<{
+    readonly items: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly kind: Schema.String;
+        readonly content: Schema.String;
+        readonly createdAt: Schema.String;
+    }>>;
+    readonly next: Schema.optionalKey<Schema.String>;
+}>;
+export type StepAttemptSessionUpdateList = (typeof StepAttemptSessionUpdateList)['Type'];
 export declare const StepOutputSubmissionResult: Schema.Union<readonly [Schema.Struct<{
     readonly status: Schema.Literal<"accepted">;
 }>, Schema.Struct<{
@@ -2088,6 +2106,9 @@ export declare const RunStepSummary: Schema.Struct<{
         readonly attempt: Schema.Int;
         readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "canceled"]>;
         readonly failureSummary: Schema.optionalKey<Schema.String>;
+        /** What the attempt's agent submitted: its claims. */
+        readonly output: Schema.optionalKey<Schema.Unknown>;
+        readonly revision: Schema.optionalKey<Schema.String>;
     }>>;
 }>;
 export declare const RunSteerDeliveries: readonly ['queued', 'delivered', 'failed'];
@@ -2103,6 +2124,8 @@ export declare const RunSteer: Schema.Struct<{
 export type RunSteer = (typeof RunSteer)['Type'];
 export declare const RunSteerInput: Schema.Struct<{
     readonly text: Schema.String;
+    /** The Run's StepAttempt to steer; without one, the newest live agent Session. */
+    readonly stepAttemptId: Schema.optionalKey<Schema.String>;
     readonly idempotencyKey: Schema.String;
 }>;
 export type RunSteerInput = (typeof RunSteerInput)['Type'];
@@ -2119,6 +2142,128 @@ export declare const RunSteerSent: Schema.Struct<{
     readonly target: Schema.Literals<readonly ["session", "next_step"]>;
 }>;
 export type RunSteerSent = (typeof RunSteerSent)['Type'];
+export declare const RunDisplayStates: readonly ['queued', 'running', 'needs_you', 'blocked', 'failed', 'stopped', 'succeeded', 'partial'];
+export type RunDisplayState = (typeof RunDisplayStates)[number];
+/** How every surface shows a Run (ADR-0072). */
+export declare const RunDisplay: Schema.Struct<{
+    readonly state: Schema.Literals<readonly ["queued", "running", "needs_you", "blocked", "failed", "stopped", "succeeded", "partial"]>;
+    /** A Step needed more than one attempt. */
+    readonly retried: Schema.Boolean;
+    /** What now: the open Question, the failure, what went missing, or the Steps it is in. */
+    readonly summary: Schema.optionalKey<Schema.String>;
+}>;
+export type RunDisplay = (typeof RunDisplay)['Type'];
+export declare const RunGraphNodeKinds: readonly ['agent', 'check', 'question', 'child', 'wait', 'activity'];
+/** A Step the Run reached, of any kind (ADR-0072). */
+export declare const RunGraphNode: Schema.Struct<{
+    /** The Step's name in the journal, such as `agent_work/fix:1`. */
+    readonly id: Schema.String;
+    readonly name: Schema.String;
+    readonly kind: Schema.Literals<readonly ["agent", "check", "question", "child", "wait", "activity"]>;
+    readonly status: Schema.Literals<readonly ["queued", "running", "needs_you", "blocked", "failed", "stopped", "succeeded", "partial"]>;
+    readonly startedAt: Schema.String;
+    readonly endedAt: Schema.optionalKey<Schema.String>;
+    readonly attempts: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly status: Schema.Literals<readonly ["queued", "running", "needs_you", "blocked", "failed", "stopped", "succeeded", "partial"]>;
+        readonly failureSummary: Schema.optionalKey<Schema.String>;
+    }>>;
+    readonly agent: Schema.optionalKey<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly harness: Schema.optionalKey<Schema.String>;
+        readonly model: Schema.optionalKey<Schema.String>;
+        readonly runner: Schema.optionalKey<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly name: Schema.String;
+        }>>;
+    }>>;
+    readonly child: Schema.optionalKey<Schema.Struct<{
+        readonly runId: Schema.String;
+        readonly loopTitle: Schema.String;
+        readonly display: Schema.Struct<{
+            readonly state: Schema.Literals<readonly ["queued", "running", "needs_you", "blocked", "failed", "stopped", "succeeded", "partial"]>;
+            /** A Step needed more than one attempt. */
+            readonly retried: Schema.Boolean;
+            /** What now: the open Question, the failure, what went missing, or the Steps it is in. */
+            readonly summary: Schema.optionalKey<Schema.String>;
+        }>;
+        readonly task: Schema.optionalKey<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly key: Schema.String;
+            readonly title: Schema.String;
+        }>>;
+    }>>;
+}>;
+export type RunGraphNode = (typeof RunGraphNode)['Type'];
+export declare const RunGraph: Schema.Struct<{
+    /** The Steps the Run reached together, left to right. */
+    readonly columns: Schema.$Array<Schema.$Array<Schema.Struct<{
+        /** The Step's name in the journal, such as `agent_work/fix:1`. */
+        readonly id: Schema.String;
+        readonly name: Schema.String;
+        readonly kind: Schema.Literals<readonly ["agent", "check", "question", "child", "wait", "activity"]>;
+        readonly status: Schema.Literals<readonly ["queued", "running", "needs_you", "blocked", "failed", "stopped", "succeeded", "partial"]>;
+        readonly startedAt: Schema.String;
+        readonly endedAt: Schema.optionalKey<Schema.String>;
+        readonly attempts: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly attempt: Schema.Int;
+            readonly status: Schema.Literals<readonly ["queued", "running", "needs_you", "blocked", "failed", "stopped", "succeeded", "partial"]>;
+            readonly failureSummary: Schema.optionalKey<Schema.String>;
+        }>>;
+        readonly agent: Schema.optionalKey<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly harness: Schema.optionalKey<Schema.String>;
+            readonly model: Schema.optionalKey<Schema.String>;
+            readonly runner: Schema.optionalKey<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly name: Schema.String;
+            }>>;
+        }>>;
+        readonly child: Schema.optionalKey<Schema.Struct<{
+            readonly runId: Schema.String;
+            readonly loopTitle: Schema.String;
+            readonly display: Schema.Struct<{
+                readonly state: Schema.Literals<readonly ["queued", "running", "needs_you", "blocked", "failed", "stopped", "succeeded", "partial"]>;
+                /** A Step needed more than one attempt. */
+                readonly retried: Schema.Boolean;
+                /** What now: the open Question, the failure, what went missing, or the Steps it is in. */
+                readonly summary: Schema.optionalKey<Schema.String>;
+            }>;
+            readonly task: Schema.optionalKey<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly key: Schema.String;
+                readonly title: Schema.String;
+            }>>;
+        }>>;
+    }>>>;
+    /** From a Child Run node to one it needs: a `blocks` Task Relation joins their Tasks. */
+    readonly needs: Schema.$Array<Schema.Struct<{
+        readonly from: Schema.String;
+        readonly to: Schema.String;
+    }>>;
+}>;
+export type RunGraph = (typeof RunGraph)['Type'];
+/** What the Run page leads with. */
+export declare const RunHeader: Schema.Struct<{
+    readonly loopTitle: Schema.String;
+    readonly branch: Schema.optionalKey<Schema.String>;
+    /** The newest ChangeRequest from the Run's branch. */
+    readonly changeRequest: Schema.optionalKey<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly title: Schema.String;
+        readonly url: Schema.String;
+    }>>;
+    readonly startedBy: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Literal<"person">;
+        readonly name: Schema.String;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"event">;
+        readonly event: Schema.String;
+    }>]>>;
+}>;
+export type RunHeader = (typeof RunHeader)['Type'];
 export declare const RunShow: Schema.Struct<{
     readonly run: Schema.Struct<{
         readonly id: Schema.String;
@@ -2259,6 +2404,78 @@ export declare const RunShow: Schema.Struct<{
         readonly createdAt: Schema.String;
         readonly updatedAt: Schema.String;
     }>;
+    readonly header: Schema.Struct<{
+        readonly loopTitle: Schema.String;
+        readonly branch: Schema.optionalKey<Schema.String>;
+        /** The newest ChangeRequest from the Run's branch. */
+        readonly changeRequest: Schema.optionalKey<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly title: Schema.String;
+            readonly url: Schema.String;
+        }>>;
+        readonly startedBy: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+            readonly kind: Schema.Literal<"person">;
+            readonly name: Schema.String;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"event">;
+            readonly event: Schema.String;
+        }>]>>;
+    }>;
+    readonly display: Schema.Struct<{
+        readonly state: Schema.Literals<readonly ["queued", "running", "needs_you", "blocked", "failed", "stopped", "succeeded", "partial"]>;
+        /** A Step needed more than one attempt. */
+        readonly retried: Schema.Boolean;
+        /** What now: the open Question, the failure, what went missing, or the Steps it is in. */
+        readonly summary: Schema.optionalKey<Schema.String>;
+    }>;
+    readonly graph: Schema.Struct<{
+        /** The Steps the Run reached together, left to right. */
+        readonly columns: Schema.$Array<Schema.$Array<Schema.Struct<{
+            /** The Step's name in the journal, such as `agent_work/fix:1`. */
+            readonly id: Schema.String;
+            readonly name: Schema.String;
+            readonly kind: Schema.Literals<readonly ["agent", "check", "question", "child", "wait", "activity"]>;
+            readonly status: Schema.Literals<readonly ["queued", "running", "needs_you", "blocked", "failed", "stopped", "succeeded", "partial"]>;
+            readonly startedAt: Schema.String;
+            readonly endedAt: Schema.optionalKey<Schema.String>;
+            readonly attempts: Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly attempt: Schema.Int;
+                readonly status: Schema.Literals<readonly ["queued", "running", "needs_you", "blocked", "failed", "stopped", "succeeded", "partial"]>;
+                readonly failureSummary: Schema.optionalKey<Schema.String>;
+            }>>;
+            readonly agent: Schema.optionalKey<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly harness: Schema.optionalKey<Schema.String>;
+                readonly model: Schema.optionalKey<Schema.String>;
+                readonly runner: Schema.optionalKey<Schema.Struct<{
+                    readonly id: Schema.String;
+                    readonly name: Schema.String;
+                }>>;
+            }>>;
+            readonly child: Schema.optionalKey<Schema.Struct<{
+                readonly runId: Schema.String;
+                readonly loopTitle: Schema.String;
+                readonly display: Schema.Struct<{
+                    readonly state: Schema.Literals<readonly ["queued", "running", "needs_you", "blocked", "failed", "stopped", "succeeded", "partial"]>;
+                    /** A Step needed more than one attempt. */
+                    readonly retried: Schema.Boolean;
+                    /** What now: the open Question, the failure, what went missing, or the Steps it is in. */
+                    readonly summary: Schema.optionalKey<Schema.String>;
+                }>;
+                readonly task: Schema.optionalKey<Schema.Struct<{
+                    readonly id: Schema.String;
+                    readonly key: Schema.String;
+                    readonly title: Schema.String;
+                }>>;
+            }>>;
+        }>>>;
+        /** From a Child Run node to one it needs: a `blocks` Task Relation joins their Tasks. */
+        readonly needs: Schema.$Array<Schema.Struct<{
+            readonly from: Schema.String;
+            readonly to: Schema.String;
+        }>>;
+    }>;
     readonly steps: Schema.$Array<Schema.Struct<{
         readonly name: Schema.String;
         readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "canceled"]>;
@@ -2270,6 +2487,9 @@ export declare const RunShow: Schema.Struct<{
             readonly attempt: Schema.Int;
             readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "canceled"]>;
             readonly failureSummary: Schema.optionalKey<Schema.String>;
+            /** What the attempt's agent submitted: its claims. */
+            readonly output: Schema.optionalKey<Schema.Unknown>;
+            readonly revision: Schema.optionalKey<Schema.String>;
         }>>;
     }>>;
     readonly questions: Schema.$Array<Schema.Struct<{
@@ -2327,6 +2547,19 @@ export declare const RunShow: Schema.Struct<{
         readonly data: Schema.optionalKey<Schema.Unknown>;
         readonly createdAt: Schema.String;
     }>>;
+    /** The `review-findings` artifacts of every Run in this Run's lineage. */
+    readonly findings: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly runId: Schema.String;
+        readonly projectId: Schema.optionalKey<Schema.String>;
+        readonly taskId: Schema.optionalKey<Schema.String>;
+        readonly step: Schema.String;
+        readonly kind: Schema.String;
+        readonly title: Schema.String;
+        readonly text: Schema.String;
+        readonly data: Schema.optionalKey<Schema.Unknown>;
+        readonly createdAt: Schema.String;
+    }>>;
     readonly events: Schema.$Array<Schema.Struct<{
         readonly id: Schema.String;
         readonly type: Schema.String;
@@ -2427,26 +2660,6 @@ export declare const ProgramLoop: Schema.Struct<{
     readonly package: Schema.String;
 }>;
 export type ProgramLoop = (typeof ProgramLoop)['Type'];
-/** A Loop as it resolves where it was asked about. */
-export declare const LoopDetail: Schema.Struct<{
-    readonly id: Schema.String;
-    readonly resolved: Schema.optionalKey<Schema.Struct<{
-        readonly id: Schema.String;
-        readonly title: Schema.String;
-        readonly layer: Schema.Literals<readonly ["project", "workspace", "shipped"]>;
-        readonly digest: Schema.String;
-        readonly outcome: Schema.optionalKey<Schema.String>;
-        readonly offers: Schema.$Array<Schema.Struct<{
-            readonly id: Schema.String;
-            readonly title: Schema.String;
-            readonly loop: Schema.String;
-        }>>;
-        readonly publishedAt: Schema.String;
-        /** The Package that declares it. */
-        readonly package: Schema.String;
-    }>>;
-}>;
-export type LoopDetail = (typeof LoopDetail)['Type'];
 /** What an Event did to one program Loop: the Run it started, or why it started none. */
 export declare const AutomaticStart: Schema.Struct<{
     readonly eventId: Schema.String;
@@ -2547,8 +2760,9 @@ export declare const ProgramLoopList: Schema.Struct<{
     }>>;
 }>;
 export type ProgramLoopList = (typeof ProgramLoopList)['Type'];
-export declare const RunList: Schema.Struct<{
-    readonly items: Schema.$Array<Schema.Struct<{
+/** A top-level Run as a list row shows it (ADR-0072). */
+export declare const RunListItem: Schema.Struct<{
+    readonly run: Schema.Struct<{
         readonly id: Schema.String;
         readonly workspaceId: Schema.String;
         readonly projectId: Schema.optionalKey<Schema.String>;
@@ -2686,7 +2900,189 @@ export declare const RunList: Schema.Struct<{
         readonly completedAt: Schema.optionalKey<Schema.String>;
         readonly createdAt: Schema.String;
         readonly updatedAt: Schema.String;
+    }>;
+    readonly loop: Schema.Struct<{
+        readonly id: Schema.String;
+        readonly title: Schema.String;
+    }>;
+    readonly task: Schema.optionalKey<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly key: Schema.String;
+        readonly title: Schema.String;
+    }>>;
+    readonly display: Schema.Struct<{
+        readonly state: Schema.Literals<readonly ["queued", "running", "needs_you", "blocked", "failed", "stopped", "succeeded", "partial"]>;
+        /** A Step needed more than one attempt. */
+        readonly retried: Schema.Boolean;
+        /** What now: the open Question, the failure, what went missing, or the Steps it is in. */
+        readonly summary: Schema.optionalKey<Schema.String>;
+    }>;
+    /** The worst node status of each Run graph column. */
+    readonly miniGraph: Schema.$Array<Schema.Literals<readonly ["queued", "running", "needs_you", "blocked", "failed", "stopped", "succeeded", "partial"]>>;
+}>;
+export type RunListItem = (typeof RunListItem)['Type'];
+export declare const RunList: Schema.Struct<{
+    readonly items: Schema.$Array<Schema.Struct<{
+        readonly run: Schema.Struct<{
+            readonly id: Schema.String;
+            readonly workspaceId: Schema.String;
+            readonly projectId: Schema.optionalKey<Schema.String>;
+            readonly taskId: Schema.optionalKey<Schema.String>;
+            readonly sessionId: Schema.optionalKey<Schema.String>;
+            /** The Loop's id in the Package that declared it. */
+            readonly loopId: Schema.String;
+            /** The Package version the Run was admitted with. */
+            readonly packageVersionId: Schema.optionalKey<Schema.String>;
+            readonly resourceVersion: Schema.Int;
+            readonly status: Schema.Literals<readonly ["pending", "running", "blocked", "completed", "failed", "canceled", "expired"]>;
+            readonly trigger: Schema.Struct<{
+                readonly event: Schema.String;
+                readonly eventId: Schema.String;
+                readonly subject: Schema.optionalKey<Schema.Struct<{
+                    readonly kind: Schema.String;
+                    readonly id: Schema.String;
+                }>>;
+                readonly occurredAt: Schema.String;
+                readonly metadata: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
+            }>;
+            readonly state: Schema.Struct<{
+                readonly stepStates: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+                    readonly stepKey: Schema.String;
+                    readonly sequence: Schema.Int;
+                    readonly attempts: Schema.Int;
+                    readonly stepAttemptId: Schema.optionalKey<Schema.String>;
+                    readonly startedAt: Schema.optionalKey<Schema.String>;
+                    readonly endedAt: Schema.optionalKey<Schema.String>;
+                    readonly output: Schema.optionalKey<Schema.Struct<{
+                        readonly stepKey: Schema.String;
+                        readonly outputSchemaRef: Schema.Struct<{
+                            readonly kind: Schema.Literal<"typebox_ref">;
+                            readonly name: Schema.String;
+                            readonly version: Schema.optionalKey<Schema.String>;
+                            readonly sha256: Schema.optionalKey<Schema.String>;
+                        }>;
+                        readonly summary: Schema.String;
+                        readonly data: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
+                        readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
+                        readonly refs: Schema.$Array<Schema.Struct<{
+                            readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
+                            readonly id: Schema.optionalKey<Schema.String>;
+                            readonly externalId: Schema.optionalKey<Schema.String>;
+                            readonly provider: Schema.optionalKey<Schema.String>;
+                            readonly title: Schema.optionalKey<Schema.String>;
+                        }>>;
+                    }>>;
+                    readonly failureSummary: Schema.optionalKey<Schema.String>;
+                    readonly updatedAt: Schema.String;
+                    readonly required: Schema.Literal<true>;
+                    readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "canceled"]>;
+                }>, Schema.Struct<{
+                    readonly stepKey: Schema.String;
+                    readonly sequence: Schema.Int;
+                    readonly attempts: Schema.Int;
+                    readonly stepAttemptId: Schema.optionalKey<Schema.String>;
+                    readonly startedAt: Schema.optionalKey<Schema.String>;
+                    readonly endedAt: Schema.optionalKey<Schema.String>;
+                    readonly output: Schema.optionalKey<Schema.Struct<{
+                        readonly stepKey: Schema.String;
+                        readonly outputSchemaRef: Schema.Struct<{
+                            readonly kind: Schema.Literal<"typebox_ref">;
+                            readonly name: Schema.String;
+                            readonly version: Schema.optionalKey<Schema.String>;
+                            readonly sha256: Schema.optionalKey<Schema.String>;
+                        }>;
+                        readonly summary: Schema.String;
+                        readonly data: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
+                        readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
+                        readonly refs: Schema.$Array<Schema.Struct<{
+                            readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
+                            readonly id: Schema.optionalKey<Schema.String>;
+                            readonly externalId: Schema.optionalKey<Schema.String>;
+                            readonly provider: Schema.optionalKey<Schema.String>;
+                            readonly title: Schema.optionalKey<Schema.String>;
+                        }>>;
+                    }>>;
+                    readonly failureSummary: Schema.optionalKey<Schema.String>;
+                    readonly updatedAt: Schema.String;
+                    readonly required: Schema.Literal<false>;
+                    readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "skipped", "canceled"]>;
+                }>]>>;
+                readonly summary: Schema.optionalKey<Schema.String>;
+                readonly resultMetadata: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
+            }>;
+            /** A program Run's bundle digest, fixed at admission. */
+            readonly loopDigest: Schema.optionalKey<Schema.String>;
+            /** The layer a program Run's Loop resolved from. */
+            readonly loopLayer: Schema.optionalKey<Schema.Literals<readonly ["project", "workspace", "shipped"]>>;
+            /** A Child Run's parent. */
+            readonly parentRunId: Schema.optionalKey<Schema.String>;
+            readonly waiting: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+                readonly kind: Schema.Literal<"question">;
+                readonly name: Schema.String;
+                readonly questionId: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"clock">;
+                readonly name: Schema.String;
+                readonly firesAt: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"event">;
+                readonly name: Schema.String;
+                readonly event: Schema.String;
+                readonly timesOutAt: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"step">;
+                readonly name: Schema.String;
+                readonly stepAttemptId: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"child">;
+                readonly name: Schema.String;
+                readonly runId: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"verification">;
+                readonly name: Schema.String;
+                readonly verificationId: Schema.String;
+            }>]>>>;
+            readonly output: Schema.optionalKey<Schema.Unknown>;
+            readonly failureSummary: Schema.optionalKey<Schema.String>;
+            /** The latest Closure of a top-level Run. */
+            readonly closure: Schema.optionalKey<Schema.Struct<{
+                readonly kind: Schema.Literals<readonly ["complete", "abandoned"]>;
+                readonly reason: Schema.optionalKey<Schema.String>;
+                readonly closedByUserId: Schema.String;
+                readonly closedAt: Schema.String;
+            }>>;
+            readonly alignment: Schema.optionalKey<Schema.Struct<{
+                readonly verdict: Schema.Literals<readonly ["aligned", "not_aligned", "unverified"]>;
+                readonly reasons: Schema.$Array<Schema.String>;
+                readonly intentVersion: Schema.Int;
+                readonly judgedAt: Schema.String;
+            }>>;
+            readonly startedAt: Schema.optionalKey<Schema.String>;
+            readonly completedAt: Schema.optionalKey<Schema.String>;
+            readonly createdAt: Schema.String;
+            readonly updatedAt: Schema.String;
+        }>;
+        readonly loop: Schema.Struct<{
+            readonly id: Schema.String;
+            readonly title: Schema.String;
+        }>;
+        readonly task: Schema.optionalKey<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly key: Schema.String;
+            readonly title: Schema.String;
+        }>>;
+        readonly display: Schema.Struct<{
+            readonly state: Schema.Literals<readonly ["queued", "running", "needs_you", "blocked", "failed", "stopped", "succeeded", "partial"]>;
+            /** A Step needed more than one attempt. */
+            readonly retried: Schema.Boolean;
+            /** What now: the open Question, the failure, what went missing, or the Steps it is in. */
+            readonly summary: Schema.optionalKey<Schema.String>;
+        }>;
+        /** The worst node status of each Run graph column. */
+        readonly miniGraph: Schema.$Array<Schema.Literals<readonly ["queued", "running", "needs_you", "blocked", "failed", "stopped", "succeeded", "partial"]>>;
     }>>;
+    /** The cursor for the next page, while more Runs remain. */
+    readonly next: Schema.optionalKey<Schema.String>;
 }>;
 export type RunList = (typeof RunList)['Type'];
 export declare const RunWaitUntils: readonly ['attention', 'finished'];

package/types/packages/core/src/package-declarations.d.ts

@@ -32,6 +32,31 @@ export declare const LoopManifest: Schema.Struct<{
     }>, Schema.Literal<"open">]>>;
 }>;
 export type LoopManifest = typeof LoopManifest.Type;
+/** A Loop as it resolves where it was asked about, with the Agent each role uses and what starts it. */
+export declare const LoopDetail: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly resolved: Schema.optionalKey<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly title: Schema.String;
+        readonly layer: Schema.Literals<readonly ["project", "workspace", "shipped"]>;
+        readonly digest: Schema.String;
+        readonly outcome: Schema.optionalKey<Schema.String>;
+        readonly offers: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly title: Schema.String;
+            readonly loop: Schema.String;
+        }>>;
+        readonly publishedAt: Schema.String;
+        readonly package: Schema.String;
+        readonly agents: Schema.$Record<Schema.String, Schema.String>;
+        readonly when: Schema.$Array<Schema.Struct<{
+            readonly event: Schema.String;
+            readonly filter: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean, Schema.Null]>, Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean, Schema.Null]>>]>>>;
+            readonly input: Schema.$Record<Schema.String, Schema.String>;
+        }>>;
+    }>>;
+}>;
+export type LoopDetail = (typeof LoopDetail)['Type'];
 /** An Agent as a Package declares it, with its instructions already read from the repository. */
 export declare const AgentDeclaration: Schema.Struct<{
     readonly extends: Schema.optionalKey<Schema.String>;