@kosuke-ai/kosuke 1.0.25 → 1.0.27

package/openapi.json

@@ -550,7 +550,7 @@
     "/api/chat-sessions": {
       "get": {
         "operationId": "sessionsListAll",
-        "summary": "List chat sessions across every workspace you belong to, each with its workspace, project, URL and Needs You reason. q narrows them to titles containing it, ids to the sessions it names. With needsYou, at most 100, most severe first. An agent token reads its own workspace only. Each session carries waitingForDeploy: true while it waits for the Deploy to finish, false once the Deploy ends, before its sandbox starts; goAheadSha and goAheadMerges, its go-ahead on its open pull request; and mergeRule, its Assignee's Merge rule.",
+        "summary": "List chat sessions across every workspace you belong to, each with its workspace, project, URL and Needs You reason. q narrows them to titles containing it, ids to the sessions it names. With needsYou, at most 100, most severe first. An agent token reads its own workspace only. Each session carries waitingForDeploy: true while it waits for the Deploy to finish, false once the Deploy ends, before its sandbox starts; goAheadSha, the head its open pull request has the go-ahead on; and mergeRule, its Assignee's Merge rule.",
         "tags": ["sessions"],
         "x-kosuke-command": ["sessions", "list"],
         "x-kosuke-variant": {
@@ -909,7 +909,7 @@
       },
       "delete": {
         "operationId": "devicesLocksDelete",
-        "summary": "From a Chat Session: let a device go as soon as you are done with it, after QA say, rather than at the end of your Turn, and leave its line if you wait in it. The next session in line gets it at once. Your approval stays: a later mac command or devices locks create takes the device again. Answers released and leftQueue.",
+        "summary": "From a Chat Session: let a device go as soon as you are done with it, after QA say, rather than at the end of your Turn, and leave its line if you wait in it. The next session in line gets it at once. Your access stays: a later mac command or devices locks create takes the device again. Answers released and leftQueue.",
         "tags": ["devices"],
         "x-kosuke-command": ["devices", "locks", "delete"],
         "x-kosuke-sandbox-token": true,
@@ -961,7 +961,7 @@
     "/api/devices/{deviceId}/requests": {
       "post": {
         "operationId": "devicesRequestsCreate",
-        "summary": "From a Chat Session: ask to use one device from devices list, with the reason the approver reads on a card in this session's chat. A personal Mac's owner approves it, a workspace device's any workspace admin, once per session: after that, asking again answers approved at once. Answers status pending or approved. Check devices list again for the answer; it expires after 30 minutes without an answer. While it is pending, go on with other work; when it is declined or expires, go on without it and say so. Once approved it stays approved for the rest of the session: pass --device-id on every mac command. One session at a time uses the device: on MAC_BUSY, wait with devices locks create, and run devices locks delete once done.",
+        "summary": "From a Chat Session: ask to use a personal Mac from devices list, with the reason its owner reads on a card in this session's chat. A workspace device needs no request: it answers approved at once with grantId null, and no one is asked. The owner approves a personal Mac once per session: after that, asking again answers approved at once. Answers status pending or approved. Check devices list again for the answer; it expires after 30 minutes without an answer. While it is pending, go on with other work; when it is declined or expires, go on without it and say so. Once approved it stays approved for the rest of the session: pass --device-id on every mac command. One session at a time uses the device: on MAC_BUSY, wait with devices locks create, and run devices locks delete once done.",
         "tags": ["devices"],
         "x-kosuke-command": ["devices", "requests", "create"],
         "x-kosuke-sandbox-token": true,
@@ -987,7 +987,7 @@
                     "type": "string",
                     "minLength": 1,
                     "maxLength": 500,
-                    "description": "One or two sentences for the approver: what you test on it, and why a real Mac."
+                    "description": "One or two sentences for the Mac’s owner: what you test on it, and why a real Mac."
                   }
                 },
                 "required": ["reason"]
@@ -1032,7 +1032,7 @@
     "/api/devices/available": {
       "get": {
         "operationId": "devicesList",
-        "summary": "From a Chat Session: the devices it may ask for, the workspace's devices and the session member's own Macs, each with its id, kind, whether it is online, the tools it offers, its macOS grants (grants.systemEvents: menu bar icons open with `osascript` through System Events), this session's access: none, pending or approved, and occupied with occupiedBy (session or sensei) when someone else uses it now. Pick an online device with the tools the test needs: a workspace device first, and the member's own Mac only when no workspace device fits, whatever the names or past approvals. Of those, pick a free one, and ask for an occupied one only when no free device fits. Request one with `kosuke devices requests create` before any mac command, and use one only when the test truly needs a real Mac. One session at a time uses a device: on MAC_BUSY, wait in its line with `kosuke devices locks create` rather than give up or call again, and let it go with `kosuke devices locks delete` once done.",
+        "summary": "From a Chat Session: the devices it may use, the workspace's devices and the session member's own Macs, each with its id, kind, whether it is online, the tools it offers, its macOS grants (grants.systemEvents: menu bar icons open with `osascript` through System Events), this session's access: none, pending or approved (a workspace device is always approved: it needs no request), and occupied with occupiedBy (session or sensei) when someone else uses it now. Pick an online device with the tools the test needs: a workspace device first, and the member's own Mac only when no workspace device fits, whatever the names or past approvals. Of those, pick a free one, and ask for an occupied one only when no free device fits. Use a workspace device at once with --device-id; request a personal Mac with `kosuke devices requests create` before any mac command on it. Use a device only when the test truly needs a real Mac. One session at a time uses a device: on MAC_BUSY, wait in its line with `kosuke devices locks create` rather than give up or call again, and let it go with `kosuke devices locks delete` once done.",
         "tags": ["devices"],
         "x-kosuke-command": ["devices", "list"],
         "x-kosuke-sandbox-token": true,
@@ -10467,7 +10467,7 @@
     "/api/projects/{projectId}/batch-merging": {
       "get": {
         "operationId": "projectsBatchMergingGet",
-        "summary": "Read whether the project merges ready pull requests in Batches, how many wait for one, and the Batch running now.",
+        "summary": "Read the Merge agent's mode (true: Batch merging, false: the merge train), how many go-ahead pull requests wait, and the run open now.",
         "tags": ["projects"],
         "x-kosuke-command": ["projects", "batch-merging", "get"],
         "x-kosuke-sandbox-token": true,
@@ -10520,7 +10520,7 @@
       },
       "put": {
         "operationId": "projectsBatchMergingSet",
-        "summary": "Turn Batch Merging on or off. While it is on, a batch agent merges up to 10 ready pull requests into the Target Branch together, reviews them once and runs a short QA, then opens one pull request for a member to merge. Batches run as the member who turned it on. Refused with MERGE_COMMITS_OFF while the repository or a rule on the Target Branch allows no merge commit.",
+        "summary": "Switch the Merge agent's mode. On: Batch merging, a batch agent combines go-ahead pull requests into one Batch pull request, reviews and QAs it, then an admin approves it. Off: the merge train merges them one at a time. Batches run as the member who turned it on. The next go-ahead starts a run in the new mode.",
         "tags": ["projects"],
         "x-kosuke-command": ["projects", "batch-merging", "set"],
         "x-kosuke-sandbox-token": true,
@@ -10547,7 +10547,7 @@
                 "properties": {
                   "enabled": {
                     "type": "boolean",
-                    "description": "True merges ready pull requests to the Target Branch in Batches; false merges them one by one again."
+                    "description": "True runs Batch merging; false runs the merge train, one pull request at a time."
                   }
                 },
                 "required": ["enabled"]
@@ -12116,7 +12116,7 @@
     "/api/projects/{projectId}/chat-sessions/{sessionId}/go-ahead": {
       "put": {
         "operationId": "sessionsGoAheadSet",
-        "summary": "Give the session's pull request the go-ahead to merge, as the session's member, on one head: goAheadSha, goAheadBy, goAheadAt and goAheadMerges. A push to another head takes it away. With `merge`, Kosuke merges it on its own; without, it waits for whoever merges it, and Batch Merging is asked to look. Members and their Sensei only.",
+        "summary": "Give the session's pull request the go-ahead to merge, as the session's member, on one head: goAheadSha, goAheadBy and goAheadAt. The project's Merge agent (the merge train, or Batch merging when it is on) is woken and merges it only at that head. Members and their Sensei only.",
         "tags": ["sessions"],
         "x-kosuke-command": ["sessions", "go-ahead", "set"],
         "x-kosuke-sandbox-token": true,
@@ -12155,10 +12155,6 @@
                     "description": "The head commit the go-ahead is given on. Defaults to the head the session last read from GitHub.",
                     "type": "string",
                     "pattern": "^[0-9a-f]{40}$"
-                  },
-                  "merge": {
-                    "description": "Kosuke merges it on its own, now or once GitHub allows. Without it the pull request is left for whoever merges it, such as the next Batch.",
-                    "type": "boolean"
                   }
                 }
               }
@@ -14243,94 +14239,10 @@
         }
       }
     },
-    "/api/projects/{projectId}/chat-sessions/{sessionId}/pull-request/ready": {
-      "post": {
-        "operationId": "sessionsPullRequestMarkReady",
-        "summary": "Mark the session's draft pull request ready for review, only when its head is the sandbox's clean HEAD, its CI is green (or, with withoutChecks, no check reported) and QA passed on it. Answers `ready:` or `not ready:` in `line`. Only the session's own sandbox.",
-        "tags": ["sessions"],
-        "x-kosuke-command": ["sessions", "pull-request", "mark-ready"],
-        "x-kosuke-sandbox-token": true,
-        "parameters": [
-          {
-            "name": "projectId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid",
-              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
-            }
-          },
-          {
-            "name": "sessionId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid",
-              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
-            }
-          }
-        ],
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "type": "object",
-                "properties": {
-                  "sha": {
-                    "description": "This checkout's HEAD, which must be the pull request's head: `git rev-parse HEAD`.",
-                    "type": "string",
-                    "pattern": "^[0-9a-f]{40}$"
-                  },
-                  "withoutChecks": {
-                    "description": "Mark it ready although no check has reported on the head of a repository with workflow files.",
-                    "type": "boolean"
-                  }
-                }
-              }
-            }
-          }
-        },
-        "responses": {
-          "2XX": {
-            "description": "Success envelope",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ApiSuccess"
-                }
-              }
-            }
-          },
-          "4XX": {
-            "description": "Error envelope",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ApiError"
-                }
-              }
-            }
-          },
-          "5XX": {
-            "description": "Error envelope",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ApiError"
-                }
-              }
-            }
-          }
-        }
-      }
-    },
     "/api/projects/{projectId}/chat-sessions/{sessionId}/qa-passed": {
       "put": {
         "operationId": "sessionsQaSet",
-        "summary": "Record the commit QA passed on as the session's qaPassedSha: a member's override. A session token may only repeat the pass `sessions qa runs finish` recorded at that commit. A pull request is done when qaPassedSha equals its head.",
+        "summary": "Record the commit QA passed on as the session's qaPassedSha: a member's override, or the session's own agent. `sessions qa runs finish` records it when the whole checklist passed. A pull request is done when qaPassedSha equals its head.",
         "tags": ["sessions"],
         "x-kosuke-command": ["sessions", "qa", "set"],
         "x-kosuke-sandbox-token": true,
@@ -16262,110 +16174,6 @@
         }
       }
     },
-    "/api/projects/{projectId}/chat-sessions/{sessionId}/sync": {
-      "post": {
-        "operationId": "sessionsSync",
-        "summary": "Merge the Target Branch, or the open pull request's base, into the session's branch on GitHub, like GitHub's Update branch, and refresh its sandbox. Without an open pull request, uses the project Target Branch, then its default branch. Starts no turn: outcome agent needs /kosuke:sync-branch; pending means GitHub accepted the merge and completion is queued. Poll statusJobId for refreshed or refresh_failed. Failed status includes recovery: retry for a transient refresh failure, observe while GitHub is unconfirmed, repair for an explicit agent repair after a confirmed merge, or stale when the branch or pull request changed. Retrying completion never requests another merge.",
-        "tags": ["sessions"],
-        "x-kosuke-command": ["sessions", "sync"],
-        "x-kosuke-sandbox-token": true,
-        "x-kosuke-cron-token": true,
-        "x-kosuke-sensei-token": true,
-        "parameters": [
-          {
-            "name": "projectId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid",
-              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
-            }
-          },
-          {
-            "name": "sessionId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid",
-              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
-            }
-          }
-        ],
-        "requestBody": {
-          "required": false,
-          "content": {
-            "application/json": {
-              "schema": {
-                "type": "object",
-                "properties": {
-                  "completion": {
-                    "description": "Retry only the observation and sandbox refresh returned by a previous Sync. Never requests another merge.",
-                    "type": "object",
-                    "properties": {
-                      "branch": {
-                        "type": "string",
-                        "minLength": 1,
-                        "maxLength": 255
-                      },
-                      "pullNumber": {
-                        "type": "integer",
-                        "exclusiveMinimum": 0,
-                        "maximum": 9007199254740991
-                      },
-                      "previousHead": {
-                        "type": "string",
-                        "pattern": "^[0-9a-f]{40,64}$"
-                      }
-                    },
-                    "required": ["branch"]
-                  },
-                  "statusJobId": {
-                    "description": "Read the completion job status without requesting a merge or refresh.",
-                    "type": "string",
-                    "pattern": "^sync-[0-9a-f-]{36}$"
-                  }
-                },
-                "additionalProperties": false
-              }
-            }
-          }
-        },
-        "responses": {
-          "2XX": {
-            "description": "Success envelope",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ApiSuccess"
-                }
-              }
-            }
-          },
-          "4XX": {
-            "description": "Error envelope",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ApiError"
-                }
-              }
-            }
-          },
-          "5XX": {
-            "description": "Error envelope",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ApiError"
-                }
-              }
-            }
-          }
-        }
-      }
-    },
     "/api/projects/{projectId}/deploy-messages": {
       "get": {
         "operationId": "deploysMessagesList",
@@ -17235,12 +17043,12 @@
         }
       }
     },
-    "/api/projects/{projectId}/preview": {
+    "/api/projects/{projectId}/merge-agent": {
       "get": {
-        "operationId": "previewGet",
-        "summary": "Read the preview URLs of the project's main sandbox, or of one chat session's. Starts a paused or missing sandbox in the background; poll health until it is up.",
-        "tags": ["preview"],
-        "x-kosuke-command": ["preview", "get"],
+        "operationId": "projectsMergeAgentGet",
+        "summary": "Read the project's Merge agent: its mode (train or batch), the base and whether it has GitHub's merge queue, the go-ahead pull requests waiting with their QA and GitHub's review decision now, and the open run and earlier runs.",
+        "tags": ["projects"],
+        "x-kosuke-command": ["projects", "merge-agent", "get"],
         "x-kosuke-sandbox-token": true,
         "x-kosuke-cron-token": true,
         "x-kosuke-sensei-token": true,
@@ -17254,18 +17062,6 @@
               "format": "uuid",
               "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
             }
-          },
-          {
-            "name": "sessionId",
-            "in": "query",
-            "required": false,
-            "description": "A chat session's preview instead of the project's main one.",
-            "schema": {
-              "description": "A chat session's preview instead of the project's main one.",
-              "type": "string",
-              "format": "uuid",
-              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
-            }
           }
         ],
         "responses": {
@@ -17302,12 +17098,12 @@
         }
       }
     },
-    "/api/projects/{projectId}/preview/health": {
-      "get": {
-        "operationId": "previewHealthGet",
-        "summary": "Read the health of every service behind a preview, and whether a background start is running or failed.",
-        "tags": ["preview"],
-        "x-kosuke-command": ["preview", "health", "get"],
+    "/api/projects/{projectId}/merge-agent/merges": {
+      "post": {
+        "operationId": "projectsMergeAgentMerge",
+        "summary": "The open Merge agent run's own session only: merge a pull request into the run's base as the Kosuke GitHub App, or add it to GitHub's merge queue with --queue, only at the head its member gave the go-ahead on and GitHub holds now. Refused for any other head, base or caller.",
+        "tags": ["projects"],
+        "x-kosuke-command": ["projects", "merge-agent", "merge"],
         "x-kosuke-sandbox-token": true,
         "x-kosuke-cron-token": true,
         "x-kosuke-sensei-token": true,
@@ -17321,20 +17117,41 @@
               "format": "uuid",
               "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
             }
-          },
-          {
-            "name": "sessionId",
-            "in": "query",
-            "required": false,
-            "description": "A chat session's preview instead of the project's main one.",
-            "schema": {
-              "description": "A chat session's preview instead of the project's main one.",
-              "type": "string",
-              "format": "uuid",
-              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
-            }
           }
         ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "number": {
+                    "type": "integer",
+                    "exclusiveMinimum": 0,
+                    "maximum": 9007199254740991,
+                    "description": "The pull request to merge."
+                  },
+                  "sha": {
+                    "type": "string",
+                    "pattern": "^[0-9a-f]{40}$",
+                    "description": "The head to merge: the go-ahead head, and the head GitHub holds now."
+                  },
+                  "method": {
+                    "description": "How to merge. Defaults to the one the repository and its rules allow.",
+                    "type": "string",
+                    "enum": ["squash", "merge", "rebase"]
+                  },
+                  "queue": {
+                    "description": "Add it to the base's GitHub merge queue instead of merging it.",
+                    "type": "boolean"
+                  }
+                },
+                "required": ["number", "sha"]
+              }
+            }
+          }
+        },
         "responses": {
           "2XX": {
             "description": "Success envelope",
@@ -17369,12 +17186,12 @@
         }
       }
     },
-    "/api/projects/{projectId}/preview/reset": {
+    "/api/projects/{projectId}/merge-agent/syncs": {
       "post": {
-        "operationId": "previewReset",
-        "summary": "Restart the services of a preview's running sandbox in place. Fails when the sandbox is paused.",
-        "tags": ["preview"],
-        "x-kosuke-command": ["preview", "reset"],
+        "operationId": "projectsMergeAgentSync",
+        "summary": "The open Merge agent run's own session only: bring the run's base into an open pull request's branch as the Kosuke GitHub App, as GitHub's Update branch does. A conflict is refused with GitHub's words.",
+        "tags": ["projects"],
+        "x-kosuke-command": ["projects", "merge-agent", "sync"],
         "x-kosuke-sandbox-token": true,
         "x-kosuke-cron-token": true,
         "x-kosuke-sensei-token": true,
@@ -17397,10 +17214,19 @@
               "schema": {
                 "type": "object",
                 "properties": {
-                  "sessionId": {
-                    "type": "string"
+                  "number": {
+                    "type": "integer",
+                    "exclusiveMinimum": 0,
+                    "maximum": 9007199254740991,
+                    "description": "The pull request whose branch is behind."
+                  },
+                  "sha": {
+                    "description": "Update only while the head is this commit. Defaults to the head GitHub holds now.",
+                    "type": "string",
+                    "pattern": "^[0-9a-f]{40}$"
                   }
-                }
+                },
+                "required": ["number"]
               }
             }
           }
@@ -17439,12 +17265,216 @@
         }
       }
     },
-    "/api/projects/{projectId}/preview/share": {
+    "/api/projects/{projectId}/preview": {
       "get": {
-        "operationId": "previewShareGet",
-        "summary": "Read the public share link of a preview, if one exists.",
+        "operationId": "previewGet",
+        "summary": "Read the preview URLs of the project's main sandbox, or of one chat session's. Starts a paused or missing sandbox in the background; poll health until it is up.",
         "tags": ["preview"],
-        "x-kosuke-command": ["preview", "share", "get"],
+        "x-kosuke-command": ["preview", "get"],
+        "x-kosuke-sandbox-token": true,
+        "x-kosuke-cron-token": true,
+        "x-kosuke-sensei-token": true,
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid",
+              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+            }
+          },
+          {
+            "name": "sessionId",
+            "in": "query",
+            "required": false,
+            "description": "A chat session's preview instead of the project's main one.",
+            "schema": {
+              "description": "A chat session's preview instead of the project's main one.",
+              "type": "string",
+              "format": "uuid",
+              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+            }
+          }
+        ],
+        "responses": {
+          "2XX": {
+            "description": "Success envelope",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiSuccess"
+                }
+              }
+            }
+          },
+          "4XX": {
+            "description": "Error envelope",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "5XX": {
+            "description": "Error envelope",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/projects/{projectId}/preview/health": {
+      "get": {
+        "operationId": "previewHealthGet",
+        "summary": "Read the health of every service behind a preview, and whether a background start is running or failed.",
+        "tags": ["preview"],
+        "x-kosuke-command": ["preview", "health", "get"],
+        "x-kosuke-sandbox-token": true,
+        "x-kosuke-cron-token": true,
+        "x-kosuke-sensei-token": true,
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid",
+              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+            }
+          },
+          {
+            "name": "sessionId",
+            "in": "query",
+            "required": false,
+            "description": "A chat session's preview instead of the project's main one.",
+            "schema": {
+              "description": "A chat session's preview instead of the project's main one.",
+              "type": "string",
+              "format": "uuid",
+              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+            }
+          }
+        ],
+        "responses": {
+          "2XX": {
+            "description": "Success envelope",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiSuccess"
+                }
+              }
+            }
+          },
+          "4XX": {
+            "description": "Error envelope",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "5XX": {
+            "description": "Error envelope",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/projects/{projectId}/preview/reset": {
+      "post": {
+        "operationId": "previewReset",
+        "summary": "Restart the services of a preview's running sandbox in place. Fails when the sandbox is paused.",
+        "tags": ["preview"],
+        "x-kosuke-command": ["preview", "reset"],
+        "x-kosuke-sandbox-token": true,
+        "x-kosuke-cron-token": true,
+        "x-kosuke-sensei-token": true,
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid",
+              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "sessionId": {
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "2XX": {
+            "description": "Success envelope",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiSuccess"
+                }
+              }
+            }
+          },
+          "4XX": {
+            "description": "Error envelope",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "5XX": {
+            "description": "Error envelope",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/projects/{projectId}/preview/share": {
+      "get": {
+        "operationId": "previewShareGet",
+        "summary": "Read the public share link of a preview, if one exists.",
+        "tags": ["preview"],
+        "x-kosuke-command": ["preview", "share", "get"],
         "x-kosuke-sandbox-token": true,
         "x-kosuke-cron-token": true,
         "x-kosuke-sensei-token": true,
@@ -20288,7 +20318,7 @@
       },
       "post": {
         "operationId": "senseiCardsSet",
-        "summary": "Open a card in your Turn's own thread, or update its open card with that key by passing the revision you read. Refused when the card moved, closed or is being sent, when your Turn stopped, when the member rejected this key in this stateKey (SKIPPED_STATE), when the session now lives in another thread (SESSION_MOVED), or when an id it names is not in the member's reach.",
+        "summary": "Open a card in your Turn's own thread, or update its open card with that key by passing the revision you read. Refused when the card moved, closed or is being sent, when your Turn stopped, when the session now lives in another thread (SESSION_MOVED), or when an id it names is not in the member's reach.",
         "tags": ["sensei"],
         "x-kosuke-command": ["sensei", "cards", "set"],
         "x-kosuke-sandbox-token": true,
@@ -21093,58 +21123,238 @@
                             }
                           },
                           "required": ["type", "rows"]
-                        }
-                      ]
-                    }
-                  },
-                  "instruction": {
-                    "type": "string",
-                    "minLength": 1,
-                    "maxLength": 60000
-                  },
-                  "open": {
-                    "description": "The page the primary button opens in place of an instruction, such as the link a teammate's message shares. The verb is the button's label (\"Open\", \"Read\"), and the tap opens the page, closes the card and sends nothing to Sensei. It takes a verb and an outcome, and no instruction, clarification block, Deploy form, action or covers; a Memory, integration or messages card cannot open a link.",
-                    "type": "object",
-                    "properties": {
-                      "href": {
-                        "type": "string",
-                        "maxLength": 2000
-                      }
-                    },
-                    "required": ["href"],
-                    "additionalProperties": false
-                  },
-                  "verb": {
-                    "type": "string",
-                    "minLength": 1,
-                    "maxLength": 32
-                  },
-                  "negativeLabel": {
-                    "description": "The negative button's label: free text of 1 to 20 characters once trimmed, in any words that say what the member's no does, such as \"Reject\", \"Skip\", \"Dismiss\" or \"Not now\"; those are examples, not a list to pick from. Omit it for \"Reject\" on a card with a verb and \"Dismiss\" on one without. Set it when the default misdescribes the no. The tap always skips the card and sends nothing.",
-                    "type": "string",
-                    "minLength": 1,
-                    "maxLength": 20
-                  },
-                  "negativeTone": {
-                    "description": "How the negative button reads, set apart from its label: destructive (red) for a no that turns something down, neutral for one that only sets the card aside. Omit it for destructive on a card with a verb and neutral on one without.",
-                    "type": "string",
-                    "enum": ["neutral", "destructive"]
-                  },
-                  "request": {
-                    "type": "string",
-                    "minLength": 1,
-                    "maxLength": 300
-                  },
-                  "outcome": {
-                    "type": "string",
-                    "minLength": 1,
-                    "maxLength": 300
-                  },
-                  "instructionKind": {
-                    "type": "string",
-                    "enum": ["session", "sensei", "ticket", "guide"]
-                  },
-                  "proposedBy": {
+                        },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "type": {
+                              "type": "string",
+                              "const": "person"
+                            },
+                            "heading": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 80
+                            },
+                            "name": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 80
+                            },
+                            "line": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 500
+                            }
+                          },
+                          "required": ["type", "name"]
+                        },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "type": {
+                              "type": "string",
+                              "const": "image"
+                            },
+                            "sessionId": {
+                              "type": "string",
+                              "format": "uuid",
+                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+                            },
+                            "cronId": {
+                              "type": "string",
+                              "format": "uuid",
+                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+                            },
+                            "runId": {
+                              "type": "string",
+                              "format": "uuid",
+                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+                            },
+                            "fileId": {
+                              "type": "string",
+                              "format": "uuid",
+                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+                            },
+                            "version": {
+                              "type": "integer",
+                              "exclusiveMinimum": 0,
+                              "maximum": 9007199254740991
+                            },
+                            "slug": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 80
+                            },
+                            "caption": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 80
+                            },
+                            "heading": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 80
+                            }
+                          },
+                          "required": ["type"]
+                        },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "type": {
+                              "type": "string",
+                              "const": "event"
+                            },
+                            "title": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 80
+                            },
+                            "start": {
+                              "type": "string",
+                              "format": "date-time",
+                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+                            },
+                            "end": {
+                              "type": "string",
+                              "format": "date-time",
+                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+                            },
+                            "timeZone": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 64
+                            },
+                            "notes": {
+                              "maxItems": 4,
+                              "type": "array",
+                              "items": {
+                                "type": "object",
+                                "properties": {
+                                  "state": {
+                                    "type": "string",
+                                    "enum": ["passed", "failed", "waiting", "info"]
+                                  },
+                                  "text": {
+                                    "type": "string",
+                                    "minLength": 1,
+                                    "maxLength": 300
+                                  }
+                                },
+                                "required": ["state", "text"]
+                              }
+                            }
+                          },
+                          "required": ["type", "start"]
+                        },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "type": {
+                              "type": "string",
+                              "const": "ticket"
+                            },
+                            "title": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 500
+                            },
+                            "project": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 80
+                            },
+                            "line": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 500
+                            }
+                          },
+                          "required": ["type", "title"]
+                        }
+                      ]
+                    }
+                  },
+                  "instruction": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 60000
+                  },
+                  "open": {
+                    "description": "The page the primary button opens in place of an instruction, such as the link a teammate's message shares. The verb is the button's label (\"Open\", \"Read\"), and the tap opens the page, closes the card and sends nothing to Sensei. It takes a verb and an outcome, and no instruction, clarification block, Deploy form, action or covers.",
+                    "type": "object",
+                    "properties": {
+                      "href": {
+                        "type": "string",
+                        "maxLength": 2000
+                      }
+                    },
+                    "required": ["href"],
+                    "additionalProperties": false
+                  },
+                  "verb": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 32
+                  },
+                  "actions": {
+                    "description": "The card's buttons beside Reply and the negative button, 1 to 3 with the verb counted among them: each a label of 24 characters at most, the prompt its tap sends to Sensei in this thread as the member's message, exactly as written and shown under the button, and a tone: primary (the filled button a swipe right taps, one at most, and none beside a verb, which is the primary), default, or destructive.",
+                    "minItems": 1,
+                    "maxItems": 3,
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "label": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 32
+                        },
+                        "prompt": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 60000
+                        },
+                        "tone": {
+                          "type": "string",
+                          "enum": ["primary", "default", "destructive"]
+                        }
+                      },
+                      "required": ["label", "prompt"]
+                    }
+                  },
+                  "urgency": {
+                    "description": "Whether the card notifies the member's devices: now sends a push notification, later waits in its thread with none. Omit it for now.",
+                    "type": "string",
+                    "enum": ["now", "later"]
+                  },
+                  "negativeLabel": {
+                    "description": "The negative button's label: free text of 1 to 20 characters once trimmed, in any words that say what the member's no does, such as \"Reject\", \"Skip\", \"Dismiss\" or \"Not now\"; those are examples, not a list to pick from. Omit it for \"Reject\" on a card with a verb and \"Dismiss\" on one without. Set it when the default misdescribes the no. The tap always skips the card and sends nothing.",
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 20
+                  },
+                  "negativeTone": {
+                    "description": "How the negative button reads, set apart from its label: destructive (red) for a no that turns something down, neutral for one that only sets the card aside. Omit it for destructive on a card with a verb and neutral on one without.",
+                    "type": "string",
+                    "enum": ["neutral", "destructive"]
+                  },
+                  "request": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 300
+                  },
+                  "outcome": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 300
+                  },
+                  "instructionKind": {
+                    "type": "string",
+                    "enum": ["session", "sensei", "ticket", "guide"]
+                  },
+                  "proposedBy": {
                     "anyOf": [
                       {
                         "type": "object",
@@ -21631,7 +21841,7 @@
                     ]
                   },
                   "covers": {
-                    "description": "The ids of the incoming_message events of this thread that this card answers. Only a reply, the FYI, or a task or calendar card with its instruction and verb covers. Every card an Event Turn writes in a message thread names them: a reply covers the message it answers, a task or calendar card the message in its evidence, an FYI the event of every row, and of each message among this Turn’s events that it only counts. An FYI update keeps unread commitments and the events in its current evidence, discarding processed history; name at most 50 events per write. The open FYI keeps a reference to every message it has covered, which its Mark read marks, and its card read gives their count and the newest. An incoming event no card covers is read again later.",
+                    "description": "The ids of the incoming_message events of this thread that this card answers. Every card an Event Turn writes in a message thread names them: a reply covers the message it answers, a task or calendar card the message in its evidence, an FYI the event of every row, and of each message among this Turn’s events that it only counts. An FYI update keeps unread commitments and the events in its current evidence, discarding processed history; name at most 50 events per write. The open FYI keeps a reference to every message it has covered, which its Mark read marks, and its card read gives their count and the newest. An incoming event no card covers is read again later.",
                     "minItems": 1,
                     "maxItems": 50,
                     "type": "array",
@@ -22627,7 +22837,7 @@
       },
       "put": {
         "operationId": "senseiMemorySet",
-        "summary": "Save a Memory file at the revision you read. Sensei must name the card approved to start this Turn.",
+        "summary": "Save a Memory file at the revision you read. Refused with 409 when it changed since.",
         "tags": ["sensei"],
         "x-kosuke-command": ["sensei", "memory", "set"],
         "x-kosuke-sensei-token": true,
@@ -22654,7 +22864,7 @@
                     "enum": ["general.md"]
                   },
                   "cardId": {
-                    "description": "The Memory card the member approved to start this Turn.",
+                    "description": "The Memory card this write answers, if any. Kosuke reads nothing from it.",
                     "type": "string",
                     "format": "uuid",
                     "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
@@ -22699,73 +22909,6 @@
         }
       }
     },
-    "/api/sensei/merge": {
-      "post": {
-        "operationId": "senseiMerge",
-        "summary": "Merge the pull request of any Chat Session in a workspace you belong to, as you on GitHub, whenever GitHub allows it: added to GitHub's merge queue where the base has one, updated first where GitHub requires an up-to-date branch, merged otherwise, pinned to the head read. GitHub alone decides: Kosuke adds no hold of its own on approvals, reviews, checks or a working session. Asking is your go-ahead, recorded on the session for its member on the head read with Kosuke merging it, so it merges later when GitHub refuses now. A push to another head takes it away. Answers the outcome, the head it decided on and why. Refused with the reason unless you have GitHub connected and the head is still `headSha` when given, and with GitHub's own reason when GitHub refuses the merge.",
-        "tags": ["sensei"],
-        "x-kosuke-command": ["sensei", "merge"],
-        "x-kosuke-sandbox-token": true,
-        "x-kosuke-cron-token": true,
-        "x-kosuke-sensei-token": true,
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "type": "object",
-                "properties": {
-                  "sessionId": {
-                    "type": "string",
-                    "format": "uuid",
-                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-                    "description": "The Chat Session whose pull request to merge, in any workspace you belong to."
-                  },
-                  "headSha": {
-                    "description": "The head commit you decided on. Nothing is written when the pull request has moved past it.",
-                    "type": "string",
-                    "pattern": "^[0-9a-f]{40}$"
-                  }
-                },
-                "required": ["sessionId"]
-              }
-            }
-          }
-        },
-        "responses": {
-          "2XX": {
-            "description": "Success envelope",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ApiSuccess"
-                }
-              }
-            }
-          },
-          "4XX": {
-            "description": "Error envelope",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ApiError"
-                }
-              }
-            }
-          },
-          "5XX": {
-            "description": "Error envelope",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ApiError"
-                }
-              }
-            }
-          }
-        }
-      }
-    },
     "/api/sensei/merge-rule": {
       "put": {
         "operationId": "senseiMergeRuleSet",
@@ -22993,49 +23136,6 @@
         }
       }
     },
-    "/api/sensei/reels/ranks": {
-      "get": {
-        "operationId": "senseiReelsRanksList",
-        "summary": "Read Jev ranks for your open Sensei Cards, valid only at each card revision.",
-        "tags": ["sensei"],
-        "x-kosuke-command": ["sensei", "reels", "ranks", "list"],
-        "x-kosuke-sandbox-token": true,
-        "x-kosuke-cron-token": true,
-        "x-kosuke-sensei-token": true,
-        "responses": {
-          "2XX": {
-            "description": "Success envelope",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ApiSuccess"
-                }
-              }
-            }
-          },
-          "4XX": {
-            "description": "Error envelope",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ApiError"
-                }
-              }
-            }
-          },
-          "5XX": {
-            "description": "Error envelope",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ApiError"
-                }
-              }
-            }
-          }
-        }
-      }
-    },
     "/api/sensei/repository": {
       "post": {
         "operationId": "senseiRepositoryCardsCreate",
@@ -23103,150 +23203,6 @@
         }
       }
     },
-    "/api/sensei/review/approve": {
-      "post": {
-        "operationId": "senseiReviewApprovalsCreate",
-        "summary": "Approve the pull request of a Chat Session as you on GitHub, pinned to headSha: the approval is of that commit. Refused with 409 HEAD_MOVED, naming the new head, when the pull request moved past headSha, with NO_PULL_REQUEST when the session has no open pull request, and with GITHUB_REFUSED and GitHub’s own words when GitHub says no, such as for your own pull request or without GitHub connected in Kosuke.",
-        "tags": ["sensei"],
-        "x-kosuke-command": ["sensei", "review", "approvals", "create"],
-        "x-kosuke-sandbox-token": true,
-        "x-kosuke-cron-token": true,
-        "x-kosuke-sensei-token": true,
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "type": "object",
-                "properties": {
-                  "sessionId": {
-                    "type": "string",
-                    "format": "uuid",
-                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-                    "description": "The Chat Session whose pull request to approve, in any workspace you belong to."
-                  },
-                  "headSha": {
-                    "type": "string",
-                    "pattern": "^[0-9a-f]{40}$",
-                    "description": "The head commit you read and approve. Nothing is approved when the pull request moved past it."
-                  }
-                },
-                "required": ["sessionId", "headSha"]
-              }
-            }
-          }
-        },
-        "responses": {
-          "2XX": {
-            "description": "Success envelope",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ApiSuccess"
-                }
-              }
-            }
-          },
-          "4XX": {
-            "description": "Error envelope",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ApiError"
-                }
-              }
-            }
-          },
-          "5XX": {
-            "description": "Error envelope",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ApiError"
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    "/api/sensei/review/ask": {
-      "post": {
-        "operationId": "senseiReviewRequestsCreate",
-        "summary": "Ask members to review the pull request of a Chat Session you are the Assignee of, as you on GitHub, and record who was asked for the merge to count. With again, ask again everyone asked before and whoever requested changes since. A member who never connected GitHub, or whom GitHub refuses, is left out and named; it is refused when nobody could be asked, with 400 when you name yourself, nobody, or there is nobody to ask again, with 403 when you are not the Assignee, and with 409 NO_PULL_REQUEST or GITHUB_REFUSED.",
-        "tags": ["sensei"],
-        "x-kosuke-command": ["sensei", "review", "requests", "create"],
-        "x-kosuke-sandbox-token": true,
-        "x-kosuke-cron-token": true,
-        "x-kosuke-sensei-token": true,
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "type": "object",
-                "properties": {
-                  "sessionId": {
-                    "type": "string",
-                    "format": "uuid",
-                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-                    "description": "The Chat Session whose pull request to ask a review of. You are its Assignee."
-                  },
-                  "reviewers": {
-                    "default": [],
-                    "description": "The members to ask, by the id `kosuke workspaces members list` prints. Left out with again.",
-                    "maxItems": 15,
-                    "type": "array",
-                    "items": {
-                      "type": "string",
-                      "minLength": 1
-                    }
-                  },
-                  "again": {
-                    "default": false,
-                    "description": "Ask again everyone asked before, and whoever requested changes since: after the session answered their review.",
-                    "type": "boolean"
-                  }
-                },
-                "required": ["sessionId"]
-              }
-            }
-          }
-        },
-        "responses": {
-          "2XX": {
-            "description": "Success envelope",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ApiSuccess"
-                }
-              }
-            }
-          },
-          "4XX": {
-            "description": "Error envelope",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ApiError"
-                }
-              }
-            }
-          },
-          "5XX": {
-            "description": "Error envelope",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ApiError"
-                }
-              }
-            }
-          }
-        }
-      }
-    },
     "/api/sensei/review/context": {
       "get": {
         "operationId": "senseiReviewContextGet",