blueprint-extractor-mcp 7.0.8 → 8.0.0

package/README.md

@@ -23,7 +23,7 @@ Blueprint Extractor MCP is a [Model Context Protocol](https://modelcontextprotoc
  AI Assistant         stdio           MCP Server         HTTP :30010        Unreal Editor
  ─────────────  ◄────────────►  ─────────────────  ◄──────────────────►  ─────────────────
   Claude Code                     Node.js process                         Remote Control API
-  Codex / OpenCode                106 tools                               BlueprintExtractor
+  Codex / OpenCode                109 tools                               BlueprintExtractor
   ...                             38 resources                            plugin
                                   4 resource templates
                                   12 prompts
@@ -112,22 +112,23 @@ codex mcp add --env UE_REMOTE_CONTROL_PORT=30010 \
 
 ## Tool Surface
 
-Only the compact core surface is visible by default to keep the context window lean. Specialized families are loaded on demand via `activate_workflow_scope`.
+Use `activate_tool_profile` to switch between the compact `default` surface and the full `expert` surface. The default profile keeps the context window lean and loads specialized families on demand via `activate_workflow_scope`.
 
 | Scope | What It Unlocks |
 |:------|:----------------|
-| **Core** *(always on)* | Search, extraction, list/save/help, editor-session binding, and project-control entry points such as `extract_asset`, `search_assets`, `save_assets`, `get_tool_help`, and `activate_workflow_scope` |
+| **Core** *(always on in `default` profile)* | Search, extraction, `find_and_extract`, list/save/help, and the profile/scope switches such as `extract_asset`, `search_assets`, `save_assets`, `get_tool_help`, `activate_tool_profile`, and `activate_workflow_scope` |
 | `widget_authoring` | Parent scope that loads `widget_authoring_structure`, `widget_authoring_visual`, and `widget_verification` together |
-| `widget_authoring_structure` | Widget tree structure, hierarchy edits, wrapping, moving, replacement, and batch operations |
+| `widget_authoring_structure` | Recipe-first widget authoring, tree replacement, unified-diff patching, and focused structure edits without the deprecated widget aliases |
 | `widget_authoring_visual` | Widget compile flows, CommonUI styles, widget animations, and widget preview capture |
 | `widget_verification` | Widget capture, checkpoint bundles, capture listing, cleanup, and reference comparison |
-| `material_authoring` | Material creation, `material_graph_operation`, compile, and material-instance edits |
-| `blueprint_authoring` | Blueprint creation, member edits, graph edits, and Live Coding trigger |
+| `material_authoring` | `create_material_setup`, `modify_material`, `material_graph_operation`, compile, and material-instance edits |
+| `blueprint_authoring` | `scaffold_blueprint`, graph/member edits, Blueprint creation, and Live Coding trigger |
 | `schema_ai_authoring` | Structs, enums, Blackboards, Behavior Trees, and State Trees |
 | `animation_authoring` | Anim sequences, montages, blend spaces, and widget motion authoring |
 | `data_tables` | Data assets, data tables, curves, Input Actions, and Input Mapping Contexts |
 | `import` | Async asset import and import-job polling |
-| `automation_testing` | Host-side automation runs, coarse project automation context, and PIE lifecycle control |
+| `project_control` | Editor-session binding, launch/wait, project automation context, PIE lifecycle control, host build/restart/sync, and `apply_window_ui_changes` |
+| `automation_testing` | Host-side automation runs and automation-run polling |
 | `analysis` | Deterministic Blueprint review and low-noise project asset audits |
 | `project_intelligence` | Bounded editor context, project indexing, freshness status, and snippet-first context search |
 | `verification` | Editor/runtime screenshots, capture comparison, motion verification, and artifact inspection |

package/dist/helpers/next-step-hints.js

@@ -254,7 +254,7 @@ export const NEXT_STEP_HINTS_REGISTRY = new Map([
     ['extract_widget_blueprint', extractionHints('extract_widget_blueprint', {
             on_success: [
                 'Use patch_widget or replace_widget_tree to modify the widget.',
-                'Use compile_widget_blueprint to check for errors.',
+                'Use compile_widget to check for errors.',
                 'Use capture_widget_preview for visual verification.',
             ],
             scope_suggestion: 'widget_authoring',
@@ -276,25 +276,17 @@ export const NEXT_STEP_HINTS_REGISTRY = new Map([
     // =========================================================================
     // Widget structure tools
     // =========================================================================
-    ['create_widget_blueprint', creationHints('extract_widget_blueprint', 'build_widget_tree', {
+    ['create_widget_blueprint', creationHints('extract_widget_blueprint', 'replace_widget_tree', {
             on_success: [
-                'Use build_widget_tree to populate the widget tree.',
+                'Use replace_widget_tree to populate the widget tree.',
                 'Use extract_widget_blueprint to verify.',
                 'Use save_assets to persist.',
             ],
             scope_suggestion: 'widget_authoring',
         })],
-    ['build_widget_tree', modificationHints('extract_widget_blueprint', {
-            on_success: [
-                'Use compile_widget_blueprint to verify the tree compiles.',
-                'Use extract_widget_blueprint to inspect the result.',
-                'Use save_assets to persist.',
-            ],
-            scope_suggestion: 'widget_authoring',
-        })],
     ['replace_widget_tree', modificationHints('extract_widget_blueprint', {
             on_success: [
-                'Use compile_widget_blueprint to verify the new tree.',
+                'Use compile_widget to verify the new tree.',
                 'Use extract_widget_blueprint to inspect the result.',
                 'Use save_assets to persist.',
             ],
@@ -344,7 +336,7 @@ export const NEXT_STEP_HINTS_REGISTRY = new Map([
         })],
     ['replace_widget_class', modificationHints('extract_widget_blueprint', {
             on_success: [
-                'Use compile_widget_blueprint to verify the class change.',
+                'Use compile_widget to verify the class change.',
                 'Use extract_widget_blueprint to inspect the result.',
                 'Use save_assets to persist.',
             ],
@@ -352,7 +344,7 @@ export const NEXT_STEP_HINTS_REGISTRY = new Map([
         })],
     ['batch_widget_operations', modificationHints('extract_widget_blueprint', {
             on_success: [
-                'Use compile_widget_blueprint to verify the batch result.',
+                'Use compile_widget to verify the batch result.',
                 'Use extract_widget_blueprint to inspect changes.',
                 'Use save_assets to persist.',
             ],
@@ -370,36 +362,6 @@ export const NEXT_STEP_HINTS_REGISTRY = new Map([
             ],
             scope_suggestion: 'widget_authoring',
         }],
-    ['modify_widget_blueprint', modificationHints('extract_widget_blueprint', {
-            on_success: [
-                'Use operation-specific tools (patch_widget, replace_widget_tree, etc.) instead.',
-                'Use save_assets to persist changes.',
-            ],
-            on_error: [
-                'Use extract_widget_blueprint to inspect current state.',
-                'Consider using operation-specific tools for clearer errors.',
-            ],
-            scope_suggestion: 'widget_authoring',
-        })],
-    ['modify_widget', modificationHints('extract_widget_blueprint', {
-            on_success: [
-                'Use save_assets to persist changes.',
-                'Use extract_widget_blueprint to verify.',
-            ],
-            scope_suggestion: 'widget_authoring',
-        })],
-    ['compile_widget_blueprint', {
-            on_success: [
-                'Inspect compile.messages and diagnostics for warnings.',
-                'Re-extract the widget blueprint before applying the next patch.',
-                'Check BindWidget names/types if there are abstract class references.',
-            ],
-            on_error: [
-                'Use extract_widget_blueprint to inspect the current state.',
-                'Fix reported issues and recompile.',
-            ],
-            scope_suggestion: 'widget_authoring',
-        }],
     // =========================================================================
     // Widget verification tools
     // =========================================================================
@@ -464,7 +426,7 @@ export const NEXT_STEP_HINTS_REGISTRY = new Map([
     ['apply_commonui_button_style', {
             on_success: [
                 'Use extract_widget_blueprint to verify the style was applied.',
-                'Use compile_widget_blueprint to verify compilation.',
+                'Use compile_widget to verify compilation.',
                 'Use save_assets to persist.',
             ],
             on_error: [

package/dist/helpers/project-resolution.js

@@ -1,7 +1,7 @@
 import { access } from 'node:fs/promises';
 import { constants as fsConstants } from 'node:fs';
-import path, { resolve } from 'node:path';
-import { buildEngineAssociationCandidates, readProjectEngineAssociation } from './workspace-project.js';
+import path, { posix as posixPath, win32 as win32Path } from 'node:path';
+import { buildEngineAssociationCandidates, isWindowsStylePath, isWslMountedWindowsPath, readProjectEngineAssociation, toHostFilesystemPath, toWindowsStylePath, } from './workspace-project.js';
 export function rememberExternalBuild(result) {
     return {
         success: result.success === true,
@@ -32,6 +32,9 @@ export async function getProjectAutomationContext(deps) {
     return nextContext;
 }
 const cachedHeuristicEngineRoots = new Map();
+function getPathModule(platform) {
+    return platform === 'win32' ? win32Path : posixPath;
+}
 export function getHeuristicEngineCandidates(platform = process.platform) {
     if (platform === 'win32') {
         return [
@@ -74,10 +77,13 @@ function getEngineMarkers(platform) {
         'Engine/Build/BatchFiles/Build.sh',
     ];
 }
-async function accessFirstMatchingMarker(root, markers) {
+async function accessFirstMatchingMarker(root, markers, targetPlatform, hostPlatform) {
+    const pathModule = getPathModule(targetPlatform);
+    const normalizedRoot = targetPlatform === 'win32' ? toWindowsStylePath(root) : root;
     for (const marker of markers) {
         try {
-            await access(resolve(root, marker), fsConstants.F_OK);
+            const candidate = pathModule.resolve(normalizedRoot, marker);
+            await access(toHostFilesystemPath(candidate, targetPlatform, hostPlatform), fsConstants.F_OK);
             return true;
         }
         catch {
@@ -86,24 +92,24 @@ async function accessFirstMatchingMarker(root, markers) {
     }
     return false;
 }
-async function probeEngineRootHeuristic(platform) {
-    if (cachedHeuristicEngineRoots.has(platform)) {
-        return cachedHeuristicEngineRoots.get(platform) || undefined;
+async function probeEngineRootHeuristic(targetPlatform, hostPlatform) {
+    const cacheKey = `${hostPlatform}:${targetPlatform}`;
+    if (cachedHeuristicEngineRoots.has(cacheKey)) {
+        return cachedHeuristicEngineRoots.get(cacheKey) || undefined;
     }
-    for (const candidate of getHeuristicEngineCandidates(platform)) {
-        if (await accessFirstMatchingMarker(candidate, getEngineMarkers(platform))) {
-            cachedHeuristicEngineRoots.set(platform, candidate);
+    for (const candidate of getHeuristicEngineCandidates(targetPlatform)) {
+        if (await accessFirstMatchingMarker(candidate, getEngineMarkers(targetPlatform), targetPlatform, hostPlatform)) {
+            cachedHeuristicEngineRoots.set(cacheKey, candidate);
             return candidate;
         }
     }
-    cachedHeuristicEngineRoots.set(platform, '');
+    cachedHeuristicEngineRoots.set(cacheKey, '');
     return undefined;
 }
-async function probePreferredEngineRoot(candidates, platform) {
-    const markers = getEngineMarkers(platform);
+async function probePreferredEngineRoot(candidates, hostPlatform) {
     for (const candidate of candidates) {
-        if (await accessFirstMatchingMarker(candidate, markers)) {
-            return candidate;
+        if (await accessFirstMatchingMarker(candidate.path, getEngineMarkers(candidate.platform), candidate.platform, hostPlatform)) {
+            return candidate.path;
         }
     }
     return undefined;
@@ -133,7 +139,16 @@ export async function resolveProjectInputs(request, deps) {
     const projectPath = firstDefinedString(request.project_path, projectPathFromContext, projectPathFromWorkspace, projectPathFromEnv);
     const target = firstDefinedString(request.target, targetFromContext, targetFromWorkspace, targetFromEnv);
     const engineAssociation = projectPath ? await readProjectEngineAssociation(projectPath) : undefined;
-    const associationCandidates = buildEngineAssociationCandidates(engineAssociation, platform);
+    const windowsWorkspaceHint = [request.engine_root, request.project_path, projectPathFromWorkspace, projectPathFromEnv]
+        .filter((value) => typeof value === 'string' && value.length > 0)
+        .some((value) => isWindowsStylePath(value) || isWslMountedWindowsPath(value));
+    const heuristicPlatforms = windowsWorkspaceHint && platform !== 'win32'
+        ? ['win32', platform]
+        : [platform];
+    const associationCandidates = heuristicPlatforms.flatMap((candidatePlatform) => (buildEngineAssociationCandidates(engineAssociation, candidatePlatform).map((candidate) => ({
+        path: candidate,
+        platform: candidatePlatform,
+    }))));
     let engineRoot = firstDefinedString(request.engine_root, engineRootFromContext, engineRootFromEnv);
     let engineRootSource;
     if (request.engine_root) {
@@ -147,7 +162,15 @@ export async function resolveProjectInputs(request, deps) {
     }
     else {
         const preferredCandidate = await probePreferredEngineRoot(associationCandidates, platform);
-        const heuristicRoot = preferredCandidate ?? await probeEngineRootHeuristic(platform);
+        let heuristicRoot = preferredCandidate;
+        if (!heuristicRoot) {
+            for (const candidatePlatform of heuristicPlatforms) {
+                heuristicRoot = await probeEngineRootHeuristic(candidatePlatform, platform);
+                if (heuristicRoot) {
+                    break;
+                }
+            }
+        }
         if (heuristicRoot) {
             engineRoot = heuristicRoot;
             engineRootSource = 'filesystem_heuristic';

package/dist/helpers/tool-help.js

@@ -102,22 +102,6 @@ export function summarizeOutputSchema(schema) {
 }
 export function collectToolExampleFamilies(exampleCatalog, toolName) {
     const equivalentToolNames = new Set([toolName]);
-    if (toolName === 'modify_widget_blueprint') {
-        [
-            'patch_widget',
-            'patch_widget_class_defaults',
-            'insert_widget_child',
-            'remove_widget',
-            'move_widget',
-            'wrap_widget',
-            'replace_widget_class',
-            'replace_widget_tree',
-            'batch_widget_operations',
-        ].forEach((name) => equivalentToolNames.add(name));
-    }
-    if (toolName === 'compile_widget_blueprint') {
-        equivalentToolNames.add('compile_widget');
-    }
     return Object.entries(exampleCatalog)
         .flatMap(([family, entry]) => {
         const exampleTitles = entry.examples
@@ -143,7 +127,6 @@ export function collectRelatedResources(toolName) {
     if (toolName.startsWith('create_')
         || toolName.startsWith('modify_')
         || toolName.startsWith('apply_')
-        || toolName === 'build_widget_tree'
         || toolName === 'save_assets') {
         resources.add('blueprint://write-capabilities');
         resources.add('blueprint://authoring-conventions');

package/dist/helpers/workspace-project.d.ts

@@ -3,6 +3,10 @@ export type WorkspaceProjectResolution = {
     ambiguous: boolean;
     searchedFrom: string;
 };
+export declare function isWindowsStylePath(input: string): boolean;
+export declare function isWslMountedWindowsPath(input: string): boolean;
+export declare function toWindowsStylePath(input: string): string;
+export declare function toHostFilesystemPath(input: string, targetPlatform: NodeJS.Platform, hostPlatform?: NodeJS.Platform): string;
 export declare function normalizeFilesystemPath(input: string | undefined): string | undefined;
 export declare function filesystemPathsEqual(left: string | undefined, right: string | undefined): boolean;
 export declare function findNearestWorkspaceProject(startDir?: string): Promise<WorkspaceProjectResolution>;

package/dist/helpers/workspace-project.js

@@ -2,9 +2,41 @@ import { readFile, readdir } from 'node:fs/promises';
 import path from 'node:path';
 const WINDOWS_DRIVE_PATH = /^[A-Za-z]:[\\/]/;
 const WINDOWS_UNC_PATH = /^(?:\\\\|\/\/)[^\\/]+[\\/][^\\/]+/;
-function isWindowsStylePath(input) {
+const WSL_MOUNT_PATH = /^\/mnt\/([a-zA-Z])(\/.*)?$/;
+export function isWindowsStylePath(input) {
     return WINDOWS_DRIVE_PATH.test(input) || WINDOWS_UNC_PATH.test(input);
 }
+export function isWslMountedWindowsPath(input) {
+    return WSL_MOUNT_PATH.test(input);
+}
+export function toWindowsStylePath(input) {
+    if (isWindowsStylePath(input)) {
+        return path.win32.normalize(input);
+    }
+    const match = input.replaceAll('\\', '/').match(WSL_MOUNT_PATH);
+    if (!match) {
+        return input;
+    }
+    const drive = match[1]?.toUpperCase();
+    const suffix = match[2] ?? '';
+    return path.win32.normalize(`${drive}:${suffix}`);
+}
+export function toHostFilesystemPath(input, targetPlatform, hostPlatform = process.platform) {
+    if (targetPlatform !== 'win32' || hostPlatform === 'win32') {
+        return input;
+    }
+    if (isWslMountedWindowsPath(input)) {
+        return path.posix.normalize(input.replaceAll('\\', '/'));
+    }
+    const normalized = input.replaceAll('\\', '/');
+    const match = normalized.match(/^([A-Za-z]):(\/.*)?$/);
+    if (!match) {
+        return input;
+    }
+    const drive = match[1]?.toLowerCase();
+    const suffix = match[2] ?? '';
+    return path.posix.normalize(`/mnt/${drive}${suffix}`);
+}
 export function normalizeFilesystemPath(input) {
     if (!input) {
         return undefined;

package/dist/project-controller.d.ts

@@ -89,6 +89,7 @@ export interface CommandRunner {
         cwd?: string;
         env?: NodeJS.ProcessEnv;
         timeoutMs: number;
+        platform?: NodeJS.Platform;
     }): Promise<{
         exitCode: number;
         stdout: string;
@@ -121,10 +122,11 @@ export interface ProjectControllerLike {
         waitForReconnect?: boolean;
     }): Promise<RestartReconnectResult>;
 }
+export declare function inferExecutionPlatform(engineRoot: string | undefined, projectPath: string | undefined, hostPlatform?: NodeJS.Platform): NodeJS.Platform;
 export declare function resolveCommandInvocation(executable: string, args: string[], platform: NodeJS.Platform, env?: NodeJS.ProcessEnv): CommandInvocation;
 export declare function getBuildScriptCandidates(engineRoot: string, platform: NodeJS.Platform): string[];
-export declare function resolveBuildScript(engineRoot: string, platform: NodeJS.Platform): Promise<string>;
-export declare function resolveEditorExecutable(engineRoot: string, platform: NodeJS.Platform, mode?: 'editor' | 'commandlet'): Promise<string>;
+export declare function resolveBuildScript(engineRoot: string, platform: NodeJS.Platform, hostPlatform?: NodeJS.Platform): Promise<string>;
+export declare function resolveEditorExecutable(engineRoot: string, platform: NodeJS.Platform, mode?: 'editor' | 'commandlet', hostPlatform?: NodeJS.Platform): Promise<string>;
 export declare function classifyChangedPaths(changedPaths: string[], forceRebuild?: boolean): SyncStrategyPlan;
 /** Classify UBT build output into an error category. */
 export declare function classifyBuildError(stdout: string, stderr: string, exitCode: number): {

package/dist/project-controller.js

@@ -1,7 +1,8 @@
 import { execSync, spawn } from 'node:child_process';
 import { access, readdir, unlink } from 'node:fs/promises';
 import { constants as fsConstants } from 'node:fs';
-import { dirname, resolve, win32 as win32Path } from 'node:path';
+import { posix as posixPath, win32 as win32Path } from 'node:path';
+import { isWindowsStylePath, isWslMountedWindowsPath, toHostFilesystemPath, toWindowsStylePath, } from './helpers/workspace-project.js';
 const DEFAULT_BUILD_TIMEOUT_MS = 30 * 60 * 1000;
 const DEFAULT_DISCONNECT_TIMEOUT_MS = 60 * 1000;
 const DEFAULT_RECONNECT_TIMEOUT_MS = 3 * 60 * 1000;
@@ -13,6 +14,27 @@ function defaultSleep(ms) {
 function isWindowsBatchScript(executable, platform) {
     return platform === 'win32' && /\.(bat|cmd)$/iu.test(executable);
 }
+function getPlatformPath(platform) {
+    return platform === 'win32' ? win32Path : posixPath;
+}
+function resolvePathForPlatform(root, segments, platform) {
+    const normalizedRoot = platform === 'win32' ? toWindowsStylePath(root) : root;
+    return getPlatformPath(platform).resolve(normalizedRoot, ...segments);
+}
+function dirnameForPlatform(filePath, platform) {
+    const normalizedPath = platform === 'win32' ? toWindowsStylePath(filePath) : filePath;
+    return getPlatformPath(platform).dirname(normalizedPath);
+}
+export function inferExecutionPlatform(engineRoot, projectPath, hostPlatform = process.platform) {
+    if (hostPlatform !== 'linux') {
+        return hostPlatform;
+    }
+    const pathHints = [engineRoot, projectPath].filter((value) => typeof value === 'string' && value.length > 0);
+    if (pathHints.some((value) => isWindowsStylePath(value) || isWslMountedWindowsPath(value))) {
+        return 'win32';
+    }
+    return hostPlatform;
+}
 function quoteWindowsCommandArg(value) {
     if (value.length === 0) {
         return '""';
@@ -45,24 +67,24 @@ export function resolveCommandInvocation(executable, args, platform, env = proce
 export function getBuildScriptCandidates(engineRoot, platform) {
     if (platform === 'win32') {
         return [
-            resolve(engineRoot, 'Engine', 'Build', 'BatchFiles', 'Build.bat'),
+            resolvePathForPlatform(engineRoot, ['Engine', 'Build', 'BatchFiles', 'Build.bat'], platform),
         ];
     }
     if (platform === 'darwin') {
         return [
-            resolve(engineRoot, 'Engine', 'Build', 'BatchFiles', 'Mac', 'Build.sh'),
-            resolve(engineRoot, 'Engine', 'Build', 'BatchFiles', 'Build.sh'),
+            resolvePathForPlatform(engineRoot, ['Engine', 'Build', 'BatchFiles', 'Mac', 'Build.sh'], platform),
+            resolvePathForPlatform(engineRoot, ['Engine', 'Build', 'BatchFiles', 'Build.sh'], platform),
         ];
     }
     return [
-        resolve(engineRoot, 'Engine', 'Build', 'BatchFiles', 'Linux', 'Build.sh'),
-        resolve(engineRoot, 'Engine', 'Build', 'BatchFiles', 'Build.sh'),
+        resolvePathForPlatform(engineRoot, ['Engine', 'Build', 'BatchFiles', 'Linux', 'Build.sh'], platform),
+        resolvePathForPlatform(engineRoot, ['Engine', 'Build', 'BatchFiles', 'Build.sh'], platform),
     ];
 }
-export async function resolveBuildScript(engineRoot, platform) {
+export async function resolveBuildScript(engineRoot, platform, hostPlatform = process.platform) {
     for (const candidate of getBuildScriptCandidates(engineRoot, platform)) {
         try {
-            await access(candidate, fsConstants.F_OK);
+            await access(toHostFilesystemPath(candidate, platform, hostPlatform), fsConstants.F_OK);
             return candidate;
         }
         catch {
@@ -71,26 +93,27 @@ export async function resolveBuildScript(engineRoot, platform) {
     }
     throw new Error(`Unable to locate an Unreal build script under ${engineRoot} for platform ${platform}.`);
 }
-export async function resolveEditorExecutable(engineRoot, platform, mode = 'editor') {
+export async function resolveEditorExecutable(engineRoot, platform, mode = 'editor', hostPlatform = process.platform) {
     const executableName = mode === 'commandlet'
         ? (platform === 'win32' ? 'UnrealEditor-Cmd.exe' : 'UnrealEditor-Cmd')
         : (platform === 'win32' ? 'UnrealEditor.exe' : 'UnrealEditor');
     const executable = platform === 'win32'
-        ? resolve(engineRoot, 'Engine', 'Binaries', 'Win64', executableName)
+        ? resolvePathForPlatform(engineRoot, ['Engine', 'Binaries', 'Win64', executableName], platform)
         : platform === 'darwin'
-            ? resolve(engineRoot, 'Engine', 'Binaries', 'Mac', executableName)
-            : resolve(engineRoot, 'Engine', 'Binaries', 'Linux', executableName);
-    await access(executable, fsConstants.F_OK);
+            ? resolvePathForPlatform(engineRoot, ['Engine', 'Binaries', 'Mac', executableName], platform)
+            : resolvePathForPlatform(engineRoot, ['Engine', 'Binaries', 'Linux', executableName], platform);
+    await access(toHostFilesystemPath(executable, platform, hostPlatform), fsConstants.F_OK);
     return executable;
 }
 async function defaultRunCommand(executable, args, options) {
     return await new Promise((resolveRun, rejectRun) => {
-        const invocation = resolveCommandInvocation(executable, args, process.platform, options.env ?? process.env);
+        const commandPlatform = options.platform ?? process.platform;
+        const invocation = resolveCommandInvocation(executable, args, commandPlatform, options.env ?? process.env);
         const child = spawn(invocation.executable, invocation.args, {
             cwd: options.cwd,
             env: options.env,
             shell: false,
-            windowsVerbatimArguments: isWindowsBatchScript(executable, process.platform),
+            windowsVerbatimArguments: isWindowsBatchScript(executable, commandPlatform),
             stdio: ['ignore', 'pipe', 'pipe'],
         });
         let stdout = '';
@@ -165,7 +188,7 @@ function fileName(path) {
     return lastSlash >= 0 ? normalized.slice(lastSlash + 1) : normalized;
 }
 function normalizeFilesystemPathForCommand(path, platform) {
-    return platform === 'win32' ? win32Path.normalize(path) : path;
+    return platform === 'win32' ? win32Path.normalize(toWindowsStylePath(path)) : path;
 }
 export function classifyChangedPaths(changedPaths, forceRebuild = false) {
     const reasons = new Set();
@@ -213,6 +236,7 @@ export function classifyChangedPaths(changedPaths, forceRebuild = false) {
 }
 const UHT_CACHE_PATTERN = /\.(uhtpath|uhtsettings)$/i;
 async function walkAndDeleteMatching(dir, pattern, deleted) {
+    const hostPath = getPlatformPath(process.platform);
     let entries;
     try {
         entries = await readdir(dir, { withFileTypes: true });
@@ -221,7 +245,7 @@ async function walkAndDeleteMatching(dir, pattern, deleted) {
         return;
     }
     for (const entry of entries) {
-        const fullPath = resolve(dir, entry.name);
+        const fullPath = hostPath.resolve(dir, entry.name);
         if (entry.isDirectory()) {
             await walkAndDeleteMatching(fullPath, pattern, deleted);
         }
@@ -238,7 +262,7 @@ async function walkAndDeleteMatching(dir, pattern, deleted) {
 }
 async function clearUhtCacheFiles(projectDir) {
     const deleted = [];
-    const intermediateDir = resolve(projectDir, 'Intermediate');
+    const intermediateDir = getPlatformPath(process.platform).resolve(projectDir, 'Intermediate');
     await walkAndDeleteMatching(intermediateDir, UHT_CACHE_PATTERN, deleted);
     return deleted;
 }
@@ -345,6 +369,7 @@ export class ProjectController {
         const projectPath = request.projectPath ?? this.env.UE_PROJECT_PATH;
         const target = request.target ?? this.env.UE_PROJECT_TARGET ?? this.env.UE_EDITOR_TARGET;
         const platform = parseBuildPlatform(request.platform ?? this.env.UE_BUILD_PLATFORM, this.platform);
+        const executionPlatform = inferExecutionPlatform(engineRoot, projectPath, this.platform);
         const configuration = parseConfiguration(request.configuration ?? this.env.UE_BUILD_CONFIGURATION);
         const includeOutput = request.includeOutput ?? false;
         const buildTimeoutMs = request.buildTimeoutMs ?? DEFAULT_BUILD_TIMEOUT_MS;
@@ -357,11 +382,13 @@ export class ProjectController {
         if (!target) {
             throw new Error('compile_project_code requires target or UE_PROJECT_TARGET/UE_EDITOR_TARGET');
         }
-        const buildScript = await resolveBuildScript(engineRoot, this.platform);
-        const commandProjectPath = normalizeFilesystemPathForCommand(projectPath, this.platform);
+        const buildScript = await resolveBuildScript(engineRoot, executionPlatform, this.platform);
+        const commandProjectPath = normalizeFilesystemPathForCommand(projectPath, executionPlatform);
+        const projectDir = dirnameForPlatform(projectPath, executionPlatform);
+        const hostProjectDir = toHostFilesystemPath(projectDir, executionPlatform, this.platform);
         let uhtCacheFilesDeleted;
         if (request.clearUhtCache) {
-            uhtCacheFilesDeleted = await clearUhtCacheFiles(dirname(projectPath));
+            uhtCacheFilesDeleted = await clearUhtCacheFiles(hostProjectDir);
         }
         const args = [
             target,
@@ -373,9 +400,10 @@ export class ProjectController {
         ];
         const startedAt = Date.now();
         const completed = await this.runCommand(buildScript, args, {
-            cwd: dirname(projectPath),
+            cwd: hostProjectDir,
             env: this.env,
             timeoutMs: buildTimeoutMs,
+            platform: executionPlatform,
         });
         const result = {
             success: completed.exitCode === 0,
@@ -383,7 +411,7 @@ export class ProjectController {
             strategy: 'external_build',
             engineRoot,
             projectPath,
-            projectDir: dirname(projectPath),
+            projectDir,
             target,
             platform,
             configuration,
@@ -465,25 +493,30 @@ export class ProjectController {
         const engineRoot = request.engineRoot ?? this.env.UE_ENGINE_ROOT;
         const projectPath = request.projectPath ?? this.env.UE_PROJECT_PATH;
         const diagnostics = [];
+        const executionPlatform = inferExecutionPlatform(engineRoot, projectPath, this.platform);
         if (!engineRoot) {
             throw new Error('launch_editor requires engine_root or UE_ENGINE_ROOT');
         }
         if (!projectPath) {
             throw new Error('launch_editor requires project_path or UE_PROJECT_PATH');
         }
-        const executable = await resolveEditorExecutable(engineRoot, this.platform, 'editor');
+        const executable = await resolveEditorExecutable(engineRoot, executionPlatform, 'editor', this.platform);
+        const hostExecutable = toHostFilesystemPath(executable, executionPlatform, this.platform);
         const requestedArgs = request.additionalArgs ?? [];
+        const commandProjectPath = normalizeFilesystemPathForCommand(projectPath, executionPlatform);
         const args = [
-            projectPath,
+            commandProjectPath,
             ...DEFAULT_EDITOR_LAUNCH_ARGS.filter((arg) => !requestedArgs.includes(arg)),
             ...requestedArgs,
         ];
-        const invocation = resolveCommandInvocation(executable, args, this.platform, this.env);
+        const invocation = resolveCommandInvocation(hostExecutable, args, executionPlatform, this.env);
+        const projectDir = dirnameForPlatform(projectPath, executionPlatform);
+        const hostProjectDir = toHostFilesystemPath(projectDir, executionPlatform, this.platform);
         const child = this.spawnProcess(invocation.executable, invocation.args, {
-            cwd: dirname(projectPath),
+            cwd: hostProjectDir,
             env: this.env,
             shell: false,
-            windowsVerbatimArguments: isWindowsBatchScript(executable, this.platform),
+            windowsVerbatimArguments: isWindowsBatchScript(hostExecutable, executionPlatform),
             detached: true,
             stdio: 'ignore',
         });
@@ -494,7 +527,7 @@ export class ProjectController {
             operation: 'launch_editor',
             engineRoot,
             projectPath,
-            projectDir: dirname(projectPath),
+            projectDir,
             processId: child.pid ?? undefined,
             command: {
                 executable: invocation.executable,

package/dist/register-server-tools.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import { exampleCatalog } from './catalogs/example-catalog.js';
 import { collectRelatedResources, collectToolExampleFamilies as collectToolExampleFamiliesFromCatalog, summarizeOutputSchema, summarizeSchemaFields, } from './helpers/tool-help.js';
-import { AnimMontageMutationOperationSchema, AnimationNotifySelectorSchema, AnimSequenceMutationOperationSchema, BehaviorTreeMutationOperationSchema, BehaviorTreeNodeSelectorSchema, BlackboardKeySchema, BlackboardMutationOperationSchema, BlendParameterSchema, BlendSpaceMutationOperationSchema, BlendSpaceSampleSchema, BlueprintGraphMutationOperationSchema, BlueprintMemberMutationOperationSchema, BuildConfigurationSchema, BuildPlatformSchema, CurveChannelSchema, CurveKeyDeleteSchema, CurveKeyUpsertSchema, CurveTableModeSchema, CurveTableRowSchema, CurveTypeSchema, DataTableRowSchema, ExtractAssetTypeSchema, EnhancedInputValueTypeSchema, FontImportItemSchema, ImportJobListSchema, ImportJobSchema, InputMappingSchema, JsonObjectSchema, MaterialConnectionSelectorFieldsSchema, MaterialFontParameterSchema, MaterialGraphOperationKindSchema, MaterialGraphOperationSchema, MaterialLayerStackSchema, MaterialNodePositionSchema, MaterialScalarParameterSchema, MaterialStaticSwitchParameterSchema, MaterialTextureParameterSchema, MaterialVectorParameterSchema, MeshImportOptionsSchema, StateTreeEditorNodeSelectorSchema, StateTreeMutationOperationSchema, StateTreeStateSelectorSchema, StateTreeTransitionSelectorSchema, StateTreeBindingsObjectSchema, TextureImportOptionsSchema, UserDefinedEnumEntrySchema, UserDefinedEnumMutationOperationSchema, UserDefinedStructFieldSchema, UserDefinedStructMutationOperationSchema, WidgetBlueprintMutationOperationSchema, WidgetNodeSchema, WidgetSelectorFieldsSchema, WindowFontApplicationSchema, } from './schemas/tool-inputs.js';
+import { AnimMontageMutationOperationSchema, AnimationNotifySelectorSchema, AnimSequenceMutationOperationSchema, BehaviorTreeMutationOperationSchema, BehaviorTreeNodeSelectorSchema, BlackboardKeySchema, BlackboardMutationOperationSchema, BlendParameterSchema, BlendSpaceMutationOperationSchema, BlendSpaceSampleSchema, BlueprintGraphMutationOperationSchema, BlueprintMemberMutationOperationSchema, BuildConfigurationSchema, BuildPlatformSchema, CurveChannelSchema, CurveKeyDeleteSchema, CurveKeyUpsertSchema, CurveTableModeSchema, CurveTableRowSchema, CurveTypeSchema, DataTableRowSchema, ExtractAssetTypeSchema, EnhancedInputValueTypeSchema, FontImportItemSchema, ImportJobListSchema, ImportJobSchema, InputMappingSchema, JsonObjectSchema, MaterialConnectionSelectorFieldsSchema, MaterialFontParameterSchema, MaterialGraphOperationKindSchema, MaterialGraphOperationSchema, MaterialLayerStackSchema, MaterialNodePositionSchema, MaterialScalarParameterSchema, MaterialStaticSwitchParameterSchema, MaterialTextureParameterSchema, MaterialVectorParameterSchema, MeshImportOptionsSchema, StateTreeEditorNodeSelectorSchema, StateTreeMutationOperationSchema, StateTreeStateSelectorSchema, StateTreeTransitionSelectorSchema, StateTreeBindingsObjectSchema, TextureImportOptionsSchema, UserDefinedEnumEntrySchema, UserDefinedEnumMutationOperationSchema, UserDefinedStructFieldSchema, UserDefinedStructMutationOperationSchema, WidgetNodeSchema, WidgetSelectorFieldsSchema, WindowFontApplicationSchema, } from './schemas/tool-inputs.js';
 import { applyWindowUiChangesResultSchema, AutomationRunListSchema, automationRunSchema, CaptureResultSchema, CascadeResultSchema, CleanupCapturesResultSchema, CompareCaptureResultSchema, CompareMotionCaptureBundleResultSchema, CreateModifyWidgetAnimationResultSchema, ExtractWidgetAnimationResultSchema, ListCapturesResultSchema, motionCaptureModeSchema, MotionCaptureBundleResultSchema, widgetAnimationCheckpointSchema, } from './schemas/tool-results.js';
 import { registerAnimationAuthoringTools } from './tools/animation-authoring.js';
 import { registerAnalysisTools } from './tools/analysis-tools.js';
@@ -47,7 +47,6 @@ export function registerServerTools({ server, client, projectController, automat
         server,
         callSubsystemJson,
         widgetNodeSchema: WidgetNodeSchema,
-        widgetBlueprintMutationOperationSchema: WidgetBlueprintMutationOperationSchema,
     });
     registerWidgetExtractionTools({
         server,