windows-development-sandbox 1.18.4 → 1.20.0

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

@@ -37,6 +37,14 @@ export const VpnStatusSchema = z.object({
     })
         .nullable()
         .describe("The running sandbox's tunnel, when one runs with the VPN on"),
+    lastFailure: z
+        .object({
+        code: z.enum(['auth', 'unreachable', 'driver', 'timeout', 'other']).describe('Why the last attempt failed'),
+        text: z.string().describe('The reason in plain words'),
+        at: z.string().describe('When (ISO date and time)'),
+    })
+        .nullable()
+        .describe("The last sandbox's VPN attempt, when it failed (kept after the sandbox closed)"),
 });
 export const vpnStatus = defineQuery({
     id: 'vpn.status',
@@ -125,6 +133,16 @@ export function vpnPage(s) {
         wireguard
             ? { id: 'login', label: 'Login', value: 'not needed (the keys are in your config)', tone: 'muted' }
             : { id: 'login', label: 'Login', value: LOGIN_TEXT[s.login] + savedDate, tone: LOGIN_TONE[s.login] },
+        ...(s.lastFailure
+            ? [
+                {
+                    id: 'lastAttempt',
+                    label: 'Last attempt',
+                    value: s.lastFailure.text + ' (' + s.lastFailure.at.slice(0, 16).replace('T', ' ') + ')',
+                    tone: 'danger',
+                },
+            ]
+            : []),
         ...(s.running
             ? [
                 {
@@ -137,14 +155,14 @@ export function vpnPage(s) {
             : []),
     ];
     const notes = [
-        ...(!wireguard && s.login === 'none'
-            ? [{ text: 'Next: sandbox vpn login', tone: 'muted', only: 'cli' }]
-            : []),
         ...(s.login === 'unreadable'
+            ? [{ text: 'Only the Windows user that saved it can read it. Save it again.', tone: 'muted' }]
+            : []),
+        ...(s.lastFailure?.code === 'auth' && s.provider === 'nordvpn'
             ? [
                 {
-                    text: 'Only the Windows user that saved it can read it. Save it again: sandbox vpn login',
-                    tone: 'muted',
+                    text: 'NordVPN refused the login. It needs the service credentials (Nord Account > NordVPN > Manual setup), not your e-mail and password.',
+                    tone: 'warn',
                 },
             ]
             : []),
@@ -152,12 +170,18 @@ export function vpnPage(s) {
     ];
     // Turning it on or off is the vpn.enabled setting (it applies from the next start).
     const toggle = action(setSetting, { scope: 'user', key: 'vpn.enabled', value: !s.enabled }, { label: s.enabled ? 'Turn the VPN off' : 'Turn the VPN on', verb: s.enabled ? 'turn off' : 'turn on', key: 'o' });
+    const refused = s.lastFailure?.code === 'auth';
     const actions = [
         toggle,
+        ...(s.lastFailure?.code === 'unreachable' && s.protocol === 'udp'
+            ? [
+                action(setSetting, { scope: 'user', key: 'vpn.protocol', value: 'tcp' }, { label: 'Try TCP instead of UDP', verb: 'use tcp', key: 't' }),
+            ]
+            : []),
         ...(wireguard
             ? []
             : [
-                action(vpnLogin, {}, { key: 'v', verb: 'save login' }),
+                action(vpnLogin, {}, { key: 'v', verb: 'save login', ...(refused ? { label: 'Save the login again…' } : {}) }),
                 ...(s.login !== 'none' ? [action(vpnLogout, {}, { key: 'x', verb: 'delete login' })] : []),
             ]),
     ];

package/dist/app/features/vpn/vpn.run.d.ts

@@ -27,6 +27,17 @@ export declare const vpnStatusRun: import("../../kernel/define.js").Implementati
         }>;
         text: import("zod").ZodString;
     }, import("zod/v4/core").$strip>>;
+    lastFailure: import("zod").ZodNullable<import("zod").ZodObject<{
+        code: import("zod").ZodEnum<{
+            auth: "auth";
+            unreachable: "unreachable";
+            driver: "driver";
+            timeout: "timeout";
+            other: "other";
+        }>;
+        text: import("zod").ZodString;
+        at: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
 }, import("zod/v4/core").$strip>, "vpn.status">, import("../../../cli/commands/context.js").Context>;
 export declare const vpnLoginRun: import("../../kernel/define.js").Implementation<import("../../kernel/define.js").OperationDef<import("zod").ZodObject<{}, import("zod/v4/core").$strict>, import("zod").ZodObject<{
     message: import("zod").ZodString;

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

@@ -32,8 +32,11 @@ export const vpnLoginRun = implement(vpnLogin, async (ctx, _input, io) => {
     if (password === undefined)
         cancelled();
     service.save({ username, password });
+    const warning = service.warning({ username, password });
+    if (warning)
+        io.log(warning, 'warn');
     VPN_WARNINGS.forEach((w) => io.log(w, 'muted'));
-    return { message: 'Saved. Turn the VPN on with: sandbox config set vpn.enabled true' };
+    return { message: 'Saved. Use "Turn the VPN on" on the VPN page to use it from the next start.' };
 });
 export const vpnLogoutRun = implement(vpnLogout, async (ctx, _input, io) => {
     requireOnPc('vpn logout');

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

@@ -57,8 +57,8 @@ export declare const ServerMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     text: z.ZodString;
     tone: z.ZodOptional<z.ZodEnum<{
         ok: "ok";
-        muted: "muted";
         warn: "warn";
+        muted: "muted";
         danger: "danger";
         accent: "accent";
     }>>;

package/dist/app/registry.js

@@ -1,6 +1,6 @@
 import { fail } from '../core/util/errors.js';
 import { accessNeeded, allows, invoke, OWNER, refusalText, NO_QUESTIONS, onSurface, } from './kernel/index.js';
-import { addAgentRun, listAgentsRun, makeDefaultAgentRun, removeAgentRun, startAgentRun, } from './features/agents/index.js';
+import { addAgentRun, agentEnvRun, agentsEnvSetRun, listAgentsRun, makeDefaultAgentRun, removeAgentRun, startAgentRun, } from './features/agents/index.js';
 import { defaultAccountRun, listAccountsRun, removeAccountRun, renameAccountRun, saveAccountRun, useAccountRun, listServicesRun, serviceImportRun, serviceLoginRun, serviceLogoutRun, } from './features/accounts/index.js';
 import { listAppsRun, requestAppRun, setCustomAppsRun, toggleAppRun } from './features/apps/index.js';
 import { browseFolderRun } from './features/files/index.js';
@@ -16,6 +16,7 @@ import { exportConfigRun, getSettingRun, importConfigRun, listSettingsRun, reset
 import { migrateSettingsRun, runUpdateRun, updatesStatusRun } from './features/updates/index.js';
 import { checkEngineRun, cleanEngineRun, engineLeftoversRun, engineStatusRun } from './features/engine/index.js';
 import { openWebRun, startWebRun, stopWebRun, webStatusRun } from './features/web/index.js';
+import { agentCommandsOffRun, agentCommandsOnRun, agentCommandsStatusRun } from './features/agent-commands/index.js';
 import { vpnLoginRun, vpnLogoutRun, vpnStatusRun } from './features/vpn/index.js';
 import { githubLoginRun, githubLogoutRun, githubStatusRun } from './features/github/index.js';
 import { accessStatusRun, allowDeviceRun, lanOffRun, lanOnRun, revokeAccessRun, revokeAllAccessRun, } from './features/access/index.js';
@@ -34,6 +35,8 @@ export const IMPLEMENTATIONS = [
     makeDefaultAgentRun,
     removeAgentRun,
     listAgentsRun,
+    agentEnvRun,
+    agentsEnvSetRun,
     listSettingsRun,
     getSettingRun,
     setSettingRun,
@@ -89,6 +92,9 @@ export const IMPLEMENTATIONS = [
     vpnStatusRun,
     vpnLoginRun,
     vpnLogoutRun,
+    agentCommandsStatusRun,
+    agentCommandsOnRun,
+    agentCommandsOffRun,
     githubStatusRun,
     githubLoginRun,
     githubLogoutRun,

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-N4GXYTLV.js";
-import "./chunk-FRPLQLSY.js";
+} from "./chunk-DK4NTBUF.js";
+import "./chunk-Z2P5OGKL.js";
 
 // src/bin/agent-sandbox.ts
 run(process.argv.slice(2));

package/dist/bin/{chunk-MY7NLQQY.js → chunk-2IMT7ZCT.js}

@@ -1,7 +1,7 @@
 import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
   attach
-} from "./chunk-FRPLQLSY.js";
+} from "./chunk-Z2P5OGKL.js";
 export {
   attach
 };

package/dist/bin/{chunk-N4GXYTLV.js → chunk-DK4NTBUF.js}

@@ -45,7 +45,9 @@ import {
   __require,
   __toESM,
   action,
-  agentCommandsCommand,
+  agentCommandsStatus,
+  agentEnv,
+  agentEnvPage,
   agentPage,
   agentsPage,
   allowStorePath,
@@ -228,7 +230,7 @@ import {
   withOperationCommands,
   working,
   writeJson
-} from "./chunk-FRPLQLSY.js";
+} from "./chunk-Z2P5OGKL.js";
 
 // node_modules/commander/lib/error.js
 var require_error = __commonJS({
@@ -4153,7 +4155,7 @@ var COMMAND_LIST = [
   },
   {
     name: "agent-commands",
-    summary: "(Beta) make claude, codex ... on this PC start in a hidden sandbox and attach",
+    summary: "make claude, codex ... on this PC start in a hidden sandbox and attach",
     group: "Advanced",
     args: [{ name: "action", description: "on, off or status", required: false, choices: ["status", "on", "off"] }],
     options: []
@@ -4887,7 +4889,9 @@ var TextScreen = class {
     }
     if (key.text) {
       const accept = this.o.accept;
-      const add = [...key.text.replace(/[\r\n]/g, "")].filter((c2) => !accept || accept.test(c2));
+      const add = [...key.text.replace(/\x1b?\[20[01]~/g, "").replace(/[\r\n]/g, "")].filter(
+        (c2) => !accept || accept.test(c2)
+      );
       if (!add.length) return;
       set([...chars.slice(0, this.cursor), ...add, ...chars.slice(this.cursor)], this.cursor + add.length);
     }
@@ -6054,9 +6058,10 @@ var Terminal = class {
     });
   }
   push(str, key) {
+    const marker = key?.name === "paste-start" || key?.name === "paste-end";
     const event = {
       name: key?.name ?? "",
-      text: str && !key?.ctrl && !key?.meta && str.length >= 1 && str >= " " && str !== "\x7F" ? str : "",
+      text: str && !marker && !key?.ctrl && !key?.meta && str.length >= 1 && str >= " " && str !== "\x7F" ? str : "",
       ctrl: Boolean(key?.ctrl),
       meta: Boolean(key?.meta),
       shift: Boolean(key?.shift)
@@ -7714,6 +7719,9 @@ var SeveralAgents = class {
 };
 
 // src/cli/menu/pages/agents-page.ts
+function commandsOf(m) {
+  return m.agentCommands ?? { enabled: m.hostAgents.length > 0, dir: "", found: [] };
+}
 function agentsList(m) {
   const removable = m.removable ?? [];
   return {
@@ -7728,7 +7736,12 @@ function agentsList(m) {
   };
 }
 function startView(m) {
-  return menuView(agentsPage(agentsList(m)), { category: "start", refresh: false });
+  const page = agentsPage(agentsList(m), commandsOf(m));
+  return menuView({ ...page, sections: page.sections.slice(0, 1) }, { category: "start", refresh: false });
+}
+function commandsView(m) {
+  const page = agentsPage(agentsList(m), commandsOf(m));
+  return menuView({ ...page, sections: page.sections.slice(1) }, { category: "host", refresh: false });
 }
 function hostAgentsToShow(enabled, found) {
   return enabled ? found.map((a) => a.harness) : [];
@@ -7754,14 +7767,19 @@ function agentCategories(m) {
       label: "Start",
       description: "Agents you can start in " + m.folder + ". Add an agent at the end of the list."
     },
-    { id: "options", label: "Options", description: "How a start goes, and the other ways to start." },
-    ...m.hostAgents.length ? [
+    ...m.claudeEnv ? [
       {
-        id: "host",
-        label: "On this PC",
-        description: "The real agents on this PC, with no sandbox around them."
+        id: "env",
+        label: "Claude environment",
+        description: "Models, limits, how many subagents run at once, and other variables of Claude."
       }
-    ] : []
+    ] : [],
+    { id: "options", label: "Options", description: "How a start goes, and the other ways to start." },
+    {
+      id: "host",
+      label: "On this PC",
+      description: "Agent commands: typing claude, codex ... here starts them in a sandbox. The real agents are listed too."
+    }
   ];
 }
 function startRow(item2, m, cwd) {
@@ -7773,8 +7791,13 @@ function startRow(item2, m, cwd) {
     details: [Theme.muted("Command  ") + commandLine(startArgv(m, name, cwd))]
   };
 }
+function envView(m) {
+  return m.claudeEnv ? menuView(agentEnvPage(m.claudeEnv), { category: "env", refresh: false }) : void 0;
+}
 function agentsOptions(m, cwd = process.cwd()) {
   const view2 = startView(m);
+  const env = envView(m);
+  const commands = commandsView(m);
   return {
     path: [],
     categories: agentCategories(m),
@@ -7790,6 +7813,8 @@ function agentsOptions(m, cwd = process.cwd()) {
         }
       ] : [],
       ...view2.items.map((item2) => startRow(item2, m, cwd)),
+      ...env?.items ?? [],
+      ...commands.items,
       {
         value: "opt:attach",
         label: "Attach this terminal",
@@ -7843,8 +7868,8 @@ function agentsOptions(m, cwd = process.cwd()) {
         description: "Runs the real " + agent + " on this PC, with no sandbox around it."
       }))
     ],
-    enterLabel: (_category, id) => ENTER[id ?? ""] ?? (id?.startsWith("agent:") ? "start" : id?.startsWith("host:") ? "run" : "open"),
-    actions: (category) => category === "start" ? view2.actions : []
+    enterLabel: (category, id) => ENTER[id ?? ""] ?? (id?.startsWith("agent:") ? "start" : id?.startsWith("host:") ? "run" : category === "host" ? commands.enterLabel(category, id) : "open"),
+    actions: (category) => category === "start" ? view2.actions : category === "env" ? env?.actions ?? [] : category === "host" ? commands.actions : []
   };
 }
 var ENTER = {
@@ -7875,7 +7900,7 @@ var AgentsPage = class extends ListPage {
   facts;
   current() {
     if (!this.facts) throw new Error("The agents tab was not loaded");
-    const { agents, commands, last } = this.facts;
+    const { agents, commands, last, env } = this.facts;
     return {
       folder: this.folder,
       defaultAgent: agents.defaultAgent,
@@ -7884,7 +7909,13 @@ var AgentsPage = class extends ListPage {
       attach: this.attach,
       window: this.window,
       hostAgents: hostAgentsToShow(commands.enabled, commands.found),
-      removable: agents.agents.filter((a) => a.removable).map((a) => a.name)
+      agentCommands: {
+        enabled: commands.enabled,
+        dir: commands.dir,
+        found: commands.found.map((a) => ({ command: a.command, harness: a.harness, real: a.real }))
+      },
+      removable: agents.agents.filter((a) => a.removable).map((a) => a.name),
+      ...env ? { claudeEnv: env } : {}
     };
   }
   /** The cursor starts on the default agent. */
@@ -7895,7 +7926,8 @@ var AgentsPage = class extends ListPage {
     this.facts = {
       agents: await readQuery(listAgents, this.ctx),
       commands: await new AgentCommandsService(this.ctx).statusAsync(),
-      last: readHistory()[0]?.argv
+      last: readHistory()[0]?.argv,
+      env: "claude" in this.ctx.loaded.config.harnesses ? await readQuery(agentEnv, this.ctx, { agent: "claude" }) : void 0
     };
     this.model = this.current();
   }
@@ -7905,9 +7937,19 @@ var AgentsPage = class extends ListPage {
   }
   async act(result) {
     const model = this.current();
-    const chosen = startView(model).resolve(result);
+    const env = this.category === "env" ? envView(model) : void 0;
+    if (env) {
+      const picked = env.resolve(result);
+      if (picked?.kind === "action") return this.operate(picked.action);
+      return {};
+    }
+    const chosen = startView(model).resolve(result) ?? commandsView(model).resolve(result);
     if (chosen?.kind === "action") {
       const { action: action2 } = chosen;
+      if (action2.kind === "link" && action2.target.kind === "view") {
+        await this.selectCategory("env");
+        return {};
+      }
       if (action2.kind === "link" && action2.target.kind === "start-agent")
         return { exit: { kind: "run", argv: startArgv(model, action2.target.agent, process.cwd()) } };
       return this.operate(action2);
@@ -8158,15 +8200,14 @@ var CATEGORIES2 = [
   },
   { id: "more", label: "More commands", description: "Less common commands." }
 ];
-var MORE_COMMANDS = ["sync", "config", "generate", "exec", "agent-commands"];
+var MORE_COMMANDS = ["sync", "config", "generate", "exec"];
 var NO_LOGS = { folder: "", files: [], crash: false };
 var NO_WEB = { running: false, port: null, address: null };
 var MORE_LABELS = {
   sync: "Copy history back now",
   config: "Your settings file",
   generate: "Preview a start",
-  exec: "Run a command in the sandbox",
-  "agent-commands": "Agent commands (Beta)"
+  exec: "Run a command in the sandbox"
 };
 function dataMenuView(data) {
   return data ? menuView(dataPage(data), { category: "data", prefix: "data:", refresh: false }) : void 0;
@@ -8781,7 +8822,8 @@ var SettingsPage = class extends ListPage {
     killSwitch: true,
     login: "none",
     loginSavedAt: null,
-    running: null
+    running: null,
+    lastFailure: null
   };
   /** Whether a GitHub token is saved (never the token): the token row needs only its state. */
   github = { shareToken: false, gitAccess: "full", token: "none", kind: null, savedAt: null };
@@ -9400,7 +9442,7 @@ var Menu = class {
       await pressAnyKey(Theme.muted("Press any key for the menu\u2026"));
     });
   }
-  /** After a save: agent commands (Beta) may have been switched, which changes this PC. */
+  /** After a save: agent commands may have been switched, which changes this PC. */
   applyAgentCommands(saved) {
     if (!saved.files.some((f) => !f.isProject)) return void 0;
     try {
@@ -9408,9 +9450,9 @@ var Menu = class {
         loadConfig(this.ctx.loaded.configPath ?? void 0).config
       );
       if (!result?.changed) return void 0;
-      return result.on ? "Agent commands (Beta) are on: open a new terminal." : "Agent commands are off: claude, codex ... run on this PC again (open a new terminal).";
+      return result.on ? "Agent commands are on: open a new terminal." : "Agent commands are off: claude, codex ... run on this PC again (open a new terminal).";
     } catch (e) {
-      return "Agent commands (Beta): " + errMsg(e);
+      return "Agent commands: " + errMsg(e);
     }
   }
 };
@@ -10282,7 +10324,6 @@ var HANDLERS = {
   generate: (ctx) => launch(ctx, true),
   attach,
   exec,
-  "agent-commands": agentCommandsCommand,
   db,
   resume,
   // The bare command lists; its actions (save, use ...) are the operations' hints.
@@ -10317,6 +10358,8 @@ var HANDLERS = {
   "host-claude": claudeHost,
   host: hostCommand,
   _watch: watcher,
+  // The bare command shows the status; on and off are the operations' hints (src/app/features/agent-commands).
+  "agent-commands": definitionHandler(agentCommandsStatus),
   vpn,
   github,
   web,