@boxes-dev/dvb-runtime 1.0.1015 → 1.0.1017
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/dist/bin/dvb.mjs +11 -11
- package/dist/bin/dvbd.mjs +8 -8
- package/dist/managed-codex-install/package-lock.json +28 -28
- package/dist/managed-codex-install/package.json +1 -1
- package/dist/product-docs/references/mobile.md +10 -0
- package/dist/product-docs/references/onbox-agent-tools.md +63 -22
- package/dist/product-docs/references/ports-terminal-and-runtime.md +45 -14
- package/dist/product-docs/references/project-setup.md +12 -10
- package/dist/product-docs/references/team-template.md +29 -3
- package/dist/product-docs/references/threads-and-agents.md +22 -14
- package/dist/product-docs/references/troubleshooting.md +6 -0
- package/package.json +2 -2
package/dist/bin/dvb.mjs
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
|
|
3
|
-
!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="
|
|
3
|
+
!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="9b454f0a-4e57-5610-9e0f-655fa8fcdd14")}catch(e){}}();
|
|
4
4
|
import { createRequire as __dvbCreateRequire } from "node:module";
|
|
5
5
|
import { dirname as __dvbDirname } from "node:path";
|
|
6
6
|
import { fileURLToPath as __dvbFileURLToPath } from "node:url";
|
|
@@ -6125,8 +6125,8 @@ var MANAGED_CODEX_MCP_OAUTH_VERSION, MANAGED_CLAUDE_MCP_OAUTH_VERSION, CLAUDE_CO
|
|
|
6125
6125
|
var init_profiles = __esm({
|
|
6126
6126
|
"../../../../shared/devboxCore/dist/mcpOAuth/profiles.js"() {
|
|
6127
6127
|
"use strict";
|
|
6128
|
-
MANAGED_CODEX_MCP_OAUTH_VERSION = "0.
|
|
6129
|
-
MANAGED_CLAUDE_MCP_OAUTH_VERSION = "2.1.
|
|
6128
|
+
MANAGED_CODEX_MCP_OAUTH_VERSION = "0.155.1";
|
|
6129
|
+
MANAGED_CLAUDE_MCP_OAUTH_VERSION = "2.1.280";
|
|
6130
6130
|
CLAUDE_CODE_CLIENT_METADATA_URL = "https://claude.ai/oauth/claude-code-client-metadata";
|
|
6131
6131
|
buildPublicClientMetadata = (clientName, redirectUri) => ({
|
|
6132
6132
|
redirect_uris: [redirectUri],
|
|
@@ -101146,8 +101146,8 @@ var init_otel = __esm({
|
|
|
101146
101146
|
return trimmed && trimmed.length > 0 ? trimmed : void 0;
|
|
101147
101147
|
};
|
|
101148
101148
|
readBuildMetadata = () => {
|
|
101149
|
-
const rawPackageVersion = "1.0.
|
|
101150
|
-
const rawGitSha = "
|
|
101149
|
+
const rawPackageVersion = "1.0.1017";
|
|
101150
|
+
const rawGitSha = "27d0f27f0c5afc4e3dfc2188cd2c483be8cc46c9";
|
|
101151
101151
|
const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
|
|
101152
101152
|
const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
|
|
101153
101153
|
return { packageVersion, gitSha };
|
|
@@ -133553,9 +133553,9 @@ var init_sentry = __esm({
|
|
|
133553
133553
|
uncaughtExceptionMonitorInstalled = false;
|
|
133554
133554
|
currentDevboxSentryUser = null;
|
|
133555
133555
|
readBuildMetadata2 = () => {
|
|
133556
|
-
const rawPackageVersion = "1.0.
|
|
133557
|
-
const rawGitSha = "
|
|
133558
|
-
const rawSentryRelease = "boxes-dev-dvb@1.0.
|
|
133556
|
+
const rawPackageVersion = "1.0.1017";
|
|
133557
|
+
const rawGitSha = "27d0f27f0c5afc4e3dfc2188cd2c483be8cc46c9";
|
|
133558
|
+
const rawSentryRelease = "boxes-dev-dvb@1.0.1017+27d0f27f0c5afc4e3dfc2188cd2c483be8cc46c9";
|
|
133559
133559
|
const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
|
|
133560
133560
|
const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
|
|
133561
133561
|
const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
|
|
@@ -138773,7 +138773,7 @@ var init_packageVersion = __esm({
|
|
|
138773
138773
|
return path17.join(process.cwd(), "dvb");
|
|
138774
138774
|
};
|
|
138775
138775
|
readEmbeddedPackageVersion = () => {
|
|
138776
|
-
const raw = "1.0.
|
|
138776
|
+
const raw = "1.0.1017";
|
|
138777
138777
|
return trimVersion(raw);
|
|
138778
138778
|
};
|
|
138779
138779
|
readNearestPackageMetadata = (basePath) => {
|
|
@@ -207213,7 +207213,7 @@ var init_managedCodex = __esm({
|
|
|
207213
207213
|
"use strict";
|
|
207214
207214
|
init_devboxCore();
|
|
207215
207215
|
init_setupTooling();
|
|
207216
|
-
MANAGED_CODEX_VERSION = "0.
|
|
207216
|
+
MANAGED_CODEX_VERSION = "0.155.1";
|
|
207217
207217
|
MANAGED_CODEX_INSTALL_MANIFEST_DIR = "managed-codex-install";
|
|
207218
207218
|
MANAGED_CODEX_INSTALL_MANIFEST_FILES = [
|
|
207219
207219
|
"package.json",
|
|
@@ -359797,4 +359797,4 @@ react/cjs/react-jsx-runtime.development.js:
|
|
|
359797
359797
|
*)
|
|
359798
359798
|
*/
|
|
359799
359799
|
|
|
359800
|
-
//# debugId=
|
|
359800
|
+
//# debugId=9b454f0a-4e57-5610-9e0f-655fa8fcdd14
|
package/dist/bin/dvbd.mjs
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
|
|
3
|
-
!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="
|
|
3
|
+
!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="ea0f7cdd-37c3-509d-9544-50805dd09a5a")}catch(e){}}();
|
|
4
4
|
import { createRequire as __dvbCreateRequire } from "node:module";
|
|
5
5
|
import { dirname as __dvbDirname } from "node:path";
|
|
6
6
|
import { fileURLToPath as __dvbFileURLToPath } from "node:url";
|
|
@@ -96328,8 +96328,8 @@ var init_otel = __esm({
|
|
|
96328
96328
|
return trimmed && trimmed.length > 0 ? trimmed : void 0;
|
|
96329
96329
|
};
|
|
96330
96330
|
readBuildMetadata = () => {
|
|
96331
|
-
const rawPackageVersion = "1.0.
|
|
96332
|
-
const rawGitSha = "
|
|
96331
|
+
const rawPackageVersion = "1.0.1017";
|
|
96332
|
+
const rawGitSha = "27d0f27f0c5afc4e3dfc2188cd2c483be8cc46c9";
|
|
96333
96333
|
const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
|
|
96334
96334
|
const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
|
|
96335
96335
|
return { packageVersion, gitSha };
|
|
@@ -128624,9 +128624,9 @@ var init_sentry = __esm({
|
|
|
128624
128624
|
uncaughtExceptionMonitorInstalled = false;
|
|
128625
128625
|
currentDevboxSentryUser = null;
|
|
128626
128626
|
readBuildMetadata2 = () => {
|
|
128627
|
-
const rawPackageVersion = "1.0.
|
|
128628
|
-
const rawGitSha = "
|
|
128629
|
-
const rawSentryRelease = "boxes-dev-dvb@1.0.
|
|
128627
|
+
const rawPackageVersion = "1.0.1017";
|
|
128628
|
+
const rawGitSha = "27d0f27f0c5afc4e3dfc2188cd2c483be8cc46c9";
|
|
128629
|
+
const rawSentryRelease = "boxes-dev-dvb@1.0.1017+27d0f27f0c5afc4e3dfc2188cd2c483be8cc46c9";
|
|
128630
128630
|
const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
|
|
128631
128631
|
const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
|
|
128632
128632
|
const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
|
|
@@ -130826,7 +130826,7 @@ var init_packageVersion = __esm({
|
|
|
130826
130826
|
return path8.join(process.cwd(), "dvb");
|
|
130827
130827
|
};
|
|
130828
130828
|
readEmbeddedPackageVersion = () => {
|
|
130829
|
-
const raw = "1.0.
|
|
130829
|
+
const raw = "1.0.1017";
|
|
130830
130830
|
return trimVersion(raw);
|
|
130831
130831
|
};
|
|
130832
130832
|
readNearestPackageMetadata = (basePath) => {
|
|
@@ -144021,4 +144021,4 @@ long/umd/index.js:
|
|
|
144021
144021
|
*)
|
|
144022
144022
|
*/
|
|
144023
144023
|
|
|
144024
|
-
//# debugId=
|
|
144024
|
+
//# debugId=ea0f7cdd-37c3-509d-9544-50805dd09a5a
|
|
@@ -8,13 +8,13 @@
|
|
|
8
8
|
"name": "@boxes-dev/managed-codex-install",
|
|
9
9
|
"version": "0.0.0",
|
|
10
10
|
"dependencies": {
|
|
11
|
-
"@openai/codex": "0.
|
|
11
|
+
"@openai/codex": "0.155.1"
|
|
12
12
|
}
|
|
13
13
|
},
|
|
14
14
|
"node_modules/@openai/codex": {
|
|
15
|
-
"version": "0.
|
|
16
|
-
"resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.
|
|
17
|
-
"integrity": "sha512-
|
|
15
|
+
"version": "0.155.1",
|
|
16
|
+
"resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.155.1.tgz",
|
|
17
|
+
"integrity": "sha512-02fAAGyBtlA1zPjEo3kTj/bOSYbPz5DvjLwRZJdV7weFFEDzNFOMjQGmZ/+5CuirYV0hE+AZTrnjzwXYU4AdAQ==",
|
|
18
18
|
"license": "Apache-2.0",
|
|
19
19
|
"bin": {
|
|
20
20
|
"codex": "bin/codex.js"
|
|
@@ -23,19 +23,19 @@
|
|
|
23
23
|
"node": ">=16"
|
|
24
24
|
},
|
|
25
25
|
"optionalDependencies": {
|
|
26
|
-
"@openai/codex-darwin-arm64": "npm:@openai/codex@0.
|
|
27
|
-
"@openai/codex-darwin-x64": "npm:@openai/codex@0.
|
|
28
|
-
"@openai/codex-linux-arm64": "npm:@openai/codex@0.
|
|
29
|
-
"@openai/codex-linux-x64": "npm:@openai/codex@0.
|
|
30
|
-
"@openai/codex-win32-arm64": "npm:@openai/codex@0.
|
|
31
|
-
"@openai/codex-win32-x64": "npm:@openai/codex@0.
|
|
26
|
+
"@openai/codex-darwin-arm64": "npm:@openai/codex@0.155.1-darwin-arm64",
|
|
27
|
+
"@openai/codex-darwin-x64": "npm:@openai/codex@0.155.1-darwin-x64",
|
|
28
|
+
"@openai/codex-linux-arm64": "npm:@openai/codex@0.155.1-linux-arm64",
|
|
29
|
+
"@openai/codex-linux-x64": "npm:@openai/codex@0.155.1-linux-x64",
|
|
30
|
+
"@openai/codex-win32-arm64": "npm:@openai/codex@0.155.1-win32-arm64",
|
|
31
|
+
"@openai/codex-win32-x64": "npm:@openai/codex@0.155.1-win32-x64"
|
|
32
32
|
}
|
|
33
33
|
},
|
|
34
34
|
"node_modules/@openai/codex-darwin-arm64": {
|
|
35
35
|
"name": "@openai/codex",
|
|
36
|
-
"version": "0.
|
|
37
|
-
"resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.
|
|
38
|
-
"integrity": "sha512-
|
|
36
|
+
"version": "0.155.1-darwin-arm64",
|
|
37
|
+
"resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.155.1-darwin-arm64.tgz",
|
|
38
|
+
"integrity": "sha512-cYxzGcRRoBrncyHlR8ed4yXwcoVJZC1pipGULSyJkGFKXJw/Uu57BklvzayuAptjJIipamnOk32CfUkk1F0bLw==",
|
|
39
39
|
"cpu": [
|
|
40
40
|
"arm64"
|
|
41
41
|
],
|
|
@@ -50,9 +50,9 @@
|
|
|
50
50
|
},
|
|
51
51
|
"node_modules/@openai/codex-darwin-x64": {
|
|
52
52
|
"name": "@openai/codex",
|
|
53
|
-
"version": "0.
|
|
54
|
-
"resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.
|
|
55
|
-
"integrity": "sha512-
|
|
53
|
+
"version": "0.155.1-darwin-x64",
|
|
54
|
+
"resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.155.1-darwin-x64.tgz",
|
|
55
|
+
"integrity": "sha512-FDpc+PdELYlyDnhd76Ckm6jNLF+1n3x34Ygd4QLQger810Vkxx/InQ5LY5jwkecJYKcbvyhMmuxTspaj1dLZrA==",
|
|
56
56
|
"cpu": [
|
|
57
57
|
"x64"
|
|
58
58
|
],
|
|
@@ -67,9 +67,9 @@
|
|
|
67
67
|
},
|
|
68
68
|
"node_modules/@openai/codex-linux-arm64": {
|
|
69
69
|
"name": "@openai/codex",
|
|
70
|
-
"version": "0.
|
|
71
|
-
"resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.
|
|
72
|
-
"integrity": "sha512-
|
|
70
|
+
"version": "0.155.1-linux-arm64",
|
|
71
|
+
"resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.155.1-linux-arm64.tgz",
|
|
72
|
+
"integrity": "sha512-X3fRXm2orhJ3KeB8LgKym4XDUiQaqaOGuaa181bcHTsQI7C8m6tcQQbQsKDzT/2IibikzgYL82jvsgMbq43jww==",
|
|
73
73
|
"cpu": [
|
|
74
74
|
"arm64"
|
|
75
75
|
],
|
|
@@ -84,9 +84,9 @@
|
|
|
84
84
|
},
|
|
85
85
|
"node_modules/@openai/codex-linux-x64": {
|
|
86
86
|
"name": "@openai/codex",
|
|
87
|
-
"version": "0.
|
|
88
|
-
"resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.
|
|
89
|
-
"integrity": "sha512-
|
|
87
|
+
"version": "0.155.1-linux-x64",
|
|
88
|
+
"resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.155.1-linux-x64.tgz",
|
|
89
|
+
"integrity": "sha512-atv3HF0mubqB0J/XkQ2JopqKzXJ+/7aQtTB2MkJ9MrraujMIz8zbCCLylLkN3PzpVGTJzzQFN/wD1oq8oJPJKg==",
|
|
90
90
|
"cpu": [
|
|
91
91
|
"x64"
|
|
92
92
|
],
|
|
@@ -101,9 +101,9 @@
|
|
|
101
101
|
},
|
|
102
102
|
"node_modules/@openai/codex-win32-arm64": {
|
|
103
103
|
"name": "@openai/codex",
|
|
104
|
-
"version": "0.
|
|
105
|
-
"resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.
|
|
106
|
-
"integrity": "sha512
|
|
104
|
+
"version": "0.155.1-win32-arm64",
|
|
105
|
+
"resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.155.1-win32-arm64.tgz",
|
|
106
|
+
"integrity": "sha512-k5x8VO1aF8Xx/nuh1P31TeBgs11WA6i2GJiHqx5YCndFbWzOzUz6aeBaq9+PO6Qfe/Ivennh3I1FKJBU6Q8mpg==",
|
|
107
107
|
"cpu": [
|
|
108
108
|
"arm64"
|
|
109
109
|
],
|
|
@@ -118,9 +118,9 @@
|
|
|
118
118
|
},
|
|
119
119
|
"node_modules/@openai/codex-win32-x64": {
|
|
120
120
|
"name": "@openai/codex",
|
|
121
|
-
"version": "0.
|
|
122
|
-
"resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.
|
|
123
|
-
"integrity": "sha512-
|
|
121
|
+
"version": "0.155.1-win32-x64",
|
|
122
|
+
"resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.155.1-win32-x64.tgz",
|
|
123
|
+
"integrity": "sha512-MO+cCZrgU0Ec7lJP/5NsTe5obJ9/qtRMkQUK0jYWTY1omxLA3lp5IOD2IAmsejlEJB931XRo51LZ7hl178CDjA==",
|
|
124
124
|
"cpu": [
|
|
125
125
|
"x64"
|
|
126
126
|
],
|
|
@@ -157,6 +157,16 @@ stopping.
|
|
|
157
157
|
Use the terminal button in a session when you need a shell for the thread's
|
|
158
158
|
current runtime.
|
|
159
159
|
|
|
160
|
+
To fork a Codex or Claude conversation, tap **Continue in new chat** below a
|
|
161
|
+
completed reply, then choose **Current box** or **New devbox**. The new chat
|
|
162
|
+
will include the conversation through that reply. The header menu offers the
|
|
163
|
+
same action for the latest reply. Wait for the agent to finish before forking;
|
|
164
|
+
unsent text and attachments will stay with the original chat. Choosing a new
|
|
165
|
+
devbox will copy the source box's current files, not rewind them to the reply.
|
|
166
|
+
The new chat will open during devbox creation, so you can queue messages
|
|
167
|
+
before the copied conversation is ready. Queued messages will remain with
|
|
168
|
+
the new chat if you navigate away.
|
|
169
|
+
|
|
160
170
|
## Devbox Actions
|
|
161
171
|
|
|
162
172
|
Mobile thread lists show Git-change counts inline and a live devbox status dot
|
|
@@ -215,41 +215,44 @@ dvb-onbox permissions request \
|
|
|
215
215
|
--permission create-devboxes-and-threads
|
|
216
216
|
```
|
|
217
217
|
|
|
218
|
-
The
|
|
218
|
+
The request values are `create-devboxes-and-threads`,
|
|
219
219
|
`create-team-templates`, `update-thread-titles`,
|
|
220
220
|
`move-devboxes-to-folders`, `create-devbox-folders`,
|
|
221
|
-
`edit-devbox-lifecycle`,
|
|
221
|
+
`edit-devbox-lifecycle`, `edit-template-maintenance`, and `destroy-devbox`. Add `--json` for a
|
|
222
222
|
stable structured result.
|
|
223
223
|
|
|
224
224
|
The command creates one request for the exact managed thread and source box,
|
|
225
|
-
then waits up to ten minutes while the owner sees **Allow
|
|
226
|
-
|
|
225
|
+
then waits up to ten minutes while the owner sees **Deny**, **Allow**, and,
|
|
226
|
+
where supported, **Always allow for project** in boxes.dev.
|
|
227
|
+
**Allow** changes the existing persistent Agent permission
|
|
227
228
|
for every agent on that source box until the owner turns it off; it is not a
|
|
228
|
-
one-operation grant.
|
|
229
|
-
request.
|
|
229
|
+
one-operation grant. **Deny** declines this request without changing permission
|
|
230
|
+
settings. An agent cannot answer its own request.
|
|
230
231
|
|
|
231
232
|
For folder access, thread titles, and creating devboxes and threads, the owner
|
|
232
|
-
can choose **
|
|
233
|
+
can choose **Always allow for project** directly.
|
|
233
234
|
This will enable the project's shared permission and make the requesting box
|
|
234
|
-
use it. All existing and future devboxes
|
|
235
|
-
|
|
236
|
-
|
|
235
|
+
use it. All existing and future devboxes will follow that setting, except
|
|
236
|
+
those configured separately. Other devboxes will keep their individual
|
|
237
|
+
permissions. The choice is personal to the owner's
|
|
237
238
|
project, including projects created from a Team Template; it will not change
|
|
238
239
|
teammates' permissions. Template-only permissions keep their existing scope.
|
|
239
240
|
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
241
|
+
The **Agent permissions** switches show each box's effective on/off settings;
|
|
242
|
+
folder access shows its actual access level. Changing a control saves the
|
|
243
|
+
choice for that box, independently of future project changes. Change shared
|
|
244
|
+
access under **Agent permissions for this project** in Project settings.
|
|
245
|
+
Turning off a project permission revokes it for every box that follows that
|
|
246
|
+
setting; permissions saved individually remain in effect. Older boxes may also
|
|
247
|
+
have permissions saved individually; turn those off in the box's Agent
|
|
248
|
+
permissions control when needed.
|
|
246
249
|
|
|
247
250
|
Run the request once and wait. `granted` and `already_granted` are successful;
|
|
248
251
|
`denied`, `expired`, and `permission_request_pending` are non-successful
|
|
249
252
|
decisions. Retry the original `dvb-onbox` operation only after a successful
|
|
250
253
|
decision, preserving that operation's original idempotency key when it has one.
|
|
251
|
-
The permission command never retries the blocked operation itself. After **
|
|
252
|
-
|
|
254
|
+
The permission command never retries the blocked operation itself. After **Deny**
|
|
255
|
+
or expiry, continue without the operation and do not ask again in the same
|
|
253
256
|
task. Do not request title permission for optional housekeeping.
|
|
254
257
|
|
|
255
258
|
## Current Thread Title
|
|
@@ -563,10 +566,48 @@ their devboxes or claiming a live input surface. The source box's live **Create
|
|
|
563
566
|
devboxes and threads** permission is checked on every observation and control.
|
|
564
567
|
Prompt files are limited to 32 KiB.
|
|
565
568
|
|
|
566
|
-
|
|
567
|
-
inventory,
|
|
568
|
-
|
|
569
|
-
|
|
569
|
+
Delegation does not grant destruction permission. `dvb-onbox` does not expose
|
|
570
|
+
project inventory, arbitrary direct exec, services, or generic port and machine
|
|
571
|
+
management. The current-box public link commands above are its only port-control
|
|
572
|
+
surface.
|
|
573
|
+
|
|
574
|
+
## Destroy And Archive The Current Devbox
|
|
575
|
+
|
|
576
|
+
An agent can request destruction of its own ordinary devbox with:
|
|
577
|
+
|
|
578
|
+
```bash
|
|
579
|
+
dvb-onbox box destroy --json
|
|
580
|
+
```
|
|
581
|
+
|
|
582
|
+
The separate **Destroy and archive this devbox** permission is off by default
|
|
583
|
+
and applies only to that devbox. Enable it in the thread header's **Agent
|
|
584
|
+
permissions**, or request `destroy-devbox` after a `destruction_disabled` error.
|
|
585
|
+
Template boxes and other devboxes cannot be targeted.
|
|
586
|
+
|
|
587
|
+
Destruction permanently deletes the devbox's files and retains its thread
|
|
588
|
+
history. Run this only when the user's task calls for destroying the devbox,
|
|
589
|
+
after preserving required work outside the machine. The command returns
|
|
590
|
+
`accepted` once the request is saved, or `already_requested` for an existing
|
|
591
|
+
request; neither means destruction has finished. Finish your final response
|
|
592
|
+
after acceptance. Do not wait in a tool call for your own destruction.
|
|
593
|
+
|
|
594
|
+
The request always waits for every agent and queued message on the devbox to
|
|
595
|
+
finish. There is no `--when-idle` or force option. Once idle, boxes.dev archives
|
|
596
|
+
the threads, runs the configured teardown, and deletes the machine. New work
|
|
597
|
+
submitted before destruction starts cancels the request, as does turning off
|
|
598
|
+
the permission. A request that stays pending for 30 minutes expires. After
|
|
599
|
+
destruction starts, new messages are rejected.
|
|
600
|
+
|
|
601
|
+
To withdraw a pending request before finishing your turn, run:
|
|
602
|
+
|
|
603
|
+
```bash
|
|
604
|
+
dvb-onbox box cancel-destroy --json
|
|
605
|
+
```
|
|
606
|
+
|
|
607
|
+
Any managed agent on the same devbox can cancel its pending request without
|
|
608
|
+
the destruction permission. The command returns `cancelled`, or `not_pending`
|
|
609
|
+
with a null `requestId` if there is nothing to cancel. Once archival has
|
|
610
|
+
started, it returns `destruction_started`; it cannot undo that handoff.
|
|
570
611
|
|
|
571
612
|
## Devbox Folders
|
|
572
613
|
|
|
@@ -52,6 +52,30 @@ Common terminal actions:
|
|
|
52
52
|
Closing a terminal tab ends that terminal session. Closing the desktop app
|
|
53
53
|
preserves open terminal sessions and restores their tabs when you reopen it.
|
|
54
54
|
|
|
55
|
+
### Command History
|
|
56
|
+
|
|
57
|
+
When Project storage is available, new Bash terminals share history within
|
|
58
|
+
your project, including projects created from a Team Template. Bash saves new
|
|
59
|
+
commands when you close the terminal session. Open a new terminal on another
|
|
60
|
+
devbox to recall saved commands with Up-arrow or Ctrl-R. Existing terminals
|
|
61
|
+
keep their current history, including after reconnecting; disconnecting or
|
|
62
|
+
sleeping a devbox does not save an open session's commands.
|
|
63
|
+
|
|
64
|
+
History uses `/project/.bash_history`, with up to 10,000 commands in memory
|
|
65
|
+
and 10,000 history-file lines. Your previous local history file stays unchanged.
|
|
66
|
+
Bash loads its entries before shared history, with older entries dropping out
|
|
67
|
+
when the limit is reached. History filters still apply, and noninteractive
|
|
68
|
+
agent commands are not included. A custom history-file setting is preserved.
|
|
69
|
+
|
|
70
|
+
Sharing is best effort. Closing terminals on different devboxes at the same
|
|
71
|
+
time can lose one session's saved commands, and an abruptly stopped session
|
|
72
|
+
can lose its unsaved history. Reading project storage can add time to opening
|
|
73
|
+
a terminal. Without Project storage, Bash will continue using local history.
|
|
74
|
+
Anyone with access to the project's storage can read its history, so avoid
|
|
75
|
+
recording secrets in commands.
|
|
76
|
+
|
|
77
|
+
### Connections And Terminal Input
|
|
78
|
+
|
|
55
79
|
**Desktop app settings > Connection** includes a Terminal Connection choice.
|
|
56
80
|
Managed is the default attachment transport. Direct (Mosh) negotiates an
|
|
57
81
|
encrypted UDP path for the lowest latency and repairs that path if connectivity
|
|
@@ -241,32 +265,39 @@ to recover. Reduce memory use before retrying the interrupted work.
|
|
|
241
265
|
|
|
242
266
|
## Reset
|
|
243
267
|
|
|
244
|
-
The desktop app menu has **Machine > Reset
|
|
245
|
-
is running. Reset kills shells, agent sessions, background
|
|
246
|
-
services, while preserving files and keeping the runtime running.
|
|
268
|
+
The desktop app menu has **Machine > Reset (stop processes)…** when the selected
|
|
269
|
+
managed runtime is running. Reset kills shells, agent sessions, background
|
|
270
|
+
commands, and user services, while preserving files and keeping the runtime running.
|
|
247
271
|
|
|
248
272
|
If a devbox thread is selected, reset targets that devbox. In an ordinary
|
|
249
273
|
project, selecting the Template box targets it instead. A project with no
|
|
250
274
|
selected real runtime has no reset target. boxes.dev confirms before resetting
|
|
251
275
|
and then reports what was stopped.
|
|
252
276
|
|
|
277
|
+
The Machine menu names the target as a Devbox with the selected thread's title
|
|
278
|
+
or a Template box with the project name. Reset is disabled while that machine
|
|
279
|
+
sleeps, with a reminder to wake it first. Reset requires the
|
|
280
|
+
machine's service to be running and cannot recover a failed wake attempt.
|
|
281
|
+
|
|
253
282
|
## Reboot (Last Resort)
|
|
254
283
|
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
284
|
+
For a running machine, try **Machine > Reset (stop processes)…** before rebooting.
|
|
285
|
+
**Machine > Reboot (restart machine)…** works on running and sleeping Template
|
|
286
|
+
boxes and devboxes. It starts that exact machine without restoring saved memory.
|
|
287
|
+
After a failed wake leaves the selected machine sleeping, a warning banner
|
|
288
|
+
offers **Try again** to retry a normal wake and **Reboot…** to restart without
|
|
289
|
+
saved memory. The normal **Wake** control remains available to retry waking.
|
|
259
290
|
|
|
260
|
-
Reboot preserves
|
|
261
|
-
|
|
291
|
+
Reboot preserves files saved to disk, including project files and git state;
|
|
292
|
+
changes still held only in memory may be lost. Every process, shell, terminal attachment, agent
|
|
262
293
|
session, background command, user service, and network connection stops. After
|
|
263
|
-
the machine starts, boxes.dev
|
|
264
|
-
|
|
265
|
-
|
|
294
|
+
the machine starts, boxes.dev waits for a fresh boxes.dev service heartbeat
|
|
295
|
+
before reporting success. Existing terminals and agent sessions do not resume;
|
|
296
|
+
reconnect or start new ones.
|
|
266
297
|
|
|
267
298
|
If shutdown is not confirmed, boxes.dev reports that reboot did not start. If
|
|
268
|
-
|
|
269
|
-
|
|
299
|
+
startup fails, the machine remains sleeping; try **Reboot** again or use **Wake**
|
|
300
|
+
to retry a normal wake. If the machine starts but boxes.dev
|
|
270
301
|
services are not ready, wait briefly and use Reset or contact support rather
|
|
271
302
|
than starting another reboot immediately.
|
|
272
303
|
|
|
@@ -12,11 +12,13 @@ from snapshots of this Template box. A Team Template can separately enable
|
|
|
12
12
|
**Member projects**, which have no personal Template box; see
|
|
13
13
|
`team-template.md` for that flow.
|
|
14
14
|
|
|
15
|
-
The
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
15
|
+
The desktop app's Project step recommends agent-driven setup first: the user's
|
|
16
|
+
own coding agent inspects the local project, prepares the upload plan, and
|
|
17
|
+
hands it to boxes.dev. The desktop local-folder flow reaches the same result
|
|
18
|
+
through a guided wizard. Both upload local project state and start a setup
|
|
19
|
+
thread on the Template box. That thread applies the setup plan, installs
|
|
20
|
+
missing project dependencies, checks important app entrypoints, and writes a
|
|
21
|
+
setup summary or follow-up list when it finishes.
|
|
20
22
|
**Create from GitHub** is the fallback for a repository the user does not have
|
|
21
23
|
locally: it clones one or more selected repositories into a new Template box,
|
|
22
24
|
without env files, secrets, or untracked local work, and leaves environment
|
|
@@ -166,11 +168,11 @@ and cache exclusions while adding exceptions, and apply to every eligible
|
|
|
166
168
|
file even when a large folder's displayed listing is shortened. Git-ignored
|
|
167
169
|
files need a named file selection if you want to copy them.
|
|
168
170
|
|
|
169
|
-
The desktop app's Project step
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
open.
|
|
171
|
+
The desktop app's Project step leads with **Set up with your coding agent**,
|
|
172
|
+
followed by a Team Template when the team has one, then a local folder, then
|
|
173
|
+
GitHub. **Use coding agent** expands the card to show the prompt to copy into
|
|
174
|
+
Codex or Claude Code in the local project folder. When the remote setup thread starts, the agent offers to open that
|
|
175
|
+
project in the desktop app, so the Project step does not need to stay open.
|
|
174
176
|
|
|
175
177
|
The commands mirror the wizard's stages: `dvb agent-init start` seeds the
|
|
176
178
|
version 3 manifest with everything detectable. A standard GitHub origin seeds
|
|
@@ -49,6 +49,31 @@ now. Agent credentials, native session files, and other private agent state are
|
|
|
49
49
|
kept outside the Team Template's authored filesystem and are never copied into
|
|
50
50
|
a saved version or a project created from it.
|
|
51
51
|
|
|
52
|
+
### Removing A Team Member
|
|
53
|
+
|
|
54
|
+
An admin can remove another member from **Team Settings → Members** using the
|
|
55
|
+
member's menu. Select a remaining member as the work recipient, then choose
|
|
56
|
+
**Transfer**, **Delete**, or **Keep** for every project. Transfer preserves the
|
|
57
|
+
project's work under the recipient and records its original account. Delete
|
|
58
|
+
uses permanent project deletion and requires confirmation for each project.
|
|
59
|
+
Keep moves the project to the departing account's fresh personal team and
|
|
60
|
+
removes managed files, managed secrets, team access, and existing thread
|
|
61
|
+
sharing. Ordinary files and unmanaged environment-file content remain.
|
|
62
|
+
A kept Member project receives an independent Template box.
|
|
63
|
+
|
|
64
|
+
Running work stops during handoff, and automations pause for connection review.
|
|
65
|
+
Account-specific connections require the new owner's authorization. The removed
|
|
66
|
+
account can continue using its personal team and will not automatically rejoin
|
|
67
|
+
the former team through its email domain. Remove its paid seat in Billing and
|
|
68
|
+
finish pending project operations first. Team Template editing sessions must
|
|
69
|
+
be saved or discarded before removal. Admins cannot remove themselves.
|
|
70
|
+
An interrupted removal remains in Team Settings with progress and a retry
|
|
71
|
+
action; closing its dialog does not cancel it.
|
|
72
|
+
Team Template conversations transfer to the selected recipient, who must be
|
|
73
|
+
an admin when these conversations exist. Shared saved environments remain with
|
|
74
|
+
the team. The personal team needs its own billing setup before starting
|
|
75
|
+
compute; the former team's payment method and credits remain on that team.
|
|
76
|
+
|
|
52
77
|
## Finding And Managing Team Templates
|
|
53
78
|
|
|
54
79
|
Team admins can open **Team Templates** from the desktop project selector or
|
|
@@ -371,9 +396,10 @@ support. These setup errors do not necessarily mean the startup script needs to
|
|
|
371
396
|
change. If waiting for preparation times out, the notice will say that completion
|
|
372
397
|
could not be confirmed and your message was not sent; it will retain your draft.
|
|
373
398
|
|
|
374
|
-
The new project is independent
|
|
375
|
-
|
|
376
|
-
|
|
399
|
+
The new project is independent of later Team Template versions and save cleanup.
|
|
400
|
+
When removing a member, an admin chooses whether to transfer, delete, or let
|
|
401
|
+
that member keep each project under the removal rules above.
|
|
402
|
+
Creating it uses a normal project slot and its
|
|
377
403
|
runtime uses the member's normal billing entitlement.
|
|
378
404
|
|
|
379
405
|
Setup instructions are current Project defaults, not part of the filesystem
|
|
@@ -489,10 +489,17 @@ handing them to the runtime, so delivery after server receipt does not depend
|
|
|
489
489
|
on keeping the app open.
|
|
490
490
|
Keep the app open until any attachment uploads finish and the message reaches
|
|
491
491
|
the server; messages saved only on your device will resume when you reopen
|
|
492
|
-
their thread.
|
|
493
|
-
|
|
494
|
-
|
|
495
|
-
|
|
492
|
+
their thread. Temporary delivery failures before agent submission retry the
|
|
493
|
+
same message while later messages wait. After three failed attempts, the first
|
|
494
|
+
message shows **Send failed**, and a **Message send failed** notice above the
|
|
495
|
+
composer offers **Retry** and **Edit message** (or **Edit messages**, when
|
|
496
|
+
several are waiting). **Retry** retries that message in place; waiting for
|
|
497
|
+
startup or reconnection does not consume those attempts.
|
|
498
|
+
Use **Edit message** or **Edit messages** to cancel pending delivery, including
|
|
499
|
+
while attachments upload. The captured messages return in order as one draft,
|
|
500
|
+
with attachments, before existing composer text. Newer submissions stay queued.
|
|
501
|
+
If returning to draft is interrupted or fails, choose **Edit message** or
|
|
502
|
+
**Edit messages** again to resume it.
|
|
496
503
|
If you quit before an upload finishes, you may need to attach the files again;
|
|
497
504
|
boxes.dev will name any attachments it couldn't restore.
|
|
498
505
|
|
|
@@ -786,16 +793,17 @@ Interrupting asks the agent to stop the current turn. It does not delete the
|
|
|
786
793
|
thread. After a turn stops, the user can send another prompt, inspect changes,
|
|
787
794
|
or decide whether to keep or discard the devbox.
|
|
788
795
|
|
|
789
|
-
On desktop
|
|
790
|
-
|
|
791
|
-
|
|
792
|
-
|
|
793
|
-
|
|
794
|
-
|
|
795
|
-
|
|
796
|
-
|
|
797
|
-
|
|
798
|
-
|
|
796
|
+
On desktop and mobile, **Stop** interrupts the active response and preserves
|
|
797
|
+
queued follow-ups for both Codex and Claude. This includes messages boxes.dev
|
|
798
|
+
is still preparing or retrying: they stay scheduled and run in order when the
|
|
799
|
+
agent is ready. **Steer now** brings queued work forward by interrupting the
|
|
800
|
+
response; preparation and uploads still have to finish.
|
|
801
|
+
|
|
802
|
+
**Edit message** or **Edit messages** explicitly cancels messages still waiting
|
|
803
|
+
for delivery and restores their text and attachments as one ordered draft.
|
|
804
|
+
Messages sent after choosing that action stay scheduled. Messages already
|
|
805
|
+
accepted into the agent's queue use its existing edit/delete controls. Startup
|
|
806
|
+
cancellation, before an active response exists, still cancels the pending start.
|
|
799
807
|
|
|
800
808
|
Claude steers already accepted by Claude are different: Stop may leave them
|
|
801
809
|
waiting for Claude's next response, and they cannot be taken back through the
|
|
@@ -152,6 +152,12 @@ directly there are under **Template-managed MCPs** in the same place. Team
|
|
|
152
152
|
Template member projects omit that inventory. If sign-in fails, follow the
|
|
153
153
|
recovery message on that MCP's card.
|
|
154
154
|
|
|
155
|
+
When you send to an existing Claude thread in the desktop app, a slow MCP
|
|
156
|
+
reconnection can delay the message while Claude gets ready. boxes.dev will
|
|
157
|
+
keep the message queued and continue automatically when preparation finishes,
|
|
158
|
+
even if it takes longer than a minute. You don't need to send it again. If
|
|
159
|
+
sign-in or another error needs attention, follow the message's recovery action.
|
|
160
|
+
|
|
155
161
|
If **Template-managed MCPs** cannot load, use **Retry**. A dash in an agent's
|
|
156
162
|
count means its inventory is unavailable, and rows kept from an earlier read
|
|
157
163
|
are marked as previous results. A sleeping Template box shows a disconnected
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@boxes-dev/dvb-runtime",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.1017",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"license": "UNLICENSED",
|
|
6
6
|
"imports": {
|
|
@@ -77,5 +77,5 @@
|
|
|
77
77
|
"e2b": "^2.18.0",
|
|
78
78
|
"ink-testing-library": "^4.0.0"
|
|
79
79
|
},
|
|
80
|
-
"devboxReleasedAt": "2026-09-
|
|
80
|
+
"devboxReleasedAt": "2026-09-23T16:43:22Z"
|
|
81
81
|
}
|