@agent-deck/shared 2.1.1 → 2.2.1

package/dist/schemas/agent-run.d.ts

@@ -0,0 +1,749 @@
+import { z } from 'zod';
+/**
+ * Agent run HTTP contract (NOT-480): one coding-agent attempt on the Agent
+ * Deck host, started or continued by an authenticated remote coordinator.
+ *
+ * Responses carry only public lifecycle fields and normalized events —
+ * never a host pid, a private log path, credentials, or an Authorization
+ * value. Success bodies are wrapped as `{ success: true, data }`.
+ */
+/** Prompt bound checked before launch (characters). */
+export declare const AGENT_RUN_PROMPT_MAX_CHARS: number;
+/** Whole-request bound for `POST /api/agent-runs` (bytes). */
+export declare const AGENT_RUN_REQUEST_BODY_LIMIT_BYTES: number;
+/** Required on `POST /api/agent-runs`; scoped to the calling grant. */
+export declare const AGENT_RUN_IDEMPOTENCY_HEADER = "idempotency-key";
+export declare const AGENT_RUN_EVENTS_DEFAULT_LIMIT = 200;
+export declare const AGENT_RUN_EVENTS_MAX_LIMIT = 1000;
+export declare const AgentRunClientSchema: z.ZodEnum<["claude", "codex", "cursor", "muse"]>;
+export declare const AgentRunToolsSchema: z.ZodEnum<["readonly", "edit"]>;
+/** Opaque run id (`run-<UTC stamp>-<hex>`). */
+export declare const AgentRunIdSchema: z.ZodString;
+export declare const AgentRunIdempotencyKeySchema: z.ZodString;
+export declare const CreateAgentRunRequestSchema: z.ZodObject<{
+    deckId: z.ZodString;
+    client: z.ZodEnum<["claude", "codex", "cursor", "muse"]>;
+    /** Absolute working directory on the Agent Deck host. */
+    cwd: z.ZodEffects<z.ZodString, string, string>;
+    prompt: z.ZodEffects<z.ZodString, string, string>;
+    /** Explicit tool profile; `readonly` only when omitted. */
+    tools: z.ZodDefault<z.ZodEnum<["readonly", "edit"]>>;
+    /** Opaque client session id from an earlier run's status. */
+    resumeSessionId: z.ZodOptional<z.ZodString>;
+    /**
+     * NOT-486: capture a private pre-launch Git baseline so this run can be
+     * finalized into one local commit. Valid only with `tools: "edit"`, a Git
+     * worktree `cwd`, and a clean Git index.
+     */
+    prepareFinalization: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    tools: "readonly" | "edit";
+    deckId: string;
+    cwd: string;
+    client: "claude" | "cursor" | "codex" | "muse";
+    prompt: string;
+    prepareFinalization: boolean;
+    resumeSessionId?: string | undefined;
+}, {
+    deckId: string;
+    cwd: string;
+    client: "claude" | "cursor" | "codex" | "muse";
+    prompt: string;
+    tools?: "readonly" | "edit" | undefined;
+    resumeSessionId?: string | undefined;
+    prepareFinalization?: boolean | undefined;
+}>;
+/**
+ * Lifecycle state. `starting` is the launch acknowledgement (record written,
+ * no event yet); `running` has emitted events; `ended`, `error`, `died`, and
+ * `canceled` (NOT-481: operator cancellation, never an execution error) are
+ * terminal. `running` never implies success.
+ */
+export declare const AgentRunStateSchema: z.ZodEnum<["starting", "running", "ended", "error", "died", "canceled"]>;
+export declare const AGENT_RUN_TERMINAL_STATES: readonly ["ended", "error", "died", "canceled"];
+export declare const CreateAgentRunResponseSchema: z.ZodObject<{
+    runId: z.ZodString;
+    state: z.ZodEnum<["starting", "running", "ended", "error", "died", "canceled"]>;
+}, "strict", z.ZodTypeAny, {
+    state: "error" | "starting" | "running" | "ended" | "died" | "canceled";
+    runId: string;
+}, {
+    state: "error" | "starting" | "running" | "ended" | "died" | "canceled";
+    runId: string;
+}>;
+/** Lowercase hex Git object id (SHA-1 or SHA-256 repositories). */
+export declare const GitObjectIdSchema: z.ZodString;
+export declare const Sha256HexSchema: z.ZodString;
+/** Opaque reference to a run's private pre-launch Git baseline. */
+export declare const FinalizationBaselineRefSchema: z.ZodString;
+/**
+ * `prepared`: baseline captured, not finalized; `finalizing`: one finalize
+ * request is in progress; `finalized`: one local commit was created.
+ */
+export declare const FinalizationStateSchema: z.ZodEnum<["prepared", "finalizing", "finalized"]>;
+/** Public finalization fields on a prepared run (never a host path or file content). */
+export declare const AgentRunFinalizationStatusSchema: z.ZodObject<{
+    baselineRef: z.ZodString;
+    baselineDigest: z.ZodString;
+    state: z.ZodEnum<["prepared", "finalizing", "finalized"]>;
+    commit: z.ZodNullable<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    state: "prepared" | "finalizing" | "finalized";
+    baselineRef: string;
+    baselineDigest: string;
+    commit: string | null;
+}, {
+    state: "prepared" | "finalizing" | "finalized";
+    baselineRef: string;
+    baselineDigest: string;
+    commit: string | null;
+}>;
+export declare const AgentRunStatusSchema: z.ZodObject<{
+    runId: z.ZodString;
+    deckId: z.ZodString;
+    client: z.ZodEnum<["claude", "codex", "cursor", "muse"]>;
+    tools: z.ZodEnum<["readonly", "edit"]>;
+    state: z.ZodEnum<["starting", "running", "ended", "error", "died", "canceled"]>;
+    /** Opaque client session id; pass as `resumeSessionId` to continue. */
+    sessionId: z.ZodNullable<z.ZodString>;
+    startedAt: z.ZodString;
+    lastEventAt: z.ZodNullable<z.ZodString>;
+    /** NOT-486: present only when the run was started with `prepareFinalization`. */
+    finalization: z.ZodNullable<z.ZodObject<{
+        baselineRef: z.ZodString;
+        baselineDigest: z.ZodString;
+        state: z.ZodEnum<["prepared", "finalizing", "finalized"]>;
+        commit: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        state: "prepared" | "finalizing" | "finalized";
+        baselineRef: string;
+        baselineDigest: string;
+        commit: string | null;
+    }, {
+        state: "prepared" | "finalizing" | "finalized";
+        baselineRef: string;
+        baselineDigest: string;
+        commit: string | null;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    tools: "readonly" | "edit";
+    deckId: string;
+    startedAt: string;
+    state: "error" | "starting" | "running" | "ended" | "died" | "canceled";
+    sessionId: string | null;
+    client: "claude" | "cursor" | "codex" | "muse";
+    runId: string;
+    lastEventAt: string | null;
+    finalization: {
+        state: "prepared" | "finalizing" | "finalized";
+        baselineRef: string;
+        baselineDigest: string;
+        commit: string | null;
+    } | null;
+}, {
+    tools: "readonly" | "edit";
+    deckId: string;
+    startedAt: string;
+    state: "error" | "starting" | "running" | "ended" | "died" | "canceled";
+    sessionId: string | null;
+    client: "claude" | "cursor" | "codex" | "muse";
+    runId: string;
+    lastEventAt: string | null;
+    finalization: {
+        state: "prepared" | "finalizing" | "finalized";
+        baselineRef: string;
+        baselineDigest: string;
+        commit: string | null;
+    } | null;
+}>;
+/**
+ * Normalized run events, in log order. `seq` is the event's 1-based position
+ * in the canonical log: stable across reads and strictly increasing.
+ */
+export declare const AgentRunEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+    seq: z.ZodNumber;
+    ts: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    type: "text";
+    text: string;
+    seq: number;
+    ts: string;
+}, {
+    type: "text";
+    text: string;
+    seq: number;
+    ts: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"tool">;
+    name: z.ZodString;
+    seq: z.ZodNumber;
+    ts: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    type: "tool";
+    seq: number;
+    ts: string;
+}, {
+    name: string;
+    type: "tool";
+    seq: number;
+    ts: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"notice">;
+    message: z.ZodString;
+    sessionId: z.ZodNullable<z.ZodString>;
+    seq: z.ZodNumber;
+    ts: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    type: "notice";
+    message: string;
+    sessionId: string | null;
+    seq: number;
+    ts: string;
+}, {
+    type: "notice";
+    message: string;
+    sessionId: string | null;
+    seq: number;
+    ts: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"result">;
+    subtype: z.ZodString;
+    result: z.ZodUnknown;
+    sessionId: z.ZodNullable<z.ZodString>;
+    seq: z.ZodNumber;
+    ts: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    type: "result";
+    sessionId: string | null;
+    seq: number;
+    ts: string;
+    subtype: string;
+    result?: unknown;
+}, {
+    type: "result";
+    sessionId: string | null;
+    seq: number;
+    ts: string;
+    subtype: string;
+    result?: unknown;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"end">;
+    sessionId: z.ZodNullable<z.ZodString>;
+    seq: z.ZodNumber;
+    ts: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    type: "end";
+    sessionId: string | null;
+    seq: number;
+    ts: string;
+}, {
+    type: "end";
+    sessionId: string | null;
+    seq: number;
+    ts: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    message: z.ZodString;
+    sessionId: z.ZodNullable<z.ZodString>;
+    seq: z.ZodNumber;
+    ts: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    type: "error";
+    message: string;
+    sessionId: string | null;
+    seq: number;
+    ts: string;
+}, {
+    type: "error";
+    message: string;
+    sessionId: string | null;
+    seq: number;
+    ts: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"canceled">;
+    sessionId: z.ZodNullable<z.ZodString>;
+    seq: z.ZodNumber;
+    ts: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    type: "canceled";
+    sessionId: string | null;
+    seq: number;
+    ts: string;
+}, {
+    type: "canceled";
+    sessionId: string | null;
+    seq: number;
+    ts: string;
+}>]>;
+export declare const AgentRunEventsQuerySchema: z.ZodObject<{
+    /** Cursor from a previous read's `nextCursor`; omitted reads from the start. */
+    after: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    after?: string | undefined;
+    limit?: number | undefined;
+}, {
+    after?: string | undefined;
+    limit?: number | undefined;
+}>;
+export declare const AgentRunEventsResponseSchema: z.ZodObject<{
+    runId: z.ZodString;
+    state: z.ZodEnum<["starting", "running", "ended", "error", "died", "canceled"]>;
+    events: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+        seq: z.ZodNumber;
+        ts: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        type: "text";
+        text: string;
+        seq: number;
+        ts: string;
+    }, {
+        type: "text";
+        text: string;
+        seq: number;
+        ts: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"tool">;
+        name: z.ZodString;
+        seq: z.ZodNumber;
+        ts: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        type: "tool";
+        seq: number;
+        ts: string;
+    }, {
+        name: string;
+        type: "tool";
+        seq: number;
+        ts: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"notice">;
+        message: z.ZodString;
+        sessionId: z.ZodNullable<z.ZodString>;
+        seq: z.ZodNumber;
+        ts: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        type: "notice";
+        message: string;
+        sessionId: string | null;
+        seq: number;
+        ts: string;
+    }, {
+        type: "notice";
+        message: string;
+        sessionId: string | null;
+        seq: number;
+        ts: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"result">;
+        subtype: z.ZodString;
+        result: z.ZodUnknown;
+        sessionId: z.ZodNullable<z.ZodString>;
+        seq: z.ZodNumber;
+        ts: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        type: "result";
+        sessionId: string | null;
+        seq: number;
+        ts: string;
+        subtype: string;
+        result?: unknown;
+    }, {
+        type: "result";
+        sessionId: string | null;
+        seq: number;
+        ts: string;
+        subtype: string;
+        result?: unknown;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"end">;
+        sessionId: z.ZodNullable<z.ZodString>;
+        seq: z.ZodNumber;
+        ts: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        type: "end";
+        sessionId: string | null;
+        seq: number;
+        ts: string;
+    }, {
+        type: "end";
+        sessionId: string | null;
+        seq: number;
+        ts: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"error">;
+        message: z.ZodString;
+        sessionId: z.ZodNullable<z.ZodString>;
+        seq: z.ZodNumber;
+        ts: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        type: "error";
+        message: string;
+        sessionId: string | null;
+        seq: number;
+        ts: string;
+    }, {
+        type: "error";
+        message: string;
+        sessionId: string | null;
+        seq: number;
+        ts: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"canceled">;
+        sessionId: z.ZodNullable<z.ZodString>;
+        seq: z.ZodNumber;
+        ts: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        type: "canceled";
+        sessionId: string | null;
+        seq: number;
+        ts: string;
+    }, {
+        type: "canceled";
+        sessionId: string | null;
+        seq: number;
+        ts: string;
+    }>]>, "many">;
+    /** Pass as `after` to read the next page; unchanged when nothing new arrived. */
+    nextCursor: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    state: "error" | "starting" | "running" | "ended" | "died" | "canceled";
+    runId: string;
+    events: ({
+        type: "text";
+        text: string;
+        seq: number;
+        ts: string;
+    } | {
+        name: string;
+        type: "tool";
+        seq: number;
+        ts: string;
+    } | {
+        type: "notice";
+        message: string;
+        sessionId: string | null;
+        seq: number;
+        ts: string;
+    } | {
+        type: "result";
+        sessionId: string | null;
+        seq: number;
+        ts: string;
+        subtype: string;
+        result?: unknown;
+    } | {
+        type: "end";
+        sessionId: string | null;
+        seq: number;
+        ts: string;
+    } | {
+        type: "error";
+        message: string;
+        sessionId: string | null;
+        seq: number;
+        ts: string;
+    } | {
+        type: "canceled";
+        sessionId: string | null;
+        seq: number;
+        ts: string;
+    })[];
+    nextCursor: string;
+}, {
+    state: "error" | "starting" | "running" | "ended" | "died" | "canceled";
+    runId: string;
+    events: ({
+        type: "text";
+        text: string;
+        seq: number;
+        ts: string;
+    } | {
+        name: string;
+        type: "tool";
+        seq: number;
+        ts: string;
+    } | {
+        type: "notice";
+        message: string;
+        sessionId: string | null;
+        seq: number;
+        ts: string;
+    } | {
+        type: "result";
+        sessionId: string | null;
+        seq: number;
+        ts: string;
+        subtype: string;
+        result?: unknown;
+    } | {
+        type: "end";
+        sessionId: string | null;
+        seq: number;
+        ts: string;
+    } | {
+        type: "error";
+        message: string;
+        sessionId: string | null;
+        seq: number;
+        ts: string;
+    } | {
+        type: "canceled";
+        sessionId: string | null;
+        seq: number;
+        ts: string;
+    })[];
+    nextCursor: string;
+}>;
+/**
+ * `GET /api/agent-runs/capabilities` (NOT-481): only clients whose real host
+ * preflight (installed and signed in) passes are listed. `start`/`resume`
+ * name the tool profiles the client can enforce; `same_profile_provenance`
+ * means a resume continues only a session an Agent Deck run on this host
+ * started with the same deck, cwd, and tools.
+ */
+export declare const AgentRunClientCapabilitySchema: z.ZodObject<{
+    client: z.ZodEnum<["claude", "codex", "cursor", "muse"]>;
+    start: z.ZodArray<z.ZodEnum<["readonly", "edit"]>, "many">;
+    resume: z.ZodArray<z.ZodEnum<["readonly", "edit"]>, "many">;
+    resumeRequires: z.ZodEnum<["none", "same_profile_provenance"]>;
+}, "strict", z.ZodTypeAny, {
+    client: "claude" | "cursor" | "codex" | "muse";
+    start: ("readonly" | "edit")[];
+    resume: ("readonly" | "edit")[];
+    resumeRequires: "none" | "same_profile_provenance";
+}, {
+    client: "claude" | "cursor" | "codex" | "muse";
+    start: ("readonly" | "edit")[];
+    resume: ("readonly" | "edit")[];
+    resumeRequires: "none" | "same_profile_provenance";
+}>;
+export declare const AgentRunCapabilitiesResponseSchema: z.ZodObject<{
+    /** Runs execute on the Agent Deck host; `cwd` is a path on that host. */
+    host: z.ZodLiteral<"same-host">;
+    clients: z.ZodArray<z.ZodObject<{
+        client: z.ZodEnum<["claude", "codex", "cursor", "muse"]>;
+        start: z.ZodArray<z.ZodEnum<["readonly", "edit"]>, "many">;
+        resume: z.ZodArray<z.ZodEnum<["readonly", "edit"]>, "many">;
+        resumeRequires: z.ZodEnum<["none", "same_profile_provenance"]>;
+    }, "strict", z.ZodTypeAny, {
+        client: "claude" | "cursor" | "codex" | "muse";
+        start: ("readonly" | "edit")[];
+        resume: ("readonly" | "edit")[];
+        resumeRequires: "none" | "same_profile_provenance";
+    }, {
+        client: "claude" | "cursor" | "codex" | "muse";
+        start: ("readonly" | "edit")[];
+        resume: ("readonly" | "edit")[];
+        resumeRequires: "none" | "same_profile_provenance";
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    host: "same-host";
+    clients: {
+        client: "claude" | "cursor" | "codex" | "muse";
+        start: ("readonly" | "edit")[];
+        resume: ("readonly" | "edit")[];
+        resumeRequires: "none" | "same_profile_provenance";
+    }[];
+}, {
+    host: "same-host";
+    clients: {
+        client: "claude" | "cursor" | "codex" | "muse";
+        start: ("readonly" | "edit")[];
+        resume: ("readonly" | "edit")[];
+        resumeRequires: "none" | "same_profile_provenance";
+    }[];
+}>;
+/**
+ * NOT-486: one manifest entry. Repository-relative POSIX path; `sha256` is
+ * the SHA-256 of the exact working-tree bytes and `mode` the Git file mode.
+ * A deleted path carries `sha256: null` and `mode: null`.
+ */
+export declare const FINALIZATION_MANIFEST_MAX_FILES = 1000;
+export declare const FINALIZATION_PATH_MAX_CHARS = 1024;
+export declare const FINALIZATION_COMMIT_MESSAGE_MAX_CHARS = 8192;
+export declare const FINALIZATION_REVIEW_ID_MAX_CHARS = 200;
+export declare const FinalizationFileModeSchema: z.ZodEnum<["100644", "100755"]>;
+export declare const FinalizationManifestEntrySchema: z.ZodEffects<z.ZodObject<{
+    path: z.ZodString;
+    sha256: z.ZodNullable<z.ZodString>;
+    mode: z.ZodNullable<z.ZodEnum<["100644", "100755"]>>;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    mode: "100644" | "100755" | null;
+    sha256: string | null;
+}, {
+    path: string;
+    mode: "100644" | "100755" | null;
+    sha256: string | null;
+}>, {
+    path: string;
+    mode: "100644" | "100755" | null;
+    sha256: string | null;
+}, {
+    path: string;
+    mode: "100644" | "100755" | null;
+    sha256: string | null;
+}>;
+/** `GET /api/agent-runs/:runId/changes`: the candidate manifest, ordered by path. */
+export declare const AgentRunChangesResponseSchema: z.ZodObject<{
+    runId: z.ZodString;
+    baselineRef: z.ZodString;
+    baselineDigest: z.ZodString;
+    /** Pass as `expectedBaseCommit` when finalizing. */
+    baseCommit: z.ZodString;
+    files: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        path: z.ZodString;
+        sha256: z.ZodNullable<z.ZodString>;
+        mode: z.ZodNullable<z.ZodEnum<["100644", "100755"]>>;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        mode: "100644" | "100755" | null;
+        sha256: string | null;
+    }, {
+        path: string;
+        mode: "100644" | "100755" | null;
+        sha256: string | null;
+    }>, {
+        path: string;
+        mode: "100644" | "100755" | null;
+        sha256: string | null;
+    }, {
+        path: string;
+        mode: "100644" | "100755" | null;
+        sha256: string | null;
+    }>, "many">;
+    manifestDigest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    runId: string;
+    baselineRef: string;
+    baselineDigest: string;
+    baseCommit: string;
+    files: {
+        path: string;
+        mode: "100644" | "100755" | null;
+        sha256: string | null;
+    }[];
+    manifestDigest: string;
+}, {
+    runId: string;
+    baselineRef: string;
+    baselineDigest: string;
+    baseCommit: string;
+    files: {
+        path: string;
+        mode: "100644" | "100755" | null;
+        sha256: string | null;
+    }[];
+    manifestDigest: string;
+}>;
+/** `POST /api/agent-runs/:runId/finalize` (requires `Idempotency-Key`). */
+export declare const FinalizeAgentRunRequestSchema: z.ZodObject<{
+    baselineDigest: z.ZodString;
+    expectedBaseCommit: z.ZodString;
+    reviewId: z.ZodString;
+    commitMessage: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+    files: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        path: z.ZodString;
+        sha256: z.ZodNullable<z.ZodString>;
+        mode: z.ZodNullable<z.ZodEnum<["100644", "100755"]>>;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        mode: "100644" | "100755" | null;
+        sha256: string | null;
+    }, {
+        path: string;
+        mode: "100644" | "100755" | null;
+        sha256: string | null;
+    }>, {
+        path: string;
+        mode: "100644" | "100755" | null;
+        sha256: string | null;
+    }, {
+        path: string;
+        mode: "100644" | "100755" | null;
+        sha256: string | null;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    baselineDigest: string;
+    files: {
+        path: string;
+        mode: "100644" | "100755" | null;
+        sha256: string | null;
+    }[];
+    expectedBaseCommit: string;
+    reviewId: string;
+    commitMessage: string;
+}, {
+    baselineDigest: string;
+    files: {
+        path: string;
+        mode: "100644" | "100755" | null;
+        sha256: string | null;
+    }[];
+    expectedBaseCommit: string;
+    reviewId: string;
+    commitMessage: string;
+}>;
+export declare const FinalizeAgentRunResponseSchema: z.ZodObject<{
+    runId: z.ZodString;
+    finalizationState: z.ZodLiteral<"finalized">;
+    commit: z.ZodString;
+    tree: z.ZodString;
+    parent: z.ZodString;
+    manifestDigest: z.ZodString;
+    fileCount: z.ZodNumber;
+    reviewId: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    runId: string;
+    commit: string;
+    manifestDigest: string;
+    reviewId: string;
+    finalizationState: "finalized";
+    tree: string;
+    parent: string;
+    fileCount: number;
+}, {
+    runId: string;
+    commit: string;
+    manifestDigest: string;
+    reviewId: string;
+    finalizationState: "finalized";
+    tree: string;
+    parent: string;
+    fileCount: number;
+}>;
+/** Run-specific error codes (auth failures use the trusted-session codes). */
+export declare const AgentRunErrorCodeSchema: z.ZodEnum<["INVALID_REQUEST", "REQUEST_TOO_LARGE", "IDEMPOTENCY_KEY_REQUIRED", "IDEMPOTENCY_CONFLICT", "DECK_NOT_FOUND", "WORKSPACE_INVALID", "WORKSPACE_MISMATCH", "CLIENT_UNAVAILABLE", "PROFILE_UNSUPPORTED", "RESUME_UNVERIFIED", "RUN_NOT_FOUND", "RUN_NOT_CANCELABLE", "FINALIZATION_INVALID", "FINALIZATION_NOT_PREPARED", "RUN_NOT_TERMINAL", "BASE_MISMATCH", "INDEX_DIRTY", "BASELINE_MISMATCH", "PATH_INVALID", "PATH_UNEXPECTED", "DIGEST_MISMATCH", "GIT_LOCK_CONFLICT", "REF_RACE", "FINALIZATION_CANCELED", "FINALIZATION_FAILED"]>;
+export type AgentRunClient = z.infer<typeof AgentRunClientSchema>;
+export type AgentRunTools = z.infer<typeof AgentRunToolsSchema>;
+export type CreateAgentRunRequest = z.infer<typeof CreateAgentRunRequestSchema>;
+export type CreateAgentRunResponse = z.infer<typeof CreateAgentRunResponseSchema>;
+export type AgentRunState = z.infer<typeof AgentRunStateSchema>;
+export type AgentRunStatus = z.infer<typeof AgentRunStatusSchema>;
+export type AgentRunEvent = z.infer<typeof AgentRunEventSchema>;
+export type AgentRunEventsQuery = z.infer<typeof AgentRunEventsQuerySchema>;
+export type AgentRunEventsResponse = z.infer<typeof AgentRunEventsResponseSchema>;
+export type AgentRunErrorCode = z.infer<typeof AgentRunErrorCodeSchema>;
+export type AgentRunClientCapability = z.infer<typeof AgentRunClientCapabilitySchema>;
+export type AgentRunCapabilitiesResponse = z.infer<typeof AgentRunCapabilitiesResponseSchema>;
+export type FinalizationState = z.infer<typeof FinalizationStateSchema>;
+export type AgentRunFinalizationStatus = z.infer<typeof AgentRunFinalizationStatusSchema>;
+export type FinalizationFileMode = z.infer<typeof FinalizationFileModeSchema>;
+export type FinalizationManifestEntry = z.infer<typeof FinalizationManifestEntrySchema>;
+export type AgentRunChangesResponse = z.infer<typeof AgentRunChangesResponseSchema>;
+export type FinalizeAgentRunRequest = z.infer<typeof FinalizeAgentRunRequestSchema>;
+export type FinalizeAgentRunResponse = z.infer<typeof FinalizeAgentRunResponseSchema>;
+export type AgentRunErrorBody = {
+    success: false;
+    error: string;
+    error_code: AgentRunErrorCode;
+};
+export declare function agentRunError(code: AgentRunErrorCode, message: string): AgentRunErrorBody;
+//# sourceMappingURL=agent-run.d.ts.map