unreal-engine-mcp-server 0.5.4 → 0.5.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (468) hide show
  1. package/dist/automation/bridge.d.ts.map +1 -0
  2. package/dist/automation/bridge.js.map +1 -0
  3. package/dist/automation/connection-manager.d.ts.map +1 -0
  4. package/dist/automation/connection-manager.js.map +1 -0
  5. package/dist/automation/handshake.d.ts.map +1 -0
  6. package/dist/automation/handshake.js.map +1 -0
  7. package/dist/automation/index.d.ts.map +1 -0
  8. package/dist/automation/index.js.map +1 -0
  9. package/dist/automation/message-handler.d.ts.map +1 -0
  10. package/dist/automation/message-handler.js.map +1 -0
  11. package/dist/automation/request-tracker.d.ts.map +1 -0
  12. package/dist/automation/request-tracker.js.map +1 -0
  13. package/dist/automation/types.d.ts.map +1 -0
  14. package/dist/automation/types.js.map +1 -0
  15. package/dist/cli.d.ts.map +1 -0
  16. package/dist/cli.js +4 -3
  17. package/dist/cli.js.map +1 -0
  18. package/dist/config/class-aliases.d.ts.map +1 -0
  19. package/dist/config/class-aliases.js.map +1 -0
  20. package/dist/config.d.ts.map +1 -0
  21. package/dist/config.js.map +1 -0
  22. package/dist/constants.d.ts.map +1 -0
  23. package/dist/constants.js.map +1 -0
  24. package/dist/graphql/loaders.d.ts.map +1 -0
  25. package/dist/graphql/loaders.js.map +1 -0
  26. package/dist/graphql/resolvers.d.ts.map +1 -0
  27. package/dist/graphql/resolvers.js +29 -29
  28. package/dist/graphql/resolvers.js.map +1 -0
  29. package/dist/graphql/schema.d.ts.map +1 -0
  30. package/dist/graphql/schema.js.map +1 -0
  31. package/dist/graphql/server.d.ts.map +1 -0
  32. package/dist/graphql/server.js.map +1 -0
  33. package/dist/graphql/types.d.ts.map +1 -0
  34. package/dist/graphql/types.js.map +1 -0
  35. package/dist/handlers/resource-handlers.d.ts.map +1 -0
  36. package/dist/handlers/resource-handlers.js.map +1 -0
  37. package/dist/index.d.ts +1 -0
  38. package/dist/index.d.ts.map +1 -0
  39. package/dist/index.js +64 -7
  40. package/dist/index.js.map +1 -0
  41. package/dist/resources/actors.d.ts.map +1 -0
  42. package/dist/resources/actors.js.map +1 -0
  43. package/dist/resources/assets.d.ts.map +1 -0
  44. package/dist/resources/assets.js +6 -4
  45. package/dist/resources/assets.js.map +1 -0
  46. package/dist/resources/levels.d.ts.map +1 -0
  47. package/dist/resources/levels.js.map +1 -0
  48. package/dist/server/resource-registry.d.ts.map +1 -0
  49. package/dist/server/resource-registry.js.map +1 -0
  50. package/dist/server/tool-registry.d.ts.map +1 -0
  51. package/dist/server/tool-registry.js.map +1 -0
  52. package/dist/server-setup.d.ts.map +1 -0
  53. package/dist/server-setup.js.map +1 -0
  54. package/dist/services/health-monitor.d.ts.map +1 -0
  55. package/dist/services/health-monitor.js.map +1 -0
  56. package/dist/services/metrics-server.d.ts.map +1 -0
  57. package/dist/services/metrics-server.js.map +1 -0
  58. package/dist/tools/actors.d.ts.map +1 -0
  59. package/dist/tools/actors.js +3 -1
  60. package/dist/tools/actors.js.map +1 -0
  61. package/dist/tools/animation.d.ts.map +1 -0
  62. package/dist/tools/animation.js +2 -2
  63. package/dist/tools/animation.js.map +1 -0
  64. package/dist/tools/assets.d.ts.map +1 -0
  65. package/dist/tools/assets.js.map +1 -0
  66. package/dist/tools/audio.d.ts.map +1 -0
  67. package/dist/tools/audio.js.map +1 -0
  68. package/dist/tools/base-tool.d.ts.map +1 -0
  69. package/dist/tools/base-tool.js.map +1 -0
  70. package/dist/tools/behavior-tree.d.ts.map +1 -0
  71. package/dist/tools/behavior-tree.js.map +1 -0
  72. package/dist/tools/blueprint.d.ts.map +1 -0
  73. package/dist/tools/blueprint.js +4 -2
  74. package/dist/tools/blueprint.js.map +1 -0
  75. package/dist/tools/consolidated-tool-definitions.d.ts.map +1 -0
  76. package/dist/tools/consolidated-tool-definitions.js.map +1 -0
  77. package/dist/tools/consolidated-tool-handlers.d.ts.map +1 -0
  78. package/dist/tools/consolidated-tool-handlers.js.map +1 -0
  79. package/dist/tools/debug.d.ts.map +1 -0
  80. package/dist/tools/debug.js +3 -1
  81. package/dist/tools/debug.js.map +1 -0
  82. package/dist/tools/dynamic-handler-registry.d.ts.map +1 -0
  83. package/dist/tools/dynamic-handler-registry.js +3 -1
  84. package/dist/tools/dynamic-handler-registry.js.map +1 -0
  85. package/dist/tools/editor.d.ts.map +1 -0
  86. package/dist/tools/editor.js +1 -1
  87. package/dist/tools/editor.js.map +1 -0
  88. package/dist/tools/engine.d.ts.map +1 -0
  89. package/dist/tools/engine.js.map +1 -0
  90. package/dist/tools/environment.d.ts.map +1 -0
  91. package/dist/tools/environment.js +2 -2
  92. package/dist/tools/environment.js.map +1 -0
  93. package/dist/tools/foliage.d.ts.map +1 -0
  94. package/dist/tools/foliage.js.map +1 -0
  95. package/dist/tools/handlers/actor-handlers.d.ts +1 -1
  96. package/dist/tools/handlers/actor-handlers.d.ts.map +1 -0
  97. package/dist/tools/handlers/actor-handlers.js +6 -5
  98. package/dist/tools/handlers/actor-handlers.js.map +1 -0
  99. package/dist/tools/handlers/animation-handlers.d.ts.map +1 -0
  100. package/dist/tools/handlers/animation-handlers.js.map +1 -0
  101. package/dist/tools/handlers/argument-helper.d.ts.map +1 -0
  102. package/dist/tools/handlers/argument-helper.js.map +1 -0
  103. package/dist/tools/handlers/asset-handlers.d.ts.map +1 -0
  104. package/dist/tools/handlers/asset-handlers.js +5 -1
  105. package/dist/tools/handlers/asset-handlers.js.map +1 -0
  106. package/dist/tools/handlers/audio-handlers.d.ts.map +1 -0
  107. package/dist/tools/handlers/audio-handlers.js.map +1 -0
  108. package/dist/tools/handlers/blueprint-handlers.d.ts.map +1 -0
  109. package/dist/tools/handlers/blueprint-handlers.js +2 -1
  110. package/dist/tools/handlers/blueprint-handlers.js.map +1 -0
  111. package/dist/tools/handlers/common-handlers.d.ts.map +1 -0
  112. package/dist/tools/handlers/common-handlers.js.map +1 -0
  113. package/dist/tools/handlers/editor-handlers.d.ts.map +1 -0
  114. package/dist/tools/handlers/editor-handlers.js +12 -2
  115. package/dist/tools/handlers/editor-handlers.js.map +1 -0
  116. package/dist/tools/handlers/effect-handlers.d.ts.map +1 -0
  117. package/dist/tools/handlers/effect-handlers.js.map +1 -0
  118. package/dist/tools/handlers/environment-handlers.d.ts.map +1 -0
  119. package/dist/tools/handlers/environment-handlers.js.map +1 -0
  120. package/dist/tools/handlers/graph-handlers.d.ts.map +1 -0
  121. package/dist/tools/handlers/graph-handlers.js +61 -1
  122. package/dist/tools/handlers/graph-handlers.js.map +1 -0
  123. package/dist/tools/handlers/input-handlers.d.ts.map +1 -0
  124. package/dist/tools/handlers/input-handlers.js.map +1 -0
  125. package/dist/tools/handlers/inspect-handlers.d.ts.map +1 -0
  126. package/dist/tools/handlers/inspect-handlers.js.map +1 -0
  127. package/dist/tools/handlers/level-handlers.d.ts.map +1 -0
  128. package/dist/tools/handlers/level-handlers.js.map +1 -0
  129. package/dist/tools/handlers/lighting-handlers.d.ts.map +1 -0
  130. package/dist/tools/handlers/lighting-handlers.js +23 -1
  131. package/dist/tools/handlers/lighting-handlers.js.map +1 -0
  132. package/dist/tools/handlers/performance-handlers.d.ts.map +1 -0
  133. package/dist/tools/handlers/performance-handlers.js +15 -2
  134. package/dist/tools/handlers/performance-handlers.js.map +1 -0
  135. package/dist/tools/handlers/pipeline-handlers.d.ts.map +1 -0
  136. package/dist/tools/handlers/pipeline-handlers.js.map +1 -0
  137. package/dist/tools/handlers/sequence-handlers.d.ts.map +1 -0
  138. package/dist/tools/handlers/sequence-handlers.js.map +1 -0
  139. package/dist/tools/handlers/system-handlers.d.ts.map +1 -0
  140. package/dist/tools/handlers/system-handlers.js +16 -1
  141. package/dist/tools/handlers/system-handlers.js.map +1 -0
  142. package/dist/tools/input.d.ts.map +1 -0
  143. package/dist/tools/input.js +3 -1
  144. package/dist/tools/input.js.map +1 -0
  145. package/dist/tools/introspection.d.ts.map +1 -0
  146. package/dist/tools/introspection.js.map +1 -0
  147. package/dist/tools/landscape.d.ts.map +1 -0
  148. package/dist/tools/landscape.js +3 -1
  149. package/dist/tools/landscape.js.map +1 -0
  150. package/dist/tools/level.d.ts.map +1 -0
  151. package/dist/tools/level.js.map +1 -0
  152. package/dist/tools/lighting.d.ts.map +1 -0
  153. package/dist/tools/lighting.js +3 -1
  154. package/dist/tools/lighting.js.map +1 -0
  155. package/dist/tools/logs.d.ts.map +1 -0
  156. package/dist/tools/logs.js.map +1 -0
  157. package/dist/tools/materials.d.ts.map +1 -0
  158. package/dist/tools/materials.js +3 -1
  159. package/dist/tools/materials.js.map +1 -0
  160. package/dist/tools/niagara.d.ts.map +1 -0
  161. package/dist/tools/niagara.js +7 -5
  162. package/dist/tools/niagara.js.map +1 -0
  163. package/dist/tools/performance.d.ts.map +1 -0
  164. package/dist/tools/performance.js.map +1 -0
  165. package/dist/tools/physics.d.ts.map +1 -0
  166. package/dist/tools/physics.js +9 -7
  167. package/dist/tools/physics.js.map +1 -0
  168. package/dist/tools/property-dictionary.d.ts.map +1 -0
  169. package/dist/tools/property-dictionary.js.map +1 -0
  170. package/dist/tools/sequence.d.ts.map +1 -0
  171. package/dist/tools/sequence.js +3 -1
  172. package/dist/tools/sequence.js.map +1 -0
  173. package/dist/tools/tool-definition-utils.d.ts.map +1 -0
  174. package/dist/tools/tool-definition-utils.js.map +1 -0
  175. package/dist/tools/ui.d.ts.map +1 -0
  176. package/dist/tools/ui.js +3 -1
  177. package/dist/tools/ui.js.map +1 -0
  178. package/dist/types/automation-responses.d.ts.map +1 -0
  179. package/dist/types/automation-responses.js.map +1 -0
  180. package/dist/types/env.d.ts.map +1 -0
  181. package/dist/types/env.js.map +1 -0
  182. package/dist/types/handler-types.d.ts.map +1 -0
  183. package/dist/types/handler-types.js.map +1 -0
  184. package/dist/types/tool-interfaces.d.ts.map +1 -0
  185. package/dist/types/tool-interfaces.js.map +1 -0
  186. package/dist/types/tool-types.d.ts.map +1 -0
  187. package/dist/types/tool-types.js.map +1 -0
  188. package/dist/unreal-bridge.d.ts +1 -0
  189. package/dist/unreal-bridge.d.ts.map +1 -0
  190. package/dist/unreal-bridge.js +8 -0
  191. package/dist/unreal-bridge.js.map +1 -0
  192. package/dist/utils/command-validator.d.ts.map +1 -0
  193. package/dist/utils/command-validator.js.map +1 -0
  194. package/dist/utils/elicitation.d.ts.map +1 -0
  195. package/dist/utils/elicitation.js.map +1 -0
  196. package/dist/utils/error-handler.d.ts.map +1 -0
  197. package/dist/utils/error-handler.js.map +1 -0
  198. package/dist/utils/ini-reader.d.ts.map +1 -0
  199. package/dist/utils/ini-reader.js.map +1 -0
  200. package/dist/utils/logger.d.ts.map +1 -0
  201. package/dist/utils/logger.js.map +1 -0
  202. package/dist/utils/normalize.d.ts.map +1 -0
  203. package/dist/utils/normalize.js.map +1 -0
  204. package/dist/utils/path-security.d.ts.map +1 -0
  205. package/dist/utils/path-security.js.map +1 -0
  206. package/dist/utils/response-factory.d.ts.map +1 -0
  207. package/dist/utils/response-factory.js +3 -1
  208. package/dist/utils/response-factory.js.map +1 -0
  209. package/dist/utils/response-validator.d.ts.map +1 -0
  210. package/dist/utils/response-validator.js.map +1 -0
  211. package/dist/utils/result-helpers.d.ts.map +1 -0
  212. package/dist/utils/result-helpers.js.map +1 -0
  213. package/dist/utils/safe-json.d.ts.map +1 -0
  214. package/dist/utils/safe-json.js.map +1 -0
  215. package/dist/utils/unreal-command-queue.d.ts.map +1 -0
  216. package/dist/utils/unreal-command-queue.js.map +1 -0
  217. package/dist/utils/validation.d.ts.map +1 -0
  218. package/dist/utils/validation.js.map +1 -0
  219. package/dist/wasm/index.d.ts.map +1 -0
  220. package/dist/wasm/index.js.map +1 -0
  221. package/package.json +12 -34
  222. package/server.json +2 -2
  223. package/.dockerignore +0 -57
  224. package/.env.example +0 -26
  225. package/.env.production +0 -61
  226. package/.eslintrc.json +0 -0
  227. package/.eslintrc.override.json +0 -8
  228. package/.github/ISSUE_TEMPLATE/bug_report.yml +0 -94
  229. package/.github/ISSUE_TEMPLATE/config.yml +0 -8
  230. package/.github/ISSUE_TEMPLATE/feature_request.yml +0 -56
  231. package/.github/copilot-instructions.md +0 -478
  232. package/.github/dependabot.yml +0 -19
  233. package/.github/labeler.yml +0 -24
  234. package/.github/labels.yml +0 -70
  235. package/.github/pull_request_template.md +0 -42
  236. package/.github/release-drafter-config.yml +0 -51
  237. package/.github/workflows/auto-merge.yml +0 -38
  238. package/.github/workflows/ci.yml +0 -38
  239. package/.github/workflows/dependency-review.yml +0 -17
  240. package/.github/workflows/gemini-issue-triage.yml +0 -172
  241. package/.github/workflows/greetings.yml +0 -27
  242. package/.github/workflows/labeler.yml +0 -17
  243. package/.github/workflows/links.yml +0 -80
  244. package/.github/workflows/pr-size-labeler.yml +0 -137
  245. package/.github/workflows/publish-mcp.yml +0 -79
  246. package/.github/workflows/release-drafter.yml +0 -24
  247. package/.github/workflows/release.yml +0 -112
  248. package/.github/workflows/semantic-pull-request.yml +0 -35
  249. package/.github/workflows/smoke-test.yml +0 -36
  250. package/.github/workflows/stale.yml +0 -28
  251. package/CONTRIBUTING.md +0 -140
  252. package/Dockerfile +0 -37
  253. package/GEMINI.md +0 -115
  254. package/Public/Plugin_setup_guide.mp4 +0 -0
  255. package/Public/icon.png +0 -0
  256. package/claude_desktop_config_example.json +0 -15
  257. package/dist/types/responses.d.ts +0 -249
  258. package/dist/types/responses.js +0 -2
  259. package/docs/GraphQL-API.md +0 -888
  260. package/docs/Migration-Guide-v0.5.0.md +0 -684
  261. package/docs/Roadmap.md +0 -53
  262. package/docs/WebAssembly-Integration.md +0 -628
  263. package/docs/editor-plugin-extension.md +0 -370
  264. package/docs/handler-mapping.md +0 -249
  265. package/docs/native-automation-progress.md +0 -128
  266. package/docs/testing-guide.md +0 -423
  267. package/eslint.config.mjs +0 -68
  268. package/mcp-config-example.json +0 -14
  269. package/plugins/McpAutomationBridge/Config/FilterPlugin.ini +0 -8
  270. package/plugins/McpAutomationBridge/McpAutomationBridge.uplugin +0 -64
  271. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/McpAutomationBridge.Build.cs +0 -189
  272. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeGlobals.cpp +0 -22
  273. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeGlobals.h +0 -30
  274. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeHelpers.h +0 -1983
  275. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeModule.cpp +0 -72
  276. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeSettings.cpp +0 -46
  277. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeSubsystem.cpp +0 -846
  278. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_AnimationHandlers.cpp +0 -2393
  279. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_AssetQueryHandlers.cpp +0 -300
  280. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_AssetWorkflowHandlers.cpp +0 -2807
  281. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_AudioHandlers.cpp +0 -1087
  282. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BehaviorTreeHandlers.cpp +0 -488
  283. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintCreationHandlers.cpp +0 -643
  284. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintCreationHandlers.h +0 -31
  285. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintGraphHandlers.cpp +0 -1094
  286. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintHandlers.cpp +0 -5750
  287. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintHandlers_List.cpp +0 -152
  288. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_ControlHandlers.cpp +0 -2614
  289. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_DebugHandlers.cpp +0 -42
  290. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_EditorFunctionHandlers.cpp +0 -1237
  291. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_EffectHandlers.cpp +0 -1725
  292. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_EnvironmentHandlers.cpp +0 -2265
  293. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_FoliageHandlers.cpp +0 -954
  294. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_InputHandlers.cpp +0 -209
  295. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_InsightsHandlers.cpp +0 -41
  296. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_LandscapeHandlers.cpp +0 -1164
  297. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_LevelHandlers.cpp +0 -762
  298. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_LightingHandlers.cpp +0 -663
  299. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_LogHandlers.cpp +0 -136
  300. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_MaterialGraphHandlers.cpp +0 -494
  301. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_NiagaraGraphHandlers.cpp +0 -278
  302. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_NiagaraHandlers.cpp +0 -625
  303. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_PerformanceHandlers.cpp +0 -401
  304. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_PipelineHandlers.cpp +0 -67
  305. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_ProcessRequest.cpp +0 -472
  306. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_PropertyHandlers.cpp +0 -2634
  307. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_RenderHandlers.cpp +0 -189
  308. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_SCSHandlers.cpp +0 -917
  309. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_SCSHandlers.h +0 -39
  310. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_SequenceHandlers.cpp +0 -2706
  311. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_SequencerHandlers.cpp +0 -519
  312. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_TestHandlers.cpp +0 -38
  313. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_UiHandlers.cpp +0 -668
  314. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_WorldPartitionHandlers.cpp +0 -346
  315. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpBridgeWebSocket.cpp +0 -1345
  316. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpBridgeWebSocket.h +0 -149
  317. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpConnectionManager.cpp +0 -782
  318. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Public/McpAutomationBridgeSettings.h +0 -115
  319. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Public/McpAutomationBridgeSubsystem.h +0 -796
  320. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Public/McpConnectionManager.h +0 -117
  321. package/scripts/check-unreal-connection.mjs +0 -19
  322. package/scripts/clean-tmp.js +0 -23
  323. package/scripts/patch-wasm.js +0 -26
  324. package/scripts/run-all-tests.mjs +0 -136
  325. package/scripts/smoke-test.ts +0 -94
  326. package/scripts/sync-mcp-plugin.js +0 -143
  327. package/scripts/test-no-plugin-alternates.mjs +0 -113
  328. package/scripts/validate-server.js +0 -46
  329. package/scripts/verify-automation-bridge.js +0 -200
  330. package/src/automation/bridge.ts +0 -630
  331. package/src/automation/connection-manager.ts +0 -148
  332. package/src/automation/handshake.ts +0 -99
  333. package/src/automation/index.ts +0 -2
  334. package/src/automation/message-handler.ts +0 -192
  335. package/src/automation/request-tracker.ts +0 -155
  336. package/src/automation/types.ts +0 -108
  337. package/src/cli.ts +0 -34
  338. package/src/config/class-aliases.ts +0 -65
  339. package/src/config.ts +0 -73
  340. package/src/constants.ts +0 -29
  341. package/src/graphql/loaders.ts +0 -244
  342. package/src/graphql/resolvers.ts +0 -1008
  343. package/src/graphql/schema.ts +0 -452
  344. package/src/graphql/server.ts +0 -156
  345. package/src/graphql/types.ts +0 -10
  346. package/src/handlers/resource-handlers.ts +0 -186
  347. package/src/index.ts +0 -243
  348. package/src/resources/actors.ts +0 -127
  349. package/src/resources/assets.ts +0 -286
  350. package/src/resources/levels.ts +0 -68
  351. package/src/server/resource-registry.ts +0 -47
  352. package/src/server/tool-registry.ts +0 -354
  353. package/src/server-setup.ts +0 -114
  354. package/src/services/health-monitor.ts +0 -132
  355. package/src/services/metrics-server.ts +0 -176
  356. package/src/tools/actors.ts +0 -564
  357. package/src/tools/animation.ts +0 -941
  358. package/src/tools/assets.ts +0 -394
  359. package/src/tools/audio.ts +0 -499
  360. package/src/tools/base-tool.ts +0 -52
  361. package/src/tools/behavior-tree.ts +0 -45
  362. package/src/tools/blueprint.ts +0 -940
  363. package/src/tools/consolidated-tool-definitions.ts +0 -1256
  364. package/src/tools/consolidated-tool-handlers.ts +0 -302
  365. package/src/tools/debug.ts +0 -622
  366. package/src/tools/dynamic-handler-registry.ts +0 -33
  367. package/src/tools/editor.ts +0 -435
  368. package/src/tools/engine.ts +0 -43
  369. package/src/tools/environment.ts +0 -281
  370. package/src/tools/foliage.ts +0 -596
  371. package/src/tools/handlers/actor-handlers.ts +0 -244
  372. package/src/tools/handlers/animation-handlers.ts +0 -237
  373. package/src/tools/handlers/argument-helper.ts +0 -142
  374. package/src/tools/handlers/asset-handlers.ts +0 -550
  375. package/src/tools/handlers/audio-handlers.ts +0 -194
  376. package/src/tools/handlers/blueprint-handlers.ts +0 -380
  377. package/src/tools/handlers/common-handlers.ts +0 -108
  378. package/src/tools/handlers/editor-handlers.ts +0 -124
  379. package/src/tools/handlers/effect-handlers.ts +0 -224
  380. package/src/tools/handlers/environment-handlers.ts +0 -183
  381. package/src/tools/handlers/graph-handlers.ts +0 -117
  382. package/src/tools/handlers/input-handlers.ts +0 -28
  383. package/src/tools/handlers/inspect-handlers.ts +0 -450
  384. package/src/tools/handlers/level-handlers.ts +0 -253
  385. package/src/tools/handlers/lighting-handlers.ts +0 -151
  386. package/src/tools/handlers/performance-handlers.ts +0 -132
  387. package/src/tools/handlers/pipeline-handlers.ts +0 -194
  388. package/src/tools/handlers/sequence-handlers.ts +0 -438
  389. package/src/tools/handlers/system-handlers.ts +0 -564
  390. package/src/tools/input.ts +0 -160
  391. package/src/tools/introspection.ts +0 -689
  392. package/src/tools/landscape.ts +0 -649
  393. package/src/tools/level.ts +0 -989
  394. package/src/tools/lighting.ts +0 -1052
  395. package/src/tools/logs.ts +0 -219
  396. package/src/tools/materials.ts +0 -295
  397. package/src/tools/niagara.ts +0 -485
  398. package/src/tools/performance.ts +0 -661
  399. package/src/tools/physics.ts +0 -679
  400. package/src/tools/property-dictionary.ts +0 -98
  401. package/src/tools/sequence.ts +0 -385
  402. package/src/tools/tool-definition-utils.ts +0 -35
  403. package/src/tools/ui.ts +0 -452
  404. package/src/types/automation-responses.ts +0 -119
  405. package/src/types/env.ts +0 -17
  406. package/src/types/handler-types.ts +0 -442
  407. package/src/types/responses.ts +0 -355
  408. package/src/types/tool-interfaces.ts +0 -250
  409. package/src/types/tool-types.ts +0 -575
  410. package/src/unreal-bridge.ts +0 -693
  411. package/src/utils/command-validator.ts +0 -139
  412. package/src/utils/elicitation.ts +0 -132
  413. package/src/utils/error-handler.ts +0 -287
  414. package/src/utils/ini-reader.ts +0 -86
  415. package/src/utils/logger.ts +0 -35
  416. package/src/utils/normalize.test.ts +0 -162
  417. package/src/utils/normalize.ts +0 -146
  418. package/src/utils/path-security.ts +0 -43
  419. package/src/utils/response-factory.ts +0 -44
  420. package/src/utils/response-validator.ts +0 -395
  421. package/src/utils/result-helpers.ts +0 -195
  422. package/src/utils/safe-json.test.ts +0 -90
  423. package/src/utils/safe-json.ts +0 -70
  424. package/src/utils/unreal-command-queue.ts +0 -166
  425. package/src/utils/validation.test.ts +0 -184
  426. package/src/utils/validation.ts +0 -312
  427. package/src/wasm/index.ts +0 -838
  428. package/test-server.mjs +0 -100
  429. package/tests/test-animation.mjs +0 -369
  430. package/tests/test-asset-advanced.mjs +0 -82
  431. package/tests/test-asset-graph.mjs +0 -311
  432. package/tests/test-audio.mjs +0 -417
  433. package/tests/test-automation-timeouts.mjs +0 -98
  434. package/tests/test-behavior-tree.mjs +0 -444
  435. package/tests/test-blueprint-graph.mjs +0 -410
  436. package/tests/test-blueprint.mjs +0 -577
  437. package/tests/test-client-mode.mjs +0 -86
  438. package/tests/test-console-command.mjs +0 -56
  439. package/tests/test-control-actor.mjs +0 -425
  440. package/tests/test-control-editor.mjs +0 -112
  441. package/tests/test-graphql.mjs +0 -372
  442. package/tests/test-input.mjs +0 -349
  443. package/tests/test-inspect.mjs +0 -302
  444. package/tests/test-landscape.mjs +0 -316
  445. package/tests/test-lighting.mjs +0 -428
  446. package/tests/test-manage-asset.mjs +0 -438
  447. package/tests/test-manage-level.mjs +0 -89
  448. package/tests/test-materials.mjs +0 -356
  449. package/tests/test-niagara.mjs +0 -185
  450. package/tests/test-no-inline-python.mjs +0 -122
  451. package/tests/test-performance.mjs +0 -539
  452. package/tests/test-plugin-handshake.mjs +0 -82
  453. package/tests/test-runner.mjs +0 -993
  454. package/tests/test-sequence.mjs +0 -104
  455. package/tests/test-system.mjs +0 -96
  456. package/tests/test-wasm.mjs +0 -283
  457. package/tests/test-world-partition.mjs +0 -215
  458. package/tsconfig.json +0 -56
  459. package/vitest.config.ts +0 -35
  460. package/wasm/Cargo.lock +0 -363
  461. package/wasm/Cargo.toml +0 -42
  462. package/wasm/LICENSE +0 -21
  463. package/wasm/README.md +0 -253
  464. package/wasm/src/dependency_resolver.rs +0 -377
  465. package/wasm/src/lib.rs +0 -153
  466. package/wasm/src/property_parser.rs +0 -271
  467. package/wasm/src/transform_math.rs +0 -396
  468. package/wasm/tests/integration.rs +0 -109
@@ -1,782 +0,0 @@
1
- #include "McpConnectionManager.h"
2
- #include "HAL/PlatformTime.h"
3
- #include "McpAutomationBridgeSettings.h"
4
- #include "McpAutomationBridgeSubsystem.h"
5
- #include "McpBridgeWebSocket.h"
6
- #include "Misc/Guid.h"
7
- #include "Serialization/JsonReader.h"
8
- #include "Serialization/JsonSerializer.h"
9
-
10
- // Reuse the log category from the subsystem for consistency
11
- // (It is declared extern in McpAutomationBridgeSubsystem.h)
12
-
13
- static inline FString SanitizeForLog(const FString &In) {
14
- if (In.IsEmpty())
15
- return FString();
16
- FString Out;
17
- Out.Reserve(FMath::Min<int32>(In.Len(), 1024));
18
- for (int32 i = 0; i < In.Len(); ++i) {
19
- const TCHAR C = In[i];
20
- if (C >= 32 && C != 127)
21
- Out.AppendChar(C);
22
- else
23
- Out.AppendChar('?');
24
- }
25
- if (Out.Len() > 512)
26
- Out = Out.Left(512) + TEXT("[TRUNCATED]");
27
- return Out;
28
- }
29
-
30
- FMcpConnectionManager::FMcpConnectionManager() {}
31
-
32
- FMcpConnectionManager::~FMcpConnectionManager() { Stop(); }
33
-
34
- void FMcpConnectionManager::Initialize(
35
- const UMcpAutomationBridgeSettings *Settings) {
36
- if (Settings) {
37
- if (!Settings->ListenHost.IsEmpty())
38
- EnvListenHost = Settings->ListenHost;
39
- if (!Settings->ListenPorts.IsEmpty())
40
- EnvListenPorts = Settings->ListenPorts;
41
- if (!Settings->EndpointUrl.IsEmpty())
42
- EndpointUrl = Settings->EndpointUrl;
43
- if (!Settings->CapabilityToken.IsEmpty())
44
- CapabilityToken = Settings->CapabilityToken;
45
- if (Settings->AutoReconnectDelay > 0.0f)
46
- AutoReconnectDelaySeconds = Settings->AutoReconnectDelay;
47
- if (Settings->ClientPort > 0)
48
- ClientPort = Settings->ClientPort;
49
- bRequireCapabilityToken = Settings->bRequireCapabilityToken;
50
- if (Settings->HeartbeatTimeoutSeconds > 0.0f)
51
- HeartbeatTimeoutSeconds = Settings->HeartbeatTimeoutSeconds;
52
- }
53
- }
54
-
55
- void FMcpConnectionManager::Start() {
56
- if (!TickerHandle.IsValid()) {
57
- // We use a lambda for the ticker that holds a weak pointer to this manager
58
- TWeakPtr<FMcpConnectionManager> WeakSelf = AsShared();
59
- const FTickerDelegate TickDelegate =
60
- FTickerDelegate::CreateLambda([WeakSelf](float DeltaTime) -> bool {
61
- if (TSharedPtr<FMcpConnectionManager> StrongSelf = WeakSelf.Pin()) {
62
- return StrongSelf->Tick(DeltaTime);
63
- }
64
- return false;
65
- });
66
-
67
- const UMcpAutomationBridgeSettings *Settings =
68
- GetDefault<UMcpAutomationBridgeSettings>();
69
- const float Interval = (Settings && Settings->TickerIntervalSeconds > 0.0f)
70
- ? Settings->TickerIntervalSeconds
71
- : 0.25f;
72
- TickerHandle = FTSTicker::GetCoreTicker().AddTicker(TickDelegate, Interval);
73
- }
74
-
75
- bBridgeAvailable = true;
76
- bReconnectEnabled = AutoReconnectDelaySeconds > 0.0f;
77
- TimeUntilReconnect = 0.0f;
78
- UE_LOG(LogMcpAutomationBridgeSubsystem, Log,
79
- TEXT("Starting MCP connection manager."));
80
- AttemptConnection();
81
- }
82
-
83
- void FMcpConnectionManager::Stop() {
84
- if (TickerHandle.IsValid()) {
85
- FTSTicker::GetCoreTicker().RemoveTicker(TickerHandle);
86
- TickerHandle = FTSTicker::FDelegateHandle();
87
- }
88
-
89
- bBridgeAvailable = false;
90
- bReconnectEnabled = false;
91
- TimeUntilReconnect = 0.0f;
92
-
93
- // Close all active sockets
94
- for (TSharedPtr<FMcpBridgeWebSocket> &Socket : ActiveSockets) {
95
- if (Socket.IsValid()) {
96
- Socket->OnConnected().RemoveAll(this);
97
- Socket->OnConnectionError().RemoveAll(this);
98
- Socket->OnClosed().RemoveAll(this);
99
- Socket->OnMessage().RemoveAll(this);
100
- Socket->OnHeartbeat().RemoveAll(this);
101
- Socket->Close();
102
- }
103
- }
104
- ActiveSockets.Empty();
105
- ActiveSockets.Empty();
106
- {
107
- FScopeLock Lock(&PendingRequestsMutex);
108
- PendingRequestsToSockets.Empty();
109
- }
110
-
111
- UE_LOG(LogMcpAutomationBridgeSubsystem, Log,
112
- TEXT("MCP connection manager stopped."));
113
- }
114
-
115
- bool FMcpConnectionManager::IsConnected() const {
116
- for (const TSharedPtr<FMcpBridgeWebSocket> &Sock : ActiveSockets) {
117
- if (Sock.IsValid() && Sock->IsConnected())
118
- return true;
119
- }
120
- return false;
121
- }
122
-
123
- void FMcpConnectionManager::SetOnMessageReceived(
124
- FMcpMessageReceivedCallback InCallback) {
125
- OnMessageReceived = InCallback;
126
- }
127
-
128
- bool FMcpConnectionManager::Tick(float DeltaTime) {
129
- // Handle reconnect countdown
130
- if (bReconnectEnabled && TimeUntilReconnect > 0.0f) {
131
- TimeUntilReconnect -= DeltaTime;
132
- if (TimeUntilReconnect <= 0.0f) {
133
- TimeUntilReconnect = 0.0f;
134
- if (bBridgeAvailable) {
135
- AttemptConnection();
136
- }
137
- }
138
- }
139
-
140
- // Heartbeat monitoring
141
- if (bHeartbeatTrackingEnabled && HeartbeatTimeoutSeconds > 0.0f &&
142
- LastHeartbeatTimestamp > 0.0) {
143
- const double Now = FPlatformTime::Seconds();
144
- if ((Now - LastHeartbeatTimestamp) > HeartbeatTimeoutSeconds) {
145
- UE_LOG(LogMcpAutomationBridgeSubsystem, Warning,
146
- TEXT("Heartbeat timed out; forcing reconnect."));
147
- ForceReconnect(TEXT("Heartbeat timeout"));
148
- }
149
- }
150
-
151
- // Telemetry summary
152
- EmitAutomationTelemetrySummaryIfNeeded(FPlatformTime::Seconds());
153
-
154
- return true;
155
- }
156
-
157
- void FMcpConnectionManager::AttemptConnection() {
158
- if (!bBridgeAvailable)
159
- return;
160
-
161
- UE_LOG(LogMcpAutomationBridgeSubsystem, Log,
162
- TEXT("AttemptConnection invoked."));
163
-
164
- const UMcpAutomationBridgeSettings *Settings =
165
- GetDefault<UMcpAutomationBridgeSettings>();
166
- if (!Settings)
167
- return;
168
-
169
- auto IsAnyServerListening = [&]() -> bool {
170
- for (const TSharedPtr<FMcpBridgeWebSocket> &Sock : ActiveSockets) {
171
- if (Sock.IsValid() && Sock->IsListening())
172
- return true;
173
- }
174
- return false;
175
- };
176
-
177
- const bool bShouldListen = Settings->bAlwaysListen;
178
- if (bShouldListen && !IsAnyServerListening()) {
179
- const FString PortsStr =
180
- bEnvListenPortsSet ? EnvListenPorts : Settings->ListenPorts;
181
- TArray<FString> PortTokens;
182
- if (!PortsStr.IsEmpty()) {
183
- PortsStr.ParseIntoArray(PortTokens, TEXT(","), true);
184
- }
185
- if (PortTokens.Num() == 0)
186
- PortTokens.Add(TEXT("8090"));
187
- if (!Settings->bMultiListen && PortTokens.Num() > 0)
188
- PortTokens.SetNum(1);
189
-
190
- const FString HostToBind =
191
- EnvListenHost.IsEmpty() ? Settings->ListenHost : EnvListenHost;
192
- TWeakPtr<FMcpConnectionManager> WeakSelf = AsShared();
193
-
194
- for (const FString &Token : PortTokens) {
195
- const FString Trimmed = Token.TrimStartAndEnd();
196
- if (Trimmed.IsEmpty())
197
- continue;
198
-
199
- int32 Port = 0;
200
- if (!LexTryParseString(Port, *Trimmed) || Port <= 0)
201
- continue;
202
-
203
- bool bAlready = false;
204
- for (const TSharedPtr<FMcpBridgeWebSocket> &Sock : ActiveSockets) {
205
- if (Sock.IsValid() && Sock->IsListening() && Sock->GetPort() == Port) {
206
- bAlready = true;
207
- break;
208
- }
209
- }
210
- if (bAlready)
211
- continue;
212
-
213
- UE_LOG(LogMcpAutomationBridgeSubsystem, Log,
214
- TEXT("AttemptConnection: creating server listener on %s:%d"),
215
- *HostToBind, Port);
216
-
217
- TSharedPtr<FMcpBridgeWebSocket> ServerSocket =
218
- MakeShared<FMcpBridgeWebSocket>(Port, HostToBind,
219
- Settings->ListenBacklog,
220
- Settings->AcceptSleepSeconds);
221
- ServerSocket->InitializeWeakSelf(ServerSocket);
222
-
223
- ServerSocket->OnConnected().AddLambda(
224
- [WeakSelf](TSharedPtr<FMcpBridgeWebSocket> Sock) {
225
- if (TSharedPtr<FMcpConnectionManager> StrongSelf = WeakSelf.Pin()) {
226
- StrongSelf->HandleConnected(Sock);
227
- }
228
- });
229
-
230
- ServerSocket->OnClientConnected().AddLambda(
231
- [WeakSelf](TSharedPtr<FMcpBridgeWebSocket> ClientSock) {
232
- if (TSharedPtr<FMcpConnectionManager> StrongSelf = WeakSelf.Pin()) {
233
- StrongSelf->HandleClientConnected(ClientSock);
234
- }
235
- });
236
-
237
- ServerSocket->OnConnectionError().AddLambda(
238
- [WeakSelf](const FString &Err) {
239
- if (TSharedPtr<FMcpConnectionManager> StrongSelf = WeakSelf.Pin()) {
240
- StrongSelf->HandleServerConnectionError(Err);
241
- }
242
- });
243
-
244
- if (!ActiveSockets.Contains(ServerSocket))
245
- ActiveSockets.Add(ServerSocket);
246
- ServerSocket->Listen();
247
- }
248
- }
249
-
250
- if (!EndpointUrl.IsEmpty()) {
251
- bool bHasClientForEndpoint = false;
252
- for (const TSharedPtr<FMcpBridgeWebSocket> &Sock : ActiveSockets) {
253
- if (Sock.IsValid() && !Sock->IsListening() &&
254
- Sock->GetPort() == ClientPort) {
255
- bHasClientForEndpoint = true;
256
- break;
257
- }
258
- }
259
-
260
- if (!bHasClientForEndpoint) {
261
- UE_LOG(LogMcpAutomationBridgeSubsystem, Log,
262
- TEXT("AttemptConnection: creating client socket to %s"),
263
- *EndpointUrl);
264
- TMap<FString, FString> Headers;
265
- if (!CapabilityToken.IsEmpty()) {
266
- Headers.Add(TEXT("X-MCP-Capability-Token"), CapabilityToken);
267
- }
268
- TSharedPtr<FMcpBridgeWebSocket> ClientSocket =
269
- MakeShared<FMcpBridgeWebSocket>(EndpointUrl, TEXT("mcp-automation"),
270
- Headers);
271
- ClientSocket->InitializeWeakSelf(ClientSocket);
272
-
273
- TWeakPtr<FMcpConnectionManager> WeakSelf = AsShared();
274
-
275
- ClientSocket->OnConnected().AddLambda(
276
- [WeakSelf](TSharedPtr<FMcpBridgeWebSocket> Sock) {
277
- if (TSharedPtr<FMcpConnectionManager> StrongSelf = WeakSelf.Pin()) {
278
- StrongSelf->HandleConnected(Sock);
279
- }
280
- });
281
- ClientSocket->OnConnectionError().AddLambda(
282
- [WeakSelf, ClientSocket](const FString &Err) {
283
- if (TSharedPtr<FMcpConnectionManager> StrongSelf = WeakSelf.Pin()) {
284
- StrongSelf->HandleConnectionError(ClientSocket, Err);
285
- }
286
- });
287
- ClientSocket->OnMessage().AddLambda(
288
- [WeakSelf](TSharedPtr<FMcpBridgeWebSocket> Sock,
289
- const FString &Message) {
290
- if (TSharedPtr<FMcpConnectionManager> StrongSelf = WeakSelf.Pin()) {
291
- StrongSelf->HandleMessage(Sock, Message);
292
- }
293
- });
294
-
295
- ActiveSockets.Add(ClientSocket);
296
- ClientSocket->Connect();
297
- }
298
- }
299
- }
300
-
301
- void FMcpConnectionManager::ForceReconnect(const FString &Reason,
302
- float ReconnectDelayOverride) {
303
- UE_LOG(LogMcpAutomationBridgeSubsystem, Warning, TEXT("ForceReconnect: %s"),
304
- *Reason);
305
-
306
- for (TSharedPtr<FMcpBridgeWebSocket> &Socket : ActiveSockets) {
307
- if (Socket.IsValid()) {
308
- Socket->Close();
309
- }
310
- }
311
- ActiveSockets.Empty();
312
- ActiveSockets.Empty();
313
- {
314
- FScopeLock Lock(&PendingRequestsMutex);
315
- PendingRequestsToSockets.Empty();
316
- }
317
-
318
- bBridgeAvailable = false;
319
- if (bReconnectEnabled) {
320
- TimeUntilReconnect = (ReconnectDelayOverride >= 0.0f)
321
- ? ReconnectDelayOverride
322
- : AutoReconnectDelaySeconds;
323
- // Re-enable bridge availability flag so tick will attempt connection after
324
- // delay
325
- bBridgeAvailable = true;
326
- }
327
- }
328
-
329
- void FMcpConnectionManager::HandleConnected(
330
- TSharedPtr<FMcpBridgeWebSocket> Socket) {
331
- if (!Socket.IsValid())
332
- return;
333
- const int32 Port = Socket->GetPort();
334
- if (Socket->IsListening()) {
335
- UE_LOG(LogMcpAutomationBridgeSubsystem, Log,
336
- TEXT("Automation bridge listening on port=%d"), Port);
337
- } else if (Socket->IsConnected()) {
338
- UE_LOG(LogMcpAutomationBridgeSubsystem, Log,
339
- TEXT("Automation bridge connected (socket port=%d)."), Port);
340
- }
341
- bBridgeAvailable = true;
342
- }
343
-
344
- void FMcpConnectionManager::HandleClientConnected(
345
- TSharedPtr<FMcpBridgeWebSocket> ClientSocket) {
346
- if (!ClientSocket.IsValid())
347
- return;
348
- UE_LOG(LogMcpAutomationBridgeSubsystem, Log,
349
- TEXT("Client socket connected (port=%d)"), ClientSocket->GetPort());
350
-
351
- // Bind delegates to this manager instance
352
- // Since we are using TSharedFromThis, we can use AsShared() for binding
353
- // However, TFunction/Lambda binding with weak pointers is safer for async
354
- // callbacks
355
-
356
- TWeakPtr<FMcpConnectionManager> WeakSelf = AsShared();
357
-
358
- ClientSocket->OnMessage().AddLambda(
359
- [WeakSelf](TSharedPtr<FMcpBridgeWebSocket> Sock, const FString &Msg) {
360
- if (TSharedPtr<FMcpConnectionManager> StrongSelf = WeakSelf.Pin())
361
- StrongSelf->HandleMessage(Sock, Msg);
362
- });
363
-
364
- ClientSocket->OnClosed().AddLambda(
365
- [WeakSelf](TSharedPtr<FMcpBridgeWebSocket> Sock, int32 Code,
366
- const FString &Reason, bool bClean) {
367
- if (TSharedPtr<FMcpConnectionManager> StrongSelf = WeakSelf.Pin())
368
- StrongSelf->HandleClosed(Sock, Code, Reason, bClean);
369
- });
370
-
371
- TWeakPtr<FMcpBridgeWebSocket> WeakSocket = ClientSocket;
372
- ClientSocket->OnConnectionError().AddLambda(
373
- [WeakSelf, WeakSocket](const FString &Error) {
374
- if (TSharedPtr<FMcpConnectionManager> StrongSelf = WeakSelf.Pin()) {
375
- StrongSelf->HandleConnectionError(WeakSocket.Pin(), Error);
376
- }
377
- });
378
-
379
- ClientSocket->OnHeartbeat().AddLambda(
380
- [WeakSelf](TSharedPtr<FMcpBridgeWebSocket> Sock) {
381
- if (TSharedPtr<FMcpConnectionManager> StrongSelf = WeakSelf.Pin())
382
- StrongSelf->HandleHeartbeat(Sock);
383
- });
384
-
385
- if (!ActiveSockets.Contains(ClientSocket)) {
386
- ActiveSockets.Add(ClientSocket);
387
- }
388
- bBridgeAvailable = true;
389
-
390
- if (ClientSocket.IsValid()) {
391
- ClientSocket->NotifyMessageHandlerRegistered();
392
- }
393
- }
394
-
395
- void FMcpConnectionManager::HandleConnectionError(
396
- TSharedPtr<FMcpBridgeWebSocket> Socket, const FString &Error) {
397
- const int32 Port = Socket.IsValid() ? Socket->GetPort() : -1;
398
- UE_LOG(LogMcpAutomationBridgeSubsystem, Warning,
399
- TEXT("Automation bridge socket error (port=%d): %s"), Port, *Error);
400
-
401
- if (Socket.IsValid()) {
402
- Socket->OnMessage().RemoveAll(this);
403
- Socket->OnClosed().RemoveAll(this);
404
- Socket->OnConnectionError().RemoveAll(this);
405
- Socket->OnHeartbeat().RemoveAll(this);
406
- Socket->Close();
407
- ActiveSockets.Remove(Socket);
408
- }
409
-
410
- if (ActiveSockets.Num() == 0) {
411
- if (bReconnectEnabled) {
412
- TimeUntilReconnect = AutoReconnectDelaySeconds;
413
- }
414
- }
415
- }
416
-
417
- void FMcpConnectionManager::HandleServerConnectionError(const FString &Error) {
418
- UE_LOG(LogMcpAutomationBridgeSubsystem, Error,
419
- TEXT("Automation bridge server error: %s"), *Error);
420
- if (bReconnectEnabled) {
421
- TimeUntilReconnect = AutoReconnectDelaySeconds;
422
- }
423
- }
424
-
425
- void FMcpConnectionManager::HandleClosed(TSharedPtr<FMcpBridgeWebSocket> Socket,
426
- int32 StatusCode,
427
- const FString &Reason,
428
- bool bWasClean) {
429
- const int32 Port = Socket.IsValid() ? Socket->GetPort() : -1;
430
- UE_LOG(LogMcpAutomationBridgeSubsystem, Log,
431
- TEXT("Socket closed: port=%d code=%d reason=%s clean=%s"), Port,
432
- StatusCode, *Reason, bWasClean ? TEXT("true") : TEXT("false"));
433
- if (Socket.IsValid()) {
434
- ActiveSockets.Remove(Socket);
435
- }
436
- if (ActiveSockets.Num() == 0 && bReconnectEnabled) {
437
- TimeUntilReconnect = AutoReconnectDelaySeconds;
438
- }
439
- }
440
-
441
- void FMcpConnectionManager::HandleHeartbeat(
442
- TSharedPtr<FMcpBridgeWebSocket> Socket) {
443
- LastHeartbeatTimestamp = FPlatformTime::Seconds();
444
- if (!bHeartbeatTrackingEnabled) {
445
- bHeartbeatTrackingEnabled = true;
446
- UE_LOG(LogMcpAutomationBridgeSubsystem, Verbose,
447
- TEXT("Heartbeat tracking enabled."));
448
- }
449
- }
450
-
451
- void FMcpConnectionManager::HandleMessage(
452
- TSharedPtr<FMcpBridgeWebSocket> Socket, const FString &Message) {
453
- if (!Socket.IsValid())
454
- return;
455
-
456
- TSharedPtr<FJsonObject> RootObj;
457
- TSharedRef<TJsonReader<>> Reader = TJsonReaderFactory<>::Create(Message);
458
- if (!FJsonSerializer::Deserialize(Reader, RootObj) || !RootObj.IsValid()) {
459
- UE_LOG(LogMcpAutomationBridgeSubsystem, Warning,
460
- TEXT("Failed to parse incoming automation message JSON: %s"),
461
- *SanitizeForLog(Message));
462
- return;
463
- }
464
-
465
- FString Type;
466
- if (!RootObj->TryGetStringField(TEXT("type"), Type)) {
467
- UE_LOG(LogMcpAutomationBridgeSubsystem, Warning,
468
- TEXT("Incoming message missing 'type' field: %s"),
469
- *SanitizeForLog(Message));
470
- return;
471
- }
472
-
473
- if (Type.Equals(TEXT("automation_request"), ESearchCase::IgnoreCase)) {
474
- FString RequestId;
475
- FString Action;
476
- RootObj->TryGetStringField(TEXT("requestId"), RequestId);
477
- RootObj->TryGetStringField(TEXT("action"), Action);
478
- TSharedPtr<FJsonObject> Payload = nullptr;
479
- const TSharedPtr<FJsonValue> *PayloadVal =
480
- RootObj->Values.Find(TEXT("payload"));
481
- if (PayloadVal && (*PayloadVal)->Type == EJson::Object) {
482
- Payload = (*PayloadVal)->AsObject();
483
- }
484
-
485
- if (RequestId.IsEmpty() || Action.IsEmpty()) {
486
- UE_LOG(LogMcpAutomationBridgeSubsystem, Warning,
487
- TEXT("automation_request missing requestId or action: %s"),
488
- *SanitizeForLog(Message));
489
- return;
490
- }
491
-
492
- // Map request to socket for response routing
493
- {
494
- FScopeLock Lock(&PendingRequestsMutex);
495
- PendingRequestsToSockets.Add(RequestId, Socket);
496
- }
497
-
498
- // Dispatch to subsystem via callback
499
- if (OnMessageReceived.IsBound()) {
500
- OnMessageReceived.Execute(RequestId, Action, Payload, Socket);
501
- }
502
- return;
503
- }
504
-
505
- if (Type.Equals(TEXT("bridge_hello"), ESearchCase::IgnoreCase)) {
506
- FString ReceivedToken;
507
- RootObj->TryGetStringField(TEXT("capabilityToken"), ReceivedToken);
508
- if (bRequireCapabilityToken &&
509
- (ReceivedToken.IsEmpty() || ReceivedToken != CapabilityToken)) {
510
- UE_LOG(LogMcpAutomationBridgeSubsystem, Warning,
511
- TEXT("Capability token mismatch."));
512
- TSharedRef<FJsonObject> Err = MakeShared<FJsonObject>();
513
- Err->SetStringField(TEXT("type"), TEXT("bridge_error"));
514
- Err->SetStringField(TEXT("error"), TEXT("INVALID_CAPABILITY_TOKEN"));
515
- FString Serialized;
516
- const TSharedRef<TJsonWriter<>> Writer =
517
- TJsonWriterFactory<>::Create(&Serialized);
518
- FJsonSerializer::Serialize(Err, Writer);
519
- if (Socket.IsValid() && Socket->IsConnected()) {
520
- Socket->Send(Serialized);
521
- Socket->Close(4005, TEXT("Invalid capability token"));
522
- }
523
- return;
524
- }
525
-
526
- TSharedRef<FJsonObject> Ack = MakeShared<FJsonObject>();
527
- Ack->SetStringField(TEXT("type"), TEXT("bridge_ack"));
528
- Ack->SetStringField(TEXT("message"), TEXT("Automation bridge ready"));
529
- Ack->SetStringField(TEXT("serverName"), !ServerName.IsEmpty()
530
- ? ServerName
531
- : TEXT("UnrealEditor"));
532
- Ack->SetStringField(TEXT("serverVersion"), !ServerVersion.IsEmpty()
533
- ? ServerVersion
534
- : TEXT("unreal-engine"));
535
-
536
- if (ActiveSessionId.IsEmpty())
537
- ActiveSessionId = FGuid::NewGuid().ToString();
538
- Ack->SetStringField(TEXT("sessionId"), ActiveSessionId);
539
- Ack->SetNumberField(TEXT("protocolVersion"), 1);
540
-
541
- TArray<TSharedPtr<FJsonValue>> SupportedOps;
542
- SupportedOps.Add(MakeShared<FJsonValueString>(TEXT("automation_request")));
543
- Ack->SetArrayField(TEXT("supportedOpcodes"), SupportedOps);
544
-
545
- TArray<TSharedPtr<FJsonValue>> ExpectedOps;
546
- ExpectedOps.Add(MakeShared<FJsonValueString>(TEXT("automation_response")));
547
- Ack->SetArrayField(TEXT("expectedResponseOpcodes"), ExpectedOps);
548
-
549
- TArray<TSharedPtr<FJsonValue>> Caps;
550
- Caps.Add(MakeShared<FJsonValueString>(TEXT("console_commands")));
551
- Caps.Add(MakeShared<FJsonValueString>(TEXT("native_plugin")));
552
- Ack->SetArrayField(TEXT("capabilities"), Caps);
553
-
554
- Ack->SetNumberField(TEXT("heartbeatIntervalMs"), 0);
555
-
556
- FString Serialized;
557
- const TSharedRef<TJsonWriter<>> Writer =
558
- TJsonWriterFactory<>::Create(&Serialized);
559
- FJsonSerializer::Serialize(Ack, Writer);
560
- Socket->Send(Serialized);
561
- }
562
- }
563
-
564
- bool FMcpConnectionManager::SendRawMessage(const FString &Message) {
565
- if (Message.IsEmpty())
566
- return false;
567
- bool bSent = false;
568
- for (const TSharedPtr<FMcpBridgeWebSocket> &Sock : ActiveSockets) {
569
- if (!Sock.IsValid() || !Sock->IsConnected())
570
- continue;
571
- if (Sock->Send(Message)) {
572
- bSent = true;
573
- break;
574
- }
575
- }
576
- return bSent;
577
- }
578
-
579
- void FMcpConnectionManager::SendControlMessage(
580
- const TSharedPtr<FJsonObject> &Message) {
581
- if (!Message.IsValid())
582
- return;
583
- FString Serialized;
584
- const TSharedRef<TJsonWriter<>> Writer =
585
- TJsonWriterFactory<>::Create(&Serialized);
586
- FJsonSerializer::Serialize(Message.ToSharedRef(), Writer);
587
- SendRawMessage(Serialized);
588
- }
589
-
590
- void FMcpConnectionManager::SendAutomationResponse(
591
- TSharedPtr<FMcpBridgeWebSocket> TargetSocket, const FString &RequestId,
592
- bool bSuccess, const FString &Message,
593
- const TSharedPtr<FJsonObject> &Result, const FString &ErrorCode) {
594
- TSharedRef<FJsonObject> Response = MakeShared<FJsonObject>();
595
- Response->SetStringField(TEXT("type"), TEXT("automation_response"));
596
- Response->SetStringField(TEXT("requestId"), RequestId);
597
- Response->SetBoolField(TEXT("success"), bSuccess);
598
- if (!Message.IsEmpty())
599
- Response->SetStringField(TEXT("message"), Message);
600
- if (!ErrorCode.IsEmpty())
601
- Response->SetStringField(TEXT("error"), ErrorCode);
602
- if (Result.IsValid())
603
- Response->SetObjectField(TEXT("result"), Result.ToSharedRef());
604
-
605
- FString Serialized;
606
- const TSharedRef<TJsonWriter<>> Writer =
607
- TJsonWriterFactory<>::Create(&Serialized);
608
- FJsonSerializer::Serialize(Response, Writer);
609
-
610
- // Log the payload size to help debug large response failures
611
- UE_LOG(LogMcpAutomationBridgeSubsystem, Log,
612
- TEXT("Sending automation_response for RequestId=%s. Payload Size: %d "
613
- "chars"),
614
- *RequestId, Serialized.Len());
615
-
616
- RecordAutomationTelemetry(RequestId, bSuccess, Message, ErrorCode);
617
-
618
- bool bSent = false;
619
- TArray<FString> AttemptDetails;
620
- const int MaxAttempts = 3;
621
-
622
- TSharedPtr<FMcpBridgeWebSocket> MappedSocket;
623
- {
624
- FScopeLock Lock(&PendingRequestsMutex);
625
- if (TSharedPtr<FMcpBridgeWebSocket> *Found =
626
- PendingRequestsToSockets.Find(RequestId)) {
627
- MappedSocket = *Found;
628
- }
629
- }
630
-
631
- for (int Attempt = 1; Attempt <= MaxAttempts && !bSent; ++Attempt) {
632
- if (TargetSocket.IsValid() && TargetSocket->IsConnected()) {
633
- if (TargetSocket->Send(Serialized)) {
634
- bSent = true;
635
- break;
636
- }
637
- }
638
-
639
- if (!bSent && MappedSocket.IsValid() && MappedSocket->IsConnected()) {
640
- if (MappedSocket->Send(Serialized)) {
641
- bSent = true;
642
- break;
643
- }
644
- }
645
-
646
- if (!bSent) {
647
- for (const TSharedPtr<FMcpBridgeWebSocket> &Sock : ActiveSockets) {
648
- if (!Sock.IsValid() || !Sock->IsConnected())
649
- continue;
650
- if (Sock == TargetSocket)
651
- continue;
652
- if (MappedSocket == Sock)
653
- continue;
654
- if (Sock->Send(Serialized)) {
655
- bSent = true;
656
- break;
657
- }
658
- }
659
- }
660
- }
661
-
662
- if (!bSent) {
663
- UE_LOG(LogMcpAutomationBridgeSubsystem, Warning,
664
- TEXT("Failed to deliver automation_response for RequestId=%s"),
665
- *RequestId);
666
-
667
- TSharedPtr<FJsonObject> FallbackEvent = MakeShared<FJsonObject>();
668
- FallbackEvent->SetStringField(TEXT("type"), TEXT("automation_event"));
669
- FallbackEvent->SetStringField(TEXT("event"), TEXT("response_fallback"));
670
- FallbackEvent->SetStringField(TEXT("requestId"), RequestId);
671
-
672
- TSharedPtr<FJsonObject> EventResult = MakeShared<FJsonObject>();
673
- EventResult->SetBoolField(TEXT("success"), bSuccess);
674
- if (!Message.IsEmpty())
675
- EventResult->SetStringField(TEXT("message"), Message);
676
- if (!ErrorCode.IsEmpty())
677
- EventResult->SetStringField(TEXT("error"), ErrorCode);
678
- if (Result.IsValid())
679
- EventResult->SetObjectField(TEXT("payload"), Result.ToSharedRef());
680
- FallbackEvent->SetObjectField(TEXT("result"), EventResult);
681
-
682
- SendControlMessage(FallbackEvent);
683
- }
684
-
685
- {
686
- FScopeLock Lock(&PendingRequestsMutex);
687
- PendingRequestsToSockets.Remove(RequestId);
688
- }
689
- }
690
-
691
- void FMcpConnectionManager::RecordAutomationTelemetry(
692
- const FString &RequestId, bool bSuccess, const FString &Message,
693
- const FString &ErrorCode) {
694
- const double NowSeconds = FPlatformTime::Seconds();
695
-
696
- FAutomationRequestTelemetry Entry;
697
- if (!ActiveRequestTelemetry.RemoveAndCopyValue(RequestId, Entry)) {
698
- return;
699
- }
700
-
701
- const FString ActionKey =
702
- Entry.Action.IsEmpty() ? TEXT("unknown") : Entry.Action;
703
- FAutomationActionStats &Stats =
704
- AutomationActionTelemetry.FindOrAdd(ActionKey);
705
-
706
- const double DurationSeconds =
707
- FMath::Max(0.0, NowSeconds - Entry.StartTimeSeconds);
708
- if (bSuccess) {
709
- ++Stats.SuccessCount;
710
- Stats.TotalSuccessDurationSeconds += DurationSeconds;
711
- } else {
712
- ++Stats.FailureCount;
713
- Stats.TotalFailureDurationSeconds += DurationSeconds;
714
- }
715
-
716
- Stats.LastDurationSeconds = DurationSeconds;
717
- Stats.LastUpdatedSeconds = NowSeconds;
718
- }
719
-
720
- void FMcpConnectionManager::EmitAutomationTelemetrySummaryIfNeeded(
721
- double NowSeconds) {
722
- if (TelemetrySummaryIntervalSeconds <= 0.0)
723
- return;
724
- if ((NowSeconds - LastTelemetrySummaryLogSeconds) <
725
- TelemetrySummaryIntervalSeconds)
726
- return;
727
-
728
- LastTelemetrySummaryLogSeconds = NowSeconds;
729
- if (AutomationActionTelemetry.Num() == 0)
730
- return;
731
-
732
- TArray<FString> Lines;
733
- Lines.Reserve(AutomationActionTelemetry.Num());
734
-
735
- for (const TPair<FString, FAutomationActionStats> &Pair :
736
- AutomationActionTelemetry) {
737
- const FString &ActionKey = Pair.Key;
738
- const FAutomationActionStats &Stats = Pair.Value;
739
- const double AvgSuccess =
740
- Stats.SuccessCount > 0
741
- ? (Stats.TotalSuccessDurationSeconds / Stats.SuccessCount)
742
- : 0.0;
743
- const double AvgFailure =
744
- Stats.FailureCount > 0
745
- ? (Stats.TotalFailureDurationSeconds / Stats.FailureCount)
746
- : 0.0;
747
- Lines.Add(FString::Printf(TEXT("%s success=%d failure=%d last=%.3fs "
748
- "avgSuccess=%.3fs avgFailure=%.3fs"),
749
- *ActionKey, Stats.SuccessCount,
750
- Stats.FailureCount, Stats.LastDurationSeconds,
751
- AvgSuccess, AvgFailure));
752
- }
753
- Lines.Sort();
754
- UE_LOG(LogMcpAutomationBridgeSubsystem, Log,
755
- TEXT("Automation action telemetry summary (%d actions):\n%s"),
756
- Lines.Num(), *FString::Join(Lines, TEXT("\n")));
757
- }
758
-
759
- int32 FMcpConnectionManager::GetActiveSocketCount() const {
760
- return ActiveSockets.Num();
761
- }
762
-
763
- void FMcpConnectionManager::RegisterRequestSocket(
764
- const FString &RequestId, TSharedPtr<FMcpBridgeWebSocket> Socket) {
765
- if (!RequestId.IsEmpty() && Socket.IsValid()) {
766
- FScopeLock Lock(&PendingRequestsMutex);
767
- PendingRequestsToSockets.Add(RequestId, Socket);
768
- }
769
- }
770
-
771
- void FMcpConnectionManager::StartRequestTelemetry(const FString &RequestId,
772
- const FString &Action) {
773
- if (!ActiveRequestTelemetry.Contains(RequestId)) {
774
- FAutomationRequestTelemetry Entry;
775
- // Store lowercase action for consistent aggregation, similar to original
776
- // logic
777
- const FString LowerAction = Action.ToLower();
778
- Entry.Action = LowerAction.IsEmpty() ? Action : LowerAction;
779
- Entry.StartTimeSeconds = FPlatformTime::Seconds();
780
- ActiveRequestTelemetry.Add(RequestId, Entry);
781
- }
782
- }