@boxes-dev/dvb-runtime 1.0.1090 → 1.0.1091

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
@@ -70354,9 +70354,9 @@ var init_sentry = __esm({
70354
70354
  uncaughtExceptionMonitorInstalled = false;
70355
70355
  currentDevboxSentryUser = null;
70356
70356
  readBuildMetadata = () => {
70357
- const rawPackageVersion = "1.0.1090";
70358
- const rawGitSha = "3f0bdf7d221d08b87ccce78bc602dcbbeb4a7bbc";
70359
- const rawSentryRelease = "boxes-dev-dvb@1.0.1090+3f0bdf7d221d08b87ccce78bc602dcbbeb4a7bbc";
70357
+ const rawPackageVersion = "1.0.1091";
70358
+ const rawGitSha = "e27d9d3c12d578e97515be216373f3634d2b454e";
70359
+ const rawSentryRelease = "boxes-dev-dvb@1.0.1091+e27d9d3c12d578e97515be216373f3634d2b454e";
70360
70360
  const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
70361
70361
  const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
70362
70362
  const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
@@ -75740,7 +75740,7 @@ var init_packageVersion = __esm({
75740
75740
  return path18.join(process.cwd(), "dvb");
75741
75741
  };
75742
75742
  readEmbeddedPackageVersion = () => {
75743
- const raw = "1.0.1090";
75743
+ const raw = "1.0.1091";
75744
75744
  return trimVersion(raw);
75745
75745
  };
75746
75746
  readNearestPackageMetadata = (basePath) => {
package/dist/bin/dvbd.mjs CHANGED
@@ -64675,9 +64675,9 @@ var init_sentry = __esm({
64675
64675
  uncaughtExceptionMonitorInstalled = false;
64676
64676
  currentDevboxSentryUser = null;
64677
64677
  readBuildMetadata = () => {
64678
- const rawPackageVersion = "1.0.1090";
64679
- const rawGitSha = "3f0bdf7d221d08b87ccce78bc602dcbbeb4a7bbc";
64680
- const rawSentryRelease = "boxes-dev-dvb@1.0.1090+3f0bdf7d221d08b87ccce78bc602dcbbeb4a7bbc";
64678
+ const rawPackageVersion = "1.0.1091";
64679
+ const rawGitSha = "e27d9d3c12d578e97515be216373f3634d2b454e";
64680
+ const rawSentryRelease = "boxes-dev-dvb@1.0.1091+e27d9d3c12d578e97515be216373f3634d2b454e";
64681
64681
  const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
64682
64682
  const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
64683
64683
  const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
@@ -66894,7 +66894,7 @@ var init_packageVersion = __esm({
66894
66894
  return path8.join(process.cwd(), "dvb");
66895
66895
  };
66896
66896
  readEmbeddedPackageVersion = () => {
66897
- const raw = "1.0.1090";
66897
+ const raw = "1.0.1091";
66898
66898
  return trimVersion(raw);
66899
66899
  };
66900
66900
  readNearestPackageMetadata = (basePath) => {
@@ -198,12 +198,14 @@ of running a per-machine `aws sso login` or copying an SSO token cache. Setup
198
198
  merges those unrelated settings without replacing the current AWS config or
199
199
  overwriting boxes.dev-managed profile sections.
200
200
 
201
- If `~/.aws/config` already contains an unmarked user-owned section with the
202
- same name as a managed profile, boxes.dev does not overwrite it. Other managed
203
- profiles still apply. Rename or remove the colliding user-owned section, then
204
- choose **Try again** on the AWS integration page. Other profiles, comments,
205
- and AWS settings remain untouched when boxes.dev adds, changes, or removes its
206
- marked section.
201
+ Profile names starting with `boxes-` in `~/.aws/config` belong to boxes.dev.
202
+ During each sync and before an agent starts, boxes.dev restores those sections
203
+ from the project's AWS settings and removes managed names that are no longer
204
+ configured. This also repairs edits that strip or damage the ownership comments,
205
+ change a helper command, or duplicate a managed section. Other profiles,
206
+ comments, and settings are preserved, including aliases such as `oro-staging`
207
+ that call a managed profile's helper. Change managed access through the AWS page;
208
+ use names outside `boxes-*` for personal profiles and aliases.
207
209
 
208
210
  ## Central Sign-In And Refresh
209
211
 
@@ -302,9 +304,9 @@ managed profile and select it explicitly.
302
304
  A team can still add a separate user-owned AWS profile on a box, such as an
303
305
  `admin` profile backed by its own `credential_process` command.
304
306
 
305
- Keep that profile separate from `boxes-dev` and select it explicitly when
306
- needed. boxes.dev never manages, refreshes, or overwrites profiles it did not
307
- create, so the team remains responsible for that profile's command,
307
+ Give that profile a name outside `boxes-*` and select it explicitly when
308
+ needed. boxes.dev does not manage, refresh, or overwrite those profiles,
309
+ so the team remains responsible for that profile's command,
308
310
  authentication, permissions, and lifecycle.
309
311
 
310
312
  ## Containers And Current Limits
@@ -63,8 +63,9 @@ prepared devboxes stay sleeping and do not use box-hours or awake-devbox
63
63
  capacity. After a prepared devbox is assigned and wakes for the member, it is
64
64
  accounted for exactly like that member's other devboxes.
65
65
 
66
- The desktop titlebar can show a usage icon next to the project selector; hover
67
- or click it for current box-hour usage, the billing period end date when
66
+ The desktop account row can show a usage icon just left of Help at the bottom
67
+ of the sidebar; hover over or click it for current box-hour usage, the billing
68
+ period end date when
68
69
  available, and awake devbox usage. The billing page shows
69
70
  usage for the current billing period. Its Usage history section shows
70
71
  box-hours used by hour for the last 24 hours or seven days, plus the boxes that
@@ -173,6 +174,10 @@ Common team-admin actions:
173
174
  Mobile shows billing and usage status in settings, but detailed billing
174
175
  management is primarily web and desktop.
175
176
 
177
+ An agent on a box can read the owner's plan, seat, box-hours, awake devboxes,
178
+ and team credit balance with `dvb-onbox billing status`. See
179
+ `onbox-agent-tools.md`.
180
+
176
181
  ## Common Billing Blocks
177
182
 
178
183
  Project setup, waking a box, creating a new devbox + thread, and automation
@@ -10,9 +10,8 @@ runtime.
10
10
  The workbench has a few persistent areas:
11
11
 
12
12
  - The top bar is split at the left pane's edge. The left pane's own top area
13
- shows the project selector, a back button, a crosshair button, a thread
14
- search button, and a usage icon (billing
15
- usage details on hover, when relevant). The back button retraces earlier workbench
13
+ shows the project selector, a back button, and a crosshair button.
14
+ The back button retraces earlier workbench
16
15
  selections, so an integration or automation detour can return to the thread
17
16
  you were viewing. It is disabled until there is somewhere to return. The
18
17
  crosshair button scrolls the thread list to the selected thread, first
@@ -27,7 +26,8 @@ The workbench has a few persistent areas:
27
26
  If the app loses its connection, an Offline or Reconnecting badge appears
28
27
  beside the pane control and clears on its own once boxes.dev is reachable
29
28
  again.
30
- - The left pane starts with Devboxes and its **New thread** header button,
29
+ - The left pane starts with Devboxes, with thread search immediately left of
30
+ its **New thread** header button,
31
31
  followed by Automations and Project. Expand Project for Integrations,
32
32
  Project URLs, Public links when active, sharing, and the Template box when
33
33
  the project has one. The gear on the Project header opens Project settings,
@@ -39,7 +39,8 @@ The workbench has a few persistent areas:
39
39
  Shared by me expands this project's shares and access requests. Sharing
40
40
  rows appear when they have items. Collapsed Project and Template box controls
41
41
  retain cues for activity, unread updates, or attention in their contents.
42
- Your account identity and a Help button stay pinned at the bottom.
42
+ Your account identity, usage icon, and Help button stay pinned at the bottom.
43
+ Hover over or click the usage icon just left of Help for billing usage details.
43
44
  Once you've sent messages in three threads (not counting project setup
44
45
  threads), a **Code on the go!** banner appears above your account if you
45
46
  haven't signed in to the mobile app. Scan its QR code to download the mobile
@@ -498,7 +499,8 @@ terminal bell can request attention without adding an unread thread.
498
499
  ## Search Your Threads
499
500
 
500
501
  Press **Cmd+F** (Ctrl+F), or choose the search button (a magnifying glass)
501
- beside the back button, to open thread search. It searches the titles and
502
+ to the left of **New thread** in the **Devboxes** heading, to open thread search.
503
+ It searches the titles and
502
504
  text of your own Codex and Claude threads across all of your projects, including archived
503
505
  threads, threads on sleeping machines,
504
506
  and threads kept in cold storage. Searching never wakes a machine.
@@ -84,9 +84,10 @@ The terminal pane connects to the selected runtime. If you select a devbox, the
84
84
  terminal is for that devbox. If you select the Template box, the terminal is for
85
85
  the Template box.
86
86
 
87
- The titlebar shows the selected project/runtime, runtime status, billing usage
88
- when relevant, the Terminal/Files/Git/Review pane control, forwarded ports, and
89
- other workspace actions.
87
+ The titlebar shows the selected project/runtime, runtime status, the
88
+ Terminal/Files/Git/Review pane control, forwarded ports, and other workspace
89
+ actions. Billing usage is beside Help in the account row at the bottom of the
90
+ left pane.
90
91
 
91
92
  Files and Git/Review open as workbench panes that can dock beside the thread or
92
93
  pop out. Use Files for browsing, media, downloads, uploads, and plain-file
@@ -80,6 +80,45 @@ permission and works on a Template box, a devbox, and a Team Template editing
80
80
  machine. Use it when a script or tool needs to attribute work to the person who
81
81
  owns the box; it does not identify who sent a particular message.
82
82
 
83
+ ## Plan And Usage
84
+
85
+ An on-box agent can read the plan and current usage of the boxes.dev account
86
+ that owns the box. Use it to answer questions such as "What plan am I on?" or
87
+ "How many box-hours do I have left?" instead of sending the user to Billing:
88
+
89
+ ```bash
90
+ dvb-onbox billing status
91
+ dvb-onbox billing status --json
92
+ ```
93
+
94
+ The result uses the same names and units that Billing and the desktop usage
95
+ icon show, so you can repeat them to the user as they are:
96
+
97
+ - `team` and `plan`: the team's name and plan, such as Trial, Starter, or Pro.
98
+ - `seat`: the owner's seat, such as Paid seat or Trial. A member of a team on a
99
+ paid plan stays on their trial until a team admin assigns them a paid seat.
100
+ - `status` and `statusDetail`: the owner's usage status as Billing shows it,
101
+ such as "Usage on track" or "Trial exhausted", with the next step when new
102
+ work is blocked.
103
+ - `boxHoursUsed` and `boxHoursIncluded`: box-hours used this billing period and
104
+ the owner's included box-hours. `boxHoursIncluded` is `Unlimited` when usage
105
+ has no included limit.
106
+ - `includedBoxHoursRemaining`: included box-hours left this billing period, or
107
+ `null` when usage has no included limit.
108
+ - `paidOverageRemaining`: how many more box-hours the team's usage credits can
109
+ pay for at the owner's plan rate, or `null` when the owner's plan doesn't use
110
+ credits for box-hours.
111
+ - `awakeDevboxes` and `awakeDevboxLimit`: how many of the owner's devboxes are
112
+ awake now and how many can be awake at once. The Template box doesn't count
113
+ toward the limit. `awakeDevboxLimit` is `null` when the plan doesn't show a
114
+ limit.
115
+ - `usageCredits`: the team's prepaid credit balance.
116
+ - `billingPeriodEndsAt`: when the current billing period ends, or `null`.
117
+
118
+ The command needs no permission and works on a Template box, a devbox, and a
119
+ Team Template editing machine. It only reads billing. A team admin needs to
120
+ change the plan, paid seats, or credits in Billing.
121
+
83
122
  ## Feedback And Bug Reports
84
123
 
85
124
  An on-box agent can send feedback straight to the boxes.dev team. Use
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@boxes-dev/dvb-runtime",
3
- "version": "1.0.1090",
3
+ "version": "1.0.1091",
4
4
  "description": "Runtime for the boxes.dev CLI. Install @boxes-dev/dvb to use the CLI.",
5
5
  "homepage": "https://boxes.dev",
6
6
  "type": "module",
@@ -77,5 +77,5 @@
77
77
  "e2b": "^2.18.0",
78
78
  "ink-testing-library": "^4.0.0"
79
79
  },
80
- "devboxReleasedAt": "2026-10-18T00:54:00Z"
80
+ "devboxReleasedAt": "2026-10-18T04:26:46Z"
81
81
  }