@hybridlabor-api/aos 4.3.0 → 4.4.0

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

@@ -1,205 +0,0 @@
-#!/usr/bin/env node
-/**
- * system_control Tool Integration Tests
- * Covers all 24 actions with proper setup/teardown sequencing.
- */
-
-import { runToolTests } from '../../test-runner.mjs';
-
-const TEST_FOLDER = '/Game/MCPTest/SystemControl';
-const WIDGET_NAME = 'WBP_SystemControl_Test';
-const WIDGET_PATH = `${TEST_FOLDER}/${WIDGET_NAME}`;
-const VALIDATION_MATERIAL = `${TEST_FOLDER}/M_SystemControlValidation`;
-const PYTHON_TEST_ID = Date.now();
-const PYTHON_FILE_RELATIVE = `Saved/MCPTests/system-control-${PYTHON_TEST_ID}.py`;
-const PYTHON_HELPER_RELATIVE = `Saved/MCPTests/system-control-${PYTHON_TEST_ID}-helper.txt`;
-const PYTHON_FILE_LITERAL = JSON.stringify(PYTHON_FILE_RELATIVE);
-const PYTHON_HELPER_LITERAL = JSON.stringify(PYTHON_HELPER_RELATIVE);
-const PROJECT_SETTING_SECTION = '/Script/Engine.Engine';
-const PROJECT_SETTING_KEY = `McpSystemControlSmoke_${Date.now()}`;
-const TRACE_TEST_ID = Date.now();
-const TRACE_CAPTURE_FILE = `MCPTests/insights-capture-${TRACE_TEST_ID}.utrace`;
-const TRACE_START_FILE = `MCPTests/insights-start-${TRACE_TEST_ID}.utrace`;
-const TRACE_SNAPSHOT_FILE = `MCPTests/insights-snapshot-${TRACE_TEST_ID}.utrace`;
-const PROJECT_SETTING_SECTION_LITERAL = JSON.stringify(PROJECT_SETTING_SECTION);
-const PROJECT_SETTING_KEY_LITERAL = JSON.stringify(PROJECT_SETTING_KEY);
-const CREATE_PYTHON_FILE_CODE = `
-import os
-import unreal
-path = os.path.join(unreal.Paths.project_dir(), ${PYTHON_FILE_LITERAL})
-helper_path = os.path.join(unreal.Paths.project_dir(), ${PYTHON_HELPER_LITERAL})
-os.makedirs(os.path.dirname(path), exist_ok=True)
-with open(helper_path, 'w', encoding='utf-8') as f:
-    f.write('sibling-file-ok')
-with open(path, 'w', encoding='utf-8') as f:
-    f.write('import os\\n')
-    f.write('helper_path = os.path.join(os.path.dirname(__file__), os.path.basename(${PYTHON_HELPER_LITERAL}))\\n')
-    f.write('with open(helper_path, "r", encoding="utf-8") as helper:\\n')
-    f.write('    print("system-control-file-ok:" + helper.read())\\n')
-print("system-control-file-created")
-`.trim();
-const DELETE_PYTHON_FILE_CODE = `
-import os
-import unreal
-path = os.path.join(unreal.Paths.project_dir(), ${PYTHON_FILE_LITERAL})
-helper_path = os.path.join(unreal.Paths.project_dir(), ${PYTHON_HELPER_LITERAL})
-if os.path.exists(path):
-    os.remove(path)
-if os.path.exists(helper_path):
-    os.remove(helper_path)
-print("system-control-file-cleaned")
-`.trim();
-const CLEANUP_PROJECT_SETTING_CODE = `
-import os
-import unreal
-section = ${PROJECT_SETTING_SECTION_LITERAL}
-key = ${PROJECT_SETTING_KEY_LITERAL}
-config_path = os.path.join(unreal.Paths.project_config_dir(), 'DefaultEngine.ini')
-if os.path.exists(config_path):
-    with open(config_path, 'r', encoding='utf-8') as f:
-        lines = f.readlines()
-    kept = []
-    in_target_section = False
-    section_header = f'[{section}]'
-    for line in lines:
-        stripped = line.strip()
-        if stripped.startswith('[') and stripped.endswith(']'):
-            in_target_section = stripped == section_header
-        if in_target_section and stripped.split('=', 1)[0].strip() == key:
-            continue
-        kept.append(line)
-    with open(config_path, 'w', encoding='utf-8') as f:
-        f.writelines(kept)
-print("system-control-setting-cleaned")
-`.trim();
-
-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 validation material', toolName: 'manage_asset', arguments: { action: 'create_material', name: 'M_SystemControlValidation', path: TEST_FOLDER }, expected: 'success|already exists' },
-
-  // === ACTION ===
-  { scenario: 'ACTION: profile', toolName: 'system_control', arguments: { action: 'profile', profileType: 'cpu' }, expected: 'success' },
-  { scenario: 'ACTION: show_fps', toolName: 'system_control', arguments: { action: 'show_fps', enabled: true }, expected: 'success' },
-  // === CONFIG ===
-  { scenario: 'CONFIG: set_quality', toolName: 'system_control', arguments: { action: 'set_quality', category: 'ViewDistance', level: 1 }, expected: 'success' },
-  // === ACTION ===
-  { scenario: 'ACTION: screenshot', toolName: 'system_control', arguments: { action: 'screenshot', filename: 'SystemControl_NullRHI', resolution: '640x360', mode: 'editor_viewport', returnBase64: false, includeMetadata: true, metadata: { source: 'system-control-suite' } }, expected: 'success' },
-  // === CONFIG ===
-  { scenario: 'CONFIG: set_resolution', toolName: 'system_control', arguments: { action: 'set_resolution', width: 1280, height: 720, windowed: true }, expected: 'success' },
-  { scenario: 'CONFIG: set_fullscreen', toolName: 'system_control', arguments: { action: 'set_fullscreen', enabled: false }, expected: 'success' },
-  // === ACTION ===
-  { scenario: 'ACTION: execute_command', toolName: 'system_control', arguments: { action: 'execute_command', command: 'stat unit' }, expected: 'success' },
-  { scenario: 'ACTION: console_command', toolName: 'system_control', arguments: { action: 'console_command', command: 'stat fps' }, expected: 'success' },
-  { scenario: 'ACTION: run_ubt', toolName: 'system_control', arguments: { action: 'run_ubt', target: 'MCPtestEditor', platform: 'Linux', configuration: 'Development', arguments: '-NoHotReload' }, expected: 'success' },
-  { scenario: 'ACTION: subscribe', toolName: 'system_control', arguments: { action: 'subscribe' }, expected: 'success' },
-  { scenario: 'ACTION: unsubscribe', toolName: 'system_control', arguments: { action: 'unsubscribe' }, expected: 'success' },
-  // === CREATE ===
-  { scenario: 'CREATE: spawn_category', toolName: 'system_control', arguments: { action: 'spawn_category', categoryName: 'AI' }, expected: 'success' },
-  // === ACTION ===
-  { scenario: 'ACTION: start_session', toolName: 'system_control', arguments: { action: 'start_session', channels: 'cpu' }, expected: 'success' },
-  { scenario: 'INFO: get_trace_status', toolName: 'system_control', arguments: { action: 'get_trace_status' }, expected: 'success' },
-  { scenario: 'ACTION: pause_session', toolName: 'system_control', arguments: { action: 'pause_session' }, expected: { successPattern: 'paused', errorPattern: 'TRACE_PAUSE_FAILED' } },
-  { scenario: 'ACTION: resume_session', toolName: 'system_control', arguments: { action: 'resume_session' }, expected: { successPattern: 'resumed', errorPattern: 'TRACE_RESUME_FAILED' } },
-  { scenario: 'ACTION: write_snapshot', toolName: 'system_control', arguments: { action: 'write_snapshot', snapshotPath: TRACE_SNAPSHOT_FILE, overwrite: true }, expected: 'success' },
-  { scenario: 'ACTION: analyze_trace', toolName: 'system_control', arguments: { action: 'analyze_trace', tracePath: TRACE_SNAPSHOT_FILE }, expected: 'success' },
-  { scenario: 'ACTION: send_snapshot', toolName: 'system_control', arguments: { action: 'send_snapshot', host: 'localhost', port: 1981 }, expected: { successPattern: 'snapshot', errorPattern: 'SNAPSHOT_SEND_FAILED' } },
-  { scenario: 'ACTION: stop_session', toolName: 'system_control', arguments: { action: 'stop_session' }, expected: 'success' },
-  { scenario: 'ACTION: capture_insights_trace', toolName: 'system_control', arguments: { action: 'capture_insights_trace', channels: 'cpu', traceFile: TRACE_CAPTURE_FILE, overwrite: true }, expected: 'success' },
-  { scenario: 'ACTION: stop_session after capture', toolName: 'system_control', arguments: { action: 'stop_session' }, expected: 'success' },
-  { scenario: 'ACTION: start_unreal_insights', toolName: 'system_control', arguments: { action: 'start_unreal_insights', channels: 'cpu', connectionType: 'file', traceFile: TRACE_START_FILE, overwrite: true }, expected: 'success' },
-  { scenario: 'ACTION: stop_session after start_unreal_insights', toolName: 'system_control', arguments: { action: 'stop_session' }, expected: 'success' },
-  { scenario: 'ACTION: lumen_update_scene', toolName: 'system_control', arguments: { action: 'lumen_update_scene' }, expected: 'success' },
-  // === PLAYBACK ===
-  { scenario: 'PLAYBACK: play_sound', toolName: 'system_control', arguments: { action: 'play_sound', volume: 0 }, expected: 'success' },
-  // === CREATE ===
-  { scenario: 'CREATE: create_widget', toolName: 'system_control', arguments: { action: 'create_widget', name: WIDGET_NAME, savePath: TEST_FOLDER }, expected: 'success|already exists' },
-  // === ACTION ===
-  { scenario: 'ACTION: show_widget', toolName: 'system_control', arguments: { action: 'show_widget', widgetId: 'notification', message: 'System control smoke', duration: 0.1 }, expected: 'success' },
-  // === ADD ===
-  { scenario: 'ADD: add_widget_child', toolName: 'system_control', arguments: { action: 'add_widget_child', widgetPath: WIDGET_PATH, childClass: 'TextBlock', name: 'SystemControlText', text: 'System control child' }, expected: 'success' },
-  { scenario: 'ADD: add_widget_child parentName', toolName: 'system_control', arguments: { action: 'add_widget_child', widgetPath: WIDGET_PATH, childClass: 'TextBlock', name: 'SystemControlNestedText', parentName: 'RootCanvas', text: 'System control nested child' }, expected: 'success' },
-  // === CONFIG ===
-  { scenario: 'CONFIG: set_cvar', toolName: 'system_control', arguments: { action: 'set_cvar', name: 'r.ScreenPercentage', value: '100' }, expected: 'success' },
-  // === INFO ===
-  { scenario: 'INFO: get_project_settings', toolName: 'system_control', arguments: { action: 'get_project_settings', section: '/Script/Engine.Engine' }, expected: 'success' },
-  // === ACTION ===
-  { scenario: 'ACTION: validate_assets', toolName: 'system_control', arguments: { action: 'validate_assets', paths: [VALIDATION_MATERIAL] }, expected: 'success' },
-  { scenario: 'ACTION: validate_assets assetPath', toolName: 'system_control', arguments: { action: 'validate_assets', assetPath: VALIDATION_MATERIAL }, expected: 'success' },
-  { scenario: 'ACTION: validate_assets path recursive', toolName: 'system_control', arguments: { action: 'validate_assets', path: TEST_FOLDER, recursive: false }, expected: 'success' },
-  // === CONFIG ===
-  { scenario: 'CONFIG: set_project_setting', toolName: 'system_control', arguments: { action: 'set_project_setting', section: PROJECT_SETTING_SECTION, key: PROJECT_SETTING_KEY, value: '1' }, expected: 'success' },
-  { scenario: 'ACTION: execute_python', toolName: 'system_control', arguments: { action: 'execute_python', code: 'print("system-control-ok")' }, expected: 'success' },
-  { scenario: 'Setup: create execute_python file', toolName: 'system_control', arguments: { action: 'execute_python', code: CREATE_PYTHON_FILE_CODE }, expected: 'success' },
-  // This result is asserted on the returned MCP response, so it also catches
-  // temp wrapper cleanup racing file execution before output/status are written.
-  { scenario: 'ACTION: execute_python file', toolName: 'system_control', arguments: { action: 'execute_python', file: PYTHON_FILE_RELATIVE }, expected: 'success', assertions: [{ path: 'structuredContent.result.output', equals: 'system-control-file-ok:sibling-file-ok', label: 'python file has __file__ and synchronous output' }] },
-
-  // === CLEANUP ===
-  { scenario: 'Cleanup: delete execute_python file', toolName: 'system_control', arguments: { action: 'execute_python', code: DELETE_PYTHON_FILE_CODE }, expected: 'success' },
-  { scenario: 'Cleanup: remove project setting', toolName: 'system_control', arguments: { action: 'execute_python', code: CLEANUP_PROJECT_SETTING_CODE }, expected: 'success' },
-  { scenario: 'Cleanup: delete test folder', toolName: 'manage_asset', arguments: { action: 'delete', path: TEST_FOLDER, force: true }, expected: 'success|not found' },
-  { scenario: 'ACTION: run_tests', toolName: 'system_control', arguments: { action: 'run_tests', filter: 'System.Core.Time.Comparison' }, expected: 'success' },
-];
-
-// === PERFORMANCE ACTIONS ===
-{
-  /**
-   * system_control performance action integration tests
-   * Covers all 20 actions with proper setup/teardown sequencing.
-   */
-
-  const ts = Date.now();
-  const TEST_FOLDER = `/Game/MCPTest/UtilityAssets_${ts}`;
-  const MERGE_PARENT_ACTOR = `ParentActor_${ts}`;
-  const MERGE_CHILD_ACTOR = `ChildActor_${ts}`;
-  const MERGED_ACTOR_ASSET = `${TEST_FOLDER}/SM_PerformanceMerged_${ts}`;
-  const MERGED_ACTOR_PACKAGE_ASSET = `${TEST_FOLDER}/SM_PerformanceMergedPackage_${ts}`;
-
-  testCases.push(
-    // === SETUP ===
-    { scenario: 'Setup: create test folder', toolName: 'manage_asset', arguments: { action: 'create_folder', path: TEST_FOLDER }, expected: 'success|already exists' },
-    { scenario: 'Setup: spawn merge parent actor', toolName: 'control_actor', arguments: { action: 'spawn_actor', classPath: '/Script/Engine.StaticMeshActor', meshPath: '/Engine/BasicShapes/Cube.Cube', actorName: MERGE_PARENT_ACTOR, location: { x: 0, y: 300, z: 120 } }, expected: 'success|already exists' },
-    { scenario: 'Setup: spawn merge child actor', toolName: 'control_actor', arguments: { action: 'spawn_actor', classPath: '/Script/Engine.StaticMeshActor', meshPath: '/Engine/BasicShapes/Cube.Cube', actorName: MERGE_CHILD_ACTOR, location: { x: 160, y: 300, z: 120 } }, expected: 'success|already exists' },
-
-    // === ACTION ===
-    { scenario: 'ACTION: start_profiling', toolName: 'system_control', arguments: {"action": "start_profiling", "type": "CPU", "duration": 1}, expected: 'success' },
-    // === PLAYBACK ===
-    { scenario: 'PLAYBACK: stop_profiling', toolName: 'system_control', arguments: {"action": "stop_profiling"}, expected: 'success' },
-    // === ACTION ===
-    { scenario: 'ACTION: run_benchmark', toolName: 'system_control', arguments: {"action": "run_benchmark", "duration": 1, "type": "CPU"}, expected: 'success' },
-    { scenario: 'ACTION: show_fps', toolName: 'system_control', arguments: {"action": "show_fps"}, expected: 'success' },
-    { scenario: 'ACTION: show_stats', toolName: 'system_control', arguments: {"action": "show_stats", "category": "Unit"}, expected: 'success' },
-    { scenario: 'ACTION: generate_memory_report', toolName: 'system_control', arguments: {"action": "generate_memory_report", "detailed": true}, expected: 'success|already exists' },
-    // === CONFIG ===
-    { scenario: 'CONFIG: set_scalability', toolName: 'system_control', arguments: {"action": "set_scalability", "level": 1, "category": "ViewDistance"}, expected: 'success' },
-    { scenario: 'CONFIG: set_resolution_scale', toolName: 'system_control', arguments: {"action": "set_resolution_scale", "scale": 75}, expected: 'success' },
-    { scenario: 'CONFIG: set_vsync', toolName: 'system_control', arguments: {"action": "set_vsync", "enabled": true}, expected: 'success' },
-    { scenario: 'CONFIG: set_frame_rate_limit', toolName: 'system_control', arguments: {"action": "set_frame_rate_limit", "maxFPS": 60}, expected: 'success' },
-    // === TOGGLE ===
-    { scenario: 'TOGGLE: enable_gpu_timing', toolName: 'system_control', arguments: {"action": "enable_gpu_timing"}, expected: 'success' },
-    // === CONFIG ===
-    { scenario: 'CONFIG: configure_texture_streaming', toolName: 'system_control', arguments: {"action": "configure_texture_streaming", "poolSize": 128, "boostPlayerLocation": false}, expected: 'success' },
-    { scenario: 'CONFIG: configure_lod', toolName: 'system_control', arguments: {"action": "configure_lod", "forceLOD": -1, "lodBias": 0}, expected: 'success' },
-    // === ACTION ===
-    { scenario: 'ACTION: apply_baseline_settings', toolName: 'system_control', arguments: {"action": "apply_baseline_settings"}, expected: 'success' },
-    { scenario: 'ACTION: optimize_draw_calls', toolName: 'system_control', arguments: {"action": "optimize_draw_calls", "enableInstancing": false, "enableBatching": true}, expected: 'success' },
-    { scenario: 'ACTION: merge_actors', toolName: 'system_control', arguments: {"action": "merge_actors", "actors": [MERGE_PARENT_ACTOR, MERGE_CHILD_ACTOR], "replaceSourceActors": false, "mergeActors": true, "outputPath": MERGED_ACTOR_ASSET}, expected: 'success' },
-    { scenario: 'ACTION: merge_actors via packageName', toolName: 'system_control', arguments: {"action": "merge_actors", "actors": [MERGE_PARENT_ACTOR, MERGE_CHILD_ACTOR], "replaceSourceActors": false, "packageName": MERGED_ACTOR_PACKAGE_ASSET}, expected: 'success' },
-    // === CONFIG ===
-    { scenario: 'CONFIG: configure_occlusion_culling', toolName: 'system_control', arguments: {"action": "configure_occlusion_culling"}, expected: 'success' },
-    // === ACTION ===
-    { scenario: 'ACTION: optimize_shaders', toolName: 'system_control', arguments: {"action": "optimize_shaders"}, expected: 'success' },
-    // === CONFIG ===
-    { scenario: 'CONFIG: configure_nanite', toolName: 'system_control', arguments: {"action": "configure_nanite"}, expected: 'success' },
-    { scenario: 'CONFIG: configure_world_partition', toolName: 'system_control', arguments: {"action": "configure_world_partition", "cellSize": 6400, "streamingDistance": 25600}, expected: 'success' },
-
-    // === CLEANUP ===
-    { scenario: 'Cleanup: delete merged mesh asset', toolName: 'manage_asset', arguments: { action: 'delete', path: MERGED_ACTOR_ASSET, force: true }, expected: 'success|not found' },
-    { scenario: 'Cleanup: delete packageName merged mesh asset', toolName: 'manage_asset', arguments: { action: 'delete', path: MERGED_ACTOR_PACKAGE_ASSET, force: true }, expected: 'success|not found' },
-    { scenario: 'Cleanup: delete merge actors', toolName: 'control_actor', arguments: { action: 'delete', actorNames: [MERGE_PARENT_ACTOR, MERGE_CHILD_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('system-control', testCases);

package/mcps/unreal_mcp/tests/mcp-tools/gameplay/animation-physics.test.mjs

@@ -1,277 +0,0 @@
-#!/usr/bin/env node
-/**
- * animation_physics Tool Integration Tests
- * Covers all 55 actions with proper setup/teardown sequencing.
- */
-
-import { runToolTests } from '../../test-runner.mjs';
-
-const TEST_FOLDER = '/Game/MCPTest/AuthoringAssets';
-const ts = Date.now();
-
-// The skeleton created in setup - used by all CREATE actions that need a skeleton
-const TEST_SKELETON_PATH = `${TEST_FOLDER}/SK_AnimPhys_${ts}`;
-const TEST_IK_RIG_PATH = `${TEST_FOLDER}/Testik_rig`;
-const TEST_IK_RETARGETER_PATH = `${TEST_FOLDER}/Testik_retargeter`;
-
-const testCases = [
-// === SETUP ===
-{ scenario: 'Setup: delete stale test folder', toolName: 'manage_asset', arguments: { action: 'delete', path: TEST_FOLDER, force: true }, expected: 'error|ASSET_NOT_FOUND|success|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 skeleton', toolName: 'animation_physics', arguments: { action: 'create_skeleton', path: TEST_SKELETON_PATH, rootBoneName: 'Root', save: true }, expected: 'success|already exists' },
-
-// === CREATE (Animation Blueprints - need skeletonPath) ===
-{ scenario: 'CREATE: create_animation_blueprint', toolName: 'animation_physics', arguments: {"action": "create_animation_blueprint", "name": "Testanimation_blueprint", "path": TEST_FOLDER, "skeletonPath": TEST_SKELETON_PATH, "parentClass": "Actor"}, expected: 'success|already exists' },
-{ scenario: 'CREATE: create_animation_bp', toolName: 'animation_physics', arguments: {"action": "create_animation_bp", "name": "Testanimation_bp", "path": TEST_FOLDER, "skeletonPath": TEST_SKELETON_PATH, "parentClass": "Actor"}, expected: 'success|already exists' },
-{ scenario: 'CREATE: create_anim_blueprint', toolName: 'animation_physics', arguments: {"action": "create_anim_blueprint", "name": "Testanim_blueprint", "path": TEST_FOLDER, "skeletonPath": TEST_SKELETON_PATH, "parentClass": "Actor"}, expected: 'success|already exists' },
-
-// === CREATE (Blend Spaces - need skeletonPath) ===
-{ scenario: 'CREATE: create_blend_space', toolName: 'animation_physics', arguments: {"action": "create_blend_space", "name": "Testblend_space", "path": TEST_FOLDER, "skeletonPath": TEST_SKELETON_PATH}, expected: 'success|already exists' },
-{ scenario: 'CREATE: create_blend_space_1d', toolName: 'animation_physics', arguments: {"action": "create_blend_space_1d", "name": "Testblend_space_1d", "path": TEST_FOLDER, "skeletonPath": TEST_SKELETON_PATH}, expected: 'success|already exists' },
-{ scenario: 'CREATE: create_blend_space_2d', toolName: 'animation_physics', arguments: {"action": "create_blend_space_2d", "name": "Testblend_space_2d", "path": TEST_FOLDER, "skeletonPath": TEST_SKELETON_PATH}, expected: 'success|already exists' },
-
-  // === CREATE (Blend Tree - needs blueprintPath to existing AnimBP) ===
-  // ANIMGRAPH_MODULE_UNAVAILABLE: primary intent since AnimGraph BlendTree headers may not be compiled in
-  { scenario: 'CREATE: create_blend_tree', toolName: 'animation_physics', arguments: {"action": "create_blend_tree", "name": "Testblend_tree", "path": TEST_FOLDER, "blueprintPath": `${TEST_FOLDER}/Testanimation_blueprint`}, expected: 'error|ANIMGRAPH_MODULE_UNAVAILABLE|success|already exists' },
-
-// === CREATE (Procedural Anim - needs skeletonPath) ===
-{ scenario: 'CREATE: create_procedural_anim', toolName: 'animation_physics', arguments: {"action": "create_procedural_anim", "name": "Testprocedural_anim", "path": TEST_FOLDER, "skeletonPath": TEST_SKELETON_PATH, "boneTracks": [{"boneName": "Root", "frames": [{"frame": 0}]}], "frameRate": 30}, expected: 'success|already exists' },
-
-// === CREATE (Aim Offset - needs skeletonPath) ===
-{ scenario: 'CREATE: create_aim_offset', toolName: 'animation_physics', arguments: {"action": "create_aim_offset", "name": "Testaim_offset", "path": TEST_FOLDER, "skeletonPath": TEST_SKELETON_PATH}, expected: 'success|already exists' },
-
-// === ADD (Aim Offset Sample - needs assetPath to the aim offset) ===
-{ scenario: 'ADD: add_aim_offset_sample', toolName: 'animation_physics', arguments: {"action": "add_aim_offset_sample", "assetPath": `${TEST_FOLDER}/Testaim_offset`, "animationPath": `${TEST_FOLDER}/Testprocedural_anim`, "yaw": 0, "pitch": 0}, expected: 'success|already exists' },
-
-// === CREATE (State Machine - needs blueprintPath) ===
-{ scenario: 'CREATE: create_state_machine', toolName: 'animation_physics', arguments: {"action": "create_state_machine", "machineName": "Teststate_machine", "path": TEST_FOLDER, "blueprintPath": `${TEST_FOLDER}/Testanimation_blueprint`}, expected: 'success|already exists' },
-
-// === ADD (State Machine - needs blueprintPath) ===
-{ scenario: 'ADD: add_state_machine', toolName: 'animation_physics', arguments: {"action": "add_state_machine", "blueprintPath": `${TEST_FOLDER}/Testanimation_blueprint`, "stateMachineName": "Teststate_machine"}, expected: 'success|already exists' },
-
-// === ADD (State - needs blueprintPath and stateMachineName) ===
-{ scenario: 'ADD: add_state', toolName: 'animation_physics', arguments: {"action": "add_state", "blueprintPath": `${TEST_FOLDER}/Testanimation_blueprint`, "stateMachineName": "Teststate_machine", "stateName": "Teststate"}, expected: 'success|already exists' },
-
-// === ADD (Transition - needs blueprintPath, stateMachineName, fromState, toState) ===
-{ scenario: 'ADD: add_transition', toolName: 'animation_physics', arguments: {"action": "add_transition", "blueprintPath": `${TEST_FOLDER}/Testanimation_blueprint`, "stateMachineName": "Teststate_machine", "fromState": "Teststate", "toState": "Teststate"}, expected: 'success|already exists' },
-
-// === CONFIG (Transition Rules - needs blueprintPath) ===
-{ scenario: 'CONFIG: set_transition_rules', toolName: 'animation_physics', arguments: {"action": "set_transition_rules", "blueprintPath": `${TEST_FOLDER}/Testanimation_blueprint`, "stateMachineName": "Teststate_machine", "fromState": "Teststate", "toState": "Teststate", "blendTime": 0.2}, expected: 'success' },
-
-// === ADD (Blend Node - needs blueprintPath) ===
-{ scenario: 'ADD: add_blend_node', toolName: 'animation_physics', arguments: {"action": "add_blend_node", "blueprintPath": `${TEST_FOLDER}/Testanimation_blueprint`, "blendType": "TwoWayBlend", "nodeName": "Testblend_node"}, expected: 'success|already exists' },
-
-// === ADD (Cached Pose - needs blueprintPath) ===
-{ scenario: 'ADD: add_cached_pose', toolName: 'animation_physics', arguments: {"action": "add_cached_pose", "blueprintPath": `${TEST_FOLDER}/Testanimation_blueprint`, "cacheName": "Testcached_pose"}, expected: 'success|already exists' },
-
-// === ADD (Slot Node - needs blueprintPath) ===
-{ scenario: 'ADD: add_slot_node', toolName: 'animation_physics', arguments: {"action": "add_slot_node", "blueprintPath": `${TEST_FOLDER}/Testanimation_blueprint`, "slotName": "Testslot_node"}, expected: 'success|already exists' },
-{ scenario: 'ADD: add_layered_blend_per_bone', toolName: 'animation_physics', arguments: {"action": "add_layered_blend_per_bone", "blueprintPath": `${TEST_FOLDER}/Testanimation_blueprint`, "layerSetup": [{"branchFilters": [{"boneName": "Root", "blendDepth": 1}]}]}, expected: 'error|ANIMGRAPH_MODULE_UNAVAILABLE|success' },
-{ scenario: 'CONFIG: set_anim_graph_node_value', toolName: 'animation_physics', arguments: {"action": "set_anim_graph_node_value", "blueprintPath": `${TEST_FOLDER}/Testanimation_blueprint`, "nodeName": "Testblend_node", "propertyName": "NodeComment", "value": "MCPUpdatedBlendNode"}, expected: 'error|ANIMGRAPH_MODULE_UNAVAILABLE|NODE_NOT_FOUND|PROPERTY_NOT_FOUND|success' },
-
-// === CREATE (Control Rig - needs skeletonPath) ===
-{ scenario: 'CREATE: create_control_rig', toolName: 'animation_physics', arguments: {"action": "create_control_rig", "name": "Testcontrol_rig", "path": TEST_FOLDER, "skeletonPath": TEST_SKELETON_PATH}, expected: 'success|already exists|NOT_AVAILABLE' },
-
-// === CREATE (IK Rig - explicit retargeter dependency; unavailable on some engine builds) ===
-{ scenario: 'SETUP: create IK Rig for retargeter', toolName: 'animation_physics', arguments: {"action": "create_ik_rig", "name": "Testik_rig", "path": TEST_FOLDER, "skeletonPath": TEST_SKELETON_PATH}, expected: 'error|IKRIG_FACTORY_UNAVAILABLE|NOT_SUPPORTED|success|already exists' },
-{ scenario: 'CREATE: create_ik_retargeter', toolName: 'animation_physics', arguments: {"action": "create_ik_retargeter", "name": "Testik_retargeter", "path": TEST_FOLDER, "sourceIKRigPath": TEST_IK_RIG_PATH, "targetIKRigPath": TEST_IK_RIG_PATH, "save": true}, expected: 'error|IKRETARGET_FACTORY_UNAVAILABLE|NOT_SUPPORTED|success|already exists' },
-{ scenario: 'CONFIG: set_retarget_chain_mapping', toolName: 'animation_physics', arguments: {"action": "set_retarget_chain_mapping", "assetPath": TEST_IK_RETARGETER_PATH, "sourceChain": "Root", "targetChain": "Root"}, expected: 'error|NOT_SUPPORTED|success' },
-
-// === ACTION (Setup IK - needs name and skeletonPath) ===
-{ scenario: 'ACTION: setup_ik', toolName: 'animation_physics', arguments: {"action": "setup_ik", "name": "TestIK", "skeletonPath": TEST_SKELETON_PATH}, expected: 'success|already exists' },
-
-// === CREATE (Pose Library - needs skeletonPath) ===
-{ scenario: 'CREATE: create_pose_library', toolName: 'animation_physics', arguments: {"action": "create_pose_library", "name": "Testpose_library", "path": TEST_FOLDER, "skeletonPath": TEST_SKELETON_PATH}, expected: 'success|already exists' },
-
-// === CREATE (Animation Asset - needs skeletonPath) ===
-{ scenario: 'CREATE: create_animation_asset', toolName: 'animation_physics', arguments: {"action": "create_animation_asset", "name": "Testanimation_asset", "path": TEST_FOLDER, "skeletonPath": TEST_SKELETON_PATH}, expected: 'success|already exists' },
-
-// === CREATE (Animation Sequence - needs skeletonPath) ===
-{ scenario: 'CREATE: create_animation_sequence', toolName: 'animation_physics', arguments: {"action": "create_animation_sequence", "name": "Testanimation_sequence", "path": TEST_FOLDER, "skeletonPath": TEST_SKELETON_PATH}, expected: 'success|already exists' },
-
-// === CONFIG (Sequence Length - needs assetPath) ===
-{ scenario: 'CONFIG: set_sequence_length', toolName: 'animation_physics', arguments: {"action": "set_sequence_length", "assetPath": `${TEST_FOLDER}/Testanimation_sequence`, "numFrames": 60}, expected: 'success' },
-
-// === ADD (Bone Track - needs assetPath and boneName) ===
-{ scenario: 'ADD: add_bone_track', toolName: 'animation_physics', arguments: {"action": "add_bone_track", "assetPath": `${TEST_FOLDER}/Testanimation_sequence`, "boneName": "Root"}, expected: 'success|already exists' },
-
-// === CONFIG (Bone Key - needs assetPath) ===
-{ scenario: 'CONFIG: set_bone_key', toolName: 'animation_physics', arguments: {"action": "set_bone_key", "assetPath": `${TEST_FOLDER}/Testanimation_sequence`, "boneName": "Root", "frame": 0, "location": {"x": 0, "y": 0, "z": 0}}, expected: 'success' },
-
-// === CONFIG (Curve Key - needs assetPath) ===
-{ scenario: 'CONFIG: set_curve_key', toolName: 'animation_physics', arguments: {"action": "set_curve_key", "assetPath": `${TEST_FOLDER}/Testanimation_sequence`, "curveName": "TestCurve", "frame": 0, "value": 1.0}, expected: 'success' },
-
-// === CREATE (Montage - needs skeletonPath) ===
-{ scenario: 'CREATE: create_montage', toolName: 'animation_physics', arguments: {"action": "create_montage", "name": "Testmontage", "path": TEST_FOLDER, "skeletonPath": TEST_SKELETON_PATH}, expected: 'success|already exists' },
-
-// === ADD (Montage Section - needs assetPath) ===
-{ scenario: 'ADD: add_montage_section', toolName: 'animation_physics', arguments: {"action": "add_montage_section", "assetPath": `${TEST_FOLDER}/Testmontage`, "sectionName": "Testmontage_section", "startTime": 0}, expected: 'success|already exists' },
-
-// === ADD (Montage Slot - needs assetPath and animationPath) ===
-{ scenario: 'ADD: add_montage_slot', toolName: 'animation_physics', arguments: {"action": "add_montage_slot", "assetPath": `${TEST_FOLDER}/Testmontage`, "animationPath": `${TEST_FOLDER}/Testanimation_sequence`, "slotName": "DefaultSlot", "startTime": 0}, expected: 'success|already exists' },
-
-// === CONFIG (Section Timing - needs assetPath) ===
-{ scenario: 'CONFIG: set_section_timing', toolName: 'animation_physics', arguments: {"action": "set_section_timing", "assetPath": `${TEST_FOLDER}/Testmontage`, "sectionName": "Testmontage_section", "startTime": 0, "length": 1.0}, expected: 'success' },
-
-// === ADD (Montage Notify - needs assetPath; no notifyClass = simple notify event) ===
-{ scenario: 'ADD: add_montage_notify', toolName: 'animation_physics', arguments: {"action": "add_montage_notify", "assetPath": `${TEST_FOLDER}/Testmontage`, "time": 0.5, "notifyName": "Testmontage_notify"}, expected: 'success|already exists' },
-
-// === CONFIG (Blend In - needs assetPath) ===
-{ scenario: 'CONFIG: set_blend_in', toolName: 'animation_physics', arguments: {"action": "set_blend_in", "assetPath": `${TEST_FOLDER}/Testmontage`, "blendTime": 0.25}, expected: 'success' },
-
-// === CONFIG (Blend Out - needs assetPath) ===
-{ scenario: 'CONFIG: set_blend_out', toolName: 'animation_physics', arguments: {"action": "set_blend_out", "assetPath": `${TEST_FOLDER}/Testmontage`, "blendTime": 0.25}, expected: 'success' },
-
-// === CONNECT (Link Sections - needs assetPath) ===
-{ scenario: 'CONNECT: link_sections', toolName: 'animation_physics', arguments: {"action": "link_sections", "assetPath": `${TEST_FOLDER}/Testmontage`, "fromSection": "Testmontage_section", "toSection": "Testmontage_section"}, expected: 'success' },
-
-// === ADD (Notify - needs assetPath and notifyName; no notifyClass = simple notify) ===
-{ scenario: 'ADD: add_notify', toolName: 'animation_physics', arguments: {"action": "add_notify", "assetPath": `${TEST_FOLDER}/Testanimation_sequence`, "notifyName": "Testnotify", "frame": 0}, expected: 'success|already exists' },
-{ scenario: 'ADD: add_notify_state', toolName: 'animation_physics', arguments: {"action": "add_notify_state", "assetPath": `${TEST_FOLDER}/Testanimation_sequence`, "notifyName": "Testnotify_state", "startFrame": 1, "endFrame": 10, "trackIndex": 0, "save": true}, expected: 'success' },
-{ scenario: 'ADD: add_sync_marker', toolName: 'animation_physics', arguments: {"action": "add_sync_marker", "assetPath": `${TEST_FOLDER}/Testanimation_sequence`, "markerName": "Testsync_marker", "frame": 5, "save": true}, expected: 'success' },
-{ scenario: 'CONFIG: set_root_motion_settings', toolName: 'animation_physics', arguments: {"action": "set_root_motion_settings", "assetPath": `${TEST_FOLDER}/Testanimation_sequence`, "enableRootMotion": true, "rootMotionRootLock": "RefPose", "forceRootLock": false, "save": true}, expected: 'success' },
-{ scenario: 'CONFIG: set_additive_settings', toolName: 'animation_physics', arguments: {"action": "set_additive_settings", "assetPath": `${TEST_FOLDER}/Testanimation_sequence`, "additiveAnimType": "NoAdditive", "basePoseType": "RefPose", "basePoseFrame": 0, "save": true}, expected: 'success' },
-{ scenario: 'INFO: get_animation_info', toolName: 'animation_physics', arguments: {"action": "get_animation_info", "assetPath": `${TEST_FOLDER}/Testanimation_sequence`}, expected: 'success' },
-
-// === SETUP: Spawn a SkeletalMeshActor for playback/ragdoll tests ===
-{ scenario: 'Setup: spawn SkeletalMeshActor', toolName: 'control_actor', arguments: {"action": "spawn", "actorName": "SkelTestActor", "actorClass": "SkeletalMeshActor"}, expected: 'success|already exists' },
-
-// === PLAYBACK (Montage - needs actorName with SkeletalMeshComponent) ===
-{ scenario: 'PLAYBACK: play_montage', toolName: 'animation_physics', arguments: {"action": "play_montage", "actorName": "SkelTestActor", "montagePath": `${TEST_FOLDER}/Testmontage`, "playRate": 1.25}, expected: 'success|COMPONENT_NOT_FOUND' },
-{ scenario: 'PLAYBACK: play_anim_montage', toolName: 'animation_physics', arguments: {"action": "play_anim_montage", "actorName": "SkelTestActor", "montagePath": `${TEST_FOLDER}/Testmontage`}, expected: 'success|COMPONENT_NOT_FOUND' },
-
-// === ACTION (Ragdoll - needs actorName with SkeletalMeshComponent) ===
-{ scenario: 'ACTION: setup_ragdoll', toolName: 'animation_physics', arguments: {"action": "setup_ragdoll", "actorName": "SkelTestActor"}, expected: 'success|COMPONENT_NOT_FOUND' },
-{ scenario: 'ACTION: activate_ragdoll', toolName: 'animation_physics', arguments: {"action": "activate_ragdoll", "actorName": "SkelTestActor"}, expected: 'success|COMPONENT_NOT_FOUND' },
-
-// === CONFIG (Vehicle - needs actorName) ===
-{ scenario: 'CONFIG: configure_vehicle', toolName: 'animation_physics', arguments: {"action": "configure_vehicle", "actorName": "SkelTestActor", "vehicleType": "WheeledVehicle4W", "dragCoefficient": 0.32}, expected: 'success|NOT_AVAILABLE|COMPONENT_CREATION_FAILED|ACTOR_NOT_FOUND' },
-
-  // === ACTION (Physics Simulation - needs skeletonPath; may fail if no preview mesh) ===
-  { scenario: 'ACTION: setup_physics_simulation', toolName: 'animation_physics', arguments: {"action": "setup_physics_simulation", "skeletonPath": TEST_SKELETON_PATH}, expected: 'error|ASSET_NOT_FOUND|SKELETON_MISSING_PREVIEW' },
-
-// === CREATE (Anim Blueprint repeat - needs skeletonPath) ===
-{ scenario: 'CREATE: create_anim_blueprint', toolName: 'animation_physics', arguments: {"action": "create_anim_blueprint", "name": "Testanim_blueprint", "path": TEST_FOLDER, "skeletonPath": TEST_SKELETON_PATH, "parentClass": "Actor"}, expected: 'success|already exists' },
-
-// === ADD (Blend Sample - needs assetPath and animationPath) ===
-{ scenario: 'ADD: add_blend_sample', toolName: 'animation_physics', arguments: {"action": "add_blend_sample", "assetPath": `${TEST_FOLDER}/Testblend_space_1d`, "animationPath": `${TEST_FOLDER}/Testanimation_sequence`, "sampleValue": 100}, expected: 'success|already exists' },
-
-// === CONFIG (Axis Settings - needs assetPath) ===
-{ scenario: 'CONFIG: set_axis_settings', toolName: 'animation_physics', arguments: {"action": "set_axis_settings", "assetPath": `${TEST_FOLDER}/Testblend_space_1d`, "axis": "X", "axisName": "Speed", "minValue": 0, "maxValue": 600}, expected: 'success' },
-
-{ scenario: 'ACTION: force_rebuild_blend_space', toolName: 'animation_physics', arguments: {"action": "force_rebuild_blend_space", "assetPath": `${TEST_FOLDER}/Testblend_space_1d`, "rebuildBlendParameters": true, "compileReferencers": false, "save": false}, expected: 'success' },
-
-// === CONFIG (Interpolation Settings - needs assetPath) ===
-{ scenario: 'CONFIG: set_interpolation_settings', toolName: 'animation_physics', arguments: {"action": "set_interpolation_settings", "assetPath": `${TEST_FOLDER}/Testblend_space_1d`, "interpolationType": "Lerp"}, expected: 'success' },
-{ scenario: 'ACTION: force_rebuild_blend_space', toolName: 'animation_physics', arguments: {"action": "force_rebuild_blend_space", "assetPath": `${TEST_FOLDER}/Testblend_space_1d`, "rebuildBlendParameters": true, "compileReferencers": false, "save": true}, expected: 'success|ASSET_NOT_FOUND|not found' },
-
-// === ACTION (Retargeting - needs sourceSkeleton and targetSkeleton) ===
-{ scenario: 'ACTION: setup_retargeting', toolName: 'animation_physics', arguments: {"action": "setup_retargeting", "sourceSkeleton": TEST_SKELETON_PATH, "targetSkeleton": TEST_SKELETON_PATH, "assets": [`${TEST_FOLDER}/Testanimation_sequence`], "savePath": TEST_FOLDER, "suffix": "_Retargeted", "overwrite": true}, expected: 'success' },
-
-// === ACTION (Cleanup - needs artifacts array) ===
-{ scenario: 'ACTION: cleanup', toolName: 'animation_physics', arguments: {"action": "cleanup", "artifacts": [
-  `${TEST_FOLDER}/Testanimation_blueprint`,
-  `${TEST_FOLDER}/Testanimation_bp`,
-  `${TEST_FOLDER}/Testanim_blueprint`,
-  `${TEST_FOLDER}/Testblend_space`,
-  `${TEST_FOLDER}/Testblend_space_1d`,
-  `${TEST_FOLDER}/Testblend_space_2d`,
-  `${TEST_FOLDER}/Testprocedural_anim`,
-  `${TEST_FOLDER}/Testaim_offset`,
-  `${TEST_FOLDER}/Testcontrol_rig`,
-  TEST_IK_RIG_PATH,
-  TEST_IK_RETARGETER_PATH,
-  `${TEST_FOLDER}/Testpose_library`,
-  `${TEST_FOLDER}/Testanimation_asset`,
-  `${TEST_FOLDER}/Testanimation_sequence`,
-  `${TEST_FOLDER}/Testmontage`,
-  TEST_SKELETON_PATH,
-  '/Game/MCPTest/AuthoringAssets_CtrlRig',
-  '/Game/Animations/TestIK',
-  '/Game/Animations/PoseLibraries/Testpose_library'
-]}, expected: 'success|not found' },
-
-// === CLEANUP ===
-{ scenario: 'Cleanup: delete SkelTestActor', toolName: 'control_actor', arguments: { action: 'delete', actorName: 'SkelTestActor' }, expected: 'success|not found' },
-{ scenario: 'Cleanup: delete test folder', toolName: 'manage_asset', arguments: { action: 'delete', path: TEST_FOLDER, force: true }, expected: 'success|not found' },
-];
-
-// === SKELETON ACTIONS ===
-{
-  /**
-   * animation_physics skeleton action integration tests
-   * Exercises real skeleton, socket, skin-weight, physics-asset, cloth, morph, and info actions.
-   */
-
-  const TEST_FOLDER = '/Game/MCPTest/AuthoringAssets';
-  const SKELETAL_MESH_PATH = '/Engine/EngineMeshes/SkeletalCube';
-  const ts = Date.now();
-
-  const SKELETON_PATH = `${TEST_FOLDER}/SK_Test_${ts}`;
-  const PHYSICS_ASSET_PATH = `${TEST_FOLDER}/PHYS_Test_${ts}`;
-  const PHYSICS_SIM_NAME = `PHYS_Sim_${ts}`;
-  const ROOT_BONE = 'Root';
-  const MESH_BONE_A = 'Bone01';
-  const MESH_BONE_B = 'Bone02';
-  const CHILD_BONE = `McpChild_${ts}`;
-  const TEMP_BONE = `McpTemp_${ts}`;
-  const VIRTUAL_BONE = `VB_Mcp_${ts}`;
-  const RENAMED_VIRTUAL_BONE = `VB_McpRenamed_${ts}`;
-  const SOCKET_NAME = `McpSocket_${ts}`;
-  const MORPH_TARGET_NAME = `McpMorph_${ts}`;
-  const PROFILE_NAME = `McpWeights_${ts}`;
-
-  testCases.push(
-    // === SETUP ===
-    { scenario: 'Setup: create test folder', toolName: 'manage_asset', arguments: { action: 'create_folder', path: TEST_FOLDER }, expected: 'success|already exists' },
-    { scenario: 'Setup: create test skeleton', toolName: 'animation_physics', arguments: { action: 'create_skeleton', path: SKELETON_PATH, rootBoneName: ROOT_BONE, save: true }, expected: 'success|already exists' },
-
-    // === SKELETON STRUCTURE ===
-    { scenario: 'ADD: add child bone', toolName: 'animation_physics', arguments: { action: 'add_bone', skeletonPath: SKELETON_PATH, boneName: CHILD_BONE, parentBoneName: ROOT_BONE, location: [10, 0, 0], rotation: [0, 0, 0], scale: 1, save: true }, expected: 'success|already exists' },
-    { scenario: 'CREATE: create virtual bone', toolName: 'animation_physics', arguments: { action: 'create_virtual_bone', skeletonPath: SKELETON_PATH, sourceBoneName: ROOT_BONE, targetBoneName: CHILD_BONE, boneName: VIRTUAL_BONE, save: true }, expected: 'success|already exists' },
-    { scenario: 'ACTION: rename virtual bone', toolName: 'animation_physics', arguments: { action: 'rename_bone', skeletonPath: SKELETON_PATH, boneName: VIRTUAL_BONE, newBoneName: RENAMED_VIRTUAL_BONE, save: true }, expected: 'success' },
-    { scenario: 'CONFIG: set mesh bone transform', toolName: 'animation_physics', arguments: { action: 'set_bone_transform', skeletalMeshPath: SKELETAL_MESH_PATH, boneName: MESH_BONE_A, location: [0, 0, 0], rotation: [0, 0, 0], scale: [1, 1, 1], save: false }, expected: 'success' },
-    { scenario: 'ADD: add temp bone', toolName: 'animation_physics', arguments: { action: 'add_bone', skeletonPath: SKELETON_PATH, boneName: TEMP_BONE, parentBoneName: ROOT_BONE, location: [0, 10, 0], save: true }, expected: 'success|already exists' },
-    { scenario: 'CONFIG: set temp bone parent', toolName: 'animation_physics', arguments: { action: 'set_bone_parent', skeletonPath: SKELETON_PATH, boneName: TEMP_BONE, parentBoneName: CHILD_BONE, save: true }, expected: 'success' },
-    { scenario: 'DELETE: remove temp bone', toolName: 'animation_physics', arguments: { action: 'remove_bone', skeletonPath: SKELETON_PATH, boneName: TEMP_BONE, removeChildren: true, save: true }, expected: 'success|not found' },
-
-    // === SOCKETS ===
-    { scenario: 'CREATE: create socket', toolName: 'animation_physics', arguments: { action: 'create_socket', skeletonPath: SKELETON_PATH, socketName: SOCKET_NAME, attachBoneName: CHILD_BONE, relativeLocation: [1, 2, 3], relativeRotation: [0, 45, 0], relativeScale: [1, 1, 1], save: true }, expected: 'success|already exists' },
-    { scenario: 'CONFIG: configure socket', toolName: 'animation_physics', arguments: { action: 'configure_socket', skeletonPath: SKELETON_PATH, socketName: SOCKET_NAME, attachBoneName: CHILD_BONE, relativeLocation: [4, 5, 6], relativeRotation: [0, 90, 0], relativeScale: [1.25, 1.25, 1.25], save: true }, expected: 'success' },
-    { scenario: 'INFO: list sockets', toolName: 'animation_physics', arguments: { action: 'list_sockets', skeletonPath: SKELETON_PATH }, expected: 'success' },
-
-    // === SKELETON INFO ===
-    { scenario: 'INFO: get skeleton info', toolName: 'animation_physics', arguments: { action: 'get_skeleton_info', skeletonPath: SKELETON_PATH }, expected: 'success' },
-    { scenario: 'INFO: list bones', toolName: 'animation_physics', arguments: { action: 'list_bones', skeletonPath: SKELETON_PATH }, expected: 'success' },
-
-    // === PHYSICS ASSET ===
-    { scenario: 'CREATE: create physics asset', toolName: 'animation_physics', arguments: { action: 'create_physics_asset', skeletalMeshPath: SKELETAL_MESH_PATH, outputPath: PHYSICS_ASSET_PATH, save: true }, expected: 'success|already exists' },
-    { scenario: 'ACTION: setup physics simulation from skeletal mesh', toolName: 'animation_physics', arguments: { action: 'setup_physics_simulation', skeletalMeshPath: SKELETAL_MESH_PATH, savePath: TEST_FOLDER, physicsAssetName: PHYSICS_SIM_NAME, assignToMesh: false }, expected: 'success|already exists', assertions: [{ path: 'structuredContent.result.existingAsset', equals: false, label: 'new physics simulation asset created from skeletalMeshPath' }] },
-    { scenario: 'INFO: list physics bodies', toolName: 'animation_physics', arguments: { action: 'list_physics_bodies', physicsAssetPath: PHYSICS_ASSET_PATH }, expected: 'success' },
-    { scenario: 'ADD: add physics body A', toolName: 'animation_physics', arguments: { action: 'add_physics_body', physicsAssetPath: PHYSICS_ASSET_PATH, boneName: MESH_BONE_A, bodyType: 'Sphere', radius: 12, center: [0, 0, 0], save: true }, expected: 'success|already exists' },
-    { scenario: 'ADD: add physics body B', toolName: 'animation_physics', arguments: { action: 'add_physics_body', physicsAssetPath: PHYSICS_ASSET_PATH, boneName: MESH_BONE_B, bodyType: 'Sphere', radius: 10, center: [0, 0, 0], save: true }, expected: 'success|already exists' },
-    { scenario: 'CONFIG: configure physics body', toolName: 'animation_physics', arguments: { action: 'configure_physics_body', physicsAssetPath: PHYSICS_ASSET_PATH, boneName: MESH_BONE_A, mass: 5, linearDamping: 0.25, angularDamping: 0.5, collisionEnabled: true, simulatePhysics: false, save: true }, expected: 'success' },
-    { scenario: 'ADD: add physics constraint', toolName: 'animation_physics', arguments: { action: 'add_physics_constraint', physicsAssetPath: PHYSICS_ASSET_PATH, bodyA: MESH_BONE_A, bodyB: MESH_BONE_B, constraintName: `McpConstraint_${ts}`, save: true }, expected: 'success|already exists' },
-    { scenario: 'CONFIG: configure constraint limits', toolName: 'animation_physics', arguments: { action: 'configure_constraint_limits', physicsAssetPath: PHYSICS_ASSET_PATH, bodyA: MESH_BONE_A, bodyB: MESH_BONE_B, limits: { swing1LimitAngle: 30, swing2LimitAngle: 35, twistLimitAngle: 20, swing1Motion: 'Limited', swing2Motion: 'Limited', twistMotion: 'Limited' }, save: true }, expected: 'success' },
-
-    // === SKIN WEIGHTS ===
-    { scenario: 'ACTION: auto skin weights', toolName: 'animation_physics', arguments: { action: 'auto_skin_weights', skeletalMeshPath: SKELETAL_MESH_PATH, save: false }, expected: 'success' },
-    { scenario: 'CONFIG: set vertex weights', toolName: 'animation_physics', arguments: { action: 'set_vertex_weights', skeletalMeshPath: SKELETAL_MESH_PATH, profileName: PROFILE_NAME, lodIndex: 0, weights: [{ vertexIndex: 0, influences: [{ boneIndex: 0, weight: 1 }] }], save: false }, expected: 'success' },
-    { scenario: 'ACTION: normalize weights', toolName: 'animation_physics', arguments: { action: 'normalize_weights', skeletalMeshPath: SKELETAL_MESH_PATH, save: false }, expected: 'success' },
-    { scenario: 'ACTION: prune weights', toolName: 'animation_physics', arguments: { action: 'prune_weights', skeletalMeshPath: SKELETAL_MESH_PATH, threshold: 0.01, save: false }, expected: 'success' },
-    { scenario: 'ACTION: copy weights', toolName: 'animation_physics', arguments: { action: 'copy_weights', sourceMeshPath: SKELETAL_MESH_PATH, targetMeshPath: SKELETAL_MESH_PATH, profileName: `${PROFILE_NAME}_Copy`, lodIndex: 0 }, expected: 'success' },
-    { scenario: 'ACTION: mirror weights', toolName: 'animation_physics', arguments: { action: 'mirror_weights', skeletalMeshPath: SKELETAL_MESH_PATH, axis: 'X', profileName: `${PROFILE_NAME}_Mirror`, lodIndex: 0, save: false }, expected: 'success' },
-
-    // === CLOTH AND MORPHS ===
-    { scenario: 'CONNECT: bind cloth to skeletal mesh', toolName: 'animation_physics', arguments: { action: 'bind_cloth_to_skeletal_mesh', skeletalMeshPath: SKELETAL_MESH_PATH, save: false }, expected: 'success' },
-    { scenario: 'CONNECT: assign cloth asset to mesh', toolName: 'animation_physics', arguments: { action: 'assign_cloth_asset_to_mesh', skeletalMeshPath: SKELETAL_MESH_PATH, save: false }, expected: 'error|manual intervention|required' },
-    { scenario: 'CREATE: create morph target', toolName: 'animation_physics', arguments: { action: 'create_morph_target', skeletalMeshPath: SKELETAL_MESH_PATH, morphTargetName: MORPH_TARGET_NAME, deltas: [{ vertexIndex: 0, positionDelta: { x: 0, y: 0, z: 1 } }], save: false }, expected: 'success|already exists' },
-    { scenario: 'CONFIG: set morph target deltas', toolName: 'animation_physics', arguments: { action: 'set_morph_target_deltas', skeletalMeshPath: SKELETAL_MESH_PATH, morphTargetName: MORPH_TARGET_NAME, deltas: [{ vertexIndex: 0, positionDelta: { x: 0, y: 0, z: 2 } }], save: false }, expected: 'success' },
-    { scenario: 'ACTION: import morph targets', toolName: 'animation_physics', arguments: { action: 'import_morph_targets', skeletalMeshPath: SKELETAL_MESH_PATH, morphTargetPath: SKELETAL_MESH_PATH, save: false }, expected: 'success' },
-
-    // === CLEANUP ===
-    { scenario: 'Cleanup: delete test folder', toolName: 'manage_asset', arguments: { action: 'delete', path: TEST_FOLDER, force: true }, expected: 'success|not found' },
-  );
-}
-
-runToolTests('animation-physics', testCases);