windows-development-sandbox 1.10.0 → 1.11.4

package/dist/cli/commands/data/index.js

@@ -1,62 +0,0 @@
-// `sandbox data`: what persists between sandboxes (toolchains, databases, agent state, logs, host storage) and
-// removing chosen parts of it. Everything under the data folder is sandbox-writable: sizes and deletes never follow
-// links, and targets resolve strictly inside the data folder.
-import _ from 'lodash';
-import { humanBytes } from '../../../core/disk.js';
-import { fail } from '../../../core/util/index.js';
-import { printJson, table, working } from '../../output/index.js';
-import { DataService } from '../../services/index.js';
-import { dataClean } from './clean.js';
-const AREA_LABEL = {
-    tools: 'Toolchains',
-    databases: 'Databases',
-    state: 'Agent state',
-    logs: 'Logs',
-    data: 'Other',
-    host: 'On this PC',
-};
-export async function dataInfo(ctx) {
-    const report = await working('Measuring the saved data (big folders take a moment)', () => new DataService(ctx).report(), !ctx.options.json);
-    const { entries, disks, totalBytes: total } = report;
-    if (printJson(ctx, { dataPath: ctx.dataPath, storageRoot: ctx.storageRoot, totalBytes: total, entries, disks }))
-        return 0;
-    console.log('Disks\n');
-    table([
-        ['DRIVE', 'USED', 'FREE', 'SIZE', ''],
-        ...disks.map((d) => [
-            d.drive,
-            humanBytes(d.usedBytes) + ' (' + Math.round((d.usedBytes / d.totalBytes) * 100) + '%)',
-            humanBytes(d.freeBytes),
-            humanBytes(d.totalBytes),
-            d.holdsStorage ? '<- sandbox storage (' + humanBytes(total) + ' of it)' : '',
-        ]),
-    ]);
-    console.log('');
-    console.log('Persistent data for the sandbox: ' + ctx.dataPath + ' (C:\\AgentData inside)\n');
-    if (!entries.length) {
-        console.log('Nothing stored yet. Toolchains, databases and agent logins appear here after the first start.');
-        return 0;
-    }
-    const rows = _.flatMap(_.groupBy(entries, 'area'), (group, area) => [
-        [AREA_LABEL[area], humanBytes(_.sumBy(group, 'bytes')), ''],
-        ...group.map((e) => ['  ' + e.name, humanBytes(e.bytes), e.path]),
-    ]);
-    table([...rows, ['', '', ''], ['Total', humanBytes(total), '']]);
-    console.log('\nFree space with: sandbox data clean <target...>  (e.g. tools/go, databases/postgres-18, logs, launches)');
-    return 0;
-}
-/** `sandbox data [info|clean] [targets...]`. */
-export function data(ctx) {
-    const [action = 'info'] = ctx.options.positionals;
-    switch (action) {
-        case 'info':
-        case 'show':
-        case 'list':
-            return dataInfo(ctx);
-        case 'clean':
-        case 'remove':
-            return dataClean(ctx);
-        default:
-            return fail('Unknown data action "' + action + '".', 'Use: sandbox data  (what is stored)  or  sandbox data clean <target...>');
-    }
-}

package/dist/cli/commands/maintenance/clean.d.ts

@@ -1,2 +0,0 @@
-import { type Context } from '../context.js';
-export declare function clean(ctx: Context): Promise<number>;

package/dist/cli/commands/maintenance/clean.js

@@ -1,24 +0,0 @@
-// `sandbox clean`: old launch folders, logs and leftovers. Shows what and how much, then asks (--yes skips).
-import _ from 'lodash';
-import { askRequired } from '../../../core/prompt.js';
-import { describePrune, pruneStorage } from '../../../host/storage/index.js';
-import { isSandboxRunning } from '../../../host/sandbox/index.js';
-import { RunDir } from '../../../shared/channel/index.js';
-import { nextStep } from '../../output/index.js';
-export async function clean(ctx) {
-    const running = isSandboxRunning() ? new RunDir(ctx.dataPath).readSandboxStatus()?.launchId : undefined;
-    const options = { launchDays: ctx.options.days, keep: _.compact([running]) };
-    const found = pruneStorage(ctx.storageRoot, { ...options, dryRun: true });
-    if (found.launches + found.logs + found.leftovers === 0) {
-        console.log('Nothing to clean.');
-        return 0;
-    }
-    console.log('Can be removed: ' + describePrune(found).replace(' removed', '') + '.');
-    if (!ctx.options.yes && !(await askRequired('Delete them?', 'Add --yes to delete without asking.'))) {
-        console.log('Nothing removed.');
-        return 1;
-    }
-    console.log('Removed ' + describePrune(pruneStorage(ctx.storageRoot, options)).replace(' removed', '') + '.');
-    nextStep('sandbox data   (see what else is saved, and clean it)');
-    return 0;
-}

package/dist/cli/commands/maintenance/config-share.d.ts

@@ -1,12 +0,0 @@
-import { type ImportPlan } from '../../menu/settings/index.js';
-import type { Context } from '../context.js';
-/** The file `config export` writes when none is named. */
-export declare const DEFAULT_EXPORT = "sandbox-settings.json";
-/** Writes the settings that differ from the defaults (no secrets, no storage, no paths unless asked) to `file`. */
-export declare function writeExport(ctx: Context, file: string, withPaths: boolean, overwrite: boolean): string[];
-/** Reads a shared file and plans the import. Fails with the reason when it cannot be read. */
-export declare function readImport(ctx: Context, file: string): ImportPlan;
-/** Writes the planned changes to your settings file (comments stay); returns how many settings changed. */
-export declare function applyImport(ctx: Context, plan: ImportPlan): number;
-export declare function exportCommand(ctx: Context, file: string | undefined): number;
-export declare function importCommand(ctx: Context, file: string | undefined): Promise<number>;

package/dist/cli/commands/maintenance/config-share.js

@@ -1,80 +0,0 @@
-// `sandbox config export` and `import`: your settings as a shareable .json, and a shared file read back in.
-import fs from 'node:fs';
-import path from 'node:path';
-import { askRequired } from '../../../core/prompt.js';
-import { fail, safeText, writeJson } from '../../../core/util/index.js';
-import { c } from '../../output/index.js';
-import { ConfigFile } from '../../../app/features/settings/index.js';
-import { diffText, exportSettings, planImport, skippedLine } from '../../menu/settings/index.js';
-/** The file `config export` writes when none is named. */
-export const DEFAULT_EXPORT = 'sandbox-settings.json';
-/** A shared file is a few KB; anything bigger is not one. */
-const MAX_BYTES = 1024 * 1024;
-/** Writes the settings that differ from the defaults (no secrets, no storage, no paths unless asked) to `file`. */
-export function writeExport(ctx, file, withPaths, overwrite) {
-    const target = path.resolve(file);
-    if (!overwrite && fs.existsSync(target))
-        fail(target + ' exists already.', 'Pick another name, or delete it first.');
-    const { data, skipped } = exportSettings(ctx.loaded.config, withPaths);
-    fs.mkdirSync(path.dirname(target), { recursive: true });
-    writeJson(target, data);
-    return skipped.map(skippedLine);
-}
-/** Reads a shared file and plans the import. Fails with the reason when it cannot be read. */
-export function readImport(ctx, file) {
-    const source = path.resolve(file);
-    if (!fs.existsSync(source))
-        fail('There is no file ' + source + '.', 'Give the path of a file made by sandbox config export.');
-    if (fs.statSync(source).size > MAX_BYTES)
-        fail(source + ' is too big to be a settings file.');
-    const plan = planImport(fs.readFileSync(source, 'utf8'), ctx.loaded.config);
-    if (plan.problems.length)
-        fail(source + ' is not valid settings:\n  ' + plan.problems.map(safeText).join('\n  '), 'Nothing was changed. Fix the file, or export a new one with: sandbox config export');
-    return plan;
-}
-/** Writes the planned changes to your settings file (comments stay); returns how many settings changed. */
-export function applyImport(ctx, plan) {
-    const outcome = ConfigFile.user(ctx.loaded.configPath).setMany(plan.changes);
-    if (typeof outcome === 'object')
-        fail('Could not import: ' + outcome.problems.join('; '), 'Nothing was written. Your settings are unchanged.');
-    return plan.changes.length;
-}
-export function exportCommand(ctx, file) {
-    const target = file ?? DEFAULT_EXPORT;
-    const skipped = writeExport(ctx, target, ctx.options.withPaths, false);
-    console.log('Wrote ' + path.resolve(target) + ' (only what differs from the defaults).');
-    if (skipped.length) {
-        console.log('Left out:');
-        for (const line of skipped)
-            console.log('  ' + line);
-    }
-    if (!ctx.options.withPaths && skipped.some((s) => s.includes('folder or file')))
-        console.log("Keep this PC's folders and files in the file with --with-paths.");
-    return 0;
-}
-export async function importCommand(ctx, file) {
-    if (!file)
-        fail('Which file?', 'Usage: sandbox config import <file>');
-    const plan = readImport(ctx, file);
-    if (plan.skipped.length) {
-        console.log('Not imported (never taken from a file):');
-        for (const s of plan.skipped)
-            console.log('  ' + safeText(skippedLine(s)));
-    }
-    if (!plan.changes.length) {
-        console.log('Nothing to change: your settings already match the file.');
-        return 0;
-    }
-    console.log('This would change ' + plan.changes.length + ' setting' + (plan.changes.length === 1 ? '' : 's') + ':');
-    for (const line of diffText(plan.lines))
-        console.log('  ' + safeText(line));
-    const yes = ctx.options.yes ||
-        (await askRequired('Change your settings like this?', 'Add --yes to change them without asking.'));
-    if (!yes) {
-        console.log('Nothing was changed.');
-        return 0;
-    }
-    const n = applyImport(ctx, plan);
-    console.log(c.green('Imported ' + n + ' setting' + (n === 1 ? '' : 's') + '.') + ' New sandboxes use them.');
-    return 0;
-}

package/dist/cli/commands/projects/projects.d.ts

@@ -1,2 +0,0 @@
-import { type Context } from '../context.js';
-export declare function projects(ctx: Context): Promise<number>;

package/dist/cli/commands/projects/projects.js

@@ -1,162 +0,0 @@
-// `sandbox projects`: which projects a sandbox can open without a restart. Project roots (whole folders of projects),
-// the projects this tool has started before, and the all-projects and exclude settings. Changes to what is mapped take
-// effect at the next start; a project you start while a sandbox runs joins it when it can (projects.ts in host/).
-import path from 'node:path';
-import { checkbox } from '@inquirer/prompts';
-import { askChoice } from '../../../core/prompt.js';
-import { fail } from '../../../core/util/index.js';
-import { isSandboxRunning } from '../../../host/sandbox/index.js';
-import { c, nextStep, pageSizeFor, shortenMiddle, termWidth, printJson, table } from '../../output/index.js';
-import { ProjectsService } from '../../services/index.js';
-const NEXT_START = 'This changes what is mapped from the next start.';
-function runningNote() {
-    return isSandboxRunning()
-        ? ' The running sandbox keeps what it has; start a project in it (sandbox claude there) and it joins without a restart when it can, or you are offered one.'
-        : '';
-}
-function list(ctx, service) {
-    const listing = service.list();
-    const rows = listing.projects;
-    if (printJson(ctx, { all: listing.all, roots: listing.roots, exclude: listing.exclude, projects: rows }))
-        return 0;
-    console.log(c.bold('All projects') +
-        ': ' +
-        (listing.all ? 'on (every project below is mapped at every start, except excluded ones)' : 'off') +
-        c.dim('   sandbox projects all on|off'));
-    console.log(c.bold('Roots') +
-        ': ' +
-        (listing.roots.length ? listing.roots.join(', ') : c.dim('none (sandbox projects roots add <folder>)')));
-    if (!rows.length) {
-        console.log('No projects yet: start one with sandbox claude in its folder.');
-        return 0;
-    }
-    const width = Math.max(20, termWidth() - 46);
-    table([
-        ['', 'FOLDER', 'AT START', 'RUNNING SANDBOX'],
-        ...rows.map((r) => [
-            r.here ? '*' : '',
-            shortenMiddle(r.folder, width),
-            r.root ? 'root' : r.excluded ? 'excluded' : r.mappedAtStart ? 'mapped' : '-',
-            r.running ?? '-',
-        ]),
-    ]);
-    console.log(c.dim('* = this folder.  Choose with: sandbox projects choose'));
-    return 0;
-}
-/** Ticks the projects mapped at every start (any ticked turns all-projects on); the rest are excluded. */
-async function choose(service) {
-    const rows = service.rows().filter((r) => !r.root);
-    if (!rows.length) {
-        console.log('No projects to choose from yet (projects in a root are always mapped with it). Start one with sandbox claude in its folder.');
-        return 0;
-    }
-    if (!process.stdin.isTTY)
-        fail('sandbox projects choose needs an interactive terminal.', 'Use sandbox projects include|exclude <folder> instead.');
-    const all = service.settings().all;
-    const picked = await checkbox({
-        message: 'Projects mapped at every start, so they open without a restart (every agent in the sandbox can see them):',
-        pageSize: pageSizeFor(rows.length),
-        choices: rows.map((r) => ({
-            value: r.folder,
-            name: shortenMiddle(r.folder, termWidth() - 12) + (r.here ? c.dim('  (this folder)') : ''),
-            checked: all && !r.excluded,
-        })),
-    });
-    const { mapped, excluded } = service.choose(rows, picked);
-    console.log(mapped + ' project(s) mapped at every start, ' + excluded + ' excluded. ' + NEXT_START + runningNote());
-    return 0;
-}
-/** The folder typed, or one picked from the known projects (or this folder) when it was left out. */
-async function folderOf(service, action, given) {
-    if (given)
-        return given;
-    const rows = service.rows();
-    return askChoice('Which folder?', [
-        { name: 'This folder (' + shortenMiddle(process.cwd(), termWidth() - 30) + ')', value: '.' },
-        ...rows.filter((r) => !r.here).map((r) => ({ name: shortenMiddle(r.folder, termWidth() - 12), value: r.folder })),
-    ], 'Usage: sandbox projects ' + action + ' <folder>   (. = this folder)');
-}
-function add(service, value) {
-    const dir = service.add(value);
-    const all = service.settings().all;
-    console.log('Added ' + dir + ' to your projects.' + (all ? ' ' + NEXT_START : ''));
-    if (!all)
-        nextStep('sandbox projects all on   (map every project at every start)');
-    return 0;
-}
-function remove(service, value) {
-    const { dir, removed } = service.forget(value);
-    console.log(removed
-        ? 'Removed ' + dir + ' from your projects (nothing in the folder was touched).'
-        : dir + ' was not in your projects.');
-    return 0;
-}
-function includeOrExclude(service, action, value) {
-    const changed = action === 'exclude' ? service.exclude(value) : service.include(value);
-    console.log((changed
-        ? (action === 'exclude' ? 'Excluded ' : 'Included ') + path.resolve(value) + '. ' + NEXT_START
-        : 'Nothing changed.') +
-        (action === 'include' && !service.settings().all
-            ? ' Mapping all projects is off: sandbox projects all on maps your projects at every start.'
-            : '') +
-        (changed ? runningNote() : ''));
-    return 0;
-}
-function all(service, value) {
-    if (value === undefined) {
-        console.log('Mapping all projects at every start is ' + (service.settings().all ? 'on' : 'off') + '.');
-        return 0;
-    }
-    service.setAll(value === 'on');
-    console.log('Mapping all projects at every start is ' +
-        value +
-        '. ' +
-        NEXT_START +
-        (value === 'on' ? ' Every agent in the sandbox can then see all of those projects.' : '') +
-        runningNote());
-    return 0;
-}
-function roots(service, value, folder) {
-    if (!value || value === 'list') {
-        const list = service.settings().roots;
-        console.log(list.length ? list.join('\n') : 'No project roots. Add one: sandbox projects roots add <folder>');
-        return 0;
-    }
-    if (value === 'add') {
-        const { dir, added } = service.addRoot(folder);
-        console.log(added
-            ? 'Added the project root ' +
-                dir +
-                ': every project in it (also new ones) opens without a restart. Every agent in the sandbox can see all of them. ' +
-                NEXT_START +
-                runningNote()
-            : dir + ' is a root already.');
-        return 0;
-    }
-    const { dir, removed } = service.removeRoot(folder);
-    console.log(removed ? 'Removed the project root ' + dir + '. ' + NEXT_START : dir + ' was not a root.');
-    return 0;
-}
-export async function projects(ctx) {
-    const [action = 'list', value, folder] = ctx.options.positionals;
-    const service = new ProjectsService(ctx);
-    switch (action) {
-        case 'list':
-            return list(ctx, service);
-        case 'choose':
-            return choose(service);
-        case 'add':
-            return add(service, await folderOf(service, action, value));
-        case 'remove':
-            return remove(service, await folderOf(service, action, value));
-        case 'include':
-        case 'exclude':
-            return includeOrExclude(service, action, await folderOf(service, action, value));
-        case 'all':
-            return all(service, value);
-        case 'roots':
-            return roots(service, value, folder);
-        default:
-            return fail('Unknown projects action "' + action + '".', 'Use: sandbox projects list | choose | add | remove | include | exclude | all | roots');
-    }
-}

package/dist/cli/commands/storage/contained.d.ts

@@ -1,3 +0,0 @@
-import type { Context } from '../context.js';
-/** `sandbox storage contained [status|on|off]`. */
-export declare function contained(ctx: Context): Promise<number>;

package/dist/cli/commands/storage/contained.js

@@ -1,179 +0,0 @@
-// `sandbox storage contained on|off|status` (beta): keep the data set's tools, state and logs in a
-// disk image that is mounted only while a sandbox runs. The work is in host/storage/contained; this file asks, shows
-// size and time, and prints.
-import fs from 'node:fs';
-import { userConfigPath } from '../../../core/config/index.js';
-import { humanBytes } from '../../../core/disk.js';
-import { askRequired } from '../../../core/prompt.js';
-import { fail } from '../../../core/util/index.js';
-import { isSandboxRunning, realContainedDeps } from '../../../host/sandbox/index.js';
-import { assertTargetsFree, containedAvailability, ContainedStorage, describeDuration, describeSize, planTransfer, runTransfer, setStateOf, StateFile, writeContainedSetting, } from '../../../host/storage/index.js';
-import { c, printJson, working } from '../../output/index.js';
-const BETA = 'Beta, and not yet tested on a real PC. ';
-function storageFor(ctx) {
-    const { config } = ctx.loaded;
-    return new ContainedStorage(realContainedDeps(ctx.storageRoot, config.storage.containedMaxGb), config.storage.dataName);
-}
-function requireAvailable() {
-    const check = containedAvailability();
-    if (!check.available)
-        fail('Contained storage cannot be used: ' + check.reasons.join(' '), check.fixes.join(' '));
-}
-function requireNoSandbox() {
-    if (isSandboxRunning())
-        fail('A sandbox is running.', 'Close it (sandbox stop) first: the folders in the image are in use.');
-}
-async function status(ctx) {
-    const storage = storageFor(ctx);
-    const check = containedAvailability();
-    const state = new StateFile(storage.paths).read();
-    const record = setStateOf(state, storage.set);
-    const reality = check.available && storage.imageExists() ? await storage.reality() : null;
-    const answer = {
-        setting: ctx.loaded.config.storage.contained,
-        maxGb: ctx.loaded.config.storage.containedMaxGb,
-        available: check.available,
-        reasons: check.reasons,
-        image: storage.paths.image,
-        imageExists: storage.imageExists(),
-        imageBytes: reality?.imageBytes ?? null,
-        mountFolder: storage.paths.mount,
-        recordedMounted: record.mounted,
-        holders: record.holders.length,
-        mountedNow: reality?.mountIsMountPoint ?? null,
-    };
-    if (printJson(ctx, answer))
-        return 0;
-    console.log(c.yellow('Contained storage (beta, untested on a real PC)'));
-    console.log('  setting:      storage.contained = ' + answer.setting + ' (limit ' + answer.maxGb + ' GB)');
-    console.log('  this PC:      ' +
-        (check.available ? 'can use it' : 'cannot use it: ' + check.reasons.join(' ') + ' ' + check.fixes.join(' ')));
-    console.log('  image:        ' +
-        answer.image +
-        (answer.imageExists ? ' (' + humanBytes(answer.imageBytes ?? 0) + ' on disk)' : ' (not made yet)'));
-    console.log('  mount folder: ' + answer.mountFolder);
-    if (reality)
-        console.log('  mounted now:  ' +
-            (reality.mountIsMountPoint ? 'yes' : 'no') +
-            (record.mounted !== reality.mountIsMountPoint
-                ? ' (the record says ' + (record.mounted ? 'yes' : 'no') + '; sandbox doctor looks into it)'
-                : ''));
-    console.log('\nTurn it on with: sandbox storage contained on   Turn it off with: sandbox storage contained off');
-    return 0;
-}
-function printPlan(plan, to) {
-    for (const f of plan.folders)
-        console.log('  ' + f.name + ': ' + describeSize(f.measured));
-    console.log('  total: ' + describeSize(plan.total) + ' to ' + to);
-    console.log('  time:  about ' + describeDuration(plan.estimate.seconds) + ' (copied, then the originals are removed)');
-    if (!plan.estimate.fits)
-        fail('Not enough free space for the copy.', 'Free some space on that drive and try again.');
-}
-async function turnOn(ctx) {
-    requireAvailable();
-    requireNoSandbox();
-    const storage = storageFor(ctx);
-    const { config } = ctx.loaded;
-    const configFile = ctx.loaded.configPath ?? userConfigPath();
-    console.log(c.yellow(BETA + 'Contained storage keeps the sandbox tools, state and logs in one disk image file.'));
-    console.log('  image:  ' + storage.paths.image + (storage.imageExists() ? ' (exists, it is used as it is)' : ''));
-    console.log('  limit:  ' + config.storage.containedMaxGb + ' GB (storage.containedMaxGb; the file grows only as it fills)');
-    console.log('  Windows asks for permission to mount it each time a sandbox starts (and once when it closes).');
-    if (!ctx.options.yes &&
-        !(await askRequired('Turn contained storage on?', 'Add --yes to turn it on without asking.', true)))
-        return fail('Nothing was changed.', 'Run sandbox storage contained on when you want it.');
-    const mount = await working('Making and mounting the image (Windows asks for permission)', () => storage.acquire({ id: 'cli', pid: process.pid }, { create: true }));
-    try {
-        const plan = planTransfer(ctx.dataPath, mount, ctx.storageRoot);
-        if (plan.folders.length > 0) {
-            console.log('\nThese folders hold your tools, state and logs now:');
-            printPlan(plan, 'the image');
-            assertTargetsFree(plan);
-            const move = ctx.options.yes || (await askRequired('Move them into the image?', 'Add --yes to move without asking.', true));
-            if (move) {
-                let line = 'Copying';
-                const result = await working(() => line, () => runTransfer(plan, ctx.dataPath, (p) => {
-                    line = 'Copying: ' + p.files.toLocaleString('en-US') + ' files, ' + humanBytes(p.bytes);
-                }));
-                console.log('Moved ' + result.files.toLocaleString('en-US') + ' files into the image.');
-                for (const note of result.notes)
-                    console.log(c.yellow(note));
-            }
-            else
-                console.log('They stay where they are and are not used: tools are downloaded again into the image. Delete them later with sandbox data clean.');
-        }
-        writeContainedSetting(configFile, 'vhdx');
-    }
-    finally {
-        const done = await working('Dismounting the image (Windows asks for permission)', () => storage.release('cli'));
-        if (!done.dismounted)
-            console.log(c.yellow('The image stays mounted (' + (done.note ?? '') + '). sandbox repair dismounts it.'));
-    }
-    console.log('Contained storage is on. sandbox launch mounts the image first.');
-    return 0;
-}
-async function turnOff(ctx) {
-    requireAvailable();
-    requireNoSandbox();
-    const storage = storageFor(ctx);
-    const configFile = ctx.loaded.configPath ?? userConfigPath();
-    console.log(c.yellow(BETA + 'Turning contained storage off moves the files back into plain folders.'));
-    if (!storage.imageExists()) {
-        writeContainedSetting(configFile, 'off');
-        console.log('There is no image, so there was nothing to move. Contained storage is off.');
-        return 0;
-    }
-    const mount = await working('Mounting the image (Windows asks for permission)', () => storage.acquire({ id: 'cli', pid: process.pid }));
-    let moved = false;
-    try {
-        const plan = planTransfer(mount, ctx.dataPath, ctx.dataPath);
-        if (plan.folders.length > 0) {
-            console.log('\nIn the image:');
-            printPlan(plan, ctx.dataPath);
-            assertTargetsFree(plan);
-            if (!ctx.options.yes &&
-                !(await askRequired('Move them back out of the image?', 'Add --yes to move without asking.', true)))
-                return fail('Nothing was moved.', 'Contained storage is still on.');
-            let line = 'Copying';
-            const result = await working(() => line, () => runTransfer(plan, mount, (p) => {
-                line = 'Copying: ' + p.files.toLocaleString('en-US') + ' files, ' + humanBytes(p.bytes);
-            }));
-            console.log('Moved ' + result.files.toLocaleString('en-US') + ' files back.');
-            for (const note of result.notes)
-                console.log(c.yellow(note));
-        }
-        writeContainedSetting(configFile, 'off');
-        moved = true;
-    }
-    finally {
-        const done = await working('Dismounting the image (Windows asks for permission)', () => storage.release('cli'));
-        if (!done.dismounted)
-            console.log(c.yellow('The image stays mounted (' + (done.note ?? '') + '). sandbox repair dismounts it.'));
-        else if (!moved)
-            console.log('The image was dismounted; contained storage is still on.');
-    }
-    console.log('Contained storage is off: tools, state and logs are plain folders in ' + ctx.dataPath + '.');
-    const bytes = fs.statSync(storage.paths.image).size;
-    if (!ctx.options.yes &&
-        (await askRequired('Delete the image file now (' + humanBytes(bytes) + ')? Everything in it was moved out.', 'Answer no to keep it.', false))) {
-        await storage.deleteImage();
-        console.log('Deleted ' + storage.paths.image + '.');
-    }
-    else
-        console.log('The image file is kept: ' + storage.paths.image + ' (delete it yourself when you are sure).');
-    return 0;
-}
-/** `sandbox storage contained [status|on|off]`. */
-export function contained(ctx) {
-    const [, mode = 'status'] = ctx.options.positionals;
-    switch (mode) {
-        case 'status':
-            return status(ctx);
-        case 'on':
-            return turnOn(ctx);
-        case 'off':
-            return turnOff(ctx);
-        default:
-            return Promise.resolve(fail('Unknown action "' + mode + '" for contained storage.', 'Use: sandbox storage contained on, off or status'));
-    }
-}

package/dist/cli/commands/storage/storage.d.ts

@@ -1,8 +0,0 @@
-import { type MoveResult } from '../../../host/storage/index.js';
-import { type Context } from '../context.js';
-/** Why a move cannot start (a background sync is still on a data folder in the old storage), or null. */
-export declare function storageBusy(root: string): string | null;
-/** Moves the data with progress on the terminal; remembers both folders. Used by the command and the start offer. */
-export declare function performMove(ctx: Context, to: string, keepOld: boolean): Promise<MoveResult>;
-/** `sandbox storage [show|move <folder>|use <folder>]`. */
-export declare function storage(ctx: Context): number | Promise<number>;