@boxes-dev/dvb-runtime 1.0.1078 → 1.0.1079
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/managed-environment-files.md +14 -1
- package/dist/product-docs/references/member-managed-files.md +9 -0
- package/dist/product-docs/references/onbox-agent-tools.md +21 -16
- package/dist/product-docs/references/team-template.md +24 -7
- package/dist/product-docs/references/threads-and-agents.md +10 -0
- package/package.json +2 -2
package/dist/bin/dvb.mjs
CHANGED
|
@@ -69730,9 +69730,9 @@ var init_sentry = __esm({
|
|
|
69730
69730
|
uncaughtExceptionMonitorInstalled = false;
|
|
69731
69731
|
currentDevboxSentryUser = null;
|
|
69732
69732
|
readBuildMetadata = () => {
|
|
69733
|
-
const rawPackageVersion = "1.0.
|
|
69734
|
-
const rawGitSha = "
|
|
69735
|
-
const rawSentryRelease = "boxes-dev-dvb@1.0.
|
|
69733
|
+
const rawPackageVersion = "1.0.1079";
|
|
69734
|
+
const rawGitSha = "b4796ddf10b015d808aba367f5eeb521c6ea0812";
|
|
69735
|
+
const rawSentryRelease = "boxes-dev-dvb@1.0.1079+b4796ddf10b015d808aba367f5eeb521c6ea0812";
|
|
69736
69736
|
const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
|
|
69737
69737
|
const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
|
|
69738
69738
|
const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
|
|
@@ -75116,7 +75116,7 @@ var init_packageVersion = __esm({
|
|
|
75116
75116
|
return path18.join(process.cwd(), "dvb");
|
|
75117
75117
|
};
|
|
75118
75118
|
readEmbeddedPackageVersion = () => {
|
|
75119
|
-
const raw = "1.0.
|
|
75119
|
+
const raw = "1.0.1079";
|
|
75120
75120
|
return trimVersion(raw);
|
|
75121
75121
|
};
|
|
75122
75122
|
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.1079";
|
|
64679
|
+
const rawGitSha = "b4796ddf10b015d808aba367f5eeb521c6ea0812";
|
|
64680
|
+
const rawSentryRelease = "boxes-dev-dvb@1.0.1079+b4796ddf10b015d808aba367f5eeb521c6ea0812";
|
|
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.1079";
|
|
66898
66898
|
return trimVersion(raw);
|
|
66899
66899
|
};
|
|
66900
66900
|
readNearestPackageMetadata = (basePath) => {
|
|
@@ -115,6 +115,19 @@ Claude session. In a Team Template-managed project, the desktop app warns the
|
|
|
115
115
|
member about each missing required value, such as one the team added later,
|
|
116
116
|
and links to **Project settings**.
|
|
117
117
|
|
|
118
|
+
Project creation groups required values and member files under **Needed to
|
|
119
|
+
create the project**. **Optional values** starts collapsed, groups rows by destination
|
|
120
|
+
file and shows search when there are more than eight optional rows. Search
|
|
121
|
+
and disclosure changes preserve entered values. Identical names in different
|
|
122
|
+
files remain separate inputs. Optional values never block creation, but the
|
|
123
|
+
tools that use them may need them later.
|
|
124
|
+
|
|
125
|
+
Unsaved values are readable by default. One **Hide values** / **Show values**
|
|
126
|
+
setting applies across required and optional inputs for this setup session.
|
|
127
|
+
The form's bottom actions name missing requirements and link to their fields;
|
|
128
|
+
submitting an incomplete form marks and focuses the missing inputs. A failed
|
|
129
|
+
creation attempt keeps the entries available for retry.
|
|
130
|
+
|
|
118
131
|
A normal project created from a Team Template receives an independent copy of
|
|
119
132
|
the definitions and the Team/member values entered for that project. Later Team
|
|
120
133
|
Template changes do not update it, and another project created from the same
|
|
@@ -123,7 +136,7 @@ template does not share its value objects.
|
|
|
123
136
|
A Team Template-managed project follows the current Team Template definitions
|
|
124
137
|
and Team values. Each member's values belong only to that member's exact
|
|
125
138
|
project. Members can replace, remove, reveal, copy, or export their own project
|
|
126
|
-
values. Team admins cannot read member values.
|
|
139
|
+
values. Team admins cannot read member values through Team Template management.
|
|
127
140
|
|
|
128
141
|
A member can also add their own variables in **Project settings → Environment
|
|
129
142
|
files**: in a file the Team Template manages, or in a new file of their own
|
|
@@ -27,6 +27,15 @@ the project. The original local filename is used only in that browser view and
|
|
|
27
27
|
is not saved by boxes.dev. Files may contain arbitrary bytes and can be up to
|
|
28
28
|
256 KiB.
|
|
29
29
|
|
|
30
|
+
During project creation, files appear with required environment values under
|
|
31
|
+
**Needed to create the project**, before the collapsed optional values. **Choose file**
|
|
32
|
+
opens the native file picker. After reading it, the form shows the local
|
|
33
|
+
filename and byte size, with **Change** and **Remove** actions.
|
|
34
|
+
Reading the file does not verify its contents or credentials.
|
|
35
|
+
Home destinations use `~/` in this form.
|
|
36
|
+
Oversized or unreadable files show an error at that requirement. The bottom
|
|
37
|
+
actions name missing files and link back to them.
|
|
38
|
+
|
|
30
39
|
## Storage And Delivery
|
|
31
40
|
|
|
32
41
|
boxes.dev encrypts each member file for that exact project. An ordinary project
|
|
@@ -1200,11 +1200,15 @@ observing until it starts or fails. A wait without `--turn` can return `idle`
|
|
|
1200
1200
|
in that interval; it does not prove the assignment has finished. After a wait
|
|
1201
1201
|
times out, wait again on the same turn while the assignment remains pending.
|
|
1202
1202
|
|
|
1203
|
-
|
|
1204
|
-
|
|
1205
|
-
|
|
1206
|
-
|
|
1207
|
-
|
|
1203
|
+
Choose how to exchange work based on the child's assignment. For a
|
|
1204
|
+
self-contained task, collect its final reply with `threads wait` or
|
|
1205
|
+
`threads result`; you can forward that result to another child with
|
|
1206
|
+
`threads send`. For direct collaboration during a turn, use `threads message`
|
|
1207
|
+
to exchange questions, findings, and feedback with the parent or other agents.
|
|
1208
|
+
|
|
1209
|
+
Collecting and forwarding final replies needs only **Create devboxes and
|
|
1210
|
+
threads**. Direct messages need **Message other agents** on both the sending
|
|
1211
|
+
and receiving devboxes (see
|
|
1208
1212
|
[Message Other Agents](#message-other-agents)). When a plan depends on those
|
|
1209
1213
|
messages, request `message-agents` once before starting the children. The
|
|
1210
1214
|
request returns `already_granted` immediately when messaging is already on.
|
|
@@ -1275,17 +1279,17 @@ matches more than one thread you can read, use the thread's `id` instead.
|
|
|
1275
1279
|
Listings, reads, and search results report the thread's last-reported execution
|
|
1276
1280
|
`status`: `draft`, `starting`, `idle`, `running`, `needs_input`, `failed`, or
|
|
1277
1281
|
`archived`. They also include `activeTurnId` and `activeTurnStatus` (both
|
|
1278
|
-
nullable), alongside `updatedAt`.
|
|
1279
|
-
|
|
1280
|
-
|
|
1281
|
-
before a message arrives, so they do not guarantee idle-only delivery.
|
|
1282
|
-
status does not wake a devbox or require delegation permission.
|
|
1282
|
+
nullable), alongside `updatedAt`. Use the thread's `status` to check its
|
|
1283
|
+
execution state. `transcript.status: ready` only means its conversation can
|
|
1284
|
+
be read, even while the agent is working. These stored states can lag live work
|
|
1285
|
+
or change before a message arrives, so they do not guarantee idle-only delivery.
|
|
1286
|
+
Reading status does not wake a devbox or require delegation permission.
|
|
1283
1287
|
|
|
1284
1288
|
For known threads, fetch their metadata together instead of scanning the whole
|
|
1285
1289
|
project or reading their conversations:
|
|
1286
1290
|
|
|
1287
1291
|
```bash
|
|
1288
|
-
dvb-onbox threads status --scope project --ids-file
|
|
1292
|
+
dvb-onbox threads status --scope project --ids-file thread-ids.json --json
|
|
1289
1293
|
```
|
|
1290
1294
|
|
|
1291
1295
|
The file must contain a JSON array of 1 through 100 thread `id` values from
|
|
@@ -1393,7 +1397,7 @@ dvb-onbox threads message --to <thread-id> \
|
|
|
1393
1397
|
--message "The endpoint now returns 422 for invalid widgets." --json
|
|
1394
1398
|
|
|
1395
1399
|
dvb-onbox threads message --to <thread-id> --message "Review the endpoint." \
|
|
1396
|
-
--idempotency-key
|
|
1400
|
+
--idempotency-key endpoint-review-1 --idle-only --json
|
|
1397
1401
|
|
|
1398
1402
|
dvb-onbox threads message --batch-file /tmp/messages.json --idle-only --json
|
|
1399
1403
|
```
|
|
@@ -1402,7 +1406,7 @@ The batch file is a JSON array of 1–100 objects, up to 3 MiB:
|
|
|
1402
1406
|
|
|
1403
1407
|
```json
|
|
1404
1408
|
[
|
|
1405
|
-
{"to": "<thread-id>", "message": "Review the endpoint.", "idempotencyKey": "
|
|
1409
|
+
{"to": "<thread-id>", "message": "Review the endpoint.", "idempotencyKey": "endpoint-review-1"}
|
|
1406
1410
|
]
|
|
1407
1411
|
```
|
|
1408
1412
|
|
|
@@ -1444,8 +1448,9 @@ instead.
|
|
|
1444
1448
|
Keys reuse the same receipt on the same source machine, including across CLI
|
|
1445
1449
|
invocations. Retrying with the same key and message recovers that outcome
|
|
1446
1450
|
without another delivery. Changing the recipient, message, attachments, or
|
|
1447
|
-
idle-only policy under that key fails with `idempotency_key_reused`. Use a new
|
|
1448
|
-
|
|
1451
|
+
idle-only policy under that key fails with `idempotency_key_reused`. Use a new
|
|
1452
|
+
key for each distinct message. If delivery was skipped because the recipient
|
|
1453
|
+
was busy, use a new key if you later decide to send it again.
|
|
1449
1454
|
|
|
1450
1455
|
`--to` takes a boxes.dev thread ID, such as one named in a received message,
|
|
1451
1456
|
one returned by `dvb-onbox threads start`, or one from
|
|
@@ -1489,7 +1494,7 @@ the outcome before reporting `operation_indeterminate`, so a script that runs
|
|
|
1489
1494
|
it should allow at least four minutes per delivery; batches may need longer
|
|
1490
1495
|
because each group can include slow wakes. If a send is stopped early, recover
|
|
1491
1496
|
with the same key or treat the unkeyed message as possibly delivered. Batch
|
|
1492
|
-
|
|
1497
|
+
delivery time depends on how long recipients' devboxes take to wake or update.
|
|
1493
1498
|
|
|
1494
1499
|
If sending reports `messaging_disabled`, request `message-agents`.
|
|
1495
1500
|
`recipient_messaging_disabled` means the recipient's devbox has messaging off;
|
|
@@ -440,13 +440,30 @@ another.
|
|
|
440
440
|
|
|
441
441
|
## Creating A Project
|
|
442
442
|
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
Select the exact template,
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
|
|
443
|
+
Start the ordinary new-project flow and choose **Start from a Team Template**.
|
|
444
|
+
The picker shows only templates with a current saved version and does not
|
|
445
|
+
preselect one. Select the exact template, name the project and complete
|
|
446
|
+
**Needed to create the project**, which brings required environment values
|
|
447
|
+
and all member files together. **Optional values** starts collapsed; these
|
|
448
|
+
can be added now or later in Project settings. Independent projects also
|
|
449
|
+
offer coding-agent choices; at least one must be selected when the template
|
|
450
|
+
includes setup instructions. Team defaults remain available for review.
|
|
451
|
+
|
|
452
|
+
The persistent bottom actions identify missing items and link to their
|
|
453
|
+
fields. **Create project** marks missing fields and focuses the first one.
|
|
454
|
+
Checks still enforce GitHub access, billing and the template's actual
|
|
455
|
+
requirements; values being present does not prove the credentials work.
|
|
456
|
+
|
|
457
|
+
**Change template** keeps the active draft in memory, and **Back to setup**
|
|
458
|
+
returns to it from the picker. Selecting a different template or closing setup
|
|
459
|
+
asks before discarding meaningful entries. Reloading clears unsaved entries; there is
|
|
460
|
+
no cross-session draft storage. Creation errors keep the entries for retry.
|
|
461
|
+
|
|
462
|
+
Git identity appears as an account summary. **Edit account identity** opens
|
|
463
|
+
the fields, and changes update the account identity when the project is
|
|
464
|
+
created. An opted-out account stays opted out unless the member chooses
|
|
465
|
+
**Turn on for your account**. This does not create a project-specific Git
|
|
466
|
+
identity.
|
|
450
467
|
|
|
451
468
|
For saved GitHub repositories, project creation checks the member's current
|
|
452
469
|
boxes.dev GitHub connection and pull/push access. Any GitHub maintenance watch,
|
|
@@ -1210,6 +1210,16 @@ Thread rows can show unread and active indicators so users can see which
|
|
|
1210
1210
|
threads need attention. Desktop and mobile notifications can also point users
|
|
1211
1211
|
back to threads that finished, need input, or changed state.
|
|
1212
1212
|
|
|
1213
|
+
While boxes.dev is in the foreground, phone alerts stay quiet for all projects.
|
|
1214
|
+
When boxes.dev is in the background and the user is using the computer,
|
|
1215
|
+
phone alerts stay quiet for the selected project.
|
|
1216
|
+
This requires an updated desktop app and an enabled desktop notification,
|
|
1217
|
+
sound, or attention effect. Phone alerts resume after five minutes without
|
|
1218
|
+
keyboard or mouse input, or when the background desktop app detects a locked
|
|
1219
|
+
screen. Quitting the app or sleeping the computer releases the desktop claim
|
|
1220
|
+
within about 45 seconds. Other projects remain eligible for phone alerts. Unread markers and
|
|
1221
|
+
badges continue to sync across devices.
|
|
1222
|
+
|
|
1213
1223
|
**Mute notifications** turns off one thread's notifications for finished,
|
|
1214
1224
|
failed, and interrupted turns and keeps those turns from marking it unread. A
|
|
1215
1225
|
request for input still notifies and marks the thread. A muted thread shows a
|
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.1079",
|
|
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-15T22:32:18Z"
|
|
81
81
|
}
|