blueprint-extractor-mcp 8.2.2 → 8.2.4

package/dist/active-editor-session.js

@@ -80,7 +80,7 @@ export class ActiveEditorSession {
         return this.getClient(rebound).checkConnection();
     }
     async editorModeAvailable() {
-        return true;
+        return this.checkConnection();
     }
     async listRunningEditors() {
         const result = await listRegisteredEditors();

package/dist/execution/adaptive-executor.js

@@ -11,6 +11,17 @@ const EDITOR_FALLBACK_ERROR_FRAGMENTS = [
     'previously selected active editor',
     'The selected active editor is currently unavailable on its registered Remote Control endpoint.',
 ];
+const COMMANDLET_LOCK_ERROR_FRAGMENTS = [
+    'locked by another process',
+    'locked file',
+    'cannot access the file',
+    'asset lock conflict',
+    'save_failed',
+    'Failed to save one or more packages',
+];
+const EDITOR_PREFERRED_WHILE_RUNNING_TOOLS = new Set([
+    'save_assets',
+]);
 export class AdaptiveExecutor {
     editorAdapter;
     commandletAdapter;
@@ -56,7 +67,16 @@ export class AdaptiveExecutor {
     async executeRouted(editorFallback, method, params, options) {
         const toolName = this._activeToolName;
         const detection = await this.detector.detect();
-        const tryCommandletFallback = async (error, requiredCapability) => {
+        if (!toolName) {
+            return editorFallback(method, params, options);
+        }
+        const toolMode = this.getToolMode(toolName);
+        const requiredCapability = toolMode === 'read_only'
+            ? 'read'
+            : toolMode === 'both'
+                ? 'write_simple'
+                : 'write_complex';
+        const tryCommandletFallback = async (error) => {
             if (!toolName || !this.commandletAdapter || !shouldFallbackToCommandlet(error)) {
                 throw error;
             }
@@ -71,18 +91,9 @@ export class AdaptiveExecutor {
             this.detector.invalidateCache();
             return this.commandletAdapter.execute('BlueprintExtractor', method, params);
         };
-        // If no active tool context or editor mode, use the original path
-        // (preserves callSubsystemJson error-checking layer)
-        if (!toolName || detection.mode === 'editor') {
-            if (!toolName) {
-                return editorFallback(method, params, options);
-            }
-            const toolMode = this.getToolMode(toolName);
-            const requiredCapability = toolMode === 'read_only'
-                ? 'read'
-                : toolMode === 'both'
-                    ? 'write_simple'
-                    : 'write_complex';
+        // Editor mode keeps the existing direct path, with commandlet fallback for
+        // compatible tools when the editor call fails.
+        if (detection.mode === 'editor') {
             try {
                 return await editorFallback(method, params, options);
             }
@@ -90,15 +101,9 @@ export class AdaptiveExecutor {
                 if (toolMode === 'editor_only') {
                     throw error;
                 }
-                return tryCommandletFallback(error, requiredCapability);
+                return tryCommandletFallback(error);
             }
         }
-        const toolMode = this.getToolMode(toolName);
-        const requiredCapability = toolMode === 'read_only'
-            ? 'read'
-            : toolMode === 'both'
-                ? 'write_simple'
-                : 'write_complex';
         // Try commandlet for compatible tools
         if (detection.mode === 'commandlet' && this.commandletAdapter) {
             if (toolMode === 'editor_only') {
@@ -108,7 +113,36 @@ export class AdaptiveExecutor {
             if (!capabilities.has(requiredCapability) && requiredCapability !== 'write_simple') {
                 throw new ExecutorError('CAPABILITY_MISMATCH', `Tool '${toolName}' requires '${requiredCapability}' capability which commandlet mode does not support.`, toolName, detection.mode, requiredCapability);
             }
-            return this.commandletAdapter.execute('BlueprintExtractor', method, params);
+            if (shouldPreferEditorWhileRunning(toolName)) {
+                try {
+                    const editorAvailable = await this.editorAdapter.isAvailable();
+                    if (editorAvailable) {
+                        this.detector.invalidateCache();
+                        return await editorFallback(method, params, options);
+                    }
+                }
+                catch {
+                    // Fall back to the commandlet path below.
+                }
+            }
+            try {
+                return await this.commandletAdapter.execute('BlueprintExtractor', method, params);
+            }
+            catch (error) {
+                if (toolMode !== 'read_only' && shouldFallbackToEditorOnLock(error)) {
+                    try {
+                        const editorAvailable = await this.editorAdapter.isAvailable();
+                        if (editorAvailable) {
+                            this.detector.invalidateCache();
+                            return await editorFallback(method, params, options);
+                        }
+                    }
+                    catch {
+                        // If the editor is not actually reachable, preserve the commandlet error.
+                    }
+                }
+                throw error;
+            }
         }
         // No adapter available
         throw new ExecutorError('MODE_UNAVAILABLE', `No execution mode available for tool '${toolName}'. ${detection.reason}`, toolName, detection.mode, requiredCapability);
@@ -122,7 +156,6 @@ export class AdaptiveExecutor {
             : toolMode === 'both'
                 ? 'write_simple'
                 : 'write_complex';
-        // Try editor first
         if (detection.mode === 'editor') {
             return this.editorAdapter.execute(subsystem, method, params);
         }
@@ -135,7 +168,36 @@ export class AdaptiveExecutor {
             if (!capabilities.has(requiredCapability) && requiredCapability !== 'write_simple') {
                 throw new ExecutorError('CAPABILITY_MISMATCH', `Tool '${toolName}' requires '${requiredCapability}' capability which commandlet mode does not support.`, toolName, detection.mode, requiredCapability);
             }
-            return this.commandletAdapter.execute(subsystem, method, params);
+            if (shouldPreferEditorWhileRunning(toolName)) {
+                try {
+                    const editorAvailable = await this.editorAdapter.isAvailable();
+                    if (editorAvailable) {
+                        this.detector.invalidateCache();
+                        return await this.editorAdapter.execute(subsystem, method, params);
+                    }
+                }
+                catch {
+                    // Keep the commandlet path below.
+                }
+            }
+            try {
+                return await this.commandletAdapter.execute(subsystem, method, params);
+            }
+            catch (error) {
+                if (toolMode !== 'read_only' && shouldFallbackToEditorOnLock(error)) {
+                    try {
+                        const editorAvailable = await this.editorAdapter.isAvailable();
+                        if (editorAvailable) {
+                            this.detector.invalidateCache();
+                            return await this.editorAdapter.execute(subsystem, method, params);
+                        }
+                    }
+                    catch {
+                        // Preserve the original commandlet failure below.
+                    }
+                }
+                throw error;
+            }
         }
         // No adapter available
         throw new ExecutorError('MODE_UNAVAILABLE', `No execution mode available for tool '${toolName}'. ${detection.reason}`, toolName, detection.mode, requiredCapability);
@@ -148,6 +210,13 @@ function shouldFallbackToCommandlet(error) {
     }
     return EDITOR_FALLBACK_ERROR_FRAGMENTS.some((fragment) => message.includes(fragment));
 }
+function shouldFallbackToEditorOnLock(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return COMMANDLET_LOCK_ERROR_FRAGMENTS.some((fragment) => message.includes(fragment));
+}
+function shouldPreferEditorWhileRunning(toolName) {
+    return EDITOR_PREFERRED_WHILE_RUNNING_TOOLS.has(toolName);
+}
 export class ExecutorError extends Error {
     code;
     toolName;

package/dist/schemas/tool-inputs.d.ts

@@ -1859,7 +1859,7 @@ export declare const AnimSequenceMutationOperationSchema: z.ZodEnum<["replace_no
 export declare const AnimMontageMutationOperationSchema: z.ZodEnum<["replace_notifies", "patch_notify", "replace_sections", "replace_slots"]>;
 export declare const BlendSpaceMutationOperationSchema: z.ZodEnum<["replace_samples", "patch_sample", "set_axes"]>;
 export declare const BlueprintMemberMutationOperationSchema: z.ZodEnum<["replace_variables", "add_variables", "patch_variable", "replace_components", "patch_component", "add_component", "replace_function_stubs", "reparent", "patch_class_defaults", "compile"]>;
-export declare const BlueprintGraphMutationOperationSchema: z.ZodEnum<["upsert_function_graphs", "append_function_call_to_sequence", "add_animgraph_nodes", "connect_animgraph_pins", "compile"]>;
+export declare const BlueprintGraphMutationOperationSchema: z.ZodEnum<["upsert_function_graphs", "append_function_call_to_sequence", "insert_exec_nodes", "add_animgraph_nodes", "connect_animgraph_pins", "compile"]>;
 export declare const UserDefinedStructFieldSchema: z.ZodObject<{
     guid: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodString>;

package/dist/schemas/tool-inputs.js

@@ -383,6 +383,7 @@ export const BlueprintMemberMutationOperationSchema = z.enum([
 export const BlueprintGraphMutationOperationSchema = z.enum([
     'upsert_function_graphs',
     'append_function_call_to_sequence',
+    'insert_exec_nodes',
     'add_animgraph_nodes',
     'connect_animgraph_pins',
     'compile',

package/dist/server-config.js

@@ -5,8 +5,9 @@ export const serverInstructions = [
     'Blueprint Extractor MCP uses a v2 public contract with tool profiles, workflow-scoped tool surfaces, snake_case arguments, prompt workflows, and structured JSON results.',
     // Tool discovery
     'Use activate_tool_profile with profile: "default" for the compact scoped surface or profile: "expert" for the full flat tool list. Clients with tool-list change support start in default; fallback clients start in expert.',
-    'A compact core tool set is visible in the default profile. Use activate_workflow_scope to load specialized tool families: widget_authoring (or sub-scopes: widget_authoring_structure, widget_authoring_visual, widget_verification), material_authoring, blueprint_authoring, schema_ai_authoring, animation_authoring, data_tables, import, project_control, automation_testing, verification, analysis, and project_intelligence.',
-    'Use find_and_extract for search+extract in one call from the default core surface. Use search_assets when you only need to locate assets.',
+    'A compact retrieval-first core tool set is visible in the default profile: search_assets, find_and_extract, extract_blueprint, extract_asset, check_asset_exists, save_assets, get_tool_help, and the profile/scope switches.',
+    'Use activate_workflow_scope to load specialized tool families: widget_authoring (or sub-scopes: widget_authoring_structure, widget_authoring_visual, widget_verification), material_authoring, blueprint_authoring, schema_ai_authoring, animation_authoring, data_tables, import, project_control, automation_testing, verification, analysis, and project_intelligence.',
+    'Prefer find_and_extract for search plus routed extraction from the default core surface. Use search_assets when you only need to locate assets.',
     'Call get_tool_help before the first use of a complex or polymorphic tool when you need operation-specific payload guidance. Use activate_workflow_scope explicitly when the tool family is not in the current profile.',
     // Deferred tool directory (tools available via activate_workflow_scope)
     'Deferred tool families — widget_authoring_structure: recipe-first widget authoring, tree replacement, diff/patch DSLs, and focused structural edits. widget_authoring_visual: CommonUI styles, widget animations, compile_widget, extraction, and preview capture. widget_verification: captures and comparisons. widget_authoring: activates all three widget sub-scopes. material_authoring: create_material_setup, modify_material DSL/batch authoring, material_graph_operation, and material instances. blueprint_authoring: scaffold_blueprint, modify_blueprint_graphs DSL authoring, member edits, and Live Coding trigger. schema_ai_authoring: structs, enums, blackboards, behavior trees, state trees. animation_authoring: anim sequences, montages, blend spaces, widget animations. data_tables: data assets, input actions, tables, curves. import: import_assets, job tracking. project_control: editor-session binding, launch/wait, project automation context, Output Log and Message Log inspection, PIE lifecycle control, host build/restart/sync flows, and apply_window_ui_changes. automation_testing: run/get/list automation tests. verification: widget captures, editor screenshots, runtime screenshots, and comparisons. analysis: deterministic Blueprint review and asset audits. project_intelligence: editor context, project indexing, and metadata-first context search.',

package/dist/tool-surface-manager.d.ts

@@ -8,6 +8,10 @@ export interface WorkflowScope {
     description: string;
 }
 export declare const WORKFLOW_SCOPE_IDS: readonly WorkflowScopeId[];
+/**
+ * Keep the always-visible default surface small so weaker models can route
+ * through search, routed extraction, and explicit help before expanding.
+ */
 export declare const CORE_TOOLS: ReadonlySet<string>;
 export declare class ToolSurfaceManager {
     private registeredToolMap;

package/dist/tool-surface-manager.js

@@ -15,14 +15,15 @@ export const WORKFLOW_SCOPE_IDS = [
     'analysis',
     'project_intelligence',
 ];
+/**
+ * Keep the always-visible default surface small so weaker models can route
+ * through search, routed extraction, and explicit help before expanding.
+ */
 export const CORE_TOOLS = new Set([
     'search_assets',
     'find_and_extract',
     'extract_blueprint',
     'extract_asset',
-    'extract_material',
-    'extract_cascade',
-    'list_assets',
     'check_asset_exists',
     'save_assets',
     'get_tool_help',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blueprint-extractor-mcp",
-  "version": "8.2.2",
+  "version": "8.2.4",
   "description": "MCP server for the Unreal Engine BlueprintExtractor plugin over Remote Control",
   "type": "module",
   "main": "dist/index.js",