@kitman-sh/sdk 0.0.0-stage → 0.7.0

package/types/packages/live/src/rpc/runner-group.d.ts

@@ -0,0 +1,733 @@
+import * as Schema from 'effect/Schema';
+import { Rpc, RpcGroup, RpcMiddleware } from 'effect/rpc';
+/** The Runner a connection acts for and the protocol version it speaks; the bearer travels as `authorization`. */
+export declare const RunnerHeaders: {
+    readonly runnerId: 'x-kitman-runner-id';
+    readonly protocolVersion: 'x-kitman-rpc-protocol';
+};
+/** The Runner RPC protocol version this client speaks; a bundle records the version it was built with. */
+export declare const RunnerRpcProtocolVersion = 1;
+declare const RunnerRpcError_base: Schema.Class<RunnerRpcError, Schema.TaggedStruct<"RunnerRpcError", {
+    readonly code: Schema.String;
+    readonly message: Schema.String;
+    readonly status: Schema.Finite;
+}>, import("effect/Cause").YieldableError>;
+/** A refused Runner call, with the HTTP status the same call would have returned. */
+export declare class RunnerRpcError extends RunnerRpcError_base {
+}
+declare const RunnerAuthentication_base: RpcMiddleware.ServiceClass<RunnerAuthentication, "RunnerAuthentication", never, typeof RunnerRpcError, never, never, false>;
+export declare class RunnerAuthentication extends RunnerAuthentication_base {
+}
+/** Work may be claimable: a hint, since the claim stays authoritative. */
+export declare const WorkAvailable: Schema.TaggedStruct<"WorkAvailable", {}>;
+/** The replica no longer holds this Work Unit's lease; stop it and report nothing. */
+export declare const LeaseRevoked: Schema.TaggedStruct<"LeaseRevoked", {
+    readonly workUnitId: Schema.String;
+}>;
+/** The Work Unit's outcome is already recorded; stop it and report nothing. */
+export declare const Settled: Schema.TaggedStruct<"Settled", {
+    readonly workUnitId: Schema.String;
+}>;
+/** A cancellation was accepted for this Work Unit; stop it and report it canceled. */
+export declare const Canceled: Schema.TaggedStruct<"Canceled", {
+    readonly workUnitId: Schema.String;
+}>;
+/** The Run settled; drop its checkouts. */
+export declare const RunSettled: Schema.TaggedStruct<"RunSettled", {
+    readonly runId: Schema.String;
+}>;
+/** A person's note for the live agent Session of this StepAttempt; report it with ReportSteer. */
+export declare const Steer: Schema.TaggedStruct<"Steer", {
+    readonly workUnitId: Schema.String;
+    readonly messageId: Schema.String;
+    readonly text: Schema.String;
+}>;
+/** The agent of this StepAttempt recorded a SessionUpdate: a moment to checkpoint. */
+export declare const SessionUpdated: Schema.TaggedStruct<"SessionUpdated", {
+    readonly workUnitId: Schema.String;
+}>;
+/** What the control plane pushes to a replica through its Signals stream. */
+export declare const RunnerSignal: Schema.Union<readonly [Schema.TaggedStruct<"WorkAvailable", {}>, Schema.TaggedStruct<"LeaseRevoked", {
+    readonly workUnitId: Schema.String;
+}>, Schema.TaggedStruct<"Settled", {
+    readonly workUnitId: Schema.String;
+}>, Schema.TaggedStruct<"Canceled", {
+    readonly workUnitId: Schema.String;
+}>, Schema.TaggedStruct<"RunSettled", {
+    readonly runId: Schema.String;
+}>, Schema.TaggedStruct<"Steer", {
+    readonly workUnitId: Schema.String;
+    readonly messageId: Schema.String;
+    readonly text: Schema.String;
+}>, Schema.TaggedStruct<"SessionUpdated", {
+    readonly workUnitId: Schema.String;
+}>]>;
+export type RunnerSignal = typeof RunnerSignal.Type;
+/** The orchestration lease every journal write presents; a write under a lease that was fenced out is refused. */
+export declare const ProgramLease: Schema.Struct<{
+    readonly workUnitId: Schema.String;
+    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 type ProgramLease = typeof ProgramLease.Type;
+/** A Harness session file, as it sits in the Harness's session location. */
+export declare const CheckpointSession: Schema.Struct<{
+    readonly harness: Schema.String;
+    readonly id: Schema.String;
+    readonly name: Schema.String;
+    /** Gzipped. */
+    readonly content: Schema.Uint8ArrayFromBase64;
+}>;
+/** An agent StepAttempt's workspace on a hidden ref of the code host, and its Harness session. */
+export declare const StepCheckpoint: Schema.Struct<{
+    readonly ref: Schema.optionalKey<Schema.String>;
+    readonly revision: Schema.optionalKey<Schema.String>;
+    readonly session: Schema.optionalKey<Schema.Struct<{
+        readonly harness: Schema.String;
+        readonly id: Schema.String;
+        readonly name: Schema.String;
+        /** Gzipped. */
+        readonly content: Schema.Uint8ArrayFromBase64;
+    }>>;
+}>;
+export declare const SuggestedVerification: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly command: Schema.String;
+    readonly workingDirectory: Schema.optional<Schema.String>;
+}>;
+export declare const ProgramOutcome: Schema.Union<readonly [Schema.Struct<{
+    readonly status: Schema.Literal<"completed">;
+    readonly output: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>, Schema.Struct<{
+    readonly status: Schema.Literal<"failed">;
+    readonly failureSummary: Schema.String;
+}>]>;
+declare const RunnerRpcs_base: RpcGroup.RpcGroup<Rpc.Rpc<"SettledRuns", Schema.Struct<{
+    runIds: Schema.$Array<Schema.String>;
+}>, Schema.$Array<Schema.String>, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"KnownEvidence", Schema.Struct<{
+    lease: Schema.Struct<{
+        readonly workUnitId: Schema.String;
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+    trees: Schema.$Array<Schema.String>;
+}>, Schema.$Array<Schema.Struct<{
+    readonly tree: Schema.String;
+    readonly name: Schema.String;
+    readonly command: Schema.String;
+}>>, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"CreatePlanTasks", Schema.Struct<{
+    lease: Schema.Struct<{
+        readonly workUnitId: Schema.String;
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+    tickets: Schema.$Array<Schema.Struct<{
+        readonly key: Schema.String;
+        readonly title: Schema.String;
+        readonly body: Schema.String;
+        readonly acceptanceCriteria: Schema.$Array<Schema.String>;
+        readonly blockedBy: Schema.$Array<Schema.String>;
+        readonly outcome: Schema.optionalKey<Schema.Literals<readonly ["feature", "bug", "refactor", "investigation", "docs", "migration"]>>;
+    }>>;
+}>, Schema.$Array<Schema.Struct<{
+    readonly key: Schema.String;
+    readonly taskId: Schema.String;
+}>>, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"SettledCheckpoints", Schema.Void, Schema.$Array<Schema.Struct<{
+    readonly stepAttemptId: Schema.String;
+    readonly ref: Schema.optionalKey<Schema.String>;
+    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>;
+    }>>;
+}>>, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"ProgramSecrets", Schema.Struct<{
+    lease: Schema.Struct<{
+        readonly workUnitId: Schema.String;
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+}>, Schema.$Record<Schema.String, Schema.String>, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"Signals", Schema.Struct<{
+    runnerReplicaId: Schema.String;
+}>, import("effect/rpc/RpcSchema").Stream<Schema.Union<readonly [Schema.TaggedStruct<"WorkAvailable", {}>, Schema.TaggedStruct<"LeaseRevoked", {
+    readonly workUnitId: Schema.String;
+}>, Schema.TaggedStruct<"Settled", {
+    readonly workUnitId: Schema.String;
+}>, Schema.TaggedStruct<"Canceled", {
+    readonly workUnitId: Schema.String;
+}>, Schema.TaggedStruct<"RunSettled", {
+    readonly runId: Schema.String;
+}>, Schema.TaggedStruct<"Steer", {
+    readonly workUnitId: Schema.String;
+    readonly messageId: Schema.String;
+    readonly text: Schema.String;
+}>, Schema.TaggedStruct<"SessionUpdated", {
+    readonly workUnitId: Schema.String;
+}>]>, typeof RunnerRpcError>, Schema.Never, typeof RunnerAuthentication, never> | Rpc.Rpc<"Claim", Schema.Struct<{
+    readonly projectId: Schema.optionalKey<Schema.String>;
+    readonly runnerReplicaId: Schema.String;
+    readonly capacitySlot: Schema.String;
+    readonly idempotencyKey: Schema.String;
+    readonly leaseDurationSeconds: Schema.optionalKey<Schema.Int>;
+}>, 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;
+        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">]>>;
+        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>;
+        }>>;
+        readonly branch: Schema.optionalKey<Schema.String>;
+        readonly baseRevision: Schema.optionalKey<Schema.String>;
+        readonly network: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+            readonly hosts: Schema.$Array<Schema.String>;
+        }>, Schema.Literal<"open">]>>;
+        readonly sandbox: Schema.optionalKey<Schema.Literal<"docker">>;
+        readonly secrets: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+        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>;
+        }>>;
+    }>]>>;
+}>, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"Heartbeat", 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>;
+}>, Schema.Struct<{
+    readonly settled: Schema.Boolean;
+    readonly outputSubmitted: Schema.optionalKey<Schema.Boolean>;
+}>, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"PutQuestion", Schema.Struct<{
+    lease: Schema.Struct<{
+        readonly workUnitId: Schema.String;
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+    step: Schema.String;
+    prompt: Schema.String;
+    options: Schema.optional<Schema.$Array<Schema.String>>;
+    /** Approving the Question approves this verification for the Run's repository. */
+    verification: Schema.optional<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly command: Schema.String;
+        readonly workingDirectory: Schema.optional<Schema.String>;
+    }>>;
+    deferredName: Schema.String;
+}>, Schema.Struct<{
+    readonly questionId: Schema.String;
+}>, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"StartAgentStep", Schema.Struct<{
+    lease: Schema.Struct<{
+        readonly workUnitId: Schema.String;
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+    step: Schema.String;
+    deferredName: Schema.String;
+    role: Schema.String;
+    agentId: Schema.String;
+    prompt: Schema.String;
+    outputSchema: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    secrets: Schema.optionalKey<Schema.$Array<Schema.String>>;
+}>, Schema.Struct<{
+    readonly stepAttemptId: Schema.String;
+}>, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"StartVerification", Schema.Struct<{
+    lease: Schema.Struct<{
+        readonly workUnitId: Schema.String;
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+    step: Schema.String;
+    deferredName: Schema.String;
+    /** The Run's head when left out. */
+    revision: Schema.optionalKey<Schema.String>;
+    checks: Schema.optional<Schema.$Array<Schema.String>>;
+}>, Schema.Struct<{
+    readonly verificationId: Schema.String;
+}>, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"AdmitChild", Schema.Struct<{
+    lease: Schema.Struct<{
+        readonly workUnitId: Schema.String;
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+    step: Schema.String;
+    loop: Schema.String;
+    input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    deferredName: Schema.String;
+}>, Schema.Struct<{
+    readonly runId: Schema.String;
+}>, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"StoreArtifact", Schema.Struct<{
+    lease: Schema.Struct<{
+        readonly workUnitId: Schema.String;
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+    step: Schema.String;
+    kind: Schema.String;
+    title: Schema.String;
+    text: Schema.String;
+    data: Schema.optional<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+}>, Schema.Struct<{
+    readonly artifactId: Schema.String;
+}>, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"IntegrationBranch", Schema.Struct<{
+    lease: Schema.Struct<{
+        readonly workUnitId: Schema.String;
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+    repoBindingId: Schema.optionalKey<Schema.String>;
+}>, Schema.Struct<{
+    readonly repoBindingId: Schema.String;
+    readonly branch: Schema.String;
+    readonly revision: Schema.String;
+}>, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"PublishRelease", Schema.Struct<{
+    lease: Schema.Struct<{
+        readonly workUnitId: Schema.String;
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+    step: Schema.String;
+    tag: Schema.String;
+    revision: Schema.optionalKey<Schema.String>;
+    title: Schema.String;
+    notes: Schema.String;
+}>, Schema.Struct<{
+    readonly tag: Schema.String;
+    readonly revision: Schema.String;
+    readonly url: Schema.String;
+}>, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"Bundle", Schema.Struct<{
+    digest: Schema.String;
+}>, Schema.Struct<{
+    readonly bundle: Schema.String;
+}>, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"ResumeCheckpoint", Schema.Struct<{
+    lease: Schema.Struct<{
+        readonly workUnitId: Schema.String;
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+}>, Schema.UndefinedOr<Schema.Struct<{
+    readonly ref: Schema.optionalKey<Schema.String>;
+    readonly revision: Schema.optionalKey<Schema.String>;
+    readonly session: Schema.optionalKey<Schema.Struct<{
+        readonly harness: Schema.String;
+        readonly id: Schema.String;
+        readonly name: Schema.String;
+        /** Gzipped. */
+        readonly content: Schema.Uint8ArrayFromBase64;
+    }>>;
+}>>, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"PerformHostEffect", Schema.Struct<{
+    lease: Schema.Struct<{
+        readonly workUnitId: Schema.String;
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+    step: Schema.String;
+    effect: Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Literal<"post_comment">;
+        readonly changeRequestId: Schema.String;
+        readonly body: Schema.String;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"change_request">;
+        readonly title: Schema.String;
+        readonly body: Schema.String;
+        readonly integration: Schema.optionalKey<Schema.String>;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"write_back">;
+        readonly milestone: Schema.optionalKey<Schema.Literals<readonly ["started", "change_request_opened", "merged", "failed"]>>;
+        readonly changeRequestUrl: Schema.optionalKey<Schema.String>;
+    }>]>;
+}>, Schema.UndefinedOr<Schema.Struct<{
+    readonly id: Schema.String;
+    readonly number: Schema.String;
+    readonly url: Schema.String;
+}>>, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"MergeChangeRequest", Schema.Struct<{
+    lease: Schema.Struct<{
+        readonly workUnitId: Schema.String;
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+    step: Schema.String;
+    changeRequestId: Schema.String;
+}>, Schema.Union<readonly [Schema.Struct<{
+    readonly status: Schema.Literal<"merged">;
+    readonly revision: Schema.String;
+}>, Schema.Struct<{
+    readonly status: Schema.Literal<"conflict">;
+}>]>, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"AwaitEvent", Schema.Struct<{
+    lease: Schema.Struct<{
+        readonly workUnitId: Schema.String;
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+    step: Schema.String;
+    deferredName: Schema.String;
+    event: Schema.String;
+    /** Event payload paths and the value, or any of the values, each must hold. */
+    filter: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean, Schema.Null]>, Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean, Schema.Null]>>]>>>;
+    timeoutMillis: Schema.Int;
+}>, Schema.Void, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"Complete", 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("../../../core/src/index").LoopStepOutputDataValue, import("../../../core/src/index").LoopStepOutputDataValue, never, never>>;
+            readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<import("../../../core/src/index").LoopStepOutputDataValue, import("../../../core/src/index").LoopStepOutputDataValue, never, never>>>;
+            readonly refs: Schema.$Array<Schema.Struct<{
+                readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
+                readonly id: Schema.optionalKey<Schema.String>;
+                readonly externalId: Schema.optionalKey<Schema.String>;
+                readonly provider: Schema.optionalKey<Schema.String>;
+                readonly title: Schema.optionalKey<Schema.String>;
+            }>>;
+        }>>;
+        readonly revision: Schema.optionalKey<Schema.String>;
+        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;
+                    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;
+                    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>;
+    }>;
+}>, Schema.Void, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"DeferredDone", Schema.Struct<{
+    lease: Schema.Struct<{
+        readonly workUnitId: Schema.String;
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+    name: Schema.String;
+    exit: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>, Schema.Void, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"FinishProgram", Schema.Struct<{
+    lease: Schema.Struct<{
+        readonly workUnitId: Schema.String;
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+    outcome: Schema.Union<readonly [Schema.Struct<{
+        readonly status: Schema.Literal<"completed">;
+        readonly output: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>, Schema.Struct<{
+        readonly status: Schema.Literal<"failed">;
+        readonly failureSummary: Schema.String;
+    }>]>;
+}>, Schema.Void, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"ForgetCheckpoints", Schema.Struct<{
+    stepAttemptIds: Schema.$Array<Schema.String>;
+}>, Schema.Void, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"RecordActivity", Schema.Struct<{
+    lease: Schema.Struct<{
+        readonly workUnitId: Schema.String;
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+    name: Schema.String;
+    attempt: Schema.Int;
+    exit: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>, Schema.Void, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"RecordNote", Schema.Struct<{
+    lease: Schema.Struct<{
+        readonly workUnitId: Schema.String;
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+    step: Schema.String;
+    text: Schema.String;
+    artifactId: Schema.optional<Schema.String>;
+}>, Schema.Void, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"Release", 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;
+    }>;
+}>, Schema.Void, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"ReportSteer", Schema.Struct<{
+    workUnitId: Schema.String;
+    messageId: Schema.String;
+    delivered: Schema.Boolean;
+}>, Schema.Void, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"SaveCheckpoint", Schema.Struct<{
+    lease: Schema.Struct<{
+        readonly workUnitId: Schema.String;
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+    checkpoint: Schema.Struct<{
+        readonly ref: Schema.optionalKey<Schema.String>;
+        readonly revision: Schema.optionalKey<Schema.String>;
+        readonly session: Schema.optionalKey<Schema.Struct<{
+            readonly harness: Schema.String;
+            readonly id: Schema.String;
+            readonly name: Schema.String;
+            /** Gzipped. */
+            readonly content: Schema.Uint8ArrayFromBase64;
+        }>>;
+    }>;
+}>, Schema.Void, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"ScheduleClock", Schema.Struct<{
+    lease: Schema.Struct<{
+        readonly workUnitId: Schema.String;
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+    name: Schema.String;
+    deferredName: Schema.String;
+    durationMillis: Schema.Int;
+}>, Schema.Void, typeof RunnerRpcError, typeof RunnerAuthentication, never> | Rpc.Rpc<"Suspend", Schema.Struct<{
+    lease: Schema.Struct<{
+        readonly workUnitId: Schema.String;
+        readonly leaseOwnerId: Schema.String;
+        readonly runnerReplicaId: Schema.String;
+        readonly leaseId: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly fencingToken: Schema.String;
+        readonly capacitySlot: Schema.String;
+    }>;
+}>, Schema.Void, typeof RunnerRpcError, typeof RunnerAuthentication, never>>;
+/** Runner control: claim, heartbeat, complete and release, the signals a replica listens to, and the journal. */
+export declare class RunnerRpcs extends RunnerRpcs_base {
+}
+export {};