@boxes-dev/dvb-runtime 1.0.1107 → 1.0.1109

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 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]="62cd5d5e-6100-5fad-a871-e2786b5c3d57")}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]="978460d9-199a-590d-8ec9-93f70fc1cb62")}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";
@@ -70400,9 +70400,9 @@ var init_sentry = __esm({
70400
70400
  uncaughtExceptionMonitorInstalled = false;
70401
70401
  currentDevboxSentryUser = null;
70402
70402
  readBuildMetadata = () => {
70403
- const rawPackageVersion = "1.0.1107";
70404
- const rawGitSha = "636b188006eb986b8be609e74b6a73eb93bc3eb4";
70405
- const rawSentryRelease = "boxes-dev-dvb@1.0.1107+636b188006eb986b8be609e74b6a73eb93bc3eb4";
70403
+ const rawPackageVersion = "1.0.1109";
70404
+ const rawGitSha = "7444b83f1846d03a8b6ae40cc96fcd9586b12ff4";
70405
+ const rawSentryRelease = "boxes-dev-dvb@1.0.1109+7444b83f1846d03a8b6ae40cc96fcd9586b12ff4";
70406
70406
  const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
70407
70407
  const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
70408
70408
  const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
@@ -76046,7 +76046,7 @@ var init_packageVersion = __esm({
76046
76046
  return path18.join(process.cwd(), "dvb");
76047
76047
  };
76048
76048
  readEmbeddedPackageVersion = () => {
76049
- const raw = "1.0.1107";
76049
+ const raw = "1.0.1109";
76050
76050
  return trimVersion(raw);
76051
76051
  };
76052
76052
  readNearestPackageMetadata = (basePath) => {
@@ -141544,12 +141544,14 @@ var init_threadInventoryBuilder = __esm({
141544
141544
  devboxFolderId: null,
141545
141545
  devboxFolderRevision: 0,
141546
141546
  devboxName: null,
141547
+ startedByExecutionInstanceId: null,
141547
141548
  ownsForkPlacement: false,
141548
141549
  forkOperationId: null,
141549
141550
  isFork: false,
141550
141551
  forkState: null,
141551
141552
  forkPlacementArchived: false,
141552
141553
  forkProgressStage: null,
141554
+ forkSlowStartReason: null,
141553
141555
  forkExecutionStatusTone: null,
141554
141556
  forkBaseCommitSha: null,
141555
141557
  forkRepoChangedFileCount: null,
@@ -141676,12 +141678,16 @@ var init_threadInventoryBuilder = __esm({
141676
141678
  placement.devboxFolderRevision
141677
141679
  );
141678
141680
  row.devboxName = normalizeText2(placement.devboxName);
141681
+ row.startedByExecutionInstanceId = normalizeText2(
141682
+ placement.startedByExecutionInstanceId
141683
+ );
141679
141684
  row.ownsForkPlacement = ownsForkPlacement;
141680
141685
  row.forkOperationId = placement.operationId;
141681
141686
  row.isFork = true;
141682
141687
  row.forkState = placement.state;
141683
141688
  row.forkPlacementArchived = placement.archivedAt !== null;
141684
141689
  row.forkProgressStage = placement.progressStage;
141690
+ row.forkSlowStartReason = placement.slowStartReason;
141685
141691
  row.forkMode = placement.mode;
141686
141692
  row.forkBaseCommitSha = normalizeText2(placement.forkBaseCommitSha);
141687
141693
  row.forkRepoChangedFileCount = placement.repoChangedFileCount ?? null;
@@ -142642,12 +142648,39 @@ var init_threadCreateActions = __esm({
142642
142648
  }
142643
142649
  });
142644
142650
 
142651
+ // ../../../../shared/threadRuntime/threadSlowStartReason.ts
142652
+ var formatThreadSlowStartReason;
142653
+ var init_threadSlowStartReason = __esm({
142654
+ "../../../../shared/threadRuntime/threadSlowStartReason.ts"() {
142655
+ "use strict";
142656
+ formatThreadSlowStartReason = (reason) => {
142657
+ switch (reason) {
142658
+ case "fresh_snapshot":
142659
+ return "Slower start: fresh snapshot";
142660
+ case "prepared_devbox_failed":
142661
+ return "Slower start: a prepared devbox failed";
142662
+ case "prepared_devboxes_in_use":
142663
+ return "Slower start: prepared devboxes in use";
142664
+ case "prepared_devboxes_updating":
142665
+ return "Slower start: updating prepared devboxes";
142666
+ case "new_snapshot":
142667
+ return "Slower start: very recent snapshot";
142668
+ case "new_team_template_version":
142669
+ return "Slower start: very recent saved version";
142670
+ case "prepared_devboxes_not_ready":
142671
+ return "Slower start: no prepared devbox ready";
142672
+ }
142673
+ };
142674
+ }
142675
+ });
142676
+
142645
142677
  // ../../../../shared/threadRuntime/threadStartProgress.ts
142646
142678
  var TOTAL_STEPS, resolveConnectingLabel, resolveProgressStage, getForkThreadStartProgress;
142647
142679
  var init_threadStartProgress = __esm({
142648
142680
  "../../../../shared/threadRuntime/threadStartProgress.ts"() {
142649
142681
  "use strict";
142650
142682
  init_threadBackendLabels();
142683
+ init_threadSlowStartReason();
142651
142684
  TOTAL_STEPS = 6;
142652
142685
  resolveConnectingLabel = (backend) => formatThreadBackendConnectingLabel(backend);
142653
142686
  resolveProgressStage = ({
@@ -142666,7 +142699,7 @@ var init_threadStartProgress = __esm({
142666
142699
  backend,
142667
142700
  placementStage,
142668
142701
  localStage,
142669
- isNewThread = false
142702
+ slowStartReason
142670
142703
  }) => {
142671
142704
  const stage = resolveProgressStage({ placementStage, localStage });
142672
142705
  if (!stage) {
@@ -142697,7 +142730,7 @@ var init_threadStartProgress = __esm({
142697
142730
  case "copying_state":
142698
142731
  return {
142699
142732
  stage,
142700
- label: isNewThread ? "Starting from a very recent Template box snapshot may take longer than usual." : "Copying box state",
142733
+ label: slowStartReason ? formatThreadSlowStartReason(slowStartReason) : "Copying box state",
142701
142734
  currentStep: 2,
142702
142735
  totalSteps: TOTAL_STEPS
142703
142736
  };
@@ -143851,7 +143884,9 @@ var init_creationPresentation = __esm({
143851
143884
  const progress = getForkThreadStartProgress({
143852
143885
  backend: status.backend,
143853
143886
  placementStage: status.placementProgressStage,
143854
- localStage
143887
+ localStage,
143888
+ // The agent view status does not carry the reason yet.
143889
+ slowStartReason: null
143855
143890
  });
143856
143891
  if (status.backend === "claude" && (status.attempt?.phase === "starting_thread" || status.attempt?.phase === "awaiting_durability")) {
143857
143892
  return {
@@ -166873,6 +166908,8 @@ var init_managedClaudeThreadCommands = __esm({
166873
166908
  "/cd": "/cd is unavailable in this CLI because it moves this thread's Claude transcript. Use /add-dir to give Claude access to another directory.",
166874
166909
  "/clear": "/clear is unavailable in this CLI because it switches Claude to a new session. Start a new boxes.dev thread instead.",
166875
166910
  "/continue": "/continue is unavailable in this CLI because it switches Claude to a different session. Open that Claude session in its own boxes.dev thread instead.",
166911
+ "/new": "/new is unavailable in this CLI because it switches Claude to a new session. Start a new boxes.dev thread instead.",
166912
+ "/reset": "/reset is unavailable in this CLI because it switches Claude to a new session. Start a new boxes.dev thread instead.",
166876
166913
  "/resume": "/resume is unavailable in this CLI because it switches Claude to a different session. Open that Claude session in its own boxes.dev thread instead.",
166877
166914
  "/teleport": "/teleport is unavailable in this CLI because it moves work into a different Claude session. Open or create that work in its own boxes.dev thread instead.",
166878
166915
  "/tp": "/tp is unavailable in this CLI because it moves work into a different Claude session. Open or create that work in its own boxes.dev thread instead."
@@ -300909,4 +300946,4 @@ react/cjs/react-jsx-runtime.development.js:
300909
300946
  *)
300910
300947
  */
300911
300948
 
300912
- //# debugId=62cd5d5e-6100-5fad-a871-e2786b5c3d57
300949
+ //# debugId=978460d9-199a-590d-8ec9-93f70fc1cb62
package/dist/bin/dvbd.mjs CHANGED
@@ -64679,9 +64679,9 @@ var init_sentry = __esm({
64679
64679
  uncaughtExceptionMonitorInstalled = false;
64680
64680
  currentDevboxSentryUser = null;
64681
64681
  readBuildMetadata = () => {
64682
- const rawPackageVersion = "1.0.1107";
64683
- const rawGitSha = "636b188006eb986b8be609e74b6a73eb93bc3eb4";
64684
- const rawSentryRelease = "boxes-dev-dvb@1.0.1107+636b188006eb986b8be609e74b6a73eb93bc3eb4";
64682
+ const rawPackageVersion = "1.0.1109";
64683
+ const rawGitSha = "7444b83f1846d03a8b6ae40cc96fcd9586b12ff4";
64684
+ const rawSentryRelease = "boxes-dev-dvb@1.0.1109+7444b83f1846d03a8b6ae40cc96fcd9586b12ff4";
64685
64685
  const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
64686
64686
  const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
64687
64687
  const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
@@ -67203,7 +67203,7 @@ var init_packageVersion = __esm({
67203
67203
  return path8.join(process.cwd(), "dvb");
67204
67204
  };
67205
67205
  readEmbeddedPackageVersion = () => {
67206
- const raw = "1.0.1107";
67206
+ const raw = "1.0.1109";
67207
67207
  return trimVersion(raw);
67208
67208
  };
67209
67209
  readNearestPackageMetadata = (basePath) => {
@@ -507,7 +507,8 @@ The same menu, including the thread header's menu, offers **Mute
507
507
  notifications**. A muted thread shows a bell-off icon after its title, and its
508
508
  finished turns don't notify you or mark it unread; requests for input still
509
509
  do. **Mark unread** on a muted thread lasts until you open it or its next turn
510
- finishes. **Unmute notifications** turns them back on.
510
+ finishes. **Unmute notifications** turns them back on. A devbox collapses two or
511
+ more muted threads into a slim row below its other threads.
511
512
 
512
513
  Desktop completion notifications are controlled in **Settings > Notifications**:
513
514
 
@@ -129,8 +129,8 @@ explains that an update is needed while file-name search keeps working.
129
129
 
130
130
  ## Uploading Files
131
131
 
132
- Drag files from your computer into the file tree to upload them to the selected
133
- directory. While you drag, Files names the effective destination and highlights
132
+ Drag files or folders from your computer into the file tree to upload them to
133
+ the selected directory. While you drag, Files names the effective destination and highlights
134
134
  the destination folder. Hovering a file means the upload will land beside that
135
135
  file in its parent folder; hovering a folder means it will land inside that
136
136
  folder; hovering a root-level file or empty tree space targets the current tree
@@ -146,6 +146,15 @@ before copying each file onto the box. Free up space or choose fewer files
146
146
  if an upload is blocked. A box awaiting an update may still have the previous
147
147
  1 GiB file limit; retry after its normal automatic update.
148
148
 
149
+ A folder is compressed on your computer, and the box unpacks it at the
150
+ destination. Its row shows Preparing while it compresses. The 5 GiB limit
151
+ applies to the compressed folder, and the box's disk check sees only that
152
+ compressed size. Everything in the folder is included except `.DS_Store` and
153
+ `._*` files, and symbolic links stay as links. If a file or folder with that
154
+ name already exists at the destination, the upload fails and the existing one
155
+ stays as it was. A box awaiting an update keeps the upload as a `.tar.gz` file
156
+ that you or your agent can unpack.
157
+
149
158
  ## Diffs From Files
150
159
 
151
160
  Files is a plain file viewer. It can show Git decorations for changed text
@@ -38,6 +38,14 @@ snapshot and then create the devbox.
38
38
  If an independent project's Template box has changed in a way future devboxes should inherit, take a
39
39
  new snapshot before starting the devbox.
40
40
 
41
+ boxes.dev usually keeps a few devboxes prepared from the current snapshot or
42
+ saved version, so a new thread can start without waiting for a restore. When
43
+ none is ready, the new devbox is restored from the snapshot instead, which can
44
+ take a minute or more. While that happens, the thread shows why: a fresh or
45
+ very recent snapshot or saved version, other new threads already using the
46
+ prepared devboxes, prepared devboxes being updated, a prepared devbox that
47
+ couldn't be used, or none being ready yet.
48
+
41
49
  ### Choose starting branches
42
50
 
43
51
  In a new desktop draft, the **Branch** menu below the composer selects the branch
@@ -86,6 +86,11 @@ Open a project to see its threads. The list can include:
86
86
  desktop app, and a pinned devbox lists under pinned threads instead of its
87
87
  folder;
88
88
  - recent threads;
89
+ - with **Group devboxes started by agents** on in Settings, each devbox an
90
+ agent started, under the devbox that started it. A slim row labeled
91
+ **Devboxes it started** shows their status; tap it to open them. It shows no
92
+ count because the phone may not have loaded all of them, and a devbox whose
93
+ parent has not loaded lists on its own until it does;
89
94
  - devbox groups, with child threads under the devbox and, when the devbox has
90
95
  archived threads, an **Archived threads** list at the end of the group;
91
96
  - an **Archived threads** list at the end of the project for the Template
@@ -138,7 +143,8 @@ The thread-list menu also offers **Mute notifications**. A muted thread shows
138
143
  a bell-off icon on its row, and its finished turns don't send a push
139
144
  notification or mark it unread; requests for input still do. **Mark unread**
140
145
  on a muted thread lasts until you open it or its next turn finishes. **Unmute
141
- notifications** turns them back on.
146
+ notifications** turns them back on. A devbox collapses two or more muted threads
147
+ into a **Muted threads** row below its other threads.
142
148
 
143
149
  ## Session View
144
150
 
@@ -528,6 +534,9 @@ include:
528
534
  - theme, monospace font, and thread text size;
529
535
  - **Sort threads**, the thread list order shared with desktop (see
530
536
  `threads-and-agents.md`, Thread List Organization);
537
+ - **Group devboxes started by agents**, which lists each devbox an agent
538
+ started under the devbox that started it, shared with desktop (see
539
+ `threads-and-agents.md`, Thread List Organization);
531
540
  - **Project view**: **Recent** (the default) lists a project's devboxes by
532
541
  date, and **Folders** groups them into the user's desktop folders. It is
533
542
  saved on the account and applies only to the mobile app; desktop always
@@ -634,8 +643,9 @@ you approve access, the window will close and the agent will show
634
643
  **Connected**; boxes.dev applies the sign-in to all of the project's
635
644
  devboxes, including sleeping ones when they wake. If the app can't receive the
636
645
  sign-in directly, it opens the page in your browser instead. After you
637
- approve, the browser will show a page that can't load; copy that page's full
638
- address, paste it into the app, and tap **Finish sign-in**.
646
+ approve, the browser will show a connection error at a local address. That's
647
+ expected: copy the full address from the address bar, paste it into the app, and
648
+ tap **Finish sign-in**.
639
649
 
640
650
  The MCPs screen requires an updated mobile app; an older installed app needs an
641
651
  app-store update.
@@ -324,12 +324,16 @@ you close the editor; reopen it to apply or discard them.
324
324
  If a remote port cannot be bound locally, the Ports button shows a warning. A
325
325
  row can say that the port is in use locally or is not forwarded.
326
326
 
327
- A row says **privileged port** when the computer refuses its local port. macOS
328
- and Linux normally reserve localhost ports below 1024, such as 80 and 443, for
329
- root, so the desktop app cannot forward to them. For these rows, **Use next
330
- available** searches from 8000 ports higher, such as 8080 for 80 or 8443 for
331
- 443. A project rule that maps the port to a higher local port avoids the
332
- prompt.
327
+ On macOS, the desktop app forwards a localhost port below 1024, such as 80 or
328
+ 443, only when a project rule covers that single port or sets the local port. A
329
+ range rule with **Same locally** does not count. Without such a rule, the port
330
+ stays free for local servers. Linux normally reserves those ports for root, so
331
+ the desktop app cannot forward to them there.
332
+
333
+ A row says **privileged port** when the desktop app cannot open a local port
334
+ below 1024. For these rows, **Use next available** searches from 8000 ports
335
+ higher, such as 8080 for 80 or 8443 for 443. A project rule that maps the port
336
+ to a higher local port avoids the prompt.
333
337
 
334
338
  When available, choose **Use next available** to approve forwarding that remote
335
339
  port to a different local port. The chosen local port stays pinned for the
@@ -346,24 +346,28 @@ from any browser. Choose a project; the page offers the same
346
346
  list, **Add MCP**, agent chips, and row menus, but not **Template-managed
347
347
  MCPs**. To sign in to an OAuth MCP there, choose **Open sign-in page** in the
348
348
  sign-in dialog and approve access in the new tab. The provider will then send
349
- that tab to an address starting with `http://127.0.0.1:` that can't load. Copy
350
- that tab's full address, paste it into the dialog, and choose **Finish
351
- sign-in**. Each sign-in needs to be finished within 10 minutes, and its address
352
- works only once. The dialog also shows the `dvb mcp authorize` command for
353
- people who prefer to sign in from a terminal on their own computer. An MCP that
354
- only a private network can reach can't be signed in from the website; use the
355
- desktop app or `dvb mcp authorize` for it. Sign-in links opened from a Template
356
- box or devbox, for example after `codex mcp add`, will open this page in a
357
- normal browser with that connection's sign-in ready.
349
+ that tab to an address starting with `http://127.0.0.1:`, which will show a
350
+ connection error. That's expected. Copy that tab's full address, paste it into
351
+ the dialog, and choose **Finish sign-in**. Each sign-in needs to be finished
352
+ within 10 minutes, and its address works only once. The dialog also shows the
353
+ `dvb mcp authorize` command for people who prefer to sign in from a terminal on
354
+ their own computer. An MCP that only a private network can reach can't be signed
355
+ in from the website; use the desktop app or `dvb mcp authorize` for it.
356
+
357
+ Sign-in links from a Template box or devbox, for example after `codex mcp add`,
358
+ will open this page in a normal browser with that connection's sign-in ready.
359
+ When you open one from a thread or terminal in the desktop app, it will open
360
+ **Integrations → MCPs** in that connection's project instead. After you approve
361
+ access, the app will finish signing in automatically, with no address to paste.
358
362
 
359
363
  Supported remote HTTP commands are another entry point to the same list. Running
360
364
  a command such as `codex mcp add <name> --url <url>` or `claude mcp add
361
365
  --transport http <name> <url>` in a Template box or devbox creates the central
362
366
  current-project connection. It does not create a separate machine-only copy.
363
367
  When the server uses OAuth, the command will print a boxes.dev sign-in link
364
- and a `dvb mcp authorize` command, and it will try to open the link in your
365
- browser. If the browser doesn't open, open the link yourself, or run that
366
- command in a terminal on your own computer, not on the box. An agent that runs
368
+ and a `dvb mcp authorize` command, and it will try to open the link. If nothing
369
+ opens, open the link yourself, or run that command in a terminal on your own
370
+ computer, not on the box. An agent that runs
367
371
  the command for you will give you the link. To enable both agents, run each
368
372
  agent's setup command with the same name, URL, and authentication details,
369
373
  including any API-key headers.
@@ -678,10 +682,11 @@ the thread may show a start-over path.
678
682
  ## Composer Basics
679
683
 
680
684
  Type a prompt and send it from the composer. The desktop composer supports text
681
- plus file or image attachments when the selected agent and thread state allow
682
- attachments; add files from the attachment menu or by drag-and-drop, and paste
683
- images directly into the composer. The composer can also reference files from
684
- the project when the agent surface supports file search.
685
+ plus file, folder, or image attachments when the selected agent and thread
686
+ state allow attachments; add files or folders from the attachment menu or by
687
+ drag-and-drop, and paste images directly into the composer. The composer can
688
+ also reference files from the project when the agent surface supports file
689
+ search.
685
690
 
686
691
  On mobile, managed Codex and Claude Code conversations support both photos and
687
692
  general files, including ZIP archives, from the composer attachment menu.
@@ -697,6 +702,13 @@ Desktop file attachments are staged into the selected box and can be up to
697
702
  5 GiB each, with up to 10 GiB of active uploads per user at a time. Image
698
703
  attachments still follow the selected agent's image input limits.
699
704
 
705
+ Desktop folder attachments are compressed on the user's computer and unpacked
706
+ into a folder on the selected box, so the agent receives a folder path. A folder
707
+ can be up to 5 GiB after compression. Everything in the folder is included
708
+ except `.DS_Store` and `._*` files, and symbolic links stay links. A box that
709
+ hasn't updated yet receives a `.tar.gz` file instead, which the agent can
710
+ unpack.
711
+
700
712
  For a connected box, boxes.dev checks free disk space before accepting new
701
713
  attachments. Files for a new or sleeping devbox can upload while the box
702
714
  prepares. Free space is checked again before the files are copied onto the
@@ -932,6 +944,13 @@ list leaves out `/model` and `/fast`, which the model menu covers. On desktop, `
932
944
  `/model <model>` switches directly to a known model. Older supported model generations appear
933
945
  under **More models** in the picker.
934
946
 
947
+ `/clear`, `/new`, and `/reset` are unavailable in a Claude thread. The command
948
+ list leaves them out, and desktop, mobile, the CLI, and other agents can't send
949
+ them. Start a new thread to clear Claude's context. A message is refused only
950
+ when one of these names is its first word, so text that mentions them sends
951
+ normally. A custom skill named `clear`, `new`, or `reset` can't run in a thread
952
+ either.
953
+
935
954
  Claude Code's own `/goal` command sets a condition that Claude keeps working
936
955
  toward across turns until it judges the condition met. `/goal <condition>`
937
956
  sets or replaces it, bare `/goal` shows it, and `/goal clear` (or `stop`,
@@ -1140,9 +1159,9 @@ stop the turn first.
1140
1159
 
1141
1160
  A managed Claude Code CLI stays bound to the boxes.dev thread and working
1142
1161
  directory it opened. Claude's Agent View and Remote Control are unavailable in
1143
- that CLI. Commands that would replace or move its session—`/clear`,
1144
- `/resume`, `/continue`, `/branch`, `/teleport`, `/tp`, and `/cd`—are rejected;
1145
- open or create the intended boxes.dev thread instead. Use `/add-dir` when Claude
1162
+ that CLI. Commands that would replace or move its session—`/clear`, `/new`,
1163
+ `/reset`, `/resume`, `/continue`, `/branch`, `/teleport`, `/tp`, and `/cd`—are
1164
+ rejected; open or create the intended boxes.dev thread instead. Use `/add-dir` when Claude
1146
1165
  only needs access to another directory. Session-preserving controls such as
1147
1166
  `/compact`, rewind/checkpoint controls, ordinary subagents, and `/fork` remain
1148
1167
  available. An ordinary `claude` started in a separate machine shell keeps its
@@ -1252,6 +1271,23 @@ The order applies to recent threads, folders, devbox groups, the Template box
1252
1271
  section, and archived threads. Pinned threads keep their own order. In the
1253
1272
  activity orders, each row's time and date group show its last activity.
1254
1273
 
1274
+ **Group devboxes started by agents**, below **Sort threads**, lists each devbox
1275
+ an agent started under the devbox that started it. It is off by default and
1276
+ saved on the account, so every computer and phone follows it. A slim row under
1277
+ the parent shows whether any of those devboxes are working, unread, or need the
1278
+ user, and selecting the row opens them. On desktop the row also counts them.
1279
+ When a devbox started only one, that devbox shows directly under its parent
1280
+ without the row.
1281
+ Devboxes nest under the devbox that started them at every level, and in the
1282
+ main list a group moves up with its newest thread.
1283
+
1284
+ A pinned devbox stays under **Pinned**, and a devbox in a different folder from
1285
+ its parent stays in its folder. A devbox in the same folder as its parent nests
1286
+ under it there. Threads an agent starts on an existing devbox stay on that
1287
+ devbox. If the parent is destroyed, the devboxes it started return to the main
1288
+ list and keep running. Devboxes started from the Template box stay in the main
1289
+ list, as do those started by a coordinator or an automation on desktop.
1290
+
1255
1291
  Rows show status indicators for draft, starting, active, unread, idle, archived,
1256
1292
  and cold-storage states. Devbox rows also show devbox context and devbox runtime
1257
1293
  status where relevant.
@@ -1510,3 +1546,10 @@ pending request for input stays until it is answered. **Mark unread** on a
1510
1546
  muted thread lasts until the thread is opened or its next turn finishes.
1511
1547
  **Unmute notifications** restores normal behavior. The setting belongs to the thread, so desktop,
1512
1548
  mobile, `dvb`, and `dvb-onbox` all show and change the same value.
1549
+
1550
+ When a devbox has two or more muted threads besides its first thread, they
1551
+ collapse into a slim row below its other threads, closed by default. The row
1552
+ shows whether any of them are working, and selecting it opens them. On desktop
1553
+ the row also counts them. A muted thread stays in the main list while it needs
1554
+ input or is unread, and on desktop so does the open thread. The row applies to
1555
+ devboxes in the thread list. The Template box lists its muted threads normally.
@@ -356,9 +356,12 @@ If a visible port is not forwarded because the local port is already in use,
356
356
  use **Use next available** when offered, or stop the local process that is
357
357
  holding the port.
358
358
 
359
- If the row says **privileged port**, the local port is below 1024, and macOS
360
- and Linux normally reserve it for root. Use **Use next available** to forward it
361
- 8000 ports higher, or add a project rule that maps it to a higher local port.
359
+ If the row says **privileged port**, the desktop app could not open a local port
360
+ below 1024. On macOS, add a project rule for that single port, such as 443, to
361
+ use the same local port. Linux normally reserves these ports for root, so that
362
+ rule will not work there. On either system, use **Use next available** to
363
+ forward it 8000 ports higher, or add a project rule that maps it to a higher
364
+ local port.
362
365
 
363
366
  If there are no forwarded ports, make sure the app or service is actually
364
367
  running inside the selected box.
@@ -373,8 +376,13 @@ box is the one that contains the work. Devbox files and Template box files
373
376
  are separate after the devbox is created.
374
377
 
375
378
  If Git can inspect local files but an automatic GitHub fetch, pull, or push is
376
- rejected, use its recovery message. Reconnect the original GitHub account,
377
- restore the user's write access, or grant the App access to that repository.
379
+ rejected, use its recovery message. For a GitHub API rate limit, wait for the
380
+ time shown before retrying the command. If no wait time is available, try
381
+ again later.
382
+
383
+ For an account or repository access error, reconnect the original GitHub
384
+ account, restore the user's write access, or grant the App access to that
385
+ repository.
378
386
  If only a push that changes `.github/workflows` is rejected, use **Update
379
387
  GitHub access** for every affected installation and return to boxes.dev to
380
388
  check again, or use SSH. Ordinary automatic fetch, pull, and push can still
@@ -408,6 +416,10 @@ setup with a valid file.
408
416
 
409
417
  ## GitHub CLI Will Not Authenticate
410
418
 
419
+ If managed `gh` says GitHub's API rate limit was reached, wait for the time
420
+ shown before retrying the command. If no wait time is available, try again
421
+ later.
422
+
411
423
  First confirm that the selected Template box or devbox is awake and ready.
412
424
  First-run desktop setup may already have connected GitHub while leaving its
413
425
  separate CLI checkbox cleared in **Finalize Bundle → GitHub access**. Open
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@boxes-dev/dvb-runtime",
3
- "version": "1.0.1107",
3
+ "version": "1.0.1109",
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-30T06:49:33Z"
80
+ "devboxReleasedAt": "2026-10-31T08:09:38Z"
81
81
  }