windows-development-sandbox 1.27.0 → 1.27.3

package/dist/runtime/tool.js

@@ -5551,7 +5551,7 @@ var androidTool = {
 
 // src/guest/devtools/fivem.ts
 import fs17 from "node:fs";
-import os3 from "node:os";
+import os4 from "node:os";
 import path20 from "node:path";
 import { spawnSync as spawnSync2 } from "node:child_process";
 
@@ -5831,10 +5831,20 @@ function scriptArgs(name2, args2 = []) {
 }
 
 // src/shared/download/spawn.ts
+import os3 from "node:os";
 import { spawn } from "node:child_process";
+function lowerPriority(pid) {
+  if (pid === void 0) return;
+  try {
+    os3.setPriority(pid, os3.constants.priority.PRIORITY_BELOW_NORMAL);
+  } catch {
+  }
+}
 function spawnAsync(file2, args2, options = {}) {
+  const { lowPriority, ...spawnOptions } = options;
   return new Promise((resolve, reject) => {
-    const child = spawn(file2, args2, { stdio: "ignore", windowsHide: true, ...options });
+    const child = spawn(file2, args2, { stdio: "ignore", windowsHide: true, ...spawnOptions });
+    if (lowPriority) lowerPriority(child.pid);
     child.once("error", reject);
     child.once("close", (code) => resolve(code ?? -1));
   });
@@ -5855,13 +5865,16 @@ function extractArchive(archive, destination, members2 = []) {
 }
 async function extract(archive, destination, members2) {
   fs7.mkdirSync(destination, { recursive: true });
-  let status = await spawnAsync(SYSTEM.tar(), ["-xf", archive, "-C", destination, ...members2]);
+  let status = await spawnAsync(SYSTEM.tar(), ["-xf", archive, "-C", destination, ...members2], {
+    lowPriority: true
+  });
   if (status !== 0 && /\.(zip|nupkg)$/i.test(archive)) {
     const zip = archive.endsWith(".zip") ? archive : archive + ".zip";
     if (zip !== archive) fs7.copyFileSync(archive, zip);
     status = await spawnAsync(
       SYSTEM.powershell(),
-      scriptArgs("expand-archive.ps1", ["-Archive", zip, "-Destination", destination])
+      scriptArgs("expand-archive.ps1", ["-Archive", zip, "-Destination", destination]),
+      { lowPriority: true }
     );
   }
   if (status !== 0) throw new Error("Could not extract " + archive);
@@ -26494,6 +26507,7 @@ var GAMEDEV_APPS = [
     size: "100 MB",
     source: { github: "f3d-app/f3d", asset: "^F3D-[\\d.]+-Windows-x86_64\\.zip$" },
     exe: "f3d.exe",
+    onPath: true,
     needs: ["mesa"]
   },
   {
@@ -27593,7 +27607,7 @@ var SERVICE_SPECS = {
   },
   steam: {
     kind: "steam",
-    label: "Steam (SteamCMD)",
+    label: "Steam",
     usedBy: ["steam"],
     sources: ["file", "sandbox"],
     singleHolder: true,
@@ -27629,7 +27643,7 @@ var SERVICE_SPECS = {
   },
   cfx: {
     kind: "cfx",
-    label: "Cfx.re (FiveM / RedM server key)",
+    label: "FiveM key",
     usedBy: ["fivem"],
     sources: ["typed", "file"],
     singleHolder: false,
@@ -27658,7 +27672,7 @@ var SERVICE_SPECS = {
   },
   keystore: {
     kind: "keystore",
-    label: "Android upload keystore",
+    label: "Android keystore",
     usedBy: ["android"],
     sources: ["file"],
     singleHolder: false,
@@ -27673,7 +27687,7 @@ var SERVICE_SPECS = {
   },
   play: {
     kind: "play",
-    label: "Google Play (service account)",
+    label: "Google Play",
     usedBy: ["android"],
     sources: ["file"],
     singleHolder: false,
@@ -27684,7 +27698,7 @@ var SERVICE_SPECS = {
   },
   expo: {
     kind: "expo",
-    label: "Expo (EAS)",
+    label: "Expo",
     usedBy: ["reactNative"],
     sources: ["typed"],
     singleHolder: false,
@@ -27695,7 +27709,7 @@ var SERVICE_SPECS = {
   },
   appstore: {
     kind: "appstore",
-    label: "App Store Connect API key",
+    label: "App Store Connect",
     usedBy: ["reactNative", "flutter"],
     sources: ["file", "typed"],
     singleHolder: false,
@@ -27709,7 +27723,7 @@ var SERVICE_SPECS = {
   },
   perplexity: {
     kind: "perplexity",
-    label: "Perplexity API key",
+    label: "Perplexity API",
     usedBy: ["perplexity"],
     sources: ["pc", "file", "typed"],
     singleHolder: false,
@@ -27733,7 +27747,7 @@ var SERVICE_SPECS = {
   },
   comet: {
     kind: "comet",
-    label: "Comet (Perplexity browser)",
+    label: "Comet",
     usedBy: ["comet"],
     sources: ["sandbox"],
     singleHolder: false,
@@ -27749,7 +27763,7 @@ var SERVICE_SPECS = {
   },
   perplexityapp: {
     kind: "perplexityapp",
-    label: "Perplexity desktop app",
+    label: "Perplexity app",
     usedBy: ["perplexityapp"],
     sources: ["sandbox"],
     singleHolder: false,
@@ -28484,7 +28498,10 @@ function warn(message) {
 // src/guest/toolchains/signature.ts
 var SignatureSchema = external_exports.object({ subject: external_exports.string().max(4096), issuer: external_exports.string().max(4096) });
 function signatureOf(file2) {
-  const text = scriptOutput("get-signature.ps1", ["-Path", file2]).trim();
+  return parseSignature(scriptOutput("get-signature.ps1", ["-Path", file2]));
+}
+function parseSignature(output2) {
+  const text = output2.trim();
   if (!text) return null;
   try {
     const parsed = SignatureSchema.safeParse(JSON.parse(text));
@@ -29014,7 +29031,7 @@ function parse3(args2) {
   return { positionals, flags, dir: dir === void 0 ? void 0 : path20.resolve(dir) };
 }
 function addresses() {
-  return Object.values(os3.networkInterfaces()).flat().filter((a) => Boolean(a && a.family === "IPv4" && !a.internal)).map((a) => a.address);
+  return Object.values(os4.networkInterfaces()).flat().filter((a) => Boolean(a && a.family === "IPv4" && !a.internal)).map((a) => a.address);
 }
 function mariadbClient() {
   const root = path20.join(toolsDir, "mariadb");

package/dist/runtime/view.js

@@ -26697,6 +26697,7 @@ var GAMEDEV_APPS = [
     size: "100 MB",
     source: { github: "f3d-app/f3d", asset: "^F3D-[\\d.]+-Windows-x86_64\\.zip$" },
     exe: "f3d.exe",
+    onPath: true,
     needs: ["mesa"]
   },
   {
@@ -27796,7 +27797,7 @@ var SERVICE_SPECS = {
   },
   steam: {
     kind: "steam",
-    label: "Steam (SteamCMD)",
+    label: "Steam",
     usedBy: ["steam"],
     sources: ["file", "sandbox"],
     singleHolder: true,
@@ -27832,7 +27833,7 @@ var SERVICE_SPECS = {
   },
   cfx: {
     kind: "cfx",
-    label: "Cfx.re (FiveM / RedM server key)",
+    label: "FiveM key",
     usedBy: ["fivem"],
     sources: ["typed", "file"],
     singleHolder: false,
@@ -27861,7 +27862,7 @@ var SERVICE_SPECS = {
   },
   keystore: {
     kind: "keystore",
-    label: "Android upload keystore",
+    label: "Android keystore",
     usedBy: ["android"],
     sources: ["file"],
     singleHolder: false,
@@ -27876,7 +27877,7 @@ var SERVICE_SPECS = {
   },
   play: {
     kind: "play",
-    label: "Google Play (service account)",
+    label: "Google Play",
     usedBy: ["android"],
     sources: ["file"],
     singleHolder: false,
@@ -27887,7 +27888,7 @@ var SERVICE_SPECS = {
   },
   expo: {
     kind: "expo",
-    label: "Expo (EAS)",
+    label: "Expo",
     usedBy: ["reactNative"],
     sources: ["typed"],
     singleHolder: false,
@@ -27898,7 +27899,7 @@ var SERVICE_SPECS = {
   },
   appstore: {
     kind: "appstore",
-    label: "App Store Connect API key",
+    label: "App Store Connect",
     usedBy: ["reactNative", "flutter"],
     sources: ["file", "typed"],
     singleHolder: false,
@@ -27912,7 +27913,7 @@ var SERVICE_SPECS = {
   },
   perplexity: {
     kind: "perplexity",
-    label: "Perplexity API key",
+    label: "Perplexity API",
     usedBy: ["perplexity"],
     sources: ["pc", "file", "typed"],
     singleHolder: false,
@@ -27936,7 +27937,7 @@ var SERVICE_SPECS = {
   },
   comet: {
     kind: "comet",
-    label: "Comet (Perplexity browser)",
+    label: "Comet",
     usedBy: ["comet"],
     sources: ["sandbox"],
     singleHolder: false,
@@ -27952,7 +27953,7 @@ var SERVICE_SPECS = {
   },
   perplexityapp: {
     kind: "perplexityapp",
-    label: "Perplexity desktop app",
+    label: "Perplexity app",
     usedBy: ["perplexityapp"],
     sources: ["sandbox"],
     singleHolder: false,
@@ -28650,10 +28651,20 @@ import path7 from "node:path";
 import crypto from "node:crypto";
 
 // src/shared/download/spawn.ts
+import os3 from "node:os";
 import { spawn as spawn2 } from "node:child_process";
+function lowerPriority(pid) {
+  if (pid === void 0) return;
+  try {
+    os3.setPriority(pid, os3.constants.priority.PRIORITY_BELOW_NORMAL);
+  } catch {
+  }
+}
 function spawnAsync(file2, args, options = {}) {
+  const { lowPriority, ...spawnOptions } = options;
   return new Promise((resolve, reject) => {
-    const child = spawn2(file2, args, { stdio: "ignore", windowsHide: true, ...options });
+    const child = spawn2(file2, args, { stdio: "ignore", windowsHide: true, ...spawnOptions });
+    if (lowPriority) lowerPriority(child.pid);
     child.once("error", reject);
     child.once("close", (code) => resolve(code ?? -1));
   });
@@ -28674,13 +28685,16 @@ function extractArchive(archive, destination, members2 = []) {
 }
 async function extract(archive, destination, members2) {
   fs6.mkdirSync(destination, { recursive: true });
-  let status = await spawnAsync(SYSTEM.tar(), ["-xf", archive, "-C", destination, ...members2]);
+  let status = await spawnAsync(SYSTEM.tar(), ["-xf", archive, "-C", destination, ...members2], {
+    lowPriority: true
+  });
   if (status !== 0 && /\.(zip|nupkg)$/i.test(archive)) {
     const zip = archive.endsWith(".zip") ? archive : archive + ".zip";
     if (zip !== archive) fs6.copyFileSync(archive, zip);
     status = await spawnAsync(
       SYSTEM.powershell(),
-      scriptArgs("expand-archive.ps1", ["-Archive", zip, "-Destination", destination])
+      scriptArgs("expand-archive.ps1", ["-Archive", zip, "-Destination", destination]),
+      { lowPriority: true }
     );
   }
   if (status !== 0) throw new Error("Could not extract " + archive);

package/dist/selftest/app.test.js

@@ -7,13 +7,13 @@ import path from 'node:path';
 import { z } from 'zod';
 import { agentNameProblem, agentsPage, agentsView } from '../app/features/agents/index.js';
 import { DEFINITIONS, NAV, navSections, navViews, QUERIES, VIEWS, viewById } from '../app/features/defs.js';
-import { accountsPage, agentPage, listAccounts } from '../app/features/accounts/index.js';
+import { accountsPage, agentPage, listAccounts, listServices, } from '../app/features/accounts/index.js';
 import { addProject, projectRoots, projectsPage } from '../app/features/projects/index.js';
 import { cleanData, dataPage, showData } from '../app/features/data/index.js';
 import { showStorage, storagePage, storageView, } from '../app/features/storage/index.js';
 import { insideSandbox, isSandboxRunning } from '../host/sandbox/index.js';
 import { CRASH, listLogs, logsPage, tailLog } from '../app/features/logs/index.js';
-import { DEFAULTS } from '../core/config/index.js';
+import { DEFAULTS, loadConfig } from '../core/config/index.js';
 import { sandboxPage } from '../app/features/sandbox/index.js';
 import { closeSession, sessionsPage, startShell, } from '../app/features/sessions/index.js';
 import { APP_GROUPS, appsPage, listApps } from '../app/features/apps/index.js';
@@ -460,6 +460,24 @@ export const appSuite = {
             storageRoot: t.at('app-apps', 'storage'),
             dataPath: t.dir('app-apps', 'data'),
         };
+        t.section('a page read after an action shows what the action saved');
+        const freshConfig = t.writeJson(t.at('app-fresh', 'config.json'), {
+            storage: { root: t.dir('app-fresh', 'storage') },
+        });
+        const freshCtx = {
+            loaded: loadConfig(freshConfig),
+            options: {},
+            storageRoot: t.at('app-fresh', 'storage'),
+            dataPath: t.dir('app-fresh', 'data'),
+        };
+        const shareOf = async () => (await readQuery(listServices, freshCtx, { name: 'comet' })).services[0]?.share;
+        t.check((await shareOf()) === false, 'a service starts not shared');
+        await runDefinition('settings.set', freshCtx, { scope: 'user', key: 'accounts.comet.share', value: true }, quiet);
+        t.check((await shareOf()) === true, 'after the share toggle runs, the service page reads it as shared');
+        await runDefinition('settings.set', freshCtx, { scope: 'user', key: 'accounts.comet.share', value: false }, quiet);
+        t.check((await shareOf()) === false, 'and as not shared again after the next toggle');
+        await runDefinition('apps.toggle', freshCtx, { id: 'perplexity-desktop', on: true }, quiet);
+        t.check(freshCtx.loaded.config.apps.install.includes('perplexity-desktop'), 'an app turned on in Apps is in the settings every page reads next');
         await runDefinition('apps.toggle', appsCtx, { id: 'lazygit', on: true }, quiet);
         const onText = fs.readFileSync(appsConfig, 'utf8');
         await runDefinition('apps.toggle', appsCtx, { id: 'lazygit', on: false }, quiet);

package/dist/selftest/boot-runner.test.js

@@ -4,7 +4,9 @@ import { BootRunner, checkGraph, duration } from '../guest/boot/runner.js';
 import { BOOT_TASKS, STAGES, stageTitle } from '../guest/boot/graph.js';
 import { backgroundNames, mergeParts, runSplit } from '../guest/toolchains/split.js';
 import { StepScheduler } from '../guest/toolchains/step-scheduler.js';
-import { Limiter, asBackground, installerRetry, INSTALLER_RETRIES } from '../shared/concurrency/index.js';
+import os from 'node:os';
+import { Limiter, asBackground, installerRetry, INSTALLER_RETRIES, net, heavy, installer, } from '../shared/concurrency/index.js';
+import { spawnAsync } from '../shared/download/index.js';
 const deferred = () => {
     let resolve = () => undefined;
     let reject = (_) => undefined;
@@ -288,6 +290,18 @@ export const bootRunnerSuite = {
             t.check(message.includes('nested pool') && again.includes('nested pool'), 'taking a second pool (or the same one) while holding one throws "nested pool"', message);
             t.check((await a.run(() => 7)) === 7 && a.running === 0, 'the slot is free again after a nested-pool error');
         }
+        {
+            // At most 3 downloads + 2 unpacks + 1 installer run at once, whatever the boot tasks, steps and apps ask for.
+            const busy = async (pool) => {
+                await Promise.all(Array.from({ length: 12 }, () => pool.run(() => sleep(5))));
+                return pool.peak;
+            };
+            t.check((await busy(net)) <= 3 && (await busy(heavy)) <= 2 && (await busy(installer)) <= 1, 'the shared pools cap at net 3, heavy 2 and installer 1', 'net ' + net.peak + ', heavy ' + heavy.peak + ', installer ' + installer.peak);
+            const script = 'setTimeout(() => process.exit(require("os").getPriority() > 0 ? 0 : 3), 400)';
+            const low = await spawnAsync(process.execPath, ['-e', script], { lowPriority: true });
+            const normal = await spawnAsync(process.execPath, ['-e', script]);
+            t.check(low === 0 && normal === 3 && os.getPriority() <= 0, 'lowPriority starts a program below normal priority; the default stays normal', 'low ' + low + ', normal ' + normal);
+        }
         t.check(installerRetry(1618, 1) &&
             installerRetry(1618, INSTALLER_RETRIES) &&
             !installerRetry(1618, INSTALLER_RETRIES + 1) &&

package/dist/selftest/engines.test.js

@@ -12,7 +12,7 @@ import { isWin } from '../core/util/index.js';
 import { ConfigSchema } from '../core/schema/index.js';
 import { decodeText, encodeText, readBoundedFile } from '../shared/io/index.js';
 import { SYSTEM } from '../shared/system.js';
-import { chooseEngine, ddcVars, enginePlaceProblem, ENGINE_NEED_BYTES, engineAt, engineExtraDirs, engineToolDirs, engineVars, entriesUnder, fileAssociationPlan, findEngines, findUproject, hasMcpPlugin, incompleteDirs, isBuildId, installLocationOf, itemSizes, launcherEntriesFor, launcherEntry, launcherInstallations, mergeLauncherInstalled, parseBuildVersion, parseEngineAssociation, preferredInstalled, registryPlan, restoreItems, saveItems, setLauncherInstallLocation, stableBuildId, UNREAL_STATUS_FILE, unrealGuideLines, unrealSummaryLine, uprojectAssociation, vaultDirsFromIni, vaultPacks, vsVerdict, VsSetupReportSchema, withInstallLocation, } from '../shared/unreal/index.js';
+import { chooseEngine, ddcVars, enginePlaceProblem, ENGINE_NEED_BYTES, engineAt, engineExtraDirs, engineToolDirs, engineVars, entriesUnder, fileAssociationPlan, findEngines, findUproject, hasMcpPlugin, incompleteDirs, isBuildId, installLocationOf, itemSizes, launcherEntriesFor, launcherEntry, launcherInstallations, mergeLauncherInstalled, parseBuildVersion, parseEngineAssociation, preferredInstalled, registryPlan, relocateItem, restoreItems, saveItems, setLauncherInstallLocation, stableBuildId, UNREAL_STATUS_FILE, unrealGuideLines, unrealSummaryLine, uprojectAssociation, vaultDirsFromIni, vaultPacks, vsVerdict, VsSetupReportSchema, withInstallLocation, } from '../shared/unreal/index.js';
 import { discoverPcInstalls } from '../host/pc-installs/index.js';
 import { findEngineFolders, findUnrealInstalls, pcSourceBuilds, regValues } from '../host/pc-installs/unreal.js';
 import { findEpicGames } from '../host/pc-installs/epic.js';
@@ -255,6 +255,7 @@ export const enginesSuite = {
             projects: [{ workspace: 'C:\\Projects\\Work\\MyGame', engine: pcEngine, reason: 'the project asks for 5.4' }],
             launcher: {
                 installed: true,
+                exe: null,
                 installLocation: enginesRoot,
                 problem: null,
                 freeBytes: null,
@@ -380,6 +381,14 @@ export const enginesSuite = {
                     AppVersion: 'v',
                     AppName: 'UE_5.3',
                 },
+                {
+                    InstallLocation: pcLauncher,
+                    NamespaceId: 'ue',
+                    ItemId: 'fab',
+                    ArtifactId: 'FabPlugin_5.4',
+                    AppVersion: '5.4.4-1+++UE5+Release-5.4-0.0.21',
+                    AppName: 'FabPlugin_5.4',
+                },
             ],
         });
         const reg = '\r\nHKEY_CURRENT_USER\\Software\\Epic Games\\Unreal Engine\\Builds\r\n    {2D9FCA5D-4E7B-4C12-8B6E-1A2B3C4D5E6F}    REG_SZ    ' +
@@ -401,13 +410,52 @@ export const enginesSuite = {
         t.check(pcFound.every((i) => i.host !== path.join(pcRoot, 'gone')), 'an entry whose folder is gone is left out');
         t.equal(findUnrealInstalls(files, ['5.6']).map((i) => i.host), [pcDefault], 'a list maps only those versions');
         t.equal(findUnrealInstalls({ ...files, launcherInstalled: null, builds: '' }, true).map((i) => i.id), ['UE_5.4', 'UE_5.6'], 'no LauncherInstalled.dat: the default folders');
+        const otherDrive = makeEngine(path.join(pcRoot, 'F', 'Program Files', 'Epic Games', 'UE_5.8'), [5, 8, 0], true);
+        t.equal(findUnrealInstalls({
+            ...files,
+            launcherInstalled: null,
+            defaultRoot: path.join(pcRoot, 'none'),
+            otherRoots: [path.join(pcRoot, 'F', 'Program Files', 'Epic Games')],
+        }, true).map((i) => i.host), [otherDrive], 'an engine in the default place on another drive is found');
+        const nextTo = JSON.stringify({
+            InstallationList: [
+                {
+                    InstallLocation: path.join(pcRoot, 'F', 'Program Files', 'Epic Games', 'SomeGame'),
+                    NamespaceId: 'fn',
+                    ItemId: 'g',
+                    ArtifactId: 'SomeGame',
+                    AppVersion: '1',
+                    AppName: 'SomeGame',
+                },
+            ],
+        });
+        t.equal(findUnrealInstalls({ ...files, launcherInstalled: nextTo, defaultRoot: path.join(pcRoot, 'none') }, true).map((i) => i.id), ['UE_5.8'], 'and one next to what the launcher lists');
         const folders = findEngineFolders({ read: DISK.read, builds: reg }, [
             pcSource,
             path.join(pcRoot, 'nothing'),
             'relative',
         ]);
         t.equal(folders.map((f) => [f.id, f.writable]), [['dir-UnrealEngine', true]], 'a registered folder is mapped writable; one without an engine is left out');
-        t.equal(findEpicGames(dat, true).map((g) => g.id), ['Fortnite'], "the launcher's games are the epic-game installs (engines are not)");
+        const pcManifests = t.dir('pc-pcManifests');
+        const itemText = JSON.stringify({
+            AppName: 'UE_5.4',
+            InstallLocation: pcLauncher.replace(/\\/g, '/'),
+            ManifestLocation: pcLauncher + '/.egstore',
+            StagingLocation: 'D:\\Elsewhere\\bps',
+            InstallSize: 123,
+        });
+        fs.writeFileSync(path.join(pcManifests, 'ABCDEF0123.item'), itemText);
+        fs.writeFileSync(path.join(pcManifests, 'notes.txt'), 'not a manifest');
+        const pcRegistered = findEngineFolders({ read: DISK.read, builds: '', launcherInstalled: dat, manifests: pcManifests, list: DISK.list }, [pcLauncher])[0];
+        t.check(pcRegistered?.launcher?.itemId === 'item54' && pcRegistered.launcherItem?.name === 'ABCDEF0123.item', 'a pcRegistered folder the launcher installed keeps its ids and its manifest');
+        const moved = relocateItem(itemText, pcLauncher, 'C:\\PcInstalls\\unreal\\dir-UE_5.4');
+        const movedItem = JSON.parse(moved ?? '{}');
+        t.check(movedItem.InstallLocation === 'C:\\PcInstalls\\unreal\\dir-UE_5.4' &&
+            movedItem.ManifestLocation === 'C:\\PcInstalls\\unreal\\dir-UE_5.4\\.egstore' &&
+            !('StagingLocation' in movedItem) &&
+            movedItem.InstallSize === 123, "the manifest names the sandbox's folder; a path elsewhere on this PC is dropped");
+        t.equal(relocateItem(itemText, path.join(pcRoot, 'other'), 'C:\\x'), null, 'a manifest of another folder: none');
+        t.equal(findEpicGames(dat, true).map((g) => g.id), ['Fortnite'], "the launcher's games are the epic-game installs (engines and the Fab plugin in one are not)");
         t.equal(findEpicGames(dat, ['nothing']), [], 'a list maps only those games');
         t.check(engineFolderProblem(pcSource, DISK.read) === null, 'Register an engine folder accepts an engine folder');
         t.includes(engineFolderProblem(pcRoot, DISK.read) ?? '', 'not an Unreal Engine folder', 'and refuses one without Build.version');
@@ -441,6 +489,8 @@ export const enginesSuite = {
         t.check(new Set(ids).size === ids.length, 'every app id is used once');
         t.equal(GAMEDEV_APPS.map((a) => a.id), ['krita', 'inkscape', 'audacity', 'renderdoc', 'f3d', 'imagemagick', 'nomacs', 'unity-mcp', 'openupm-cli'], 'Krita, Inkscape, Audacity, RenderDoc, F3D, ImageMagick, nomacs, then the Unity add-ons (Blender was there)');
         t.check(ids.includes('blender'), 'Blender is in the catalogue');
+        const f3d = GAMEDEV_APPS.find((a) => a.id === 'f3d');
+        t.check(f3d.onPath === true && !f3d.cli, 'F3D is on PATH (the preview guide runs `f3d`) and keeps its shortcut');
         t.check(GAMEDEV_APPS.every((a) => (a.category === 'gamedev' || a.id === 'unity-mcp') && a.exe && a.about.length > 20), 'each is a game-development app with its program');
         const audacity = new RegExp(GAMEDEV_APPS.find((a) => a.id === 'audacity').source.asset);
         t.check(audacity.test('audacity-win-4.0.2-x86_64.7z') &&

package/dist/selftest/menu-screens.js

@@ -19,6 +19,7 @@ import { SECTION_LABELS } from '../cli/menu/shell.js';
 import { Frame, ListScreen, OverlayScreen, Text } from '../cli/tui/index.js';
 export const SIZES = [
     { width: 200, height: 60 },
+    { width: 120, height: 30 },
     { width: 100, height: 30 },
     { width: 80, height: 24 },
     { width: 60, height: 20 },
@@ -38,6 +39,48 @@ const DATA_FOLDER_ROW = [
 const ACCOUNTS = {
     agent: 'claude',
     services: [
+        {
+            kind: 'epic',
+            label: SERVICE_SPECS.epic.label,
+            share: true,
+            state: 'none',
+            source: null,
+            savedAt: null,
+            summary: null,
+            heldBy: null,
+            usedBy: ['unreal'],
+            usedFor: 'unreal',
+            warnings: [...SERVICE_SPECS.epic.warnings],
+            canImport: true,
+            canLogin: false,
+            needsFile: false,
+            fromPc: true,
+            hasFileSource: false,
+            onPc: true,
+            sandboxOnly: false,
+            ready: true,
+        },
+        {
+            kind: 'keystore',
+            label: SERVICE_SPECS.keystore.label,
+            share: false,
+            state: 'none',
+            source: null,
+            savedAt: null,
+            summary: null,
+            heldBy: null,
+            usedBy: ['flutter'],
+            usedFor: 'flutter',
+            warnings: [...SERVICE_SPECS.keystore.warnings],
+            canImport: true,
+            canLogin: false,
+            needsFile: true,
+            fromPc: false,
+            hasFileSource: true,
+            onPc: null,
+            sandboxOnly: false,
+            ready: false,
+        },
         {
             kind: 'perplexity',
             label: SERVICE_SPECS.perplexity.label,
@@ -53,6 +96,10 @@ const ACCOUNTS = {
             canImport: true,
             canLogin: true,
             needsFile: false,
+            fromPc: true,
+            hasFileSource: true,
+            onPc: true,
+            sandboxOnly: false,
             ready: true,
         },
         {
@@ -70,6 +117,10 @@ const ACCOUNTS = {
             canImport: false,
             canLogin: false,
             needsFile: false,
+            fromPc: false,
+            hasFileSource: false,
+            onPc: null,
+            sandboxOnly: true,
             ready: true,
         },
     ],
@@ -423,7 +474,7 @@ export function renderScreens(dir) {
             ],
             escape: 'cancel',
         });
-        out.push(block('5 Settings: Save / Discard / Cancel', Frame.render({ ...dialog.render(bodySize), nav }, size.width, size.height).map((l) => Text.strip(l).replace(/\s+$/, '')), size), block('6 Accounts', draw(5, accountsOptions(ACCOUNTS), size, status), size), block('6 Accounts · codex', draw(5, { ...accountsOptions(ACCOUNTS), startCategory: 'codex' }, size, status), size), block('6 Accounts · opencode (login not kept)', draw(5, { ...accountsOptions(ACCOUNTS), startCategory: 'opencode' }, size, status), size));
+        out.push(block('5 Settings: Save / Discard / Cancel', Frame.render({ ...dialog.render(bodySize), nav }, size.width, size.height).map((l) => Text.strip(l).replace(/\s+$/, '')), size), block('6 Accounts', draw(5, accountsOptions(ACCOUNTS), size, status), size), ...['epic', 'perplexity', 'comet'].map((kind) => block('6 Accounts · ' + kind, draw(5, { ...accountsOptions(ACCOUNTS), startCategory: 'service:' + kind }, size, status), size)), block('6 Accounts · codex', draw(5, { ...accountsOptions(ACCOUNTS), startCategory: 'codex' }, size, status), size), block('6 Accounts · opencode (login not kept)', draw(5, { ...accountsOptions(ACCOUNTS), startCategory: 'opencode' }, size, status), size));
         for (const category of ['updates', 'data', 'health', 'logs', 'more'])
             out.push(block('7 Maintenance · ' + category, draw(6, { ...maintenanceOptions(maintenance), startCategory: category }, size, status), size));
     }

package/dist/selftest/menu.test.js

@@ -7,7 +7,7 @@ import { Draft } from '../cli/menu/settings/draft.js';
 import { z } from 'zod';
 import { addedAgents, agentNameProblem, commandFromPackage, newAgent } from '../app/features/agents/index.js';
 import { APP_GROUPS, appRows, REQUEST_APP, requestAppUrl } from '../app/features/apps/index.js';
-import { appsCategories, appsItems } from '../cli/menu/pages/apps-page.js';
+import { appsCategories, appsItems, stageTicks } from '../cli/menu/pages/apps-page.js';
 import { readMenuView, saveMenuView } from '../cli/menu/memory.js';
 import path from 'node:path';
 import { argPathKind, optionLabel, optionPathKind, plainDescription } from '../cli/menu/command-fields.js';
@@ -633,6 +633,24 @@ export const menuSuite = {
             appItems.every((i) => groupIds.includes(i.category ?? '')) &&
             appItems.length === appRows(user2, t.dir('apps-groups')).length &&
             APP_CATEGORIES.every((c) => APP_GROUPS.some((g) => g.members.includes(c.id))), 'the apps are in at most 7 groups (with your own programs); every catalogue category belongs to one and every app is listed', groupIds.join());
+        t.section('a Store app ticked on the Apps page is saved and shown on');
+        const appsFile = ConfigFile.user(t.at('apps-store', 'config.json'));
+        const appsDraft = new Draft();
+        const perplexityRow = (d) => appsItems(appsFile, t.dir('apps-store-data'), d).find((i) => i.value === 'perplexity-desktop')?.checked;
+        t.check(perplexityRow(appsDraft) === false, 'the Perplexity desktop app starts off');
+        const alreadyOn = appRows(appsFile, t.dir('apps-store-data'))
+            .filter((r) => r.on)
+            .map((r) => r.id);
+        stageTicks(appsFile, appsDraft, [...alreadyOn, 'perplexity-desktop']);
+        t.check(perplexityRow(appsDraft) === true && appsDraft.count() === 1, 'ticking it shows it on and stages one change');
+        const applied = appsDraft.apply();
+        t.check(applied.saved === 1 &&
+            applied.problems.length === 0 &&
+            appsFile.valueInFile(['apps', 'install']).includes('perplexity-desktop') &&
+            perplexityRow(new Draft()) === true, 'Ctrl+S writes it into apps.install and the page still shows it on');
+        const toggleCtx = { loaded: { configPath: appsFile.file }, options: {}, dataPath: t.dir('apps-store-data') };
+        await runDefinition('apps.toggle', toggleCtx, { id: 'perplexity-desktop', on: false }, quiet());
+        t.check(!(ConfigFile.user(appsFile.file).valueInFile(['apps', 'install']) ?? []).includes('perplexity-desktop'), 'and the web toggle (apps.toggle) turns it off in the same list');
         t.section('dialog box');
         const box = dialogBox({ title: 'Unsaved changes', lines: ['You have 2 unsaved changes.'], buttons: 'Save' }, 61);
         const base = Array.from({ length: 12 }, () => 'x'.repeat(60));
@@ -742,11 +760,19 @@ export const menuSuite = {
             const size = /\((\d+)x(\d+)\)/.exec(head);
             return !size || rows.length !== Number(size[2]) || rows.some((l) => Text.width(l) > Number(size[1]) - 1);
         });
-        t.equal(overflow.map((b) => b.slice(0, b.indexOf('\n'))), [], 'every screen is exactly as tall as the terminal and never wider, at 200x60, 100x30, 80x24 and 60x20');
-        t.check(SIZES.length === 4 &&
+        t.equal(overflow.map((b) => b.slice(0, b.indexOf('\n'))), [], 'every screen is exactly as tall as the terminal and never wider, at 200x60, 120x30, 100x30, 80x24 and 60x20');
+        t.check(SIZES.length === 5 &&
             screens.includes('=== 7 Maintenance · health (80x24) ===') &&
             screens.includes('unsaved: 2') &&
             screens.includes('Save'), 'all screens render at both sizes; the settings screen shows its unsaved count and the leave dialog offers Save');
+        const serviceScreens = blocks.filter((b) => /^6 Accounts · (epic|perplexity|comet) \((80x24|120x30)\)/.test(b));
+        const serviceRows = serviceScreens.flatMap((b) => b.split('\n').slice(1));
+        t.check(serviceScreens.length === 6 &&
+            serviceRows.every((l) => !/\bsandbox (account|launch|config)\b/.test(l)) &&
+            serviceRows.every((l) => !l.includes('(encrypted)') && !/[A-Za-z]…/.test(l.replace(/(file|sign-in|Forget)…/g, ''))) &&
+            serviceRows.some((l) => l.includes('On this PC') && l.includes('found')) &&
+            serviceRows.some((l) => l.includes('Perplexity API')) &&
+            !serviceRows.some((l) => l.includes('Perplexity API key')), 'the service pages read short at 80 and 120 columns: short names, a few facts, no cut words, no command hints');
         const out = process.env.MENU_SCREENS_OUT;
         if (out)
             fs.writeFileSync(out, screens, 'utf8');

package/dist/selftest/mixamo.test.js

@@ -18,7 +18,7 @@ function statusWith(version) {
             },
         ],
         projects: [{ workspace: PROJECT.workspace, engine: 'C:\\E', reason: 'test' }],
-        launcher: { installed: false, installLocation: null, problem: null, freeBytes: null, needBytes: 1 },
+        launcher: { installed: false, exe: null, installLocation: null, problem: null, freeBytes: null, needBytes: 1 },
         visualStudio: { version: '17.14', path: 'C:/VS', how: 'kept', check: 'ok', ok: true },
         debugger: null,
         ddc: { mode: 'persisted', dir: null },