@boxes-dev/dvb-runtime 1.0.1052 → 1.0.1054

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]="a9afcb43-4806-5154-9842-36529ed47771")}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]="7d72dc90-582f-5b5e-adc3-cf59e376ab6d")}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";
@@ -45,13 +45,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
45
45
  mod
46
46
  ));
47
47
 
48
- // ../../../../shared/devboxCore/dist/directMoshProtocol.js
49
- var init_directMoshProtocol = __esm({
50
- "../../../../shared/devboxCore/dist/directMoshProtocol.js"() {
51
- "use strict";
52
- }
53
- });
54
-
55
48
  // ../../../../node_modules/ws/lib/constants.js
56
49
  var require_constants = __commonJS({
57
50
  "../../../../node_modules/ws/lib/constants.js"(exports, module2) {
@@ -23924,6 +23917,68 @@ var init_mcpOAuth = __esm({
23924
23917
  }
23925
23918
  });
23926
23919
 
23920
+ // ../../../../shared/devboxCore/dist/codexChatGptAuthJson.js
23921
+ var init_codexChatGptAuthJson = __esm({
23922
+ "../../../../shared/devboxCore/dist/codexChatGptAuthJson.js"() {
23923
+ "use strict";
23924
+ }
23925
+ });
23926
+
23927
+ // ../../../../shared/devboxCore/dist/codexManagedAuth.js
23928
+ var init_codexManagedAuth = __esm({
23929
+ "../../../../shared/devboxCore/dist/codexManagedAuth.js"() {
23930
+ "use strict";
23931
+ }
23932
+ });
23933
+
23934
+ // ../../../../shared/devboxCore/dist/codexOAuthParams.js
23935
+ var CODEX_OAUTH_ISSUER, CODEX_OAUTH_AUTHORIZE_URL, CODEX_OAUTH_TOKEN_URL;
23936
+ var init_codexOAuthParams = __esm({
23937
+ "../../../../shared/devboxCore/dist/codexOAuthParams.js"() {
23938
+ "use strict";
23939
+ CODEX_OAUTH_ISSUER = "https://auth.openai.com";
23940
+ CODEX_OAUTH_AUTHORIZE_URL = `${CODEX_OAUTH_ISSUER}/oauth/authorize`;
23941
+ CODEX_OAUTH_TOKEN_URL = `${CODEX_OAUTH_ISSUER}/oauth/token`;
23942
+ }
23943
+ });
23944
+
23945
+ // ../../../../shared/devboxCore/dist/boxesLogoSvg.js
23946
+ var init_boxesLogoSvg = __esm({
23947
+ "../../../../shared/devboxCore/dist/boxesLogoSvg.js"() {
23948
+ "use strict";
23949
+ }
23950
+ });
23951
+
23952
+ // ../../../../shared/devboxCore/dist/oauthCallbackPage.js
23953
+ var init_oauthCallbackPage = __esm({
23954
+ "../../../../shared/devboxCore/dist/oauthCallbackPage.js"() {
23955
+ "use strict";
23956
+ init_boxesLogoSvg();
23957
+ }
23958
+ });
23959
+
23960
+ // ../../../../shared/devboxCore/dist/chatGptBrowserSignIn.js
23961
+ var DEFAULT_TIMEOUT_MS;
23962
+ var init_chatGptBrowserSignIn = __esm({
23963
+ "../../../../shared/devboxCore/dist/chatGptBrowserSignIn.js"() {
23964
+ "use strict";
23965
+ init_codexChatGptAuthJson();
23966
+ init_codexManagedAuth();
23967
+ init_codexOAuthParams();
23968
+ init_oauthCallbackPage();
23969
+ DEFAULT_TIMEOUT_MS = 10 * 6e4;
23970
+ }
23971
+ });
23972
+
23973
+ // ../../../../shared/devboxCore/dist/claudeOAuthParams.js
23974
+ var CLAUDE_SETUP_TOKEN_EXPIRES_IN_SECONDS;
23975
+ var init_claudeOAuthParams = __esm({
23976
+ "../../../../shared/devboxCore/dist/claudeOAuthParams.js"() {
23977
+ "use strict";
23978
+ CLAUDE_SETUP_TOKEN_EXPIRES_IN_SECONDS = 365 * 24 * 60 * 60;
23979
+ }
23980
+ });
23981
+
23927
23982
  // ../../../../shared/devboxCore/dist/agentConfigImport/types.js
23928
23983
  var init_types2 = __esm({
23929
23984
  "../../../../shared/devboxCore/dist/agentConfigImport/types.js"() {
@@ -64612,9 +64667,9 @@ var init_sentry = __esm({
64612
64667
  uncaughtExceptionMonitorInstalled = false;
64613
64668
  currentDevboxSentryUser = null;
64614
64669
  readBuildMetadata = () => {
64615
- const rawPackageVersion = "1.0.1052";
64616
- const rawGitSha = "6e5360aed3f79e9b0b4d34adaaea7b174277c4d7";
64617
- const rawSentryRelease = "boxes-dev-dvb@1.0.1052+6e5360aed3f79e9b0b4d34adaaea7b174277c4d7";
64670
+ const rawPackageVersion = "1.0.1054";
64671
+ const rawGitSha = "4a244bb28514548cb1ff7c63ae7ddd26e23079ad";
64672
+ const rawSentryRelease = "boxes-dev-dvb@1.0.1054+4a244bb28514548cb1ff7c63ae7ddd26e23079ad";
64618
64673
  const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
64619
64674
  const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
64620
64675
  const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
@@ -66473,6 +66528,112 @@ var init_npmCli = __esm({
66473
66528
  }
66474
66529
  });
66475
66530
 
66531
+ // ../../../../shared/devboxCore/dist/packageUpdates.js
66532
+ import fs5 from "node:fs/promises";
66533
+ import os5 from "node:os";
66534
+ import path6 from "node:path";
66535
+ var createEmptyCache, resolvePackageUpdateCacheDir, resolvePackageUpdateCachePath, ensureCacheDir, writeJsonAtomic, parseEntry, loadPackageUpdateCache, savePackageUpdateCache, writeCachedPackageVersion;
66536
+ var init_packageUpdates = __esm({
66537
+ "../../../../shared/devboxCore/dist/packageUpdates.js"() {
66538
+ "use strict";
66539
+ init_config();
66540
+ createEmptyCache = () => ({
66541
+ version: 1,
66542
+ packages: {}
66543
+ });
66544
+ resolvePackageUpdateCacheDir = (homeDir = os5.homedir()) => path6.join(resolveDevboxDir(homeDir), "cache");
66545
+ resolvePackageUpdateCachePath = (homeDir = os5.homedir()) => path6.join(resolvePackageUpdateCacheDir(homeDir), "package-updates.json");
66546
+ ensureCacheDir = async (homeDir) => {
66547
+ const dir = resolvePackageUpdateCacheDir(homeDir);
66548
+ await fs5.mkdir(dir, { recursive: true, mode: 448 });
66549
+ try {
66550
+ await fs5.chmod(dir, 448);
66551
+ } catch {
66552
+ }
66553
+ return dir;
66554
+ };
66555
+ writeJsonAtomic = async (filePath, payload) => {
66556
+ const dir = path6.dirname(filePath);
66557
+ const tempPath = path6.join(dir, `.tmp-${path6.basename(filePath)}-${Date.now()}`);
66558
+ await fs5.writeFile(tempPath, JSON.stringify(payload, null, 2), {
66559
+ mode: 384
66560
+ });
66561
+ await fs5.rename(tempPath, filePath);
66562
+ try {
66563
+ await fs5.chmod(filePath, 384);
66564
+ } catch {
66565
+ }
66566
+ };
66567
+ parseEntry = (value) => {
66568
+ if (!value || typeof value !== "object")
66569
+ return null;
66570
+ const record2 = value;
66571
+ if (typeof record2.latestVersion !== "string")
66572
+ return null;
66573
+ if (typeof record2.checkedAt !== "string")
66574
+ return null;
66575
+ const latestVersion = record2.latestVersion.trim();
66576
+ const checkedAt = record2.checkedAt.trim();
66577
+ if (!latestVersion || !checkedAt)
66578
+ return null;
66579
+ return { latestVersion, checkedAt };
66580
+ };
66581
+ loadPackageUpdateCache = async (options = {}) => {
66582
+ const filePath = resolvePackageUpdateCachePath(options.homeDir);
66583
+ try {
66584
+ const raw = await fs5.readFile(filePath, "utf8");
66585
+ const parsed = JSON.parse(raw);
66586
+ if (!parsed || parsed.version !== 1)
66587
+ return createEmptyCache();
66588
+ if (!parsed.packages || typeof parsed.packages !== "object") {
66589
+ return createEmptyCache();
66590
+ }
66591
+ const packages = {};
66592
+ for (const [packageName, entryValue] of Object.entries(parsed.packages)) {
66593
+ const entry = parseEntry(entryValue);
66594
+ if (!entry)
66595
+ continue;
66596
+ packages[packageName] = entry;
66597
+ }
66598
+ return {
66599
+ version: 1,
66600
+ packages
66601
+ };
66602
+ } catch (error4) {
66603
+ if (error4 instanceof Error && "code" in error4 && error4.code === "ENOENT") {
66604
+ return createEmptyCache();
66605
+ }
66606
+ throw error4;
66607
+ }
66608
+ };
66609
+ savePackageUpdateCache = async (cache, options = {}) => {
66610
+ await ensureCacheDir(options.homeDir);
66611
+ const filePath = resolvePackageUpdateCachePath(options.homeDir);
66612
+ await writeJsonAtomic(filePath, cache);
66613
+ };
66614
+ writeCachedPackageVersion = async (packageName, latestVersion, options = {}) => {
66615
+ const trimmedPackageName = packageName.trim();
66616
+ const trimmedVersion = latestVersion.trim();
66617
+ if (!trimmedPackageName || !trimmedVersion)
66618
+ return;
66619
+ const cache = await loadPackageUpdateCache(options);
66620
+ cache.packages[trimmedPackageName] = {
66621
+ latestVersion: trimmedVersion,
66622
+ checkedAt: options.checkedAt ?? (/* @__PURE__ */ new Date()).toISOString()
66623
+ };
66624
+ await savePackageUpdateCache(cache, options);
66625
+ };
66626
+ }
66627
+ });
66628
+
66629
+ // ../../../../shared/devboxCore/dist/managedCodexVersions.js
66630
+ var init_managedCodexVersions = __esm({
66631
+ "../../../../shared/devboxCore/dist/managedCodexVersions.js"() {
66632
+ "use strict";
66633
+ init_packageUpdates();
66634
+ }
66635
+ });
66636
+
66476
66637
  // ../../../../shared/devboxCore/dist/desktopInitContracts.js
66477
66638
  var DESKTOP_INIT_UPLOAD_URL_TTL_SECONDS, DESKTOP_INIT_DOWNLOAD_URL_TTL_SECONDS, DESKTOP_INIT_MAX_UNCOMPRESSED_BUNDLE_BYTES, DESKTOP_INIT_MAX_COMBINED_BUNDLE_BYTES, DESKTOP_INIT_SHELL_ENV_CAPTURE_MAX_BYTES, DESKTOP_INIT_PHASES, DESKTOP_INIT_JOB_STATUSES, DESKTOP_INIT_WORKFLOW_STEPS, PHASE_SET, JOB_STATUS_SET, WORKFLOW_OWNED_PHASES, DESKTOP_INIT_UNTRACKED_AUTO_EXCLUDE_DIR_NAMES, DESKTOP_INIT_UNTRACKED_BUILD_OUTPUT_DIR_NAMES, DESKTOP_INIT_UNTRACKED_AUTO_EXCLUDE_DIR_NAME_SET, DESKTOP_INIT_UNTRACKED_BUILD_OUTPUT_DIR_NAME_SET;
66478
66639
  var init_desktopInitContracts = __esm({
@@ -66656,7 +66817,7 @@ var init_desktopSetupReview = __esm({
66656
66817
 
66657
66818
  // ../../../../shared/devboxCore/dist/installOwner.js
66658
66819
  import { existsSync as existsSync2 } from "node:fs";
66659
- import path6 from "node:path";
66820
+ import path7 from "node:path";
66660
66821
  var DEVBOX_INSTALL_OWNER_PATHS_ENV, trimOwnerPath, resolveInstallOwnerPaths, findMissingInstallOwnerPaths;
66661
66822
  var init_installOwner = __esm({
66662
66823
  "../../../../shared/devboxCore/dist/installOwner.js"() {
@@ -66668,7 +66829,7 @@ var init_installOwner = __esm({
66668
66829
  if (!raw) {
66669
66830
  return [];
66670
66831
  }
66671
- const values = raw.split(path6.delimiter).map(trimOwnerPath).filter((value) => value.length > 0);
66832
+ const values = raw.split(path7.delimiter).map(trimOwnerPath).filter((value) => value.length > 0);
66672
66833
  return [...new Set(values)];
66673
66834
  };
66674
66835
  findMissingInstallOwnerPaths = (ownerPaths, exists = existsSync2) => ownerPaths.map(trimOwnerPath).filter((ownerPath) => ownerPath.length > 0 && !exists(ownerPath));
@@ -66682,104 +66843,6 @@ var init_strings = __esm({
66682
66843
  }
66683
66844
  });
66684
66845
 
66685
- // ../../../../shared/devboxCore/dist/packageUpdates.js
66686
- import fs5 from "node:fs/promises";
66687
- import os5 from "node:os";
66688
- import path7 from "node:path";
66689
- var createEmptyCache, resolvePackageUpdateCacheDir, resolvePackageUpdateCachePath, ensureCacheDir, writeJsonAtomic, parseEntry, loadPackageUpdateCache, savePackageUpdateCache, writeCachedPackageVersion;
66690
- var init_packageUpdates = __esm({
66691
- "../../../../shared/devboxCore/dist/packageUpdates.js"() {
66692
- "use strict";
66693
- init_config();
66694
- createEmptyCache = () => ({
66695
- version: 1,
66696
- packages: {}
66697
- });
66698
- resolvePackageUpdateCacheDir = (homeDir = os5.homedir()) => path7.join(resolveDevboxDir(homeDir), "cache");
66699
- resolvePackageUpdateCachePath = (homeDir = os5.homedir()) => path7.join(resolvePackageUpdateCacheDir(homeDir), "package-updates.json");
66700
- ensureCacheDir = async (homeDir) => {
66701
- const dir = resolvePackageUpdateCacheDir(homeDir);
66702
- await fs5.mkdir(dir, { recursive: true, mode: 448 });
66703
- try {
66704
- await fs5.chmod(dir, 448);
66705
- } catch {
66706
- }
66707
- return dir;
66708
- };
66709
- writeJsonAtomic = async (filePath, payload) => {
66710
- const dir = path7.dirname(filePath);
66711
- const tempPath = path7.join(dir, `.tmp-${path7.basename(filePath)}-${Date.now()}`);
66712
- await fs5.writeFile(tempPath, JSON.stringify(payload, null, 2), {
66713
- mode: 384
66714
- });
66715
- await fs5.rename(tempPath, filePath);
66716
- try {
66717
- await fs5.chmod(filePath, 384);
66718
- } catch {
66719
- }
66720
- };
66721
- parseEntry = (value) => {
66722
- if (!value || typeof value !== "object")
66723
- return null;
66724
- const record2 = value;
66725
- if (typeof record2.latestVersion !== "string")
66726
- return null;
66727
- if (typeof record2.checkedAt !== "string")
66728
- return null;
66729
- const latestVersion = record2.latestVersion.trim();
66730
- const checkedAt = record2.checkedAt.trim();
66731
- if (!latestVersion || !checkedAt)
66732
- return null;
66733
- return { latestVersion, checkedAt };
66734
- };
66735
- loadPackageUpdateCache = async (options = {}) => {
66736
- const filePath = resolvePackageUpdateCachePath(options.homeDir);
66737
- try {
66738
- const raw = await fs5.readFile(filePath, "utf8");
66739
- const parsed = JSON.parse(raw);
66740
- if (!parsed || parsed.version !== 1)
66741
- return createEmptyCache();
66742
- if (!parsed.packages || typeof parsed.packages !== "object") {
66743
- return createEmptyCache();
66744
- }
66745
- const packages = {};
66746
- for (const [packageName, entryValue] of Object.entries(parsed.packages)) {
66747
- const entry = parseEntry(entryValue);
66748
- if (!entry)
66749
- continue;
66750
- packages[packageName] = entry;
66751
- }
66752
- return {
66753
- version: 1,
66754
- packages
66755
- };
66756
- } catch (error4) {
66757
- if (error4 instanceof Error && "code" in error4 && error4.code === "ENOENT") {
66758
- return createEmptyCache();
66759
- }
66760
- throw error4;
66761
- }
66762
- };
66763
- savePackageUpdateCache = async (cache, options = {}) => {
66764
- await ensureCacheDir(options.homeDir);
66765
- const filePath = resolvePackageUpdateCachePath(options.homeDir);
66766
- await writeJsonAtomic(filePath, cache);
66767
- };
66768
- writeCachedPackageVersion = async (packageName, latestVersion, options = {}) => {
66769
- const trimmedPackageName = packageName.trim();
66770
- const trimmedVersion = latestVersion.trim();
66771
- if (!trimmedPackageName || !trimmedVersion)
66772
- return;
66773
- const cache = await loadPackageUpdateCache(options);
66774
- cache.packages[trimmedPackageName] = {
66775
- latestVersion: trimmedVersion,
66776
- checkedAt: options.checkedAt ?? (/* @__PURE__ */ new Date()).toISOString()
66777
- };
66778
- await savePackageUpdateCache(cache, options);
66779
- };
66780
- }
66781
- });
66782
-
66783
66846
  // ../../../../shared/devboxCore/dist/packageVersion.js
66784
66847
  import { readFileSync as readFileSync2, realpathSync } from "node:fs";
66785
66848
  import path8 from "node:path";
@@ -66821,7 +66884,7 @@ var init_packageVersion = __esm({
66821
66884
  return path8.join(process.cwd(), "dvb");
66822
66885
  };
66823
66886
  readEmbeddedPackageVersion = () => {
66824
- const raw = "1.0.1052";
66887
+ const raw = "1.0.1054";
66825
66888
  return trimVersion(raw);
66826
66889
  };
66827
66890
  readNearestPackageMetadata = (basePath) => {
@@ -67056,7 +67119,6 @@ var init_authRefresh = __esm({
67056
67119
  var init_dist3 = __esm({
67057
67120
  "../../../../shared/devboxCore/dist/index.js"() {
67058
67121
  "use strict";
67059
- init_directMoshProtocol();
67060
67122
  init_codexLocalRenderer();
67061
67123
  init_codexLocalImageFrame();
67062
67124
  init_mcpCommandImport();
@@ -67068,6 +67130,11 @@ var init_dist3 = __esm({
67068
67130
  init_githubGitCredentials();
67069
67131
  init_githubGhCredentials();
67070
67132
  init_mcpOAuth();
67133
+ init_chatGptBrowserSignIn();
67134
+ init_claudeOAuthParams();
67135
+ init_codexChatGptAuthJson();
67136
+ init_codexOAuthParams();
67137
+ init_oauthCallbackPage();
67071
67138
  init_agentConfigImport();
67072
67139
  init_profile();
67073
67140
  init_codingAgents();
@@ -67104,6 +67171,7 @@ var init_dist3 = __esm({
67104
67171
  init_loopbackServer();
67105
67172
  init_portProxying();
67106
67173
  init_npmCli();
67174
+ init_managedCodexVersions();
67107
67175
  init_desktopInitContracts();
67108
67176
  init_desktopObjectTransfers();
67109
67177
  init_desktopInitPaths();
@@ -79968,4 +80036,4 @@ smol-toml/dist/index.js:
79968
80036
  *)
79969
80037
  */
79970
80038
 
79971
- //# debugId=a9afcb43-4806-5154-9842-36529ed47771
80039
+ //# debugId=7d72dc90-582f-5b5e-adc3-cf59e376ab6d
@@ -8,6 +8,10 @@ description: Product documentation for boxes.dev, the platform running this mach
8
8
  Use this skill when the user asks how boxes.dev works or how to use a boxes.dev
9
9
  feature.
10
10
 
11
+ When explaining where to find a desktop control or setting in a boxes.dev
12
+ conversation, read `references/ui-references.md` and use its supported inline
13
+ references where they help the user follow your explanation.
14
+
11
15
  For human-readable walkthroughs, point signed-in users to
12
16
  `https://boxes.dev/help`. The help center covers these same product topics in
13
17
  task-oriented articles, with search and screenshots.
@@ -71,6 +71,16 @@ automatically. The choice is saved with each new run, so changing it affects
71
71
  future runs without changing existing run history. Slack and Linear replies and
72
72
  output destinations are unaffected.
73
73
 
74
+ **Completion notifications**, also under **More settings**, controls whether a
75
+ turn that finishes in one of the automation's threads sends a desktop or mobile
76
+ notification. **Every turn** is the default. **Follow-ups only** skips the
77
+ notification for the automation's first turn, and **Off** skips it for every
78
+ turn in the automation's threads, including follow-ups. Failed turns and turns
79
+ that need input still notify. Muted threads still show an unread dot unless
80
+ **Mark successful runs as read** also applies. This choice is also saved with
81
+ each new run, and Slack and Linear replies and output destinations are
82
+ unaffected.
83
+
74
84
  ## Automations Created By Agents
75
85
 
76
86
  You can ask an agent in one of the project's threads to set up or change an
@@ -197,27 +197,10 @@ dvb connect <devbox> -n server
197
197
  dvb connect <devbox> --command "npm test"
198
198
  ```
199
199
 
200
- Managed CLI attachments replay prior output when you reconnect.
200
+ CLI attachments replay prior output when you reconnect.
201
201
 
202
202
  Use `dvb sessions` to list, rename, or kill persistent terminal sessions.
203
203
 
204
- For the lowest connection latency, use:
205
-
206
- ```bash
207
- dvb connect <devbox> --transport direct
208
- ```
209
-
210
- Direct mode attaches an interactive terminal session using Mosh's encrypted UDP
211
- transport after negotiating a direct network path. It does not use SSH. Direct
212
- and Managed attach the same persistent terminal sessions, so names such as
213
- `<devbox>/server` or `-n server` work in either mode and a session created in
214
- one can be reattached through the other. Closing the Direct client detaches
215
- without ending the underlying session. Direct remains interactive-only, so
216
- one-off commands and detached-session creation use Managed. It reports an error
217
- when the installed CLI lacks its matching native component or the machine needs
218
- an update; it never uses a system Mosh installation or silently falls back to
219
- Managed.
220
-
221
204
  For a noninteractive exact-argv command, use:
222
205
 
223
206
  ```bash
@@ -290,6 +290,14 @@ threads, new-devbox placeholders, and automation views all use the same detail
290
290
  area. A Codex or Claude thread can switch between GUI and the CLI from its
291
291
  header without becoming a different thread.
292
292
 
293
+ Agent replies can include blue pills pointing to controls or settings. Hover
294
+ one to see its location, then click to reveal and highlight the item. A
295
+ reference can open a settings section or menu, but does not activate the
296
+ highlighted action or change a setting. After a detail-page detour, **Back to
297
+ thread** returns to the conversation at its bottom. On mobile, tapping a
298
+ reference explains where to find it on desktop. See `ui-references.md` for
299
+ authoring guidance and supported destinations.
300
+
293
301
  Mermaid code blocks in Codex and Claude replies appear as diagrams. Use the
294
302
  diagram's controls to copy its source, expand it for zooming, or download an
295
303
  SVG. A diagram loads after the agent finishes its code block; if it cannot be
@@ -543,6 +551,10 @@ On macOS, the app clears recognized leftover update downloads and installation
543
551
  files from older releases when it starts. Files for the current release or a
544
552
  pending newer update remain available until the updater finishes with them.
545
553
 
554
+ If a downloaded update fails to install, the app does not download that same
555
+ version again in the background. Choose **Check for Updates…** in the app menu
556
+ to try it again; newer versions still download automatically.
557
+
546
558
  Use the Help button next to your account identity at the bottom of the left pane
547
559
  for quick troubleshooting tips and to send product feedback, when the button is
548
560
  shown.
@@ -66,6 +66,8 @@ Use this terminology consistently:
66
66
  - `desktop-workbench.md`: the desktop app layout, thread list, transcript pane,
67
67
  Template box page, terminal pane, files, ports, runtime controls, and settings
68
68
  entry points.
69
+ - `ui-references.md`: supported inline references for showing users where
70
+ desktop controls, settings, and other threads live while explaining them.
69
71
  - `files-git-and-review.md`: file viewer, diffs, media/download handling,
70
72
  upload/download transfers, review comments, git status, staging, commits,
71
73
  amend, history, branches, and multi-repo behavior.
@@ -252,7 +252,8 @@ separate `--prompt-file`, not both. File paths can be relative or absolute.
252
252
 
253
253
  - `name`, the prompt, `execution`, and `trigger` are required. Other keys
254
254
  default to the desktop defaults: runs under the automation, successful runs
255
- not marked read, no capacity options, devbox cleanup **Never** with both
255
+ not marked read, completion notifications for every turn, no capacity
256
+ options, devbox cleanup **Never** with both
256
257
  safeguards, and no outputs. `create` saves the automation paused.
257
258
  - `execution`: `backend` is `codex` or `claude`. Take `model` and
258
259
  `reasoningEffort` from `automations options`; `reasoningEffort` is `null`
@@ -269,6 +270,11 @@ separate `--prompt-file`, not both. File paths can be relative or absolute.
269
270
  - `threadPlacement`: `nested` (under the automation) or `main` (the main
270
271
  thread list).
271
272
  - `markSuccessfulRunsRead`: `true` or `false`.
273
+ - `completionNotifications`: `all` (the default), `follow_ups_only` (no
274
+ notification when the automation's first turn finishes), or `none` (no
275
+ notification when any turn in its threads finishes). Failed turns and turns
276
+ that need input still notify. See
277
+ [Editing Automations](automations.md#editing-automations).
272
278
  - `capacity`: `sleepIdleDevboxWhenFull` and `deferScheduledRunWhenFull`, both
273
279
  required when `capacity` is given. See
274
280
  [Capacity Behavior](automations.md#capacity-behavior).
@@ -51,6 +51,8 @@ Common terminal actions:
51
51
 
52
52
  Closing a terminal tab ends that terminal session. Closing the desktop app
53
53
  preserves open terminal sessions and restores their tabs when you reopen it.
54
+ Opening a session in another window or device replaces only that session's
55
+ current attachment.
54
56
 
55
57
  ### Command History
56
58
 
@@ -76,16 +78,7 @@ a terminal. Without Project storage, Bash will continue using local history.
76
78
  Anyone with access to the project's storage can read its history, so avoid
77
79
  recording secrets in commands.
78
80
 
79
- ### Connections And Terminal Input
80
-
81
- **Desktop app settings > Connection** includes a Terminal Connection choice.
82
- Managed is the default attachment transport. Direct (Mosh) negotiates an
83
- encrypted UDP path for the lowest latency and repairs that path if connectivity
84
- changes. Both choices use the same persistent terminal sessions: tabs created
85
- in either mode are restored after reopening the app and can be attached through
86
- the other mode. Opening one session elsewhere replaces only that session's
87
- current attachment. Direct reports an error rather than falling back to Managed
88
- when its native component or the required remote support is unavailable.
81
+ ### Terminal Input
89
82
 
90
83
  Terminal tabs can show unread-output or attention indicators, including bell
91
84
  alerts when terminal notification settings allow them.
@@ -95,7 +88,7 @@ Paste a clipboard image into a desktop terminal with **Cmd+V** on macOS,
95
88
  (**Ctrl+V** on macOS/Linux, **Alt+V** on Windows) also works. boxes.dev will
96
89
  upload the image to the selected machine and paste its file path. Claude Code
97
90
  will recognize that path as an image attachment; a shell will receive the path
98
- without running a command. This works with Managed and Direct connections.
91
+ without running a command.
99
92
  PNG and JPEG images are supported, up to 20 MiB per image and 50 MiB per paste.
100
93
  If an upload fails, paste again before resubmitting your prompt.
101
94
 
@@ -54,10 +54,15 @@ actions to email, copy, or share a link to the page, and the desktop step is
54
54
  left out. The first project is set up by the coding agent; **Create from
55
55
  GitHub** is offered when the user adds a later project.
56
56
 
57
- When a user copies the prompt, the page confirms the copy and can show when
58
- the CLI connects, prepares the project, waits for launch approval, and starts
59
- launching. The coding agent still owns the setup work, and `dvb agent-init
60
- status` remains the source for its exact next action.
57
+ When a user copies the prompt, the page confirms the copy and then follows
58
+ that setup by project name. It shows when the CLI connects and prepares the
59
+ project, when the user needs to connect accounts or GitHub or add an SSH key,
60
+ when the agent is fixing issues a check found, when the setup plan is ready for
61
+ approval, and the upload percentage. If a setup command fails, the page shows
62
+ its error. Once the CLI connects, the progress leads the card and the prompt
63
+ moves behind **Setup prompt**, which the user can open to copy the prompt again
64
+ (for example, to start over). The coding agent still owns the setup work, and
65
+ `dvb agent-init status` remains the source for its exact next action.
61
66
 
62
67
  After setup, the website's **Projects** page lists projects and their last-used
63
68
  activity. Choose a project name or **Open in desktop app** to continue in the
@@ -207,11 +212,21 @@ files need a named file selection if you want to copy them.
207
212
  The desktop app's Project step leads with **Set up with your coding agent**,
208
213
  followed by a Team Template when the team has one. The local-folder and GitHub
209
214
  options are fallbacks under **Other setup options** at the bottom of the step,
210
- with the local folder first. **Use coding agent** expands the card to show the
211
- prompt to copy into Codex or Claude Code in the local project folder. Once
215
+ with the local folder first. The prompt and **Copy prompt** are visible
216
+ immediately. Paste the prompt into Codex or Claude Code in the local project
217
+ folder. The card then shows that setup's progress, including after a reload:
218
+ when the CLI connects and prepares the project, when the user needs to act,
219
+ when a setup command fails, and when the setup plan is ready for approval.
220
+ Once the CLI connects, the prompt moves behind **Setup prompt** below the
221
+ progress. In **New project**, the card only follows a setup started after the
222
+ wizard opened.
223
+
224
+ The folder wizard's steps and **Continue** appear only after a local folder
225
+ is selected. **Other setup options** remembers whether it was open across
226
+ reloads in the same app session. Once
212
227
  the agent's `dvb agent-init run` starts uploading, the Project step's setup
213
228
  choices are replaced by that project's setup status: the project name and four
214
- stages (uploading the project files, creating the Template box, unpacking the
229
+ stages (uploading the project files, with a percentage, creating the Template box, unpacking the
215
230
  files on the Template box, and starting setup on the Template box). When the setup thread starts on the Template box, the
216
231
  desktop app opens it in the workbench. The workbench banner then shows
217
232
  **Setup in progress** and **Finishing setup** until setup completes, and new
@@ -297,8 +312,9 @@ prompt instead.
297
312
 
298
313
  Next, `dvb agent-init accounts` opens **Connect your accounts** in the
299
314
  browser. There the user connects Codex, Claude Code, or both, and can connect
300
- GitHub and Slack. Codex and Claude Code use their normal browser sign-in,
301
- which returns to the CLI on the user's computer, and **Use an API key** saves
315
+ GitHub and Slack. Codex and Claude Code use their normal browser sign-in in
316
+ the same tab, which returns to the page through the CLI on the user's
317
+ computer; neither agent needs to be installed there. **Use an API key** saves
302
318
  a key instead. **Done** becomes available once a coding agent is connected,
303
319
  and the command waits until the user chooses it. Over SSH, the command prints
304
320
  a link for the user to open and exits: on that page, Codex shows a one-time
@@ -29,6 +29,11 @@ final replies, including conversations started in the apps. Search can lag
29
29
  recent messages and returns a bounded result set. Read the thread before
30
30
  continuing it; discovery includes whether it can accept a follow-up now.
31
31
 
32
+ The assistant can also list current and recently finished work across the
33
+ selected projects in one request. Conversations waiting for an answer or
34
+ approval are listed first, and finished ones include the start of the final
35
+ reply.
36
+
32
37
  A new task starts Codex or Claude in a new devbox from the project's saved
33
38
  environment. Finish project setup and save its environment before starting.
34
39
  Continuing an existing thread preserves its context and can wake its sleeping
@@ -36,6 +41,12 @@ devbox. Archived conversations need to be unarchived in boxes.dev first;
36
41
  conversations in storage need to be restored. A history-only conversation
37
42
  cannot continue. These recovery actions are not performed automatically.
38
43
 
44
+ A new task uses the agent's saved model and reasoning effort for the project,
45
+ and its saved speed for Codex, unless the user asks for a specific model,
46
+ reasoning effort or Codex speed. The assistant can choose from the models the
47
+ boxes.dev model picker lists for the account, and the start receipt reports
48
+ what the agent was launched with.
49
+
39
50
  Follow-ups queue by default while an agent is working. Codex also supports
40
51
  steering to redirect current work; Claude steering is unavailable through this
41
52
  connection. Claude follow-ups go directly to its session and do not appear in
@@ -52,10 +63,15 @@ assistant chats. Delivered means the prompt was handed off, not that it
52
63
  executed or completed.
53
64
 
54
65
  Read the conversation for current activity and saved messages. Refresh to see
55
- recent content, or page backward for earlier context. History previews can
56
- omit content and shorten messages; read listed messages in full when needed.
57
- For very large messages omitted from the preview, share the thread link.
58
- Revert or rewind can remove messages from current history.
66
+ recent content, or page backward for earlier context. Reading does not wake a
67
+ sleeping devbox. Activity shows whether the agent is starting, working, waiting
68
+ for input or finished. If the agent last reported work but its devbox is asleep
69
+ or not responding, the status is unverified: that work may have stopped or
70
+ finished, and its state can't be confirmed until the devbox responds again.
71
+
72
+ History previews can omit content and shorten messages; read listed messages in
73
+ full when needed. For very large messages omitted from the preview, share the
74
+ thread link. Revert or rewind can remove messages from current history.
59
75
 
60
76
  There is no per-request result mapping. The latest reply or completion notice
61
77
  may reflect another message, a human's work or a background continuation.
@@ -67,10 +83,11 @@ messages can arrive after an event. Subscriptions need renewal within 24 hours
67
83
  and do not replay old events. Poll current activity when notifications are
68
84
  unavailable or missed; legacy-only sessions may require polling.
69
85
 
70
- For native approvals or interactive questions, share the thread link so the
71
- user can respond in boxes.dev. A question may not appear in saved history and
72
- may reject remote interruption. Sending a queued prompt does not answer the
73
- native dialog.
86
+ For native approvals, interactive questions and boxes.dev permission
87
+ requests, the assistant can show what the agent is waiting on, then share the
88
+ thread link so the user can respond in boxes.dev. A question may not appear in
89
+ saved history and may reject remote interruption. Sending a queued prompt does
90
+ not answer the native dialog.
74
91
 
75
92
  ## Stop work or remove access
76
93