windows-development-sandbox 1.25.0 → 1.25.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "windows-development-sandbox",
-  "version": "1.25.0",
+  "version": "1.25.1",
   "description": "A disposable Windows Sandbox for development, with or without an AI agent (Claude Code, Codex, Gemini, opencode, ...): the folder you run it from is the workspace, toolchains and databases for your project install themselves, and nothing else on your PC is reachable.",
   "type": "module",
   "license": "MIT",

package/sandbox/csharp/VsSetup.cs

@@ -0,0 +1,210 @@
+// The Visual Studio Setup Configuration API as UnrealBuildTool calls it (MicrosoftPlatformSDK: SetupConfiguration,
+// ISetupConfiguration2.EnumAllInstances, ISetupInstance2): every instance with its state, version, product, path and
+// packages. Loaded by scripts\get-vs-setup.ps1 (Add-Type), which adds the file checks and writes the JSON. C# 5.
+using System;
+using System.Collections.Generic;
+using System.Runtime.InteropServices;
+using FILETIME = System.Runtime.InteropServices.ComTypes.FILETIME;
+
+namespace AgentSandbox
+{
+    [ComImport]
+    [Guid("42843719-DB4C-46C2-8E7C-64F1816EFD5B")]
+    [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
+    public interface ISetupConfiguration
+    {
+        IEnumSetupInstances EnumInstances();
+        ISetupInstance GetInstanceForCurrentProcess();
+        ISetupInstance GetInstanceForPath([In, MarshalAs(UnmanagedType.LPWStr)] string path);
+    }
+
+    [ComImport]
+    [Guid("26AAB78C-4A60-49D6-AF3B-3C35BC93365D")]
+    [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
+    public interface ISetupConfiguration2 : ISetupConfiguration
+    {
+        new IEnumSetupInstances EnumInstances();
+        new ISetupInstance GetInstanceForCurrentProcess();
+        new ISetupInstance GetInstanceForPath([In, MarshalAs(UnmanagedType.LPWStr)] string path);
+        IEnumSetupInstances EnumAllInstances();
+    }
+
+    [ComImport]
+    [Guid("6380BCFF-41D3-4B2E-8B2E-BF8A6810C848")]
+    [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
+    public interface IEnumSetupInstances
+    {
+        void Next(
+            [In, MarshalAs(UnmanagedType.U4)] int celt,
+            [Out, MarshalAs(UnmanagedType.LPArray, ArraySubType = UnmanagedType.Interface, SizeParamIndex = 0)]
+            ISetupInstance[] rgelt,
+            [Out, MarshalAs(UnmanagedType.U4)] out int pceltFetched);
+        void Skip([In, MarshalAs(UnmanagedType.U4)] int celt);
+        void Reset();
+        IEnumSetupInstances Clone();
+    }
+
+    [ComImport]
+    [Guid("B41463C3-8866-43B5-BC33-2B0676F7F42E")]
+    [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
+    public interface ISetupInstance
+    {
+        [return: MarshalAs(UnmanagedType.BStr)] string GetInstanceId();
+        [return: MarshalAs(UnmanagedType.Struct)] FILETIME GetInstallDate();
+        [return: MarshalAs(UnmanagedType.BStr)] string GetInstallationName();
+        [return: MarshalAs(UnmanagedType.BStr)] string GetInstallationPath();
+        [return: MarshalAs(UnmanagedType.BStr)] string GetInstallationVersion();
+        [return: MarshalAs(UnmanagedType.BStr)] string GetDisplayName([In, MarshalAs(UnmanagedType.U4)] int lcid);
+        [return: MarshalAs(UnmanagedType.BStr)] string GetDescription([In, MarshalAs(UnmanagedType.U4)] int lcid);
+        [return: MarshalAs(UnmanagedType.BStr)] string ResolvePath([In, MarshalAs(UnmanagedType.LPWStr)] string path);
+    }
+
+    [ComImport]
+    [Guid("89143C9A-05AF-49B0-B717-72E218A2185C")]
+    [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
+    public interface ISetupInstance2 : ISetupInstance
+    {
+        [return: MarshalAs(UnmanagedType.BStr)] new string GetInstanceId();
+        [return: MarshalAs(UnmanagedType.Struct)] new FILETIME GetInstallDate();
+        [return: MarshalAs(UnmanagedType.BStr)] new string GetInstallationName();
+        [return: MarshalAs(UnmanagedType.BStr)] new string GetInstallationPath();
+        [return: MarshalAs(UnmanagedType.BStr)] new string GetInstallationVersion();
+        [return: MarshalAs(UnmanagedType.BStr)] new string GetDisplayName([In, MarshalAs(UnmanagedType.U4)] int lcid);
+        [return: MarshalAs(UnmanagedType.BStr)] new string GetDescription([In, MarshalAs(UnmanagedType.U4)] int lcid);
+        [return: MarshalAs(UnmanagedType.BStr)] new string ResolvePath([In, MarshalAs(UnmanagedType.LPWStr)] string path);
+        [return: MarshalAs(UnmanagedType.U4)] uint GetState();
+        [return: MarshalAs(UnmanagedType.SafeArray, SafeArraySubType = VarEnum.VT_UNKNOWN)]
+        ISetupPackageReference[] GetPackages();
+        ISetupPackageReference GetProduct();
+        [return: MarshalAs(UnmanagedType.BStr)] string GetProductPath();
+        [return: MarshalAs(UnmanagedType.IUnknown)] object GetErrors();
+        [return: MarshalAs(UnmanagedType.VariantBool)] bool IsLaunchable();
+        [return: MarshalAs(UnmanagedType.VariantBool)] bool IsComplete();
+    }
+
+    [ComImport]
+    [Guid("DA8D8A16-B2B6-4487-A2F1-594CCCCD6BF5")]
+    [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
+    public interface ISetupPackageReference
+    {
+        [return: MarshalAs(UnmanagedType.BStr)] string GetId();
+        [return: MarshalAs(UnmanagedType.BStr)] string GetVersion();
+        [return: MarshalAs(UnmanagedType.BStr)] string GetChip();
+        [return: MarshalAs(UnmanagedType.BStr)] string GetLanguage();
+        [return: MarshalAs(UnmanagedType.BStr)] string GetBranch();
+        [return: MarshalAs(UnmanagedType.BStr)] string GetType();
+        [return: MarshalAs(UnmanagedType.BStr)] string GetUniqueId();
+        [return: MarshalAs(UnmanagedType.VariantBool)] bool GetIsExtension();
+    }
+
+    [ComImport]
+    [Guid("177F0C4A-1CD3-4DE7-A32C-71DBBB9FA36D")]
+    [ClassInterface(ClassInterfaceType.None)]
+    public class SetupConfiguration
+    {
+    }
+
+    /// <summary>One instance as the Setup API reports it.</summary>
+    public class SetupInstanceInfo
+    {
+        public string InstanceId;
+        public string InstallationPath;
+        public string InstallationVersion;
+        public string ProductId;
+        public uint State;
+        public bool IsComplete;
+        public bool IsLaunchable;
+        public string[] Packages;
+    }
+
+    public static class VsSetup
+    {
+        /// <summary>InstanceState.Local: the instance's files are on this machine (the only ones UnrealBuildTool uses).</summary>
+        public const uint StateLocal = 1;
+
+        /// <summary>Every instance EnumAllInstances lists (complete or not), as UnrealBuildTool enumerates them.</summary>
+        public static SetupInstanceInfo[] AllInstances()
+        {
+            List<SetupInstanceInfo> found = new List<SetupInstanceInfo>();
+            ISetupConfiguration2 setup = (ISetupConfiguration2)new SetupConfiguration();
+            IEnumSetupInstances instances = null;
+            try
+            {
+                instances = setup.EnumAllInstances();
+                ISetupInstance[] one = new ISetupInstance[1];
+                while (true)
+                {
+                    int fetched;
+                    instances.Next(1, one, out fetched);
+                    if (fetched == 0)
+                    {
+                        break;
+                    }
+                    ISetupInstance2 instance = (ISetupInstance2)one[0];
+                    try
+                    {
+                        found.Add(Describe(instance));
+                    }
+                    finally
+                    {
+                        Marshal.ReleaseComObject(instance);
+                    }
+                }
+            }
+            finally
+            {
+                if (instances != null)
+                {
+                    Marshal.ReleaseComObject(instances);
+                }
+                Marshal.ReleaseComObject(setup);
+            }
+            return found.ToArray();
+        }
+
+        private static SetupInstanceInfo Describe(ISetupInstance2 instance)
+        {
+            SetupInstanceInfo info = new SetupInstanceInfo();
+            info.InstanceId = instance.GetInstanceId();
+            info.InstallationPath = instance.GetInstallationPath();
+            info.InstallationVersion = instance.GetInstallationVersion();
+            info.State = instance.GetState();
+            ISetupPackageReference product = instance.GetProduct();
+            if (product == null)
+            {
+                info.ProductId = "";
+            }
+            else
+            {
+                try
+                {
+                    info.ProductId = product.GetId();
+                }
+                finally
+                {
+                    Marshal.ReleaseComObject(product);
+                }
+            }
+            info.IsComplete = instance.IsComplete();
+            info.IsLaunchable = instance.IsLaunchable();
+            ISetupPackageReference[] packages = instance.GetPackages();
+            List<string> ids = new List<string>();
+            if (packages != null)
+            {
+                foreach (ISetupPackageReference package in packages)
+                {
+                    try
+                    {
+                        ids.Add(package.GetId());
+                    }
+                    finally
+                    {
+                        Marshal.ReleaseComObject(package);
+                    }
+                }
+            }
+            info.Packages = ids.ToArray();
+            return info;
+        }
+    }
+}

package/sandbox/scripts/get-vs-setup.ps1

@@ -0,0 +1,93 @@
+#Requires -Version 5.1
+# Looks for Visual Studio the way UnrealBuildTool does (guest/toolchains/engines/unreal-engines.ts runs it; the
+# verdict is decided in vs-check.ts): every instance the Setup Configuration API lists (csharp\VsSetup.cs), the MSVC
+# toolchains under each one's VC\Tools\MSVC that have the x64 compiler, and the Windows SDKs under each KitsRoot10 the
+# registry names (HKLM in both views, HKCU) that have windows.h and the x64 kernel32.lib. Writes JSON to -ResultFile.
+param([Parameter(Mandatory = $true)][string]$ResultFile)
+$ErrorActionPreference = 'Stop'
+
+Add-Type -Path (Join-Path $PSScriptRoot '..\csharp\VsSetup.cs')
+
+$instances = New-Object System.Collections.ArrayList
+$setupError = ''
+try {
+    foreach ($i in [AgentSandbox.VsSetup]::AllInstances()) {
+        $toolchains = New-Object System.Collections.ArrayList
+        $msvc = Join-Path $i.InstallationPath 'VC\Tools\MSVC'
+        if (Test-Path -LiteralPath $msvc -PathType Container) {
+            foreach ($dir in Get-ChildItem -LiteralPath $msvc -Directory) {
+                $cl = Join-Path $dir.FullName 'bin\Hostx64\x64\cl.exe'
+                $link = Join-Path $dir.FullName 'bin\Hostx64\x64\link.exe'
+                [void]$toolchains.Add([ordered]@{
+                        version = $dir.Name
+                        cl      = (Test-Path -LiteralPath $cl -PathType Leaf)
+                        link    = (Test-Path -LiteralPath $link -PathType Leaf)
+                    })
+            }
+        }
+        $wanted = @('Microsoft.VisualStudio.Component.VC.Tools.x86.x64', 'Microsoft.VisualStudio.Workload.NativeGame',
+            'Microsoft.VisualStudio.Workload.VCTools', 'Component.Unreal', 'Component.Unreal.Ide')
+        [void]$instances.Add([ordered]@{
+                instanceId          = $i.InstanceId
+                installationPath    = $i.InstallationPath
+                installationVersion = $i.InstallationVersion
+                productId           = $i.ProductId
+                state               = [int64]$i.State
+                isComplete          = $i.IsComplete
+                isLaunchable        = $i.IsLaunchable
+                packages            = @($i.Packages | Where-Object { $wanted -contains $_ })
+                packageCount        = @($i.Packages).Count
+                toolchains          = @($toolchains)
+            })
+    }
+} catch {
+    $setupError = $_.Exception.Message
+}
+
+$roots = New-Object System.Collections.ArrayList
+$places = @(
+    @{ hive = [Microsoft.Win32.RegistryHive]::LocalMachine; view = [Microsoft.Win32.RegistryView]::Registry64; name = 'HKLM (64-bit)' },
+    @{ hive = [Microsoft.Win32.RegistryHive]::LocalMachine; view = [Microsoft.Win32.RegistryView]::Registry32; name = 'HKLM (32-bit)' },
+    @{ hive = [Microsoft.Win32.RegistryHive]::CurrentUser; view = [Microsoft.Win32.RegistryView]::Registry64; name = 'HKCU' }
+)
+foreach ($place in $places) {
+    $base = [Microsoft.Win32.RegistryKey]::OpenBaseKey($place.hive, $place.view)
+    try {
+        $key = $base.OpenSubKey('SOFTWARE\Microsoft\Windows Kits\Installed Roots')
+        if ($key) {
+            $value = [string]$key.GetValue('KitsRoot10')
+            $key.Close()
+            if ($value) { [void]$roots.Add([ordered]@{ where = $place.name; path = $value }) }
+        }
+    } finally {
+        $base.Close()
+    }
+}
+
+$sdks = New-Object System.Collections.ArrayList
+$seen = @{}
+foreach ($root in $roots) {
+    $include = Join-Path $root.path 'Include'
+    if ($seen.ContainsKey($include.ToLowerInvariant())) { continue }
+    $seen[$include.ToLowerInvariant()] = $true
+    if (-not (Test-Path -LiteralPath $include -PathType Container)) { continue }
+    foreach ($dir in Get-ChildItem -LiteralPath $include -Directory) {
+        if ($dir.Name -notmatch '^10\.\d+\.\d+\.\d+$') { continue }
+        [void]$sdks.Add([ordered]@{
+                version  = $dir.Name
+                root     = $root.path
+                windowsH = (Test-Path -LiteralPath (Join-Path $dir.FullName 'um\windows.h') -PathType Leaf)
+                kernel32 = (Test-Path -LiteralPath (Join-Path $root.path ('Lib\' + $dir.Name + '\um\x64\kernel32.lib')) -PathType Leaf)
+                ucrt     = (Test-Path -LiteralPath (Join-Path $root.path ('Lib\' + $dir.Name + '\ucrt\x64\ucrt.lib')) -PathType Leaf)
+            })
+    }
+}
+
+$result = [ordered]@{
+    setupError = $setupError
+    instances  = @($instances)
+    kitsRoots  = @($roots)
+    sdks       = @($sdks)
+}
+$json = ConvertTo-Json -InputObject $result -Depth 6
+[System.IO.File]::WriteAllText($ResultFile, $json, (New-Object System.Text.UTF8Encoding($false)))

package/sandbox/scripts/set-registry-values.ps1

@@ -0,0 +1,35 @@
+#Requires -Version 5.1
+# Writes string registry values from a plan (guest/toolchains/engines/unreal-engines.ts: the Unreal engines'
+# registration and the .uproject file association; what goes where is decided in shared/unreal/engines.ts). -PlanFile
+# is JSON written by the runtime:
+#   values: [{ hive: 'HKLM' | 'HKCU', key, name, value }]   64-bit view, '' = the default value
+# Safe to run again. Exit 0 when every value is set, 2 when one could not be.
+param([Parameter(Mandatory = $true)][string]$PlanFile)
+$ErrorActionPreference = 'Stop'
+
+$plan = Get-Content -LiteralPath $PlanFile -Raw -Encoding UTF8 | ConvertFrom-Json
+$failed = New-Object System.Collections.ArrayList
+$set = 0
+foreach ($v in @($plan.values)) {
+    $hive = if ($v.hive -eq 'HKLM') { [Microsoft.Win32.RegistryHive]::LocalMachine } else { [Microsoft.Win32.RegistryHive]::CurrentUser }
+    $base = [Microsoft.Win32.RegistryKey]::OpenBaseKey($hive, [Microsoft.Win32.RegistryView]::Registry64)
+    try {
+        $key = $base.CreateSubKey([string]$v.key)
+        try {
+            $key.SetValue([string]$v.name, [string]$v.value, [Microsoft.Win32.RegistryValueKind]::String)
+            $set++
+        } finally {
+            $key.Close()
+        }
+    } catch {
+        [void]$failed.Add($v.hive + '\' + $v.key + ' ' + $v.name + ' (' + $_.Exception.Message + ')')
+    } finally {
+        $base.Close()
+    }
+}
+if ($failed.Count) {
+    Write-Host ('Could not set: ' + ($failed -join '; '))
+    exit 2
+}
+Write-Host ('Set ' + $set + ' registry values')
+exit 0

package/schemas/config.schema.json

@@ -554,6 +554,10 @@
         },
         "unrealEngines": {
           "anyOf": [
+            {
+              "type": "string",
+              "const": "auto"
+            },
             {
               "type": "boolean"
             },
@@ -565,7 +569,29 @@
               }
             }
           ],
-          "description": "Unreal Engine versions installed with the Epic Games Launcher of this PC, read-only in the sandbox under C:\\PcInstalls: true = all of them, false = none, or a list (e.g. [\"5.4\"]). The agent can read their files."
+          "description": "Unreal Engine versions installed on this PC (with the Epic Games Launcher, or source builds it lists), read-only in the sandbox under C:\\PcInstalls\\unreal and registered there, so projects build with them without a download. \"auto\" = all of them whenever the sandbox is set up for Unreal, true = always, false = never, or a list (e.g. [\"5.4\"])."
+        },
+        "unrealEngineFolders": {
+          "maxItems": 8,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 3,
+            "maxLength": 260
+          },
+          "description": "Unreal Engine folders of this PC to use in the sandbox, writable (a source build, or a copy you build plugins into): each must hold Engine\\Build\\Build.version. Mapped under C:\\PcInstalls\\unreal and registered there."
+        },
+        "unrealAssets": {
+          "anyOf": [
+            {
+              "type": "string",
+              "const": "auto"
+            },
+            {
+              "type": "boolean"
+            }
+          ],
+          "description": "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": {
           "anyOf": [
@@ -800,7 +826,7 @@
                 "lld",
                 "gnu"
               ],
-              "description": "GNU host: \"lld\" links with Rust's own lld through MinGW's gcc (much less memory than GNU ld), \"gnu\" with GNU ld."
+              "description": "\"lld\" (default) links with Rust's own lld: through MinGW's gcc on the GNU host (much less memory than GNU ld), and instead of link.exe on the MSVC host (link.exe writes executables into mapped folders as all zeros: os error 1392). \"gnu\" keeps GNU ld / link.exe."
             },
             "linkSlots": {
               "anyOf": [
@@ -2026,6 +2052,13 @@
               "gitleaks",
               "ast-grep",
               "rust-analyzer",
+              "krita",
+              "inkscape",
+              "audacity",
+              "renderdoc",
+              "f3d",
+              "imagemagick",
+              "nomacs",
               "lua-language-server",
               "stylua",
               "selene",

package/schemas/sandbox-config.schema.json

@@ -485,7 +485,7 @@
                 "lld",
                 "gnu"
               ],
-              "description": "GNU host: \"lld\" links with Rust's own lld through MinGW's gcc (much less memory than GNU ld), \"gnu\" with GNU ld."
+              "description": "\"lld\" (default) links with Rust's own lld: through MinGW's gcc on the GNU host (much less memory than GNU ld), and instead of link.exe on the MSVC host (link.exe writes executables into mapped folders as all zeros: os error 1392). \"gnu\" keeps GNU ld / link.exe."
             },
             "linkSlots": {
               "anyOf": [
@@ -1565,6 +1565,13 @@
               "gitleaks",
               "ast-grep",
               "rust-analyzer",
+              "krita",
+              "inkscape",
+              "audacity",
+              "renderdoc",
+              "f3d",
+              "imagemagick",
+              "nomacs",
               "lua-language-server",
               "stylua",
               "selene"