@hybridlabor-api/aos 4.2.0 → 4.4.0

package/mcps/unreal_mcp/tests/mcp-tools/core/manage-blueprint.test.mjs

@@ -1,331 +0,0 @@
-#!/usr/bin/env node
-/**
- * manage_blueprint Tool Integration Tests
- * Covers all 36 actions with proper setup/teardown sequencing.
- *
- * Every action that operates on a blueprint must include a valid
- * blueprintPath pointing to the blueprint created during setup.
- *
- * captureResult is used to capture real nodeIds from node creation
- * so that subsequent node operations (delete, connect, etc.) use
- * real GUIDs that exist in the blueprint graph.
- */
-
-import { runToolTests } from '../../test-runner.mjs';
-
-const TEST_FOLDER = '/Game/MCPTest/AuthoringAssets';
-const ts = Date.now();
-const BP_NAME = `BP_Test_${ts}`;
-const BP_PATH = `${TEST_FOLDER}/${BP_NAME}`;
-const INPUT_ACTION_NAME = `IA_Blueprint_${ts}`;
-const INPUT_ACTION_PATH = `${TEST_FOLDER}/${INPUT_ACTION_NAME}`;
-const ENGINE_CUBE_MESH = '/Engine/BasicShapes/Cube.Cube';
-const ENGINE_BASIC_MATERIAL = '/Engine/BasicShapes/BasicShapeMaterial.BasicShapeMaterial';
-const ENGINE_DEFAULT_TEXTURE = '/Engine/EngineResources/DefaultTexture.DefaultTexture';
-
-const testCases = [
-  // === SETUP ===
-  { scenario: 'Setup: create test folder', toolName: 'manage_asset', arguments: { action: 'create_folder', path: TEST_FOLDER }, expected: 'success|already exists' },
-  { scenario: 'Setup: create test blueprint', toolName: 'manage_blueprint', arguments: { action: 'create_blueprint', name: BP_NAME, path: TEST_FOLDER, parentClass: 'Actor' }, expected: 'success|already exists', assertions: [{ path: 'structuredContent.result.assetPath', equals: BP_PATH, label: 'create_blueprint path alias uses requested folder' }] },
-  { scenario: 'Setup: create input action asset', toolName: 'manage_networking', arguments: { action: 'create_input_action', name: INPUT_ACTION_NAME, path: TEST_FOLDER }, expected: 'success|already exists' },
-
-  // === ACTION: create (requires name + path/blueprintPath) ===
-  { scenario: 'ACTION: create', toolName: 'manage_blueprint', arguments: { action: 'create', name: `BP_Create_${ts}`, savePath: TEST_FOLDER, blueprintType: 'Actor', properties: { bReplicates: true } }, expected: 'success|already exists' },
-
-  // === INFO: get_blueprint (uses blueprintPath) ===
-  { scenario: 'INFO: get_blueprint', toolName: 'manage_blueprint', arguments: { action: 'get_blueprint', blueprintPath: BP_PATH }, expected: 'success' },
-
-  // === ACTION: get (uses blueprintPath via name fallback) ===
-  { scenario: 'ACTION: get', toolName: 'manage_blueprint', arguments: { action: 'get', blueprintPath: BP_PATH, timeoutMs: 5000 }, expected: 'success' },
-
-  // === ACTION: compile (uses blueprintPath) ===
-  { scenario: 'ACTION: compile', toolName: 'manage_blueprint', arguments: { action: 'compile', blueprintPath: BP_PATH, saveAfterCompile: false }, expected: 'success' },
-
-  // === ADD: add_component (blueprintPath + componentClass + componentName) ===
-  { scenario: 'ADD: add_component', toolName: 'manage_blueprint', arguments: { action: 'add_component', blueprintPath: BP_PATH, componentType: 'PointLightComponent', componentName: 'TestLight', attachTo: 'DefaultSceneRoot' }, expected: 'success|already exists' },
-
-// === CONFIG: set_default (blueprintPath + propertyName + value/propertyValue) ===
-// bGenerateOverlapEvents is on UPrimitiveComponent; this Actor BP root is SceneComponent.
-// Use a property that exists on AActor CDO directly.
-{ scenario: 'CONFIG: set_default', toolName: 'manage_blueprint', arguments: { action: 'set_default', blueprintPath: BP_PATH, propertyName: 'bReplicates', propertyValue: true }, expected: 'success' },
-
-  // === CONFIG: modify_scs (blueprintPath + operations) ===
-  { scenario: 'CONFIG: modify_scs', toolName: 'manage_blueprint', arguments: { action: 'modify_scs', blueprintPath: BP_PATH, operations: [{ type: 'add_component', componentName: 'TestModSCSComp', componentClass: 'SceneComponent' }], applyAndSave: true }, expected: 'success|already exists' },
-
-  // === INFO: get_scs (blueprintPath) ===
-  { scenario: 'INFO: get_scs', toolName: 'manage_blueprint', arguments: { action: 'get_scs', blueprintPath: BP_PATH }, expected: 'success' },
-
-  // === ADD: add_scs_component (blueprint_path + component_class + component_name) ===
-  { scenario: 'ADD: add_scs_component', toolName: 'manage_blueprint', arguments: { action: 'add_scs_component', blueprintPath: BP_PATH, componentClass: 'PointLightComponent', componentName: 'TestSCSComp', parentComponent: 'DefaultSceneRoot' }, expected: 'success|already exists' },
-
-  // === ADD: add_scs_component with mesh/material assignment ===
-  { scenario: 'ADD: add_scs_component with mesh material', toolName: 'manage_blueprint', arguments: { action: 'add_scs_component', blueprintPath: BP_PATH, componentClass: 'StaticMeshComponent', componentName: 'TestStaticMeshSCSComp', parentComponent: 'DefaultSceneRoot', meshPath: ENGINE_CUBE_MESH, materialPath: ENGINE_BASIC_MATERIAL }, expected: 'success|already exists', assertions: [{ path: 'structuredContent.result.mesh_applied', equals: true, label: 'SCS static mesh assignment applied' }, { path: 'structuredContent.result.material_applied', equals: true, label: 'SCS material assignment applied' }] },
-
-  // === DELETE: remove_scs_component (blueprintPath + componentName) ===
-  { scenario: 'DELETE: remove_scs_component', toolName: 'manage_blueprint', arguments: { action: 'remove_scs_component', blueprintPath: BP_PATH, componentName: 'TestSCSComp' }, expected: 'success|not found' },
-  { scenario: 'DELETE: remove_scs_static_mesh_component', toolName: 'manage_blueprint', arguments: { action: 'remove_scs_component', blueprintPath: BP_PATH, componentName: 'TestStaticMeshSCSComp' }, expected: 'success|not found' },
-
-  // === ACTION: reparent_scs_component (blueprintPath + componentName + newParent) ===
-  { scenario: 'ACTION: reparent_scs_component', toolName: 'manage_blueprint', arguments: { action: 'reparent_scs_component', blueprintPath: BP_PATH, componentName: 'TestModSCSComp', newParent: 'DefaultSceneRoot' }, expected: 'success' },
-
-  // === CONFIG: set_scs_transform (blueprintPath + componentName + location/rotation/scale) ===
-  { scenario: 'CONFIG: set_scs_transform', toolName: 'manage_blueprint', arguments: { action: 'set_scs_transform', blueprintPath: BP_PATH, componentName: 'TestModSCSComp', location: { x: 100, y: 0, z: 50 }, rotation: { pitch: 0, yaw: 45, roll: 0 }, scale: { x: 1.1, y: 1.1, z: 1.1 } }, expected: 'success' },
-
-  // === CONFIG: set_scs_property (blueprintPath + componentName + propertyName + propertyValue) ===
-  // C++ ApplyJsonValueToProperty supports struct (FVector) via array format [x, y, z].
-  { scenario: 'CONFIG: set_scs_property', toolName: 'manage_blueprint', arguments: { action: 'set_scs_property', blueprintPath: BP_PATH, componentName: 'TestModSCSComp', propertyName: 'RelativeLocation', propertyValue: [100, 0, 50] }, expected: 'success' },
-
-  // === ACTION: ensure_exists (blueprintPath) ===
-  { scenario: 'ACTION: ensure_exists', toolName: 'manage_blueprint', arguments: { action: 'ensure_exists', blueprintPath: BP_PATH }, expected: 'success' },
-
-  // === ACTION: probe_handle (no blueprint needed - uses componentClass) ===
-  { scenario: 'ACTION: probe_handle', toolName: 'manage_blueprint', arguments: { action: 'probe_handle', componentClass: 'StaticMeshComponent' }, expected: 'success', assertions: [{ path: 'structuredContent.result.hasHandles', equals: true, label: 'probe_handle gathered real handles' }] },
-
-  // === ADD: add_variable (blueprintPath + variableName + variableType) ===
-  // This variable will be renamed in the next step — do NOT delete it before rename.
-  { scenario: 'ADD: add_variable', toolName: 'manage_blueprint', arguments: { action: 'add_variable', blueprintPath: BP_PATH, variableName: 'TestVariable', variableType: 'Boolean', category: 'MCP', isReplicated: true, isPublic: true }, expected: 'success|already exists' },
-
-  // === ACTION: rename_variable (blueprintPath + oldName + newName) ===
-  // Renames the variable added above (NOT deleted).
-  { scenario: 'ACTION: rename_variable', toolName: 'manage_blueprint', arguments: { action: 'rename_variable', blueprintPath: BP_PATH, oldName: 'TestVariable', newName: 'RenamedVariable' }, expected: 'success' },
-
-  // === CONFIG: set_variable_metadata (blueprintPath + variableName + metadata) ===
-  // Operates on the RENAMED variable from the previous step.
-  { scenario: 'CONFIG: set_variable_metadata', toolName: 'manage_blueprint', arguments: { action: 'set_variable_metadata', blueprintPath: BP_PATH, variableName: 'RenamedVariable', metadata: { tooltip: 'Test variable tooltip' } }, expected: 'success' },
-
-  // === DELETE: remove_variable (blueprintPath + variableName) ===
-  // Now remove the renamed variable after metadata was set.
-  { scenario: 'DELETE: remove_variable', toolName: 'manage_blueprint', arguments: { action: 'remove_variable', blueprintPath: BP_PATH, variableName: 'RenamedVariable' }, expected: 'success|not found' },
-
-  // === ADD: add_function (blueprintPath + functionName) ===
-  { scenario: 'ADD: add_function', toolName: 'manage_blueprint', arguments: { action: 'add_function', blueprintPath: BP_PATH, memberName: 'TestFunction', inputs: [{ name: 'InputValue', type: 'Float' }], outputs: [{ name: 'ReturnValue', type: 'Float' }], isPublic: true }, expected: 'success|already exists' },
-
-  // === ADD: add_event (blueprintPath + eventType) ===
-  { scenario: 'ADD: add_event', toolName: 'manage_blueprint', arguments: { action: 'add_event', blueprintPath: BP_PATH, eventType: 'Custom', customEventName: 'TestEvent', parameters: [{ name: 'Payload', type: 'String' }] }, expected: 'success|already exists' },
-
-  // === DELETE: remove_event (blueprintPath + eventName) ===
-  { scenario: 'DELETE: remove_event', toolName: 'manage_blueprint', arguments: { action: 'remove_event', blueprintPath: BP_PATH, eventName: 'TestEvent' }, expected: 'success|not found' },
-
-  // === ADD: add_construction_script (blueprintPath) ===
-  { scenario: 'ADD: add_construction_script', toolName: 'manage_blueprint', arguments: { action: 'add_construction_script', blueprintPath: BP_PATH }, expected: 'success|already exists' },
-
-  // === CONFIG: set_metadata (assetPath/blueprintPath + metadata) ===
-  { scenario: 'CONFIG: set_metadata', toolName: 'manage_blueprint', arguments: { action: 'set_metadata', blueprintPath: BP_PATH, metadata: { comment: 'Test metadata' } }, expected: 'success' },
-
-  // === CREATE: create_node (blueprintPath as assetPath + nodeType + graphName) ===
-  // Capture the nodeId for use in subsequent node operations.
-  { scenario: 'CREATE: create_node', toolName: 'manage_blueprint', arguments: { action: 'create_node', blueprintPath: BP_PATH, nodeType: 'Sequence', graphName: 'EventGraph', posX: -240, posY: 120 }, expected: 'success|already exists', captureResult: { key: 'seqNodeId', fromField: 'nodeId' } },
-
-  // === CREATE: create_node variants with specialized metadata ===
-  { scenario: 'CREATE: create_node call function metadata', toolName: 'manage_blueprint', arguments: { action: 'create_node', blueprintPath: BP_PATH, nodeType: 'CallFunction', memberName: 'PrintString', memberClass: 'KismetSystemLibrary', graphName: 'EventGraph', posX: -40, posY: 120 }, expected: 'success|already exists' },
-  { scenario: 'CREATE: create_node cast target class', toolName: 'manage_blueprint', arguments: { action: 'create_node', blueprintPath: BP_PATH, nodeType: 'Cast', targetClass: 'Actor', graphName: 'EventGraph', posX: 160, posY: 120 }, expected: 'success|already exists' },
-  { scenario: 'CREATE: create_node input axis event', toolName: 'manage_blueprint', arguments: { action: 'create_node', blueprintPath: BP_PATH, nodeType: 'InputAxisEvent', inputAxisName: 'MoveForward', graphName: 'EventGraph', posX: 360, posY: 120 }, expected: 'success|already exists' },
-  { scenario: 'CREATE: create_node enhanced input actionPath', toolName: 'manage_blueprint', arguments: { action: 'create_node', blueprintPath: BP_PATH, nodeType: 'K2Node_EnhancedInputAction', actionPath: INPUT_ACTION_PATH, graphName: 'EventGraph', posX: 560, posY: 120 }, expected: 'success|already exists' },
-  { scenario: 'CREATE: create_node enhanced input inputActionPath', toolName: 'manage_blueprint', arguments: { action: 'create_node', blueprintPath: BP_PATH, nodeType: 'K2Node_EnhancedInputAction', inputActionPath: INPUT_ACTION_PATH, graphName: 'EventGraph', posX: 760, posY: 120 }, expected: 'success|already exists' },
-  { scenario: 'CREATE: create_node enhanced input inputActionAssetPath', toolName: 'manage_blueprint', arguments: { action: 'create_node', blueprintPath: BP_PATH, nodeType: 'K2Node_EnhancedInputAction', inputActionAssetPath: INPUT_ACTION_PATH, graphName: 'EventGraph', posX: 960, posY: 120 }, expected: 'success|already exists' },
-
-  // === ADD: add_node (blueprintPath as assetPath + nodeType + nodeName) ===
-  // Capture a real PrintString node for connect/default/delete operations.
-  { scenario: 'ADD: add_node', toolName: 'manage_blueprint', arguments: { action: 'add_node', blueprintPath: BP_PATH, nodeType: 'PrintString', functionName: 'PrintString', nodeName: 'TestPrintNode', graphName: 'EventGraph' }, expected: 'success|already exists', captureResult: { key: 'printNodeId', fromField: 'nodeId' } },
-
-  // === CONNECT: connect_pins (blueprintPath + sourceNode/targetNode + sourcePin/targetPin) ===
-  // Uses real nodeIds captured from node creation. Sequence output pins are then_0/then_1.
-  { scenario: 'CONNECT: connect_pins', toolName: 'manage_blueprint', arguments: { action: 'connect_pins', blueprintPath: BP_PATH, sourceNode: '${captured:seqNodeId}', targetNode: '${captured:printNodeId}', sourcePin: 'then_0', targetPin: 'execute', graphName: 'EventGraph' }, expected: 'success' },
-
-  // === VERIFY: connected pin state ===
-  { scenario: 'VERIFY: connected pin state', toolName: 'manage_blueprint', arguments: { action: 'get_pin_details', blueprintPath: BP_PATH, nodeGuid: '${captured:seqNodeId}', pinName: 'then_0', graphName: 'EventGraph' }, expected: 'success', assertions: [{ path: 'structuredContent.result.pins', includesObject: { pinName: 'then_0', linkedTo: { length: 1 } }, label: 'then_0 has one real graph link after connect_pins' }] },
-
-  // === ACTION: break_pin_links (blueprintPath + nodeGuid + pinName) ===
-  // Uses the real Sequence output pin that was just connected.
-  { scenario: 'ACTION: break_pin_links', toolName: 'manage_blueprint', arguments: { action: 'break_pin_links', blueprintPath: BP_PATH, nodeGuid: '${captured:seqNodeId}', pinName: 'then_0', graphName: 'EventGraph' }, expected: 'success' },
-
-  // === CONNECT: connect_pins using native field names ===
-  { scenario: 'CONNECT: connect_pins via native fields', toolName: 'manage_blueprint', arguments: { action: 'connect_pins', blueprintPath: BP_PATH, fromNodeId: '${captured:seqNodeId}', fromPinName: 'then_0', toNodeId: '${captured:printNodeId}', toPinName: 'execute', graphName: 'EventGraph' }, expected: 'success' },
-
-  // === VERIFY: native-field connected pin state ===
-  { scenario: 'VERIFY: native-field connected pin state', toolName: 'manage_blueprint', arguments: { action: 'get_pin_details', blueprintPath: BP_PATH, nodeId: '${captured:seqNodeId}', pinName: 'then_0', graphName: 'EventGraph' }, expected: 'success', assertions: [{ path: 'structuredContent.result.pins', includesObject: { pinName: 'then_0', linkedTo: { length: 1 } }, label: 'then_0 has one real graph link after native-field connect_pins' }] },
-
-  // === ACTION: break_pin_links via nodeId alias ===
-  { scenario: 'ACTION: break_pin_links via nodeId', toolName: 'manage_blueprint', arguments: { action: 'break_pin_links', blueprintPath: BP_PATH, nodeId: '${captured:seqNodeId}', pinName: 'then_0', graphName: 'EventGraph' }, expected: 'success' },
-
-  // === CONNECT: connect_pins using linkedTo alias ===
-  { scenario: 'CONNECT: connect_pins via linkedTo', toolName: 'manage_blueprint', arguments: { action: 'connect_pins', blueprintPath: BP_PATH, nodeId: '${captured:seqNodeId}', pinName: 'then_0', linkedTo: '${captured:printNodeId}.execute', graphName: 'EventGraph' }, expected: 'success' },
-
-  // === ACTION: break_pin_links after linkedTo connect ===
-  { scenario: 'ACTION: break_pin_links after linkedTo connect', toolName: 'manage_blueprint', arguments: { action: 'break_pin_links', blueprintPath: BP_PATH, nodeId: '${captured:seqNodeId}', pinName: 'then_0', graphName: 'EventGraph' }, expected: 'success' },
-
-  // === CONFIG: set_node_property (blueprintPath + nodeGuid + propertyName + propertyValue) ===
-  // Uses the real nodeId captured from the first Sequence node.
-  { scenario: 'CONFIG: set_node_property', toolName: 'manage_blueprint', arguments: { action: 'set_node_property', blueprintPath: BP_PATH, nodeGuid: '${captured:seqNodeId}', propertyName: 'Comment', propertyValue: 'Test comment', graphName: 'EventGraph' }, expected: 'success' },
-
-  // === CREATE: create_reroute_node (blueprintPath + graphName) ===
-  { scenario: 'CREATE: create_reroute_node', toolName: 'manage_blueprint', arguments: { action: 'create_reroute_node', blueprintPath: BP_PATH, graphName: 'EventGraph' }, expected: 'success|already exists', captureResult: { key: 'rerouteNodeId', fromField: 'nodeId' } },
-
-  // === INFO: get_node_details (blueprintPath + nodeGuid + graphName) ===
-  // Uses the real PrintString input data pin.
-  { scenario: 'INFO: get_node_details', toolName: 'manage_blueprint', arguments: { action: 'get_node_details', blueprintPath: BP_PATH, nodeGuid: '${captured:seqNodeId}', graphName: 'EventGraph' }, expected: 'success' },
-
-  // === INFO: get_graph_details (blueprintPath + graphName) ===
-  { scenario: 'INFO: get_graph_details', toolName: 'manage_blueprint', arguments: { action: 'get_graph_details', blueprintPath: BP_PATH, graphName: 'EventGraph' }, expected: 'success' },
-
-  // === INFO: get_pin_details (blueprintPath + nodeGuid + graphName) ===
-  // Uses the real nodeId captured from the first Sequence node.
-  { scenario: 'INFO: get_pin_details', toolName: 'manage_blueprint', arguments: { action: 'get_pin_details', blueprintPath: BP_PATH, nodeGuid: '${captured:seqNodeId}', graphName: 'EventGraph' }, expected: 'success', assertions: [{ path: 'structuredContent.result.pins', includesObject: { pinName: 'then_0', linkedTo: { length: 0 } }, label: 'then_0 links are removed after break_pin_links' }] },
-
-  // === INFO: list_node_types (no blueprint needed) ===
-  { scenario: 'INFO: list_node_types', toolName: 'manage_blueprint', arguments: { action: 'list_node_types' }, expected: 'success' },
-
-  // === CONFIG: set_pin_default_value (blueprintPath + nodeGuid + pinName + value) ===
-  // Uses the real nodeId captured from the first Sequence node.
-  { scenario: 'CONFIG: set_pin_default_value', toolName: 'manage_blueprint', arguments: { action: 'set_pin_default_value', blueprintPath: BP_PATH, nodeGuid: '${captured:printNodeId}', pinName: 'InString', defaultValue: 'test', graphName: 'EventGraph' }, expected: 'success', assertions: [{ path: 'structuredContent.value', equals: 'test', label: 'set_pin_default_value returns applied value' }] },
-
-  // === VERIFY: pin default persisted on PrintString node ===
-  { scenario: 'VERIFY: pin default persisted', toolName: 'manage_blueprint', arguments: { action: 'get_pin_details', blueprintPath: BP_PATH, nodeGuid: '${captured:printNodeId}', pinName: 'InString', graphName: 'EventGraph' }, expected: 'success', assertions: [{ path: 'structuredContent.result.pins', includesObject: { pinName: 'InString', defaultValue: 'test' }, label: 'PrintString InString pin default is persisted' }] },
-
-  // === DELETE: delete_node (blueprintPath + nodeGuid) ===
-  // Delete the PrintString node after all pin operations have used it.
-  { scenario: 'DELETE: delete_node', toolName: 'manage_blueprint', arguments: { action: 'delete_node', blueprintPath: BP_PATH, nodeGuid: '${captured:printNodeId}', graphName: 'EventGraph' }, expected: 'success' },
-
-  // === CLEANUP ===
-  { scenario: 'Cleanup: delete test blueprint', toolName: 'manage_asset', arguments: { action: 'delete', path: BP_PATH, force: true }, expected: 'success|not found' },
-  { scenario: 'Cleanup: delete test folder', toolName: 'manage_asset', arguments: { action: 'delete', path: TEST_FOLDER, force: true }, expected: 'success|not found' },
-];
-
-// === WIDGET AUTHORING ACTIONS ===
-{
-  const TEST_FOLDER = '/Game/MCPTest/AuthoringAssets';
-  const ts = Date.now();
-  const WIDGET_NAME = `WBP_WidgetAuthoring_${ts}`;
-  const CREATED_WIDGET_PATH = '${captured:widgetPath}';
-  const ANIMATION_NAME = `IntroFade_${ts}`;
-
-  const widgetArgs = (action, extra = {}) => ({ action, widgetPath: CREATED_WIDGET_PATH, ...extra });
-  const createTemplateArgs = (action, name, extra = {}) => ({ action, name: `${name}_${ts}`, folder: TEST_FOLDER, ...extra });
-
-  const addWidgetCases = [
-    ['ADD: add_horizontal_box', 'add_horizontal_box', 'MainHorizontalBox'],
-    ['ADD: add_vertical_box', 'add_vertical_box', 'MainVerticalBox'],
-    ['ADD: add_overlay', 'add_overlay', 'MainOverlay'],
-    ['ADD: add_grid_panel', 'add_grid_panel', 'InventoryGrid', { columnCount: 2, rowCount: 2 }],
-    ['ADD: add_uniform_grid', 'add_uniform_grid', 'UniformGrid', { slotPadding: { left: 4, top: 4, right: 4, bottom: 4 }, minDesiredSlotWidth: 32, minDesiredSlotHeight: 32 }],
-    ['ADD: add_wrap_box', 'add_wrap_box', 'TagWrap', { innerSlotPadding: { left: 2, top: 2, right: 2, bottom: 2 }, wrapWidth: 256, explicitWrapWidth: true }],
-    ['ADD: add_scroll_box', 'add_scroll_box', 'OptionsScroll', { orientation: 'Vertical', scrollBarVisibility: 'Visible', alwaysShowScrollbar: true }],
-    ['ADD: add_size_box', 'add_size_box', 'SizedPanel', { widthOverride: 300, heightOverride: 120, minDesiredWidth: 200, minDesiredHeight: 80 }],
-    ['ADD: add_scale_box', 'add_scale_box', 'ScaledPanel', { stretch: 'UserSpecified', stretchDirection: 'Both', userSpecifiedScale: 0.85 }],
-    ['ADD: add_border', 'add_border', 'FramedBorder', { brushColor: { r: 0.1, g: 0.2, b: 0.8, a: 1 } }],
-    ['ADD: add_text_block', 'add_text_block', 'TitleText', { text: 'Widget Authoring Test', fontSize: 24, colorAndOpacity: { r: 1, g: 0.9, b: 0.6, a: 1 }, autoWrap: true }],
-    ['ADD: add_rich_text_block', 'add_rich_text_block', 'RichBodyText', { text: '<Rich>Body</>' }],
-    ['ADD: add_image', 'add_image', 'LogoImage', { texturePath: ENGINE_DEFAULT_TEXTURE, brushSize: { x: 64, y: 64 } }],
-    ['ADD: add_button', 'add_button', 'PlayButton', { isEnabled: true }],
-    ['ADD: add_check_box', 'add_check_box', 'OptionCheckBox', { isChecked: true }],
-    ['ADD: add_slider', 'add_slider', 'VolumeSlider', { value: 0.5, minValue: 0, maxValue: 1, stepSize: 0.1 }],
-    ['ADD: add_progress_bar', 'add_progress_bar', 'LoadingProgress', { percent: 0.75, fillColorAndOpacity: { r: 0.2, g: 0.8, b: 0.3, a: 1 }, isMarquee: false }],
-    ['ADD: add_text_input', 'add_text_input', 'NameInput', { hintText: 'Name', inputType: 'single' }],
-    ['ADD: add_combo_box', 'add_combo_box', 'QualityCombo', { options: ['Low', 'High'], selectedOption: 'High' }],
-    ['ADD: add_spin_box', 'add_spin_box', 'AmountSpinBox', { value: 5, minValue: 0, maxValue: 10, delta: 0.5 }],
-    ['ADD: add_list_view', 'add_list_view', 'InventoryList'],
-    ['ADD: add_tree_view', 'add_tree_view', 'QuestTree'],
-  ].map(([scenario, action, slotName, extra = {}]) => ({
-    scenario,
-    toolName: 'manage_blueprint',
-    arguments: widgetArgs(action, { slotName, parentSlot: 'RootCanvas', ...extra }),
-    expected: 'success|already exists',
-  }));
-
-  const layoutCases = [
-    ['CONFIG: set_anchor', 'set_anchor', { preset: 'TopCenter', anchorMin: { x: 0.5, y: 0 }, anchorMax: { x: 0.5, y: 0 } }],
-    ['CONFIG: set_alignment', 'set_alignment', { alignment: { x: 0.5, y: 0 } }],
-    ['CONFIG: set_position', 'set_position', { position: { x: 80, y: 40 } }],
-    ['CONFIG: set_size', 'set_size', { size: { x: 420, y: 72 } }],
-    ['CONFIG: set_padding', 'set_padding', { padding: { left: 8, top: 8, right: 8, bottom: 8 } }],
-    ['CONFIG: set_z_order', 'set_z_order', { zOrder: 10 }],
-    ['CONFIG: set_render_transform', 'set_render_transform', { translation: { x: 4, y: 2 }, scale: { x: 1, y: 1 }, shear: { x: 0.05, y: 0 }, angle: 0 }],
-    ['CONFIG: set_visibility', 'set_visibility', { visibility: 'Visible' }],
-    ['CONFIG: set_style', 'set_style', { propertyName: 'RenderOpacity', value: '0.9' }],
-    ['CONFIG: set_clipping', 'set_clipping', { clipping: 'Inherit' }],
-  ].map(([scenario, action, extra]) => ({
-    scenario,
-    toolName: 'manage_blueprint',
-    arguments: widgetArgs(action, { slotName: 'TitleText', ...extra }),
-    expected: 'success',
-  }));
-
-  const bindingCases = [
-    ['CREATE: create_property_binding', 'create_property_binding', 'TitleText', { propertyName: 'Text', functionName: 'GetTitleText' }],
-    ['CONNECT: bind_text', 'bind_text', 'TitleText', { bindingSource: 'GetTitleText' }],
-    ['CONNECT: bind_visibility', 'bind_visibility', 'TitleText', { bindingSource: 'GetTitleVisibility' }],
-    ['CONNECT: bind_color', 'bind_color', 'TitleText', { bindingSource: 'GetTitleColor' }],
-    ['CONNECT: bind_enabled', 'bind_enabled', 'PlayButton', { bindingSource: 'CanPlay' }],
-    ['CONNECT: bind_on_clicked', 'bind_on_clicked', 'PlayButton', { functionName: 'HandlePlayClicked' }],
-    ['CONNECT: bind_on_hovered', 'bind_on_hovered', 'PlayButton', { onHoveredFunction: 'HandlePlayHovered', onUnhoveredFunction: 'HandlePlayUnhovered' }],
-    ['CONNECT: bind_on_value_changed', 'bind_on_value_changed', 'VolumeSlider', { functionName: 'HandleVolumeChanged' }],
-  ].map(([scenario, action, slotName, extra]) => ({
-    scenario,
-    toolName: 'manage_blueprint',
-    arguments: widgetArgs(action, { slotName, ...extra }),
-    expected: 'success',
-  }));
-
-  const hudElementCases = [
-    ['ADD: add_health_bar', 'add_health_bar', { parentName: 'HUDCanvas', x: 20, y: 20, width: 240, height: 28 }],
-    ['ADD: add_ammo_counter', 'add_ammo_counter', { parentName: 'HUDCanvas' }],
-    ['ADD: add_minimap', 'add_minimap', { parentName: 'HUDCanvas', size: 160 }],
-    ['ADD: add_crosshair', 'add_crosshair', { parentName: 'HUDCanvas', size: 32 }],
-    ['ADD: add_compass', 'add_compass', { parentName: 'HUDCanvas' }],
-    ['ADD: add_interaction_prompt', 'add_interaction_prompt', { parentName: 'HUDCanvas', promptFormat: 'Press E' }],
-    ['ADD: add_objective_tracker', 'add_objective_tracker', { parentName: 'HUDCanvas', maxVisibleObjectives: 3 }],
-    ['ADD: add_damage_indicator', 'add_damage_indicator', { parentName: 'HUDCanvas', fadeTime: 1.0 }],
-  ].map(([scenario, action, extra]) => ({
-    scenario,
-    toolName: 'manage_blueprint',
-    arguments: widgetArgs(action, extra),
-    expected: 'success|already exists',
-  }));
-
-  testCases.push(
-    // === SETUP ===
-    { scenario: 'Setup: clear stale widget test folder', toolName: 'manage_asset', arguments: { action: 'delete', path: TEST_FOLDER, force: true }, expected: 'success|ASSET_NOT_FOUND|not found' },
-    { scenario: 'Setup: create test folder', toolName: 'manage_asset', arguments: { action: 'create_folder', path: TEST_FOLDER }, expected: 'success|already exists' },
-    { scenario: 'Setup: create test widget blueprint', toolName: 'manage_blueprint', arguments: { action: 'create_widget_blueprint', name: WIDGET_NAME, path: TEST_FOLDER, parentClass: 'UserWidget' }, expected: 'success', assertions: [{ path: 'structuredContent.result.compileSucceeded', equals: true, label: 'created widget blueprint compiles before reuse' }, { path: 'structuredContent.result.saveSucceeded', equals: true, label: 'created widget blueprint saves before reuse' }], captureResult: { key: 'widgetPath', fromField: 'result.widgetPath' } },
-
-    // === CREATE ===
-    { scenario: 'CREATE: create_widget_blueprint', toolName: 'manage_blueprint', arguments: { action: 'create_widget_blueprint', name: `WBP_CreateWidget_${ts}`, path: TEST_FOLDER, parentClass: 'UserWidget' }, expected: 'success|already exists' },
-    { scenario: 'CONFIG: set_widget_parent_class', toolName: 'manage_blueprint', arguments: widgetArgs('set_widget_parent_class', { parentClass: 'UserWidget' }), expected: 'success' },
-
-    // === ADD ===
-    { scenario: 'ADD: add_canvas_panel', toolName: 'manage_blueprint', arguments: widgetArgs('add_canvas_panel', { slotName: 'RootCanvas' }), expected: 'success|already exists' },
-    ...addWidgetCases,
-
-    // === CONFIG ===
-    ...layoutCases,
-
-    // === CONNECT ===
-    ...bindingCases,
-
-    // === ANIMATION ===
-    { scenario: 'CREATE: create_widget_animation', toolName: 'manage_blueprint', arguments: widgetArgs('create_widget_animation', { animationName: ANIMATION_NAME, duration: 1.25 }), expected: 'success|already exists' },
-    { scenario: 'ADD: add_animation_track', toolName: 'manage_blueprint', arguments: widgetArgs('add_animation_track', { animationName: ANIMATION_NAME, slotName: 'TitleText', trackType: 'opacity', propertyName: 'RenderOpacity' }), expected: 'success|already exists' },
-    { scenario: 'ADD: add_animation_keyframe', toolName: 'manage_blueprint', arguments: widgetArgs('add_animation_keyframe', { animationName: ANIMATION_NAME, slotName: 'TitleText', time: 0.25, value: 0.5, interpolation: 'linear' }), expected: 'success' },
-    { scenario: 'CONFIG: set_animation_loop', toolName: 'manage_blueprint', arguments: widgetArgs('set_animation_loop', { animationName: ANIMATION_NAME, loopCount: 1, playMode: 'forward' }), expected: 'success' },
-
-    // === TEMPLATES ===
-    { scenario: 'CREATE: create_main_menu', toolName: 'manage_blueprint', arguments: widgetArgs('create_main_menu', { title: 'Main Menu' }), expected: 'success' },
-    { scenario: 'CREATE: create_pause_menu', toolName: 'manage_blueprint', arguments: widgetArgs('create_pause_menu'), expected: 'success' },
-    { scenario: 'CREATE: create_settings_menu', toolName: 'manage_blueprint', arguments: createTemplateArgs('create_settings_menu', 'WBP_SettingsMenu', { settingsType: 'all' }), expected: 'success|already exists' },
-    { scenario: 'CREATE: create_loading_screen', toolName: 'manage_blueprint', arguments: createTemplateArgs('create_loading_screen', 'WBP_LoadingScreen', { includeProgressBar: true }), expected: 'success|already exists' },
-    { scenario: 'CREATE: create_hud_widget', toolName: 'manage_blueprint', arguments: widgetArgs('create_hud_widget'), expected: 'success' },
-    ...hudElementCases,
-    { scenario: 'CREATE: create_inventory_ui', toolName: 'manage_blueprint', arguments: createTemplateArgs('create_inventory_ui', 'WBP_InventoryUI', { gridSize: { columns: 6, rows: 4 } }), expected: 'success|already exists' },
-    { scenario: 'CREATE: create_dialog_widget', toolName: 'manage_blueprint', arguments: createTemplateArgs('create_dialog_widget', 'WBP_DialogWidget', { showSpeakerName: true }), expected: 'success|already exists' },
-    { scenario: 'CREATE: create_radial_menu', toolName: 'manage_blueprint', arguments: createTemplateArgs('create_radial_menu', 'WBP_RadialMenu', { segmentCount: 8 }), expected: 'success|already exists' },
-
-    // === INFO ===
-    { scenario: 'INFO: get_widget_info', toolName: 'manage_blueprint', arguments: widgetArgs('get_widget_info'), expected: 'success' },
-    { scenario: 'ACTION: preview_widget', toolName: 'manage_blueprint', arguments: widgetArgs('preview_widget', { previewSize: '720p' }), expected: 'success' },
-
-    // === CLEANUP ===
-    { scenario: 'Cleanup: delete test folder', toolName: 'manage_asset', arguments: { action: 'delete', path: TEST_FOLDER, force: true }, expected: 'success|not found' },
-  );
-}
-
-runToolTests('manage-blueprint', testCases);

package/mcps/unreal_mcp/tests/mcp-tools/core/manage-level.test.mjs

@@ -1,73 +0,0 @@
-#!/usr/bin/env node
-/**
- * manage_level Tool Integration Tests
- * Covers all manage_level actions with real level package paths and deterministic cleanup.
- */
-
-import { runToolTests } from '../../test-runner.mjs';
-
-const TEST_FOLDER = '/Game/MCPTest/WorldAssets';
-const ts = Date.now();
-const MAIN_LEVEL = `${TEST_FOLDER}/LevelMain_${ts}`;
-const SUB_LEVEL = `${TEST_FOLDER}/LevelSub_${ts}`;
-const SAVE_AS_LEVEL = `${TEST_FOLDER}/LevelSaveAs_${ts}`;
-const SAVE_LEVEL_AS = `${TEST_FOLDER}/LevelSaveLevelAs_${ts}`;
-const EXPORTED_LEVEL = `${TEST_FOLDER}/LevelExported_${ts}`;
-const IMPORTED_LEVEL = `${TEST_FOLDER}/LevelImported_${ts}`;
-const DUPLICATED_LEVEL = `${TEST_FOLDER}/LevelDuplicated_${ts}`;
-const RENAMED_LEVEL_NAME = `LevelRenamed_${ts}`;
-const RENAMED_LEVEL = `${TEST_FOLDER}/${RENAMED_LEVEL_NAME}`;
-const TEST_ACTOR = `LevelActor_${ts}`;
-
-const testCases = [
-  // === SETUP ===
-  { scenario: 'Setup: create test folder', toolName: 'manage_asset', arguments: { action: 'create_folder', path: TEST_FOLDER }, expected: 'success|already exists' },
-
-  // === CREATE / SAVE / LOAD ===
-  { scenario: 'CREATE: create_level', toolName: 'manage_level', arguments: { action: 'create_level', levelName: `LevelMain_${ts}`, levelPath: TEST_FOLDER, template: '/Engine/Maps/Templates/OpenWorld', useWorldPartition: false, saveDirtyPackages: true }, expected: 'success|already exists' },
-  { scenario: 'ACTION: save', toolName: 'manage_level', arguments: { action: 'save' }, expected: 'success' },
-  { scenario: 'ACTION: save_level alias', toolName: 'manage_level', arguments: { action: 'save_level' }, expected: 'success' },
-  { scenario: 'ACTION: save_as', toolName: 'manage_level', arguments: { action: 'save_as', savePath: SAVE_AS_LEVEL }, expected: 'success' },
-  { scenario: 'ACTION: save_level_as', toolName: 'manage_level', arguments: { action: 'save_level_as', savePath: SAVE_LEVEL_AS }, expected: 'success' },
-  { scenario: 'Setup: create sublevel', toolName: 'manage_level', arguments: { action: 'create_level', levelName: `LevelSub_${ts}`, levelPath: TEST_FOLDER, useWorldPartition: false, saveDirtyPackages: true }, expected: 'success|already exists' },
-  { scenario: 'ACTION: load', toolName: 'manage_level', arguments: { action: 'load', levelPath: MAIN_LEVEL, streaming: false, saveDirtyPackages: true }, expected: 'success' },
-  { scenario: 'ACTION: load_level alias', toolName: 'manage_level', arguments: { action: 'load_level', levelPath: MAIN_LEVEL, streaming: false, saveDirtyPackages: true }, expected: 'success' },
-  { scenario: 'Setup: spawn actor in level', toolName: 'control_actor', arguments: { action: 'spawn', classPath: '/Engine/BasicShapes/Cube', actorName: TEST_ACTOR, location: { x: 0, y: 0, z: 100 } }, expected: 'success' },
-
-  // === STREAMING ===
-  { scenario: 'ACTION: stream', toolName: 'manage_level', arguments: { action: 'stream', levelPath: SUB_LEVEL, shouldBeLoaded: true, shouldBeVisible: true }, expected: 'success|already loaded' },
-  { scenario: 'ACTION: unload', toolName: 'manage_level', arguments: { action: 'unload', levelPath: SUB_LEVEL }, expected: 'success|not loaded' },
-  { scenario: 'ACTION: unload_level alias', toolName: 'manage_level', arguments: { action: 'unload_level', levelPath: SUB_LEVEL }, expected: 'success|not loaded' },
-  { scenario: 'ADD: add_sublevel', toolName: 'manage_level', arguments: { action: 'add_sublevel', subLevelPath: SUB_LEVEL, parentLevel: MAIN_LEVEL, parentPath: TEST_FOLDER, streamingMethod: 'AlwaysLoaded' }, expected: 'success|already exists' },
-  { scenario: 'ADD: add_sublevel via sublevelPath alias', toolName: 'manage_level', arguments: { action: 'add_sublevel', sublevelPath: SUB_LEVEL, streamingMethod: 'AlwaysLoaded' }, expected: 'success|already exists' },
-
-  // === LIGHTING ===
-  { scenario: 'CREATE: create_light', toolName: 'manage_level', arguments: { action: 'create_light', lightType: 'Point', name: `LevelLight_${ts}`, location: { x: 150, y: 0, z: 250 }, rotation: { pitch: -20, yaw: 0, roll: 0 }, intensity: 1500, color: [1, 0.85, 0.6, 1] }, expected: 'success|already exists' },
-  { scenario: 'CREATE: build_lighting', toolName: 'manage_level', arguments: { action: 'build_lighting', quality: 'Preview' }, expected: 'success|already exists' },
-
-  // === METADATA ===
-  { scenario: 'CONFIG: set_metadata', toolName: 'manage_level', arguments: { action: 'set_metadata', assetPath: MAIN_LEVEL, metadata: { suite: 'manage_level', timestamp: ts } }, expected: 'success' },
-
-  // === IMPORT / EXPORT / INFO ===
-  { scenario: 'ACTION: export_level', toolName: 'manage_level', arguments: { action: 'export_level', levelPath: MAIN_LEVEL, exportPath: EXPORTED_LEVEL, timeoutMs: 45000 }, expected: 'success' },
-  { scenario: 'ACTION: import_level', toolName: 'manage_level', arguments: { action: 'import_level', packagePath: MAIN_LEVEL, destinationPath: IMPORTED_LEVEL, timeoutMs: 45000 }, expected: 'success|already exists' },
-  { scenario: 'ACTION: import_level targetPath alias', toolName: 'manage_level', arguments: { action: 'import_level', packagePath: MAIN_LEVEL, targetPath: `${TEST_FOLDER}/LevelImportedAlias_${ts}`, timeoutMs: 45000 }, expected: 'success|already exists' },
-  { scenario: 'INFO: list_levels', toolName: 'manage_level', arguments: { action: 'list_levels' }, expected: 'success' },
-  { scenario: 'INFO: get_summary', toolName: 'manage_level', arguments: { action: 'get_summary', levelPath: MAIN_LEVEL }, expected: 'success' },
-  { scenario: 'ACTION: validate_level', toolName: 'manage_level', arguments: { action: 'validate_level', levelPath: MAIN_LEVEL }, expected: 'success' },
-  { scenario: 'ACTION: validate_level assetPath alias', toolName: 'manage_level', arguments: { action: 'validate_level', assetPath: MAIN_LEVEL }, expected: 'success' },
-  { scenario: 'INFO: get_current_level', toolName: 'manage_level', arguments: { action: 'get_current_level' }, expected: 'success' },
-
-  // === ASSET OPERATIONS ===
-  { scenario: 'ACTION: duplicate_level', toolName: 'manage_level', arguments: { action: 'duplicate_level', sourcePath: MAIN_LEVEL, destinationPath: DUPLICATED_LEVEL, targetPath: TEST_FOLDER, overwrite: false }, expected: 'success|already exists' },
-  { scenario: 'ACTION: rename_level', toolName: 'manage_level', arguments: { action: 'rename_level', levelPath: DUPLICATED_LEVEL, newName: RENAMED_LEVEL_NAME, overwrite: false }, expected: 'success|already exists' },
-  { scenario: 'DELETE: delete multiple levels', toolName: 'manage_level', arguments: { action: 'delete', levelPaths: [SAVE_AS_LEVEL, SAVE_LEVEL_AS, EXPORTED_LEVEL] }, expected: 'success|not found' },
-  { scenario: 'DELETE: delete', toolName: 'manage_level', arguments: { action: 'delete', levelPath: RENAMED_LEVEL }, expected: 'success|not found' },
-  { scenario: 'DELETE: delete_level path alias', toolName: 'manage_level', arguments: { action: 'delete_level', path: IMPORTED_LEVEL }, expected: 'success|not found' },
-
-  // === CLEANUP ===
-  { scenario: 'Cleanup: delete test actor', toolName: 'control_actor', arguments: { action: 'delete', actorName: TEST_ACTOR }, expected: 'success|not found' },
-  { scenario: 'Cleanup: delete test folder', toolName: 'manage_asset', arguments: { action: 'delete', path: TEST_FOLDER, force: true }, expected: 'success|not found' },
-];
-
-runToolTests('manage-level', testCases);

package/mcps/unreal_mcp/tests/mcp-tools/core/manage-tools.test.mjs

@@ -1,30 +0,0 @@
-#!/usr/bin/env node
-/**
- * manage_tools Tool Integration Tests
- * Covers all 8 actions with proper setup/teardown sequencing.
- */
-
-import { runToolTests } from '../../test-runner.mjs';
-
-const testCases = [
-  // === SETUP ===
-  { scenario: 'Setup: reset dynamic tool state', toolName: 'manage_tools', arguments: { action: 'reset' }, expected: 'success' },
-
-  // === INFO ===
-  { scenario: 'INFO: list_tools', toolName: 'manage_tools', arguments: { action: 'list_tools' }, expected: 'success', assertions: [{ path: 'structuredContent.tools', includesObject: { name: 'manage_tools', enabled: true, category: 'core' }, label: 'manage_tools remains visible and protected' }] },
-  { scenario: 'INFO: list_categories', toolName: 'manage_tools', arguments: { action: 'list_categories' }, expected: 'success', assertions: [{ path: 'structuredContent.categories', includesObject: { name: 'gameplay' }, label: 'gameplay category is registered' }] },
-  // === TOGGLE ===
-  { scenario: 'TOGGLE: enable_tools', toolName: 'manage_tools', arguments: { action: 'enable_tools', tools: ['system_control'] }, expected: 'success', assertions: [{ path: 'structuredContent.enabled', length: 1, label: 'enable_tools reports the requested tool' }] },
-  { scenario: 'TOGGLE: disable_tools', toolName: 'manage_tools', arguments: { action: 'disable_tools', tools: ['system_control'] }, expected: 'success', assertions: [{ path: 'structuredContent.disabled', length: 1, label: 'disable_tools reports the requested tool' }] },
-  { scenario: 'TOGGLE: enable_category', toolName: 'manage_tools', arguments: { action: 'enable_category', category: 'gameplay' }, expected: 'success', assertions: [{ path: 'structuredContent.category', equals: 'gameplay', label: 'enable_category echoes category' }] },
-  { scenario: 'TOGGLE: disable_category', toolName: 'manage_tools', arguments: { action: 'disable_category', category: 'gameplay' }, expected: 'success', assertions: [{ path: 'structuredContent.category', equals: 'gameplay', label: 'disable_category echoes category' }] },
-  // === INFO ===
-  { scenario: 'INFO: get_status', toolName: 'manage_tools', arguments: { action: 'get_status' }, expected: 'success', assertions: [{ path: 'structuredContent.categories', includesObject: { name: 'gameplay', enabled: false }, label: 'get_status reflects disabled gameplay category' }] },
-  // === ACTION ===
-  { scenario: 'ACTION: reset', toolName: 'manage_tools', arguments: { action: 'reset' }, expected: 'success' },
-
-  // === CLEANUP ===
-  { scenario: 'Cleanup: reset dynamic tool state', toolName: 'manage_tools', arguments: { action: 'reset' }, expected: 'success' },
-];
-
-runToolTests('manage-tools', testCases);