@drisp/protocol 0.6.2 → 0.8.1

package/dist/v2.d.ts

@@ -4,15 +4,45 @@ import { f as InstalledWorkflowSchema } from './domain-B-kg2pa_.js';
 /** Presentation of canonical fragment records; archive/cursor accounting always uses the original records. */
 declare function readableHistory(records: HistoryRecord[]): HistoryRecord[];
 
+/**
+ * What a Build's children cost against its token budget (root ADR-0011). Tokens exclude cache reads. The forecasts
+ * are defaults, not measured; the caps are the per-Run ceilings the size classes declare.
+ */
+type SizeClass = 'S' | 'M' | 'L';
+/** Per-Run token cap of each size class. The largest class also bounds anything above it. */
+declare const SIZE_CLASS_CAPS: Readonly<Record<SizeClass, number>>;
+/** What a Run of each class is expected to use: default, not measured. */
+declare const SIZE_CLASS_FORECASTS: Readonly<Record<SizeClass, number>>;
+/** The smallest class whose cap is at least the declared one; above the largest cap is `L`. */
+declare function classOfCap(declaredCap: number): SizeClass;
+/**
+ * What one attempt holds against the budget: a closed attempt (finished, failed, cancelled) its forecast; a running
+ * or queued one still its declared cap.
+ */
+declare function attemptCost(attempt: {
+    tokenCap: number;
+    closed: boolean;
+}): number;
+
 declare const protocolVersion: {
     readonly major: 2;
-    readonly minor: 1;
+    readonly minor: 2;
 };
 declare const conversationContinuationCapability = "conversation_continuation";
 declare const abandonedConversationContinuationCapability = "abandoned_conversation_continuation";
 declare const repositoryAccessCapability = "repository_checkout_v1";
 /** The runner can install a Workflow named by a Run's install reference before it starts. */
 declare const workflowInstallCapability = "workflow_install_v1";
+/**
+ * The runner takes grants carrying `delegationToken` and `parent` (protocol minor 2, root ADR-0008) and hands the
+ * token to the agent as `DRISP_RUN_TOKEN`. A start with `delegation` is never sent to a runner without it.
+ */
+declare const runDelegationCapability = "run_delegation_v1";
+/** The prefix of every delegation token; the Hub keeps only its digest. */
+declare const delegationTokenPrefix = "drisp_dlg_";
+/** A `run.artifact` history record's `name`, and the most its `json` may take serialized. */
+declare const runArtifactNameSchema: z.ZodString;
+declare const runArtifactMaxBytes: number;
 /** Deployment-approved secret references, never secret values or process-control variables. */
 declare const secretEnvironmentSchema: z.ZodRecord<z.ZodString, z.ZodString>;
 declare const permissionAnswerSchema: z.ZodObject<{
@@ -90,6 +120,7 @@ declare const interruptionSchema: z.ZodObject<{
         question: "question";
         guidance: "guidance";
         recovery: "recovery";
+        waiting: "waiting";
     }>;
     message: z.ZodString;
     requestId: z.ZodOptional<z.ZodString>;
@@ -100,6 +131,40 @@ declare const workflowIdentitySchema: z.ZodObject<{
     version: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 type WorkflowIdentity = z.infer<typeof workflowIdentitySchema>;
+/** A Runner's close reasons for a Build Run: a child refused at bootstrap, or an approval marker with no question. */
+declare const buildCloseReasonSchema: z.ZodEnum<{
+    workflow_template_mismatch: "workflow_template_mismatch";
+    child_project_dir_invalid: "child_project_dir_invalid";
+    build_not_approved: "build_not_approved";
+    approval_question_missing: "approval_question_missing";
+}>;
+type BuildCloseReason = z.infer<typeof buildCloseReasonSchema>;
+/**
+ * Every close reason a Hub gives a Run view's `closeReason`: its own, and the Runner's Build ones it stores from
+ * `run.finished.reason`. The view keeps `closeReason` an open string, so a newer Hub's reasons still decode; the app
+ * words each of these (apps/macos Kit `BuildStrings.closeReasons`), and a Kit test fails on one it does not word.
+ */
+declare const runCloseReasonSchema: z.ZodEnum<{
+    workflow_template_mismatch: "workflow_template_mismatch";
+    child_project_dir_invalid: "child_project_dir_invalid";
+    build_not_approved: "build_not_approved";
+    approval_question_missing: "approval_question_missing";
+    execution_terminal: "execution_terminal";
+    cancelled_before_start: "cancelled_before_start";
+    admission_failed: "admission_failed";
+    abandoned: "abandoned";
+    managed_startup_timeout: "managed_startup_timeout";
+    runner_disconnected: "runner_disconnected";
+    runner_needs_owner: "runner_needs_owner";
+    runner_not_available: "runner_not_available";
+    runner_upgrade_required: "runner_upgrade_required";
+    legacy_succeeded: "legacy_succeeded";
+    legacy_failed: "legacy_failed";
+    legacy_cancelled: "legacy_cancelled";
+    legacy_timeout: "legacy_timeout";
+    legacy_force_failed: "legacy_force_failed";
+}>;
+type RunCloseReason = z.infer<typeof runCloseReasonSchema>;
 declare const controlRecordSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"workflows.changed">;
     workflows: z.ZodArray<z.ZodObject<{
@@ -167,6 +232,7 @@ declare const controlRecordSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             question: "question";
             guidance: "guidance";
             recovery: "recovery";
+            waiting: "waiting";
         }>;
         message: z.ZodString;
         requestId: z.ZodOptional<z.ZodString>;
@@ -201,6 +267,12 @@ declare const controlRecordSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }>;
     historyThrough: z.ZodNumber;
     workspaceUnavailable: z.ZodOptional<z.ZodLiteral<true>>;
+    reason: z.ZodOptional<z.ZodEnum<{
+        workflow_template_mismatch: "workflow_template_mismatch";
+        child_project_dir_invalid: "child_project_dir_invalid";
+        build_not_approved: "build_not_approved";
+        approval_question_missing: "approval_question_missing";
+    }>>;
     runId: z.ZodString;
     attemptId: z.ZodString;
     executionRevision: z.ZodNumber;
@@ -304,6 +376,24 @@ declare const runSpecSchema: z.ZodObject<{
         bindingId: z.ZodString;
     }, z.core.$strict>>;
 }, z.core.$strict>;
+/** What a Run is for, e.g. `plan:<linearProjectId>`; at most one non-closed Run holds a key (`key_busy`). */
+declare const runKeySchema: z.ZodString;
+/** A member start's grant to start, limit and stop its own children (root ADR-0008). */
+declare const delegationSchema: z.ZodObject<{
+    maxChildren: z.ZodNumber;
+    tokenBudget: z.ZodNumber;
+}, z.core.$strict>;
+/** A child's parent and declared token cap. Required on a delegated start; the Hub refuses it without `tokenCap`. */
+declare const runParentIntentSchema: z.ZodObject<{
+    runId: z.ZodString;
+    tokenCap: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+declare const runParentSchema: z.ZodObject<{
+    runId: z.ZodString;
+    tokenCap: z.ZodNumber;
+}, z.core.$strict>;
+type Delegation = z.infer<typeof delegationSchema>;
+type RunParent = z.infer<typeof runParentSchema>;
 declare const commandSchema: z.ZodObject<{
     commandId: z.ZodString;
     hubEpoch: z.ZodString;
@@ -347,6 +437,15 @@ declare const commandSchema: z.ZodObject<{
                 bindingId: z.ZodString;
             }, z.core.$strict>>;
         }, z.core.$strict>;
+        key: z.ZodOptional<z.ZodString>;
+        delegation: z.ZodOptional<z.ZodObject<{
+            maxChildren: z.ZodNumber;
+            tokenBudget: z.ZodNumber;
+        }, z.core.$strict>>;
+        parent: z.ZodOptional<z.ZodObject<{
+            runId: z.ZodString;
+            tokenCap: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"cancel">;
     }, z.core.$strict>, z.ZodObject<{
@@ -424,6 +523,11 @@ declare const grantSchema: z.ZodObject<{
         checkpointId: z.ZodString;
         checksum: z.ZodString;
     }, z.core.$strict>>;
+    delegationToken: z.ZodOptional<z.ZodString>;
+    parent: z.ZodOptional<z.ZodObject<{
+        runId: z.ZodString;
+        tokenCap: z.ZodNumber;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 declare const historyRecordSchema: z.ZodObject<{
     eventId: z.ZodString;
@@ -546,6 +650,7 @@ declare const runnerFrameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 question: "question";
                 guidance: "guidance";
                 recovery: "recovery";
+                waiting: "waiting";
             }>;
             message: z.ZodString;
             requestId: z.ZodOptional<z.ZodString>;
@@ -580,6 +685,12 @@ declare const runnerFrameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }>;
         historyThrough: z.ZodNumber;
         workspaceUnavailable: z.ZodOptional<z.ZodLiteral<true>>;
+        reason: z.ZodOptional<z.ZodEnum<{
+            workflow_template_mismatch: "workflow_template_mismatch";
+            child_project_dir_invalid: "child_project_dir_invalid";
+            build_not_approved: "build_not_approved";
+            approval_question_missing: "approval_question_missing";
+        }>>;
         runId: z.ZodString;
         attemptId: z.ZodString;
         executionRevision: z.ZodNumber;
@@ -657,6 +768,15 @@ declare const runViewSchema: z.ZodObject<{
     }, z.core.$strict>], "visibility">;
     recordRevision: z.ZodNumber;
     label: z.ZodOptional<z.ZodString>;
+    key: z.ZodOptional<z.ZodString>;
+    parent: z.ZodOptional<z.ZodObject<{
+        runId: z.ZodString;
+        tokenCap: z.ZodNumber;
+    }, z.core.$strict>>;
+    delegation: z.ZodOptional<z.ZodObject<{
+        maxChildren: z.ZodNumber;
+        tokenBudget: z.ZodNumber;
+    }, z.core.$strict>>;
     workflow: z.ZodOptional<z.ZodObject<{
         name: z.ZodString;
         version: z.ZodOptional<z.ZodString>;
@@ -685,6 +805,7 @@ declare const runViewSchema: z.ZodObject<{
                 question: "question";
                 guidance: "guidance";
                 recovery: "recovery";
+                waiting: "waiting";
             }>;
             message: z.ZodString;
             requestId: z.ZodOptional<z.ZodString>;
@@ -737,6 +858,15 @@ declare const runViewSchema: z.ZodObject<{
                 bindingId: z.ZodString;
             }, z.core.$strict>>;
         }, z.core.$strict>;
+        key: z.ZodOptional<z.ZodString>;
+        delegation: z.ZodOptional<z.ZodObject<{
+            maxChildren: z.ZodNumber;
+            tokenBudget: z.ZodNumber;
+        }, z.core.$strict>>;
+        parent: z.ZodOptional<z.ZodObject<{
+            runId: z.ZodString;
+            tokenCap: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"cancel">;
     }, z.core.$strict>, z.ZodObject<{
@@ -823,6 +953,15 @@ declare const clientFrameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     bindingId: z.ZodString;
                 }, z.core.$strict>>;
             }, z.core.$strict>;
+            key: z.ZodOptional<z.ZodString>;
+            delegation: z.ZodOptional<z.ZodObject<{
+                maxChildren: z.ZodNumber;
+                tokenBudget: z.ZodNumber;
+            }, z.core.$strict>>;
+            parent: z.ZodOptional<z.ZodObject<{
+                runId: z.ZodString;
+                tokenCap: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"cancel">;
         }, z.core.$strict>, z.ZodObject<{
@@ -921,6 +1060,11 @@ declare const checkpointSchema: z.ZodObject<{
             checkpointId: z.ZodString;
             checksum: z.ZodString;
         }, z.core.$strict>>;
+        delegationToken: z.ZodOptional<z.ZodString>;
+        parent: z.ZodOptional<z.ZodObject<{
+            runId: z.ZodString;
+            tokenCap: z.ZodNumber;
+        }, z.core.$strict>>;
     }, z.core.$strict>;
     gitHead: z.ZodString;
     gitBase: z.ZodOptional<z.ZodString>;
@@ -1092,8 +1236,8 @@ declare const runsGoToSchema: z.ZodUnion<readonly [z.ZodObject<{
 }, z.core.$strict>, z.ZodObject<{
     via: z.ZodLiteral<"none">;
     reason: z.ZodEnum<{
-        no_runner_available: "no_runner_available";
         runner_needs_owner: "runner_needs_owner";
+        no_runner_available: "no_runner_available";
     }>;
 }, z.core.$strict>]>;
 declare const runnerListSchema: z.ZodObject<{
@@ -1122,8 +1266,8 @@ declare const runnerListSchema: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         via: z.ZodLiteral<"none">;
         reason: z.ZodEnum<{
-            no_runner_available: "no_runner_available";
             runner_needs_owner: "runner_needs_owner";
+            no_runner_available: "no_runner_available";
         }>;
     }, z.core.$strict>]>>;
     minimumRunnerVersion: z.ZodOptional<z.ZodString>;
@@ -1280,4 +1424,4 @@ type ConnectPendingResponse = z.infer<typeof connectPendingResponseSchema>;
 type TeamDefault = z.infer<typeof teamDefaultSchema>;
 type RunsGoTo = z.infer<typeof runsGoToSchema>;
 
-export { type Audience, type Checkpoint, type Command, type ConnectAlreadyConnected, type ConnectPendingResponse, type ConnectRedeemRequest, type ConnectRedeemResponse, type ConnectStartRequest, type ConnectStartResponse, type ControlRecord, type ExecutionFact, type Grant, type Harness, type HarnessReadiness, type HistoryRecord, type InstalledWorkflow, type RepositoryBinding, type RepositorySource, type RunView, type RunnerAdoptRequest, type RunnerDisconnectPreview, type RunnerDisconnectResponse, type RunnerFrame, type RunnerList, type RunnerListEntry, type RunnerReadiness, type RunsGoTo, type Scope, type TeamDefault, type WorkflowIdentity, type WorkflowInstallReference, type WorkflowReference, abandonedConversationContinuationCapability, audienceSchema, canonicalJson, checkpointPathSchema, checkpointSchema, clientFrameSchema, commandSchema, connectAlreadyConnectedSchema, connectApproveRequestSchema, connectCodeAlphabet, connectCodeRequestSchema, connectCodeResponseSchema, connectCodeSchema, connectDenyRequestSchema, connectPendingResponseSchema, connectPollRequestSchema, connectRedeemRequestSchema, connectRedeemResponseSchema, connectStartRequestSchema, connectStartResponseSchema, controlRecordSchema, conversationContinuationCapability, grantSchema, harnessReadinessSchema, harnessSchema, historyRecordSchema, hubEpochRequestSchema, installReference, installedWorkflowsSchema, interruptionSchema, permissionAnswerSchema, protocolVersion, readableHistory, readinessFixCommand, repositoryAccessCapability, repositoryBindingSchema, repositoryRefSchema, repositorySourceSchema, repositoryWorkingDirectorySchema, runSpecSchema, runViewSchema, runnerAdoptRequestSchema, runnerDisconnectPreviewSchema, runnerDisconnectRequestSchema, runnerDisconnectResponseSchema, runnerFrameSchema, runnerListEntrySchema, runnerListSchema, runnerReadinessSchema, runnerUpdateCommand, runnerUpdateRequestSchema, runsGoToSchema, sameWorkflow, scopeSchema, secretEnvironmentSchema, sequence, teamDefaultRequestSchema, teamDefaultSchema, workflowIdentitySchema, workflowInstallCapability, workflowName, workflowReferenceSchema, workflowSourceSchema };
+export { type Audience, type BuildCloseReason, type Checkpoint, type Command, type ConnectAlreadyConnected, type ConnectPendingResponse, type ConnectRedeemRequest, type ConnectRedeemResponse, type ConnectStartRequest, type ConnectStartResponse, type ControlRecord, type Delegation, type ExecutionFact, type Grant, type Harness, type HarnessReadiness, type HistoryRecord, type InstalledWorkflow, type RepositoryBinding, type RepositorySource, type RunCloseReason, type RunParent, type RunView, type RunnerAdoptRequest, type RunnerDisconnectPreview, type RunnerDisconnectResponse, type RunnerFrame, type RunnerList, type RunnerListEntry, type RunnerReadiness, type RunsGoTo, SIZE_CLASS_CAPS, SIZE_CLASS_FORECASTS, type Scope, type SizeClass, type TeamDefault, type WorkflowIdentity, type WorkflowInstallReference, type WorkflowReference, abandonedConversationContinuationCapability, attemptCost, audienceSchema, buildCloseReasonSchema, canonicalJson, checkpointPathSchema, checkpointSchema, classOfCap, clientFrameSchema, commandSchema, connectAlreadyConnectedSchema, connectApproveRequestSchema, connectCodeAlphabet, connectCodeRequestSchema, connectCodeResponseSchema, connectCodeSchema, connectDenyRequestSchema, connectPendingResponseSchema, connectPollRequestSchema, connectRedeemRequestSchema, connectRedeemResponseSchema, connectStartRequestSchema, connectStartResponseSchema, controlRecordSchema, conversationContinuationCapability, delegationSchema, delegationTokenPrefix, grantSchema, harnessReadinessSchema, harnessSchema, historyRecordSchema, hubEpochRequestSchema, installReference, installedWorkflowsSchema, interruptionSchema, permissionAnswerSchema, protocolVersion, readableHistory, readinessFixCommand, repositoryAccessCapability, repositoryBindingSchema, repositoryRefSchema, repositorySourceSchema, repositoryWorkingDirectorySchema, runArtifactMaxBytes, runArtifactNameSchema, runCloseReasonSchema, runDelegationCapability, runKeySchema, runParentIntentSchema, runParentSchema, runSpecSchema, runViewSchema, runnerAdoptRequestSchema, runnerDisconnectPreviewSchema, runnerDisconnectRequestSchema, runnerDisconnectResponseSchema, runnerFrameSchema, runnerListEntrySchema, runnerListSchema, runnerReadinessSchema, runnerUpdateCommand, runnerUpdateRequestSchema, runsGoToSchema, sameWorkflow, scopeSchema, secretEnvironmentSchema, sequence, teamDefaultRequestSchema, teamDefaultSchema, workflowIdentitySchema, workflowInstallCapability, workflowName, workflowReferenceSchema, workflowSourceSchema };

package/dist/v2.js

@@ -47,12 +47,36 @@ function readableHistory(records) {
   return result;
 }
 
+// src/budget.ts
+var SIZE_CLASS_CAPS = {
+  S: 3e6,
+  M: 6e6,
+  L: 12e6
+};
+var SIZE_CLASS_FORECASTS = {
+  S: 15e4,
+  M: 4e5,
+  L: 12e5
+};
+function classOfCap(declaredCap) {
+  if (declaredCap <= SIZE_CLASS_CAPS.S) return "S";
+  if (declaredCap <= SIZE_CLASS_CAPS.M) return "M";
+  return "L";
+}
+function attemptCost(attempt) {
+  return attempt.closed ? SIZE_CLASS_FORECASTS[classOfCap(attempt.tokenCap)] : attempt.tokenCap;
+}
+
 // src/v2.ts
-var protocolVersion = { major: 2, minor: 1 };
+var protocolVersion = { major: 2, minor: 2 };
 var conversationContinuationCapability = "conversation_continuation";
 var abandonedConversationContinuationCapability = "abandoned_conversation_continuation";
 var repositoryAccessCapability = "repository_checkout_v1";
 var workflowInstallCapability = "workflow_install_v1";
+var runDelegationCapability = "run_delegation_v1";
+var delegationTokenPrefix = "drisp_dlg_";
+var runArtifactNameSchema = z.string().regex(/^[a-z][a-z0-9_]{0,63}$/);
+var runArtifactMaxBytes = 64 * 1024;
 var secretEnvironmentSchema = z.record(
   z.string().regex(/^(?:OPENAI_API_KEY|ANTHROPIC_API_KEY|CLAUDE_CODE_OAUTH_TOKEN|NPM_TOKEN|NODE_AUTH_TOKEN|PIP_INDEX_URL|PIP_EXTRA_INDEX_URL|UV_INDEX_URL|DRISP_TEST_[A-Z0-9_]+)$/),
   z.string().regex(/^projects\/[a-zA-Z0-9-]+\/secrets\/[a-zA-Z0-9_-]+\/versions\/(?:latest|[0-9]+)$/)
@@ -91,7 +115,8 @@ var runnerUpdateCommand = "npm i -g @drisp/cli";
 var interruptionSchema = z.strictObject({
   interruptionId: id,
   revision: positive,
-  kind: z.enum(["permission", "question", "guidance", "recovery"]),
+  /** `waiting` (root ADR-0008) is non-human: a Run parked until one of its children closes or parks. */
+  kind: z.enum(["permission", "question", "guidance", "recovery", "waiting"]),
   message: z.string().max(16384),
   requestId: id.optional()
 });
@@ -99,6 +124,29 @@ var workflowIdentitySchema = z.strictObject({
   name: z.string().min(1).max(128),
   version: z.string().min(1).max(128).optional()
 });
+var buildCloseReasonSchema = z.enum([
+  "workflow_template_mismatch",
+  "child_project_dir_invalid",
+  "build_not_approved",
+  "approval_question_missing"
+]);
+var runCloseReasonSchema = z.enum([
+  "execution_terminal",
+  "cancelled_before_start",
+  "admission_failed",
+  "abandoned",
+  "managed_startup_timeout",
+  "runner_disconnected",
+  "runner_needs_owner",
+  "runner_not_available",
+  "runner_upgrade_required",
+  "legacy_succeeded",
+  "legacy_failed",
+  "legacy_cancelled",
+  "legacy_timeout",
+  "legacy_force_failed",
+  ...buildCloseReasonSchema.options
+]);
 var factIdentity = {
   runId: id,
   attemptId: id,
@@ -143,7 +191,12 @@ var controlRecordSchema = z.discriminatedUnion("kind", [
     status: z.enum(["completed", "failed", "cancelled"]),
     historyThrough: sequence,
     /** No setup/harness executed and no workspace was produced; safe to retire without export. */
-    workspaceUnavailable: z.literal(true).optional()
+    workspaceUnavailable: z.literal(true).optional(),
+    /**
+     * Why a Build Run failed, as its close reason (docs/specs/build-orchestrator.md). Sent only for a grant with
+     * `parent` or `delegationToken`, which only a Hub that knows this field issues.
+     */
+    reason: buildCloseReasonSchema.optional()
   }),
   z.strictObject({ kind: z.literal("command.applied"), runId: id, attemptId: id, commandId: id }),
   z.strictObject({
@@ -207,6 +260,14 @@ var runSpecSchema = z.strictObject({
   workflow: workflowReferenceSchema.optional(),
   repository: repositorySourceSchema.optional()
 });
+var runKeySchema = z.string().min(1).max(160);
+var delegationSchema = z.strictObject({
+  maxChildren: z.number().int().min(1).max(8),
+  tokenBudget: z.number().int().positive().max(Number.MAX_SAFE_INTEGER)
+});
+var tokenCapSchema = z.number().int().positive().max(Number.MAX_SAFE_INTEGER);
+var runParentIntentSchema = z.strictObject({ runId: id, tokenCap: tokenCapSchema.optional() });
+var runParentSchema = z.strictObject({ runId: id, tokenCap: tokenCapSchema });
 var commandSchema = z.strictObject({
   commandId: id,
   hubEpoch: id,
@@ -223,7 +284,12 @@ var commandSchema = z.strictObject({
       runnerId: id.optional(),
       computeProfileId: id.optional(),
       scope: scopeSchema,
-      spec: runSpecSchema
+      spec: runSpecSchema,
+      key: runKeySchema.optional(),
+      /** Member starts only. */
+      delegation: delegationSchema.optional(),
+      /** Delegated starts only, and required on them. */
+      parent: runParentIntentSchema.optional()
     }),
     z.strictObject({ kind: z.literal("cancel") }),
     z.strictObject({ kind: z.literal("abandon") }),
@@ -266,7 +332,11 @@ var grantSchema = z.strictObject({
     closeReason: z.literal("abandoned").optional(),
     checkpoint: z.strictObject({ checkpointId: id, checksum: z.string().regex(/^[a-f0-9]{64}$/) }).optional()
   }).optional(),
-  checkpoint: z.strictObject({ checkpointId: id, checksum: z.string().regex(/^[a-f0-9]{64}$/) }).optional()
+  checkpoint: z.strictObject({ checkpointId: id, checksum: z.string().regex(/^[a-f0-9]{64}$/) }).optional(),
+  /** This attempt's delegation token: only for a Run started with `delegation`, only to a `run_delegation_v1` Runner. */
+  delegationToken: z.string().min(32).max(256).optional(),
+  /** Copied from the start intent of a delegated child. */
+  parent: runParentSchema.optional()
 });
 var historyRecordSchema = z.strictObject({
   eventId: id,
@@ -325,6 +395,9 @@ var runViewSchema = z.object({
   scope: scopeSchema,
   recordRevision: positive,
   label: z.string().max(160).optional(),
+  key: runKeySchema.optional(),
+  parent: runParentSchema.optional(),
+  delegation: delegationSchema.optional(),
   /** Resolved by the runner at start; absent until the Run starts and for runners that predate reporting. */
   workflow: workflowIdentitySchema.optional(),
   execution: z.object({
@@ -546,11 +619,16 @@ var connectApproveRequestSchema = z.strictObject({
 });
 var connectDenyRequestSchema = z.strictObject({ code: z.string().min(8).max(16) });
 export {
+  SIZE_CLASS_CAPS,
+  SIZE_CLASS_FORECASTS,
   abandonedConversationContinuationCapability,
+  attemptCost,
   audienceSchema,
+  buildCloseReasonSchema,
   canonicalJson,
   checkpointPathSchema,
   checkpointSchema,
+  classOfCap,
   clientFrameSchema,
   commandSchema,
   connectAlreadyConnectedSchema,
@@ -568,6 +646,8 @@ export {
   connectStartResponseSchema,
   controlRecordSchema,
   conversationContinuationCapability,
+  delegationSchema,
+  delegationTokenPrefix,
   grantSchema,
   harnessReadinessSchema,
   harnessSchema,
@@ -585,6 +665,13 @@ export {
   repositoryRefSchema,
   repositorySourceSchema,
   repositoryWorkingDirectorySchema,
+  runArtifactMaxBytes,
+  runArtifactNameSchema,
+  runCloseReasonSchema,
+  runDelegationCapability,
+  runKeySchema,
+  runParentIntentSchema,
+  runParentSchema,
   runSpecSchema,
   runViewSchema,
   runnerAdoptRequestSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drisp/protocol",
-  "version": "0.6.2",
+  "version": "0.8.1",
   "description": "Wire contract between a drisp runner and the hub: zod schemas, inferred types, and JSON Schema for the instance-socket frames, Run, Turn, Interruption, and the event stream",
   "repository": {
     "type": "git",

package/schema/v2/checkpoint.json

@@ -332,6 +332,31 @@
             "checksum"
           ],
           "additionalProperties": false
+        },
+        "delegationToken": {
+          "type": "string",
+          "minLength": 32,
+          "maxLength": 256
+        },
+        "parent": {
+          "type": "object",
+          "properties": {
+            "runId": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 160
+            },
+            "tokenCap": {
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": [
+            "runId",
+            "tokenCap"
+          ],
+          "additionalProperties": false
         }
       },
       "required": [

package/schema/v2/client.json

@@ -293,6 +293,50 @@
                         "harness"
                       ],
                       "additionalProperties": false
+                    },
+                    "key": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 160
+                    },
+                    "delegation": {
+                      "type": "object",
+                      "properties": {
+                        "maxChildren": {
+                          "type": "integer",
+                          "minimum": 1,
+                          "maximum": 8
+                        },
+                        "tokenBudget": {
+                          "type": "integer",
+                          "exclusiveMinimum": 0,
+                          "maximum": 9007199254740991
+                        }
+                      },
+                      "required": [
+                        "maxChildren",
+                        "tokenBudget"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "parent": {
+                      "type": "object",
+                      "properties": {
+                        "runId": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 160
+                        },
+                        "tokenCap": {
+                          "type": "integer",
+                          "exclusiveMinimum": 0,
+                          "maximum": 9007199254740991
+                        }
+                      },
+                      "required": [
+                        "runId"
+                      ],
+                      "additionalProperties": false
                     }
                   },
                   "required": [

package/schema/v2/command.json

@@ -230,6 +230,50 @@
                 "harness"
               ],
               "additionalProperties": false
+            },
+            "key": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 160
+            },
+            "delegation": {
+              "type": "object",
+              "properties": {
+                "maxChildren": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 8
+                },
+                "tokenBudget": {
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "maximum": 9007199254740991
+                }
+              },
+              "required": [
+                "maxChildren",
+                "tokenBudget"
+              ],
+              "additionalProperties": false
+            },
+            "parent": {
+              "type": "object",
+              "properties": {
+                "runId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 160
+                },
+                "tokenCap": {
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "maximum": 9007199254740991
+                }
+              },
+              "required": [
+                "runId"
+              ],
+              "additionalProperties": false
             }
           },
           "required": [

package/schema/v2/grant.json

@@ -283,6 +283,31 @@
         "checksum"
       ],
       "additionalProperties": false
+    },
+    "delegationToken": {
+      "type": "string",
+      "minLength": 32,
+      "maxLength": 256
+    },
+    "parent": {
+      "type": "object",
+      "properties": {
+        "runId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 160
+        },
+        "tokenCap": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991
+        }
+      },
+      "required": [
+        "runId",
+        "tokenCap"
+      ],
+      "additionalProperties": false
     }
   },
   "required": [

package/schema/v2/run.json

@@ -67,6 +67,51 @@
       "type": "string",
       "maxLength": 160
     },
+    "key": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 160
+    },
+    "parent": {
+      "type": "object",
+      "properties": {
+        "runId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 160
+        },
+        "tokenCap": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991
+        }
+      },
+      "required": [
+        "runId",
+        "tokenCap"
+      ],
+      "additionalProperties": false
+    },
+    "delegation": {
+      "type": "object",
+      "properties": {
+        "maxChildren": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 8
+        },
+        "tokenBudget": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991
+        }
+      },
+      "required": [
+        "maxChildren",
+        "tokenBudget"
+      ],
+      "additionalProperties": false
+    },
     "workflow": {
       "type": "object",
       "properties": {
@@ -147,7 +192,8 @@
                     "permission",
                     "question",
                     "guidance",
-                    "recovery"
+                    "recovery",
+                    "waiting"
                   ]
                 },
                 "message": {
@@ -410,6 +456,50 @@
                 "harness"
               ],
               "additionalProperties": false
+            },
+            "key": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 160
+            },
+            "delegation": {
+              "type": "object",
+              "properties": {
+                "maxChildren": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 8
+                },
+                "tokenBudget": {
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "maximum": 9007199254740991
+                }
+              },
+              "required": [
+                "maxChildren",
+                "tokenBudget"
+              ],
+              "additionalProperties": false
+            },
+            "parent": {
+              "type": "object",
+              "properties": {
+                "runId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 160
+                },
+                "tokenCap": {
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "maximum": 9007199254740991
+                }
+              },
+              "required": [
+                "runId"
+              ],
+              "additionalProperties": false
             }
           },
           "required": [

package/schema/v2/runner.json

@@ -614,7 +614,8 @@
                           "permission",
                           "question",
                           "guidance",
-                          "recovery"
+                          "recovery",
+                          "waiting"
                         ]
                       },
                       "message": {
@@ -777,6 +778,15 @@
                   "workspaceUnavailable": {
                     "type": "boolean",
                     "const": true
+                  },
+                  "reason": {
+                    "type": "string",
+                    "enum": [
+                      "workflow_template_mismatch",
+                      "child_project_dir_invalid",
+                      "build_not_approved",
+                      "approval_question_missing"
+                    ]
                   }
                 },
                 "required": [