windows-development-sandbox 1.7.0 → 1.9.0

package/dist/cli/manifest.d.ts

@@ -205,34 +205,6 @@ declare const COMMAND_LIST: readonly [{
         group?: string | undefined;
         shownAs?: string | undefined;
     }];
-}, {
-    readonly name: "sessions";
-    readonly summary: "list agent sessions and who is attached";
-    readonly group: "Sessions";
-    readonly args: readonly [];
-    readonly options: readonly [{
-        flag: string;
-        type: "string" | "number" | "boolean" | "list";
-        description: string;
-        short?: string | undefined;
-        value?: string | undefined;
-        label?: string | undefined;
-        default?: string | number | undefined;
-        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
-        advanced?: boolean | undefined;
-        when?: string | undefined;
-        noMenu?: boolean | undefined;
-        group?: string | undefined;
-        shownAs?: string | undefined;
-    }];
-    readonly json: true;
-}, {
-    readonly name: "status";
-    readonly summary: "show what the sandbox is doing";
-    readonly group: "Sessions";
-    readonly args: readonly [];
-    readonly options: readonly [];
-    readonly json: true;
 }, {
     readonly name: "db";
     readonly summary: "list, start or stop databases in the running sandbox";
@@ -283,60 +255,6 @@ declare const COMMAND_LIST: readonly [{
     }];
     readonly passthrough: "command";
     readonly json: true;
-}, {
-    readonly name: "restart";
-    readonly summary: "restart this project's running agents in place; they resume their conversation";
-    readonly group: "Agents";
-    readonly args: readonly [];
-    readonly options: readonly [{
-        flag: string;
-        type: "string" | "number" | "boolean" | "list";
-        description: string;
-        short?: string | undefined;
-        value?: string | undefined;
-        label?: string | undefined;
-        default?: string | number | undefined;
-        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
-        advanced?: boolean | undefined;
-        when?: string | undefined;
-        noMenu?: boolean | undefined;
-        group?: string | undefined;
-        shownAs?: string | undefined;
-    }, {
-        flag: string;
-        type: "string" | "number" | "boolean" | "list";
-        description: string;
-        short?: string | undefined;
-        value?: string | undefined;
-        label?: string | undefined;
-        default?: string | number | undefined;
-        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
-        advanced?: boolean | undefined;
-        when?: string | undefined;
-        noMenu?: boolean | undefined;
-        group?: string | undefined;
-        shownAs?: string | undefined;
-    }];
-}, {
-    readonly name: "stop";
-    readonly summary: "shut the sandbox down (every project's sessions end)";
-    readonly group: "Agents";
-    readonly args: readonly [];
-    readonly options: readonly [{
-        flag: string;
-        type: "string" | "number" | "boolean" | "list";
-        description: string;
-        short?: string | undefined;
-        value?: string | undefined;
-        label?: string | undefined;
-        default?: string | number | undefined;
-        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
-        advanced?: boolean | undefined;
-        when?: string | undefined;
-        noMenu?: boolean | undefined;
-        group?: string | undefined;
-        shownAs?: string | undefined;
-    }];
 }, {
     readonly name: "projects";
     readonly summary: "the projects a sandbox can open without a restart: list, choose, roots, all/exclude";
@@ -374,18 +292,6 @@ declare const COMMAND_LIST: readonly [{
         group?: string | undefined;
         shownAs?: string | undefined;
     }];
-}, {
-    readonly name: "show";
-    readonly summary: "show the sandbox window";
-    readonly group: "Sessions";
-    readonly args: readonly [];
-    readonly options: readonly [];
-}, {
-    readonly name: "hide";
-    readonly summary: "hide the sandbox window (it keeps running)";
-    readonly group: "Sessions";
-    readonly args: readonly [];
-    readonly options: readonly [];
 }, {
     readonly name: "account";
     readonly summary: "Claude logins: list, save, use, set the default, remove";
@@ -510,19 +416,19 @@ declare const COMMAND_LIST: readonly [{
     readonly examples: readonly ["sandbox data clean                 pick what to delete from a list", "sandbox data clean logs tools/go   delete these"];
 }, {
     readonly name: "storage";
-    readonly summary: "where your saved data lives: show it, move it to another folder, or switch folders";
+    readonly summary: "where your saved data lives: show it, move it to another folder, switch folders, or (beta) keep it in a disk image";
     readonly group: "Data";
-    readonly examples: readonly ["sandbox storage                    where the data is", "sandbox storage move D:\\sandbox-data   move it (asks first)"];
+    readonly examples: readonly ["sandbox storage                    where the data is", "sandbox storage move D:\\sandbox-data   move it (asks first)", "sandbox storage contained status   (beta) the disk image for tools, state and logs", "sandbox storage contained on       (beta) keep them in a disk image (asks first)"];
     readonly args: readonly [{
         readonly name: "action";
-        readonly description: "show, move or use";
+        readonly description: "show, move, use or contained";
         readonly required: false;
-        readonly choices: readonly ["show", "move", "use"];
+        readonly choices: readonly ["show", "move", "use", "contained"];
     }, {
         readonly name: "folder";
-        readonly description: "the folder to move to, or to use";
+        readonly description: "the folder to move to, or to use; for contained: on, off or status";
         readonly required: false;
-        readonly when: readonly ["move", "use"];
+        readonly when: readonly ["move", "use", "contained"];
     }];
     readonly options: readonly [{
         flag: string;
@@ -554,6 +460,25 @@ declare const COMMAND_LIST: readonly [{
         shownAs?: string | undefined;
     }];
     readonly json: true;
+}, {
+    readonly name: "engine";
+    readonly summary: "(beta) what runs your sandbox (Windows Sandbox or HCS) and what each engine can do on this PC";
+    readonly group: "Health";
+    readonly examples: readonly ["sandbox engine                  the engine in use and what each can do", "sandbox engine check hcs        what this PC lacks for the HCS engine, and the commands that would fix it"];
+    readonly args: readonly [{
+        readonly name: "action";
+        readonly description: "show or check";
+        readonly required: false;
+        readonly choices: readonly ["show", "check"];
+    }, {
+        readonly name: "engine";
+        readonly description: "the engine to check";
+        readonly required: false;
+        readonly choices: readonly ["windows-sandbox", "hcs"];
+        readonly when: "check";
+    }];
+    readonly options: readonly [];
+    readonly json: true;
 }, {
     readonly name: "clean";
     readonly summary: "delete old launch folders, logs and leftovers";
@@ -646,6 +571,20 @@ declare const COMMAND_LIST: readonly [{
         noMenu?: boolean | undefined;
         group?: string | undefined;
         shownAs?: string | undefined;
+    }, {
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        label?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }];
 }, {
     readonly name: "setup";
@@ -867,13 +806,13 @@ declare const COMMAND_LIST: readonly [{
         readonly name: "action";
         readonly description: "what to do";
         readonly required: false;
-        readonly choices: readonly ["show", "path", "init", "schema", "check", "get", "set"];
+        readonly choices: readonly ["show", "path", "init", "schema", "check", "get", "set", "export", "import"];
         readonly aliases: readonly ["summary"];
     }, {
         readonly name: "key";
-        readonly description: "(get, set) the setting, e.g. sandbox.memoryMb";
+        readonly description: "(get, set, reset) the setting, e.g. sandbox.memoryMb; (export, import) the .json file";
         readonly required: false;
-        readonly when: readonly ["get", "set"];
+        readonly when: readonly ["get", "set", "export", "import"];
     }, {
         readonly name: "value";
         readonly description: "(set) the new value";
@@ -894,8 +833,36 @@ declare const COMMAND_LIST: readonly [{
         noMenu?: boolean | undefined;
         group?: string | undefined;
         shownAs?: string | undefined;
+    }, {
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        label?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
+    }, {
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        label?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }];
-    readonly examples: readonly ["sandbox config set sandbox.memoryMb 8192", "sandbox config get sandbox.memoryMb"];
+    readonly examples: readonly ["sandbox config set sandbox.memoryMb 8192", "sandbox config get sandbox.memoryMb", "sandbox config reset sandbox.memoryMb", "sandbox config list", "sandbox config export team-settings.json", "sandbox config import team-settings.json"];
 }, {
     readonly name: "agent-commands";
     readonly summary: "(Beta) make claude, codex ... on this PC start in a hidden sandbox and attach";
@@ -1006,6 +973,7 @@ declare const COMMAND_LIST: readonly [{
     readonly options: readonly [];
     readonly hidden: true;
 }];
+/** The hand-written commands (the shared core's own commands are not in this union). */
 export type CommandName = (typeof COMMAND_LIST)[number]['name'];
 export declare const COMMANDS: CommandSpec[];
 export declare function commandSpec(name: string): CommandSpec | undefined;

package/dist/cli/manifest.js

@@ -1,6 +1,10 @@
 // Every command, defined once: name, group, arguments and options with their types. args.ts builds the commander
-// parser from it and menu.ts builds the interactive menu from it, so a command added here works both ways.
+// parser from it and menu.ts builds the interactive menu from it, so a command added here works both ways. Commands of
+// the shared core (status, sessions, stop ... and actions such as config get) come from their definitions' CLI hints
+// (cli/operations/spec.ts); this list shrinks as areas move into src/app.
 import { z } from 'zod';
+// The file rather than the barrel: the barrel's handlers need the registry, which needs the commands.
+import { withOperationCommands } from './operations/spec.js';
 const ChoicesSchema = z
     .union([z.array(z.string()), z.enum(['harnesses', 'accounts', 'sessions'])])
     .describe('Fixed values, or a list the menu fills in at run time.');
@@ -208,15 +212,6 @@ const COMMAND_LIST = [
             bool('--auto', 'used by the background sync after a crash: no questions', { noMenu: true, advanced: true }),
         ],
     },
-    {
-        name: 'sessions',
-        summary: 'list agent sessions and who is attached',
-        group: 'Sessions',
-        args: [],
-        options: [bool('--wide', "also show each session's folder", { noMenu: true })],
-        json,
-    },
-    { name: 'status', summary: 'show what the sandbox is doing', group: 'Sessions', args: [], options: [], json },
     {
         name: 'db',
         summary: 'list, start or stop databases in the running sandbox',
@@ -254,23 +249,6 @@ const COMMAND_LIST = [
         passthrough: 'command',
         json,
     },
-    {
-        name: 'restart',
-        summary: "restart this project's running agents in place; they resume their conversation",
-        group: 'Agents',
-        args: [],
-        options: [
-            text('--harness', 'name', 'only this agent', { choices: 'harnesses', shownAs: '--agent' }),
-            bool('--all', "every project's sessions, not only this folder's"),
-        ],
-    },
-    {
-        name: 'stop',
-        summary: "shut the sandbox down (every project's sessions end)",
-        group: 'Agents',
-        args: [],
-        options: [bool('--yes', "do not ask when other projects' sessions would end", { short: '-y', noMenu: true })],
-    },
     {
         name: 'projects',
         summary: 'the projects a sandbox can open without a restart: list, choose, roots, all/exclude',
@@ -298,8 +276,6 @@ const COMMAND_LIST = [
         ],
         options: [bool('--yes', 'do not ask before removing', { short: '-y', when: 'remove', noMenu: true })],
     },
-    { name: 'show', summary: 'show the sandbox window', group: 'Sessions', args: [], options: [] },
-    { name: 'hide', summary: 'hide the sandbox window (it keeps running)', group: 'Sessions', args: [], options: [] },
     {
         name: 'account',
         summary: 'Claude logins: list, save, use, set the default, remove',
@@ -358,15 +334,27 @@ const COMMAND_LIST = [
     },
     {
         name: 'storage',
-        summary: 'where your saved data lives: show it, move it to another folder, or switch folders',
+        summary: 'where your saved data lives: show it, move it to another folder, switch folders, or (beta) keep it in a disk image',
         group: 'Data',
         examples: [
             'sandbox storage                    where the data is',
             'sandbox storage move D:\\sandbox-data   move it (asks first)',
+            'sandbox storage contained status   (beta) the disk image for tools, state and logs',
+            'sandbox storage contained on       (beta) keep them in a disk image (asks first)',
         ],
         args: [
-            { name: 'action', description: 'show, move or use', required: false, choices: ['show', 'move', 'use'] },
-            { name: 'folder', description: 'the folder to move to, or to use', required: false, when: ['move', 'use'] },
+            {
+                name: 'action',
+                description: 'show, move, use or contained',
+                required: false,
+                choices: ['show', 'move', 'use', 'contained'],
+            },
+            {
+                name: 'folder',
+                description: 'the folder to move to, or to use; for contained: on, off or status',
+                required: false,
+                when: ['move', 'use', 'contained'],
+            },
         ],
         options: [
             bool('--yes', 'do not ask before moving or switching', { short: '-y', noMenu: true }),
@@ -374,6 +362,27 @@ const COMMAND_LIST = [
         ],
         json,
     },
+    {
+        name: 'engine',
+        summary: '(beta) what runs your sandbox (Windows Sandbox or HCS) and what each engine can do on this PC',
+        group: 'Health',
+        examples: [
+            'sandbox engine                  the engine in use and what each can do',
+            'sandbox engine check hcs        what this PC lacks for the HCS engine, and the commands that would fix it',
+        ],
+        args: [
+            { name: 'action', description: 'show or check', required: false, choices: ['show', 'check'] },
+            {
+                name: 'engine',
+                description: 'the engine to check',
+                required: false,
+                choices: ['windows-sandbox', 'hcs'],
+                when: 'check',
+            },
+        ],
+        options: [],
+        json,
+    },
     {
         name: 'clean',
         summary: 'delete old launch folders, logs and leftovers',
@@ -410,7 +419,10 @@ const COMMAND_LIST = [
         summary: 'print the newest sandbox log',
         group: 'Health',
         args: [],
-        options: [bool('--follow', 'keep printing new lines', { short: '-f' })],
+        options: [
+            bool('--follow', 'keep printing new lines', { short: '-f' }),
+            bool('--crash', 'print the report of the last crash (what Windows logged, this PC and the sandbox memory)'),
+        ],
     },
     {
         name: 'setup',
@@ -494,19 +506,30 @@ const COMMAND_LIST = [
                 name: 'action',
                 description: 'what to do',
                 required: false,
-                choices: ['show', 'path', 'init', 'schema', 'check', 'get', 'set'],
+                choices: ['show', 'path', 'init', 'schema', 'check', 'get', 'set', 'export', 'import'],
                 aliases: ['summary'],
             },
             {
                 name: 'key',
-                description: '(get, set) the setting, e.g. sandbox.memoryMb',
+                description: '(get, set, reset) the setting, e.g. sandbox.memoryMb; (export, import) the .json file',
                 required: false,
-                when: ['get', 'set'],
+                when: ['get', 'set', 'export', 'import'],
             },
             { name: 'value', description: '(set) the new value', required: false, when: 'set' },
         ],
-        options: [text('--workspace', 'dir', '(check) the project folder; default: the current one')],
-        examples: ['sandbox config set sandbox.memoryMb 8192', 'sandbox config get sandbox.memoryMb'],
+        options: [
+            text('--workspace', 'dir', '(check) the project folder; default: the current one'),
+            bool('--with-paths', '(export) keep folders and files of this PC in the file', { when: 'export' }),
+            bool('--yes', '(import) do not ask before changing your settings', { short: '-y', when: 'import', noMenu: true }),
+        ],
+        examples: [
+            'sandbox config set sandbox.memoryMb 8192',
+            'sandbox config get sandbox.memoryMb',
+            'sandbox config reset sandbox.memoryMb',
+            'sandbox config list',
+            'sandbox config export team-settings.json',
+            'sandbox config import team-settings.json',
+        ],
     },
     {
         name: 'agent-commands',
@@ -585,7 +608,9 @@ const COMMAND_LIST = [
         hidden: true,
     },
 ];
-export const COMMANDS = z.array(CommandSpecSchema).parse(COMMAND_LIST);
+export const COMMANDS = z
+    .array(CommandSpecSchema)
+    .parse(withOperationCommands(z.array(CommandSpecSchema).parse(COMMAND_LIST)));
 export function commandSpec(name) {
     return COMMANDS.find((c) => c.name === name);
 }

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

@@ -1,6 +1,6 @@
 import type { Harness } from '../../core/types.js';
 import type { App } from '../tui/index.js';
-import type { ConfigFile } from './settings/config-file.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';

package/dist/cli/menu/add-agent.js

@@ -5,7 +5,7 @@
 import { DEFAULTS } from '../../core/config/index.js';
 import { HarnessSchema, NameSchema, describeIssues } from '../../core/schema/index.js';
 import { fail } from '../../core/util/index.js';
-import { askPath } from './settings/path-kind.js';
+import { askPath } from './settings/ask-path.js';
 /** Nothing wrong with the name (true), or what is wrong. Pure. */
 export function agentNameProblem(name, taken) {
     const typed = name.trim();

package/dist/cli/menu/apps.d.ts

@@ -1,6 +1,6 @@
 import { type AppCategory, type AppEntry } from '../../shared/apps/index.js';
 import { type Category, type ListItem } from '../tui/index.js';
-import type { ConfigFile } from './settings/config-file.js';
+import type { ConfigFile } from '../../app/features/settings/index.js';
 import type { Draft } from './settings/draft.js';
 export declare const CUSTOM = "@custom:";
 /** The catalogue has many small categories; the menu shows these few groups so the navigation stays short. */
@@ -32,6 +32,12 @@ export declare const APP_GROUPS: readonly [{
 }];
 /** The group an app category is shown under. */
 export declare function groupOf(category: AppCategory): string;
+/** The row in Apps that opens the "request an app" issue form (its id is not an app). */
+export declare const REQUEST_APP = "@request-app";
+/** This project's new-issue page on GitHub. */
+export declare const ISSUES_URL = "https://github.com/JoshDiDuca/windows-development-sandbox/issues/new";
+/** The new-issue address with a title and a body to fill in (the page needs no login to show it). */
+export declare function requestAppUrl(): string;
 export declare class AppsModel {
     private readonly file;
     private readonly dataPath;

package/dist/cli/menu/apps.js

@@ -45,6 +45,30 @@ export function groupOf(category) {
     return APP_GROUPS.find((g) => g.members.includes(category))?.id ?? 'tools';
 }
 const INSTALL = ['apps', 'install'];
+/** The row in Apps that opens the "request an app" issue form (its id is not an app). */
+export const REQUEST_APP = '@request-app';
+/** This project's new-issue page on GitHub. */
+export const ISSUES_URL = 'https://github.com/JoshDiDuca/windows-development-sandbox/issues/new';
+/** The new-issue address with a title and a body to fill in (the page needs no login to show it). */
+export function requestAppUrl() {
+    const body = [
+        '**App name:**',
+        '',
+        '**Where to get it** (GitHub releases page or a direct download link):',
+        '',
+        '**What it is for:**',
+        '',
+        '**Command-line tool or desktop app?**',
+        '',
+        '**Does it need a GPU, a license or an account?**',
+    ].join('\n');
+    const query = [
+        ['title', 'App request: '],
+        ['body', body],
+        ['labels', 'app-request'],
+    ];
+    return ISSUES_URL + '?' + query.map(([k, v]) => k + '=' + encodeURIComponent(v)).join('&');
+}
 export class AppsModel {
     file;
     dataPath;
@@ -137,6 +161,18 @@ export class AppsModel {
     items(draft) {
         return [
             ...this.entries().map((a) => this.item(a, draft)),
+            ...(this.file.isProject
+                ? []
+                : [
+                    {
+                        value: REQUEST_APP,
+                        label: 'Request an app…',
+                        category: 'custom',
+                        description: 'Not in the list? Press r: your browser opens a prefilled request on GitHub (' + ISSUES_URL + ').',
+                        hint: Theme.muted('press r'),
+                        disabled: 'Press r to open the request form on GitHub.',
+                    },
+                ]),
             ...Object.entries(this.custom(draft)).map(([id, a]) => ({
                 value: CUSTOM + id,
                 label: a.name,

package/dist/cli/menu/command-fields.d.ts

@@ -1,5 +1,5 @@
 import { type ArgSpec, type OptionSpec } from '../manifest.js';
-import type { PathKind } from './settings/path-kind.js';
+import type { PathKind } from '../../app/kernel/index.js';
 /** What an option accepts, checked while typing (undefined = fine). */
 export declare function optionProblem(o: OptionSpec, v: string): string | undefined;
 export type Field = {

package/dist/cli/menu/command-form.js

@@ -16,8 +16,8 @@ import { askedWhen } from '../manifest.js';
 import { Text, Theme } from '../tui/index.js';
 import { actionOf, argLabel, argPathKind, optionLabel, optionPathKind, optionProblem, plainDescription, plainSummary, } from './command-fields.js';
 import { StringListEditor } from './settings/collections/string-list-editor.js';
-import { askPath } from './settings/path-kind.js';
-import { SchemaNode } from './settings/schema-node.js';
+import { askPath } from './settings/ask-path.js';
+import { SchemaNode } from '../../app/kernel/index.js';
 import { ValueEditor } from './settings/value-editor.js';
 const MORE = '@more';
 const OTHER = '@other';

package/dist/cli/menu/io-menu.d.ts

@@ -0,0 +1,29 @@
+import { type Action, type AnyDefinition } from '../../app/kernel/index.js';
+import type { Context } from '../commands/context.js';
+import { type App } from '../tui/index.js';
+import type { ShellExit } from './shell.js';
+/** Where the dialogs say they are (the menu's path line). */
+type Where = readonly string[];
+/** How a page shows progress while an operation runs (ListPage.busy). */
+export type ShowBusy = (text: string) => void;
+/** What an action did: leave the menu to run a command, and/or a notice after the page loads again. */
+export interface Performed {
+    readonly exit?: ShellExit;
+    readonly notice?: string;
+    readonly reload?: boolean;
+}
+export declare class MenuOperations {
+    private readonly app;
+    private readonly ctx;
+    constructor(app: App, ctx: Context);
+    /** Does what an action of a page says: follows a link, or asks for its fields and runs its operation. */
+    perform(action: Action, where: Where, busy?: ShowBusy): Promise<Performed>;
+    /** The values of an action's fields, from the editors that fit them (undefined: one was backed out of). */
+    private fields;
+    /**
+     * Runs a definition with this input and returns the notice to show: its text (✓), the problem and its fix (✘), or
+     * undefined when a question was declined (nothing changed, nothing to say).
+     */
+    run(def: AnyDefinition, input: unknown, where: Where, busy?: ShowBusy): Promise<string | undefined>;
+}
+export {};