stitchkit 0.65.0 → 0.66.0

package/dist/agent-runtime/store.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { type AgentSnapshot } from './schemas';
+import { type AgentRun, type AgentSnapshot } from './schemas';
 export declare const AgentStoreConflictSchema: z.ZodObject<{
     outcome: z.ZodLiteral<"conflict">;
     actualVersion: z.ZodInt;
@@ -113,6 +113,7 @@ export declare const AgentStoreAppliedSchema: z.ZodObject<{
             fencingToken: z.ZodOptional<z.ZodInt>;
             terminalReason: z.ZodOptional<z.ZodEnum<{
                 abandoned: "abandoned";
+                absorbed: "absorbed";
                 cancelled: "cancelled";
                 context_overflow: "context_overflow";
                 interrupted: "interrupted";
@@ -125,9 +126,10 @@ export declare const AgentStoreAppliedSchema: z.ZodObject<{
                 timeout: "timeout";
             }>>;
             terminalPolicyName: z.ZodOptional<z.ZodString>;
+            absorbedIntoRunId: z.ZodOptional<z.ZodString>;
             usage: z.ZodOptional<z.ZodObject<{
                 inputTokens: z.ZodObject<{
-                    value: z.ZodOptional<z.ZodNumber>;
+                    value: z.ZodOptional<z.ZodInt>;
                     provenance: z.ZodEnum<{
                         computed: "computed";
                         estimated: "estimated";
@@ -136,7 +138,7 @@ export declare const AgentStoreAppliedSchema: z.ZodObject<{
                     }>;
                 }, z.core.$strip>;
                 outputTokens: z.ZodObject<{
-                    value: z.ZodOptional<z.ZodNumber>;
+                    value: z.ZodOptional<z.ZodInt>;
                     provenance: z.ZodEnum<{
                         computed: "computed";
                         estimated: "estimated";
@@ -145,7 +147,7 @@ export declare const AgentStoreAppliedSchema: z.ZodObject<{
                     }>;
                 }, z.core.$strip>;
                 reasoningTokens: z.ZodOptional<z.ZodObject<{
-                    value: z.ZodOptional<z.ZodNumber>;
+                    value: z.ZodOptional<z.ZodInt>;
                     provenance: z.ZodEnum<{
                         computed: "computed";
                         estimated: "estimated";
@@ -154,7 +156,7 @@ export declare const AgentStoreAppliedSchema: z.ZodObject<{
                     }>;
                 }, z.core.$strip>>;
                 cacheReadTokens: z.ZodOptional<z.ZodObject<{
-                    value: z.ZodOptional<z.ZodNumber>;
+                    value: z.ZodOptional<z.ZodInt>;
                     provenance: z.ZodEnum<{
                         computed: "computed";
                         estimated: "estimated";
@@ -163,7 +165,7 @@ export declare const AgentStoreAppliedSchema: z.ZodObject<{
                     }>;
                 }, z.core.$strip>>;
                 cacheWriteTokens: z.ZodOptional<z.ZodObject<{
-                    value: z.ZodOptional<z.ZodNumber>;
+                    value: z.ZodOptional<z.ZodInt>;
                     provenance: z.ZodEnum<{
                         computed: "computed";
                         estimated: "estimated";
@@ -292,6 +294,7 @@ export declare const AgentStoreDuplicateSchema: z.ZodObject<{
         fencingToken: z.ZodOptional<z.ZodInt>;
         terminalReason: z.ZodOptional<z.ZodEnum<{
             abandoned: "abandoned";
+            absorbed: "absorbed";
             cancelled: "cancelled";
             context_overflow: "context_overflow";
             interrupted: "interrupted";
@@ -304,9 +307,10 @@ export declare const AgentStoreDuplicateSchema: z.ZodObject<{
             timeout: "timeout";
         }>>;
         terminalPolicyName: z.ZodOptional<z.ZodString>;
+        absorbedIntoRunId: z.ZodOptional<z.ZodString>;
         usage: z.ZodOptional<z.ZodObject<{
             inputTokens: z.ZodObject<{
-                value: z.ZodOptional<z.ZodNumber>;
+                value: z.ZodOptional<z.ZodInt>;
                 provenance: z.ZodEnum<{
                     computed: "computed";
                     estimated: "estimated";
@@ -315,7 +319,7 @@ export declare const AgentStoreDuplicateSchema: z.ZodObject<{
                 }>;
             }, z.core.$strip>;
             outputTokens: z.ZodObject<{
-                value: z.ZodOptional<z.ZodNumber>;
+                value: z.ZodOptional<z.ZodInt>;
                 provenance: z.ZodEnum<{
                     computed: "computed";
                     estimated: "estimated";
@@ -324,7 +328,7 @@ export declare const AgentStoreDuplicateSchema: z.ZodObject<{
                 }>;
             }, z.core.$strip>;
             reasoningTokens: z.ZodOptional<z.ZodObject<{
-                value: z.ZodOptional<z.ZodNumber>;
+                value: z.ZodOptional<z.ZodInt>;
                 provenance: z.ZodEnum<{
                     computed: "computed";
                     estimated: "estimated";
@@ -333,7 +337,7 @@ export declare const AgentStoreDuplicateSchema: z.ZodObject<{
                 }>;
             }, z.core.$strip>>;
             cacheReadTokens: z.ZodOptional<z.ZodObject<{
-                value: z.ZodOptional<z.ZodNumber>;
+                value: z.ZodOptional<z.ZodInt>;
                 provenance: z.ZodEnum<{
                     computed: "computed";
                     estimated: "estimated";
@@ -342,7 +346,7 @@ export declare const AgentStoreDuplicateSchema: z.ZodObject<{
                 }>;
             }, z.core.$strip>>;
             cacheWriteTokens: z.ZodOptional<z.ZodObject<{
-                value: z.ZodOptional<z.ZodNumber>;
+                value: z.ZodOptional<z.ZodInt>;
                 provenance: z.ZodEnum<{
                     computed: "computed";
                     estimated: "estimated";
@@ -546,6 +550,7 @@ export declare const AgentStoreDuplicateSchema: z.ZodObject<{
             fencingToken: z.ZodOptional<z.ZodInt>;
             terminalReason: z.ZodOptional<z.ZodEnum<{
                 abandoned: "abandoned";
+                absorbed: "absorbed";
                 cancelled: "cancelled";
                 context_overflow: "context_overflow";
                 interrupted: "interrupted";
@@ -558,9 +563,10 @@ export declare const AgentStoreDuplicateSchema: z.ZodObject<{
                 timeout: "timeout";
             }>>;
             terminalPolicyName: z.ZodOptional<z.ZodString>;
+            absorbedIntoRunId: z.ZodOptional<z.ZodString>;
             usage: z.ZodOptional<z.ZodObject<{
                 inputTokens: z.ZodObject<{
-                    value: z.ZodOptional<z.ZodNumber>;
+                    value: z.ZodOptional<z.ZodInt>;
                     provenance: z.ZodEnum<{
                         computed: "computed";
                         estimated: "estimated";
@@ -569,7 +575,7 @@ export declare const AgentStoreDuplicateSchema: z.ZodObject<{
                     }>;
                 }, z.core.$strip>;
                 outputTokens: z.ZodObject<{
-                    value: z.ZodOptional<z.ZodNumber>;
+                    value: z.ZodOptional<z.ZodInt>;
                     provenance: z.ZodEnum<{
                         computed: "computed";
                         estimated: "estimated";
@@ -578,7 +584,7 @@ export declare const AgentStoreDuplicateSchema: z.ZodObject<{
                     }>;
                 }, z.core.$strip>;
                 reasoningTokens: z.ZodOptional<z.ZodObject<{
-                    value: z.ZodOptional<z.ZodNumber>;
+                    value: z.ZodOptional<z.ZodInt>;
                     provenance: z.ZodEnum<{
                         computed: "computed";
                         estimated: "estimated";
@@ -587,7 +593,7 @@ export declare const AgentStoreDuplicateSchema: z.ZodObject<{
                     }>;
                 }, z.core.$strip>>;
                 cacheReadTokens: z.ZodOptional<z.ZodObject<{
-                    value: z.ZodOptional<z.ZodNumber>;
+                    value: z.ZodOptional<z.ZodInt>;
                     provenance: z.ZodEnum<{
                         computed: "computed";
                         estimated: "estimated";
@@ -596,7 +602,7 @@ export declare const AgentStoreDuplicateSchema: z.ZodObject<{
                     }>;
                 }, z.core.$strip>>;
                 cacheWriteTokens: z.ZodOptional<z.ZodObject<{
-                    value: z.ZodOptional<z.ZodNumber>;
+                    value: z.ZodOptional<z.ZodInt>;
                     provenance: z.ZodEnum<{
                         computed: "computed";
                         estimated: "estimated";
@@ -726,6 +732,7 @@ export declare const AgentStoreMutationResultSchema: z.ZodDiscriminatedUnion<[z.
             fencingToken: z.ZodOptional<z.ZodInt>;
             terminalReason: z.ZodOptional<z.ZodEnum<{
                 abandoned: "abandoned";
+                absorbed: "absorbed";
                 cancelled: "cancelled";
                 context_overflow: "context_overflow";
                 interrupted: "interrupted";
@@ -738,9 +745,10 @@ export declare const AgentStoreMutationResultSchema: z.ZodDiscriminatedUnion<[z.
                 timeout: "timeout";
             }>>;
             terminalPolicyName: z.ZodOptional<z.ZodString>;
+            absorbedIntoRunId: z.ZodOptional<z.ZodString>;
             usage: z.ZodOptional<z.ZodObject<{
                 inputTokens: z.ZodObject<{
-                    value: z.ZodOptional<z.ZodNumber>;
+                    value: z.ZodOptional<z.ZodInt>;
                     provenance: z.ZodEnum<{
                         computed: "computed";
                         estimated: "estimated";
@@ -749,7 +757,7 @@ export declare const AgentStoreMutationResultSchema: z.ZodDiscriminatedUnion<[z.
                     }>;
                 }, z.core.$strip>;
                 outputTokens: z.ZodObject<{
-                    value: z.ZodOptional<z.ZodNumber>;
+                    value: z.ZodOptional<z.ZodInt>;
                     provenance: z.ZodEnum<{
                         computed: "computed";
                         estimated: "estimated";
@@ -758,7 +766,7 @@ export declare const AgentStoreMutationResultSchema: z.ZodDiscriminatedUnion<[z.
                     }>;
                 }, z.core.$strip>;
                 reasoningTokens: z.ZodOptional<z.ZodObject<{
-                    value: z.ZodOptional<z.ZodNumber>;
+                    value: z.ZodOptional<z.ZodInt>;
                     provenance: z.ZodEnum<{
                         computed: "computed";
                         estimated: "estimated";
@@ -767,7 +775,7 @@ export declare const AgentStoreMutationResultSchema: z.ZodDiscriminatedUnion<[z.
                     }>;
                 }, z.core.$strip>>;
                 cacheReadTokens: z.ZodOptional<z.ZodObject<{
-                    value: z.ZodOptional<z.ZodNumber>;
+                    value: z.ZodOptional<z.ZodInt>;
                     provenance: z.ZodEnum<{
                         computed: "computed";
                         estimated: "estimated";
@@ -776,7 +784,7 @@ export declare const AgentStoreMutationResultSchema: z.ZodDiscriminatedUnion<[z.
                     }>;
                 }, z.core.$strip>>;
                 cacheWriteTokens: z.ZodOptional<z.ZodObject<{
-                    value: z.ZodOptional<z.ZodNumber>;
+                    value: z.ZodOptional<z.ZodInt>;
                     provenance: z.ZodEnum<{
                         computed: "computed";
                         estimated: "estimated";
@@ -904,6 +912,7 @@ export declare const AgentStoreMutationResultSchema: z.ZodDiscriminatedUnion<[z.
         fencingToken: z.ZodOptional<z.ZodInt>;
         terminalReason: z.ZodOptional<z.ZodEnum<{
             abandoned: "abandoned";
+            absorbed: "absorbed";
             cancelled: "cancelled";
             context_overflow: "context_overflow";
             interrupted: "interrupted";
@@ -916,9 +925,10 @@ export declare const AgentStoreMutationResultSchema: z.ZodDiscriminatedUnion<[z.
             timeout: "timeout";
         }>>;
         terminalPolicyName: z.ZodOptional<z.ZodString>;
+        absorbedIntoRunId: z.ZodOptional<z.ZodString>;
         usage: z.ZodOptional<z.ZodObject<{
             inputTokens: z.ZodObject<{
-                value: z.ZodOptional<z.ZodNumber>;
+                value: z.ZodOptional<z.ZodInt>;
                 provenance: z.ZodEnum<{
                     computed: "computed";
                     estimated: "estimated";
@@ -927,7 +937,7 @@ export declare const AgentStoreMutationResultSchema: z.ZodDiscriminatedUnion<[z.
                 }>;
             }, z.core.$strip>;
             outputTokens: z.ZodObject<{
-                value: z.ZodOptional<z.ZodNumber>;
+                value: z.ZodOptional<z.ZodInt>;
                 provenance: z.ZodEnum<{
                     computed: "computed";
                     estimated: "estimated";
@@ -936,7 +946,7 @@ export declare const AgentStoreMutationResultSchema: z.ZodDiscriminatedUnion<[z.
                 }>;
             }, z.core.$strip>;
             reasoningTokens: z.ZodOptional<z.ZodObject<{
-                value: z.ZodOptional<z.ZodNumber>;
+                value: z.ZodOptional<z.ZodInt>;
                 provenance: z.ZodEnum<{
                     computed: "computed";
                     estimated: "estimated";
@@ -945,7 +955,7 @@ export declare const AgentStoreMutationResultSchema: z.ZodDiscriminatedUnion<[z.
                 }>;
             }, z.core.$strip>>;
             cacheReadTokens: z.ZodOptional<z.ZodObject<{
-                value: z.ZodOptional<z.ZodNumber>;
+                value: z.ZodOptional<z.ZodInt>;
                 provenance: z.ZodEnum<{
                     computed: "computed";
                     estimated: "estimated";
@@ -954,7 +964,7 @@ export declare const AgentStoreMutationResultSchema: z.ZodDiscriminatedUnion<[z.
                 }>;
             }, z.core.$strip>>;
             cacheWriteTokens: z.ZodOptional<z.ZodObject<{
-                value: z.ZodOptional<z.ZodNumber>;
+                value: z.ZodOptional<z.ZodInt>;
                 provenance: z.ZodEnum<{
                     computed: "computed";
                     estimated: "estimated";
@@ -1158,6 +1168,7 @@ export declare const AgentStoreMutationResultSchema: z.ZodDiscriminatedUnion<[z.
             fencingToken: z.ZodOptional<z.ZodInt>;
             terminalReason: z.ZodOptional<z.ZodEnum<{
                 abandoned: "abandoned";
+                absorbed: "absorbed";
                 cancelled: "cancelled";
                 context_overflow: "context_overflow";
                 interrupted: "interrupted";
@@ -1170,9 +1181,10 @@ export declare const AgentStoreMutationResultSchema: z.ZodDiscriminatedUnion<[z.
                 timeout: "timeout";
             }>>;
             terminalPolicyName: z.ZodOptional<z.ZodString>;
+            absorbedIntoRunId: z.ZodOptional<z.ZodString>;
             usage: z.ZodOptional<z.ZodObject<{
                 inputTokens: z.ZodObject<{
-                    value: z.ZodOptional<z.ZodNumber>;
+                    value: z.ZodOptional<z.ZodInt>;
                     provenance: z.ZodEnum<{
                         computed: "computed";
                         estimated: "estimated";
@@ -1181,7 +1193,7 @@ export declare const AgentStoreMutationResultSchema: z.ZodDiscriminatedUnion<[z.
                     }>;
                 }, z.core.$strip>;
                 outputTokens: z.ZodObject<{
-                    value: z.ZodOptional<z.ZodNumber>;
+                    value: z.ZodOptional<z.ZodInt>;
                     provenance: z.ZodEnum<{
                         computed: "computed";
                         estimated: "estimated";
@@ -1190,7 +1202,7 @@ export declare const AgentStoreMutationResultSchema: z.ZodDiscriminatedUnion<[z.
                     }>;
                 }, z.core.$strip>;
                 reasoningTokens: z.ZodOptional<z.ZodObject<{
-                    value: z.ZodOptional<z.ZodNumber>;
+                    value: z.ZodOptional<z.ZodInt>;
                     provenance: z.ZodEnum<{
                         computed: "computed";
                         estimated: "estimated";
@@ -1199,7 +1211,7 @@ export declare const AgentStoreMutationResultSchema: z.ZodDiscriminatedUnion<[z.
                     }>;
                 }, z.core.$strip>>;
                 cacheReadTokens: z.ZodOptional<z.ZodObject<{
-                    value: z.ZodOptional<z.ZodNumber>;
+                    value: z.ZodOptional<z.ZodInt>;
                     provenance: z.ZodEnum<{
                         computed: "computed";
                         estimated: "estimated";
@@ -1208,7 +1220,7 @@ export declare const AgentStoreMutationResultSchema: z.ZodDiscriminatedUnion<[z.
                     }>;
                 }, z.core.$strip>>;
                 cacheWriteTokens: z.ZodOptional<z.ZodObject<{
-                    value: z.ZodOptional<z.ZodNumber>;
+                    value: z.ZodOptional<z.ZodInt>;
                     provenance: z.ZodEnum<{
                         computed: "computed";
                         estimated: "estimated";
@@ -1238,6 +1250,196 @@ export declare const AgentStoreMutationResultSchema: z.ZodDiscriminatedUnion<[z.
     outcome: z.ZodLiteral<"not_found">;
 }, z.core.$strip>], "outcome">;
 export type AgentStoreMutationResult = z.infer<typeof AgentStoreMutationResultSchema>;
+/**
+ * One run, read without reading the conversation it belongs to.
+ *
+ * `loadSnapshot` was the only way to resolve a `runId`, and most of the runtime
+ * only ever wanted the run: the fencing check that runs before **every tool
+ * call** loaded every message in the conversation to compare two numbers. A
+ * twenty-tool run in a five-thousand-message conversation read a hundred
+ * thousand messages to learn nothing about any of them.
+ *
+ * `assistant` is the retained terminal message, so it is present exactly when
+ * the run is terminal — which is when anything asks for it.
+ */
+export declare const AgentRunViewSchema: z.ZodObject<{
+    snapshotVersion: z.ZodInt;
+    run: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        id: z.ZodString;
+        conversationId: z.ZodString;
+        inputMessageIds: z.ZodArray<z.ZodString>;
+        assistantMessageId: z.ZodString;
+        state: z.ZodEnum<{
+            abandoned: "abandoned";
+            cancelled: "cancelled";
+            completed: "completed";
+            failed: "failed";
+            interrupt_requested: "interrupt_requested";
+            interrupted: "interrupted";
+            queued: "queued";
+            running: "running";
+            superseded: "superseded";
+        }>;
+        revision: z.ZodInt;
+        ownerId: z.ZodOptional<z.ZodString>;
+        fencingToken: z.ZodOptional<z.ZodInt>;
+        terminalReason: z.ZodOptional<z.ZodEnum<{
+            abandoned: "abandoned";
+            absorbed: "absorbed";
+            cancelled: "cancelled";
+            context_overflow: "context_overflow";
+            interrupted: "interrupted";
+            policy_stop: "policy_stop";
+            provider_failure: "provider_failure";
+            provider_stop: "provider_stop";
+            shutdown: "shutdown";
+            success: "success";
+            superseded: "superseded";
+            timeout: "timeout";
+        }>>;
+        terminalPolicyName: z.ZodOptional<z.ZodString>;
+        absorbedIntoRunId: z.ZodOptional<z.ZodString>;
+        usage: z.ZodOptional<z.ZodObject<{
+            inputTokens: z.ZodObject<{
+                value: z.ZodOptional<z.ZodInt>;
+                provenance: z.ZodEnum<{
+                    computed: "computed";
+                    estimated: "estimated";
+                    "provider-reported": "provider-reported";
+                    unavailable: "unavailable";
+                }>;
+            }, z.core.$strip>;
+            outputTokens: z.ZodObject<{
+                value: z.ZodOptional<z.ZodInt>;
+                provenance: z.ZodEnum<{
+                    computed: "computed";
+                    estimated: "estimated";
+                    "provider-reported": "provider-reported";
+                    unavailable: "unavailable";
+                }>;
+            }, z.core.$strip>;
+            reasoningTokens: z.ZodOptional<z.ZodObject<{
+                value: z.ZodOptional<z.ZodInt>;
+                provenance: z.ZodEnum<{
+                    computed: "computed";
+                    estimated: "estimated";
+                    "provider-reported": "provider-reported";
+                    unavailable: "unavailable";
+                }>;
+            }, z.core.$strip>>;
+            cacheReadTokens: z.ZodOptional<z.ZodObject<{
+                value: z.ZodOptional<z.ZodInt>;
+                provenance: z.ZodEnum<{
+                    computed: "computed";
+                    estimated: "estimated";
+                    "provider-reported": "provider-reported";
+                    unavailable: "unavailable";
+                }>;
+            }, z.core.$strip>>;
+            cacheWriteTokens: z.ZodOptional<z.ZodObject<{
+                value: z.ZodOptional<z.ZodInt>;
+                provenance: z.ZodEnum<{
+                    computed: "computed";
+                    estimated: "estimated";
+                    "provider-reported": "provider-reported";
+                    unavailable: "unavailable";
+                }>;
+            }, z.core.$strip>>;
+            cost: z.ZodOptional<z.ZodObject<{
+                value: z.ZodOptional<z.ZodNumber>;
+                currency: z.ZodOptional<z.ZodString>;
+                provenance: z.ZodEnum<{
+                    computed: "computed";
+                    estimated: "estimated";
+                    "provider-reported": "provider-reported";
+                    unavailable: "unavailable";
+                }>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        createdAt: z.ZodISODateTime;
+        updatedAt: z.ZodISODateTime;
+    }, z.core.$strip>;
+    assistant: z.ZodOptional<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        id: z.ZodString;
+        conversationId: z.ZodString;
+        runId: z.ZodOptional<z.ZodString>;
+        role: z.ZodEnum<{
+            assistant: "assistant";
+            summary: "summary";
+            system: "system";
+            user: "user";
+        }>;
+        status: z.ZodEnum<{
+            committed: "committed";
+            completed: "completed";
+            failed: "failed";
+            interrupted: "interrupted";
+            streaming: "streaming";
+            superseded: "superseded";
+        }>;
+        parts: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"reasoning">;
+            text: z.ZodString;
+            provider: z.ZodOptional<z.ZodObject<{
+                schemaVersion: z.ZodInt;
+                provider: z.ZodString;
+                data: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"file">;
+            mediaType: z.ZodString;
+            reference: z.ZodString;
+            filename: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"source">;
+            sourceId: z.ZodString;
+            url: z.ZodOptional<z.ZodURL>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"tool-call">;
+            callId: z.ZodString;
+            toolName: z.ZodString;
+            input: z.ZodJSONSchema;
+            provider: z.ZodOptional<z.ZodObject<{
+                schemaVersion: z.ZodInt;
+                provider: z.ZodString;
+                data: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"tool-result">;
+            callId: z.ZodString;
+            toolName: z.ZodString;
+            outcome: z.ZodEnum<{
+                error: "error";
+                interrupted: "interrupted";
+                success: "success";
+            }>;
+            output: z.ZodOptional<z.ZodJSONSchema>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"provider">;
+            envelope: z.ZodObject<{
+                schemaVersion: z.ZodInt;
+                provider: z.ZodString;
+                data: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"control">;
+            reason: z.ZodEnum<{
+                "run-interrupted": "run-interrupted";
+                "stale-run": "stale-run";
+            }>;
+        }, z.core.$strip>], "type">>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        createdAt: z.ZodISODateTime;
+        updatedAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AgentRunView = z.infer<typeof AgentRunViewSchema>;
 export declare const AcceptInputAndAssignRunSchema: z.ZodObject<{
     idempotencyKey: z.ZodString;
     expectedVersion: z.ZodOptional<z.ZodInt>;
@@ -1341,6 +1543,7 @@ export declare const AcceptInputAndAssignRunSchema: z.ZodObject<{
         fencingToken: z.ZodOptional<z.ZodInt>;
         terminalReason: z.ZodOptional<z.ZodEnum<{
             abandoned: "abandoned";
+            absorbed: "absorbed";
             cancelled: "cancelled";
             context_overflow: "context_overflow";
             interrupted: "interrupted";
@@ -1353,9 +1556,10 @@ export declare const AcceptInputAndAssignRunSchema: z.ZodObject<{
             timeout: "timeout";
         }>>;
         terminalPolicyName: z.ZodOptional<z.ZodString>;
+        absorbedIntoRunId: z.ZodOptional<z.ZodString>;
         usage: z.ZodOptional<z.ZodObject<{
             inputTokens: z.ZodObject<{
-                value: z.ZodOptional<z.ZodNumber>;
+                value: z.ZodOptional<z.ZodInt>;
                 provenance: z.ZodEnum<{
                     computed: "computed";
                     estimated: "estimated";
@@ -1364,7 +1568,7 @@ export declare const AcceptInputAndAssignRunSchema: z.ZodObject<{
                 }>;
             }, z.core.$strip>;
             outputTokens: z.ZodObject<{
-                value: z.ZodOptional<z.ZodNumber>;
+                value: z.ZodOptional<z.ZodInt>;
                 provenance: z.ZodEnum<{
                     computed: "computed";
                     estimated: "estimated";
@@ -1373,7 +1577,7 @@ export declare const AcceptInputAndAssignRunSchema: z.ZodObject<{
                 }>;
             }, z.core.$strip>;
             reasoningTokens: z.ZodOptional<z.ZodObject<{
-                value: z.ZodOptional<z.ZodNumber>;
+                value: z.ZodOptional<z.ZodInt>;
                 provenance: z.ZodEnum<{
                     computed: "computed";
                     estimated: "estimated";
@@ -1382,7 +1586,7 @@ export declare const AcceptInputAndAssignRunSchema: z.ZodObject<{
                 }>;
             }, z.core.$strip>>;
             cacheReadTokens: z.ZodOptional<z.ZodObject<{
-                value: z.ZodOptional<z.ZodNumber>;
+                value: z.ZodOptional<z.ZodInt>;
                 provenance: z.ZodEnum<{
                     computed: "computed";
                     estimated: "estimated";
@@ -1391,7 +1595,7 @@ export declare const AcceptInputAndAssignRunSchema: z.ZodObject<{
                 }>;
             }, z.core.$strip>>;
             cacheWriteTokens: z.ZodOptional<z.ZodObject<{
-                value: z.ZodOptional<z.ZodNumber>;
+                value: z.ZodOptional<z.ZodInt>;
                 provenance: z.ZodEnum<{
                     computed: "computed";
                     estimated: "estimated";
@@ -1507,7 +1711,7 @@ export declare const CheckpointRunAssistantSchema: z.ZodObject<{
     }, z.core.$strip>;
     usage: z.ZodOptional<z.ZodObject<{
         inputTokens: z.ZodObject<{
-            value: z.ZodOptional<z.ZodNumber>;
+            value: z.ZodOptional<z.ZodInt>;
             provenance: z.ZodEnum<{
                 computed: "computed";
                 estimated: "estimated";
@@ -1516,7 +1720,7 @@ export declare const CheckpointRunAssistantSchema: z.ZodObject<{
             }>;
         }, z.core.$strip>;
         outputTokens: z.ZodObject<{
-            value: z.ZodOptional<z.ZodNumber>;
+            value: z.ZodOptional<z.ZodInt>;
             provenance: z.ZodEnum<{
                 computed: "computed";
                 estimated: "estimated";
@@ -1525,7 +1729,7 @@ export declare const CheckpointRunAssistantSchema: z.ZodObject<{
             }>;
         }, z.core.$strip>;
         reasoningTokens: z.ZodOptional<z.ZodObject<{
-            value: z.ZodOptional<z.ZodNumber>;
+            value: z.ZodOptional<z.ZodInt>;
             provenance: z.ZodEnum<{
                 computed: "computed";
                 estimated: "estimated";
@@ -1534,7 +1738,7 @@ export declare const CheckpointRunAssistantSchema: z.ZodObject<{
             }>;
         }, z.core.$strip>>;
         cacheReadTokens: z.ZodOptional<z.ZodObject<{
-            value: z.ZodOptional<z.ZodNumber>;
+            value: z.ZodOptional<z.ZodInt>;
             provenance: z.ZodEnum<{
                 computed: "computed";
                 estimated: "estimated";
@@ -1543,7 +1747,7 @@ export declare const CheckpointRunAssistantSchema: z.ZodObject<{
             }>;
         }, z.core.$strip>>;
         cacheWriteTokens: z.ZodOptional<z.ZodObject<{
-            value: z.ZodOptional<z.ZodNumber>;
+            value: z.ZodOptional<z.ZodInt>;
             provenance: z.ZodEnum<{
                 computed: "computed";
                 estimated: "estimated";
@@ -1649,6 +1853,7 @@ export declare const CommitRunTerminalSchema: z.ZodObject<{
     }, z.core.$strip>;
     reason: z.ZodEnum<{
         abandoned: "abandoned";
+        absorbed: "absorbed";
         cancelled: "cancelled";
         context_overflow: "context_overflow";
         interrupted: "interrupted";
@@ -1663,7 +1868,7 @@ export declare const CommitRunTerminalSchema: z.ZodObject<{
     policyName: z.ZodOptional<z.ZodString>;
     usage: z.ZodOptional<z.ZodObject<{
         inputTokens: z.ZodObject<{
-            value: z.ZodOptional<z.ZodNumber>;
+            value: z.ZodOptional<z.ZodInt>;
             provenance: z.ZodEnum<{
                 computed: "computed";
                 estimated: "estimated";
@@ -1672,7 +1877,7 @@ export declare const CommitRunTerminalSchema: z.ZodObject<{
             }>;
         }, z.core.$strip>;
         outputTokens: z.ZodObject<{
-            value: z.ZodOptional<z.ZodNumber>;
+            value: z.ZodOptional<z.ZodInt>;
             provenance: z.ZodEnum<{
                 computed: "computed";
                 estimated: "estimated";
@@ -1681,7 +1886,7 @@ export declare const CommitRunTerminalSchema: z.ZodObject<{
             }>;
         }, z.core.$strip>;
         reasoningTokens: z.ZodOptional<z.ZodObject<{
-            value: z.ZodOptional<z.ZodNumber>;
+            value: z.ZodOptional<z.ZodInt>;
             provenance: z.ZodEnum<{
                 computed: "computed";
                 estimated: "estimated";
@@ -1690,7 +1895,7 @@ export declare const CommitRunTerminalSchema: z.ZodObject<{
             }>;
         }, z.core.$strip>>;
         cacheReadTokens: z.ZodOptional<z.ZodObject<{
-            value: z.ZodOptional<z.ZodNumber>;
+            value: z.ZodOptional<z.ZodInt>;
             provenance: z.ZodEnum<{
                 computed: "computed";
                 estimated: "estimated";
@@ -1699,7 +1904,7 @@ export declare const CommitRunTerminalSchema: z.ZodObject<{
             }>;
         }, z.core.$strip>>;
         cacheWriteTokens: z.ZodOptional<z.ZodObject<{
-            value: z.ZodOptional<z.ZodNumber>;
+            value: z.ZodOptional<z.ZodInt>;
             provenance: z.ZodEnum<{
                 computed: "computed";
                 estimated: "estimated";
@@ -1718,6 +1923,10 @@ export declare const CommitRunTerminalSchema: z.ZodObject<{
             }>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
+    absorb: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        runId: z.ZodString;
+        inputMessageIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export declare const RequestRunInterruptSchema: z.ZodObject<{
     conversationId: z.ZodString;
@@ -1825,7 +2034,32 @@ export type RequestRunInterrupt = z.infer<typeof RequestRunInterruptSchema>;
 export type RecoverAgentRun = z.infer<typeof RecoverAgentRunSchema>;
 export type ReplaceCompactedRange = z.infer<typeof ReplaceCompactedRangeSchema>;
 export interface AgentRuntimeStore {
+    /**
+     * The whole conversation — every message and every run.
+     *
+     * Unbounded by construction, and the only read that is. Ask for it when you
+     * need the conversation: composing a prompt, or compacting. To resolve a
+     * `runId`, or to ask what is in flight, use `loadRun` / `listActiveRuns` —
+     * they read one record and are the calls the runtime itself uses. See
+     * "Reading a conversation" in the agent-runtime guide for what this costs and
+     * what bounds it.
+     */
     loadSnapshot(conversationId: string): Promise<AgentSnapshot>;
+    /** One run by id. `undefined` if this conversation has no such run. */
+    loadRun(input: {
+        conversationId: string;
+        runId: string;
+    }): Promise<AgentRunView | undefined>;
+    /**
+     * Every run of this conversation that has not reached a terminal state,
+     * oldest first by `createdAt` and then by `id`.
+     *
+     * Deliberately a weaker order than `AgentSnapshot.runs`, which breaks a
+     * `createdAt` tie by where the run sits in the conversation's history. That
+     * tiebreak needs the history, and reading it is the cost this call exists to
+     * avoid.
+     */
+    listActiveRuns(conversationId: string): Promise<readonly AgentRun[]>;
     acceptInputAndAssignRun(input: AcceptInputAndAssignRun): Promise<AgentStoreMutationResult>;
     acquireRun(input: AcquireAgentRun): Promise<AgentStoreMutationResult>;
     checkpointRunAssistant(input: CheckpointRunAssistant): Promise<AgentStoreMutationResult>;