@kosuke-ai/kosuke 1.0.5 → 1.0.7

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

@@ -5,7 +5,7 @@ export const operation = {
         "sessions",
         "create"
     ],
-    "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.",
     "pathParams": [
         "projectId"
     ],

package/dist/generated/commands/sessions/edit-prompt.js

@@ -5,7 +5,7 @@ export const operation = {
         "sessions",
         "edit-prompt"
     ],
-    "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.",
     "pathParams": [
         "projectId",
         "sessionId"

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

@@ -5,7 +5,7 @@ export const operation = {
         "sessions",
         "send"
     ],
-    "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.",
     "pathParams": [
         "projectId",
         "sessionId"

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

@@ -5,7 +5,7 @@ export const operation = {
         "sessions",
         "steer"
     ],
-    "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.",
     "pathParams": [
         "projectId",
         "sessionId"

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

@@ -5,7 +5,7 @@ export const operation = {
         "sessions",
         "update"
     ],
-    "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.",
     "pathParams": [
         "projectId",
         "sessionId"

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

@@ -5,7 +5,7 @@ export const operation = {
         "tasks",
         "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.",
+    "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 +85,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/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"
     ],
@@ -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",
@@ -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/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/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",

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

@@ -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/crons-create.js

@@ -6,7 +6,7 @@ export const operation = {
         "crons",
         "create"
     ],
-    "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.",
     "pathParams": [],
     "query": [],
     "body": {

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) {

package/dist/runtime/attach.js

@@ -7,36 +7,12 @@ import { buildRequest, execute, readWholeBody, UsageError } from './invoke.js';
  * the contract's summary, verbatim.
  */
 export function attachOperation(root, operation, runtime) {
-    const leaf = attachLeaf(root, operation.command, operation, runtime, { hidden: false });
-    const name = operation.command.join(' ');
-    for (const [alias, target] of COMMAND_ALIASES) {
-        if (target === name) {
-            attachLeaf(root, alias.split(' '), operation, runtime, {
-                hidden: true,
-                workspaceArgument: true,
-            });
-        }
-    }
-    return leaf;
+    return attachLeaf(root, operation.command, operation, runtime);
 }
-// Alias: Sensei's commands from when it was a workspace's, `kosuke workspaces sensei-* <id>`,
-// and the Lead's names for them, which an older sandbox's Sensei prompt still runs; remove the
-// Lead's one release after the Sensei rename, Sensei's one release after Sensei moved to the
-// person. The workspace they take goes to `--workspace` where the command reads one.
-const COMMAND_ALIASES = new Map([
-    ['cards', 'sensei cards'],
-    ['merge', 'sensei merge'],
-    ['notifications open', 'sensei notifications open'],
-].flatMap(([old, target]) => [
-    [`workspaces sensei-${old}`, target],
-    [`workspaces lead-${old}`, target],
-]));
-function attachLeaf(root, path, operation, runtime, { hidden, workspaceArgument = false }) {
-    const parent = groupFor(root, path.slice(0, -1), { hidden });
-    const leaf = parent.command(path[path.length - 1], { hidden });
+function attachLeaf(root, path, operation, runtime) {
+    const parent = groupFor(root, path.slice(0, -1));
+    const leaf = parent.command(path[path.length - 1]);
     leaf.description(operation.summary);
-    if (workspaceArgument)
-        leaf.addArgument(new Argument('<workspaceId>', 'Workspace id'));
     for (const name of operation.pathParams) {
         leaf.addArgument(new Argument(`<${name}>`, humanize(name)));
     }
@@ -63,17 +39,10 @@ function attachLeaf(root, path, operation, runtime, { hidden, workspaceArgument
     }
     leaf.action(async (...args) => {
         const options = args[args.length - 2];
-        const offset = workspaceArgument ? 1 : 0;
-        const positionals = args.slice(offset, offset + operation.pathParams.length);
-        const workspace = workspaceArgument ? args[0] : undefined;
+        const positionals = args.slice(0, operation.pathParams.length);
         const input = {
             pathParams: Object.fromEntries(operation.pathParams.map((name, i) => [name, positionals[i]])),
-            fields: Object.fromEntries(fields.map((field) => {
-                const given = options[optionKey(field.flag)];
-                // The old command's workspace filters a read that takes one; a write names its own.
-                const value = given ?? (field.name === 'workspace' ? workspace : undefined);
-                return [field.name, value];
-            })),
+            fields: Object.fromEntries(fields.map((field) => [field.name, options[optionKey(field.flag)]])),
             wholeBody: readWholeBody({
                 body: options.body,
                 bodyFile: options.bodyFile,
@@ -98,13 +67,11 @@ function attachLeaf(root, path, operation, runtime, { hidden, workspaceArgument
     });
     return leaf;
 }
-/** A group created here is hidden when asked; one that already exists keeps what it is. */
-export function groupFor(root, path, { hidden = false } = {}) {
+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;
 }