@kosuke-ai/kosuke 1.0.6 → 1.0.8

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

@@ -5,7 +5,7 @@ export const operation = {
         "tasks",
         "create"
     ],
-    "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.",
     "pathParams": [
         "workspaceId"
     ],
@@ -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"
@@ -106,7 +106,8 @@ export const operation = {
                 "name": "description",
                 "flag": "description",
                 "kind": "string",
-                "required": true
+                "required": true,
+                "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."
             },
             {
                 "name": "hintProjectId",
@@ -225,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"
@@ -235,7 +236,8 @@ export const operation = {
             "name": "description",
             "flag": "description",
             "kind": "string",
-            "required": true
+            "required": true,
+            "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."
         },
         {
             "name": "hintProjectId",

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": [

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

@@ -3,9 +3,12 @@ export const operation = {
     "path": "/api/tasks",
     "command": [
         "tasks",
-        "all"
+        "list"
     ],
-    "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.",
+    "variant": {
+        "scope": "all"
+    },
+    "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.",
     "pathParams": [],
     "query": [
         {
@@ -85,7 +88,8 @@ export const operation = {
             "name": "includePrompt",
             "flag": "include-prompt",
             "kind": "boolean",
-            "required": false
+            "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."
         },
         {
             "name": "includeOpenCount",

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

@@ -2,9 +2,12 @@ export const operation = {
     "method": "get",
     "path": "/api/personal-tasks",
     "command": [
-        "personal-tasks",
+        "tasks",
         "list"
     ],
+    "variant": {
+        "scope": "personal"
+    },
     "summary": "List your personal tasks, newest first. status is a csv of todo, in_progress, done; includeOpenCount counts Todo and In progress with the same filters, independent of status and cursor.",
     "pathParams": [],
     "query": [

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

@@ -5,7 +5,7 @@ export const operation = {
         "tasks",
         "list"
     ],
-    "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.",
     "pathParams": [
         "workspaceId"
     ],
@@ -87,7 +87,8 @@ export const operation = {
             "name": "includePrompt",
             "flag": "include-prompt",
             "kind": "boolean",
-            "required": false
+            "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."
         },
         {
             "name": "includeOpenCount",

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

@@ -2,10 +2,13 @@ export const operation = {
     "method": "post",
     "path": "/api/personal-tasks/{taskId}/move",
     "command": [
-        "personal-tasks",
+        "tasks",
         "move"
     ],
-    "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.",
+    "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"
@@ -31,7 +34,8 @@ export const operation = {
                 "name": "prompt",
                 "flag": "prompt",
                 "kind": "string",
-                "required": false
+                "required": false,
+                "description": "Other text for the first message. The description stays as it is."
             },
             {
                 "name": "sandboxSize",
@@ -51,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

@@ -5,7 +5,7 @@ export const operation = {
         "tasks",
         "start"
     ],
-    "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.",
     "pathParams": [
         "workspaceId",
         "taskId"
@@ -32,7 +32,8 @@ export const operation = {
                 "name": "prompt",
                 "flag": "prompt",
                 "kind": "string",
-                "required": false
+                "required": false,
+                "description": "Other text for the first message. The description stays as it is."
             },
             {
                 "name": "sandboxSize",
@@ -52,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"
@@ -124,13 +124,15 @@ export const operation = {
                 "name": "description",
                 "flag": "description",
                 "kind": "string",
-                "required": false
+                "required": false,
+                "description": "The whole new description, only when the goal changed: never because the task starts."
             },
             {
                 "name": "ifRevision",
                 "flag": "if-revision",
                 "kind": "string",
-                "required": false
+                "required": false,
+                "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."
             },
             {
                 "name": "hintProjectId",

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. */

package/dist/runtime/agent-tokens.js

@@ -11,14 +11,8 @@ export const AGENT_TOKENS = [
     { token: 'sandboxToken', prefixes: ['kosuke_sbx_'], extension: 'x-kosuke-sandbox-token' },
     // Wire contract with `src/lib/auth/cron-token.ts`: one Cron Run.
     { token: 'cronToken', prefixes: ['kosuke_crn_'], extension: 'x-kosuke-cron-token' },
-    // Wire contract with `src/lib/auth/sensei-token.ts`: a Sensei Chat's Turn. A token minted
-    // before the Sensei rename carries `kosuke_lead_` until it expires; drop that prefix one
-    // release after the rename.
-    {
-        token: 'senseiToken',
-        prefixes: ['kosuke_sensei_', 'kosuke_lead_'],
-        extension: 'x-kosuke-sensei-token',
-    },
+    // Wire contract with `src/lib/auth/sensei-token.ts`: a Sensei Chat's Turn.
+    { token: 'senseiToken', prefixes: ['kosuke_sensei_'], extension: 'x-kosuke-sensei-token' },
 ];
 /** The agent token a key is, by its prefix; null for a member's own key or none. */
 export function agentTokenOf(key) {