@boxes-dev/dvb-runtime 1.0.1103 → 1.0.1105

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.
Files changed (33) hide show
  1. package/dist/agent-init-guides/agent-config.md +34 -0
  2. package/dist/agent-init-guides/app.md +6 -5
  3. package/dist/agent-init-guides/flow.md +72 -12
  4. package/dist/agent-init-guides/git-ssh.md +9 -4
  5. package/dist/agent-init-guides/manifest.md +6 -0
  6. package/dist/agent-init-guides/recovery.md +22 -0
  7. package/dist/agent-init-guides/running.md +12 -0
  8. package/dist/agent-init-guides/untracked.md +2 -1
  9. package/dist/bin/dvb.mjs +1228 -1758
  10. package/dist/bin/dvbd.mjs +6 -6
  11. package/dist/product-docs/references/agent-tools.md +32 -5
  12. package/dist/product-docs/references/automations.md +18 -3
  13. package/dist/product-docs/references/cli.md +6 -4
  14. package/dist/product-docs/references/core-concepts.md +1 -1
  15. package/dist/product-docs/references/desktop-workbench.md +28 -3
  16. package/dist/product-docs/references/environment-setup-validation.md +22 -0
  17. package/dist/product-docs/references/files-git-and-review.md +32 -18
  18. package/dist/product-docs/references/fork-workflows.md +6 -3
  19. package/dist/product-docs/references/getting-started.md +2 -1
  20. package/dist/product-docs/references/index.md +2 -1
  21. package/dist/product-docs/references/linear.md +15 -0
  22. package/dist/product-docs/references/member-managed-files.md +2 -1
  23. package/dist/product-docs/references/mobile.md +63 -17
  24. package/dist/product-docs/references/onbox-agent-tools.md +224 -66
  25. package/dist/product-docs/references/ports-terminal-and-runtime.md +5 -3
  26. package/dist/product-docs/references/project-setup.md +67 -17
  27. package/dist/product-docs/references/security-and-data.md +3 -2
  28. package/dist/product-docs/references/slack.md +8 -5
  29. package/dist/product-docs/references/threads-and-agents.md +25 -8
  30. package/dist/product-docs/references/troubleshooting.md +7 -5
  31. package/dist/product-docs/references/unattended-work.md +5 -0
  32. package/dist/prompts/local-services-scan.md +3 -4
  33. package/package.json +2 -2
@@ -72,8 +72,9 @@ temporary storage that only the user's account can use. boxes.dev deletes it
72
72
  once the Template box has copied the threads, or when the import fails or the
73
73
  upload goes unused.
74
74
 
75
- Untracked disposable agent checkouts under `.claude/worktrees` and
76
- `.codex/worktrees` are unchecked by default in the setup bundle review. Users
75
+ Untracked Git worktrees inside a repository, including disposable agent
76
+ checkouts under `.claude/worktrees` and `.codex/worktrees`, are unchecked by
77
+ default in the setup bundle review. Users
77
78
  can explicitly include all or selected worktrees when they need them; adjacent
78
79
  agent settings and unrelated project directories remain included.
79
80
 
@@ -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.
96
-
97
- If boxes.dev cannot match your Slack user, verify your boxes.dev email and try
98
- again from Slack.
94
+ whatever email your Slack profile uses.
95
+
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
 
@@ -293,10 +293,13 @@ Supported remote HTTP commands are another entry point to the same list. Running
293
293
  a command such as `codex mcp add <name> --url <url>` or `claude mcp add
294
294
  --transport http <name> <url>` in a Template box or devbox creates the central
295
295
  current-project connection. It does not create a separate machine-only copy.
296
- When the server uses OAuth, the command will try to open sign-in in your
297
- browser and will print a `dvb mcp authorize` command. If the browser doesn't
298
- open, run that command in a terminal on your own computer, not on the box. To enable both agents, run each agent's setup command with
299
- the same name, URL, and authentication details, including any API-key headers.
296
+ When the server uses OAuth, the command will print a boxes.dev sign-in link
297
+ and a `dvb mcp authorize` command, and it will try to open the link in your
298
+ browser. If the browser doesn't open, open the link yourself, or run that
299
+ command in a terminal on your own computer, not on the box. An agent that runs
300
+ the command for you will give you the link. To enable both agents, run each
301
+ agent's setup command with the same name, URL, and authentication details,
302
+ including any API-key headers.
300
303
  The second command will add its agent to the existing project connection;
301
304
  repeating either command will keep the existing connection and sign-in. OAuth
302
305
  still requires authorization for each agent. For an **All projects** connection
@@ -1097,6 +1100,16 @@ to finish or use the runtime controls if the whole runtime is stuck.
1097
1100
  The desktop thread list groups work by devboxes, automations, and, when the
1098
1101
  project has one, Template-box threads.
1099
1102
 
1103
+ On desktop, a devbox folder is a row with an open or closed folder icon, the
1104
+ folder's name, and its devbox count. A closed folder also shows the most
1105
+ urgent state among its threads, such as running, needs input, or unread. While
1106
+ the user scrolls through an open folder, its row stays pinned below the
1107
+ **Devboxes** heading until the next folder or the unfiled devboxes reach it.
1108
+ **Sidebar density**, under **Appearance and layout** in **Settings > General**,
1109
+ sets the thread list's spacing to **Comfortable** (the default), **Cozy**, or
1110
+ **Compact**. It is saved on that computer only, and **Restore appearance and
1111
+ layout defaults** returns it to Comfortable.
1112
+
1100
1113
  Thread sections include pinned and recent chats. On desktop, drag pinned
1101
1114
  threads or devboxes to rearrange them within their **Pinned** section. The order
1102
1115
  will sync across devices. A grouped devbox moves with its threads. Template
@@ -1210,10 +1223,14 @@ section. The thread's permanent `/thread/` link is different: it identifies
1210
1223
  the thread for Team work, Git history, and the CLI, but does not grant access
1211
1224
  or save the thread by itself.
1212
1225
  It always applies the current team policy, privacy setting, and share access.
1213
- On a shared-thread browser page, choose **Open in app** to open the same
1214
- read-only thread in the desktop app, or in the mobile app when viewed on a
1215
- phone or tablet. If the viewer has never signed in to that app, the button
1216
- opens a page with a download option instead.
1226
+ On a shared-thread or `/thread/` browser page, choose **Open in app** to open
1227
+ the thread in the desktop app, or in the mobile app when viewed on a phone or
1228
+ tablet. The owner's own thread opens as their ordinary thread. A teammate's
1229
+ `/thread/` page offers the button only in a desktop browser, because the mobile
1230
+ app cannot open a teammate's thread from a link. If the viewer has never signed
1231
+ in to that app, the button opens a page with a download option instead. Inside
1232
+ the desktop app, clicking a boxes.dev `/thread/` link or share link opens the
1233
+ thread in the app rather than in the browser.
1217
1234
 
1218
1235
  To save an ordinary Team work thread, choose **Pin to my workbench**. A
1219
1236
  teammate's thread has a `…` menu in its header and on its **Shared with me**
@@ -423,8 +423,9 @@ project that uses that separate access method.
423
423
 
424
424
  If a repository or API request is still rejected while `gh` is enabled, use
425
425
  **Manage repository access** to check App access, and reconnect GitHub if the
426
- page requests it. If your organization cannot approve the App, choose **Use
427
- personal access** and authorize the official GitHub CLI. Personal access is
426
+ page requests it. If your organization cannot approve the App, choose
427
+ **Connect personal access** under **GitHub CLI access** and authorize the
428
+ official GitHub CLI. Personal access is
428
429
  also available when App repository access works but a command needs broader
429
430
  permissions. Without personal access, boxes.dev checks that the App can reach
430
431
  every known project repository before issuing its credential. With personal
@@ -459,7 +460,7 @@ its original error if the command is denied.
459
460
 
460
461
  For issue changes or publishing check results, ask the installation owner to
461
462
  approve Issues and Checks read and write, then retry. The App also requests
462
- read-only access to deployments and organization members. Reading the user's
463
+ read-only access to deployments. Reading the user's
463
464
  account email addresses requires that user's approval of the updated GitHub
464
465
  authorization. Choose **Update connection** in **Account** or **Integrations →
465
466
  GitHub** to review and approve it.
@@ -472,8 +473,9 @@ optional personal access may provide the required permission. Do not change
472
473
  credentials automatically after a command fails.
473
474
 
474
475
  To let `gh` use the user's own GitHub permissions, connect optional personal
475
- access. In **Account** settings or **Integrations → GitHub**, choose **Enable**
476
- under **Full GitHub CLI access (optional)**. Alternatively, run `gh auth login`
476
+ access. In **Integrations → GitHub**, choose **Connect personal access** under
477
+ **GitHub CLI access**; in **Account** settings, choose **Connect** under
478
+ **Personal GitHub CLI access (optional)**. Alternatively, run `gh auth login`
477
479
  on the Template box or devbox. It will print a one-time code and a GitHub
478
480
  approval URL, then wait until the user approves with the GitHub account
479
481
  connected to boxes.dev. An agent that runs it should give the user the code and
@@ -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
@@ -29,7 +29,7 @@ Important requirements (read carefully):
29
29
  What to find:
30
30
 
31
31
  - `appEntrypoints`: the primary command(s) a developer runs from the project root to start the app locally (long-running dev servers, watchers, "run the app" commands). If local dev requires multiple terminals (e.g. "backend" + "frontend"), include each as a separate entry with a clear description.
32
- - `backgroundServices`: supporting services expected to be running for local dev (database, cache, queue, search, object storage emulator, auth emulator, etc). Prefer the repo's canonical way to start them (compose, just, make, scripts). `httpPort` is only for HTTP services that should be reverse-proxied; for non-HTTP services (Postgres/Redis/etc), use `null` even if they expose other ports.
32
+ - `backgroundServices`: supporting services expected to be running for local dev (database, cache, queue, search, object storage emulator, auth emulator, etc). Prefer the repo's canonical way to start them (compose, just, make, scripts). `httpPort` is the port an HTTP service listens on; for non-HTTP services (Postgres/Redis/etc), use `null` even if they expose other ports.
33
33
 
34
34
  Minimum evidence to gather (run these, plus anything else you need):
35
35
 
@@ -80,8 +80,7 @@ How to decide what to output (avoid noise):
80
80
  - Example: if `npm run dev` already starts the backend process, do not also list that backend command as a background service.
81
81
  - Every background-service `name` must be a unique machine identifier matching `^[A-Za-z0-9._-]+$`. Use names such as `postgres`, `atlas-local`, or `pubsub_emulator`; do not use spaces, parentheses, or human-readable annotations.
82
82
  - Every `command` must contain only the exact executable shell command. Never append explanations or parenthetical notes to the command string.
83
- - For compose-defined background dependencies, list them under `backgroundServices` with commands like:
84
- - `docker compose up -d <service>` (or `docker-compose up -d <service>` if that's what's documented)
83
+ - For compose-defined background dependencies, use the compose command the repo documents for starting them.
85
84
  - Do not invent service names; use names found in compose files / docs.
86
85
  - For background services started via just/make/task, use those commands (for example: `just db`, `make redis`, `task up`), but only if present and documented in the repo.
87
86
 
@@ -99,6 +98,6 @@ Return JSON with this shape:
99
98
  - backgroundServices: [{ name, command, httpPort }]
100
99
  - name must be a unique machine identifier matching `^[A-Za-z0-9._-]+$` (e.g. "postgres" or "atlas-local")
101
100
  - command must be the exact executable command string to start the service, without commentary
102
- - httpPort is the HTTP port for proxy routing, or null if not applicable/unknown
101
+ - httpPort is the service's HTTP port, or null if not applicable/unknown
103
102
 
104
103
  Return only JSON that matches the provided schema.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@boxes-dev/dvb-runtime",
3
- "version": "1.0.1103",
3
+ "version": "1.0.1105",
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-23T15:08:28Z"
80
+ "devboxReleasedAt": "2026-10-26T23:50:05Z"
81
81
  }