windows-development-sandbox 1.20.0 → 1.23.1

package/dist/app/features/sessions/sessions.run.js

@@ -66,7 +66,7 @@ async function shellPlace(ctx, project, io) {
     if (project !== undefined) {
         const named = projects.find((p) => p.name.toLowerCase() === project.toLowerCase());
         if (!named)
-            fail('The running sandbox has no project "' + project + '".', 'sandbox status lists its projects.');
+            fail('The running sandbox has no project "' + project + '".', 'Check the project names on the Sandbox page.');
         return { name: named.name, guest: named.guest };
     }
     const here = locateHere(ctx, new RunDir(ctx.dataPath).readSandboxStatus());
@@ -107,7 +107,7 @@ export const closeSessionRun = implement(closeSession, async (asked, input, io)
     const ctx = await useSharedSandbox(asked, (shared) => find(shared)?.kind === 'shell' ? { kind: 'use' } : { kind: 'owner-only', what: 'close an agent session' }, typedConfirm(io));
     const session = find(ctx);
     if (!session)
-        fail('No running session ' + input.session + '.', 'sandbox sessions lists the running ones.');
+        fail('No running session ' + input.session + '.', 'Check the list of running sessions.');
     const what = safeText(session.harness) + (session.kind === 'shell' ? ' (shell)' : '');
     const yes = await io.confirm({
         title: 'Close ' + what + ' session ' + input.session + '?',

package/dist/app/features/settings/categories.def.js

@@ -85,6 +85,8 @@ const NAMES = {
     play: 'Google Play',
     expo: 'Expo (EAS)',
     appstore: 'App Store Connect',
+    perplexity: 'Perplexity API key',
+    comet: 'Comet (Perplexity browser)',
     hooks: 'Hooks',
     personalization: 'Desktop look',
     projects: 'Projects',

package/dist/app/features/settings/settings-rows.js

@@ -102,5 +102,5 @@ export function findSetting(file, key) {
         '"' +
         (file.isProject ? ' a project can set' : '') +
         '.' +
-        (hint ? ' Did you mean ' + hint + '?' : ''), 'Settings are named like sandbox.memoryMb. See them all with: sandbox config show');
+        (hint ? ' Did you mean ' + hint + '?' : ''), 'Settings are named like sandbox.memoryMb. Search the Settings page by name to find one.');
 }

package/dist/app/features/settings/settings.def.js

@@ -203,7 +203,7 @@ function dataFolderItem(folder) {
         label: 'Data folder',
         hint: folder,
         cells: { setting: 'storage.root', value: folder },
-        description: 'Where your tools, logins, history and logs are kept between sandboxes. Move it with sandbox storage move <folder>.',
+        description: 'Where your tools, logins, history and logs are kept between sandboxes. Maintenance > Storage moves it.',
         primary: action(changeDataFolder, {}, { label: 'Data folder', verb: 'change' }),
     };
 }

package/dist/app/features/settings/settings.run.js

@@ -121,12 +121,12 @@ function freshConfig(ctx) {
 function readImport(config, 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.');
+        fail('There is no file ' + source + '.', 'Give the path of a file made by Export settings.');
     if (fs.statSync(source).size > MAX_BYTES)
         fail(source + ' is too big to be a settings file.');
     const plan = planImport(fs.readFileSync(source, 'utf8'), 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');
+        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 Export settings.');
     return plan;
 }
 /** Writes the planned changes to your settings file (comments stay); returns how many settings changed. */
@@ -160,7 +160,7 @@ export const importConfigRun = implement(importConfig, async (ctx, input, io) =>
     const file = input.settingsFile ??
         (await io.path({
             title: 'Which settings file',
-            lines: ['A file made by Export settings (or sandbox config export).'],
+            lines: ['A file made by Export settings (or one exported on the command line).'],
             pathKind: 'file',
         }));
     if (file === undefined)

package/dist/app/features/storage/storage.run.js

@@ -7,7 +7,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { userConfigPath, userDir } from '../../../core/config/index.js';
 import { humanBytes } from '../../../core/disk.js';
-import { expandPath, fail } from '../../../core/util/index.js';
+import { expandPath, fail, failWith } from '../../../core/util/index.js';
 import { requireOnPc } from '../../../cli/commands/context.js';
 import { StorageService } from '../../../cli/services/index.js';
 import { isSandboxRunning, realContainedDeps } from '../../../host/sandbox/index.js';
@@ -26,7 +26,11 @@ function requireAvailable() {
 }
 function requireNoSandbox() {
     if (isSandboxRunning())
-        fail('A sandbox is running.', 'Close it (sandbox stop) first: the folders in the image are in use.');
+        failWith('A sandbox is running.', 'Stop it first: the folders in the image are in use.', {
+            op: 'sandbox.stop',
+            label: 'Stop the sandbox',
+            cli: 'sandbox stop',
+        });
 }
 function storageFor(ctx) {
     const { config } = ctx.loaded;
@@ -122,7 +126,7 @@ async function useData(io, service, from, to, ask) {
             cancelled('Nothing was changed.');
     }
     service.use(to);
-    return 'Your data is now looked for in ' + to + '. Move it later with: sandbox storage move <folder>';
+    return 'Your data is now looked for in ' + to + '. Move it later from Maintenance > Storage.';
 }
 export const showStorageRun = implement(showStorage, async (ctx, input, io) => {
     requireOnPc('storage');
@@ -153,7 +157,12 @@ export const moveStorageRun = implement(moveStorage, async (ctx, input, io) => {
         ? expandPath(input.folder, process.cwd())
         : await chooseFolder(io, service, 'move', 'Nothing was moved.');
     if (!fs.existsSync(from))
-        fail('There is nothing to move: ' + from + ' does not exist.', 'Use sandbox storage use ' + to + ' to switch.');
+        failWith('There is nothing to move: ' + from + ' does not exist.', 'Switch to ' + to + ' without moving instead.', {
+            op: 'storage.use',
+            input: { folder: to },
+            label: 'Use ' + to,
+            cli: 'sandbox storage use ' + to,
+        });
     return moveData(io, service, from, to, input.keepOld, true);
 });
 export const useStorageRun = implement(useStorage, async (ctx, input, io) => {
@@ -271,7 +280,7 @@ export const containedOnRun = implement(containedOn, async (ctx, _input, io) =>
         noTerminal: { message: NO_TERMINAL, fix: 'Add --yes to turn it on without asking.' },
     });
     if (!turnOn)
-        fail('Nothing was changed.', 'Run sandbox storage contained on when you want it.');
+        fail('Nothing was changed.', 'Turn contained storage on when you want it.');
     io.progress('Making and mounting the image (Windows asks for permission)');
     const mount = await storage.acquire({ id: 'cli', pid: process.pid }, { create: true });
     try {
@@ -293,7 +302,7 @@ export const containedOnRun = implement(containedOn, async (ctx, _input, io) =>
                     io.log(note, 'warn');
             }
             else
-                io.log('They stay where they are and are not used: tools are downloaded again into the image. Delete them later with sandbox data clean.');
+                io.log('They stay where they are and are not used: tools are downloaded again into the image. Delete them later in Maintenance > Data.');
         }
         writeContainedSetting(configFile, 'vhdx');
     }
@@ -301,9 +310,9 @@ export const containedOnRun = implement(containedOn, async (ctx, _input, io) =>
         io.progress('Dismounting the image (Windows asks for permission)');
         const done = await storage.release('cli');
         if (!done.dismounted)
-            io.log('The image stays mounted (' + (done.note ?? '') + '). sandbox repair dismounts it.', 'warn');
+            io.log('The image stays mounted (' + (done.note ?? '') + '). Repairing from Health dismounts it.', 'warn');
     }
-    return { message: 'Contained storage is on. sandbox launch mounts the image first.' };
+    return { message: 'Contained storage is on. The next sandbox mounts the image first.' };
 });
 export const containedOffRun = implement(containedOff, async (ctx, _input, io) => {
     requireOnPc('storage');
@@ -345,7 +354,7 @@ export const containedOffRun = implement(containedOff, async (ctx, _input, io) =
         io.progress('Dismounting the image (Windows asks for permission)');
         const done = await storage.release('cli');
         if (!done.dismounted)
-            io.log('The image stays mounted (' + (done.note ?? '') + '). sandbox repair dismounts it.', 'warn');
+            io.log('The image stays mounted (' + (done.note ?? '') + '). Repairing from Health dismounts it.', 'warn');
         else if (!moved)
             io.log('The image was dismounted; contained storage is still on.');
     }

package/dist/app/features/updates/update-lines.js

@@ -24,9 +24,9 @@ export function describeResult(result, _unattended) {
                 result.reason.replace(/\.?\s*$/, '.') +
                 (result.rolledBack
                     ? ' The change was undone: you are on the version you had.'
-                    : ' Going back to your previous version did not fully work: run sandbox update --rollback or the installer.') +
+                    : ' Going back to your previous version did not fully work: use Go back to the previous version, or run the installer.') +
                 (result.autoUpdateOff
-                    ? ' Automatic updates are off; turn them back on in Maintenance > Updates or with sandbox update --auto on.'
+                    ? ' Automatic updates are off; turn them back on in Maintenance > Updates.'
                     : result.blocked
                         ? ' It is not tried again; the next release is.'
                         : ' It is tried again later.'),

package/dist/app/features/updates/updates.def.js

@@ -100,7 +100,7 @@ export function updatesPage(s, latest) {
         title: 'This program',
         notes: [
             {
-                text: 'After an update this page still runs the version it started with; sandbox web open (or the next sandbox start) starts the new one.',
+                text: 'After an update this page still runs the version it started with. Stop and start the web UI (Maintenance > Web UI) to use the new one.',
                 tone: 'muted',
                 only: 'web',
             },

package/dist/app/features/updates/updates.run.js

@@ -39,7 +39,7 @@ export async function updateWith(service, input, io) {
         const found = await service.check();
         if (found.available && found.latest)
             return {
-                line: 'Version ' + found.latest.version + ' is available (you have ' + found.current + '). Run: sandbox update',
+                line: 'Version ' + found.latest.version + ' is available (you have ' + found.current + ').',
                 latest: found.latest.version,
             };
         if (found.blocked)

package/dist/app/features/web/web.def.js

@@ -27,10 +27,10 @@ export const webStatus = defineQuery({
     text: (o) => o.running && o.port
         ? 'The web UI is running at http://127.0.0.1:' +
             o.port +
-            '/ (sandbox web open signs you in).' +
+            '/ (the Open action signs you in).' +
             (o.lanAddress ? '\nOn your network: ' + o.lanAddress + ' (certificate ' + o.lanFingerprint + ')' : '') +
             (o.lanProblem ? '\nLAN mode is on but not listening: ' + o.lanProblem : '')
-        : 'The web UI is not running (sandbox web start).',
+        : 'The web UI is not running.',
     cli: { name: 'web', action: 'status', json: true },
 });
 export const startWeb = defineOperation({

package/dist/app/features/web/web.run.js

@@ -3,7 +3,7 @@
 // it. The server itself (`sandbox _web`) stays in cli/commands/web.ts.
 import path from 'node:path';
 import { packageVersion } from '../../../core/package-info.js';
-import { fail, sleep } from '../../../core/util/index.js';
+import { fail, failWith, sleep } from '../../../core/util/index.js';
 import { requireOnPc } from '../../../cli/commands/context.js';
 import { spawnDetached } from '../../../host/sandbox/index.js';
 import { openBrowser, WebControl, WebStore } from '../../../host/web/index.js';
@@ -50,10 +50,14 @@ async function startServer(ctx, io, control) {
         const now = await control.status();
         if (now.running && now.state) {
             io.log('The web UI is running at http://127.0.0.1:' + now.state.port + '/ (this PC only).');
-            return { port: now.state.port, message: 'Open it already signed in with: sandbox web open', wasRunning: false };
+            return {
+                port: now.state.port,
+                message: 'Open it already signed in from Maintenance > Web UI.',
+                wasRunning: false,
+            };
         }
     }
-    return fail('The web UI did not start.', 'Run sandbox _web to see why (the port ' + config.web.port + ' may be taken: change web.port).');
+    return fail('The web UI did not start.', 'The port ' + config.web.port + ' may be taken: change web.port in Settings. The Logs page may say more.');
 }
 /** Whether the web UI runs, and its address without the token. Never returns the state (it holds the token). */
 export const webStatusRun = implement(webStatus, async (ctx) => {
@@ -83,7 +87,11 @@ export const openWebRun = implement(openWeb, async (ctx, _input, io) => {
         io.log(started.message);
     const { running, state } = await control.status();
     if (!running || !state)
-        return fail('The web UI stopped right away.', 'Run sandbox web start again.');
+        return failWith('The web UI stopped right away.', 'Start it again.', {
+            op: 'web.start',
+            label: 'Start the web UI',
+            cli: 'sandbox web start',
+        });
     openBrowser(control.url(state));
     return { message: 'Opened in your browser.' };
 });

package/dist/app/kernel/errors.d.ts

@@ -1,4 +1,6 @@
 import { z } from 'zod';
+import { type ErrorAction } from '../../core/util/errors.js';
+export type { ErrorAction };
 export declare const ErrorKindSchema: z.ZodEnum<{
     user: "user";
     cancelled: "cancelled";
@@ -16,6 +18,11 @@ export declare const WireErrorSchema: z.ZodObject<{
     }>;
     message: z.ZodString;
     fix: z.ZodOptional<z.ZodString>;
+    action: z.ZodOptional<z.ZodObject<{
+        op: z.ZodString;
+        input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        label: z.ZodString;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 export type WireError = z.output<typeof WireErrorSchema>;
 /** The user said no to a question the operation needed: nothing changed. */

package/dist/app/kernel/errors.js

@@ -9,6 +9,14 @@ export const WireErrorSchema = z.strictObject({
     kind: ErrorKindSchema,
     message: z.string().max(2000),
     fix: z.string().max(2000).optional(),
+    /** A button that fixes it (the command line is not sent: only the CLI prints it). */
+    action: z
+        .strictObject({
+        op: z.string().max(100),
+        input: z.record(z.string(), z.unknown()).optional(),
+        label: z.string().max(200),
+    })
+        .optional(),
 });
 /** The user said no to a question the operation needed: nothing changed. */
 export class Cancelled extends Error {
@@ -27,8 +35,15 @@ export const BUG_MESSAGE = 'Something went wrong.';
 export function toWireError(e) {
     if (e instanceof Cancelled)
         return { kind: 'cancelled', message: e.message };
-    if (e instanceof UserError)
-        return { kind: 'user', message: e.message, ...(e.fix ? { fix: e.fix } : {}) };
+    if (e instanceof UserError) {
+        const a = e.action;
+        return {
+            kind: 'user',
+            message: e.message,
+            ...(e.fix ? { fix: e.fix } : {}),
+            ...(a ? { action: { op: a.op, ...(a.input ? { input: { ...a.input } } : {}), label: a.label } } : {}),
+        };
+    }
     if (e instanceof z.ZodError)
         return { kind: 'invalid', message: issuesText(e) };
     return { kind: 'bug', message: BUG_MESSAGE };
@@ -37,7 +52,7 @@ export function toWireError(e) {
 export function fromWireError(w) {
     if (w.kind === 'cancelled')
         return new Cancelled(w.message);
-    return new UserError(w.message, w.fix);
+    return new UserError(w.message, w.fix, w.action ? { op: w.action.op, input: w.action.input, label: w.action.label, cli: '' } : undefined);
 }
 /** "key: problem; other: problem" for a value that did not fit its schema. */
 export function issuesText(e) {

package/dist/app/kernel/rpc.d.ts

@@ -154,6 +154,11 @@ export declare const ServerMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }>;
         message: z.ZodString;
         fix: z.ZodOptional<z.ZodString>;
+        action: z.ZodOptional<z.ZodObject<{
+            op: z.ZodString;
+            input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            label: z.ZodString;
+        }, z.core.$strict>>;
     }, z.core.$strict>;
 }, z.core.$strict>, z.ZodObject<{
     t: z.ZodLiteral<"data">;

package/dist/app/kernel/view.d.ts

@@ -20,11 +20,21 @@ export type Target =
     readonly kind: 'start-agent';
     readonly agent: string;
 }
-/** A command line of an area that is not a feature yet: the menu runs it, the web does not offer it. */
+/** A command line of an area that is not a feature yet: the menu runs it. No Page uses it. */
  | {
     readonly kind: 'command';
     readonly argv: readonly string[];
 }
+/** One setting: Settings opens at its row (the web: /v/settings?focus=<key>; the menu: Settings, searched for it). */
+ | {
+    readonly kind: 'setting';
+    readonly key: string;
+}
+/** A page on the internet (only https://github.com/ so far): the menu opens it in the browser, the web in a tab. */
+ | {
+    readonly kind: 'url';
+    readonly href: string;
+}
 /** Another view. */
  | {
     readonly kind: 'view';

package/dist/bin/agent-sandbox.js

@@ -2,8 +2,8 @@
 import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
   run
-} from "./chunk-DK4NTBUF.js";
-import "./chunk-Z2P5OGKL.js";
+} from "./chunk-7YPEDAJD.js";
+import "./chunk-USTRSHIE.js";
 
 // src/bin/agent-sandbox.ts
 run(process.argv.slice(2));