unreal-engine-mcp-server 0.5.4 → 0.5.6

package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeSubsystem.cpp

@@ -1,846 +0,0 @@
-// Ensure the subsystem type and bridge socket types are available
-#include "McpAutomationBridgeSubsystem.h"
-#include "HAL/PlatformFilemanager.h"
-#include "HAL/PlatformTime.h"
-#include "McpAutomationBridgeGlobals.h"
-#include "McpAutomationBridgeSettings.h"
-#include "McpBridgeWebSocket.h"
-#include "McpConnectionManager.h"
-#include "Misc/FileHelper.h"
-#include "Misc/Guid.h"
-#include "Misc/Paths.h"
-#include "Serialization/JsonReader.h"
-#include "Serialization/JsonSerializer.h"
-
-// Define the subsystem log category declared in the public header.
-DEFINE_LOG_CATEGORY(LogMcpAutomationBridgeSubsystem);
-
-// Sanitize incoming text for logging: replace control characters with
-// '?' and truncate long messages so logs remain readable and do not
-// attempt to render unprintable glyphs in the editor which can spam
-/**
- * @brief Produces a log-safe copy of a string by replacing control characters
- * and truncating long input.
- *
- * Creates a sanitized version of the input string where characters with code
- * points less than 32 or equal to 127 are replaced with '?' and the result is
- * truncated to 512 characters with "[TRUNCATED]" appended if the input is
- * longer.
- *
- * @param In Input string to sanitize.
- * @return FString Sanitized string suitable for logging.
- */
-static inline FString SanitizeForLog(const FString &In) {
-  if (In.IsEmpty())
-    return FString();
-  FString Out;
-  Out.Reserve(FMath::Min<int32>(In.Len(), 1024));
-  for (int32 i = 0; i < In.Len(); ++i) {
-    const TCHAR C = In[i];
-    if (C >= 32 && C != 127)
-      Out.AppendChar(C);
-    else
-      Out.AppendChar('?');
-  }
-  if (Out.Len() > 512)
-    Out = Out.Left(512) + TEXT("[TRUNCATED]");
-  return Out;
-}
-
-/**
- * @brief Initialize the automation bridge subsystem, preparing networking,
- * handlers, and periodic processing.
- *
- * Creates and initializes the connection manager, registers automation action
- * handlers and a message-received callback, starts the connection manager, and
- * registers a recurring ticker to process pending automation requests.
- *
- * @param Collection Subsystem collection provided by the engine during
- * initialization.
- */
-void UMcpAutomationBridgeSubsystem::Initialize(
-    FSubsystemCollectionBase &Collection) {
-  Super::Initialize(Collection);
-
-  UE_LOG(LogMcpAutomationBridgeSubsystem, Log,
-         TEXT("McpAutomationBridgeSubsystem initializing."));
-
-  // Create and initialize the connection manager
-  ConnectionManager = MakeShared<FMcpConnectionManager>();
-  ConnectionManager->Initialize(GetDefault<UMcpAutomationBridgeSettings>());
-
-  // Bind message received delegate
-  ConnectionManager->SetOnMessageReceived(
-      FMcpMessageReceivedCallback::CreateWeakLambda(
-          this, [this](const FString &RequestId, const FString &Action,
-                       const TSharedPtr<FJsonObject> &Payload,
-                       TSharedPtr<FMcpBridgeWebSocket> Socket) {
-            ProcessAutomationRequest(RequestId, Action, Payload, Socket);
-          }));
-
-  // Initialize the handler registry
-  InitializeHandlers();
-
-  // Start the connection manager
-  ConnectionManager->Start();
-
-  // Register Ticker
-  TickHandle = FTSTicker::GetCoreTicker().AddTicker(
-      FTickerDelegate::CreateUObject(this,
-                                     &UMcpAutomationBridgeSubsystem::Tick),
-      0.1f // Tick every 0.1s is sufficient for automation queue processing
-  );
-
-  UE_LOG(LogMcpAutomationBridgeSubsystem, Log,
-         TEXT("McpAutomationBridgeSubsystem Initialized."));
-}
-
-/**
- * @brief Shuts down the MCP Automation Bridge subsystem and releases its
- * resources.
- *
- * Removes the registered ticker, stops and clears the connection manager,
- * detaches and clears the log capture device, and calls the superclass
- * deinitialization.
- */
-void UMcpAutomationBridgeSubsystem::Deinitialize() {
-  if (TickHandle.IsValid()) {
-    FTSTicker::GetCoreTicker().RemoveTicker(TickHandle);
-    TickHandle.Reset();
-  }
-
-  UE_LOG(LogMcpAutomationBridgeSubsystem, Log,
-         TEXT("McpAutomationBridgeSubsystem deinitializing."));
-
-  if (ConnectionManager.IsValid()) {
-    ConnectionManager->Stop();
-    ConnectionManager.Reset();
-  }
-
-  if (LogCaptureDevice.IsValid()) {
-    if (GLog)
-      GLog->RemoveOutputDevice(LogCaptureDevice.Get());
-    LogCaptureDevice.Reset();
-  }
-
-  Super::Deinitialize();
-}
-
-/**
- * @brief Reports whether the automation bridge currently has any active
- * connections.
- *
- * @return `true` if the connection manager exists and has one or more active
- * sockets, `false` otherwise.
- */
-bool UMcpAutomationBridgeSubsystem::IsBridgeActive() const {
-  return ConnectionManager.IsValid() &&
-         ConnectionManager->GetActiveSocketCount() > 0;
-}
-
-/**
- * @brief Determine the bridge's connection state from active sockets.
- *
- * @return EMcpAutomationBridgeState `EMcpAutomationBridgeState::Connected` if
- * one or more active sockets are present,
- * `EMcpAutomationBridgeState::Disconnected` otherwise.
- */
-EMcpAutomationBridgeState
-UMcpAutomationBridgeSubsystem::GetBridgeState() const {
-  // Map connection manager state if needed, for now just check if we have
-  // active sockets
-  return IsBridgeActive() ? EMcpAutomationBridgeState::Connected
-                          : EMcpAutomationBridgeState::Disconnected;
-}
-
-/**
- * @brief Forward a raw text message to the connection manager for transmission.
- *
- * @param Message The raw message string to send.
- * @return `true` if the connection manager accepted the message for sending,
- * `false` otherwise.
- */
-bool UMcpAutomationBridgeSubsystem::SendRawMessage(const FString &Message) {
-  if (ConnectionManager.IsValid()) {
-    return ConnectionManager->SendRawMessage(Message);
-  }
-  return false;
-}
-
-/**
- * @brief Per-frame tick that processes deferred automation requests when it is
- * safe to do so.
- *
- * Invokes processing of any pending automation requests that were previously
- * deferred due to unsafe engine states (saving, garbage collection, or async
- * loading).
- *
- * @param DeltaTime Time elapsed since the last tick, in seconds.
- * @return true to remain registered and continue receiving ticks.
- */
-bool UMcpAutomationBridgeSubsystem::Tick(float DeltaTime) {
-  // Check if we have pending requests that were deferred due to unsafe engine
-  // states
-  if (bPendingRequestsScheduled && !GIsSavingPackage &&
-      !IsGarbageCollecting() && !IsAsyncLoading()) {
-    ProcessPendingAutomationRequests();
-  }
-  return true;
-}
-
-// The in-file implementation of ProcessAutomationRequest was intentionally
-// removed from this translation unit. The function is now implemented in
-// McpAutomationBridge_ProcessRequest.cpp to avoid duplicate definitions and
-// to keep this file focused. See that file for the full request dispatcher
-/**
- * @brief Sends an automation response for a specific request to the given
- * socket.
- *
- * If the connection manager is not available this call is a no-op.
- *
- * @param TargetSocket WebSocket to which the response will be sent.
- * @param RequestId Identifier of the automation request being responded to.
- * @param bSuccess `true` if the request succeeded, `false` otherwise.
- * @param Message Human-readable message or description associated with the
- * response.
- * @param Result Optional JSON object containing result data; may be null.
- * @param ErrorCode Error code string to include when `bSuccess` is `false`.
- */
-
-void UMcpAutomationBridgeSubsystem::SendAutomationResponse(
-    TSharedPtr<FMcpBridgeWebSocket> TargetSocket, const FString &RequestId,
-    const bool bSuccess, const FString &Message,
-    const TSharedPtr<FJsonObject> &Result, const FString &ErrorCode) {
-  if (ConnectionManager.IsValid()) {
-    ConnectionManager->SendAutomationResponse(TargetSocket, RequestId, bSuccess,
-                                              Message, Result, ErrorCode);
-  }
-}
-
-/**
- * @brief Log a failure and send a standardized automation error response.
- *
- * Resolves an empty ErrorCode to "AUTOMATION_ERROR", logs a sanitized warning
- * with the resolved error and message, and sends a failure response for the
- * specified request.
- *
- * @param TargetSocket Optional socket to target the response; may be null to
- * broadcast or use a default.
- * @param RequestId Identifier of the automation request that failed.
- * @param Message Human-readable failure message.
- * @param ErrorCode Error code to include with the response; "AUTOMATION_ERROR"
- * is used if empty.
- */
-void UMcpAutomationBridgeSubsystem::SendAutomationError(
-    TSharedPtr<FMcpBridgeWebSocket> TargetSocket, const FString &RequestId,
-    const FString &Message, const FString &ErrorCode) {
-  const FString ResolvedError =
-      ErrorCode.IsEmpty() ? TEXT("AUTOMATION_ERROR") : ErrorCode;
-  UE_LOG(LogMcpAutomationBridgeSubsystem, Warning,
-         TEXT("Automation request failed (%s): %s"), *ResolvedError,
-         *SanitizeForLog(Message));
-  SendAutomationResponse(TargetSocket, RequestId, false, Message, nullptr,
-                         ResolvedError);
-}
-
-/**
- * @brief Records telemetry for an automation request with outcome details.
- *
- * Forwards the request identifier, success flag, human-readable message, and
- * error code to the connection manager for telemetry/logging.
- *
- * @param RequestId Unique identifier of the automation request.
- * @param bSuccess `true` if the request completed successfully, `false`
- * otherwise.
- * @param Message Human-readable message describing the outcome or context.
- * @param ErrorCode Short error identifier (empty if none).
- */
-void UMcpAutomationBridgeSubsystem::RecordAutomationTelemetry(
-    const FString &RequestId, const bool bSuccess, const FString &Message,
-    const FString &ErrorCode) {
-  if (ConnectionManager.IsValid()) {
-    ConnectionManager->RecordAutomationTelemetry(RequestId, bSuccess, Message,
-                                                 ErrorCode);
-  }
-}
-
-/**
- * @brief Registers an automation action handler for the given action string.
- *
- * If a non-empty handler is provided, stores it under Action (replacing any
- * existing handler for the same key). If Handler is null/invalid, the call is a
- * no-op.
- *
- * @param Action The action identifier string used to look up the handler.
- * @param Handler Callable invoked when the specified action is requested.
- */
-void UMcpAutomationBridgeSubsystem::RegisterHandler(
-    const FString &Action, FAutomationHandler Handler) {
-  if (Handler) {
-    AutomationHandlers.Add(Action, Handler);
-  }
-}
-
-/**
- * @brief Registers all automation action handlers used by the MCP Automation
- * Bridge.
- *
- * Populates the subsystem's handler registry with mappings from action name
- * strings (for example: core/property actions, array/map/set container ops,
- * asset dependency queries, console/system and editor tooling actions,
- * blueprint/world/asset management, rendering/materials, input/control,
- * audio/lighting/physics/effects, and performance actions) to the functions
- * that handle those actions so incoming automation requests can be dispatched
- * by action name.
- *
- * This also registers a few common alias actions (e.g., "create_effect",
- * "clear_debug_shapes") so those actions dispatch directly to the intended
- * handler.
- */
-void UMcpAutomationBridgeSubsystem::InitializeHandlers() {
-  // Core & Properties
-  RegisterHandler(TEXT("execute_editor_function"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleExecuteEditorFunction(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("set_object_property"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleSetObjectProperty(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("get_object_property"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleGetObjectProperty(R, A, P, S);
-                  });
-
-  // Containers (Arrays, Maps, Sets)
-  RegisterHandler(TEXT("array_append"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleArrayAppend(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("array_remove"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleArrayRemove(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("array_insert"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleArrayInsert(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("array_get_element"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleArrayGetElement(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("array_set_element"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleArraySetElement(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("array_clear"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleArrayClear(R, A, P, S);
-                  });
-
-  RegisterHandler(TEXT("map_set_value"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleMapSetValue(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("map_get_value"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleMapGetValue(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("map_remove_key"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleMapRemoveKey(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("map_has_key"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleMapHasKey(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("map_get_keys"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleMapGetKeys(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("map_clear"), [this](const FString &R, const FString &A,
-                                            const TSharedPtr<FJsonObject> &P,
-                                            TSharedPtr<FMcpBridgeWebSocket> S) {
-    return HandleMapClear(R, A, P, S);
-  });
-
-  RegisterHandler(TEXT("set_add"), [this](const FString &R, const FString &A,
-                                          const TSharedPtr<FJsonObject> &P,
-                                          TSharedPtr<FMcpBridgeWebSocket> S) {
-    return HandleSetAdd(R, A, P, S);
-  });
-  RegisterHandler(TEXT("set_remove"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleSetRemove(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("set_contains"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleSetContains(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("set_clear"), [this](const FString &R, const FString &A,
-                                            const TSharedPtr<FJsonObject> &P,
-                                            TSharedPtr<FMcpBridgeWebSocket> S) {
-    return HandleSetClear(R, A, P, S);
-  });
-
-  // Asset Dependency
-  RegisterHandler(TEXT("get_asset_references"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleGetAssetReferences(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("get_asset_dependencies"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleGetAssetDependencies(R, A, P, S);
-                  });
-
-  // Asset Workflow
-  RegisterHandler(TEXT("fixup_redirectors"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleFixupRedirectors(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("source_control_checkout"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleSourceControlCheckout(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("source_control_submit"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleSourceControlSubmit(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("bulk_rename_assets"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleBulkRenameAssets(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("bulk_delete_assets"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleBulkDeleteAssets(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("generate_thumbnail"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleGenerateThumbnail(R, A, P, S);
-                  });
-
-  // Landscape
-  RegisterHandler(TEXT("create_landscape"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleCreateLandscape(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("create_procedural_terrain"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleCreateProceduralTerrain(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("create_landscape_grass_type"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleCreateLandscapeGrassType(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("sculpt_landscape"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleSculptLandscape(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("set_landscape_material"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleSetLandscapeMaterial(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("edit_landscape"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleEditLandscape(R, A, P, S);
-                  });
-
-  // Foliage
-  RegisterHandler(TEXT("add_foliage_type"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleAddFoliageType(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("create_procedural_foliage"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleCreateProceduralFoliage(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("paint_foliage"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandlePaintFoliage(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("add_foliage_instances"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleAddFoliageInstances(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("remove_foliage"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleRemoveFoliage(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("get_foliage_instances"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleGetFoliageInstances(R, A, P, S);
-                  });
-
-  // Niagara
-  RegisterHandler(TEXT("create_niagara_system"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleCreateNiagaraSystem(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("create_niagara_ribbon"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleCreateNiagaraRibbon(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("create_niagara_emitter"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleCreateNiagaraEmitter(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("spawn_niagara_actor"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleSpawnNiagaraActor(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("modify_niagara_parameter"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleModifyNiagaraParameter(R, A, P, S);
-                  });
-
-  // Animation
-  RegisterHandler(TEXT("create_anim_blueprint"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleCreateAnimBlueprint(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("play_anim_montage"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandlePlayAnimMontage(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("setup_ragdoll"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleSetupRagdoll(R, A, P, S);
-                  });
-
-  // Material Graph
-  RegisterHandler(TEXT("add_material_texture_sample"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleAddMaterialTextureSample(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("add_material_expression"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleAddMaterialExpression(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("create_material_nodes"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleCreateMaterialNodes(R, A, P, S);
-                  });
-
-  // Sequencer
-  RegisterHandler(TEXT("add_sequencer_keyframe"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleAddSequencerKeyframe(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("manage_sequencer_track"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleManageSequencerTrack(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("add_camera_track"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleAddCameraTrack(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("add_animation_track"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleAddAnimationTrack(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("add_transform_track"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleAddTransformTrack(R, A, P, S);
-                  });
-
-  // UI & Environment
-  RegisterHandler(TEXT("manage_ui"), [this](const FString &R, const FString &A,
-                                            const TSharedPtr<FJsonObject> &P,
-                                            TSharedPtr<FMcpBridgeWebSocket> S) {
-    return HandleUiAction(R, A, P, S);
-  });
-  RegisterHandler(TEXT("control_environment"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleControlEnvironmentAction(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("build_environment"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleBuildEnvironmentAction(R, A, P, S);
-                  });
-
-  // Tools & System
-  RegisterHandler(TEXT("console_command"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleConsoleCommandAction(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("inspect"), [this](const FString &R, const FString &A,
-                                          const TSharedPtr<FJsonObject> &P,
-                                          TSharedPtr<FMcpBridgeWebSocket> S) {
-    return HandleInspectAction(R, A, P, S);
-  });
-  RegisterHandler(TEXT("system_control"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleSystemControlAction(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("manage_blueprint_graph"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleBlueprintGraphAction(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("list_blueprints"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleListBlueprints(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("manage_world_partition"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleWorldPartitionAction(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("manage_render"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleRenderAction(R, A, P, S);
-                  });
-
-  RegisterHandler(TEXT("manage_input"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleInputAction(R, A, P, S);
-                  });
-
-  RegisterHandler(TEXT("control_actor"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleControlActorAction(R, A, P, S);
-                  });
-
-  RegisterHandler(TEXT("manage_level"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleLevelAction(R, A, P, S);
-                  });
-
-  RegisterHandler(TEXT("manage_sequence"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleSequenceAction(R, A, P, S);
-                  });
-
-  RegisterHandler(TEXT("manage_asset"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleAssetAction(R, A, P, S);
-                  });
-
-  RegisterHandler(TEXT("rebuild_material"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleRebuildMaterial(R, P, S);
-                  });
-
-  RegisterHandler(TEXT("manage_behavior_tree"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleBehaviorTreeAction(R, A, P, S);
-                  });
-
-  RegisterHandler(TEXT("manage_audio"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleAudioAction(R, A, P, S);
-                  });
-
-  RegisterHandler(TEXT("manage_lighting"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleLightingAction(R, A, P, S);
-                  });
-
-  RegisterHandler(TEXT("manage_physics"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleAnimationPhysicsAction(R, A, P, S);
-                  });
-
-  RegisterHandler(TEXT("manage_effect"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleEffectAction(R, A, P, S);
-                  });
-
-  // Common effect aliases used by the Node server; registering them here keeps
-  // dispatch O(1) and avoids relying on the late handler chain.
-  RegisterHandler(TEXT("create_effect"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleEffectAction(R, A, P, S);
-                  });
-  RegisterHandler(TEXT("clear_debug_shapes"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandleEffectAction(R, A, P, S);
-                  });
-
-  RegisterHandler(TEXT("manage_performance"),
-                  [this](const FString &R, const FString &A,
-                         const TSharedPtr<FJsonObject> &P,
-                         TSharedPtr<FMcpBridgeWebSocket> S) {
-                    return HandlePerformanceAction(R, A, P, S);
-                  });
-}
-
-// Drain and process any automation requests that were enqueued while the
-// subsystem was busy. This implementation lives in the primary subsystem
-// translation unit to ensure the symbol is available at link time for
-/**
- * @brief Processes all queued automation requests on the game thread.
- *
- * Ensures execution on the game thread (re-dispatches if called from another
- * thread), moves the shared pending-request queue into a local list under a
- * lock, clears the shared queue and the scheduled flag, then dispatches each
- * request to ProcessAutomationRequest.
- */
-void UMcpAutomationBridgeSubsystem::ProcessPendingAutomationRequests() {
-  if (!IsInGameThread()) {
-    AsyncTask(ENamedThreads::GameThread,
-              [this]() { this->ProcessPendingAutomationRequests(); });
-    return;
-  }
-
-  TArray<FPendingAutomationRequest> LocalQueue;
-  {
-    FScopeLock Lock(&PendingAutomationRequestsMutex);
-    if (PendingAutomationRequests.Num() == 0) {
-      bPendingRequestsScheduled = false;
-      return;
-    }
-    LocalQueue = MoveTemp(PendingAutomationRequests);
-    PendingAutomationRequests.Empty();
-    bPendingRequestsScheduled = false;
-  }
-
-  for (const FPendingAutomationRequest &Req : LocalQueue) {
-    ProcessAutomationRequest(Req.RequestId, Req.Action, Req.Payload,
-                             Req.RequestingSocket);
-  }
-}