@kosuke-ai/kosuke 1.0.49 → 1.0.50

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 1.0.50
+
+- No change you will notice: internal code comments in the CLI were updated.
+- Describe Device Requests as lasting the Turn that asked: a later Turn files a new request.
+
 ## 1.0.49
 
 - A message now takes up to 20 files instead of 10. The iOS photo picker lets you choose up to 20 photos at once, and the CLI's `--attach` accepts up to 20 files per request. Photos chosen in the iOS photo picker are no longer lost when the app wrongly decided the picker had not opened.

package/dist/agent/summary.js

@@ -297,6 +297,7 @@ function coverageLine(sessions) {
         : [];
     return `Workspaces covered: ${names.length ? names.join(', ') : 'none'}.`;
 }
+/** @internal */
 export function planSummary(options) {
     const { sessions, apiUrl, now, workspace, peek = false } = options;
     const scope = workspace ? ` --workspace ${workspace}` : '';
@@ -338,7 +339,10 @@ export function planSummary(options) {
         scope,
     };
 }
-/** The whole digest, once `activity` answered the plan's `activityQuery`. */
+/**
+ * The whole digest, once `activity` answered the plan's `activityQuery`.
+ * @internal
+ */
 export function renderSummary(plan, activity) {
     const lines = [...plan.head];
     // Every event the read returned is printed: without a peek, each is already marked seen.

package/dist/commands/hand-written.js

@@ -90,4 +90,5 @@ export const HAND_WRITTEN = {
         workspace: true,
     },
 };
+/** @internal */
 export const HAND_WRITTEN_COMMANDS = Object.values(HAND_WRITTEN);

package/dist/generated/commands/devices/requests-create.js

@@ -6,7 +6,7 @@ export const operation = {
         "requests",
         "create"
     ],
-    "summary": "From a Chat Session: ask to use a personal Mac from devices list, with the reason its owner reads on a card in this session's chat. A workspace device needs no request: it answers approved at once with grantId null, and no one is asked. The owner approves a personal Mac once per session: after that, asking again answers approved at once. Answers status pending or approved. Check devices list again for the answer; it expires after 30 minutes without an answer. While it is pending, go on with other work; when it is declined or expires, go on without it and say so. Once approved it stays approved for the rest of the session: pass --device-id on every mac command. One session at a time uses the device: on MAC_BUSY, wait with devices locks create, and run devices locks delete once done.",
+    "summary": "From a Chat Session: ask to use a personal Mac from devices list, with the reason its owner reads on a card in this session's chat. A workspace device needs no request: it answers approved at once with grantId null, and no one is asked. The owner approves a personal Mac for the Turn that asked: asking again in that Turn answers approved at once, and a later Turn asks again, with a new card for the owner. Answers status pending or approved. Check devices list again for the answer; it expires after 30 minutes without an answer, or when this Turn ends. While it is pending, go on with other work; when it is declined or expires, go on without it and say so. Once approved it lasts until this Turn ends: pass --device-id on every mac command; after that, mac commands on it are refused. One session at a time uses the device: on MAC_BUSY, wait with devices locks create, and run devices locks delete once done.",
     "pathParams": [
         "deviceId"
     ],

package/dist/generated/commands/sensei/device-requests-list.js

@@ -6,7 +6,7 @@ export const operation = {
         "device-requests",
         "list"
     ],
-    "summary": "List the Device Requests of a Chat Session, oldest first, as you would see them on its cards: id, device, kind, owner, reason, status (pending, approved, declined, expired, withdrawn or closed), who asked and who answered, when, canApprove, whether you may answer it, and occupiedBy, session or sensei when someone else uses the device while it is pending. A request past its 30 minutes reads expired.",
+    "summary": "List the Device Requests of a Chat Session, oldest first, as you would see them on its cards: id, device, kind, owner, reason, status (pending, approved, declined, expired, withdrawn or closed), who asked and who answered, when, canApprove, whether you may answer it, and occupiedBy, session or sensei when someone else uses the device while it is pending. A request past its 30 minutes reads expired, and so does a request or approval once the Turn that asked for it ended.",
     "pathParams": [],
     "query": [
         {

package/dist/generated/commands/sensei/device-requests-update.js

@@ -30,7 +30,7 @@ export const operation = {
                 "flag": "decision",
                 "kind": "string",
                 "required": true,
-                "description": "approve lets the session use the device until it ends; decline refuses it.",
+                "description": "approve lets the session use the device until the Turn that asked ends; decline refuses it.",
                 "choices": [
                     "approve",
                     "decline"

package/dist/program.js

@@ -14,6 +14,7 @@ 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. Global flags are read
  * before any subcommand runs, so the runtime the subcommands share is built once, from them.
+ * @internal
  */
 export function createProgram(options = {}) {
     const program = new Command('kosuke')

package/dist/runtime/agent-tokens.js

@@ -5,6 +5,7 @@
  * decides which commands the tree shows.
  *
  * Imports nothing, so the generator can load it on plain node.
+ * @internal
  */
 export const AGENT_TOKENS = [
     // Wire contract with `src/lib/auth/sandbox-agent-token.ts`: a chat sandbox's own Turn.
@@ -21,7 +22,10 @@ export function agentTokenOf(key) {
     const found = AGENT_TOKENS.find(({ prefixes }) => prefixes.some((prefix) => key.startsWith(prefix)));
     return found?.token ?? null;
 }
-/** The descriptor value for the agent tokens the document grants an operation. */
+/**
+ * The descriptor value for the agent tokens the document grants an operation.
+ * @internal
+ */
 export function agentReach(granted) {
     const tokens = AGENT_TOKENS.map(({ token }) => token).filter((token) => granted.includes(token));
     if (tokens.length === 0)

package/dist/runtime/attach.js

@@ -360,11 +360,17 @@ function jsonParser(raw) {
 function collect(value, previous) {
     return [...(previous ?? []), value];
 }
-/** commander stores `--exclude-archived` as `excludeArchived`. */
+/**
+ * commander stores `--exclude-archived` as `excludeArchived`.
+ * @internal
+ */
 export function optionKey(flag) {
     return flag.replace(/-([a-z0-9])/g, (_, letter) => letter.toUpperCase());
 }
-/** `projectId` reads as `Project id`; `env-vars` as `Env vars`. */
+/**
+ * `projectId` reads as `Project id`; `env-vars` as `Env vars`.
+ * @internal
+ */
 export function humanize(name) {
     const words = name
         .replace(/([a-z0-9])([A-Z])/g, '$1 $2')

package/openapi.json

@@ -961,7 +961,7 @@
     "/api/devices/{deviceId}/requests": {
       "post": {
         "operationId": "devicesRequestsCreate",
-        "summary": "From a Chat Session: ask to use a personal Mac from devices list, with the reason its owner reads on a card in this session's chat. A workspace device needs no request: it answers approved at once with grantId null, and no one is asked. The owner approves a personal Mac once per session: after that, asking again answers approved at once. Answers status pending or approved. Check devices list again for the answer; it expires after 30 minutes without an answer. While it is pending, go on with other work; when it is declined or expires, go on without it and say so. Once approved it stays approved for the rest of the session: pass --device-id on every mac command. One session at a time uses the device: on MAC_BUSY, wait with devices locks create, and run devices locks delete once done.",
+        "summary": "From a Chat Session: ask to use a personal Mac from devices list, with the reason its owner reads on a card in this session's chat. A workspace device needs no request: it answers approved at once with grantId null, and no one is asked. The owner approves a personal Mac for the Turn that asked: asking again in that Turn answers approved at once, and a later Turn asks again, with a new card for the owner. Answers status pending or approved. Check devices list again for the answer; it expires after 30 minutes without an answer, or when this Turn ends. While it is pending, go on with other work; when it is declined or expires, go on without it and say so. Once approved it lasts until this Turn ends: pass --device-id on every mac command; after that, mac commands on it are refused. One session at a time uses the device: on MAC_BUSY, wait with devices locks create, and run devices locks delete once done.",
         "tags": ["devices"],
         "x-kosuke-command": ["devices", "requests", "create"],
         "x-kosuke-sandbox-token": true,
@@ -23314,7 +23314,7 @@
     "/api/sensei/device-requests": {
       "get": {
         "operationId": "senseiDeviceRequestsList",
-        "summary": "List the Device Requests of a Chat Session, oldest first, as you would see them on its cards: id, device, kind, owner, reason, status (pending, approved, declined, expired, withdrawn or closed), who asked and who answered, when, canApprove, whether you may answer it, and occupiedBy, session or sensei when someone else uses the device while it is pending. A request past its 30 minutes reads expired.",
+        "summary": "List the Device Requests of a Chat Session, oldest first, as you would see them on its cards: id, device, kind, owner, reason, status (pending, approved, declined, expired, withdrawn or closed), who asked and who answered, when, canApprove, whether you may answer it, and occupiedBy, session or sensei when someone else uses the device while it is pending. A request past its 30 minutes reads expired, and so does a request or approval once the Turn that asked for it ended.",
         "tags": ["sensei"],
         "x-kosuke-command": ["sensei", "device-requests", "list"],
         "x-kosuke-sandbox-token": true,
@@ -23397,7 +23397,7 @@
                   "decision": {
                     "type": "string",
                     "enum": ["approve", "decline"],
-                    "description": "approve lets the session use the device until it ends; decline refuses it."
+                    "description": "approve lets the session use the device until the Turn that asked ends; decline refuses it."
                   }
                 },
                 "required": ["sessionId", "requestId", "decision"]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kosuke-ai/kosuke",
-  "version": "1.0.49",
+  "version": "1.0.50",
   "description": "Kosuke platform CLI. The client customers install to drive app.kosuke.ai from their own machine.",
   "license": "MIT",
   "repository": {
@@ -40,10 +40,11 @@
     "vitest": "^4.1.12"
   },
   "kosukeRelease": {
-    "sourceCommit": "2fece35c238337316974c0ce32615f1fbe682fd9",
-    "sourceIdentity": "c8c7c09262763d928f5e07b05b602a9a543c07b30c74e04325e18080ab6e3716",
+    "sourceCommit": "783c56f80b3c75df5f129ad9ef32d5f2cf0e7a92",
+    "sourceIdentity": "97a8761f0d47f9900bc37d7da2fb71dd14fc32222a97ec5d248c32986cd63bcd",
     "fragments": [
-      "twenty-files-per-message-r7k2qd.json"
+      "cli-internal-marks-3q4y00.json",
+      "device-approval-per-turn-23f44b.json"
     ]
   }
 }