windows-development-sandbox 1.25.1 → 1.27.0

package/dist/host/pc-installs/unity.js

@@ -1,7 +1,140 @@
+// Unity editors of this PC (pcInstalls.unityEditors): Unity Hub's default folder (<Program Files>\Unity\Hub\Editor),
+// the folder named by %APPDATA%\UnityHub\secondaryInstallPath.json and the editors in editors-v2.json. An editor counts
+// only with Editor\Unity.exe; its folder is mapped read-only at C:\PcInstalls\unity\<version>. Every file is read
+// bounded and every name is checked: what Hub wrote is data, never trusted.
+import fs from 'node:fs';
+import path from 'node:path';
+import { z } from 'zod';
+import { readBoundedFile } from '../../shared/io/index.js';
+import { assetStoreDir, pcAssetCacheDirs, UNITY_VERSION } from '../../shared/unity/index.js';
+const win = path.win32;
+/** At most this many editors of this PC are mapped. */
+export const MAX_PC_EDITORS = 12;
+const MAX_SECONDARY_BYTES = 4 * 1024;
+const MAX_EDITORS_FILE_BYTES = 1024 * 1024;
+const MAX_EDITOR_ENTRIES = 200;
+const MAX_LISTED = 500;
+const EditorsFileSchema = z.union([
+    z.array(z.unknown()).max(MAX_EDITOR_ENTRIES),
+    z.object({ data: z.array(z.unknown()).max(MAX_EDITOR_ENTRIES) }).passthrough(),
+]);
+const EditorEntrySchema = z
+    .object({
+    version: z.string().max(40),
+    location: z.union([z.string().max(1000), z.array(z.string().max(1000)).max(8)]),
+})
+    .passthrough();
+function jsonOf(files, file, max) {
+    const bytes = files.read(file, max);
+    if (!bytes)
+        return null;
+    try {
+        return JSON.parse(bytes.toString('utf8').replace(/^\uFEFF/, ''));
+    }
+    catch {
+        return null; // Not JSON: Hub's file is ignored.
+    }
+}
+/** The folder in secondaryInstallPath.json (a JSON string, absolute only), or null. */
+function secondaryRoot(files) {
+    const json = jsonOf(files, win.join(files.appData, 'UnityHub', 'secondaryInstallPath.json'), MAX_SECONDARY_BYTES);
+    return typeof json === 'string' && json.length < 1000 && win.isAbsolute(json) ? win.normalize(json) : null;
+}
+const hasEditorExe = (root, files) => files.list(win.join(root, 'Editor')).some((n) => n.toLowerCase() === 'unity.exe');
+/** The editors editors-v2.json lists: only `...\Editor\Unity.exe`, the root two levels up. */
+function listedEditors(files) {
+    const parsed = EditorsFileSchema.safeParse(jsonOf(files, win.join(files.appData, 'UnityHub', 'editors-v2.json'), MAX_EDITORS_FILE_BYTES));
+    if (!parsed.success)
+        return [];
+    const entries = Array.isArray(parsed.data) ? parsed.data : parsed.data.data;
+    const out = [];
+    for (const raw of entries) {
+        const e = EditorEntrySchema.safeParse(raw);
+        if (!e.success)
+            continue;
+        for (const location of [e.data.location].flat()) {
+            const exe = win.normalize(location);
+            if (!win.isAbsolute(exe) || win.basename(exe).toLowerCase() !== 'unity.exe')
+                continue;
+            const editorDir = win.dirname(exe);
+            if (win.basename(editorDir).toLowerCase() !== 'editor')
+                continue;
+            out.push({ version: e.data.version, root: win.dirname(editorDir) });
+        }
+    }
+    return out;
+}
+/** The editors of this PC: all of them (true) or the listed versions. Each version once, each folder once. */
+export function findUnityEditorsOnPc(files, wanted) {
+    const candidates = [];
+    const hubFolders = [win.join(files.programFiles, 'Unity', 'Hub', 'Editor'), secondaryRoot(files)].filter((d) => d !== null);
+    for (const folder of hubFolders)
+        for (const name of files.list(folder).slice(0, MAX_LISTED).sort())
+            if (UNITY_VERSION.test(name))
+                candidates.push({ version: name, root: win.join(folder, name) });
+    candidates.push(...listedEditors(files));
+    const found = [];
+    for (const c of candidates) {
+        if (found.length >= MAX_PC_EDITORS)
+            break;
+        if (!UNITY_VERSION.test(c.version))
+            continue;
+        if (wanted !== true && !wanted.includes(c.version))
+            continue;
+        const key = c.root.toLowerCase();
+        if (found.some((f) => f.id === c.version || f.host.toLowerCase() === key))
+            continue;
+        if (!files.isDir(c.root) || !hasEditorExe(c.root, files))
+            continue;
+        found.push({
+            kind: 'unity',
+            id: c.version,
+            name: 'Unity ' + c.version,
+            version: c.version,
+            host: c.root,
+            guest: '',
+        });
+    }
+    return found;
+}
+/** The Asset Store-5.x folders of this PC (the environment's cache root first, then %APPDATA%\Unity), to map. */
+export function unityAssetCacheDirs(files, envValue) {
+    return pcAssetCacheDirs({ appData: files.appData, envValue }, files.isDir).map(assetStoreDir);
+}
+function listDir(dir) {
+    try {
+        return fs.readdirSync(dir).slice(0, MAX_LISTED);
+    }
+    catch {
+        return []; // Not a folder: nothing in it.
+    }
+}
+function isDir(dir) {
+    try {
+        return fs.statSync(dir).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/** This PC's disk for the search. */
+export function unityPcFiles(pc) {
+    return {
+        read: readBoundedFile,
+        isDir,
+        list: listDir,
+        appData: pc.appData,
+        programFiles: pc.programFiles ?? 'C:\\Program Files',
+    };
+}
+/** The cache root the environment names: this terminal's variable, else the saved user one. */
+export function assetCacheEnv(pc) {
+    return pc.env?.ASSETSTORE_CACHE_PATH ?? pc.userVariable?.('ASSETSTORE_CACHE_PATH') ?? undefined;
+}
 export const unityInstalls = {
     kind: 'unity',
     setting: 'unityEditors',
-    find(_wanted, _pc) {
-        return [];
+    find(wanted, pc) {
+        return findUnityEditorsOnPc(unityPcFiles(pc), wanted === true ? true : wanted.map(String));
     },
 };

package/dist/runtime/agent.js

@@ -25690,21 +25690,35 @@ var ToolchainsSchema = external_exports.strictObject({
   }),
   unity: external_exports.strictObject({
     enabled: enabled(
-      "Unity: the editor version a project asks for, from Unity's release API (checked against its published hash), installed into tools\\unity\\<version> (6-7 GB each), with the modules you list.",
+      "Unity: the editor version a project asks for, from Unity's release API (checked against its published hash), installed on the data disk (tools\\unity\\editors\\<version>, 8-13 GB each, kept between sandboxes), with the modules you list. This PC's editors (pcInstalls.unityEditors) are used first.",
       "ProjectSettings/ProjectVersion.txt"
     ),
     acceptLicense: external_exports.boolean().describe(
       "Required to install: you accept the Unity terms of service (https://unity.com/legal/terms-of-service), and the editor needs a Unity licence (Personal is free). A project file cannot accept it for you."
     ),
     version: external_exports.string().min(1).describe(
-      '"project" = the version in ProjectSettings/ProjectVersion.txt, or an editor version such as "6000.0.32f1".'
+      `"project" = the version in ProjectSettings/ProjectVersion.txt, or an editor version such as "6000.0.32f1" for folders without one (a project's own version always wins).`
     ),
     modules: external_exports.array(external_exports.string().regex(/^[a-z0-9-]+$/)).describe(
       `Editor modules to add: "android" (4-5 GB, also the Android SDK), "webgl" (1.5 GB), "windows-il2cpp" (adds Visual Studio's C++ parts), "ios" (Xcode project export only: iOS builds need a Mac).`
     ),
-    hub: external_exports.boolean().describe("Also Unity Hub, with the installed editors listed in it."),
+    hub: external_exports.boolean().describe(
+      "Also Unity Hub (kept on the data disk), for signing in to Unity Personal and installing editors by hand."
+    ),
     keepVersions: external_exports.number().int().min(1).max(20).describe(
       "How many editor versions to keep in tools\\unity; older ones are removed (the least recently used first)."
+    ),
+    mcp: external_exports.boolean().describe(
+      "The Unity CLI's MCP server (unity mcp) in Claude Code and Codex as sbx-unity: Unity's read-only tools always, the open editor's tools when the project has the Unity Pipeline package (Unity 6 and later). Nothing in your project changes."
+    ),
+    agentSkills: external_exports.boolean().describe(
+      "Unity's skills for Claude Code and Codex, from Unity-Technologies/skills at the commit the Unity CLI pins."
+    ),
+    cliVersion: external_exports.string().regex(/^(latest|\d+\.\d+\.\d+(-[A-Za-z0-9.]+)?)$/).describe(
+      'The Unity CLI version, checked against the SHA-256 Unity publishes: a version such as "1.0.0-beta.16", or "latest". It never updates itself.'
+    ),
+    assetCache: external_exports.enum(["persisted", "pc", "local"]).describe(
+      `"persisted": Asset Store downloads made in the sandbox go to tools\\unity\\asset-store (kept). "pc": the sandbox uses this PC's Asset Store downloads (read-only; download new ones on your PC). "local": Unity's own place on the sandbox disk (lost when it closes).`
     )
   }),
   godot: external_exports.strictObject({
@@ -25856,7 +25870,7 @@ var ToolchainsSchema = external_exports.strictObject({
   }),
   cli: external_exports.strictObject({
     gh: EnabledSchema.describe(
-      'GitHub CLI (gh). Only with provisioning.git.access "full": gh can push and merge through the GitHub API, past a read-only git. Your PC\'s gh login is never copied; `gh auth login` inside persists (GH_CONFIG_DIR), unless a token you saved for sandboxes is handed over (github.shareToken). "auto" = when the project has a .github folder.'
+      'GitHub CLI (gh). Only with provisioning.git.access "full": gh can push and merge through the GitHub API, past a read-only git. Your PC\'s gh login is copied only with github.usePcLogin (or a token you saved for sandboxes with github.shareToken); otherwise `gh auth login` inside persists (GH_CONFIG_DIR). "auto" = when the project has a .github folder.'
     ),
     zstd: EnabledSchema.describe('Zstandard (zstd). "auto" = off; set true to get it.'),
     openssl: EnabledSchema.describe(
@@ -25911,6 +25925,9 @@ var COMET_SIGNER = {
   subject: ['(^|, )CN="?PERPLEXITY AI, INC\\.?"?(,|$)', '(^|, )O="?PERPLEXITY AI, INC\\.?"?(,|$)'],
   issuer: ["^CN=GlobalSign GCC R45 EV CodeSigning CA 2020(,|$)"]
 };
+var PERPLEXITY_DESKTOP_PRODUCT_ID = "9P9XG917PWCJ";
+var PERPLEXITY_DESKTOP_PACKAGE = "PerplexityAI.PerplexityApp";
+var PERPLEXITY_DESKTOP_FAMILY = "PerplexityAI.PerplexityApp_3jh4kjrg4dzr2";
 var EDGE_EXE = "C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe";
 var AGENTS_WEB_APPS = [
   {
@@ -25957,6 +25974,22 @@ var 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",
@@ -26010,6 +26043,8 @@ var AGENTS_WEB_APPS = [
 ];
 
 // src/shared/apps/catalogue-gamedev.ts
+var UNITY_MCP_VERSION = "10.3.0";
+var OPENUPM_CLI_VERSION = "4.5.3";
 var GAMEDEV_APPS = [
   {
     id: "krita",
@@ -26079,6 +26114,34 @@ var GAMEDEV_APPS = [
     size: "60 MB",
     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"
   }
 ];
 
@@ -26953,6 +27016,21 @@ var CORE_APPS = [
 ];
 var APPS = [...CORE_APPS, ...GAMEDEV_APPS, ...MODDING_APPS, ...MOBILE_APPS, ...AGENTS_WEB_APPS];
 
+// src/shared/apps/store-package.ts
+var GB = 1024 * 1024 * 1024;
+var FILE_NAME = /^[A-Za-z0-9._~+-]{1,200}\.(msix|appx|msixbundle|appxbundle)$/i;
+var StorePackageFileSchema = external_exports.strictObject({
+  name: external_exports.string().regex(FILE_NAME),
+  role: external_exports.enum(["main", "dependency"]),
+  sha256: external_exports.string().regex(/^[0-9a-f]{64}$/),
+  bytes: external_exports.number().int().positive().max(2 * GB)
+});
+var StorePackageManifestSchema = external_exports.strictObject({
+  productId: external_exports.string().regex(/^[A-Z0-9]{12}$/),
+  fetchedAt: external_exports.string().max(40),
+  files: external_exports.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");
+
 // src/core/schema/apps.ts
 var CATALOGUE_IDS = APPS.filter((a) => !a.setting).map((a) => a.id);
 var AppIdSchema = external_exports.enum(CATALOGUE_IDS);
@@ -27087,6 +27165,9 @@ var VpnSchema = external_exports.strictObject({
 var GithubSchema = external_exports.strictObject({
   shareToken: external_exports.boolean().describe(
     'Give each sandbox the GitHub token you saved in Accounts (best a fine-grained token limited to some repositories and permissions), so gh and https git work there without logging in. Only with provisioning.git.access "full". The agent in the sandbox can read the token and use it for whatever it allows. A project file (.sandbox-config.json) cannot turn this on.'
+  ),
+  usePcLogin: external_exports.boolean().describe(
+    'Give each sandbox the GitHub CLI (gh) login from this PC, when there is one, so gh and https git work there without logging in. Used when no token saved for sandboxes is handed over. Only with provisioning.git.access "full". Without a gh login on the PC nothing happens. The login reaches everything your account can, and the agent in the sandbox can read it. A project file (.sandbox-config.json) cannot turn this on.'
   )
 });
 
@@ -27135,7 +27216,9 @@ var SERVICE_SPECS = {
     warnings: [
       AGENT_CAN_USE,
       ONE_PLACE,
-      "A Pro seat is handed back when the sandbox stops cleanly; a sandbox closed abruptly may keep it until you return it."
+      "Unity Personal is activated by signing in: sign in to Unity once in a sandbox and the licence it makes is kept for the next ones (if Unity refuses it there, sign in again).",
+      "A Plus or Pro serial is activated in each sandbox and handed back when the sandbox stops cleanly; a sandbox closed abruptly may keep the seat until you remove it at id.unity.com (My Seats).",
+      "A licence file taken from this PC may not work in a sandbox: Unity ties it to the computer."
     ],
     fields: [
       { name: "email", label: "Unity ID email", secret: false, optional: true },
@@ -27262,11 +27345,28 @@ var SERVICE_SPECS = {
       "Several sandboxes can use it at once: the sign-in the last one hands back is kept."
     ],
     fields: []
+  },
+  perplexityapp: {
+    kind: "perplexityapp",
+    label: "Perplexity desktop app",
+    usedBy: ["perplexityapp"],
+    sources: ["sandbox"],
+    singleHolder: false,
+    returns: true,
+    maxBytes: 256 * 1024,
+    warnings: [
+      AGENT_CAN_USE + " It can act as you in the Perplexity app and spend your Perplexity Computer credits; the app acts on the pages it reads, which can try to steer it.",
+      "Your sign-in in the Perplexity app can't be copied from this PC: Windows locks it to your PC account. Sign in once inside a sandbox and it is kept for the next ones.",
+      "Only the perplexity.ai sign-in cookies are kept: never saved passwords, other sites, localStorage or history.",
+      "Several sandboxes can use it at once: the sign-in the last one hands back is kept."
+    ],
+    fields: []
   }
 };
 var APP_USER_TEXT = {
   perplexity: "the Perplexity MCP app",
-  comet: "the Comet app"
+  comet: "the Comet app",
+  perplexityapp: "the Perplexity desktop app"
 };
 function usedByText(usedBy) {
   return usedBy.map((u) => u in APP_USER_TEXT ? APP_USER_TEXT[u] : u).join(" or ");
@@ -27291,7 +27391,11 @@ var AccountsSchema = external_exports.strictObject({
   expo: share("expo", "type the token in Accounts"),
   appstore: share("appstore", "import the AuthKey.p8 file in Accounts"),
   perplexity: share("perplexity", "type the API key in Accounts, or import it from a .env file"),
-  comet: share("comet", "sign in to Comet once in a sandbox: it cannot be taken from this PC")
+  comet: share("comet", "sign in to Comet once in a sandbox: it cannot be taken from this PC"),
+  perplexityapp: share(
+    "perplexityapp",
+    "sign in to the Perplexity app once in a sandbox: it cannot be taken from this PC"
+  )
 }).describe("Service sign-ins for sandboxes (game stores, engines, app signing, Perplexity). Manage them in Accounts.");
 
 // src/core/schema/pc-installs.ts
@@ -27318,10 +27422,11 @@ var PcInstallsSchema = external_exports.strictObject({
   unrealAssets: external_exports.union([external_exports.literal("auto"), external_exports.boolean()]).describe(
     `The Epic Games Launcher's vault cache of this PC (the Fab and Marketplace packs you downloaded), read-only in the sandbox at C:\\PcInstalls\\unreal\\Vault: what you download on your PC is there for the agents at once. "auto" = whenever the sandbox is set up for Unreal, true = always, false = never.`
   ),
-  unityEditors: pick2(
-    external_exports.string().regex(/^\d+\.\d+\.\d+[abfp]\d+$/),
-    "Unity editors installed with Unity Hub",
-    '["6000.0.32f1"]'
+  unityEditors: external_exports.union([external_exports.literal("auto"), external_exports.boolean(), external_exports.array(external_exports.string().regex(/^\d+\.\d+\.\d+[abfp]\d+$/))]).describe(
+    `Unity editors installed on this PC (with Unity Hub), read-only in the sandbox under C:\\PcInstalls\\unity: a project opens with the PC's editor without a download. "auto" = all of them whenever the sandbox is set up for Unity, true = always, false = never, or a list (e.g. ["6000.0.32f1"]).`
+  ),
+  unityAssets: external_exports.union([external_exports.literal("auto"), external_exports.boolean()]).describe(
+    `This PC's Unity Asset Store downloads (.unitypackage files), read-only at C:\\PcInstalls\\unity\\AssetStore: what you download on your PC is there for the agents at once. "auto" = whenever the sandbox is set up for Unity, true = always, false = never.`
   )
 }).describe(
   "Games, engines and editors installed on this PC, mapped read-only into sandboxes (no copy, no room on the sandbox's disk)."