@boxes-dev/dvb-runtime 1.0.1057 → 1.0.1058
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 +4 -0
- package/dist/product-docs/references/onbox-agent-tools.md +70 -5
- package/dist/product-docs/references/threads-and-agents.md +10 -7
- 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.1058";
|
|
64678
|
+
const rawGitSha = "9ffbfb9429091920831dcdea454c86b1db35ea19";
|
|
64679
|
+
const rawSentryRelease = "boxes-dev-dvb@1.0.1058+9ffbfb9429091920831dcdea454c86b1db35ea19";
|
|
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.1058";
|
|
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
|
|
@@ -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.
|
|
@@ -825,7 +825,8 @@ devboxes and threads** permission is checked on every observation and control.
|
|
|
825
825
|
Prompt files are limited to 32 KiB.
|
|
826
826
|
|
|
827
827
|
Delegation does not grant destruction permission or access to unrelated
|
|
828
|
-
threads.
|
|
828
|
+
threads. To clean up a devbox created this way, see
|
|
829
|
+
[Destroy And Archive Created Devboxes](#destroy-and-archive-created-devboxes). Read-only thread and project discovery has its own permission below.
|
|
829
830
|
`dvb-onbox` does not expose arbitrary direct exec, services, or generic machine
|
|
830
831
|
management. The current-box public link commands above are its only port-control
|
|
831
832
|
surface.
|
|
@@ -876,6 +877,12 @@ boxes.dev thread link, or the thread's Codex thread ID or Claude session ID.
|
|
|
876
877
|
Listings and reads report that agent ID as `nativeThreadId`. If an agent ID
|
|
877
878
|
matches more than one thread you can read, use the thread's `id` instead.
|
|
878
879
|
|
|
880
|
+
**Copy thread ID** in a teammate thread's `…` menu copies an ID for
|
|
881
|
+
`read --thread`. A `tsh_...` ID, copied from a share-link page, needs
|
|
882
|
+
`--scope shared`. A `thr_...` ID works with `--scope shared` when the user
|
|
883
|
+
opened that thread's invitation link, and with `--scope team` when team
|
|
884
|
+
settings allow reading it.
|
|
885
|
+
|
|
879
886
|
Reads return stored visible user/assistant messages with older-page cursors.
|
|
880
887
|
They may lag active work and shorten long messages. They do not wake boxes,
|
|
881
888
|
mark threads read, claim links, or expose full tool logs. Without `--scope`,
|
|
@@ -972,8 +979,10 @@ archive** under **Agent permissions for this project** in Project settings.
|
|
|
972
979
|
The project setting applies to existing and future devboxes without an
|
|
973
980
|
individual override. After a `destruction_disabled` error, request
|
|
974
981
|
`destroy-devbox`; the owner can choose **Allow** or **Always allow for project**.
|
|
975
|
-
Either way, agents
|
|
976
|
-
and other devboxes cannot be targeted.
|
|
982
|
+
Either way, this permission lets agents destroy only their own ordinary devbox.
|
|
983
|
+
Template boxes and other devboxes cannot be targeted. To destroy devboxes that
|
|
984
|
+
agents on this box created, see
|
|
985
|
+
[Destroy And Archive Created Devboxes](#destroy-and-archive-created-devboxes).
|
|
977
986
|
|
|
978
987
|
Destruction permanently deletes the devbox's files and retains its thread
|
|
979
988
|
history. Run this only when the user's task calls for destroying the devbox,
|
|
@@ -996,10 +1005,66 @@ dvb-onbox box cancel-destroy --json
|
|
|
996
1005
|
```
|
|
997
1006
|
|
|
998
1007
|
Any managed agent on the same devbox can cancel its pending request without
|
|
999
|
-
the destruction permission
|
|
1008
|
+
the destruction permission, including a request made by the box that created
|
|
1009
|
+
the devbox. The command returns `cancelled`, or `not_pending`
|
|
1000
1010
|
with a null `requestId` if there is nothing to cancel. Once archival has
|
|
1001
1011
|
started, it returns `destruction_started`; it cannot undo that handoff.
|
|
1002
1012
|
|
|
1013
|
+
## Destroy And Archive Created Devboxes
|
|
1014
|
+
|
|
1015
|
+
An agent on a Template box or devbox can request destruction of an ordinary
|
|
1016
|
+
devbox that an agent on the same box created with
|
|
1017
|
+
`dvb-onbox threads start --target new-devbox`:
|
|
1018
|
+
|
|
1019
|
+
```bash
|
|
1020
|
+
dvb-onbox box destroy --devbox <devbox-id> --json
|
|
1021
|
+
```
|
|
1022
|
+
|
|
1023
|
+
Use the `devboxId` returned by `threads start`. The separate **Destroy and
|
|
1024
|
+
archive created devboxes** permission on the requesting box is off by default.
|
|
1025
|
+
Enable it in the thread header's **Agent permissions**, or under **Agent
|
|
1026
|
+
permissions for this project** in Project settings. After a
|
|
1027
|
+
`destruction_disabled` error, request `destroy-created-devboxes`; the owner can
|
|
1028
|
+
choose **Allow** or **Always allow for project**. This permission is
|
|
1029
|
+
independent of **Create devboxes and threads** and of the created devbox's own
|
|
1030
|
+
**Destroy and archive this devbox** permission, and any agent on the
|
|
1031
|
+
requesting box can use it. Devboxes created by another box, devboxes where this
|
|
1032
|
+
box only started a thread, devboxes created by a created devbox, devboxes
|
|
1033
|
+
created by restoring an archived thread, and Template boxes return
|
|
1034
|
+
`devbox_not_found`.
|
|
1035
|
+
|
|
1036
|
+
Run this only when the user's task calls for it, such as after the devbox's
|
|
1037
|
+
work has merged or has otherwise been preserved outside the machine.
|
|
1038
|
+
Destruction permanently deletes the devbox's files and retains its thread
|
|
1039
|
+
history.
|
|
1040
|
+
|
|
1041
|
+
The request waits for every agent and queued message on that devbox to finish,
|
|
1042
|
+
and boxes.dev wakes a sleeping devbox to archive it. New work submitted to the
|
|
1043
|
+
devbox before destruction starts cancels the request, as does turning off the
|
|
1044
|
+
permission on the requesting box. A request that stays pending for 30 minutes
|
|
1045
|
+
expires. If the devbox already has a pending request, including one it made for
|
|
1046
|
+
itself, the command returns `already_requested` with that request's ID. Pending
|
|
1047
|
+
requests are also cancelled if the requesting box is destroyed first, so a box
|
|
1048
|
+
that will destroy itself should first wait until its created devboxes are
|
|
1049
|
+
archived.
|
|
1050
|
+
|
|
1051
|
+
`accepted` means only that the request was saved. `threads list
|
|
1052
|
+
--include-archived` shows the devbox's thread as archived once its history is
|
|
1053
|
+
saved and deletion of the machine has started; that does not prove the machine
|
|
1054
|
+
is gone. Listing delegated threads still requires **Create devboxes and
|
|
1055
|
+
threads**.
|
|
1056
|
+
|
|
1057
|
+
To withdraw a pending request, run:
|
|
1058
|
+
|
|
1059
|
+
```bash
|
|
1060
|
+
dvb-onbox box cancel-destroy --devbox <devbox-id> --json
|
|
1061
|
+
```
|
|
1062
|
+
|
|
1063
|
+
Cancellation does not require a destroy permission and also withdraws a
|
|
1064
|
+
request the devbox made for itself. It returns `cancelled`, or `not_pending`
|
|
1065
|
+
with a null `requestId` if there is nothing to cancel. Once archival has
|
|
1066
|
+
started, it returns `destruction_started`.
|
|
1067
|
+
|
|
1003
1068
|
## Devbox Folders
|
|
1004
1069
|
|
|
1005
1070
|
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.
|
|
946
|
-
|
|
947
|
-
|
|
948
|
-
|
|
949
|
-
|
|
950
|
-
row.
|
|
951
|
-
|
|
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.
|
|
947
|
+
|
|
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
|
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.1058",
|
|
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-07T21:45:14Z"
|
|
81
81
|
}
|