@boxes-dev/dvb-runtime 1.0.1086 → 1.0.1090

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.
@@ -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) or agent-only SSH
13
- keys — `run` reports if the copy can't work, in which case fall back to
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` unless their key
27
- is hardware-backed.
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]="386d2bc5-76f8-5193-be15-c9ac6e87cee9")}catch(e){}}();
3
+ !function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="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.1086";
70358
- const rawGitSha = "8cfa244d008ae1cf1a05a80866c12355619ca010";
70359
- const rawSentryRelease = "boxes-dev-dvb@1.0.1086+8cfa244d008ae1cf1a05a80866c12355619ca010";
70357
+ const rawPackageVersion = "1.0.1090";
70358
+ const rawGitSha = "3f0bdf7d221d08b87ccce78bc602dcbbeb4a7bbc";
70359
+ const rawSentryRelease = "boxes-dev-dvb@1.0.1090+3f0bdf7d221d08b87ccce78bc602dcbbeb4a7bbc";
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.1086";
75743
+ const raw = "1.0.1090";
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 ({ privatePath, signingKey }) => {
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({ privatePath: keyPath, signingKey });
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/commands/agentInit/recover.ts
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 context34.service.destroyLocalState({ repo, selectedAgents });
265075
- await fs54.rm(statePaths.checkStatePath, { force: true });
265076
- if (manifestText !== null) {
265077
- await fs54.mkdir(statePaths.stateDir, { recursive: true, mode: 448 });
265078
- await fs54.mkdir(statePaths.stagingDir, { recursive: true, mode: 448 });
265079
- await fs54.writeFile(statePaths.manifestPath, manifestText, {
265080
- encoding: "utf8",
265081
- mode: 384
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 [defaults, devboxDestruction2, created2, peer2, teammate2, threadReads2] = await Promise.all([
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=386d2bc5-76f8-5193-be15-c9ac6e87cee9
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]="7f4b3604-1af9-5143-b37e-1ae102911c44")}catch(e){}}();
3
+ !function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="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.1086";
64679
- const rawGitSha = "8cfa244d008ae1cf1a05a80866c12355619ca010";
64680
- const rawSentryRelease = "boxes-dev-dvb@1.0.1086+8cfa244d008ae1cf1a05a80866c12355619ca010";
64678
+ const rawPackageVersion = "1.0.1090";
64679
+ const rawGitSha = "3f0bdf7d221d08b87ccce78bc602dcbbeb4a7bbc";
64680
+ const rawSentryRelease = "boxes-dev-dvb@1.0.1090+3f0bdf7d221d08b87ccce78bc602dcbbeb4a7bbc";
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.1086";
66897
+ const raw = "1.0.1090";
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=7f4b3604-1af9-5143-b37e-1ae102911c44
80050
+ //# debugId=47398613-b9bd-5f2b-9588-152eaf724fc6
@@ -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`. A box change applies
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
@@ -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. Elevated
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
@@ -735,7 +735,8 @@ The request values are `create-devboxes-and-threads`,
735
735
  `move-devboxes-to-folders`, `create-devbox-folders`,
736
736
  `edit-devbox-lifecycle`, `edit-template-maintenance`, `destroy-devbox`,
737
737
  `destroy-created-devboxes`, `read-project-threads`, `read-user-threads`, `read-shared-threads`,
738
- `read-team-threads`, `message-agents`, `message-teammates-agents`, `edit-template-box`,
738
+ `read-team-threads`, `control-created-threads`, `control-project-threads`,
739
+ `control-user-threads`, `message-agents`, `message-teammates-agents`, `edit-template-box`,
739
740
  `edit-team-template`, `edit-project-settings`, `edit-personal-environment`, and `edit-automations`.
740
741
  Add `--json` for a stable structured result.
741
742
 
@@ -775,7 +776,7 @@ pause, activate, run, and delete the owner's automations in that project; see
775
776
  [Automations](#automations). It is kept apart from the grants above, so a
776
777
  thread can hold it together with one of them.
777
778
 
778
- For thread reads, agent messaging, folder access, thread titles, destroying
779
+ For thread reads and controls, agent messaging, folder access, thread titles, destroying
779
780
  devboxes, and creating devboxes and threads, the owner can choose **Always allow for project**
780
781
  directly.
781
782
  This will enable the project's shared permission and make the requesting box
@@ -789,8 +790,10 @@ allow for project** is not offered; **Allow** still enables the permission on
789
790
  the requesting box. See `team-template.md` for how a Team Template sets these
790
791
  project permissions.
791
792
 
792
- The **Agent permissions** switches show each box's effective on/off settings;
793
- folder access shows its actual access level. Changing a control saves the
793
+ The **Agent permissions** switches show each box's effective on/off settings.
794
+ **Read threads** and **Pause and resume agents** show a scope icon and chevron;
795
+ open the menu for labels and **Off**. Folder access shows its access level.
796
+ Changing a control saves the
794
797
  choice for that box, independently of future project changes. Change shared
795
798
  access under **Agent permissions for this project** in Project settings.
796
799
  Turning off a project permission revokes it for every box that follows that
@@ -1122,7 +1125,7 @@ pushing alone does not change the commit checked out in the new devbox.
1122
1125
 
1123
1126
  To start another thread on an ordinary devbox, use its instance ID. This is the
1124
1127
  `devboxId` returned by `threads start`, or by a `--scope project` listing when
1125
- **Read other threads** is enabled:
1128
+ **Read threads** is enabled:
1126
1129
 
1127
1130
  ```bash
1128
1131
  dvb-onbox threads start \
@@ -1150,9 +1153,15 @@ it needs input when its agent asks a question or needs an approval, because
1150
1153
  only the user can answer those. `--muted` is a start argument, so a retry with
1151
1154
  the same idempotency key must repeat it.
1152
1155
 
1153
- The source box can continue and inspect only the delegated children it created
1154
- through this command. It cannot target another same-project thread. The default
1155
- follow-up delivery is `next`:
1156
+ **Pause and resume agents** governs `send` and `interrupt` independently of
1157
+ **Create devboxes and threads**. Its default, **Created from this devbox**,
1158
+ covers accepted delegated children created by any agent on this source box.
1159
+ **In this project** adds your other threads in this project, and **Across all
1160
+ my projects** adds your threads in other projects. **Off** disables controls.
1161
+ Neither wider scope includes teammates' threads, even when shared with you.
1162
+ Set the scope on the source box or in Project settings. Use a target's `id`
1163
+ from scoped listings for a nonchild; discovery requires separate **Read
1164
+ threads** access. The default follow-up delivery is `next`:
1156
1165
 
1157
1166
  ```bash
1158
1167
  dvb-onbox threads send \
@@ -1184,7 +1193,8 @@ dvb-onbox threads send \
1184
1193
  --json
1185
1194
  ```
1186
1195
 
1187
- `next` starts a turn when the child is idle and otherwise queues behind its
1196
+ The send and interrupt examples also accept an owned nonchild's thread ID
1197
+ when the control scope permits it. `next` starts a turn when the thread is idle and otherwise queues behind its
1188
1198
  active turn. `idle` is the strict idle-only form. `steer` adds instructions to
1189
1199
  the exact active Codex or Claude turn. Claude will read them at its next
1190
1200
  opportunity without interrupting a running tool. Claude steering requires an
@@ -1212,6 +1222,22 @@ automatically sending the input again. If a send or interrupt fails with
1212
1222
  `daemon_unavailable`, try again with a new idempotency key, because the old
1213
1223
  key will keep returning the same failure.
1214
1224
 
1225
+ To stop active agents on other devboxes, list the requested `project` or
1226
+ `user` read scope with `--all`, exclude entries whose `devboxId` is the current
1227
+ devbox, and select only entries with an active turn. Call `interrupt` for each
1228
+ exact thread and `activeTurnId`, with a different key for each request. Save
1229
+ the target IDs and outcomes, and verify them with scoped `threads status`.
1230
+ This preserves the devboxes and conversations. It does not freeze queued work
1231
+ or prevent a new turn from starting later. A changed or finished turn is
1232
+ reported without interrupting its replacement; don't send a cooperative stop
1233
+ message to a finished thread, since that would start it again.
1234
+
1235
+ When the user asks to continue, send a follow-up to each intended existing
1236
+ thread with `--delivery idle`. Each operation has its own result; the group
1237
+ is not atomic. `thread_control_disabled` and `thread_control_scope_denied`
1238
+ name the appropriate `control-created-threads`, `control-project-threads`, or
1239
+ `control-user-threads` permission request.
1240
+
1215
1241
  Mute or unmute the notifications of a child that this box created when the
1216
1242
  user asks:
1217
1243
 
@@ -1277,8 +1303,8 @@ an opaque resume cursor on every JSONL row. With no turn, cursor, or
1277
1303
  exact-turn stream ends after needs-input or a terminal event.
1278
1304
 
1279
1305
  If an accepted child is later deleted, `threads list` retains its ID as a
1280
- `failed` entry titled **Deleted delegated thread**. Reads and controls explain
1281
- that it was deleted. Retrying its original start with the same idempotency key
1306
+ `failed` entry titled **Deleted delegated thread**. Reads explain that it was
1307
+ deleted, and controls return `thread_not_found`. Retrying its original start with the same idempotency key
1282
1308
  reports `child_thread_deleted` and keeps the original child ID; it does not
1283
1309
  create another thread or recover the deleted transcript.
1284
1310
 
@@ -1301,8 +1327,9 @@ self-contained task, collect its final reply with `threads wait` or
1301
1327
  `threads send`. For direct collaboration during a turn, use `threads message`
1302
1328
  to exchange questions, findings, and feedback with the parent or other agents.
1303
1329
 
1304
- Collecting and forwarding final replies needs only **Create devboxes and
1305
- threads**. Direct messages need **Message other agents** on both the sending
1330
+ Collecting final replies needs **Create devboxes and threads**. Forwarding
1331
+ them with `send` needs **Pause and resume agents**, whose default covers
1332
+ created children. Direct messages need **Message other agents** on both the sending
1306
1333
  and receiving devboxes (see
1307
1334
  [Message Other Agents](#message-other-agents)). When a plan depends on those
1308
1335
  messages, request `message-agents` once before starting the children. The
@@ -1314,7 +1341,8 @@ children to put everything the parent needs in their final replies.
1314
1341
  Read, result, list, wait, and events operate on durable control-service state,
1315
1342
  so they can inspect archived, cold, and history-only children without waking
1316
1343
  their devboxes or claiming a live input surface. The source box's live **Create
1317
- devboxes and threads** permission is checked on every observation and control.
1344
+ devboxes and threads** permission is checked on every child observation;
1345
+ **Pause and resume agents** is checked on every send or interrupt.
1318
1346
  Prompt files are limited to 32 KiB.
1319
1347
 
1320
1348
  Delegation does not grant destruction permission or access to unrelated
@@ -1326,7 +1354,7 @@ surface.
1326
1354
 
1327
1355
  ## Read Other Threads
1328
1356
 
1329
- With **Read other threads** enabled in Agent permissions, agents can discover
1357
+ With **Read threads** enabled in Agent permissions, agents can discover
1330
1358
  and read threads beyond their delegated children. The setting applies to every
1331
1359
  agent on the source box. It is off by default, inherits the project's setting,
1332
1360
  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 copied keys stay passphrase-protected. boxes.dev does not
894
- store or unlock the passphrase during setup. Hardware, smartcard, FIDO, and
895
- agent-only signing keys are not copied; use create mode or skip signing setup
896
- for those repos. Setup verifies signed commits locally on the Template box, but
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 Connect users, guests, bots/apps, deleted users, external users, and
297
- unverifiable uploaders are never trusted for file import;
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
- If the work depends on an omitted file, attach it manually in the boxes.dev
306
- thread.
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
- Restore an archived Team Template before changing these settings or running
175
- maintenance.
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 other threads. Only team
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.1086",
3
+ "version": "1.0.1090",
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-17T20:24:07Z"
80
+ "devboxReleasedAt": "2026-10-18T00:54:00Z"
81
81
  }