@boxes-dev/dvb-runtime 1.0.1059 → 1.0.1060

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.
@@ -15,6 +15,9 @@ How to investigate (read-only, evidence-driven):
15
15
 
16
16
  - Start from project evidence: `package.json` engines/scripts, README setup
17
17
  docs, Justfile/Makefile targets, docker-compose files, CI config.
18
+ - Inspect package manifests and lockfiles for private GitHub Git dependencies.
19
+ With managed GitHub access, list their `owner/repository` names under
20
+ `githubDependencies` and follow the git-ssh guide before remote setup.
18
21
  - Only when project evidence justifies it, check the specific outside-repo
19
22
  config file it points at (e.g. scripts call `gh` → check
20
23
  `~/.config/gh/hosts.yml` exists). Keep these checks narrow and targeted.
@@ -26,6 +26,33 @@ under `.github/workflows` after every affected installation accepts the shown
26
26
  update. Keep the GitHub `gitSsh` rows at `mode: skip` and
27
27
  `convertOriginToSsh: false` when managed access is selected.
28
28
 
29
+ Before checking managed access, inspect the project's package manifests and
30
+ lockfiles for private GitHub dependencies, including Cargo Git dependencies
31
+ and transitive Git sources in lockfiles. Review the required repositories with
32
+ the user and list them separately from checkout paths:
33
+
34
+ ```yaml
35
+ githubDependencies:
36
+ - Nullframe/engine-spec
37
+ ```
38
+
39
+ Run `dvb agent-init github connect` to grant any missing GitHub App access, then
40
+ `dvb agent-init check`. Both commands verify read access to every declared
41
+ dependency before setup. If remote setup is already blocked, grant any missing
42
+ GitHub access, continue that setup thread, and retry the package fetch. Keep the
43
+ dependency URLs and checkout layout unchanged. Dependencies can be read-only or
44
+ archived; project checkouts still need write access during setup. In an ordinary
45
+ project, Git can access any repository that the connected credential can read;
46
+ GitHub enforces write permission when pushing. The dependency list does not
47
+ grant or restrict access.
48
+
49
+ Omit `githubDependencies` or use an empty list to skip dependency preflight.
50
+ Manage repository access through GitHub. This flow applies to
51
+ ordinary projects with managed GitHub HTTPS access, not Team Template member
52
+ projects. If Cargo's built-in Git client cannot use the configured authentication,
53
+ set `CARGO_NET_GIT_FETCH_WITH_CLI=true` during remote setup to make Cargo use Git
54
+ for fetching. See [Cargo's Git authentication guide](https://doc.rust-lang.org/cargo/appendix/git-authentication.html).
55
+
29
56
  Set `githubAccess: ssh` to use the key flow below for GitHub. Set `skip` to
30
57
  leave GitHub push/pull unconfigured. Use null only when the project has no
31
58
  standard GitHub origin. GitLab and other hosts always use `gitSsh`.
@@ -61,6 +61,7 @@ Sections (each has its own guide topic):
61
61
  | `localChanges.copyDirty` | Copy uncommitted changes? | untracked |
62
62
  | `untracked` | Which untracked files ride along | untracked |
63
63
  | `githubAccess` | Managed GitHub, SSH, skip, or null with no GitHub origins | git-ssh |
64
+ | `githubDependencies` | Optional private GitHub dependency repository names to check before setup | git-ssh |
64
65
  | `gitSsh` | Git push/pull auth from the Template box | git-ssh |
65
66
  | `gitSigning` | Commit signing on the Template box | git-signing |
66
67
  | `agentConfig` / `agentThreads` | Claude/Codex config + history import | agent-config |
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]="3b790c03-f84d-5b8e-85a2-1549b0f7a919")}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]="7aa83311-1186-5591-8c75-997f59be496e")}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";
@@ -69709,9 +69709,9 @@ var init_sentry = __esm({
69709
69709
  uncaughtExceptionMonitorInstalled = false;
69710
69710
  currentDevboxSentryUser = null;
69711
69711
  readBuildMetadata = () => {
69712
- const rawPackageVersion = "1.0.1059";
69713
- const rawGitSha = "f538c975742985e515cdf721d4c94e5cb211e2ab";
69714
- const rawSentryRelease = "boxes-dev-dvb@1.0.1059+f538c975742985e515cdf721d4c94e5cb211e2ab";
69712
+ const rawPackageVersion = "1.0.1060";
69713
+ const rawGitSha = "933e3efd090a3e3976548122ca0dafc03f4f3d6e";
69714
+ const rawSentryRelease = "boxes-dev-dvb@1.0.1060+933e3efd090a3e3976548122ca0dafc03f4f3d6e";
69715
69715
  const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
69716
69716
  const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
69717
69717
  const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
@@ -75095,7 +75095,7 @@ var init_packageVersion = __esm({
75095
75095
  return path18.join(process.cwd(), "dvb");
75096
75096
  };
75097
75097
  readEmbeddedPackageVersion = () => {
75098
- const raw = "1.0.1059";
75098
+ const raw = "1.0.1060";
75099
75099
  return trimVersion(raw);
75100
75100
  };
75101
75101
  readNearestPackageMetadata = (basePath) => {
@@ -99050,7 +99050,7 @@ var init_catalog = __esm({
99050
99050
  name: "start",
99051
99051
  summary: "Start a Codex or Claude thread",
99052
99052
  usage: [
99053
- "dvb threads start --project <project> --target template|devbox:<devbox>|new-devbox --agent codex|claude (--prompt <text> | --prompt-file <path> | --stdin) --idempotency-key <key> [--json]"
99053
+ "dvb threads start --project <project> --target template|devbox:<devbox>|new-devbox --agent codex|claude (--prompt <text> | --prompt-file <path> | --stdin) --idempotency-key <key> [--muted] [--json]"
99054
99054
  ],
99055
99055
  options: [
99056
99056
  flag("project", "Project name or fingerprint", {
@@ -99070,7 +99070,11 @@ var init_catalog = __esm({
99070
99070
  flag("idempotency-key", "Caller-owned retry key", {
99071
99071
  valueName: "key"
99072
99072
  }),
99073
+ flag("muted", "Start the thread with notifications muted"),
99073
99074
  flag("json", "Output the versioned JSON envelope")
99075
+ ],
99076
+ notes: [
99077
+ "Finished turns on a muted thread don't notify you or mark the thread unread. Requests for input still notify."
99074
99078
  ]
99075
99079
  },
99076
99080
  {
@@ -99184,6 +99188,32 @@ var init_catalog = __esm({
99184
99188
  notes: [
99185
99189
  "Fails if the requested turn is no longer active or another turn replaced it."
99186
99190
  ]
99191
+ },
99192
+ {
99193
+ name: "mute",
99194
+ summary: "Mute notifications for an agent thread",
99195
+ usage: ["dvb threads mute --thread <client-thread-id> [--json]"],
99196
+ options: [
99197
+ flag("thread", "Stable client thread id", {
99198
+ valueName: "client-thread-id"
99199
+ }),
99200
+ flag("json", "Output the versioned JSON envelope")
99201
+ ],
99202
+ notes: [
99203
+ "Finished turns on a muted thread don't notify you or mark the thread unread. Requests for input still notify.",
99204
+ "Muting marks an unread thread read, but a pending request for input stays visible until it is answered."
99205
+ ]
99206
+ },
99207
+ {
99208
+ name: "unmute",
99209
+ summary: "Unmute notifications for an agent thread",
99210
+ usage: ["dvb threads unmute --thread <client-thread-id> [--json]"],
99211
+ options: [
99212
+ flag("thread", "Stable client thread id", {
99213
+ valueName: "client-thread-id"
99214
+ }),
99215
+ flag("json", "Output the versioned JSON envelope")
99216
+ ]
99187
99217
  }
99188
99218
  ]
99189
99219
  },
@@ -140777,6 +140807,7 @@ var init_threadInventoryBuilder = __esm({
140777
140807
  cwd: null,
140778
140808
  path: normalizeText2(thread.sessionPath),
140779
140809
  isArchived: thread.archivedAt !== null,
140810
+ notificationsMuted: thread.notificationsMuted,
140780
140811
  storageState: resolveThreadStorageState(thread.storageState),
140781
140812
  nativeBundleStatus: resolveThreadNativeBundleStatus(
140782
140813
  thread.nativeBundleStatus
@@ -142990,7 +143021,7 @@ var init_projects2 = __esm({
142990
143021
  });
142991
143022
 
142992
143023
  // src/devbox/resourceApi/queryRefs.ts
142993
- var listCliAgentToolProjectExecutionsV1, createCliAgentToolDevboxV1, getCliAgentToolDevboxOperationV1, startCliAgentToolThreadV1, sendCliAgentToolThreadV1, interruptCliAgentToolThreadV1, getCliAgentToolThreadContextV1, listCliAgentToolThreadEventsV1, observeCliAgentToolThreadV1, loadCliAgentToolThreadPeekV1, readCanonicalTeamThreadV1;
143024
+ var listCliAgentToolProjectExecutionsV1, createCliAgentToolDevboxV1, getCliAgentToolDevboxOperationV1, startCliAgentToolThreadV1, setCliAgentToolThreadNotificationsMutedV1, sendCliAgentToolThreadV1, interruptCliAgentToolThreadV1, getCliAgentToolThreadContextV1, listCliAgentToolThreadEventsV1, observeCliAgentToolThreadV1, loadCliAgentToolThreadPeekV1, readCanonicalTeamThreadV1;
142994
143025
  var init_queryRefs2 = __esm({
142995
143026
  "src/devbox/resourceApi/queryRefs.ts"() {
142996
143027
  "use strict";
@@ -142999,6 +143030,7 @@ var init_queryRefs2 = __esm({
142999
143030
  createCliAgentToolDevboxV1 = makeFunctionReference("cliAgentTools:createDevboxV1");
143000
143031
  getCliAgentToolDevboxOperationV1 = makeFunctionReference("cliAgentTools:getDevboxOperationV1");
143001
143032
  startCliAgentToolThreadV1 = makeFunctionReference("cliAgentTools:startThreadV1");
143033
+ setCliAgentToolThreadNotificationsMutedV1 = makeFunctionReference("cliAgentTools:setThreadNotificationsMutedV1");
143002
143034
  sendCliAgentToolThreadV1 = makeFunctionReference("cliAgentThreadMutationsNode:sendThreadV1");
143003
143035
  interruptCliAgentToolThreadV1 = makeFunctionReference("cliAgentThreadMutationsNode:interruptThreadV1");
143004
143036
  getCliAgentToolThreadContextV1 = makeFunctionReference("cliAgentThreadObservation:getThreadContextV1");
@@ -230750,6 +230782,7 @@ var init_threads = __esm({
230750
230782
  }),
230751
230783
  pinned: row.isPinned,
230752
230784
  archived: row.isArchived,
230785
+ notificationsMuted: row.notificationsMuted,
230753
230786
  activeTurnId: row.activeTurnId,
230754
230787
  updatedAt: row.updatedAtMs,
230755
230788
  automation: row.automation === null ? null : { trigger: row.automation.primaryTriggerKind }
@@ -259834,6 +259867,7 @@ var init_parse6 = __esm({
259834
259867
  "localChanges",
259835
259868
  "untracked",
259836
259869
  "githubAccess",
259870
+ "githubDependencies",
259837
259871
  "gitSsh",
259838
259872
  "gitSigning",
259839
259873
  "agentConfig",
@@ -260088,6 +260122,25 @@ var init_parse6 = __esm({
260088
260122
  GITHUB_ACCESS_MODES
260089
260123
  ) ?? null : null;
260090
260124
  const gitSsh = parseGitSsh(sink, root.gitSsh ?? {});
260125
+ const githubDependencies = "githubDependencies" in root ? readStringList(sink, "githubDependencies", root.githubDependencies) : void 0;
260126
+ if (githubDependencies !== void 0) {
260127
+ if (manifestVersion === 1 || githubAccess !== "managed") {
260128
+ sink.error(
260129
+ "githubDependencies",
260130
+ "GitHub dependencies require managed GitHub access in manifest version 2 or 3.",
260131
+ "Set `githubAccess: managed`, or remove `githubDependencies`."
260132
+ );
260133
+ }
260134
+ if (githubDependencies.length > 100 || githubDependencies.some(
260135
+ (name) => !/^[a-zA-Z0-9][a-zA-Z0-9-]*\/[a-zA-Z0-9_.-]+$/.test(name) || [".", ".."].includes(name.split("/")[1] ?? "")
260136
+ )) {
260137
+ sink.error(
260138
+ "githubDependencies",
260139
+ "GitHub dependencies must contain at most 100 owner/repository names.",
260140
+ "Use a list such as `githubDependencies: [Nullframe/engine-spec]`."
260141
+ );
260142
+ }
260143
+ }
260091
260144
  const gitSigningRecord = readRecord4(
260092
260145
  sink,
260093
260146
  "gitSigning",
@@ -260241,12 +260294,14 @@ var init_parse6 = __esm({
260241
260294
  ...manifestBase,
260242
260295
  version: AGENT_INIT_MANIFEST_VERSION,
260243
260296
  githubAccess,
260297
+ ...githubDependencies === void 0 ? {} : { githubDependencies },
260244
260298
  devboxLifecycle,
260245
260299
  templateMaintenance
260246
260300
  } : manifestVersion === AGENT_INIT_GITHUB_MANIFEST_VERSION ? {
260247
260301
  ...manifestBase,
260248
260302
  version: AGENT_INIT_GITHUB_MANIFEST_VERSION,
260249
260303
  githubAccess,
260304
+ ...githubDependencies === void 0 ? {} : { githubDependencies },
260250
260305
  forkStartupScript
260251
260306
  } : {
260252
260307
  ...manifestBase,
@@ -260903,7 +260958,7 @@ var init_instanceType = __esm({
260903
260958
  });
260904
260959
 
260905
260960
  // src/devbox/agentInit/githubAccess.ts
260906
- var resolveAgentInitGithubAccessPage, isRecord9, githubIssue, githubInventoryFailureIssue, readAgentInitProjectLayoutRepos, manifestGithubAccess, buildAgentInitGithubManifestIssues, normalizeInventoryRepository, normalizeInventoryInstallation, matchAgentInitGithubRepositories, agentInitGithubBlockedIssue, resolveAgentInitGithubAccessDefault, resolveAgentInitManagedGithubAccess, configureAgentInitGithubAccess;
260961
+ var resolveAgentInitGithubAccessPage, isRecord9, githubIssue, githubInventoryFailureIssue, readAgentInitProjectLayoutRepos, manifestGithubAccess, buildAgentInitGithubManifestIssues, normalizeInventoryRepository, normalizeInventoryInstallation, matchAgentInitGithubRepositories, agentInitGithubBlockedIssue, resolveAgentInitGithubAccessDefault, resolveAgentInitManagedGithubAccess, configureAgentInitGithubAccess, resolveAgentInitGithubDependencies;
260907
260962
  var init_githubAccess = __esm({
260908
260963
  "src/devbox/agentInit/githubAccess.ts"() {
260909
260964
  "use strict";
@@ -261108,7 +261163,8 @@ var init_githubAccess = __esm({
261108
261163
  inventoryRepositories,
261109
261164
  projectLayoutRepos,
261110
261165
  requiredPermission,
261111
- requireDefaultBranch
261166
+ requireDefaultBranch,
261167
+ allowArchived
261112
261168
  }) => {
261113
261169
  const matches2 = /* @__PURE__ */ new Map();
261114
261170
  const missing = [];
@@ -261123,7 +261179,7 @@ var init_githubAccess = __esm({
261123
261179
  const candidate = candidates.length === 1 ? candidates[0] : null;
261124
261180
  if (!candidate) {
261125
261181
  missing.push(fullName);
261126
- } else if (candidate.disabledReason !== null || !candidate.permissions[requiredPermission] || requireDefaultBranch && candidate.defaultBranch === null) {
261182
+ } else if (candidate.disabledReason === "repository_disabled" || candidate.disabledReason === "archived" && !allowArchived || candidate.disabledReason === "read_only" && requiredPermission === "push" || !candidate.permissions[requiredPermission] || requireDefaultBranch && candidate.defaultBranch === null) {
261127
261183
  blocked.push(candidate);
261128
261184
  } else {
261129
261185
  matches2.set(candidate.id, candidate);
@@ -261162,7 +261218,8 @@ var init_githubAccess = __esm({
261162
261218
  projectLayoutRepos,
261163
261219
  requiredPermission = "push",
261164
261220
  requireWorkflowsPermission = true,
261165
- requireDefaultBranch = false
261221
+ requireDefaultBranch = false,
261222
+ allowArchived = false
261166
261223
  }) => {
261167
261224
  if (!isRecord9(connectionResult)) {
261168
261225
  return {
@@ -261243,7 +261300,8 @@ var init_githubAccess = __esm({
261243
261300
  inventoryRepositories,
261244
261301
  projectLayoutRepos,
261245
261302
  requiredPermission,
261246
- requireDefaultBranch
261303
+ requireDefaultBranch,
261304
+ allowArchived
261247
261305
  });
261248
261306
  if (missing.length === 0 && blocked.length > 0) {
261249
261307
  return {
@@ -261383,6 +261441,15 @@ var init_githubAccess = __esm({
261383
261441
  if (transportResolution && !transportResolution.ok) {
261384
261442
  return transportResolution;
261385
261443
  }
261444
+ const githubDependencies = manifest.version === 1 ? void 0 : manifest.githubDependencies;
261445
+ if (githubDependencies && githubDependencies.length > 0) {
261446
+ const dependencyResolution = resolveAgentInitGithubDependencies({
261447
+ connectionResult,
261448
+ inventoryResult,
261449
+ repositories: githubDependencies
261450
+ });
261451
+ if (!dependencyResolution.ok) return dependencyResolution;
261452
+ }
261386
261453
  const maintenanceResolution = maintenanceRepos.length > 0 ? resolveAgentInitManagedGithubAccess({
261387
261454
  connectionResult,
261388
261455
  inventoryResult,
@@ -261453,6 +261520,25 @@ var init_githubAccess = __esm({
261453
261520
  githubRequirements
261454
261521
  };
261455
261522
  };
261523
+ resolveAgentInitGithubDependencies = ({
261524
+ connectionResult,
261525
+ inventoryResult,
261526
+ repositories
261527
+ }) => {
261528
+ const result = resolveAgentInitManagedGithubAccess({
261529
+ connectionResult,
261530
+ inventoryResult,
261531
+ projectLayoutRepos: repositories.map((fullName) => ({
261532
+ origin: `https://github.com/${fullName}`,
261533
+ originDefaultBranch: null,
261534
+ relPath: fullName
261535
+ })),
261536
+ requiredPermission: "pull",
261537
+ requireWorkflowsPermission: false,
261538
+ allowArchived: true
261539
+ });
261540
+ return result.ok ? result : { ...result, issue: { ...result.issue, location: "githubDependencies" } };
261541
+ };
261456
261542
  }
261457
261543
  });
261458
261544
 
@@ -261709,6 +261795,11 @@ var init_check2 = __esm({
261709
261795
  `Untracked files: ${!(manifest.untracked.copy ?? manifest.localChanges.copyDirty) ? "not copied" : manifest.untracked.mode === "defaults" ? "defaults (dependency/cache folders excluded)" : `custom selection, starting from ${manifest.untracked.base === "defaults" ? "normal exclusions" : "all eligible files"} (${manifest.untracked.include.length} include, ${manifest.untracked.exclude.length} exclude pattern(s))`}`
261710
261796
  );
261711
261797
  if (manifest.version !== 1) {
261798
+ if (manifest.githubDependencies !== void 0) {
261799
+ lines.push(
261800
+ `GitHub dependencies: ${manifest.githubDependencies.length ? manifest.githubDependencies.join(", ") : "none"}`
261801
+ );
261802
+ }
261712
261803
  if (manifest.githubAccess === "managed") {
261713
261804
  lines.push(
261714
261805
  `GitHub: ${githubAccessSummary ? `automatic access for ${githubAccessSummary.repositoryCount} repositories as @${githubAccessSummary.githubLogin}` : "automatic access"}`
@@ -262835,6 +262926,7 @@ var init_github = __esm({
262835
262926
  "src/devbox/commands/agentInit/github.ts"() {
262836
262927
  "use strict";
262837
262928
  init_commandCore();
262929
+ init_parse6();
262838
262930
  init_githubAccess();
262839
262931
  init_progressReport();
262840
262932
  init_remoteSession();
@@ -262884,13 +262976,27 @@ var init_github = __esm({
262884
262976
  });
262885
262977
  return;
262886
262978
  }
262979
+ let project = null;
262887
262980
  const outcome = await connectAgentInitGithub({
262888
262981
  client: context34.controlPlaneClient,
262889
262982
  loadProjectLayoutRepos: async () => {
262890
- const { repo, validation } = await resolveAgentInitProject({
262983
+ project = await resolveAgentInitProject({
262891
262984
  projectPath: process.cwd()
262892
262985
  });
262893
- return readAgentInitProjectLayoutRepos({ repo, validation });
262986
+ return readAgentInitProjectLayoutRepos(project);
262987
+ },
262988
+ loadGithubDependencies: async () => {
262989
+ if (!project) throw new Error("The project could not be resolved.");
262990
+ const text = await readManifestTextIfPresent(
262991
+ project.statePaths.manifestPath
262992
+ );
262993
+ if (text === null) return void 0;
262994
+ const parsed = parseAgentInitManifest(text);
262995
+ if (!parsed.ok)
262996
+ throw new Error(
262997
+ "Fix the setup manifest with `dvb agent-init check` before checking dependency access."
262998
+ );
262999
+ return parsed.manifest.version === 1 ? void 0 : parsed.manifest.githubDependencies;
262894
263000
  }
262895
263001
  });
262896
263002
  if (outcome !== null) {
@@ -262920,6 +263026,7 @@ var init_github = __esm({
262920
263026
  connectAgentInitGithub = async ({
262921
263027
  client,
262922
263028
  loadProjectLayoutRepos,
263029
+ loadGithubDependencies,
262923
263030
  openBrowserFn = openBrowser,
262924
263031
  print = console.log
262925
263032
  }) => {
@@ -262928,14 +263035,24 @@ var init_github = __esm({
262928
263035
  await startAgentInitGithubConnection({ client, openBrowserFn, print });
262929
263036
  return "waiting";
262930
263037
  }
262931
- const resolution = resolveAgentInitManagedGithubAccess({
263038
+ const inventoryResult = await client.listGithubRepositories({});
263039
+ let resolution = resolveAgentInitManagedGithubAccess({
262932
263040
  connectionResult,
262933
- inventoryResult: await client.listGithubRepositories({}),
263041
+ inventoryResult,
262934
263042
  projectLayoutRepos: await loadProjectLayoutRepos()
262935
263043
  });
263044
+ const githubDependencies = await loadGithubDependencies?.();
263045
+ const rootRepositoryCount = resolution.ok ? resolution.repositories.length : 0;
263046
+ if (resolution.ok && githubDependencies && githubDependencies.length > 0) {
263047
+ resolution = resolveAgentInitGithubDependencies({
263048
+ connectionResult,
263049
+ inventoryResult,
263050
+ repositories: githubDependencies
263051
+ });
263052
+ }
262936
263053
  if (resolution.ok) {
262937
263054
  print(
262938
- `GitHub is connected and boxes.dev can access ${resolution.repositories.length === 1 ? "this project's repository" : `all ${resolution.repositories.length} of this project's repositories`}. Re-run \`dvb agent-init check\`.`
263055
+ `GitHub is connected and boxes.dev can access ${rootRepositoryCount === 1 ? "this project's repository" : `all ${rootRepositoryCount} of this project's repositories`}${githubDependencies?.length ? ` and ${githubDependencies.length} dependency ${githubDependencies.length === 1 ? "repository" : "repositories"}` : ""}. Re-run \`dvb agent-init check\`.`
262939
263056
  );
262940
263057
  return "ok";
262941
263058
  }
@@ -264182,6 +264299,12 @@ var init_seed = __esm({
264182
264299
  push("# skip: no GitHub push/pull access");
264183
264300
  push("# Use null only when this project has no standard github.com origins.");
264184
264301
  push(`githubAccess: ${hasGithubOrigin ? githubAccessDefault : "null"}`);
264302
+ if (hasGithubOrigin && githubAccessDefault === "managed") {
264303
+ push(
264304
+ "# List private GitHub dependencies from package manifests and lockfiles."
264305
+ );
264306
+ push("githubDependencies: []");
264307
+ }
264185
264308
  push("");
264186
264309
  push("# SSH access from the Template box to each repo's origin.");
264187
264310
  push(
@@ -284285,7 +284408,8 @@ var init_userAuthenticatedRemoteSetup = __esm({
284285
284408
  backend,
284286
284409
  target: { kind: "template_box" },
284287
284410
  prompt,
284288
- idempotencyKey: `init-setup:${primaryInstanceId}`
284411
+ idempotencyKey: `init-setup:${primaryInstanceId}`,
284412
+ notificationsMuted: false
284289
284413
  })).operation.clientThreadId;
284290
284414
  await persistClientThread(clientThreadId);
284291
284415
  const startupDeadline = Date.now() + 18e4;
@@ -294622,7 +294746,8 @@ var init_threadStart = __esm({
294622
294746
  backend,
294623
294747
  target,
294624
294748
  prompt,
294625
- idempotencyKey
294749
+ idempotencyKey,
294750
+ notificationsMuted
294626
294751
  }) => {
294627
294752
  const project = await loadCliAgentToolProject(
294628
294753
  context34.client,
@@ -294664,7 +294789,8 @@ var init_threadStart = __esm({
294664
294789
  backend,
294665
294790
  target: resolvedTarget,
294666
294791
  prompt,
294667
- idempotencyKey
294792
+ idempotencyKey,
294793
+ notificationsMuted
294668
294794
  });
294669
294795
  } catch (error55) {
294670
294796
  throw normalizeConvexResourceError(error55);
@@ -294778,6 +294904,7 @@ var init_threadMutations = __esm({
294778
294904
  const values = /* @__PURE__ */ new Map();
294779
294905
  let json3 = false;
294780
294906
  let stdin = false;
294907
+ let notificationsMuted = false;
294781
294908
  for (let index = 0; index < args.length; index += 1) {
294782
294909
  const argument = args[index];
294783
294910
  if (argument === "--json") {
@@ -294788,6 +294915,10 @@ var init_threadMutations = __esm({
294788
294915
  stdin = true;
294789
294916
  continue;
294790
294917
  }
294918
+ if (argument === "--muted") {
294919
+ notificationsMuted = true;
294920
+ continue;
294921
+ }
294791
294922
  if (!argument.startsWith("--")) {
294792
294923
  invalidThreadMutationArgs(`Unexpected argument: ${argument}`);
294793
294924
  }
@@ -294840,7 +294971,8 @@ var init_threadMutations = __esm({
294840
294971
  target: parseTarget(requireValue("target")),
294841
294972
  backend,
294842
294973
  idempotencyKey: requireValue("idempotency-key"),
294843
- promptSource: sources[0]
294974
+ promptSource: sources[0],
294975
+ notificationsMuted
294844
294976
  };
294845
294977
  };
294846
294978
  parseThreadControlArgs = ({
@@ -294971,7 +295103,8 @@ var init_threadMutations = __esm({
294971
295103
  backend: parsed.backend,
294972
295104
  target: parsed.target,
294973
295105
  prompt: await loadPrompt2(parsed.promptSource, dependencies),
294974
- idempotencyKey: parsed.idempotencyKey
295106
+ idempotencyKey: parsed.idempotencyKey,
295107
+ notificationsMuted: parsed.notificationsMuted
294975
295108
  }),
294976
295109
  render: renderThreadStart,
294977
295110
  nextActions: (data) => [
@@ -295094,6 +295227,107 @@ var init_threadMutations = __esm({
295094
295227
  }
295095
295228
  });
295096
295229
 
295230
+ // src/devbox/commands/threadNotifications.ts
295231
+ var invalidThreadNotificationsArgs, parseThreadNotificationsArgs, setThreadNotificationsMuted, defaultThreadNotificationsCommandDependencies, runThreadNotificationsWithDependencies, runThreadMute, runThreadUnmute;
295232
+ var init_threadNotifications = __esm({
295233
+ "src/devbox/commands/threadNotifications.ts"() {
295234
+ "use strict";
295235
+ init_threadInventory();
295236
+ init_devboxOperations();
295237
+ init_errors5();
295238
+ init_queryRefs2();
295239
+ init_resourceOutput();
295240
+ invalidThreadNotificationsArgs = (message) => {
295241
+ throw new CliAgentToolError({ code: "invalid_request", message });
295242
+ };
295243
+ parseThreadNotificationsArgs = (args) => {
295244
+ let json3 = false;
295245
+ let clientThreadId = null;
295246
+ for (let index = 0; index < args.length; index += 1) {
295247
+ const argument = args[index];
295248
+ if (argument === "--json") {
295249
+ json3 = true;
295250
+ continue;
295251
+ }
295252
+ if (argument !== "--thread" && !argument.startsWith("--thread=")) {
295253
+ invalidThreadNotificationsArgs(
295254
+ argument.startsWith("--") ? `Unknown option: ${argument}` : `Unexpected argument: ${argument}`
295255
+ );
295256
+ }
295257
+ if (clientThreadId !== null) {
295258
+ invalidThreadNotificationsArgs("`--thread` may be supplied only once.");
295259
+ }
295260
+ const inline = argument !== "--thread";
295261
+ const value = (inline ? argument.slice("--thread=".length) : args[index + 1] ?? "").trim();
295262
+ if (!value || !inline && value.startsWith("--")) {
295263
+ invalidThreadNotificationsArgs("`--thread` requires a value.");
295264
+ }
295265
+ clientThreadId = value;
295266
+ if (!inline) {
295267
+ index += 1;
295268
+ }
295269
+ }
295270
+ return {
295271
+ json: json3,
295272
+ clientThreadId: clientThreadId ?? invalidThreadNotificationsArgs("`--thread <value>` is required.")
295273
+ };
295274
+ };
295275
+ setThreadNotificationsMuted = async ({
295276
+ context: context34,
295277
+ clientThreadId,
295278
+ muted
295279
+ }) => {
295280
+ try {
295281
+ return await context34.client.mutation(
295282
+ setCliAgentToolThreadNotificationsMutedV1,
295283
+ {
295284
+ contractVersion: CLI_AGENT_TOOLS_CONTRACT_VERSION,
295285
+ clientThreadId,
295286
+ muted
295287
+ }
295288
+ );
295289
+ } catch (error55) {
295290
+ throw normalizeConvexResourceError(error55);
295291
+ }
295292
+ };
295293
+ defaultThreadNotificationsCommandDependencies = {
295294
+ ...defaultResourceCommandDependencies,
295295
+ setThreadNotificationsMuted
295296
+ };
295297
+ runThreadNotificationsWithDependencies = async (args, muted, dependencies) => {
295298
+ try {
295299
+ const parsed = parseThreadNotificationsArgs(args);
295300
+ await runResourceCommand({
295301
+ json: parsed.json,
295302
+ dependencies,
295303
+ load: async (context34) => await dependencies.setThreadNotificationsMuted({
295304
+ context: context34,
295305
+ clientThreadId: parsed.clientThreadId,
295306
+ muted
295307
+ }),
295308
+ render: (data) => `${data.clientThreadId} ${data.notificationsMuted ? "muted" : "unmuted"}`
295309
+ });
295310
+ } catch (error55) {
295311
+ if (args.includes("--json")) {
295312
+ writeResourceCommandJsonFailure({ dependencies, error: error55 });
295313
+ return;
295314
+ }
295315
+ throw error55;
295316
+ }
295317
+ };
295318
+ runThreadMute = async (args) => await runThreadNotificationsWithDependencies(
295319
+ args,
295320
+ true,
295321
+ defaultThreadNotificationsCommandDependencies
295322
+ );
295323
+ runThreadUnmute = async (args) => await runThreadNotificationsWithDependencies(
295324
+ args,
295325
+ false,
295326
+ defaultThreadNotificationsCommandDependencies
295327
+ );
295328
+ }
295329
+ });
295330
+
295097
295331
  // src/devbox/resourceApi/threadRead.ts
295098
295332
  var readCliAgentToolThread, readCliAgentToolCanonicalThread, readCliAgentToolThreadByLocator;
295099
295333
  var init_threadRead = __esm({
@@ -296139,6 +296373,7 @@ var init_dispatch = __esm({
296139
296373
  init_whoami();
296140
296374
  init_threads2();
296141
296375
  init_threadMutations();
296376
+ init_threadNotifications();
296142
296377
  init_threadObservation2();
296143
296378
  init_completions();
296144
296379
  COMMAND_DISPATCH = /* @__PURE__ */ new Map([
@@ -296170,6 +296405,8 @@ var init_dispatch = __esm({
296170
296405
  ["threads wait", runThreadWait],
296171
296406
  ["threads events", runThreadEvents],
296172
296407
  ["threads interrupt", runThreadInterrupt],
296408
+ ["threads mute", runThreadMute],
296409
+ ["threads unmute", runThreadUnmute],
296173
296410
  ["exec", runExec],
296174
296411
  ["list", runList],
296175
296412
  ["connect", runConnect],
@@ -296905,4 +297142,4 @@ react/cjs/react-jsx-runtime.development.js:
296905
297142
  *)
296906
297143
  */
296907
297144
 
296908
- //# debugId=3b790c03-f84d-5b8e-85a2-1549b0f7a919
297145
+ //# debugId=7aa83311-1186-5591-8c75-997f59be496e
package/dist/bin/dvbd.mjs CHANGED
@@ -64674,9 +64674,9 @@ var init_sentry = __esm({
64674
64674
  uncaughtExceptionMonitorInstalled = false;
64675
64675
  currentDevboxSentryUser = null;
64676
64676
  readBuildMetadata = () => {
64677
- const rawPackageVersion = "1.0.1059";
64678
- const rawGitSha = "f538c975742985e515cdf721d4c94e5cb211e2ab";
64679
- const rawSentryRelease = "boxes-dev-dvb@1.0.1059+f538c975742985e515cdf721d4c94e5cb211e2ab";
64677
+ const rawPackageVersion = "1.0.1060";
64678
+ const rawGitSha = "933e3efd090a3e3976548122ca0dafc03f4f3d6e";
64679
+ const rawSentryRelease = "boxes-dev-dvb@1.0.1060+933e3efd090a3e3976548122ca0dafc03f4f3d6e";
64680
64680
  const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
64681
64681
  const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
64682
64682
  const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
@@ -66893,7 +66893,7 @@ var init_packageVersion = __esm({
66893
66893
  return path8.join(process.cwd(), "dvb");
66894
66894
  };
66895
66895
  readEmbeddedPackageVersion = () => {
66896
- const raw = "1.0.1059";
66896
+ const raw = "1.0.1060";
66897
66897
  return trimVersion(raw);
66898
66898
  };
66899
66899
  readNearestPackageMetadata = (basePath) => {
@@ -197,6 +197,9 @@ and exact existing devboxes but rejects `template` because it has no personal
197
197
  Template box.
198
198
  Use exactly one of `--prompt`, `--prompt-file`, or `--stdin`. Thread start
199
199
  supports current Codex and Claude threads, not the retired `claude_code` type.
200
+ Add `--muted` when the user asks for a quiet thread, such as a worker whose
201
+ result you will collect yourself. A muted thread's finished turns don't notify
202
+ the user or mark it unread; requests for input still do.
200
203
 
201
204
  The result contains a durable `operationId` and stable `clientThreadId`. Retry
202
205
  the same logical start with the same idempotency key and identical arguments.
@@ -303,6 +306,18 @@ An older devbox service returns `unsupported_capability` for send and
303
306
  interrupt. Upgrade the local boxes.dev service rather than bypassing the
304
307
  ownership or exact-turn checks.
305
308
 
309
+ Mute or unmute an existing thread when the user asks:
310
+
311
+ ```bash
312
+ dvb threads mute --thread <client-thread-id> --json
313
+ dvb threads unmute --thread <client-thread-id> --json
314
+ ```
315
+
316
+ The change takes effect immediately and is safe to repeat. Muting an unread
317
+ thread also marks it read, but a pending request for input stays visible until
318
+ it is answered. `threads list` reports each thread's `notificationsMuted`
319
+ value.
320
+
306
321
  ## Lifecycle Mutations And Cleanup
307
322
 
308
323
  Use exact project and target identifiers:
@@ -76,7 +76,8 @@ Most workbench surfaces have right-click menus, and each shows the same
76
76
  actions as the surface's other affordances:
77
77
 
78
78
  - Thread rows open the same menu as their **...** button (pin, rename, mark
79
- unread, archive, copy actions, and devbox actions where they apply).
79
+ unread, mute notifications, archive, copy actions, and devbox actions where
80
+ they apply).
80
81
  - File links in transcripts offer Open, Open expanded, Reveal in Files pane,
81
82
  Copy path (with line when the link has one), and Download. Images in
82
83
  transcripts and previews offer Open in Files pane, Copy path, Save image,
@@ -353,6 +354,12 @@ The menu for an eligible non-archived thread includes **Mark unread**. The
353
354
  thread stays unread until you open it again, and the same state appears in the
354
355
  mobile app and unread badge counts.
355
356
 
357
+ The same menu, including the thread header's menu, offers **Mute
358
+ notifications**. A muted thread shows a bell-off icon after its title, and its
359
+ finished turns don't notify you or mark it unread; requests for input still
360
+ do. **Mark unread** on a muted thread lasts until you open it or its next turn
361
+ finishes. **Unmute notifications** turns them back on.
362
+
356
363
  Desktop completion notifications are controlled in **Desktop app settings >
357
364
  Notifications**:
358
365
 
@@ -238,16 +238,17 @@ boxes.dev refreshes expiring credentials automatically before they expire.
238
238
  If the refresh credential has also expired, reconnect GitHub. Temporary GitHub
239
239
  outages are retried without treating your authorization as revoked.
240
240
 
241
- For a project created from GitHub with automatic access, fetch, pull, and push
242
- use the connected user's credential after boxes.dev verifies that the exact
243
- repository was selected for the project and the user still has write access.
241
+ For an ordinary project with automatic access, Git can use any GitHub repository
242
+ that the connected user's credential can read. boxes.dev verifies the machine
243
+ and current repository access before returning the credential; GitHub enforces
244
+ write permission and branch rules when you push.
244
245
  If access stops, reconnect the GitHub account used for the project, use
245
246
  **Manage repos** to give the boxes.dev App access, or restore the connected
246
247
  user's write permission as directed by the error. When an organization cannot
247
248
  approve the App for that repository, **Integrations → GitHub → Use personal
248
249
  access** can authorize the official GitHub CLI instead. That personal access
249
- can authenticate an existing, exact token-free HTTPS project remote after
250
- boxes.dev confirms that the connected user still has write access. It does not
250
+ can authenticate a token-free HTTPS Git request after boxes.dev confirms that
251
+ the same connected user can read the repository. It does not
251
252
  convert an SSH remote to HTTPS or change any repository remote.
252
253
 
253
254
  GitHub authenticates the push as the connected user while the commit keeps its
@@ -322,6 +323,27 @@ no membership or repair controls to offer. A managed single-repository project
322
323
  can still show the card for its exact GitHub membership or an access repair,
323
324
  but cannot add another repository at the project root.
324
325
 
326
+ ### Private Git Dependencies
327
+
328
+ Ordinary projects with automatic GitHub access can fetch private dependencies
329
+ using the connected account's existing access, without adding another checkout.
330
+ For an early access check with `dvb agent-init` on your own computer, list private
331
+ GitHub dependencies in the setup manifest. For example, use
332
+ `githubDependencies: [Nullframe/engine-spec]` with
333
+ `githubAccess: managed`. Ask the local setup agent to inspect package manifests
334
+ and lockfiles, review the list with you, and run `dvb agent-init github connect`
335
+ followed by `dvb agent-init check`. If the GitHub App lacks access, the command
336
+ will open the page where you can grant it or request organization approval.
337
+
338
+ Dependency checks require read access, so a read-only or archived dependency
339
+ can be used without adding a checkout, changing its URL, or changing the project
340
+ layout. If an existing setup is blocked, grant any missing GitHub access,
341
+ continue its setup thread, and retry the dependency fetch. The manifest list
342
+ only chooses which dependencies to check before setup; leaving it out or empty
343
+ does not change repository access. Credentials retain their GitHub permissions.
344
+ This flow does not change Team Template
345
+ member projects. Run the setup CLI on your own computer, not inside a devbox.
346
+
325
347
  ## Git Author Identity
326
348
 
327
349
  By default, boxes.dev uses your connected GitHub account's name and private
@@ -96,8 +96,8 @@ current saved version. Inside an existing devbox group, **New thread** opens a
96
96
  draft directly on that same devbox, where you choose the agent before sending.
97
97
 
98
98
  Thread menus support common actions such as opening, renaming, pinning,
99
- unpinning, marking unread, archiving, unarchiving, deleting when available, and
100
- ending live sessions. Eligible Codex and Claude threads on the Template box can
99
+ unpinning, marking unread, muting notifications, archiving, unarchiving,
100
+ deleting when available, and ending live sessions. Eligible Codex and Claude threads on the Template box can
101
101
  be moved to a new devbox after their current turn finishes.
102
102
 
103
103
  For an ordinary project, from an open Template-box thread, use **New snapshot** in the header overflow
@@ -117,6 +117,12 @@ thread-list menu and the open session's header menu. The thread stays unread
117
117
  until you open it again, and the same state appears in the desktop app and
118
118
  unread badge counts.
119
119
 
120
+ The thread-list menu also offers **Mute notifications**. A muted thread shows
121
+ a bell-off icon on its row, and its finished turns don't send a push
122
+ notification or mark it unread; requests for input still do. **Mark unread**
123
+ on a muted thread lasts until you open it or its next turn finishes. **Unmute
124
+ notifications** turns them back on.
125
+
120
126
  ## Session View
121
127
 
122
128
  The session view shows the thread transcript and a composer for sending new
@@ -731,6 +731,13 @@ Retry an uncertain result with the same idempotency key and identical
731
731
  arguments, including model and reasoning effort and any explicit speed;
732
732
  changed arguments under the same key fail.
733
733
 
734
+ Add `--muted` to any start form when the user wants a quiet worker thread or
735
+ asks not to be notified about it. A muted thread will not send notifications or
736
+ become unread when its turns finish, fail, or are interrupted. It will still
737
+ notify the user and show that it needs input when its agent asks a question or
738
+ needs an approval, because only the user can answer those. `--muted` is a start
739
+ argument, so a retry with the same idempotency key must repeat it.
740
+
734
741
  The source box can continue and inspect only the delegated children it created
735
742
  through this command. It cannot target another same-project thread. The default
736
743
  follow-up delivery is `next`:
@@ -787,6 +794,20 @@ logical send or interrupt, and keep every argument identical on retry. If a
787
794
  response is lost after dispatch, boxes.dev recovers the durable result without
788
795
  automatically sending the input again.
789
796
 
797
+ Mute or unmute the notifications of a child that this box created when the
798
+ user asks:
799
+
800
+ ```bash
801
+ dvb-onbox threads mute --thread <delegated-thread-id> --json
802
+ dvb-onbox threads unmute --thread <delegated-thread-id> --json
803
+ ```
804
+
805
+ The change takes effect immediately and is safe to repeat. Muting a child that
806
+ is currently unread also marks it read, but a pending request for input stays
807
+ visible until it is answered. The user can change the same setting
808
+ from the thread menu in the desktop app or the long-press menu on mobile, and
809
+ `threads list` reports each child's `notificationsMuted` value.
810
+
790
811
  Read the child's saved transcript without claiming its live input surface:
791
812
 
792
813
  ```bash
@@ -980,7 +1001,9 @@ The recipient's Codex or Claude receives the message from another agent, not
980
1001
  as user input. The message names the sender's thread and the command for
981
1002
  replying. It cannot answer a pending permission prompt or question for the
982
1003
  user. The user sees it in the recipient's thread as a message from the sending
983
- agent, linked to the sender's thread.
1004
+ agent, linked to the sender's thread. After work finishes, peer messages
1005
+ collapse with tool activity under **Worked for…**. Expand it to read those
1006
+ messages; messages from the user and the agent's final answer stay visible.
984
1007
 
985
1008
  A successful result means the recipient accepted the message; it does not mean
986
1009
  the agent has read, acted on, or answered it. Replies arrive later as messages
@@ -1015,11 +1038,17 @@ agents on this box created, see
1015
1038
  [Destroy And Archive Created Devboxes](#destroy-and-archive-created-devboxes).
1016
1039
 
1017
1040
  Destruction permanently deletes the devbox's files and retains its thread
1018
- history. Run this only when the user's task calls for destroying the devbox,
1019
- after preserving required work outside the machine. The command returns
1020
- `accepted` once the request is saved, or `already_requested` for an existing
1021
- request; neither means destruction has finished. Finish your final response
1022
- after acceptance. Do not wait in a tool call for your own destruction.
1041
+ history. Run this only when the user's task calls for destroying the devbox.
1042
+ When the user asks for teardown, generally proceed, ignoring files, branches
1043
+ and stashes inherited unchanged from the Template box. If significant work
1044
+ created on this devbox is worth keeping and has not been committed and pushed
1045
+ or otherwise saved, flag it to the user and wait for their answer before
1046
+ requesting destruction.
1047
+
1048
+ The command returns `accepted` once the request is saved, or
1049
+ `already_requested` for an existing request; neither means destruction has
1050
+ finished. Finish your final response after acceptance. Do not wait in a tool
1051
+ call for your own destruction.
1023
1052
 
1024
1053
  The request always waits for every agent and queued message on the devbox to
1025
1054
  finish. There is no `--when-idle` or force option. Once idle, boxes.dev archives
@@ -554,9 +554,12 @@ safe setup constraints, run verification, and snapshot workflow.
554
554
 
555
555
  With automatic access, boxes.dev clones over a token-free GitHub HTTPS URL.
556
556
  The Template box and its devboxes request the connected user's credential only
557
- when Git needs one. Before returning it, boxes.dev checks that the exact
558
- repository was selected for this project and that the connected user still has
559
- write access. The credential is kept out of the remote URL, Git configuration,
557
+ when Git needs one. Before returning it, boxes.dev checks the machine's ownership
558
+ and that the connected user can read the requested repository. Git can access
559
+ other repositories and private dependencies covered by that authorization,
560
+ including readable archived repositories, without adding them to the project.
561
+ GitHub enforces write permissions and branch rules when pushing.
562
+ The credential is kept out of the remote URL, Git configuration,
560
563
  and managed files, but it can exist in daemon, Git, and snapshot process memory.
561
564
  This access continues after a box sleeps or restarts without another setup
562
565
  step.
@@ -566,14 +569,14 @@ protection, rulesets, required checks, user/team allowlists, bypass decisions,
566
569
  and GitHub Activity see the human actor. Commit author, committer, email, and
567
570
  signature continue to come from Git. The user credential can access any
568
571
  repository available to both that user and the boxes.dev GitHub App; project
569
- selection controls when the managed helper returns it, but does not downscope a
570
- credential that code on the box extracts. New and reconnected GitHub accounts
572
+ checkout selection does not narrow Git access or the credential itself. New and
573
+ reconnected GitHub accounts
571
574
  use short-lived access that boxes.dev refreshes centrally, so Template boxes and
572
575
  devboxes do not need another setup step when an access token changes. A user
573
576
  who connected before this behavior shipped may be asked for one GitHub update
574
577
  before starting another automatic-access setup; existing projects keep
575
578
  working in the meantime. Disconnecting the project's GitHub account, removing
576
- the repository from the App installation, or losing write access stops future
579
+ the repository from the App installation, or losing read access stops future
577
580
  helper issuance after its bounded cache lease, but does not itself revoke a
578
581
  credential already returned to a process. New setup treats an automatic-access
579
582
  choice as ready only after every affected GitHub account has accepted any
@@ -130,14 +130,15 @@ disconnecting the main GitHub connection.
130
130
 
131
131
  When automatic Git access uses the GitHub App, the connected user's App
132
132
  credential remains encrypted at rest in boxes.dev. When Git needs access, the
133
- machine requests that credential through a local helper. boxes.dev first checks
134
- that the exact repository is associated with the project and that the connected
135
- user still has write access. The token can exist in the boxes.dev service, local
133
+ machine requests that credential through a local helper. For ordinary projects,
134
+ boxes.dev first checks the machine's ownership and that the connected user can
135
+ read the requested repository. GitHub enforces write permissions when pushing.
136
+ The token can exist in the boxes.dev service, local
136
137
  service, Git process, and snapshot process memory, but is not written to the
137
138
  remote URL or a managed credential file.
138
139
 
139
- Repository selection is an issuance boundary, not a downscope on the App token
140
- itself. Code running on the box can request and inspect the App credential,
140
+ Ordinary project checkout selection does not restrict Git access. Code running
141
+ on the box can request and inspect the App credential,
141
142
  whose access is the intersection of the connected user's repositories and the
142
143
  repositories and permissions granted to the boxes.dev GitHub App. Current App
143
144
  connections use GitHub access tokens that last eight hours. boxes.dev refreshes
@@ -151,6 +152,10 @@ removing App access stops future App helper issuance after its bounded cache
151
152
  lease, but does not itself revoke an App token already returned to a process.
152
153
  GitHub attributes the Git operation to the connected user.
153
154
 
155
+ Team Template member projects retain their separate release-bound repository
156
+ checks. Team Template editing uses repository-restricted App installation
157
+ credentials rather than an administrator's broad user credential.
158
+
154
159
  Optional personal access uses the official GitHub CLI authorization the user
155
160
  approved. Before boxes.dev issues this credential, the personal authorization
156
161
  must match the main GitHub identity and pass the exact repository checks for the
@@ -326,6 +326,42 @@ Manual, scheduled, and API automations can separately send selected events to
326
326
  Slack channels or linked-user DMs. Those output destinations can receive final
327
327
  output, needs-input, and failed-run events.
328
328
 
329
+ ## Shared Thread Previews
330
+
331
+ When someone posts a boxes.dev share link (`/t/...`) in Slack, boxes.dev adds
332
+ a preview card to the message. The card shows the boxes.dev logo, the thread's
333
+ title, its creator, and an **Open in boxes.dev** button that opens the share
334
+ link. A thread without a manual or generated title shows **boxes.dev thread**;
335
+ the first message never appears on the card, because everyone in the
336
+ conversation can see it. boxes.dev updates posted cards when the thread is
337
+ renamed; turns don't change the card. Several share links in one message get
338
+ compact cards, and Slack previews at most five links per message.
339
+
340
+ Selecting the card's title opens its details in Slack. A viewer who has linked
341
+ their Slack identity and can open the share sees the card's fields and button
342
+ plus the first message, last activity, coding agent, project, devbox, and
343
+ shared date. The details show a status only when the thread is **Working**,
344
+ **Waiting for input**, **Failed**, **Cold stored**, or **History only**, read
345
+ when the panel opens. An unlinked member of the connected workspace is asked to
346
+ connect their boxes.dev account. External users, bots, and members linked to
347
+ another boxes.dev team see Slack's restricted state. An open details panel
348
+ keeps what it loaded until the viewer chooses **Sync data**.
349
+
350
+ A revoked or private share, a deleted thread, an owner whose account was
351
+ deleted or who left the team keeping the project, and another team's share all
352
+ show **This shared thread isn't available**, and posted cards switch to it
353
+ within seconds. Previews also appear in DMs, group DMs, and private channels
354
+ without the app. boxes.dev adds no preview in conversations Slack reports as
355
+ shared with another organization.
356
+
357
+ Workspaces connected before previews existed lack the `links:read` and
358
+ `links:write` permissions. Mentions, DMs, and automations keep working without
359
+ them. The Slack integration home shows **Update available** and "Reinstall the
360
+ Slack app to turn on previews for shared thread links." Members instead see
361
+ that a team admin needs to reinstall it. A team admin needs to choose
362
+ **Reinstall** there, or **Reinstall Slack** from the Slack actions menu in
363
+ **Team Settings**, and approve the request in Slack.
364
+
329
365
  ## Current Limits
330
366
 
331
367
  Slack triggers require an app mention or a 1:1 app DM. boxes.dev does not
@@ -354,6 +390,9 @@ If a channel is not available, add `@boxes.dev` to the channel and run
354
390
  **Check** from **Team connection** on the Slack integration home (or
355
391
  **Recheck** in Team Settings).
356
392
 
393
+ If a share link gets no preview, confirm the conversation isn't shared with
394
+ another organization and the Slack connection lists no missing permissions. See [Shared Thread Previews](#shared-thread-previews).
395
+
357
396
  If a mention does not start an automation, confirm the Slack workspace is
358
397
  connected, your Slack identity is linked, the automation is active, the message
359
398
  includes `@boxes.dev`, and the command/channel/permission settings allow it. If
@@ -300,6 +300,11 @@ connection without replacing its sign-in; other personal connections remain.
300
300
  An account-wide source stays available in other projects. See
301
301
  `team-template.md` for matching and template-update behavior.
302
302
 
303
+ A connected service can ask Claude for a simple confirmation in the thread.
304
+ Choose **Allow** to approve the request or **Deny** to reject it. Requests for
305
+ other form input or a separate confirmation URL are canceled so Claude can
306
+ continue.
307
+
303
308
  ## Plugins
304
309
 
305
310
  Open **Integrations → Codex/Claude Plugins** in the desktop app. The page talks
@@ -999,6 +1004,7 @@ The thread action menu can include:
999
1004
 
1000
1005
  - Pin thread or Unpin thread.
1001
1006
  - Rename thread.
1007
+ - Mute notifications or Unmute notifications.
1002
1008
  - Archive thread or Unarchive thread.
1003
1009
  - Restore thread for an archived cold-storage thread. Ordinary projects offer
1004
1010
  To new devbox and To Template box; Team Template member projects offer only
@@ -1050,3 +1056,12 @@ git or file transfer before the devbox is destroyed.
1050
1056
  Thread rows can show unread and active indicators so users can see which
1051
1057
  threads need attention. Desktop and mobile notifications can also point users
1052
1058
  back to threads that finished, need input, or changed state.
1059
+
1060
+ **Mute notifications** turns off one thread's notifications for finished,
1061
+ failed, and interrupted turns and keeps those turns from marking it unread. A
1062
+ request for input still notifies and marks the thread. A muted thread shows a
1063
+ bell-off icon on its row. Muting also clears an existing unread marker, but a
1064
+ pending request for input stays until it is answered. **Mark unread** on a
1065
+ muted thread lasts until the thread is opened or its next turn finishes.
1066
+ **Unmute notifications** restores normal behavior. The setting belongs to the thread, so desktop,
1067
+ mobile, `dvb`, and `dvb-onbox` all show and change the same value.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@boxes-dev/dvb-runtime",
3
- "version": "1.0.1059",
3
+ "version": "1.0.1060",
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-08T01:46:54Z"
80
+ "devboxReleasedAt": "2026-10-08T21:24:43Z"
81
81
  }