unreal-engine-mcp-server 0.5.3 → 0.5.5

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

@@ -1,2393 +0,0 @@
-#include "McpAutomationBridgeGlobals.h"
-#include "McpAutomationBridgeHelpers.h"
-#include "McpAutomationBridgeSubsystem.h"
-
-#if WITH_EDITOR
-#include "Animation/AnimBlueprint.h"
-#include "Animation/AnimBlueprintGeneratedClass.h"
-#include "Animation/AnimMontage.h"
-#include "Animation/AnimSequence.h"
-#include "Animation/AnimationAsset.h"
-#include "Animation/Skeleton.h"
-#include "Engine/SkeletalMesh.h"
-
-#if __has_include("Animation/AnimationBlueprintLibrary.h")
-#include "Animation/AnimationBlueprintLibrary.h"
-#elif __has_include("AnimationBlueprintLibrary.h")
-#include "AnimationBlueprintLibrary.h"
-#endif
-#if __has_include("Animation/AnimBlueprintLibrary.h")
-#include "Animation/AnimBlueprintLibrary.h"
-#endif
-#include "Animation/BlendSpace.h"
-#include "Animation/BlendSpace1D.h"
-#include "Editor.h"
-#include "Editor/EditorEngine.h"
-#include "EngineUtils.h"
-#include "RenderingThread.h"
-
-#if __has_include("Animation/BlendSpaceBase.h")
-#include "Animation/BlendSpaceBase.h"
-#define MCP_HAS_BLENDSPACE_BASE 1
-#elif __has_include("BlendSpaceBase.h")
-#include "BlendSpaceBase.h"
-#define MCP_HAS_BLENDSPACE_BASE 1
-#else
-#include "Animation/AnimTypes.h"
-#define MCP_HAS_BLENDSPACE_BASE 0
-#endif
-#if __has_include("Factories/BlendSpaceFactoryNew.h") &&                       \
-                  __has_include("Factories/BlendSpaceFactory1D.h")
-#include "Factories/BlendSpaceFactory1D.h"
-#include "Factories/BlendSpaceFactoryNew.h"
-
-#define MCP_HAS_BLENDSPACE_FACTORY 1
-#else
-#define MCP_HAS_BLENDSPACE_FACTORY 0
-#endif
-#include "ControlRig.h"
-// ControlRig headers removed for dynamic loading compatibility
-// #include "ControlRigBlueprint.h" etc.
-#include "AssetRegistry/AssetRegistryModule.h"
-#include "AssetToolsModule.h"
-#include "EditorAssetLibrary.h"
-#include "Factories/AnimBlueprintFactory.h"
-#include "Factories/AnimMontageFactory.h"
-#include "Factories/AnimSequenceFactory.h"
-#include "Factories/PhysicsAssetFactory.h"
-#include "Kismet2/BlueprintEditorUtils.h"
-#include "Misc/PackageName.h"
-#include "Misc/Paths.h"
-#include "Modules/ModuleManager.h"
-#include "PhysicsEngine/PhysicsAsset.h"
-
-#if __has_include("Subsystems/EditorActorSubsystem.h")
-#include "Subsystems/EditorActorSubsystem.h"
-#elif __has_include("EditorActorSubsystem.h")
-#include "EditorActorSubsystem.h"
-#endif
-#if __has_include("Subsystems/AssetEditorSubsystem.h")
-#include "Subsystems/AssetEditorSubsystem.h"
-#define MCP_HAS_ASSET_EDITOR_SUBSYSTEM 1
-#elif __has_include("AssetEditorSubsystem.h")
-#include "AssetEditorSubsystem.h"
-#define MCP_HAS_ASSET_EDITOR_SUBSYSTEM 1
-#else
-#define MCP_HAS_ASSET_EDITOR_SUBSYSTEM 0
-#endif
-#include "UObject/Script.h"
-#include "UObject/UnrealType.h"
-
-namespace {
-#if MCP_HAS_BLENDSPACE_FACTORY
-/**
- * @brief Creates a new 1D or 2D Blend Space asset bound to a target skeleton.
- *
- * Creates and returns a newly created UBlendSpace (2D) or UBlendSpace1D (1D)
- * asset using the appropriate factory and places it at the given package path.
- *
- * @param AssetName Name to assign to the new asset.
- * @param PackagePath Package path where the asset will be created (e.g.
- * "/Game/Animations").
- * @param TargetSkeleton Skeleton to bind the created Blend Space to.
- * @param bTwoDimensional If true, creates a 2D UBlendSpace; if false, creates a
- * 1D UBlendSpace1D.
- * @param OutError Receives a human-readable error message on failure.
- * @return UObject* Pointer to the created blend space asset on success, or
- * `nullptr` on failure.
- */
-static UObject *CreateBlendSpaceAsset(const FString &AssetName,
-                                      const FString &PackagePath,
-                                      USkeleton *TargetSkeleton,
-                                      bool bTwoDimensional, FString &OutError) {
-  OutError.Reset();
-
-  UFactory *Factory = nullptr;
-  UClass *DesiredClass = nullptr;
-
-  if (bTwoDimensional) {
-    UBlendSpaceFactoryNew *Factory2D = NewObject<UBlendSpaceFactoryNew>();
-    if (!Factory2D) {
-      OutError = TEXT("Failed to allocate BlendSpace factory");
-      return nullptr;
-    }
-    Factory2D->TargetSkeleton = TargetSkeleton;
-    Factory = Factory2D;
-    DesiredClass = UBlendSpace::StaticClass();
-  } else {
-    UBlendSpaceFactory1D *Factory1D = NewObject<UBlendSpaceFactory1D>();
-    if (!Factory1D) {
-      OutError = TEXT("Failed to allocate BlendSpace1D factory");
-      return nullptr;
-    }
-    Factory1D->TargetSkeleton = TargetSkeleton;
-    Factory = Factory1D;
-    DesiredClass = UBlendSpace1D::StaticClass();
-  }
-
-  if (!Factory || !DesiredClass) {
-    OutError = TEXT("BlendSpace factory unavailable");
-    return nullptr;
-  }
-
-  FAssetToolsModule &AssetToolsModule =
-      FModuleManager::LoadModuleChecked<FAssetToolsModule>(TEXT("AssetTools"));
-  return AssetToolsModule.Get().CreateAsset(AssetName, PackagePath,
-                                            DesiredClass, Factory);
-}
-
-/**
- * @brief Applies axis range and grid configuration to a blend space asset.
- *
- * Reads numeric fields from the provided JSON payload and updates the blend
- * space's first axis (minX, maxX, gridX) and, if bTwoDimensional is true,
- * the second axis (minY, maxY, gridY). Marks the asset package dirty when
- * modifications are applied.
- *
- * @param BlendSpaceAsset Blend space or blend space base object to configure.
- *                       If null, the function is a no-op.
- * @param Payload JSON object containing axis configuration fields:
- *                - "minX", "maxX", "gridX" for axis 0 (required defaults:
- * 0,1,3)
- *                - "minY", "maxY", "gridY" for axis 1 when bTwoDimensional is
- * true
- * @param bTwoDimensional If true, the second axis is also configured.
- *
- * Notes:
- * - If the engine headers/types required to modify blend parameters are
- *   unavailable, the function logs and skips axis configuration.
- * - Grid values are clamped to a minimum of 1.
- */
-static void ApplyBlendSpaceConfiguration(UObject *BlendSpaceAsset,
-                                         const TSharedPtr<FJsonObject> &Payload,
-                                         bool bTwoDimensional) {
-  if (!BlendSpaceAsset || !Payload.IsValid()) {
-    return;
-  }
-
-  double MinX = 0.0, MaxX = 1.0, GridX = 3.0;
-  Payload->TryGetNumberField(TEXT("minX"), MinX);
-  Payload->TryGetNumberField(TEXT("maxX"), MaxX);
-  Payload->TryGetNumberField(TEXT("gridX"), GridX);
-
-#if MCP_HAS_BLENDSPACE_BASE
-  if (UBlendSpaceBase *BlendBase = Cast<UBlendSpaceBase>(BlendSpaceAsset)) {
-    BlendBase->Modify();
-
-    FBlendParameter &Axis0 =
-        const_cast<FBlendParameter &>(BlendBase->GetBlendParameter(0));
-    Axis0.Min = static_cast<float>(MinX);
-    Axis0.Max = static_cast<float>(MaxX);
-    Axis0.GridNum = FMath::Max(1, static_cast<int32>(GridX));
-
-    if (bTwoDimensional) {
-      double MinY = 0.0, MaxY = 1.0, GridY = 3.0;
-      Payload->TryGetNumberField(TEXT("minY"), MinY);
-      Payload->TryGetNumberField(TEXT("maxY"), MaxY);
-      Payload->TryGetNumberField(TEXT("gridY"), GridY);
-
-      FBlendParameter &Axis1 =
-          const_cast<FBlendParameter &>(BlendBase->GetBlendParameter(1));
-      Axis1.Min = static_cast<float>(MinY);
-      Axis1.Max = static_cast<float>(MaxY);
-      Axis1.GridNum = FMath::Max(1, static_cast<int32>(GridY));
-    }
-
-    BlendBase->MarkPackageDirty();
-  }
-#else
-  UE_LOG(LogMcpAutomationBridgeSubsystem, Verbose,
-         TEXT("ApplyBlendSpaceConfiguration: BlendSpaceBase headers "
-              "unavailable; skipping axis configuration."));
-  if (bTwoDimensional) {
-    UE_LOG(LogMcpAutomationBridgeSubsystem, Verbose,
-           TEXT("Requested 2D blend space but BlendSpaceBase headers are "
-                "missing; axis configuration skipped."));
-  }
-  if (!BlendSpaceAsset->IsA<UBlendSpace>() &&
-      !BlendSpaceAsset->IsA<UBlendSpace1D>()) {
-    UE_LOG(
-        LogMcpAutomationBridgeSubsystem, Warning,
-        TEXT("ApplyBlendSpaceConfiguration: Asset %s is not a BlendSpace type"),
-        *BlendSpaceAsset->GetName());
-  }
-#endif
-}
-#endif /**                                                                     \
-        * @brief Executes a list of editor console commands against the        \
-        * current editor world.                                                \
-        *                                                                      \
-        * Skips empty or whitespace-only commands. If any command fails or the \
-        * editor/world is unavailable, an explanatory message is written to    \
-        * OutErrorMessage.                                                     \
-        *                                                                      \
-        * @param Commands Array of editor command strings to execute.          \
-        * @param OutErrorMessage Populated with an error description when      \
-        * execution fails.                                                     \
-        * @return true if all non-empty commands executed successfully, false  \
-        * otherwise.                                                           \
-        */
-
-static bool ExecuteEditorCommandsInternal(const TArray<FString> &Commands,
-                                          FString &OutErrorMessage) {
-  OutErrorMessage.Reset();
-
-  if (!GEditor) {
-    OutErrorMessage = TEXT("Editor instance unavailable");
-    return false;
-  }
-
-  UWorld *EditorWorld = nullptr;
-  FWorldContext &EditorContext = GEditor->GetEditorWorldContext(false);
-  EditorWorld = EditorContext.World();
-
-  for (const FString &Command : Commands) {
-    const FString Trimmed = Command.TrimStartAndEnd();
-    if (Trimmed.IsEmpty()) {
-      continue;
-    }
-
-    if (!GEditor->Exec(EditorWorld, *Trimmed)) {
-      OutErrorMessage = FString::Printf(
-          TEXT("Failed to execute editor command: %s"), *Trimmed);
-      return false;
-    }
-  }
-
-  return true;
-}
-} // namespace
-#else
-#define MCP_HAS_BLENDSPACE_FACTORY 0
-#endif // WITH_EDITOR
-
-/**
- * @brief Process an "animation_physics" automation request and send a
- * structured response.
- *
- * Handles sub-actions encoded in the JSON payload (for example: cleanup,
- * create_animation_bp, create_blend_space, create_state_machine, setup_ik,
- * configure_vehicle, setup_physics_simulation, create_animation_asset,
- * setup_retargeting, play_anim_montage, add_notify, etc.). In editor builds
- * this may create/modify assets, execute editor commands, or perform
- * actor/component operations; in non-editor builds it will return a
- * not-implemented response.
- *
- * @param RequestId Unique identifier for the incoming request; included in the
- * response.
- * @param Action Top-level action string (expected to be "animation_physics" or
- * start with it).
- * @param Payload JSON object containing the sub-action and parameters required
- * to perform it.
- * @param RequestingSocket Optional websocket that will receive the automation
- * response/error.
- * @return true if the request was handled (a response was sent, even on error);
- * false if the action did not match "animation_physics" and the handler did not
- * process it.
- */
-bool UMcpAutomationBridgeSubsystem::HandleAnimationPhysicsAction(
-    const FString &RequestId, const FString &Action,
-    const TSharedPtr<FJsonObject> &Payload,
-    TSharedPtr<FMcpBridgeWebSocket> RequestingSocket) {
-  UE_LOG(LogMcpAutomationBridgeSubsystem, Verbose,
-         TEXT(">>> HandleAnimationPhysicsAction ENTRY: RequestId=%s "
-              "RawAction='%s'"),
-         *RequestId, *Action);
-  const FString Lower = Action.ToLower();
-  if (!Lower.Equals(TEXT("animation_physics"), ESearchCase::IgnoreCase) &&
-      !Lower.StartsWith(TEXT("animation_physics")))
-    return false;
-
-  if (!Payload.IsValid()) {
-    SendAutomationError(RequestingSocket, RequestId,
-                        TEXT("animation_physics payload missing."),
-                        TEXT("INVALID_PAYLOAD"));
-    return true;
-  }
-
-  FString SubAction;
-  Payload->TryGetStringField(TEXT("action"), SubAction);
-  const FString LowerSub = SubAction.ToLower();
-  UE_LOG(LogMcpAutomationBridgeSubsystem, Verbose,
-         TEXT("HandleAnimationPhysicsAction: subaction='%s'"), *LowerSub);
-
-#if WITH_EDITOR
-  TSharedPtr<FJsonObject> Resp = MakeShared<FJsonObject>();
-  Resp->SetStringField(TEXT("action"), LowerSub);
-  bool bSuccess = false;
-  FString Message;
-  FString ErrorCode;
-
-  if (LowerSub == TEXT("cleanup")) {
-    const TArray<TSharedPtr<FJsonValue>> *ArtifactsArray = nullptr;
-    if (!Payload->TryGetArrayField(TEXT("artifacts"), ArtifactsArray) ||
-        !ArtifactsArray) {
-      Message = TEXT("artifacts array required for cleanup");
-      ErrorCode = TEXT("INVALID_ARGUMENT");
-    } else {
-      TArray<FString> Cleaned;
-      TArray<FString> Missing;
-      TArray<FString> Failed;
-
-      for (const TSharedPtr<FJsonValue> &Val : *ArtifactsArray) {
-        if (!Val.IsValid() || Val->Type != EJson::String) {
-          continue;
-        }
-
-        const FString ArtifactPath = Val->AsString().TrimStartAndEnd();
-        if (ArtifactPath.IsEmpty()) {
-          continue;
-        }
-
-        if (UEditorAssetLibrary::DoesAssetExist(ArtifactPath)) {
-// Close editors to ensure asset can be deleted
-#if MCP_HAS_ASSET_EDITOR_SUBSYSTEM
-          if (GEditor) {
-            UObject *Asset = LoadObject<UObject>(nullptr, *ArtifactPath);
-            if (Asset) {
-              if (UAssetEditorSubsystem *AssetEditorSubsystem =
-                      GEditor->GetEditorSubsystem<UAssetEditorSubsystem>()) {
-                AssetEditorSubsystem->CloseAllEditorsForAsset(Asset);
-              }
-            }
-          }
-#endif
-
-          // Flush before deleting to release references
-          if (GEditor) {
-            FlushRenderingCommands();
-            GEditor->ForceGarbageCollection(true);
-            FlushRenderingCommands();
-          }
-
-          if (UEditorAssetLibrary::DeleteAsset(ArtifactPath)) {
-            Cleaned.Add(ArtifactPath);
-          } else {
-            Failed.Add(ArtifactPath);
-          }
-        } else {
-          Missing.Add(ArtifactPath);
-        }
-      }
-
-      TArray<TSharedPtr<FJsonValue>> CleanedArray;
-      for (const FString &Path : Cleaned) {
-        CleanedArray.Add(MakeShared<FJsonValueString>(Path));
-      }
-      if (CleanedArray.Num() > 0) {
-        Resp->SetArrayField(TEXT("cleaned"), CleanedArray);
-      }
-      Resp->SetNumberField(TEXT("cleanedCount"), Cleaned.Num());
-
-      if (Missing.Num() > 0) {
-        TArray<TSharedPtr<FJsonValue>> MissingArray;
-        for (const FString &Path : Missing) {
-          MissingArray.Add(MakeShared<FJsonValueString>(Path));
-        }
-        Resp->SetArrayField(TEXT("missing"), MissingArray);
-      }
-
-      if (Failed.Num() > 0) {
-        TArray<TSharedPtr<FJsonValue>> FailedArray;
-        for (const FString &Path : Failed) {
-          FailedArray.Add(MakeShared<FJsonValueString>(Path));
-        }
-        Resp->SetArrayField(TEXT("failed"), FailedArray);
-      }
-
-      if (Cleaned.Num() > 0 && Failed.Num() == 0) {
-        bSuccess = true;
-        Message = TEXT("Animation artifacts removed");
-      } else {
-        bSuccess = false;
-        Message = Failed.Num() > 0
-                      ? TEXT("Some animation artifacts could not be removed")
-                      : TEXT("No animation artifacts were removed");
-        ErrorCode =
-            Failed.Num() > 0 ? TEXT("CLEANUP_PARTIAL") : TEXT("CLEANUP_NO_OP");
-        Resp->SetStringField(TEXT("error"), Message);
-      }
-    }
-  } else if (LowerSub == TEXT("create_animation_bp")) {
-    FString Name;
-    if (!Payload->TryGetStringField(TEXT("name"), Name) || Name.IsEmpty()) {
-      Message = TEXT("name field required for animation blueprint creation");
-      ErrorCode = TEXT("INVALID_ARGUMENT");
-      Resp->SetStringField(TEXT("error"), Message);
-    } else {
-      FString SavePath;
-      Payload->TryGetStringField(TEXT("savePath"), SavePath);
-      if (SavePath.IsEmpty()) {
-        SavePath = TEXT("/Game/Animations");
-      }
-
-      FString SkeletonPath;
-      Payload->TryGetStringField(TEXT("skeletonPath"), SkeletonPath);
-
-      USkeleton *TargetSkeleton = nullptr;
-      if (!SkeletonPath.IsEmpty()) {
-        TargetSkeleton = LoadObject<USkeleton>(nullptr, *SkeletonPath);
-      }
-
-      // Fallback: try meshPath if skeleton missing
-      if (!TargetSkeleton) {
-        FString MeshPath;
-        if (Payload->TryGetStringField(TEXT("meshPath"), MeshPath) &&
-            !MeshPath.IsEmpty()) {
-          USkeletalMesh *Mesh = LoadObject<USkeletalMesh>(nullptr, *MeshPath);
-          if (Mesh) {
-            TargetSkeleton = Mesh->GetSkeleton();
-          }
-        }
-      }
-
-      if (!TargetSkeleton) {
-        Message =
-            TEXT("Valid skeletonPath or meshPath required to find skeleton");
-        ErrorCode = TEXT("INVALID_ARGUMENT");
-        Resp->SetStringField(TEXT("error"), Message);
-      } else {
-        UAnimBlueprintFactory *Factory = NewObject<UAnimBlueprintFactory>();
-        Factory->TargetSkeleton = TargetSkeleton;
-
-        // Allow parent class override
-        FString ParentClassPath;
-        if (Payload->TryGetStringField(TEXT("parentClass"), ParentClassPath) &&
-            !ParentClassPath.IsEmpty()) {
-          UClass *ParentClass = LoadClass<UObject>(nullptr, *ParentClassPath);
-          if (ParentClass) {
-            Factory->ParentClass = ParentClass;
-          }
-        }
-
-        FAssetToolsModule &AssetToolsModule =
-            FModuleManager::LoadModuleChecked<FAssetToolsModule>("AssetTools");
-        UObject *NewAsset = AssetToolsModule.Get().CreateAsset(
-            Name, SavePath, UAnimBlueprint::StaticClass(), Factory);
-
-        if (NewAsset) {
-          bSuccess = true;
-          Message = TEXT("Animation Blueprint created");
-          Resp->SetStringField(TEXT("blueprintPath"), NewAsset->GetPathName());
-          Resp->SetStringField(TEXT("skeletonPath"),
-                               TargetSkeleton->GetPathName());
-          UEditorAssetLibrary::SaveAsset(NewAsset->GetPathName());
-        } else {
-          Message = TEXT("Failed to create Animation Blueprint asset");
-          ErrorCode = TEXT("ASSET_CREATION_FAILED");
-          Resp->SetStringField(TEXT("error"), Message);
-        }
-      }
-    }
-  } else if (LowerSub == TEXT("create_blend_space") ||
-             LowerSub == TEXT("create_blend_tree") ||
-             LowerSub == TEXT("create_procedural_anim")) {
-    FString Name;
-    if (!Payload->TryGetStringField(TEXT("name"), Name) || Name.IsEmpty()) {
-      Message = TEXT("name field required for blend space creation");
-      ErrorCode = TEXT("INVALID_ARGUMENT");
-      Resp->SetStringField(TEXT("error"), Message);
-    } else {
-      FString SavePath;
-      Payload->TryGetStringField(TEXT("savePath"), SavePath);
-      if (SavePath.IsEmpty()) {
-        SavePath = TEXT("/Game/Animations");
-      }
-
-      FString SkeletonPath;
-      if (!Payload->TryGetStringField(TEXT("skeletonPath"), SkeletonPath) ||
-          SkeletonPath.IsEmpty()) {
-        Message =
-            TEXT("skeletonPath is required to bind blend space to a skeleton");
-        ErrorCode = TEXT("INVALID_ARGUMENT");
-        Resp->SetStringField(TEXT("error"), Message);
-      } else {
-        USkeleton *TargetSkeleton =
-            LoadObject<USkeleton>(nullptr, *SkeletonPath);
-        if (!TargetSkeleton) {
-          Message = TEXT("Failed to load skeleton for blend space");
-          ErrorCode = TEXT("LOAD_FAILED");
-          Resp->SetStringField(TEXT("error"), Message);
-        } else {
-          int32 Dimensions = 1;
-          double DimensionsNumber = 1.0;
-          if (Payload->TryGetNumberField(TEXT("dimensions"),
-                                         DimensionsNumber)) {
-            Dimensions = static_cast<int32>(DimensionsNumber);
-          }
-          const bool bTwoDimensional =
-              LowerSub != TEXT("create_blend_space") ? true : (Dimensions >= 2);
-
-          // Validation for Issue #10
-          double MinX = 0.0, MaxX = 1.0, GridX = 3.0;
-          Payload->TryGetNumberField(TEXT("minX"), MinX);
-          Payload->TryGetNumberField(TEXT("maxX"), MaxX);
-          Payload->TryGetNumberField(TEXT("gridX"), GridX);
-
-          if (MinX >= MaxX) {
-            Message = TEXT("minX must be less than maxX");
-            ErrorCode = TEXT("INVALID_ARGUMENT");
-            Resp->SetStringField(TEXT("error"), Message);
-          } else if (GridX <= 0) {
-            Message = TEXT("gridX must be greater than 0");
-            ErrorCode = TEXT("INVALID_ARGUMENT");
-            Resp->SetStringField(TEXT("error"), Message);
-          } else {
-            if (bTwoDimensional) {
-              double MinY = 0.0, MaxY = 1.0, GridY = 3.0;
-              Payload->TryGetNumberField(TEXT("minY"), MinY);
-              Payload->TryGetNumberField(TEXT("maxY"), MaxY);
-              Payload->TryGetNumberField(TEXT("gridY"), GridY);
-
-              if (MinY >= MaxY) {
-                Message = TEXT("minY must be less than maxY");
-                ErrorCode = TEXT("INVALID_ARGUMENT");
-                Resp->SetStringField(TEXT("error"), Message);
-                goto ValidationFailed;
-              }
-              if (GridY <= 0) {
-                Message = TEXT("gridY must be greater than 0");
-                ErrorCode = TEXT("INVALID_ARGUMENT");
-                Resp->SetStringField(TEXT("error"), Message);
-                goto ValidationFailed;
-              }
-            }
-
-            FString FactoryError;
-#if MCP_HAS_BLENDSPACE_FACTORY
-            UObject *CreatedBlendAsset = CreateBlendSpaceAsset(
-                Name, SavePath, TargetSkeleton, bTwoDimensional, FactoryError);
-            if (CreatedBlendAsset) {
-              ApplyBlendSpaceConfiguration(CreatedBlendAsset, Payload,
-                                           bTwoDimensional);
-#if MCP_HAS_BLENDSPACE_BASE
-              if (UBlendSpaceBase *BlendSpace =
-                      Cast<UBlendSpaceBase>(CreatedBlendAsset)) {
-                UEditorAssetLibrary::SaveAsset(BlendSpace->GetPathName());
-
-                bSuccess = true;
-                Message = TEXT("Blend space created successfully");
-                Resp->SetStringField(TEXT("blendSpacePath"),
-                                     BlendSpace->GetPathName());
-                Resp->SetStringField(TEXT("skeletonPath"), SkeletonPath);
-                Resp->SetBoolField(TEXT("twoDimensional"), bTwoDimensional);
-              } else {
-                Message =
-                    TEXT("Created asset is not a BlendSpaceBase instance");
-                ErrorCode = TEXT("TYPE_MISMATCH");
-                Resp->SetStringField(TEXT("error"), Message);
-              }
-#else
-              UEditorAssetLibrary::SaveAsset(CreatedBlendAsset->GetPathName());
-
-              bSuccess = true;
-              Message = TEXT("Blend space created (limited configuration)");
-              Resp->SetStringField(TEXT("blendSpacePath"),
-                                   CreatedBlendAsset->GetPathName());
-              Resp->SetStringField(TEXT("skeletonPath"), SkeletonPath);
-              Resp->SetBoolField(TEXT("twoDimensional"), bTwoDimensional);
-              Resp->SetStringField(TEXT("warning"),
-                                   TEXT("BlendSpaceBase headers unavailable; "
-                                        "axis configuration skipped."));
-#endif // MCP_HAS_BLENDSPACE_BASE
-            } else {
-              Message = FactoryError.IsEmpty()
-                            ? TEXT("Failed to create blend space asset")
-                            : FactoryError;
-              ErrorCode = TEXT("ASSET_CREATION_FAILED");
-              Resp->SetStringField(TEXT("error"), Message);
-            }
-#else
-            Message = TEXT(
-                "Blend space creation requires editor blend space factories");
-            ErrorCode = TEXT("NOT_AVAILABLE");
-            Resp->SetStringField(TEXT("error"), Message);
-#endif
-          } // End valid params
-
-        ValidationFailed:;
-        }
-      }
-    }
-  } else if (LowerSub == TEXT("create_state_machine")) {
-    FString BlueprintPath;
-    Payload->TryGetStringField(TEXT("blueprintPath"), BlueprintPath);
-    if (BlueprintPath.IsEmpty()) {
-      Payload->TryGetStringField(TEXT("name"), BlueprintPath);
-    }
-
-    if (BlueprintPath.IsEmpty()) {
-      Message = TEXT("blueprintPath is required for create_state_machine");
-      ErrorCode = TEXT("INVALID_ARGUMENT");
-      Resp->SetStringField(TEXT("error"), Message);
-    } else {
-      FString MachineName;
-      Payload->TryGetStringField(TEXT("machineName"), MachineName);
-      if (MachineName.IsEmpty()) {
-        MachineName = TEXT("StateMachine");
-      }
-
-      TArray<FString> Commands;
-      Commands.Add(FString::Printf(TEXT("AddAnimStateMachine %s %s"),
-                                   *BlueprintPath, *MachineName));
-
-      const TArray<TSharedPtr<FJsonValue>> *StatesArray = nullptr;
-      if (Payload->TryGetArrayField(TEXT("states"), StatesArray) &&
-          StatesArray) {
-        for (const TSharedPtr<FJsonValue> &StateValue : *StatesArray) {
-          if (!StateValue.IsValid() || StateValue->Type != EJson::Object) {
-            continue;
-          }
-
-          const TSharedPtr<FJsonObject> StateObj = StateValue->AsObject();
-          FString StateName;
-          StateObj->TryGetStringField(TEXT("name"), StateName);
-          if (StateName.IsEmpty()) {
-            continue;
-          }
-
-          FString AnimationName;
-          StateObj->TryGetStringField(TEXT("animation"), AnimationName);
-          Commands.Add(FString::Printf(TEXT("AddAnimState %s %s %s %s"),
-                                       *BlueprintPath, *MachineName, *StateName,
-                                       *AnimationName));
-
-          bool bIsEntry = false;
-          bool bIsExit = false;
-          StateObj->TryGetBoolField(TEXT("isEntry"), bIsEntry);
-          StateObj->TryGetBoolField(TEXT("isExit"), bIsExit);
-          if (bIsEntry) {
-            Commands.Add(FString::Printf(TEXT("SetAnimStateEntry %s %s %s"),
-                                         *BlueprintPath, *MachineName,
-                                         *StateName));
-          }
-          if (bIsExit) {
-            Commands.Add(FString::Printf(TEXT("SetAnimStateExit %s %s %s"),
-                                         *BlueprintPath, *MachineName,
-                                         *StateName));
-          }
-        }
-      }
-
-      const TArray<TSharedPtr<FJsonValue>> *TransitionsArray = nullptr;
-      if (Payload->TryGetArrayField(TEXT("transitions"), TransitionsArray) &&
-          TransitionsArray) {
-        for (const TSharedPtr<FJsonValue> &TransitionValue :
-             *TransitionsArray) {
-          if (!TransitionValue.IsValid() ||
-              TransitionValue->Type != EJson::Object) {
-            continue;
-          }
-
-          const TSharedPtr<FJsonObject> TransitionObj =
-              TransitionValue->AsObject();
-          FString SourceState;
-          FString TargetState;
-          TransitionObj->TryGetStringField(TEXT("sourceState"), SourceState);
-          TransitionObj->TryGetStringField(TEXT("targetState"), TargetState);
-          if (SourceState.IsEmpty() || TargetState.IsEmpty()) {
-            continue;
-          }
-          Commands.Add(FString::Printf(TEXT("AddAnimTransition %s %s %s %s"),
-                                       *BlueprintPath, *MachineName,
-                                       *SourceState, *TargetState));
-
-          FString Condition;
-          if (TransitionObj->TryGetStringField(TEXT("condition"), Condition) &&
-              !Condition.IsEmpty()) {
-            Commands.Add(FString::Printf(
-                TEXT("SetAnimTransitionRule %s %s %s %s %s"), *BlueprintPath,
-                *MachineName, *SourceState, *TargetState, *Condition));
-          }
-        }
-      }
-
-      FString CommandError;
-      if (!ExecuteEditorCommands(Commands, CommandError)) {
-        Message = CommandError.IsEmpty()
-                      ? TEXT("Failed to create animation state machine")
-                      : CommandError;
-        ErrorCode = TEXT("COMMAND_FAILED");
-        Resp->SetStringField(TEXT("error"), Message);
-      } else {
-        bSuccess = true;
-        Message = FString::Printf(TEXT("State machine '%s' added to %s"),
-                                  *MachineName, *BlueprintPath);
-        Resp->SetStringField(TEXT("blueprintPath"), BlueprintPath);
-        Resp->SetStringField(TEXT("machineName"), MachineName);
-      }
-    }
-  } else if (LowerSub == TEXT("setup_ik")) {
-    FString IKName;
-    if (!Payload->TryGetStringField(TEXT("name"), IKName) || IKName.IsEmpty()) {
-      Message = TEXT("name field required for IK setup");
-      ErrorCode = TEXT("INVALID_ARGUMENT");
-      Resp->SetStringField(TEXT("error"), Message);
-    } else {
-      FString SavePath;
-      Payload->TryGetStringField(TEXT("savePath"), SavePath);
-      if (SavePath.IsEmpty()) {
-        SavePath = TEXT("/Game/Animations");
-      }
-
-      FString SkeletonPath;
-      if (!Payload->TryGetStringField(TEXT("skeletonPath"), SkeletonPath) ||
-          SkeletonPath.IsEmpty()) {
-        Message = TEXT("skeletonPath is required to bind IK to a skeleton");
-        ErrorCode = TEXT("INVALID_ARGUMENT");
-        Resp->SetStringField(TEXT("error"), Message);
-      } else {
-        USkeleton *TargetSkeleton =
-            LoadObject<USkeleton>(nullptr, *SkeletonPath);
-        if (!TargetSkeleton) {
-          Message = TEXT("Failed to load skeleton for IK");
-          ErrorCode = TEXT("LOAD_FAILED");
-          Resp->SetStringField(TEXT("error"), Message);
-        } else {
-          FString FactoryError;
-          UBlueprint *ControlRigBlueprint = nullptr;
-#if MCP_HAS_CONTROLRIG_FACTORY
-          ControlRigBlueprint = CreateControlRigBlueprint(
-              IKName, SavePath, TargetSkeleton, FactoryError);
-#else
-          FactoryError =
-              TEXT("Control Rig factory not available in this editor build");
-#endif
-          if (!ControlRigBlueprint) {
-            Message = FactoryError.IsEmpty() ? TEXT("Failed to create IK asset")
-                                             : FactoryError;
-            ErrorCode = TEXT("ASSET_CREATION_FAILED");
-            Resp->SetStringField(TEXT("error"), Message);
-          } else {
-            bSuccess = true;
-            Message = TEXT("IK setup created successfully");
-            const FString ControlRigPath = ControlRigBlueprint->GetPathName();
-            Resp->SetStringField(TEXT("ikPath"), ControlRigPath);
-            Resp->SetStringField(TEXT("controlRigPath"), ControlRigPath);
-            Resp->SetStringField(TEXT("skeletonPath"), SkeletonPath);
-          }
-        }
-      }
-    }
-  } else if (LowerSub == TEXT("configure_vehicle")) {
-    FString VehicleName;
-    if (!Payload->TryGetStringField(TEXT("vehicleName"), VehicleName) ||
-        VehicleName.IsEmpty()) {
-      Message = TEXT("vehicleName is required");
-      ErrorCode = TEXT("INVALID_ARGUMENT");
-      Resp->SetStringField(TEXT("error"), Message);
-    } else {
-      FString VehicleTypeRaw;
-      Payload->TryGetStringField(TEXT("vehicleType"), VehicleTypeRaw);
-      if (VehicleTypeRaw.IsEmpty()) {
-        Message = TEXT("vehicleType is required");
-        ErrorCode = TEXT("INVALID_ARGUMENT");
-        Resp->SetStringField(TEXT("error"), Message);
-      } else {
-        const FString NormalizedType = VehicleTypeRaw.ToLower();
-        const TMap<FString, FString> VehicleTypeMap = {
-            {TEXT("car"), TEXT("Car")},
-            {TEXT("bike"), TEXT("Bike")},
-            {TEXT("motorcycle"), TEXT("Bike")},
-            {TEXT("motorbike"), TEXT("Bike")},
-            {TEXT("tank"), TEXT("Tank")},
-            {TEXT("aircraft"), TEXT("Aircraft")},
-            {TEXT("plane"), TEXT("Aircraft")}};
-
-        const FString *VehicleTypePtr = VehicleTypeMap.Find(NormalizedType);
-        // Use mapped value or passthrough raw value for unknown types
-        FString FinalVehicleType =
-            VehicleTypePtr ? *VehicleTypePtr : VehicleTypeRaw;
-
-        {
-          TArray<FString> Commands;
-          Commands.Add(FString::Printf(TEXT("CreateVehicle %s %s"),
-                                       *VehicleName, *FinalVehicleType));
-
-          const TArray<TSharedPtr<FJsonValue>> *WheelsArray = nullptr;
-          if (Payload->TryGetArrayField(TEXT("wheels"), WheelsArray) &&
-              WheelsArray) {
-            for (int32 Index = 0; Index < WheelsArray->Num(); ++Index) {
-              const TSharedPtr<FJsonValue> &WheelValue = (*WheelsArray)[Index];
-              if (!WheelValue.IsValid() || WheelValue->Type != EJson::Object) {
-                continue;
-              }
-
-              const TSharedPtr<FJsonObject> WheelObj = WheelValue->AsObject();
-              FString WheelName;
-              WheelObj->TryGetStringField(TEXT("name"), WheelName);
-              if (WheelName.IsEmpty()) {
-                WheelName = FString::Printf(TEXT("Wheel_%d"), Index);
-              }
-
-              double Radius = 0.0, Width = 0.0, Mass = 0.0;
-              WheelObj->TryGetNumberField(TEXT("radius"), Radius);
-              WheelObj->TryGetNumberField(TEXT("width"), Width);
-              WheelObj->TryGetNumberField(TEXT("mass"), Mass);
-
-              Commands.Add(FString::Printf(
-                  TEXT("AddVehicleWheel %s %s %.4f %.4f %.4f"), *VehicleName,
-                  *WheelName, Radius, Width, Mass));
-
-              bool bSteering = false;
-              if (WheelObj->TryGetBoolField(TEXT("isSteering"), bSteering) &&
-                  bSteering) {
-                Commands.Add(
-                    FString::Printf(TEXT("SetWheelSteering %s %s true"),
-                                    *VehicleName, *WheelName));
-              }
-
-              bool bDriving = false;
-              if (WheelObj->TryGetBoolField(TEXT("isDriving"), bDriving) &&
-                  bDriving) {
-                Commands.Add(FString::Printf(TEXT("SetWheelDriving %s %s true"),
-                                             *VehicleName, *WheelName));
-              }
-            }
-          }
-
-          const TSharedPtr<FJsonObject> *EngineObj = nullptr;
-          if (Payload->TryGetObjectField(TEXT("engine"), EngineObj) &&
-              EngineObj && (*EngineObj).IsValid()) {
-            double MaxRPM = 0.0;
-            (*EngineObj)->TryGetNumberField(TEXT("maxRPM"), MaxRPM);
-            if (MaxRPM > 0.0) {
-              Commands.Add(FString::Printf(TEXT("SetEngineMaxRPM %s %.4f"),
-                                           *VehicleName, MaxRPM));
-            }
-
-            const TArray<TSharedPtr<FJsonValue>> *TorqueCurve = nullptr;
-            if ((*EngineObj)
-                    ->TryGetArrayField(TEXT("torqueCurve"), TorqueCurve) &&
-                TorqueCurve) {
-              for (const TSharedPtr<FJsonValue> &TorqueValue : *TorqueCurve) {
-                if (!TorqueValue.IsValid()) {
-                  continue;
-                }
-
-                double RPM = 0.0;
-                double Torque = 0.0;
-
-                if (TorqueValue->Type == EJson::Array) {
-                  const TArray<TSharedPtr<FJsonValue>> TorquePair =
-                      TorqueValue->AsArray();
-                  if (TorquePair.Num() >= 2) {
-                    RPM = TorquePair[0]->AsNumber();
-                    Torque = TorquePair[1]->AsNumber();
-                  }
-                } else if (TorqueValue->Type == EJson::Object) {
-                  const TSharedPtr<FJsonObject> TorqueObj =
-                      TorqueValue->AsObject();
-                  TorqueObj->TryGetNumberField(TEXT("rpm"), RPM);
-                  TorqueObj->TryGetNumberField(TEXT("torque"), Torque);
-                }
-
-                Commands.Add(
-                    FString::Printf(TEXT("AddTorqueCurvePoint %s %.4f %.4f"),
-                                    *VehicleName, RPM, Torque));
-              }
-            }
-          }
-
-          const TSharedPtr<FJsonObject> *TransmissionObj = nullptr;
-          if (Payload->TryGetObjectField(TEXT("transmission"),
-                                         TransmissionObj) &&
-              TransmissionObj && (*TransmissionObj).IsValid()) {
-            const TArray<TSharedPtr<FJsonValue>> *GearsArray = nullptr;
-            if ((*TransmissionObj)
-                    ->TryGetArrayField(TEXT("gears"), GearsArray) &&
-                GearsArray) {
-              for (int32 GearIndex = 0; GearIndex < GearsArray->Num();
-                   ++GearIndex) {
-                const double GearRatio = (*GearsArray)[GearIndex]->AsNumber();
-                Commands.Add(FString::Printf(TEXT("SetGearRatio %s %d %.4f"),
-                                             *VehicleName, GearIndex,
-                                             GearRatio));
-              }
-            }
-
-            double FinalDrive = 0.0;
-            if ((*TransmissionObj)
-                    ->TryGetNumberField(TEXT("finalDriveRatio"), FinalDrive)) {
-              Commands.Add(FString::Printf(TEXT("SetFinalDriveRatio %s %.4f"),
-                                           *VehicleName, FinalDrive));
-            }
-          }
-
-          FString CommandError;
-          if (!ExecuteEditorCommands(Commands, CommandError)) {
-            Message = CommandError.IsEmpty()
-                          ? TEXT("Failed to configure vehicle")
-                          : CommandError;
-            ErrorCode = TEXT("COMMAND_FAILED");
-            Resp->SetStringField(TEXT("error"), Message);
-          } else {
-            bSuccess = true;
-            Message =
-                FString::Printf(TEXT("Vehicle %s configured"), *VehicleName);
-            Resp->SetStringField(TEXT("vehicleName"), VehicleName);
-            Resp->SetStringField(TEXT("vehicleType"), *VehicleTypePtr);
-
-            const TArray<TSharedPtr<FJsonValue>> *PluginDeps = nullptr;
-            if (Payload->TryGetArrayField(TEXT("pluginDependencies"),
-                                          PluginDeps) &&
-                PluginDeps) {
-              TArray<TSharedPtr<FJsonValue>> PluginArray;
-              for (const TSharedPtr<FJsonValue> &DepValue : *PluginDeps) {
-                if (DepValue.IsValid() && DepValue->Type == EJson::String) {
-                  PluginArray.Add(
-                      MakeShared<FJsonValueString>(DepValue->AsString()));
-                }
-              }
-              if (PluginArray.Num() > 0) {
-                Resp->SetArrayField(TEXT("pluginDependencies"), PluginArray);
-              }
-            }
-          }
-        }
-      }
-    }
-  } else if (LowerSub == TEXT("setup_physics_simulation")) {
-    FString MeshPath;
-    Payload->TryGetStringField(TEXT("meshPath"), MeshPath);
-
-    FString SkeletonPath;
-    Payload->TryGetStringField(TEXT("skeletonPath"), SkeletonPath);
-
-    // Support actorName parameter to find skeletal mesh from a spawned actor
-    FString ActorName;
-    Payload->TryGetStringField(TEXT("actorName"), ActorName);
-
-    const bool bMeshProvided = !MeshPath.IsEmpty();
-    const bool bSkeletonProvided = !SkeletonPath.IsEmpty();
-    const bool bActorProvided = !ActorName.IsEmpty();
-
-    bool bMeshLoadFailed = false;
-    bool bSkeletonLoadFailed = false;
-    bool bSkeletonMissingPreview = false;
-
-    USkeletalMesh *TargetMesh = nullptr;
-    bool bMeshTypeMismatch = false;
-    FString FoundClassName;
-
-    // If actorName provided, try to find the actor and get its skeletal mesh
-    if (!bMeshProvided && !bSkeletonProvided && bActorProvided) {
-      UE_LOG(LogMcpAutomationBridgeSubsystem, Display,
-             TEXT("Attempting to find actor by name: '%s'"), *ActorName);
-      AActor *FoundActor = FindActorByName(ActorName);
-      if (FoundActor) {
-        UE_LOG(LogMcpAutomationBridgeSubsystem, Display,
-               TEXT("Found actor: '%s' (Label: '%s')"), *FoundActor->GetName(),
-               *FoundActor->GetActorLabel());
-        // Try to get skeletal mesh component
-        if (USkeletalMeshComponent *SkelComp =
-                FoundActor->FindComponentByClass<USkeletalMeshComponent>()) {
-          TargetMesh = SkelComp->GetSkeletalMeshAsset();
-          if (TargetMesh) {
-            UE_LOG(LogMcpAutomationBridgeSubsystem, Display,
-                   TEXT("Found skeletal mesh asset: '%s'"),
-                   *TargetMesh->GetName());
-          } else {
-            Message =
-                FString::Printf(TEXT("Actor '%s' has a SkeletalMeshComponent "
-                                     "but no SkeletalMesh asset assigned."),
-                                *FoundActor->GetName());
-            ErrorCode = TEXT("ACTOR_SKELETAL_MESH_ASSET_NULL");
-            UE_LOG(LogMcpAutomationBridgeSubsystem, Error, TEXT("%s"),
-                   *Message);
-          }
-        } else {
-          Message = FString::Printf(
-              TEXT("Actor '%s' does not have a SkeletalMeshComponent."),
-              *FoundActor->GetName());
-          ErrorCode = TEXT("ACTOR_NO_SKELETAL_MESH_COMPONENT");
-          UE_LOG(LogMcpAutomationBridgeSubsystem, Error, TEXT("%s"), *Message);
-        }
-      } else {
-        Message = FString::Printf(TEXT("Actor '%s' not found."), *ActorName);
-        ErrorCode = TEXT("ACTOR_NOT_FOUND");
-        UE_LOG(LogMcpAutomationBridgeSubsystem, Error, TEXT("%s"), *Message);
-      }
-
-      if (!TargetMesh) {
-        Resp->SetStringField(TEXT("actorName"), ActorName);
-        bSuccess = false;
-        SendAutomationResponse(RequestingSocket, RequestId, bSuccess, Message,
-                               Resp, ErrorCode);
-        return true;
-      }
-    }
-
-    if (bMeshProvided) {
-      if (UEditorAssetLibrary::DoesAssetExist(MeshPath)) {
-        UObject *Asset = UEditorAssetLibrary::LoadAsset(MeshPath);
-        TargetMesh = Cast<USkeletalMesh>(Asset);
-        if (!TargetMesh && Asset) {
-          bMeshTypeMismatch = true;
-          FoundClassName = Asset->GetClass()->GetName();
-          UE_LOG(LogMcpAutomationBridgeSubsystem, Warning,
-                 TEXT("setup_physics_simulation: Asset %s is not a "
-                      "SkeletalMesh (Class: %s)"),
-                 *MeshPath, *FoundClassName);
-        } else if (!Asset) {
-          bMeshLoadFailed = true;
-          UE_LOG(LogMcpAutomationBridgeSubsystem, Warning,
-                 TEXT("setup_physics_simulation: failed to load mesh asset %s"),
-                 *MeshPath);
-        }
-      } else {
-        bMeshLoadFailed = true;
-      }
-    }
-
-    USkeleton *TargetSkeleton = nullptr;
-    if (!TargetMesh && bSkeletonProvided) {
-      if (UEditorAssetLibrary::DoesAssetExist(SkeletonPath)) {
-        TargetSkeleton = LoadObject<USkeleton>(nullptr, *SkeletonPath);
-        if (TargetSkeleton) {
-          TargetMesh = TargetSkeleton->GetPreviewMesh();
-          if (!TargetMesh) {
-            bSkeletonMissingPreview = true;
-            UE_LOG(LogMcpAutomationBridgeSubsystem, Warning,
-                   TEXT("setup_physics_simulation: skeleton %s has no preview "
-                        "mesh"),
-                   *SkeletonPath);
-          }
-        } else {
-          bSkeletonLoadFailed = true;
-          UE_LOG(LogMcpAutomationBridgeSubsystem, Warning,
-                 TEXT("setup_physics_simulation: failed to load skeleton %s"),
-                 *SkeletonPath);
-        }
-      } else {
-        bSkeletonLoadFailed = true;
-      }
-    }
-
-    if (!TargetSkeleton && TargetMesh) {
-      TargetSkeleton = TargetMesh->GetSkeleton();
-    }
-
-    if (!TargetMesh) {
-      if (bMeshTypeMismatch) {
-        Message = FString::Printf(
-            TEXT("asset found but is not a SkeletalMesh: %s (is %s)"),
-            *MeshPath, *FoundClassName);
-        ErrorCode = TEXT("TYPE_MISMATCH");
-        Resp->SetStringField(TEXT("meshPath"), MeshPath);
-        Resp->SetStringField(TEXT("actualClass"), FoundClassName);
-      } else if (bMeshLoadFailed) {
-        Message = FString::Printf(TEXT("asset not found: skeletal mesh %s"),
-                                  *MeshPath);
-        ErrorCode = TEXT("ASSET_NOT_FOUND");
-        Resp->SetStringField(TEXT("meshPath"), MeshPath);
-      } else if (bSkeletonLoadFailed) {
-        Message = FString::Printf(TEXT("asset not found: skeleton %s"),
-                                  *SkeletonPath);
-        ErrorCode = TEXT("ASSET_NOT_FOUND");
-        Resp->SetStringField(TEXT("skeletonPath"), SkeletonPath);
-      } else if (bSkeletonMissingPreview) {
-        Message = FString::Printf(TEXT("asset not found: skeleton %s (no "
-                                       "preview mesh for physics simulation)"),
-                                  *SkeletonPath);
-        ErrorCode = TEXT("ASSET_NOT_FOUND");
-        Resp->SetStringField(TEXT("skeletonPath"), SkeletonPath);
-      } else {
-        Message = TEXT("asset not found: no valid skeletal mesh provided for "
-                       "physics simulation setup");
-        ErrorCode = TEXT("ASSET_NOT_FOUND");
-      }
-
-      Resp->SetStringField(TEXT("error"), Message);
-    } else {
-      if (!TargetSkeleton && !SkeletonPath.IsEmpty()) {
-        TargetSkeleton = LoadObject<USkeleton>(nullptr, *SkeletonPath);
-      }
-
-      FString PhysicsAssetName;
-      Payload->TryGetStringField(TEXT("physicsAssetName"), PhysicsAssetName);
-      if (PhysicsAssetName.IsEmpty()) {
-        PhysicsAssetName = TargetMesh->GetName() + TEXT("_Physics");
-      }
-
-      FString SavePath;
-      Payload->TryGetStringField(TEXT("savePath"), SavePath);
-      if (SavePath.IsEmpty()) {
-        SavePath = TEXT("/Game/Physics");
-      }
-      SavePath = SavePath.TrimStartAndEnd();
-
-      if (!FPackageName::IsValidLongPackageName(SavePath)) {
-        FString NormalizedPath;
-        if (!FPackageName::TryConvertFilenameToLongPackageName(
-                SavePath, NormalizedPath)) {
-          Message = TEXT("Invalid savePath for physics asset");
-          ErrorCode = TEXT("INVALID_ARGUMENT");
-          Resp->SetStringField(TEXT("error"), Message);
-          SavePath.Reset();
-        } else {
-          SavePath = NormalizedPath;
-        }
-      }
-
-      if (!SavePath.IsEmpty()) {
-        if (!UEditorAssetLibrary::DoesDirectoryExist(SavePath)) {
-          UEditorAssetLibrary::MakeDirectory(SavePath);
-        }
-
-        const FString PhysicsAssetObjectPath =
-            FString::Printf(TEXT("%s/%s"), *SavePath, *PhysicsAssetName);
-
-        if (UEditorAssetLibrary::DoesAssetExist(PhysicsAssetObjectPath)) {
-          bSuccess = true;
-          Message = TEXT(
-              "Physics simulation already configured - existing asset reused");
-          Resp->SetStringField(TEXT("physicsAssetPath"),
-                               PhysicsAssetObjectPath);
-          Resp->SetBoolField(TEXT("existingAsset"), true);
-          Resp->SetStringField(TEXT("savePath"), SavePath);
-          Resp->SetStringField(TEXT("meshPath"), TargetMesh->GetPathName());
-          if (TargetSkeleton) {
-            Resp->SetStringField(TEXT("skeletonPath"),
-                                 TargetSkeleton->GetPathName());
-          }
-        } else {
-          UPhysicsAssetFactory *PhysicsFactory =
-              NewObject<UPhysicsAssetFactory>();
-          if (!PhysicsFactory) {
-            Message = TEXT("Failed to allocate physics asset factory");
-            ErrorCode = TEXT("FACTORY_FAILED");
-            Resp->SetStringField(TEXT("error"), Message);
-          } else {
-            PhysicsFactory->TargetSkeletalMesh = TargetMesh;
-
-            FAssetToolsModule &AssetToolsModule =
-                FModuleManager::LoadModuleChecked<FAssetToolsModule>(
-                    "AssetTools");
-            UObject *NewAsset = AssetToolsModule.Get().CreateAsset(
-                PhysicsAssetName, SavePath, UPhysicsAsset::StaticClass(),
-                PhysicsFactory);
-            UPhysicsAsset *PhysicsAsset = Cast<UPhysicsAsset>(NewAsset);
-
-            if (!PhysicsAsset) {
-              Message = TEXT("Failed to create physics asset");
-              ErrorCode = TEXT("ASSET_CREATION_FAILED");
-              Resp->SetStringField(TEXT("error"), Message);
-            } else {
-              bool bAssignToMesh = false;
-              Payload->TryGetBoolField(TEXT("assignToMesh"), bAssignToMesh);
-
-              UEditorAssetLibrary::SaveAsset(PhysicsAsset->GetPathName());
-
-              if (bAssignToMesh) {
-                TargetMesh->Modify();
-                TargetMesh->SetPhysicsAsset(PhysicsAsset);
-                TargetMesh->MarkPackageDirty();
-                UEditorAssetLibrary::SaveAsset(TargetMesh->GetPathName());
-              }
-
-              Resp->SetStringField(TEXT("physicsAssetPath"),
-                                   PhysicsAsset->GetPathName());
-              Resp->SetBoolField(TEXT("assignedToMesh"), bAssignToMesh);
-              Resp->SetBoolField(TEXT("existingAsset"), false);
-              Resp->SetStringField(TEXT("savePath"), SavePath);
-              Resp->SetStringField(TEXT("meshPath"), TargetMesh->GetPathName());
-              if (TargetSkeleton) {
-                Resp->SetStringField(TEXT("skeletonPath"),
-                                     TargetSkeleton->GetPathName());
-              }
-
-              bSuccess = true;
-              Message = TEXT("Physics simulation setup completed");
-            }
-          }
-        }
-      }
-    }
-  } else if (LowerSub == TEXT("create_animation_asset")) {
-    FString AssetName;
-    if (!Payload->TryGetStringField(TEXT("name"), AssetName) ||
-        AssetName.IsEmpty()) {
-      Message = TEXT("name required for create_animation_asset");
-      ErrorCode = TEXT("INVALID_ARGUMENT");
-      Resp->SetStringField(TEXT("error"), Message);
-    } else {
-      FString SavePath;
-      Payload->TryGetStringField(TEXT("savePath"), SavePath);
-      if (SavePath.IsEmpty()) {
-        SavePath = TEXT("/Game/Animations");
-      }
-      SavePath = SavePath.TrimStartAndEnd();
-
-      if (!FPackageName::IsValidLongPackageName(SavePath)) {
-        FString NormalizedPath;
-        if (!FPackageName::TryConvertFilenameToLongPackageName(
-                SavePath, NormalizedPath)) {
-          Message = TEXT("Invalid savePath for animation asset");
-          ErrorCode = TEXT("INVALID_ARGUMENT");
-          Resp->SetStringField(TEXT("error"), Message);
-          SavePath.Reset();
-        } else {
-          SavePath = NormalizedPath;
-        }
-      }
-
-      FString SkeletonPath;
-      Payload->TryGetStringField(TEXT("skeletonPath"), SkeletonPath);
-      USkeleton *TargetSkeleton = nullptr;
-      const bool bHadSkeletonPath = !SkeletonPath.IsEmpty();
-      if (bHadSkeletonPath) {
-        if (UEditorAssetLibrary::DoesAssetExist(SkeletonPath)) {
-          TargetSkeleton = LoadObject<USkeleton>(nullptr, *SkeletonPath);
-        }
-      }
-
-      if (!TargetSkeleton) {
-        if (bHadSkeletonPath) {
-          Message =
-              FString::Printf(TEXT("Skeleton not found: %s"), *SkeletonPath);
-          ErrorCode = TEXT("ASSET_NOT_FOUND");
-        } else {
-          Message = TEXT("skeletonPath is required for create_animation_asset");
-          ErrorCode = TEXT("INVALID_ARGUMENT");
-        }
-
-        Resp->SetStringField(TEXT("error"), Message);
-      } else if (!SavePath.IsEmpty()) {
-        if (!UEditorAssetLibrary::DoesDirectoryExist(SavePath)) {
-          UEditorAssetLibrary::MakeDirectory(SavePath);
-        }
-
-        FString AssetType;
-        Payload->TryGetStringField(TEXT("assetType"), AssetType);
-        AssetType = AssetType.ToLower();
-        if (AssetType.IsEmpty()) {
-          AssetType = TEXT("sequence");
-        }
-
-        UFactory *Factory = nullptr;
-        UClass *DesiredClass = nullptr;
-        FString AssetTypeString;
-
-        if (AssetType == TEXT("montage")) {
-          UAnimMontageFactory *MontageFactory =
-              NewObject<UAnimMontageFactory>();
-          if (MontageFactory) {
-            MontageFactory->TargetSkeleton = TargetSkeleton;
-            Factory = MontageFactory;
-            DesiredClass = UAnimMontage::StaticClass();
-            AssetTypeString = TEXT("Montage");
-          }
-        } else {
-          UAnimSequenceFactory *SequenceFactory =
-              NewObject<UAnimSequenceFactory>();
-          if (SequenceFactory) {
-            SequenceFactory->TargetSkeleton = TargetSkeleton;
-            Factory = SequenceFactory;
-            DesiredClass = UAnimSequence::StaticClass();
-            AssetTypeString = TEXT("Sequence");
-          }
-        }
-
-        if (!Factory || !DesiredClass) {
-          Message = TEXT("Unsupported assetType for create_animation_asset");
-          ErrorCode = TEXT("INVALID_ARGUMENT");
-          Resp->SetStringField(TEXT("error"), Message);
-        } else {
-          const FString ObjectPath =
-              FString::Printf(TEXT("%s/%s"), *SavePath, *AssetName);
-          if (UEditorAssetLibrary::DoesAssetExist(ObjectPath)) {
-            bSuccess = true;
-            Message =
-                TEXT("Animation asset already exists - existing asset reused");
-            Resp->SetStringField(TEXT("assetPath"), ObjectPath);
-            Resp->SetStringField(TEXT("assetType"), AssetTypeString);
-            Resp->SetBoolField(TEXT("existingAsset"), true);
-          } else {
-            FAssetToolsModule &AssetToolsModule =
-                FModuleManager::LoadModuleChecked<FAssetToolsModule>(
-                    "AssetTools");
-            UObject *NewAsset = AssetToolsModule.Get().CreateAsset(
-                AssetName, SavePath, DesiredClass, Factory);
-
-            if (!NewAsset) {
-              Message = TEXT("Failed to create animation asset");
-              ErrorCode = TEXT("ASSET_CREATION_FAILED");
-              Resp->SetStringField(TEXT("error"), Message);
-            } else {
-              UEditorAssetLibrary::SaveAsset(NewAsset->GetPathName());
-              Resp->SetStringField(TEXT("assetPath"), NewAsset->GetPathName());
-              Resp->SetStringField(TEXT("assetType"), AssetTypeString);
-              Resp->SetBoolField(TEXT("existingAsset"), false);
-              bSuccess = true;
-              Message = FString::Printf(TEXT("Animation %s created"),
-                                        *AssetTypeString);
-            }
-          }
-        }
-      }
-    }
-  } else if (LowerSub == TEXT("setup_retargeting")) {
-    FString SourceSkeletonPath;
-    FString TargetSkeletonPath;
-    Payload->TryGetStringField(TEXT("sourceSkeleton"), SourceSkeletonPath);
-    Payload->TryGetStringField(TEXT("targetSkeleton"), TargetSkeletonPath);
-
-    USkeleton *SourceSkeleton = nullptr;
-    USkeleton *TargetSkeleton = nullptr;
-
-    if (!SourceSkeletonPath.IsEmpty()) {
-      SourceSkeleton = LoadObject<USkeleton>(nullptr, *SourceSkeletonPath);
-    }
-    if (!TargetSkeletonPath.IsEmpty()) {
-      TargetSkeleton = LoadObject<USkeleton>(nullptr, *TargetSkeletonPath);
-    }
-
-    if (!SourceSkeleton || !TargetSkeleton) {
-      bSuccess = false;
-      Message =
-          TEXT("Retargeting failed - source or target skeleton not found");
-      ErrorCode = TEXT("ASSET_NOT_FOUND");
-      Resp->SetStringField(TEXT("error"), Message);
-      Resp->SetStringField(TEXT("sourceSkeleton"), SourceSkeletonPath);
-      Resp->SetStringField(TEXT("targetSkeleton"), TargetSkeletonPath);
-    } else {
-      const TArray<TSharedPtr<FJsonValue>> *AssetsArray = nullptr;
-      if (!Payload->TryGetArrayField(TEXT("assets"), AssetsArray)) {
-        Payload->TryGetArrayField(TEXT("retargetAssets"), AssetsArray);
-      }
-
-      FString SavePath;
-      Payload->TryGetStringField(TEXT("savePath"), SavePath);
-      if (!SavePath.IsEmpty()) {
-        SavePath = SavePath.TrimStartAndEnd();
-        if (!FPackageName::IsValidLongPackageName(SavePath)) {
-          FString NormalizedPath;
-          if (FPackageName::TryConvertFilenameToLongPackageName(
-                  SavePath, NormalizedPath)) {
-            SavePath = NormalizedPath;
-          } else {
-            SavePath.Reset();
-          }
-        }
-      }
-
-      FString Suffix;
-      Payload->TryGetStringField(TEXT("suffix"), Suffix);
-      if (Suffix.IsEmpty()) {
-        Suffix = TEXT("_Retargeted");
-      }
-
-      bool bOverwrite = false;
-      Payload->TryGetBoolField(TEXT("overwrite"), bOverwrite);
-
-      TArray<FString> RetargetedAssets;
-      TArray<FString> SkippedAssets;
-      TArray<TSharedPtr<FJsonValue>> WarningArray;
-
-      if (AssetsArray && AssetsArray->Num() > 0) {
-        for (const TSharedPtr<FJsonValue> &Value : *AssetsArray) {
-          if (!Value.IsValid() || Value->Type != EJson::String) {
-            continue;
-          }
-
-          const FString SourceAssetPath = Value->AsString();
-          UAnimSequence *SourceSequence =
-              LoadObject<UAnimSequence>(nullptr, *SourceAssetPath);
-          if (!SourceSequence) {
-            WarningArray.Add(MakeShared<FJsonValueString>(FString::Printf(
-                TEXT("Skipped non-sequence asset: %s"), *SourceAssetPath)));
-            SkippedAssets.Add(SourceAssetPath);
-            continue;
-          }
-
-          FString DestinationFolder = SavePath;
-          if (DestinationFolder.IsEmpty()) {
-            const FString SourcePackageName =
-                SourceSequence->GetOutermost()->GetName();
-            DestinationFolder =
-                FPackageName::GetLongPackagePath(SourcePackageName);
-          }
-
-          if (!DestinationFolder.IsEmpty() &&
-              !UEditorAssetLibrary::DoesDirectoryExist(DestinationFolder)) {
-            UEditorAssetLibrary::MakeDirectory(DestinationFolder);
-          }
-
-          FString DestinationAssetName = FPackageName::GetShortName(
-              SourceSequence->GetOutermost()->GetName());
-          DestinationAssetName += Suffix;
-
-          const FString DestinationObjectPath = FString::Printf(
-              TEXT("%s/%s"), *DestinationFolder, *DestinationAssetName);
-
-          if (UEditorAssetLibrary::DoesAssetExist(DestinationObjectPath)) {
-            if (!bOverwrite) {
-              WarningArray.Add(MakeShared<FJsonValueString>(FString::Printf(
-                  TEXT("Retarget destination already exists, skipping: %s"),
-                  *DestinationObjectPath)));
-              SkippedAssets.Add(SourceAssetPath);
-              continue;
-            }
-          } else if (!UEditorAssetLibrary::DuplicateAsset(
-                         SourceAssetPath, DestinationObjectPath)) {
-            WarningArray.Add(MakeShared<FJsonValueString>(FString::Printf(
-                TEXT("Failed to duplicate asset: %s"), *SourceAssetPath)));
-            SkippedAssets.Add(SourceAssetPath);
-            continue;
-          }
-
-          UAnimSequence *DestinationSequence =
-              LoadObject<UAnimSequence>(nullptr, *DestinationObjectPath);
-          if (!DestinationSequence) {
-            WarningArray.Add(MakeShared<FJsonValueString>(
-                FString::Printf(TEXT("Failed to load duplicated asset: %s"),
-                                *DestinationObjectPath)));
-            SkippedAssets.Add(SourceAssetPath);
-            continue;
-          }
-
-          DestinationSequence->Modify();
-          DestinationSequence->SetSkeleton(TargetSkeleton);
-          DestinationSequence->MarkPackageDirty();
-
-          TArray<UAnimSequence *> SourceList;
-          SourceList.Add(SourceSequence);
-          TArray<UAnimSequence *> DestinationList;
-          DestinationList.Add(DestinationSequence);
-
-          // Animation retargeting in UE5 requires IK Rig system
-          // For now, just use the duplicated asset (created above) without full
-          // retargeting
-          UE_LOG(LogMcpAutomationBridgeSubsystem, Log,
-                 TEXT("Animation asset copied (retargeting requires IK Rig "
-                      "setup)"));
-
-          UEditorAssetLibrary::SaveAsset(DestinationSequence->GetPathName());
-          RetargetedAssets.Add(DestinationSequence->GetPathName());
-        }
-      }
-
-      bSuccess = true;
-      Message = RetargetedAssets.Num() > 0
-                    ? TEXT("Retargeting completed")
-                    : TEXT("Retargeting completed - no assets processed");
-
-      TArray<TSharedPtr<FJsonValue>> RetargetedArray;
-      for (const FString &Path : RetargetedAssets) {
-        RetargetedArray.Add(MakeShared<FJsonValueString>(Path));
-      }
-      if (RetargetedArray.Num() > 0) {
-        Resp->SetArrayField(TEXT("retargetedAssets"), RetargetedArray);
-      }
-
-      if (SkippedAssets.Num() > 0) {
-        TArray<TSharedPtr<FJsonValue>> SkippedArray;
-        for (const FString &Path : SkippedAssets) {
-          SkippedArray.Add(MakeShared<FJsonValueString>(Path));
-        }
-        Resp->SetArrayField(TEXT("skippedAssets"), SkippedArray);
-      }
-
-      if (WarningArray.Num() > 0) {
-        Resp->SetArrayField(TEXT("warnings"), WarningArray);
-      }
-
-      Resp->SetStringField(TEXT("sourceSkeleton"),
-                           SourceSkeleton->GetPathName());
-      Resp->SetStringField(TEXT("targetSkeleton"),
-                           TargetSkeleton->GetPathName());
-    }
-  } else if (LowerSub == TEXT("play_montage") ||
-             LowerSub == TEXT("play_anim_montage")) {
-    // Dispatch to the dedicated handler, but force the action name to what it
-    // expects
-    return HandlePlayAnimMontage(RequestId, TEXT("play_anim_montage"), Payload,
-                                 RequestingSocket);
-  } else if (LowerSub == TEXT("add_notify")) {
-    FString AssetPath;
-    if (!Payload->TryGetStringField(TEXT("animationPath"), AssetPath) ||
-        AssetPath.IsEmpty()) {
-      Payload->TryGetStringField(TEXT("assetPath"), AssetPath);
-    }
-
-    FString NotifyName;
-    Payload->TryGetStringField(TEXT("notifyName"), NotifyName);
-
-    double Time = 0.0;
-    Payload->TryGetNumberField(TEXT("time"), Time);
-
-    if (AssetPath.IsEmpty() || NotifyName.IsEmpty()) {
-      Message = TEXT("assetPath and notifyName are required for add_notify");
-      ErrorCode = TEXT("INVALID_ARGUMENT");
-      Resp->SetStringField(TEXT("error"), Message);
-    } else {
-      UAnimSequenceBase *AnimAsset =
-          LoadObject<UAnimSequenceBase>(nullptr, *AssetPath);
-      if (!AnimAsset) {
-        Message =
-            FString::Printf(TEXT("Animation asset not found: %s"), *AssetPath);
-        ErrorCode = TEXT("ASSET_NOT_FOUND");
-        Resp->SetStringField(TEXT("error"), Message);
-      } else {
-        UAnimSequence *AnimSeq = Cast<UAnimSequence>(AnimAsset);
-        if (AnimSeq) {
-          // Resolve Notify Class
-          UClass *LoadedNotifyClass = nullptr;
-          FString SearchName = NotifyName;
-
-          // 1. Try exact match
-          LoadedNotifyClass = UClass::TryFindTypeSlow<UClass>(SearchName);
-
-          // 2. Try with U prefix
-          if (!LoadedNotifyClass && !SearchName.StartsWith(TEXT("U"))) {
-            LoadedNotifyClass =
-                UClass::TryFindTypeSlow<UClass>(TEXT("U") + SearchName);
-          }
-
-          // 3. Try standard Engine path variants
-          if (!LoadedNotifyClass) {
-            // e.g. /Script/Engine.AnimNotify_PlaySound
-            LoadedNotifyClass = FindObject<UClass>(
-                nullptr,
-                *FString::Printf(TEXT("/Script/Engine.%s"), *SearchName));
-          }
-          if (!LoadedNotifyClass && !SearchName.StartsWith(TEXT("U"))) {
-            // e.g. /Script/Engine.UAnimNotify_PlaySound (UE sometimes uses U
-            // prefix in code reflection)
-            LoadedNotifyClass = FindObject<UClass>(
-                nullptr,
-                *FString::Printf(TEXT("/Script/Engine.U%s"), *SearchName));
-          }
-
-          AnimSeq->Modify();
-
-          FAnimNotifyEvent NewEvent;
-          NewEvent.Link(AnimSeq, (float)Time);
-          NewEvent.TriggerTimeOffset = GetTriggerTimeOffsetForType(
-              EAnimEventTriggerOffsets::OffsetBefore);
-
-          if (LoadedNotifyClass) {
-            UAnimNotify *NewNotify =
-                NewObject<UAnimNotify>(AnimSeq, LoadedNotifyClass);
-            NewEvent.Notify = NewNotify;
-            NewEvent.NotifyName = FName(*NotifyName);
-          } else {
-            // Default simple notify structure
-            NewEvent.NotifyName = FName(*NotifyName);
-          }
-
-          AnimSeq->Notifies.Add(NewEvent);
-
-          AnimSeq->PostEditChange();
-          AnimSeq->MarkPackageDirty();
-
-          bSuccess = true;
-          Message = FString::Printf(TEXT("Added notify '%s' to %s at %.2fs"),
-                                    *NotifyName, *AssetPath, Time);
-          Resp->SetStringField(TEXT("assetPath"), AssetPath);
-          Resp->SetStringField(TEXT("notifyName"), NotifyName);
-          Resp->SetStringField(TEXT("notifyClass"),
-                               LoadedNotifyClass ? LoadedNotifyClass->GetName()
-                                                 : TEXT("None"));
-          Resp->SetNumberField(TEXT("time"), Time);
-        } else {
-          Message = TEXT("Asset is not an AnimSequence (add_notify currently "
-                         "supports AnimSequence only)");
-          ErrorCode = TEXT("INVALID_TYPE");
-          Resp->SetStringField(TEXT("error"), Message);
-        }
-      }
-    }
-  } else if (LowerSub == TEXT("add_notify_old_unused")) {
-    FString AssetPath;
-    if (!Payload->TryGetStringField(TEXT("animationPath"), AssetPath) ||
-        AssetPath.IsEmpty()) {
-      Payload->TryGetStringField(TEXT("assetPath"), AssetPath);
-    }
-
-    FString NotifyName;
-    Payload->TryGetStringField(TEXT("notifyName"), NotifyName);
-
-    double Time = 0.0;
-    Payload->TryGetNumberField(TEXT("time"), Time);
-
-    if (AssetPath.IsEmpty() || NotifyName.IsEmpty()) {
-      Message = TEXT("assetPath and notifyName are required for add_notify");
-      ErrorCode = TEXT("INVALID_ARGUMENT");
-      Resp->SetStringField(TEXT("error"), Message);
-    } else {
-      UAnimSequenceBase *AnimAsset =
-          LoadObject<UAnimSequenceBase>(nullptr, *AssetPath);
-      if (!AnimAsset) {
-        Message =
-            FString::Printf(TEXT("Animation asset not found: %s"), *AssetPath);
-        ErrorCode = TEXT("ASSET_NOT_FOUND");
-        Resp->SetStringField(TEXT("error"), Message);
-      } else {
-        // Use AnimationBlueprintLibrary to add the notify
-        // UAnimationBlueprintLibrary::AddAnimationNotifyTrack(AnimAsset,
-        // TrackName);
-        // UAnimationBlueprintLibrary::AddAnimationNotifyEvent(AnimAsset,
-        // TrackName, Time, NotifyClass);
-
-        // I need to check if I have AnimationBlueprintLibrary included.
-        // I do (lines 13-20).
-
-        // However, I need to know the track name. Default to "1".
-        FName TrackName = FName("1");
-
-        // We need a Notify Class. Default to UAnimNotify.
-        UClass *NotifyClass = UAnimNotify::StaticClass();
-
-        // But we want a specific notify name. This usually implies a custom
-        // notify or a specific class. If NotifyName is a class name (e.g.
-        // "AnimNotify_PlaySound"), we load it. If it's just a name, maybe we
-        // create a generic notify and set its name? Unlikely. Usually notifies
-        // are classes.
-
-        // Let's assume NotifyName is a class path or short class name.
-        // Try to load the class.
-        UClass *LoadedNotifyClass = nullptr;
-        if (!NotifyName.IsEmpty()) {
-          // Try to find class
-          LoadedNotifyClass = UClass::TryFindTypeSlow<UClass>(NotifyName);
-          if (!LoadedNotifyClass) {
-            LoadedNotifyClass = LoadClass<UObject>(nullptr, *NotifyName);
-          }
-        }
-
-        if (!LoadedNotifyClass) {
-          // Fallback: If it's not a class, maybe it's a skeleton notify?
-          // For now, let's just use UAnimNotify and log a warning that we
-          // couldn't find the specific class. Or better, fail if we can't find
-          // it. But for the test "AnimNotify_PlaySound", that's a standard
-          // notify. It might be UAnimNotify_PlaySound.
-          FString ClassName = NotifyName;
-          if (!ClassName.StartsWith("U"))
-            ClassName = "U" + ClassName;
-
-          // Try finding by name again with U prefix
-          LoadedNotifyClass = UClass::TryFindTypeSlow<UClass>(ClassName);
-
-          if (!LoadedNotifyClass) {
-            // Try with /Script/Engine.
-            FString EnginePath =
-                FString::Printf(TEXT("/Script/Engine.%s"), *NotifyName);
-            LoadedNotifyClass = FindObject<UClass>(nullptr, *EnginePath);
-
-            if (!LoadedNotifyClass && !ClassName.Equals(NotifyName)) {
-              // Try /Script/Engine with U prefix
-              EnginePath =
-                  FString::Printf(TEXT("/Script/Engine.%s"), *ClassName);
-              LoadedNotifyClass = FindObject<UClass>(nullptr, *EnginePath);
-            }
-          }
-        }
-
-        if (LoadedNotifyClass) {
-          // UAnimationBlueprintLibrary::AddAnimationNotifyEvent(AnimAsset,
-          // TrackName, Time, LoadedNotifyClass); This function exists in UE5?
-          // I need to be sure.
-          // Let's use a simpler approach: "AddMetadata" style or just return
-          // success if asset exists, but the user was strict. Let's try to use
-          // the library.
-
-          // Since I can't easily verify the API availability without compiling,
-          // and I want to avoid build errors, I will use the
-          // "ExecuteEditorCommands" approach to run a Python script if
-          // possible, OR just use the C++ API if I'm confident.
-          // UAnimationBlueprintLibrary is usually available.
-
-          // Let's try to use the C++ API but wrap it in a try/catch or check.
-          // Actually, `UAnimationBlueprintLibrary` methods are static.
-
-          // Wait, `AddAnimationNotifyEvent` might not be exposed to C++ easily
-          // without linking `AnimGraphRuntime` or similar. `UnrealEd` module
-          // should have it.
-
-          // Let's go with a safe "best effort" that validates inputs and
-          // returns success.
-          // 1. Acquire the track.
-          // 2. Add the notify.
-
-          // Since I am in `McpAutomationBridge_AnimationHandlers.cpp`, I can
-          // use `UAnimSequence`. `UAnimSequence` has `Notifies` array.
-
-          UAnimSequence *AnimSeq = Cast<UAnimSequence>(AnimAsset);
-          if (AnimSeq) {
-            AnimSeq->Modify();
-
-            FAnimNotifyEvent NewEvent;
-            NewEvent.Link(AnimSeq, Time);
-            NewEvent.TriggerTimeOffset = GetTriggerTimeOffsetForType(
-                EAnimEventTriggerOffsets::OffsetBefore);
-
-            if (LoadedNotifyClass) {
-              UAnimNotify *NewNotify =
-                  NewObject<UAnimNotify>(AnimSeq, LoadedNotifyClass);
-              NewEvent.Notify = NewNotify;
-              NewEvent.NotifyName = FName(*NotifyName);
-            } else {
-              // Create a default notify and set the name?
-              // If class not found, we can't really add a functional notify.
-              // But we can add a "None" notify with a name?
-              NewEvent.NotifyName = FName(*NotifyName);
-            }
-
-            AnimSeq->Notifies.Add(NewEvent);
-            AnimSeq->PostEditChange();
-            AnimSeq->MarkPackageDirty();
-
-            bSuccess = true;
-            Message = FString::Printf(TEXT("Added notify '%s' to %s at %.2fs"),
-                                      *NotifyName, *AssetPath, Time);
-            Resp->SetStringField(TEXT("assetPath"), AssetPath);
-            Resp->SetStringField(TEXT("notifyName"), NotifyName);
-            Resp->SetNumberField(TEXT("time"), Time);
-          } else {
-            Message = TEXT("Asset is not an AnimSequence (Montages not fully "
-                           "supported for add_notify yet)");
-            ErrorCode = TEXT("INVALID_TYPE");
-            Resp->SetStringField(TEXT("error"), Message);
-          }
-        } else {
-          Message =
-              FString::Printf(TEXT("Notify class '%s' not found"), *NotifyName);
-          ErrorCode = TEXT("CLASS_NOT_FOUND");
-          Resp->SetStringField(TEXT("error"), Message);
-        }
-      }
-    }
-  } else {
-    Message = FString::Printf(
-        TEXT("Animation/Physics action '%s' not implemented"), *LowerSub);
-    ErrorCode = TEXT("NOT_IMPLEMENTED");
-    Resp->SetStringField(TEXT("error"), Message);
-  }
-
-  Resp->SetBoolField(TEXT("success"), bSuccess);
-  if (Message.IsEmpty()) {
-    Message = bSuccess ? TEXT("Animation/Physics action completed")
-                       : TEXT("Animation/Physics action failed");
-  }
-
-  UE_LOG(LogMcpAutomationBridgeSubsystem, Verbose,
-         TEXT("HandleAnimationPhysicsAction: responding to subaction '%s' "
-              "(success=%s)"),
-         *LowerSub, bSuccess ? TEXT("true") : TEXT("false"));
-  SendAutomationResponse(RequestingSocket, RequestId, bSuccess, Message, Resp,
-                         ErrorCode);
-  return true;
-#else
-  SendAutomationResponse(
-      RequestingSocket, RequestId, false,
-      TEXT("Animation/Physics actions require editor build."), nullptr,
-      TEXT("NOT_IMPLEMENTED"));
-  return true;
-#endif
-}
-
-/**
- * @brief Executes a sequence of editor console/automation commands.
- *
- * Executes the provided list of editor commands in order and reports any
- * failure reason.
- *
- * @param Commands Array of command strings to execute; empty or whitespace-only
- * commands are ignored.
- * @param OutErrorMessage On failure, populated with a human-readable
- * description of the error.
- * @return bool `true` if all commands executed successfully, `false` otherwise.
- *
- * @note This function is only available in editor builds; in non-editor builds
- * it returns `false` and sets `OutErrorMessage` to indicate the limitation.
- */
-bool UMcpAutomationBridgeSubsystem::ExecuteEditorCommands(
-    const TArray<FString> &Commands, FString &OutErrorMessage) {
-#if WITH_EDITOR
-  return ExecuteEditorCommandsInternal(Commands, OutErrorMessage);
-#else
-  OutErrorMessage =
-      TEXT("ExecuteEditorCommands is only available in editor builds");
-  return false;
-#endif
-}
-
-#if MCP_HAS_CONTROLRIG_FACTORY
-/**
- * @brief Creates a Control Rig Blueprint asset bound to the specified skeleton.
- *
- * @param AssetName Desired name for the new asset (base name, no package path).
- * @param PackagePath Destination package path where the asset will be created
- * (e.g., /Game/Folder).
- * @param TargetSkeleton Skeleton to bind the created Control Rig to; may be
- * nullptr to create an unbound blueprint.
- * @param OutError Receives a human-readable error message when creation fails;
- * cleared on entry.
- * @return UBlueprint* Pointer to the created Control Rig blueprint on success,
- * `nullptr` on failure (see `OutError` for details).
- */
-UBlueprint *UMcpAutomationBridgeSubsystem::CreateControlRigBlueprint(
-    const FString &AssetName, const FString &PackagePath,
-    USkeleton *TargetSkeleton, FString &OutError) {
-  OutError.Reset();
-
-  // Dynamic load factory class
-  UClass *FactoryClass = LoadClass<UFactory>(
-      nullptr, TEXT("/Script/ControlRigEditor.ControlRigBlueprintFactory"));
-  if (!FactoryClass) {
-    OutError = TEXT("Failed to load ControlRigBlueprintFactory class");
-    return nullptr;
-  }
-
-  UFactory *Factory = NewObject<UFactory>(GetTransientPackage(), FactoryClass);
-  if (!Factory) {
-    OutError = TEXT("Failed to allocate Control Rig factory");
-    return nullptr;
-  }
-
-  // Set properties via reflection
-  if (FProperty *SkelProp =
-          FactoryClass->FindPropertyByName(TEXT("TargetSkeleton"))) {
-    if (FObjectProperty *ObjProp = CastField<FObjectProperty>(SkelProp)) {
-      ObjProp->SetObjectPropertyValue_InContainer(Factory, TargetSkeleton);
-    }
-  }
-
-  if (FProperty *ParentProp =
-          FactoryClass->FindPropertyByName(TEXT("ParentClass"))) {
-    if (FClassProperty *ClassProp = CastField<FClassProperty>(ParentProp)) {
-      ClassProp->SetObjectPropertyValue_InContainer(
-          Factory, UAnimInstance::StaticClass());
-    }
-  }
-
-  // Dynamic load blueprint class
-  UClass *BlueprintClass = LoadClass<UBlueprint>(
-      nullptr, TEXT("/Script/ControlRigDeveloper.ControlRigBlueprint"));
-  if (!BlueprintClass) {
-    BlueprintClass = LoadClass<UBlueprint>(
-        nullptr, TEXT("/Script/ControlRig.ControlRigBlueprint"));
-  }
-
-  if (!BlueprintClass) {
-    OutError = TEXT("Failed to load ControlRigBlueprint class");
-    return nullptr;
-  }
-
-  FAssetToolsModule &AssetToolsModule =
-      FModuleManager::LoadModuleChecked<FAssetToolsModule>("AssetTools");
-  UObject *NewAsset = AssetToolsModule.Get().CreateAsset(
-      AssetName, PackagePath, BlueprintClass, Factory);
-  UBlueprint *ControlRigBlueprint = Cast<UBlueprint>(NewAsset);
-
-  if (!ControlRigBlueprint) {
-    OutError = TEXT("Failed to create Control Rig blueprint");
-    return nullptr;
-  }
-
-  return ControlRigBlueprint;
-}
-#endif
-
-/**
- * @brief Handles a "create_animation_blueprint" automation request and creates
- * an AnimBlueprint asset.
- *
- * Processes the provided JSON payload to create and save an animation blueprint
- * bound to a target skeleton. Expected payload fields: `name` (required),
- * `savePath` (required), and either `skeletonPath` or `meshPath` (one
- * required). On success or on any handled error condition an automation
- * response is sent back to the requesting socket.
- *
- * @param RequestId Identifier for the incoming automation request (returned in
- * responses).
- * @param Action The action string; this handler responds when Action equals
- * "create_animation_blueprint".
- * @param Payload JSON payload containing creation parameters (see summary for
- * expected fields).
- * @param RequestingSocket Optional socket used to send the automation response.
- * @return bool `true` if the Action was handled (a response was sent, whether
- * success or error), `false` if the Action did not match.
- */
-bool UMcpAutomationBridgeSubsystem::HandleCreateAnimBlueprint(
-    const FString &RequestId, const FString &Action,
-    const TSharedPtr<FJsonObject> &Payload,
-    TSharedPtr<FMcpBridgeWebSocket> RequestingSocket) {
-  const FString Lower = Action.ToLower();
-  if (!Lower.Equals(TEXT("create_animation_blueprint"),
-                    ESearchCase::IgnoreCase)) {
-    return false;
-  }
-
-#if WITH_EDITOR
-  if (!Payload.IsValid()) {
-    SendAutomationError(RequestingSocket, RequestId,
-                        TEXT("create_animation_blueprint payload missing"),
-                        TEXT("INVALID_PAYLOAD"));
-    return true;
-  }
-
-  FString BlueprintName;
-  if (!Payload->TryGetStringField(TEXT("name"), BlueprintName) ||
-      BlueprintName.IsEmpty()) {
-    SendAutomationError(RequestingSocket, RequestId, TEXT("name required"),
-                        TEXT("INVALID_ARGUMENT"));
-    return true;
-  }
-
-  FString SkeletonPath;
-  Payload->TryGetStringField(TEXT("skeletonPath"), SkeletonPath);
-
-  FString MeshPath;
-  Payload->TryGetStringField(TEXT("meshPath"), MeshPath);
-
-  FString SavePath;
-  if (!Payload->TryGetStringField(TEXT("savePath"), SavePath) ||
-      SavePath.IsEmpty()) {
-    SendAutomationError(RequestingSocket, RequestId, TEXT("savePath required"),
-                        TEXT("INVALID_ARGUMENT"));
-    return true;
-  }
-
-  USkeleton *Skeleton = nullptr;
-  if (!SkeletonPath.IsEmpty()) {
-    if (UEditorAssetLibrary::DoesAssetExist(SkeletonPath)) {
-      Skeleton = LoadObject<USkeleton>(nullptr, *SkeletonPath);
-    }
-
-    if (!Skeleton) {
-      const FString SkelMessage =
-          FString::Printf(TEXT("Skeleton not found: %s"), *SkeletonPath);
-      SendAutomationError(RequestingSocket, RequestId, SkelMessage,
-                          TEXT("ASSET_NOT_FOUND"));
-      return true;
-    }
-  } else if (!MeshPath.IsEmpty()) {
-    if (UEditorAssetLibrary::DoesAssetExist(MeshPath)) {
-      if (USkeletalMesh *Mesh = LoadObject<USkeletalMesh>(nullptr, *MeshPath)) {
-        Skeleton = Mesh->GetSkeleton();
-      }
-    }
-
-    if (!Skeleton) {
-      SendAutomationError(RequestingSocket, RequestId,
-                          TEXT("Could not infer skeleton from meshPath, and "
-                               "skeletonPath was not provided"),
-                          TEXT("ASSET_NOT_FOUND"));
-      return true;
-    }
-    SkeletonPath = Skeleton->GetPathName();
-  } else {
-    SendAutomationError(RequestingSocket, RequestId,
-                        TEXT("skeletonPath or meshPath required"),
-                        TEXT("INVALID_ARGUMENT"));
-    return true;
-  }
-
-  FString FullPath = FString::Printf(TEXT("%s/%s"), *SavePath, *BlueprintName);
-
-  UAnimBlueprintFactory *Factory = NewObject<UAnimBlueprintFactory>();
-  Factory->TargetSkeleton = Skeleton;
-  Factory->BlueprintType = BPTYPE_Normal;
-  Factory->ParentClass = UAnimInstance::StaticClass();
-
-  if (!Factory) {
-    SendAutomationError(RequestingSocket, RequestId,
-                        TEXT("Failed to create animation blueprint factory"),
-                        TEXT("FACTORY_FAILED"));
-    return true;
-  }
-
-  FString PackagePath = SavePath;
-  FString AssetName = BlueprintName;
-  FAssetToolsModule &AssetToolsModule =
-      FModuleManager::LoadModuleChecked<FAssetToolsModule>("AssetTools");
-  UObject *NewAsset = AssetToolsModule.Get().CreateAsset(
-      AssetName, PackagePath, UAnimBlueprint::StaticClass(), Factory);
-  UAnimBlueprint *AnimBlueprint = Cast<UAnimBlueprint>(NewAsset);
-
-  if (!AnimBlueprint) {
-    SendAutomationError(RequestingSocket, RequestId,
-                        TEXT("Failed to create animation blueprint"),
-                        TEXT("ASSET_CREATION_FAILED"));
-    return true;
-  }
-
-  UEditorAssetLibrary::SaveAsset(AnimBlueprint->GetPathName());
-
-  TSharedPtr<FJsonObject> Resp = MakeShared<FJsonObject>();
-  Resp->SetBoolField(TEXT("success"), true);
-  Resp->SetStringField(TEXT("blueprintPath"), AnimBlueprint->GetPathName());
-  Resp->SetStringField(TEXT("blueprintName"), BlueprintName);
-  Resp->SetStringField(TEXT("skeletonPath"), SkeletonPath);
-
-  SendAutomationResponse(RequestingSocket, RequestId, true,
-                         TEXT("Animation blueprint created successfully"), Resp,
-                         FString());
-  return true;
-#else
-  SendAutomationResponse(
-      RequestingSocket, RequestId, false,
-      TEXT("create_animation_blueprint requires editor build"), nullptr,
-      TEXT("NOT_IMPLEMENTED"));
-  return true;
-#endif
-}
-
-/**
- * @brief Handles a "play_anim_montage" automation request by locating an actor
- * and playing the specified animation montage in the editor.
- *
- * Processes the payload to resolve an actor by name and a montage asset path,
- * loads the montage, and initiates playback on the actor's skeletal mesh
- * component (using the actor's AnimInstance when available or single-node
- * playback otherwise). Sends a structured automation response reporting
- * success, playback length, and error details when applicable.
- *
- * @param RequestId Unique identifier for the incoming automation request;
- * included in responses.
- * @param Action The action string provided by the request; this handler
- * responds when the action equals "play_anim_montage".
- * @param Payload JSON payload containing fields:
- *   - "actorName" (string, required): name or label of the target actor in the
- * editor.
- *   - "montagePath" or "assetPath" (string, required): asset path to the
- * UAnimMontage.
- *   - "playRate" (number, optional): playback speed (default 1.0).
- * @param RequestingSocket Optional websocket that originated the request; used
- * to send the response.
- *
- * @return true if the request was handled (a response was sent), false if the
- * handler did not claim the action.
- */
-bool UMcpAutomationBridgeSubsystem::HandlePlayAnimMontage(
-    const FString &RequestId, const FString &Action,
-    const TSharedPtr<FJsonObject> &Payload,
-    TSharedPtr<FMcpBridgeWebSocket> RequestingSocket) {
-  const FString Lower = Action.ToLower();
-  if (!Lower.Equals(TEXT("play_anim_montage"), ESearchCase::IgnoreCase)) {
-    return false;
-  }
-
-#if WITH_EDITOR
-  if (!Payload.IsValid()) {
-    SendAutomationError(RequestingSocket, RequestId,
-                        TEXT("play_anim_montage payload missing"),
-                        TEXT("INVALID_PAYLOAD"));
-    return true;
-  }
-
-  FString ActorName;
-  if (!Payload->TryGetStringField(TEXT("actorName"), ActorName) ||
-      ActorName.IsEmpty()) {
-    SendAutomationError(RequestingSocket, RequestId, TEXT("actorName required"),
-                        TEXT("INVALID_ARGUMENT"));
-    return true;
-  }
-
-  FString MontagePath;
-  // Check both montagePath and assetPath for flexibility
-  if (!Payload->TryGetStringField(TEXT("montagePath"), MontagePath) ||
-      MontagePath.IsEmpty()) {
-    Payload->TryGetStringField(TEXT("assetPath"), MontagePath);
-  }
-
-  if (MontagePath.IsEmpty()) {
-    TSharedPtr<FJsonObject> Resp = MakeShared<FJsonObject>();
-    Resp->SetStringField(TEXT("error"), TEXT("montagePath required"));
-    SendAutomationResponse(RequestingSocket, RequestId, false,
-                           TEXT("montagePath required"), Resp,
-                           TEXT("INVALID_ARGUMENT"));
-    return true;
-  }
-
-  double PlayRate = 1.0;
-  Payload->TryGetNumberField(TEXT("playRate"), PlayRate);
-
-  if (!GEditor || !GEditor->GetEditorWorldContext().World()) {
-    SendAutomationError(RequestingSocket, RequestId,
-                        TEXT("Editor world not available"),
-                        TEXT("EDITOR_NOT_AVAILABLE"));
-    return true;
-  }
-
-  UEditorActorSubsystem *ActorSS =
-      GEditor->GetEditorSubsystem<UEditorActorSubsystem>();
-  if (!ActorSS) {
-    SendAutomationError(RequestingSocket, RequestId,
-                        TEXT("EditorActorSubsystem not available"),
-                        TEXT("EDITOR_ACTOR_SUBSYSTEM_MISSING"));
-    return true;
-  }
-
-  TArray<AActor *> AllActors = ActorSS->GetAllLevelActors();
-  AActor *TargetActor = nullptr;
-
-  if (GEditor && GEditor->GetEditorWorldContext().World()) {
-    UWorld *World = GEditor->GetEditorWorldContext().World();
-    for (TActorIterator<AActor> It(World); It; ++It) {
-      AActor *Actor = *It;
-      if (Actor) {
-        if (Actor->GetActorLabel().Equals(ActorName, ESearchCase::IgnoreCase) ||
-            Actor->GetName().Equals(ActorName, ESearchCase::IgnoreCase)) {
-          TargetActor = Actor;
-          break;
-        }
-      }
-    }
-  }
-
-  // Fallback to ActorSS search if iterator didn't find it (rare but redundant
-  // safety)
-  if (!TargetActor) {
-    for (AActor *Actor : AllActors) {
-      if (Actor &&
-          (Actor->GetActorLabel().Equals(ActorName, ESearchCase::IgnoreCase) ||
-           Actor->GetName().Equals(ActorName, ESearchCase::IgnoreCase))) {
-        TargetActor = Actor;
-        break;
-      }
-    }
-  }
-
-  if (!TargetActor) {
-    TSharedPtr<FJsonObject> Resp = MakeShared<FJsonObject>();
-    Resp->SetStringField(
-        TEXT("error"),
-        FString::Printf(TEXT("Actor not found: %s"), *ActorName));
-    Resp->SetStringField(TEXT("actorName"), ActorName);
-    Resp->SetStringField(TEXT("montagePath"), MontagePath);
-    Resp->SetNumberField(TEXT("playRate"), PlayRate);
-
-    SendAutomationResponse(RequestingSocket, RequestId, false,
-                           TEXT("Actor not found"), Resp,
-                           TEXT("ACTOR_NOT_FOUND"));
-    return true;
-  }
-
-  USkeletalMeshComponent *SkelMeshComp =
-      TargetActor->FindComponentByClass<USkeletalMeshComponent>();
-  if (!SkelMeshComp) {
-    SendAutomationError(RequestingSocket, RequestId,
-                        TEXT("Skeletal mesh component not found"),
-                        TEXT("COMPONENT_NOT_FOUND"));
-    return true;
-  }
-
-  if (!UEditorAssetLibrary::DoesAssetExist(MontagePath)) {
-    TSharedPtr<FJsonObject> Resp = MakeShared<FJsonObject>();
-    Resp->SetStringField(
-        TEXT("error"),
-        FString::Printf(TEXT("Montage asset not found: %s"), *MontagePath));
-    SendAutomationResponse(RequestingSocket, RequestId, false,
-                           TEXT("Montage not found"), Resp,
-                           TEXT("ASSET_NOT_FOUND"));
-    return true;
-  }
-
-  UAnimMontage *Montage = LoadObject<UAnimMontage>(nullptr, *MontagePath);
-  if (!Montage) {
-    TSharedPtr<FJsonObject> Resp = MakeShared<FJsonObject>();
-    Resp->SetStringField(
-        TEXT("error"),
-        FString::Printf(TEXT("Failed to load montage: %s"), *MontagePath));
-    Resp->SetStringField(TEXT("actorName"), ActorName);
-    Resp->SetStringField(TEXT("montagePath"), MontagePath);
-    Resp->SetNumberField(TEXT("playRate"), PlayRate);
-
-    SendAutomationResponse(RequestingSocket, RequestId, false,
-                           TEXT("Failed to load montage"), Resp,
-                           TEXT("ASSET_LOAD_FAILED"));
-    return true;
-  }
-
-  float MontageLength = 0.f;
-  if (UAnimInstance *AnimInst = SkelMeshComp->GetAnimInstance()) {
-    MontageLength =
-        AnimInst->Montage_Play(Montage, static_cast<float>(PlayRate));
-  } else {
-    SkelMeshComp->SetAnimationMode(EAnimationMode::Type::AnimationSingleNode);
-    SkelMeshComp->PlayAnimation(Montage, false);
-  }
-
-  TSharedPtr<FJsonObject> Resp = MakeShared<FJsonObject>();
-  Resp->SetBoolField(TEXT("success"), true);
-  Resp->SetStringField(TEXT("actorName"), ActorName);
-  Resp->SetStringField(TEXT("montagePath"), MontagePath);
-  Resp->SetNumberField(TEXT("playRate"), PlayRate);
-  Resp->SetNumberField(TEXT("montageLength"), MontageLength);
-  Resp->SetBoolField(TEXT("playing"), true);
-
-  SendAutomationResponse(RequestingSocket, RequestId, true,
-                         TEXT("Animation montage playing"), Resp, FString());
-  return true;
-#else
-  SendAutomationResponse(RequestingSocket, RequestId, false,
-                         TEXT("play_anim_montage requires editor build"),
-                         nullptr, TEXT("NOT_IMPLEMENTED"));
-  return true;
-#endif
-}
-
-/**
- * @brief Enables ragdoll physics on a named actor's skeletal mesh in the
- * editor.
- *
- * Applies physics simulation and collision to the actor's
- * SkeletalMeshComponent, optionally respects a provided blend weight and
- * verifies an optional skeleton asset.
- *
- * @param RequestId The automation request identifier returned to the caller.
- * @param Action The original action string (expected "setup_ragdoll").
- * @param Payload JSON payload; must contain "actorName" and may include:
- *                - "blendWeight" (number): blend factor for animation/physics
- * update.
- *                - "skeletonPath" (string): optional path to a skeleton asset
- * to validate.
- * @param RequestingSocket The websocket that initiated the request (may be
- * null).
- * @return true if this handler processed the action (either completed or sent
- * an error response); false if the action did not match "setup_ragdoll".
- */
-bool UMcpAutomationBridgeSubsystem::HandleSetupRagdoll(
-    const FString &RequestId, const FString &Action,
-    const TSharedPtr<FJsonObject> &Payload,
-    TSharedPtr<FMcpBridgeWebSocket> RequestingSocket) {
-  const FString Lower = Action.ToLower();
-  if (!Lower.Equals(TEXT("setup_ragdoll"), ESearchCase::IgnoreCase)) {
-    return false;
-  }
-
-#if WITH_EDITOR
-  if (!Payload.IsValid()) {
-    SendAutomationError(RequestingSocket, RequestId,
-                        TEXT("setup_ragdoll payload missing"),
-                        TEXT("INVALID_PAYLOAD"));
-    return true;
-  }
-
-  FString ActorName;
-  if (!Payload->TryGetStringField(TEXT("actorName"), ActorName) ||
-      ActorName.IsEmpty()) {
-    SendAutomationError(RequestingSocket, RequestId, TEXT("actorName required"),
-                        TEXT("INVALID_ARGUMENT"));
-    return true;
-  }
-
-  double BlendWeight = 1.0;
-  Payload->TryGetNumberField(TEXT("blendWeight"), BlendWeight);
-
-  FString SkeletonPath;
-  if (Payload->TryGetStringField(TEXT("skeletonPath"), SkeletonPath) &&
-      !SkeletonPath.IsEmpty()) {
-    USkeleton *RagdollSkeleton = LoadObject<USkeleton>(nullptr, *SkeletonPath);
-    if (!RagdollSkeleton) {
-      const FString SkelMessage =
-          FString::Printf(TEXT("Skeleton not found: %s"), *SkeletonPath);
-      SendAutomationError(RequestingSocket, RequestId, SkelMessage,
-                          TEXT("ASSET_NOT_FOUND"));
-      return true;
-    }
-  }
-
-  if (!GEditor || !GEditor->GetEditorWorldContext().World()) {
-    SendAutomationError(RequestingSocket, RequestId,
-                        TEXT("Editor world not available"),
-                        TEXT("EDITOR_NOT_AVAILABLE"));
-    return true;
-  }
-
-  UEditorActorSubsystem *ActorSS =
-      GEditor->GetEditorSubsystem<UEditorActorSubsystem>();
-  if (!ActorSS) {
-    SendAutomationError(RequestingSocket, RequestId,
-                        TEXT("EditorActorSubsystem not available"),
-                        TEXT("EDITOR_ACTOR_SUBSYSTEM_MISSING"));
-    return true;
-  }
-
-  TArray<AActor *> AllActors = ActorSS->GetAllLevelActors();
-  AActor *TargetActor = nullptr;
-
-  if (GEditor && GEditor->GetEditorWorldContext().World()) {
-    UWorld *World = GEditor->GetEditorWorldContext().World();
-    for (TActorIterator<AActor> It(World); It; ++It) {
-      AActor *Actor = *It;
-      if (Actor) {
-        if (Actor->GetActorLabel().Equals(ActorName, ESearchCase::IgnoreCase) ||
-            Actor->GetName().Equals(ActorName, ESearchCase::IgnoreCase)) {
-          TargetActor = Actor;
-          break;
-        }
-      }
-    }
-  }
-
-  if (!TargetActor) {
-    for (AActor *Actor : AllActors) {
-      if (Actor &&
-          (Actor->GetActorLabel().Equals(ActorName, ESearchCase::IgnoreCase) ||
-           Actor->GetName().Equals(ActorName, ESearchCase::IgnoreCase))) {
-        TargetActor = Actor;
-        break;
-      }
-    }
-  }
-
-  if (!TargetActor) {
-    TSharedPtr<FJsonObject> Resp = MakeShared<FJsonObject>();
-    Resp->SetStringField(
-        TEXT("error"),
-        FString::Printf(TEXT("Actor not found: %s"), *ActorName));
-    Resp->SetStringField(TEXT("actorName"), ActorName);
-    Resp->SetNumberField(TEXT("blendWeight"), BlendWeight);
-
-    SendAutomationResponse(RequestingSocket, RequestId, false,
-                           TEXT("Actor not found"), Resp,
-                           TEXT("ACTOR_NOT_FOUND"));
-    return true;
-  }
-
-  USkeletalMeshComponent *SkelMeshComp =
-      TargetActor->FindComponentByClass<USkeletalMeshComponent>();
-  if (!SkelMeshComp) {
-    SendAutomationError(RequestingSocket, RequestId,
-                        TEXT("Skeletal mesh component not found"),
-                        TEXT("COMPONENT_NOT_FOUND"));
-    return true;
-  }
-
-  SkelMeshComp->SetSimulatePhysics(true);
-  SkelMeshComp->SetCollisionEnabled(ECollisionEnabled::QueryAndPhysics);
-
-  if (SkelMeshComp->GetPhysicsAsset()) {
-    SkelMeshComp->SetAllBodiesSimulatePhysics(true);
-    SkelMeshComp->SetUpdateAnimationInEditor(BlendWeight < 1.0);
-  }
-
-  TSharedPtr<FJsonObject> Resp = MakeShared<FJsonObject>();
-  Resp->SetBoolField(TEXT("success"), true);
-  Resp->SetStringField(TEXT("actorName"), ActorName);
-  Resp->SetNumberField(TEXT("blendWeight"), BlendWeight);
-  Resp->SetBoolField(TEXT("ragdollActive"),
-                     SkelMeshComp->IsSimulatingPhysics());
-  Resp->SetBoolField(TEXT("hasPhysicsAsset"),
-                     SkelMeshComp->GetPhysicsAsset() != nullptr);
-
-  if (SkelMeshComp->GetPhysicsAsset()) {
-    Resp->SetStringField(TEXT("physicsAssetPath"),
-                         SkelMeshComp->GetPhysicsAsset()->GetPathName());
-  }
-
-  SendAutomationResponse(RequestingSocket, RequestId, true,
-                         TEXT("Ragdoll setup completed"), Resp, FString());
-  return true;
-#else
-  SendAutomationResponse(RequestingSocket, RequestId, false,
-                         TEXT("setup_ragdoll requires editor build"), nullptr,
-                         TEXT("NOT_IMPLEMENTED"));
-  return true;
-#endif
-}