windows-development-sandbox 1.10.0 → 1.11.3

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>;

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

@@ -1,179 +0,0 @@
-// `sandbox storage`: where everything kept between sandboxes lives, moving it to another folder (with the size, an
-// estimate and a warning first) and switching to a folder without moving. The work is in host/storage.
-import fs from 'node:fs';
-import path from 'node:path';
-import { userConfigPath, userDir } from '../../../core/config/index.js';
-import { diskUsage, humanBytes } from '../../../core/disk.js';
-import { askChoice, askName, askRequired } from '../../../core/prompt.js';
-import { expandPath, fail } from '../../../core/util/index.js';
-import { describeDuration, describeSize, estimate, holdsData, measureFolder, mountedSets, moveWarning, otherDataFolders, sharedDefaultRoot, StorageHistory, StorageMove, } from '../../../host/storage/index.js';
-import { isSandboxRunning } from '../../../host/sandbox/index.js';
-import { protectPrivateFolder } from '../../../host/sharing/index.js';
-import { watcherRunning } from '../../../sync/index.js';
-import { printJson, working } from '../../output/index.js';
-import { requireOnPc } from '../context.js';
-import { contained } from './contained.js';
-/** Why a move cannot start (a background sync is still on a data folder in the old storage), or null. */
-export function storageBusy(root) {
-    const mounted = mountedSets(root);
-    if (mounted.length > 0)
-        return ('The contained storage of "' +
-            mounted.join('", "') +
-            '" is mounted (a disk image; moving now would reach into it).');
-    const data = path.join(root, 'data');
-    try {
-        for (const name of fs.readdirSync(data))
-            if (watcherRunning(path.join(data, name)))
-                return 'The background sync of "' + name + '" is still finishing.';
-    }
-    catch {
-        // no data folder: nothing runs
-    }
-    return null;
-}
-function mover(ctx) {
-    return new StorageMove(ctx.loaded.configPath ?? userConfigPath(), () => storageBusy(ctx.storageRoot), isSandboxRunning, protectPrivateFolder);
-}
-/** The path as typed (variables and ~ expand, relative to the current folder). */
-function typedPath(value) {
-    return expandPath(value, process.cwd());
-}
-/** The folder typed, or picked from the default folder, folders that hold data and the drives (or typed in). */
-async function folderOf(ctx, value, what) {
-    if (value)
-        return typedPath(value);
-    const fix = 'Use: sandbox storage ' + what + ' <folder>';
-    const typed = 'type';
-    const known = [sharedDefaultRoot(), ...otherDataFolders(ctx.storageRoot, new StorageHistory(userDir()))];
-    const drives = diskUsage(ctx.storageRoot)
-        .filter((d) => !d.holdsStorage)
-        .map((d) => path.join(d.drive, 'AgentSandbox'));
-    const choices = [...new Set([...known, ...drives])]
-        .filter((f) => f.toLowerCase() !== ctx.storageRoot.toLowerCase())
-        .map((f) => ({ name: f, value: f }));
-    const picked = await askChoice('Which folder?', [...choices, { name: 'Type a path...', value: typed }], fix);
-    if (picked !== typed)
-        return picked;
-    const answer = await askName('Folder:', fix, (v) => v.length > 0 || 'Type a folder path.');
-    return typedPath(answer);
-}
-async function show(ctx) {
-    const history = new StorageHistory(userDir());
-    const measured = await working('Measuring your saved data (big folders take a moment)', () => measureFolder(ctx.storageRoot), !ctx.options.json);
-    const others = otherDataFolders(ctx.storageRoot, history);
-    const shared = sharedDefaultRoot();
-    if (printJson(ctx, {
-        root: ctx.storageRoot,
-        exists: fs.existsSync(ctx.storageRoot),
-        ...measured,
-        defaultRoot: shared,
-        otherFoldersWithData: others,
-    }))
-        return 0;
-    const inUse = shared.toLowerCase() === ctx.storageRoot.toLowerCase() ? ' (in use)' : '';
-    console.log('Your saved data is in: ' + ctx.storageRoot);
-    console.log('  ' + (holdsData(ctx.storageRoot) ? describeSize(measured) : 'nothing in it yet'));
-    console.log('The default folder is: ' + shared + inUse);
-    for (const other of others)
-        console.log('Another folder with data: ' + other);
-    console.log('\nMove it with: sandbox storage move <folder>  (or switch without moving: sandbox storage use <folder>)');
-    console.log('What takes the space: sandbox data');
-    return 0;
-}
-function printPlan(from, to, measured, copyOnly) {
-    const est = estimate(from, to, measured, copyOnly);
-    const time = est.sameVolume
-        ? 'a few seconds (same drive, nothing is copied)'
-        : describeDuration(est.seconds) + ' (copied to another drive)';
-    console.log('Move from: ' + from);
-    console.log('       to: ' + to);
-    console.log('     size: ' + describeSize(measured));
-    console.log('     time: ' + time);
-    const warning = moveWarning(measured, est);
-    if (warning)
-        console.log('Warning: ' + warning);
-    if (!est.fits)
-        fail('Not enough free space on the target drive.', 'Free some space or pick another drive.');
-}
-/** Moves the data with progress on the terminal; remembers both folders. Used by the command and the start offer. */
-export async function performMove(ctx, to, keepOld) {
-    const from = ctx.storageRoot;
-    const history = new StorageHistory(userDir());
-    let line = 'Moving your data';
-    const result = await working(() => line, () => mover(ctx).move(from, to, {
-        keepOld,
-        onProgress: (p) => {
-            line = 'Copying: ' + p.files.toLocaleString('en-US') + ' files, ' + humanBytes(p.bytes);
-        },
-    }));
-    history.remember(from);
-    history.remember(to);
-    return result;
-}
-async function move(ctx) {
-    const to = await folderOf(ctx, ctx.options.positionals[1], 'move');
-    const from = ctx.storageRoot;
-    if (!fs.existsSync(from))
-        fail('There is nothing to move: ' + from + ' does not exist.', 'Use sandbox storage use ' + to + ' to switch.');
-    mover(ctx).validate(from, to);
-    const measured = await working('Measuring your saved data', () => measureFolder(from), !ctx.options.json);
-    const keepOld = ctx.options.keepOld;
-    printPlan(from, to, measured, keepOld);
-    if (!ctx.options.yes) {
-        if (!(await askRequired('Move your data to ' + to + '?', 'Add --yes to move without asking.', true))) {
-            console.log('Nothing was moved.');
-            return 1;
-        }
-    }
-    const result = await performMove(ctx, to, keepOld);
-    if (printJson(ctx, result))
-        return 0;
-    const left = result.removedOld ? '' : '; the old folder is still at ' + result.from;
-    console.log('Moved ' + result.files.toLocaleString('en-US') + ' files. Your data is now in ' + result.to + left + '.');
-    for (const note of result.notes)
-        console.log(note);
-    console.log('Your settings now point to ' + result.pinned + ', so older versions find the data too.');
-    return 0;
-}
-async function use(ctx) {
-    const to = await folderOf(ctx, ctx.options.positionals[1], 'use');
-    if (to.toLowerCase() === ctx.storageRoot.toLowerCase()) {
-        console.log('That folder is in use already.');
-        return 0;
-    }
-    const busy = storageBusy(ctx.storageRoot);
-    if (busy)
-        fail(busy, 'Wait a minute, then try again.');
-    const state = holdsData(to)
-        ? to + ' is used as it is.'
-        : to + ' starts empty: tools, logins and history are set up again.';
-    console.log('Warning: your data stays in ' + ctx.storageRoot + '. ' + state);
-    if (!ctx.options.yes) {
-        if (!(await askRequired('Use ' + to + ' from now on, without moving your data?', 'Add --yes to switch without asking.'))) {
-            console.log('Nothing was changed.');
-            return 1;
-        }
-    }
-    new StorageHistory(userDir()).remember(ctx.storageRoot);
-    mover(ctx).pin(to);
-    console.log('Your data is now looked for in ' + to + '. Move it later with: sandbox storage move <folder>');
-    return 0;
-}
-/** `sandbox storage [show|move <folder>|use <folder>]`. */
-export function storage(ctx) {
-    requireOnPc('storage');
-    const [action = 'show'] = ctx.options.positionals;
-    switch (action) {
-        case 'show':
-        case 'info':
-            return show(ctx);
-        case 'move':
-            return move(ctx);
-        case 'use':
-            return use(ctx);
-        case 'contained':
-            return contained(ctx);
-        default:
-            return fail('Unknown storage action "' + action + '".', 'Use: sandbox storage, sandbox storage move <folder>, sandbox storage use <folder> or sandbox storage contained on|off|status');
-    }
-}

package/dist/cli/menu/add-agent.d.ts

@@ -1,47 +0,0 @@
-import type { Harness } from '../../core/types.js';
-import type { App } from '../tui/index.js';
-import type { ConfigFile } from '../../app/features/settings/index.js';
-import type { Draft } from './settings/draft.js';
-/** How a new agent gets into the sandbox. */
-export type AgentSource = 'npm' | 'uv' | 'host';
-/** Nothing wrong with the name (true), or what is wrong. Pure. */
-export declare function agentNameProblem(name: string, taken: readonly string[]): true | string;
-/** The command a package usually provides: "@scope/my-agent@latest" gives "my-agent". Pure. */
-export declare function commandFromPackage(pkg: string): string;
-/** The config entry for a new agent. Pure. */
-export declare function newAgent(source: AgentSource, what: string, command: string, hostDir?: string): Harness;
-/** What `harnesses` should say with `name` taken out. Pure. */
-export declare function withoutAgent(current: unknown, name: string): Record<string, unknown>;
-/** Writes a setting to your config file now, or adds it to the unsaved changes when it has some already. */
-export declare function writeOrStage(file: ConfigFile, draft: Draft, key: string[], value: unknown): {
-    saved: boolean;
-};
-/** What `harnesses` should say with `name` added to what is staged or in the file now. Pure. */
-export declare function withAgent(current: unknown, name: string, harness: Harness): Record<string, unknown>;
-/** Makes `name` the agent that starts by default (written now, or joined to unsaved changes to that setting). */
-export declare function makeDefaultAgent(file: ConfigFile, draft: Draft, name: string): {
-    saved: boolean;
-};
-/** Takes an agent you added out of your settings (the built-in ones are not removable). */
-export declare function removeAgent(file: ConfigFile, draft: Draft, name: string): {
-    saved: boolean;
-};
-export interface AddedAgent {
-    readonly name: string;
-    /** Written to your config file now (false: waiting for Ctrl+S with the other unsaved changes). */
-    readonly saved: boolean;
-}
-export declare class AddAgent {
-    private readonly app;
-    private readonly file;
-    private readonly draft;
-    /** Every agent that exists now (the new name must be different). */
-    private readonly taken;
-    constructor(app: App, file: ConfigFile, draft: Draft, 
-    /** Every agent that exists now (the new name must be different). */
-    taken: readonly string[]);
-    /** Asks, then adds the agent. Undefined when you backed out. */
-    run(): Promise<AddedAgent | undefined>;
-    /** Validates and writes (or stages) the entry. */
-    private add;
-}