@boxes-dev/dvb-runtime 1.0.1106 → 1.0.1108
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 +1728 -1157
- package/dist/bin/dvbd.mjs +25 -21
- package/dist/product-docs/references/automations.md +22 -4
- package/dist/product-docs/references/cli.md +50 -5
- package/dist/product-docs/references/desktop-workbench.md +10 -3
- package/dist/product-docs/references/environment-setup-validation.md +12 -4
- package/dist/product-docs/references/files-git-and-review.md +11 -2
- package/dist/product-docs/references/fork-workflows.md +17 -5
- package/dist/product-docs/references/getting-started.md +3 -0
- package/dist/product-docs/references/mobile.md +46 -13
- package/dist/product-docs/references/onbox-agent-tools.md +80 -21
- package/dist/product-docs/references/ports-terminal-and-runtime.md +11 -0
- package/dist/product-docs/references/project-setup.md +35 -5
- package/dist/product-docs/references/remote-assistants.md +9 -0
- package/dist/product-docs/references/template-box-environment.md +7 -0
- package/dist/product-docs/references/threads-and-agents.md +164 -21
- package/dist/product-docs/references/troubleshooting.md +18 -2
- 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]="c3df6e8d-08ba-56d3-b8e3-c7c2f15f6900")}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";
|
|
@@ -4078,7 +4078,7 @@ var init_githubGhCredentials = __esm({
|
|
|
4078
4078
|
|
|
4079
4079
|
// ../../../../shared/devboxCore/dist/loopbackServer.js
|
|
4080
4080
|
import net from "node:net";
|
|
4081
|
-
var MAX_PORT, MAX_LOOPBACK_PORT_SHIFT, nextCandidatePort, isRetryableListenError,
|
|
4081
|
+
var MAX_PORT, MAX_LOOPBACK_PORT_SHIFT, nextCandidatePort, isRetryableListenError, probeIpv6Loopback, listenOnLoopbackPort;
|
|
4082
4082
|
var init_loopbackServer = __esm({
|
|
4083
4083
|
"../../../../shared/devboxCore/dist/loopbackServer.js"() {
|
|
4084
4084
|
"use strict";
|
|
@@ -4088,10 +4088,10 @@ var init_loopbackServer = __esm({
|
|
|
4088
4088
|
isRetryableListenError = (error4) => {
|
|
4089
4089
|
return error4.code === "EADDRINUSE" || error4.code === "EACCES" || error4.code === "EADDRNOTAVAIL";
|
|
4090
4090
|
};
|
|
4091
|
-
|
|
4091
|
+
probeIpv6Loopback = async (port) => await new Promise((resolve2, reject) => {
|
|
4092
4092
|
const server = net.createServer();
|
|
4093
4093
|
let settled = false;
|
|
4094
|
-
const finalize2 = (
|
|
4094
|
+
const finalize2 = (state) => {
|
|
4095
4095
|
if (settled) {
|
|
4096
4096
|
return;
|
|
4097
4097
|
}
|
|
@@ -4101,25 +4101,29 @@ var init_loopbackServer = __esm({
|
|
|
4101
4101
|
} catch {
|
|
4102
4102
|
}
|
|
4103
4103
|
if (!server.listening) {
|
|
4104
|
-
resolve2(
|
|
4104
|
+
resolve2(state);
|
|
4105
4105
|
return;
|
|
4106
4106
|
}
|
|
4107
|
-
server.close(() => resolve2(
|
|
4107
|
+
server.close(() => resolve2(state));
|
|
4108
4108
|
};
|
|
4109
4109
|
server.once("error", (error4) => {
|
|
4110
|
-
if (error4.code === "
|
|
4111
|
-
finalize2(
|
|
4110
|
+
if (error4.code === "EACCES") {
|
|
4111
|
+
finalize2("permission_denied");
|
|
4112
|
+
return;
|
|
4113
|
+
}
|
|
4114
|
+
if (error4.code === "EAFNOSUPPORT" || error4.code === "EADDRNOTAVAIL" || error4.code === "EADDRINUSE") {
|
|
4115
|
+
finalize2("unavailable");
|
|
4112
4116
|
return;
|
|
4113
4117
|
}
|
|
4114
4118
|
reject(error4);
|
|
4115
4119
|
});
|
|
4116
4120
|
server.once("listening", () => {
|
|
4117
|
-
finalize2(
|
|
4121
|
+
finalize2("available");
|
|
4118
4122
|
});
|
|
4119
4123
|
try {
|
|
4120
4124
|
server.listen({ host: "::1", port });
|
|
4121
4125
|
} catch {
|
|
4122
|
-
finalize2(
|
|
4126
|
+
finalize2("unavailable");
|
|
4123
4127
|
}
|
|
4124
4128
|
});
|
|
4125
4129
|
listenOnLoopbackPort = async ({ createServer: createServer2 = () => net.createServer(), onRetryableConflict, port, shiftLimit = MAX_LOOPBACK_PORT_SHIFT, strategy }) => {
|
|
@@ -4145,11 +4149,11 @@ var init_loopbackServer = __esm({
|
|
|
4145
4149
|
let targetPort = port;
|
|
4146
4150
|
let attempts = 0;
|
|
4147
4151
|
while (attempts <= shiftLimit && targetPort <= MAX_PORT) {
|
|
4148
|
-
const
|
|
4149
|
-
if (
|
|
4152
|
+
const ipv6State = await probeIpv6Loopback(targetPort);
|
|
4153
|
+
if (ipv6State !== "available") {
|
|
4150
4154
|
if (strategy === "canonical_only") {
|
|
4151
4155
|
const error5 = new Error(`localhost:${String(targetPort)} is unavailable on ::1.`);
|
|
4152
|
-
error5.code = "EADDRINUSE";
|
|
4156
|
+
error5.code = ipv6State === "permission_denied" ? "EACCES" : "EADDRINUSE";
|
|
4153
4157
|
server.close();
|
|
4154
4158
|
throw error5;
|
|
4155
4159
|
}
|
|
@@ -64675,9 +64679,9 @@ var init_sentry = __esm({
|
|
|
64675
64679
|
uncaughtExceptionMonitorInstalled = false;
|
|
64676
64680
|
currentDevboxSentryUser = null;
|
|
64677
64681
|
readBuildMetadata = () => {
|
|
64678
|
-
const rawPackageVersion = "1.0.
|
|
64679
|
-
const rawGitSha = "
|
|
64680
|
-
const rawSentryRelease = "boxes-dev-dvb@1.0.
|
|
64682
|
+
const rawPackageVersion = "1.0.1108";
|
|
64683
|
+
const rawGitSha = "e3c45f64d9c5ff6bff506203058fbbd14057f5c0";
|
|
64684
|
+
const rawSentryRelease = "boxes-dev-dvb@1.0.1108+e3c45f64d9c5ff6bff506203058fbbd14057f5c0";
|
|
64681
64685
|
const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
|
|
64682
64686
|
const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
|
|
64683
64687
|
const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
|
|
@@ -67199,7 +67203,7 @@ var init_packageVersion = __esm({
|
|
|
67199
67203
|
return path8.join(process.cwd(), "dvb");
|
|
67200
67204
|
};
|
|
67201
67205
|
readEmbeddedPackageVersion = () => {
|
|
67202
|
-
const raw = "1.0.
|
|
67206
|
+
const raw = "1.0.1108";
|
|
67203
67207
|
return trimVersion(raw);
|
|
67204
67208
|
};
|
|
67205
67209
|
readNearestPackageMetadata = (basePath) => {
|
|
@@ -77642,7 +77646,7 @@ var init_ports2 = __esm({
|
|
|
77642
77646
|
MAX_PORT_SHIFT = 50;
|
|
77643
77647
|
MIN_UNPRIVILEGED_PORT = 1024;
|
|
77644
77648
|
SUBSCRIPTION_RETRY_DELAY_MS = 1e3;
|
|
77645
|
-
SUBSCRIPTION_RETRY_MAX_DELAY_MS =
|
|
77649
|
+
SUBSCRIPTION_RETRY_MAX_DELAY_MS = 12e4;
|
|
77646
77650
|
SUBSCRIPTION_STALE_DISCONNECT_MS = 5e3;
|
|
77647
77651
|
PORT_LEASE_REFRESH_MS = 2e3;
|
|
77648
77652
|
PORT_LEASE_STALE_AFTER_MS = 1e4;
|
|
@@ -78651,6 +78655,7 @@ var init_ports2 = __esm({
|
|
|
78651
78655
|
let subscription = null;
|
|
78652
78656
|
subscription = await this.knownBoxDiscoveryAdapter.subscribe({
|
|
78653
78657
|
onUpdate: (entries) => {
|
|
78658
|
+
this.knownBoxRetryAttempt = 0;
|
|
78654
78659
|
this.syncKnownBoxes(entries);
|
|
78655
78660
|
},
|
|
78656
78661
|
onError: (error4) => {
|
|
@@ -78670,7 +78675,6 @@ var init_ports2 = __esm({
|
|
|
78670
78675
|
clearTimeout(this.knownBoxRetryTimer);
|
|
78671
78676
|
this.knownBoxRetryTimer = null;
|
|
78672
78677
|
}
|
|
78673
|
-
this.knownBoxRetryAttempt = 0;
|
|
78674
78678
|
this.knownBoxSubscription = subscription;
|
|
78675
78679
|
this.maybeEnsureControlPlaneStateSubscription();
|
|
78676
78680
|
const current = subscription.getCurrentValue();
|
|
@@ -78957,6 +78961,7 @@ var init_ports2 = __esm({
|
|
|
78957
78961
|
box,
|
|
78958
78962
|
instanceId: this.getBoxInstanceId(box),
|
|
78959
78963
|
onUpdate: (entries) => {
|
|
78964
|
+
this.subscriptionRetryAttempts.delete(box);
|
|
78960
78965
|
this.syncFromSnapshot(box, entries);
|
|
78961
78966
|
},
|
|
78962
78967
|
onError: (error4) => {
|
|
@@ -78983,7 +78988,6 @@ var init_ports2 = __esm({
|
|
|
78983
78988
|
clearTimeout(retryTimer);
|
|
78984
78989
|
this.subscriptionRetryTimers.delete(box);
|
|
78985
78990
|
}
|
|
78986
|
-
this.subscriptionRetryAttempts.delete(box);
|
|
78987
78991
|
this.subscriptions.set(box, subscription);
|
|
78988
78992
|
this.subscriptionTargetKeys.set(box, subscriptionTargetKey);
|
|
78989
78993
|
this.maybeEnsureControlPlaneStateSubscription();
|
|
@@ -80404,4 +80408,4 @@ smol-toml/dist/index.js:
|
|
|
80404
80408
|
*)
|
|
80405
80409
|
*/
|
|
80406
80410
|
|
|
80407
|
-
//# debugId=
|
|
80411
|
+
//# debugId=c3df6e8d-08ba-56d3-b8e3-c7c2f15f6900
|
|
@@ -44,6 +44,11 @@ API endpoint appears below the prompt.
|
|
|
44
44
|
New automations start with the same agent, model, reasoning, and speed defaults
|
|
45
45
|
that a new project thread would use.
|
|
46
46
|
|
|
47
|
+
For Codex new-thread runs, **Provider** above the prompt selects OpenAI or a
|
|
48
|
+
saved model provider connection. Add keys in **Configure agents**, then choose
|
|
49
|
+
the connection and one of its models here. Reasoning and speed controls appear
|
|
50
|
+
only where supported; a model without a reasoning control needs no effort.
|
|
51
|
+
|
|
47
52
|
For drafts with **Only when I click Run now** or **On a schedule** selected,
|
|
48
53
|
**Thread** lets you keep **New devbox and thread on each run** or select an
|
|
49
54
|
existing conversation you own in this project. Search by title to find a thread.
|
|
@@ -77,6 +82,11 @@ on your device, so they survive a page refresh, and are not shared with other
|
|
|
77
82
|
devices or people. If the automation changed somewhere else while you had
|
|
78
83
|
unsaved edits, boxes.dev warns you before you save over the newer version.
|
|
79
84
|
|
|
85
|
+
Changing a Codex provider applies to future new-thread runs. Earlier runs keep
|
|
86
|
+
their original connection. If a key is disconnected, reconnect it in Configure
|
|
87
|
+
agents before running again, or choose another connection for future runs.
|
|
88
|
+
You can still rename, pause, or edit unrelated settings while disconnected.
|
|
89
|
+
|
|
80
90
|
An automation targeting an existing thread keeps that thread in its current
|
|
81
91
|
location. New-thread placement, model controls, completion preferences, Slack
|
|
82
92
|
outputs, and devbox cleanup do not apply to these runs.
|
|
@@ -189,7 +199,12 @@ spawned thread without renaming the automation. If `execution` is supplied,
|
|
|
189
199
|
it is a complete agent selection rather than a partial merge:
|
|
190
200
|
|
|
191
201
|
- Codex requires `backend`, `model`, and `reasoningEffort`. `serviceTier` is
|
|
192
|
-
optional and defaults to `standard`;
|
|
202
|
+
optional and defaults to `standard`; supported OpenAI models also offer
|
|
203
|
+
`fast` and `ultrafast`. Set `codexProviderConnectionId` to an owned saved
|
|
204
|
+
connection ID to use its model. Within a supplied `execution` object,
|
|
205
|
+
omitting that field or setting it to `null` selects OpenAI, even if the
|
|
206
|
+
automation has a different saved provider. Provider models use standard
|
|
207
|
+
speed, and models without a reasoning control use `reasoningEffort: null`.
|
|
193
208
|
- Claude Code requires `backend`, `model`, and `reasoningEffort`. Models
|
|
194
209
|
without a reasoning control use `null`. `serviceTier` is optional and
|
|
195
210
|
defaults to `standard`; set it to `fast` to use fast mode on a model that
|
|
@@ -197,8 +212,11 @@ it is a complete agent selection rather than a partial merge:
|
|
|
197
212
|
|
|
198
213
|
The values use the same model, reasoning, and speed controls as normal threads
|
|
199
214
|
and automation defaults. Invalid fields, unknown fields, unsupported
|
|
200
|
-
combinations, or incomplete `execution` objects are rejected
|
|
201
|
-
|
|
215
|
+
combinations, or incomplete `execution` objects are rejected. A disconnected
|
|
216
|
+
or unavailable provider connection records an actionable failed run before
|
|
217
|
+
creating a devbox. The API does not accept raw Codex or Claude CLI arguments.
|
|
218
|
+
Copy **Request examples** from the editor to get the selected connection ID
|
|
219
|
+
and model controls without including its API key.
|
|
202
220
|
|
|
203
221
|
Fixed API triggers accept only `{}`. Switching an existing fixed trigger to
|
|
204
222
|
configurable requests rotates its secret because the new secret can submit
|
|
@@ -370,7 +388,7 @@ Expanding a nested automation loads its most recent runs in pages. Choose
|
|
|
370
388
|
cleanup remain openable beneath the automation even when they are older than
|
|
371
389
|
the thread list's currently loaded history.
|
|
372
390
|
|
|
373
|
-
Each run keeps the full prompt, spawned-thread title, agent, model, reasoning,
|
|
391
|
+
Each run keeps the full prompt, spawned-thread title, agent, provider connection, model, reasoning,
|
|
374
392
|
and speed controls it started with. The run detail identifies whether its
|
|
375
393
|
prompt came from the saved automation, an API request, or trigger context.
|
|
376
394
|
Editing the automation later affects future runs, not existing run history.
|
|
@@ -152,6 +152,33 @@ opaque continuation cursor. Add `--all` only for a complete inventory.
|
|
|
152
152
|
|
|
153
153
|
See `dvb agent-docs agent-tools` for the complete safe workflow.
|
|
154
154
|
|
|
155
|
+
### Choose settings for a scripted thread
|
|
156
|
+
|
|
157
|
+
List the available agents, models, and saved provider connections before
|
|
158
|
+
starting a thread:
|
|
159
|
+
|
|
160
|
+
```bash
|
|
161
|
+
dvb threads options --json
|
|
162
|
+
dvb threads start --project <project> --target new-devbox --agent codex \
|
|
163
|
+
--provider <connection-id> --model <model-id> \
|
|
164
|
+
--prompt-file <path> --idempotency-key <key> --json
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
For Codex, `--provider openai` selects OpenAI; a connection ID from
|
|
168
|
+
`codexProviders` selects that saved connection. Its `models` list contains
|
|
169
|
+
the exact model IDs and reasoning choices for that connection. The `codex`
|
|
170
|
+
and `claude` lists contain the ordinary OpenAI and Claude choices.
|
|
171
|
+
|
|
172
|
+
Without selection flags, a start uses the target box's saved settings, or the
|
|
173
|
+
project's source settings for a new devbox. A bare `--model` stays within that
|
|
174
|
+
saved provider. Changing the model uses its default reasoning and Standard
|
|
175
|
+
speed; naming the already selected model preserves its settings. Use
|
|
176
|
+
`--reasoning-effort` or `--speed` only for supported choices. An explicit
|
|
177
|
+
`--provider` starts from that provider's default model and reasoning, with
|
|
178
|
+
Standard speed, before applying the other flags. Omit `--reasoning-effort`
|
|
179
|
+
for models with no effort choices. Provider selection is Codex-only, and a
|
|
180
|
+
started thread keeps its provider connection.
|
|
181
|
+
|
|
155
182
|
## Configure Devbox Lifecycle And Template Maintenance
|
|
156
183
|
|
|
157
184
|
A signed-in coding agent on your computer can inspect and edit a project's
|
|
@@ -345,15 +372,28 @@ border and the current agent settings on one status line. Press `Tab` (or
|
|
|
345
372
|
`Shift+Tab`) to move focus across those settings like form fields: arrow keys
|
|
346
373
|
change the focused value, typing jumps to a matching option by name, and `Esc`
|
|
347
374
|
returns to the prompt. Typing `/` as the first character of the prompt opens a
|
|
348
|
-
command menu (`/agent`, `/model`, `/reasoning`, `/speed`,
|
|
349
|
-
jumps to the same controls: arrows choose a command, `Tab`
|
|
350
|
-
Enter runs it. Press `?` from an empty prompt for all
|
|
375
|
+
command menu (`/agent`, `/provider`, `/model`, `/reasoning`, `/speed`,
|
|
376
|
+
`/shortcuts`) that jumps to the same controls: arrows choose a command, `Tab`
|
|
377
|
+
completes it, and Enter runs it. Press `?` from an empty prompt for all
|
|
378
|
+
composer shortcuts.
|
|
379
|
+
|
|
380
|
+
For a Codex draft, `/provider` chooses OpenAI or a connection saved in
|
|
381
|
+
**Configure agents**. It appears when a provider choice is available. Model
|
|
382
|
+
and reasoning choices belong to the selected connection; unsupported
|
|
383
|
+
reasoning and speed controls are omitted. Reselecting the current provider
|
|
384
|
+
or model keeps the current settings. Choosing a different provider selects
|
|
385
|
+
its default model and reasoning; choosing a different model within the same
|
|
386
|
+
provider selects that model's default reasoning. Either change uses Standard
|
|
387
|
+
speed. Once the thread starts, its provider connection is fixed; supported
|
|
388
|
+
model and reasoning changes stay within that connection. An unavailable
|
|
389
|
+
connection remains selected until you reconnect it or choose another provider
|
|
390
|
+
for a new draft.
|
|
351
391
|
|
|
352
392
|
Enter starts the thread in the background, and `Ctrl+O` starts it and opens the
|
|
353
393
|
terminal interface as soon as it is ready. The Codex or Claude choice is shared
|
|
354
394
|
for the project with desktop and mobile, so a change from any surface becomes
|
|
355
|
-
the default for the next new draft on every surface.
|
|
356
|
-
speed defaults are shared per Template box or devbox. A new-devbox draft uses
|
|
395
|
+
the default for the next new draft on every surface. Provider, model, reasoning,
|
|
396
|
+
and speed defaults are shared per Template box or devbox. A new-devbox draft uses
|
|
357
397
|
the project's source defaults until the devbox exists. Claude CLI remains a
|
|
358
398
|
surface-specific Claude mode. Press `Esc` before submission to discard a blank
|
|
359
399
|
draft or keep a non-blank draft; while waiting for `Ctrl+O`, `Esc` cancels only
|
|
@@ -438,6 +478,11 @@ empty native Codex or Claude interface so you can type and submit the first
|
|
|
438
478
|
message there. If the project is omitted, the CLI auto-selects the only project
|
|
439
479
|
or shows the same project picker as `dvb agents`.
|
|
440
480
|
|
|
481
|
+
New starts use the saved agent settings for the selected box, or the project's
|
|
482
|
+
source settings for a new devbox. For Codex, those settings include its provider
|
|
483
|
+
connection, model, and reasoning. Resuming a thread keeps its existing provider
|
|
484
|
+
connection even if new-thread defaults have changed.
|
|
485
|
+
|
|
441
486
|
When starting a new thread without `--devbox`, the command creates a devbox from
|
|
442
487
|
the project's current reusable source. For an independent project, that is the
|
|
443
488
|
latest completed Template-box snapshot; if none exists, the command asks you to
|
|
@@ -309,7 +309,7 @@ box has no live metrics.
|
|
|
309
309
|
|
|
310
310
|
Choose the gear on the sidebar's **Project** header for
|
|
311
311
|
settings that belong to the project rather than to a particular box. This
|
|
312
|
-
page contains **Project storage**, **Git**, **Agent
|
|
312
|
+
page contains **Project storage**, **Browser**, **Git**, **Agent
|
|
313
313
|
permissions for this project**, **Devbox lifecycle**, and **Agent settings**,
|
|
314
314
|
including the project's preferred Git action, commit thread-link behavior,
|
|
315
315
|
startup script, shared agent guidance, automatic waking of sleeping machines,
|
|
@@ -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
|
|
|
@@ -631,7 +632,13 @@ selected.
|
|
|
631
632
|
|
|
632
633
|
Browser tabs, cookies, local storage, downloads, uploads, and other profile
|
|
633
634
|
state live on that box, so the user and agents can share the same web
|
|
634
|
-
session.
|
|
635
|
+
session. Sites see the Browser coming from a cloud data center IP address, and
|
|
636
|
+
some of them treat sign-ins or traffic from that address as suspicious.
|
|
637
|
+
**Project settings → Browser** has a **Use the Browser** switch, on by default.
|
|
638
|
+
While it's off, the Browser is hidden on every box in the project, agents there
|
|
639
|
+
can't use it (Browser API calls return HTTP 403 `agent_browser_disabled`), and
|
|
640
|
+
each box keeps its tabs and sign-ins. The
|
|
641
|
+
Browser pane supports ordinary page interaction, file chooser
|
|
635
642
|
prompts, downloads into the box, permission prompts, browser dialogs, and
|
|
636
643
|
profile reset. **Restart browser** asks for confirmation, then opens one blank
|
|
637
644
|
tab while preserving sign-ins and saved profile data. Check **Restore open
|
|
@@ -28,10 +28,18 @@ branch, usually `main`, regardless of the Template box's current branch or
|
|
|
28
28
|
files. Use another saved starting branch when the user requests it. Inheriting
|
|
29
29
|
the Template box's saved checkout should be a deliberate user choice.
|
|
30
30
|
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
31
|
+
Checking out `main` on the Template box doesn't configure the defaults. Read
|
|
32
|
+
them back from `settings.defaultBranches` in
|
|
33
|
+
`dvb-onbox project settings get --json`. If they're missing or differ from a
|
|
34
|
+
remote starting branch during setup, save the chosen branch with a
|
|
35
|
+
`default_branches` edit (see
|
|
36
|
+
[Project And Team Template Settings](onbox-agent-tools.md#project-and-team-template-settings)).
|
|
37
|
+
The setup thread doesn't need a permission grant for it; read the defaults
|
|
38
|
+
back afterwards. Leave them unsaved for a local-only branch or when an
|
|
39
|
+
intentional custom startup script switches branches itself. Don't wait for the
|
|
40
|
+
user, and say in the summary what new devboxes will start on. Follow
|
|
41
|
+
[Project setup](project-setup.md) for the setup flow's generated Git
|
|
42
|
+
declaration. Keep dependency,
|
|
35
43
|
environment, and service commands after branch preparation, and remove custom
|
|
36
44
|
commands that switch branches or reset away the selected code.
|
|
37
45
|
|
|
@@ -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
|
|
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
|
|
@@ -65,6 +73,11 @@ Devbox lifecycle → Default branch**. Clearing or restoring startup commands
|
|
|
65
73
|
keeps the branch defaults.
|
|
66
74
|
Existing projects without configured defaults can keep the branch saved in
|
|
67
75
|
the Template box snapshot by choosing **From Template box**.
|
|
76
|
+
They can also add defaults in **Project settings → Devbox lifecycle**, which
|
|
77
|
+
shows an empty branch field for each known repository and needs a branch for
|
|
78
|
+
every one. Once saved, new devboxes fetch those branches and match their latest
|
|
79
|
+
commits, discarding the snapshot's uncommitted changes and untracked files that
|
|
80
|
+
Git doesn't ignore.
|
|
68
81
|
|
|
69
82
|
Projects using the generated Git startup commands retain their existing reset
|
|
70
83
|
and clean behavior on the new devbox: tracked files match the fetched branch,
|
|
@@ -419,11 +432,10 @@ information is available. It also names the pull requests whose automatic
|
|
|
419
432
|
follow-ups the devbox's threads handle. Destroying the devbox stops those
|
|
420
433
|
follow-ups, and the pull request shows them as paused until a restored or
|
|
421
434
|
other thread turns them on again. As soon as the destroy starts, the devbox's
|
|
422
|
-
threads move
|
|
423
|
-
**Archived threads** at the end of the project on mobile
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
threads are grouped there under the destroyed devbox's name.
|
|
435
|
+
threads move under its name in **Devboxes** → **Archived threads** on desktop
|
|
436
|
+
and in **Archived threads** at the end of the project on mobile. The
|
|
437
|
+
cold-storage archive finishes in the background; if it fails, the threads
|
|
438
|
+
return to the active list untouched.
|
|
427
439
|
Archived automation runs stay in their automation's **Archived** group on
|
|
428
440
|
desktop, with their threads directly beneath the run's devbox. `dvb agents`
|
|
429
441
|
shows the threads in its archived section throughout. Preserving the
|
|
@@ -70,6 +70,9 @@ The recommended boxes.dev workflow is:
|
|
|
70
70
|
The desktop app is the main workbench. It is available for macOS
|
|
71
71
|
(`https://boxes.dev/mac`) and Linux (`https://boxes.dev/linux`, with .deb,
|
|
72
72
|
.rpm, and AppImage packages).
|
|
73
|
+
The main Mac download is for Apple Silicon and requires macOS 12 or later.
|
|
74
|
+
The included PostgreSQL tools for copying a local database require macOS 13
|
|
75
|
+
or later.
|
|
73
76
|
|
|
74
77
|
The left side is the thread list. It groups work on devboxes, automations, and,
|
|
75
78
|
when the project has one, the Template box. New-thread controls let you choose
|
|
@@ -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
|
|
|
@@ -359,12 +365,15 @@ directly from the thread. Image previews fit the available
|
|
|
359
365
|
screen and support pinch zoom and panning with inertial flings and elastic edge
|
|
360
366
|
settling.
|
|
361
367
|
|
|
362
|
-
In a devbox thread, tapping the **Devbox** pill in the header opens
|
|
363
|
-
list of
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
conflicts
|
|
368
|
+
In a devbox thread, tapping the **Devbox** pill in the header opens the
|
|
369
|
+
devbox's status and a read-only list of its Git changes. The status names the
|
|
370
|
+
state behind the pill's colored dot, such as **Running**, **Sleeping**,
|
|
371
|
+
**Waking**, **Upgrading**, or **Upgrade failed**. A red dot means the latest
|
|
372
|
+
boxes.dev update didn't install on the devbox. The Git list shows each
|
|
373
|
+
repository's branch, merge conflicts, commits that haven't been pushed, and
|
|
374
|
+
changed files with added and removed line counts. Tapping a changed file opens
|
|
375
|
+
its diff in the file viewer. A warning icon in the pill or the thread row means
|
|
376
|
+
a repository has unresolved merge conflicts.
|
|
368
377
|
|
|
369
378
|
Large downloads may open through the browser, and they arrive with the file's
|
|
370
379
|
real name and extension so your phone can open them in the right app. Full
|
|
@@ -389,7 +398,8 @@ Choose **… → Browser** in a thread's header to open Browser on that
|
|
|
389
398
|
thread's devbox or Template box, waking it if it's asleep. It is the same
|
|
390
399
|
Chromium session as the desktop Browser pane, with the same tabs, signed-in
|
|
391
400
|
sites, and profile, and agents on the box use it too. If the box's browser
|
|
392
|
-
isn't running yet, opening Browser starts it.
|
|
401
|
+
isn't running yet, opening Browser starts it. The menu leaves out **Browser**
|
|
402
|
+
while the project's Browser is turned off in Project settings.
|
|
393
403
|
|
|
394
404
|
Opening Browser on a phone resizes that shared browser to the phone's page
|
|
395
405
|
area, so sites use their narrow-screen layout. It is a size change only: sites
|
|
@@ -485,12 +495,14 @@ exceptions listed after this list:
|
|
|
485
495
|
- under **Project**: **Devbox lifecycle** (agent guidance, startup and
|
|
486
496
|
teardown scripts with their timeouts, the first prompt prefix, and the
|
|
487
497
|
default branch new devboxes check out for each repository, each edited on
|
|
488
|
-
its own screen
|
|
498
|
+
its own screen; a project without saved branches sets the first ones for
|
|
499
|
+
every repository on one screen), **Environment files** (set, replace, or remove
|
|
489
500
|
values and variables in files already added; in a Team Template project,
|
|
490
501
|
the member's values, their own variables, and their own replacement for a
|
|
491
502
|
Team value where the team allows one), **Member files** (Team
|
|
492
503
|
Template projects only: upload, replace, approve at a moved destination, or
|
|
493
|
-
remove), **Project storage**,
|
|
504
|
+
remove), **Project storage**, **Browser** (the **Use the Browser** switch
|
|
505
|
+
described in `desktop-workbench.md`), and **Git** (preferred Git action, thread links
|
|
494
506
|
in commits, automatic pull request follow-ups, and the default follow-up
|
|
495
507
|
events);
|
|
496
508
|
- under **Integrations**, which matches the desktop app's Integrations tool:
|
|
@@ -512,7 +524,8 @@ include:
|
|
|
512
524
|
|
|
513
525
|
- account sign-in and sign-out, adding another account, and switching between
|
|
514
526
|
signed-in accounts;
|
|
515
|
-
- **Agent accounts**, for the Codex and Claude accounts
|
|
527
|
+
- **Agent accounts**, for the Codex and Claude accounts and Codex model
|
|
528
|
+
providers your devboxes use;
|
|
516
529
|
- billing usage summary;
|
|
517
530
|
- an invite link and QR code you can share with someone who wants to try
|
|
518
531
|
boxes.dev (the same link is on the Account page in the web app);
|
|
@@ -521,6 +534,9 @@ include:
|
|
|
521
534
|
- theme, monospace font, and thread text size;
|
|
522
535
|
- **Sort threads**, the thread list order shared with desktop (see
|
|
523
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);
|
|
524
540
|
- **Project view**: **Recent** (the default) lists a project's devboxes by
|
|
525
541
|
date, and **Folders** groups them into the user's desktop folders. It is
|
|
526
542
|
saved on the account and applies only to the mobile app; desktop always
|
|
@@ -560,6 +576,22 @@ login is saved, the **Allow claude.ai connectors** switch below the Claude
|
|
|
560
576
|
accounts controls whether Claude can use the connectors added on claude.ai. A
|
|
561
577
|
change takes effect the next time Claude starts.
|
|
562
578
|
|
|
579
|
+
For OpenRouter, Vercel AI Gateway or a custom endpoint, tap **Add** beside Codex,
|
|
580
|
+
then **Model provider**. Tap **Provider** to choose the host, enter the API key
|
|
581
|
+
and an optional connection name, then tap **Save**. **Custom endpoint
|
|
582
|
+
(advanced)** also requires a base URL, model ID and context size; leave its key
|
|
583
|
+
empty only when the endpoint requires no authentication. Saving validates the
|
|
584
|
+
configuration without making an inference request.
|
|
585
|
+
|
|
586
|
+
Model providers appear below the OpenAI accounts, without an account-selection
|
|
587
|
+
checkmark. Tap a provider row for **Rename**, **Replace key**, or **Disconnect**.
|
|
588
|
+
After disconnecting, **Reconnect** will accept a replacement key for the same
|
|
589
|
+
connection. **Remove connection** will delete a disconnected or no-auth
|
|
590
|
+
connection; its existing threads will remain readable, but continuing work
|
|
591
|
+
will need a new thread. Model-provider keys and the selected OpenAI account
|
|
592
|
+
remain available independently. See `threads-and-agents.md`, Codex model
|
|
593
|
+
providers, for supported models, billing and endpoint requirements.
|
|
594
|
+
|
|
563
595
|
To sign in to Codex, tap **Log in with ChatGPT**. The app shows a one-time
|
|
564
596
|
code, and **Open ChatGPT** copies it and opens the ChatGPT device sign-in page.
|
|
565
597
|
Sign in there if asked and paste the code. Codex will connect after you
|
|
@@ -611,8 +643,9 @@ you approve access, the window will close and the agent will show
|
|
|
611
643
|
**Connected**; boxes.dev applies the sign-in to all of the project's
|
|
612
644
|
devboxes, including sleeping ones when they wake. If the app can't receive the
|
|
613
645
|
sign-in directly, it opens the page in your browser instead. After you
|
|
614
|
-
approve, the browser will show a
|
|
615
|
-
address, paste it into the app, and
|
|
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**.
|
|
616
649
|
|
|
617
650
|
The MCPs screen requires an updated mobile app; an older installed app needs an
|
|
618
651
|
app-store update.
|