@kosuke-ai/cli 5.16.0 → 6.0.1

package/README.md

@@ -13,7 +13,8 @@ kosuke sessions create <projectId> --title "Fix the login form" \
   --content "See the screenshot" --status backlog --attach shot.png
 kosuke crons create <workspaceId> --project <projectId> --project <projectId> \
   --name "Daily ingest" --prompt "/sources" \
-  --cron-expression "0 6 * * *" --timezone Europe/Zurich
+  --cron-expression "0 6 * * *"
+kosuke workspaces timezone-set <workspaceId> --timezone Europe/Zurich
 ```
 
 Every API command prints the platform's JSON response as is, so it pipes into `jq`.
@@ -64,6 +65,15 @@ so on stderr and exits 1.
 This command is written by hand: the stream is a WebSocket, which the OpenAPI
 document below cannot describe.
 
+## Upgrading from 5.x
+
+A cron no longer has a timezone of its own: every cron of a workspace is read
+in the Workspace Timezone, which `kosuke workspaces timezone-set <workspaceId>
+--timezone Europe/Zurich` sets, as an owner or admin. `crons create` and `crons
+update` lose `--timezone`, and the API refuses a cron body that still sends one,
+which is what an older CLI does with `--timezone`. `crons get` still prints the
+cron's `timezone`, the workspace's.
+
 ## Upgrading from 4.x
 
 A cron now belongs to its workspace and covers one or more projects, so every

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

@@ -5,7 +5,7 @@ export const operation = {
         "crons",
         "create"
     ],
-    "summary": "Create a cron, enabled, with you as its creator, in one or more of the workspace's projects: each fire runs the Cron Agent in every one of them at once. Every run spends the workspace's Credentials, never a member's Subscription, so a workspace with no usable provider is refused. The model is an encoded id such as anthropic:opus__xhigh; null or left out uses the saved Workspace Default Model when its Provider has usable workspace Credentials, otherwise Kosuke's choice among usable workspace Credentials at run time. The crontab may not fire more often than every 15 minutes.",
+    "summary": "Create a cron, enabled, with you as its creator, in one or more of the workspace's projects: each fire runs the Cron Agent in every one of them at once. Every run spends the workspace's Credentials, never a member's Subscription, so a workspace with no usable provider is refused. The model is an encoded id such as anthropic:opus__xhigh; null or left out uses the saved Workspace Default Model when its Provider has usable workspace Credentials, otherwise Kosuke's choice among usable workspace Credentials at run time. The crontab is read in the Workspace Timezone (workspaces timezone-set), and may not fire more often than every 15 minutes. A body that sends timezone is refused.",
     "pathParams": [
         "workspaceId"
     ],
@@ -38,14 +38,7 @@ export const operation = {
                 "flag": "cron-expression",
                 "kind": "string",
                 "required": true,
-                "description": "Five fields: minute, hour, day of month, month, day of week. At most one fire every 15 minutes."
-            },
-            {
-                "name": "timezone",
-                "flag": "timezone",
-                "kind": "string",
-                "required": true,
-                "description": "The IANA zone the crontab is read in, e.g. Europe/Zurich or UTC."
+                "description": "Five fields: minute, hour, day of month, month, day of week, read in the Workspace Timezone (kosuke workspaces timezone-set). At most one fire every 15 minutes."
             },
             {
                 "name": "model",

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

@@ -39,14 +39,7 @@ export const operation = {
                 "flag": "cron-expression",
                 "kind": "string",
                 "required": false,
-                "description": "Five fields: minute, hour, day of month, month, day of week. At most one fire every 15 minutes."
-            },
-            {
-                "name": "timezone",
-                "flag": "timezone",
-                "kind": "string",
-                "required": false,
-                "description": "The IANA zone the crontab is read in, e.g. Europe/Zurich or UTC."
+                "description": "Five fields: minute, hour, day of month, month, day of week, read in the Workspace Timezone (kosuke workspaces timezone-set). At most one fire every 15 minutes."
             },
             {
                 "name": "model",

package/dist/generated/commands/index.js

@@ -165,7 +165,8 @@ import { operation as o163 } from './workspaces/skills-get.js';
 import { operation as o164 } from './workspaces/skills-list.js';
 import { operation as o165 } from './workspaces/skills-update.js';
 import { operation as o166 } from './workspaces/stop-sandboxes.js';
-import { operation as o167 } from './workspaces/usage.js';
+import { operation as o167 } from './workspaces/timezone-set.js';
+import { operation as o168 } from './workspaces/usage.js';
 export const operations = [
     o0,
     o1,
@@ -335,4 +336,5 @@ export const operations = [
     o165,
     o166,
     o167,
+    o168,
 ];

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

@@ -5,7 +5,7 @@ export const operation = {
         "sessions",
         "get"
     ],
-    "summary": "Read one chat session with its latest job and pull request. A Backlog session also carries its promptRevision, which a merge proposal names for each ticket it was written from.",
+    "summary": "Read one chat session with its URL, latest job and pull request. A Backlog session also carries its promptRevision, which a merge proposal names for each ticket it was written from.",
     "pathParams": [
         "projectId",
         "sessionId"

package/dist/generated/commands/user/profile.js

@@ -5,7 +5,7 @@ export const operation = {
         "user",
         "profile"
     ],
-    "summary": "Read your account: id, email, name, onboarding state, default model, auto-commit and plain-language settings.",
+    "summary": "Read your account: id, email, name, onboarding state, default model, auto-commit setting and Reply Style.",
     "pathParams": [],
     "query": [],
     "body": null,

package/dist/generated/commands/workspaces/get.js

@@ -5,7 +5,7 @@ export const operation = {
         "workspaces",
         "get"
     ],
-    "summary": "Read one workspace and your role in it.",
+    "summary": "Read one workspace, your role in it, and its timezone, the one every cron is read in.",
     "pathParams": [
         "workspaceId"
     ],

package/dist/generated/commands/workspaces/lead-proposals-create.js

@@ -6,7 +6,7 @@ export const operation = {
         "lead-proposals",
         "create"
     ],
-    "summary": "Open a Lead Card in a member's Needs you that proposes one thing, with one line of why: your own, or from a Cron Run the Needs you of the member memberId names. kind start proposes starting a Backlog session, and is refused unless that member is idle. kind delete_ticket (with evidence), merge_tickets (with sessionIds, mergedContent and the promptRevision sessions get gave for each ticket in revisions) and create_cron (with name, prompt, crontab, timezone and projectIds, and no sessionId) change nothing until the member accepts the card. Pass the body whole with --body or --body-file.",
+    "summary": "Open a Lead Card in a member's Needs you that proposes one thing, with one line of why: your own, or from a Cron Run the Needs you of the member memberId names. kind start proposes starting a Backlog session, and is refused unless that member is idle. kind delete_ticket (with evidence), merge_tickets (with sessionIds, mergedContent and the promptRevision sessions get gave for each ticket in revisions) and create_cron (with name, prompt, crontab, read in the Workspace Timezone, and projectIds, and no sessionId) change nothing until the member accepts the card. Pass the body whole with --body or --body-file.",
     "pathParams": [
         "workspaceId"
     ],

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

@@ -0,0 +1,32 @@
+export const operation = {
+    "method": "put",
+    "path": "/api/organizations/{workspaceId}/timezone",
+    "command": [
+        "workspaces",
+        "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": [
+        "workspaceId"
+    ],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "timezone",
+                "flag": "timezone",
+                "kind": "string",
+                "required": true,
+                "description": "The IANA zone every cron of the workspace is read and shown in, e.g. Europe/Rome or UTC."
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "sandboxToken": true,
+    "orchestratorToken": true,
+    "cronToken": true,
+    "leadToken": true
+};

package/openapi.json

@@ -591,7 +591,7 @@
     "/api/organizations/{workspaceId}": {
       "get": {
         "operationId": "workspacesGet",
-        "summary": "Read one workspace and your role in it.",
+        "summary": "Read one workspace, your role in it, and its timezone, the one every cron is read in.",
         "tags": ["workspaces"],
         "x-kosuke-command": ["workspaces", "get"],
         "x-kosuke-sandbox-token": true,
@@ -1463,7 +1463,7 @@
       },
       "post": {
         "operationId": "cronsCreate",
-        "summary": "Create a cron, enabled, with you as its creator, in one or more of the workspace's projects: each fire runs the Cron Agent in every one of them at once. Every run spends the workspace's Credentials, never a member's Subscription, so a workspace with no usable provider is refused. The model is an encoded id such as anthropic:opus__xhigh; null or left out uses the saved Workspace Default Model when its Provider has usable workspace Credentials, otherwise Kosuke's choice among usable workspace Credentials at run time. The crontab may not fire more often than every 15 minutes.",
+        "summary": "Create a cron, enabled, with you as its creator, in one or more of the workspace's projects: each fire runs the Cron Agent in every one of them at once. Every run spends the workspace's Credentials, never a member's Subscription, so a workspace with no usable provider is refused. The model is an encoded id such as anthropic:opus__xhigh; null or left out uses the saved Workspace Default Model when its Provider has usable workspace Credentials, otherwise Kosuke's choice among usable workspace Credentials at run time. The crontab is read in the Workspace Timezone (workspaces timezone-set), and may not fire more often than every 15 minutes. A body that sends timezone is refused.",
         "tags": ["crons"],
         "x-kosuke-command": ["crons", "create"],
         "x-kosuke-sandbox-token": true,
@@ -1513,13 +1513,7 @@
                     "type": "string",
                     "minLength": 1,
                     "maxLength": 100,
-                    "description": "Five fields: minute, hour, day of month, month, day of week. At most one fire every 15 minutes."
-                  },
-                  "timezone": {
-                    "type": "string",
-                    "minLength": 1,
-                    "maxLength": 64,
-                    "description": "The IANA zone the crontab is read in, e.g. Europe/Zurich or UTC."
+                    "description": "Five fields: minute, hour, day of month, month, day of week, read in the Workspace Timezone (kosuke workspaces timezone-set). At most one fire every 15 minutes."
                   },
                   "model": {
                     "description": "An encoded model id such as anthropic:opus__xhigh. Null, or left out on create, uses the Workspace Default Model at run time, then Kosuke's choice among available workspace Credentials.",
@@ -1534,7 +1528,7 @@
                     ]
                   }
                 },
-                "required": ["name", "projectIds", "prompt", "cronExpression", "timezone"]
+                "required": ["name", "projectIds", "prompt", "cronExpression"]
               }
             }
           }
@@ -1699,13 +1693,7 @@
                     "type": "string",
                     "minLength": 1,
                     "maxLength": 100,
-                    "description": "Five fields: minute, hour, day of month, month, day of week. At most one fire every 15 minutes."
-                  },
-                  "timezone": {
-                    "type": "string",
-                    "minLength": 1,
-                    "maxLength": 64,
-                    "description": "The IANA zone the crontab is read in, e.g. Europe/Zurich or UTC."
+                    "description": "Five fields: minute, hour, day of month, month, day of week, read in the Workspace Timezone (kosuke workspaces timezone-set). At most one fire every 15 minutes."
                   },
                   "model": {
                     "description": "An encoded model id such as anthropic:opus__xhigh. Null, or left out on create, uses the Workspace Default Model at run time, then Kosuke's choice among available workspace Credentials.",
@@ -3229,7 +3217,7 @@
     "/api/organizations/{workspaceId}/lead/proposals": {
       "post": {
         "operationId": "workspacesLeadProposalsCreate",
-        "summary": "Open a Lead Card in a member's Needs you that proposes one thing, with one line of why: your own, or from a Cron Run the Needs you of the member memberId names. kind start proposes starting a Backlog session, and is refused unless that member is idle. kind delete_ticket (with evidence), merge_tickets (with sessionIds, mergedContent and the promptRevision sessions get gave for each ticket in revisions) and create_cron (with name, prompt, crontab, timezone and projectIds, and no sessionId) change nothing until the member accepts the card. Pass the body whole with --body or --body-file.",
+        "summary": "Open a Lead Card in a member's Needs you that proposes one thing, with one line of why: your own, or from a Cron Run the Needs you of the member memberId names. kind start proposes starting a Backlog session, and is refused unless that member is idle. kind delete_ticket (with evidence), merge_tickets (with sessionIds, mergedContent and the promptRevision sessions get gave for each ticket in revisions) and create_cron (with name, prompt, crontab, read in the Workspace Timezone, and projectIds, and no sessionId) change nothing until the member accepts the card. Pass the body whole with --body or --body-file.",
         "tags": ["workspaces"],
         "x-kosuke-command": ["workspaces", "lead-proposals", "create"],
         "x-kosuke-sandbox-token": true,
@@ -3434,13 +3422,7 @@
                         "type": "string",
                         "minLength": 1,
                         "maxLength": 100,
-                        "description": "Five fields: minute, hour, day of month, month, day of week. At most one fire every 15 minutes."
-                      },
-                      "timezone": {
-                        "type": "string",
-                        "minLength": 1,
-                        "maxLength": 64,
-                        "description": "The IANA zone the crontab is read in, e.g. Europe/Zurich or UTC."
+                        "description": "Five fields: minute, hour, day of month, month, day of week, read in the Workspace Timezone (kosuke workspaces timezone-set). At most one fire every 15 minutes."
                       },
                       "projectIds": {
                         "minItems": 1,
@@ -3460,7 +3442,6 @@
                       "name",
                       "prompt",
                       "crontab",
-                      "timezone",
                       "projectIds"
                     ]
                   }
@@ -4606,6 +4587,80 @@
         }
       }
     },
+    "/api/organizations/{workspaceId}/timezone": {
+      "put": {
+        "operationId": "workspacesTimezoneSet",
+        "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.",
+        "tags": ["workspaces"],
+        "x-kosuke-command": ["workspaces", "timezone-set"],
+        "x-kosuke-sandbox-token": true,
+        "x-kosuke-orchestrator-token": true,
+        "x-kosuke-cron-token": true,
+        "x-kosuke-lead-token": true,
+        "parameters": [
+          {
+            "name": "workspaceId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "timezone": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 64,
+                    "description": "The IANA zone every cron of the workspace is read and shown in, e.g. Europe/Rome or UTC."
+                  }
+                },
+                "required": ["timezone"]
+              }
+            }
+          }
+        },
+        "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/organizations/{workspaceId}/usage": {
       "get": {
         "operationId": "workspacesUsage",
@@ -5363,7 +5418,7 @@
     "/api/projects/{projectId}/chat-sessions/{sessionId}": {
       "get": {
         "operationId": "sessionsGet",
-        "summary": "Read one chat session with its latest job and pull request. A Backlog session also carries its promptRevision, which a merge proposal names for each ticket it was written from.",
+        "summary": "Read one chat session with its URL, latest job and pull request. A Backlog session also carries its promptRevision, which a merge proposal names for each ticket it was written from.",
         "tags": ["sessions"],
         "x-kosuke-command": ["sessions", "get"],
         "x-kosuke-sandbox-token": true,
@@ -12441,7 +12496,7 @@
     "/api/user/profile": {
       "get": {
         "operationId": "userProfile",
-        "summary": "Read your account: id, email, name, onboarding state, default model, auto-commit and plain-language settings.",
+        "summary": "Read your account: id, email, name, onboarding state, default model, auto-commit setting and Reply Style.",
         "tags": ["user"],
         "x-kosuke-command": ["user", "profile"],
         "x-kosuke-sandbox-token": true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kosuke-ai/cli",
-  "version": "5.16.0",
+  "version": "6.0.1",
   "description": "Kosuke platform CLI. The client customers install to drive app.kosuke.ai from their own machine.",
   "license": "MIT",
   "repository": {