windows-development-sandbox 1.25.1 → 1.27.0

package/dist/core/schema/config.d.ts

@@ -95,6 +95,7 @@ export declare const ConfigSchema: z.ZodObject<{
     }, z.core.$strict>;
     github: z.ZodObject<{
         shareToken: z.ZodBoolean;
+        usePcLogin: z.ZodBoolean;
     }, z.core.$strict>;
     accounts: z.ZodObject<{
         epic: z.ZodObject<{
@@ -127,6 +128,9 @@ export declare const ConfigSchema: z.ZodObject<{
         comet: z.ZodObject<{
             share: z.ZodBoolean;
         }, z.core.$strict>;
+        perplexityapp: z.ZodObject<{
+            share: z.ZodBoolean;
+        }, z.core.$strict>;
     }, z.core.$strict>;
     pcInstalls: z.ZodObject<{
         steamGames: z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodNumber>]>;
@@ -134,7 +138,8 @@ export declare const ConfigSchema: z.ZodObject<{
         unrealEngines: z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodBoolean, z.ZodArray<z.ZodString>]>;
         unrealEngineFolders: z.ZodArray<z.ZodString>;
         unrealAssets: z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodBoolean]>;
-        unityEditors: z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodString>]>;
+        unityEditors: z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodBoolean, z.ZodArray<z.ZodString>]>;
+        unityAssets: z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodBoolean]>;
     }, z.core.$strict>;
     provisioning: z.ZodObject<{
         copyFromHost: z.ZodBoolean;
@@ -214,6 +219,14 @@ export declare const ConfigSchema: 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">]>;
@@ -579,6 +592,9 @@ export declare const LocalOverridesSchema: z.ZodObject<{
         comet: z.ZodOptional<z.ZodObject<{
             share: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
+        perplexityapp: z.ZodOptional<z.ZodObject<{
+            share: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
     }, z.core.$strict>>;
     provisioning: z.ZodOptional<z.ZodObject<{
         copyFromHost: z.ZodOptional<z.ZodBoolean>;
@@ -601,7 +617,7 @@ export declare const LocalOverridesSchema: z.ZodObject<{
     }, z.core.$strict>>;
     toolchains: z.ZodOptional<z.ZodObject<{
         environment: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        unity: z.ZodOptional<z.ZodObject<{
+        godot: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict> | z.ZodObject<{
             version: z.ZodOptional<z.ZodString>;
@@ -616,7 +632,7 @@ export declare const LocalOverridesSchema: z.ZodObject<{
             zstd: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>;
             openssl: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>;
         }, z.core.$strict>>;
-        godot: z.ZodOptional<z.ZodObject<{
+        android: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict> | z.ZodObject<{
             version: z.ZodOptional<z.ZodString>;
@@ -631,7 +647,7 @@ export declare const LocalOverridesSchema: z.ZodObject<{
             zstd: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>;
             openssl: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>;
         }, z.core.$strict>>;
-        android: z.ZodOptional<z.ZodObject<{
+        flutter: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict> | z.ZodObject<{
             version: z.ZodOptional<z.ZodString>;
@@ -646,7 +662,7 @@ export declare const LocalOverridesSchema: z.ZodObject<{
             zstd: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>;
             openssl: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>;
         }, z.core.$strict>>;
-        flutter: z.ZodOptional<z.ZodObject<{
+        dart: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict> | z.ZodObject<{
             version: z.ZodOptional<z.ZodString>;
@@ -661,7 +677,7 @@ export declare const LocalOverridesSchema: z.ZodObject<{
             zstd: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>;
             openssl: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>;
         }, z.core.$strict>>;
-        dart: z.ZodOptional<z.ZodObject<{
+        reactNative: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict> | z.ZodObject<{
             version: z.ZodOptional<z.ZodString>;
@@ -676,7 +692,7 @@ export declare const LocalOverridesSchema: z.ZodObject<{
             zstd: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>;
             openssl: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>;
         }, z.core.$strict>>;
-        reactNative: z.ZodOptional<z.ZodObject<{
+        node: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict> | z.ZodObject<{
             version: z.ZodOptional<z.ZodString>;
@@ -691,7 +707,7 @@ export declare const LocalOverridesSchema: z.ZodObject<{
             zstd: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>;
             openssl: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>;
         }, z.core.$strict>>;
-        node: z.ZodOptional<z.ZodObject<{
+        go: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict> | z.ZodObject<{
             version: z.ZodOptional<z.ZodString>;
@@ -706,7 +722,7 @@ export declare const LocalOverridesSchema: z.ZodObject<{
             zstd: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>;
             openssl: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>;
         }, z.core.$strict>>;
-        go: z.ZodOptional<z.ZodObject<{
+        python: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict> | z.ZodObject<{
             version: z.ZodOptional<z.ZodString>;
@@ -721,7 +737,7 @@ export declare const LocalOverridesSchema: z.ZodObject<{
             zstd: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>;
             openssl: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>;
         }, z.core.$strict>>;
-        python: z.ZodOptional<z.ZodObject<{
+        rust: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict> | z.ZodObject<{
             version: z.ZodOptional<z.ZodString>;
@@ -736,7 +752,7 @@ export declare const LocalOverridesSchema: z.ZodObject<{
             zstd: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>;
             openssl: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>;
         }, z.core.$strict>>;
-        rust: z.ZodOptional<z.ZodObject<{
+        msvc: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict> | z.ZodObject<{
             version: z.ZodOptional<z.ZodString>;
@@ -751,7 +767,7 @@ export declare const LocalOverridesSchema: z.ZodObject<{
             zstd: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>;
             openssl: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>;
         }, z.core.$strict>>;
-        msvc: z.ZodOptional<z.ZodObject<{
+        unreal: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict> | z.ZodObject<{
             version: z.ZodOptional<z.ZodString>;
@@ -766,7 +782,7 @@ export declare const LocalOverridesSchema: z.ZodObject<{
             zstd: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>;
             openssl: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>;
         }, z.core.$strict>>;
-        unreal: z.ZodOptional<z.ZodObject<{
+        unity: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict> | z.ZodObject<{
             version: z.ZodOptional<z.ZodString>;

package/dist/core/schema/github.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
 export declare const GithubSchema: z.ZodObject<{
     shareToken: z.ZodBoolean;
+    usePcLogin: z.ZodBoolean;
 }, z.core.$strict>;

package/dist/core/schema/github.js

@@ -4,4 +4,7 @@ export const GithubSchema = z.strictObject({
     shareToken: z
         .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: z
+        .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.'),
 });

package/dist/core/schema/pc-installs.d.ts

@@ -5,5 +5,6 @@ export declare const PcInstallsSchema: z.ZodObject<{
     unrealEngines: z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodBoolean, z.ZodArray<z.ZodString>]>;
     unrealEngineFolders: z.ZodArray<z.ZodString>;
     unrealAssets: z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodBoolean]>;
-    unityEditors: z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodString>]>;
+    unityEditors: z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodBoolean, z.ZodArray<z.ZodString>]>;
+    unityAssets: z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodBoolean]>;
 }, z.core.$strict>;

package/dist/core/schema/pc-installs.js

@@ -21,6 +21,11 @@ export const PcInstallsSchema = z
     unrealAssets: z
         .union([z.literal('auto'), z.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: pick(z.string().regex(/^\d+\.\d+\.\d+[abfp]\d+$/), 'Unity editors installed with Unity Hub', '["6000.0.32f1"]'),
+    unityEditors: z
+        .union([z.literal('auto'), z.boolean(), z.array(z.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: z
+        .union([z.literal('auto'), z.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).");

package/dist/core/schema/toolchains.d.ts

@@ -55,6 +55,14 @@ export declare const ToolchainsSchema: 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/core/schema/toolchains.js

@@ -70,24 +70,39 @@ export const ToolchainsSchema = z.strictObject({
             .describe('"persisted": the engine\'s local derived data cache (compiled shaders, 10-50 GB) in tools\\unreal\\ddc, kept between sandboxes. "local": Unreal\'s own place on the sandbox disk (rebuilt every boot).'),
     }),
     unity: z.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.", 'ProjectSettings/ProjectVersion.txt'),
+        enabled: enabled("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: z
             .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: z
             .string()
             .min(1)
-            .describe('"project" = the version in ProjectSettings/ProjectVersion.txt, or an editor version such as "6000.0.32f1".'),
+            .describe('"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: z
             .array(z.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: z.boolean().describe('Also Unity Hub, with the installed editors listed in it.'),
+        hub: z
+            .boolean()
+            .describe('Also Unity Hub (kept on the data disk), for signing in to Unity Personal and installing editors by hand.'),
         keepVersions: z
             .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: z
+            .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: z
+            .boolean()
+            .describe("Unity's skills for Claude Code and Codex, from Unity-Technologies/skills at the commit the Unity CLI pins."),
+        cliVersion: z
+            .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: z
+            .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: z.strictObject({
         enabled: enabled('Godot from its official builds (checked against the published SHA-512 sums), self-contained in tools\\godot\\<version> with `godot` (the console build) on PATH.', 'project.godot'),
@@ -218,7 +233,7 @@ export const ToolchainsSchema = z.strictObject({
     }),
     cli: z
         .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.'),
+        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 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('`openssl` on PATH, from the copy Git for Windows ships (its mingw64\\bin is not put on PATH, so it cannot shadow MinGW\'s gcc). "auto" = on.'),
     })

package/dist/guest/accounts/adapters.js

@@ -5,6 +5,7 @@ import { epicAdapter } from './kinds/epic.js';
 import { expoAdapter } from './kinds/expo.js';
 import { keystoreAdapter } from './kinds/keystore.js';
 import { perplexityAdapter } from './kinds/perplexity.js';
+import { perplexityAppAdapter } from './kinds/perplexityapp.js';
 import { playAdapter } from './kinds/play.js';
 import { steamAdapter } from './kinds/steam.js';
 import { unityAdapter } from './kinds/unity.js';
@@ -19,4 +20,5 @@ export const ADAPTERS = {
     appstore: appstoreAdapter,
     perplexity: perplexityAdapter,
     comet: cometAdapter,
+    perplexityapp: perplexityAppAdapter,
 };

package/dist/guest/accounts/apply.d.ts

@@ -4,28 +4,30 @@ import type { ServiceAccounts } from '../../shared/accounts/payloads.js';
 import { type GuestAdapter } from './adapter.js';
 export declare const DeliveredSchema: z.ZodObject<{
     fingerprints: z.ZodRecord<z.ZodEnum<{
-        unity: "unity";
         keystore: "keystore";
         play: "play";
         expo: "expo";
         appstore: "appstore";
+        unity: "unity";
         steam: "steam";
         epic: "epic";
         cfx: "cfx";
         perplexity: "perplexity";
         comet: "comet";
+        perplexityapp: "perplexityapp";
     }> & z.core.$partial, z.ZodString>;
     leased: z.ZodArray<z.ZodEnum<{
-        unity: "unity";
         keystore: "keystore";
         play: "play";
         expo: "expo";
         appstore: "appstore";
+        unity: "unity";
         steam: "steam";
         epic: "epic";
         cfx: "cfx";
         perplexity: "perplexity";
         comet: "comet";
+        perplexityapp: "perplexityapp";
     }>>;
 }, z.core.$strip>;
 export type Delivered = z.output<typeof DeliveredSchema>;

package/dist/guest/accounts/kinds/perplexityapp.d.ts

@@ -0,0 +1,7 @@
+import { type CometPayload } from '../../../shared/accounts/index.js';
+import { type GuestAdapter } from '../adapter.js';
+/** Where the sign-in waits for the app. */
+export declare function perplexityAppPendingFile(root?: string): string;
+/** The sign-in waiting for the app (left in place), or null (none, or not the expected shape). */
+export declare function peekPendingPerplexityApp(root?: string): CometPayload | null;
+export declare const perplexityAppAdapter: GuestAdapter<'perplexityapp'>;

package/dist/guest/accounts/kinds/perplexityapp.js

@@ -0,0 +1,53 @@
+// Perplexity desktop app: the saved perplexity.ai sign-in cookies wait in secretDir('perplexityapp') (the sandbox's own
+// disk) until the app runs; the watch then writes them into it over its DevTools port and deletes the file. While the
+// sandbox runs, the watch asks the running app for its perplexity.ai cookies, so a sign-in made here (or renewed) is
+// kept for the next sandbox. When the app is not running, the last sign-in seen stands.
+import fs from 'node:fs';
+import path from 'node:path';
+import { cometSummary, PAYLOADS } from '../../../shared/accounts/index.js';
+import { readBoundedFile } from '../../../shared/io/bounded.js';
+import { readAppSignIn, restoreAppSignIn } from '../../browser/perplexity-app.js';
+import { secretDir } from '../adapter.js';
+/** Where the sign-in waits for the app. */
+export function perplexityAppPendingFile(root = secretDir('perplexityapp')) {
+    return path.join(root, 'restore.json');
+}
+/** The sign-in waiting for the app (left in place), or null (none, or not the expected shape). */
+export function peekPendingPerplexityApp(root) {
+    const bytes = readBoundedFile(perplexityAppPendingFile(root), 512 * 1024);
+    if (!bytes)
+        return null;
+    try {
+        const parsed = PAYLOADS.perplexityapp.safeParse(JSON.parse(bytes.toString('utf8')));
+        return parsed.success ? parsed.data : null;
+    }
+    catch {
+        return null; // Not JSON: nothing to restore.
+    }
+}
+/** The last sign-in seen in this process (the daemon's watch). */
+let held = null;
+export const perplexityAppAdapter = {
+    kind: 'perplexityapp',
+    apply(p) {
+        const file = perplexityAppPendingFile();
+        fs.mkdirSync(path.dirname(file), { recursive: true });
+        fs.writeFileSync(file, JSON.stringify(p), { encoding: 'utf8', mode: 0o600 });
+        held = p;
+        return {
+            summary: 'Perplexity app: your saved sign-in (' + cometSummary(p) + ') goes into it once it runs (reload its window)',
+        };
+    },
+    async refresh() {
+        const pending = peekPendingPerplexityApp();
+        if (pending && (await restoreAppSignIn(pending).catch(() => false)))
+            fs.rmSync(perplexityAppPendingFile(), { force: true });
+        const now = await readAppSignIn();
+        if (now)
+            held = now;
+    },
+    current() {
+        return held;
+    },
+    checkMs: 30_000,
+};

package/dist/guest/accounts/kinds/unity.d.ts

@@ -1,2 +1,29 @@
+import type { UnityStatus } from '../../../shared/unity/status.js';
 import { type GuestAdapter } from '../adapter.js';
+/** Runs a program to its end (or its time limit); the exit code and what it printed. Injected by the self-test. */
+export type UnityRunner = (file: string, args: readonly string[], o: {
+    readonly timeoutMs: number;
+    readonly env?: Readonly<Record<string, string>>;
+}) => Promise<{
+    readonly code: number;
+    readonly stdout: string;
+}>;
+export declare const runUnityProgram: UnityRunner;
+export interface UnityDirs {
+    readonly programData: string;
+    readonly localAppData: string;
+    /** secretDir('unity'). */
+    readonly secrets: string;
+}
+/** The adapter for these folders and this runner (the self-test passes its own). */
+export declare function unityAdapterFor(dirs: UnityDirs, run?: UnityRunner): GuestAdapter<'unity'>;
 export declare const unityAdapter: GuestAdapter<'unity'>;
+/**
+ * Activates the serial the sandbox holds once an editor exists, then asks `unity license status` where the licence
+ * stands. The detail never holds a secret.
+ */
+export declare function activateUnityLicence(o: {
+    readonly editorExe: string | null;
+    readonly unityExe: string | null;
+    readonly source?: string;
+}, dirs?: UnityDirs, run?: UnityRunner): Promise<UnityStatus['licence']>;

package/dist/guest/accounts/kinds/unity.js

@@ -1,7 +1,164 @@
-import { notAvailableYet } from '../adapter.js';
-export const unityAdapter = {
-    kind: 'unity',
-    apply(_p) {
-        return notAvailableYet('unity');
-    },
-};
+// Unity: the licence file (Unity_lic.ulf) goes to %ProgramData%\Unity and the named-user licence to
+// %LOCALAPPDATA%\Unity\licenses, where the editor reads them. The Unity ID (and a Plus or Pro serial) are kept in
+// secretDir('unity')\activation.json, on the sandbox's own disk, for the editor to sign in with. A serial seat is
+// returned when the sandbox stops. Nothing here puts a password, serial or licence text in a log or a summary.
+import { execFile } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { z } from 'zod';
+import { MAX_ULF_BYTES, parseLicenceStatus, unityEntitlementFile, unityUlfFile, } from '../../../shared/accounts/index.js';
+import { decodeText, readBoundedFile } from '../../../shared/io/index.js';
+import { licenceStatusArgs, UNITY_CLI_ENV } from '../../../shared/unity/cli.js';
+import { localAppData, secretDir } from '../adapter.js';
+const MAX_JSON_BYTES = 16 * 1024;
+const RETURN_MS = 120_000;
+const ACTIVATE_MS = 180_000;
+const STATUS_MS = 60_000;
+const ActivationSchema = z.object({
+    email: z.string().max(256).optional(),
+    password: z.string().max(1024).optional(),
+    serial: z.string().max(64).optional(),
+});
+const ActivatedSchema = z.object({ editorExe: z.string().min(1).max(520), serial: z.literal(true) });
+export const runUnityProgram = (file, args, o) => new Promise((resolve) => {
+    execFile(file, [...args], { windowsHide: true, timeout: o.timeoutMs, maxBuffer: 1024 * 1024, env: { ...process.env, ...o.env } }, (error, stdout) => {
+        const code = error ? (typeof error.code === 'number' ? error.code : -1) : 0;
+        resolve({ code, stdout: String(stdout ?? '') });
+    });
+});
+function readText(file) {
+    const bytes = readBoundedFile(file, MAX_ULF_BYTES);
+    return bytes ? decodeText(bytes).text : null;
+}
+function readSecretJson(schema, file) {
+    const bytes = readBoundedFile(file, MAX_JSON_BYTES);
+    if (!bytes)
+        return null;
+    try {
+        const parsed = schema.safeParse(JSON.parse(decodeText(bytes).text));
+        return parsed.success ? parsed.data : null;
+    }
+    catch {
+        return null; // not JSON: treated as absent
+    }
+}
+function writeText(file, text) {
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, text, 'utf8');
+}
+/** The adapter for these folders and this runner (the self-test passes its own). */
+export function unityAdapterFor(dirs, run = runUnityProgram) {
+    const activation = path.join(dirs.secrets, 'activation.json');
+    const activated = path.join(dirs.secrets, 'activated.json');
+    return {
+        kind: 'unity',
+        apply(p) {
+            if (p.ulf)
+                writeText(unityUlfFile(dirs.programData), p.ulf);
+            if (p.entitlement)
+                writeText(unityEntitlementFile(dirs.localAppData), p.entitlement);
+            const sign = {};
+            if (p.email)
+                sign.email = p.email;
+            if (p.password)
+                sign.password = p.password;
+            if (p.serial)
+                sign.serial = p.serial;
+            if (Object.keys(sign).length)
+                writeText(activation, JSON.stringify(sign));
+            return {
+                summary: p.ulf || p.entitlement
+                    ? 'Unity: your licence file is in place'
+                    : 'Unity: your Unity ID is ready to activate the serial',
+            };
+        },
+        current() {
+            const ulf = readText(unityUlfFile(dirs.programData));
+            const entitlement = readText(unityEntitlementFile(dirs.localAppData));
+            const sign = readSecretJson(ActivationSchema, activation) ?? {};
+            const out = {
+                ...(ulf ? { ulf } : {}),
+                ...(entitlement ? { entitlement } : {}),
+                ...sign,
+            };
+            return Object.keys(out).length ? out : null;
+        },
+        async release() {
+            const marker = readSecretJson(ActivatedSchema, activated);
+            if (!marker)
+                return;
+            const sign = readSecretJson(ActivationSchema, activation);
+            if (!sign?.email || !sign.password)
+                return;
+            await run(marker.editorExe, [
+                '-batchmode',
+                '-nographics',
+                '-quit',
+                '-returnlicense',
+                '-username',
+                sign.email,
+                '-password',
+                sign.password,
+                '-logFile',
+                path.join(dirs.secrets, 'return.log'),
+            ], { timeoutMs: RETURN_MS });
+        },
+    };
+}
+function defaultDirs() {
+    return {
+        programData: process.env.ProgramData ?? process.env.PROGRAMDATA ?? 'C:\\ProgramData',
+        localAppData: localAppData(),
+        secrets: secretDir('unity'),
+    };
+}
+export const unityAdapter = unityAdapterFor(defaultDirs());
+/**
+ * Activates the serial the sandbox holds once an editor exists, then asks `unity license status` where the licence
+ * stands. The detail never holds a secret.
+ */
+export async function activateUnityLicence(o, dirs = defaultDirs(), run = runUnityProgram) {
+    const sign = readSecretJson(ActivationSchema, path.join(dirs.secrets, 'activation.json'));
+    if (sign?.serial && sign.email && sign.password && o.editorExe) {
+        await run(o.editorExe, [
+            '-batchmode',
+            '-nographics',
+            '-quit',
+            '-serial',
+            sign.serial,
+            '-username',
+            sign.email,
+            '-password',
+            sign.password,
+            '-logFile',
+            path.join(dirs.secrets, 'activate.log'),
+        ], { timeoutMs: ACTIVATE_MS });
+        writeText(path.join(dirs.secrets, 'activated.json'), JSON.stringify({ editorExe: o.editorExe, serial: true }));
+    }
+    const user = sign?.email ?? null;
+    if (!o.unityExe)
+        return { state: 'unknown', kind: '', detail: 'not checked', user };
+    let parsed = null;
+    try {
+        const r = await run(o.unityExe, licenceStatusArgs(), { timeoutMs: STATUS_MS, env: UNITY_CLI_ENV });
+        parsed = r.code === 0 ? JSON.parse(r.stdout) : null;
+    }
+    catch {
+        parsed = null; // not JSON: reported as not recognised
+    }
+    const s = parseLicenceStatus(parsed);
+    if (s.state === 'active')
+        return { state: 'active', kind: s.kind, detail: 'active (' + (s.kind || 'licensed') + ')', user };
+    if (s.state === 'none') {
+        const hasFile = readText(unityUlfFile(dirs.programData)) !== null || readText(unityEntitlementFile(dirs.localAppData)) !== null;
+        return hasFile
+            ? {
+                state: 'invalid',
+                kind: '',
+                detail: 'the licence file from ' + (o.source ?? 'your saved sign-in') + ' is not accepted here: sign in again',
+                user,
+            }
+            : { state: 'none', kind: '', detail: 'none: sign in to Unity once in this sandbox', user };
+    }
+    return { state: 'unknown', kind: '', detail: s.detail, user };
+}

package/dist/guest/apps/app-installer.js

@@ -13,10 +13,13 @@ import { errMsg } from '../../core/util/errors.js';
 import { emptyEnv, tool } from '../toolchains/tool-env.js';
 import { uvVars } from '../toolchains/runtimes.js';
 import { COMET_MCP_PORT, cometShortcutArgs } from '../browser/comet.js';
+import { perplexityAppShortcutArgs } from '../browser/perplexity-app.js';
 import { afterInstall } from './after-install.js';
 import { installFromKept } from './comet-unpack.js';
 import { findExe } from './find-exe.js';
+import { installStoreApp } from './store-app.js';
 import { shortcuts } from './shortcuts.js';
+import { SYSTEM } from '../../shared/system.js';
 import { signatureCheck } from '../toolchains/installers.js';
 import { resolve } from './sources.js';
 import { unpack } from './unpack.js';
@@ -46,6 +49,7 @@ export class AppInstaller {
     async prefetch(entries) {
         const todo = entries.filter((e) => !('remote' in e.source) &&
             !('locked' in e.source) &&
+            !('store' in e.source) &&
             !('npm' in e.source) &&
             e.id !== '7zip' &&
             (this.options.refresh || !exists(path.join(tool('apps', ...e.id.split('/')), MARKER))));
@@ -97,6 +101,20 @@ export class AppInstaller {
                 this.installed.push(entry.name);
                 return;
             }
+            if ('store' in entry.source) {
+                // A Store app: Windows in the sandbox is new on every boot, so it is installed again from the PC's package.
+                log('Installing ' + entry.name + ' (Microsoft Store package) ...');
+                await installStoreApp(entry.id, entry.source.store.packageName);
+                fs.writeFileSync(path.join(mkdirp(dest), MARKER), JSON.stringify({ id: entry.id, at: new Date().toISOString() }));
+                this.gui.push({
+                    name: entry.name,
+                    exe: SYSTEM.powershell(),
+                    args: perplexityAppShortcutArgs(path.join(launchDir, 'sandbox', 'scripts', 'start-store-app.ps1')),
+                });
+                this.installed.push(entry.name);
+                this.installedIds.push(entry.id);
+                return;
+            }
             if (!exists(path.join(dest, MARKER)) || this.options.refresh)
                 await this.download(entry, dest);
             // A Chromium installer that could not be unpacked is kept and installed into the sandbox each boot instead.

package/dist/guest/apps/store-app.d.ts

@@ -0,0 +1,4 @@
+/** Where the PC left an app's package. */
+export declare function storePackageDir(appId: string): string;
+/** Installs the app from its kept package; resolves when Windows has it. */
+export declare function installStoreApp(appId: string, packageName: string): Promise<void>;