@bridge4dev/runner 0.11.0 → 0.22.1

package/dist/protocol.d.ts

@@ -19,22 +19,31 @@ export declare const SessionDescriptorSchema: z.ZodObject<{
         path: z.ZodString;
         projectId: z.ZodString;
         trustMode: z.ZodEnum<["STRICT", "NORMAL", "AUTO"]>;
+        /**
+         * Session 15. Optional: an API older than this release does not send it,
+         * and «not said» must keep the behaviour every deployed runner has now —
+         * inventing a restriction from silence would stop agents committing on
+         * every project the moment a runner updated ahead of its API.
+         */
+        agentAutoCommit: z.ZodOptional<z.ZodBoolean>;
         budgetUsd: z.ZodNullable<z.ZodNumber>;
         budgetMinutes: z.ZodNullable<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        path: string;
         id: string;
+        path: string;
         projectId: string;
         trustMode: "STRICT" | "NORMAL" | "AUTO";
         budgetUsd: number | null;
         budgetMinutes: number | null;
+        agentAutoCommit?: boolean | undefined;
     }, {
-        path: string;
         id: string;
+        path: string;
         projectId: string;
         trustMode: "STRICT" | "NORMAL" | "AUTO";
         budgetUsd: number | null;
         budgetMinutes: number | null;
+        agentAutoCommit?: boolean | undefined;
     }>;
     tickets: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -50,6 +59,54 @@ export declare const SessionDescriptorSchema: z.ZodObject<{
         title: string;
     }>, "many">;
     branchHint: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+    /**
+     * Session 13: the branch as a decision rather than a coincidence.
+     *
+     * `branchHint` said «call it this if you like»; the runner then guessed what
+     * to do about a name that already existed (silently reuse it) or did not
+     * (create it off whatever the folder was on). Both guesses lose work. The
+     * plan says which of the two the API meant, and the runner fails loudly when
+     * reality disagrees.
+     *
+     * `.catch(undefined)` for the same reason as `branchHint`: this field travels
+     * inside hello_ack, which carries EVERY session of the server, so one
+     * malformed plan must cost its own session at most — never the frame
+     * (QA-100 MAJOR-1). Falling back to `branchHint` restores exactly the old
+     * behaviour.
+     */
+    branchPlan: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        branch: z.ZodString;
+        source: z.ZodEnum<["NEW", "CONTINUE"]>;
+        baseBranch: z.ZodOptional<z.ZodString>;
+        baseSha: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        branch: string;
+        source: "NEW" | "CONTINUE";
+        baseBranch?: string | undefined;
+        baseSha?: string | undefined;
+    }, {
+        branch: string;
+        source: "NEW" | "CONTINUE";
+        baseBranch?: string | undefined;
+        baseSha?: string | undefined;
+    }>>>;
+    /**
+     * Where this session works (session 16).
+     *
+     * `DIRECT` — in the project folder itself, on the branch it is already on.
+     * There is no worktree, no session branch and no «Apply»: the work is already
+     * where the person wanted it. This is the ordinary case, because the person
+     * runs their own terminal agents in that same folder anyway — we were paying
+     * the whole price of isolation and not getting any.
+     *
+     * `BRANCH` — the historical worktree-and-branch arrangement. The API hands it
+     * out when the folder is already taken by another live session, because two
+     * agents in one folder fight exactly the way a human and an agent do.
+     *
+     * Optional, and absent means `BRANCH`: an API older than this release says
+     * nothing, and silence must keep the behaviour every deployed runner has now.
+     */
+    workMode: z.ZodCatch<z.ZodOptional<z.ZodEnum<["DIRECT", "BRANCH"]>>>;
     mcp: z.ZodOptional<z.ZodObject<{
         url: z.ZodString;
         token: z.ZodString;
@@ -62,26 +119,27 @@ export declare const SessionDescriptorSchema: z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     mode: "ask" | "plan" | "auto" | "full";
-    status: "STARTING" | "RUNNING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "FAILED" | "STOPPED";
-    agent: "CLAUDE" | "CODEX";
+    status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
     id: string;
+    agent: "CLAUDE" | "CODEX";
     kind: "TICKET" | "CHAT";
     model: string | null;
     effort: string | null;
-    epoch: number;
     prompt: string;
+    epoch: number;
     providerSessionId: string | null;
     lastSeq: number;
     costUsd: number;
     activeMsBase: number;
     extraBudgetMinutes: number | null;
     workspace: {
-        path: string;
         id: string;
+        path: string;
         projectId: string;
         trustMode: "STRICT" | "NORMAL" | "AUTO";
         budgetUsd: number | null;
         budgetMinutes: number | null;
+        agentAutoCommit?: boolean | undefined;
     };
     tickets: {
         number: number;
@@ -93,20 +151,28 @@ export declare const SessionDescriptorSchema: z.ZodObject<{
         token: string;
     } | undefined;
     branchHint?: string | undefined;
+    branchPlan?: {
+        branch: string;
+        source: "NEW" | "CONTINUE";
+        baseBranch?: string | undefined;
+        baseSha?: string | undefined;
+    } | undefined;
+    workMode?: "DIRECT" | "BRANCH" | undefined;
 }, {
-    status: "STARTING" | "RUNNING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "FAILED" | "STOPPED";
-    agent: "CLAUDE" | "CODEX";
+    status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
     id: string;
+    agent: "CLAUDE" | "CODEX";
     kind: "TICKET" | "CHAT";
     prompt: string;
     providerSessionId: string | null;
     workspace: {
-        path: string;
         id: string;
+        path: string;
         projectId: string;
         trustMode: "STRICT" | "NORMAL" | "AUTO";
         budgetUsd: number | null;
         budgetMinutes: number | null;
+        agentAutoCommit?: boolean | undefined;
     };
     tickets: {
         number: number;
@@ -126,6 +192,8 @@ export declare const SessionDescriptorSchema: z.ZodObject<{
     activeMsBase?: number | undefined;
     extraBudgetMinutes?: number | null | undefined;
     branchHint?: unknown;
+    branchPlan?: unknown;
+    workMode?: unknown;
 }>;
 export type SessionDescriptor = z.infer<typeof SessionDescriptorSchema>;
 export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
@@ -153,22 +221,31 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             path: z.ZodString;
             projectId: z.ZodString;
             trustMode: z.ZodEnum<["STRICT", "NORMAL", "AUTO"]>;
+            /**
+             * Session 15. Optional: an API older than this release does not send it,
+             * and «not said» must keep the behaviour every deployed runner has now —
+             * inventing a restriction from silence would stop agents committing on
+             * every project the moment a runner updated ahead of its API.
+             */
+            agentAutoCommit: z.ZodOptional<z.ZodBoolean>;
             budgetUsd: z.ZodNullable<z.ZodNumber>;
             budgetMinutes: z.ZodNullable<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
-            path: string;
             id: string;
+            path: string;
             projectId: string;
             trustMode: "STRICT" | "NORMAL" | "AUTO";
             budgetUsd: number | null;
             budgetMinutes: number | null;
+            agentAutoCommit?: boolean | undefined;
         }, {
-            path: string;
             id: string;
+            path: string;
             projectId: string;
             trustMode: "STRICT" | "NORMAL" | "AUTO";
             budgetUsd: number | null;
             budgetMinutes: number | null;
+            agentAutoCommit?: boolean | undefined;
         }>;
         tickets: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -184,6 +261,54 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             title: string;
         }>, "many">;
         branchHint: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+        /**
+         * Session 13: the branch as a decision rather than a coincidence.
+         *
+         * `branchHint` said «call it this if you like»; the runner then guessed what
+         * to do about a name that already existed (silently reuse it) or did not
+         * (create it off whatever the folder was on). Both guesses lose work. The
+         * plan says which of the two the API meant, and the runner fails loudly when
+         * reality disagrees.
+         *
+         * `.catch(undefined)` for the same reason as `branchHint`: this field travels
+         * inside hello_ack, which carries EVERY session of the server, so one
+         * malformed plan must cost its own session at most — never the frame
+         * (QA-100 MAJOR-1). Falling back to `branchHint` restores exactly the old
+         * behaviour.
+         */
+        branchPlan: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            branch: z.ZodString;
+            source: z.ZodEnum<["NEW", "CONTINUE"]>;
+            baseBranch: z.ZodOptional<z.ZodString>;
+            baseSha: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            branch: string;
+            source: "NEW" | "CONTINUE";
+            baseBranch?: string | undefined;
+            baseSha?: string | undefined;
+        }, {
+            branch: string;
+            source: "NEW" | "CONTINUE";
+            baseBranch?: string | undefined;
+            baseSha?: string | undefined;
+        }>>>;
+        /**
+         * Where this session works (session 16).
+         *
+         * `DIRECT` — in the project folder itself, on the branch it is already on.
+         * There is no worktree, no session branch and no «Apply»: the work is already
+         * where the person wanted it. This is the ordinary case, because the person
+         * runs their own terminal agents in that same folder anyway — we were paying
+         * the whole price of isolation and not getting any.
+         *
+         * `BRANCH` — the historical worktree-and-branch arrangement. The API hands it
+         * out when the folder is already taken by another live session, because two
+         * agents in one folder fight exactly the way a human and an agent do.
+         *
+         * Optional, and absent means `BRANCH`: an API older than this release says
+         * nothing, and silence must keep the behaviour every deployed runner has now.
+         */
+        workMode: z.ZodCatch<z.ZodOptional<z.ZodEnum<["DIRECT", "BRANCH"]>>>;
         mcp: z.ZodOptional<z.ZodObject<{
             url: z.ZodString;
             token: z.ZodString;
@@ -196,26 +321,27 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
         }>>;
     }, "strip", z.ZodTypeAny, {
         mode: "ask" | "plan" | "auto" | "full";
-        status: "STARTING" | "RUNNING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "FAILED" | "STOPPED";
-        agent: "CLAUDE" | "CODEX";
+        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         id: string;
+        agent: "CLAUDE" | "CODEX";
         kind: "TICKET" | "CHAT";
         model: string | null;
         effort: string | null;
-        epoch: number;
         prompt: string;
+        epoch: number;
         providerSessionId: string | null;
         lastSeq: number;
         costUsd: number;
         activeMsBase: number;
         extraBudgetMinutes: number | null;
         workspace: {
-            path: string;
             id: string;
+            path: string;
             projectId: string;
             trustMode: "STRICT" | "NORMAL" | "AUTO";
             budgetUsd: number | null;
             budgetMinutes: number | null;
+            agentAutoCommit?: boolean | undefined;
         };
         tickets: {
             number: number;
@@ -227,20 +353,28 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             token: string;
         } | undefined;
         branchHint?: string | undefined;
+        branchPlan?: {
+            branch: string;
+            source: "NEW" | "CONTINUE";
+            baseBranch?: string | undefined;
+            baseSha?: string | undefined;
+        } | undefined;
+        workMode?: "DIRECT" | "BRANCH" | undefined;
     }, {
-        status: "STARTING" | "RUNNING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "FAILED" | "STOPPED";
-        agent: "CLAUDE" | "CODEX";
+        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         id: string;
+        agent: "CLAUDE" | "CODEX";
         kind: "TICKET" | "CHAT";
         prompt: string;
         providerSessionId: string | null;
         workspace: {
-            path: string;
             id: string;
+            path: string;
             projectId: string;
             trustMode: "STRICT" | "NORMAL" | "AUTO";
             budgetUsd: number | null;
             budgetMinutes: number | null;
+            agentAutoCommit?: boolean | undefined;
         };
         tickets: {
             number: number;
@@ -260,6 +394,8 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
         activeMsBase?: number | undefined;
         extraBudgetMinutes?: number | null | undefined;
         branchHint?: unknown;
+        branchPlan?: unknown;
+        workMode?: unknown;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     type: "hello_ack";
@@ -267,26 +403,27 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
     serverId: string;
     sessions: {
         mode: "ask" | "plan" | "auto" | "full";
-        status: "STARTING" | "RUNNING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "FAILED" | "STOPPED";
-        agent: "CLAUDE" | "CODEX";
+        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         id: string;
+        agent: "CLAUDE" | "CODEX";
         kind: "TICKET" | "CHAT";
         model: string | null;
         effort: string | null;
-        epoch: number;
         prompt: string;
+        epoch: number;
         providerSessionId: string | null;
         lastSeq: number;
         costUsd: number;
         activeMsBase: number;
         extraBudgetMinutes: number | null;
         workspace: {
-            path: string;
             id: string;
+            path: string;
             projectId: string;
             trustMode: "STRICT" | "NORMAL" | "AUTO";
             budgetUsd: number | null;
             budgetMinutes: number | null;
+            agentAutoCommit?: boolean | undefined;
         };
         tickets: {
             number: number;
@@ -298,6 +435,13 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             token: string;
         } | undefined;
         branchHint?: string | undefined;
+        branchPlan?: {
+            branch: string;
+            source: "NEW" | "CONTINUE";
+            baseBranch?: string | undefined;
+            baseSha?: string | undefined;
+        } | undefined;
+        workMode?: "DIRECT" | "BRANCH" | undefined;
     }[];
     maxSessions?: number | undefined;
 }, {
@@ -305,19 +449,20 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
     serverName: string;
     serverId: string;
     sessions: {
-        status: "STARTING" | "RUNNING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "FAILED" | "STOPPED";
-        agent: "CLAUDE" | "CODEX";
+        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         id: string;
+        agent: "CLAUDE" | "CODEX";
         kind: "TICKET" | "CHAT";
         prompt: string;
         providerSessionId: string | null;
         workspace: {
-            path: string;
             id: string;
+            path: string;
             projectId: string;
             trustMode: "STRICT" | "NORMAL" | "AUTO";
             budgetUsd: number | null;
             budgetMinutes: number | null;
+            agentAutoCommit?: boolean | undefined;
         };
         tickets: {
             number: number;
@@ -337,6 +482,8 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
         activeMsBase?: number | undefined;
         extraBudgetMinutes?: number | null | undefined;
         branchHint?: unknown;
+        branchPlan?: unknown;
+        workMode?: unknown;
     }[];
     maxSessions?: unknown;
 }>, z.ZodObject<{
@@ -344,12 +491,12 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
     sessionId: z.ZodString;
     seq: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
-    type: "event_ack";
     sessionId: string;
+    type: "event_ack";
     seq: number;
 }, {
-    type: "event_ack";
     sessionId: string;
+    type: "event_ack";
     seq: number;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"event_nack">;
@@ -358,13 +505,13 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
     reason: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     reason: string;
-    type: "event_nack";
     sessionId: string;
+    type: "event_nack";
     seq: number;
 }, {
     reason: string;
-    type: "event_nack";
     sessionId: string;
+    type: "event_nack";
     seq: number;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"session_start">;
@@ -388,22 +535,31 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             path: z.ZodString;
             projectId: z.ZodString;
             trustMode: z.ZodEnum<["STRICT", "NORMAL", "AUTO"]>;
+            /**
+             * Session 15. Optional: an API older than this release does not send it,
+             * and «not said» must keep the behaviour every deployed runner has now —
+             * inventing a restriction from silence would stop agents committing on
+             * every project the moment a runner updated ahead of its API.
+             */
+            agentAutoCommit: z.ZodOptional<z.ZodBoolean>;
             budgetUsd: z.ZodNullable<z.ZodNumber>;
             budgetMinutes: z.ZodNullable<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
-            path: string;
             id: string;
+            path: string;
             projectId: string;
             trustMode: "STRICT" | "NORMAL" | "AUTO";
             budgetUsd: number | null;
             budgetMinutes: number | null;
+            agentAutoCommit?: boolean | undefined;
         }, {
-            path: string;
             id: string;
+            path: string;
             projectId: string;
             trustMode: "STRICT" | "NORMAL" | "AUTO";
             budgetUsd: number | null;
             budgetMinutes: number | null;
+            agentAutoCommit?: boolean | undefined;
         }>;
         tickets: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -419,6 +575,54 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             title: string;
         }>, "many">;
         branchHint: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+        /**
+         * Session 13: the branch as a decision rather than a coincidence.
+         *
+         * `branchHint` said «call it this if you like»; the runner then guessed what
+         * to do about a name that already existed (silently reuse it) or did not
+         * (create it off whatever the folder was on). Both guesses lose work. The
+         * plan says which of the two the API meant, and the runner fails loudly when
+         * reality disagrees.
+         *
+         * `.catch(undefined)` for the same reason as `branchHint`: this field travels
+         * inside hello_ack, which carries EVERY session of the server, so one
+         * malformed plan must cost its own session at most — never the frame
+         * (QA-100 MAJOR-1). Falling back to `branchHint` restores exactly the old
+         * behaviour.
+         */
+        branchPlan: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            branch: z.ZodString;
+            source: z.ZodEnum<["NEW", "CONTINUE"]>;
+            baseBranch: z.ZodOptional<z.ZodString>;
+            baseSha: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            branch: string;
+            source: "NEW" | "CONTINUE";
+            baseBranch?: string | undefined;
+            baseSha?: string | undefined;
+        }, {
+            branch: string;
+            source: "NEW" | "CONTINUE";
+            baseBranch?: string | undefined;
+            baseSha?: string | undefined;
+        }>>>;
+        /**
+         * Where this session works (session 16).
+         *
+         * `DIRECT` — in the project folder itself, on the branch it is already on.
+         * There is no worktree, no session branch and no «Apply»: the work is already
+         * where the person wanted it. This is the ordinary case, because the person
+         * runs their own terminal agents in that same folder anyway — we were paying
+         * the whole price of isolation and not getting any.
+         *
+         * `BRANCH` — the historical worktree-and-branch arrangement. The API hands it
+         * out when the folder is already taken by another live session, because two
+         * agents in one folder fight exactly the way a human and an agent do.
+         *
+         * Optional, and absent means `BRANCH`: an API older than this release says
+         * nothing, and silence must keep the behaviour every deployed runner has now.
+         */
+        workMode: z.ZodCatch<z.ZodOptional<z.ZodEnum<["DIRECT", "BRANCH"]>>>;
         mcp: z.ZodOptional<z.ZodObject<{
             url: z.ZodString;
             token: z.ZodString;
@@ -431,26 +635,27 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
         }>>;
     }, "strip", z.ZodTypeAny, {
         mode: "ask" | "plan" | "auto" | "full";
-        status: "STARTING" | "RUNNING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "FAILED" | "STOPPED";
-        agent: "CLAUDE" | "CODEX";
+        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         id: string;
+        agent: "CLAUDE" | "CODEX";
         kind: "TICKET" | "CHAT";
         model: string | null;
         effort: string | null;
-        epoch: number;
         prompt: string;
+        epoch: number;
         providerSessionId: string | null;
         lastSeq: number;
         costUsd: number;
         activeMsBase: number;
         extraBudgetMinutes: number | null;
         workspace: {
-            path: string;
             id: string;
+            path: string;
             projectId: string;
             trustMode: "STRICT" | "NORMAL" | "AUTO";
             budgetUsd: number | null;
             budgetMinutes: number | null;
+            agentAutoCommit?: boolean | undefined;
         };
         tickets: {
             number: number;
@@ -462,20 +667,28 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             token: string;
         } | undefined;
         branchHint?: string | undefined;
+        branchPlan?: {
+            branch: string;
+            source: "NEW" | "CONTINUE";
+            baseBranch?: string | undefined;
+            baseSha?: string | undefined;
+        } | undefined;
+        workMode?: "DIRECT" | "BRANCH" | undefined;
     }, {
-        status: "STARTING" | "RUNNING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "FAILED" | "STOPPED";
-        agent: "CLAUDE" | "CODEX";
+        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         id: string;
+        agent: "CLAUDE" | "CODEX";
         kind: "TICKET" | "CHAT";
         prompt: string;
         providerSessionId: string | null;
         workspace: {
-            path: string;
             id: string;
+            path: string;
             projectId: string;
             trustMode: "STRICT" | "NORMAL" | "AUTO";
             budgetUsd: number | null;
             budgetMinutes: number | null;
+            agentAutoCommit?: boolean | undefined;
         };
         tickets: {
             number: number;
@@ -495,31 +708,34 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
         activeMsBase?: number | undefined;
         extraBudgetMinutes?: number | null | undefined;
         branchHint?: unknown;
+        branchPlan?: unknown;
+        workMode?: unknown;
     }>;
 }, "strip", z.ZodTypeAny, {
     type: "session_start";
     session: {
         mode: "ask" | "plan" | "auto" | "full";
-        status: "STARTING" | "RUNNING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "FAILED" | "STOPPED";
-        agent: "CLAUDE" | "CODEX";
+        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         id: string;
+        agent: "CLAUDE" | "CODEX";
         kind: "TICKET" | "CHAT";
         model: string | null;
         effort: string | null;
-        epoch: number;
         prompt: string;
+        epoch: number;
         providerSessionId: string | null;
         lastSeq: number;
         costUsd: number;
         activeMsBase: number;
         extraBudgetMinutes: number | null;
         workspace: {
-            path: string;
             id: string;
+            path: string;
             projectId: string;
             trustMode: "STRICT" | "NORMAL" | "AUTO";
             budgetUsd: number | null;
             budgetMinutes: number | null;
+            agentAutoCommit?: boolean | undefined;
         };
         tickets: {
             number: number;
@@ -531,23 +747,31 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             token: string;
         } | undefined;
         branchHint?: string | undefined;
+        branchPlan?: {
+            branch: string;
+            source: "NEW" | "CONTINUE";
+            baseBranch?: string | undefined;
+            baseSha?: string | undefined;
+        } | undefined;
+        workMode?: "DIRECT" | "BRANCH" | undefined;
     };
 }, {
     type: "session_start";
     session: {
-        status: "STARTING" | "RUNNING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "FAILED" | "STOPPED";
-        agent: "CLAUDE" | "CODEX";
+        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         id: string;
+        agent: "CLAUDE" | "CODEX";
         kind: "TICKET" | "CHAT";
         prompt: string;
         providerSessionId: string | null;
         workspace: {
-            path: string;
             id: string;
+            path: string;
             projectId: string;
             trustMode: "STRICT" | "NORMAL" | "AUTO";
             budgetUsd: number | null;
             budgetMinutes: number | null;
+            agentAutoCommit?: boolean | undefined;
         };
         tickets: {
             number: number;
@@ -567,6 +791,8 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
         activeMsBase?: number | undefined;
         extraBudgetMinutes?: number | null | undefined;
         branchHint?: unknown;
+        branchPlan?: unknown;
+        workMode?: unknown;
     };
 }>, z.ZodObject<{
     type: z.ZodLiteral<"session_message">;
@@ -589,9 +815,9 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
         fileSize: number;
     }>, "many">>>;
 }, "strip", z.ZodTypeAny, {
+    sessionId: string;
     type: "session_message";
     text: string;
-    sessionId: string;
     attachments?: {
         id: string;
         fileName: string;
@@ -599,9 +825,9 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
         fileSize: number;
     }[] | undefined;
 }, {
+    sessionId: string;
     type: "session_message";
     text: string;
-    sessionId: string;
     attachments?: unknown;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"permission_answer">;
@@ -611,34 +837,80 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
     note: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     allow: boolean;
+    sessionId: string;
     type: "permission_answer";
     requestId: string;
-    sessionId: string;
     note?: string | undefined;
 }, {
     allow: boolean;
+    sessionId: string;
     type: "permission_answer";
     requestId: string;
-    sessionId: string;
     note?: string | undefined;
 }>, z.ZodObject<{
-    type: z.ZodLiteral<"session_stop">;
+    type: z.ZodLiteral<"question_answer">;
     sessionId: z.ZodString;
+    askId: z.ZodString;
+    action: z.ZodEnum<["answer", "discuss"]>;
+    answers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        questionId: z.ZodString;
+        values: z.ZodArray<z.ZodString, "many">;
+        custom: z.ZodOptional<z.ZodString>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        values: string[];
+        questionId: string;
+        custom?: string | undefined;
+        notes?: string | undefined;
+    }, {
+        values: string[];
+        questionId: string;
+        custom?: string | undefined;
+        notes?: string | undefined;
+    }>, "many">>;
+    text: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    type: "session_stop";
     sessionId: string;
+    type: "question_answer";
+    askId: string;
+    action: "answer" | "discuss";
+    text?: string | undefined;
+    answers?: {
+        values: string[];
+        questionId: string;
+        custom?: string | undefined;
+        notes?: string | undefined;
+    }[] | undefined;
 }, {
+    sessionId: string;
+    type: "question_answer";
+    askId: string;
+    action: "answer" | "discuss";
+    text?: string | undefined;
+    answers?: {
+        values: string[];
+        questionId: string;
+        custom?: string | undefined;
+        notes?: string | undefined;
+    }[] | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"session_stop">;
+    sessionId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
     type: "session_stop";
+}, {
     sessionId: string;
+    type: "session_stop";
 }>, z.ZodObject<{
     type: z.ZodLiteral<"session_interrupt">;
     sessionId: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    type: "session_interrupt";
     sessionId: string;
-}, {
     type: "session_interrupt";
+}, {
     sessionId: string;
+    type: "session_interrupt";
 }>, z.ZodObject<{
     type: z.ZodLiteral<"server_settings">;
     maxSessions: z.ZodCatch<z.ZodOptional<z.ZodNumber>>;
@@ -648,6 +920,21 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
 }, {
     type: "server_settings";
     maxSessions?: unknown;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"workspace_settings">;
+    workspaceId: z.ZodString;
+    trustMode: z.ZodOptional<z.ZodEnum<["STRICT", "NORMAL", "AUTO"]>>;
+    agentAutoCommit: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "workspace_settings";
+    workspaceId: string;
+    agentAutoCommit?: boolean | undefined;
+    trustMode?: "STRICT" | "NORMAL" | "AUTO" | undefined;
+}, {
+    type: "workspace_settings";
+    workspaceId: string;
+    agentAutoCommit?: boolean | undefined;
+    trustMode?: "STRICT" | "NORMAL" | "AUTO" | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"session_settings">;
     sessionId: z.ZodString;
@@ -655,14 +942,14 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
     mode: z.ZodOptional<z.ZodEnum<["ask", "plan", "auto", "full"]>>;
     effort: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
-    type: "session_settings";
     sessionId: string;
+    type: "session_settings";
     mode?: "ask" | "plan" | "auto" | "full" | undefined;
     model?: string | undefined;
     effort?: string | null | undefined;
 }, {
-    type: "session_settings";
     sessionId: string;
+    type: "session_settings";
     mode?: "ask" | "plan" | "auto" | "full" | undefined;
     model?: string | undefined;
     effort?: string | null | undefined;
@@ -675,18 +962,27 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
     args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     type: "command";
-    name: string;
     requestId: string;
-    args?: Record<string, unknown> | undefined;
+    name: string;
     sessionId?: string | undefined;
     workspaceId?: string | undefined;
+    args?: Record<string, unknown> | undefined;
 }, {
     type: "command";
-    name: string;
     requestId: string;
-    args?: Record<string, unknown> | undefined;
+    name: string;
     sessionId?: string | undefined;
     workspaceId?: string | undefined;
+    args?: Record<string, unknown> | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"verify_report_ack">;
+    runId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "verify_report_ack";
+    runId: string;
+}, {
+    type: "verify_report_ack";
+    runId: string;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"revoked">;
     reason: z.ZodString;
@@ -722,11 +1018,25 @@ export type RunnerFrame = {
 } | {
     type: 'session_status';
     sessionId: string;
-    status: Exclude<SessionStatusValue, 'STARTING'>;
+    /**
+     * `DONE` left this union in session 13. It used to mean «applied», and
+     * the runner never sent it — but the schema accepted it, and now that
+     * `DONE` means «a human closed this session» a runner bug could close a
+     * session on the user's behalf. The API rejects it too.
+     */
+    status: Exclude<SessionStatusValue, 'STARTING' | 'DONE'>;
     costUsd?: number;
     providerSessionId?: string;
     branch?: string;
     worktreePath?: string;
+    /**
+     * The fork point, reported once when the runner creates the branch. The
+     * API pins the FIRST value it hears and never recomputes it — «the base»
+     * used to be re-derived on every call as whatever the project folder was
+     * checked out on.
+     */
+    baseBranch?: string;
+    baseSha?: string;
     errorMessage?: string;
     /** Why it ended, when the reason is worth naming rather than an error. */
     endReason?: 'TIME_BUDGET' | 'COST_BUDGET';
@@ -748,6 +1058,18 @@ export type RunnerFrame = {
     ok: boolean;
     result?: unknown;
     error?: string;
+}
+/**
+ * Session 14: the verdict of a verification run.
+ *
+ * Its own frame, not a command answer — `verify_start` returns as soon as the
+ * process is up, and the build finishes minutes later, long after any relay
+ * would have timed out and quite possibly after the browser tab was closed.
+ * Redelivered from the on-disk queue on every reconnect until acked.
+ */
+ | {
+    type: 'verify_report';
+    report: Record<string, unknown>;
 } | {
     type: 'pong';
 };