windows-development-sandbox 1.25.0 → 1.25.1

package/dist/selftest/hostile-input.test.js

@@ -8,7 +8,7 @@ import { assertSafeMapping } from '../core/safe-paths.js';
 import { safeText } from '../core/util/index.js';
 import { isSafeFileName } from '../shared/paths/index.js';
 import { removeRefusal, safeRemove } from '../shared/io/index.js';
-import { writeJsonAtomic } from '../shared/io/index.js';
+import { rotateLog, writeJsonAtomic } from '../shared/io/index.js';
 export const hostileInputSuite = {
     name: 'hostile-input',
     title: 'file names, deletes, printed text, mappings and state files from an untrusted sandbox',
@@ -63,5 +63,15 @@ export const hostileInputSuite = {
         fs.writeFileSync(path.join(repoDir, '.sandbox-config.json'), '{"readOnly": true}' + ' '.repeat(1100 * 1024));
         await t.throws(() => f.run({ cwd: repoDir, trustConfig: true }), 'over 1 MB', 'a .sandbox-config.json over 1 MB is refused before it is parsed');
         fs.rmSync(path.join(repoDir, '.sandbox-config.json'));
+        t.section('a log that grows for ever (Headroom appends to one on the data disk)');
+        const logFile = t.at('rotate', 'proxy.log');
+        fs.mkdirSync(path.dirname(logFile), { recursive: true });
+        t.check(!rotateLog(logFile, 10), 'no log yet: nothing to rotate');
+        fs.writeFileSync(logFile, 'x'.repeat(10));
+        t.check(!rotateLog(logFile, 10) && fs.existsSync(logFile), 'a log at the limit stays');
+        fs.writeFileSync(logFile + '.1', 'old');
+        fs.writeFileSync(logFile, 'y'.repeat(11));
+        t.check(rotateLog(logFile, 10), 'a log over the limit is rotated');
+        t.check(!fs.existsSync(logFile) && fs.readFileSync(logFile + '.1', 'utf8') === 'y'.repeat(11), 'it replaces the older copy');
     },
 };

package/dist/selftest/index.js

@@ -16,6 +16,7 @@ import { persistedInstallsSuite } from './persisted-installs.test.js';
 import { pcInstallsSuite } from './pc-installs.test.js';
 import { steamSuite } from './steam.test.js';
 import { enginesSuite } from './engines.test.js';
+import { mixamoSuite } from './mixamo.test.js';
 import { unitySuite } from './unity.test.js';
 import { fivemSuite } from './fivem.test.js';
 import { androidSuite } from './android.test.js';
@@ -139,6 +140,7 @@ export const SUITES = [
     persistedInstallsSuite,
     steamSuite,
     enginesSuite,
+    mixamoSuite,
     unitySuite,
     fivemSuite,
     androidSuite,

package/dist/selftest/menu-screens.js

@@ -10,6 +10,7 @@ import { appsOptions, stageTicks } from '../cli/menu/pages/apps-page.js';
 import { maintenanceOptions } from '../cli/menu/pages/maintenance-page.js';
 import { sandboxOptions } from '../cli/menu/pages/sandbox-page.js';
 import { sessionsOptions } from '../cli/menu/pages/sessions-page.js';
+import { UNREAL_SAMPLE } from './support/unreal-sample.js';
 import { settingsOf, settingsOptions } from '../cli/menu/pages/settings-page.js';
 import { CATEGORIES } from '../app/features/settings/index.js';
 import { agentsOptions } from '../cli/menu/pages/agents-page.js';
@@ -199,6 +200,7 @@ export function renderScreens(dir) {
             { name: 'redis', running: false, port: 6379, title: 'Redis' },
         ],
         defaultAgent: 'claude',
+        unreal: UNREAL_SAMPLE,
     };
     const stopped = {
         ...sandbox,
@@ -399,7 +401,7 @@ export function renderScreens(dir) {
         out.push(block('1 Agents · Start', draw(0, { ...agentsOptions(agentsModel, API_FOLDER), startCategory: 'start' }, size, status), size), block('1 Agents · Options (navigation focused)', draw(0, { ...agentsOptions(agentsModel, API_FOLDER), startCategory: 'options' }, size, status, 0, true), size), block('1 Agents · On this PC', draw(0, { ...agentsOptions(agentsModel, API_FOLDER), startCategory: 'host' }, size, status), size), block('2 Sessions', draw(1, sessionsOptions({ sandboxRunning: true, sessions: SESSIONS, defaultAgent: 'claude' }), size, status), size), block('2 Sessions (no sandbox)', draw(1, sessionsOptions({ sandboxRunning: false, sessions: [], defaultAgent: 'claude' }), size), size));
         for (const category of ['status', 'databases'])
             out.push(block('3 Sandbox (stopped) · ' + category, draw(2, { ...sandboxOptions(stopped), startCategory: category }, size), size));
-        for (const category of ['status', 'projects', 'databases'])
+        for (const category of ['status', 'projects', 'databases', 'unreal'])
             out.push(block('3 Sandbox · ' + category, draw(2, { ...sandboxOptions(sandbox), startCategory: category }, size, status), size));
         out.push(block('4 Apps (1 unsaved)', draw(3, appsOptions(user, appsData, appsDraft, 'user'), size, status, appsDraft.count()), size));
         for (const category of CATEGORIES)

package/dist/selftest/mixamo.test.d.ts

@@ -0,0 +1,2 @@
+import type { Suite } from './support/suite.js';
+export declare const mixamoSuite: Suite;

package/dist/selftest/mixamo.test.js

@@ -0,0 +1,60 @@
+// Mixamo: the browser policy table (downloads folder, no GPU) and the guide's Mixamo lines and editor names.
+import { browserPolicies } from '../shared/browser-policy.js';
+import { unrealGuideLines } from '../shared/unreal/guide.js';
+const DOWNLOADS = 'C:\\AgentData\\downloads';
+const PROJECT = { workspace: 'C:\\P\\Game', uproject: 'C:\\P\\Game\\Game.uproject' };
+function statusWith(version) {
+    return {
+        updatedAt: 'now',
+        engines: [
+            {
+                id: 'UE_' + version,
+                dir: 'C:\\E',
+                version,
+                build: 'installed',
+                origin: 'pc',
+                writable: true,
+                sizeBytes: null,
+            },
+        ],
+        projects: [{ workspace: PROJECT.workspace, engine: 'C:\\E', reason: 'test' }],
+        launcher: { installed: false, 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 },
+        vaults: [],
+        mcpUrl: null,
+    };
+}
+export const mixamoSuite = {
+    name: 'mixamo',
+    title: 'Mixamo: browser downloads folder and the guide lines for bringing characters into Unreal',
+    run: async (t) => {
+        t.section('browser policies');
+        const four = browserPolicies({ downloads: DOWNLOADS });
+        t.equal(four.length, 4, 'two browsers, two policies each');
+        t.equal(four.filter((p) => p.name === 'DefaultDownloadDirectory').map((p) => p.data), [DOWNLOADS, DOWNLOADS], 'both browsers download to the data disk');
+        t.equal(browserPolicies({ downloads: null }).length, 2, 'no folder: only the GPU policy');
+        await t.throws(() => browserPolicies({ downloads: 'C:\\a"b' }), 'not a folder', 'a quote in the folder is refused');
+        await t.throws(() => browserPolicies({ downloads: 'downloads' }), 'not a folder', 'a relative folder is refused');
+        t.section('the guide');
+        const on = { mixamo: { downloads: DOWNLOADS, script: null } };
+        const guide = unrealGuideLines(statusWith('5.4.4'), [PROJECT], on).join('\n');
+        t.includes(guide, 'https://www.mixamo.com', 'the Mixamo line is there');
+        t.includes(guide, DOWNLOADS, 'it names the downloads folder');
+        t.includes(guide, 'Mixamo into Unreal', 'and the import line');
+        t.excludes(guide, 'Mixamo import script', 'no script line without a script');
+        const withScript = unrealGuideLines(statusWith('5.4.4'), [PROJECT], {
+            mixamo: { downloads: DOWNLOADS, script: 'C:\\x\\import_mixamo.py' },
+        }).join('\n');
+        t.includes(withScript, 'Mixamo import script', 'a script adds its line');
+        t.excludes(unrealGuideLines(statusWith('5.4.4'), [PROJECT]).join('\n'), 'Mixamo', 'off by default');
+        const noEngine = { ...statusWith('5.4.4'), engines: [] };
+        t.excludes(unrealGuideLines(noEngine, [PROJECT], on).join('\n'), 'Mixamo', 'no engine: no Mixamo lines');
+        t.section('UE4 names');
+        const ue4 = unrealGuideLines(statusWith('4.27.2'), [PROJECT]).join('\n');
+        t.includes(ue4, 'UE4Editor-Cmd.exe', 'a UE4 engine uses UE4Editor-Cmd.exe');
+        t.excludes(ue4, 'UnrealEditor', 'and not the UE5 names');
+        t.includes(unrealGuideLines(statusWith('5.4.4'), [PROJECT]).join('\n'), 'UnrealEditor-Cmd.exe', 'UE5 keeps its names');
+    },
+};

package/dist/selftest/secrets.test.js

@@ -1,7 +1,9 @@
 // What reaches the sandbox from this PC's Claude files, and what is stripped first: API keys, cloud credentials, tokens
 // in MCP server definitions. Also the secret-looking files in a workspace that the launch warns about.
 import path from 'node:path';
-import { findSecretFiles, sandboxGlobalState, stripMcpServers, stripSettings } from '../host/profile/index.js';
+import fs from 'node:fs';
+import { DEFAULTS } from '../core/config/index.js';
+import { findSecretFiles, pluginFilter, pluginTrimLevel, sandboxGlobalState, stageClaudeProfile, stripMcpServers, stripSettings, } from '../host/profile/index.js';
 const REMOVED = '[removed by agent-sandbox]';
 export const secretsSuite = {
     name: 'secrets',
@@ -111,5 +113,38 @@ export const secretsSuite = {
         ])
             t.write(path.join(workspace, file), 'x');
         t.equal(findSecretFiles(workspace).sort(), ['.env', 'api\\credentials.json', 'server.pem'], 'secret-looking workspace files are found for the launch warning (templates and dependencies ignored)');
+        t.section('plugins staged from this PC');
+        const hostClaude = t.at('plugins-host');
+        const plugins = path.join(hostClaude, 'plugins');
+        t.write(path.join(plugins, 'installed_plugins.json'), '{"version":2,"plugins":{}}');
+        t.write(path.join(plugins, 'known_marketplaces.json'), '{}');
+        t.write(path.join(plugins, 'cache', 'm', 'p', '1.0', 'plugin.json'), '{}');
+        t.write(path.join(plugins, 'cache', 'm', 'p', '1.0', 'node_modules', 'dep', 'index.js'), 'x');
+        t.write(path.join(plugins, 'cache', 'temp_git_1_abc', 'junk.txt'), 'x');
+        t.write(path.join(plugins, 'marketplaces', 'm', 'marketplace.json'), '{}');
+        t.write(path.join(plugins, 'marketplaces', 'm', '.git', 'HEAD'), 'ref');
+        t.write(path.join(plugins, 'marketplaces', 'm.backup', 'old.txt'), 'x');
+        t.write(path.join(plugins, 'marketplaces', 'temp_subdir_2.clone', 'junk.txt'), 'x');
+        t.write(path.join(hostClaude, 'settings.json'), '{"enabledPlugins":{"p@m":true}}');
+        const launch = t.at('plugins-launch');
+        const profile = { ...DEFAULTS.claudeProfile, hostDir: hostClaude, globalStateFile: '' };
+        const staged = stageClaudeProfile(profile, launch, 'D:/Code/app', DEFAULTS.secrets);
+        const out = path.join(launch, 'claude-profile', 'plugins');
+        t.check(staged.staged.includes('plugins'), 'plugins are staged');
+        t.check(fs.existsSync(path.join(out, 'cache', 'm', 'p', '1.0', 'plugin.json')) &&
+            fs.existsSync(path.join(out, 'marketplaces', 'm', 'marketplace.json')) &&
+            fs.existsSync(path.join(out, 'marketplaces', 'm', '.git', 'HEAD')) &&
+            fs.existsSync(path.join(out, 'cache', 'm', 'p', '1.0', 'node_modules', 'dep', 'index.js')), 'the plugin cache, marketplaces and (when they fit) their git folders and dependencies are copied');
+        t.check(!fs.existsSync(path.join(out, 'cache', 'temp_git_1_abc')) &&
+            !fs.existsSync(path.join(out, 'marketplaces', 'm.backup')) &&
+            !fs.existsSync(path.join(out, 'marketplaces', 'temp_subdir_2.clone')), 'interrupted clones, backups and staging folders of plugins are left out');
+        t.check(pluginTrimLevel(plugins) === 0, 'a plugins folder under the cap is not trimmed');
+        const git = path.join(plugins, 'marketplaces', 'm', '.git');
+        const deps = path.join(plugins, 'cache', 'm', 'p', '1.0', 'node_modules');
+        t.check(pluginFilter(plugins, 0)(git) &&
+            !pluginFilter(plugins, 1)(git) &&
+            pluginFilter(plugins, 1)(deps) &&
+            !pluginFilter(plugins, 2)(deps), 'a plugins folder over the cap loses git history first, then node_modules');
+        t.check(fs.readFileSync(path.join(launch, 'claude-profile', 'settings.json'), 'utf8').includes('p@m'), 'enabledPlugins reach the sandbox');
     },
 };

package/dist/selftest/support/engine-golden.js

@@ -69,6 +69,7 @@ export const LAUNCH_FILES_GOLDEN = [
     'sandbox/csharp/SandboxTools/MemoryLog.cs',
     'sandbox/csharp/SandboxTools/PageFile.cs',
     'sandbox/csharp/SandboxTools/Program.cs',
+    'sandbox/csharp/VsSetup.cs',
     'sandbox/csharp/VsWhere.cs',
     'sandbox/csharp/VtInput.cs',
     'sandbox/scripts/add-firewall-port.ps1',
@@ -76,6 +77,7 @@ export const LAUNCH_FILES_GOLDEN = [
     'sandbox/scripts/expand-archive.ps1',
     'sandbox/scripts/get-gpu-names.ps1',
     'sandbox/scripts/get-signature.ps1',
+    'sandbox/scripts/get-vs-setup.ps1',
     'sandbox/scripts/install-shell-path.ps1',
     'sandbox/scripts/link-profile-dirs.ps1',
     'sandbox/scripts/new-shortcuts.ps1',
@@ -85,6 +87,7 @@ export const LAUNCH_FILES_GOLDEN = [
     'sandbox/scripts/set-desktop.ps1',
     'sandbox/scripts/set-dns-servers.ps1',
     'sandbox/scripts/set-machine-environment.ps1',
+    'sandbox/scripts/set-registry-values.ps1',
     'sandbox/templates/fivem/README.txt',
     'sandbox/templates/fivem/cs/Client/Client.csproj',
     'sandbox/templates/fivem/cs/Client/ClientMain.cs',

package/dist/selftest/support/fixtures.d.ts

@@ -142,7 +142,9 @@ export declare function createFixtures(t: Harness): {
         pcInstalls: {
             steamGames: boolean | number[];
             epicGames: boolean | string[];
-            unrealEngines: boolean | string[];
+            unrealEngines: boolean | string[] | "auto";
+            unrealEngineFolders: string[];
+            unrealAssets: boolean | "auto";
             unityEditors: boolean | string[];
         };
         provisioning: {

package/dist/selftest/support/unreal-sample.d.ts

@@ -0,0 +1,2 @@
+import type { UnrealOverview } from '../../app/features/unreal/index.js';
+export declare const UNREAL_SAMPLE: UnrealOverview;

package/dist/selftest/support/unreal-sample.js

@@ -0,0 +1,83 @@
+export const UNREAL_SAMPLE = {
+    setUp: true,
+    checkedAt: '2026-11-04T12:00:00.000Z',
+    engines: [
+        {
+            id: 'UE_5.6',
+            version: '5.6.1',
+            dir: 'C:\\PcInstalls\\unreal\\UE_5.6',
+            where: 'this PC, read-only',
+            writable: false,
+            build: 'installed',
+            sizeBytes: null,
+            projects: ['ShooterGame'],
+        },
+        {
+            id: 'UE_5.4',
+            version: '5.4.4',
+            dir: 'C:\\AgentData\\tools\\unreal\\engines\\UE_5.4',
+            where: 'Epic Games Launcher, data disk',
+            writable: true,
+            build: 'installed',
+            sizeBytes: 48 * 1024 ** 3,
+            projects: [],
+        },
+    ],
+    projects: [{ project: 'ShooterGame', engine: 'UE_5.6', reason: 'the project asks for 5.6' }],
+    launcher: {
+        installed: true,
+        installLocation: 'C:\\AgentData\\tools\\unreal\\engines',
+        problem: null,
+        free: '812 GB',
+    },
+    visualStudio: {
+        version: '17.14.37827.9',
+        path: 'C:\\AgentData\\tools\\visualstudio\\persist\\Community',
+        how: 'kept on the data disk',
+        check: 'Visual Studio 17.14.37827.9, MSVC 14.44.35207, Windows SDK 10.0.22621.0',
+        ok: true,
+    },
+    debugger: 'C:\\AgentData\\tools\\visualstudio\\persist\\WindowsKits10\\Debuggers\\x64\\cdb.exe',
+    ddc: 'C:\\AgentData\\tools\\unreal\\ddc',
+    mcpUrl: null,
+    pc: {
+        setting: 'auto',
+        engines: [
+            {
+                id: 'UE_5.6',
+                name: 'Unreal Engine 5.6.1',
+                folder: 'C:\\Program Files\\Epic Games\\UE_5.6',
+                writable: false,
+                source: false,
+            },
+            {
+                id: 'dir-UnrealEngine',
+                name: 'Unreal Engine 5.7.0 (UnrealEngine)',
+                folder: 'D:\\Src\\UnrealEngine',
+                writable: true,
+                source: false,
+            },
+        ],
+        problem: null,
+    },
+    vault: {
+        setting: 'auto',
+        folders: [
+            {
+                folder: 'C:\\ProgramData\\Epic\\EpicGamesLauncher\\VaultCache',
+                packs: [
+                    { name: 'CityParkEnvironment', size: '2.1 GB', kind: 'content' },
+                    { name: 'ToolkitPlugin', size: '45 MB', kind: 'plugin' },
+                ],
+                more: 0,
+            },
+        ],
+    },
+    settings: {
+        enabled: 'auto',
+        acceptLicense: true,
+        persistEngines: true,
+        derivedDataCache: 'persisted',
+        visualStudio: 'full',
+    },
+};

package/dist/selftest/toolchains.test.js

@@ -8,12 +8,12 @@ import { decidePwsh, pcHasPwsh, PWSH_MAX_BYTES, readPwshScripts, usesPwsh } from
 import { projectFolderLines, toolLines } from '../guest/boot/guide-lines.js';
 import { binstallAsset, CLI_TOOLS, decideCli, pwshAsset } from '../guest/toolchains/catalogue.js';
 import { missingExtensions, vscodeExtensions, vscodeSettings } from '../guest/toolchains/tools/vscode-profile.js';
-import { addonGuideLine, addonMcpServer, APP_CATEGORIES, APPS, appsNeedMesa, appsNeedUv, appsToInstall, CCUSAGE_VERSION, claudeManagedSettings, CONTEXT7_MCP_VERSION, exeMatcher, HEADROOM_VERSION, headroomArgs, headroomEnv, headroomUrl, PLAYWRIGHT_MCP_VERSION, RTK_VERSION, withAddonMcpServers, } from '../shared/apps/index.js';
+import { addonGuideLine, addonMcpServer, APP_CATEGORIES, APPS, associationPlan, appsNeedMesa, appsNeedUv, appsToInstall, CCUSAGE_VERSION, claudeManagedSettings, CONTEXT7_MCP_VERSION, exeMatcher, HEADROOM_VERSION, headroomArgs, headroomEnv, headroomUrl, PLAYWRIGHT_MCP_VERSION, previewGuideLine, RTK_VERSION, withAddonMcpServers, } from '../shared/apps/index.js';
 import { ConfigSchema, LocalOverridesSchema } from '../core/schema/index.js';
 export const toolchainsSuite = {
     name: 'toolchains',
     title: 'version pickers, release assets, PowerShell 7 and CLI tool decisions',
-    run: (t) => {
+    run: async (t) => {
         t.section('version pickers');
         const releases = [
             { version: 'v23.1.0', lts: false },
@@ -198,6 +198,36 @@ export const toolchainsSuite = {
         t.check(ids.every((id, i) => ids.indexOf(id) === i) &&
             APPS.every((a) => APP_CATEGORIES.some((c) => c.id === a.category)) &&
             !APPS.some(badPattern), 'apps: ids are unique, every app is in a known category, every GitHub asset pattern compiles');
+        t.section('asset preview apps');
+        const previewPick = (id, files) => {
+            const source = APPS.find((x) => x.id === id)?.source;
+            const re = new RegExp(source && 'github' in source ? source.asset : '$^');
+            return files.filter((f) => re.test(f));
+        };
+        t.check(['f3d', 'imagemagick', 'nomacs'].every((id) => APPS.some((a) => a.id === id && a.category === 'gamedev')) &&
+            previewPick('f3d', [
+                'F3D-4.0.1-Windows-x86_64.zip',
+                'F3D-4.0.1-Windows-x86_64.exe',
+                'F3D-4.0.1-Windows-x86_64-raytracing.zip',
+            ]).join() === 'F3D-4.0.1-Windows-x86_64.zip' &&
+            previewPick('imagemagick', [
+                'ImageMagick-7.1.2-35-portable-Q16-HDRI-x64.7z',
+                'ImageMagick-7.1.2-35-portable-Q16-x64.7z',
+                'ImageMagick-7.1.2-35-portable-Q16-HDRI-arm64.7z',
+            ]).join() === 'ImageMagick-7.1.2-35-portable-Q16-HDRI-x64.7z' &&
+            previewPick('nomacs', ['nomacs-portable-win.zip', 'nomacs-setup.exe']).join() === 'nomacs-portable-win.zip', 'preview apps: F3D, ImageMagick and nomacs are in the catalogue and pick the portable download only');
+        const f3d = associationPlan('f3d', 'C:\\x\\f3d.exe');
+        t.check(f3d.some((v) => v.key === 'Software\\Classes\\.fbx' && v.value === 'Sandbox.f3d') &&
+            f3d.some((v) => v.key.endsWith('\\shell\\open\\command') && v.value === '"C:\\x\\f3d.exe" "%1"') &&
+            f3d.every((v) => v.hive === 'HKCU' && v.name === '') &&
+            associationPlan('nomacs', 'C:\\x\\nomacs.exe').some((v) => v.key === 'Software\\Classes\\.tga') &&
+            associationPlan('krita', 'C:\\x\\k.exe').length === 0, 'preview apps: double-click associations name the app per extension; an app without any gets none');
+        await t.throws(() => associationPlan('f3d', 'f3d.exe'), 'not a program path', 'a relative program path is refused');
+        await t.throws(() => associationPlan('f3d', 'C:\\a"b.exe'), 'not a program path', 'a quoted program path is refused');
+        t.check(previewGuideLine([]) === null &&
+            previewGuideLine(['jq']) === null &&
+            (previewGuideLine(['f3d']) ?? '').includes('--output=') &&
+            previewGuideLine(['imagemagick']) !== null, 'preview apps: the agent preview line appears only when F3D or ImageMagick is installed');
         t.check(exeMatcher('/^Godot_v[\\d.]+-stable_win64\\.exe$/')('Godot_v4.7.2-stable_win64.exe') &&
             !exeMatcher('/^Godot_v[\\d.]+-stable_win64\\.exe$/')('Godot_v4.7.2-stable_win64_console.exe') &&
             exeMatcher('Code.exe')('code.EXE'), 'apps: the program is found by name or by pattern');

package/dist/shared/accounts/index.d.ts

@@ -1,7 +1,7 @@
 export * from './kinds.js';
 export * from './payloads.js';
 export { fingerprint } from './fingerprint.js';
-export { epicSettingsFile, MAX_EPIC_INI_BYTES, readEpicLogin, withEpicLogin, type EpicPayload } from './kinds/epic.js';
+export { epicSettingsFile, epicSettingsFiles, MAX_EPIC_INI_BYTES, readEpicLogin, withEpicLogin, type EpicPayload, } from './kinds/epic.js';
 export * from './kinds/steam.js';
 export { PERPLEXITY_ENV, perplexityKeyFromText, perplexitySummary, type PerplexityPayload, } from './kinds/perplexity.js';
 export { cometPayloadFromCookies, cometSummary, cookiesToRestore, type CometPayload } from './kinds/comet.js';

package/dist/shared/accounts/index.js

@@ -3,7 +3,7 @@
 export * from './kinds.js';
 export * from './payloads.js';
 export { fingerprint } from './fingerprint.js';
-export { epicSettingsFile, MAX_EPIC_INI_BYTES, readEpicLogin, withEpicLogin } from './kinds/epic.js';
+export { epicSettingsFile, epicSettingsFiles, MAX_EPIC_INI_BYTES, readEpicLogin, withEpicLogin, } from './kinds/epic.js';
 export * from './kinds/steam.js';
 export { PERPLEXITY_ENV, perplexityKeyFromText, perplexitySummary, } from './kinds/perplexity.js';
 export { cometPayloadFromCookies, cometSummary, cookiesToRestore } from './kinds/comet.js';

package/dist/shared/accounts/kinds/epic.d.ts

@@ -2,8 +2,13 @@ import type { Payload } from '../payloads.js';
 /** At most this much of a GameUserSettings.ini is read. */
 export declare const MAX_EPIC_INI_BYTES: number;
 export type EpicPayload = Payload<'epic'>;
-/** GameUserSettings.ini under a LocalAppData folder (the PC's or the sandbox's). */
+/** GameUserSettings.ini under a LocalAppData folder (the PC's or the sandbox's), where launchers before 17 keep it. */
 export declare function epicSettingsFile(localAppData: string): string;
+/**
+ * Every GameUserSettings.ini the launcher may read, newest place first: launcher 17 and later (20.3 checked) keep it in
+ * Config\WindowsEditor, older ones in Config\Windows.
+ */
+export declare function epicSettingsFiles(localAppData: string): string[];
 /** The saved sign-in in an ini text, or null (none, turned off, or not the expected shape). */
 export declare function readEpicLogin(ini: string): EpicPayload | null;
 /** The ini text with its [RememberMe] section replaced by this sign-in (the other sections are kept). */

package/dist/shared/accounts/kinds/epic.js

@@ -6,10 +6,20 @@ import { EpicPayloadSchema } from '../payloads.js';
 /** At most this much of a GameUserSettings.ini is read. */
 export const MAX_EPIC_INI_BYTES = 1024 * 1024;
 const SECTION = '[rememberme]';
-/** GameUserSettings.ini under a LocalAppData folder (the PC's or the sandbox's). */
+/** GameUserSettings.ini under a LocalAppData folder (the PC's or the sandbox's), where launchers before 17 keep it. */
 export function epicSettingsFile(localAppData) {
     return localAppData + '\\EpicGamesLauncher\\Saved\\Config\\Windows\\GameUserSettings.ini';
 }
+/**
+ * Every GameUserSettings.ini the launcher may read, newest place first: launcher 17 and later (20.3 checked) keep it in
+ * Config\WindowsEditor, older ones in Config\Windows.
+ */
+export function epicSettingsFiles(localAppData) {
+    return [
+        localAppData + '\\EpicGamesLauncher\\Saved\\Config\\WindowsEditor\\GameUserSettings.ini',
+        epicSettingsFile(localAppData),
+    ];
+}
 const isHeader = (line) => line.trimStart().startsWith('[');
 /** The saved sign-in in an ini text, or null (none, turned off, or not the expected shape). */
 export function readEpicLogin(ini) {

package/dist/shared/apps/associations.d.ts

@@ -0,0 +1,7 @@
+import type { RegistryValue } from '../unreal/engines.js';
+export declare const ASSOCIATIONS: {
+    readonly f3d: readonly [".fbx", ".glb", ".gltf", ".obj", ".stl", ".ply", ".3ds", ".usd", ".usdz"];
+    readonly nomacs: readonly [".tga", ".psd", ".dds", ".exr"];
+};
+/** The registry values that make `appId` open its file types; no values for an app that opens none. */
+export declare function associationPlan(appId: string, exe: string): RegistryValue[];

package/dist/shared/apps/associations.js

@@ -0,0 +1,26 @@
+// Which apps open which game-asset files when you double-click them (per user, written to the registry each boot
+// because the sandbox's registry is new every time). Pure: the guest writes the plan with set-registry-values.ps1.
+import path from 'node:path';
+export const ASSOCIATIONS = {
+    f3d: ['.fbx', '.glb', '.gltf', '.obj', '.stl', '.ply', '.3ds', '.usd', '.usdz'],
+    nomacs: ['.tga', '.psd', '.dds', '.exr'],
+};
+const NAMES = { f3d: 'F3D', nomacs: 'nomacs' };
+/** The registry values that make `appId` open its file types; no values for an app that opens none. */
+export function associationPlan(appId, exe) {
+    if (!Object.hasOwn(ASSOCIATIONS, appId))
+        return [];
+    const id = appId;
+    if (!path.win32.isAbsolute(exe) || /["\r\n]/.test(exe))
+        throw new Error('not a program path: ' + exe);
+    const classes = 'Software\\Classes';
+    const type = classes + '\\Sandbox.' + id;
+    const quoted = '"' + exe + '"';
+    const v = (key, value) => ({ hive: 'HKCU', key, name: '', value });
+    return [
+        ...ASSOCIATIONS[id].map((ext) => v(classes + '\\' + ext, 'Sandbox.' + id)),
+        v(type, NAMES[id] + ' file'),
+        v(type + '\\DefaultIcon', quoted + ',0'),
+        v(type + '\\shell\\open\\command', quoted + ' "%1"'),
+    ];
+}

package/dist/shared/apps/catalogue-agents-web.d.ts

@@ -9,6 +9,9 @@ export declare const BROWSER_USE_VERSION = "0.13.14";
 export declare const PERPLEXITY_COMPUTER_MCP_URL = "https://www.perplexity.ai/rest/computer/mcp";
 /** Comet's Windows installer: a redirect to the current release (no checksum is published; its signer is checked). */
 export declare const COMET_DOWNLOAD_URL = "https://www.perplexity.ai/rest/browser/download?platform=win_x64&channel=stable";
-/** Who signs Comet: Perplexity AI, Inc., with an EV code-signing certificate from GlobalSign. */
+/**
+ * Who signs Comet: Perplexity AI, Inc., with an EV code-signing certificate from GlobalSign. Windows reports the
+ * subject with E=<contact address> first (E=..., CN="PERPLEXITY AI, INC.", O=...), so CN is not at the start.
+ */
 export declare const COMET_SIGNER: AppSigner;
 export declare const AGENTS_WEB_APPS: readonly AppEntry[];

package/dist/shared/apps/catalogue-agents-web.js

@@ -7,9 +7,12 @@ export const BROWSER_USE_VERSION = '0.13.14';
 export const PERPLEXITY_COMPUTER_MCP_URL = 'https://www.perplexity.ai/rest/computer/mcp';
 /** Comet's Windows installer: a redirect to the current release (no checksum is published; its signer is checked). */
 export const COMET_DOWNLOAD_URL = 'https://www.perplexity.ai/rest/browser/download?platform=win_x64&channel=stable';
-/** Who signs Comet: Perplexity AI, Inc., with an EV code-signing certificate from GlobalSign. */
+/**
+ * Who signs Comet: Perplexity AI, Inc., with an EV code-signing certificate from GlobalSign. Windows reports the
+ * subject with E=<contact address> first (E=..., CN="PERPLEXITY AI, INC.", O=...), so CN is not at the start.
+ */
 export const COMET_SIGNER = {
-    subject: ['^CN="?PERPLEXITY AI, INC\\.?"?(,|$)', '(^|, )O="?PERPLEXITY AI, INC\\.?"?(,|$)'],
+    subject: ['(^|, )CN="?PERPLEXITY AI, INC\\.?"?(,|$)', '(^|, )O="?PERPLEXITY AI, INC\\.?"?(,|$)'],
     issuer: ['^CN=GlobalSign GCC R45 EV CodeSigning CA 2020(,|$)'],
 };
 /** Microsoft Edge, already in every sandbox: the browser Chrome DevTools MCP starts. */

package/dist/shared/apps/catalogue-gamedev.js

@@ -1 +1,71 @@
-export const GAMEDEV_APPS = [];
+export const GAMEDEV_APPS = [
+    {
+        id: 'krita',
+        name: 'Krita',
+        category: 'gamedev',
+        about: 'Painting and texture editor (PSD, layers, brushes), checked against the SHA-256 download.kde.org publishes.',
+        size: '450 MB',
+        source: { resolve: 'krita' },
+        exe: 'krita.exe',
+        needs: ['mesa'],
+    },
+    {
+        id: 'inkscape',
+        name: 'Inkscape',
+        category: 'gamedev',
+        about: 'Vector graphics for UI, icons and 2D art (SVG), checked against the SHA-256 inkscape.org publishes.',
+        size: '400 MB',
+        source: { resolve: 'inkscape' },
+        exe: 'inkscape.exe',
+        needs: ['7zip'],
+    },
+    {
+        id: 'audacity',
+        name: 'Audacity',
+        category: 'gamedev',
+        about: 'Records and edits sound effects and music (WAV, OGG, FLAC).',
+        size: '80 MB',
+        source: { github: 'audacity/audacity', asset: '^audacity-win-[\\d.]+-(?:64bit\\.zip|x86_64\\.7z)$' },
+        exe: 'Audacity.exe',
+        needs: ['7zip'],
+    },
+    {
+        id: 'renderdoc',
+        name: 'RenderDoc',
+        category: 'gamedev',
+        about: "Captures a frame of a game (Unreal's -d3d12/-vulkan builds) to inspect every draw call, texture and shader. Needs the sandbox's GPU (vGPU) for live captures.",
+        size: '70 MB',
+        source: { resolve: 'renderdoc' },
+        exe: 'qrenderdoc.exe',
+    },
+    {
+        id: 'f3d',
+        name: 'F3D',
+        category: 'gamedev',
+        about: 'Fast 3D viewer (FBX, glTF/GLB, OBJ, STL, PLY, 3DS, USD); renders still previews from the command line.',
+        size: '100 MB',
+        source: { github: 'f3d-app/f3d', asset: '^F3D-[\\d.]+-Windows-x86_64\\.zip$' },
+        exe: 'f3d.exe',
+        needs: ['mesa'],
+    },
+    {
+        id: 'imagemagick',
+        name: 'ImageMagick',
+        category: 'gamedev',
+        about: 'Converts and thumbnails textures (TGA, PSD, DDS, EXR, HDR) and builds contact sheets (magick montage).',
+        size: '150 MB',
+        source: { github: 'ImageMagick/ImageMagick', asset: '^ImageMagick-[\\d.]+-\\d+-portable-Q16-HDRI-x64\\.7z$' },
+        exe: 'magick.exe',
+        cli: true,
+        needs: ['7zip'],
+    },
+    {
+        id: 'nomacs',
+        name: 'nomacs',
+        category: 'gamedev',
+        about: 'Image viewer for textures (TGA, PSD, DDS, EXR).',
+        size: '60 MB',
+        source: { github: 'nomacs/nomacs', asset: '^nomacs-portable-win\\.zip$' },
+        exe: 'nomacs.exe',
+    },
+];

package/dist/shared/apps/index.d.ts

@@ -1,4 +1,6 @@
 export { type AddonMcp, type AppCategory, APP_CATEGORIES, type AppSource, type AppEntry, APPS, appById, CCUSAGE_VERSION, CONTEXT7_MCP_VERSION, HEADROOM_VERSION, PLAYWRIGHT_MCP_VERSION, RTK_VERSION, } from './catalogue.js';
+export { ASSOCIATIONS, associationPlan } from './associations.js';
+export { previewGuideLine } from './preview.js';
 export { exeMatcher, appsToInstall, appsNeedMesa, appsNeedUv } from './selection.js';
 export { signerMatches, type AppSigner, type Signature } from '../signer.js';
 export { AGENTS_WEB_APPS, BROWSER_USE_VERSION, CHROME_DEVTOOLS_MCP_VERSION, COMET_DOWNLOAD_URL, COMET_MCP_VERSION, COMET_SIGNER, PERPLEXITY_COMPUTER_MCP_URL, PERPLEXITY_MCP_VERSION, } from './catalogue-agents-web.js';

package/dist/shared/apps/index.js

@@ -1,4 +1,6 @@
 export { APP_CATEGORIES, APPS, appById, CCUSAGE_VERSION, CONTEXT7_MCP_VERSION, HEADROOM_VERSION, PLAYWRIGHT_MCP_VERSION, RTK_VERSION, } from './catalogue.js';
+export { ASSOCIATIONS, associationPlan } from './associations.js';
+export { previewGuideLine } from './preview.js';
 export { exeMatcher, appsToInstall, appsNeedMesa, appsNeedUv } from './selection.js';
 export { signerMatches } from '../signer.js';
 export { AGENTS_WEB_APPS, BROWSER_USE_VERSION, CHROME_DEVTOOLS_MCP_VERSION, COMET_DOWNLOAD_URL, COMET_MCP_VERSION, COMET_SIGNER, PERPLEXITY_COMPUTER_MCP_URL, PERPLEXITY_MCP_VERSION, } from './catalogue-agents-web.js';

package/dist/shared/apps/preview.d.ts

@@ -0,0 +1,2 @@
+/** Null unless F3D or ImageMagick is installed; `installed` holds app ids. */
+export declare function previewGuideLine(installed: readonly string[]): string | null;

package/dist/shared/apps/preview.js

@@ -0,0 +1,10 @@
+// The one line that tells an agent how to render previews of meshes and textures for the owner (pure).
+/** Null unless F3D or ImageMagick is installed; `installed` holds app ids. */
+export function previewGuideLine(installed) {
+    if (!installed.includes('f3d') && !installed.includes('imagemagick'))
+        return null;
+    return ('asset previews: `f3d "<mesh>" --output="<pkg>\\previews\\<name>.png" --resolution=1024,768 --up=+Y` per mesh ' +
+        '(--up=+Z for Unreal-space files), `magick montage "<pkg>\\source\\**\\*.png" -thumbnail 256x256 -geometry +4+4 ' +
+        '-label %f "<pkg>\\previews\\textures.png"` for textures (convert TGA/PSD/DDS/EXR to PNG first with magick); ' +
+        "leave them in the package's previews\\ folder for the owner to look at before import");
+}

package/dist/shared/browser-policy.d.ts

@@ -0,0 +1,14 @@
+export interface BrowserPolicy {
+    readonly key: string;
+    readonly name: string;
+    readonly type: 'REG_DWORD' | 'REG_SZ';
+    readonly data: string;
+}
+export declare const BROWSER_POLICY_KEYS: readonly ["HKLM\\SOFTWARE\\Policies\\Microsoft\\Edge", "HKLM\\SOFTWARE\\Policies\\Google\\Chrome"];
+/**
+ * The policies for each browser: no hardware acceleration (today's behaviour) and, when a downloads folder is given,
+ * DefaultDownloadDirectory (the default only: Playwright's download path and the user's own choice still win).
+ */
+export declare function browserPolicies(o: {
+    readonly downloads: string | null;
+}): BrowserPolicy[];