@boxes-dev/dvb-runtime 1.0.1113 → 1.0.1114
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/agent-init-guides/flow.md +8 -4
- package/dist/bin/dvb.mjs +405 -178
- package/dist/bin/dvbd.mjs +4 -4
- package/dist/product-docs/references/desktop-workbench.md +4 -4
- package/dist/product-docs/references/fork-workflows.md +4 -3
- package/dist/product-docs/references/getting-started.md +1 -1
- package/dist/product-docs/references/managed-environment-files.md +58 -0
- package/dist/product-docs/references/member-managed-files.md +28 -20
- package/dist/product-docs/references/mobile.md +6 -4
- package/dist/product-docs/references/onbox-agent-tools.md +170 -52
- package/dist/product-docs/references/ports-terminal-and-runtime.md +19 -8
- package/dist/product-docs/references/project-setup.md +9 -2
- package/dist/product-docs/references/team-template.md +3 -2
- package/dist/product-docs/references/template-box-environment.md +14 -12
- package/dist/product-docs/references/threads-and-agents.md +33 -15
- package/package.json +2 -2
|
@@ -35,12 +35,16 @@ Git, or Ports. If a devbox is sleeping because the awake devbox limit is full,
|
|
|
35
35
|
boxes.dev asks you to sleep another devbox before continuing.
|
|
36
36
|
|
|
37
37
|
Background work started by an agent can keep a devbox awake after the agent
|
|
38
|
-
finishes its reply.
|
|
39
|
-
|
|
40
|
-
|
|
38
|
+
finishes its reply. In the chat view, Claude background subagents keep it
|
|
39
|
+
awake while they work, including while they wait on a tool. After 12 minutes without
|
|
40
|
+
new activity, normal idle sleep can resume.
|
|
41
|
+
|
|
42
|
+
Codex background commands and Claude subagents started in a terminal receive
|
|
43
|
+
up to one hour of sleep protection. Claude background commands and workflows
|
|
44
|
+
use their declared timeout, capped at four hours, or one hour when no timeout
|
|
45
|
+
is declared. Finishing the work releases
|
|
41
46
|
that protection sooner. When the limit expires, normal idle sleep can resume;
|
|
42
|
-
the limit does not terminate the command. You can still sleep the
|
|
43
|
-
yourself.
|
|
47
|
+
the limit does not terminate the command. You can still sleep the box yourself.
|
|
44
48
|
|
|
45
49
|
Claude's background shell commands in the chat view have a separate execution
|
|
46
50
|
limit: 30 minutes by default, up to two hours. When that limit expires, Claude
|
|
@@ -263,9 +267,16 @@ dialog shows the new link with a **Copy link** button. Public links do not
|
|
|
263
267
|
depend on local forwarding, remain active when you select another devbox or
|
|
264
268
|
close the desktop app, and remain allocated while the app is stopped or the
|
|
265
269
|
machine is sleeping. Traffic through a public link can keep an awake machine
|
|
266
|
-
active; Project URL traffic does not.
|
|
267
|
-
|
|
268
|
-
Ports menu marks the link as paused
|
|
270
|
+
active; Project URL traffic does not.
|
|
271
|
+
|
|
272
|
+
While the box sleeps, the Ports menu marks the link as paused, and
|
|
273
|
+
visitors see a page with a **Wake devbox** button. Anyone with the link can
|
|
274
|
+
press it without signing in. The box then wakes as if its owner had woken
|
|
275
|
+
it: it uses the owner's box-hours, and the owner's billing and awake devbox
|
|
276
|
+
limits apply. The page reloads into the app once the box is ready. Other
|
|
277
|
+
requests to the link, including API calls and WebSocket connections, do not
|
|
278
|
+
wake the box. If a limit blocks the wake or the wake fails, the page says
|
|
279
|
+
so, and after a failed wake the visitor can try again.
|
|
269
280
|
|
|
270
281
|
Public links and Project URLs pass their public hostname to the app. If Vite
|
|
271
282
|
rejects those requests with "Blocked request. This host is not allowed", add
|
|
@@ -358,8 +358,15 @@ manifest can instead select SSH or skip Git access. If GitHub is not connected,
|
|
|
358
358
|
flow. Once GitHub is connected, the same command opens the GitHub page that
|
|
359
359
|
gives the boxes.dev GitHub App access to the project's repositories: the
|
|
360
360
|
owner's installation settings, or the install page with the owning account
|
|
361
|
-
selected.
|
|
362
|
-
|
|
361
|
+
selected. The command then waits, for up to 20 minutes without progress,
|
|
362
|
+
until the user finishes each step on GitHub and boxes.dev can access every
|
|
363
|
+
repository, so the agent doesn't need the user to say they're done. The setup
|
|
364
|
+
page names the step: a **Connect GitHub** button while the user signs in, and
|
|
365
|
+
the repositories and an **Open GitHub** link while boxes.dev needs access.
|
|
366
|
+
When GitHub returns the user to **Account** after an App install, update, or
|
|
367
|
+
request, Account says what happened and tells a user in setup to go back to
|
|
368
|
+
their coding agent. `dvb agent-init check` verifies the exact writable
|
|
369
|
+
repositories, App visibility, and current GitHub access before a managed launch; when an update
|
|
363
370
|
is required, it prints the exact GitHub action and the SSH alternative. If
|
|
364
371
|
GitHub renamed or transferred a repository after its local origin was set,
|
|
365
372
|
`check` and `github connect` print a `git remote set-url` command for the
|
|
@@ -516,8 +516,9 @@ Start the ordinary new-project flow and choose **Start from a Team Template**.
|
|
|
516
516
|
The picker shows only templates with a current saved version and does not
|
|
517
517
|
preselect one. Select the exact template, name the project and complete
|
|
518
518
|
**Needed to create the project**, which brings required environment values
|
|
519
|
-
and
|
|
520
|
-
can be added now or later in Project
|
|
519
|
+
and required member files together. **Show optional** starts collapsed and
|
|
520
|
+
holds optional values and files; these can be added now or later in Project
|
|
521
|
+
settings. Independent projects also
|
|
521
522
|
offer coding-agent choices; at least one must be selected when the template
|
|
522
523
|
includes setup instructions. Team defaults remain available for review.
|
|
523
524
|
|
|
@@ -115,12 +115,14 @@ Doing this on an ordinary devbox stays local to that devbox and does not create
|
|
|
115
115
|
a Template snapshot. See `files-git-and-review.md` for the full add, review,
|
|
116
116
|
repair, access-recovery, and unsupported-layout behavior.
|
|
117
117
|
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
118
|
+
An agent on the Template box or any of its devboxes can use `dvb-onbox project
|
|
119
|
+
lifecycle get/set` to update the same startup script, teardown script, and
|
|
120
|
+
timeouts shown in Project settings. The agent needs to ask you for permission
|
|
121
|
+
to edit project settings first. On a Template box where **Edit devbox
|
|
122
|
+
lifecycle** is already on, its agents can use the command without asking. The
|
|
123
|
+
command is revision-checked, reads script content from regular files under
|
|
124
|
+
`/home/boxes`, and cannot target another project. This lifecycle setting is
|
|
125
|
+
unrelated to boxes.dev Automations.
|
|
124
126
|
|
|
125
127
|
## Template Maintenance
|
|
126
128
|
|
|
@@ -150,16 +152,16 @@ saving it.
|
|
|
150
152
|
Automatic scheduling is optional; the supported cadences are every 6 hours,
|
|
151
153
|
every 12 hours, nightly, and weekly.
|
|
152
154
|
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
the
|
|
155
|
+
An agent on the Template box or any of its devboxes can use `dvb-onbox project
|
|
156
|
+
maintenance get/apply` to author the script and complete GitHub watch set
|
|
157
|
+
together, and `run` to start the saved script and follow its result. It needs
|
|
158
|
+
the same permission to edit project settings, unless **Edit template
|
|
159
|
+
maintenance** is already on for the Template box it runs on. The command copies a
|
|
157
160
|
script and version-1 watch JSON file from regular files under `/home/boxes`,
|
|
158
161
|
requires the revision returned by `get`, and requires explicit confirmation
|
|
159
162
|
before removing an editable watch. It preserves the existing repeating
|
|
160
163
|
schedule. New, changed, or re-enabled watches receive a fresh baseline without
|
|
161
|
-
starting a maintenance run.
|
|
162
|
-
**Edit devbox lifecycle** or any saved configuration.
|
|
164
|
+
starting a maintenance run.
|
|
163
165
|
|
|
164
166
|
When GitHub is connected, a policy can also watch exact repository-relative
|
|
165
167
|
files or directories on each repository's default branch. Only the project's own
|
|
@@ -841,11 +841,13 @@ have not sent or skipped stay under **Answer questions**. If
|
|
|
841
841
|
the turn ends, edited answers that you have not sent will move to the reply box.
|
|
842
842
|
Answers reach the running turn even if ordinary replies are set to Queue.
|
|
843
843
|
|
|
844
|
-
On mobile, the questions appear
|
|
845
|
-
stay visible until answered or the turn ends.
|
|
846
|
-
|
|
847
|
-
|
|
848
|
-
|
|
844
|
+
On mobile, the questions appear one at a time in the scrollable conversation
|
|
845
|
+
and stay visible until answered or the turn ends. Tapping an option answers the
|
|
846
|
+
question and moves to the next one; on the last question it sends the answers.
|
|
847
|
+
For a written answer, type it and tap **Continue**, or **Send** on the last
|
|
848
|
+
question. The arrows at the top of the form move between questions. Edited
|
|
849
|
+
unsent answers also return to the reply box when the turn ends. See
|
|
850
|
+
`mobile.md` for mobile message recovery and question controls.
|
|
849
851
|
|
|
850
852
|
Codex threads expose model controls in the composer footer:
|
|
851
853
|
|
|
@@ -1119,19 +1121,32 @@ intentionally moves them to cold storage or that machine is destroyed.
|
|
|
1119
1121
|
When Claude Code enters plan mode, the desktop and mobile mode control shows
|
|
1120
1122
|
**Plan** while Claude is planning without changing project files. An older
|
|
1121
1123
|
connected runtime can show the passive label **Plan mode** instead. When Claude
|
|
1122
|
-
|
|
1123
|
-
**
|
|
1124
|
-
|
|
1125
|
-
|
|
1126
|
-
|
|
1127
|
-
|
|
1124
|
+
proposes a plan, the transcript shows it formatted, and the **Plan** card asks
|
|
1125
|
+
**Implement this plan?** Choose **Yes, implement this plan** to leave plan mode
|
|
1126
|
+
and let Claude start the work in the previous mode. To revise the plan instead,
|
|
1127
|
+
type what to change in **No, tell Claude what to change** and submit it, or
|
|
1128
|
+
send the change as a steer from the reply box. Claude will stay in plan mode
|
|
1129
|
+
and propose a revised plan. A queued message waits until the plan is answered. A
|
|
1130
|
+
box running an older version of boxes.dev shows **Allow** and **Deny** instead.
|
|
1131
|
+
|
|
1132
|
+
Claude Code may ask the user structured questions. The question card shows
|
|
1133
|
+
one question at a time, above the reply box on desktop and in the conversation
|
|
1134
|
+
on mobile, with arrows and a "1 of N" position when Claude asked several. A
|
|
1135
|
+
question can allow one choice or several. When it allows one, choosing an
|
|
1136
|
+
option moves to the next question that still needs an answer, and the answers
|
|
1137
|
+
are sent once every question has one. Multi-select and custom answers use **Continue**, or
|
|
1138
|
+
**Submit** on the last question. On desktop, number keys choose options while
|
|
1139
|
+
the card has focus, and Esc stops the turn. **Skip** appears on a
|
|
1140
|
+
question when Claude offered a skip option for it. Every Claude-authored
|
|
1128
1141
|
question also includes **Type something else...** for a custom answer and
|
|
1129
1142
|
**Chat about this** when the choices or premise need clarification. Chat sends
|
|
1130
1143
|
the current partial selections or custom text back as context so Claude can
|
|
1131
|
-
reformulate the question; it does not record a completed answer.
|
|
1132
|
-
|
|
1133
|
-
|
|
1134
|
-
|
|
1144
|
+
reformulate the question; it does not record a completed answer. Permission
|
|
1145
|
+
requests use the same card with **Allow** and **Deny**. While one of these
|
|
1146
|
+
questions is waiting, Claude can't take a steer; answer it first, then retry
|
|
1147
|
+
the message.
|
|
1148
|
+
Answering a question on a sleeping box wakes the box and sends the answer once
|
|
1149
|
+
the app reconnects.
|
|
1135
1150
|
|
|
1136
1151
|
To let Claude continue without an answer, choose **Question auto-continue
|
|
1137
1152
|
timeout** under **Settings → Agents → Agent replies** on desktop or
|
|
@@ -1292,6 +1307,9 @@ folder's name, and its devbox count. A closed folder also shows the most
|
|
|
1292
1307
|
urgent state among its threads, such as running, needs input, or unread. While
|
|
1293
1308
|
the user scrolls through an open folder, its row stays pinned below the
|
|
1294
1309
|
**Devboxes** heading until the next folder or the unfiled devboxes reach it.
|
|
1310
|
+
To move a devbox, the user can choose a folder from **Move to** in its menu or
|
|
1311
|
+
drag the devbox onto the folder. Dragging it to the unfiled devboxes takes it
|
|
1312
|
+
out of its folder. A pinned devbox can't be dragged into a folder.
|
|
1295
1313
|
**Sidebar density**, under **Appearance and layout** in **Settings > General**,
|
|
1296
1314
|
sets the thread list's spacing to **Comfortable** (the default), **Cozy**, or
|
|
1297
1315
|
**Compact**. It is saved on that computer only, and **Restore appearance and
|
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.1114",
|
|
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-11-
|
|
80
|
+
"devboxReleasedAt": "2026-11-06T01:06:52Z"
|
|
81
81
|
}
|