@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 +4 -4
- package/dist/bin/dvbd.mjs +4 -4
- package/dist/product-docs/references/aws.md +11 -9
- package/dist/product-docs/references/billing-and-limits.md +7 -2
- package/dist/product-docs/references/desktop-workbench.md +8 -6
- package/dist/product-docs/references/getting-started.md +4 -3
- package/dist/product-docs/references/onbox-agent-tools.md +39 -0
- package/package.json +2 -2
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.
|
|
70358
|
-
const rawGitSha = "
|
|
70359
|
-
const rawSentryRelease = "boxes-dev-dvb@1.0.
|
|
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.
|
|
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.
|
|
64679
|
-
const rawGitSha = "
|
|
64680
|
-
const rawSentryRelease = "boxes-dev-dvb@1.0.
|
|
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.
|
|
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
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
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
|
-
|
|
306
|
-
needed. boxes.dev
|
|
307
|
-
|
|
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
|
|
67
|
-
or click it for current box-hour usage, the billing
|
|
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
|
|
14
|
-
|
|
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
|
|
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
|
|
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
|
-
|
|
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,
|
|
88
|
-
|
|
89
|
-
|
|
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.
|
|
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-
|
|
80
|
+
"devboxReleasedAt": "2026-10-18T04:26:46Z"
|
|
81
81
|
}
|