@boxes-dev/dvb-runtime 1.0.1105 → 1.0.1107

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/bin/dvbd.mjs CHANGED
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
 
3
- !function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="e0a9c17c-a865-5681-a514-632ec7b02f34")}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]="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, isIpv6LoopbackAvailable, listenOnLoopbackPort;
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
- isIpv6LoopbackAvailable = async (port) => await new Promise((resolve2, reject) => {
4091
+ probeIpv6Loopback = async (port) => await new Promise((resolve2, reject) => {
4092
4092
  const server = net.createServer();
4093
4093
  let settled = false;
4094
- const finalize2 = (available) => {
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(available);
4104
+ resolve2(state);
4105
4105
  return;
4106
4106
  }
4107
- server.close(() => resolve2(available));
4107
+ server.close(() => resolve2(state));
4108
4108
  };
4109
4109
  server.once("error", (error4) => {
4110
- if (error4.code === "EAFNOSUPPORT" || error4.code === "EADDRNOTAVAIL" || error4.code === "EADDRINUSE" || error4.code === "EACCES") {
4111
- finalize2(false);
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(true);
4121
+ finalize2("available");
4118
4122
  });
4119
4123
  try {
4120
4124
  server.listen({ host: "::1", port });
4121
4125
  } catch {
4122
- finalize2(false);
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 ipv6Available = await isIpv6LoopbackAvailable(targetPort);
4149
- if (!ipv6Available) {
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.1105";
64679
- const rawGitSha = "d46fc24460fe8e0aad75a5d122a6b22996bb45a4";
64680
- const rawSentryRelease = "boxes-dev-dvb@1.0.1105+d46fc24460fe8e0aad75a5d122a6b22996bb45a4";
64682
+ const rawPackageVersion = "1.0.1107";
64683
+ const rawGitSha = "636b188006eb986b8be609e74b6a73eb93bc3eb4";
64684
+ const rawSentryRelease = "boxes-dev-dvb@1.0.1107+636b188006eb986b8be609e74b6a73eb93bc3eb4";
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.1105";
67206
+ const raw = "1.0.1107";
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 = 3e4;
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=e0a9c17c-a865-5681-a514-632ec7b02f34
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`; set it to `fast` to use Fast mode.
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 before a run is
201
- created. The API does not accept raw Codex or Claude CLI arguments.
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`, `/shortcuts`) that
349
- jumps to the same controls: arrows choose a command, `Tab` completes it, and
350
- Enter runs it. Press `?` from an empty prompt for all composer shortcuts.
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. Model, reasoning, and
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,
@@ -631,7 +631,13 @@ selected.
631
631
 
632
632
  Browser tabs, cookies, local storage, downloads, uploads, and other profile
633
633
  state live on that box, so the user and agents can share the same web
634
- session. The Browser pane supports ordinary page interaction, file chooser
634
+ session. Sites see the Browser coming from a cloud data center IP address, and
635
+ some of them treat sign-ins or traffic from that address as suspicious.
636
+ **Project settings → Browser** has a **Use the Browser** switch, on by default.
637
+ While it's off, the Browser is hidden on every box in the project, agents there
638
+ can't use it (Browser API calls return HTTP 403 `agent_browser_disabled`), and
639
+ each box keeps its tabs and sign-ins. The
640
+ Browser pane supports ordinary page interaction, file chooser
635
641
  prompts, downloads into the box, permission prompts, browser dialogs, and
636
642
  profile reset. **Restart browser** asks for confirmation, then opens one blank
637
643
  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
- Read back the project's branch defaults; checking out `main` on the Template
32
- box alone does not configure them. Follow
33
- [Project setup](project-setup.md) for the setup
34
- flow's supported controls and generated Git declaration. Keep dependency,
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
 
@@ -65,6 +65,11 @@ Devbox lifecycle → Default branch**. Clearing or restoring startup commands
65
65
  keeps the branch defaults.
66
66
  Existing projects without configured defaults can keep the branch saved in
67
67
  the Template box snapshot by choosing **From Template box**.
68
+ They can also add defaults in **Project settings → Devbox lifecycle**, which
69
+ shows an empty branch field for each known repository and needs a branch for
70
+ every one. Once saved, new devboxes fetch those branches and match their latest
71
+ commits, discarding the snapshot's uncommitted changes and untracked files that
72
+ Git doesn't ignore.
68
73
 
69
74
  Projects using the generated Git startup commands retain their existing reset
70
75
  and clean behavior on the new devbox: tracked files match the fetched branch,
@@ -419,11 +424,10 @@ information is available. It also names the pull requests whose automatic
419
424
  follow-ups the devbox's threads handle. Destroying the devbox stops those
420
425
  follow-ups, and the pull request shows them as paused until a restored or
421
426
  other thread turns them on again. As soon as the destroy starts, the devbox's
422
- threads move to **Devboxes** → **Archived threads** on desktop and to
423
- **Archived threads** at the end of the project on mobile, on every device,
424
- while the cold-storage archive finishes in the background. If archiving fails,
425
- the threads return to the active list untouched. Once the devbox is gone, its
426
- threads are grouped there under the destroyed devbox's name.
427
+ threads move under its name in **Devboxes** → **Archived threads** on desktop
428
+ and in **Archived threads** at the end of the project on mobile. The
429
+ cold-storage archive finishes in the background; if it fails, the threads
430
+ return to the active list untouched.
427
431
  Archived automation runs stay in their automation's **Archived** group on
428
432
  desktop, with their threads directly beneath the run's devbox. `dvb agents`
429
433
  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
@@ -359,12 +359,15 @@ directly from the thread. Image previews fit the available
359
359
  screen and support pinch zoom and panning with inertial flings and elastic edge
360
360
  settling.
361
361
 
362
- In a devbox thread, tapping the **Devbox** pill in the header opens a read-only
363
- list of the devbox's Git changes: each repository's branch, merge conflicts,
364
- commits that haven't been pushed, and changed files with added and removed line
365
- counts. Tapping a changed file opens its diff in the file viewer. A warning
366
- icon in the pill or the thread row means a repository has unresolved merge
367
- conflicts.
362
+ In a devbox thread, tapping the **Devbox** pill in the header opens the
363
+ devbox's status and a read-only list of its Git changes. The status names the
364
+ state behind the pill's colored dot, such as **Running**, **Sleeping**,
365
+ **Waking**, **Upgrading**, or **Upgrade failed**. A red dot means the latest
366
+ boxes.dev update didn't install on the devbox. The Git list shows each
367
+ repository's branch, merge conflicts, commits that haven't been pushed, and
368
+ changed files with added and removed line counts. Tapping a changed file opens
369
+ its diff in the file viewer. A warning icon in the pill or the thread row means
370
+ a repository has unresolved merge conflicts.
368
371
 
369
372
  Large downloads may open through the browser, and they arrive with the file's
370
373
  real name and extension so your phone can open them in the right app. Full
@@ -389,7 +392,8 @@ Choose **… → Browser** in a thread's header to open Browser on that
389
392
  thread's devbox or Template box, waking it if it's asleep. It is the same
390
393
  Chromium session as the desktop Browser pane, with the same tabs, signed-in
391
394
  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.
395
+ isn't running yet, opening Browser starts it. The menu leaves out **Browser**
396
+ while the project's Browser is turned off in Project settings.
393
397
 
394
398
  Opening Browser on a phone resizes that shared browser to the phone's page
395
399
  area, so sites use their narrow-screen layout. It is a size change only: sites
@@ -485,12 +489,14 @@ exceptions listed after this list:
485
489
  - under **Project**: **Devbox lifecycle** (agent guidance, startup and
486
490
  teardown scripts with their timeouts, the first prompt prefix, and the
487
491
  default branch new devboxes check out for each repository, each edited on
488
- its own screen), **Environment files** (set, replace, or remove
492
+ its own screen; a project without saved branches sets the first ones for
493
+ every repository on one screen), **Environment files** (set, replace, or remove
489
494
  values and variables in files already added; in a Team Template project,
490
495
  the member's values, their own variables, and their own replacement for a
491
496
  Team value where the team allows one), **Member files** (Team
492
497
  Template projects only: upload, replace, approve at a moved destination, or
493
- remove), **Project storage**, and **Git** (preferred Git action, thread links
498
+ remove), **Project storage**, **Browser** (the **Use the Browser** switch
499
+ described in `desktop-workbench.md`), and **Git** (preferred Git action, thread links
494
500
  in commits, automatic pull request follow-ups, and the default follow-up
495
501
  events);
496
502
  - under **Integrations**, which matches the desktop app's Integrations tool:
@@ -512,7 +518,8 @@ include:
512
518
 
513
519
  - account sign-in and sign-out, adding another account, and switching between
514
520
  signed-in accounts;
515
- - **Agent accounts**, for the Codex and Claude accounts your devboxes use;
521
+ - **Agent accounts**, for the Codex and Claude accounts and Codex model
522
+ providers your devboxes use;
516
523
  - billing usage summary;
517
524
  - an invite link and QR code you can share with someone who wants to try
518
525
  boxes.dev (the same link is on the Account page in the web app);
@@ -560,6 +567,22 @@ login is saved, the **Allow claude.ai connectors** switch below the Claude
560
567
  accounts controls whether Claude can use the connectors added on claude.ai. A
561
568
  change takes effect the next time Claude starts.
562
569
 
570
+ For OpenRouter, Vercel AI Gateway or a custom endpoint, tap **Add** beside Codex,
571
+ then **Model provider**. Tap **Provider** to choose the host, enter the API key
572
+ and an optional connection name, then tap **Save**. **Custom endpoint
573
+ (advanced)** also requires a base URL, model ID and context size; leave its key
574
+ empty only when the endpoint requires no authentication. Saving validates the
575
+ configuration without making an inference request.
576
+
577
+ Model providers appear below the OpenAI accounts, without an account-selection
578
+ checkmark. Tap a provider row for **Rename**, **Replace key**, or **Disconnect**.
579
+ After disconnecting, **Reconnect** will accept a replacement key for the same
580
+ connection. **Remove connection** will delete a disconnected or no-auth
581
+ connection; its existing threads will remain readable, but continuing work
582
+ will need a new thread. Model-provider keys and the selected OpenAI account
583
+ remain available independently. See `threads-and-agents.md`, Codex model
584
+ providers, for supported models, billing and endpoint requirements.
585
+
563
586
  To sign in to Codex, tap **Log in with ChatGPT**. The app shows a one-time
564
587
  code, and **Open ChatGPT** copies it and opens the ChatGPT device sign-in page.
565
588
  Sign in there if asked and paste the code. Codex will connect after you