@kosuke-ai/kosuke 1.0.60 → 1.0.61
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +4 -0
- package/dist/generated/commands/devices/list.js +1 -1
- package/dist/generated/commands/mac/files-delete.js +1 -1
- package/dist/generated/commands/mac/files-move.js +1 -1
- package/dist/generated/commands/mac/files-set.js +1 -1
- package/dist/generated/commands/mac/shell.js +1 -1
- package/dist/generated/commands/projects/settings-set.js +8 -0
- package/dist/generated/commands/projects/settings-update.js +9 -1
- package/openapi.json +20 -6
- package/package.json +4 -11
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,9 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 1.0.61
|
|
4
|
+
|
|
5
|
+
- A Chat Session's shell and file writes on a Mac stay in its scratch folder ~/KosukeQA/<session8>/, Xcode DerivedData, CoreSimulator, the temporary folders and the folders its project declares in deviceWritePaths, which a member sets with `kosuke projects settings update --device-write-paths`. A write elsewhere fails. Sensei's own Mac calls are unchanged.
|
|
6
|
+
|
|
3
7
|
## 1.0.60
|
|
4
8
|
|
|
5
9
|
- `kosuke projects batch-merging set` takes `--go-ahead` (member or checks) and `--wait-for-qa`, and `get` reads them. Apps are gone: `projects create --workflow`, `projects workflow set`, `projects backlog-items` and `projects live writes` are removed.
|
|
@@ -5,7 +5,7 @@ export const operation = {
|
|
|
5
5
|
"devices",
|
|
6
6
|
"list"
|
|
7
7
|
],
|
|
8
|
-
"summary": "From a Chat Session: the devices it may use, the workspace's devices and the session member's own Macs, each with its id, kind, whether it is online, the tools it offers, its macOS grants (grants.systemEvents: menu bar icons
|
|
8
|
+
"summary": "From a Chat Session: the devices it may use, the workspace's devices and the session member's own Macs, each with its id, kind, whether it is online, the tools it offers, its macOS grants (grants.systemEvents is for Sensei's `osascript` through System Events: a session's shell runs in its fence, where macOS refuses Apple Events, so a session opens menu bar icons with `kosuke mac click`), this session's access: none, pending or approved (a workspace device is always approved: it needs no request), and occupied with occupiedBy (session or sensei) when someone else uses it now. Pick an online device with the tools the test needs: a workspace device first, and the member's own Mac only when no workspace device fits, whatever the names or past approvals. Of those, pick a free one, and ask for an occupied one only when no free device fits. Use a workspace device at once with --device-id; request a personal Mac with `kosuke devices requests create` before any mac command on it. Use a device only when the test truly needs a real Mac. One session at a time uses a device: on MAC_BUSY, wait in its line with `kosuke devices locks create` rather than give up or call again, and let it go with `kosuke devices locks delete` once done.",
|
|
9
9
|
"pathParams": [],
|
|
10
10
|
"query": [],
|
|
11
11
|
"body": null,
|
|
@@ -6,7 +6,7 @@ export const operation = {
|
|
|
6
6
|
"files",
|
|
7
7
|
"delete"
|
|
8
8
|
],
|
|
9
|
-
"summary": "Move a file on the member's Mac to the Trash. Sensei calls it, and a Chat Session does with --device-id for a device approved for it.",
|
|
9
|
+
"summary": "Move a file on the member's Mac to the Trash. Sensei calls it, and a Chat Session does with --device-id for a device approved for it. A Chat Session's call deletes only under its scratch folder ~/KosukeQA/<session8>/ (the session id's first 8 characters), Xcode DerivedData, CoreSimulator, the temporary folders and the project's deviceWritePaths: a path elsewhere answers OUTSIDE_FENCE, and a device whose app cannot keep it answers FENCE_UNSUPPORTED.",
|
|
10
10
|
"pathParams": [],
|
|
11
11
|
"query": [],
|
|
12
12
|
"body": {
|
|
@@ -6,7 +6,7 @@ export const operation = {
|
|
|
6
6
|
"files",
|
|
7
7
|
"move"
|
|
8
8
|
],
|
|
9
|
-
"summary": "Move or rename a file on the member's Mac. Sensei calls it, and a Chat Session does with --device-id for a device approved for it.",
|
|
9
|
+
"summary": "Move or rename a file on the member's Mac. Sensei calls it, and a Chat Session does with --device-id for a device approved for it. A Chat Session's call moves a file only when both paths are under its scratch folder ~/KosukeQA/<session8>/ (the session id's first 8 characters), Xcode DerivedData, CoreSimulator, the temporary folders and the project's deviceWritePaths: a path elsewhere answers OUTSIDE_FENCE, and a device whose app cannot keep it answers FENCE_UNSUPPORTED.",
|
|
10
10
|
"pathParams": [],
|
|
11
11
|
"query": [],
|
|
12
12
|
"body": {
|
|
@@ -6,7 +6,7 @@ export const operation = {
|
|
|
6
6
|
"files",
|
|
7
7
|
"set"
|
|
8
8
|
],
|
|
9
|
-
"summary": "Write a file on the member's Mac, from text or from a URL the Mac downloads. Sensei calls it, and a Chat Session does with --device-id for a device approved for it.",
|
|
9
|
+
"summary": "Write a file on the member's Mac, from text or from a URL the Mac downloads. Sensei calls it, and a Chat Session does with --device-id for a device approved for it. A Chat Session's call writes only under its scratch folder ~/KosukeQA/<session8>/ (the session id's first 8 characters), Xcode DerivedData, CoreSimulator, the temporary folders and the project's deviceWritePaths: a path elsewhere answers OUTSIDE_FENCE, and a device whose app cannot keep it answers FENCE_UNSUPPORTED.",
|
|
10
10
|
"pathParams": [],
|
|
11
11
|
"query": [],
|
|
12
12
|
"body": {
|
|
@@ -5,7 +5,7 @@ export const operation = {
|
|
|
5
5
|
"mac",
|
|
6
6
|
"shell"
|
|
7
7
|
],
|
|
8
|
-
"summary": "Run a shell command on the member's Mac with /bin/zsh -lc, in cwd when given, for up to timeoutMs (60000 by default, at most 600000). Answers exitCode, stdout and stderr; output over 256 KiB comes as file.url. Sensei calls it, and a Chat Session does with --device-id for a device approved for it.",
|
|
8
|
+
"summary": "Run a shell command on the member's Mac with /bin/zsh -lc, in cwd when given, for up to timeoutMs (60000 by default, at most 600000). Answers exitCode, stdout and stderr; output over 256 KiB comes as file.url. Sensei calls it, and a Chat Session does with --device-id for a device approved for it. A Chat Session's command writes and deletes only under its scratch folder ~/KosukeQA/<session8>/ (the session id's first 8 characters), Xcode DerivedData, CoreSimulator, the temporary folders and the project's deviceWritePaths: a write elsewhere fails with \"Operation not permitted\", and a device whose app cannot keep it answers FENCE_UNSUPPORTED. macOS refuses Apple Events from inside the fence, so `osascript` to another app fails there: drive apps with the click, type, key and ax_tree tools.",
|
|
9
9
|
"pathParams": [],
|
|
10
10
|
"query": [],
|
|
11
11
|
"body": {
|
|
@@ -69,6 +69,14 @@ export const operation = {
|
|
|
69
69
|
"required": false,
|
|
70
70
|
"description": "The Project QA Guide: markdown on how to test this project in a sandbox. automated-qa proposes changes to the session's Assignee, and a member saves it. A sandbox cannot set it."
|
|
71
71
|
},
|
|
72
|
+
{
|
|
73
|
+
"name": "deviceWritePaths",
|
|
74
|
+
"flag": "device-write-paths",
|
|
75
|
+
"kind": "json",
|
|
76
|
+
"required": false,
|
|
77
|
+
"description": "Extra folders on a device, beyond the session's scratch folder ~/KosukeQA/<session8>/, Xcode DerivedData, CoreSimulator and temporary folders, that a Chat Session's shell and file tools may write and delete. `<session8>` stands for the session id's first 8 characters. Each starts with ~/ and names a folder inside a folder of the home folder (~/Library/<folder>/<name> under ~/Library), never ~/KosukeQA, ~/.Trash, the member's mail, keys or accounts, or the Sensei app that links the device; no wildcards, quotes or variables; at most 64. Omitted leaves the saved list; [] clears it. Only a member's own API key or browser session sets it, never a sandbox, a Cron Run or Sensei. Sensei's own calls are not fenced.",
|
|
78
|
+
"shape": "string[]"
|
|
79
|
+
},
|
|
72
80
|
{
|
|
73
81
|
"name": "sandboxTier",
|
|
74
82
|
"flag": "sandbox-tier",
|
|
@@ -6,7 +6,7 @@ export const operation = {
|
|
|
6
6
|
"settings",
|
|
7
7
|
"update"
|
|
8
8
|
],
|
|
9
|
-
"summary": "Change setup commands, branches, working directory, sandbox tier
|
|
9
|
+
"summary": "Change setup commands, branches, working directory, sandbox tier, the Project QA Guide or deviceWritePaths, the device folders a Chat Session may write. A sandbox cannot change the guide, and only a member's own API key or browser session changes deviceWritePaths.",
|
|
10
10
|
"pathParams": [
|
|
11
11
|
"projectId"
|
|
12
12
|
],
|
|
@@ -69,6 +69,14 @@ export const operation = {
|
|
|
69
69
|
"required": false,
|
|
70
70
|
"description": "The Project QA Guide: markdown on how to test this project in a sandbox. automated-qa proposes changes to the session's Assignee, and a member saves it. A sandbox cannot set it."
|
|
71
71
|
},
|
|
72
|
+
{
|
|
73
|
+
"name": "deviceWritePaths",
|
|
74
|
+
"flag": "device-write-paths",
|
|
75
|
+
"kind": "json",
|
|
76
|
+
"required": false,
|
|
77
|
+
"description": "Extra folders on a device, beyond the session's scratch folder ~/KosukeQA/<session8>/, Xcode DerivedData, CoreSimulator and temporary folders, that a Chat Session's shell and file tools may write and delete. `<session8>` stands for the session id's first 8 characters. Each starts with ~/ and names a folder inside a folder of the home folder (~/Library/<folder>/<name> under ~/Library), never ~/KosukeQA, ~/.Trash, the member's mail, keys or accounts, or the Sensei app that links the device; no wildcards, quotes or variables; at most 64. Omitted leaves the saved list; [] clears it. Only a member's own API key or browser session sets it, never a sandbox, a Cron Run or Sensei. Sensei's own calls are not fenced.",
|
|
78
|
+
"shape": "string[]"
|
|
79
|
+
},
|
|
72
80
|
{
|
|
73
81
|
"name": "sandboxTier",
|
|
74
82
|
"flag": "sandbox-tier",
|
package/openapi.json
CHANGED
|
@@ -1032,7 +1032,7 @@
|
|
|
1032
1032
|
"/api/devices/available": {
|
|
1033
1033
|
"get": {
|
|
1034
1034
|
"operationId": "devicesList",
|
|
1035
|
-
"summary": "From a Chat Session: the devices it may use, the workspace's devices and the session member's own Macs, each with its id, kind, whether it is online, the tools it offers, its macOS grants (grants.systemEvents: menu bar icons
|
|
1035
|
+
"summary": "From a Chat Session: the devices it may use, the workspace's devices and the session member's own Macs, each with its id, kind, whether it is online, the tools it offers, its macOS grants (grants.systemEvents is for Sensei's `osascript` through System Events: a session's shell runs in its fence, where macOS refuses Apple Events, so a session opens menu bar icons with `kosuke mac click`), this session's access: none, pending or approved (a workspace device is always approved: it needs no request), and occupied with occupiedBy (session or sensei) when someone else uses it now. Pick an online device with the tools the test needs: a workspace device first, and the member's own Mac only when no workspace device fits, whatever the names or past approvals. Of those, pick a free one, and ask for an occupied one only when no free device fits. Use a workspace device at once with --device-id; request a personal Mac with `kosuke devices requests create` before any mac command on it. Use a device only when the test truly needs a real Mac. One session at a time uses a device: on MAC_BUSY, wait in its line with `kosuke devices locks create` rather than give up or call again, and let it go with `kosuke devices locks delete` once done.",
|
|
1036
1036
|
"tags": ["devices"],
|
|
1037
1037
|
"x-kosuke-command": ["devices", "list"],
|
|
1038
1038
|
"x-kosuke-sandbox-token": true,
|
|
@@ -1750,7 +1750,7 @@
|
|
|
1750
1750
|
"/api/devices/mac/file-delete": {
|
|
1751
1751
|
"post": {
|
|
1752
1752
|
"operationId": "macFilesDelete",
|
|
1753
|
-
"summary": "Move a file on the member's Mac to the Trash. Sensei calls it, and a Chat Session does with --device-id for a device approved for it.",
|
|
1753
|
+
"summary": "Move a file on the member's Mac to the Trash. Sensei calls it, and a Chat Session does with --device-id for a device approved for it. A Chat Session's call deletes only under its scratch folder ~/KosukeQA/<session8>/ (the session id's first 8 characters), Xcode DerivedData, CoreSimulator, the temporary folders and the project's deviceWritePaths: a path elsewhere answers OUTSIDE_FENCE, and a device whose app cannot keep it answers FENCE_UNSUPPORTED.",
|
|
1754
1754
|
"tags": ["mac"],
|
|
1755
1755
|
"x-kosuke-command": ["mac", "files", "delete"],
|
|
1756
1756
|
"x-kosuke-sandbox-token": true,
|
|
@@ -1886,7 +1886,7 @@
|
|
|
1886
1886
|
"/api/devices/mac/file-move": {
|
|
1887
1887
|
"post": {
|
|
1888
1888
|
"operationId": "macFilesMove",
|
|
1889
|
-
"summary": "Move or rename a file on the member's Mac. Sensei calls it, and a Chat Session does with --device-id for a device approved for it.",
|
|
1889
|
+
"summary": "Move or rename a file on the member's Mac. Sensei calls it, and a Chat Session does with --device-id for a device approved for it. A Chat Session's call moves a file only when both paths are under its scratch folder ~/KosukeQA/<session8>/ (the session id's first 8 characters), Xcode DerivedData, CoreSimulator, the temporary folders and the project's deviceWritePaths: a path elsewhere answers OUTSIDE_FENCE, and a device whose app cannot keep it answers FENCE_UNSUPPORTED.",
|
|
1890
1890
|
"tags": ["mac"],
|
|
1891
1891
|
"x-kosuke-command": ["mac", "files", "move"],
|
|
1892
1892
|
"x-kosuke-sandbox-token": true,
|
|
@@ -2028,7 +2028,7 @@
|
|
|
2028
2028
|
"/api/devices/mac/file-write": {
|
|
2029
2029
|
"post": {
|
|
2030
2030
|
"operationId": "macFilesSet",
|
|
2031
|
-
"summary": "Write a file on the member's Mac, from text or from a URL the Mac downloads. Sensei calls it, and a Chat Session does with --device-id for a device approved for it.",
|
|
2031
|
+
"summary": "Write a file on the member's Mac, from text or from a URL the Mac downloads. Sensei calls it, and a Chat Session does with --device-id for a device approved for it. A Chat Session's call writes only under its scratch folder ~/KosukeQA/<session8>/ (the session id's first 8 characters), Xcode DerivedData, CoreSimulator, the temporary folders and the project's deviceWritePaths: a path elsewhere answers OUTSIDE_FENCE, and a device whose app cannot keep it answers FENCE_UNSUPPORTED.",
|
|
2032
2032
|
"tags": ["mac"],
|
|
2033
2033
|
"x-kosuke-command": ["mac", "files", "set"],
|
|
2034
2034
|
"x-kosuke-sandbox-token": true,
|
|
@@ -2432,7 +2432,7 @@
|
|
|
2432
2432
|
"/api/devices/mac/shell": {
|
|
2433
2433
|
"post": {
|
|
2434
2434
|
"operationId": "macShell",
|
|
2435
|
-
"summary": "Run a shell command on the member's Mac with /bin/zsh -lc, in cwd when given, for up to timeoutMs (60000 by default, at most 600000). Answers exitCode, stdout and stderr; output over 256 KiB comes as file.url. Sensei calls it, and a Chat Session does with --device-id for a device approved for it.",
|
|
2435
|
+
"summary": "Run a shell command on the member's Mac with /bin/zsh -lc, in cwd when given, for up to timeoutMs (60000 by default, at most 600000). Answers exitCode, stdout and stderr; output over 256 KiB comes as file.url. Sensei calls it, and a Chat Session does with --device-id for a device approved for it. A Chat Session's command writes and deletes only under its scratch folder ~/KosukeQA/<session8>/ (the session id's first 8 characters), Xcode DerivedData, CoreSimulator, the temporary folders and the project's deviceWritePaths: a write elsewhere fails with \"Operation not permitted\", and a device whose app cannot keep it answers FENCE_UNSUPPORTED. macOS refuses Apple Events from inside the fence, so `osascript` to another app fails there: drive apps with the click, type, key and ax_tree tools.",
|
|
2436
2436
|
"tags": ["mac"],
|
|
2437
2437
|
"x-kosuke-command": ["mac", "shell"],
|
|
2438
2438
|
"x-kosuke-sandbox-token": true,
|
|
@@ -18172,7 +18172,7 @@
|
|
|
18172
18172
|
},
|
|
18173
18173
|
"patch": {
|
|
18174
18174
|
"operationId": "projectsSettingsUpdate",
|
|
18175
|
-
"summary": "Change setup commands, branches, working directory, sandbox tier
|
|
18175
|
+
"summary": "Change setup commands, branches, working directory, sandbox tier, the Project QA Guide or deviceWritePaths, the device folders a Chat Session may write. A sandbox cannot change the guide, and only a member's own API key or browser session changes deviceWritePaths.",
|
|
18176
18176
|
"tags": ["projects"],
|
|
18177
18177
|
"x-kosuke-command": ["projects", "settings", "update"],
|
|
18178
18178
|
"x-kosuke-sandbox-token": true,
|
|
@@ -18287,6 +18287,13 @@
|
|
|
18287
18287
|
}
|
|
18288
18288
|
]
|
|
18289
18289
|
},
|
|
18290
|
+
"deviceWritePaths": {
|
|
18291
|
+
"description": "Extra folders on a device, beyond the session's scratch folder ~/KosukeQA/<session8>/, Xcode DerivedData, CoreSimulator and temporary folders, that a Chat Session's shell and file tools may write and delete. `<session8>` stands for the session id's first 8 characters. Each starts with ~/ and names a folder inside a folder of the home folder (~/Library/<folder>/<name> under ~/Library), never ~/KosukeQA, ~/.Trash, the member's mail, keys or accounts, or the Sensei app that links the device; no wildcards, quotes or variables; at most 64. Omitted leaves the saved list; [] clears it. Only a member's own API key or browser session sets it, never a sandbox, a Cron Run or Sensei. Sensei's own calls are not fenced.",
|
|
18292
|
+
"type": "array",
|
|
18293
|
+
"items": {
|
|
18294
|
+
"type": "string"
|
|
18295
|
+
}
|
|
18296
|
+
},
|
|
18290
18297
|
"sandboxTier": {
|
|
18291
18298
|
"description": "Sandbox resource tier provisioned for the preview: SMALL, MEDIUM, LARGE, or XLARGE. Omitted leaves the current tier. A first deploy boots on XLARGE (unknown footprint). Measure actual peak usage and set the right-sized tier here so later sandboxes use it.",
|
|
18292
18299
|
"type": "string",
|
|
@@ -19334,6 +19341,13 @@
|
|
|
19334
19341
|
}
|
|
19335
19342
|
]
|
|
19336
19343
|
},
|
|
19344
|
+
"deviceWritePaths": {
|
|
19345
|
+
"description": "Extra folders on a device, beyond the session's scratch folder ~/KosukeQA/<session8>/, Xcode DerivedData, CoreSimulator and temporary folders, that a Chat Session's shell and file tools may write and delete. `<session8>` stands for the session id's first 8 characters. Each starts with ~/ and names a folder inside a folder of the home folder (~/Library/<folder>/<name> under ~/Library), never ~/KosukeQA, ~/.Trash, the member's mail, keys or accounts, or the Sensei app that links the device; no wildcards, quotes or variables; at most 64. Omitted leaves the saved list; [] clears it. Only a member's own API key or browser session sets it, never a sandbox, a Cron Run or Sensei. Sensei's own calls are not fenced.",
|
|
19346
|
+
"type": "array",
|
|
19347
|
+
"items": {
|
|
19348
|
+
"type": "string"
|
|
19349
|
+
}
|
|
19350
|
+
},
|
|
19337
19351
|
"sandboxTier": {
|
|
19338
19352
|
"description": "Sandbox resource tier provisioned for the preview: SMALL, MEDIUM, LARGE, or XLARGE. Omitted leaves the current tier. A first deploy boots on XLARGE (unknown footprint). Measure actual peak usage and set the right-sized tier here so later sandboxes use it.",
|
|
19339
19353
|
"type": "string",
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@kosuke-ai/kosuke",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.61",
|
|
4
4
|
"description": "Sensei platform CLI. The client customers install to drive app.kosuke.ai from their own machine.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -43,17 +43,10 @@
|
|
|
43
43
|
"minimatch": "^11.0.1"
|
|
44
44
|
},
|
|
45
45
|
"kosukeRelease": {
|
|
46
|
-
"sourceCommit": "
|
|
47
|
-
"sourceIdentity": "
|
|
46
|
+
"sourceCommit": "ab954c7c62c405306a487ae257ca74d0c243d0fa",
|
|
47
|
+
"sourceIdentity": "4e544c0ff9c9c9902f0290efed2f704509ef0599945faeab51bc6bef33f4f21c",
|
|
48
48
|
"fragments": [
|
|
49
|
-
"
|
|
50
|
-
"qa-standin-simulator-r8aj6e.json",
|
|
51
|
-
"tasks-personal-space-b6cli7.json",
|
|
52
|
-
"cron-reattach-drain-hakfn4.json",
|
|
53
|
-
"mark-read-unconfirmed-eh4l04.json",
|
|
54
|
-
"kosuke-cli-agents-vjgjqn.json",
|
|
55
|
-
"qa-sync-since-z8xrol.json",
|
|
56
|
-
"merge-train-go-ahead-h59dec.json"
|
|
49
|
+
"session-fence-iau7rc.json"
|
|
57
50
|
]
|
|
58
51
|
}
|
|
59
52
|
}
|