@boxes-dev/dvb-runtime 1.0.1097 → 1.0.1099

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.
Files changed (35) hide show
  1. package/dist/agent-init-guides/flow.md +31 -4
  2. package/dist/agent-init-guides/git-ssh.md +2 -2
  3. package/dist/agent-init-guides/manifest.md +10 -2
  4. package/dist/agent-init-guides/running.md +8 -3
  5. package/dist/agent-init-guides/untracked.md +29 -4
  6. package/dist/bin/dvb.mjs +108 -27
  7. package/dist/bin/dvbd.mjs +10 -9
  8. package/dist/product-docs/references/agent-tools.md +6 -7
  9. package/dist/product-docs/references/automations.md +4 -4
  10. package/dist/product-docs/references/aws.md +17 -11
  11. package/dist/product-docs/references/billing-and-limits.md +23 -11
  12. package/dist/product-docs/references/cli.md +14 -15
  13. package/dist/product-docs/references/core-concepts.md +35 -30
  14. package/dist/product-docs/references/desktop-workbench.md +26 -25
  15. package/dist/product-docs/references/files-git-and-review.md +20 -17
  16. package/dist/product-docs/references/fork-workflows.md +44 -31
  17. package/dist/product-docs/references/getting-started.md +7 -8
  18. package/dist/product-docs/references/glossary.md +46 -22
  19. package/dist/product-docs/references/google-cloud.md +13 -8
  20. package/dist/product-docs/references/index.md +18 -16
  21. package/dist/product-docs/references/linear.md +2 -2
  22. package/dist/product-docs/references/managed-environment-files.md +1 -1
  23. package/dist/product-docs/references/member-managed-files.md +4 -4
  24. package/dist/product-docs/references/mobile.md +23 -18
  25. package/dist/product-docs/references/onbox-agent-tools.md +25 -26
  26. package/dist/product-docs/references/ports-terminal-and-runtime.md +27 -28
  27. package/dist/product-docs/references/project-setup.md +36 -16
  28. package/dist/product-docs/references/security-and-data.md +10 -10
  29. package/dist/product-docs/references/slack.md +3 -3
  30. package/dist/product-docs/references/tailscale.md +2 -2
  31. package/dist/product-docs/references/team-template.md +22 -22
  32. package/dist/product-docs/references/template-box-environment.md +7 -3
  33. package/dist/product-docs/references/threads-and-agents.md +79 -31
  34. package/dist/product-docs/references/troubleshooting.md +24 -25
  35. package/package.json +2 -2
@@ -144,6 +144,32 @@ Use `github cli enable` or `github cli disable` only after the user chooses
144
144
  to change it. This changes their existing account setting across projects;
145
145
  it is separate from repository pull/push access and is not a manifest field.
146
146
 
147
+ Ask which branch new devboxes should start on; Template setup will run on that
148
+ same branch. Recommend each repository's actual remote default (often `main`
149
+ or `master`), even when the local checkout is already there. For multiple
150
+ repositories, record one choice per path. Use that choice in the generated
151
+ `devboxLifecycle.startupScript` Git block and any Template maintenance script.
152
+
153
+ As part of the existing dirty/untracked-file review in `guide untracked`, compare
154
+ the local checkout with the selected branch and ask which unfinished work to
155
+ save on boxes.dev for later. Reuse answers already given; do not add a second file
156
+ review. Included work will be saved separately on the Template box before setup
157
+ runs on the selected branch. It will not become the active starting state of
158
+ Template setup or new devboxes, even when the edits are already on that branch.
159
+ Leave the local checkout, index, and files alone.
160
+
161
+ Record the selected branch, current branch/commit, work-copy choices, and
162
+ preservation instructions per repository in `setupNotes`. Distinguish
163
+ unfinished work from env/config/fixtures needed for setup. For example: start
164
+ on `main`, retain the imported `feature-123` branch, save its dirty files in a
165
+ named stash on the Template box, and keep the approved `.env.local` available
166
+ for setup. Saving this work in the Template snapshot does not involve a Git push.
167
+ When the selected branch has no remote counterpart, explain that fetching it
168
+ for new devboxes is unavailable. Ask whether to choose an available remote
169
+ branch or use a clean local branch from the Template snapshot for both setup
170
+ and new devboxes; omit the generated remote Git block only for that latter
171
+ choice. Do not invent a remote branch or publish one.
172
+
147
173
  Review `devboxLifecycle` even when its seeded Git refresh is correct. Add a
148
174
  teardown script only for cleanup that must happen before a devbox is removed.
149
175
  The generated Git block declares each selected repository's starting branch,
@@ -157,7 +183,7 @@ block; do not add another Git reset or branch switch there.
157
183
  Recommend Template maintenance when the project has dependencies, generated
158
184
  code, or tooling that change over time; most projects do. New devboxes start
159
185
  from the Template box's latest snapshot. Maintenance keeps that snapshot
160
- current: it updates the Template box to the latest default branch, installs
186
+ current: it updates the Template box on the selected starting branch, installs
161
187
  locked dependencies, and refreshes tooling, then boxes.dev saves a new snapshot.
162
188
  Design `templateMaintenance.script` and its exact GitHub watch paths together.
163
189
  Watch the lockfiles, toolchain version files, and generated-code inputs that
@@ -199,9 +225,10 @@ destination paths and get the user's choice before selecting outside files.
199
225
  Record unresolved requirements in `setupNotes` for remote setup and validation.
200
226
 
201
227
  Do not silently choose approval-sensitive options. Before `check`, explicitly
202
- confirm the repositories in a multi-repository project, runtime agents and
203
- imported agent config/history, dirty and untracked files, databases,
204
- instance type, GitHub access, Git SSH/signing, devbox lifecycle or Template
228
+ confirm the repositories in a multi-repository project, the shared starting
229
+ branch for Template setup and new devboxes, runtime agents and imported agent
230
+ config/history, local-work preservation and dirty/untracked-file selections,
231
+ databases, instance type, GitHub access, Git SSH/signing, devbox lifecycle or Template
205
232
  maintenance configuration (including watch paths), and any instruction that
206
233
  lets the remote setup agent change tracked project files. It is fine to
207
234
  recommend defaults, but the user must make the choice.
@@ -41,14 +41,14 @@ Run `dvb agent-init github connect` to grant any missing GitHub App access, then
41
41
  dependency before setup. If remote setup is already blocked, grant any missing
42
42
  GitHub access, continue that setup thread, and retry the package fetch. Keep the
43
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
44
+ archived; project checkouts still need write access during setup. In an independent
45
45
  project, Git can access any repository that the connected credential can read;
46
46
  GitHub enforces write permission when pushing. The dependency list does not
47
47
  grant or restrict access.
48
48
 
49
49
  Omit `githubDependencies` or use an empty list to skip dependency preflight.
50
50
  Manage repository access through GitHub. This flow applies to
51
- ordinary projects with managed GitHub HTTPS access, not Team Template member
51
+ independent projects with managed GitHub HTTPS access, not managed
52
52
  projects. If Cargo's built-in Git client cannot use the configured authentication,
53
53
  set `CARGO_NET_GIT_FETCH_WITH_CLI=true` during remote setup to make Cargo use Git
54
54
  for fetching. See [Cargo's Git authentication guide](https://doc.rust-lang.org/cargo/appendix/git-authentication.html).
@@ -118,7 +118,8 @@ watches always require current boxes.dev GitHub App read access, even when
118
118
 
119
119
  A maintenance script must:
120
120
 
121
- - Fetch and fast-forward each repository it depends on to its default branch,
121
+ - Fetch and fast-forward each repository on the branch selected for Template
122
+ setup and new devboxes,
122
123
  then install locked dependencies and refresh generated files or tooling
123
124
  without prompts.
124
125
  - Exit nonzero with a clear message when a checkout has uncommitted changes or
@@ -164,7 +165,14 @@ Use a nonempty teardown script only when devbox removal genuinely needs cleanup;
164
165
  it is not a second maintenance hook.
165
166
 
166
167
  `setupNotes` is worth writing well: it goes verbatim to the agent that
167
- finishes setup on the Template box. Include install steps that aren't obvious
168
+ finishes setup on the Template box. For each repository, record the shared
169
+ starting branch for Template setup and new devboxes, the imported branch/commit,
170
+ and which local work to preserve separately in a named stash. Identify approved
171
+ env/config/fixtures that must remain available for setup. The remote agent will
172
+ save the imported work and prepare the selected branch before installing
173
+ dependencies; the local checkout must stay intact. See `guide untracked` for
174
+ the combined branch and local-file review.
175
+ Include install steps that aren't obvious
168
176
  from the repo, known gotchas, and a verification command ("`npm run dev`
169
177
  should serve on :5173"). By default the remote agent preserves tracked project
170
178
  files: if a build or test exposes a code, dependency-manifest, lockfile, or
@@ -33,9 +33,14 @@ Progress streams as timestamped lines — relay the meaningful ones
33
33
  (phase changes, the completion message). A full run typically takes several
34
34
  minutes; remote setup is the long part.
35
35
 
36
- The remote setup agent installs tools and dependencies, places approved config,
37
- and verifies the app. It preserves tracked project files unless `setupNotes`
38
- contains exact, user-approved tracked edits. A project build/test failure is an
36
+ The remote setup agent first saves approved imported work separately, then
37
+ prepares the same starting branch as new devboxes, as recorded in `setupNotes`.
38
+ It will reuse the reviewed choices and ask only about a missing choice or work
39
+ it cannot safely preserve. The handoff will name the saved branch/commit and
40
+ stash, with instructions for resuming that work in a devbox. It then installs
41
+ tools and dependencies, places approved config, and verifies the app. Beyond
42
+ the approved branch checkout, it preserves tracked project files unless `setupNotes`
43
+ contains exact, user-approved edits. A project build/test failure is an
39
44
  honest setup result, not permission to rewrite dependencies, source, or tests.
40
45
 
41
46
  Guards to expect:
@@ -1,12 +1,36 @@
1
1
  # Untracked files and local changes (`untracked`, `localChanges`)
2
2
 
3
- Two toggles that decide what else travels beyond the repo clone and the
4
- named files:
3
+ Review local work together with the starting branch chosen in `guide flow`.
4
+ Inspect the current branch/commit, local-only commits, staged and unstaged
5
+ changes, and the untracked-file list. If the checkout differs from the selected
6
+ branch, ask whether to save that work on boxes.dev for later. This includes a
7
+ clean feature branch, detached HEAD, and edits or local-only commits on the
8
+ selected branch itself. Reuse the user's existing answers and file selections.
9
+
10
+ Explain that Template setup and new devboxes will start on the selected branch.
11
+ Approved work will be preserved on the Template box at its original commit, with
12
+ a named Git stash for staged, unstaged, and selected untracked work. The remote
13
+ agent will provide restore instructions. Saving it in the Template snapshot
14
+ does not involve pushing to a Git remote or applying it onto the setup branch.
15
+ Keep environment/configuration files and fixtures needed for
16
+ setup selected separately, so they remain available in the active checkout.
17
+ Do not stash, switch, or clean the user's local checkout.
18
+
19
+ The repository upload includes Git history and local branch refs, including
20
+ local-only commits. The choices below control uncommitted files, not which
21
+ commits are uploaded. Explain this during review when local-only work exists;
22
+ do not promise to exclude those commits. If the user requires that exclusion,
23
+ resolve the upload scope before launch; these toggles cannot provide it.
24
+
25
+ Use the existing two controls to record the reviewed file choices:
5
26
 
6
27
  ## `localChanges.copyDirty`
7
28
 
8
29
  Whether staged and unstaged edits to tracked files will be copied. The default
9
30
  is true. Set false if the user wants the committed versions of those files.
31
+ This does not select a branch or remove local-only commits. Setting it to false
32
+ does not exclude untracked work; review `untracked.copy` and its rules together
33
+ with this choice. Record the result in `setupNotes` as described in `guide flow`.
10
34
 
11
35
  ## `untracked`
12
36
 
@@ -51,5 +75,6 @@ big folders you propose excluding or force-including. This is a
51
75
  collaboration point — the user may want to edit the globs in the manifest
52
76
  directly.
53
77
 
54
- Done means: the user has seen the numbers and the mode (or globs) reflects
55
- their choice.
78
+ Done means: the user has seen the numbers, the toggles and rules reflect their
79
+ choices, and `setupNotes` tells the remote agent which work to save separately
80
+ and which approved files to keep available for setup.
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]="ebebd7c5-1f84-5a96-97a5-a9c39fb03c96")}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]="56dec66e-dfc5-5fd7-ab6c-6ec0b589ff12")}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";
@@ -70396,9 +70396,9 @@ var init_sentry = __esm({
70396
70396
  uncaughtExceptionMonitorInstalled = false;
70397
70397
  currentDevboxSentryUser = null;
70398
70398
  readBuildMetadata = () => {
70399
- const rawPackageVersion = "1.0.1097";
70400
- const rawGitSha = "d832fb28fb9520f497ad91b0ce4cbc24c9aa34a4";
70401
- const rawSentryRelease = "boxes-dev-dvb@1.0.1097+d832fb28fb9520f497ad91b0ce4cbc24c9aa34a4";
70399
+ const rawPackageVersion = "1.0.1099";
70400
+ const rawGitSha = "5f95fd277d454c1af877aac60a1e8b6cb84e7655";
70401
+ const rawSentryRelease = "boxes-dev-dvb@1.0.1099+5f95fd277d454c1af877aac60a1e8b6cb84e7655";
70402
70402
  const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
70403
70403
  const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
70404
70404
  const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
@@ -74898,12 +74898,13 @@ var init_desktopInitContracts = __esm({
74898
74898
  });
74899
74899
 
74900
74900
  // ../../../../shared/devboxCore/dist/desktopObjectTransfers.js
74901
- var DESKTOP_OBJECT_TRANSFER_MAX_FILE_BYTES, DESKTOP_OBJECT_TRANSFER_MAX_BATCH_BYTES, DESKTOP_OBJECT_TRANSFER_MULTIPART_THRESHOLD_BYTES, DESKTOP_OBJECT_TRANSFER_MULTIPART_PART_SIZE_BYTES, DESKTOP_OBJECT_TRANSFER_UPLOAD_URL_TTL_SECONDS, DESKTOP_OBJECT_TRANSFER_DOWNLOAD_URL_TTL_SECONDS;
74901
+ var DESKTOP_OBJECT_TRANSFER_MAX_FILE_BYTES, DESKTOP_OBJECT_TRANSFER_MAX_BATCH_BYTES, DESKTOP_OBJECT_TRANSFER_IMPORT_TIMEOUT_MS, DESKTOP_OBJECT_TRANSFER_MULTIPART_THRESHOLD_BYTES, DESKTOP_OBJECT_TRANSFER_MULTIPART_PART_SIZE_BYTES, DESKTOP_OBJECT_TRANSFER_UPLOAD_URL_TTL_SECONDS, DESKTOP_OBJECT_TRANSFER_DOWNLOAD_URL_TTL_SECONDS;
74902
74902
  var init_desktopObjectTransfers = __esm({
74903
74903
  "../../../../shared/devboxCore/dist/desktopObjectTransfers.js"() {
74904
74904
  "use strict";
74905
- DESKTOP_OBJECT_TRANSFER_MAX_FILE_BYTES = 1 * 1024 * 1024 * 1024;
74906
- DESKTOP_OBJECT_TRANSFER_MAX_BATCH_BYTES = 2 * 1024 * 1024 * 1024;
74905
+ DESKTOP_OBJECT_TRANSFER_MAX_FILE_BYTES = 5 * 1024 * 1024 * 1024;
74906
+ DESKTOP_OBJECT_TRANSFER_MAX_BATCH_BYTES = 10 * 1024 * 1024 * 1024;
74907
+ DESKTOP_OBJECT_TRANSFER_IMPORT_TIMEOUT_MS = 5 * 60 * 1e3;
74907
74908
  DESKTOP_OBJECT_TRANSFER_MULTIPART_THRESHOLD_BYTES = 100 * 1024 * 1024;
74908
74909
  DESKTOP_OBJECT_TRANSFER_MULTIPART_PART_SIZE_BYTES = 64 * 1024 * 1024;
74909
74910
  DESKTOP_OBJECT_TRANSFER_UPLOAD_URL_TTL_SECONDS = 15 * 60;
@@ -75048,7 +75049,7 @@ so future devboxes will inherit those changes.
75048
75049
  });
75049
75050
 
75050
75051
  // ../../../../shared/devboxCore/dist/remoteSetupPrompt.js
75051
- var REMOTE_SETUP_APPLY_E2B_TEMPLATE, renderTemplate, LEGACY_AGENT_SETUP_BLOCK, ORDINARY_AGENT_SETUP_BLOCK, joinPosixPath, buildRemoteSetupEntrypointsBlock, buildRemoteSetupCompletionBlock, buildRemoteSetupGitConfigReviewBlock, buildRemoteSetupDatabaseRestoreBlock, quotePosixShellArgument, buildTemplateMaintenanceValidationCommand, buildRemoteSetupTemplateMaintenanceBlock, getSurfacePromptValues, renderRemoteSetupApplyPrompt;
75052
+ var REMOTE_SETUP_APPLY_E2B_TEMPLATE, renderTemplate, LEGACY_AGENT_SETUP_BLOCK, ORDINARY_AGENT_SETUP_BLOCK, REPOSITORY_SETUP_BLOCK, joinPosixPath, buildRemoteSetupEntrypointsBlock, buildRemoteSetupCompletionBlock, buildRemoteSetupGitConfigReviewBlock, buildRemoteSetupDatabaseRestoreBlock, quotePosixShellArgument, buildTemplateMaintenanceValidationCommand, buildRemoteSetupTemplateMaintenanceBlock, getSurfacePromptValues, renderRemoteSetupApplyPrompt;
75052
75053
  var init_remoteSetupPrompt = __esm({
75053
75054
  "../../../../shared/devboxCore/dist/remoteSetupPrompt.js"() {
75054
75055
  "use strict";
@@ -75195,6 +75196,7 @@ Then apply the setup plan in \`{{setup_path}}\`:
75195
75196
  - Read the whole setup plan before changing the machine. If it has a non-empty
75196
75197
  \`agentInstructions\` field, treat that as user-provided setup guidance and
75197
75198
  follow it unless it conflicts with these safety instructions.
75199
+ {{repository_setup_block}}
75198
75200
  - Install required tools/runtimes that are listed.
75199
75201
  - Prefer project-local installs (e.g., package manager installs in the project or the relevant indexed repo) over global installs.
75200
75202
  - Run setup commands in the project root unless the plan specifies another path. If a command targets a child repo, run it from that repo's relative path.
@@ -75263,6 +75265,50 @@ assistant response in this thread. Do not put this user-facing response in
75263
75265
  - This is a regular Codex or Claude Code thread using the user's connected account.
75264
75266
  - Configure Codex MCP servers in the normal Codex home at \`/home/boxes/.codex\` and Claude MCP servers in Claude's normal user configuration.
75265
75267
  - Newly configured MCP tools may require a fresh or restarted agent process.`;
75268
+ REPOSITORY_SETUP_BLOCK = `- Before installing dependencies or running project commands, read the branch
75269
+ and local-work choices in \`agentInstructions\` and inspect each imported
75270
+ repository. One selected starting branch governs both Template setup and new
75271
+ devboxes. Saving imported work is a separate choice; it must not change that
75272
+ starting branch or leave unfinished work active during setup.
75273
+ - Reuse choices already recorded in the plan or thread, including the reviewed
75274
+ dirty/untracked-file selections. Ask only for missing decisions: which
75275
+ starting branch to use, recommending the actual remote default (often
75276
+ \`main\` or \`master\`), and which imported work to save separately. Differences
75277
+ include another branch, detached HEAD, local-only commits, and staged,
75278
+ unstaged, or untracked changes, even on the selected branch itself.
75279
+ Choosing the imported feature branch still requires saving its unfinished
75280
+ files separately. Do not offer to leave unstashed work active during setup.
75281
+ - Before switching branches, preserve approved imported work on this Template
75282
+ box for inclusion in its snapshot. This is what saving work on boxes.dev
75283
+ means; do not push it to a Git remote or ask for publication as part of setup.
75284
+ Keep its original commit reachable through a branch; create a clearly
75285
+ named saved-work branch if HEAD is detached or the selected branch name must
75286
+ move away from local commits. Save staged, unstaged, and selected untracked
75287
+ work in a clearly named Git stash, preserving the index. Keep approved
75288
+ environment/configuration files, fixtures, and setup artifacts available for
75289
+ setup; do not sweep them into the stash with unfinished work. Record the
75290
+ original commit, saved branch, and stash commit for the handoff. Do not create
75291
+ an empty stash when there are no unfinished files.
75292
+ - Then prepare the selected starting branch. For a remote branch, fetch it and
75293
+ verify that the checkout is on that branch at the fetched commit, with the
75294
+ imported work saved separately. For an explicitly approved local-only branch,
75295
+ use its clean committed state and the matching snapshot-based new-devbox
75296
+ choice; do not invent or publish a remote branch. Keep maintenance on the
75297
+ same selected branch. Branch preparation is part of setup, not permission to
75298
+ edit source or dependencies to make tests pass.
75299
+ - Do not discard unpreserved changes or commits, apply saved work onto the
75300
+ setup branch, or modify the source computer's checkout. If preservation or
75301
+ checkout cannot follow the reviewed plan, explain the specific conflict and
75302
+ ask about it. Saving included work as approved does not need another review.
75303
+ - Checking out the branch here does not configure new-devbox defaults. Verify
75304
+ both against the reviewed plan. If a choice is missing or changes remotely,
75305
+ reconcile the saved default through the documented setup controls before
75306
+ completing setup; if unavailable, report the required change and wait.
75307
+ - Report the shared starting branch and any saved work in the setup summary.
75308
+ Give the saved branch/original commit and stash commit, with instructions to
75309
+ resume in a devbox from that original commit and apply the stash with
75310
+ \`git stash apply --index\`. Leave the Template checkout on the selected
75311
+ branch; never restore the saved work there just to demonstrate recovery.`;
75266
75312
  joinPosixPath = (base, relative2) => `${base.replace(/\/+$/u, "")}/${relative2.replace(/^\/+/u, "")}`;
75267
75313
  buildRemoteSetupEntrypointsBlock = (entrypoints) => {
75268
75314
  if (entrypoints.length === 0)
@@ -75447,6 +75493,7 @@ below.`;
75447
75493
  final_response_block: renderSetupFinalResponsePrompt("automatic"),
75448
75494
  git_config_review_block: buildRemoteSetupGitConfigReviewBlock(gitConfigReviewPath),
75449
75495
  agent_setup_block: agentRuntime === "ordinary" ? ORDINARY_AGENT_SETUP_BLOCK : LEGACY_AGENT_SETUP_BLOCK,
75496
+ repository_setup_block: agentRuntime === "ordinary" ? REPOSITORY_SETUP_BLOCK : "",
75450
75497
  interaction_guidance: agentRuntime === "ordinary" ? "- Ask the user in this thread when setup needs their input." : "- This run is non-interactive; do not rely on Ctrl-C.",
75451
75498
  setup_completion_block: buildRemoteSetupCompletionBlock(completionMode, setupTodoPath),
75452
75499
  database_restore_block: buildRemoteSetupDatabaseRestoreBlock({
@@ -75907,7 +75954,7 @@ var init_packageVersion = __esm({
75907
75954
  return path18.join(process.cwd(), "dvb");
75908
75955
  };
75909
75956
  readEmbeddedPackageVersion = () => {
75910
- const raw = "1.0.1097";
75957
+ const raw = "1.0.1099";
75911
75958
  return trimVersion(raw);
75912
75959
  };
75913
75960
  readNearestPackageMetadata = (basePath) => {
@@ -139785,7 +139832,7 @@ var init_checkpoint = __esm({
139785
139832
  }) => {
139786
139833
  const trimmedTarget = target.trim();
139787
139834
  if (!trimmedTarget) {
139788
- throw new Error("Machine alias is required.");
139835
+ throw new Error("Template box name is required.");
139789
139836
  }
139790
139837
  return instances2.find((entry) => entry.alias === trimmedTarget) ?? instances2.find((entry) => entry.providerInstanceId === trimmedTarget) ?? null;
139791
139838
  };
@@ -139821,18 +139868,18 @@ var init_checkpoint = __esm({
139821
139868
  const { controlPlaneToken } = await resolveE2bCommandContext({
139822
139869
  stage: (message) => status.stage(message)
139823
139870
  });
139824
- status.stage("Resolving machine");
139871
+ status.stage("Finding Template box");
139825
139872
  const instances2 = await listViewerInstances(controlPlaneToken);
139826
139873
  const resolved = resolveTargetInstance({ instances: instances2, target });
139827
139874
  if (!resolved) {
139828
- throw new Error(`Unknown machine: ${target}`);
139875
+ throw new Error(`Unknown box: ${target}`);
139829
139876
  }
139830
139877
  if (resolved.provider !== "e2b") {
139831
139878
  throw new Error(
139832
- "`dvb checkpoint` is currently only supported for checkpoint-enabled machines."
139879
+ "Use `dvb checkpoint` with your project's Template box to take a snapshot."
139833
139880
  );
139834
139881
  }
139835
- status.stage(`Creating checkpoint for ${resolved.alias}`);
139882
+ status.stage(`Taking snapshot of ${resolved.alias}`);
139836
139883
  const result = await createManagedCheckpoint(
139837
139884
  controlPlaneToken,
139838
139885
  resolved.alias
@@ -139840,7 +139887,7 @@ var init_checkpoint = __esm({
139840
139887
  const record3 = result[0];
139841
139888
  const checkpointId = record3 ? extractCheckpointId(record3) : null;
139842
139889
  if (!record3 || !checkpointId) {
139843
- throw new Error("Managed checkpoint response did not include an id.");
139890
+ throw new Error("The snapshot response did not include an ID.");
139844
139891
  }
139845
139892
  status.stop();
139846
139893
  if (parsed.json) {
@@ -139859,7 +139906,7 @@ var init_checkpoint = __esm({
139859
139906
  );
139860
139907
  return;
139861
139908
  }
139862
- console.log(`checkpoint created: ${resolved.alias} (${checkpointId})`);
139909
+ console.log(`Snapshot created: ${resolved.alias} (${checkpointId})`);
139863
139910
  };
139864
139911
  try {
139865
139912
  await run2();
@@ -141851,6 +141898,7 @@ var init_threadInventoryBuilder = __esm({
141851
141898
  forkOperationId: null,
141852
141899
  isFork: false,
141853
141900
  forkState: null,
141901
+ forkPlacementArchived: false,
141854
141902
  forkProgressStage: null,
141855
141903
  forkExecutionStatusTone: null,
141856
141904
  forkBaseCommitSha: null,
@@ -141879,6 +141927,7 @@ var init_threadInventoryBuilder = __esm({
141879
141927
  cwd: null,
141880
141928
  path: normalizeText2(thread.sessionPath),
141881
141929
  isArchived: thread.archivedAt !== null,
141930
+ archivedDevbox: thread.archivedDevbox ?? null,
141882
141931
  notificationsMuted: thread.notificationsMuted,
141883
141932
  storageState: resolveThreadStorageState(thread.storageState),
141884
141933
  nativeBundleStatus: resolveThreadNativeBundleStatus(
@@ -141981,6 +142030,7 @@ var init_threadInventoryBuilder = __esm({
141981
142030
  row.forkOperationId = placement.operationId;
141982
142031
  row.isFork = true;
141983
142032
  row.forkState = placement.state;
142033
+ row.forkPlacementArchived = placement.archivedAt !== null;
141984
142034
  row.forkProgressStage = placement.progressStage;
141985
142035
  row.forkMode = placement.mode;
141986
142036
  row.forkBaseCommitSha = normalizeText2(placement.forkBaseCommitSha);
@@ -142306,7 +142356,8 @@ var init_forkThreadGroups = __esm({
142306
142356
  resolveMinimumGroupSize = (anchorRow) => anchorRow.devboxName === null ? 2 : 1;
142307
142357
  buildForkThreadGroupMap = ({
142308
142358
  rows,
142309
- resolveTitle
142359
+ resolveTitle,
142360
+ archiveLayout = null
142310
142361
  }) => {
142311
142362
  const childrenByPlacementId = /* @__PURE__ */ new Map();
142312
142363
  for (const row of rows) {
@@ -142325,9 +142376,10 @@ var init_forkThreadGroups = __esm({
142325
142376
  if (!anchorRow || anchorRow.forkAnchorClientThreadId === null) {
142326
142377
  continue;
142327
142378
  }
142328
- const section = resolveGroupSection(anchorRow);
142329
- const sectionChildren = resolveGroupChildrenForSection(children, section);
142330
- if (sectionChildren.length < resolveMinimumGroupSize(anchorRow)) {
142379
+ const section = archiveLayout ? anchorRow.isPinned ? "pinned" : "recent" : resolveGroupSection(anchorRow);
142380
+ const sectionChildren = archiveLayout ? children.filter((row) => !row.isArchived) : resolveGroupChildrenForSection(children, section);
142381
+ const minimumGroupSize = archiveLayout && (anchorRow.isArchived || archiveLayout.hasArchivedThreads(anchorRow.executionInstanceId)) ? 0 : resolveMinimumGroupSize(anchorRow);
142382
+ if (sectionChildren.length < minimumGroupSize) {
142331
142383
  continue;
142332
142384
  }
142333
142385
  const sortedChildren = sortGroupChildren(sectionChildren, anchorRow);
@@ -142340,8 +142392,8 @@ var init_forkThreadGroups = __esm({
142340
142392
  devboxName: anchorRow.devboxName,
142341
142393
  anchorRow,
142342
142394
  children: sortedChildren,
142343
- additionalThreadCount: sortedChildren.length - 1,
142344
- updatedAtMs: Math.max(...sortedChildren.map((row) => row.updatedAtMs)),
142395
+ additionalThreadCount: Math.max(sortedChildren.length - 1, 0),
142396
+ updatedAtMs: sortedChildren.length > 0 ? Math.max(...sortedChildren.map((row) => row.updatedAtMs)) : anchorRow.updatedAtMs,
142345
142397
  isPinned: anchorRow.isPinned,
142346
142398
  pinOrder: anchorRow.pinOrder,
142347
142399
  isArchived: section === "archived",
@@ -142358,11 +142410,13 @@ var init_forkThreadGroups = __esm({
142358
142410
  allRows,
142359
142411
  sectionRows,
142360
142412
  section,
142361
- resolveTitle
142413
+ resolveTitle,
142414
+ archiveLayout = null
142362
142415
  }) => {
142363
142416
  const groupsByPlacementId = buildForkThreadGroupMap({
142364
142417
  rows: allRows,
142365
- resolveTitle
142418
+ resolveTitle,
142419
+ archiveLayout
142366
142420
  });
142367
142421
  const emittedPlacementIds = /* @__PURE__ */ new Set();
142368
142422
  const entries = [];
@@ -142419,6 +142473,14 @@ var init_threadArchiveEligibility = __esm({
142419
142473
  }
142420
142474
  });
142421
142475
 
142476
+ // ../../../../shared/threadRuntime/threadArchiveGroups.ts
142477
+ var init_threadArchiveGroups = __esm({
142478
+ "../../../../shared/threadRuntime/threadArchiveGroups.ts"() {
142479
+ "use strict";
142480
+ init_threadColdStorage();
142481
+ }
142482
+ });
142483
+
142422
142484
  // ../../../../shared/threadRuntime/cliAgentViewContract.ts
142423
142485
  var CLI_AGENT_VIEW_CONTRACT_VERSION, CLI_AGENT_VIEW_PROJECT_CONTRACT_VERSION, CLI_AGENT_VIEW_WINDOW_CONTRACT_VERSION, CLI_AGENT_VIEW_PEEK_CONTRACT_VERSION, CLI_AGENT_VIEW_PRESENCE_SHARD_SIZE, CLI_AGENT_VIEW_PROMPT_MAX_UTF8_BYTES, CLI_AGENT_VIEW_NO_SNAPSHOT_MESSAGE, adaptCliAgentViewProjectSummaryV2;
142424
142486
  var init_cliAgentViewContract = __esm({
@@ -143755,6 +143817,7 @@ var init_threadInventory = __esm({
143755
143817
  init_threadInventoryBuilder();
143756
143818
  init_forkThreadGroups();
143757
143819
  init_threadArchiveEligibility();
143820
+ init_threadArchiveGroups();
143758
143821
  init_cliAgentViewContract();
143759
143822
  init_cliAgentViewImages();
143760
143823
  init_storageUploadTargets();
@@ -222039,7 +222102,7 @@ var init_creationPresentation = __esm({
222039
222102
  "use strict";
222040
222103
  init_threadInventory();
222041
222104
  FAILURE_COPY = {
222042
- machine_unavailable: "The selected machine is unavailable. Review its status and try again.",
222105
+ machine_unavailable: "The selected box is unavailable. Review its status and try again.",
222043
222106
  unsupported_machine: "This machine needs a boxes.dev service update before it can start threads.",
222044
222107
  machine_creation_failed: "The devbox could not be created. Review its status and try again.",
222045
222108
  billing_attention: "Billing activation is required before this devbox can be created.",
@@ -266264,6 +266327,19 @@ var init_seed = __esm({
266264
266327
  push(
266265
266328
  "# Copy uncommitted local changes (dirty worktree) to the Template box?"
266266
266329
  );
266330
+ push("# TODO(agent): ask for one starting branch for Template setup and new");
266331
+ push(
266332
+ "# devboxes, recommending the remote default (guide: flow). Review local"
266333
+ );
266334
+ push(
266335
+ "# work with untracked files below (guide: untracked); included work will"
266336
+ );
266337
+ push("# be saved separately before setup. Record the choices in setupNotes,");
266338
+ push("# align lifecycle/maintenance branches, then remove this marker.");
266339
+ push(
266340
+ "# Keep the local checkout intact; branch preparation happens remotely."
266341
+ );
266342
+ push("# copyDirty does not choose a branch or exclude local-only commits.");
266267
266343
  push(
266268
266344
  `localChanges: # ${formatSizeNote(dirtyFileCount)} changed file(s) detected`
266269
266345
  );
@@ -266421,7 +266497,9 @@ var init_seed = __esm({
266421
266497
  push("");
266422
266498
  push("# Template box maintenance, recommended for most projects. Design the");
266423
266499
  push("# script and GitHub watch paths together: watch lockfiles and tooling");
266424
- push("# files, not application source. The script fast-forwards the default");
266500
+ push(
266501
+ "# files, not application source. The script fast-forwards the selected"
266502
+ );
266425
266503
  push(
266426
266504
  "# branch, installs without prompts, and fails clearly on local changes"
266427
266505
  );
@@ -266441,6 +266519,9 @@ var init_seed = __esm({
266441
266519
  push(
266442
266520
  "# on the Template box (install steps, gotchas, verification commands)."
266443
266521
  );
266522
+ push(
266523
+ "# Include each starting branch and which local work to save separately."
266524
+ );
266444
266525
  push("# Tracked project files stay unchanged unless exact edits are written");
266445
266526
  push("# here and explicitly approved by the user during review.");
266446
266527
  push("# TODO(agent): write brief setup guidance once investigation is done.");
@@ -301252,4 +301333,4 @@ react/cjs/react-jsx-runtime.development.js:
301252
301333
  *)
301253
301334
  */
301254
301335
 
301255
- //# debugId=ebebd7c5-1f84-5a96-97a5-a9c39fb03c96
301336
+ //# debugId=56dec66e-dfc5-5fd7-ab6c-6ec0b589ff12
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]="57feb75d-01ce-5c1b-85e0-5a03f16ca546")}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]="421b351a-0bea-571c-97d8-cc0f726016b9")}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.1097";
64679
- const rawGitSha = "d832fb28fb9520f497ad91b0ce4cbc24c9aa34a4";
64680
- const rawSentryRelease = "boxes-dev-dvb@1.0.1097+d832fb28fb9520f497ad91b0ce4cbc24c9aa34a4";
64678
+ const rawPackageVersion = "1.0.1099";
64679
+ const rawGitSha = "5f95fd277d454c1af877aac60a1e8b6cb84e7655";
64680
+ const rawSentryRelease = "boxes-dev-dvb@1.0.1099+5f95fd277d454c1af877aac60a1e8b6cb84e7655";
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;
@@ -66773,12 +66773,13 @@ var init_desktopInitContracts = __esm({
66773
66773
  });
66774
66774
 
66775
66775
  // ../../../../shared/devboxCore/dist/desktopObjectTransfers.js
66776
- var DESKTOP_OBJECT_TRANSFER_MAX_FILE_BYTES, DESKTOP_OBJECT_TRANSFER_MAX_BATCH_BYTES, DESKTOP_OBJECT_TRANSFER_MULTIPART_THRESHOLD_BYTES, DESKTOP_OBJECT_TRANSFER_MULTIPART_PART_SIZE_BYTES, DESKTOP_OBJECT_TRANSFER_UPLOAD_URL_TTL_SECONDS, DESKTOP_OBJECT_TRANSFER_DOWNLOAD_URL_TTL_SECONDS;
66776
+ var DESKTOP_OBJECT_TRANSFER_MAX_FILE_BYTES, DESKTOP_OBJECT_TRANSFER_MAX_BATCH_BYTES, DESKTOP_OBJECT_TRANSFER_IMPORT_TIMEOUT_MS, DESKTOP_OBJECT_TRANSFER_MULTIPART_THRESHOLD_BYTES, DESKTOP_OBJECT_TRANSFER_MULTIPART_PART_SIZE_BYTES, DESKTOP_OBJECT_TRANSFER_UPLOAD_URL_TTL_SECONDS, DESKTOP_OBJECT_TRANSFER_DOWNLOAD_URL_TTL_SECONDS;
66777
66777
  var init_desktopObjectTransfers = __esm({
66778
66778
  "../../../../shared/devboxCore/dist/desktopObjectTransfers.js"() {
66779
66779
  "use strict";
66780
- DESKTOP_OBJECT_TRANSFER_MAX_FILE_BYTES = 1 * 1024 * 1024 * 1024;
66781
- DESKTOP_OBJECT_TRANSFER_MAX_BATCH_BYTES = 2 * 1024 * 1024 * 1024;
66780
+ DESKTOP_OBJECT_TRANSFER_MAX_FILE_BYTES = 5 * 1024 * 1024 * 1024;
66781
+ DESKTOP_OBJECT_TRANSFER_MAX_BATCH_BYTES = 10 * 1024 * 1024 * 1024;
66782
+ DESKTOP_OBJECT_TRANSFER_IMPORT_TIMEOUT_MS = 5 * 60 * 1e3;
66782
66783
  DESKTOP_OBJECT_TRANSFER_MULTIPART_THRESHOLD_BYTES = 100 * 1024 * 1024;
66783
66784
  DESKTOP_OBJECT_TRANSFER_MULTIPART_PART_SIZE_BYTES = 64 * 1024 * 1024;
66784
66785
  DESKTOP_OBJECT_TRANSFER_UPLOAD_URL_TTL_SECONDS = 15 * 60;
@@ -66894,7 +66895,7 @@ var init_packageVersion = __esm({
66894
66895
  return path8.join(process.cwd(), "dvb");
66895
66896
  };
66896
66897
  readEmbeddedPackageVersion = () => {
66897
- const raw = "1.0.1097";
66898
+ const raw = "1.0.1099";
66898
66899
  return trimVersion(raw);
66899
66900
  };
66900
66901
  readNearestPackageMetadata = (basePath) => {
@@ -80047,4 +80048,4 @@ smol-toml/dist/index.js:
80047
80048
  *)
80048
80049
  */
80049
80050
 
80050
- //# debugId=57feb75d-01ce-5c1b-85e0-5a03f16ca546
80051
+ //# debugId=421b351a-0bea-571c-97d8-cc0f726016b9
@@ -50,8 +50,7 @@ returned `nextActions` when they apply.
50
50
 
51
51
  Public data is intentionally compact. Project rows contain `name`,
52
52
  `fingerprint`, `canonicalWorkdir`, an optional project `kind`, and an optional
53
- setup warning with its recovery action. Older CLI releases safely omit Team
54
- Template member projects. Template-box/devbox rows contain
53
+ setup warning with its recovery action. Older CLI releases safely omit managed projects. Template-box/devbox rows contain
55
54
  `instanceId`, server-generated `name`, `kind`, coarse `status`,
56
55
  `canonicalWorkdir`, and `lastActivityAt`. Thread rows contain
57
56
  `clientThreadId`, `agent`, `executionInstanceId`, title, action-oriented
@@ -71,12 +70,12 @@ dvb projects lifecycle set --project <project-fingerprint> \
71
70
  ```
72
71
 
73
72
  Script inputs come from local files. Startup and teardown timeouts accept
74
- 1–120 seconds, and clear flags remove either script. A Team Template member
73
+ 1–120 seconds, and clear flags remove either script. A managed
75
74
  project supports these project-owned lifecycle defaults. After
76
75
  `configuration_conflict`, read and reconcile the newer state; never overwrite
77
76
  it with the stale revision.
78
77
 
79
- For an ordinary project with a personal Template box, configure the maintenance
78
+ For an independent project with a personal Template box, configure the maintenance
80
79
  script and complete GitHub watch set as one unit:
81
80
 
82
81
  ```bash
@@ -92,7 +91,7 @@ exact repository-relative file or directory paths, not globs. Omitted editable
92
91
  watches are removals and need explicit confirmation; read-only watches remain
93
92
  unchanged. The write preserves the current repeating schedule. New, changed,
94
93
  or re-enabled watches receive a fresh default-branch baseline and do not start
95
- a run. Team Template member projects return
94
+ a run. Managed projects return
96
95
  `template_maintenance_unavailable` rather than changing their shared Team
97
96
  Template.
98
97
 
@@ -141,7 +140,7 @@ same failed operation.
141
140
 
142
141
  This workflow creates a devbox from the project's current reusable source
143
142
  without creating a draft, conversation, or agent thread. That source is an
144
- ordinary project's Template-box snapshot or a Team Template member project's
143
+ independent project's Template-box snapshot or a managed project's
145
144
  current saved version. It is CLI/agent-only for now.
146
145
 
147
146
  ## Run One-Off Work
@@ -201,7 +200,7 @@ flow; it is different from `devboxes create`, which creates a devbox without
201
200
  starting an agent thread. Starting the first thread on a devbox from
202
201
  `devboxes create` will adopt that devbox: the thread becomes its anchor thread
203
202
  and the devbox then appears and behaves like any other devbox in the desktop
204
- and mobile apps. A Team Template member project accepts `new-devbox`
203
+ and mobile apps. A managed project accepts `new-devbox`
205
204
  and exact existing devboxes but rejects `template` because it has no personal
206
205
  Template box.
207
206
  Use exactly one of `--prompt`, `--prompt-file`, or `--stdin`. Thread start
@@ -25,8 +25,8 @@ An automation has:
25
25
  - run history.
26
26
 
27
27
  By default, automation runs start new devboxes from the same reusable source as ordinary
28
- threads. For an ordinary project, that is the latest Template-box snapshot. For
29
- a Team Template member project, it is the Team Template's current saved
28
+ threads. For an independent project, that is the latest Template-box snapshot. For
29
+ a managed project, it is the Team Template's current saved
30
30
  version. Keep the source current when future automation runs need new
31
31
  dependencies, generated files, or shared setup changes.
32
32
 
@@ -310,8 +310,8 @@ number of inactive days, or after a chosen number of newer eligible runs have
310
310
  finished. Cleanup preserves the run thread directly in cold storage and
311
311
  destroys its devbox; the automation run remains in run history and its archived
312
312
  thread can still be opened without waking a machine. Restore the thread
313
- explicitly if it needs to continue. Ordinary projects can restore it to a new
314
- devbox or the Template box; Team Template member projects restore it only to a
313
+ explicitly if it needs to continue. Independent projects can restore it to a new
314
+ devbox or the Template box; managed projects restore it only to a
315
315
  new devbox.
316
316
 
317
317
  If boxes.dev must wake a sleeping devbox only to inspect or archive it for