@kitman-sh/sdk 0.7.2 → 0.7.4

package/types/packages/core/src/work-unit.d.ts

@@ -0,0 +1,740 @@
+import * as Schema from 'effect/Schema';
+/** A read projection used for pending WorkUnits, where no active lease exists yet. */
+export declare const WorkUnitLeaseProjection: Schema.Struct<{
+    readonly leaseOwnerId: Schema.optionalKey<Schema.String>;
+    readonly runnerReplicaId: Schema.optionalKey<Schema.String>;
+    readonly leaseId: Schema.optionalKey<Schema.String>;
+    readonly attempt: Schema.optionalKey<Schema.Int>;
+    readonly fencingToken: Schema.optionalKey<Schema.String>;
+    readonly capacitySlot: Schema.optionalKey<Schema.String>;
+    readonly leaseExpiresAt: Schema.optionalKey<Schema.String>;
+    readonly lastHeartbeatAt: Schema.optionalKey<Schema.String>;
+}>;
+/** Frozen repository metadata required for local materialization; credential references stay server-side. */
+export declare const WorkUnitRepoBinding: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly provider: Schema.Union<readonly [Schema.Literal<"github">, Schema.Literal<"gitlab">, Schema.Literal<"generic_git">]>;
+    readonly host: Schema.String;
+    readonly owner: Schema.String;
+    readonly name: Schema.String;
+    readonly repositoryUrl: Schema.optionalKey<Schema.String>;
+    readonly pathPrefix: Schema.optionalKey<Schema.String>;
+    readonly defaultTargetBranch: Schema.String;
+    readonly expectedBranch: Schema.optionalKey<Schema.String>;
+    readonly expectedCommitSha: Schema.optionalKey<Schema.String>;
+}>;
+/** The complete tuple callers must present for a claim-owned mutation. */
+export declare const WorkUnitLeaseInput: Schema.Struct<{
+    readonly leaseOwnerId: Schema.String;
+    readonly runnerReplicaId: Schema.String;
+    readonly leaseId: Schema.String;
+    readonly attempt: Schema.Int;
+    readonly fencingToken: Schema.String;
+    readonly capacitySlot: Schema.String;
+}>;
+export declare const LoopCheckout: Schema.Union<readonly [Schema.Literal<"none">, Schema.Literal<"read">, Schema.Literal<"write">]>;
+/** A program's agent Step: one StepAttempt, which any eligible Runner may run from the Step's base revision. */
+export declare const AgentStepWorkUnit: Schema.Struct<{
+    readonly kind: Schema.Literal<"agent_step">;
+    readonly id: Schema.String;
+    readonly projectId: Schema.optionalKey<Schema.String>;
+    readonly runId: Schema.String;
+    readonly stepKey: Schema.String;
+    readonly attempt: Schema.Int;
+    readonly lease: Schema.Struct<{
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+        readonly leaseExpiresAt: Schema.String;
+        readonly lastHeartbeatAt: Schema.String;
+    }>;
+    readonly brief: Schema.Struct<{
+        readonly stepAttemptId: Schema.String;
+        readonly harness: Schema.String;
+        readonly model: Schema.optionalKey<Schema.String>;
+        readonly effort: Schema.optionalKey<Schema.Literals<readonly ["low", "medium", "high", "xhigh"]>>;
+        readonly prompt: Schema.String;
+        readonly contextPack: Schema.optionalKey<Schema.Struct<{
+            readonly contextPackId: Schema.optionalKey<Schema.String>;
+            readonly mode: Schema.String;
+            readonly contentMarkdown: Schema.String;
+        }>>;
+        readonly outputSchema: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+        readonly skills: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+            readonly name: Schema.String;
+            readonly files: Schema.$Record<Schema.String, Schema.String>;
+        }>>>;
+        readonly toolless: Schema.optionalKey<Schema.Literal<true>>;
+    }>;
+    readonly stepCredential: Schema.String;
+    readonly checkout: Schema.Union<readonly [Schema.Literal<"none">, Schema.Literal<"read">, Schema.Literal<"write">]>;
+    readonly repoBinding: Schema.optionalKey<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly provider: Schema.Union<readonly [Schema.Literal<"github">, Schema.Literal<"gitlab">, Schema.Literal<"generic_git">]>;
+        readonly host: Schema.String;
+        readonly owner: Schema.String;
+        readonly name: Schema.String;
+        readonly repositoryUrl: Schema.optionalKey<Schema.String>;
+        readonly pathPrefix: Schema.optionalKey<Schema.String>;
+        readonly defaultTargetBranch: Schema.String;
+        readonly expectedBranch: Schema.optionalKey<Schema.String>;
+        readonly expectedCommitSha: Schema.optionalKey<Schema.String>;
+    }>>;
+    /** The Run's TaskBranch; a write checkout pushes to it. */
+    readonly branch: Schema.optionalKey<Schema.String>;
+    /** Where the checkout starts; absent means the branch's base. */
+    readonly baseRevision: Schema.optionalKey<Schema.String>;
+    /** The Agent's own network; the Runner adds the defaults. */
+    readonly network: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+        readonly hosts: Schema.$Array<Schema.String>;
+    }>, Schema.Literal<"open">]>>;
+    /** The SandboxBackend the Agent requires. */
+    readonly sandbox: Schema.optionalKey<Schema.Literal<"docker">>;
+    /** The values of the Secrets the Step names, for its sandbox's environment. */
+    readonly secrets: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+    /** Where the Run's first Step started; a boundary's change is the Run's whole change from there. */
+    readonly runBaseRevision: Schema.optionalKey<Schema.String>;
+}>;
+/** Encoded Exits by Activity `name/attempt` and by deferred name. */
+export declare const RunJournal: Schema.Struct<{
+    readonly activities: Schema.$Record<Schema.String, Schema.Unknown>;
+    readonly deferreds: Schema.$Record<Schema.String, Schema.Unknown>;
+}>;
+/** A Run's program to run or replay; it carries the whole journal so replay reads nothing remotely. */
+export declare const OrchestrationWorkUnit: Schema.Struct<{
+    readonly kind: Schema.Literal<"orchestration">;
+    readonly id: Schema.String;
+    readonly projectId: Schema.optionalKey<Schema.String>;
+    readonly runId: Schema.String;
+    readonly loopDigest: Schema.String;
+    readonly input: Schema.Unknown;
+    /** The capabilities the Run was granted; the program fails a Step that needs another. */
+    readonly granted: Schema.$Array<Schema.String>;
+    readonly lease: Schema.Struct<{
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+        readonly leaseExpiresAt: Schema.String;
+        readonly lastHeartbeatAt: Schema.String;
+    }>;
+    readonly journal: Schema.Struct<{
+        readonly activities: Schema.$Record<Schema.String, Schema.Unknown>;
+        readonly deferreds: Schema.$Record<Schema.String, Schema.Unknown>;
+    }>;
+    /** The hosts the Loop declares besides Kitman, or `open`. */
+    readonly network: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+        readonly hosts: Schema.$Array<Schema.String>;
+    }>, Schema.Literal<"open">]>>;
+    /** The Runner spawns the Run's bundle with this Loop id and credential. */
+    readonly program: Schema.Struct<{
+        readonly loopId: Schema.String;
+        readonly credential: Schema.String;
+    }>;
+}>;
+/** What a Package's process reads on stdin; its Loop id and credential come in its environment instead. */
+export declare const ProgramWorkUnit: Schema.Struct<{
+    readonly kind: Schema.Literal<"orchestration">;
+    readonly id: Schema.String;
+    readonly projectId: Schema.optionalKey<Schema.String>;
+    readonly runId: Schema.String;
+    readonly loopDigest: Schema.String;
+    readonly input: Schema.Unknown;
+    readonly granted: Schema.$Array<Schema.String>;
+    readonly lease: Schema.Struct<{
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+        readonly leaseExpiresAt: Schema.String;
+        readonly lastHeartbeatAt: Schema.String;
+    }>;
+    readonly journal: Schema.Struct<{
+        readonly activities: Schema.$Record<Schema.String, Schema.Unknown>;
+        readonly deferreds: Schema.$Record<Schema.String, Schema.Unknown>;
+    }>;
+    readonly network: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+        readonly hosts: Schema.$Array<Schema.String>;
+    }>, Schema.Literal<"open">]>>;
+}>;
+export type ProgramWorkUnit = (typeof ProgramWorkUnit)['Type'];
+/** An approved verification as Kitman holds it for a RepoBinding; never read from the branch. */
+export declare const ApprovedCheck: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly command: Schema.String;
+    readonly workingDirectory: Schema.optionalKey<Schema.String>;
+}>;
+/** Runs approved checks at a revision with no agent, and at the default branch's head as the baseline. */
+export declare const VerificationWorkUnit: Schema.Struct<{
+    readonly kind: Schema.Literal<"verification">;
+    readonly id: Schema.String;
+    readonly projectId: Schema.String;
+    readonly runId: Schema.String;
+    readonly stepKey: Schema.String;
+    readonly lease: Schema.Struct<{
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+        readonly leaseExpiresAt: Schema.String;
+        readonly lastHeartbeatAt: Schema.String;
+    }>;
+    readonly repoBinding: Schema.Struct<{
+        readonly id: Schema.String;
+        readonly provider: Schema.Union<readonly [Schema.Literal<"github">, Schema.Literal<"gitlab">, Schema.Literal<"generic_git">]>;
+        readonly host: Schema.String;
+        readonly owner: Schema.String;
+        readonly name: Schema.String;
+        readonly repositoryUrl: Schema.optionalKey<Schema.String>;
+        readonly pathPrefix: Schema.optionalKey<Schema.String>;
+        readonly defaultTargetBranch: Schema.String;
+        readonly expectedBranch: Schema.optionalKey<Schema.String>;
+        readonly expectedCommitSha: Schema.optionalKey<Schema.String>;
+    }>;
+    readonly revision: Schema.String;
+    readonly checks: Schema.$Array<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly command: Schema.String;
+        readonly workingDirectory: Schema.optionalKey<Schema.String>;
+    }>>;
+}>;
+export declare const WorkUnit: Schema.Union<readonly [Schema.Struct<{
+    readonly kind: Schema.Literal<"orchestration">;
+    readonly id: Schema.String;
+    readonly projectId: Schema.optionalKey<Schema.String>;
+    readonly runId: Schema.String;
+    readonly loopDigest: Schema.String;
+    readonly input: Schema.Unknown;
+    /** The capabilities the Run was granted; the program fails a Step that needs another. */
+    readonly granted: Schema.$Array<Schema.String>;
+    readonly lease: Schema.Struct<{
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+        readonly leaseExpiresAt: Schema.String;
+        readonly lastHeartbeatAt: Schema.String;
+    }>;
+    readonly journal: Schema.Struct<{
+        readonly activities: Schema.$Record<Schema.String, Schema.Unknown>;
+        readonly deferreds: Schema.$Record<Schema.String, Schema.Unknown>;
+    }>;
+    /** The hosts the Loop declares besides Kitman, or `open`. */
+    readonly network: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+        readonly hosts: Schema.$Array<Schema.String>;
+    }>, Schema.Literal<"open">]>>;
+    /** The Runner spawns the Run's bundle with this Loop id and credential. */
+    readonly program: Schema.Struct<{
+        readonly loopId: Schema.String;
+        readonly credential: Schema.String;
+    }>;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"agent_step">;
+    readonly id: Schema.String;
+    readonly projectId: Schema.optionalKey<Schema.String>;
+    readonly runId: Schema.String;
+    readonly stepKey: Schema.String;
+    readonly attempt: Schema.Int;
+    readonly lease: Schema.Struct<{
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+        readonly leaseExpiresAt: Schema.String;
+        readonly lastHeartbeatAt: Schema.String;
+    }>;
+    readonly brief: Schema.Struct<{
+        readonly stepAttemptId: Schema.String;
+        readonly harness: Schema.String;
+        readonly model: Schema.optionalKey<Schema.String>;
+        readonly effort: Schema.optionalKey<Schema.Literals<readonly ["low", "medium", "high", "xhigh"]>>;
+        readonly prompt: Schema.String;
+        readonly contextPack: Schema.optionalKey<Schema.Struct<{
+            readonly contextPackId: Schema.optionalKey<Schema.String>;
+            readonly mode: Schema.String;
+            readonly contentMarkdown: Schema.String;
+        }>>;
+        readonly outputSchema: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+        readonly skills: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+            readonly name: Schema.String;
+            readonly files: Schema.$Record<Schema.String, Schema.String>;
+        }>>>;
+        readonly toolless: Schema.optionalKey<Schema.Literal<true>>;
+    }>;
+    readonly stepCredential: Schema.String;
+    readonly checkout: Schema.Union<readonly [Schema.Literal<"none">, Schema.Literal<"read">, Schema.Literal<"write">]>;
+    readonly repoBinding: Schema.optionalKey<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly provider: Schema.Union<readonly [Schema.Literal<"github">, Schema.Literal<"gitlab">, Schema.Literal<"generic_git">]>;
+        readonly host: Schema.String;
+        readonly owner: Schema.String;
+        readonly name: Schema.String;
+        readonly repositoryUrl: Schema.optionalKey<Schema.String>;
+        readonly pathPrefix: Schema.optionalKey<Schema.String>;
+        readonly defaultTargetBranch: Schema.String;
+        readonly expectedBranch: Schema.optionalKey<Schema.String>;
+        readonly expectedCommitSha: Schema.optionalKey<Schema.String>;
+    }>>;
+    /** The Run's TaskBranch; a write checkout pushes to it. */
+    readonly branch: Schema.optionalKey<Schema.String>;
+    /** Where the checkout starts; absent means the branch's base. */
+    readonly baseRevision: Schema.optionalKey<Schema.String>;
+    /** The Agent's own network; the Runner adds the defaults. */
+    readonly network: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+        readonly hosts: Schema.$Array<Schema.String>;
+    }>, Schema.Literal<"open">]>>;
+    /** The SandboxBackend the Agent requires. */
+    readonly sandbox: Schema.optionalKey<Schema.Literal<"docker">>;
+    /** The values of the Secrets the Step names, for its sandbox's environment. */
+    readonly secrets: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+    /** Where the Run's first Step started; a boundary's change is the Run's whole change from there. */
+    readonly runBaseRevision: Schema.optionalKey<Schema.String>;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"verification">;
+    readonly id: Schema.String;
+    readonly projectId: Schema.String;
+    readonly runId: Schema.String;
+    readonly stepKey: Schema.String;
+    readonly lease: Schema.Struct<{
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+        readonly leaseExpiresAt: Schema.String;
+        readonly lastHeartbeatAt: Schema.String;
+    }>;
+    readonly repoBinding: Schema.Struct<{
+        readonly id: Schema.String;
+        readonly provider: Schema.Union<readonly [Schema.Literal<"github">, Schema.Literal<"gitlab">, Schema.Literal<"generic_git">]>;
+        readonly host: Schema.String;
+        readonly owner: Schema.String;
+        readonly name: Schema.String;
+        readonly repositoryUrl: Schema.optionalKey<Schema.String>;
+        readonly pathPrefix: Schema.optionalKey<Schema.String>;
+        readonly defaultTargetBranch: Schema.String;
+        readonly expectedBranch: Schema.optionalKey<Schema.String>;
+        readonly expectedCommitSha: Schema.optionalKey<Schema.String>;
+    }>;
+    readonly revision: Schema.String;
+    readonly checks: Schema.$Array<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly command: Schema.String;
+        readonly workingDirectory: Schema.optionalKey<Schema.String>;
+    }>>;
+}>]>;
+export declare const WorkUnitClaimResult: Schema.Struct<{
+    readonly workUnit: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Literal<"orchestration">;
+        readonly id: Schema.String;
+        readonly projectId: Schema.optionalKey<Schema.String>;
+        readonly runId: Schema.String;
+        readonly loopDigest: Schema.String;
+        readonly input: Schema.Unknown;
+        /** The capabilities the Run was granted; the program fails a Step that needs another. */
+        readonly granted: Schema.$Array<Schema.String>;
+        readonly lease: Schema.Struct<{
+            readonly leaseOwnerId: Schema.String;
+            readonly runnerReplicaId: Schema.String;
+            readonly leaseId: Schema.String;
+            readonly attempt: Schema.Int;
+            readonly fencingToken: Schema.String;
+            readonly capacitySlot: Schema.String;
+            readonly leaseExpiresAt: Schema.String;
+            readonly lastHeartbeatAt: Schema.String;
+        }>;
+        readonly journal: Schema.Struct<{
+            readonly activities: Schema.$Record<Schema.String, Schema.Unknown>;
+            readonly deferreds: Schema.$Record<Schema.String, Schema.Unknown>;
+        }>;
+        /** The hosts the Loop declares besides Kitman, or `open`. */
+        readonly network: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+            readonly hosts: Schema.$Array<Schema.String>;
+        }>, Schema.Literal<"open">]>>;
+        /** The Runner spawns the Run's bundle with this Loop id and credential. */
+        readonly program: Schema.Struct<{
+            readonly loopId: Schema.String;
+            readonly credential: Schema.String;
+        }>;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"agent_step">;
+        readonly id: Schema.String;
+        readonly projectId: Schema.optionalKey<Schema.String>;
+        readonly runId: Schema.String;
+        readonly stepKey: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly lease: Schema.Struct<{
+            readonly leaseOwnerId: Schema.String;
+            readonly runnerReplicaId: Schema.String;
+            readonly leaseId: Schema.String;
+            readonly attempt: Schema.Int;
+            readonly fencingToken: Schema.String;
+            readonly capacitySlot: Schema.String;
+            readonly leaseExpiresAt: Schema.String;
+            readonly lastHeartbeatAt: Schema.String;
+        }>;
+        readonly brief: Schema.Struct<{
+            readonly stepAttemptId: Schema.String;
+            readonly harness: Schema.String;
+            readonly model: Schema.optionalKey<Schema.String>;
+            readonly effort: Schema.optionalKey<Schema.Literals<readonly ["low", "medium", "high", "xhigh"]>>;
+            readonly prompt: Schema.String;
+            readonly contextPack: Schema.optionalKey<Schema.Struct<{
+                readonly contextPackId: Schema.optionalKey<Schema.String>;
+                readonly mode: Schema.String;
+                readonly contentMarkdown: Schema.String;
+            }>>;
+            readonly outputSchema: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+            readonly skills: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+                readonly name: Schema.String;
+                readonly files: Schema.$Record<Schema.String, Schema.String>;
+            }>>>;
+            readonly toolless: Schema.optionalKey<Schema.Literal<true>>;
+        }>;
+        readonly stepCredential: Schema.String;
+        readonly checkout: Schema.Union<readonly [Schema.Literal<"none">, Schema.Literal<"read">, Schema.Literal<"write">]>;
+        readonly repoBinding: Schema.optionalKey<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly provider: Schema.Union<readonly [Schema.Literal<"github">, Schema.Literal<"gitlab">, Schema.Literal<"generic_git">]>;
+            readonly host: Schema.String;
+            readonly owner: Schema.String;
+            readonly name: Schema.String;
+            readonly repositoryUrl: Schema.optionalKey<Schema.String>;
+            readonly pathPrefix: Schema.optionalKey<Schema.String>;
+            readonly defaultTargetBranch: Schema.String;
+            readonly expectedBranch: Schema.optionalKey<Schema.String>;
+            readonly expectedCommitSha: Schema.optionalKey<Schema.String>;
+        }>>;
+        /** The Run's TaskBranch; a write checkout pushes to it. */
+        readonly branch: Schema.optionalKey<Schema.String>;
+        /** Where the checkout starts; absent means the branch's base. */
+        readonly baseRevision: Schema.optionalKey<Schema.String>;
+        /** The Agent's own network; the Runner adds the defaults. */
+        readonly network: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+            readonly hosts: Schema.$Array<Schema.String>;
+        }>, Schema.Literal<"open">]>>;
+        /** The SandboxBackend the Agent requires. */
+        readonly sandbox: Schema.optionalKey<Schema.Literal<"docker">>;
+        /** The values of the Secrets the Step names, for its sandbox's environment. */
+        readonly secrets: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+        /** Where the Run's first Step started; a boundary's change is the Run's whole change from there. */
+        readonly runBaseRevision: Schema.optionalKey<Schema.String>;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"verification">;
+        readonly id: Schema.String;
+        readonly projectId: Schema.String;
+        readonly runId: Schema.String;
+        readonly stepKey: Schema.String;
+        readonly lease: Schema.Struct<{
+            readonly leaseOwnerId: Schema.String;
+            readonly runnerReplicaId: Schema.String;
+            readonly leaseId: Schema.String;
+            readonly attempt: Schema.Int;
+            readonly fencingToken: Schema.String;
+            readonly capacitySlot: Schema.String;
+            readonly leaseExpiresAt: Schema.String;
+            readonly lastHeartbeatAt: Schema.String;
+        }>;
+        readonly repoBinding: Schema.Struct<{
+            readonly id: Schema.String;
+            readonly provider: Schema.Union<readonly [Schema.Literal<"github">, Schema.Literal<"gitlab">, Schema.Literal<"generic_git">]>;
+            readonly host: Schema.String;
+            readonly owner: Schema.String;
+            readonly name: Schema.String;
+            readonly repositoryUrl: Schema.optionalKey<Schema.String>;
+            readonly pathPrefix: Schema.optionalKey<Schema.String>;
+            readonly defaultTargetBranch: Schema.String;
+            readonly expectedBranch: Schema.optionalKey<Schema.String>;
+            readonly expectedCommitSha: Schema.optionalKey<Schema.String>;
+        }>;
+        readonly revision: Schema.String;
+        readonly checks: Schema.$Array<Schema.Struct<{
+            readonly name: Schema.String;
+            readonly command: Schema.String;
+            readonly workingDirectory: Schema.optionalKey<Schema.String>;
+        }>>;
+    }>]>>;
+}>;
+/** Runner-supplied lease identity for an immediate claim. */
+export declare const WorkUnitClaimInput: Schema.Struct<{
+    /** Optional only for the Runner control plane; it selects eligible work server-side. */
+    readonly projectId: Schema.optionalKey<Schema.String>;
+    readonly runnerReplicaId: Schema.String;
+    readonly capacitySlot: Schema.String;
+    readonly idempotencyKey: Schema.String;
+    readonly leaseDurationSeconds: Schema.optionalKey<Schema.Int>;
+}>;
+/** Canonical lease-renewal payload for any externally executed Work Unit. */
+export declare const WorkUnitHeartbeatInput: Schema.Struct<{
+    readonly workUnitId: Schema.String;
+    readonly lease: Schema.Struct<{
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+    readonly leaseDurationSeconds: Schema.optionalKey<Schema.Int>;
+}>;
+/** `settled` means the control plane already recorded this Work Unit's outcome; the Runner stops and reports nothing. */
+export declare const WorkUnitHeartbeatResult: Schema.Struct<{
+    readonly settled: Schema.Boolean;
+    /** An agent Step's Output was accepted; the Runner pushes its work and completes the Step. */
+    readonly outputSubmitted: Schema.optionalKey<Schema.Boolean>;
+}>;
+/** Releases an uncompleted WorkUnit after verifying the complete lease tuple. */
+export declare const WorkUnitReleaseInput: Schema.Struct<{
+    readonly workUnitId: Schema.String;
+    readonly lease: Schema.Struct<{
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+}>;
+/** One check's run at a tree: what an EvidenceRef records. */
+export declare const CheckEvidence: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly command: Schema.String;
+    readonly status: Schema.Union<readonly [Schema.Literal<"passed">, Schema.Literal<"failed">]>;
+    readonly exitCode: Schema.optionalKey<Schema.Int>;
+    readonly durationMs: Schema.Int;
+    /** The end of the output, with credentials redacted. */
+    readonly outputTail: Schema.String;
+}>;
+/** Checks run at one revision; `tree` is the revision's git tree id. Checks the tree already had are left out. */
+export declare const TreeEvidence: Schema.Struct<{
+    readonly revision: Schema.String;
+    readonly tree: Schema.String;
+    readonly checks: Schema.$Array<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly command: Schema.String;
+        readonly status: Schema.Union<readonly [Schema.Literal<"passed">, Schema.Literal<"failed">]>;
+        readonly exitCode: Schema.optionalKey<Schema.Int>;
+        readonly durationMs: Schema.Int;
+        /** The end of the output, with credentials redacted. */
+        readonly outputTail: Schema.String;
+    }>>;
+}>;
+export declare const VerificationEvidence: Schema.Struct<{
+    readonly head: Schema.Struct<{
+        readonly revision: Schema.String;
+        readonly tree: Schema.String;
+        readonly checks: Schema.$Array<Schema.Struct<{
+            readonly name: Schema.String;
+            readonly command: Schema.String;
+            readonly status: Schema.Union<readonly [Schema.Literal<"passed">, Schema.Literal<"failed">]>;
+            readonly exitCode: Schema.optionalKey<Schema.Int>;
+            readonly durationMs: Schema.Int;
+            /** The end of the output, with credentials redacted. */
+            readonly outputTail: Schema.String;
+        }>>;
+    }>;
+    readonly baseline: Schema.optionalKey<Schema.Struct<{
+        readonly revision: Schema.String;
+        readonly tree: Schema.String;
+        readonly checks: Schema.$Array<Schema.Struct<{
+            readonly name: Schema.String;
+            readonly command: Schema.String;
+            readonly status: Schema.Union<readonly [Schema.Literal<"passed">, Schema.Literal<"failed">]>;
+            readonly exitCode: Schema.optionalKey<Schema.Int>;
+            readonly durationMs: Schema.Int;
+            /** The end of the output, with credentials redacted. */
+            readonly outputTail: Schema.String;
+        }>>;
+    }>>;
+}>;
+/** A write checkout's change since the Run began, bounded and redacted by the Runner; Kitman bounds it again. */
+export declare const BoundaryChange: Schema.Struct<{
+    readonly kind: Schema.Literal<"change">;
+    readonly changedPaths: Schema.$Array<Schema.String>;
+    readonly omittedPaths: Schema.Int;
+    readonly files: Schema.$Array<Schema.Struct<{
+        readonly path: Schema.String;
+        readonly excerpt: Schema.String;
+        readonly redacted: Schema.Boolean;
+        readonly truncated: Schema.Boolean;
+    }>>;
+    readonly truncated: Schema.Boolean;
+}>;
+export type BoundaryChange = (typeof BoundaryChange)['Type'];
+export declare const WorkUnitOutcome: Schema.Struct<{
+    readonly status: Schema.Union<readonly [Schema.Literal<"completed">, Schema.Literal<"failed">, Schema.Literal<"blocked">, Schema.Literal<"canceled">]>;
+    readonly result: 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<import("./loop").LoopStepOutputDataValue, import("./loop").LoopStepOutputDataValue, never, never>>;
+        readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<import("./loop").LoopStepOutputDataValue, import("./loop").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>;
+        }>>;
+    }>>;
+    /** What an agent Step's write checkout pushed to the Run's branch. */
+    readonly revision: Schema.optionalKey<Schema.String>;
+    /** What a verification ran. */
+    readonly evidence: Schema.optionalKey<Schema.Struct<{
+        readonly head: Schema.Struct<{
+            readonly revision: Schema.String;
+            readonly tree: Schema.String;
+            readonly checks: Schema.$Array<Schema.Struct<{
+                readonly name: Schema.String;
+                readonly command: Schema.String;
+                readonly status: Schema.Union<readonly [Schema.Literal<"passed">, Schema.Literal<"failed">]>;
+                readonly exitCode: Schema.optionalKey<Schema.Int>;
+                readonly durationMs: Schema.Int;
+                /** The end of the output, with credentials redacted. */
+                readonly outputTail: Schema.String;
+            }>>;
+        }>;
+        readonly baseline: Schema.optionalKey<Schema.Struct<{
+            readonly revision: Schema.String;
+            readonly tree: Schema.String;
+            readonly checks: Schema.$Array<Schema.Struct<{
+                readonly name: Schema.String;
+                readonly command: Schema.String;
+                readonly status: Schema.Union<readonly [Schema.Literal<"passed">, Schema.Literal<"failed">]>;
+                readonly exitCode: Schema.optionalKey<Schema.Int>;
+                readonly durationMs: Schema.Int;
+                /** The end of the output, with credentials redacted. */
+                readonly outputTail: Schema.String;
+            }>>;
+        }>>;
+    }>>;
+    readonly boundary: Schema.optionalKey<Schema.Struct<{
+        readonly kind: Schema.Literal<"change">;
+        readonly changedPaths: Schema.$Array<Schema.String>;
+        readonly omittedPaths: Schema.Int;
+        readonly files: Schema.$Array<Schema.Struct<{
+            readonly path: Schema.String;
+            readonly excerpt: Schema.String;
+            readonly redacted: Schema.Boolean;
+            readonly truncated: Schema.Boolean;
+        }>>;
+        readonly truncated: Schema.Boolean;
+    }>>;
+    readonly failureSummary: Schema.optionalKey<Schema.String>;
+}>;
+export declare const WorkUnitCompletion: Schema.Struct<{
+    readonly workUnitId: Schema.String;
+    readonly lease: Schema.Struct<{
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+    readonly idempotencyKey: Schema.String;
+    readonly outcome: Schema.Struct<{
+        readonly status: Schema.Union<readonly [Schema.Literal<"completed">, Schema.Literal<"failed">, Schema.Literal<"blocked">, Schema.Literal<"canceled">]>;
+        readonly result: 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<import("./loop").LoopStepOutputDataValue, import("./loop").LoopStepOutputDataValue, never, never>>;
+            readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<import("./loop").LoopStepOutputDataValue, import("./loop").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>;
+            }>>;
+        }>>;
+        /** What an agent Step's write checkout pushed to the Run's branch. */
+        readonly revision: Schema.optionalKey<Schema.String>;
+        /** What a verification ran. */
+        readonly evidence: Schema.optionalKey<Schema.Struct<{
+            readonly head: Schema.Struct<{
+                readonly revision: Schema.String;
+                readonly tree: Schema.String;
+                readonly checks: Schema.$Array<Schema.Struct<{
+                    readonly name: Schema.String;
+                    readonly command: Schema.String;
+                    readonly status: Schema.Union<readonly [Schema.Literal<"passed">, Schema.Literal<"failed">]>;
+                    readonly exitCode: Schema.optionalKey<Schema.Int>;
+                    readonly durationMs: Schema.Int;
+                    /** The end of the output, with credentials redacted. */
+                    readonly outputTail: Schema.String;
+                }>>;
+            }>;
+            readonly baseline: Schema.optionalKey<Schema.Struct<{
+                readonly revision: Schema.String;
+                readonly tree: Schema.String;
+                readonly checks: Schema.$Array<Schema.Struct<{
+                    readonly name: Schema.String;
+                    readonly command: Schema.String;
+                    readonly status: Schema.Union<readonly [Schema.Literal<"passed">, Schema.Literal<"failed">]>;
+                    readonly exitCode: Schema.optionalKey<Schema.Int>;
+                    readonly durationMs: Schema.Int;
+                    /** The end of the output, with credentials redacted. */
+                    readonly outputTail: Schema.String;
+                }>>;
+            }>>;
+        }>>;
+        readonly boundary: Schema.optionalKey<Schema.Struct<{
+            readonly kind: Schema.Literal<"change">;
+            readonly changedPaths: Schema.$Array<Schema.String>;
+            readonly omittedPaths: Schema.Int;
+            readonly files: Schema.$Array<Schema.Struct<{
+                readonly path: Schema.String;
+                readonly excerpt: Schema.String;
+                readonly redacted: Schema.Boolean;
+                readonly truncated: Schema.Boolean;
+            }>>;
+            readonly truncated: Schema.Boolean;
+        }>>;
+        readonly failureSummary: Schema.optionalKey<Schema.String>;
+    }>;
+}>;
+export type WorkUnitLeaseProjection = (typeof WorkUnitLeaseProjection)['Type'];
+export type WorkUnitLeaseInput = (typeof WorkUnitLeaseInput)['Type'];
+export type WorkUnit = (typeof WorkUnit)['Type'];
+export type OrchestrationWorkUnit = (typeof OrchestrationWorkUnit)['Type'];
+export type AgentStepWorkUnit = (typeof AgentStepWorkUnit)['Type'];
+export type ApprovedCheck = (typeof ApprovedCheck)['Type'];
+export type VerificationWorkUnit = (typeof VerificationWorkUnit)['Type'];
+export type CheckEvidence = (typeof CheckEvidence)['Type'];
+export type TreeEvidence = (typeof TreeEvidence)['Type'];
+export type VerificationEvidence = (typeof VerificationEvidence)['Type'];
+export type LoopCheckout = (typeof LoopCheckout)['Type'];
+export type RunJournal = (typeof RunJournal)['Type'];
+export type WorkUnitClaimResult = (typeof WorkUnitClaimResult)['Type'];
+export type WorkUnitClaimInput = (typeof WorkUnitClaimInput)['Type'];
+export type WorkUnitHeartbeatInput = (typeof WorkUnitHeartbeatInput)['Type'];
+export type WorkUnitHeartbeatResult = (typeof WorkUnitHeartbeatResult)['Type'];
+export type WorkUnitReleaseInput = (typeof WorkUnitReleaseInput)['Type'];
+export type WorkUnitOutcome = (typeof WorkUnitOutcome)['Type'];
+export type WorkUnitCompletion = (typeof WorkUnitCompletion)['Type'];