@boxes-dev/dvb-runtime 1.0.1089 → 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/agent-init-guides/git-signing.md +6 -5
- package/dist/bin/dvb.mjs +194 -57
- package/dist/bin/dvbd.mjs +6 -6
- 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/cli.md +4 -1
- 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/mobile.md +4 -1
- package/dist/product-docs/references/onbox-agent-tools.md +82 -15
- package/dist/product-docs/references/project-setup.md +6 -4
- package/dist/product-docs/references/slack.md +16 -4
- package/dist/product-docs/references/team-template.md +11 -3
- package/package.json +2 -2
|
@@ -9,9 +9,9 @@ gitSigning:
|
|
|
9
9
|
|
|
10
10
|
- `copy`: bring the user's local signing key (OpenPGP or SSH signing key)
|
|
11
11
|
to the Template box so commits sign exactly as they do locally. Not possible
|
|
12
|
-
for hardware-backed keys (YubiKey, FIDO, smartcard)
|
|
13
|
-
keys
|
|
14
|
-
`create` or `skip
|
|
12
|
+
for hardware-backed keys (YubiKey, FIDO, smartcard), agent-only SSH keys, or
|
|
13
|
+
passphrase-protected SSH keys. `run` will explain when copying cannot work;
|
|
14
|
+
ask the user to choose `create` or `skip` before running again.
|
|
15
15
|
- `create`: prepare a boxes.dev signing key locally and upload it to the
|
|
16
16
|
Template box. An existing local signing key is not required. Set Git
|
|
17
17
|
`user.name` and `user.email` in the repo first. Setup will use `gpg.format`
|
|
@@ -23,8 +23,9 @@ gitSigning:
|
|
|
23
23
|
How to decide (ask, don't guess): check whether the user signs commits at
|
|
24
24
|
all — `git config commit.gpgsign` and `git config user.signingkey` in the
|
|
25
25
|
repo — then confirm their preference. Users who don't sign locally almost
|
|
26
|
-
always want `skip`. Users who do sign usually want `copy`
|
|
27
|
-
|
|
26
|
+
always want `skip`. Users who do sign usually want `copy` when their key is
|
|
27
|
+
supported. For a protected SSH key, ask about `create` or `skip`; don't remove
|
|
28
|
+
the passphrase from their existing key.
|
|
28
29
|
|
|
29
30
|
If the user wants signing on the Template box but does not sign locally,
|
|
30
31
|
choose `create`. When a project mixes signed and unsigned repos, setup will
|
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]="
|
|
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]="f8d401d9-73f0-577e-be52-09aa547a8690")}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";
|
|
@@ -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) => {
|
|
@@ -99217,7 +99217,7 @@ var init_catalog = __esm({
|
|
|
99217
99217
|
arg("permission", "Permission name from `dvb permissions get`"),
|
|
99218
99218
|
arg(
|
|
99219
99219
|
"value",
|
|
99220
|
-
"on or off; folder-access takes none, move, or create; read-threads takes none, project, user, shared, or team"
|
|
99220
|
+
"on or off; folder-access takes none, move, or create; read-threads takes none, project, user, shared, or team; pause-and-resume-agents takes none, created, project, or user"
|
|
99221
99221
|
)
|
|
99222
99222
|
],
|
|
99223
99223
|
options: [
|
|
@@ -143445,6 +143445,20 @@ var init_onboxThreadReadAccess = __esm({
|
|
|
143445
143445
|
}
|
|
143446
143446
|
});
|
|
143447
143447
|
|
|
143448
|
+
// ../../../../shared/onboxThreadControlAccess.ts
|
|
143449
|
+
var THREAD_CONTROL_LEVELS;
|
|
143450
|
+
var init_onboxThreadControlAccess = __esm({
|
|
143451
|
+
"../../../../shared/onboxThreadControlAccess.ts"() {
|
|
143452
|
+
"use strict";
|
|
143453
|
+
THREAD_CONTROL_LEVELS = [
|
|
143454
|
+
"none",
|
|
143455
|
+
"created",
|
|
143456
|
+
"project",
|
|
143457
|
+
"user"
|
|
143458
|
+
];
|
|
143459
|
+
}
|
|
143460
|
+
});
|
|
143461
|
+
|
|
143448
143462
|
// ../../../../shared/onboxAgentPermissionRequestProtocol.ts
|
|
143449
143463
|
var ONBOX_AGENT_PERMISSION_REQUEST_MAX_HTTP_BODY_BYTES, ONBOX_AGENT_PERMISSION_REQUEST_TTL_MS, ONBOX_AGENT_PERMISSIONS, ONBOX_AGENT_THREAD_GRANT_PERMISSIONS, ONBOX_AGENT_THREAD_GRANT_TTL_MS, isOnboxAgentThreadGrantPermission, isOnboxAgentPermission, REQUEST_ID_PATTERN, normalizeOnboxAgentPermissionRequestId;
|
|
143450
143464
|
var init_onboxAgentPermissionRequestProtocol = __esm({
|
|
@@ -143457,6 +143471,9 @@ var init_onboxAgentPermissionRequestProtocol = __esm({
|
|
|
143457
143471
|
"read-user-threads",
|
|
143458
143472
|
"read-shared-threads",
|
|
143459
143473
|
"read-team-threads",
|
|
143474
|
+
"control-created-threads",
|
|
143475
|
+
"control-project-threads",
|
|
143476
|
+
"control-user-threads",
|
|
143460
143477
|
"message-agents",
|
|
143461
143478
|
"message-teammates-agents",
|
|
143462
143479
|
"destroy-devbox",
|
|
@@ -143505,6 +143522,9 @@ var init_onboxAgentPermissionRequestPresentation = __esm({
|
|
|
143505
143522
|
"read-user-threads": "Allow agents to read threads in all your projects?",
|
|
143506
143523
|
"read-shared-threads": "Allow agents to read your threads and threads shared with you?",
|
|
143507
143524
|
"read-team-threads": "Allow agents to read your threads and teammates\u2019 threads you can access?",
|
|
143525
|
+
"control-created-threads": "Allow agents to pause and resume agents started from this box?",
|
|
143526
|
+
"control-project-threads": "Allow agents to pause and resume your agents in this project?",
|
|
143527
|
+
"control-user-threads": "Allow agents to pause and resume your agents in all your projects?",
|
|
143508
143528
|
"message-agents": "Allow agents to message other agents in this project?",
|
|
143509
143529
|
"message-teammates-agents": "Allow agents to message your teammates\u2019 agents?",
|
|
143510
143530
|
"destroy-devbox": "Allow agents to destroy and archive this devbox?",
|
|
@@ -143587,6 +143607,7 @@ var init_threadInventory = __esm({
|
|
|
143587
143607
|
init_projectLifecycleMaintenance();
|
|
143588
143608
|
init_maintenanceHistory();
|
|
143589
143609
|
init_onboxThreadReadAccess();
|
|
143610
|
+
init_onboxThreadControlAccess();
|
|
143590
143611
|
init_onboxAgentPermissionRequestProtocol();
|
|
143591
143612
|
init_onboxAgentPermissionRequestPresentation();
|
|
143592
143613
|
}
|
|
@@ -239522,6 +239543,60 @@ var init_scanOutputs = __esm({
|
|
|
239522
239543
|
}
|
|
239523
239544
|
});
|
|
239524
239545
|
|
|
239546
|
+
// ../../../../shared/initPrep/src/gitSigningSshCopy.mjs
|
|
239547
|
+
var getPrivateKeyProtection, getSshSigningCopyAvailability;
|
|
239548
|
+
var init_gitSigningSshCopy = __esm({
|
|
239549
|
+
"../../../../shared/initPrep/src/gitSigningSshCopy.mjs"() {
|
|
239550
|
+
"use strict";
|
|
239551
|
+
getPrivateKeyProtection = (privateText) => {
|
|
239552
|
+
const openSsh = /-----BEGIN OPENSSH PRIVATE KEY-----\s+([\s\S]+?)\s+-----END OPENSSH PRIVATE KEY-----/u.exec(
|
|
239553
|
+
privateText
|
|
239554
|
+
);
|
|
239555
|
+
if (openSsh) {
|
|
239556
|
+
const bytes = Buffer.from(openSsh[1].replace(/\s/gu, ""), "base64");
|
|
239557
|
+
const magic = Buffer.from("openssh-key-v1\0");
|
|
239558
|
+
if (bytes.length < magic.length + 4 || !bytes.subarray(0, magic.length).equals(magic)) {
|
|
239559
|
+
return null;
|
|
239560
|
+
}
|
|
239561
|
+
const cipherLength = bytes.readUInt32BE(magic.length);
|
|
239562
|
+
const cipherStart = magic.length + 4;
|
|
239563
|
+
if (cipherLength === 0 || cipherStart + cipherLength > bytes.length) {
|
|
239564
|
+
return null;
|
|
239565
|
+
}
|
|
239566
|
+
return bytes.subarray(cipherStart, cipherStart + cipherLength).toString("utf8") !== "none";
|
|
239567
|
+
}
|
|
239568
|
+
if (/^-----BEGIN ENCRYPTED PRIVATE KEY-----/mu.test(privateText)) {
|
|
239569
|
+
return true;
|
|
239570
|
+
}
|
|
239571
|
+
if (/^-----BEGIN (?:RSA |DSA |EC )?PRIVATE KEY-----/mu.test(privateText)) {
|
|
239572
|
+
return /^Proc-Type:\s*4,ENCRYPTED\s*$/mu.test(privateText);
|
|
239573
|
+
}
|
|
239574
|
+
return null;
|
|
239575
|
+
};
|
|
239576
|
+
getSshSigningCopyAvailability = ({ privateText, sourcePaths }) => {
|
|
239577
|
+
const passphraseProtected = getPrivateKeyProtection(privateText);
|
|
239578
|
+
if (passphraseProtected === null) {
|
|
239579
|
+
return {
|
|
239580
|
+
available: false,
|
|
239581
|
+
material: "ssh_key",
|
|
239582
|
+
sourcePaths,
|
|
239583
|
+
passphraseProtected,
|
|
239584
|
+
reason: "invalid_ssh_signing_key",
|
|
239585
|
+
detail: "The SSH signing private key format could not be read. Create a boxes.dev signing key or skip signing setup."
|
|
239586
|
+
};
|
|
239587
|
+
}
|
|
239588
|
+
return {
|
|
239589
|
+
available: !passphraseProtected,
|
|
239590
|
+
material: "ssh_key",
|
|
239591
|
+
sourcePaths,
|
|
239592
|
+
passphraseProtected,
|
|
239593
|
+
reason: passphraseProtected ? "passphrase_protected_ssh_key" : null,
|
|
239594
|
+
detail: passphraseProtected ? "This SSH signing key needs a passphrase, which coding agents cannot enter. Create a boxes.dev signing key or skip signing setup." : null
|
|
239595
|
+
};
|
|
239596
|
+
};
|
|
239597
|
+
}
|
|
239598
|
+
});
|
|
239599
|
+
|
|
239525
239600
|
// ../../../../shared/initPrep/src/gitSigningProfiles.mjs
|
|
239526
239601
|
import { createHash as createHash16 } from "node:crypto";
|
|
239527
239602
|
var normalizeGitSigningFormat, buildIdentityWarnings, buildProfileId, createManagedGitSigningRepoPlan;
|
|
@@ -239631,6 +239706,7 @@ var init_gitSigning2 = __esm({
|
|
|
239631
239706
|
"use strict";
|
|
239632
239707
|
init_devboxCore2();
|
|
239633
239708
|
init_gitPathStream();
|
|
239709
|
+
init_gitSigningSshCopy();
|
|
239634
239710
|
init_gitSigningProfiles();
|
|
239635
239711
|
uniqueStrings2 = (values) => [...new Set(values)];
|
|
239636
239712
|
trim9 = (value) => typeof value === "string" ? value.trim() : "";
|
|
@@ -240030,14 +240106,7 @@ var init_gitSigning2 = __esm({
|
|
|
240030
240106
|
passphraseProtected: null,
|
|
240031
240107
|
reason: "ssh_fido_key",
|
|
240032
240108
|
detail: "The SSH signing key is FIDO-backed and cannot be copied."
|
|
240033
|
-
} : privateText ? {
|
|
240034
|
-
available: true,
|
|
240035
|
-
material: "ssh_key",
|
|
240036
|
-
sourcePaths,
|
|
240037
|
-
passphraseProtected: null,
|
|
240038
|
-
reason: null,
|
|
240039
|
-
detail: null
|
|
240040
|
-
} : missingSshPrivateKeyCopyAvailability(
|
|
240109
|
+
} : privateText ? getSshSigningCopyAvailability({ privateText, sourcePaths }) : missingSshPrivateKeyCopyAvailability(
|
|
240041
240110
|
sourcePaths,
|
|
240042
240111
|
"ssh_agent_only",
|
|
240043
240112
|
"The SSH signing key private file is not present on disk."
|
|
@@ -240045,7 +240114,11 @@ var init_gitSigning2 = __esm({
|
|
|
240045
240114
|
incompleteReason: null
|
|
240046
240115
|
};
|
|
240047
240116
|
};
|
|
240048
|
-
inspectPrivateSshKeyFile = async ({
|
|
240117
|
+
inspectPrivateSshKeyFile = async ({
|
|
240118
|
+
privatePath,
|
|
240119
|
+
privateText,
|
|
240120
|
+
signingKey
|
|
240121
|
+
}) => {
|
|
240049
240122
|
const publicPath = `${privatePath}.pub`;
|
|
240050
240123
|
const publicText = await readFileIfExists3(publicPath);
|
|
240051
240124
|
if (!publicText) {
|
|
@@ -240102,14 +240175,7 @@ var init_gitSigning2 = __esm({
|
|
|
240102
240175
|
passphraseProtected: null,
|
|
240103
240176
|
reason: "ssh_fido_key",
|
|
240104
240177
|
detail: "The SSH signing key is FIDO-backed and cannot be copied."
|
|
240105
|
-
} : {
|
|
240106
|
-
available: true,
|
|
240107
|
-
material: "ssh_key",
|
|
240108
|
-
sourcePaths,
|
|
240109
|
-
passphraseProtected: null,
|
|
240110
|
-
reason: null,
|
|
240111
|
-
detail: null
|
|
240112
|
-
},
|
|
240178
|
+
} : getSshSigningCopyAvailability({ privateText, sourcePaths }),
|
|
240113
240179
|
incompleteReason: null
|
|
240114
240180
|
};
|
|
240115
240181
|
};
|
|
@@ -240138,7 +240204,11 @@ var init_gitSigning2 = __esm({
|
|
|
240138
240204
|
publicPath: keyPath,
|
|
240139
240205
|
publicText: text,
|
|
240140
240206
|
signingKey
|
|
240141
|
-
}) : await inspectPrivateSshKeyFile({
|
|
240207
|
+
}) : await inspectPrivateSshKeyFile({
|
|
240208
|
+
privatePath: keyPath,
|
|
240209
|
+
privateText: text,
|
|
240210
|
+
signingKey
|
|
240211
|
+
});
|
|
240142
240212
|
};
|
|
240143
240213
|
buildIncompleteRepoPlan = ({
|
|
240144
240214
|
commitGpgSign,
|
|
@@ -240772,9 +240842,7 @@ var init_gitSigning2 = __esm({
|
|
|
240772
240842
|
(profile) => !profile.copyAvailability.available
|
|
240773
240843
|
);
|
|
240774
240844
|
if (unavailable2) {
|
|
240775
|
-
throw new Error(
|
|
240776
|
-
`Git signing profile ${unavailable2.id} cannot be copied: ${unavailable2.copyAvailability.reason}`
|
|
240777
|
-
);
|
|
240845
|
+
throw new Error(unavailable2.copyAvailability.detail);
|
|
240778
240846
|
}
|
|
240779
240847
|
}
|
|
240780
240848
|
};
|
|
@@ -240943,9 +241011,7 @@ var init_gitSigning2 = __esm({
|
|
|
240943
241011
|
};
|
|
240944
241012
|
assertCopyAvailable = (profile) => {
|
|
240945
241013
|
if (profile.copyAvailability.available) return;
|
|
240946
|
-
throw new Error(
|
|
240947
|
-
`Git signing profile ${profile.id} cannot be copied: ${profile.copyAvailability.reason}`
|
|
240948
|
-
);
|
|
241014
|
+
throw new Error(profile.copyAvailability.detail);
|
|
240949
241015
|
};
|
|
240950
241016
|
prepareOpenPgpProfile = async ({
|
|
240951
241017
|
accountScope,
|
|
@@ -241042,6 +241108,17 @@ var init_gitSigning2 = __esm({
|
|
|
241042
241108
|
throw new Error(`SSH profile ${profile.id} is missing key paths.`);
|
|
241043
241109
|
}
|
|
241044
241110
|
const publicKeyPath = profile.publicKeyPaths[0];
|
|
241111
|
+
const privateText = await readFileIfExists3(profile.privateKeyPath);
|
|
241112
|
+
if (privateText === null) {
|
|
241113
|
+
throwSourceMissing(profile.privateKeyPath);
|
|
241114
|
+
}
|
|
241115
|
+
const copyAvailability = getSshSigningCopyAvailability({
|
|
241116
|
+
privateText,
|
|
241117
|
+
sourcePaths: [profile.privateKeyPath, publicKeyPath]
|
|
241118
|
+
});
|
|
241119
|
+
if (!copyAvailability.available) {
|
|
241120
|
+
throw new Error(copyAvailability.detail);
|
|
241121
|
+
}
|
|
241045
241122
|
const archivePrivatePath = normalizeArchivePath(
|
|
241046
241123
|
path52.join("ssh", profile.id, "signing_key")
|
|
241047
241124
|
);
|
|
@@ -264980,8 +265057,42 @@ var init_openDesktop = __esm({
|
|
|
264980
265057
|
}
|
|
264981
265058
|
});
|
|
264982
265059
|
|
|
264983
|
-
// src/devbox/
|
|
265060
|
+
// src/devbox/agentInit/destroyLocalState.ts
|
|
264984
265061
|
import fs54 from "node:fs/promises";
|
|
265062
|
+
var destroyAgentInitLocalState;
|
|
265063
|
+
var init_destroyLocalState2 = __esm({
|
|
265064
|
+
"src/devbox/agentInit/destroyLocalState.ts"() {
|
|
265065
|
+
"use strict";
|
|
265066
|
+
init_commandCore();
|
|
265067
|
+
init_parse6();
|
|
265068
|
+
destroyAgentInitLocalState = async ({
|
|
265069
|
+
project,
|
|
265070
|
+
repo,
|
|
265071
|
+
selectedAgents,
|
|
265072
|
+
service,
|
|
265073
|
+
statePaths
|
|
265074
|
+
}) => {
|
|
265075
|
+
const manifestText = await readManifestTextIfPresent(statePaths.manifestPath);
|
|
265076
|
+
await service.destroyLocalState({ repo, selectedAgents });
|
|
265077
|
+
await Promise.all([
|
|
265078
|
+
fs54.rm(statePaths.checkStatePath, { force: true }),
|
|
265079
|
+
fs54.rm(statePaths.preparedBundleStatePath, { force: true })
|
|
265080
|
+
]);
|
|
265081
|
+
if (manifestText === null) return false;
|
|
265082
|
+
const parsed = parseAgentInitManifest(manifestText);
|
|
265083
|
+
await service.initializeLocalPrep({
|
|
265084
|
+
repo,
|
|
265085
|
+
selectedAgents,
|
|
265086
|
+
resourceConfigKey: parsed.ok ? parsed.manifest.project.instanceType : null,
|
|
265087
|
+
selectedRepoRelPaths: project?.["selectedRepoRelPaths"] ?? null,
|
|
265088
|
+
selectedProjectRootEntryRelPaths: project?.["selectedProjectRootEntryRelPaths"] ?? null
|
|
265089
|
+
});
|
|
265090
|
+
return true;
|
|
265091
|
+
};
|
|
265092
|
+
}
|
|
265093
|
+
});
|
|
265094
|
+
|
|
265095
|
+
// src/devbox/commands/agentInit/recover.ts
|
|
264985
265096
|
var isRecord16, runAgentInitRetry, runAgentInitDestroy;
|
|
264986
265097
|
var init_recover = __esm({
|
|
264987
265098
|
"src/devbox/commands/agentInit/recover.ts"() {
|
|
@@ -264992,6 +265103,7 @@ var init_recover = __esm({
|
|
|
264992
265103
|
init_jobLoop();
|
|
264993
265104
|
init_progressReport();
|
|
264994
265105
|
init_desktopHandoff();
|
|
265106
|
+
init_destroyLocalState2();
|
|
264995
265107
|
isRecord16 = (value) => typeof value === "object" && value !== null;
|
|
264996
265108
|
runAgentInitRetry = async (args) => {
|
|
264997
265109
|
const { flags, positionals } = parseCommandArgs({
|
|
@@ -265059,27 +265171,16 @@ var init_recover = __esm({
|
|
|
265059
265171
|
);
|
|
265060
265172
|
}
|
|
265061
265173
|
const projectPath = resolveProjectPathFlag(flags);
|
|
265062
|
-
const { context: context34, repo, selectedAgents, statePaths } = await resolveAgentInitProject({ projectPath });
|
|
265063
|
-
let manifestText = null;
|
|
265064
|
-
try {
|
|
265065
|
-
manifestText = await fs54.readFile(statePaths.manifestPath, "utf8");
|
|
265066
|
-
} catch (error55) {
|
|
265067
|
-
if (typeof error55 === "object" && error55 !== null && "code" in error55 && error55.code === "ENOENT") {
|
|
265068
|
-
manifestText = null;
|
|
265069
|
-
} else {
|
|
265070
|
-
throw error55;
|
|
265071
|
-
}
|
|
265072
|
-
}
|
|
265174
|
+
const { context: context34, repo, selectedAgents, statePaths, validation } = await resolveAgentInitProject({ projectPath });
|
|
265073
265175
|
console.log("Destroying the agent-init Template box and local progress...");
|
|
265074
|
-
await
|
|
265075
|
-
|
|
265076
|
-
|
|
265077
|
-
|
|
265078
|
-
|
|
265079
|
-
|
|
265080
|
-
|
|
265081
|
-
|
|
265082
|
-
});
|
|
265176
|
+
const manifestKept = await destroyAgentInitLocalState({
|
|
265177
|
+
project: validation.project ?? null,
|
|
265178
|
+
repo,
|
|
265179
|
+
selectedAgents,
|
|
265180
|
+
service: context34.service,
|
|
265181
|
+
statePaths
|
|
265182
|
+
});
|
|
265183
|
+
if (manifestKept) {
|
|
265083
265184
|
console.log("Done. The manifest was kept:");
|
|
265084
265185
|
console.log(` ${statePaths.manifestPath}`);
|
|
265085
265186
|
} else {
|
|
@@ -265090,7 +265191,7 @@ var init_recover = __esm({
|
|
|
265090
265191
|
step: { command: "destroy", outcome: "ok", phase: "preparing" }
|
|
265091
265192
|
});
|
|
265092
265193
|
console.log(
|
|
265093
|
-
"Re-run `dvb agent-init check` and `dvb agent-init run` to start over."
|
|
265194
|
+
manifestKept ? "Re-run `dvb agent-init check` and `dvb agent-init run` to start over." : "Run `dvb agent-init start` to create a new manifest."
|
|
265094
265195
|
);
|
|
265095
265196
|
};
|
|
265096
265197
|
}
|
|
@@ -293226,7 +293327,8 @@ var init_agentPermissionSettings = __esm({
|
|
|
293226
293327
|
AGENT_PERMISSION_SETTINGS = [
|
|
293227
293328
|
...SWITCHES,
|
|
293228
293329
|
"folder-access",
|
|
293229
|
-
"read-threads"
|
|
293330
|
+
"read-threads",
|
|
293331
|
+
"pause-and-resume-agents"
|
|
293230
293332
|
];
|
|
293231
293333
|
TEMPLATE_BOX_ONLY = /* @__PURE__ */ new Set([
|
|
293232
293334
|
"create-team-templates",
|
|
@@ -293239,7 +293341,7 @@ var init_agentPermissionSettings = __esm({
|
|
|
293239
293341
|
return setting !== "destroy-devbox";
|
|
293240
293342
|
};
|
|
293241
293343
|
isAgentPermissionSetting = (value) => AGENT_PERMISSION_SETTINGS.includes(value);
|
|
293242
|
-
allowedAgentPermissionValues = (setting) => setting === "folder-access" ? FOLDER_ACCESS_LEVELS : setting === "read-threads" ? THREAD_READ_LEVELS : ["on", "off"];
|
|
293344
|
+
allowedAgentPermissionValues = (setting) => setting === "folder-access" ? FOLDER_ACCESS_LEVELS : setting === "read-threads" ? THREAD_READ_LEVELS : setting === "pause-and-resume-agents" ? THREAD_CONTROL_LEVELS : ["on", "off"];
|
|
293243
293345
|
parseAgentPermissionValue = (setting, raw) => {
|
|
293244
293346
|
if (!allowedAgentPermissionValues(setting).includes(raw)) return null;
|
|
293245
293347
|
if (setting === "folder-access") {
|
|
@@ -293248,6 +293350,9 @@ var init_agentPermissionSettings = __esm({
|
|
|
293248
293350
|
if (setting === "read-threads") {
|
|
293249
293351
|
return { permission: setting, value: raw };
|
|
293250
293352
|
}
|
|
293353
|
+
if (setting === "pause-and-resume-agents") {
|
|
293354
|
+
return { permission: setting, value: raw };
|
|
293355
|
+
}
|
|
293251
293356
|
return { permission: setting, value: raw };
|
|
293252
293357
|
};
|
|
293253
293358
|
query = (name) => makeFunctionReference(name);
|
|
@@ -293277,6 +293382,9 @@ var init_agentPermissionSettings = __esm({
|
|
|
293277
293382
|
),
|
|
293278
293383
|
threadReads: query(
|
|
293279
293384
|
"onboxAgentThreadReadAccess:getForViewer"
|
|
293385
|
+
),
|
|
293386
|
+
threadControl: query(
|
|
293387
|
+
"onboxAgentThreadControlAccess:getForViewer"
|
|
293280
293388
|
)
|
|
293281
293389
|
};
|
|
293282
293390
|
writes = {
|
|
@@ -293312,6 +293420,9 @@ var init_agentPermissionSettings = __esm({
|
|
|
293312
293420
|
projectConfiguration: mutation("onboxAgentProjectConfigurationPermissions:setForViewer"),
|
|
293313
293421
|
threadReads: mutation(
|
|
293314
293422
|
"onboxAgentThreadReadAccess:setForViewer"
|
|
293423
|
+
),
|
|
293424
|
+
threadControl: mutation(
|
|
293425
|
+
"onboxAgentThreadControlAccess:setForViewer"
|
|
293315
293426
|
)
|
|
293316
293427
|
};
|
|
293317
293428
|
listViewerInstances3 = query("instances:listForViewer");
|
|
@@ -293356,13 +293467,22 @@ var init_agentPermissionSettings = __esm({
|
|
|
293356
293467
|
if (target.kind === "project") {
|
|
293357
293468
|
const instanceId = target.primaryInstanceId;
|
|
293358
293469
|
const scoped2 = { instanceId, scope: "project" };
|
|
293359
|
-
const [
|
|
293470
|
+
const [
|
|
293471
|
+
defaults,
|
|
293472
|
+
devboxDestruction2,
|
|
293473
|
+
created2,
|
|
293474
|
+
peer2,
|
|
293475
|
+
teammate2,
|
|
293476
|
+
threadReads2,
|
|
293477
|
+
threadControl2
|
|
293478
|
+
] = await Promise.all([
|
|
293360
293479
|
client.query(reads.projectDefaults, { instanceId }),
|
|
293361
293480
|
client.query(reads.projectDevboxDestruction, { instanceId }),
|
|
293362
293481
|
client.query(reads.createdDevboxDestruction, scoped2),
|
|
293363
293482
|
client.query(reads.peerMessaging, scoped2),
|
|
293364
293483
|
client.query(reads.teammateMessaging, scoped2),
|
|
293365
|
-
client.query(reads.threadReads, scoped2)
|
|
293484
|
+
client.query(reads.threadReads, scoped2),
|
|
293485
|
+
client.query(reads.threadControl, scoped2)
|
|
293366
293486
|
]);
|
|
293367
293487
|
if (!defaults) return null;
|
|
293368
293488
|
return [
|
|
@@ -293373,6 +293493,10 @@ var init_agentPermissionSettings = __esm({
|
|
|
293373
293493
|
{ permission: "destroy-created-devboxes", value: onOff(created2) },
|
|
293374
293494
|
{ permission: "message-agents", value: onOff(peer2) },
|
|
293375
293495
|
{ permission: "message-teammates-agents", value: onOff(teammate2) },
|
|
293496
|
+
{
|
|
293497
|
+
permission: "pause-and-resume-agents",
|
|
293498
|
+
value: threadControl2?.access ?? null
|
|
293499
|
+
},
|
|
293376
293500
|
{ permission: "destroy-devbox", value: onOff(devboxDestruction2) },
|
|
293377
293501
|
{
|
|
293378
293502
|
permission: "update-thread-titles",
|
|
@@ -293393,6 +293517,7 @@ var init_agentPermissionSettings = __esm({
|
|
|
293393
293517
|
peer,
|
|
293394
293518
|
teammate,
|
|
293395
293519
|
threadReads,
|
|
293520
|
+
threadControl,
|
|
293396
293521
|
devboxDestruction,
|
|
293397
293522
|
teamTemplateCreation,
|
|
293398
293523
|
devboxLifecycle,
|
|
@@ -293404,6 +293529,7 @@ var init_agentPermissionSettings = __esm({
|
|
|
293404
293529
|
client.query(reads.peerMessaging, scoped),
|
|
293405
293530
|
client.query(reads.teammateMessaging, scoped),
|
|
293406
293531
|
client.query(reads.threadReads, scoped),
|
|
293532
|
+
client.query(reads.threadControl, scoped),
|
|
293407
293533
|
isTemplateBox ? none : client.query(reads.devboxDestruction, instanceIds),
|
|
293408
293534
|
isTemplateBox ? client.query(reads.teamTemplateCreation, instanceIds) : none,
|
|
293409
293535
|
isTemplateBox ? client.query(reads.projectConfiguration, {
|
|
@@ -293425,6 +293551,10 @@ var init_agentPermissionSettings = __esm({
|
|
|
293425
293551
|
{ permission: "destroy-created-devboxes", value: onOff(created) },
|
|
293426
293552
|
{ permission: "message-agents", value: onOff(peer) },
|
|
293427
293553
|
{ permission: "message-teammates-agents", value: onOff(teammate) },
|
|
293554
|
+
{
|
|
293555
|
+
permission: "pause-and-resume-agents",
|
|
293556
|
+
value: threadControl?.access ?? null
|
|
293557
|
+
},
|
|
293428
293558
|
{ permission: "destroy-devbox", value: onOff(devboxDestruction?.[0]) },
|
|
293429
293559
|
{
|
|
293430
293560
|
permission: "create-team-templates",
|
|
@@ -293458,6 +293588,13 @@ var init_agentPermissionSettings = __esm({
|
|
|
293458
293588
|
access: permission.value
|
|
293459
293589
|
});
|
|
293460
293590
|
return;
|
|
293591
|
+
case "pause-and-resume-agents":
|
|
293592
|
+
await client.mutation(writes.threadControl, {
|
|
293593
|
+
instanceId,
|
|
293594
|
+
scope,
|
|
293595
|
+
access: permission.value
|
|
293596
|
+
});
|
|
293597
|
+
return;
|
|
293461
293598
|
}
|
|
293462
293599
|
const enabled = permission.value === "on";
|
|
293463
293600
|
switch (permission.permission) {
|
|
@@ -300854,4 +300991,4 @@ react/cjs/react-jsx-runtime.development.js:
|
|
|
300854
300991
|
*)
|
|
300855
300992
|
*/
|
|
300856
300993
|
|
|
300857
|
-
//# debugId=
|
|
300994
|
+
//# debugId=f8d401d9-73f0-577e-be52-09aa547a8690
|
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]="
|
|
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]="47398613-b9bd-5f2b-9588-152eaf724fc6")}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";
|
|
@@ -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) => {
|
|
@@ -80047,4 +80047,4 @@ smol-toml/dist/index.js:
|
|
|
80047
80047
|
*)
|
|
80048
80048
|
*/
|
|
80049
80049
|
|
|
80050
|
-
//# debugId=
|
|
80050
|
+
//# debugId=47398613-b9bd-5f2b-9588-152eaf724fc6
|
|
@@ -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
|
|
@@ -201,11 +201,14 @@ dvb permissions get --box <box>
|
|
|
201
201
|
dvb permissions get --project <project>
|
|
202
202
|
dvb permissions set message-agents on --project <project>
|
|
203
203
|
dvb permissions set folder-access move --box <box>
|
|
204
|
+
dvb permissions set pause-and-resume-agents project --box <box>
|
|
204
205
|
```
|
|
205
206
|
|
|
206
207
|
`set` takes a permission name from `get` and a value: `on` or `off` for
|
|
207
208
|
switches, `none`, `move`, or `create` for `folder-access`, and `none`,
|
|
208
|
-
`project`, `user`, `shared`, or `team` for `read-threads`.
|
|
209
|
+
`project`, `user`, `shared`, or `team` for `read-threads`. For
|
|
210
|
+
`pause-and-resume-agents`, choose `none`, `created` (the default), `project`,
|
|
211
|
+
or `user`; wider scopes cover your own threads. A box change applies
|
|
209
212
|
only to that box, while a project change applies to existing and future
|
|
210
213
|
devboxes except those configured separately. Template-box-only permissions such as
|
|
211
214
|
`create-team-templates` are rejected for a devbox or a project. Lifecycle and
|
|
@@ -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
|
|
@@ -265,7 +265,10 @@ agents on that thread's devbox or Template box can do. Each row shows the
|
|
|
265
265
|
permission in effect on that box, including one the box follows from the
|
|
266
266
|
project's shared settings. Changing a row saves a choice for that box, as the
|
|
267
267
|
desktop thread header's **Agent permissions** control does, and applies to
|
|
268
|
-
every agent on the box. Every change takes effect immediately.
|
|
268
|
+
every agent on the box. Every change takes effect immediately. **Pause and
|
|
269
|
+
resume agents** offers **Off**, **Created from this devbox** (the default),
|
|
270
|
+
**In this project**, and **Across all my projects**. The wider choices cover
|
|
271
|
+
your own threads; **Read threads** controls reading separately. Elevated
|
|
269
272
|
permissions (creating devboxes and threads, messaging other agents, destroying
|
|
270
273
|
and archiving devboxes, and a Template box's Team Template creation,
|
|
271
274
|
lifecycle, and maintenance permissions) have amber switches and a one-line
|
|
@@ -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
|
|
@@ -735,7 +774,8 @@ The request values are `create-devboxes-and-threads`,
|
|
|
735
774
|
`move-devboxes-to-folders`, `create-devbox-folders`,
|
|
736
775
|
`edit-devbox-lifecycle`, `edit-template-maintenance`, `destroy-devbox`,
|
|
737
776
|
`destroy-created-devboxes`, `read-project-threads`, `read-user-threads`, `read-shared-threads`,
|
|
738
|
-
`read-team-threads`, `
|
|
777
|
+
`read-team-threads`, `control-created-threads`, `control-project-threads`,
|
|
778
|
+
`control-user-threads`, `message-agents`, `message-teammates-agents`, `edit-template-box`,
|
|
739
779
|
`edit-team-template`, `edit-project-settings`, `edit-personal-environment`, and `edit-automations`.
|
|
740
780
|
Add `--json` for a stable structured result.
|
|
741
781
|
|
|
@@ -775,7 +815,7 @@ pause, activate, run, and delete the owner's automations in that project; see
|
|
|
775
815
|
[Automations](#automations). It is kept apart from the grants above, so a
|
|
776
816
|
thread can hold it together with one of them.
|
|
777
817
|
|
|
778
|
-
For thread reads, agent messaging, folder access, thread titles, destroying
|
|
818
|
+
For thread reads and controls, agent messaging, folder access, thread titles, destroying
|
|
779
819
|
devboxes, and creating devboxes and threads, the owner can choose **Always allow for project**
|
|
780
820
|
directly.
|
|
781
821
|
This will enable the project's shared permission and make the requesting box
|
|
@@ -789,8 +829,10 @@ allow for project** is not offered; **Allow** still enables the permission on
|
|
|
789
829
|
the requesting box. See `team-template.md` for how a Team Template sets these
|
|
790
830
|
project permissions.
|
|
791
831
|
|
|
792
|
-
The **Agent permissions** switches show each box's effective on/off settings
|
|
793
|
-
|
|
832
|
+
The **Agent permissions** switches show each box's effective on/off settings.
|
|
833
|
+
**Read threads** and **Pause and resume agents** show a scope icon and chevron;
|
|
834
|
+
open the menu for labels and **Off**. Folder access shows its access level.
|
|
835
|
+
Changing a control saves the
|
|
794
836
|
choice for that box, independently of future project changes. Change shared
|
|
795
837
|
access under **Agent permissions for this project** in Project settings.
|
|
796
838
|
Turning off a project permission revokes it for every box that follows that
|
|
@@ -1122,7 +1164,7 @@ pushing alone does not change the commit checked out in the new devbox.
|
|
|
1122
1164
|
|
|
1123
1165
|
To start another thread on an ordinary devbox, use its instance ID. This is the
|
|
1124
1166
|
`devboxId` returned by `threads start`, or by a `--scope project` listing when
|
|
1125
|
-
**Read
|
|
1167
|
+
**Read threads** is enabled:
|
|
1126
1168
|
|
|
1127
1169
|
```bash
|
|
1128
1170
|
dvb-onbox threads start \
|
|
@@ -1150,9 +1192,15 @@ it needs input when its agent asks a question or needs an approval, because
|
|
|
1150
1192
|
only the user can answer those. `--muted` is a start argument, so a retry with
|
|
1151
1193
|
the same idempotency key must repeat it.
|
|
1152
1194
|
|
|
1153
|
-
|
|
1154
|
-
|
|
1155
|
-
|
|
1195
|
+
**Pause and resume agents** governs `send` and `interrupt` independently of
|
|
1196
|
+
**Create devboxes and threads**. Its default, **Created from this devbox**,
|
|
1197
|
+
covers accepted delegated children created by any agent on this source box.
|
|
1198
|
+
**In this project** adds your other threads in this project, and **Across all
|
|
1199
|
+
my projects** adds your threads in other projects. **Off** disables controls.
|
|
1200
|
+
Neither wider scope includes teammates' threads, even when shared with you.
|
|
1201
|
+
Set the scope on the source box or in Project settings. Use a target's `id`
|
|
1202
|
+
from scoped listings for a nonchild; discovery requires separate **Read
|
|
1203
|
+
threads** access. The default follow-up delivery is `next`:
|
|
1156
1204
|
|
|
1157
1205
|
```bash
|
|
1158
1206
|
dvb-onbox threads send \
|
|
@@ -1184,7 +1232,8 @@ dvb-onbox threads send \
|
|
|
1184
1232
|
--json
|
|
1185
1233
|
```
|
|
1186
1234
|
|
|
1187
|
-
|
|
1235
|
+
The send and interrupt examples also accept an owned nonchild's thread ID
|
|
1236
|
+
when the control scope permits it. `next` starts a turn when the thread is idle and otherwise queues behind its
|
|
1188
1237
|
active turn. `idle` is the strict idle-only form. `steer` adds instructions to
|
|
1189
1238
|
the exact active Codex or Claude turn. Claude will read them at its next
|
|
1190
1239
|
opportunity without interrupting a running tool. Claude steering requires an
|
|
@@ -1212,6 +1261,22 @@ automatically sending the input again. If a send or interrupt fails with
|
|
|
1212
1261
|
`daemon_unavailable`, try again with a new idempotency key, because the old
|
|
1213
1262
|
key will keep returning the same failure.
|
|
1214
1263
|
|
|
1264
|
+
To stop active agents on other devboxes, list the requested `project` or
|
|
1265
|
+
`user` read scope with `--all`, exclude entries whose `devboxId` is the current
|
|
1266
|
+
devbox, and select only entries with an active turn. Call `interrupt` for each
|
|
1267
|
+
exact thread and `activeTurnId`, with a different key for each request. Save
|
|
1268
|
+
the target IDs and outcomes, and verify them with scoped `threads status`.
|
|
1269
|
+
This preserves the devboxes and conversations. It does not freeze queued work
|
|
1270
|
+
or prevent a new turn from starting later. A changed or finished turn is
|
|
1271
|
+
reported without interrupting its replacement; don't send a cooperative stop
|
|
1272
|
+
message to a finished thread, since that would start it again.
|
|
1273
|
+
|
|
1274
|
+
When the user asks to continue, send a follow-up to each intended existing
|
|
1275
|
+
thread with `--delivery idle`. Each operation has its own result; the group
|
|
1276
|
+
is not atomic. `thread_control_disabled` and `thread_control_scope_denied`
|
|
1277
|
+
name the appropriate `control-created-threads`, `control-project-threads`, or
|
|
1278
|
+
`control-user-threads` permission request.
|
|
1279
|
+
|
|
1215
1280
|
Mute or unmute the notifications of a child that this box created when the
|
|
1216
1281
|
user asks:
|
|
1217
1282
|
|
|
@@ -1277,8 +1342,8 @@ an opaque resume cursor on every JSONL row. With no turn, cursor, or
|
|
|
1277
1342
|
exact-turn stream ends after needs-input or a terminal event.
|
|
1278
1343
|
|
|
1279
1344
|
If an accepted child is later deleted, `threads list` retains its ID as a
|
|
1280
|
-
`failed` entry titled **Deleted delegated thread**. Reads
|
|
1281
|
-
|
|
1345
|
+
`failed` entry titled **Deleted delegated thread**. Reads explain that it was
|
|
1346
|
+
deleted, and controls return `thread_not_found`. Retrying its original start with the same idempotency key
|
|
1282
1347
|
reports `child_thread_deleted` and keeps the original child ID; it does not
|
|
1283
1348
|
create another thread or recover the deleted transcript.
|
|
1284
1349
|
|
|
@@ -1301,8 +1366,9 @@ self-contained task, collect its final reply with `threads wait` or
|
|
|
1301
1366
|
`threads send`. For direct collaboration during a turn, use `threads message`
|
|
1302
1367
|
to exchange questions, findings, and feedback with the parent or other agents.
|
|
1303
1368
|
|
|
1304
|
-
Collecting
|
|
1305
|
-
|
|
1369
|
+
Collecting final replies needs **Create devboxes and threads**. Forwarding
|
|
1370
|
+
them with `send` needs **Pause and resume agents**, whose default covers
|
|
1371
|
+
created children. Direct messages need **Message other agents** on both the sending
|
|
1306
1372
|
and receiving devboxes (see
|
|
1307
1373
|
[Message Other Agents](#message-other-agents)). When a plan depends on those
|
|
1308
1374
|
messages, request `message-agents` once before starting the children. The
|
|
@@ -1314,7 +1380,8 @@ children to put everything the parent needs in their final replies.
|
|
|
1314
1380
|
Read, result, list, wait, and events operate on durable control-service state,
|
|
1315
1381
|
so they can inspect archived, cold, and history-only children without waking
|
|
1316
1382
|
their devboxes or claiming a live input surface. The source box's live **Create
|
|
1317
|
-
devboxes and threads** permission is checked on every observation
|
|
1383
|
+
devboxes and threads** permission is checked on every child observation;
|
|
1384
|
+
**Pause and resume agents** is checked on every send or interrupt.
|
|
1318
1385
|
Prompt files are limited to 32 KiB.
|
|
1319
1386
|
|
|
1320
1387
|
Delegation does not grant destruction permission or access to unrelated
|
|
@@ -1326,7 +1393,7 @@ surface.
|
|
|
1326
1393
|
|
|
1327
1394
|
## Read Other Threads
|
|
1328
1395
|
|
|
1329
|
-
With **Read
|
|
1396
|
+
With **Read threads** enabled in Agent permissions, agents can discover
|
|
1330
1397
|
and read threads beyond their delegated children. The setting applies to every
|
|
1331
1398
|
agent on the source box. It is off by default, inherits the project's setting,
|
|
1332
1399
|
and can be overridden on a box. Higher levels include the preceding levels:
|
|
@@ -890,10 +890,12 @@ both purposes. Signing also works when repository access uses HTTPS or is
|
|
|
890
890
|
skipped. Copy mode can move private signing key material
|
|
891
891
|
onto the Template box, so it requires an explicit confirmation.
|
|
892
892
|
|
|
893
|
-
Passphrase-protected
|
|
894
|
-
|
|
895
|
-
|
|
896
|
-
|
|
893
|
+
Passphrase-protected SSH signing keys cannot be copied because coding agents
|
|
894
|
+
cannot enter their passphrase. Choose create mode or skip signing setup for
|
|
895
|
+
those repos. Copied OpenPGP keys stay passphrase-protected; boxes.dev does not
|
|
896
|
+
store or unlock their passphrase during setup. Hardware, smartcard, FIDO, and
|
|
897
|
+
agent-only signing keys are also not copied. Setup verifies signed commits
|
|
898
|
+
locally on the Template box when the key can sign without a prompt, but
|
|
897
899
|
Git host "Verified" badges still require the public signing key to be registered
|
|
898
900
|
with the Git host.
|
|
899
901
|
|
|
@@ -293,8 +293,9 @@ Limits and rules:
|
|
|
293
293
|
- when **Allow files from other Slack workspace members** is on, files from
|
|
294
294
|
verified ordinary internal members of the connected Slack workspace are
|
|
295
295
|
allowed even if the uploader cannot run the automation;
|
|
296
|
-
- Slack
|
|
297
|
-
|
|
296
|
+
- files from external Slack users, including Slack Connect users and guests,
|
|
297
|
+
require the requester's approval for each file;
|
|
298
|
+
- files from bots/apps, deleted users, and unverifiable uploaders are omitted;
|
|
298
299
|
- deleted, restricted, unsupported, oversized, or technically failed files are
|
|
299
300
|
omitted.
|
|
300
301
|
|
|
@@ -302,8 +303,19 @@ An omitted file does not stop an otherwise valid request or linked follow-up.
|
|
|
302
303
|
boxes.dev continues with every file that imported successfully and tells the
|
|
303
304
|
agent which intended input was not delivered. It also explains the omission
|
|
304
305
|
in Slack when attachment warnings are enabled.
|
|
305
|
-
|
|
306
|
-
|
|
306
|
+
For an external user's file, boxes.dev will show **Upload file** and **Skip**
|
|
307
|
+
in a private Slack message visible only to the person who triggered the
|
|
308
|
+
request. Only upload files you trust: they may contain malware or malicious
|
|
309
|
+
instructions. The agent will start with the available text and files;
|
|
310
|
+
**Upload file** will send that file to the same agent thread as a follow-up,
|
|
311
|
+
and **Skip** will leave it out. Approval applies only to that file and request.
|
|
312
|
+
These private prompts also appear when public attachment warnings are off.
|
|
313
|
+
|
|
314
|
+
Slack's private prompts are temporary and may disappear after a reload or
|
|
315
|
+
not arrive while you are inactive. Approval cannot grant access to files
|
|
316
|
+
Slack has restricted. If you miss a prompt or an upload fails, attach the
|
|
317
|
+
file manually in the boxes.dev thread. Imported files and agent replies
|
|
318
|
+
follow the thread's existing visibility rules.
|
|
307
319
|
|
|
308
320
|
Slack file import transfers only the eligible Slack attachments included with
|
|
309
321
|
the request or its thread context. Starting a thread in a teammate's workspace
|
|
@@ -171,8 +171,14 @@ settings in the order they are usually needed:
|
|
|
171
171
|
is created.
|
|
172
172
|
- **Template settings**: name, description, and archive.
|
|
173
173
|
|
|
174
|
-
|
|
175
|
-
|
|
174
|
+
Archived templates do not reserve their names. Creating or renaming a template
|
|
175
|
+
can reuse an archived template's name. Names are unique within a team among
|
|
176
|
+
templates that aren't archived, ignoring capitalization and extra spaces. If
|
|
177
|
+
another template has reused the name, rename either template in **Template
|
|
178
|
+
settings**, save it, then restore the archived template.
|
|
179
|
+
|
|
180
|
+
An archived template's name and description remain editable. Restore it before
|
|
181
|
+
changing other settings or running maintenance.
|
|
176
182
|
|
|
177
183
|
The **Member projects** card explains which kind of project the template
|
|
178
184
|
creates. A template creates independent projects until an admin chooses **Set
|
|
@@ -305,7 +311,9 @@ lists combine, and which keys are reserved.
|
|
|
305
311
|
The **Agent permissions** card on the Team Template page sets the project
|
|
306
312
|
agent permissions for projects that use the template: creating devboxes and
|
|
307
313
|
threads, destroying devboxes, messaging other agents and teammates' agents,
|
|
308
|
-
updating thread titles, folder access, and reading
|
|
314
|
+
pausing and resuming agents, updating thread titles, folder access, and reading
|
|
315
|
+
other threads. **Pause and resume agents** defaults to **Created from this
|
|
316
|
+
devbox**; its wider scopes cover the project owner's own threads. Only team
|
|
309
317
|
admins can edit it. Until an admin saves it, each project keeps its own
|
|
310
318
|
permissions.
|
|
311
319
|
|
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
|
}
|