@boxes-dev/dvb-runtime 1.0.1025 → 1.0.1027
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/bin/dvb.mjs +125 -41
- package/dist/bin/dvbd.mjs +6 -6
- package/dist/product-docs/references/automations.md +34 -3
- package/dist/product-docs/references/cli.md +3 -1
- package/dist/product-docs/references/desktop-workbench.md +5 -3
- package/dist/product-docs/references/fork-workflows.md +11 -0
- package/dist/product-docs/references/mobile.md +2 -0
- package/dist/product-docs/references/onbox-agent-tools.md +139 -9
- package/dist/product-docs/references/project-setup.md +14 -8
- package/dist/product-docs/references/threads-and-agents.md +9 -8
- package/dist/product-docs/references/troubleshooting.md +12 -0
- package/package.json +2 -2
package/dist/bin/dvb.mjs
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
|
|
3
|
-
!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="
|
|
3
|
+
!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b4d75a4b-c5e3-5e9c-8629-a7af77ccf4b0")}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";
|
|
@@ -101146,8 +101146,8 @@ var init_otel = __esm({
|
|
|
101146
101146
|
return trimmed && trimmed.length > 0 ? trimmed : void 0;
|
|
101147
101147
|
};
|
|
101148
101148
|
readBuildMetadata = () => {
|
|
101149
|
-
const rawPackageVersion = "1.0.
|
|
101150
|
-
const rawGitSha = "
|
|
101149
|
+
const rawPackageVersion = "1.0.1027";
|
|
101150
|
+
const rawGitSha = "b1de1456a00a8cf396a793db03b3095cf40cf93a";
|
|
101151
101151
|
const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
|
|
101152
101152
|
const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
|
|
101153
101153
|
return { packageVersion, gitSha };
|
|
@@ -133553,9 +133553,9 @@ var init_sentry = __esm({
|
|
|
133553
133553
|
uncaughtExceptionMonitorInstalled = false;
|
|
133554
133554
|
currentDevboxSentryUser = null;
|
|
133555
133555
|
readBuildMetadata2 = () => {
|
|
133556
|
-
const rawPackageVersion = "1.0.
|
|
133557
|
-
const rawGitSha = "
|
|
133558
|
-
const rawSentryRelease = "boxes-dev-dvb@1.0.
|
|
133556
|
+
const rawPackageVersion = "1.0.1027";
|
|
133557
|
+
const rawGitSha = "b1de1456a00a8cf396a793db03b3095cf40cf93a";
|
|
133558
|
+
const rawSentryRelease = "boxes-dev-dvb@1.0.1027+b1de1456a00a8cf396a793db03b3095cf40cf93a";
|
|
133559
133559
|
const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
|
|
133560
133560
|
const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
|
|
133561
133561
|
const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
|
|
@@ -138773,7 +138773,7 @@ var init_packageVersion = __esm({
|
|
|
138773
138773
|
return path17.join(process.cwd(), "dvb");
|
|
138774
138774
|
};
|
|
138775
138775
|
readEmbeddedPackageVersion = () => {
|
|
138776
|
-
const raw = "1.0.
|
|
138776
|
+
const raw = "1.0.1027";
|
|
138777
138777
|
return trimVersion(raw);
|
|
138778
138778
|
};
|
|
138779
138779
|
readNearestPackageMetadata = (basePath) => {
|
|
@@ -204824,6 +204824,7 @@ var init_threadInventoryBuilder = __esm({
|
|
|
204824
204824
|
forkAnchorClientThreadId: null,
|
|
204825
204825
|
devboxFolderId: null,
|
|
204826
204826
|
devboxFolderRevision: 0,
|
|
204827
|
+
devboxName: null,
|
|
204827
204828
|
ownsForkPlacement: false,
|
|
204828
204829
|
forkOperationId: null,
|
|
204829
204830
|
isFork: false,
|
|
@@ -204951,6 +204952,7 @@ var init_threadInventoryBuilder = __esm({
|
|
|
204951
204952
|
row.devboxFolderRevision = normalizeDevboxFolderRevision(
|
|
204952
204953
|
placement.devboxFolderRevision
|
|
204953
204954
|
);
|
|
204955
|
+
row.devboxName = normalizeText2(placement.devboxName);
|
|
204954
204956
|
row.ownsForkPlacement = ownsForkPlacement;
|
|
204955
204957
|
row.forkOperationId = placement.operationId;
|
|
204956
204958
|
row.isFork = true;
|
|
@@ -205250,7 +205252,7 @@ var init_threadInventoryBuilder = __esm({
|
|
|
205250
205252
|
});
|
|
205251
205253
|
|
|
205252
205254
|
// ../../../../shared/threadRuntime/forkThreadGroups.ts
|
|
205253
|
-
var compareChildRows, resolveGroupSection, resolveGroupChildrenForSection, sortGroupChildren, isForkThreadChildRow, buildForkThreadGroupMap, buildForkThreadListEntries;
|
|
205255
|
+
var compareChildRows, resolveGroupSection, resolveGroupChildrenForSection, sortGroupChildren, isForkThreadChildRow, resolveMinimumGroupSize, buildForkThreadGroupMap, buildForkThreadListEntries;
|
|
205254
205256
|
var init_forkThreadGroups = __esm({
|
|
205255
205257
|
"../../../../shared/threadRuntime/forkThreadGroups.ts"() {
|
|
205256
205258
|
"use strict";
|
|
@@ -205272,6 +205274,7 @@ var init_forkThreadGroups = __esm({
|
|
|
205272
205274
|
...children.filter((row) => row.key !== anchorRow.key).sort(compareChildRows)
|
|
205273
205275
|
];
|
|
205274
205276
|
isForkThreadChildRow = (row) => row.forkAnchorPlacementId !== null && row.executionInstanceId !== row.primaryInstanceId;
|
|
205277
|
+
resolveMinimumGroupSize = (anchorRow) => anchorRow.devboxName === null ? 2 : 1;
|
|
205275
205278
|
buildForkThreadGroupMap = ({
|
|
205276
205279
|
rows,
|
|
205277
205280
|
resolveTitle
|
|
@@ -205287,9 +205290,6 @@ var init_forkThreadGroups = __esm({
|
|
|
205287
205290
|
}
|
|
205288
205291
|
const groupsByPlacementId = /* @__PURE__ */ new Map();
|
|
205289
205292
|
for (const [placementId, children] of childrenByPlacementId) {
|
|
205290
|
-
if (children.length < 2) {
|
|
205291
|
-
continue;
|
|
205292
|
-
}
|
|
205293
205293
|
const anchorRow = children.find((row) => row.ownsForkPlacement) ?? children.find(
|
|
205294
205294
|
(row) => row.clientThreadId === row.forkAnchorClientThreadId
|
|
205295
205295
|
);
|
|
@@ -205298,7 +205298,7 @@ var init_forkThreadGroups = __esm({
|
|
|
205298
205298
|
}
|
|
205299
205299
|
const section = resolveGroupSection(anchorRow);
|
|
205300
205300
|
const sectionChildren = resolveGroupChildrenForSection(children, section);
|
|
205301
|
-
if (sectionChildren.length <
|
|
205301
|
+
if (sectionChildren.length < resolveMinimumGroupSize(anchorRow)) {
|
|
205302
205302
|
continue;
|
|
205303
205303
|
}
|
|
205304
205304
|
const sortedChildren = sortGroupChildren(sectionChildren, anchorRow);
|
|
@@ -205307,7 +205307,8 @@ var init_forkThreadGroups = __esm({
|
|
|
205307
205307
|
forkAnchorPlacementId: placementId,
|
|
205308
205308
|
forkAnchorClientThreadId: anchorRow.forkAnchorClientThreadId,
|
|
205309
205309
|
executionInstanceId: anchorRow.executionInstanceId,
|
|
205310
|
-
title: resolveTitle(anchorRow),
|
|
205310
|
+
title: anchorRow.devboxName ?? resolveTitle(anchorRow),
|
|
205311
|
+
devboxName: anchorRow.devboxName,
|
|
205311
205312
|
anchorRow,
|
|
205312
205313
|
children: sortedChildren,
|
|
205313
205314
|
additionalThreadCount: sortedChildren.length - 1,
|
|
@@ -206814,7 +206815,7 @@ var init_projectSelection = __esm({
|
|
|
206814
206815
|
});
|
|
206815
206816
|
|
|
206816
206817
|
// src/devbox/agentView/queryRefs.ts
|
|
206817
|
-
var getAgentViewCreationOptionsV1, getAgentViewCreationExecutionDefaultsV1, setAgentViewCreationExecutionDefaultV1, setAgentViewCreationAgentDefaultV1, getAgentViewCreateContextV1, createAgentViewDraftV1, discardAgentViewDraftV1, getAgentViewDraftForEditV1, setAgentViewComposerDraftText, setAgentViewFailedStartDraftTextV1, updateAgentViewDraftBackendV1, prewarmAgentViewDraftV1, startAgentViewTextThreadV2, createAgentViewImageUploadTargets, discardAgentViewImageUploads, kickoffAgentViewThreadStartV1, getAgentViewCreationStatusV1, getAgentViewEmptyNativeThreadStatusV1, startAgentViewEmptyNativeThreadV1, createAndStartAgentViewEmptyNativeThreadV1, listAgentViewProjectsV1, listAgentViewProjectsV2, getAgentViewProjectWindowV1, getAgentViewProjectWindowV2, getAgentViewProjectPresenceV1, getAgentViewThreadPeekBindingV1, loadAgentViewThreadPeekV1, markAgentViewThreadPeekViewedV1, resolveAgentViewTargetV1, resolveAgentViewNativeThreadV1, markAgentViewThreadViewed, loadAgentViewProjectPageV1, loadAgentViewProjectPageV2, retryAgentViewEmptyNativeThreadV1, discardAgentViewEmptyNativeThreadV1, pinAgentViewThread, unpinAgentViewThread, setAgentViewThreadTitle, clearAgentViewThreadTitle, archiveAgentViewTemplateThreadMetadata, archiveAgentViewSecondaryThreadMetadata, unarchiveAgentViewTemplateThreadMetadata, unarchiveAgentViewSecondaryThreadMetadata, restoreAgentViewColdThread;
|
|
206818
|
+
var getAgentViewCreationOptionsV1, getAgentViewCreationExecutionDefaultsV1, setAgentViewCreationExecutionDefaultV1, setAgentViewCreationAgentDefaultV1, getAgentViewCreateContextV1, createAgentViewDraftV1, discardAgentViewDraftV1, getAgentViewDraftForEditV1, setAgentViewComposerDraftText, setAgentViewFailedStartDraftTextV1, updateAgentViewDraftBackendV1, prewarmAgentViewDraftV1, startAgentViewTextThreadV2, createAgentViewImageUploadTargets, discardAgentViewImageUploads, kickoffAgentViewThreadStartV1, getAgentViewCreationStatusV1, getAgentViewEmptyNativeThreadStatusV1, startAgentViewEmptyNativeThreadV1, createAndStartAgentViewEmptyNativeThreadV1, listAgentViewProjectsV1, listAgentViewProjectsV2, getAgentViewProjectWindowV1, getAgentViewProjectWindowV2, getAgentViewProjectPresenceV1, getAgentViewThreadPeekBindingV1, loadAgentViewThreadPeekV1, markAgentViewThreadPeekViewedV1, resolveAgentViewTargetV1, resolveAgentViewNativeThreadV1, markAgentViewThreadViewed, loadAgentViewProjectPageV1, loadAgentViewProjectPageV2, retryAgentViewEmptyNativeThreadV1, discardAgentViewEmptyNativeThreadV1, pinAgentViewThread, unpinAgentViewThread, setAgentViewThreadTitle, clearAgentViewThreadTitle, setAgentViewDevboxName, archiveAgentViewTemplateThreadMetadata, archiveAgentViewSecondaryThreadMetadata, unarchiveAgentViewTemplateThreadMetadata, unarchiveAgentViewSecondaryThreadMetadata, restoreAgentViewColdThread;
|
|
206818
206819
|
var init_queryRefs = __esm({
|
|
206819
206820
|
"src/devbox/agentView/queryRefs.ts"() {
|
|
206820
206821
|
"use strict";
|
|
@@ -206858,6 +206859,7 @@ var init_queryRefs = __esm({
|
|
|
206858
206859
|
unpinAgentViewThread = makeFunctionReference("desktopAgentState:unpinThread");
|
|
206859
206860
|
setAgentViewThreadTitle = makeFunctionReference("desktopAgentState:setThreadTitleOverride");
|
|
206860
206861
|
clearAgentViewThreadTitle = makeFunctionReference("desktopAgentState:clearThreadTitleOverride");
|
|
206862
|
+
setAgentViewDevboxName = makeFunctionReference("devboxNames:setForViewer");
|
|
206861
206863
|
archiveAgentViewTemplateThreadMetadata = makeFunctionReference("desktopAgentState:archiveThreadMetadata");
|
|
206862
206864
|
archiveAgentViewSecondaryThreadMetadata = makeFunctionReference("desktopAgentState:archiveSecondaryForkThreadMetadata");
|
|
206863
206865
|
unarchiveAgentViewTemplateThreadMetadata = makeFunctionReference("desktopAgentState:unarchiveThreadMetadata");
|
|
@@ -284923,7 +284925,7 @@ var init_creationPresentation = __esm({
|
|
|
284923
284925
|
});
|
|
284924
284926
|
|
|
284925
284927
|
// src/devbox/agentView/threadActions.ts
|
|
284926
|
-
var disabledAgentViewThreadMetadataActions, isTemplateThread, isDevboxAnchor, createTarget, projectAgentViewThreadMetadataActions, resolvePostArchiveSelectionKey;
|
|
284928
|
+
var disabledAgentViewThreadMetadataActions, isTemplateThread, isDevboxAnchor, createTarget, projectAgentViewThreadMetadataActions, projectAgentViewDevboxGroupMetadataActions, resolvePostArchiveSelectionKey;
|
|
284927
284929
|
var init_threadActions = __esm({
|
|
284928
284930
|
"src/devbox/agentView/threadActions.ts"() {
|
|
284929
284931
|
"use strict";
|
|
@@ -284954,7 +284956,8 @@ var init_threadActions = __esm({
|
|
|
284954
284956
|
storageState: row.storageState,
|
|
284955
284957
|
isDevboxAnchor: devboxAnchor,
|
|
284956
284958
|
isSecondaryDevboxThread: row.executionInstanceId !== row.primaryInstanceId && !devboxAnchor,
|
|
284957
|
-
forkGroupKey: row.forkAnchorPlacementId === null ? null : `fork-group:${String(row.forkAnchorPlacementId)}
|
|
284959
|
+
forkGroupKey: row.forkAnchorPlacementId === null ? null : `fork-group:${String(row.forkAnchorPlacementId)}`,
|
|
284960
|
+
renameSubject: { kind: "thread" }
|
|
284958
284961
|
};
|
|
284959
284962
|
};
|
|
284960
284963
|
projectAgentViewThreadMetadataActions = ({
|
|
@@ -284982,6 +284985,23 @@ var init_threadActions = __esm({
|
|
|
284982
284985
|
}
|
|
284983
284986
|
return { pin, rename, archive };
|
|
284984
284987
|
};
|
|
284988
|
+
projectAgentViewDevboxGroupMetadataActions = ({
|
|
284989
|
+
anchorRow,
|
|
284990
|
+
selectionKey,
|
|
284991
|
+
placementId,
|
|
284992
|
+
devboxName,
|
|
284993
|
+
groupTitle
|
|
284994
|
+
}) => ({
|
|
284995
|
+
...projectAgentViewThreadMetadataActions({ row: anchorRow, selectionKey }),
|
|
284996
|
+
rename: {
|
|
284997
|
+
kind: "ready",
|
|
284998
|
+
target: {
|
|
284999
|
+
...createTarget({ row: anchorRow, selectionKey }),
|
|
285000
|
+
currentTitle: groupTitle,
|
|
285001
|
+
renameSubject: { kind: "devbox", placementId, devboxName }
|
|
285002
|
+
}
|
|
285003
|
+
}
|
|
285004
|
+
});
|
|
284985
285005
|
resolvePostArchiveSelectionKey = ({
|
|
284986
285006
|
selectedKey,
|
|
284987
285007
|
selectableItems
|
|
@@ -285230,18 +285250,19 @@ var init_renderState = __esm({
|
|
|
285230
285250
|
}
|
|
285231
285251
|
const expanded = !collapsedForkGroupKeys.has(entry.group.key);
|
|
285232
285252
|
const totalThreadCount = entry.group.additionalThreadCount + 1;
|
|
285253
|
+
const expandedLabel = entry.group.devboxName === null ? "Devbox" : toSingleLineRowTitle(entry.group.devboxName);
|
|
285233
285254
|
blocks.push({
|
|
285234
285255
|
kind: "fork_group",
|
|
285235
285256
|
key: entry.group.key,
|
|
285236
285257
|
section,
|
|
285237
|
-
title: expanded ?
|
|
285258
|
+
title: expanded ? `${expandedLabel} (${String(totalThreadCount)} ${totalThreadCount === 1 ? "thread" : "threads"})` : toSingleLineRowTitle(entry.group.title),
|
|
285238
285259
|
originLabel: null,
|
|
285239
285260
|
dotTone: entry.group.hasActiveChild ? "active" : null,
|
|
285240
285261
|
// The group row is the devbox row, so it keeps the devbox's git counts
|
|
285241
285262
|
// whether or not its threads are showing. Only the collapsed row also
|
|
285242
285263
|
// carries the hidden-thread count, since expanding reveals them.
|
|
285243
285264
|
tokens: [
|
|
285244
|
-
...expanded ? [] : [
|
|
285265
|
+
...expanded || entry.group.additionalThreadCount === 0 ? [] : [
|
|
285245
285266
|
{
|
|
285246
285267
|
kind: "group_count",
|
|
285247
285268
|
text: `+${String(entry.group.additionalThreadCount)}`
|
|
@@ -285259,9 +285280,12 @@ var init_renderState = __esm({
|
|
|
285259
285280
|
targetRole: "devbox"
|
|
285260
285281
|
},
|
|
285261
285282
|
discardEmptyNative: { kind: "none" },
|
|
285262
|
-
metadata:
|
|
285263
|
-
|
|
285264
|
-
selectionKey: entry.group.key
|
|
285283
|
+
metadata: projectAgentViewDevboxGroupMetadataActions({
|
|
285284
|
+
anchorRow: entry.group.anchorRow,
|
|
285285
|
+
selectionKey: entry.group.key,
|
|
285286
|
+
placementId: entry.group.forkAnchorPlacementId,
|
|
285287
|
+
devboxName: entry.group.devboxName,
|
|
285288
|
+
groupTitle: toSingleLineRowTitle(entry.group.title)
|
|
285265
285289
|
})
|
|
285266
285290
|
},
|
|
285267
285291
|
target: {
|
|
@@ -285765,7 +285789,11 @@ var init_renameModal = __esm({
|
|
|
285765
285789
|
}) => ({
|
|
285766
285790
|
target,
|
|
285767
285791
|
boxLabel,
|
|
285768
|
-
|
|
285792
|
+
// An unnamed devbox starts empty so saving untouched text does not name it
|
|
285793
|
+
// after its first thread.
|
|
285794
|
+
editor: createAgentViewTextBuffer(
|
|
285795
|
+
target.renameSubject.kind === "devbox" ? target.renameSubject.devboxName ?? "" : target.currentTitle
|
|
285796
|
+
),
|
|
285769
285797
|
validationMessage: null,
|
|
285770
285798
|
submitting: false
|
|
285771
285799
|
});
|
|
@@ -285774,12 +285802,12 @@ var init_renameModal = __esm({
|
|
|
285774
285802
|
editor: reduceAgentViewTextBuffer(modal.editor, action),
|
|
285775
285803
|
validationMessage: null
|
|
285776
285804
|
});
|
|
285777
|
-
validateAgentViewThreadTitle = (text) => {
|
|
285805
|
+
validateAgentViewThreadTitle = (text, subject) => {
|
|
285778
285806
|
const codePointCount = Array.from(text).length;
|
|
285779
285807
|
if (codePointCount > AGENT_VIEW_THREAD_TITLE_MAX_CODE_POINTS) {
|
|
285780
285808
|
return {
|
|
285781
285809
|
valid: false,
|
|
285782
|
-
message: "Thread titles can be at most 120 characters.",
|
|
285810
|
+
message: subject === "devbox" ? "Devbox names can be at most 120 characters." : "Thread titles can be at most 120 characters.",
|
|
285783
285811
|
codePointCount
|
|
285784
285812
|
};
|
|
285785
285813
|
}
|
|
@@ -285789,7 +285817,7 @@ var init_renameModal = __esm({
|
|
|
285789
285817
|
});
|
|
285790
285818
|
|
|
285791
285819
|
// src/devbox/agentView/threadActionExecutor.ts
|
|
285792
|
-
var AgentViewThreadArchiveError, runAgentViewPinAction, runAgentViewRenameAction, setMetadataArchivedState, requireResolvedArchiveTarget, runAgentViewArchiveAction;
|
|
285820
|
+
var AgentViewThreadArchiveError, runAgentViewPinAction, runAgentViewRenameAction, runAgentViewDevboxRenameAction, setMetadataArchivedState, requireResolvedArchiveTarget, runAgentViewArchiveAction;
|
|
285793
285821
|
var init_threadActionExecutor = __esm({
|
|
285794
285822
|
"src/devbox/agentView/threadActionExecutor.ts"() {
|
|
285795
285823
|
"use strict";
|
|
@@ -285839,6 +285867,17 @@ var init_threadActionExecutor = __esm({
|
|
|
285839
285867
|
});
|
|
285840
285868
|
return { automaticTitle: false, title: result.title };
|
|
285841
285869
|
};
|
|
285870
|
+
runAgentViewDevboxRenameAction = async ({
|
|
285871
|
+
client,
|
|
285872
|
+
placementId,
|
|
285873
|
+
name
|
|
285874
|
+
}) => {
|
|
285875
|
+
const result = await client.mutation(setAgentViewDevboxName, {
|
|
285876
|
+
placementId,
|
|
285877
|
+
name
|
|
285878
|
+
});
|
|
285879
|
+
return { devboxName: result.devboxName };
|
|
285880
|
+
};
|
|
285842
285881
|
setMetadataArchivedState = async ({
|
|
285843
285882
|
client,
|
|
285844
285883
|
target,
|
|
@@ -285998,7 +286037,7 @@ var init_metadataActionController = __esm({
|
|
|
285998
286037
|
return "This Codex thread isn\u2019t ready to be archived yet.";
|
|
285999
286038
|
}
|
|
286000
286039
|
};
|
|
286001
|
-
genericFailureCopy = (action) => action === "pin" ? "Thread couldn\u2019t be pinned. Review the latest status and try again." : action === "rename" ? "Thread couldn\u2019t be renamed. Review the latest status and try again." : action === "archive" ? "Thread couldn\u2019t be archived. Review the latest status and try again." : "Thread couldn\u2019t be unarchived. Review the latest status and try again.";
|
|
286040
|
+
genericFailureCopy = (action) => action === "pin" ? "Thread couldn\u2019t be pinned. Review the latest status and try again." : action === "rename" ? "Thread couldn\u2019t be renamed. Review the latest status and try again." : action === "rename_devbox" ? "Devbox couldn\u2019t be renamed. Review the latest status and try again." : action === "archive" ? "Thread couldn\u2019t be archived. Review the latest status and try again." : "Thread couldn\u2019t be unarchived. Review the latest status and try again.";
|
|
286002
286041
|
AgentViewMetadataActionController = class {
|
|
286003
286042
|
constructor(client, setCodexArchivedState, managedProject, host) {
|
|
286004
286043
|
this.client = client;
|
|
@@ -286108,7 +286147,7 @@ var init_metadataActionController = __esm({
|
|
|
286108
286147
|
});
|
|
286109
286148
|
try {
|
|
286110
286149
|
let boxLabel = "Template box";
|
|
286111
|
-
if (target.executionInstanceId !== target.primaryInstanceId) {
|
|
286150
|
+
if (target.renameSubject.kind === "thread" && target.executionInstanceId !== target.primaryInstanceId) {
|
|
286112
286151
|
const resolved = await this.client.query(resolveAgentViewTargetV1, {
|
|
286113
286152
|
primaryInstanceId: target.primaryInstanceId,
|
|
286114
286153
|
executionInstanceId: target.executionInstanceId
|
|
@@ -286157,7 +286196,11 @@ var init_metadataActionController = __esm({
|
|
|
286157
286196
|
if (!modal || modal.submitting || this.snapshot.pendingLabel !== null) {
|
|
286158
286197
|
return;
|
|
286159
286198
|
}
|
|
286160
|
-
const
|
|
286199
|
+
const subject = modal.target.renameSubject;
|
|
286200
|
+
const validation = validateAgentViewThreadTitle(
|
|
286201
|
+
modal.editor.text,
|
|
286202
|
+
subject.kind
|
|
286203
|
+
);
|
|
286161
286204
|
if (!validation.valid) {
|
|
286162
286205
|
this.update({
|
|
286163
286206
|
renameModal: {
|
|
@@ -286174,6 +286217,30 @@ var init_metadataActionController = __esm({
|
|
|
286174
286217
|
renameModal: { ...modal, submitting: true, validationMessage: null }
|
|
286175
286218
|
});
|
|
286176
286219
|
try {
|
|
286220
|
+
if (subject.kind === "devbox") {
|
|
286221
|
+
const result2 = await runAgentViewDevboxRenameAction({
|
|
286222
|
+
client: this.client,
|
|
286223
|
+
placementId: subject.placementId,
|
|
286224
|
+
name: validation.title
|
|
286225
|
+
});
|
|
286226
|
+
this.setCompletedAction({
|
|
286227
|
+
kind: "rename",
|
|
286228
|
+
subject: "devbox",
|
|
286229
|
+
clientThreadId: modal.target.clientThreadId,
|
|
286230
|
+
expectedValue: result2.devboxName,
|
|
286231
|
+
observedExpected: false
|
|
286232
|
+
});
|
|
286233
|
+
this.update({
|
|
286234
|
+
renameModal: null,
|
|
286235
|
+
statusMessage: result2.devboxName === null ? "Using the first thread\u2019s title for this devbox." : `Renamed devbox to \u201C${result2.devboxName}\u201D.`,
|
|
286236
|
+
statusTone: "neutral"
|
|
286237
|
+
});
|
|
286238
|
+
logger2.info("agent_view_devbox_rename_completed", {
|
|
286239
|
+
placementId: subject.placementId,
|
|
286240
|
+
cleared: result2.devboxName === null
|
|
286241
|
+
});
|
|
286242
|
+
return;
|
|
286243
|
+
}
|
|
286177
286244
|
const result = await runAgentViewRenameAction({
|
|
286178
286245
|
client: this.client,
|
|
286179
286246
|
target: modal.target,
|
|
@@ -286181,8 +286248,9 @@ var init_metadataActionController = __esm({
|
|
|
286181
286248
|
});
|
|
286182
286249
|
this.setCompletedAction({
|
|
286183
286250
|
kind: "rename",
|
|
286251
|
+
subject: "thread",
|
|
286184
286252
|
clientThreadId: modal.target.clientThreadId,
|
|
286185
|
-
|
|
286253
|
+
expectedValue: result.automaticTitle ? null : result.title,
|
|
286186
286254
|
observedExpected: false
|
|
286187
286255
|
});
|
|
286188
286256
|
this.update({
|
|
@@ -286202,13 +286270,18 @@ var init_metadataActionController = __esm({
|
|
|
286202
286270
|
submitting: false,
|
|
286203
286271
|
validationMessage: null
|
|
286204
286272
|
},
|
|
286205
|
-
statusMessage: genericFailureCopy(
|
|
286273
|
+
statusMessage: genericFailureCopy(
|
|
286274
|
+
subject.kind === "devbox" ? "rename_devbox" : "rename"
|
|
286275
|
+
),
|
|
286206
286276
|
statusTone: "error"
|
|
286207
286277
|
});
|
|
286208
|
-
logger2.warn(
|
|
286209
|
-
|
|
286210
|
-
|
|
286211
|
-
|
|
286278
|
+
logger2.warn(
|
|
286279
|
+
subject.kind === "devbox" ? "agent_view_devbox_rename_failed" : "agent_view_thread_rename_failed",
|
|
286280
|
+
{
|
|
286281
|
+
clientThreadId: modal.target.clientThreadId,
|
|
286282
|
+
error: error55 instanceof Error ? error55.message : String(error55)
|
|
286283
|
+
}
|
|
286284
|
+
);
|
|
286212
286285
|
} finally {
|
|
286213
286286
|
this.update({ pendingLabel: null });
|
|
286214
286287
|
}
|
|
@@ -286365,12 +286438,13 @@ var init_metadataActionController = __esm({
|
|
|
286365
286438
|
return;
|
|
286366
286439
|
}
|
|
286367
286440
|
const readyAction = items.map((item) => item.actions.metadata[completed.kind]).find(
|
|
286368
|
-
(action) => action.kind === "ready" && action.target.clientThreadId === completed.clientThreadId
|
|
286441
|
+
(action) => action.kind === "ready" && action.target.clientThreadId === completed.clientThreadId && (completed.kind !== "rename" || action.target.renameSubject.kind === completed.subject)
|
|
286369
286442
|
);
|
|
286370
286443
|
if (!readyAction) {
|
|
286371
286444
|
return;
|
|
286372
286445
|
}
|
|
286373
|
-
const
|
|
286446
|
+
const renameSubject = readyAction.target.renameSubject;
|
|
286447
|
+
const matches2 = completed.kind === "pin" ? readyAction.target.isPinned === completed.expectedPinned : completed.kind === "rename" ? (renameSubject.kind === "devbox" ? renameSubject.devboxName : readyAction.target.manualTitle) === completed.expectedValue : readyAction.target.isArchived === completed.expectedArchived;
|
|
286374
286448
|
if (matches2) {
|
|
286375
286449
|
completed.observedExpected = true;
|
|
286376
286450
|
return;
|
|
@@ -291514,6 +291588,7 @@ var init_AgentViewRenameModal = __esm({
|
|
|
291514
291588
|
viewportHeight,
|
|
291515
291589
|
width
|
|
291516
291590
|
}) => {
|
|
291591
|
+
const isDevbox = modal.target.renameSubject.kind === "devbox";
|
|
291517
291592
|
const modalWidth = Math.max(24, Math.min(width - 4, 76));
|
|
291518
291593
|
const contentWidth = modalWidth - 4;
|
|
291519
291594
|
const horizontalRule = "\u2500".repeat(modalWidth - 2);
|
|
@@ -291527,11 +291602,18 @@ var init_AgentViewRenameModal = __esm({
|
|
|
291527
291602
|
justifyContent: "center",
|
|
291528
291603
|
children: /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)(Box_default, { flexDirection: "column", width: modalWidth, children: [
|
|
291529
291604
|
/* @__PURE__ */ (0, import_jsx_runtime10.jsx)(Text, { children: `\u256D${horizontalRule}\u256E` }),
|
|
291530
|
-
/* @__PURE__ */ (0, import_jsx_runtime10.jsx)(ModalLine, { text: "Rename thread", width: contentWidth, bold: true }),
|
|
291531
291605
|
/* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
|
|
291532
291606
|
ModalLine,
|
|
291533
291607
|
{
|
|
291534
|
-
text:
|
|
291608
|
+
text: isDevbox ? "Rename devbox" : "Rename thread",
|
|
291609
|
+
width: contentWidth,
|
|
291610
|
+
bold: true
|
|
291611
|
+
}
|
|
291612
|
+
),
|
|
291613
|
+
/* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
|
|
291614
|
+
ModalLine,
|
|
291615
|
+
{
|
|
291616
|
+
text: isDevbox ? modal.target.currentTitle : `${modal.target.currentTitle} \xB7 ${modal.boxLabel}`,
|
|
291535
291617
|
width: contentWidth,
|
|
291536
291618
|
dimColor: true
|
|
291537
291619
|
}
|
|
@@ -291539,7 +291621,7 @@ var init_AgentViewRenameModal = __esm({
|
|
|
291539
291621
|
/* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
|
|
291540
291622
|
ModalLine,
|
|
291541
291623
|
{
|
|
291542
|
-
text: "Leave the title empty to use the automatic title.",
|
|
291624
|
+
text: isDevbox ? "Leave the name empty to use the first thread\u2019s title." : "Leave the title empty to use the automatic title.",
|
|
291543
291625
|
width: contentWidth,
|
|
291544
291626
|
dimColor: true
|
|
291545
291627
|
}
|
|
@@ -349576,7 +349658,9 @@ var init_claudeAuthProbe = __esm({
|
|
|
349576
349658
|
}),
|
|
349577
349659
|
"EOF",
|
|
349578
349660
|
'cd "$tmpdir"',
|
|
349579
|
-
|
|
349661
|
+
// Without --no-session-persistence, Claude saves the probe transcript and
|
|
349662
|
+
// the box imports it as a thread whose temporary working directory is gone.
|
|
349663
|
+
`${REMOTE_MANAGED_CLAUDE_PATH} --devbox-disable-session-tracking --no-session-persistence -p --verbose --input-format stream-json --output-format stream-json --include-partial-messages --setting-sources user,project,local --permission-mode bypassPermissions --permission-prompt-tool stdio < "$input"`
|
|
349580
349664
|
].join("\n");
|
|
349581
349665
|
buildWriteManagedClaudeTokenToRemoteScript = ({
|
|
349582
349666
|
authMode = "oauth",
|
|
@@ -359806,4 +359890,4 @@ react/cjs/react-jsx-runtime.development.js:
|
|
|
359806
359890
|
*)
|
|
359807
359891
|
*/
|
|
359808
359892
|
|
|
359809
|
-
//# debugId=
|
|
359893
|
+
//# debugId=b4d75a4b-c5e3-5e9c-8629-a7af77ccf4b0
|
package/dist/bin/dvbd.mjs
CHANGED
|
@@ -96328,8 +96328,8 @@ var init_otel = __esm({
|
|
|
96328
96328
|
return trimmed && trimmed.length > 0 ? trimmed : void 0;
|
|
96329
96329
|
};
|
|
96330
96330
|
readBuildMetadata = () => {
|
|
96331
|
-
const rawPackageVersion = "1.0.
|
|
96332
|
-
const rawGitSha = "
|
|
96331
|
+
const rawPackageVersion = "1.0.1027";
|
|
96332
|
+
const rawGitSha = "b1de1456a00a8cf396a793db03b3095cf40cf93a";
|
|
96333
96333
|
const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
|
|
96334
96334
|
const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
|
|
96335
96335
|
return { packageVersion, gitSha };
|
|
@@ -128624,9 +128624,9 @@ var init_sentry = __esm({
|
|
|
128624
128624
|
uncaughtExceptionMonitorInstalled = false;
|
|
128625
128625
|
currentDevboxSentryUser = null;
|
|
128626
128626
|
readBuildMetadata2 = () => {
|
|
128627
|
-
const rawPackageVersion = "1.0.
|
|
128628
|
-
const rawGitSha = "
|
|
128629
|
-
const rawSentryRelease = "boxes-dev-dvb@1.0.
|
|
128627
|
+
const rawPackageVersion = "1.0.1027";
|
|
128628
|
+
const rawGitSha = "b1de1456a00a8cf396a793db03b3095cf40cf93a";
|
|
128629
|
+
const rawSentryRelease = "boxes-dev-dvb@1.0.1027+b1de1456a00a8cf396a793db03b3095cf40cf93a";
|
|
128630
128630
|
const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
|
|
128631
128631
|
const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
|
|
128632
128632
|
const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
|
|
@@ -130826,7 +130826,7 @@ var init_packageVersion = __esm({
|
|
|
130826
130826
|
return path8.join(process.cwd(), "dvb");
|
|
130827
130827
|
};
|
|
130828
130828
|
readEmbeddedPackageVersion = () => {
|
|
130829
|
-
const raw = "1.0.
|
|
130829
|
+
const raw = "1.0.1027";
|
|
130830
130830
|
return trimVersion(raw);
|
|
130831
130831
|
};
|
|
130832
130832
|
readNearestPackageMetadata = (basePath) => {
|
|
@@ -24,7 +24,7 @@ An automation has:
|
|
|
24
24
|
- capacity behavior;
|
|
25
25
|
- run history.
|
|
26
26
|
|
|
27
|
-
|
|
27
|
+
By default, automation runs start new devboxes from the same reusable source as ordinary
|
|
28
28
|
threads. For an ordinary project, that is the latest Template-box snapshot. For
|
|
29
29
|
a Team Template member project, it is the Team Template's current saved
|
|
30
30
|
version. Keep the source current when future automation runs need new
|
|
@@ -149,7 +149,33 @@ Requests support an optional `Idempotency-Key` header. Retrying the same
|
|
|
149
149
|
normalized request with the same key returns the original run; reusing the key
|
|
150
150
|
for different input returns a conflict.
|
|
151
151
|
|
|
152
|
-
|
|
152
|
+
To keep one devbox per issue, launch the first run without `target`, wait for
|
|
153
|
+
`thread_ready`, and save its returned `devboxId`. A later configurable request
|
|
154
|
+
can start a fresh run and conversation on that filesystem:
|
|
155
|
+
|
|
156
|
+
```json
|
|
157
|
+
{
|
|
158
|
+
"prompt": "Implement the plan saved in issue-plan.md.",
|
|
159
|
+
"threadTitle": "Build the feature",
|
|
160
|
+
"target": { "kind": "existing_devbox", "devboxId": "<saved devboxId>" }
|
|
161
|
+
}
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
Omit `target` to create a new devbox. Only devboxes created by the same
|
|
165
|
+
automation are eligible. Missing, still starting, archived, destroying, or inaccessible targets
|
|
166
|
+
return `409 devbox_unavailable`; no replacement devbox is created. A target
|
|
167
|
+
that becomes unavailable after acceptance can still cause a failed run during
|
|
168
|
+
startup. Use a new idempotency key for each workflow; changing the target also
|
|
169
|
+
changes the request for idempotency purposes.
|
|
170
|
+
|
|
171
|
+
Shared-devbox threads have separate conversations and share files. Pass context
|
|
172
|
+
through files or the prompt, and coordinate concurrent edits and branch changes.
|
|
173
|
+
Choose **Never** under **Devbox cleanup** for a persistent issue workspace.
|
|
174
|
+
The creating run retains cleanup ownership; existing cleanup preserves devboxes
|
|
175
|
+
with additional durable threads. The sidebar groups shared-devbox threads once,
|
|
176
|
+
while run history keeps each workflow separately.
|
|
177
|
+
|
|
178
|
+
An accepted request returns `202`, the run id, a status URL, nullable `devboxId`, and the effective
|
|
153
179
|
thread title and agent controls without echoing the prompt. GET requests to the
|
|
154
180
|
status URL require the same Bearer secret and report launch progress.
|
|
155
181
|
`thread_ready` means the child thread exists and can be
|
|
@@ -160,7 +186,7 @@ runs in parallel; use `Idempotency-Key` to make retries reuse the original run.
|
|
|
160
186
|
|
|
161
187
|
## Capacity Behavior
|
|
162
188
|
|
|
163
|
-
Each
|
|
189
|
+
Each new devbox needs awake devbox capacity. If you are at your awake devbox
|
|
164
190
|
limit, the automation can be blocked unless you enable capacity behavior for
|
|
165
191
|
that automation.
|
|
166
192
|
|
|
@@ -173,6 +199,11 @@ Capacity settings do not override billing limits or unavailable runtime state.
|
|
|
173
199
|
They only help when the blocker is the awake devbox concurrency limit and an
|
|
174
200
|
idle devbox can be slept.
|
|
175
201
|
|
|
202
|
+
An API request targeting an awake devbox needs no additional awake slot.
|
|
203
|
+
Sleeping targets wake if capacity is available. The sleep-idle option applies only
|
|
204
|
+
to new-devbox requests; a wake blocked by capacity produces a failed run with
|
|
205
|
+
`startup_active_fork_limit_reached` at its status URL.
|
|
206
|
+
|
|
176
207
|
## Automation Devbox Cleanup
|
|
177
208
|
|
|
178
209
|
Scheduled and API automations whose runs stay nested under the automation can
|
|
@@ -271,7 +271,9 @@ preview clears unread only after the exact ready content is rendered. Loading,
|
|
|
271
271
|
unavailable, and stale content do not clear it.
|
|
272
272
|
|
|
273
273
|
Use `p` to pin or unpin an eligible Template-box thread or devbox anchor, `r`
|
|
274
|
-
to rename a thread, and `x` to archive or restore it. On
|
|
274
|
+
to rename a thread, and `x` to archive or restore it. On a devbox group row,
|
|
275
|
+
`r` renames the devbox instead, and empty input returns the group to its first
|
|
276
|
+
thread's title. On an archived
|
|
275
277
|
cold-storage thread, `x` opens the available restore choice. Ordinary projects
|
|
276
278
|
can use the current Template box or a new devbox; Team Template member projects
|
|
277
279
|
restore only to a new devbox. Empty rename input
|
|
@@ -35,7 +35,9 @@ Git/Review, and Browser. The app menu can show or hide the Agent pane. At least
|
|
|
35
35
|
one main area stays visible. A new devbox starts with no aux pane open. The
|
|
36
36
|
Template box and each devbox then remember their last aux-pane choice
|
|
37
37
|
independently, so returning to a runtime restores its previous pane. Pane widths
|
|
38
|
-
can be resized.
|
|
38
|
+
can be resized. Showing Terminal reattaches the runtime's open terminal
|
|
39
|
+
sessions, or starts one if it has none, and closing the last terminal tab
|
|
40
|
+
closes the pane.
|
|
39
41
|
|
|
40
42
|
## Right-Click Menus
|
|
41
43
|
|
|
@@ -208,8 +210,8 @@ snapshot, repository, terminal, and power controls.
|
|
|
208
210
|
Use the terminal button in the Template box header to replace the Template box
|
|
209
211
|
page with its terminal in the main pane. While it is there, Terminal is
|
|
210
212
|
unavailable as the right-side pane, but Files, Git/Review, and Browser continue
|
|
211
|
-
to work there normally. Use the same button again
|
|
212
|
-
page.
|
|
213
|
+
to work there normally. Use the same button again, or close the last terminal
|
|
214
|
+
tab, to restore the Template box page.
|
|
213
215
|
|
|
214
216
|
Work that should not change the Template box directly should usually start on a
|
|
215
217
|
devbox. See `fork-workflows.md` for that workflow.
|
|
@@ -167,6 +167,17 @@ runtime state.
|
|
|
167
167
|
This is useful for asking a second question about work already in that devbox,
|
|
168
168
|
or for continuing with another agent without creating another machine.
|
|
169
169
|
|
|
170
|
+
In the thread list, a devbox with more than one thread appears as a group
|
|
171
|
+
titled with its first thread's title. To label the devbox separately, choose
|
|
172
|
+
**Rename devbox** from the group's menu in the desktop or mobile app, or press
|
|
173
|
+
`r` on the group row in `dvb agents`. Renaming the devbox does not change any
|
|
174
|
+
thread title, and renaming a thread does not change the devbox name. A named
|
|
175
|
+
devbox keeps its group row even when all but one of its threads are archived.
|
|
176
|
+
Saving an empty name returns the group to the first thread's title, and a
|
|
177
|
+
devbox with one remaining thread goes back to a single thread row. Teammates
|
|
178
|
+
who can see the devbox's threads see the same name, but only the owner can
|
|
179
|
+
rename it.
|
|
180
|
+
|
|
170
181
|
Secondary threads on a devbox can be archived without destroying the devbox. The
|
|
171
182
|
devbox row and original devbox thread still own devbox lifecycle actions;
|
|
172
183
|
archiving a secondary thread only hides that child thread from the active devbox
|
|
@@ -176,6 +176,8 @@ at the right, matching desktop. Sleeping devboxes show a timestamp in that
|
|
|
176
176
|
space. From a devbox row or devbox group you can:
|
|
177
177
|
|
|
178
178
|
- start another thread on the same devbox;
|
|
179
|
+
- rename the devbox from its group, so the group shows that name instead of
|
|
180
|
+
its first thread's title;
|
|
179
181
|
- pin or unpin the devbox;
|
|
180
182
|
- put the devbox to sleep when it is idle;
|
|
181
183
|
- destroy the devbox when you are finished.
|
|
@@ -104,7 +104,7 @@ snapshot used by future devboxes:
|
|
|
104
104
|
dvb-onbox snapshot --json
|
|
105
105
|
```
|
|
106
106
|
|
|
107
|
-
|
|
107
|
+
This command works only on the Template box itself. It is a user-visible,
|
|
108
108
|
state-changing operation and should run only when the user asks to take or
|
|
109
109
|
refresh a snapshot and the environment is ready to become the basis for future
|
|
110
110
|
devboxes. The requesting Codex or Claude agent can remain active: boxes.dev will
|
|
@@ -112,6 +112,28 @@ pause it only during capture and resume it on the Template box. Future devboxes
|
|
|
112
112
|
will receive the saved files and transcript history, but they will not continue
|
|
113
113
|
the copied agent process.
|
|
114
114
|
|
|
115
|
+
### Edit the Template box from a devbox
|
|
116
|
+
|
|
117
|
+
From a devbox in a project with its own Template box, an agent with the
|
|
118
|
+
`edit-template-box` permission for its current thread can change the project's
|
|
119
|
+
Template box and save a snapshot without a thread on the Template box:
|
|
120
|
+
|
|
121
|
+
```bash
|
|
122
|
+
dvb-onbox template-box exec -- git -C /home/boxes/example status --short
|
|
123
|
+
dvb-onbox template-box exec --cwd /home/boxes/example -- direnv allow
|
|
124
|
+
dvb-onbox template-box run --script-file /home/boxes/setup-change.sh \
|
|
125
|
+
--idempotency-key <stable-key> --json
|
|
126
|
+
dvb-onbox template-box snapshot --json
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
Each command wakes a sleeping Template box and runs as its `boxes` user.
|
|
130
|
+
`exec` runs one noninteractive command for up to 120 seconds with 1 MiB of
|
|
131
|
+
output per stream. `run` sends a regular script file of up to 3 MiB to `bash`,
|
|
132
|
+
runs it for up to 20 minutes, and returns up to 4 MiB per output stream; use it
|
|
133
|
+
to write files on the Template box. `snapshot` waits for the new snapshot that
|
|
134
|
+
future devboxes will use. Take one only when the user wants the change to reach
|
|
135
|
+
future devboxes. Ordinary shell commands still act on the current devbox.
|
|
136
|
+
|
|
115
137
|
## Devbox Lifecycle And Template Maintenance
|
|
116
138
|
|
|
117
139
|
From the project's current ordinary Template box, an agent can inspect and edit
|
|
@@ -218,8 +240,10 @@ dvb-onbox permissions request \
|
|
|
218
240
|
The request values are `create-devboxes-and-threads`,
|
|
219
241
|
`create-team-templates`, `update-thread-titles`,
|
|
220
242
|
`move-devboxes-to-folders`, `create-devbox-folders`,
|
|
221
|
-
`edit-devbox-lifecycle`, `edit-template-maintenance`,
|
|
222
|
-
|
|
243
|
+
`edit-devbox-lifecycle`, `edit-template-maintenance`, `destroy-devbox`,
|
|
244
|
+
`read-project-threads`, `read-user-threads`, `read-shared-threads`,
|
|
245
|
+
`read-team-threads`, `edit-template-box`, and `edit-team-template`. Add
|
|
246
|
+
`--json` for a stable structured result.
|
|
223
247
|
|
|
224
248
|
The command creates one request for the exact managed thread and source box,
|
|
225
249
|
then waits up to ten minutes while the owner sees **Deny**, **Allow**, and,
|
|
@@ -229,7 +253,17 @@ for every agent on that source box until the owner turns it off; it is not a
|
|
|
229
253
|
one-operation grant. **Deny** declines this request without changing permission
|
|
230
254
|
settings. An agent cannot answer its own request.
|
|
231
255
|
|
|
232
|
-
|
|
256
|
+
`edit-template-box` and `edit-team-template` work differently. They let only
|
|
257
|
+
the agent in the requesting thread edit the Template its devbox came from, and
|
|
258
|
+
the owner sees **Deny** and **Allow for 3 hours**. The grant expires 3 hours
|
|
259
|
+
after approval. Other threads and boxes never receive it, and no Agent
|
|
260
|
+
permissions switch or project setting can enable it. Request
|
|
261
|
+
`edit-template-box` from a devbox in a project with its own Template box.
|
|
262
|
+
Request `edit-team-template` from a devbox in a Team Template project; only a
|
|
263
|
+
team admin can receive it. After the grant expires, the next command reports
|
|
264
|
+
the missing permission and the agent needs a new request.
|
|
265
|
+
|
|
266
|
+
For thread reads, folder access, thread titles, and creating devboxes and threads, the owner
|
|
233
267
|
can choose **Always allow for project** directly.
|
|
234
268
|
This will enable the project's shared permission and make the requesting box
|
|
235
269
|
use it. All existing and future devboxes will follow that setting, except
|
|
@@ -566,11 +600,63 @@ their devboxes or claiming a live input surface. The source box's live **Create
|
|
|
566
600
|
devboxes and threads** permission is checked on every observation and control.
|
|
567
601
|
Prompt files are limited to 32 KiB.
|
|
568
602
|
|
|
569
|
-
Delegation does not grant destruction permission
|
|
570
|
-
|
|
603
|
+
Delegation does not grant destruction permission or access to unrelated
|
|
604
|
+
threads. Read-only thread and project discovery has its own permission below.
|
|
605
|
+
`dvb-onbox` does not expose arbitrary direct exec, services, or generic machine
|
|
571
606
|
management. The current-box public link commands above are its only port-control
|
|
572
607
|
surface.
|
|
573
608
|
|
|
609
|
+
## Read Other Threads
|
|
610
|
+
|
|
611
|
+
With **Read other threads** enabled in Agent permissions, agents can discover
|
|
612
|
+
and read threads beyond their delegated children. The setting applies to every
|
|
613
|
+
agent on the source box. It is off by default, inherits the project's setting,
|
|
614
|
+
and can be overridden on a box. Higher levels include the preceding levels:
|
|
615
|
+
this project, all your projects, your threads plus shared threads, and your
|
|
616
|
+
threads plus teammates' threads you can access. This permission never grants
|
|
617
|
+
control of other threads.
|
|
618
|
+
|
|
619
|
+
```bash
|
|
620
|
+
dvb-onbox threads access --json
|
|
621
|
+
dvb-onbox threads list --scope project --json
|
|
622
|
+
dvb-onbox threads projects --scope user --json
|
|
623
|
+
dvb-onbox threads list --scope user --project <project-id> --json
|
|
624
|
+
dvb-onbox threads list --scope shared --json
|
|
625
|
+
dvb-onbox threads list --scope team --owner <owner-id> --project <project-id> --json
|
|
626
|
+
dvb-onbox threads read --scope shared --thread <thread-id-or-share-link> --turns 20 --json
|
|
627
|
+
```
|
|
628
|
+
|
|
629
|
+
`access` reports the grant, team visibility, and available scopes. `project`
|
|
630
|
+
selects your current project; `user` selects your projects. `shared` lists
|
|
631
|
+
teammate threads whose invitation link you previously opened and which still
|
|
632
|
+
grant access, including ones removed from Shared with me. Pins alone and
|
|
633
|
+
unopened links do not qualify. A supplied invitation URL can be read without
|
|
634
|
+
saving or claiming it. A permanent thread URL does not grant access.
|
|
635
|
+
|
|
636
|
+
`team` excludes your own threads and follows team settings: Shared links only
|
|
637
|
+
disables general discovery, Thread titles permits metadata, and All threads
|
|
638
|
+
permits transcripts. Valid personal shares can grant transcript access under
|
|
639
|
+
Thread titles. Private threads and revoked access remain unavailable.
|
|
640
|
+
|
|
641
|
+
Use project IDs and owner IDs returned by `projects` or `list`, not repository
|
|
642
|
+
names. Project filters apply to `user`, `shared`, and `team`; owner filters
|
|
643
|
+
apply to `shared` and `team`. Each listing page examines up to 50 candidate
|
|
644
|
+
records; filters and access checks can leave fewer results or an empty page.
|
|
645
|
+
Pass `pagination.nextCursor` as `--cursor` when you need more results, and
|
|
646
|
+
check `pagination.complete` to know when the inventory ends. Scoped commands
|
|
647
|
+
do not accept `--all`. Project discovery can repeat a project across pages;
|
|
648
|
+
deduplicate by project ID. Add `--include-archived` to thread listings for archived work.
|
|
649
|
+
|
|
650
|
+
Reads return stored visible user/assistant messages with older-page cursors.
|
|
651
|
+
They may lag active work and shorten long messages. They do not wake boxes,
|
|
652
|
+
mark threads read, claim links, or expose full tool logs. Without `--scope`,
|
|
653
|
+
the existing `list` and `read` commands still select delegated children only.
|
|
654
|
+
|
|
655
|
+
If a needed scope reports `thread_read_access_disabled`, request the matching
|
|
656
|
+
`read-project-threads`, `read-user-threads`, `read-shared-threads`, or
|
|
657
|
+
`read-team-threads` permission. Team visibility limits require a team setting
|
|
658
|
+
change; an agent permission cannot override them.
|
|
659
|
+
|
|
574
660
|
## Destroy And Archive The Current Devbox
|
|
575
661
|
|
|
576
662
|
An agent can request destruction of its own ordinary devbox with:
|
|
@@ -790,9 +876,11 @@ Run `dvb-onbox box status --json` before choosing a workflow:
|
|
|
790
876
|
box. To edit an associated Team Template, use **Work on a Team Template from
|
|
791
877
|
an ordinary Template box**. To create a new definition from the current
|
|
792
878
|
project, use **Create a Team Template from this project**.
|
|
793
|
-
- `devbox`: local edits affect only this devbox
|
|
794
|
-
|
|
795
|
-
|
|
879
|
+
- `devbox`: local edits affect only this devbox; do not treat it as the shared
|
|
880
|
+
template. In a Team Template project, a team admin's agent can edit that
|
|
881
|
+
Team Template after the user allows `edit-team-template` for the current
|
|
882
|
+
thread. Use **Work on a Team Template from a member devbox**. Creating a
|
|
883
|
+
Team Template requires an ordinary Template box.
|
|
796
884
|
|
|
797
885
|
Skill availability is not proof of an editing association. If role inspection
|
|
798
886
|
fails, report the command's error and use only the operations whose target is
|
|
@@ -1095,3 +1183,45 @@ second time. The command reports a request ID and may say that its output is
|
|
|
1095
1183
|
unavailable; verify filesystem state before deciding whether another command
|
|
1096
1184
|
is appropriate. Retrying the same `push` request after an uncertain response
|
|
1097
1185
|
recovers its recorded result instead of writing the destination twice.
|
|
1186
|
+
|
|
1187
|
+
### Work on a Team Template from a member devbox
|
|
1188
|
+
|
|
1189
|
+
This section applies to a devbox in a Team Template project whose user is a
|
|
1190
|
+
team admin. Ask the user for access, then request it for the current thread:
|
|
1191
|
+
|
|
1192
|
+
```bash
|
|
1193
|
+
dvb-onbox permissions request --permission edit-team-template --json
|
|
1194
|
+
```
|
|
1195
|
+
|
|
1196
|
+
After the user chooses **Allow for 3 hours**, connect this thread to the Team
|
|
1197
|
+
Template's editing session:
|
|
1198
|
+
|
|
1199
|
+
```bash
|
|
1200
|
+
dvb-onbox team-template edit-box open --idempotency-key <stable-key> --json
|
|
1201
|
+
```
|
|
1202
|
+
|
|
1203
|
+
`open` uses the Team Template of the devbox's project. It reuses the user's
|
|
1204
|
+
current editing session or starts a new one, which can take several minutes,
|
|
1205
|
+
and waits until the session is connected to this thread. It fails while
|
|
1206
|
+
another admin is editing the Team Template or another agent is connected to
|
|
1207
|
+
the session. The result includes the Team Template id and `editBox.id`. The
|
|
1208
|
+
target commands from the previous section then act on that editing machine:
|
|
1209
|
+
|
|
1210
|
+
```bash
|
|
1211
|
+
dvb-onbox team-template exec --template <team-template-id> -- git status --short
|
|
1212
|
+
dvb-onbox team-template push --template <team-template-id> \
|
|
1213
|
+
--source /home/boxes/file-on-devbox \
|
|
1214
|
+
--destination /home/boxes/file-in-team-template
|
|
1215
|
+
dvb-onbox team-template edit-box run --edit-box <edit-box-id> \
|
|
1216
|
+
--script-file /home/boxes/setup-change.sh --idempotency-key <stable-key> --json
|
|
1217
|
+
dvb-onbox team-template edit-box status --edit-box <edit-box-id> --json
|
|
1218
|
+
dvb-onbox team-template edit-box save --edit-box <edit-box-id> \
|
|
1219
|
+
--idempotency-key <stable-key> --json
|
|
1220
|
+
```
|
|
1221
|
+
|
|
1222
|
+
Save only when the user asked to publish the change. `save` uses the normal
|
|
1223
|
+
verified save pipeline, waits for it to finish, and ends this thread's access
|
|
1224
|
+
to that editing session. Access also ends when the grant expires or an admin
|
|
1225
|
+
saves the session in the desktop app. To make more changes, run `open` again
|
|
1226
|
+
with a new key. Member-file requirements and Team Template creation are not
|
|
1227
|
+
available from a devbox.
|
|
@@ -180,10 +180,12 @@ file even when a large folder's displayed listing is shortened. Git-ignored
|
|
|
180
180
|
files need a named file selection if you want to copy them.
|
|
181
181
|
|
|
182
182
|
The desktop app's Project step leads with **Set up with your coding agent**,
|
|
183
|
-
followed by a Team Template when the team has one
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
183
|
+
followed by a Team Template when the team has one. The local-folder and GitHub
|
|
184
|
+
options are fallbacks under **Other setup options** at the bottom of the step,
|
|
185
|
+
with the local folder first. **Use coding agent** expands the card to show the
|
|
186
|
+
prompt to copy into Codex or Claude Code in the local project folder. When the
|
|
187
|
+
remote setup thread starts, the agent offers to open that project in the
|
|
188
|
+
desktop app, so the Project step does not need to stay open.
|
|
187
189
|
|
|
188
190
|
The commands mirror the wizard's stages: `dvb agent-init start` seeds the
|
|
189
191
|
version 3 manifest with everything detectable. A standard GitHub origin seeds
|
|
@@ -308,7 +310,9 @@ opens Configure agents. Connecting that agent there clears the block.
|
|
|
308
310
|
## Project Selection
|
|
309
311
|
|
|
310
312
|
The local-folder project step chooses the folder that becomes the boxes.dev
|
|
311
|
-
project.
|
|
313
|
+
project. In the desktop app, open **Other setup options** at the bottom of the
|
|
314
|
+
Project step, then choose **Browse...** or drop the folder onto the local-folder
|
|
315
|
+
option.
|
|
312
316
|
The project name must use lowercase letters, numbers, and dashes. If the
|
|
313
317
|
selected folder contains multiple direct child Git repos, setup shows those
|
|
314
318
|
repos under **Git repositories** and the user can choose which ones to include
|
|
@@ -346,9 +350,11 @@ creation until a project is deleted or billing changes allow another project.
|
|
|
346
350
|
|
|
347
351
|
On the logged-in website, including from a mobile browser, choose **Create from
|
|
348
352
|
GitHub** and connect a GitHub account. After a user has set up their first
|
|
349
|
-
project, the desktop app also offers **Create from GitHub**
|
|
350
|
-
|
|
351
|
-
|
|
353
|
+
project, the desktop app also offers **Create from GitHub** under **Other
|
|
354
|
+
setup options** when they start another project, marked **Manual setup**
|
|
355
|
+
because it suits only repositories that need little setup. The desktop
|
|
356
|
+
first-project flow leaves this option out so it can guide new users through
|
|
357
|
+
copying their local development environment instead.
|
|
352
358
|
Connecting first authorizes the user's GitHub identity. If the boxes.dev GitHub
|
|
353
359
|
App is not installed yet, setup then makes installation the required next step:
|
|
354
360
|
choose the personal account or organization that owns the repositories and
|
|
@@ -607,13 +607,13 @@ source thread's files and working directory. New devbox snapshots the exact
|
|
|
607
607
|
Template box or devbox that hosts the source, then creates an independent
|
|
608
608
|
devbox with that filesystem state. This includes the current working tree when
|
|
609
609
|
the source is already a devbox. The source remains unchanged, and the source
|
|
610
|
-
and child can continue independently.
|
|
611
|
-
|
|
612
|
-
|
|
613
|
-
|
|
614
|
-
|
|
615
|
-
|
|
616
|
-
|
|
610
|
+
and child can continue independently. On mobile, long-press a completed reply
|
|
611
|
+
to choose **Continue in current box** or **Continue in new devbox**. Fork
|
|
612
|
+
controls are unavailable while the source is working, but they don't wait for
|
|
613
|
+
the app to connect to the source machine. When you choose a fork action,
|
|
614
|
+
boxes.dev will connect to the source, waking it if needed, before creating the
|
|
615
|
+
new chat. If the source machine's boxes.dev service is too old to branch, the
|
|
616
|
+
new chat will show an error.
|
|
617
617
|
|
|
618
618
|
Codex active turns can usually be interrupted with the Stop button or Escape.
|
|
619
619
|
If interruption has already been requested, the UI shows that the turn is
|
|
@@ -876,7 +876,8 @@ Team admins choose **Thread access** in Team settings:
|
|
|
876
876
|
With **Thread titles** or **All threads**, use **Teammates' projects** in the
|
|
877
877
|
desktop project selector or mobile Home to choose a teammate's project. The
|
|
878
878
|
Team workbench reuses the familiar devbox, thread-list, transcript, and
|
|
879
|
-
optional Template-box layout in read-only form.
|
|
879
|
+
optional Template-box layout in read-only form. A devbox its owner named
|
|
880
|
+
appears under that name. It does not include a composer,
|
|
880
881
|
Files, Git/Review, terminal, ports, or runtime controls. Opening Team work or a
|
|
881
882
|
shared transcript does not select or wake the viewer's last Template box or
|
|
882
883
|
devbox. Merely browsing a teammate's work does not add it to **Shared with
|
|
@@ -186,6 +186,18 @@ before asking you to sign in again.
|
|
|
186
186
|
|
|
187
187
|
## Codex Stopped Before Finishing
|
|
188
188
|
|
|
189
|
+
If a large Codex thread asks you to reload or update boxes.dev, press Cmd+R in
|
|
190
|
+
the desktop app. On mobile, open **Settings → About → Release details** and
|
|
191
|
+
choose **Check for update**. If the installed app has no compatible update and
|
|
192
|
+
the message persists, install the latest app version or contact support.
|
|
193
|
+
Reloading the desktop app does not stop the agent running on the devbox.
|
|
194
|
+
|
|
195
|
+
If Retry says the thread is too large, send a new message to continue.
|
|
196
|
+
The failed turn stays in the history.
|
|
197
|
+
|
|
198
|
+
If the message says an older thread is too large to reopen, start a new thread
|
|
199
|
+
to continue. Updating the app does not remove this limitation for older threads.
|
|
200
|
+
|
|
189
201
|
Codex failure cards distinguish several failure layers so the recovery step
|
|
190
202
|
matches what happened:
|
|
191
203
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@boxes-dev/dvb-runtime",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.1027",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"license": "UNLICENSED",
|
|
6
6
|
"imports": {
|
|
@@ -77,5 +77,5 @@
|
|
|
77
77
|
"e2b": "^2.18.0",
|
|
78
78
|
"ink-testing-library": "^4.0.0"
|
|
79
79
|
},
|
|
80
|
-
"devboxReleasedAt": "2026-09-
|
|
80
|
+
"devboxReleasedAt": "2026-09-26T19:00:13Z"
|
|
81
81
|
}
|