@boxes-dev/dvb-runtime 1.0.1102 → 1.0.1104

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
@@ -64675,9 +64675,9 @@ var init_sentry = __esm({
64675
64675
  uncaughtExceptionMonitorInstalled = false;
64676
64676
  currentDevboxSentryUser = null;
64677
64677
  readBuildMetadata = () => {
64678
- const rawPackageVersion = "1.0.1102";
64679
- const rawGitSha = "f5480fcea3e05ded20280167aedfefba3a32d9d1";
64680
- const rawSentryRelease = "boxes-dev-dvb@1.0.1102+f5480fcea3e05ded20280167aedfefba3a32d9d1";
64678
+ const rawPackageVersion = "1.0.1104";
64679
+ const rawGitSha = "7cca6967beed7953102b25e849b5ca609ff8b282";
64680
+ const rawSentryRelease = "boxes-dev-dvb@1.0.1104+7cca6967beed7953102b25e849b5ca609ff8b282";
64681
64681
  const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
64682
64682
  const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
64683
64683
  const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
@@ -67199,7 +67199,7 @@ var init_packageVersion = __esm({
67199
67199
  return path8.join(process.cwd(), "dvb");
67200
67200
  };
67201
67201
  readEmbeddedPackageVersion = () => {
67202
- const raw = "1.0.1102";
67202
+ const raw = "1.0.1104";
67203
67203
  return trimVersion(raw);
67204
67204
  };
67205
67205
  readNearestPackageMetadata = (basePath) => {
@@ -390,9 +390,24 @@ Choose **View run history** from an automation's overflow menu to see every
390
390
  recorded run. Select a run to open its status, timing, trigger, and support
391
391
  details.
392
392
 
393
- The automation detail pane shows last triggered time, last successful run time,
394
- and number of recorded runs. The thread list shows the latest run summary, next
395
- scheduled run when relevant, and reason messages for failed or skipped runs.
393
+ The automation detail pane shows last triggered time, last started time, and
394
+ number of recorded runs. **Last started** records when a run's thread started
395
+ or its prompt was sent, not when the agent finished. The thread list shows the
396
+ latest run summary, next scheduled run when relevant, and reason messages for
397
+ failed or skipped runs.
398
+
399
+ When runs of an active automation have been skipped since its last run
400
+ started, the automation shows a warning dot in the thread list. Its detail
401
+ pane shows how many runs were skipped, when the skipping began, the reason,
402
+ and **Open last run**, which opens the most recent run that started. The
403
+ warning clears once a run starts its thread or its prompt is sent; a run that
404
+ fails to start or has **Unconfirmed** delivery leaves it in place. While a run
405
+ is starting, the thread list shows that run's spinner in place of the dot.
406
+
407
+ Two or more consecutive runs skipped for the same reason appear as one
408
+ expandable row, such as **12 skipped runs**, with the dates they cover. Expand
409
+ the row to list each skipped run. Grouping changes only the thread list; run
410
+ numbers and **View run history** still include every skipped run.
396
411
 
397
412
  Deleting an automation is blocked while it still has recorded runs. Delete the
398
413
  runs first if you need to remove the automation.
@@ -189,6 +189,12 @@ Terminal and Browser tabs (while that pane is focused):
189
189
  - Close terminal tab: **Cmd+W** (Ctrl+Shift+W)
190
190
  - Previous / next tab: **Cmd+[** / **Cmd+]** (Ctrl+Shift+Tab / Ctrl+Tab)
191
191
 
192
+ With a thread selected, Cmd+W (Ctrl+Shift+W on Windows and Linux) closes its
193
+ view and shows **No thread selected**. Reopen it from the sidebar or choose
194
+ Back; its draft and any running work stay with the thread. A focused terminal
195
+ keeps this shortcut for closing its current tab. To archive a thread,
196
+ right-click it and choose **Archive**.
197
+
192
198
  Files (while the Files pane has focus):
193
199
 
194
200
  - Go to line in the open file: **Ctrl+G** on every platform, matching VS
@@ -497,8 +497,9 @@ personal CLI access does not require App access to the project's repositories.
497
497
  Aliases and extensions run as ordinary code owned by the same machine
498
498
  user and can use the effective managed or local identity.
499
499
 
500
- Open **Project settings** in the desktop app, then expand **Git** to choose the
501
- project's Preferred Git action. Create a pull request keeps Create PR as the
500
+ Open **Project settings → Git**, in the desktop app or from the project's gear
501
+ button on mobile, to choose the project's Preferred Git action. Create a pull
502
+ request keeps Create PR as the
502
503
  usual primary action. Push directly makes the applicable Push or Publish action
503
504
  primary instead. The preference applies to every Template box and devbox that
504
505
  belongs to the project and changes ordering only: both workflows remain
@@ -60,7 +60,9 @@ or a failed start does not change them. Existing devboxes keep their checkout.
60
60
  Setup and import show default branches and startup commands as separate settings
61
61
  under **New devboxes**. Edit configured defaults in **Project settings → Devbox
62
62
  lifecycle → New devbox defaults**, above the startup script, then choose
63
- **Save**. Clearing or restoring startup commands keeps the branch defaults.
63
+ **Save**. The mobile app edits the same defaults under **Project settings →
64
+ Devbox lifecycle → Default branch**. Clearing or restoring startup commands
65
+ keeps the branch defaults.
64
66
  Existing projects without configured defaults can keep the branch saved in
65
67
  the Template box snapshot by choosing **From Template box**.
66
68
 
@@ -61,7 +61,8 @@ the bytes only after boxes.dev has bound it to the exact member and project.
61
61
 
62
62
  A missing member file, or one awaiting destination approval, does not block a
63
63
  startup script or a new Codex or Claude session. They start without it, and the
64
- desktop app warns the member until they add it. A file that cannot be written
64
+ desktop and mobile apps warn the member until they add it; either app's
65
+ Project settings can upload it. A file that cannot be written
65
66
  safely does block them until it is fixed, and Project settings explains what
66
67
  the member must do. An agent session that is already running is not stopped
67
68
  when a requirement or file changes.
@@ -73,6 +73,16 @@ and punctuation do not need to match.
73
73
  Open a project to see its threads. The list can include:
74
74
 
75
75
  - pinned threads and devboxes;
76
+ - devbox folders from the desktop app, in their saved order, when **Project
77
+ view** in Settings is **Folders**. The default, **Recent**, leaves devboxes
78
+ in the recent threads by date. Folders start
79
+ collapsed and show their devbox count and a status icon when one of their
80
+ threads needs attention, for example because it is running, needs input, or
81
+ is unread. Opening a folder lists its
82
+ devboxes, 15 at a time with **Load more devboxes**. Folders are read-only on
83
+ mobile: creating, editing, and moving devboxes between them stay in the
84
+ desktop app, and a pinned devbox lists under pinned threads instead of its
85
+ folder;
76
86
  - recent threads;
77
87
  - devbox groups, with child threads under the devbox and, when the devbox has
78
88
  archived threads, an **Archived threads** list at the end of the group;
@@ -272,12 +282,13 @@ every agent on the box. Every change takes effect immediately. **Pause and
272
282
  resume agents** offers **Off**, **Created from this devbox** (the default),
273
283
  **In this project**, and **Across all my projects**. The wider choices cover
274
284
  your own threads; **Read threads** controls reading separately. Elevated
275
- permissions (creating devboxes and threads, messaging other agents, destroying
276
- and archiving devboxes, and a Template box's Team Template creation,
277
- lifecycle, and maintenance permissions) have amber switches and a one-line
278
- explanation under the label. **Project permissions** at the bottom opens the
279
- project's shared settings. **Message teammates' agents** is not on the mobile
280
- screens yet; change it in the desktop app.
285
+ permissions (creating devboxes and threads, messaging other agents and
286
+ teammates' agents, destroying and archiving devboxes, and a Template box's
287
+ Team Template creation, lifecycle, and maintenance permissions) have amber
288
+ switches and a one-line explanation under the label. **Project permissions** at the bottom opens the
289
+ project's shared settings. When opened from a thread, the screen also lists
290
+ teammates' threads that are always allowed to message it under **Always
291
+ allowed in this thread**, each with **Remove**.
281
292
 
282
293
  Long-press a message to open its bottom menu and choose **Copy** to copy its
283
294
  text. On an eligible completed Codex or Claude reply, choose **Fork in
@@ -460,14 +471,40 @@ Tap the row to open the phone's settings and allow notifications.
460
471
 
461
472
  ## Settings
462
473
 
463
- A project's gear button opens **Project settings**, which has these rows:
464
-
465
- - **Agent permissions**, for the shared permissions that the project's
466
- devboxes follow unless they were configured separately;
467
- - **MCPs**, for the MCP servers Codex and Claude use in the project (see
468
- [MCPs](#mcps));
474
+ A project's gear button opens **Project settings**. Each row opens its own
475
+ screen and edits the desktop app's project settings, apart from the
476
+ exceptions listed after this list:
477
+
478
+ - under **Agents**: **Agent permissions**, for the shared permissions that the
479
+ project's devboxes follow unless they were configured separately;
480
+ and **Agent settings**, the project's Claude `settings.json` and Codex
481
+ `config.toml` (a Team Template project also shows the team's settings,
482
+ read-only);
483
+ - under **Project**: **Devbox lifecycle** (agent guidance, startup and
484
+ teardown scripts with their timeouts, the first prompt prefix, and the
485
+ default branch new devboxes check out for each repository, each edited on
486
+ its own screen), **Environment files** (set, replace, or remove
487
+ values and variables in files already added; in a Team Template project,
488
+ the member's values, their own variables, and their own replacement for a
489
+ Team value where the team allows one), **Member files** (Team
490
+ Template projects only: upload, replace, approve at a moved destination, or
491
+ remove), **Project storage**, and **Git** (preferred Git action, thread links
492
+ in commits, automatic pull request follow-ups, and the default follow-up
493
+ events);
494
+ - under **Integrations**, which matches the desktop app's Integrations tool:
495
+ **MCPs**, for the MCP servers Codex and Claude use in the project (see
496
+ [MCPs](#mcps)), and **Google Cloud** when the project offers it;
469
497
  - **App settings**, which opens the app-wide settings below.
470
498
 
499
+ The app never shows saved environment values or member files, and it cannot
500
+ add a new environment file (that reads the file from the Template box), reveal
501
+ values, or download member files; those stay in the desktop app, along with
502
+ opening or creating a Team Template. The account-wide auto-wake preference is
503
+ desktop-only because only the desktop app follows it. In a Team Template
504
+ project, the project screen shows a warning with **Add** while a required
505
+ value or member file is missing. A line under the project name names its Team
506
+ Template.
507
+
471
508
  The **Settings** tab on Home opens the app-wide settings directly. They
472
509
  include:
473
510
 
@@ -482,6 +519,10 @@ include:
482
519
  - theme, monospace font, and thread text size;
483
520
  - **Sort threads**, the thread list order shared with desktop (see
484
521
  `threads-and-agents.md`, Thread List Organization);
522
+ - **Project view**: **Recent** (the default) lists a project's devboxes by
523
+ date, and **Folders** groups them into the user's desktop folders. It is
524
+ saved on the account and applies only to the mobile app; desktop always
525
+ shows folders;
485
526
  - release package details and refresh controls in installed builds;
486
527
  - account deletion.
487
528
  - a Help center link that opens the public guides at `https://boxes.dev/help`
@@ -578,8 +619,8 @@ Git staging and commits, port forwarding, box process inspection, and
578
619
  detailed review.
579
620
 
580
621
  Use mobile when you want to monitor progress, answer questions, send a quick
581
- follow-up, review or change agent permissions, reconnect a Codex or Claude
582
- account, add or sign in to an MCP, take a Template-box snapshot,
583
- inspect a linked file or diff, open a shell, check a page in the shared
584
- Browser, sleep or destroy a devbox, or check billing/status away from the
585
- desktop.
622
+ follow-up, review or change agent permissions or other project settings,
623
+ supply a missing environment value or member file, reconnect a Codex or Claude
624
+ account, add or sign in to an MCP, take a Template-box snapshot, inspect a
625
+ linked file or diff, open a shell, check a page in the shared Browser, sleep or
626
+ destroy a devbox, or check billing/status away from the desktop.
@@ -856,8 +856,7 @@ have permissions saved individually; turn those off in the box's Agent
856
856
  permissions control when needed. In the mobile app, the box's controls are in
857
857
  an open thread's **…** menu under **Agent permissions**, and the shared
858
858
  settings are under **Agent permissions** in the project's gear button
859
- (**Project settings**). **Message teammates' agents** is set only in the
860
- desktop app.
859
+ (**Project settings**).
861
860
 
862
861
  Run the request once and wait. `granted` and `already_granted` are successful;
863
862
  `denied`, `expired`, and `permission_request_pending` are non-successful
@@ -1774,8 +1773,7 @@ An agent can also message a teammate's Codex or Claude thread in any of the
1774
1773
  teammate's projects. This needs **Message teammates' agents** on both
1775
1774
  devboxes: the one sending and the recipient thread's current devbox. It is
1776
1775
  separate from **Message other agents**, off by default, and set by each person
1777
- in the desktop app for their own projects and boxes, like the other Agent
1778
- permissions.
1776
+ for their own projects and boxes, like the other Agent permissions.
1779
1777
 
1780
1778
  Use the same command. `--to` takes the thread ID named in a received message,
1781
1779
  or a `thr_` ID from **Copy thread ID** or `dvb-onbox threads list --scope team`.
@@ -1803,7 +1801,7 @@ recipient's side wakes until the message is allowed, and the waking and model
1803
1801
  usage count against the recipient's account. **Always allow** covers one
1804
1802
  sending thread and one receiving thread, including that pair's messages
1805
1803
  already waiting; the recipient can remove it under **Always allowed in this
1806
- thread** in that thread's Agent permissions in the desktop app.
1804
+ thread** in that thread's Agent permissions, on desktop and mobile.
1807
1805
 
1808
1806
  The receiving agent sees a first line naming the teammate: "Sent by <name>, a
1809
1807
  teammate of your user. Your user allowed this message to reach you." Treat the
@@ -182,6 +182,30 @@ untracked files, Git access, agent config, and so on) — and reviews it with
182
182
  the user. The manifest lives outside the repo, so setup leaves no changes in
183
183
  the project folder, and the user can read or edit it directly at any time.
184
184
 
185
+ The agent should recommend the smallest box size that fits one coding agent,
186
+ one running instance of the app, and its required services. A marketing site
187
+ or modest app is a candidate for 4 vCPU / 8 GB; a larger recommendation should
188
+ have a workload reason. Review the box-hour multiplier as well as CPU and
189
+ memory before choosing. Larger sizes consume included box-hours and prepaid
190
+ credits faster while awake, even when their extra capacity is idle. The size
191
+ applies to the Template box and future devboxes and cannot be changed after
192
+ initialization. See Billing And Limits for current multipliers.
193
+
194
+ Agent-driven setup can select individual Claude and Codex skill folders,
195
+ including their linked support files. `dvb agent-init detect agent-config`
196
+ lists individual skill ids and sizes, and its `--json` output includes source
197
+ paths and exact byte counts. The manifest's `agentConfig.include` selects those
198
+ ids. Existing `claude:skills` and `codex:skills` entries still select whole
199
+ folders; remove the corresponding whole-folder entry when choosing a subset.
200
+ The local originals remain unchanged.
201
+
202
+ Global agent configuration is optional. The local agent should recommend a
203
+ selection based on usefulness to this project and the user's development
204
+ workflow, estimate its upload size, and explain the largest categories. Testing and
205
+ browser skills can be worth including even when the app does not require
206
+ them. Review large or uncertain choices with the agent before approving the
207
+ import; a small upload is not the only goal.
208
+
185
209
  The local agent can record its verified current agent and model in optional
186
210
  `agents.setup: { backend: codex, model: gpt-6.1-sol }` (use `claude` for Claude
187
211
  Code). Remote setup prefers that agent when selected and connected, and that
@@ -1098,6 +1122,16 @@ Common recovery paths:
1098
1122
  - Setup state is no longer useful: delete setup state and start over.
1099
1123
 
1100
1124
  Starting over removes the incomplete setup state created by that setup attempt.
1125
+
1126
+ For an agent-driven setup with an unnecessarily large import, the local agent
1127
+ can stop its active upload command and, with approval, run
1128
+ `dvb agent-init destroy --yes` from the project folder. This removes the
1129
+ incomplete Template box and setup progress but keeps the agent's manifest and
1130
+ local project files. The agent can revise that manifest, check it again, and
1131
+ show the smaller import and box-size cost before requesting launch approval.
1132
+ A completed project needs a separate recreation decision; do not reset it as
1133
+ an incomplete setup.
1134
+
1101
1135
  If setup says the Template box did not respond in time, resume setup to
1102
1136
  continue.
1103
1137
 
@@ -91,11 +91,14 @@ You can link by:
91
91
  Until your Slack identity is linked, the app answers any mention or app DM from
92
92
  you, including `help`, with a DM containing a connect link, the next setup
93
93
  steps, and links to the Slack help article and support. The connect link works
94
- whatever email your Slack profile uses; **Find my Slack account** matches your
95
- boxes.dev email.
94
+ whatever email your Slack profile uses.
96
95
 
97
- If boxes.dev cannot match your Slack user, verify your boxes.dev email and try
98
- again from Slack.
96
+ **Link your account**, **Connect Slack**, and **Find my Slack account** look
97
+ for a Slack account with your verified boxes.dev email and link it. When none
98
+ matches, Slack opens and asks you to sign in to the team's workspace, and
99
+ boxes.dev links the account you sign in with. The sign-in can't link a bot, a
100
+ guest, a member of another workspace, or an account that is already linked to
101
+ another boxes.dev user. Verify your boxes.dev email before linking.
99
102
 
100
103
  ## Create And Activate Your Default Slack Receiver
101
104
 
@@ -314,7 +317,13 @@ to an owner when a teammate starts work in their workspace is unchanged.
314
317
 
315
318
  After a Slack request starts a boxes.dev thread, mention `@boxes.dev` again in
316
319
  the same Slack thread to send a follow-up. Ordinary Slack replies without the
317
- mention stay in Slack and are not sent to the agent.
320
+ mention do not send an instruction to the agent. The agent can retrieve them
321
+ when it reads the Slack thread again.
322
+
323
+ Thread reads fetch new replies. If Slack asks boxes.dev to wait, the tool
324
+ returns available context, marks it incomplete, and tells the agent when to
325
+ read again. Long threads return the newest available messages and disclose
326
+ omitted earlier messages. Earlier edits and deletions are not synchronized.
318
327
 
319
328
  Anyone allowed to run the automation can send follow-ups in its linked Slack
320
329
  threads, including threads the owner started. Each follow-up reaches the agent
@@ -913,6 +913,13 @@ also offer these modes when the runtime supports switching them:
913
913
  - **Plan** lets Claude inspect and propose changes without editing project files
914
914
  until the user approves leaving plan mode.
915
915
 
916
+ Claude Code settings can turn off bypass mode, for example with
917
+ `permissions.disableBypassPermissionsMode` in the repository's
918
+ `.claude/settings.json`. Claude threads in such a project start in Auto
919
+ instead of Full-access, or in Manual when the settings also turn off Auto. A
920
+ running thread moves to Auto the same way if the setting appears while it runs,
921
+ and choosing Full-access shows an error that names the setting.
922
+
916
923
  The last confirmed Full-access, Auto, or Manual choice belongs to that thread
917
924
  and survives reconnects and agent restarts unless an explicit machine mode
918
925
  overrides it at process startup. Plan temporarily overlays that base
@@ -1203,10 +1210,14 @@ section. The thread's permanent `/thread/` link is different: it identifies
1203
1210
  the thread for Team work, Git history, and the CLI, but does not grant access
1204
1211
  or save the thread by itself.
1205
1212
  It always applies the current team policy, privacy setting, and share access.
1206
- On a shared-thread browser page, choose **Open in app** to open the same
1207
- read-only thread in the desktop app, or in the mobile app when viewed on a
1208
- phone or tablet. If the viewer has never signed in to that app, the button
1209
- opens a page with a download option instead.
1213
+ On a shared-thread or `/thread/` browser page, choose **Open in app** to open
1214
+ the thread in the desktop app, or in the mobile app when viewed on a phone or
1215
+ tablet. The owner's own thread opens as their ordinary thread. A teammate's
1216
+ `/thread/` page offers the button only in a desktop browser, because the mobile
1217
+ app cannot open a teammate's thread from a link. If the viewer has never signed
1218
+ in to that app, the button opens a page with a download option instead. Inside
1219
+ the desktop app, clicking a boxes.dev `/thread/` link or share link opens the
1220
+ thread in the app rather than in the browser.
1210
1221
 
1211
1222
  To save an ordinary Team work thread, choose **Pin to my workbench**. A
1212
1223
  teammate's thread has a `…` menu in its header and on its **Shared with me**
@@ -63,6 +63,11 @@ keeps its original deadline. Cancel with the returned request ID when the
63
63
  work finishes. A hold keeps the box and its agent available; it does not
64
64
  launch, supervise or restart a command.
65
65
 
66
+ After 24 hours of continuous running, a box pauses briefly. When activity or
67
+ a live hold still keeps it awake, boxes.dev usually resumes it within seconds,
68
+ subject to the usual billing and awake devbox limits. Commands continue where
69
+ they left off, but network connections may need to reconnect.
70
+
66
71
  An awake box uses box-hours even while waiting, and agent responses may use
67
72
  model allowance. The response estimates box-hours for the requested interval
68
73
  at the current box size. It is not an additional charge or a total spending
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@boxes-dev/dvb-runtime",
3
- "version": "1.0.1102",
3
+ "version": "1.0.1104",
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-22T04:53:33Z"
80
+ "devboxReleasedAt": "2026-10-25T00:49:41Z"
81
81
  }