@kosuke-ai/kosuke 1.0.7 → 1.0.9

package/dist/generated/commands/sessions/qa-runs-finish.js

@@ -0,0 +1,66 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/qa-runs/{run}/finish",
+    "command": [
+        "sessions",
+        "qa",
+        "runs",
+        "finish"
+    ],
+    "summary": "Finish a QA Run and record QA Passed when the whole checklist passed at the sandbox's clean HEAD; the answer's qaPassed says why not. A run that ends failed, blocked or incomplete clears a QA Passed the session's runs recorded at its head. Finishing again decides again. Only the session's own sandbox.",
+    "pathParams": [
+        "projectId",
+        "sessionId",
+        "run"
+    ],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "checklist",
+                "flag": "checklist",
+                "kind": "string",
+                "required": true,
+                "description": "The Testing Checklist as the sandbox holds it: `--checklist-file \"$ART/testing-checklist.md\"`.",
+                "file": true
+            },
+            {
+                "name": "notes",
+                "flag": "note",
+                "kind": "string",
+                "required": false,
+                "description": "A run-level note: a held-back section, a repair, a crash.",
+                "repeated": true
+            },
+            {
+                "name": "usage",
+                "flag": "usage",
+                "kind": "json",
+                "required": false,
+                "description": "The run's Delegated Run usage: `--usage-file <path>`.",
+                "file": true
+            },
+            {
+                "name": "acceptBlocked",
+                "flag": "accept-blocked",
+                "kind": "string",
+                "required": false,
+                "description": "The running Batch's session only: the BLOCKED item ids it accepts, comma separated."
+            },
+            {
+                "name": "why",
+                "flag": "why",
+                "kind": "string",
+                "required": false,
+                "description": "With --accept-blocked: one line on why the blocked items may merge."
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": [
+        "sandboxToken"
+    ]
+};

package/dist/generated/commands/sessions/qa-runs-fixes-create.js

@@ -0,0 +1,65 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/qa-runs/{run}/fixes",
+    "command": [
+        "sessions",
+        "qa",
+        "runs",
+        "fixes",
+        "create"
+    ],
+    "summary": "Record a fix commit of a QA Run, a commit on HEAD after the run's start: unticks the FAILED items it targets for their retest and adds them to the selection. Only the session's own sandbox.",
+    "pathParams": [
+        "projectId",
+        "sessionId",
+        "run"
+    ],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "checklist",
+                "flag": "checklist",
+                "kind": "string",
+                "required": true,
+                "description": "The Testing Checklist as the sandbox holds it: `--checklist-file \"$ART/testing-checklist.md\"`.",
+                "file": true
+            },
+            {
+                "name": "section",
+                "flag": "section",
+                "kind": "string",
+                "required": true,
+                "description": "The section the fix is for."
+            },
+            {
+                "name": "sha",
+                "flag": "sha",
+                "kind": "string",
+                "required": true,
+                "description": "The full sha of the fix commit."
+            },
+            {
+                "name": "subject",
+                "flag": "subject",
+                "kind": "string",
+                "required": true,
+                "description": "The commit subject."
+            },
+            {
+                "name": "retest",
+                "flag": "retest",
+                "kind": "string",
+                "required": true,
+                "description": "The FAILED item ids the fix targets, comma separated; at least one."
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": [
+        "sandboxToken"
+    ]
+};

package/dist/generated/commands/sessions/qa-runs-get.js

@@ -0,0 +1,22 @@
+export const operation = {
+    "method": "get",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/qa-runs/{run}",
+    "command": [
+        "sessions",
+        "qa",
+        "runs",
+        "get"
+    ],
+    "summary": "Read a QA Run, or `latest`, as data: each section and item of the session's published Testing Checklist with its status and the outcome that explains it, the counts, the assessment, the history and the budget.",
+    "pathParams": [
+        "projectId",
+        "sessionId",
+        "run"
+    ],
+    "query": [],
+    "body": null,
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

package/dist/generated/commands/sessions/qa-runs-results-create.js

@@ -0,0 +1,45 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/qa-runs/{run}/results",
+    "command": [
+        "sessions",
+        "qa",
+        "runs",
+        "results",
+        "create"
+    ],
+    "summary": "Apply one section attempt a tester or prober wrote to a QA Run: stores it, ticks or tags its items and republishes the QA Report. The same result again changes nothing. Only the session's own sandbox.",
+    "pathParams": [
+        "projectId",
+        "sessionId",
+        "run"
+    ],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "checklist",
+                "flag": "checklist",
+                "kind": "string",
+                "required": true,
+                "description": "The Testing Checklist as the sandbox holds it: `--checklist-file \"$ART/testing-checklist.md\"`.",
+                "file": true
+            },
+            {
+                "name": "result",
+                "flag": "result",
+                "kind": "json",
+                "required": true,
+                "description": "One section attempt, as the tester wrote it: `--result-file <result path>`.",
+                "file": true
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": [
+        "sandboxToken"
+    ]
+};

package/dist/generated/commands/sessions/qa-runs-start.js

@@ -0,0 +1,75 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/qa-runs",
+    "command": [
+        "sessions",
+        "qa",
+        "runs",
+        "start"
+    ],
+    "summary": "Start a QA Run of the session's Testing Checklist, or continue the newest one when HEAD is its start or only its fixes moved it. Only the session's own sandbox. Answers the checklist to write back, the counts and the budget.",
+    "pathParams": [
+        "projectId",
+        "sessionId"
+    ],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "checklist",
+                "flag": "checklist",
+                "kind": "string",
+                "required": true,
+                "description": "The Testing Checklist as the sandbox holds it: `--checklist-file \"$ART/testing-checklist.md\"`.",
+                "file": true
+            },
+            {
+                "name": "head",
+                "flag": "head",
+                "kind": "string",
+                "required": true,
+                "description": "The commit the run tests: `git rev-parse HEAD`."
+            },
+            {
+                "name": "select",
+                "flag": "select",
+                "kind": "string",
+                "required": true,
+                "description": "The item ids to test, comma separated. '' only when every item already passed or there is none."
+            },
+            {
+                "name": "mode",
+                "flag": "mode",
+                "kind": "string",
+                "required": true,
+                "description": "`ship` under /kosuke:ship, else `standalone`.",
+                "choices": [
+                    "ship",
+                    "standalone"
+                ]
+            },
+            {
+                "name": "restart",
+                "flag": "restart",
+                "kind": "boolean",
+                "required": false,
+                "description": "Untick every item and start the QA Report over at v1. Only when asked."
+            },
+            {
+                "name": "sync",
+                "flag": "sync",
+                "kind": "json",
+                "required": false,
+                "description": "The sync scope with your `items` decisions: `--sync-file /tmp/qa/sync-scope.json`.",
+                "file": true
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": [
+        "sandboxToken"
+    ]
+};

package/dist/generated/commands/sessions/qa-runs-stop.js

@@ -0,0 +1,43 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/qa-runs/{run}/block",
+    "command": [
+        "sessions",
+        "qa",
+        "runs",
+        "stop"
+    ],
+    "summary": "Block what is left of a QA Run's selection with the reason, and finish it. Records no pass. Only the session's own sandbox.",
+    "pathParams": [
+        "projectId",
+        "sessionId",
+        "run"
+    ],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "checklist",
+                "flag": "checklist",
+                "kind": "string",
+                "required": true,
+                "description": "The Testing Checklist as the sandbox holds it: `--checklist-file \"$ART/testing-checklist.md\"`.",
+                "file": true
+            },
+            {
+                "name": "reason",
+                "flag": "reason",
+                "kind": "string",
+                "required": true,
+                "description": "Why the rest of the selection could not be tested, specifically."
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": [
+        "sandboxToken"
+    ]
+};

package/dist/generated/commands/sessions/qa-set.js

@@ -6,7 +6,7 @@ export const operation = {
         "qa",
         "set"
     ],
-    "summary": "Record the commit QA passed on as the session's qaPassedSha. A session token may set only its own session. 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. 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.",
     "pathParams": [
         "projectId",
         "sessionId"

package/dist/generated/commands/sessions/review-set.js

@@ -0,0 +1,53 @@
+export const operation = {
+    "method": "put",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/review",
+    "command": [
+        "sessions",
+        "review",
+        "set"
+    ],
+    "summary": "Record a review's verdict for the sandbox's HEAD, with the head and tree Kosuke reads from the checkout. Refused (409) while HEAD is not the given head, while tracked files have uncommitted changes, or once the Turn stopped. Only the session's own sandbox.",
+    "pathParams": [
+        "projectId",
+        "sessionId"
+    ],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "verdict",
+                "flag": "verdict",
+                "kind": "string",
+                "required": true,
+                "description": "`Ship` with every finding fixed or none, `Do not ship` with one open, `Incomplete` when no reviewer answered.",
+                "choices": [
+                    "Ship",
+                    "Ship with open items",
+                    "Do not ship",
+                    "Incomplete"
+                ]
+            },
+            {
+                "name": "head",
+                "flag": "head",
+                "kind": "string",
+                "required": true,
+                "description": "The commit the review covers, after its fixes: `git rev-parse HEAD`."
+            },
+            {
+                "name": "run",
+                "flag": "run",
+                "kind": "integer",
+                "required": true,
+                "description": "The review's run: when it started, in epoch seconds (`cat /tmp/review/run`)."
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": [
+        "sandboxToken"
+    ]
+};

package/dist/generated/commands/sessions/{runtime-command.js → runtime-commands-run.js}

@@ -3,7 +3,8 @@ export const operation = {
     "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/runtime-commands",
     "command": [
         "sessions",
-        "runtime-command"
+        "runtime-commands",
+        "run"
     ],
     "summary": "Run a runtime command on the agent session: clear starts a fresh conversation, compact summarizes it, with optional focus instructions. Queued Up next while a turn or another command is running. Compact waits for the sandbox and can take a minute.",
     "pathParams": [

package/dist/generated/commands/sessions/{activate.js → start.js}

@@ -3,7 +3,7 @@ export const operation = {
     "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/activate",
     "command": [
         "sessions",
-        "activate"
+        "start"
     ],
     "summary": "Start a backlog session: queue its saved prompt as the first turn, which runs once the sandbox is ready. Answers before the sandbox exists; a sandbox that fails to start later leaves the session Active with a failed first turn. With --skill ship the first turn is /kosuke:ship on that prompt. From an agent (a sandbox, a Cron Run or Sensei) it is also refused with 403 ASSIGNED_TO_OTHER when another member is the Assignee; a ticket that is unassigned or assigned to Kosuke passes that check and meets the same project access and status checks as when a member starts it. From Sensei, the session moves to the thread of the Turn that started it.",
     "pathParams": [

package/dist/generated/commands/sessions/update.js

@@ -102,7 +102,7 @@ export const operation = {
                 "flag": "app-stack",
                 "kind": "string",
                 "required": false,
-                "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": "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 `kosuke sessions app-stack start`. Fixed once the session starts.",
                 "choices": [
                     "start",
                     "skip"

package/dist/generated/commands/{user/skills-create.js → skills/create--personal.js}

@@ -2,10 +2,12 @@ export const operation = {
     "method": "post",
     "path": "/api/user/skills",
     "command": [
-        "user",
         "skills",
         "create"
     ],
+    "variant": {
+        "scope": "personal"
+    },
     "summary": "Add a personal skill from its files. A SKILL.md is required; its frontmatter carries the kebab-case name, the description and an optional argument-hint. Text files only, 100 KiB each, 50 files and 1 MiB in all. Names are unique among your own personal skills. Answers 201 with the id of the new skill.",
     "pathParams": [],
     "query": [],

package/dist/generated/commands/{workspaces/skills-create.js → skills/create.js}

@@ -2,7 +2,6 @@ export const operation = {
     "method": "post",
     "path": "/api/organizations/{workspaceId}/skills",
     "command": [
-        "workspaces",
         "skills",
         "create"
     ],

package/dist/generated/commands/{user/skills-delete.js → skills/delete--personal.js}

@@ -2,10 +2,12 @@ export const operation = {
     "method": "delete",
     "path": "/api/user/skills/{skillId}",
     "command": [
-        "user",
         "skills",
         "delete"
     ],
+    "variant": {
+        "scope": "personal"
+    },
     "summary": "Delete one of your personal skills. Running chat sessions drop it at their next turn.",
     "pathParams": [
         "skillId"

package/dist/generated/commands/{workspaces/skills-delete.js → skills/delete.js}

@@ -2,7 +2,6 @@ export const operation = {
     "method": "delete",
     "path": "/api/organizations/{workspaceId}/skills/{skillId}",
     "command": [
-        "workspaces",
         "skills",
         "delete"
     ],

package/dist/generated/commands/{user/skills-get.js → skills/get--personal.js}

@@ -2,10 +2,12 @@ export const operation = {
     "method": "get",
     "path": "/api/user/skills/{skillId}",
     "command": [
-        "user",
         "skills",
         "get"
     ],
+    "variant": {
+        "scope": "personal"
+    },
     "summary": "Get one of your personal skills with every file it holds, SKILL.md included. From an agent token, one of the member it acts as. From a Cron Run with no member behind it, never one: it acts as Kosuke, which holds no personal skills.",
     "pathParams": [
         "skillId"

package/dist/generated/commands/{workspaces/skills-get.js → skills/get.js}

@@ -2,7 +2,6 @@ export const operation = {
     "method": "get",
     "path": "/api/organizations/{workspaceId}/skills/{skillId}",
     "command": [
-        "workspaces",
         "skills",
         "get"
     ],

package/dist/generated/commands/{user/skills-list.js → skills/list--personal.js}

@@ -2,10 +2,12 @@ export const operation = {
     "method": "get",
     "path": "/api/user/skills",
     "command": [
-        "user",
         "skills",
         "list"
     ],
+    "variant": {
+        "scope": "personal"
+    },
     "summary": "List your personal skills: what each SKILL.md declares, how many files the skill holds, whether it is enabled, and the workspaces where it replaces an enabled workspace skill of the same name. Personal skills follow you into every workspace you belong to and reach the chat sessions you are the assignee of. From an agent token, those of the member it acts as, naming only this workspace. From a Cron Run with no member behind it, none.",
     "pathParams": [],
     "query": [],

package/dist/generated/commands/{workspaces/skills-list.js → skills/list.js}

@@ -2,7 +2,6 @@ export const operation = {
     "method": "get",
     "path": "/api/organizations/{workspaceId}/skills",
     "command": [
-        "workspaces",
         "skills",
         "list"
     ],

package/dist/generated/commands/{user/skills-update.js → skills/update--personal.js}

@@ -2,10 +2,12 @@ export const operation = {
     "method": "patch",
     "path": "/api/user/skills/{skillId}",
     "command": [
-        "user",
         "skills",
         "update"
     ],
+    "variant": {
+        "scope": "personal"
+    },
     "summary": "Enable or disable one of your personal skills, or replace every file it holds; at least one of enabled and files. The switch applies in every workspace at once. Answers 204.",
     "pathParams": [
         "skillId"

package/dist/generated/commands/{workspaces/skills-update.js → skills/update.js}

@@ -2,7 +2,6 @@ export const operation = {
     "method": "patch",
     "path": "/api/organizations/{workspaceId}/skills/{skillId}",
     "command": [
-        "workspaces",
         "skills",
         "update"
     ],

package/dist/generated/commands/{personal-tasks/create.js → tasks/create--personal.js}

@@ -2,10 +2,13 @@ export const operation = {
     "method": "post",
     "path": "/api/personal-tasks",
     "command": [
-        "personal-tasks",
+        "tasks",
         "create"
     ],
-    "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.",
+    "variant": {
+        "scope": "personal"
+    },
+    "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 `kosuke tasks list personal` for one that covers it first.",
     "pathParams": [],
     "query": [],
     "body": {

package/dist/generated/commands/tasks/create.js

@@ -96,7 +96,7 @@ export const operation = {
                 "flag": "app-stack",
                 "kind": "string",
                 "required": false,
-                "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": "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 `kosuke sessions app-stack start`. Fixed once the session starts.",
                 "choices": [
                     "start",
                     "skip"
@@ -226,7 +226,7 @@ export const operation = {
             "flag": "app-stack",
             "kind": "string",
             "required": false,
-            "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": "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 `kosuke sessions app-stack start`. Fixed once the session starts.",
             "choices": [
                 "start",
                 "skip"

package/dist/generated/commands/{personal-tasks/delete.js → tasks/delete--personal.js}

@@ -2,9 +2,12 @@ export const operation = {
     "method": "delete",
     "path": "/api/personal-tasks/{taskId}",
     "command": [
-        "personal-tasks",
+        "tasks",
         "delete"
     ],
+    "variant": {
+        "scope": "personal"
+    },
     "summary": "Delete one of your personal tasks.",
     "pathParams": [
         "taskId"

package/dist/generated/commands/{personal-tasks/get.js → tasks/get--personal.js}

@@ -2,9 +2,12 @@ export const operation = {
     "method": "get",
     "path": "/api/personal-tasks/{taskId}",
     "command": [
-        "personal-tasks",
+        "tasks",
         "get"
     ],
+    "variant": {
+        "scope": "personal"
+    },
     "summary": "Get one of your personal tasks.",
     "pathParams": [
         "taskId"

package/dist/generated/commands/tasks/{labels.js → labels-list.js}

@@ -3,7 +3,8 @@ export const operation = {
     "path": "/api/organizations/{workspaceId}/labels",
     "command": [
         "tasks",
-        "labels"
+        "labels",
+        "list"
     ],
     "summary": "List the label names across a workspace's repositories, for the tasks list's labels filter.",
     "pathParams": [