windows-development-sandbox 1.4.0 → 1.4.3

package/dist/cli/manifest.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-export declare const OptionSpec: z.ZodObject<{
+export declare const OptionSpecSchema: z.ZodObject<{
     flag: z.ZodString;
     short: z.ZodOptional<z.ZodString>;
     type: z.ZodEnum<{
@@ -20,7 +20,7 @@ export declare const OptionSpec: z.ZodObject<{
     when: z.ZodOptional<z.ZodString>;
     noMenu: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
-export declare const ArgSpec: z.ZodObject<{
+export declare const ArgSpecSchema: z.ZodObject<{
     name: z.ZodString;
     description: z.ZodString;
     required: z.ZodBoolean;
@@ -33,8 +33,8 @@ export declare const ArgSpec: z.ZodObject<{
     when: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
 }, z.core.$strict>;
 /** Is an argument or option with this `when` asked, given the first argument's answer? */
-export declare const askedWhen: (when: string | string[] | undefined, first: string) => boolean;
-export declare const Group: z.ZodEnum<{
+export declare function askedWhen(when: string | string[] | undefined, first: string): boolean;
+export declare const GroupSchema: z.ZodEnum<{
     Agents: "Agents";
     Sandbox: "Sandbox";
     Sessions: "Sessions";
@@ -43,7 +43,7 @@ export declare const Group: z.ZodEnum<{
     Health: "Health";
     Config: "Config";
 }>;
-export declare const CommandSpec: z.ZodObject<{
+export declare const CommandSpecSchema: z.ZodObject<{
     name: z.ZodString;
     summary: z.ZodString;
     group: z.ZodEnum<{
@@ -96,8 +96,462 @@ export declare const CommandSpec: z.ZodObject<{
     interactive: z.ZodOptional<z.ZodBoolean>;
     hidden: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
-export type OptionSpecT = z.output<typeof OptionSpec>;
-export type ArgSpecT = z.output<typeof ArgSpec>;
-export type CommandSpecT = z.output<typeof CommandSpec>;
-export declare const COMMANDS: CommandSpecT[];
-export declare const commandSpec: (name: string) => CommandSpecT | undefined;
+export type OptionSpec = z.output<typeof OptionSpecSchema>;
+export type ArgSpec = z.output<typeof ArgSpecSchema>;
+export type CommandSpec = z.output<typeof CommandSpecSchema>;
+declare const COMMAND_LIST: readonly [{
+    readonly name: "launch";
+    readonly summary: "start the sandbox and an agent (or another session in the running sandbox)";
+    readonly group: "Agents";
+    readonly args: readonly [];
+    readonly options: {
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+    }[];
+    readonly passthrough: "agent";
+    readonly interactive: true;
+}, {
+    readonly name: "start";
+    readonly summary: "start a sandbox with no agent (tools and databases only)";
+    readonly group: "Sandbox";
+    readonly args: readonly [];
+    readonly options: {
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+    }[];
+    readonly interactive: true;
+}, {
+    readonly name: "generate";
+    readonly summary: "show what a start would do, without starting anything";
+    readonly group: "Health";
+    readonly args: readonly [];
+    readonly options: {
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+    }[];
+    readonly passthrough: "agent";
+}, {
+    readonly name: "attach";
+    readonly summary: "show a running session in this terminal (Ctrl+] detaches)";
+    readonly group: "Sessions";
+    readonly args: readonly [{
+        readonly name: "id";
+        readonly description: "session (default: the newest)";
+        readonly required: false;
+        readonly choices: "sessions";
+    }];
+    readonly options: readonly [];
+    readonly interactive: true;
+}, {
+    readonly name: "sessions";
+    readonly summary: "list agent sessions and who is attached";
+    readonly group: "Sessions";
+    readonly args: readonly [];
+    readonly options: readonly [];
+    readonly json: true;
+}, {
+    readonly name: "status";
+    readonly summary: "show what the sandbox is doing";
+    readonly group: "Sandbox";
+    readonly args: readonly [];
+    readonly options: readonly [];
+    readonly json: true;
+}, {
+    readonly name: "db";
+    readonly summary: "list, start or stop databases in the running sandbox";
+    readonly group: "Sandbox";
+    readonly args: readonly [{
+        readonly name: "action";
+        readonly description: "list, start or stop";
+        readonly required: false;
+        readonly choices: readonly ["list", "start", "stop"];
+    }, {
+        readonly name: "name";
+        readonly description: "postgres, mysql, mongodb, redis or dynamodb";
+        readonly required: false;
+        readonly choices: readonly ["postgres", "mysql", "mongodb", "redis", "dynamodb"];
+    }];
+    readonly options: readonly [];
+}, {
+    readonly name: "exec";
+    readonly summary: "run a command inside the sandbox and print its output";
+    readonly group: "Sandbox";
+    readonly args: readonly [{
+        readonly name: "command";
+        readonly description: "command and its arguments";
+        readonly required: true;
+        readonly variadic: true;
+    }];
+    readonly options: readonly [{
+        readonly flag: "--timeout";
+        readonly type: "number";
+        readonly value: "seconds";
+        readonly description: "give up after this many seconds";
+        readonly default: 600;
+    }, {
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+    }];
+    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: "Sessions";
+    readonly args: readonly [];
+    readonly options: readonly [{
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+    }, {
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+    }];
+}, {
+    readonly name: "stop";
+    readonly summary: "shut the sandbox down (every project's sessions end)";
+    readonly group: "Sandbox";
+    readonly args: readonly [];
+    readonly options: readonly [{
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+    }];
+}, {
+    readonly name: "projects";
+    readonly summary: "the projects a sandbox can open without a restart: list, choose, roots, all/exclude";
+    readonly group: "Sandbox";
+    readonly json: true;
+    readonly args: readonly [{
+        readonly name: "action";
+        readonly description: "list, choose, add, remove, include, exclude, all, roots";
+        readonly required: false;
+        readonly choices: readonly ["list", "choose", "add", "remove", "include", "exclude", "all", "roots"];
+    }, {
+        readonly name: "value";
+        readonly description: "a folder (add, remove, include, exclude), on/off (all), or list/add/remove (roots)";
+        readonly required: false;
+        readonly when: readonly ["add", "remove", "include", "exclude", "all", "roots"];
+    }, {
+        readonly name: "folder";
+        readonly description: "(roots add/remove) the folder";
+        readonly required: false;
+        readonly when: "roots";
+    }];
+    readonly options: readonly [];
+}, {
+    readonly name: "show";
+    readonly summary: "show the sandbox window";
+    readonly group: "Sandbox";
+    readonly args: readonly [];
+    readonly options: readonly [];
+}, {
+    readonly name: "hide";
+    readonly summary: "hide the sandbox window (it keeps running)";
+    readonly group: "Sandbox";
+    readonly args: readonly [];
+    readonly options: readonly [];
+}, {
+    readonly name: "account";
+    readonly summary: "Claude logins: list, save, use, set the default, remove";
+    readonly group: "Accounts";
+    readonly args: readonly [{
+        readonly name: "action";
+        readonly description: "what to do";
+        readonly required: false;
+        readonly choices: readonly ["list", "save", "use", "default", "remove"];
+    }, {
+        readonly name: "name";
+        readonly description: "account name";
+        readonly required: false;
+        readonly choices: "accounts";
+    }];
+    readonly options: readonly [{
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+    }, {
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+    }];
+    readonly json: true;
+}, {
+    readonly name: "data";
+    readonly summary: "show what is kept between sandboxes (tools, databases, logins, logs), or delete some of it";
+    readonly group: "Data";
+    readonly args: readonly [{
+        readonly name: "action";
+        readonly description: "show or clean";
+        readonly required: false;
+        readonly choices: readonly ["show", "clean"];
+    }, {
+        readonly name: "targets";
+        readonly description: "what to clean, e.g. tools/go databases logs";
+        readonly required: false;
+        readonly variadic: true;
+        readonly when: "clean";
+    }];
+    readonly options: readonly [{
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+    }];
+    readonly json: true;
+}, {
+    readonly name: "clean";
+    readonly summary: "delete old launch folders, logs and leftovers";
+    readonly group: "Data";
+    readonly args: readonly [];
+    readonly options: readonly [{
+        readonly flag: "--days";
+        readonly type: "number";
+        readonly value: "n";
+        readonly description: "launch folders older than this many days";
+        readonly default: 7;
+    }];
+}, {
+    readonly name: "sync";
+    readonly summary: "copy conversation history back to this PC now";
+    readonly group: "Data";
+    readonly args: readonly [];
+    readonly options: readonly [];
+}, {
+    readonly name: "audit";
+    readonly summary: "what happened in your sandboxes: programs started, files changed, sessions, repo guard (audit.enabled)";
+    readonly group: "Health";
+    readonly json: true;
+    readonly args: readonly [];
+    readonly options: readonly [{
+        readonly flag: "--days";
+        readonly type: "number";
+        readonly value: "n";
+        readonly description: "the last n days (default: today)";
+        readonly default: 1;
+    }, {
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+    }, {
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+    }];
+}, {
+    readonly name: "logs";
+    readonly summary: "print the newest sandbox log";
+    readonly group: "Health";
+    readonly args: readonly [];
+    readonly options: readonly [{
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+    }];
+}, {
+    readonly name: "setup";
+    readonly summary: "check this PC can run Windows Sandbox and offer to turn it on";
+    readonly group: "Health";
+    readonly args: readonly [];
+    readonly options: readonly [];
+}, {
+    readonly name: "doctor";
+    readonly summary: "check this PC and show what will be copied or downloaded";
+    readonly group: "Health";
+    readonly args: readonly [];
+    readonly options: readonly [{
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+    }];
+}, {
+    readonly name: "repair";
+    readonly summary: "find and fix common problems (stale state, broken downloads, half-installed tools)";
+    readonly group: "Health";
+    readonly args: readonly [];
+    readonly options: readonly [];
+}, {
+    readonly name: "self-test";
+    readonly summary: "run the built-in tests";
+    readonly group: "Health";
+    readonly args: readonly [{
+        readonly name: "suite";
+        readonly description: "run only these test suites, e.g. config live-daemon (default: all)";
+        readonly required: false;
+        readonly variadic: true;
+    }];
+    readonly options: readonly [];
+}, {
+    readonly name: "config";
+    readonly summary: "show or create your settings file, or check a project's .sandbox-config.json";
+    readonly group: "Config";
+    readonly args: readonly [{
+        readonly name: "action";
+        readonly description: "what to do";
+        readonly required: false;
+        readonly choices: readonly ["show", "path", "init", "schema", "check"];
+    }];
+    readonly options: readonly [{
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+    }];
+}, {
+    readonly name: "agent-commands";
+    readonly summary: "(Beta) make claude, codex ... on this PC start in a hidden sandbox and attach";
+    readonly group: "Agents";
+    readonly args: readonly [{
+        readonly name: "action";
+        readonly description: "on, off or status";
+        readonly required: false;
+        readonly choices: readonly ["status", "on", "off"];
+    }];
+    readonly options: readonly [];
+}, {
+    readonly name: "host-claude";
+    readonly summary: "run Claude on this PC, NOT sandboxed, with its own profile";
+    readonly group: "Agents";
+    readonly args: readonly [];
+    readonly options: readonly [{
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+    }];
+    readonly passthrough: "agent";
+    readonly interactive: true;
+}, {
+    readonly name: "menu";
+    readonly summary: "the interactive menu (what `sandbox` opens with no arguments)";
+    readonly group: "Config";
+    readonly args: readonly [];
+    readonly options: readonly [];
+    readonly hidden: true;
+    readonly interactive: true;
+}, {
+    readonly name: "_watch";
+    readonly summary: "background history sync";
+    readonly group: "Data";
+    readonly args: readonly [];
+    readonly options: readonly [];
+    readonly hidden: true;
+}];
+export type CommandName = (typeof COMMAND_LIST)[number]['name'];
+export declare const COMMANDS: CommandSpec[];
+export declare function commandSpec(name: string): CommandSpec | undefined;
+export {};