@drisp/protocol 0.6.0 → 0.8.0

package/dist/v2.d.ts

@@ -0,0 +1,1407 @@
+import { z } from 'zod';
+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[];
+
+declare const protocolVersion: {
+    readonly major: 2;
+    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<{
+    kind: z.ZodLiteral<"permission">;
+    decision: z.ZodEnum<{
+        allow: "allow";
+        deny: "deny";
+    }>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+declare const sequence: z.ZodNumber;
+declare const scopeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    visibility: z.ZodLiteral<"organization">;
+}, z.core.$strict>, z.ZodObject<{
+    visibility: z.ZodLiteral<"private">;
+    ownerUserId: z.ZodString;
+}, z.core.$strict>], "visibility">;
+/** Workflows a runner can run; reported on hello and replaced wholesale by `workflows.changed`. */
+declare const installedWorkflowsSchema: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"builtin">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"marketplace-remote">;
+        ref: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"marketplace-local">;
+        repoDir: z.ZodString;
+        workflowName: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"filesystem">;
+        path: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"unknown">;
+    }, z.core.$strip>], "kind">;
+}, z.core.$strip>>;
+/** The coding agents a Run can use. */
+declare const harnessSchema: z.ZodEnum<{
+    "claude-code": "claude-code";
+    codex: "codex";
+}>;
+type Harness = z.infer<typeof harnessSchema>;
+/** Whether one harness can start a Run on a Runner: its CLI is installed, and it is signed in. */
+declare const harnessReadinessSchema: z.ZodObject<{
+    installed: z.ZodBoolean;
+    signedIn: z.ZodBoolean;
+}, z.core.$strict>;
+type HarnessReadiness = z.infer<typeof harnessReadinessSchema>;
+/**
+ * Readiness (root ADR-0005): connected is not ready. A Runner reports each harness it checked, on hello and again
+ * with `readiness.changed`. A harness it does not report, like the whole field from an older runner, is unknown,
+ * never "not ready".
+ */
+declare const runnerReadinessSchema: z.ZodObject<{
+    'claude-code': z.ZodOptional<z.ZodObject<{
+        installed: z.ZodBoolean;
+        signedIn: z.ZodBoolean;
+    }, z.core.$strict>>;
+    codex: z.ZodOptional<z.ZodObject<{
+        installed: z.ZodBoolean;
+        signedIn: z.ZodBoolean;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type RunnerReadiness = z.infer<typeof runnerReadinessSchema>;
+/** The command that closes a harness's Readiness gap on the Runner's machine, or undefined when it is ready. */
+declare function readinessFixCommand(harness: Harness, readiness: HarnessReadiness): string | undefined;
+/** What brings a Runner below the Hub's minimum version up to date. Runner services never update themselves. */
+declare const runnerUpdateCommand = "npm i -g @drisp/cli";
+declare const interruptionSchema: z.ZodObject<{
+    interruptionId: z.ZodString;
+    revision: z.ZodNumber;
+    kind: z.ZodEnum<{
+        permission: "permission";
+        question: "question";
+        guidance: "guidance";
+        recovery: "recovery";
+        waiting: "waiting";
+    }>;
+    message: z.ZodString;
+    requestId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** The Workflow a Run resolved on its runner: the registry name and, when the Workflow declares one, its version. */
+declare const workflowIdentitySchema: z.ZodObject<{
+    name: z.ZodString;
+    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<{
+        name: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"builtin">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"marketplace-remote">;
+            ref: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"marketplace-local">;
+            repoDir: z.ZodString;
+            workflowName: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"filesystem">;
+            path: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"unknown">;
+        }, z.core.$strip>], "kind">;
+    }, z.core.$strip>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"readiness.changed">;
+    readiness: z.ZodObject<{
+        'claude-code': z.ZodOptional<z.ZodObject<{
+            installed: z.ZodBoolean;
+            signedIn: z.ZodBoolean;
+        }, z.core.$strict>>;
+        codex: z.ZodOptional<z.ZodObject<{
+            installed: z.ZodBoolean;
+            signedIn: z.ZodBoolean;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"assignment.accepted">;
+    runId: z.ZodString;
+    attemptId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"assignment.rejected">;
+    runId: z.ZodString;
+    attemptId: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    workflow: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    runId: z.ZodString;
+    attemptId: z.ZodString;
+    executionRevision: z.ZodNumber;
+    emittedAt: z.ZodISODateTime;
+    kind: z.ZodLiteral<"run.started">;
+}, z.core.$strict>, z.ZodObject<{
+    runId: z.ZodString;
+    attemptId: z.ZodString;
+    executionRevision: z.ZodNumber;
+    emittedAt: z.ZodISODateTime;
+    kind: z.ZodLiteral<"run.resumed">;
+}, z.core.$strict>, z.ZodObject<{
+    interruption: z.ZodObject<{
+        interruptionId: z.ZodString;
+        revision: z.ZodNumber;
+        kind: z.ZodEnum<{
+            permission: "permission";
+            question: "question";
+            guidance: "guidance";
+            recovery: "recovery";
+            waiting: "waiting";
+        }>;
+        message: z.ZodString;
+        requestId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    occupancy: z.ZodEnum<{
+        held: "held";
+        released: "released";
+    }>;
+    historyThrough: z.ZodNumber;
+    continuation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"live_request">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"local_checkpoint">;
+        checkpointId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"portable_checkpoint">;
+        checkpointId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"repair_required">;
+        detail: z.ZodString;
+    }, z.core.$strict>], "kind">;
+    runId: z.ZodString;
+    attemptId: z.ZodString;
+    executionRevision: z.ZodNumber;
+    emittedAt: z.ZodISODateTime;
+    kind: z.ZodLiteral<"run.attention">;
+}, z.core.$strict>, z.ZodObject<{
+    status: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        cancelled: "cancelled";
+    }>;
+    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;
+    emittedAt: z.ZodISODateTime;
+    kind: z.ZodLiteral<"run.finished">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"command.applied">;
+    runId: z.ZodString;
+    attemptId: z.ZodString;
+    commandId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"command.rejected">;
+    runId: z.ZodString;
+    attemptId: z.ZodString;
+    commandId: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"revoked_not_started">;
+    runId: z.ZodString;
+    attemptId: z.ZodString;
+}, z.core.$strict>], "kind">;
+/** Git references are data, never command options or shell expressions. */
+declare const repositoryRefSchema: z.ZodString;
+declare const repositoryWorkingDirectorySchema: z.ZodString;
+declare const repositoryBindingSchema: z.ZodObject<{
+    defaultRef: z.ZodString;
+    workingDirectory: z.ZodString;
+    setupCommands: z.ZodArray<z.ZodString>;
+    revision: z.ZodNumber;
+    enabled: z.ZodBoolean;
+    repositoryId: z.ZodNumber;
+    installationId: z.ZodNumber;
+    owner: z.ZodString;
+    name: z.ZodString;
+    id: z.ZodString;
+    label: z.ZodString;
+}, z.core.$strict>;
+/** Resolved by the Hub; no credentials or client-selected clone URLs belong here. */
+declare const repositorySourceSchema: z.ZodObject<{
+    ref: z.ZodString;
+    commitSha: z.ZodString;
+    branch: z.ZodString;
+    workingDirectory: z.ZodString;
+    setupCommands: z.ZodArray<z.ZodString>;
+    configRevision: z.ZodNumber;
+    repositoryId: z.ZodNumber;
+    installationId: z.ZodNumber;
+    owner: z.ZodString;
+    name: z.ZodString;
+    bindingId: z.ZodString;
+}, z.core.$strict>;
+type RepositoryBinding = z.infer<typeof repositoryBindingSchema>;
+type RepositorySource = z.infer<typeof repositorySourceSchema>;
+/**
+ * A Workflow named by a Run. A bare string is the registry name, exactly as before. The object form adds an install
+ * reference: `source` is an `owner/repo` GitHub marketplace slug (never a path or URL; segments start alphanumeric,
+ * the same rule as tests/fixtures/workflow-refs.json) and `version` is matched exactly. `ref` parses so that the Hub
+ * and Runner can refuse it with a specific reason; it is not honoured yet.
+ */
+declare const workflowSourceSchema: z.ZodString;
+declare const workflowReferenceSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    name: z.ZodString;
+    source: z.ZodOptional<z.ZodString>;
+    ref: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>]>;
+type WorkflowReference = z.infer<typeof workflowReferenceSchema>;
+type WorkflowInstallReference = Exclude<WorkflowReference, string> & {
+    source: string;
+};
+/** The registry name a Run's `spec.workflow` asks for, in either spelling. */
+declare const workflowName: (workflow: WorkflowReference | undefined) => string | undefined;
+/** The install reference, present only for the object form that carries a `source`. */
+declare const installReference: (workflow: WorkflowReference | undefined) => WorkflowInstallReference | undefined;
+/** Structural equality of two `spec.workflow` values; never `===`, which is false for equal objects. */
+declare const sameWorkflow: (a: WorkflowReference | undefined, b: WorkflowReference | undefined) => boolean;
+declare const runSpecSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    projectDir: z.ZodString;
+    harness: z.ZodEnum<{
+        "claude-code": "claude-code";
+        codex: "codex";
+    }>;
+    workflow: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        source: z.ZodOptional<z.ZodString>;
+        ref: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>>;
+    repository: z.ZodOptional<z.ZodObject<{
+        ref: z.ZodString;
+        commitSha: z.ZodString;
+        branch: z.ZodString;
+        workingDirectory: z.ZodString;
+        setupCommands: z.ZodArray<z.ZodString>;
+        configRevision: z.ZodNumber;
+        repositoryId: z.ZodNumber;
+        installationId: z.ZodNumber;
+        owner: z.ZodString;
+        name: z.ZodString;
+        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;
+    runId: z.ZodString;
+    expectedRecordRevision: z.ZodOptional<z.ZodNumber>;
+    intent: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"start">;
+        sessionId: z.ZodString;
+        runnerId: z.ZodOptional<z.ZodString>;
+        computeProfileId: z.ZodOptional<z.ZodString>;
+        scope: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            visibility: z.ZodLiteral<"organization">;
+        }, z.core.$strict>, z.ZodObject<{
+            visibility: z.ZodLiteral<"private">;
+            ownerUserId: z.ZodString;
+        }, z.core.$strict>], "visibility">;
+        spec: z.ZodObject<{
+            prompt: z.ZodString;
+            projectDir: z.ZodString;
+            harness: z.ZodEnum<{
+                "claude-code": "claude-code";
+                codex: "codex";
+            }>;
+            workflow: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                name: z.ZodString;
+                source: z.ZodOptional<z.ZodString>;
+                ref: z.ZodOptional<z.ZodString>;
+                version: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>>;
+            repository: z.ZodOptional<z.ZodObject<{
+                ref: z.ZodString;
+                commitSha: z.ZodString;
+                branch: z.ZodString;
+                workingDirectory: z.ZodString;
+                setupCommands: z.ZodArray<z.ZodString>;
+                configRevision: z.ZodNumber;
+                repositoryId: z.ZodNumber;
+                installationId: z.ZodNumber;
+                owner: z.ZodString;
+                name: z.ZodString;
+                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<{
+        kind: z.ZodLiteral<"abandon">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"steer">;
+        text: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"answer">;
+        interruptionId: z.ZodString;
+        expectedInterruptionRevision: z.ZodNumber;
+        requestId: z.ZodOptional<z.ZodString>;
+        answer: z.ZodJSONSchema;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"resume">;
+        interruptionId: z.ZodString;
+        guidance: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>;
+declare const grantSchema: z.ZodObject<{
+    commandId: z.ZodString;
+    hubEpoch: z.ZodString;
+    runId: z.ZodString;
+    sessionId: z.ZodString;
+    runnerId: z.ZodString;
+    installationId: z.ZodString;
+    attemptId: z.ZodString;
+    generation: z.ZodNumber;
+    baseExecutionRevision: z.ZodNumber;
+    baseHistorySeq: z.ZodNumber;
+    cloudHistoryThrough: z.ZodNumber;
+    purpose: z.ZodEnum<{
+        start: "start";
+        resume: "resume";
+    }>;
+    spec: z.ZodObject<{
+        prompt: z.ZodString;
+        projectDir: z.ZodString;
+        harness: z.ZodEnum<{
+            "claude-code": "claude-code";
+            codex: "codex";
+        }>;
+        workflow: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            name: z.ZodString;
+            source: z.ZodOptional<z.ZodString>;
+            ref: z.ZodOptional<z.ZodString>;
+            version: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>>;
+        repository: z.ZodOptional<z.ZodObject<{
+            ref: z.ZodString;
+            commitSha: z.ZodString;
+            branch: z.ZodString;
+            workingDirectory: z.ZodString;
+            setupCommands: z.ZodArray<z.ZodString>;
+            configRevision: z.ZodNumber;
+            repositoryId: z.ZodNumber;
+            installationId: z.ZodNumber;
+            owner: z.ZodString;
+            name: z.ZodString;
+            bindingId: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    continuation: z.ZodOptional<z.ZodJSONSchema>;
+    previousRun: z.ZodOptional<z.ZodObject<{
+        runId: z.ZodString;
+        executionRevision: z.ZodNumber;
+        historyProduced: z.ZodNumber;
+        closeReason: z.ZodOptional<z.ZodLiteral<"abandoned">>;
+        checkpoint: z.ZodOptional<z.ZodObject<{
+            checkpointId: z.ZodString;
+            checksum: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    checkpoint: z.ZodOptional<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;
+    attemptId: z.ZodString;
+    emittedAt: z.ZodISODateTime;
+    kind: z.ZodString;
+    data: z.ZodJSONSchema;
+}, z.core.$strict>;
+declare const runnerFrameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"hello">;
+    role: z.ZodLiteral<"runner">;
+    protocol: z.ZodObject<{
+        major: z.ZodLiteral<2>;
+        minor: z.ZodNumber;
+    }, z.core.$strict>;
+    runnerId: z.ZodString;
+    installationId: z.ZodString;
+    softwareVersion: z.ZodString;
+    capabilities: z.ZodArray<z.ZodString>;
+    workflows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"builtin">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"marketplace-remote">;
+            ref: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"marketplace-local">;
+            repoDir: z.ZodString;
+            workflowName: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"filesystem">;
+            path: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"unknown">;
+        }, z.core.$strip>], "kind">;
+    }, z.core.$strip>>>;
+    readiness: z.ZodOptional<z.ZodObject<{
+        'claude-code': z.ZodOptional<z.ZodObject<{
+            installed: z.ZodBoolean;
+            signedIn: z.ZodBoolean;
+        }, z.core.$strict>>;
+        codex: z.ZodOptional<z.ZodObject<{
+            installed: z.ZodBoolean;
+            signedIn: z.ZodBoolean;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    control: z.ZodObject<{
+        firstRetainedSeq: z.ZodNumber;
+        lastProducedSeq: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"control.batch">;
+    firstSeq: z.ZodNumber;
+    records: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"workflows.changed">;
+        workflows: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            version: z.ZodOptional<z.ZodString>;
+            source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"builtin">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"marketplace-remote">;
+                ref: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"marketplace-local">;
+                repoDir: z.ZodString;
+                workflowName: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"filesystem">;
+                path: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"unknown">;
+            }, z.core.$strip>], "kind">;
+        }, z.core.$strip>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"readiness.changed">;
+        readiness: z.ZodObject<{
+            'claude-code': z.ZodOptional<z.ZodObject<{
+                installed: z.ZodBoolean;
+                signedIn: z.ZodBoolean;
+            }, z.core.$strict>>;
+            codex: z.ZodOptional<z.ZodObject<{
+                installed: z.ZodBoolean;
+                signedIn: z.ZodBoolean;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"assignment.accepted">;
+        runId: z.ZodString;
+        attemptId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"assignment.rejected">;
+        runId: z.ZodString;
+        attemptId: z.ZodString;
+        reason: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        workflow: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            version: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        runId: z.ZodString;
+        attemptId: z.ZodString;
+        executionRevision: z.ZodNumber;
+        emittedAt: z.ZodISODateTime;
+        kind: z.ZodLiteral<"run.started">;
+    }, z.core.$strict>, z.ZodObject<{
+        runId: z.ZodString;
+        attemptId: z.ZodString;
+        executionRevision: z.ZodNumber;
+        emittedAt: z.ZodISODateTime;
+        kind: z.ZodLiteral<"run.resumed">;
+    }, z.core.$strict>, z.ZodObject<{
+        interruption: z.ZodObject<{
+            interruptionId: z.ZodString;
+            revision: z.ZodNumber;
+            kind: z.ZodEnum<{
+                permission: "permission";
+                question: "question";
+                guidance: "guidance";
+                recovery: "recovery";
+                waiting: "waiting";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        occupancy: z.ZodEnum<{
+            held: "held";
+            released: "released";
+        }>;
+        historyThrough: z.ZodNumber;
+        continuation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"live_request">;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"local_checkpoint">;
+            checkpointId: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"portable_checkpoint">;
+            checkpointId: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"repair_required">;
+            detail: z.ZodString;
+        }, z.core.$strict>], "kind">;
+        runId: z.ZodString;
+        attemptId: z.ZodString;
+        executionRevision: z.ZodNumber;
+        emittedAt: z.ZodISODateTime;
+        kind: z.ZodLiteral<"run.attention">;
+    }, z.core.$strict>, z.ZodObject<{
+        status: z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            cancelled: "cancelled";
+        }>;
+        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;
+        emittedAt: z.ZodISODateTime;
+        kind: z.ZodLiteral<"run.finished">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"command.applied">;
+        runId: z.ZodString;
+        attemptId: z.ZodString;
+        commandId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"command.rejected">;
+        runId: z.ZodString;
+        attemptId: z.ZodString;
+        commandId: z.ZodString;
+        reason: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"revoked_not_started">;
+        runId: z.ZodString;
+        attemptId: z.ZodString;
+    }, z.core.$strict>], "kind">>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"history.batch">;
+    runId: z.ZodString;
+    firstSeq: z.ZodNumber;
+    records: z.ZodArray<z.ZodObject<{
+        eventId: z.ZodString;
+        attemptId: z.ZodString;
+        emittedAt: z.ZodISODateTime;
+        kind: z.ZodString;
+        data: z.ZodJSONSchema;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"ping">;
+    nonce: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"reconcile.page">;
+    inventoryId: z.ZodDefault<z.ZodString>;
+    page: z.ZodDefault<z.ZodNumber>;
+    complete: z.ZodBoolean;
+    runs: z.ZodArray<z.ZodObject<{
+        runId: z.ZodString;
+        attemptId: z.ZodString;
+        executionRevision: z.ZodNumber;
+        phase: z.ZodEnum<{
+            recovery: "recovery";
+            admitted: "admitted";
+            prepared: "prepared";
+            executing: "executing";
+            parked: "parked";
+            terminal: "terminal";
+        }>;
+    }, z.core.$strict>>;
+}, z.core.$strict>], "type">;
+type InstalledWorkflow = z.infer<typeof InstalledWorkflowSchema>;
+type Scope = z.infer<typeof scopeSchema>;
+type Command = z.infer<typeof commandSchema>;
+type Grant = z.infer<typeof grantSchema>;
+type ControlRecord = z.infer<typeof controlRecordSchema>;
+type RunnerFrame = z.infer<typeof runnerFrameSchema>;
+type HistoryRecord = z.infer<typeof historyRecordSchema>;
+type ExecutionFact = Extract<ControlRecord, {
+    executionRevision: number;
+}>;
+declare const runViewSchema: z.ZodObject<{
+    runId: z.ZodString;
+    sessionId: z.ZodString;
+    runnerId: z.ZodString;
+    computeProfileId: z.ZodOptional<z.ZodString>;
+    scope: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        visibility: z.ZodLiteral<"organization">;
+    }, z.core.$strict>, z.ZodObject<{
+        visibility: z.ZodLiteral<"private">;
+        ownerUserId: z.ZodString;
+    }, 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>;
+    }, z.core.$strict>>;
+    execution: z.ZodNullable<z.ZodObject<{
+        status: z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            cancelled: "cancelled";
+            running: "running";
+            awaiting_attention: "awaiting_attention";
+        }>;
+        revision: z.ZodNumber;
+        attemptId: z.ZodString;
+        occupancy: z.ZodEnum<{
+            held: "held";
+            released: "released";
+        }>;
+        startedAt: z.ZodOptional<z.ZodISODateTime>;
+        endedAt: z.ZodOptional<z.ZodISODateTime>;
+        interruption: z.ZodOptional<z.ZodObject<{
+            interruptionId: z.ZodString;
+            revision: z.ZodNumber;
+            kind: z.ZodEnum<{
+                permission: "permission";
+                question: "question";
+                guidance: "guidance";
+                recovery: "recovery";
+                waiting: "waiting";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strip>>;
+    scheduling: z.ZodEnum<{
+        admitted: "admitted";
+        queued: "queued";
+        dispatching: "dispatching";
+        idle: "idle";
+    }>;
+    closed: z.ZodBoolean;
+    closeReason: z.ZodOptional<z.ZodString>;
+    cancellation: z.ZodOptional<z.ZodString>;
+    pendingResume: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"start">;
+        sessionId: z.ZodString;
+        runnerId: z.ZodOptional<z.ZodString>;
+        computeProfileId: z.ZodOptional<z.ZodString>;
+        scope: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            visibility: z.ZodLiteral<"organization">;
+        }, z.core.$strict>, z.ZodObject<{
+            visibility: z.ZodLiteral<"private">;
+            ownerUserId: z.ZodString;
+        }, z.core.$strict>], "visibility">;
+        spec: z.ZodObject<{
+            prompt: z.ZodString;
+            projectDir: z.ZodString;
+            harness: z.ZodEnum<{
+                "claude-code": "claude-code";
+                codex: "codex";
+            }>;
+            workflow: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                name: z.ZodString;
+                source: z.ZodOptional<z.ZodString>;
+                ref: z.ZodOptional<z.ZodString>;
+                version: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>>;
+            repository: z.ZodOptional<z.ZodObject<{
+                ref: z.ZodString;
+                commitSha: z.ZodString;
+                branch: z.ZodString;
+                workingDirectory: z.ZodString;
+                setupCommands: z.ZodArray<z.ZodString>;
+                configRevision: z.ZodNumber;
+                repositoryId: z.ZodNumber;
+                installationId: z.ZodNumber;
+                owner: z.ZodString;
+                name: z.ZodString;
+                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<{
+        kind: z.ZodLiteral<"abandon">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"steer">;
+        text: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"answer">;
+        interruptionId: z.ZodString;
+        expectedInterruptionRevision: z.ZodNumber;
+        requestId: z.ZodOptional<z.ZodString>;
+        answer: z.ZodJSONSchema;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"resume">;
+        interruptionId: z.ZodString;
+        guidance: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "kind">>;
+    runnerStopped: z.ZodOptional<z.ZodBoolean>;
+    canAbandon: z.ZodOptional<z.ZodBoolean>;
+    historyThrough: z.ZodNumber;
+    expectedHistoryThrough: z.ZodOptional<z.ZodNumber>;
+    createdAt: z.ZodNumber;
+    checkpoint: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        state: z.ZodEnum<{
+            pending: "pending";
+            ready: "ready";
+        }>;
+        checksum: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type RunView = z.infer<typeof runViewSchema>;
+declare const clientFrameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"watch">;
+    hubEpoch: z.ZodString;
+    runIds: z.ZodArray<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"watch.ack">;
+    subscriptionId: z.ZodString;
+    through: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"command.submit">;
+    command: z.ZodObject<{
+        commandId: z.ZodString;
+        hubEpoch: z.ZodString;
+        runId: z.ZodString;
+        expectedRecordRevision: z.ZodOptional<z.ZodNumber>;
+        intent: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"start">;
+            sessionId: z.ZodString;
+            runnerId: z.ZodOptional<z.ZodString>;
+            computeProfileId: z.ZodOptional<z.ZodString>;
+            scope: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                visibility: z.ZodLiteral<"organization">;
+            }, z.core.$strict>, z.ZodObject<{
+                visibility: z.ZodLiteral<"private">;
+                ownerUserId: z.ZodString;
+            }, z.core.$strict>], "visibility">;
+            spec: z.ZodObject<{
+                prompt: z.ZodString;
+                projectDir: z.ZodString;
+                harness: z.ZodEnum<{
+                    "claude-code": "claude-code";
+                    codex: "codex";
+                }>;
+                workflow: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    name: z.ZodString;
+                    source: z.ZodOptional<z.ZodString>;
+                    ref: z.ZodOptional<z.ZodString>;
+                    version: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>]>>;
+                repository: z.ZodOptional<z.ZodObject<{
+                    ref: z.ZodString;
+                    commitSha: z.ZodString;
+                    branch: z.ZodString;
+                    workingDirectory: z.ZodString;
+                    setupCommands: z.ZodArray<z.ZodString>;
+                    configRevision: z.ZodNumber;
+                    repositoryId: z.ZodNumber;
+                    installationId: z.ZodNumber;
+                    owner: z.ZodString;
+                    name: z.ZodString;
+                    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<{
+            kind: z.ZodLiteral<"abandon">;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"steer">;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"answer">;
+            interruptionId: z.ZodString;
+            expectedInterruptionRevision: z.ZodNumber;
+            requestId: z.ZodOptional<z.ZodString>;
+            answer: z.ZodJSONSchema;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"resume">;
+            interruptionId: z.ZodString;
+            guidance: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>], "kind">;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"ping">;
+    nonce: z.ZodString;
+}, z.core.$strict>], "type">;
+/** Stable JSON encoding for duplicate detection; independent of object key insertion order. */
+declare function canonicalJson(value: unknown): string;
+declare const checkpointPathSchema: z.ZodString;
+declare const checkpointSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    checkpointId: z.ZodString;
+    orgId: z.ZodString;
+    phase: z.ZodEnum<{
+        parked: "parked";
+        terminal: "terminal";
+    }>;
+    runId: z.ZodString;
+    sessionId: z.ZodString;
+    sourceAttemptId: z.ZodString;
+    executionRevision: z.ZodNumber;
+    historyProduced: z.ZodNumber;
+    historyAck: z.ZodNumber;
+    grant: z.ZodObject<{
+        commandId: z.ZodString;
+        hubEpoch: z.ZodString;
+        runId: z.ZodString;
+        sessionId: z.ZodString;
+        runnerId: z.ZodString;
+        installationId: z.ZodString;
+        attemptId: z.ZodString;
+        generation: z.ZodNumber;
+        baseExecutionRevision: z.ZodNumber;
+        baseHistorySeq: z.ZodNumber;
+        cloudHistoryThrough: z.ZodNumber;
+        purpose: z.ZodEnum<{
+            start: "start";
+            resume: "resume";
+        }>;
+        spec: z.ZodObject<{
+            prompt: z.ZodString;
+            projectDir: z.ZodString;
+            harness: z.ZodEnum<{
+                "claude-code": "claude-code";
+                codex: "codex";
+            }>;
+            workflow: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                name: z.ZodString;
+                source: z.ZodOptional<z.ZodString>;
+                ref: z.ZodOptional<z.ZodString>;
+                version: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>>;
+            repository: z.ZodOptional<z.ZodObject<{
+                ref: z.ZodString;
+                commitSha: z.ZodString;
+                branch: z.ZodString;
+                workingDirectory: z.ZodString;
+                setupCommands: z.ZodArray<z.ZodString>;
+                configRevision: z.ZodNumber;
+                repositoryId: z.ZodNumber;
+                installationId: z.ZodNumber;
+                owner: z.ZodString;
+                name: z.ZodString;
+                bindingId: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        continuation: z.ZodOptional<z.ZodJSONSchema>;
+        previousRun: z.ZodOptional<z.ZodObject<{
+            runId: z.ZodString;
+            executionRevision: z.ZodNumber;
+            historyProduced: z.ZodNumber;
+            closeReason: z.ZodOptional<z.ZodLiteral<"abandoned">>;
+            checkpoint: z.ZodOptional<z.ZodObject<{
+                checkpointId: z.ZodString;
+                checksum: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        checkpoint: z.ZodOptional<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>;
+    gitBundle: z.ZodString;
+    indexPatch: z.ZodString;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodString;
+        executable: z.ZodBoolean;
+    }, z.core.$strict>>;
+    deleted: z.ZodArray<z.ZodString>;
+    sessionRows: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        id: z.ZodString;
+        payload: z.ZodString;
+    }, z.core.$strict>>;
+    history: z.ZodArray<z.ZodObject<{
+        seq: z.ZodNumber;
+        record: z.ZodObject<{
+            eventId: z.ZodString;
+            attemptId: z.ZodString;
+            emittedAt: z.ZodISODateTime;
+            kind: z.ZodString;
+            data: z.ZodJSONSchema;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type Checkpoint = z.infer<typeof checkpointSchema>;
+/**
+ * Connect (root ADR-0005): a member asks for a short, one-use Connect code bound to them and their Team, and a
+ * machine redeems it for a Runner credential. Codes use an alphabet without look-alike characters and are
+ * shown as `XXXX-XXXX`; redemption accepts either form.
+ */
+declare const connectCodeAlphabet = "ABCDEFGHJKMNPQRSTUVWXYZ23456789";
+declare const connectCodeSchema: z.ZodString;
+declare const connectCodeRequestSchema: z.ZodObject<{
+    hubEpoch: z.ZodString;
+}, z.core.$strict>;
+declare const connectCodeResponseSchema: z.ZodObject<{
+    code: z.ZodString;
+    expiresAt: z.ZodNumber;
+}, z.core.$strict>;
+/** What a machine presents when it redeems a Connect code. The Hub uses it to name the Runner, never for authority. */
+declare const connectRedeemRequestSchema: z.ZodObject<{
+    code: z.ZodString;
+    installationId: z.ZodString;
+    hostname: z.ZodString;
+    os: z.ZodString;
+    softwareVersion: z.ZodString;
+}, z.core.$strict>;
+/** Everything the machine needs to run as this Runner; `token` is the only copy of the credential. */
+declare const connectRedeemResponseSchema: z.ZodObject<{
+    orgId: z.ZodString;
+    hubEpoch: z.ZodString;
+    runnerId: z.ZodString;
+    installationId: z.ZodString;
+    name: z.ZodString;
+    token: z.ZodString;
+    credentialId: z.ZodString;
+    expiresAt: z.ZodNumber;
+}, z.core.$strict>;
+/**
+ * One Runner per machine per Team (root ADR-0005): redeeming from an installation that already has a Runner in the
+ * code's Team is refused with `409` and this body, naming the Runner it already has. No credential is minted and
+ * the code is not spent.
+ */
+declare const connectAlreadyConnectedSchema: z.ZodObject<{
+    error: z.ZodLiteral<"runner_already_connected">;
+    orgId: z.ZodString;
+    runnerId: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strict>;
+/** Personal: serves only the member who connected it. Team: serves every member (only an admin widens it). */
+declare const audienceSchema: z.ZodEnum<{
+    personal: "personal";
+    team: "team";
+}>;
+/** One entry of `GET /runners`. Runners enrolled before Connect, and managed Runners, carry no owner fields. */
+declare const runnerListEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    online: z.ZodNumber;
+    capacity: z.ZodNumber;
+    managed: z.ZodNumber;
+    draining: z.ZodNumber;
+    stopped: z.ZodNumber;
+    name: z.ZodNullable<z.ZodString>;
+    connectedBy: z.ZodNullable<z.ZodString>;
+    audience: z.ZodNullable<z.ZodEnum<{
+        personal: "personal";
+        team: "team";
+    }>>;
+    softwareVersion: z.ZodNullable<z.ZodString>;
+    lastSeen: z.ZodNullable<z.ZodNumber>;
+    workflows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"builtin">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"marketplace-remote">;
+            ref: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"marketplace-local">;
+            repoDir: z.ZodString;
+            workflowName: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"filesystem">;
+            path: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"unknown">;
+        }, z.core.$strip>], "kind">;
+    }, z.core.$strip>>>;
+    readOnly: z.ZodOptional<z.ZodBoolean>;
+    readiness: z.ZodOptional<z.ZodObject<{
+        'claude-code': z.ZodOptional<z.ZodObject<{
+            installed: z.ZodBoolean;
+            signedIn: z.ZodBoolean;
+        }, z.core.$strict>>;
+        codex: z.ZodOptional<z.ZodObject<{
+            installed: z.ZodBoolean;
+            signedIn: z.ZodBoolean;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    updateRequired: z.ZodOptional<z.ZodBoolean>;
+    needsOwner: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/** Where a member's Runs go when nothing else decides: a Team-audience Runner or a cloud compute profile. */
+declare const teamDefaultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"runner">;
+    runnerId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"profile">;
+    profileId: z.ZodString;
+}, z.core.$strict>], "kind">;
+/** `POST /team-default` (admin only); `null` clears it. */
+declare const teamDefaultRequestSchema: z.ZodObject<{
+    hubEpoch: z.ZodString;
+    teamDefault: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"runner">;
+        runnerId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"profile">;
+        profileId: z.ZodString;
+    }, z.core.$strict>], "kind">>;
+}, z.core.$strict>;
+/**
+ * `POST /runners/<id>`: rename, set how many Runs it takes in parallel, or change its Audience. Its connected-by
+ * member may rename it, set its capacity and narrow it to Personal; only an admin may widen it to Team.
+ */
+declare const runnerUpdateRequestSchema: z.ZodObject<{
+    hubEpoch: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    capacity: z.ZodOptional<z.ZodNumber>;
+    audience: z.ZodOptional<z.ZodEnum<{
+        personal: "personal";
+        team: "team";
+    }>>;
+}, z.core.$strict>;
+/** Where the viewer's next Run goes when it names no Runner (root ADR-0005), or why it cannot start. */
+declare const runsGoToSchema: z.ZodUnion<readonly [z.ZodObject<{
+    via: z.ZodLiteral<"personal">;
+    runnerId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    via: z.ZodLiteral<"team_default">;
+    runnerId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    via: z.ZodLiteral<"team_default">;
+    profileId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    via: z.ZodLiteral<"none">;
+    reason: z.ZodEnum<{
+        runner_needs_owner: "runner_needs_owner";
+        no_runner_available: "no_runner_available";
+    }>;
+}, z.core.$strict>]>;
+declare const runnerListSchema: z.ZodObject<{
+    capabilities: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+    historyRetentionDays: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    viewer: z.ZodOptional<z.ZodObject<{
+        userId: z.ZodString;
+        admin: z.ZodBoolean;
+    }, z.core.$strip>>;
+    teamDefault: z.ZodOptional<z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"runner">;
+        runnerId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"profile">;
+        profileId: z.ZodString;
+    }, z.core.$strict>], "kind">>>;
+    runsGoTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        via: z.ZodLiteral<"personal">;
+        runnerId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        via: z.ZodLiteral<"team_default">;
+        runnerId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        via: z.ZodLiteral<"team_default">;
+        profileId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        via: z.ZodLiteral<"none">;
+        reason: z.ZodEnum<{
+            runner_needs_owner: "runner_needs_owner";
+            no_runner_available: "no_runner_available";
+        }>;
+    }, z.core.$strict>]>>;
+    minimumRunnerVersion: z.ZodOptional<z.ZodString>;
+    runners: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        online: z.ZodNumber;
+        capacity: z.ZodNumber;
+        managed: z.ZodNumber;
+        draining: z.ZodNumber;
+        stopped: z.ZodNumber;
+        name: z.ZodNullable<z.ZodString>;
+        connectedBy: z.ZodNullable<z.ZodString>;
+        audience: z.ZodNullable<z.ZodEnum<{
+            personal: "personal";
+            team: "team";
+        }>>;
+        softwareVersion: z.ZodNullable<z.ZodString>;
+        lastSeen: z.ZodNullable<z.ZodNumber>;
+        workflows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            version: z.ZodOptional<z.ZodString>;
+            source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"builtin">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"marketplace-remote">;
+                ref: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"marketplace-local">;
+                repoDir: z.ZodString;
+                workflowName: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"filesystem">;
+                path: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"unknown">;
+            }, z.core.$strip>], "kind">;
+        }, z.core.$strip>>>;
+        readOnly: z.ZodOptional<z.ZodBoolean>;
+        readiness: z.ZodOptional<z.ZodObject<{
+            'claude-code': z.ZodOptional<z.ZodObject<{
+                installed: z.ZodBoolean;
+                signedIn: z.ZodBoolean;
+            }, z.core.$strict>>;
+            codex: z.ZodOptional<z.ZodObject<{
+                installed: z.ZodBoolean;
+                signedIn: z.ZodBoolean;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        updateRequired: z.ZodOptional<z.ZodBoolean>;
+        needsOwner: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    profiles: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        projectDir: z.ZodString;
+        repositoryRequired: z.ZodOptional<z.ZodBoolean>;
+        workflows: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        workflowSources: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type ConnectRedeemRequest = z.infer<typeof connectRedeemRequestSchema>;
+/**
+ * Disconnect (root ADR-0005) ends a Runner's membership in its Team. From Settings, a member posts it for a Runner
+ * they connected (an admin, for any Runner) to `/runners/{id}/disconnect`; from the machine, the Runner posts it
+ * with its own credential to `/runner/disconnect`. A Disconnected Runner's next contact is refused with
+ * `runner_disconnected` (HTTP 410, or an `error` frame on a live instance socket).
+ */
+declare const runnerDisconnectRequestSchema: z.ZodObject<{
+    hubEpoch: z.ZodString;
+}, z.core.$strict>;
+/** A body that carries only the Hub epoch it was made against: Disconnect and adopt. */
+declare const hubEpochRequestSchema: z.ZodObject<{
+    hubEpoch: z.ZodString;
+}, z.core.$strict>;
+/** What a Disconnect will stop, for its confirmation. Runs the viewer cannot see are counted, never named. */
+declare const runnerDisconnectPreviewSchema: z.ZodObject<{
+    runnerId: z.ZodString;
+    name: z.ZodNullable<z.ZodString>;
+    runs: z.ZodArray<z.ZodObject<{
+        runId: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        state: z.ZodEnum<{
+            parked: "parked";
+            queued: "queued";
+            working: "working";
+        }>;
+    }, z.core.$strip>>;
+    hiddenRuns: z.ZodNumber;
+}, z.core.$strip>;
+declare const runnerDisconnectResponseSchema: z.ZodObject<{
+    disconnected: z.ZodLiteral<true>;
+    stoppedRuns: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * `POST /runners/{id}/adopt` (admin only): take over a Runner paused as "Needs an owner" as its connected-by
+ * member, so it serves again with its Audience, name and capacity unchanged. Answers the updated Runner-list
+ * entry; a Runner that is not paused answers `runner_not_paused`.
+ */
+declare const runnerAdoptRequestSchema: z.ZodObject<{
+    hubEpoch: z.ZodString;
+}, z.core.$strict>;
+type RunnerAdoptRequest = z.infer<typeof runnerAdoptRequestSchema>;
+type RunnerDisconnectPreview = z.infer<typeof runnerDisconnectPreviewSchema>;
+type RunnerDisconnectResponse = z.infer<typeof runnerDisconnectResponseSchema>;
+type ConnectRedeemResponse = z.infer<typeof connectRedeemResponseSchema>;
+type ConnectAlreadyConnected = z.infer<typeof connectAlreadyConnectedSchema>;
+type RunnerListEntry = z.infer<typeof runnerListEntrySchema>;
+type RunnerList = z.infer<typeof runnerListSchema>;
+/**
+ * The machine-initiated door of Connect (root ADR-0005). A machine with no credential asks for a Connect code
+ * (`connectStart`), prints it with the approval URL and polls with its secret `deviceCode` (`connectPoll`). A
+ * signed-in member sees what is asking (`connectPending`) and approves it into one of their Teams with an
+ * Audience (`connectApprove`), or denies it (`connectDeny`). The approved poll answers a `connectRedeem` credential.
+ */
+declare const connectStartRequestSchema: z.ZodObject<{
+    installationId: z.ZodString;
+    softwareVersion: z.ZodString;
+    hostname: z.ZodString;
+    os: z.ZodString;
+}, z.core.$strict>;
+declare const connectStartResponseSchema: z.ZodObject<{
+    deviceCode: z.ZodString;
+    code: z.ZodString;
+    expiresAt: z.ZodNumber;
+    intervalSec: z.ZodNumber;
+    verificationUrl: z.ZodString;
+}, z.core.$strict>;
+declare const connectPollRequestSchema: z.ZodObject<{
+    deviceCode: z.ZodString;
+}, z.core.$strict>;
+/** What the approval page shows about the machine: what the machine says about itself, never authority. */
+declare const connectPendingResponseSchema: z.ZodObject<{
+    hostname: z.ZodString;
+    os: z.ZodString;
+    softwareVersion: z.ZodString;
+    requestedAt: z.ZodNumber;
+    expiresAt: z.ZodNumber;
+}, z.core.$strict>;
+declare const connectApproveRequestSchema: z.ZodObject<{
+    code: z.ZodString;
+    audience: z.ZodEnum<{
+        personal: "personal";
+        team: "team";
+    }>;
+    hubEpoch: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+declare const connectDenyRequestSchema: z.ZodObject<{
+    code: z.ZodString;
+}, z.core.$strict>;
+type Audience = z.infer<typeof audienceSchema>;
+type ConnectStartRequest = z.infer<typeof connectStartRequestSchema>;
+type ConnectStartResponse = z.infer<typeof connectStartResponseSchema>;
+type ConnectPendingResponse = z.infer<typeof connectPendingResponseSchema>;
+type TeamDefault = z.infer<typeof teamDefaultSchema>;
+type RunsGoTo = z.infer<typeof runsGoToSchema>;
+
+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, type Scope, type TeamDefault, type WorkflowIdentity, type WorkflowInstallReference, type WorkflowReference, abandonedConversationContinuationCapability, audienceSchema, buildCloseReasonSchema, canonicalJson, checkpointPathSchema, checkpointSchema, 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 };