@boxes-dev/dvb-runtime 1.0.1057 → 1.0.1059
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 +1830 -1749
- package/dist/bin/dvbd.mjs +18 -8
- package/dist/product-docs/references/agent-tools.md +24 -7
- package/dist/product-docs/references/desktop-workbench.md +36 -7
- package/dist/product-docs/references/files-git-and-review.md +6 -0
- package/dist/product-docs/references/onbox-agent-tools.md +100 -5
- package/dist/product-docs/references/threads-and-agents.md +16 -6
- package/package.json +2 -2
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]="6358e715-5d10-5bd8-bcb8-b3b8fafb5add")}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";
|
|
@@ -45,6 +45,13 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
|
|
|
45
45
|
mod
|
|
46
46
|
));
|
|
47
47
|
|
|
48
|
+
// ../../../../shared/devboxCore/dist/embeddedIdeProtocol.js
|
|
49
|
+
var init_embeddedIdeProtocol = __esm({
|
|
50
|
+
"../../../../shared/devboxCore/dist/embeddedIdeProtocol.js"() {
|
|
51
|
+
"use strict";
|
|
52
|
+
}
|
|
53
|
+
});
|
|
54
|
+
|
|
48
55
|
// ../../../../node_modules/ws/lib/constants.js
|
|
49
56
|
var require_constants = __commonJS({
|
|
50
57
|
"../../../../node_modules/ws/lib/constants.js"(exports, module2) {
|
|
@@ -64667,9 +64674,9 @@ var init_sentry = __esm({
|
|
|
64667
64674
|
uncaughtExceptionMonitorInstalled = false;
|
|
64668
64675
|
currentDevboxSentryUser = null;
|
|
64669
64676
|
readBuildMetadata = () => {
|
|
64670
|
-
const rawPackageVersion = "1.0.
|
|
64671
|
-
const rawGitSha = "
|
|
64672
|
-
const rawSentryRelease = "boxes-dev-dvb@1.0.
|
|
64677
|
+
const rawPackageVersion = "1.0.1059";
|
|
64678
|
+
const rawGitSha = "f538c975742985e515cdf721d4c94e5cb211e2ab";
|
|
64679
|
+
const rawSentryRelease = "boxes-dev-dvb@1.0.1059+f538c975742985e515cdf721d4c94e5cb211e2ab";
|
|
64673
64680
|
const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
|
|
64674
64681
|
const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
|
|
64675
64682
|
const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
|
|
@@ -65401,7 +65408,7 @@ var init_forkStartupScript = __esm({
|
|
|
65401
65408
|
});
|
|
65402
65409
|
|
|
65403
65410
|
// ../../../../shared/devboxCore/dist/ports.js
|
|
65404
|
-
var MIN_PORT, MAX_PORT2, DEFAULT_MANAGED_SSH_PORT, E2B_MANAGED_SSH_PORT, RPCBIND_PORT, SPRITE_DAEMON_SESSION_PORT, PROJECT_URL_LOCAL_API_PORT, MANAGED_DAEMON_CONTROL_PORT, REMOTE_BROWSER_CDP_PORT, LOOPBACK_PRIVACY_CANARY_PORT, LOOPBACK_PRIVACY_WILDCARD_CONTROL_PORT, LOOPBACK_PRIVACY_MIGRATION_CONTROL_PORT, RESERVED_SYSTEM_PORTS, normalizePort, getManagedSshPort, isManagedSshPort, isReservedSystemPort, normalizeRange, mergeRanges, normalizePortSpec, mergePortSpecs, toRanges, subtractPortSpecs, isPortAllowed, parsePortSpec;
|
|
65411
|
+
var MIN_PORT, MAX_PORT2, DEFAULT_MANAGED_SSH_PORT, E2B_MANAGED_SSH_PORT, RPCBIND_PORT, SPRITE_DAEMON_SESSION_PORT, PROJECT_URL_LOCAL_API_PORT, MANAGED_DAEMON_CONTROL_PORT, REMOTE_BROWSER_CDP_PORT, LOOPBACK_PRIVACY_CANARY_PORT, LOOPBACK_PRIVACY_WILDCARD_CONTROL_PORT, LOOPBACK_PRIVACY_MIGRATION_CONTROL_PORT, EMBEDDED_IDE_SERVER_PORT, RESERVED_SYSTEM_PORTS, normalizePort, getManagedSshPort, isManagedSshPort, isReservedSystemPort, normalizeRange, mergeRanges, normalizePortSpec, mergePortSpecs, toRanges, subtractPortSpecs, isPortAllowed, parsePortSpec;
|
|
65405
65412
|
var init_ports = __esm({
|
|
65406
65413
|
"../../../../shared/devboxCore/dist/ports.js"() {
|
|
65407
65414
|
"use strict";
|
|
@@ -65417,6 +65424,7 @@ var init_ports = __esm({
|
|
|
65417
65424
|
LOOPBACK_PRIVACY_CANARY_PORT = 47824;
|
|
65418
65425
|
LOOPBACK_PRIVACY_WILDCARD_CONTROL_PORT = 47825;
|
|
65419
65426
|
LOOPBACK_PRIVACY_MIGRATION_CONTROL_PORT = 47826;
|
|
65427
|
+
EMBEDDED_IDE_SERVER_PORT = 47827;
|
|
65420
65428
|
RESERVED_SYSTEM_PORTS = /* @__PURE__ */ new Set([
|
|
65421
65429
|
DEFAULT_MANAGED_SSH_PORT,
|
|
65422
65430
|
RPCBIND_PORT,
|
|
@@ -65427,7 +65435,8 @@ var init_ports = __esm({
|
|
|
65427
65435
|
REMOTE_BROWSER_CDP_PORT,
|
|
65428
65436
|
LOOPBACK_PRIVACY_CANARY_PORT,
|
|
65429
65437
|
LOOPBACK_PRIVACY_WILDCARD_CONTROL_PORT,
|
|
65430
|
-
LOOPBACK_PRIVACY_MIGRATION_CONTROL_PORT
|
|
65438
|
+
LOOPBACK_PRIVACY_MIGRATION_CONTROL_PORT,
|
|
65439
|
+
EMBEDDED_IDE_SERVER_PORT
|
|
65431
65440
|
]);
|
|
65432
65441
|
normalizePort = (value) => {
|
|
65433
65442
|
if (!Number.isInteger(value))
|
|
@@ -66884,7 +66893,7 @@ var init_packageVersion = __esm({
|
|
|
66884
66893
|
return path8.join(process.cwd(), "dvb");
|
|
66885
66894
|
};
|
|
66886
66895
|
readEmbeddedPackageVersion = () => {
|
|
66887
|
-
const raw = "1.0.
|
|
66896
|
+
const raw = "1.0.1059";
|
|
66888
66897
|
return trimVersion(raw);
|
|
66889
66898
|
};
|
|
66890
66899
|
readNearestPackageMetadata = (basePath) => {
|
|
@@ -67119,6 +67128,7 @@ var init_authRefresh = __esm({
|
|
|
67119
67128
|
var init_dist3 = __esm({
|
|
67120
67129
|
"../../../../shared/devboxCore/dist/index.js"() {
|
|
67121
67130
|
"use strict";
|
|
67131
|
+
init_embeddedIdeProtocol();
|
|
67122
67132
|
init_codexLocalRenderer();
|
|
67123
67133
|
init_codexLocalImageFrame();
|
|
67124
67134
|
init_mcpCommandImport();
|
|
@@ -80036,4 +80046,4 @@ smol-toml/dist/index.js:
|
|
|
80036
80046
|
*)
|
|
80037
80047
|
*/
|
|
80038
80048
|
|
|
80039
|
-
//# debugId=
|
|
80049
|
+
//# debugId=6358e715-5d10-5bd8-bcb8-b3b8fafb5add
|
|
@@ -214,7 +214,7 @@ viewed. The default is 20 recent turns; follow the returned opaque cursor for
|
|
|
214
214
|
earlier pages. Current Codex and Claude transcripts are supported. Threads of
|
|
215
215
|
the retired `claude_code` type return a typed `unsupported_agent` transcript status.
|
|
216
216
|
|
|
217
|
-
Send a follow-up
|
|
217
|
+
Send a follow-up to the canonical thread:
|
|
218
218
|
|
|
219
219
|
```bash
|
|
220
220
|
idempotency_key="$(node -p 'require("node:crypto").randomUUID()')"
|
|
@@ -226,12 +226,29 @@ dvb threads send \
|
|
|
226
226
|
--json
|
|
227
227
|
```
|
|
228
228
|
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
229
|
+
By default, a send starts a turn when the thread is idle and otherwise queues
|
|
230
|
+
behind the active turn, so you don't need to wait for the thread before
|
|
231
|
+
sending. Choose a stricter behavior with `--delivery`:
|
|
232
|
+
|
|
233
|
+
| Value | Behavior |
|
|
234
|
+
| --- | --- |
|
|
235
|
+
| `next` | Starts a turn when the thread is idle, or queues behind the active turn. This is the default. |
|
|
236
|
+
| `idle` | Starts a turn only when the thread is idle. Active work returns `thread_busy`. |
|
|
237
|
+
| `queue` | Queues only behind active work. An idle thread returns `turn_not_active`. |
|
|
238
|
+
| `steer` | Adds the follow-up to the exact active Codex turn given by `--turn <active-turn-id>`. Claude doesn't support steering. |
|
|
239
|
+
|
|
240
|
+
`idle`, `queue`, and `steer` never fall back to another mode. The operation's
|
|
241
|
+
`disposition` reports what happened: `started` or `steered` with a `turnId`,
|
|
242
|
+
or `queued` without one. A queued follow-up starts after the active turn ends,
|
|
243
|
+
including when that turn is interrupted, and appears in `threads read` once it
|
|
244
|
+
starts. Take `<active-turn-id>` from the thread's `activeTurnId` in
|
|
245
|
+
`threads list`.
|
|
246
|
+
|
|
247
|
+
A Claude terminal that a person is using stays off limits: the send returns
|
|
248
|
+
`thread_controlled_elsewhere` and doesn't take over that terminal. Retry an
|
|
249
|
+
uncertain result only with the same key and identical arguments, including
|
|
250
|
+
`--delivery` and `--turn`. `operation_indeterminate` means the request may
|
|
251
|
+
have reached the agent and must not be submitted again under a new key.
|
|
235
252
|
|
|
236
253
|
Wait for one exact turn without polling the devbox:
|
|
237
254
|
|
|
@@ -24,6 +24,10 @@ The workbench has a few persistent areas:
|
|
|
24
24
|
- The left pane lists threads, integrations, automations, Project URLs, an
|
|
25
25
|
expandable Settings section, and the Template box when that project has one.
|
|
26
26
|
Your account identity and a Help button stay pinned at the bottom.
|
|
27
|
+
If you haven't signed in to the mobile app, a **Code on the go!** banner
|
|
28
|
+
appears above your account. Scan its QR code to download the mobile app, or
|
|
29
|
+
select **X** to dismiss it for this account on this computer. Signing in on
|
|
30
|
+
mobile will also hide the banner.
|
|
27
31
|
- The detail pane shows the selected thread, Project settings, an integration,
|
|
28
32
|
an automation editor, or the Template box page when available.
|
|
29
33
|
- The Terminal, Files, Git/Review, and Browser panes can be shown next to the
|
|
@@ -42,12 +46,16 @@ closes the pane.
|
|
|
42
46
|
## Accounts
|
|
43
47
|
|
|
44
48
|
The desktop app can stay signed in to more than one boxes.dev account, such as
|
|
45
|
-
a personal account and a work account.
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
49
|
+
a personal account and a work account. **Add another account** opens Google
|
|
50
|
+
sign-in in your browser while the current account stays open, then switches to
|
|
51
|
+
the new account once sign-in finishes. With only one account signed in, it
|
|
52
|
+
appears directly in the account menu at the bottom of the left pane.
|
|
53
|
+
|
|
54
|
+
Once more than one account is signed in, the account menu shows **Switch
|
|
55
|
+
account** in its place. That submenu lists every signed-in account, with a
|
|
56
|
+
check beside the current one; click another account to switch. The workbench
|
|
57
|
+
will open that account's last project; there is no new sign-in. **Add another
|
|
58
|
+
account** moves to the bottom of that submenu.
|
|
51
59
|
|
|
52
60
|
**Log out** (or **Sign Out** in the app menu) signs out only the current
|
|
53
61
|
account. If another account is still signed in, the app switches to it, and
|
|
@@ -59,7 +67,8 @@ setup screen offers the same switch, add, and log out choices.
|
|
|
59
67
|
|
|
60
68
|
Desktop notifications, the unread count, ports, and terminals follow the
|
|
61
69
|
account that is open. Switching accounts requires a current desktop app
|
|
62
|
-
version; older versions
|
|
70
|
+
version; older versions show neither **Add another account** nor **Switch
|
|
71
|
+
account**.
|
|
63
72
|
|
|
64
73
|
## Right-Click Menus
|
|
65
74
|
|
|
@@ -127,6 +136,12 @@ Terminal and Browser tabs (while that pane is focused):
|
|
|
127
136
|
- Close terminal tab: **Cmd+W** (Ctrl+Shift+W)
|
|
128
137
|
- Previous / next tab: **Cmd+[** / **Cmd+]** (Ctrl+Shift+Tab / Ctrl+Tab)
|
|
129
138
|
|
|
139
|
+
Files (while the Files pane has focus):
|
|
140
|
+
|
|
141
|
+
- Go to line in the open file: **Ctrl+G** on every platform, matching VS
|
|
142
|
+
Code. macOS uses Control here, not Cmd. A focused terminal keeps Ctrl+G for
|
|
143
|
+
the shell.
|
|
144
|
+
|
|
130
145
|
Help:
|
|
131
146
|
|
|
132
147
|
- Show keyboard shortcuts: **Cmd+Shift+/** (Ctrl+Shift+/)
|
|
@@ -304,6 +319,20 @@ SVG. A diagram loads after the agent finishes its code block; if it cannot be
|
|
|
304
319
|
rendered, the source remains visible. Mobile chats also show diagrams with
|
|
305
320
|
source copy and an expanded preview.
|
|
306
321
|
|
|
322
|
+
An agent can also publish an interactive visual, such as a chart or a small
|
|
323
|
+
simulation with controls, when one would explain something better than text.
|
|
324
|
+
The visual appears in place of its link in the agent's final reply. The desktop
|
|
325
|
+
and mobile apps run it automatically, while a web browser waits until the
|
|
326
|
+
reader chooses **Show visual**. Its controls open it in a browser, expand it,
|
|
327
|
+
or hide it. Hiding a visual keeps it hidden for that viewer on that device,
|
|
328
|
+
including after the thread is reopened, until they choose **Show visual**.
|
|
329
|
+
Changes made inside a visual last only while it stays on screen: scrolling far
|
|
330
|
+
away or reopening the thread starts it fresh, and so does the mobile app's
|
|
331
|
+
**Expand**. Published visuals don't depend on the devbox, so they keep working
|
|
332
|
+
after it sleeps. Older app versions, Slack, and copied transcripts show the
|
|
333
|
+
ordinary link. See `onbox-agent-tools.md` for the commands agents use to
|
|
334
|
+
publish visuals.
|
|
335
|
+
|
|
307
336
|
Claude's active and recently finished subagents appear above the composer.
|
|
308
337
|
Open an agent from that list or its launch card to read its transcript, and use
|
|
309
338
|
**Back** or **Escape** to return to the parent thread and focus its composer.
|
|
@@ -52,6 +52,12 @@ selection and keeps the nearest document section in view. Review comments stay
|
|
|
52
52
|
visible on their selected sentence or beside the corresponding rendered block
|
|
53
53
|
in Preview.
|
|
54
54
|
|
|
55
|
+
To jump to a line in a text file, choose Go to line from the file's **...**
|
|
56
|
+
menu, or press **Ctrl+G** while the Files pane has focus. Ctrl+G is the default
|
|
57
|
+
on every platform, including macOS, matching VS Code. Type a line number and
|
|
58
|
+
press Enter; Escape closes the prompt and returns to where you were. Go to line
|
|
59
|
+
isn't available in Markdown Preview or for media and PDF previews.
|
|
60
|
+
|
|
55
61
|
The file header shows the selected file name, path, file size, and modified
|
|
56
62
|
time when available. Use Download to copy the selected file from the runtime to
|
|
57
63
|
your computer. After a download finishes, use Open in Finder in the confirmation
|
|
@@ -448,7 +448,7 @@ The request values are `create-devboxes-and-threads`,
|
|
|
448
448
|
`create-team-templates`, `update-thread-titles`,
|
|
449
449
|
`move-devboxes-to-folders`, `create-devbox-folders`,
|
|
450
450
|
`edit-devbox-lifecycle`, `edit-template-maintenance`, `destroy-devbox`,
|
|
451
|
-
`read-project-threads`, `read-user-threads`, `read-shared-threads`,
|
|
451
|
+
`destroy-created-devboxes`, `read-project-threads`, `read-user-threads`, `read-shared-threads`,
|
|
452
452
|
`read-team-threads`, `message-agents`, `edit-template-box`,
|
|
453
453
|
`edit-team-template`, `edit-personal-environment`, and `edit-automations`.
|
|
454
454
|
Add `--json` for a stable structured result.
|
|
@@ -550,6 +550,36 @@ When a user-required title change returns `title_editing_disabled`, request
|
|
|
550
550
|
only `update-thread-titles` through the Agent permissions command above. Do not
|
|
551
551
|
request it merely to perform an optional rename after unrelated work.
|
|
552
552
|
|
|
553
|
+
## Inline Visuals
|
|
554
|
+
|
|
555
|
+
A managed Codex or Claude agent can publish a self-contained interactive HTML
|
|
556
|
+
visual that boxes.dev shows inside its final answer. The
|
|
557
|
+
`boxes-inline-visualizations` skill has the authoring workflow, rendering
|
|
558
|
+
rules, and an example; read it before making a visual.
|
|
559
|
+
|
|
560
|
+
```bash
|
|
561
|
+
dvb-onbox visuals preview --file /tmp/visuals/latency/index.html --output-dir /tmp/visuals/latency/preview --json
|
|
562
|
+
dvb-onbox visuals publish --file /tmp/visuals/latency/index.html --title "Queue latency near capacity"
|
|
563
|
+
dvb-onbox visuals read --id vis_<id> --output /tmp/visuals/latency/index.html --json
|
|
564
|
+
```
|
|
565
|
+
|
|
566
|
+
`preview` renders the visual once in a private browser on the box and writes
|
|
567
|
+
one screenshot with console, blocked-load, and layout diagnostics. It runs
|
|
568
|
+
entirely on the box and publishes nothing. `publish` inlines the HTML file's
|
|
569
|
+
local classic scripts, stylesheets, and images into one document of at most 5
|
|
570
|
+
MiB, uploads it, and prints a Markdown link only after the upload succeeds. The
|
|
571
|
+
visual appears only when that link stands alone in a paragraph of the final
|
|
572
|
+
answer. Each publish creates a new permanent visual, so earlier answers never
|
|
573
|
+
change; revise by running `read`, editing the saved file, and publishing again.
|
|
574
|
+
`read` works for visuals owned by the user who owns the current thread.
|
|
575
|
+
|
|
576
|
+
The commands take no owner or thread selector: the current managed thread
|
|
577
|
+
determines the owner. Publishing does not share the thread; who can open a
|
|
578
|
+
visual follows its owner and thread sharing. Readers' apps block ordinary
|
|
579
|
+
remote loads and connections from a visual, including this box's ports. If
|
|
580
|
+
`visuals` is missing from `dvb-onbox --help` or returns
|
|
581
|
+
`daemon_update_required`, the box has not received this capability yet.
|
|
582
|
+
|
|
553
583
|
## Current-Box Public Links
|
|
554
584
|
|
|
555
585
|
An agent or shell script can create and remove an HTTPS public link for an
|
|
@@ -825,7 +855,8 @@ devboxes and threads** permission is checked on every observation and control.
|
|
|
825
855
|
Prompt files are limited to 32 KiB.
|
|
826
856
|
|
|
827
857
|
Delegation does not grant destruction permission or access to unrelated
|
|
828
|
-
threads.
|
|
858
|
+
threads. To clean up a devbox created this way, see
|
|
859
|
+
[Destroy And Archive Created Devboxes](#destroy-and-archive-created-devboxes). Read-only thread and project discovery has its own permission below.
|
|
829
860
|
`dvb-onbox` does not expose arbitrary direct exec, services, or generic machine
|
|
830
861
|
management. The current-box public link commands above are its only port-control
|
|
831
862
|
surface.
|
|
@@ -876,6 +907,12 @@ boxes.dev thread link, or the thread's Codex thread ID or Claude session ID.
|
|
|
876
907
|
Listings and reads report that agent ID as `nativeThreadId`. If an agent ID
|
|
877
908
|
matches more than one thread you can read, use the thread's `id` instead.
|
|
878
909
|
|
|
910
|
+
**Copy thread ID** in a teammate thread's `…` menu copies an ID for
|
|
911
|
+
`read --thread`. A `tsh_...` ID, copied from a share-link page, needs
|
|
912
|
+
`--scope shared`. A `thr_...` ID works with `--scope shared` when the user
|
|
913
|
+
opened that thread's invitation link, and with `--scope team` when team
|
|
914
|
+
settings allow reading it.
|
|
915
|
+
|
|
879
916
|
Reads return stored visible user/assistant messages with older-page cursors.
|
|
880
917
|
They may lag active work and shorten long messages. They do not wake boxes,
|
|
881
918
|
mark threads read, claim links, or expose full tool logs. Without `--scope`,
|
|
@@ -972,8 +1009,10 @@ archive** under **Agent permissions for this project** in Project settings.
|
|
|
972
1009
|
The project setting applies to existing and future devboxes without an
|
|
973
1010
|
individual override. After a `destruction_disabled` error, request
|
|
974
1011
|
`destroy-devbox`; the owner can choose **Allow** or **Always allow for project**.
|
|
975
|
-
Either way, agents
|
|
976
|
-
and other devboxes cannot be targeted.
|
|
1012
|
+
Either way, this permission lets agents destroy only their own ordinary devbox.
|
|
1013
|
+
Template boxes and other devboxes cannot be targeted. To destroy devboxes that
|
|
1014
|
+
agents on this box created, see
|
|
1015
|
+
[Destroy And Archive Created Devboxes](#destroy-and-archive-created-devboxes).
|
|
977
1016
|
|
|
978
1017
|
Destruction permanently deletes the devbox's files and retains its thread
|
|
979
1018
|
history. Run this only when the user's task calls for destroying the devbox,
|
|
@@ -996,10 +1035,66 @@ dvb-onbox box cancel-destroy --json
|
|
|
996
1035
|
```
|
|
997
1036
|
|
|
998
1037
|
Any managed agent on the same devbox can cancel its pending request without
|
|
999
|
-
the destruction permission
|
|
1038
|
+
the destruction permission, including a request made by the box that created
|
|
1039
|
+
the devbox. The command returns `cancelled`, or `not_pending`
|
|
1000
1040
|
with a null `requestId` if there is nothing to cancel. Once archival has
|
|
1001
1041
|
started, it returns `destruction_started`; it cannot undo that handoff.
|
|
1002
1042
|
|
|
1043
|
+
## Destroy And Archive Created Devboxes
|
|
1044
|
+
|
|
1045
|
+
An agent on a Template box or devbox can request destruction of an ordinary
|
|
1046
|
+
devbox that an agent on the same box created with
|
|
1047
|
+
`dvb-onbox threads start --target new-devbox`:
|
|
1048
|
+
|
|
1049
|
+
```bash
|
|
1050
|
+
dvb-onbox box destroy --devbox <devbox-id> --json
|
|
1051
|
+
```
|
|
1052
|
+
|
|
1053
|
+
Use the `devboxId` returned by `threads start`. The separate **Destroy and
|
|
1054
|
+
archive created devboxes** permission on the requesting box is off by default.
|
|
1055
|
+
Enable it in the thread header's **Agent permissions**, or under **Agent
|
|
1056
|
+
permissions for this project** in Project settings. After a
|
|
1057
|
+
`destruction_disabled` error, request `destroy-created-devboxes`; the owner can
|
|
1058
|
+
choose **Allow** or **Always allow for project**. This permission is
|
|
1059
|
+
independent of **Create devboxes and threads** and of the created devbox's own
|
|
1060
|
+
**Destroy and archive this devbox** permission, and any agent on the
|
|
1061
|
+
requesting box can use it. Devboxes created by another box, devboxes where this
|
|
1062
|
+
box only started a thread, devboxes created by a created devbox, devboxes
|
|
1063
|
+
created by restoring an archived thread, and Template boxes return
|
|
1064
|
+
`devbox_not_found`.
|
|
1065
|
+
|
|
1066
|
+
Run this only when the user's task calls for it, such as after the devbox's
|
|
1067
|
+
work has merged or has otherwise been preserved outside the machine.
|
|
1068
|
+
Destruction permanently deletes the devbox's files and retains its thread
|
|
1069
|
+
history.
|
|
1070
|
+
|
|
1071
|
+
The request waits for every agent and queued message on that devbox to finish,
|
|
1072
|
+
and boxes.dev wakes a sleeping devbox to archive it. New work submitted to the
|
|
1073
|
+
devbox before destruction starts cancels the request, as does turning off the
|
|
1074
|
+
permission on the requesting box. A request that stays pending for 30 minutes
|
|
1075
|
+
expires. If the devbox already has a pending request, including one it made for
|
|
1076
|
+
itself, the command returns `already_requested` with that request's ID. Pending
|
|
1077
|
+
requests are also cancelled if the requesting box is destroyed first, so a box
|
|
1078
|
+
that will destroy itself should first wait until its created devboxes are
|
|
1079
|
+
archived.
|
|
1080
|
+
|
|
1081
|
+
`accepted` means only that the request was saved. `threads list
|
|
1082
|
+
--include-archived` shows the devbox's thread as archived once its history is
|
|
1083
|
+
saved and deletion of the machine has started; that does not prove the machine
|
|
1084
|
+
is gone. Listing delegated threads still requires **Create devboxes and
|
|
1085
|
+
threads**.
|
|
1086
|
+
|
|
1087
|
+
To withdraw a pending request, run:
|
|
1088
|
+
|
|
1089
|
+
```bash
|
|
1090
|
+
dvb-onbox box cancel-destroy --devbox <devbox-id> --json
|
|
1091
|
+
```
|
|
1092
|
+
|
|
1093
|
+
Cancellation does not require a destroy permission and also withdraws a
|
|
1094
|
+
request the devbox made for itself. It returns `cancelled`, or `not_pending`
|
|
1095
|
+
with a null `requestId` if there is nothing to cancel. Once archival has
|
|
1096
|
+
started, it returns `destruction_started`.
|
|
1097
|
+
|
|
1003
1098
|
## Devbox Folders
|
|
1004
1099
|
|
|
1005
1100
|
Project folders group whole ordinary devboxes in the desktop thread list. They
|
|
@@ -942,13 +942,16 @@ history, and the CLI, but does not grant access or save the thread by itself.
|
|
|
942
942
|
It always applies the current team policy, privacy setting, and share access.
|
|
943
943
|
On a shared-thread browser page, choose **Open in app** to open the same
|
|
944
944
|
read-only thread in the desktop app, or in the mobile app when viewed on a
|
|
945
|
-
phone or tablet.
|
|
945
|
+
phone or tablet. If the viewer has never signed in to that app, the button
|
|
946
|
+
opens a page with a download option instead.
|
|
946
947
|
|
|
947
|
-
To save an ordinary Team work thread, choose **Pin to my workbench**. A
|
|
948
|
-
|
|
949
|
-
|
|
950
|
-
|
|
951
|
-
|
|
948
|
+
To save an ordinary Team work thread, choose **Pin to my workbench**. A
|
|
949
|
+
teammate's thread has a `…` menu in its header and on its **Shared with me**
|
|
950
|
+
row. Choose **Remove from Shared with me** there to remove the row without
|
|
951
|
+
revoking access; opening the same active share link or pinning the thread
|
|
952
|
+
again restores it. Choose **Copy thread ID** to give the thread to an agent
|
|
953
|
+
that has permission to read other threads. Read and unread state is personal
|
|
954
|
+
to each viewer and does not change the owner's state.
|
|
952
955
|
|
|
953
956
|
Under **Thread titles**, a teammate can choose **Request access**. On desktop,
|
|
954
957
|
the project sidebar's **Shared by me** section appears whenever the selected
|
|
@@ -983,6 +986,13 @@ snapshot. A missing file shows **File not found**; a destroyed or unreachable
|
|
|
983
986
|
source shows **Image unavailable**. Other local file links do not grant
|
|
984
987
|
workspace access.
|
|
985
988
|
|
|
989
|
+
Teammates who can read a thread also see the interactive visuals that the
|
|
990
|
+
owner's agents published in its replies, without starting the source devbox.
|
|
991
|
+
A visual's link opened on its own works for the owner and for people who can
|
|
992
|
+
currently read the thread where it was published. Copying the link into a
|
|
993
|
+
teammate's thread, another conversation, or Slack does not give anyone else
|
|
994
|
+
access.
|
|
995
|
+
|
|
986
996
|
## Thread Actions
|
|
987
997
|
|
|
988
998
|
The thread action menu can include:
|
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.1059",
|
|
4
4
|
"description": "Runtime for the boxes.dev CLI. Install @boxes-dev/dvb to use the CLI.",
|
|
5
5
|
"homepage": "https://boxes.dev",
|
|
6
6
|
"type": "module",
|
|
@@ -77,5 +77,5 @@
|
|
|
77
77
|
"e2b": "^2.18.0",
|
|
78
78
|
"ink-testing-library": "^4.0.0"
|
|
79
79
|
},
|
|
80
|
-
"devboxReleasedAt": "2026-10-
|
|
80
|
+
"devboxReleasedAt": "2026-10-08T01:46:54Z"
|
|
81
81
|
}
|