@boxes-dev/dvb-runtime 1.0.1052 → 1.0.1053

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.1053";
64671
+ const rawGitSha = "76361e7078c6a6e750a6d2ba0cf73167ab361588";
64672
+ const rawSentryRelease = "boxes-dev-dvb@1.0.1053+76361e7078c6a6e750a6d2ba0cf73167ab361588";
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.1053";
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.
@@ -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.
@@ -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
 
@@ -207,8 +207,15 @@ files need a named file selection if you want to copy them.
207
207
  The desktop app's Project step leads with **Set up with your coding agent**,
208
208
  followed by a Team Template when the team has one. The local-folder and GitHub
209
209
  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
210
+ with the local folder first. The prompt and **Copy prompt** are visible
211
+ immediately. Paste the prompt into Codex or Claude Code in the local project
212
+ folder. During first-run setup, the card also shows when the CLI connects and
213
+ prepares the project, including after a reload. For a later project, the card
214
+ confirms the copy and setup progress appears once uploading begins.
215
+
216
+ The folder wizard's steps and **Continue** appear only after a local folder
217
+ is selected. **Other setup options** remembers whether it was open across
218
+ reloads in the same app session. Once
212
219
  the agent's `dvb agent-init run` starts uploading, the Project step's setup
213
220
  choices are replaced by that project's setup status: the project name and four
214
221
  stages (uploading the project files, creating the Template box, unpacking the
@@ -297,8 +304,9 @@ prompt instead.
297
304
 
298
305
  Next, `dvb agent-init accounts` opens **Connect your accounts** in the
299
306
  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
307
+ GitHub and Slack. Codex and Claude Code use their normal browser sign-in in
308
+ the same tab, which returns to the page through the CLI on the user's
309
+ computer; neither agent needs to be installed there. **Use an API key** saves
302
310
  a key instead. **Done** becomes available once a coding agent is connected,
303
311
  and the command waits until the user chooses it. Over SSH, the command prints
304
312
  a link for the user to open and exits: on that page, Codex shows a one-time
@@ -0,0 +1,66 @@
1
+ # Point to the desktop UI in a reply
2
+
3
+ Agents can include references to boxes.dev controls and settings in conversation
4
+ replies. These appear as blue inline pills in the desktop app, beside the
5
+ explanation of what the user can do there.
6
+
7
+ ## How references behave
8
+
9
+ Hover a pill to see where the item lives and what clicking will do. A visible
10
+ item may also get a quiet preview outline. Click to reveal the item, scroll it
11
+ into view, and briefly highlight it. Settings sections and integration pages
12
+ can open; controls such as Git, New automation, and Share are highlighted so
13
+ the user can choose their next action. A reference never presses the highlighted
14
+ control, changes a permission, or creates a resource.
15
+
16
+ Navigation follows the app's ordinary behavior, including Auto-wake when
17
+ opening Template box details. After a settings or detail-page detour, **Back
18
+ to thread** returns to the conversation at its bottom. An older reply's exact
19
+ scroll position is not restored. Escape or another interaction dismisses the
20
+ highlight; reduced-motion preferences remove the travel animation and glint.
21
+
22
+ References are relative to the conversation's project and devbox. Specific
23
+ thread, automation, and Project URL references can identify other items in
24
+ that same project. Thread references reveal a sidebar row without selecting
25
+ it. Rows nested under automation runs are not supported yet.
26
+
27
+ On mobile, tap a reference for its location in the desktop app. Shared and
28
+ read-only conversations cannot reveal the viewer's own controls. If an item
29
+ is missing or unavailable, the app will explain that; unknown destinations
30
+ appear as plain text. Older clients and command-line readers may display the
31
+ ordinary Markdown destination instead of a pill.
32
+
33
+ ## Writing references
34
+
35
+ In a boxes.dev conversation reply, use a normal Markdown link with a supported
36
+ destination, for example:
37
+
38
+ ```md
39
+ Add persistent variables in [Environment files](boxes:environment-files).
40
+ Review [Agent permissions](boxes:agent-permissions) for this devbox.
41
+ Enable [Message other agents](boxes:agent-permissions/message-agents) if you want agents to collaborate.
42
+ ```
43
+
44
+ Use the UI's name or a short, natural noun phrase as the label. Link the first
45
+ useful mention rather than every repeated mention, and keep the sentence
46
+ understandable without the link. Explain the user's next step in the prose;
47
+ clicking a reference only reveals its destination. Avoid “click here.”
48
+
49
+ Use only destinations listed below. Replace entity placeholders with exact IDs
50
+ already returned by authorized boxes.dev tools; never guess an ID or derive
51
+ one from a title. Static names and permission/provider keys are case-sensitive.
52
+ Do not add query parameters, fragments, encodings, or action arguments.
53
+
54
+ Use these links only in boxes.dev conversation prose. Do not put them in Slack
55
+ or Linear replies sent through tools, commit messages, PR bodies, repository
56
+ files, or executable code. A code example remains literal and does not become
57
+ a clickable reference. No extra tool call is needed to show a reference.
58
+
59
+ ## Supported destinations
60
+
61
+ The published skill includes the current destination table here. Availability
62
+ depends on the project, box kind, agent, permissions, and the UI currently
63
+ offered to the viewer. Use the normal feature documentation to explain those
64
+ requirements; a reference does not grant access or enable a missing feature.
65
+
66
+ <!-- UI_REFERENCE_CATALOG -->
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@boxes-dev/dvb-runtime",
3
- "version": "1.0.1052",
3
+ "version": "1.0.1053",
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",
@@ -34,15 +34,13 @@
34
34
  "dist/agent-init-guides",
35
35
  "dist/codex",
36
36
  "dist/managed-codex-install",
37
- "dist/boxes-mosh",
38
37
  "dist/postgres-tools",
39
38
  "dist/product-docs",
40
39
  "dist/prompts"
41
40
  ],
42
41
  "scripts": {
43
- "build": "../../node_modules/@typescript/native/bin/tsc -b --checkers 1 --builders 1 && npm run build:bundle && npm run build:prompts && npm run build:boxes-mosh && npm run build:postgres-tools",
42
+ "build": "../../node_modules/@typescript/native/bin/tsc -b --checkers 1 --builders 1 && npm run build:bundle && npm run build:prompts && npm run build:postgres-tools",
44
43
  "build:bundle": "node ./scripts/build-bundle.mjs",
45
- "build:boxes-mosh": "node ../../../../scripts/package-boxes-mosh-surface.mjs --surface cli --output dist/boxes-mosh --allow-missing-materialized",
46
44
  "build:postgres-tools": "node ../../../../scripts/package-postgres-tools-surface.mjs --surface cli --output dist/postgres-tools --allow-missing-materialized",
47
45
  "build:prompts": "rm -rf dist/product-docs && mkdir -p dist/prompts dist/codex dist/managed-codex-install dist/agent-init-guides dist/product-docs && cp -R src/devbox/commands/init/codex/prompts/* dist/prompts/ && cp -R src/devbox/commands/init/codex/schema/* dist/codex/ && cp -R ../../../../shared/devboxCore/assets/managed-codex-install/* dist/managed-codex-install/ && cp -R ../../../../shared/devboxCore/assets/agent-init-guides/* dist/agent-init-guides/ && cp -R ../../../../apps/sprite-daemon/assets/skills/boxes-product-docs/. dist/product-docs/",
48
46
  "prepack": "npm run clean && npm run build",
@@ -79,5 +77,5 @@
79
77
  "e2b": "^2.18.0",
80
78
  "ink-testing-library": "^4.0.0"
81
79
  },
82
- "devboxReleasedAt": "2026-10-03T19:33:55Z"
80
+ "devboxReleasedAt": "2026-10-04T22:46:11Z"
83
81
  }
@@ -1,9 +0,0 @@
1
- 02fa8fb934723971b88bb1a5c2488a479340b1f6bbf52df2c1988cb4c447d2e0 darwin-x64/notices.tar.gz
2
- 27797d0b939cd0c48ef0eae1c4c034d4a7e31dc6866d6fad688d162324adab10 darwin-arm64/mosh-client
3
- 3486778118d2ac84b09fcbc12c46e7dd6d2071519d31eec7d758dac81aca8dc2 darwin-x64/mosh-client
4
- 6aa8f7a121c9705c313b986133da13d51c114745343e28eecc15cbcbda0b4221 darwin-arm64/notices.tar.gz
5
- 700f16a3f6a0df292020de0ec6b647881be12c57146457a3028be8158e15cb46 linux-x64/notices.tar.gz
6
- 72d709843f7d9815ded8254327d41c237e223965a35d2446c2d210033dfb6ea1 linux-arm64/mosh-client
7
- 92c6384031a5828e8a0fa2bac0d2a97eba718c81dea773b7776d89bb1abb9002 source/boxes-mosh-source-829ce1ba6667ce0b5cfa797ae6bb4edefd8f53cd.tar.gz
8
- a20d0298999e903c90df13a399508fe235039f16927698706172905351467dc5 linux-x64/mosh-client
9
- cf33d7f8b0ba7015b53e3c0232b9796012406957520ee4f5f0bde8decf4cf473 linux-arm64/notices.tar.gz