@kosuke-ai/kosuke 1.0.46 → 1.0.48

package/dist/program.js

@@ -6,15 +6,13 @@ import { attachIntegrationsCommands } from './commands/integrations.js';
 import { attachWatchCommand } from './commands/watch.js';
 import { operations } from './generated/commands/index.js';
 import { attachCommand } from './runtime/attach.js';
-import { attachFormerCommands } from './runtime/former-commands.js';
 import { formsOf } from './runtime/variants.js';
 import { agentTokenOf, isReachable } from './runtime/agent-tokens.js';
 import { createRuntime, ExitSignal } from './runtime/runtime.js';
 import { version } from './runtime/version.js';
 /**
  * The command tree: the commands `commands/hand-written.ts` lists by hand, everything else
- * from the generated descriptors, one leaf per command over its forms, then the former
- * names as hidden aliases. Global flags are read
+ * from the generated descriptors, one leaf per command over its forms. Global flags are read
  * before any subcommand runs, so the runtime the subcommands share is built once, from them.
  */
 export function createProgram(options = {}) {
@@ -61,7 +59,6 @@ export function createProgram(options = {}) {
     // The job stream admits a member's API key only; it closes 4401 on every narrower token.
     if (narrowedTo === null)
         attachWatchCommand(program, lazy, options.watch);
-    attachFormerCommands(program, operations.filter(reaches), lazy);
     return program;
 }
 /** Run to completion; an ExitSignal has already reported and set the exit code. */

package/dist/runtime/attach.js

@@ -13,16 +13,13 @@ export function attachCommand(root, forms, runtime, { reachable = () => true } =
     const [only] = forms;
     if (forms.length === 1 && !only.variant) {
         // A hidden operation sits beside a hand-written command in a visible group.
-        return attachLeaf(root, only.command, only, runtime, {
-            hidden: only.hidden === true,
-            groupsHidden: false,
-        });
+        return attachLeaf(root, only.command, only, runtime, only.hidden === true);
     }
     return attachForms(root, forms, runtime, reachable);
 }
-/** A single-form leaf: the command as it was before forms, which aliases reuse. */
-export function attachLeaf(root, path, operation, runtime, { hidden, groupsHidden = hidden, fixed = {}, formerFlags = {} }) {
-    const parent = groupFor(root, path.slice(0, -1), { hidden: groupsHidden });
+/** A leaf for an operation with a single form. */
+function attachLeaf(root, path, operation, runtime, hidden) {
+    const parent = groupFor(root, path.slice(0, -1));
     const leaf = parent.command(path[path.length - 1], { hidden });
     leaf.description(operation.summary);
     for (const name of operation.pathParams) {
@@ -31,25 +28,13 @@ export function attachLeaf(root, path, operation, runtime, { hidden, groupsHidde
     const fields = fieldsOf(operation);
     for (const field of fields)
         addFieldOptions(leaf, field, field.description ?? '');
-    for (const [former, current] of Object.entries(formerFlags)) {
-        const field = fields.find((candidate) => candidate.flag === current);
-        if (!field) {
-            throw new Error(`kosuke ${path.join(' ')}: --${former} names --${current}, not a flag.`);
-        }
-        const option = new Option(`--${former} <value>`).hideHelp();
-        // Repeated as it was, `--project-ids a --project-ids b`, or one JSON list.
-        if (field.repeated)
-            option.argParser(collect).default(undefined);
-        leaf.addOption(option);
-    }
     addBodyOptions(leaf, operation);
     leaf.action(async (...args) => {
         const options = args[args.length - 2];
         const positionals = args.slice(0, operation.pathParams.length);
         try {
             checkFileFlags(options, fields.filter((field) => field.file).map((field) => field.flag));
-            // `personal` where a workspace id goes, on a command with no personal form. An alias
-            // leaf runs a personal form by its old path, which takes no workspace id at all.
+            // Refuse `personal` where a workspace id goes on a command with no personal form.
             if (!operation.variant)
                 selectForm([operation], { first: positionals[0], flags: {} });
         }
@@ -58,19 +43,13 @@ export function attachLeaf(root, path, operation, runtime, { hidden, groupsHidde
                 leaf.error(error.message);
             throw error;
         }
-        const values = Object.fromEntries(fields.map((field) => {
-            const former = Object.entries(formerFlags).find(([, current]) => current === field.flag);
-            const formerValue = former
-                ? formerValueOf(field, options[optionKey(former[0])])
-                : undefined;
-            return [
-                field.name,
-                options[optionKey(field.flag)] ?? fileValue(field, options) ?? formerValue,
-            ];
-        }));
+        const values = Object.fromEntries(fields.map((field) => [
+            field.name,
+            options[optionKey(field.flag)] ?? fileValue(field, options),
+        ]));
         await run(leaf, runtime, operation, {
             pathParams: Object.fromEntries(operation.pathParams.map((name, i) => [name, positionals[i]])),
-            fields: { ...values, ...fixed },
+            fields: values,
             wholeBody: readWholeBody({
                 body: options.body,
                 bodyFile: options.bodyFile,
@@ -242,22 +221,6 @@ function parseForForm(field, raw) {
         return raw === 'true';
     return field.repeated ? [raw] : raw;
 }
-/** The value of a renamed flag, by the rule its field had: one JSON list, or the values given. */
-function formerValueOf(field, raw) {
-    if (Array.isArray(raw))
-        return raw.flatMap((value) => formerValueOf(field, value));
-    if (typeof raw !== 'string')
-        return raw;
-    if (!field.repeated)
-        return field.kind === 'json' ? jsonParser(raw) : raw;
-    try {
-        const parsed = JSON.parse(raw);
-        return Array.isArray(parsed) ? parsed : [raw];
-    }
-    catch {
-        return [raw];
-    }
-}
 function addFieldOptions(leaf, field, description) {
     leaf.addOption(optionFor({ ...field, description }));
     if (field.file) {
@@ -279,13 +242,12 @@ function addBodyOptions(leaf, operation) {
         leaf.option('--attach <path>', 'Attach a file; repeat for several. Sends the request as multipart.', collect, []);
     }
 }
-/** A group created here is hidden when asked; one that already exists keeps what it is. */
-export function groupFor(root, path, { hidden = false } = {}) {
+/** Find or create the command groups on the way to a leaf. */
+export function groupFor(root, path) {
     let current = root;
     for (const segment of path) {
         const existing = current.commands.find((command) => command.name() === segment);
-        current =
-            existing ?? current.command(segment, { hidden }).description(`${humanize(segment)} commands`);
+        current = existing ?? current.command(segment).description(`${humanize(segment)} commands`);
     }
     return current;
 }

package/openapi.json

@@ -10958,6 +10958,84 @@
         }
       }
     },
+    "/api/projects/{projectId}/batch-merging/picks": {
+      "put": {
+        "operationId": "projectsBatchMergingPicksSet",
+        "summary": "The open Batch's own session only, running or pipelined: replace the list of task pull requests merged into its branch. Their tasks show the Batch while it runs, and stop once it ends. Safe to repeat.",
+        "tags": ["projects"],
+        "x-kosuke-command": ["projects", "batch-merging", "picks", "set"],
+        "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": {
+                  "pullRequests": {
+                    "maxItems": 500,
+                    "type": "array",
+                    "items": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 2147483647
+                    },
+                    "description": "Every task pull request merged into this Batch's branch now, in merge order: the whole list, never its base Batch's. An empty list clears it."
+                  }
+                },
+                "required": ["pullRequests"]
+              }
+            }
+          }
+        },
+        "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}/branches": {
       "get": {
         "operationId": "projectsBranchesList",
@@ -12254,6 +12332,72 @@
         }
       }
     },
+    "/api/projects/{projectId}/chat-sessions/{sessionId}/env-sync": {
+      "post": {
+        "operationId": "sessionsEnvSync",
+        "summary": "Deliver the project's saved environment variables, with its services and setup commands, to a chat session's running sandbox and restart its setup and services, so a variable added after the sandbox booted reaches them. Answers status synced with the variable names, never their values, once the services answer again, or status running when setup outlasts ten minutes and the sync goes on. Refused, never queued: 409 TURN_RUNNING while a turn runs, SANDBOX_NOT_RUNNING when the sandbox is not up (it is not woken), SANDBOX_PROVISIONING or SANDBOX_NOT_READY while it is created or boots, APP_STACK_STARTING during an App stack start and SANDBOX_BUSY while another update changes it; 422 ENV_SYNC_FAILED when setup or a service did not come back.",
+        "tags": ["sessions"],
+        "x-kosuke-command": ["sessions", "env", "sync"],
+        "x-kosuke-answer-timeout-ms": 660000,
+        "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)$"
+            }
+          }
+        ],
+        "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}/go-ahead": {
       "put": {
         "operationId": "sessionsGoAheadSet",
@@ -14394,7 +14538,7 @@
     "/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, 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.",
+        "summary": "Record the commit QA passed on as the session's qaPassedSha: a member's override. `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,
@@ -18911,7 +19055,7 @@
     "/api/projects/{projectId}/settings/agentic-deploy/queue/{queuedMessageId}/steer": {
       "post": {
         "operationId": "deploysQueueSteer",
-        "summary": "Send your own queued Deploy Chat message into the running deploy agent Turn as a steer. Claude deploys only; the message stays queued when nothing can take it.",
+        "summary": "Send your own queued Deploy Chat message into the running deploy agent Turn as a steer, on any deploy model whose runtime takes one; the message stays queued when nothing can take it.",
         "tags": ["deploys"],
         "x-kosuke-command": ["deploys", "queue", "steer"],
         "x-kosuke-sandbox-token": true,
@@ -24248,6 +24392,74 @@
         }
       }
     },
+    "/api/sensei/thread-create": {
+      "post": {
+        "operationId": "senseiThreadsCreate",
+        "summary": "Open a new thread for the member, at any point of this Turn, on a prompt you write. Only Sensei calls it, for a separate topic that should not go on in this thread. Never for the asks of the member’s message that started this thread: `sensei threads split` does that. The new thread gets its own Turn, which may read Queued, and links back here; nothing of this thread goes with it, so the prompt says all it needs. A Turn opens at most 3 threads, and so do the threads opened from one thread in all. Answers the new thread id and turn id: do not do that work here.",
+        "tags": ["sensei"],
+        "x-kosuke-command": ["sensei", "threads", "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": {
+                  "prompt": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 20000,
+                    "description": "What the new thread’s Turn does, whole, in words that stand without this thread: it reads nothing else of it."
+                  },
+                  "title": {
+                    "description": "A short title for the new thread. Without it, the thread is named by the prompt.",
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 200
+                  }
+                },
+                "required": ["prompt"]
+              }
+            }
+          }
+        },
+        "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/thread-move": {
       "post": {
         "operationId": "senseiThreadsMove",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kosuke-ai/kosuke",
-  "version": "1.0.46",
+  "version": "1.0.48",
   "description": "Kosuke platform CLI. The client customers install to drive app.kosuke.ai from their own machine.",
   "license": "MIT",
   "repository": {
@@ -40,10 +40,13 @@
     "vitest": "^4.1.12"
   },
   "kosukeRelease": {
-    "sourceCommit": "f4683aa88f4cb9eb6912d2a4200eb6c1f200bcf7",
-    "sourceIdentity": "fdca0a6ab0b23ad62544a8f7e689f390510d911a476dee7ab45956bfb173e44b",
+    "sourceCommit": "f75c0ef51a675f14fa5bcc79de7d275f7084b580",
+    "sourceIdentity": "f07745a38e5f377026b443e17377c207475f86d04bec95ddce5886fb7adc9ffd",
     "fragments": [
-      "go-ahead-marks-ready-h7yijc.json"
+      "command-grammar-aliases-removed-mlwinm.json",
+      "sensei-threads-create-puzuue.json",
+      "session-env-sync-bk2sgu.json",
+      "skill-marker-result-help-pkivi6.json"
     ]
   }
 }