@kosuke-ai/kosuke 1.0.7 → 1.0.8

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

@@ -2,9 +2,12 @@ export const operation = {
     "method": "post",
     "path": "/api/personal-tasks/{taskId}/move",
     "command": [
-        "personal-tasks",
+        "tasks",
         "move"
     ],
+    "variant": {
+        "scope": "personal"
+    },
     "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.",
     "pathParams": [
         "taskId"

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

@@ -2,9 +2,12 @@ export const operation = {
     "method": "post",
     "path": "/api/personal-tasks/{taskId}/start",
     "command": [
-        "personal-tasks",
+        "tasks",
         "start"
     ],
+    "variant": {
+        "scope": "personal"
+    },
     "summary": "Start a Todo or In progress Personal task in a deployed Personal Repository.",
     "pathParams": [
         "taskId"
@@ -52,7 +55,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/tasks/start.js

@@ -53,7 +53,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/update.js → tasks/update--personal.js}

@@ -2,9 +2,12 @@ export const operation = {
     "method": "patch",
     "path": "/api/personal-tasks/{taskId}",
     "command": [
-        "personal-tasks",
+        "tasks",
         "update"
     ],
+    "variant": {
+        "scope": "personal"
+    },
     "summary": "Edit one of your personal tasks. dueOn or threadId null clears it.",
     "pathParams": [
         "taskId"

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

@@ -90,7 +90,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/{auth-token-revoke.js → api-keys-delete.js}

@@ -3,8 +3,8 @@ export const operation = {
     "path": "/api/user/api-keys/current",
     "command": [
         "user",
-        "auth-token",
-        "revoke"
+        "api-keys",
+        "delete"
     ],
     "summary": "Revoke the API key this request is made with, and no other. The Apple Watch and the Meta glasses call it when they sign out. Answers 204.",
     "pathParams": [],

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

@@ -3,7 +3,8 @@ export const operation = {
     "path": "/api/user/profile",
     "command": [
         "user",
-        "profile"
+        "profile",
+        "get"
     ],
     "summary": "Read your account: id, email, name, onboarding state, default model, auto-commit setting and Reply Style.",
     "pathParams": [],

package/dist/generated/commands/user/{push-devices-register.js → push-devices-create.js}

@@ -4,7 +4,7 @@ export const operation = {
     "command": [
         "user",
         "push-devices",
-        "register"
+        "create"
     ],
     "summary": "Register an iPhone or Apple Watch for push notifications with its hex APNs device token, the app bundle id it was issued to and its APNs environment. A token already registered moves to you. The Watch also sends its installationId and a generation it raises on every registration; one older than the registration already held for that installation answers 409. Both apps send their appVersion, which decides the notification categories they are sent. Called by the Kosuke iOS and Watch apps; answers 204.",
     "pathParams": [],

package/dist/generated/commands/user/{push-devices-remove.js → push-devices-delete.js}

@@ -4,7 +4,7 @@ export const operation = {
     "command": [
         "user",
         "push-devices",
-        "remove"
+        "delete"
     ],
     "summary": "Stop push notifications to one of your devices, by its APNs device token. A token that is not yours, or not registered, is left alone; answers 204 either way.",
     "pathParams": [],

package/dist/generated/commands/workspaces/{artifacts.js → artifacts-search.js}

@@ -3,7 +3,8 @@ export const operation = {
     "path": "/api/organizations/{workspaceId}/artifacts/search",
     "command": [
         "workspaces",
-        "artifacts"
+        "artifacts",
+        "search"
     ],
     "summary": "Search the Artifacts of a workspace by title, across its Chat Sessions and its Cron Runs. Rows only, each naming the session or run it was written in; read one with `sessions artifacts get` or `crons runs artifacts get`.",
     "pathParams": [

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

@@ -3,7 +3,8 @@ export const operation = {
     "path": "/api/organizations/{workspaceId}/credits",
     "command": [
         "workspaces",
-        "credits"
+        "credits",
+        "get"
     ],
     "summary": "Read the credit balance and limit of a workspace.",
     "pathParams": [

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

@@ -2,9 +2,13 @@ export const operation = {
     "method": "get",
     "path": "/api/members",
     "command": [
+        "workspaces",
         "members",
         "list"
     ],
+    "variant": {
+        "scope": "all"
+    },
     "summary": "List visible members across every workspace you belong to. Each roster names its workspace. An agent token reads its own workspace only.",
     "pathParams": [],
     "query": [

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

@@ -3,7 +3,8 @@ export const operation = {
     "path": "/api/organizations/{workspaceId}/members",
     "command": [
         "workspaces",
-        "members"
+        "members",
+        "list"
     ],
     "summary": "List the members of a workspace, and its pending invitations unless excluded.",
     "pathParams": [

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

@@ -3,7 +3,8 @@ export const operation = {
     "path": "/api/organizations/{workspaceId}/sandbox-limit",
     "command": [
         "workspaces",
-        "sandbox-limit"
+        "sandbox-limit",
+        "get"
     ],
     "summary": "Read how many sandboxes may run at once and which sessions are running now.",
     "pathParams": [

package/dist/generated/commands/workspaces/{stop-sandboxes.js → sandboxes-stop.js}

@@ -3,7 +3,8 @@ export const operation = {
     "path": "/api/organizations/{workspaceId}/stop-sandboxes",
     "command": [
         "workspaces",
-        "stop-sandboxes"
+        "sandboxes",
+        "stop"
     ],
     "summary": "Pause the sandboxes of the given chat sessions.",
     "pathParams": [

package/dist/generated/commands/workspaces/timezone-set.js

@@ -3,7 +3,8 @@ export const operation = {
     "path": "/api/organizations/{workspaceId}/timezone",
     "command": [
         "workspaces",
-        "timezone-set"
+        "timezone",
+        "set"
     ],
     "summary": "Set the Workspace Timezone, the IANA zone every cron of the workspace is read and shown in, e.g. Europe/Rome. Each enabled cron's next run moves to the new zone, except one already due, which fires on its slot. Refused, naming the crons, when any cron would fire more often than every 15 minutes or never in the new zone; nothing changes then. Sending the zone already set changes nothing. Owners and admins only.",
     "pathParams": [

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

@@ -3,7 +3,8 @@ export const operation = {
     "path": "/api/organizations/{workspaceId}/usage",
     "command": [
         "workspaces",
-        "usage"
+        "usage",
+        "get"
     ],
     "summary": "Read sandbox usage by day and by project. start must precede end and the range is capped at 366 days.",
     "pathParams": [

package/dist/integrations/api.js

@@ -87,7 +87,7 @@ export function failureOf(status, error, method) {
         return {
             ok: false,
             status,
-            message: 'The API key was refused (HTTP 401). Run `kosuke auth status`.',
+            message: 'The API key was refused (HTTP 401). Run `kosuke auth status get`.',
         };
     }
     if (status === 429) {

package/dist/integrations/render.js

@@ -47,7 +47,7 @@ export function renderOverview(overview, filtered) {
     else {
         out.push(`${plural(overview.connectionTotal, 'connection')}. ` +
             "`kosuke integrations list --toolkit <slug>` shows a toolkit's tools; " +
-            "`kosuke integrations describe <tool>` prints one tool's input schema.");
+            "`kosuke integrations tools get <tool>` prints one tool's input schema.");
     }
     if (note)
         out.push(note);

package/dist/program.js

@@ -5,13 +5,16 @@ import { attachAuthCommands } from './commands/auth.js';
 import { attachIntegrationsCommands } from './commands/integrations.js';
 import { attachWatchCommand } from './commands/watch.js';
 import { operations } from './generated/commands/index.js';
-import { attachOperation } from './runtime/attach.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: `auth`, `agent`, `integrations list|describe|call` and `sessions watch` by
- * hand, everything else from the generated descriptors. Global flags are read
+ * 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
  * before any subcommand runs, so the runtime the subcommands share is built once, from them.
  */
 export function createProgram(options = {}) {
@@ -40,22 +43,25 @@ export function createProgram(options = {}) {
     // Read from the env alone, which keeps `--help` off the credentials file.
     const token = (options.process?.env ?? process.env).KOSUKE_API_KEY;
     const narrowedTo = agentTokenOf(token);
-    const reachable = narrowedTo
-        ? operations.filter((operation) => isReachable(operation.agents, narrowedTo))
-        : operations;
-    for (const operation of reachable)
-        attachOperation(program, operation, lazy);
+    // Per form: a command attaches when any of its forms is reachable, and a call to a form
+    // the key does not reach is refused by name.
+    const reaches = (operation) => !narrowedTo || isReachable(operation.agents, narrowedTo);
+    for (const forms of formsOf(operations).values()) {
+        if (forms.some(reaches))
+            attachCommand(program, forms, lazy, { reachable: reaches });
+    }
     // Every agent token reads the digest's two lists as its member. Only a
     // member's own key and their Sensei may mark Activity seen, so the others
     // read it with `--peek`.
     attachAgentCommands(program, lazy, options.agent);
     if (narrowedTo === null || narrowedTo === 'sandboxToken')
         attachSkillMarkerCommands(program, options.process);
-    // Beside the generated `integrations tools` and `execute`, which stay raw passthroughs.
+    // Beside the generated, hidden `integrations tools list|call`, which stay raw passthroughs.
     attachIntegrationsCommands(program, lazy, options.integrations);
     // 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. */