unreal-engine-mcp-server 0.4.7 → 0.5.1

package/tests/test-console-command.mjs

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+/**
+ * Condensed Console Command Test Suite (15 cases)
+ * Tool: system_control (action: console_command)
+ */
+
+import { runToolTests } from './test-runner.mjs';
+
+const testCases = [
+  { scenario: 'Show FPS stats', toolName: 'system_control', arguments: { action: 'console_command', command: 'stat fps' }, expected: 'success - command executed' },
+  { scenario: 'Show unit stats', toolName: 'system_control', arguments: { action: 'console_command', command: 'stat unit' }, expected: 'success - unit stats shown' },
+  { scenario: 'Set resolution 1280x720 windowed', toolName: 'system_control', arguments: { action: 'console_command', command: 'r.SetRes 1280x720w' }, expected: 'success - resolution set' },
+  { scenario: 'Enable wireframe view', toolName: 'system_control', arguments: { action: 'console_command', command: 'viewmode wireframe' }, expected: 'success - wireframe enabled' },
+  { scenario: 'Enable lit view', toolName: 'system_control', arguments: { action: 'console_command', command: 'viewmode lit' }, expected: 'success - lit view enabled' },
+  { scenario: 'Show GPU profiler', toolName: 'system_control', arguments: { action: 'console_command', command: 'profilegpu' }, expected: 'success - GPU profiler shown' },
+  { scenario: 'Toggle collision visibility', toolName: 'system_control', arguments: { action: 'console_command', command: 'show collision' }, expected: 'success - collision visibility toggled' },
+  { scenario: 'Set screen percentage to 100', toolName: 'system_control', arguments: { action: 'console_command', command: 'r.ScreenPercentage 100' }, expected: 'success - screen percentage set' },
+  { scenario: 'Enable temporal AA weight', toolName: 'system_control', arguments: { action: 'console_command', command: 'r.TemporalAACurrentFrameWeight 0.04' }, expected: 'success - TAA weight set' },
+  { scenario: 'Set VSync on', toolName: 'system_control', arguments: { action: 'console_command', command: 'r.VSync 1' }, expected: 'success - VSync enabled' },
+  { scenario: 'Set max FPS to 60', toolName: 'system_control', arguments: { action: 'console_command', command: 't.MaxFPS 60' }, expected: 'success - max FPS set' },
+  { scenario: 'Show RHI stats', toolName: 'system_control', arguments: { action: 'console_command', command: 'stat rhi' }, expected: 'success - RHI stats shown' },
+  { scenario: 'Show game thread stats', toolName: 'system_control', arguments: { action: 'console_command', command: 'stat game' }, expected: 'success - game thread stats shown' },
+  { scenario: 'Show animation stats', toolName: 'system_control', arguments: { action: 'console_command', command: 'stat anim' }, expected: 'success - animation stats shown' },
+  { scenario: 'Reset viewmode to lit', toolName: 'system_control', arguments: { action: 'console_command', command: 'viewmode lit' }, expected: 'success - viewmode reset' },
+  { scenario: 'Show GPU', toolName: 'system_control', arguments: { action: 'console_command', command: 'stat gpu' }, expected: 'success or handled' },
+  { scenario: 'Show memory', toolName: 'system_control', arguments: { action: 'console_command', command: 'stat memory' }, expected: 'success or handled' },
+  { scenario: 'Set Mip LOD Bias', toolName: 'system_control', arguments: { action: 'console_command', command: 'r.MipMapLODBias 0' }, expected: 'success or handled' },
+  { scenario: 'Set AA Quality', toolName: 'system_control', arguments: { action: 'console_command', command: 'r.PostProcessAAQuality 4' }, expected: 'success or handled' },
+  { scenario: 'Flush rendering commands', toolName: 'system_control', arguments: { action: 'console_command', command: 'r.FlushRenderingCommands' }, expected: 'success or handled' },
+  {
+    scenario: "Blocked: Dangerous quit",
+    toolName: "system_control",
+    arguments: { action: "console_command", command: "quit" },
+    expected: "blocked|dangerous"
+  },
+  {
+    scenario: "Error: Empty command",
+    toolName: "system_control",
+    arguments: { action: "console_command", command: "" },
+    expected: "error|empty"
+  },
+  {
+    scenario: "Edge: Very long safe command",
+    toolName: "system_control",
+    arguments: { action: "console_command", command: "stat fps; stat gpu; stat memory" },
+    expected: "success"
+  },
+  {
+    scenario: "Warning: Unknown command",
+    toolName: "system_control",
+    arguments: { action: "console_command", command: "unknowncmd" },
+    expected: "warning|unknown"
+  }
+];
+
+await runToolTests('Console Command', testCases);

package/tests/test-control-actor.mjs

@@ -0,0 +1,425 @@
+#!/usr/bin/env node
+/**
+ * Condensed Actor Control Test Suite (15 cases) — safe for real Editor runs.
+ * Tool: control_actor
+ */
+
+import { runToolTests } from './test-runner.mjs';
+
+const testCases = [
+  {
+    scenario: 'Spawn StaticMeshActor (engine cube)',
+    toolName: 'control_actor',
+    arguments: { action: 'spawn', classPath: '/Engine/BasicShapes/Cube', actorName: 'TC_Cube', location: { x: 0, y: 0, z: 200 } },
+    expected: 'success - actor spawned'
+  },
+  {
+    scenario: 'Spawn CameraActor',
+    toolName: 'control_actor',
+    arguments: { action: 'spawn', classPath: 'CameraActor', actorName: 'TC_Camera', location: { x: 300, y: 0, z: 300 } },
+    expected: 'success - camera spawned'
+  },
+  {
+    scenario: 'Spawn PointLight',
+    toolName: 'control_actor',
+    arguments: { action: 'spawn', classPath: 'PointLight', actorName: 'TC_PointLight', location: { x: -300, y: 0, z: 300 } },
+    expected: 'success - light spawned'
+  },
+  {
+    scenario: 'Spawn Physics Cube (use control_actor instead of Python)',
+    toolName: 'control_actor',
+    arguments: { action: 'spawn', classPath: '/Engine/BasicShapes/Cube', actorName: 'TC_Physics', location: { x: 0, y: 0, z: 500 } },
+    expected: 'success - physics actor created'
+  },
+  {
+    scenario: 'Apply force to Physics actor',
+    toolName: 'control_actor',
+    arguments: { action: 'apply_force', actorName: 'TC_Physics', force: { x: 200000, y: 0, z: 0 } },
+    expected: 'success - force applied'
+  },
+  {
+    scenario: 'Set transform on an actor',
+    toolName: 'control_actor',
+    arguments: { action: 'set_transform', actorName: 'TC_Cube', location: { x: 100, y: 100, z: 400 }, rotation: { pitch: 0, yaw: 45, roll: 0 } },
+    expected: 'success - actor transform set'
+  },
+  {
+    scenario: 'Get actor transform',
+    toolName: 'control_actor',
+    arguments: { action: 'get_transform', actorName: 'TC_Cube' },
+    expected: 'success - actor transform retrieved'
+  },
+  {
+    scenario: 'Add PointLight component to actor',
+    toolName: 'control_actor',
+    arguments: { action: 'add_component', actorName: 'TC_Cube', componentType: 'PointLightComponent', componentName: 'TC_PointLightComp', properties: { Intensity: 3000 } },
+    expected: 'success - component added'
+  },
+  {
+    scenario: 'Set component properties',
+    toolName: 'control_actor',
+    arguments: { action: 'set_component_properties', actorName: 'TC_Cube', componentName: 'TC_PointLightComp', properties: { Intensity: 1500 } },
+    expected: 'success - component properties set'
+  },
+  {
+    scenario: 'Get components of actor',
+    toolName: 'control_actor',
+    arguments: { action: 'get_components', actorName: 'TC_Cube' },
+    expected: 'success - actor components retrieved'
+  },
+  {
+    scenario: 'Toggle actor visibility',
+    toolName: 'control_actor',
+    arguments: { action: 'set_visibility', actorName: 'TC_Cube', visible: false },
+    expected: 'success - actor visibility updated'
+  },
+  {
+    scenario: 'Duplicate actor',
+    toolName: 'control_actor',
+    arguments: { action: 'duplicate', actorName: 'TC_Cube', newName: 'TC_Cube_Copy', offset: { x: 50, y: 0, z: 0 } },
+    expected: 'success - actor duplicated'
+  },
+  {
+    scenario: 'Attach actor to another',
+    toolName: 'control_actor',
+    arguments: { action: 'attach', childActor: 'TC_Cube_Copy', parentActor: 'TC_Cube' },
+    expected: 'success - actor attached'
+  },
+  {
+    scenario: 'Detach actor',
+    toolName: 'control_actor',
+    arguments: { action: 'detach', actorName: 'TC_Cube_Copy' },
+    expected: 'success - actor detached'
+  },
+  {
+    scenario: 'Tag actor',
+    toolName: 'control_actor',
+    arguments: { action: 'add_tag', actorName: 'TC_Cube', tag: 'TC_Tag' },
+    expected: 'success - actor tagged'
+  },
+  {
+    scenario: 'Find actors by tag',
+    toolName: 'control_actor',
+    arguments: { action: 'find_by_tag', tag: 'TC_Tag' },
+    expected: 'success - actors found by tag'
+  },
+  {
+    scenario: 'Find actors by name',
+    toolName: 'control_actor',
+    arguments: { action: 'find_by_name', name: 'TC_Cube' },
+    expected: 'success - actors found by name'
+  },
+  {
+    scenario: 'Create snapshot for an actor',
+    toolName: 'control_actor',
+    arguments: { action: 'create_snapshot', actorName: 'TC_Cube', snapshotName: 'TC_Before' },
+    expected: 'success - actor snapshot created'
+  },
+  {
+    scenario: 'Create test blueprint first (BP_TestActor)',
+    toolName: 'manage_blueprint',
+    arguments: { action: 'create', path: '/Game/Blueprints/BP_TestActor', parentClass: 'Actor', blueprintType: 'actor' },
+    expected: 'success - blueprint created for testing'
+  },
+  {
+    scenario: 'Add Health variable to test blueprint',
+    toolName: 'manage_blueprint',
+    arguments: { action: 'add_variable', blueprintPath: '/Game/Blueprints/BP_TestActor', variableName: 'Health', variableType: 'float', defaultValue: 100.0 },
+    expected: 'success - Health variable added'
+  },
+  {
+    scenario: 'Add IsActive variable to test blueprint',
+    toolName: 'manage_blueprint',
+    arguments: { action: 'add_variable', blueprintPath: '/Game/Blueprints/BP_TestActor', variableName: 'IsActive', variableType: 'bool', defaultValue: false },
+    expected: 'success - IsActive variable added'
+  },
+  {
+    scenario: 'Spawn blueprint instance',
+    toolName: 'control_actor',
+    arguments: { action: 'spawn_blueprint', blueprintPath: '/Game/Blueprints/BP_TestActor', actorName: 'TC_BP_Instance', location: { x: 600, y: 0, z: 200 } },
+    expected: 'success - blueprint instance spawned'
+  },
+  {
+    scenario: 'Set blueprint variables',
+    toolName: 'control_actor',
+    arguments: { action: 'set_blueprint_variables', actorName: 'TC_BP_Instance', variables: { Health: 120, IsActive: true } },
+    expected: 'success - blueprint variables set'
+  },
+  {
+    scenario: 'Delete by tag filter',
+    toolName: 'control_actor',
+    arguments: { action: 'delete_by_tag', tag: 'TC_Tag' },
+    expected: 'success - actors deleted by tag'
+  },
+  // Real-World Scenario: Composite Actor (Parent-Child)
+  {
+    scenario: 'Composite Actor - Spawn Parent (Car)',
+    toolName: 'control_actor',
+    arguments: { action: 'spawn', classPath: '/Engine/BasicShapes/Cube', actorName: 'TC_Car_Body', location: { x: 1000, y: 0, z: 100 } },
+    expected: 'success'
+  },
+  {
+    scenario: 'Composite Actor - Spawn Child (Wheel)',
+    toolName: 'control_actor',
+    arguments: { action: 'spawn', classPath: '/Engine/BasicShapes/Cylinder', actorName: 'TC_Car_Wheel', location: { x: 1050, y: 50, z: 50 } },
+    expected: 'success'
+  },
+  {
+    scenario: 'Composite Actor - Attach Wheel to Body',
+    toolName: 'control_actor',
+    arguments: { action: 'attach', childActor: 'TC_Car_Wheel', parentActor: 'TC_Car_Body' },
+    expected: 'success'
+  },
+  {
+    scenario: 'Composite Actor - Move Parent',
+    toolName: 'control_actor',
+    arguments: { action: 'set_transform', actorName: 'TC_Car_Body', location: { x: 1200, y: 0, z: 100 } },
+    expected: 'success'
+  },
+
+  // Real-World Scenario: Batch Operations
+  {
+    scenario: 'Batch Ops - Spawn Crowd 1',
+    toolName: 'control_actor',
+    arguments: { action: 'spawn', classPath: '/Engine/BasicShapes/Cube', actorName: 'TC_Crowd_1', location: { x: 2000, y: 0, z: 0 } },
+    expected: 'success'
+  },
+  {
+    scenario: 'Batch Ops - Spawn Crowd 2',
+    toolName: 'control_actor',
+    arguments: { action: 'spawn', classPath: '/Engine/BasicShapes/Cube', actorName: 'TC_Crowd_2', location: { x: 2100, y: 0, z: 0 } },
+    expected: 'success'
+  },
+  {
+    scenario: 'Batch Ops - Tag Crowd',
+    toolName: 'control_actor',
+    arguments: { action: 'add_tag', actorName: 'TC_Crowd_1', tag: 'TC_Crowd' },
+    expected: 'success'
+  },
+  {
+    scenario: 'Batch Ops - Tag Crowd 2',
+    toolName: 'control_actor',
+    arguments: { action: 'add_tag', actorName: 'TC_Crowd_2', tag: 'TC_Crowd' },
+    expected: 'success'
+  },
+  {
+    scenario: 'Batch Ops - Find by Tag',
+    toolName: 'control_actor',
+    arguments: { action: 'find_by_tag', tag: 'TC_Crowd' },
+    expected: 'success'
+  },
+
+  // Cleanup
+  {
+    scenario: 'Cleanup - delete test actors',
+    toolName: 'control_actor',
+    arguments: { action: 'delete', actorNames: ['TC_Cube_Copy', 'TC_Physics', 'TC_PointLight', 'TC_BP_Instance', 'TC_Camera', 'TC_Car_Wheel', 'TC_Car_Body', 'TC_Crowd_1', 'TC_Crowd_2'] },
+    expected: 'success - actors deleted'
+  },
+  // Robust Blueprint Cleanup Sequence
+  {
+    scenario: 'Cleanup - Force GC (Pre-BP Delete)',
+    toolName: 'system_control',
+    arguments: { action: 'console_command', command: 'obj gc' },
+    expected: 'success'
+  },
+  {
+    scenario: 'Cleanup - Wait for GC',
+    toolName: 'system_control',
+    arguments: { action: 'console_command', command: 'Sleep 1' },
+    expected: 'success'
+  },
+  {
+    scenario: 'Cleanup - Delete Test Blueprint',
+    toolName: 'manage_asset',
+    arguments: { action: 'delete_assets', paths: ['/Game/Blueprints/BP_TestActor'], force: true },
+    expected: 'success|not_found|error' // Accept any result to avoid failing test on cleanup
+  },
+  {
+    scenario: "Error: Invalid action",
+    toolName: "control_actor",
+    arguments: { action: "invalid_action" },
+    expected: "error|validation|unknown_action"
+  },
+  {
+    scenario: "Error: Spawn invalid class",
+    toolName: "control_actor",
+    arguments: { action: "spawn", classPath: "InvalidClassDoesNotExist", actorName: "TestInvalid" },
+    expected: "error|class_not_found"
+  },
+  {
+    scenario: "Edge: Zero force (no-op)",
+    toolName: "control_actor",
+    arguments: { action: "apply_force", actorName: "TC_Physics", force: { x: 0, y: 0, z: 0 } },
+    expected: "success"
+  },
+  {
+    scenario: "Border: Extreme location",
+    toolName: "control_actor",
+    arguments: { action: "spawn", classPath: "/Engine/BasicShapes/Cube", actorName: "TC_Extreme", location: { x: 1000000, y: 1000000, z: 1000000 } },
+    expected: "success"
+  },
+  {
+    scenario: "Error: Non-existent actor",
+    toolName: "control_actor",
+    arguments: { action: "delete", actorName: "NonExistentActor" },
+    expected: "not_found|error"
+  },
+  {
+    scenario: "Edge: Empty tag array (find)",
+    toolName: "control_actor",
+    arguments: { action: "find_by_tag", tag: "" },
+    expected: "success|empty"
+  },
+  {
+    scenario: "Timeout test (short timeout fail)",
+    toolName: "control_actor",
+    arguments: { action: "spawn", classPath: "StaticMeshActor", timeoutMs: 100 },
+    expected: "timeout|error"
+  },
+  {
+    scenario: "Batch delete empty array",
+    toolName: "control_actor",
+    arguments: { action: "delete", actorNames: [] },
+    expected: "success|no_op"
+  },
+  // --- New Test Cases (+20) ---
+  {
+    scenario: "Restore TC_Cube for new tests",
+    toolName: "control_actor",
+    arguments: { action: "spawn", classPath: "/Engine/BasicShapes/Cube", actorName: "TC_Cube", location: { x: 0, y: 0, z: 0 } },
+    expected: "success"
+  },
+  {
+    scenario: "Set transform: Location only",
+    toolName: "control_actor",
+    arguments: { action: "set_transform", actorName: "TC_Cube", location: { x: 50, y: 50, z: 50 } },
+    expected: "success"
+  },
+  {
+    scenario: "Set transform: Rotation only",
+    toolName: "control_actor",
+    arguments: { action: "set_transform", actorName: "TC_Cube", rotation: { pitch: 90, yaw: 0, roll: 0 } },
+    expected: "success"
+  },
+  {
+    scenario: "Set transform: Scale only",
+    toolName: "control_actor",
+    arguments: { action: "set_transform", actorName: "TC_Cube", scale: { x: 2, y: 2, z: 2 } },
+    expected: "success"
+  },
+  {
+    scenario: "Error: Get transform non-existent",
+    toolName: "control_actor",
+    arguments: { action: "get_transform", actorName: "NonExistentActor_123" },
+    expected: "error|not_found"
+  },
+  {
+    scenario: "Error: Attach to self (cycle)",
+    toolName: "control_actor",
+    arguments: { action: "attach", childActor: "TC_Cube", parentActor: "TC_Cube" },
+    expected: "error|cycle"
+  },
+  {
+    scenario: "Error: Attach to non-existent parent",
+    toolName: "control_actor",
+    arguments: { action: "attach", childActor: "TC_Cube", parentActor: "NonExistentParent" },
+    expected: "error|not_found"
+  },
+  {
+    scenario: "Error: Attach non-existent child",
+    toolName: "control_actor",
+    arguments: { action: "attach", childActor: "NonExistentChild", parentActor: "TC_Cube" },
+    expected: "error|not_found"
+  },
+  {
+    scenario: "Detach: Not attached (safe)",
+    toolName: "control_actor",
+    arguments: { action: "detach", actorName: "TC_Cube" },
+    expected: "success" // Should be safe/idempotent
+  },
+  {
+    scenario: "Visibility: Non-existent actor",
+    toolName: "control_actor",
+    arguments: { action: "set_visibility", actorName: "NonExistentActor_Vis", visible: true },
+    expected: "error|not_found"
+  },
+  {
+    scenario: "Tags: Add existing tag (idempotent)",
+    toolName: "control_actor",
+    arguments: { action: "add_tag", actorName: "TC_Cube", tag: "TC_Tag" },
+    expected: "success"
+  },
+  {
+    scenario: "Tags: Remove non-existent tag",
+    toolName: "control_actor",
+    arguments: { action: "remove_tag", actorName: "TC_Cube", tag: "NonExistentTag" },
+    expected: "success|not_found"
+  },
+  {
+    scenario: "Tags: Remove existing tag",
+    toolName: "control_actor",
+    arguments: { action: "remove_tag", actorName: "TC_Cube", tag: "TC_Tag" },
+    expected: "success"
+  },
+  {
+    scenario: "Components: Get from non-existent",
+    toolName: "control_actor",
+    arguments: { action: "get_components", actorName: "NonExistentActor_Comp" },
+    expected: "error|not_found"
+  },
+  {
+    scenario: "List actors: All",
+    toolName: "control_actor",
+    arguments: { action: "list" },
+    expected: "success"
+  },
+  {
+    scenario: "Snapshot: Non-existent actor",
+    toolName: "control_actor",
+    arguments: { action: "create_snapshot", actorName: "GhostActor", snapshotName: "Snap1" },
+    expected: "error|not_found"
+  },
+  {
+    scenario: "Duplicate: Non-existent actor",
+    toolName: "control_actor",
+    arguments: { action: "duplicate", actorName: "GhostActor", newName: "GhostCopy" },
+    expected: "error|not_found"
+  },
+  {
+    scenario: "Force: Non-existent actor",
+    toolName: "control_actor",
+    arguments: { action: "apply_force", actorName: "GhostActor", force: { x: 100, y: 0, z: 0 } },
+    expected: "error|not_found"
+  },
+  {
+    scenario: "Spawn: Hidden",
+    toolName: "control_actor",
+    arguments: {
+      action: "spawn",
+      classPath: "/Engine/BasicShapes/Sphere",
+      actorName: "TC_HiddenSphere",
+      properties: { bHidden: true }
+    },
+    expected: "success"
+  },
+  {
+    scenario: "Set properties: Non-existent component",
+    toolName: "control_actor",
+    arguments: {
+      action: "set_component_properties",
+      actorName: "TC_Cube",
+      componentName: "InvalidComp",
+      properties: { Intensity: 5000 }
+    },
+    expected: "error|not_found"
+  },
+  {
+    scenario: "Final Cleanup",
+    toolName: "control_actor",
+    arguments: { action: "delete", actorNames: ["TC_Cube", "TC_HiddenSphere"] },
+    expected: "success"
+  }
+];
+
+await runToolTests('Actor Control', testCases);

package/tests/test-control-editor.mjs

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+/**
+ * Comprehensive Editor Control Test Suite
+ * Tool: control_editor
+ * Coverage: All 24 actions with success, error, and edge cases
+ */
+
+import { runToolTests } from './test-runner.mjs';
+
+const testCases = [
+  // === PRE-FIX ===
+  {
+    scenario: 'Pre-Fix: Remove Invalid Data Layers (Native)',
+    toolName: 'manage_level',
+    arguments: {
+      action: 'cleanup_invalid_datalayers'
+    },
+    expected: 'success'
+  },
+
+  // === PIE CONTROL (play, stop, stop_pie, pause, resume) ===
+  { scenario: 'Start PIE (Play in Editor)', toolName: 'control_editor', arguments: { action: 'play' }, expected: 'success - PIE started' },
+  { scenario: 'Pause PIE', toolName: 'control_editor', arguments: { action: 'pause' }, expected: 'success - PIE paused' },
+  { scenario: 'Resume PIE', toolName: 'control_editor', arguments: { action: 'resume' }, expected: 'success - PIE resumed' },
+  { scenario: 'Stop PIE', toolName: 'control_editor', arguments: { action: 'stop' }, expected: 'success - PIE stopped' },
+  { scenario: 'Stop PIE (alias)', toolName: 'control_editor', arguments: { action: 'stop_pie' }, expected: 'success - PIE stopped' },
+
+  // === GAME SPEED ===
+  { scenario: 'Set game speed 0.5x', toolName: 'control_editor', arguments: { action: 'set_game_speed', speed: 0.5 }, expected: 'success' },
+  { scenario: 'Set game speed 2x', toolName: 'control_editor', arguments: { action: 'set_game_speed', speed: 2.0 }, expected: 'success' },
+  { scenario: 'Set game speed 1x (reset)', toolName: 'control_editor', arguments: { action: 'set_game_speed', speed: 1.0 }, expected: 'success' },
+
+  // === EJECT / POSSESS ===
+  { scenario: 'Eject from possessed pawn', toolName: 'control_editor', arguments: { action: 'eject' }, expected: 'success|handled' },
+  { scenario: 'Possess pawn', toolName: 'control_editor', arguments: { action: 'possess' }, expected: 'success|handled' },
+
+  // === CAMERA CONTROL ===
+  { scenario: 'Set camera location and rotation', toolName: 'control_editor', arguments: { action: 'set_camera', location: { x: 0, y: 0, z: 500 }, rotation: { pitch: -45, yaw: 0, roll: 0 } }, expected: 'success - camera set' },
+  { scenario: 'Set camera position only', toolName: 'control_editor', arguments: { action: 'set_camera_position', location: { x: 100, y: 100, z: 300 } }, expected: 'success' },
+  { scenario: 'Set camera rotation only', toolName: 'control_editor', arguments: { action: 'set_camera', rotation: { pitch: -30, yaw: 45, roll: 0 } }, expected: 'success' },
+  { scenario: 'Focus camera on actor', toolName: 'control_editor', arguments: { action: 'set_camera', targetActor: 'TC_Cube' }, expected: 'success - camera focused' },
+  { scenario: 'Set camera FOV 90', toolName: 'control_editor', arguments: { action: 'set_camera_fov', fov: 90 }, expected: 'success' },
+  { scenario: 'Set camera FOV 60', toolName: 'control_editor', arguments: { action: 'set_camera_fov', fov: 60 }, expected: 'success' },
+  { scenario: 'Set camera FOV extreme (120)', toolName: 'control_editor', arguments: { action: 'set_camera_fov', fov: 120 }, expected: 'success' },
+
+  // === VIEW MODE ===
+  { scenario: 'Set view mode to Lit', toolName: 'control_editor', arguments: { action: 'set_view_mode', viewMode: 'Lit' }, expected: 'success - view mode set' },
+  { scenario: 'Set view mode to Wireframe', toolName: 'control_editor', arguments: { action: 'set_view_mode', viewMode: 'Wireframe' }, expected: 'success - view mode set' },
+  { scenario: 'Set view mode to Unlit', toolName: 'control_editor', arguments: { action: 'set_view_mode', viewMode: 'Unlit' }, expected: 'success' },
+  { scenario: 'Set view mode to PathTracing', toolName: 'control_editor', arguments: { action: 'set_view_mode', viewMode: 'PathTracing' }, expected: 'success|not_supported' },
+
+  // === VIEWPORT SETTINGS ===
+  { scenario: 'Set viewport resolution 1920x1080', toolName: 'control_editor', arguments: { action: 'set_viewport_resolution', width: 1920, height: 1080 }, expected: 'success' },
+  { scenario: 'Set viewport resolution 1280x720', toolName: 'control_editor', arguments: { action: 'set_viewport_resolution', width: 1280, height: 720 }, expected: 'success' },
+  { scenario: 'Set viewport realtime on', toolName: 'control_editor', arguments: { action: 'set_viewport_realtime', enabled: true }, expected: 'success' },
+  { scenario: 'Set viewport realtime off', toolName: 'control_editor', arguments: { action: 'set_viewport_realtime', enabled: false }, expected: 'success' },
+
+  // === SCREENSHOT ===
+  { scenario: 'Take screenshot', toolName: 'control_editor', arguments: { action: 'screenshot', filename: 'TC_Screenshot' }, expected: 'success - screenshot taken' },
+  { scenario: 'Take screenshot with resolution', toolName: 'control_editor', arguments: { action: 'screenshot', filename: 'TC_Screenshot_HD', width: 1920, height: 1080 }, expected: 'success' },
+
+  // === RECORDING ===
+  { scenario: 'Start recording', toolName: 'control_editor', arguments: { action: 'start_recording', filename: 'TC_Record', frameRate: 30 }, expected: 'success - recording started' },
+  { scenario: 'Stop recording', toolName: 'control_editor', arguments: { action: 'stop_recording' }, expected: 'success - recording stopped' },
+
+  // === FRAME STEPPING ===
+  { scenario: 'Step single frame', toolName: 'control_editor', arguments: { action: 'step_frame' }, expected: 'success - frame stepped' },
+  { scenario: 'Step multiple frames', toolName: 'control_editor', arguments: { action: 'step_frame', steps: 5 }, expected: 'success' },
+
+  // === BOOKMARKS ===
+  { scenario: 'Create camera bookmark', toolName: 'control_editor', arguments: { action: 'create_bookmark', bookmarkName: 'TC_Bookmark_1' }, expected: 'success - bookmark created' },
+  { scenario: 'Create second bookmark', toolName: 'control_editor', arguments: { action: 'create_bookmark', bookmarkName: 'TC_Bookmark_2' }, expected: 'success' },
+  { scenario: 'Jump to bookmark 1', toolName: 'control_editor', arguments: { action: 'jump_to_bookmark', bookmarkName: 'TC_Bookmark_1' }, expected: 'success - jumped to bookmark' },
+  { scenario: 'Jump to bookmark 2', toolName: 'control_editor', arguments: { action: 'jump_to_bookmark', bookmarkName: 'TC_Bookmark_2' }, expected: 'success' },
+
+  // === PREFERENCES ===
+  { scenario: 'Set editor preferences - grid', toolName: 'control_editor', arguments: { action: 'set_preferences', category: 'Editor', preferences: { UseGrid: true, SnapToGrid: true } }, expected: 'success - editor preferences set' },
+  { scenario: 'Set editor preferences - realtime', toolName: 'control_editor', arguments: { action: 'set_preferences', category: 'Viewport', preferences: { bRealtimeUpdate: true } }, expected: 'success' },
+
+  // === CONSOLE COMMANDS ===
+  { scenario: 'Execute console command (stat fps)', toolName: 'control_editor', arguments: { action: 'execute_command', command: 'stat fps' }, expected: 'success' },
+  { scenario: 'Console command (alias)', toolName: 'control_editor', arguments: { action: 'console_command', command: 'stat unit' }, expected: 'success' },
+  { scenario: 'Console command - toggle stat', toolName: 'control_editor', arguments: { action: 'console_command', command: 'stat none' }, expected: 'success' },
+
+  // === OPEN ASSET ===
+  { scenario: 'Open asset in editor', toolName: 'control_editor', arguments: { action: 'open_asset', assetPath: '/Engine/BasicShapes/Cube' }, expected: 'success' },
+  { scenario: 'Open material asset', toolName: 'control_editor', arguments: { action: 'open_asset', assetPath: '/Engine/EngineMaterials/DefaultMaterial' }, expected: 'success' },
+
+  // === SIMULATE INPUT ===
+  { scenario: 'Simulate key press W', toolName: 'control_editor', arguments: { action: 'simulate_input', keyName: 'W', eventType: 'KeyDown' }, expected: 'success' },
+  { scenario: 'Simulate key release W', toolName: 'control_editor', arguments: { action: 'simulate_input', keyName: 'W', eventType: 'KeyUp' }, expected: 'success' },
+  { scenario: 'Simulate key press and release Space', toolName: 'control_editor', arguments: { action: 'simulate_input', keyName: 'SpaceBar', eventType: 'Both' }, expected: 'success' },
+
+  // === ERROR CASES ===
+  { scenario: 'Error: Invalid view mode', toolName: 'control_editor', arguments: { action: 'set_view_mode', viewMode: 'InvalidMode' }, expected: 'error|unknown_viewmode' },
+  { scenario: 'Error: Invalid bookmark', toolName: 'control_editor', arguments: { action: 'jump_to_bookmark', bookmarkName: 'NonExistent_Bookmark_XYZ' }, expected: 'error|not_found' },
+  { scenario: 'Error: Empty command', toolName: 'control_editor', arguments: { action: 'console_command', command: '' }, expected: 'error|empty' },
+  { scenario: 'Error: Invalid resolution', toolName: 'control_editor', arguments: { action: 'set_viewport_resolution', width: -100, height: -100 }, expected: 'error|validation' },
+  { scenario: 'Error: Open non-existent asset', toolName: 'control_editor', arguments: { action: 'open_asset', assetPath: '/Game/NonExistent/Asset' }, expected: 'error|not_found' },
+  { scenario: 'Error: Screenshot invalid resolution', toolName: 'control_editor', arguments: { action: 'screenshot', resolution: 'invalidxres' }, expected: 'error' },
+
+  // === EDGE CASES ===
+  { scenario: 'Edge: Extreme FOV (1 degree)', toolName: 'control_editor', arguments: { action: 'set_camera_fov', fov: 1 }, expected: 'success' },
+  { scenario: 'Edge: Negative speed', toolName: 'control_editor', arguments: { action: 'set_game_speed', speed: -1 }, expected: 'success|handled' },
+  { scenario: 'Edge: Zero speed (frozen)', toolName: 'control_editor', arguments: { action: 'set_game_speed', speed: 0 }, expected: 'success' },
+  { scenario: 'Edge: Very high speed', toolName: 'control_editor', arguments: { action: 'set_game_speed', speed: 10.0 }, expected: 'success' },
+
+  // === TIMEOUT TEST ===
+  { scenario: 'Timeout short fail', toolName: 'control_editor', arguments: { action: 'play', timeoutMs: 1 }, expected: 'timeout|error' }
+];
+
+await runToolTests('Editor Control', testCases);