@kosuke-ai/kosuke 1.0.5 → 1.0.7

package/openapi.json

@@ -234,7 +234,7 @@
     "/api/agent-integrations/tools": {
       "get": {
         "operationId": "integrationsTools",
-        "summary": "List the integration tools you can run now, with the connections that run them. An agent reads its own workspace. With an API key, name a workspace you belong to: it shows that workspace’s connections and your own personal ones. Some integrations require an enabled workspace to be named. A Connector Token or a browser session is refused.",
+        "summary": "List the integration tools you can run now, with the connections that run them. An agent reads its own workspace. With an API key, name a workspace you belong to: it shows that workspace’s connections and your own personal ones. Some integrations require an enabled workspace to be named. A Connector Token or a browser session is refused. Each toolkit is personal or workspace, never both. A personal connection reaches only a Turn its member started (in a workspace chat, only the session's Assignee); a workspace Cron, Deploy Chat, a Turn another member sent and unassigned work reach workspace connections only. In the Personal space the owner's own Turns reach both kinds.",
         "tags": ["integrations"],
         "x-kosuke-command": ["integrations", "tools"],
         "x-kosuke-sandbox-token": true,
@@ -766,7 +766,7 @@
     "/api/devices/{deviceId}/requests": {
       "post": {
         "operationId": "devicesRequest",
-        "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. While pending, wait and check devices list; it expires after 30 minutes without an answer. Then pass --device-id on every mac command.",
+        "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 is yours for the rest of the session: pass --device-id on every mac command.",
         "tags": ["devices"],
         "x-kosuke-command": ["devices", "request"],
         "x-kosuke-sandbox-token": true,
@@ -837,7 +837,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 and this session's access: none, pending or approved. Request one with devices request before any mac command, and use one only when the test truly needs a real Mac.",
+        "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 and this session's access: none, pending or approved. 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. Request one with devices request before any mac command, and use one only when the test truly needs a real Mac.",
         "tags": ["devices"],
         "x-kosuke-command": ["devices", "list"],
         "x-kosuke-sandbox-token": true,
@@ -7865,7 +7865,7 @@
     "/api/organizations/{workspaceId}/tasks": {
       "get": {
         "operationId": "tasksList",
-        "summary": "List tasks in one workspace.",
+        "summary": "List tasks in one workspace. Before you file or propose a ticket, read the open ones (--status todo,in_progress --include-prompt, following meta.pagination.nextCursor with --cursor) and judge overlap by meaning, not title words: work another task or session already covers gets no new ticket.",
         "tags": ["tasks"],
         "x-kosuke-command": ["tasks", "list"],
         "x-kosuke-sandbox-token": true,
@@ -7986,7 +7986,9 @@
             "name": "includePrompt",
             "in": "query",
             "required": false,
+            "description": "Adds each task's prompt: a Todo task's description, or its first message after Start, cut at 4,000 characters (promptTruncated). Read `tasks get` for a cut or empty one.",
             "schema": {
+              "description": "Adds each task's prompt: a Todo task's description, or its first message after Start, cut at 4,000 characters (promptTruncated). Read `tasks get` for a cut or empty one.",
               "type": "boolean"
             }
           },
@@ -8043,7 +8045,7 @@
       },
       "post": {
         "operationId": "tasksCreate",
-        "summary": "File a task. A hint files into that project; YOLO returns a Backlog item.",
+        "summary": "File a task. A hint files into that project; YOLO returns a Backlog item. From Sensei, ownerId is the member, or the teammate they name; leave sandboxSize to the member, who changes it in the task's Properties. Answers shareUrl: link the task's title to it.",
         "tags": ["tasks"],
         "x-kosuke-command": ["tasks", "create"],
         "x-kosuke-attachments": true,
@@ -8121,7 +8123,8 @@
                     "description": "start (default) runs the project's services when the sandbox boots. skip boots setup and the agent only; a member or the session's agent starts the services later with sessions app-stack-start. Fixed once the session starts."
                   },
                   "description": {
-                    "type": "string"
+                    "type": "string",
+                    "description": "Markdown someone with none of your context can act on: the goal, why it matters, the limits, what done contains, and what the repository does not hold (a log line, an error, a URL). Resolve every \"it\" and @mention; keep the member's decisions and scope; leave out empty sections."
                   },
                   "hintProjectId": {
                     "x-kosuke-flag": "hint-project",
@@ -8202,7 +8205,8 @@
                     "description": "start (default) runs the project's services when the sandbox boots. skip boots setup and the agent only; a member or the session's agent starts the services later with sessions app-stack-start. Fixed once the session starts."
                   },
                   "description": {
-                    "type": "string"
+                    "type": "string",
+                    "description": "Markdown someone with none of your context can act on: the goal, why it matters, the limits, what done contains, and what the repository does not hold (a log line, an error, a URL). Resolve every \"it\" and @mention; keep the member's decisions and scope; leave out empty sections."
                   },
                   "hintProjectId": {
                     "x-kosuke-flag": "hint-project",
@@ -8491,9 +8495,11 @@
                     ]
                   },
                   "description": {
+                    "description": "The whole new description, only when the goal changed: never because the task starts.",
                     "type": "string"
                   },
                   "ifRevision": {
+                    "description": "The descriptionRevision `tasks get` printed. Sensei and a Cron Run must pass it with description; a changed task answers 409 TASK_CONFLICT, so read it again and reconcile.",
                     "type": "string"
                   },
                   "hintProjectId": {
@@ -8689,7 +8695,7 @@
     "/api/organizations/{workspaceId}/tasks/{taskId}/start": {
       "post": {
         "operationId": "tasksStart",
-        "summary": "Start a Todo task. Members and Sensei only. sandboxSize and appStack set the task's Sandbox size and App stack as it starts; absent keeps what the task holds.",
+        "summary": "Start a Todo task. Members and Sensei only. sandboxSize and appStack set the task's Sandbox size and App stack as it starts; absent keeps what the task holds. The member's ask to start is the yes: start without reading back credits or sandboxes. A refusal leaves it in the Backlog: say what Kosuke answered and do not retry.",
         "tags": ["tasks"],
         "x-kosuke-command": ["tasks", "start"],
         "x-kosuke-sandbox-token": true,
@@ -8733,6 +8739,7 @@
                     "enum": ["ship"]
                   },
                   "prompt": {
+                    "description": "Other text for the first message. The description stays as it is.",
                     "type": "string"
                   },
                   "sandboxSize": {
@@ -9049,7 +9056,7 @@
       },
       "post": {
         "operationId": "personalTasksCreate",
-        "summary": "File a personal task: yours alone, in no workspace. From a Sensei Turn it joins the Turn’s thread unless threadId names another.",
+        "summary": "File a personal task: yours alone, in no workspace. From a Sensei Turn it joins the Turn’s thread unless threadId names another. Check personal-tasks list for one that covers it first.",
         "tags": ["personal-tasks"],
         "x-kosuke-command": ["personal-tasks", "create"],
         "x-kosuke-sandbox-token": true,
@@ -9353,7 +9360,7 @@
     "/api/personal-tasks/{taskId}/move": {
       "post": {
         "operationId": "personalTasksMove",
-        "summary": "Move a Todo or In progress personal task into a workspace you belong to, as its Todo task assigned to you; the personal task is removed. A due date becomes the description’s last line.",
+        "summary": "Move a Todo or In progress personal task into a workspace you belong to, as its Todo task assigned to you; the personal task is removed. A due date becomes the description’s last line. Only when the member asks.",
         "tags": ["personal-tasks"],
         "x-kosuke-command": ["personal-tasks", "move"],
         "x-kosuke-sandbox-token": true,
@@ -9461,6 +9468,7 @@
                     "enum": ["ship"]
                   },
                   "prompt": {
+                    "description": "Other text for the first message. The description stays as it is.",
                     "type": "string"
                   },
                   "sandboxSize": {
@@ -9557,7 +9565,7 @@
       },
       "post": {
         "operationId": "projectsCreate",
-        "summary": "Connect a GitHub repository as a project in a workspace, or describe what to build to create a YOLO project on a new Kosuke-Org repository. Pass workflow yolo with a repository to import it in YOLO mode, with an optional prompt as its first message. Pass personal instead of orgId to create it in your Personal: your own credential, or your Sensei in a Turn you started. Its first Deploy starts by itself, as the caller's; sessions start once it lands. Imports only a repository your own GitHub Connection can write to: 403 GITHUB_REPOSITORY_ACCESS_REQUIRED otherwise, 401 GITHUB_RECONNECT_REQUIRED when GitHub no longer accepts your connection.",
+        "summary": "Connect a GitHub repository as a project in a workspace, or describe what to build to create a YOLO project on a new Kosuke-Org repository. Pass workflow yolo with a repository to import it in YOLO mode, with an optional prompt as its first message. Pass personal instead of orgId to create it in your Personal: your own credential, or your Sensei in a Turn you started. Its first Deploy starts by itself, as the caller's; sessions start once it lands. Imports only a repository your own GitHub Connection can write to: 403 GITHUB_REPOSITORY_ACCESS_REQUIRED otherwise, 401 GITHUB_RECONNECT_REQUIRED when GitHub no longer accepts your connection. Pass workflow yolo or personal only when the member asked for it. Report a chatError; on BRANCH_PROTECTED give its message and do not retry.",
         "tags": ["projects"],
         "x-kosuke-command": ["projects", "create"],
         "x-kosuke-sandbox-token": true,
@@ -10801,7 +10809,7 @@
       },
       "post": {
         "operationId": "sessionsCreate",
-        "summary": "Start a chat session, or file a backlog one with status=backlog. Title or content is required; a backlog session needs content. Attachments ride along as multipart. From a sandbox or a Cron Run, only status=backlog, and reason is required: one line on why the ticket exists. From a Cron Run, Kosuke files it and is its Assignee, and a model the workspace cannot run falls back to the Cron's: model says which one it will run on.",
+        "summary": "Start a chat session, or file a backlog one with status=backlog. Title or content is required; a backlog session needs content. Attachments ride along as multipart. From a sandbox or a Cron Run, only status=backlog, and reason is required: one line on why the ticket exists. From a Cron Run, Kosuke files it and is its Assignee, and a model the workspace cannot run falls back to the Cron's: model says which one it will run on. A backlog session answers shareUrl, the link to give for it.",
         "tags": ["sessions"],
         "x-kosuke-command": ["sessions", "create"],
         "x-kosuke-attachments": true,
@@ -11057,7 +11065,7 @@
       },
       "put": {
         "operationId": "sessionsUpdate",
-        "summary": "Change title, status, model, Auto, Assignee, priority, Sandbox size (sandboxSize) or App stack (appStack). Which changes are legal depends on the current status; the handler decides. sandboxSize and appStack change only while the session is in the Backlog: once it started they are fixed, and 409 SANDBOX_SETTINGS_LOCKED refuses them.",
+        "summary": "Change title, status, model, Auto, Assignee, priority, Sandbox size (sandboxSize) or App stack (appStack). Which changes are legal depends on the current status; the handler decides. sandboxSize and appStack change only while the session is in the Backlog: once it started they are fixed, and 409 SANDBOX_SETTINGS_LOCKED refuses them. A sandbox or a Cron Run may change only the title and priority of a Backlog session it filed.",
         "tags": ["sessions"],
         "x-kosuke-command": ["sessions", "update"],
         "x-kosuke-sandbox-token": true,
@@ -11528,7 +11536,7 @@
     "/api/projects/{projectId}/chat-sessions/{sessionId}/artifacts/{artifactId}": {
       "get": {
         "operationId": "sessionsArtifactsGet",
-        "summary": "Read one artifact of the session, by its id or its slug: a markdown or html one carries its body, an image or a video a presigned url, its media type and its size.",
+        "summary": "Read one artifact of the session, by its id or its slug, such as `testing-checklist`, `qa-report` or `review`: a markdown or html one carries its body, an image or a video a presigned url, its media type and its size.",
         "tags": ["sessions"],
         "x-kosuke-command": ["sessions", "artifacts", "get"],
         "x-kosuke-sandbox-token": true,
@@ -12052,7 +12060,7 @@
       },
       "post": {
         "operationId": "sessionsSend",
-        "summary": "Send a message: starts a turn, or waits Up next while one is running. To steer the running turn with it, steer the Queued Message it becomes. Attachments ride along as multipart.",
+        "summary": "Send a message: starts a turn, or waits Up next while one is running. To steer the running turn with it, steer the Queued Message it becomes. Attachments ride along as multipart. Use it over steer only for attachments, a message that runs a skill, or text over 10,000 characters.",
         "tags": ["sessions"],
         "x-kosuke-command": ["sessions", "send"],
         "x-kosuke-attachments": true,
@@ -14045,7 +14053,7 @@
     "/api/projects/{projectId}/chat-sessions/{sessionId}/prompt": {
       "patch": {
         "operationId": "sessionsEditPrompt",
-        "summary": "Rewrite the saved prompt of a backlog session, keeping or replacing its attachments. Multipart only. With ifRevision, the promptRevision `sessions get` gave, it is refused with 409 TICKET_EDITED when the prompt changed since; Sensei and a Cron Run must pass it.",
+        "summary": "Rewrite the saved prompt of a backlog session, keeping or replacing its attachments. Multipart only. With ifRevision, the promptRevision `sessions get` gave, it is refused with 409 TICKET_EDITED when the prompt changed since; Sensei and a Cron Run must pass it. Send the whole new description, and only for a new goal; an agent rewrites only a ticket it filed unless the member asked.",
         "tags": ["sessions"],
         "x-kosuke-command": ["sessions", "edit-prompt"],
         "x-kosuke-attachments": true,
@@ -15016,7 +15024,7 @@
     "/api/projects/{projectId}/chat-sessions/{sessionId}/steer": {
       "post": {
         "operationId": "sessionsSteer",
-        "summary": "Send a message and steer it into your running turn. Answers delivery steer, queued (the turn could not take it), job (no turn was running) or refused (the turn was stopped).",
+        "summary": "Send a message and steer it into your running turn. Answers delivery steer, queued (the turn could not take it), job (no turn was running) or refused (the turn was stopped). Use it for plain text up to 10,000 characters; on queued or refused, say where the message is.",
         "tags": ["sessions"],
         "x-kosuke-command": ["sessions", "steer"],
         "x-kosuke-sandbox-token": true,
@@ -18579,7 +18587,7 @@
     "/api/projects/{projectId}/skills": {
       "get": {
         "operationId": "projectsSkills",
-        "summary": "List the skills the agent can invoke in this project, for one provider: the project's own, the workspace's and the member's, the plugins', and Kosuke's own skills in the kosuke plugin, which every chat session carries as kosuke:<name>. From a sandbox, sessionId defaults to its own chat session.",
+        "summary": "List the skills the agent can invoke in this project, for one provider: the project's own, the workspace's and the member's, the plugins', and Kosuke's own skills in the kosuke plugin, which every chat session carries as kosuke:<name>. From a sandbox, sessionId defaults to its own chat session. provider is the session's agent: anthropic for Claude, GLM, Kimi and DeepSeek; openai for Codex; meta for Muse; google for Gemini; xai for Grok. Check a skill is listed before you send a message that runs it.",
         "tags": ["projects"],
         "x-kosuke-command": ["projects", "skills"],
         "x-kosuke-sandbox-token": true,
@@ -18710,7 +18718,7 @@
     "/api/projects/{projectId}/workflow": {
       "post": {
         "operationId": "projectsSwitchWorkflow",
-        "summary": "Switch a project between YOLO mode and Collaboration. YOLO completes every Active and Under Review session and turns Backlog sessions into Backlog items; switching back revives the sessions it closed.",
+        "summary": "Switch a project between YOLO mode and Collaboration. YOLO completes every Active and Under Review session and turns Backlog sessions into Backlog items; switching back revives the sessions it closed. Before a switch to YOLO, list the Active, Under Review and Backlog sessions it closes (`sessions list --status active,under-review,backlog`) and switch only on the member's yes in a later message. A YOLO project's work goes into its one chat, the oldest session not Completed: steer it, or create one when there is none, and never run /kosuke:ship there. A refusal (BRANCH_PROTECTED, TURN_IN_FLIGHT, QUEUED_FILES, BACKLOG_FILES) changed nothing: say it.",
         "tags": ["projects"],
         "x-kosuke-command": ["projects", "switch-workflow"],
         "x-kosuke-sandbox-token": true,
@@ -20025,7 +20033,7 @@
                           },
                           "memory": {
                             "type": "string",
-                            "enum": ["SENSEI.md", "personality.md", "general.md"]
+                            "enum": ["general.md"]
                           },
                           "integration": {
                             "not": {}
@@ -21104,7 +21112,7 @@
     "/api/sensei/memory": {
       "get": {
         "operationId": "senseiMemoryGet",
-        "summary": "Read your three private Memory files and their revisions.",
+        "summary": "Read your private Memory file, general.md, and its revision.",
         "tags": ["sensei"],
         "x-kosuke-command": ["sensei", "memory", "get"],
         "x-kosuke-sandbox-token": true,
@@ -21171,7 +21179,7 @@
                   },
                   "file": {
                     "type": "string",
-                    "enum": ["SENSEI.md", "personality.md", "general.md"]
+                    "enum": ["general.md"]
                   },
                   "cardId": {
                     "description": "The Memory card the member approved to start this Turn.",
@@ -21513,62 +21521,6 @@
         }
       }
     },
-    "/api/sensei/reels/proposals": {
-      "get": {
-        "operationId": "senseiReelsProposals",
-        "summary": "Read your Backlog proposals newest first by ticket creation or edit, ten per page, excluding the ones you skipped at the current ticket version.",
-        "tags": ["sensei"],
-        "x-kosuke-command": ["sensei", "reels", "proposals"],
-        "x-kosuke-sandbox-token": true,
-        "x-kosuke-cron-token": true,
-        "x-kosuke-sensei-token": true,
-        "parameters": [
-          {
-            "name": "cursor",
-            "in": "query",
-            "required": false,
-            "description": "Opaque cursor from the previous page.",
-            "schema": {
-              "description": "Opaque cursor from the previous page.",
-              "type": "string",
-              "maxLength": 100
-            }
-          }
-        ],
-        "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/reels/ranks": {
       "get": {
         "operationId": "senseiReelsRanks",
@@ -21612,71 +21564,6 @@
         }
       }
     },
-    "/api/sensei/reels/skips": {
-      "post": {
-        "operationId": "senseiReelsSkips",
-        "summary": "Skip your Backlog proposal on every device until its ticket version changes.",
-        "tags": ["sensei"],
-        "x-kosuke-command": ["sensei", "reels", "skips"],
-        "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)$"
-                  },
-                  "ticketVersion": {
-                    "type": "string",
-                    "pattern": "^[a-f0-9]{64}$"
-                  }
-                },
-                "required": ["sessionId", "ticketVersion"]
-              }
-            }
-          }
-        },
-        "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": "senseiRepository",
@@ -22127,7 +22014,7 @@
     "/api/sensei/suggest": {
       "post": {
         "operationId": "senseiSuggest",
-        "summary": "Put suggestion pills in a message of your Turn's own thread, under your words. A tap on a pill fills the member's reply and sends nothing; a newThread pill is a new topic, and its tap starts a thread of its own with those words. Refused when your Turn stopped.",
+        "summary": "Put suggestion pills in a message of your Turn's own thread, under your words. A tap on a pill fills the member's reply and sends nothing; a newThread pill is a new topic, and its tap starts a thread of its own with those words. Refused when your Turn stopped. Each pill is in the member's words; newThread only for an unrelated topic. It is the last thing your Turn posts: end your Turn after it.",
         "tags": ["sensei"],
         "x-kosuke-command": ["sensei", "suggest"],
         "x-kosuke-sandbox-token": true,
@@ -22211,7 +22098,7 @@
     "/api/sensei/teammate-messages": {
       "post": {
         "operationId": "senseiMessagesSend",
-        "summary": "Send a message to a member's Sensei. Any sender can: you, your Sensei when you ask it to, a Cron Run, or a session's agent; the sender is read from the credential. Their Sensei shows it on a card that says who sent it, with the action that fits, and they are notified as for any card. Name the project with projectId, and optionally the Chat Session (sessionId) or pull request (pullRequest, with projectId) it is about; a sessionId alone names its project. memberId is required: the id a Member mention carries or `kosuke workspaces members` prints, never a guess between members who share a name. key is a slug such as merge-plan, ticket-<slug> or qa-guide, and text, up to 60,000 characters, is everything the member needs, so it can hold a ticket prompt or a whole Project QA Guide. title, why (one line: why this member), paths (the repository paths it is about) and link (a Kosuke path starting with / or an https URL the card opens) are optional. The same key with new text or a new link updates the open card and raises the revision; the same again writes nothing. Pass ifRevision, the revision an earlier send answered, to be refused with MESSAGE_CHANGED when it moved on. When a member sent it, the recipient's approve, edit, reject or reply comes back to the thread it was sent from. Only a Turn your member started sends one as your Sensei. Answers id, revision, updated and the recipient. Pass the body with --body or --body-file.",
+        "summary": "Send a message to a member's Sensei. Any sender can: you, your Sensei, a Cron Run, or a session's agent; the sender is read from the credential. Their Sensei shows it on a card that says who sent it, with the action that fits, and they are notified as for any card. Name the project with projectId, and optionally the Chat Session (sessionId) or pull request (pullRequest, with projectId) it is about; a sessionId alone names its project. memberId is required: the id a Member mention carries or `kosuke workspaces members` prints, never a guess between members who share a name. key is a slug such as merge-plan, ticket-<slug> or qa-guide, and text, up to 60,000 characters, is everything the member needs, so it can hold a ticket prompt or a whole Project QA Guide. title, why (one line: why this member), paths (the repository paths it is about) and link (a Kosuke path starting with / or an https URL the card opens) are optional. The same key with new text or a new link updates the open card and raises the revision; the same again writes nothing. Pass ifRevision, the revision an earlier send answered, to be refused with MESSAGE_CHANGED when it moved on. When a member sent it, the recipient's approve, edit, reject or reply comes back to the thread it was sent from. Answers id, revision, updated and the recipient: say who it went to. Keys and text by kind: ticket-<slug of the title>, whose text is \"File the ticket <title> in <project>'s Backlog.\" then the reason and the description; start-<slug>, only for an unassigned or the member's own ticket while nothing of theirs builds or waits on them; delete-<slug> with its evidence; merge-<slug> with the merged text and each task's promptRevision; cron-<slug> with its prompt, crontab and projects; merge-plan with each pull request's number, head SHA and action. Before a ticket message, read the open tasks (`tasks list --include-prompt`): send nothing for work a session already covers, and name the Todo task that covers part of it in text. A 400 VALIDATION_ERROR wrote nothing: fix the fields in details and send again with the same key and memberId. Any other refusal is final: send to nobody else instead. An unknown outcome (a timeout, a 5xx) is never sent again. Pass the body with --body or --body-file.",
         "tags": ["sensei"],
         "x-kosuke-command": ["sensei", "messages", "send"],
         "x-kosuke-sandbox-token": true,
@@ -22408,7 +22295,7 @@
     "/api/sensei/thread-move": {
       "post": {
         "operationId": "senseiThreadMove",
-        "summary": "Move the member’s message that started this Turn’s thread into another of their threads, which it continues. Only Sensei calls it, and only before the Turn has written anything: Kosuke ends this Turn, sends the message into that thread, where it is answered with that thread’s memory, and removes this thread. Write no answer after it.",
+        "summary": "Move the member’s message that started this Turn’s thread into another of their threads, which it continues. Only Sensei calls it, and only before the Turn has written anything: Kosuke ends this Turn, sends the message into that thread, where it is answered with that thread’s memory, and removes this thread. Write no answer after it. Move it when it answers a question you asked in that thread, or is about that thread's work or session.",
         "tags": ["sensei"],
         "x-kosuke-command": ["sensei", "thread", "move"],
         "x-kosuke-sandbox-token": true,
@@ -22471,7 +22358,7 @@
     "/api/sensei/thread-split": {
       "post": {
         "operationId": "senseiThreadSplit",
-        "summary": "Split the member’s message that started this Turn’s thread into one thread per ask. Only Sensei calls it, once per message. The member’s message stays the root of this thread, which does the first ask; each other ask becomes a thread of its own with its own Turn. The reply lists the asks handed off: do not do those here.",
+        "summary": "Split the member’s message that started this Turn’s thread into one thread per ask. Only Sensei calls it, once per message. The member’s message stays the root of this thread, which does the first ask; each other ask becomes a thread of its own with its own Turn. The reply lists the asks handed off: do not do those here. Each ask stands alone: \"Ship A, B and C\" is three asks, the steps of one piece of work are one.",
         "tags": ["sensei"],
         "x-kosuke-command": ["sensei", "thread", "split"],
         "x-kosuke-sandbox-token": true,
@@ -23032,7 +22919,7 @@
     "/api/tasks": {
       "get": {
         "operationId": "tasksAll",
-        "summary": "List tasks across your workspaces. Agent credentials stay in their workspace. includeOpenCount counts Todo and In progress with the same filters, independent of status and cursor.",
+        "summary": "List tasks across your workspaces. Agent credentials stay in their workspace. includeOpenCount counts Todo and In progress with the same filters, independent of status and cursor. Before you file or propose a ticket, read the open ones (--status todo,in_progress --include-prompt, following meta.pagination.nextCursor with --cursor) and judge overlap by meaning, not title words: work another task or session already covers gets no new ticket.",
         "tags": ["tasks"],
         "x-kosuke-command": ["tasks", "all"],
         "x-kosuke-sandbox-token": true,
@@ -23144,7 +23031,9 @@
             "name": "includePrompt",
             "in": "query",
             "required": false,
+            "description": "Adds each task's prompt: a Todo task's description, or its first message after Start, cut at 4,000 characters (promptTruncated). Read `tasks get` for a cut or empty one.",
             "schema": {
+              "description": "Adds each task's prompt: a Todo task's description, or its first message after Start, cut at 4,000 characters (promptTruncated). Read `tasks get` for a cut or empty one.",
               "type": "boolean"
             }
           },
@@ -23320,7 +23209,7 @@
       },
       "post": {
         "operationId": "userCronsCreate",
-        "summary": "Create a Personal Cron, enabled, with you as its owner. A Personal Cron belongs to you and no workspace: with Personal Repositories or Apps it runs in its own sandbox; without, in its Sensei Thread. Repository runs use your own Subscriptions; thread runs use your Subscriptions or Kosuke free when you hold none. Kosuke free cannot run a Cron with repositories yet. The crontab is read in the cron's own timezone, and may not fire more often than every 15 minutes. The model is an encoded id such as anthropic:opus__xhigh; repositories require an explicit Model from any released Provider on one of your Subscriptions. Changing to Free while you hold a Subscription, or to a personal Model without one, is refused. Without repositories, null or left out runs on the thread’s model. From your Sensei it is refused with 409 CRON_ALREADY_EXISTS when you have a Personal Cron by that name.",
+        "summary": "Create a Personal Cron, enabled, with you as its owner. A Personal Cron belongs to you and no workspace: with Personal Repositories or Apps it runs in its own sandbox; without, in its Sensei Thread. Repository runs use your own Subscriptions; thread runs use your Subscriptions or Kosuke free when you hold none. Kosuke free cannot run a Cron with repositories yet. The crontab is read in the cron's own timezone, and may not fire more often than every 15 minutes. The model is an encoded id such as anthropic:opus__xhigh; repositories require an explicit Model from any released Provider on one of your Subscriptions. Changing to Free while you hold a Subscription, or to a personal Model without one, is refused. Without repositories, null or left out runs on the thread’s model. From your Sensei it is refused with 409 CRON_ALREADY_EXISTS when you have a Personal Cron by that name: update that one instead. From Sensei, create or change one only when the member asks. To move a workspace Cron here, read it and recreate it with its timezone (its model only when the member's own Subscription runs it); the member deletes the workspace one in the app.",
         "tags": ["user"],
         "x-kosuke-command": ["user", "crons", "create"],
         "x-kosuke-sandbox-token": true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kosuke-ai/kosuke",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Kosuke platform CLI. The client customers install to drive app.kosuke.ai from their own machine.",
   "license": "MIT",
   "repository": {
@@ -40,10 +40,12 @@
     "vitest": "^4.1.12"
   },
   "kosukeRelease": {
-    "sourceCommit": "a12d5ea4ee5848ee63410de21c82ddf4236ad2a1",
-    "sourceIdentity": "a6641d76081e4b13391d8de2d14808cdaa2fdbce99c800fb80ecc17ddcb51318",
+    "sourceCommit": "bc66357937d20c3224158d1242666e8bc27b70e7",
+    "sourceIdentity": "119a65423855174a560baee6ec929f2ef6cc3cf15fdd1aaedbbe67c20e55c1d6",
     "fragments": [
-      "agent-permission-tiers-4m8q2x.json"
+      "cli-drop-lead-aliases-k3v8pq.json",
+      "help-from-guides-r4w8kn.json",
+      "memory-general-only-r4t8nz.json"
     ]
   }
 }

package/dist/generated/commands/sensei/reels-proposals.js

@@ -1,25 +0,0 @@
-export const operation = {
-    "method": "get",
-    "path": "/api/sensei/reels/proposals",
-    "command": [
-        "sensei",
-        "reels",
-        "proposals"
-    ],
-    "summary": "Read your Backlog proposals newest first by ticket creation or edit, ten per page, excluding the ones you skipped at the current ticket version.",
-    "pathParams": [],
-    "query": [
-        {
-            "name": "cursor",
-            "flag": "cursor",
-            "kind": "string",
-            "required": false,
-            "description": "Opaque cursor from the previous page."
-        }
-    ],
-    "body": null,
-    "multipart": null,
-    "attachments": false,
-    "anonymous": false,
-    "agents": "all"
-};

package/dist/generated/commands/sensei/reels-skips.js

@@ -1,33 +0,0 @@
-export const operation = {
-    "method": "post",
-    "path": "/api/sensei/reels/skips",
-    "command": [
-        "sensei",
-        "reels",
-        "skips"
-    ],
-    "summary": "Skip your Backlog proposal on every device until its ticket version changes.",
-    "pathParams": [],
-    "query": [],
-    "body": {
-        "fields": [
-            {
-                "name": "sessionId",
-                "flag": "session-id",
-                "kind": "string",
-                "required": true
-            },
-            {
-                "name": "ticketVersion",
-                "flag": "ticket-version",
-                "kind": "string",
-                "required": true
-            }
-        ],
-        "required": true
-    },
-    "multipart": null,
-    "attachments": false,
-    "anonymous": false,
-    "agents": "all"
-};