@boxes-dev/dvb-runtime 1.0.969 → 1.0.971

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/bin/dvb.mjs 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]="8e52df52-1fef-59fa-8775-c08b9d9a8f8f")}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]="e1551a91-925f-5423-be1b-4fe8159ffc80")}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";
@@ -101145,8 +101145,8 @@ var init_otel = __esm({
101145
101145
  return trimmed && trimmed.length > 0 ? trimmed : void 0;
101146
101146
  };
101147
101147
  readBuildMetadata = () => {
101148
- const rawPackageVersion = "1.0.969";
101149
- const rawGitSha = "6760e4f2ebf91bf962991e425ba6144e8b535c4f";
101148
+ const rawPackageVersion = "1.0.971";
101149
+ const rawGitSha = "63cbb0f96bb83af343e80bf19971efbcdb57b1b0";
101150
101150
  const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
101151
101151
  const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
101152
101152
  return { packageVersion, gitSha };
@@ -133552,9 +133552,9 @@ var init_sentry = __esm({
133552
133552
  uncaughtExceptionMonitorInstalled = false;
133553
133553
  currentDevboxSentryUser = null;
133554
133554
  readBuildMetadata2 = () => {
133555
- const rawPackageVersion = "1.0.969";
133556
- const rawGitSha = "6760e4f2ebf91bf962991e425ba6144e8b535c4f";
133557
- const rawSentryRelease = "boxes-dev-dvb@1.0.969+6760e4f2ebf91bf962991e425ba6144e8b535c4f";
133555
+ const rawPackageVersion = "1.0.971";
133556
+ const rawGitSha = "63cbb0f96bb83af343e80bf19971efbcdb57b1b0";
133557
+ const rawSentryRelease = "boxes-dev-dvb@1.0.971+63cbb0f96bb83af343e80bf19971efbcdb57b1b0";
133558
133558
  const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
133559
133559
  const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
133560
133560
  const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
@@ -138737,7 +138737,7 @@ var init_packageVersion = __esm({
138737
138737
  return path17.join(process.cwd(), "dvb");
138738
138738
  };
138739
138739
  readEmbeddedPackageVersion = () => {
138740
- const raw = "1.0.969";
138740
+ const raw = "1.0.971";
138741
138741
  return trimVersion(raw);
138742
138742
  };
138743
138743
  readNearestPackageMetadata = (basePath) => {
@@ -229326,15 +229326,15 @@ var init_managedClaudeThreadCommands = __esm({
229326
229326
  "../../../../shared/threadRuntime/dist-inventory/threadRuntime/managedClaudeThreadCommands.js"() {
229327
229327
  "use strict";
229328
229328
  MANAGED_CLAUDE_THREAD_COMMAND_MESSAGES = {
229329
- "/branch": "/branch is unavailable in this Terminal because it switches Claude to a new session. Create a new boxes.dev thread or devbox instead.",
229330
- "/cd": "/cd is unavailable in this Terminal because it moves this thread's Claude transcript. Use /add-dir to give Claude access to another directory.",
229331
- "/clear": "/clear is unavailable in this Terminal because it switches Claude to a new session. Start a new boxes.dev thread instead.",
229332
- "/continue": "/continue is unavailable in this Terminal because it switches Claude to a different session. Open that Claude session in its own boxes.dev thread instead.",
229333
- "/resume": "/resume is unavailable in this Terminal because it switches Claude to a different session. Open that Claude session in its own boxes.dev thread instead.",
229334
- "/teleport": "/teleport is unavailable in this Terminal because it moves work into a different Claude session. Open or create that work in its own boxes.dev thread instead.",
229335
- "/tp": "/tp is unavailable in this Terminal because it moves work into a different Claude session. Open or create that work in its own boxes.dev thread instead."
229336
- };
229337
- MANAGED_CLAUDE_COMMAND_MENU_MESSAGE = "Select-by-menu Claude commands are unavailable in this Terminal because they can switch this boxes.dev thread to another session. Type the full command name instead.";
229329
+ "/branch": "/branch is unavailable in this CLI because it switches Claude to a new session. Create a new boxes.dev thread or devbox instead.",
229330
+ "/cd": "/cd is unavailable in this CLI because it moves this thread's Claude transcript. Use /add-dir to give Claude access to another directory.",
229331
+ "/clear": "/clear is unavailable in this CLI because it switches Claude to a new session. Start a new boxes.dev thread instead.",
229332
+ "/continue": "/continue is unavailable in this CLI because it switches Claude to a different session. Open that Claude session in its own boxes.dev thread instead.",
229333
+ "/resume": "/resume is unavailable in this CLI because it switches Claude to a different session. Open that Claude session in its own boxes.dev thread instead.",
229334
+ "/teleport": "/teleport is unavailable in this CLI because it moves work into a different Claude session. Open or create that work in its own boxes.dev thread instead.",
229335
+ "/tp": "/tp is unavailable in this CLI because it moves work into a different Claude session. Open or create that work in its own boxes.dev thread instead."
229336
+ };
229337
+ MANAGED_CLAUDE_COMMAND_MENU_MESSAGE = "Select-by-menu Claude commands are unavailable in this CLI because they can switch this boxes.dev thread to another session. Type the full command name instead.";
229338
229338
  normalizeClaudePromptLine = (line) => line.replace(/\u00a0/g, " ").replace(/^[\s>❯›]+/u, "").trimStart();
229339
229339
  resolveBlockedManagedClaudeThreadCommand = (line) => {
229340
229340
  const normalizedLine = normalizeClaudePromptLine(line);
@@ -357626,4 +357626,4 @@ react/cjs/react-jsx-runtime.development.js:
357626
357626
  *)
357627
357627
  */
357628
357628
 
357629
- //# debugId=8e52df52-1fef-59fa-8775-c08b9d9a8f8f
357629
+ //# debugId=e1551a91-925f-5423-be1b-4fe8159ffc80
package/dist/bin/dvbd.mjs CHANGED
@@ -96328,8 +96328,8 @@ var init_otel = __esm({
96328
96328
  return trimmed && trimmed.length > 0 ? trimmed : void 0;
96329
96329
  };
96330
96330
  readBuildMetadata = () => {
96331
- const rawPackageVersion = "1.0.969";
96332
- const rawGitSha = "6760e4f2ebf91bf962991e425ba6144e8b535c4f";
96331
+ const rawPackageVersion = "1.0.971";
96332
+ const rawGitSha = "63cbb0f96bb83af343e80bf19971efbcdb57b1b0";
96333
96333
  const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
96334
96334
  const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
96335
96335
  return { packageVersion, gitSha };
@@ -128624,9 +128624,9 @@ var init_sentry = __esm({
128624
128624
  uncaughtExceptionMonitorInstalled = false;
128625
128625
  currentDevboxSentryUser = null;
128626
128626
  readBuildMetadata2 = () => {
128627
- const rawPackageVersion = "1.0.969";
128628
- const rawGitSha = "6760e4f2ebf91bf962991e425ba6144e8b535c4f";
128629
- const rawSentryRelease = "boxes-dev-dvb@1.0.969+6760e4f2ebf91bf962991e425ba6144e8b535c4f";
128627
+ const rawPackageVersion = "1.0.971";
128628
+ const rawGitSha = "63cbb0f96bb83af343e80bf19971efbcdb57b1b0";
128629
+ const rawSentryRelease = "boxes-dev-dvb@1.0.971+63cbb0f96bb83af343e80bf19971efbcdb57b1b0";
128630
128630
  const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
128631
128631
  const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
128632
128632
  const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
@@ -130818,7 +130818,7 @@ var init_packageVersion = __esm({
130818
130818
  return path8.join(process.cwd(), "dvb");
130819
130819
  };
130820
130820
  readEmbeddedPackageVersion = () => {
130821
- const raw = "1.0.969";
130821
+ const raw = "1.0.971";
130822
130822
  return trimVersion(raw);
130823
130823
  };
130824
130824
  readNearestPackageMetadata = (basePath) => {
@@ -58,7 +58,7 @@ boxes.dev, threads run on a devbox or, in an ordinary project, on the Template
58
58
  box.
59
59
 
60
60
  The agent is Codex or Claude, depending on what is enabled and authenticated.
61
- In the desktop app, GUI and Terminal are two views of that same conversation,
61
+ In the desktop app, GUI and the CLI are two views of that same conversation,
62
62
  not separate thread types. A thread may be user-started, setup-created, or
63
63
  spawned by an automation or integration.
64
64
 
@@ -227,7 +227,7 @@ but cannot connect to the editing machine.
227
227
 
228
228
  Select a thread in the left pane to open it in the detail pane. Codex and Claude
229
229
  threads, new-devbox placeholders, and automation views all use the same detail
230
- area. A Codex or Claude thread can switch between GUI and Terminal from its
230
+ area. A Codex or Claude thread can switch between GUI and the CLI from its
231
231
  header without becoming a different thread.
232
232
 
233
233
  To distinguish Claude and Codex threads at a glance, turn on **Show agent
@@ -45,7 +45,7 @@ A thread whose agent is Claude Code.
45
45
 
46
46
  A retired terminal-only Claude thread type. Existing rows may remain visible
47
47
  temporarily while they drain, but new work uses an ordinary Claude thread in
48
- Terminal view.
48
+ CLI view.
49
49
 
50
50
  ## Codex Thread
51
51
 
@@ -26,7 +26,7 @@ Use this terminology consistently:
26
26
  Template's saved version for a task, thread, automation run, or an
27
27
  integration-triggered run.
28
28
  - Thread: a Codex or Claude conversation connected to a runtime. In the
29
- desktop app, the same thread can use GUI or Terminal view.
29
+ desktop app, the same thread can use GUI or CLI view.
30
30
  - Snapshot: a saved filesystem state used to create future devboxes.
31
31
  - Selected runtime: the Template box or devbox currently selected in the app;
32
32
  terminals, ports, files, and runtime controls follow that selection.
@@ -43,13 +43,16 @@ Use this terminology consistently:
43
43
  copied-data boundaries.
44
44
  - `template-box-environment.md`: the Template box machine environment, baseline
45
45
  development tools, setup constraints, local-run verification, and snapshots.
46
+ - `managed-environment-files.md`: centrally managed dotenv files, initial
47
+ import, managed-prefix ownership, Team Template Team/member values,
48
+ reveal/export, outages, snapshots, security boundaries, and limits.
46
49
  - `shared-storage.md`: the shared `/project` folder, recommended uses and
47
50
  limitations, Claude project memory, persistence, access, and turning it off.
48
51
  - `core-concepts.md`: short definitions for projects, Template boxes, devboxes,
49
52
  Team Templates, threads, snapshots, wake/sleep, and selected runtime
50
53
  behavior.
51
54
  - `threads-and-agents.md`: creating and continuing Codex or Claude threads,
52
- choosing GUI or Terminal on desktop, safely draining remaining legacy Claude
55
+ choosing GUI or the CLI on desktop, safely draining remaining legacy Claude
53
56
  CLI threads, Template box versus devbox starts, goals, follow-ups, interrupts,
54
57
  retries, model controls, thread actions, and notifications.
55
58
  - `fork-workflows.md`: when to use a devbox, how devbox work starts, file
@@ -0,0 +1,149 @@
1
+ # Managed Environment Files
2
+
3
+ Use this doc for questions about centrally managed `.env` files, project
4
+ values, Team Template value requirements, imports, reveal/export, or sync
5
+ behavior.
6
+
7
+ ## What boxes.dev Manages
8
+
9
+ A project owner can register a project-relative dotenv file such as
10
+ `.env.local` in **Project settings → Environment files**. Each registered file
11
+ has its own list of names, values, optional inline comments, and descriptions.
12
+ The saved values are the source of truth: Template boxes and devboxes receive
13
+ updates, but changes made on a box never update the central copy.
14
+
15
+ boxes.dev writes a managed section at the start of the file and ends it with:
16
+
17
+ ```dotenv
18
+ # >>> BOXES_MANAGED_ENV_v1 <<<
19
+ ```
20
+
21
+ The section above and including that marker is replaced during sync. Everything
22
+ after it is local machine content and is preserved byte for byte. Do not edit
23
+ the managed section directly; use Project settings. A local value below the
24
+ marker may duplicate a managed name, but boxes.dev does not parse that tail or
25
+ treat duplicate names as a supported override mechanism.
26
+
27
+ New files are created with owner-only permissions. Existing regular files keep
28
+ their current owner, group, mode, and content below the marker. Unsafe paths,
29
+ symbolic-link traversal, and non-file destinations are refused.
30
+
31
+ ## Adding An Existing File
32
+
33
+ When a project owner first registers a path, boxes.dev checks that path on the
34
+ project's Template box. If an ordinary dotenv file exists, the editor recognizes
35
+ conservative single-line assignments and lets the owner choose for each one:
36
+
37
+ - **Manage**: save the value centrally and move the assignment into the managed
38
+ section;
39
+ - **Keep local**: leave the assignment in the file's local tail; or
40
+ - **Remove**: remove that recognized assignment when management starts.
41
+
42
+ Comments, blank lines, shell expressions, multiline constructs, and anything
43
+ else the importer does not recognize stay local. The file must still match the
44
+ version that was reviewed when the import is applied. If it changed, boxes.dev
45
+ leaves it alone and asks the owner to review it again. Import is a one-time
46
+ setup step; boxes.dev never imports later edits from an already managed file.
47
+
48
+ If the file does not exist, boxes.dev creates it. If it is too large or is not
49
+ valid UTF-8, automatic import is skipped and the complete existing file is
50
+ preserved below the new managed section.
51
+
52
+ When a team admin adds a file to a Team Template, boxes.dev checks the retained
53
+ source box for the latest saved release. Before the first release, it checks
54
+ that admin's current Team Template editing session. The admin must explicitly
55
+ classify every imported assignment as a Team value, a Member value, local
56
+ content, or removed content before saving.
57
+
58
+ Each derived or team-managed project applies that import decision once. If its
59
+ file still matches the reviewed source, boxes.dev moves or removes the selected
60
+ assignments. If the file has changed, boxes.dev adds the managed section but
61
+ preserves the complete existing file below it. This may leave a duplicate name
62
+ for the project owner to resolve, but does not discard local content.
63
+
64
+ ## Team Template Values
65
+
66
+ A team admin can add environment-file defaults to a Team Template. Each row is
67
+ either:
68
+
69
+ - **Team**: the admin supplies the shared value; or
70
+ - **Member**: each member supplies their own value during project creation.
71
+
72
+ A Member row can be required or optional and can include a description and
73
+ instructions for obtaining the value. Required values block creation of that
74
+ new project until they are entered; they do not block unrelated existing
75
+ devboxes or agent startup. Optional or otherwise missing values are omitted
76
+ from the file.
77
+
78
+ A normal project created from a Team Template receives an independent copy of
79
+ the definitions and the Team/member values entered for that project. Later Team
80
+ Template changes do not update it, and another project created from the same
81
+ template does not share its value objects.
82
+
83
+ A Team Template-managed project follows the current Team Template definitions
84
+ and Team values. Each member's values belong only to that member's exact
85
+ project. Members can replace, remove, reveal, copy, or export their own project
86
+ values, but cannot add centrally managed files or rows in this first version.
87
+ Team admins cannot read member values.
88
+
89
+ If an admin changes where a Member value will be written by renaming it or
90
+ moving its file, boxes.dev omits the old saved value. The member must review the
91
+ new destination and choose **Use saved value here**, or enter a replacement.
92
+ Other managed values continue syncing while that one is unresolved.
93
+
94
+ ## Sync And Outages
95
+
96
+ Managed files reconcile when a Template box or devbox starts or wakes, when a
97
+ change is observed, and during periodic retry. Changing a value does not wake a
98
+ paused machine. A failure in one file does not stop other files from updating.
99
+
100
+ If boxes.dev, its key service, or the network is temporarily unavailable, an
101
+ existing file remains unchanged and the machine continues starting. The daemon
102
+ retries later. A newly restored machine may therefore use the copy already in
103
+ its snapshot until sync succeeds.
104
+
105
+ ## Viewing And Recovering Current Values
106
+
107
+ Values are masked in normal project settings. Revealing values, showing a
108
+ value-bearing file preview, copying the managed file, or exporting it requires
109
+ a fresh confirmation with the Google account linked to the current boxes.dev
110
+ account. That confirmation applies only to the current signed-in session and
111
+ lasts five minutes. Closing the editor, navigating away, switching accounts,
112
+ signing out, or reaching the expiry removes the revealed plaintext from the
113
+ UI.
114
+
115
+ A Team Template admin can use the same confirmation to reveal or export the
116
+ Team values saved on that template. Member values are project-local and are
117
+ never revealed to the Team Template admin. A member can confirm with their own
118
+ Google account to reveal, copy, or export the current managed file for their
119
+ own Team Template-managed project.
120
+
121
+ boxes.dev keeps only the current central value. There is no per-value version
122
+ history, rollback, or recovery window. Replace or delete carefully, and rotate
123
+ credentials through their issuing service when necessary.
124
+
125
+ ## Security Boundaries
126
+
127
+ Central values are encrypted before they are stored, using a separate key scope
128
+ for each project or other value owner. The central database stores ciphertext,
129
+ not plaintext values or usable root encryption keys. Authorized boxes.dev
130
+ services can still decrypt current values when they must deliver, reveal, copy,
131
+ or export them; this is not end-to-end or zero-knowledge encryption.
132
+
133
+ Delivered files contain plaintext. A project owner, root user, process, or
134
+ coding agent on that machine can read them. Use development, staging, sandbox,
135
+ or narrowly scoped credentials rather than broad production credentials.
136
+
137
+ Snapshots preserve their filesystem, including managed environment files.
138
+ Replacing or deleting a central value does not erase an older value from an
139
+ existing snapshot, backup, running process, or already delivered machine.
140
+ Rotate or revoke the credential at its provider when that distinction matters.
141
+
142
+ ## Limits
143
+
144
+ The protective limits are:
145
+
146
+ - 64 KiB per value;
147
+ - 500 managed rows per file;
148
+ - 1 MiB for the rendered managed section; and
149
+ - 2 MiB for automatic import of an existing file.
@@ -128,13 +128,18 @@ close the desktop app, and stay in place until you stop sharing them. They do
128
128
  not wake a sleeping devbox: while the devbox sleeps, visitors see an
129
129
  unavailable page and the Ports menu marks the link as paused.
130
130
 
131
- The Ports button shows an active-link count. Open the Ports menu to copy,
132
- open, or stop sharing links from the selected port row. The **Public links**
133
- section keeps links from other devboxes, or links whose application is no
134
- longer detected, visible and individually stoppable. Choosing **Stop sharing**
135
- stops that boxes.dev public URL and sharing the port again later creates a new
136
- URL. It does not stop the application or change another network path the
137
- application may expose.
131
+ The Ports button and menu cover only the selected Template box or devbox. The
132
+ button shows that machine's active-link count, each detected port row offers
133
+ copy, open, and stop sharing, and the menu's **Public links** group keeps that
134
+ machine's links whose application is no longer detected visible and
135
+ individually stoppable. Every active link in the project lives in the
136
+ **Public links** sidebar section beside **Project URLs**. That section appears
137
+ while at least one link is active, names the machine that owns each link, and
138
+ lets you open, copy, or stop sharing any link without switching machines; the
139
+ Ports menu's **All public links…** entry jumps there. Choosing **Stop
140
+ sharing** stops that boxes.dev public URL and sharing the port again later
141
+ creates a new URL. It does not stop the application or change another network
142
+ path the application may expose.
138
143
 
139
144
  Inside a managed Template box or devbox, a shell script or coding agent can
140
145
  control the same public links for the physical current box:
@@ -1,9 +1,13 @@
1
1
  # Shared Project Storage
2
2
 
3
- Project storage gives a project one persistent folder shared by its devboxes.
4
- It is on by default during open beta and appears at `/project` inside each
5
- devbox. The Template box does not mount it, and Template box snapshots do not
6
- copy or replace its contents.
3
+ Project storage gives a project one persistent folder shared by its Template
4
+ box and devboxes. It is on by default during open beta and appears at
5
+ `/project` on each machine.
6
+
7
+ You can snapshot the Template box while `/project` is mounted. The snapshot
8
+ does not copy or replace the stored contents. When boxes.dev creates a devbox
9
+ from that snapshot, it reconnects `/project` for that devbox before the devbox
10
+ is ready.
7
11
 
8
12
  Use project storage for information that should follow work across devboxes,
9
13
  such as agent memory, reference files, handoff files, stable project data, and
@@ -14,14 +18,13 @@ package caches, logs, queues, build trees, or other high-churn workloads.
14
18
  ## Claude project memory
15
19
 
16
20
  When `/project` is mounted normally, boxes.dev directs Claude's automatic
17
- memory to the shared project storage. A memory Claude writes in one devbox can
18
- therefore inform Claude in another devbox for the same project.
21
+ memory to the shared project storage. A memory Claude writes on the Template
22
+ box or a devbox can therefore inform Claude on the project's other machines.
19
23
 
20
24
  Before broad launch, boxes.dev migrated eligible Claude auto memory from each
21
25
  existing project's Template box into `/project/.claude/memory`. It did not
22
- combine memory that existed only on other devboxes. The Template box still
23
- uses its own local memory and does not see memories written through
24
- `/project`.
26
+ combine memory that existed only on other devboxes. The Template box and
27
+ devboxes now use the shared memory while `/project` is mounted.
25
28
 
26
29
  Claude's own settings still take precedence. `autoMemoryEnabled: false` keeps
27
30
  automatic memory off, and an explicitly supplied memory directory remains in
@@ -32,24 +35,25 @@ boxes.dev does not redirect Codex state or transcripts there.
32
35
 
33
36
  ## Concurrent access and durability
34
37
 
35
- Multiple devboxes can read and write the folder. Updates can take about a
36
- second to become visible elsewhere, and truly simultaneous writes to the same
37
- file can fail or conflict. Avoid workflows that depend on local-disk latency,
38
- strict cache coherence, atomic appends from several writers, file locking, or
39
- many processes rewriting the same files.
38
+ The Template box and multiple devboxes can read and write the folder. Updates
39
+ can take about a second to become visible elsewhere, and truly simultaneous
40
+ writes to the same file can fail or conflict. Avoid workflows that depend on
41
+ local-disk latency, strict cache coherence, atomic appends from several
42
+ writers, file locking, or many processes rewriting the same files.
40
43
 
41
- Project storage survives devbox sleep, reset, destruction, and replacement.
42
- Deleting the boxes.dev project deletes its project storage. During open beta,
43
- keep another copy of anything you cannot recreate.
44
+ Project storage survives machine sleep and reset, as well as devbox
45
+ destruction and replacement. Deleting the boxes.dev project deletes its
46
+ project storage. During open beta, keep another copy of anything you cannot
47
+ recreate.
44
48
 
45
49
  ## Turning project storage off
46
50
 
47
51
  Open **Project settings** for the project and use **Project storage** to turn
48
52
  the mount off or back on. Turning it off detaches `/project` from the project's
49
- devboxes and removes their access, but it does not delete stored files.
50
- Re-enabling it mounts the same storage again.
53
+ Template box and devboxes and removes their access, but it does not delete
54
+ stored files. Re-enabling it mounts the same storage again.
51
55
 
52
56
  Machine access and thread sharing are separate. Anyone who is authorized to
53
- operate a devbox can naturally access the files mounted inside that devbox.
54
- Sharing an agent thread by itself does not grant devbox access, project-setting
55
- permission, or access to project storage.
57
+ operate a project machine can naturally access the files mounted inside that
58
+ machine. Sharing an agent thread by itself does not grant machine access,
59
+ project-setting permission, or access to project storage.
@@ -15,7 +15,7 @@ can run on:
15
15
  exists.
16
16
 
17
17
  The agent is Codex or Claude, depending on what is enabled and authenticated.
18
- In the desktop app, GUI and Terminal are two views of the same thread rather
18
+ In the desktop app, GUI and the CLI are two views of the same thread rather
19
19
  than separate agent choices.
20
20
 
21
21
  ## Starting A Thread
@@ -115,6 +115,32 @@ directory before the first prompt is sent. The options are the project
115
115
  directory and the tracked repo directories in that project. Existing threads
116
116
  continue in the working directory they were originally started with.
117
117
 
118
+ ## Recorded Agent Activity
119
+
120
+ boxes.dev records compact hourly token measurements from retained Codex and
121
+ Claude transcripts. These measurements describe activity visible in the
122
+ transcripts; they are separate from the provider's rate-limit windows and may
123
+ not match how the provider calculates quota use.
124
+
125
+ The prepared dialog is scoped to the thread that opens it. It shows that
126
+ thread's share of recorded tokens, model-call count, average and largest input
127
+ context, and the balance of new input, cached input, and generated output. Its
128
+ chart compares that thread with one aggregate `Other activity` series; it does
129
+ not name or link to other threads.
130
+
131
+ Activity includes the currently selected saved account when the running agent
132
+ can prove that account binding, plus earlier or transitional activity whose
133
+ thread is known but whose account cannot be matched safely. The dialog discloses
134
+ that uncertain account amount without assigning it to the selected account. A
135
+ known extraction gap is partial history, not zero usage.
136
+
137
+ The prepared usage-details dialog reads a 24-hour or seven-day point-in-time
138
+ snapshot and shows when it was recorded. The 24-hour chart is hourly; the
139
+ seven-day chart can show one-hour or one-day bars. Refreshing requests a new
140
+ snapshot; it does not subscribe to transcript changes. The dialog's production
141
+ entrypoint remains unavailable until the bounded seven-day history backfill and
142
+ release checks are complete.
143
+
118
144
  ## Continuing In A New Chat
119
145
 
120
146
  On a completed Codex or Claude response, choose **Continue in new chat** and
@@ -570,39 +596,39 @@ tools stay visible outside the collapsed activity in both styles, before the
570
596
  final agent reply. Clear **View > Diagnostics > Use Collapsed Transcript
571
597
  History** to show older intermediate activity inline instead.
572
598
 
573
- ## GUI And Terminal Views
599
+ ## GUI And CLI Views
574
600
 
575
601
  On desktop, a thread uses Claude or Codex as its agent and can be viewed in GUI
576
- or Terminal. These are two views of the same conversation, not separate thread
602
+ or the CLI. These are two views of the same conversation, not separate thread
577
603
  types. Every new-thread entry point first opens a draft on the location that
578
604
  entry point already chose. The prominent selector changes the agent; the quiet
579
- **Start in Terminal** or **Back to the GUI composer** action changes the draft
605
+ **Start in the CLI** or **Back to the GUI composer** action changes the draft
580
606
  view without asking for the runtime target again.
581
607
 
582
- A GUI draft has the normal composer. A Terminal draft has no composer and uses
583
- **Open Terminal** to commit the draft to the selected runtime; the first prompt
608
+ A GUI draft has the normal composer. A CLI draft has no composer and uses
609
+ **Open CLI** to commit the draft to the selected runtime; the first prompt
584
610
  is then typed directly into the agent's interactive terminal. Merely selecting
585
- Terminal keeps any GUI draft text and attachments intact in case the user
586
- returns to GUI. **Open Terminal** warns before discarding GUI-only text,
611
+ the CLI view keeps any GUI draft text and attachments intact in case the user
612
+ returns to GUI. **Open CLI** warns before discarding GUI-only text,
587
613
  attachments, or review content that cannot be transferred to the terminal.
588
614
 
589
- GUI and Terminal keep independent unsent input. Switching views does not move
615
+ GUI and the CLI keep independent unsent input. Switching views does not move
590
616
  or clear the other view's draft. For Codex, returning to GUI parks the local
591
- Terminal renderer, so its unsent terminal input remains available when the user
592
- returns to Terminal. For Claude Code, returning to GUI closes the native
617
+ CLI renderer, so its unsent terminal input remains available when the user
618
+ returns to the CLI. For Claude Code, returning to GUI closes the native
593
619
  terminal writer; the confirmation warns that unsent terminal input will be
594
620
  lost and identifies any saved GUI draft that will reappear.
595
621
 
596
- Opening Claude Code in Terminal switches directly while its GUI agent is idle.
622
+ Opening Claude Code in the CLI switches directly while its GUI agent is idle.
597
623
  It requires confirmation if the GUI agent is working or another client owns
598
624
  the terminal attachment. The transition can interrupt the current Claude turn
599
625
  or move the attachment to this desktop. A failed transition leaves the current
600
- view selected rather than claiming the switch succeeded. Codex Terminal can
626
+ view selected rather than claiming the switch succeeded. The Codex CLI can
601
627
  attach to the same active conversation without interrupting the turn.
602
628
 
603
- A managed Claude Code Terminal stays bound to the boxes.dev thread and working
629
+ A managed Claude Code CLI stays bound to the boxes.dev thread and working
604
630
  directory it opened. Claude's Agent View and Remote Control are unavailable in
605
- that Terminal. Commands that would replace or move its session—`/clear`,
631
+ that CLI. Commands that would replace or move its session—`/clear`,
606
632
  `/resume`, `/continue`, `/branch`, `/teleport`, `/tp`, and `/cd`—are rejected;
607
633
  open or create the intended boxes.dev thread instead. Use `/add-dir` when Claude
608
634
  only needs access to another directory. Session-preserving controls such as
@@ -610,17 +636,19 @@ only needs access to another directory. Session-preserving controls such as
610
636
  available. An ordinary `claude` started in a separate machine shell keeps its
611
637
  stock behavior.
612
638
 
613
- For a started desktop thread, the small Terminal button in the normal thread
614
- header opens a one-command menu: **Switch view to Terminal** or **Switch view
615
- to GUI**. The same header keeps sharing and thread actions available in
616
- Terminal. A project's default view changes only after a GUI first message is
617
- successfully sent or **Open Terminal** successfully commits a new thread;
618
- merely previewing the other draft view does not change future drafts.
639
+ For a started desktop thread, the normal thread header shows a small pill
640
+ named for the current view (**GUI** or **CLI**). It opens a **Thread view**
641
+ menu listing both views; choosing the other view switches this thread, and an
642
+ unavailable CLI view stays listed with the reason it cannot open. The same
643
+ header keeps sharing and thread actions available in the CLI. A project's
644
+ default view changes only after a GUI first message is successfully sent or
645
+ **Open CLI** successfully commits a new thread; merely previewing the other
646
+ draft view does not change future drafts.
619
647
 
620
648
  Legacy Claude CLI threads may still appear temporarily while boxes.dev retires
621
649
  that older thread type. A running legacy terminal can be attached long enough
622
650
  to drain safely, but a missing legacy terminal cannot be restarted. Start a
623
- Claude thread in Terminal for new work.
651
+ Claude thread in the CLI view for new work.
624
652
 
625
653
  ## Interrupts And Stops
626
654
 
@@ -698,7 +726,7 @@ An owner can also share an eligible started Codex or Claude Code transcript
698
726
  with anyone on their team who has the link. The share includes the live durable
699
727
  conversation, status, commands, tool output, diffs, attachments, and images, so
700
728
  review the conversation for source, credentials, or other sensitive content
701
- before sharing it. GUI and Terminal views share the same ordinary conversation,
729
+ before sharing it. GUI and CLI views share the same ordinary conversation,
702
730
  so the selected view does not change sharing eligibility. Drafts, setup threads,
703
731
  and conversations that have not started cannot be shared.
704
732
 
@@ -725,11 +753,15 @@ Opening the same active share link or pinning the thread again restores the
725
753
  row. Read and unread state is personal to each viewer and does not change the
726
754
  owner's state.
727
755
 
728
- Under **Thread titles**, a teammate can choose **Request access**. The owner
729
- can review requests in the desktop sharing manager or on mobile. Accepting a
730
- request makes the current share link available to that requester in boxes.dev;
731
- the requester opens it to complete access and add the thread to
732
- **Shared with me**. Requests do not send email or push notifications.
756
+ Under **Thread titles**, a teammate can choose **Request access**. On desktop,
757
+ the project sidebar's **Shared by me** section appears whenever the selected
758
+ project has an active share or a pending access request. Shared threads are
759
+ listed with copy-link and revoke controls, pending requests appear above them
760
+ with accept and dismiss controls, and selecting any row opens that thread.
761
+ Owners can also review requests on mobile. Accepting a request will make the
762
+ current share link available to that requester in boxes.dev; the requester
763
+ opens it to complete access and add the thread to **Shared with me**. Requests
764
+ do not send email or push notifications.
733
765
 
734
766
  The active share keeps the same URL until the owner revokes it. Revocation
735
767
  immediately makes that URL unavailable and removes access that depended on
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@boxes-dev/dvb-runtime",
3
- "version": "1.0.969",
3
+ "version": "1.0.971",
4
4
  "type": "module",
5
5
  "license": "UNLICENSED",
6
6
  "imports": {
@@ -77,5 +77,5 @@
77
77
  "e2b": "^2.18.0",
78
78
  "ink-testing-library": "^4.0.0"
79
79
  },
80
- "devboxReleasedAt": "2026-08-31T01:53:02Z"
80
+ "devboxReleasedAt": "2026-09-01T03:46:51Z"
81
81
  }