windows-development-sandbox 1.25.1 → 1.27.0

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

@@ -15,6 +15,13 @@ export const COMET_SIGNER = {
     subject: ['(^|, )CN="?PERPLEXITY AI, INC\\.?"?(,|$)', '(^|, )O="?PERPLEXITY AI, INC\\.?"?(,|$)'],
     issuer: ['^CN=GlobalSign GCC R45 EV CodeSigning CA 2020(,|$)'],
 };
+/**
+ * The Perplexity desktop app is Store-only (its old installer is gone): product 9P9XG917PWCJ, an MSIX of about 300 MB.
+ * The package is fetched on this PC with your own Store tooling and installed in the sandbox with Add-AppxPackage.
+ */
+export const PERPLEXITY_DESKTOP_PRODUCT_ID = '9P9XG917PWCJ';
+export const PERPLEXITY_DESKTOP_PACKAGE = 'PerplexityAI.PerplexityApp';
+export const PERPLEXITY_DESKTOP_FAMILY = 'PerplexityAI.PerplexityApp_3jh4kjrg4dzr2';
 /** Microsoft Edge, already in every sandbox: the browser Chrome DevTools MCP starts. */
 const EDGE_EXE = 'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe';
 export const AGENTS_WEB_APPS = [
@@ -62,6 +69,22 @@ export const AGENTS_WEB_APPS = [
         signer: COMET_SIGNER,
         userOnly: true,
     },
+    {
+        id: 'perplexity-desktop',
+        name: 'Perplexity (desktop app)',
+        category: 'agents',
+        about: "Perplexity's desktop app, with Perplexity Computer, from the Microsoft Store. The package comes from this PC (winget with your own Microsoft Store access) and is kept on the data disk; the sandbox installs it on every boot. With accounts.perplexityapp.share on, your sign-in made in a sandbox is kept for the next ones (it cannot be copied from this PC). It acts on what it reads: use it only on what you would let it act on.",
+        size: '300 MB',
+        source: {
+            store: {
+                productId: PERPLEXITY_DESKTOP_PRODUCT_ID,
+                packageName: PERPLEXITY_DESKTOP_PACKAGE,
+                family: PERPLEXITY_DESKTOP_FAMILY,
+            },
+        },
+        exe: '',
+        userOnly: true,
+    },
     {
         id: 'comet-mcp',
         name: 'Comet MCP',

package/dist/shared/apps/catalogue-gamedev.d.ts

@@ -1,2 +1,5 @@
 import type { AppEntry } from './catalogue.js';
+/** Pinned packages, installed from the lock files in sandbox\addons\<id> (renewing them: docs/toolchains.md). */
+export declare const UNITY_MCP_VERSION = "10.3.0";
+export declare const OPENUPM_CLI_VERSION = "4.5.3";
 export declare const GAMEDEV_APPS: readonly AppEntry[];

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

@@ -1,3 +1,6 @@
+/** Pinned packages, installed from the lock files in sandbox\addons\<id> (renewing them: docs/toolchains.md). */
+export const UNITY_MCP_VERSION = '10.3.0';
+export const OPENUPM_CLI_VERSION = '4.5.3';
 export const GAMEDEV_APPS = [
     {
         id: 'krita',
@@ -68,4 +71,32 @@ export const GAMEDEV_APPS = [
         source: { github: 'nomacs/nomacs', asset: '^nomacs-portable-win\\.zip$' },
         exe: 'nomacs.exe',
     },
+    {
+        id: 'unity-mcp',
+        name: 'MCP for Unity',
+        category: 'agents',
+        about: 'Lets Claude Code and Codex work in an open Unity editor (CoplayDev/unity-mcp 10.3.0, MIT; Unity 2021.3 to 6.x). Your project needs its package (Unity page: Add the editor bridge). Telemetry is off.',
+        size: '60 MB',
+        source: { locked: 'uv', package: 'mcpforunityserver', version: UNITY_MCP_VERSION },
+        exe: 'mcp-for-unity.exe',
+        service: true,
+        mcp: {
+            name: 'sbx-unity-mcp',
+            program: true,
+            args: ['--transport', 'stdio'],
+            env: { DISABLE_TELEMETRY: '1', UNITY_MCP_DISABLE_TELEMETRY: '1', MCP_DISABLE_TELEMETRY: '1' },
+            codex: true,
+        },
+        plugsInto: 'Claude Code and Codex as the MCP server sbx-unity-mcp',
+        userOnly: true,
+    },
+    {
+        id: 'openupm-cli',
+        name: 'openupm-cli',
+        category: 'gamedev',
+        about: 'Adds OpenUPM packages to Unity projects from the command line (openupm 4.5.3, BSD-3-Clause).',
+        size: '15 MB',
+        source: { locked: 'npm', package: 'openupm-cli', version: OPENUPM_CLI_VERSION },
+        exe: 'openupm.cmd',
+    },
 ];

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

@@ -28,6 +28,14 @@ export type AppSource = {
 /** Nothing to download: a remote MCP server (AddonMcp.url). */
  | {
     remote: true;
+}
+/** A Microsoft Store app: this PC fetches the package with its own Store tooling; the sandbox installs it. */
+ | {
+    store: {
+        productId: string;
+        packageName: string;
+        family: string;
+    };
 };
 /**
  * An MCP server an add-on adds to the sandbox's Claude Code (and Codex, with `codex`): `node <its folder>\<script>

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

@@ -1,7 +1,8 @@
 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 { exeMatcher, appsToInstall, appsNeedMesa, appsNeedUv, storeApps } 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';
+export { AGENTS_WEB_APPS, BROWSER_USE_VERSION, CHROME_DEVTOOLS_MCP_VERSION, COMET_DOWNLOAD_URL, PERPLEXITY_DESKTOP_FAMILY, PERPLEXITY_DESKTOP_PACKAGE, PERPLEXITY_DESKTOP_PRODUCT_ID, COMET_MCP_VERSION, COMET_SIGNER, PERPLEXITY_COMPUTER_MCP_URL, PERPLEXITY_MCP_VERSION, } from './catalogue-agents-web.js';
 export { ADDON_MCP_PREFIX, addonGuideLine, addonMcpServer, type AddonPlace, claudeManagedSettings, codexWithAddonMcpServers, type CodexMcpServer, HEADROOM_ENV, HEADROOM_PORT, HEADROOM_UPSTREAM, headroomArgs, headroomEnv, headroomGuideLine, headroomUrl, type ManagedSettings, type McpServerConfig, rtkHookCommand, RTK_GUIDE_LINE, withAddonMcpServers, } from './agent-addons.js';
+export { isStorePackageFile, STORE_PACKAGE_MANIFEST, StorePackageFileSchema, StorePackageManifestSchema, storePackageRole, type StorePackageFile, type StorePackageManifest, } from './store-package.js';

package/dist/shared/apps/index.js

@@ -1,7 +1,8 @@
 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 { exeMatcher, appsToInstall, appsNeedMesa, appsNeedUv, storeApps } 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';
+export { AGENTS_WEB_APPS, BROWSER_USE_VERSION, CHROME_DEVTOOLS_MCP_VERSION, COMET_DOWNLOAD_URL, PERPLEXITY_DESKTOP_FAMILY, PERPLEXITY_DESKTOP_PACKAGE, PERPLEXITY_DESKTOP_PRODUCT_ID, COMET_MCP_VERSION, COMET_SIGNER, PERPLEXITY_COMPUTER_MCP_URL, PERPLEXITY_MCP_VERSION, } from './catalogue-agents-web.js';
 export { ADDON_MCP_PREFIX, addonGuideLine, addonMcpServer, claudeManagedSettings, codexWithAddonMcpServers, HEADROOM_ENV, HEADROOM_PORT, HEADROOM_UPSTREAM, headroomArgs, headroomEnv, headroomGuideLine, headroomUrl, rtkHookCommand, RTK_GUIDE_LINE, withAddonMcpServers, } from './agent-addons.js';
+export { isStorePackageFile, STORE_PACKAGE_MANIFEST, StorePackageFileSchema, StorePackageManifestSchema, storePackageRole, } from './store-package.js';

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

@@ -11,3 +11,9 @@ export declare function appsToInstall(apps: Config['apps'], gitAccess: GitAccess
 export declare function appsNeedUv(apps: Config['apps'] | undefined): boolean;
 /** Does any chosen app draw with OpenGL (so the Mesa step must run first)? */
 export declare function appsNeedMesa(apps: Config['apps'] | undefined): boolean;
+/** The chosen apps that come from the Microsoft Store: what this PC has to fetch for them. */
+export declare function storeApps(install: readonly string[]): {
+    id: string;
+    productId: string;
+    packageName: string;
+}[];

package/dist/shared/apps/selection.js

@@ -47,3 +47,12 @@ export function appsNeedUv(apps) {
 export function appsNeedMesa(apps) {
     return Boolean(apps?.install.some((id) => appById(id)?.needs?.includes('mesa')));
 }
+/** The chosen apps that come from the Microsoft Store: what this PC has to fetch for them. */
+export function storeApps(install) {
+    return install.flatMap((id) => {
+        const source = appById(id)?.source;
+        return source !== undefined && 'store' in source
+            ? [{ id, productId: source.store.productId, packageName: source.store.packageName }]
+            : [];
+    });
+}

package/dist/shared/apps/store-package.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+export declare const StorePackageFileSchema: z.ZodObject<{
+    name: z.ZodString;
+    role: z.ZodEnum<{
+        main: "main";
+        dependency: "dependency";
+    }>;
+    sha256: z.ZodString;
+    bytes: z.ZodNumber;
+}, z.core.$strict>;
+export type StorePackageFile = z.output<typeof StorePackageFileSchema>;
+/** store-package.json: next to the package files, on this PC's cache and in the sandbox's data folder. */
+export declare const StorePackageManifestSchema: z.ZodObject<{
+    productId: z.ZodString;
+    fetchedAt: z.ZodString;
+    files: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        role: z.ZodEnum<{
+            main: "main";
+            dependency: "dependency";
+        }>;
+        sha256: z.ZodString;
+        bytes: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type StorePackageManifest = z.output<typeof StorePackageManifestSchema>;
+export declare const STORE_PACKAGE_MANIFEST = "store-package.json";
+/** Whether a file name is a package file this feature handles. */
+export declare function isStorePackageFile(name: string): boolean;
+/** The app itself (named <package name>_<version>_...), as opposed to a framework it depends on (VCLibs ...). */
+export declare function storePackageRole(fileName: string, packageName: string): 'main' | 'dependency';

package/dist/shared/apps/store-package.js

@@ -0,0 +1,34 @@
+// A Microsoft Store app handed to the sandbox as package files (.msix and its dependencies). The PC fetches them with
+// its own Store tooling (host/apps/store-package.ts) and the sandbox installs them with Add-AppxPackage.
+// Pure, web-safe: the shape of the manifest that travels with the files, and which file is the app itself.
+import { z } from 'zod';
+const GB = 1024 * 1024 * 1024;
+const FILE_NAME = /^[A-Za-z0-9._~+-]{1,200}\.(msix|appx|msixbundle|appxbundle)$/i;
+export const StorePackageFileSchema = z.strictObject({
+    name: z.string().regex(FILE_NAME),
+    role: z.enum(['main', 'dependency']),
+    sha256: z.string().regex(/^[0-9a-f]{64}$/),
+    bytes: z
+        .number()
+        .int()
+        .positive()
+        .max(2 * GB),
+});
+/** store-package.json: next to the package files, on this PC's cache and in the sandbox's data folder. */
+export const StorePackageManifestSchema = z
+    .strictObject({
+    productId: z.string().regex(/^[A-Z0-9]{12}$/),
+    fetchedAt: z.string().max(40),
+    files: z.array(StorePackageFileSchema).min(1).max(24),
+})
+    .refine((m) => m.files.filter((f) => f.role === 'main').length === 1, 'exactly one file must be the app itself')
+    .refine((m) => new Set(m.files.map((f) => f.name.toLowerCase())).size === m.files.length, 'file names repeat');
+export const STORE_PACKAGE_MANIFEST = 'store-package.json';
+/** Whether a file name is a package file this feature handles. */
+export function isStorePackageFile(name) {
+    return FILE_NAME.test(name);
+}
+/** The app itself (named <package name>_<version>_...), as opposed to a framework it depends on (VCLibs ...). */
+export function storePackageRole(fileName, packageName) {
+    return fileName.toLowerCase().startsWith(packageName.toLowerCase() + '_') ? 'main' : 'dependency';
+}

package/dist/shared/channel/schema.d.ts

@@ -126,6 +126,14 @@ export declare const ProjectSpecSchema: z.ZodObject<{
             modules: z.ZodArray<z.ZodString>;
             hub: z.ZodBoolean;
             keepVersions: z.ZodNumber;
+            mcp: z.ZodBoolean;
+            agentSkills: z.ZodBoolean;
+            cliVersion: z.ZodString;
+            assetCache: z.ZodEnum<{
+                pc: "pc";
+                persisted: "persisted";
+                local: "local";
+            }>;
         }, z.core.$strict>;
         godot: z.ZodObject<{
             enabled: z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>;
@@ -362,6 +370,14 @@ export declare const GuestRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 modules: z.ZodArray<z.ZodString>;
                 hub: z.ZodBoolean;
                 keepVersions: z.ZodNumber;
+                mcp: z.ZodBoolean;
+                agentSkills: z.ZodBoolean;
+                cliVersion: z.ZodString;
+                assetCache: z.ZodEnum<{
+                    pc: "pc";
+                    persisted: "persisted";
+                    local: "local";
+                }>;
             }, z.core.$strict>;
             godot: z.ZodObject<{
                 enabled: z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>;
@@ -618,6 +634,14 @@ export declare const GuestRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 modules: z.ZodArray<z.ZodString>;
                 hub: z.ZodBoolean;
                 keepVersions: z.ZodNumber;
+                mcp: z.ZodBoolean;
+                agentSkills: z.ZodBoolean;
+                cliVersion: z.ZodString;
+                assetCache: z.ZodEnum<{
+                    pc: "pc";
+                    persisted: "persisted";
+                    local: "local";
+                }>;
             }, z.core.$strict>;
             godot: z.ZodObject<{
                 enabled: z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>;

package/dist/shared/channel/secrets.d.ts

@@ -25,6 +25,7 @@ export declare const SecretsFileSchema: z.ZodObject<{
         }, z.core.$strict>>;
         unity: z.ZodOptional<z.ZodObject<{
             ulf: z.ZodOptional<z.ZodString>;
+            entitlement: z.ZodOptional<z.ZodString>;
             email: z.ZodOptional<z.ZodString>;
             password: z.ZodOptional<z.ZodString>;
             serial: z.ZodOptional<z.ZodString>;
@@ -70,6 +71,22 @@ export declare const SecretsFileSchema: z.ZodObject<{
                 }>>;
             }, z.core.$strict>>;
         }, z.core.$strict>>;
+        perplexityapp: z.ZodOptional<z.ZodObject<{
+            cookies: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                value: z.ZodString;
+                domain: z.ZodString;
+                path: z.ZodString;
+                expires: z.ZodOptional<z.ZodNumber>;
+                secure: z.ZodBoolean;
+                httpOnly: z.ZodBoolean;
+                sameSite: z.ZodOptional<z.ZodEnum<{
+                    Strict: "Strict";
+                    Lax: "Lax";
+                    None: "None";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
     }, z.core.$strict>>;
     liveFoldersKey: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;

package/dist/shared/paths/pc-installs.d.ts

@@ -1,6 +1,6 @@
 /** Where this PC's installs appear in the sandbox (reserved: RESERVED_GUEST). */
 export declare const PC_INSTALLS_GUEST = "C:\\PcInstalls";
-export type PcInstallKind = 'steam-game' | 'steam-library' | 'epic-game' | 'unreal' | 'unreal-vault' | 'unity';
+export type PcInstallKind = 'steam-game' | 'steam-library' | 'epic-game' | 'unreal' | 'unreal-vault' | 'unity' | 'unity-assets';
 export interface PcInstall {
     readonly kind: PcInstallKind;
     /** The Steam app ID or library (library1), the Epic app name, the engine (UE_5.4) or editor version. */

package/dist/shared/paths/pc-installs.js

@@ -11,6 +11,7 @@ const AREA = {
     unreal: 'unreal',
     'unreal-vault': 'unreal',
     unity: 'unity',
+    'unity-assets': 'unity',
 };
 /** The guest folder of one install: C:\PcInstalls\steam\<appid>, \epic\<AppName>, \unreal\UE_5.4, \unity\<ver>. */
 export function pcInstallGuest(kind, id) {

package/dist/shared/readiness.d.ts

@@ -1,8 +1,8 @@
 export declare const NOT_READY: {
     /** Toolchains whose step is a stub: their settings rows are hidden and "auto" never turns them on. */
-    readonly toolchains: readonly ["unity", "godot", "android", "flutter", "dart", "reactNative"];
+    readonly toolchains: readonly ["godot", "android", "flutter", "dart", "reactNative"];
     /** Service sign-ins whose host or guest side is a stub: the menu and the web do not list them. */
-    readonly kinds: readonly ["unity", "keystore", "play", "expo", "appstore"];
+    readonly kinds: readonly ["keystore", "play", "expo", "appstore"];
 };
 export declare const isToolchainReady: (name: string) => boolean;
 export declare const isKindReady: (kind: string) => boolean;

package/dist/shared/readiness.js

@@ -2,9 +2,9 @@
 // entries here (the end of round 2 leaves it empty). Pure.
 export const NOT_READY = {
     /** Toolchains whose step is a stub: their settings rows are hidden and "auto" never turns them on. */
-    toolchains: ['unity', 'godot', 'android', 'flutter', 'dart', 'reactNative'],
+    toolchains: ['godot', 'android', 'flutter', 'dart', 'reactNative'],
     /** Service sign-ins whose host or guest side is a stub: the menu and the web do not list them. */
-    kinds: ['unity', 'keystore', 'play', 'expo', 'appstore'],
+    kinds: ['keystore', 'play', 'expo', 'appstore'],
 };
 export const isToolchainReady = (name) => !NOT_READY.toolchains.includes(name);
 export const isKindReady = (kind) => !NOT_READY.kinds.includes(kind);

package/dist/shared/unity/asset-cache.d.ts

@@ -0,0 +1,20 @@
+export declare function assetStoreDir(root: string): string;
+/** The cache roots of this PC that hold an Asset Store-5.x folder: the environment's first, then %APPDATA%\Unity. */
+export declare function pcAssetCacheDirs(pc: {
+    readonly appData: string;
+    readonly envValue?: string | undefined;
+}, isDir: (dir: string) => boolean): string[];
+export interface AssetFs {
+    list(dir: string): string[];
+    isDir(dir: string): boolean;
+    /** A file's size, or null when it is a folder or missing. */
+    size(file: string): number | null;
+}
+export interface AssetPackage {
+    readonly publisher: string;
+    readonly category: string;
+    readonly name: string;
+    readonly sizeBytes: number;
+}
+/** The .unitypackage files in an Asset Store-5.x folder (three levels deep), sorted, at most 2000. */
+export declare function assetPackages(dir: string, fs: AssetFs): AssetPackage[];

package/dist/shared/unity/asset-cache.js

@@ -0,0 +1,44 @@
+// The Unity Asset Store's download cache: <root>\Asset Store-5.x\<publisher>\<category>\<name>.unitypackage. The root
+// is ASSETSTORE_CACHE_PATH, else %APPDATA%\Unity. Pure apart from the reads it is given; every walk is bounded.
+import path from 'node:path';
+const win = path.win32;
+const MAX_PACKAGES = 2000;
+const MAX_ROOTS = 2;
+export function assetStoreDir(root) {
+    return root + '\\Asset Store-5.x';
+}
+/** The cache roots of this PC that hold an Asset Store-5.x folder: the environment's first, then %APPDATA%\Unity. */
+export function pcAssetCacheDirs(pc, isDir) {
+    const all = [pc.envValue?.trim() ?? '', pc.appData ? win.join(pc.appData, 'Unity') : ''].filter(Boolean);
+    return all
+        .map((d) => win.normalize(d).replace(/\\+$/, ''))
+        .filter((d, i, a) => a.findIndex((o) => o.toLowerCase() === d.toLowerCase()) === i)
+        .filter((d) => isDir(assetStoreDir(d)))
+        .slice(0, MAX_ROOTS);
+}
+/** The .unitypackage files in an Asset Store-5.x folder (three levels deep), sorted, at most 2000. */
+export function assetPackages(dir, fs) {
+    const found = [];
+    const sorted = (d) => fs.list(d).sort((a, b) => a.localeCompare(b));
+    for (const publisher of sorted(dir)) {
+        const pdir = win.join(dir, publisher);
+        if (!fs.isDir(pdir))
+            continue;
+        for (const category of sorted(pdir)) {
+            const cdir = win.join(pdir, category);
+            if (!fs.isDir(cdir))
+                continue;
+            for (const file of sorted(cdir)) {
+                if (!/\.unitypackage$/i.test(file))
+                    continue;
+                const size = fs.size(win.join(cdir, file));
+                if (size === null)
+                    continue;
+                found.push({ publisher, category, name: file.replace(/\.unitypackage$/i, ''), sizeBytes: size });
+                if (found.length >= MAX_PACKAGES)
+                    return found;
+            }
+        }
+    }
+    return found;
+}

package/dist/shared/unity/cli.d.ts

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+export declare const UNITY_CLI_CDN = "https://public-cdn.cloud.unity3d.com/hub/prod/cli";
+export declare const DEFAULT_UNITY_CLI = "1.0.0-beta.16";
+/** The manifest of a CLI version: "latest" is the newest beta, else that version's own latest.json. */
+export declare function cliManifestUrl(version: string): string;
+export declare const CliManifestSchema: z.ZodObject<{
+    version: z.ZodString;
+    binaries: z.ZodRecord<z.ZodString, z.ZodObject<{
+        filename: z.ZodString;
+        sha256: z.ZodString;
+        size: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CliManifest = z.infer<typeof CliManifestSchema>;
+export interface CliBinary {
+    readonly version: string;
+    readonly url: string;
+    readonly sha256: string;
+    readonly size: number;
+}
+/** The Windows build for this CPU, or null when the manifest has none or its file name or hash is unexpected. */
+export declare function pickCliBinary(m: CliManifest, arch: 'x64' | 'arm64'): CliBinary | null;
+/** No telemetry, hints, pager, elevation prompt or first-run set-up (the skills are synced by us when asked). */
+export declare const UNITY_CLI_ENV: {
+    readonly UNITY_NO_CLI_INVOKED_TELEMETRY: "1";
+    readonly UNITY_NO_AGENT_HINTS: "1";
+    readonly UNITY_CLI_SKIP_SETUP: "1";
+    readonly UNITY_NO_PAGER: "1";
+    readonly UNITY_NO_ELEVATE: "1";
+};
+/** `unity install <version> -c <changeset> -m <ids> --cm`. --download-directory is not in the docs: from the plan. */
+export declare function installArgs(version: string, changeset: string | null, modules: readonly string[], dir: string): string[];
+/** `unity install-modules -e <version> -m <ids> --cm`. --download-directory is not in the docs: from the plan. */
+export declare function installModulesArgs(version: string, modules: readonly string[], dir: string): string[];
+/** Where the CLI installs editors. `--set` is not in the docs (they say "run install-path --help"): from the plan. */
+export declare function installPathArgs(dir: string): string[];
+/** `unity editors add <path...>` registers editors installed outside the Hub (the docs pass their folders). */
+export declare function editorsAddArgs(exes: readonly string[]): string[];
+/** `unity license status` is not in the docs; --format json is the global output option. */
+export declare function licenceStatusArgs(): string[];

package/dist/shared/unity/cli.js

@@ -0,0 +1,77 @@
+// The Unity CLI (`unity`): where its pinned build is published, how a download is checked, the environment it runs in
+// and the argument lists we pass it. The flags below are checked against the docs
+// (docs.unity.com/en-us/unity-cli/reference), not a live run; the ones the docs do not settle are marked.
+import { z } from 'zod';
+export const UNITY_CLI_CDN = 'https://public-cdn.cloud.unity3d.com/hub/prod/cli';
+export const DEFAULT_UNITY_CLI = '1.0.0-beta.16';
+const CLI_VERSION = /^\d+\.\d+\.\d+(-[A-Za-z0-9.]+)?$/;
+const CLI_FILE = /^unity-windows-(x64|arm64)\.exe$/;
+const SHA256 = /^[0-9a-f]{64}$/i;
+/** The manifest of a CLI version: "latest" is the newest beta, else that version's own latest.json. */
+export function cliManifestUrl(version) {
+    if (version === 'latest')
+        return UNITY_CLI_CDN + '/latest-beta.json';
+    if (!CLI_VERSION.test(version))
+        throw new Error('not a Unity CLI version: ' + version);
+    return UNITY_CLI_CDN + '/' + version + '/latest.json';
+}
+export const CliManifestSchema = z.object({
+    version: z.string().regex(CLI_VERSION),
+    binaries: z
+        .record(z.string().max(40), z.object({
+        filename: z.string().max(80),
+        sha256: z.string().max(80),
+        size: z.number().int().min(0).optional(),
+    }))
+        .refine((r) => Object.keys(r).length <= 20),
+});
+/** The Windows build for this CPU, or null when the manifest has none or its file name or hash is unexpected. */
+export function pickCliBinary(m, arch) {
+    const b = m.binaries['win32-' + arch];
+    if (!b)
+        return null;
+    const file = CLI_FILE.exec(b.filename);
+    if (!file || file[1] !== arch || !SHA256.test(b.sha256))
+        return null;
+    return {
+        version: m.version,
+        url: UNITY_CLI_CDN + '/' + m.version + '/' + b.filename,
+        sha256: b.sha256.toLowerCase(),
+        size: b.size ?? 0,
+    };
+}
+/** No telemetry, hints, pager, elevation prompt or first-run set-up (the skills are synced by us when asked). */
+export const UNITY_CLI_ENV = {
+    UNITY_NO_CLI_INVOKED_TELEMETRY: '1',
+    UNITY_NO_AGENT_HINTS: '1',
+    UNITY_CLI_SKIP_SETUP: '1',
+    UNITY_NO_PAGER: '1',
+    UNITY_NO_ELEVATE: '1',
+};
+/** `unity install <version> -c <changeset> -m <ids> --cm`. --download-directory is not in the docs: from the plan. */
+export function installArgs(version, changeset, modules, dir) {
+    return [
+        'install',
+        version,
+        ...(changeset ? ['-c', changeset] : []),
+        ...(modules.length ? ['-m', ...modules, '--cm'] : []),
+        '--download-directory',
+        dir,
+    ];
+}
+/** `unity install-modules -e <version> -m <ids> --cm`. --download-directory is not in the docs: from the plan. */
+export function installModulesArgs(version, modules, dir) {
+    return ['install-modules', '-e', version, '-m', ...modules, '--cm', '--download-directory', dir];
+}
+/** Where the CLI installs editors. `--set` is not in the docs (they say "run install-path --help"): from the plan. */
+export function installPathArgs(dir) {
+    return ['install-path', '--set', dir];
+}
+/** `unity editors add <path...>` registers editors installed outside the Hub (the docs pass their folders). */
+export function editorsAddArgs(exes) {
+    return ['editors', 'add', ...exes];
+}
+/** `unity license status` is not in the docs; --format json is the global output option. */
+export function licenceStatusArgs() {
+    return ['license', 'status', '--format', 'json'];
+}

package/dist/shared/unity/editors.d.ts

@@ -0,0 +1,46 @@
+export interface UnityFs {
+    exists(file: string): boolean;
+    list(dir: string): string[];
+}
+export interface UnityEditor {
+    readonly version: string;
+    /** The folder that holds Editor\Unity.exe. */
+    readonly root: string;
+    readonly exe: string;
+    readonly origin: 'pc' | 'data';
+    readonly writable: boolean;
+    /** Module ids found installed (android, webgl, ios, windows-il2cpp). */
+    readonly modules: readonly string[];
+}
+export declare const ORIGIN_LABELS: {
+    readonly pc: "this PC, read-only";
+    readonly data: "the data disk, kept between sandboxes";
+};
+/** The modules installed in an editor folder. */
+export declare function editorModules(root: string, fs: UnityFs): string[];
+export interface EditorSearch {
+    /** This PC's editors as mapped read-only (id = the version). */
+    readonly mapped: readonly {
+        readonly guest: string;
+        readonly id: string;
+    }[];
+    /** tools\unity\editors on the data disk. */
+    readonly dataRoot: string;
+}
+export declare function findEditors(search: EditorSearch, fs: UnityFs): UnityEditor[];
+export interface WantedEditor {
+    readonly version: string;
+    readonly changeset: string | null;
+}
+export interface EditorChoice {
+    readonly editor: UnityEditor | null;
+    /** What to install on the data disk, when nothing usable is there. */
+    readonly install: WantedEditor | null;
+    readonly reason: string;
+}
+/**
+ * The editor for a project: exactly the version it asks for. This PC's (read-only) when it has every module, then the
+ * data disk's, else install it when the licence is accepted. A PC editor that lacks modules is still used when nothing
+ * can be installed.
+ */
+export declare function chooseEditor(editors: readonly UnityEditor[], wanted: WantedEditor | null, modules: readonly string[], canInstall: boolean): EditorChoice;