@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/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]="103c9c31-b3d3-5dbb-99d6-74c72d0d05a1")}catch(e){}}();
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.1057";
64671
- const rawGitSha = "9db607079c0ebc4b2607564d3c7666b8e10f0356";
64672
- const rawSentryRelease = "boxes-dev-dvb@1.0.1057+9db607079c0ebc4b2607564d3c7666b8e10f0356";
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.1057";
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=103c9c31-b3d3-5dbb-99d6-74c72d0d05a1
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 only when the canonical thread is idle:
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
- Agent sends never queue, steer, interrupt, or wait. An active turn returns a
230
- durable failed operation with `thread_busy`. A thread owned by a native Claude
231
- terminal returns `thread_controlled_elsewhere`; the command does not evict or
232
- take over that terminal. Retry an uncertain result only with the same key.
233
- `operation_indeterminate` means the request may have reached the agent and
234
- must not be submitted again under a new key.
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. Read-only thread and project discovery has its own permission below.
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 can destroy only their own ordinary devbox. Template boxes
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. The command returns `cancelled`, or `not_pending`
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
- To save an ordinary Team work thread, choose **Pin to my workbench**. A viewer
948
- can later choose **Remove from Shared with me** without revoking access.
949
- Opening the same active share link or pinning the thread again restores the
950
- row. Read and unread state is personal to each viewer and does not change the
951
- owner's state.
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.1057",
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-06T16:15:59Z"
80
+ "devboxReleasedAt": "2026-10-07T21:45:14Z"
81
81
  }