unreal-engine-mcp-server 0.4.7 → 0.5.0

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 (438) hide show
  1. package/.env.example +26 -0
  2. package/.env.production +38 -7
  3. package/.eslintrc.json +0 -54
  4. package/.eslintrc.override.json +8 -0
  5. package/.github/ISSUE_TEMPLATE/bug_report.yml +94 -0
  6. package/.github/ISSUE_TEMPLATE/config.yml +8 -0
  7. package/.github/ISSUE_TEMPLATE/feature_request.yml +56 -0
  8. package/.github/copilot-instructions.md +478 -45
  9. package/.github/dependabot.yml +19 -0
  10. package/.github/labeler.yml +24 -0
  11. package/.github/labels.yml +70 -0
  12. package/.github/pull_request_template.md +42 -0
  13. package/.github/release-drafter.yml +148 -0
  14. package/.github/workflows/auto-merge.yml +38 -0
  15. package/.github/workflows/ci.yml +38 -0
  16. package/.github/workflows/dependency-review.yml +17 -0
  17. package/.github/workflows/gemini-issue-triage.yml +172 -0
  18. package/.github/workflows/greetings.yml +23 -0
  19. package/.github/workflows/labeler.yml +16 -0
  20. package/.github/workflows/links.yml +80 -0
  21. package/.github/workflows/pr-size-labeler.yml +137 -0
  22. package/.github/workflows/publish-mcp.yml +12 -7
  23. package/.github/workflows/release-drafter.yml +23 -0
  24. package/.github/workflows/release.yml +112 -0
  25. package/.github/workflows/semantic-pull-request.yml +35 -0
  26. package/.github/workflows/smoke-test.yml +36 -0
  27. package/.github/workflows/stale.yml +28 -0
  28. package/CHANGELOG.md +267 -31
  29. package/CONTRIBUTING.md +140 -0
  30. package/README.md +166 -71
  31. package/claude_desktop_config_example.json +7 -6
  32. package/dist/automation/bridge.d.ts +50 -0
  33. package/dist/automation/bridge.js +452 -0
  34. package/dist/automation/connection-manager.d.ts +23 -0
  35. package/dist/automation/connection-manager.js +107 -0
  36. package/dist/automation/handshake.d.ts +11 -0
  37. package/dist/automation/handshake.js +89 -0
  38. package/dist/automation/index.d.ts +3 -0
  39. package/dist/automation/index.js +3 -0
  40. package/dist/automation/message-handler.d.ts +12 -0
  41. package/dist/automation/message-handler.js +149 -0
  42. package/dist/automation/request-tracker.d.ts +25 -0
  43. package/dist/automation/request-tracker.js +98 -0
  44. package/dist/automation/types.d.ts +130 -0
  45. package/dist/automation/types.js +2 -0
  46. package/dist/cli.js +32 -5
  47. package/dist/config.d.ts +27 -0
  48. package/dist/config.js +60 -0
  49. package/dist/constants.d.ts +12 -0
  50. package/dist/constants.js +12 -0
  51. package/dist/graphql/resolvers.d.ts +268 -0
  52. package/dist/graphql/resolvers.js +743 -0
  53. package/dist/graphql/schema.d.ts +5 -0
  54. package/dist/graphql/schema.js +437 -0
  55. package/dist/graphql/server.d.ts +26 -0
  56. package/dist/graphql/server.js +115 -0
  57. package/dist/graphql/types.d.ts +7 -0
  58. package/dist/graphql/types.js +2 -0
  59. package/dist/handlers/resource-handlers.d.ts +20 -0
  60. package/dist/handlers/resource-handlers.js +180 -0
  61. package/dist/index.d.ts +31 -18
  62. package/dist/index.js +119 -619
  63. package/dist/prompts/index.js +4 -4
  64. package/dist/resources/actors.d.ts +17 -12
  65. package/dist/resources/actors.js +56 -76
  66. package/dist/resources/assets.d.ts +6 -14
  67. package/dist/resources/assets.js +115 -147
  68. package/dist/resources/levels.d.ts +13 -13
  69. package/dist/resources/levels.js +25 -34
  70. package/dist/server/resource-registry.d.ts +20 -0
  71. package/dist/server/resource-registry.js +37 -0
  72. package/dist/server/tool-registry.d.ts +23 -0
  73. package/dist/server/tool-registry.js +322 -0
  74. package/dist/server-setup.d.ts +21 -0
  75. package/dist/server-setup.js +111 -0
  76. package/dist/services/health-monitor.d.ts +34 -0
  77. package/dist/services/health-monitor.js +105 -0
  78. package/dist/services/metrics-server.d.ts +11 -0
  79. package/dist/services/metrics-server.js +105 -0
  80. package/dist/tools/actors.d.ts +147 -9
  81. package/dist/tools/actors.js +350 -311
  82. package/dist/tools/animation.d.ts +135 -4
  83. package/dist/tools/animation.js +510 -411
  84. package/dist/tools/assets.d.ts +117 -19
  85. package/dist/tools/assets.js +259 -284
  86. package/dist/tools/audio.d.ts +102 -42
  87. package/dist/tools/audio.js +272 -685
  88. package/dist/tools/base-tool.d.ts +17 -0
  89. package/dist/tools/base-tool.js +46 -0
  90. package/dist/tools/behavior-tree.d.ts +94 -0
  91. package/dist/tools/behavior-tree.js +39 -0
  92. package/dist/tools/blueprint/helpers.d.ts +29 -0
  93. package/dist/tools/blueprint/helpers.js +182 -0
  94. package/dist/tools/blueprint.d.ts +228 -118
  95. package/dist/tools/blueprint.js +685 -832
  96. package/dist/tools/consolidated-tool-definitions.d.ts +5462 -1781
  97. package/dist/tools/consolidated-tool-definitions.js +829 -496
  98. package/dist/tools/consolidated-tool-handlers.d.ts +2 -1
  99. package/dist/tools/consolidated-tool-handlers.js +211 -1026
  100. package/dist/tools/debug.d.ts +143 -85
  101. package/dist/tools/debug.js +234 -180
  102. package/dist/tools/dynamic-handler-registry.d.ts +11 -0
  103. package/dist/tools/dynamic-handler-registry.js +101 -0
  104. package/dist/tools/editor.d.ts +139 -18
  105. package/dist/tools/editor.js +239 -244
  106. package/dist/tools/engine.d.ts +10 -4
  107. package/dist/tools/engine.js +13 -5
  108. package/dist/tools/environment.d.ts +36 -0
  109. package/dist/tools/environment.js +267 -0
  110. package/dist/tools/foliage.d.ts +105 -14
  111. package/dist/tools/foliage.js +219 -331
  112. package/dist/tools/handlers/actor-handlers.d.ts +3 -0
  113. package/dist/tools/handlers/actor-handlers.js +232 -0
  114. package/dist/tools/handlers/animation-handlers.d.ts +3 -0
  115. package/dist/tools/handlers/animation-handlers.js +185 -0
  116. package/dist/tools/handlers/argument-helper.d.ts +16 -0
  117. package/dist/tools/handlers/argument-helper.js +80 -0
  118. package/dist/tools/handlers/asset-handlers.d.ts +3 -0
  119. package/dist/tools/handlers/asset-handlers.js +496 -0
  120. package/dist/tools/handlers/audio-handlers.d.ts +3 -0
  121. package/dist/tools/handlers/audio-handlers.js +166 -0
  122. package/dist/tools/handlers/blueprint-handlers.d.ts +4 -0
  123. package/dist/tools/handlers/blueprint-handlers.js +358 -0
  124. package/dist/tools/handlers/common-handlers.d.ts +14 -0
  125. package/dist/tools/handlers/common-handlers.js +56 -0
  126. package/dist/tools/handlers/editor-handlers.d.ts +3 -0
  127. package/dist/tools/handlers/editor-handlers.js +119 -0
  128. package/dist/tools/handlers/effect-handlers.d.ts +3 -0
  129. package/dist/tools/handlers/effect-handlers.js +171 -0
  130. package/dist/tools/handlers/environment-handlers.d.ts +3 -0
  131. package/dist/tools/handlers/environment-handlers.js +170 -0
  132. package/dist/tools/handlers/graph-handlers.d.ts +3 -0
  133. package/dist/tools/handlers/graph-handlers.js +90 -0
  134. package/dist/tools/handlers/input-handlers.d.ts +3 -0
  135. package/dist/tools/handlers/input-handlers.js +21 -0
  136. package/dist/tools/handlers/inspect-handlers.d.ts +3 -0
  137. package/dist/tools/handlers/inspect-handlers.js +383 -0
  138. package/dist/tools/handlers/level-handlers.d.ts +3 -0
  139. package/dist/tools/handlers/level-handlers.js +237 -0
  140. package/dist/tools/handlers/lighting-handlers.d.ts +3 -0
  141. package/dist/tools/handlers/lighting-handlers.js +144 -0
  142. package/dist/tools/handlers/performance-handlers.d.ts +3 -0
  143. package/dist/tools/handlers/performance-handlers.js +130 -0
  144. package/dist/tools/handlers/pipeline-handlers.d.ts +3 -0
  145. package/dist/tools/handlers/pipeline-handlers.js +110 -0
  146. package/dist/tools/handlers/sequence-handlers.d.ts +3 -0
  147. package/dist/tools/handlers/sequence-handlers.js +376 -0
  148. package/dist/tools/handlers/system-handlers.d.ts +4 -0
  149. package/dist/tools/handlers/system-handlers.js +506 -0
  150. package/dist/tools/input.d.ts +19 -0
  151. package/dist/tools/input.js +89 -0
  152. package/dist/tools/introspection.d.ts +103 -40
  153. package/dist/tools/introspection.js +425 -568
  154. package/dist/tools/landscape.d.ts +97 -36
  155. package/dist/tools/landscape.js +280 -409
  156. package/dist/tools/level.d.ts +130 -10
  157. package/dist/tools/level.js +639 -675
  158. package/dist/tools/lighting.d.ts +77 -38
  159. package/dist/tools/lighting.js +441 -943
  160. package/dist/tools/logs.d.ts +3 -3
  161. package/dist/tools/logs.js +5 -57
  162. package/dist/tools/materials.d.ts +91 -24
  163. package/dist/tools/materials.js +190 -118
  164. package/dist/tools/niagara.d.ts +149 -39
  165. package/dist/tools/niagara.js +232 -182
  166. package/dist/tools/performance.d.ts +27 -12
  167. package/dist/tools/performance.js +204 -122
  168. package/dist/tools/physics.d.ts +32 -77
  169. package/dist/tools/physics.js +171 -582
  170. package/dist/tools/property-dictionary.d.ts +13 -0
  171. package/dist/tools/property-dictionary.js +82 -0
  172. package/dist/tools/sequence.d.ts +73 -48
  173. package/dist/tools/sequence.js +196 -748
  174. package/dist/tools/tool-definition-utils.d.ts +59 -0
  175. package/dist/tools/tool-definition-utils.js +35 -0
  176. package/dist/tools/ui.d.ts +66 -34
  177. package/dist/tools/ui.js +134 -214
  178. package/dist/types/env.d.ts +0 -3
  179. package/dist/types/env.js +0 -7
  180. package/dist/types/tool-interfaces.d.ts +898 -0
  181. package/dist/types/tool-interfaces.js +2 -0
  182. package/dist/types/tool-types.d.ts +183 -19
  183. package/dist/types/tool-types.js +0 -4
  184. package/dist/unreal-bridge.d.ts +24 -131
  185. package/dist/unreal-bridge.js +364 -1506
  186. package/dist/utils/command-validator.d.ts +9 -0
  187. package/dist/utils/command-validator.js +67 -0
  188. package/dist/utils/elicitation.d.ts +1 -1
  189. package/dist/utils/elicitation.js +12 -15
  190. package/dist/utils/error-handler.d.ts +2 -51
  191. package/dist/utils/error-handler.js +11 -87
  192. package/dist/utils/ini-reader.d.ts +3 -0
  193. package/dist/utils/ini-reader.js +69 -0
  194. package/dist/utils/logger.js +9 -6
  195. package/dist/utils/normalize.d.ts +3 -0
  196. package/dist/utils/normalize.js +56 -0
  197. package/dist/utils/response-factory.d.ts +7 -0
  198. package/dist/utils/response-factory.js +33 -0
  199. package/dist/utils/response-validator.d.ts +3 -24
  200. package/dist/utils/response-validator.js +130 -81
  201. package/dist/utils/result-helpers.d.ts +4 -5
  202. package/dist/utils/result-helpers.js +15 -16
  203. package/dist/utils/safe-json.js +5 -11
  204. package/dist/utils/unreal-command-queue.d.ts +24 -0
  205. package/dist/utils/unreal-command-queue.js +120 -0
  206. package/dist/utils/validation.d.ts +0 -40
  207. package/dist/utils/validation.js +1 -78
  208. package/dist/wasm/index.d.ts +70 -0
  209. package/dist/wasm/index.js +535 -0
  210. package/docs/GraphQL-API.md +888 -0
  211. package/docs/Migration-Guide-v0.5.0.md +692 -0
  212. package/docs/Roadmap.md +53 -0
  213. package/docs/WebAssembly-Integration.md +628 -0
  214. package/docs/editor-plugin-extension.md +370 -0
  215. package/docs/handler-mapping.md +242 -0
  216. package/docs/native-automation-progress.md +128 -0
  217. package/docs/testing-guide.md +423 -0
  218. package/mcp-config-example.json +6 -6
  219. package/package.json +60 -27
  220. package/plugins/McpAutomationBridge/Config/FilterPlugin.ini +8 -0
  221. package/plugins/McpAutomationBridge/McpAutomationBridge.uplugin +64 -0
  222. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/McpAutomationBridge.Build.cs +189 -0
  223. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeGlobals.cpp +22 -0
  224. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeGlobals.h +30 -0
  225. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeHelpers.h +1983 -0
  226. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeModule.cpp +72 -0
  227. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeSettings.cpp +46 -0
  228. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeSubsystem.cpp +581 -0
  229. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_AnimationHandlers.cpp +2394 -0
  230. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_AssetQueryHandlers.cpp +300 -0
  231. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_AssetWorkflowHandlers.cpp +2807 -0
  232. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_AudioHandlers.cpp +1087 -0
  233. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BehaviorTreeHandlers.cpp +488 -0
  234. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintCreationHandlers.cpp +643 -0
  235. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintCreationHandlers.h +31 -0
  236. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintGraphHandlers.cpp +1184 -0
  237. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintHandlers.cpp +5652 -0
  238. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintHandlers_List.cpp +152 -0
  239. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_ControlHandlers.cpp +2614 -0
  240. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_DebugHandlers.cpp +42 -0
  241. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_EditorFunctionHandlers.cpp +1237 -0
  242. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_EffectHandlers.cpp +1701 -0
  243. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_EnvironmentHandlers.cpp +2145 -0
  244. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_FoliageHandlers.cpp +954 -0
  245. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_InputHandlers.cpp +209 -0
  246. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_InsightsHandlers.cpp +41 -0
  247. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_LandscapeHandlers.cpp +1164 -0
  248. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_LevelHandlers.cpp +762 -0
  249. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_LightingHandlers.cpp +634 -0
  250. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_LogHandlers.cpp +136 -0
  251. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_MaterialGraphHandlers.cpp +494 -0
  252. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_NiagaraGraphHandlers.cpp +278 -0
  253. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_NiagaraHandlers.cpp +625 -0
  254. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_PerformanceHandlers.cpp +401 -0
  255. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_PipelineHandlers.cpp +67 -0
  256. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_ProcessRequest.cpp +735 -0
  257. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_PropertyHandlers.cpp +2634 -0
  258. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_RenderHandlers.cpp +189 -0
  259. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_SCSHandlers.cpp +917 -0
  260. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_SCSHandlers.h +39 -0
  261. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_SequenceHandlers.cpp +2670 -0
  262. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_SequencerHandlers.cpp +519 -0
  263. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_TestHandlers.cpp +38 -0
  264. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_UiHandlers.cpp +668 -0
  265. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_WorldPartitionHandlers.cpp +346 -0
  266. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpBridgeWebSocket.cpp +1330 -0
  267. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpBridgeWebSocket.h +149 -0
  268. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpConnectionManager.cpp +783 -0
  269. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Public/McpAutomationBridgeSettings.h +115 -0
  270. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Public/McpAutomationBridgeSubsystem.h +796 -0
  271. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Public/McpConnectionManager.h +117 -0
  272. package/scripts/check-unreal-connection.mjs +19 -0
  273. package/scripts/clean-tmp.js +23 -0
  274. package/scripts/patch-wasm.js +26 -0
  275. package/scripts/run-all-tests.mjs +131 -0
  276. package/scripts/smoke-test.ts +94 -0
  277. package/scripts/sync-mcp-plugin.js +143 -0
  278. package/scripts/test-no-plugin-alternates.mjs +113 -0
  279. package/scripts/validate-server.js +46 -0
  280. package/scripts/verify-automation-bridge.js +200 -0
  281. package/server.json +57 -21
  282. package/src/automation/bridge.ts +558 -0
  283. package/src/automation/connection-manager.ts +130 -0
  284. package/src/automation/handshake.ts +99 -0
  285. package/src/automation/index.ts +2 -0
  286. package/src/automation/message-handler.ts +167 -0
  287. package/src/automation/request-tracker.ts +123 -0
  288. package/src/automation/types.ts +107 -0
  289. package/src/cli.ts +33 -6
  290. package/src/config.ts +73 -0
  291. package/src/constants.ts +12 -0
  292. package/src/graphql/resolvers.ts +1010 -0
  293. package/src/graphql/schema.ts +452 -0
  294. package/src/graphql/server.ts +154 -0
  295. package/src/graphql/types.ts +7 -0
  296. package/src/handlers/resource-handlers.ts +186 -0
  297. package/src/index.ts +152 -663
  298. package/src/prompts/index.ts +4 -4
  299. package/src/resources/actors.ts +58 -76
  300. package/src/resources/assets.ts +147 -134
  301. package/src/resources/levels.ts +28 -33
  302. package/src/server/resource-registry.ts +47 -0
  303. package/src/server/tool-registry.ts +354 -0
  304. package/src/server-setup.ts +148 -0
  305. package/src/services/health-monitor.ts +132 -0
  306. package/src/services/metrics-server.ts +142 -0
  307. package/src/tools/actors.ts +417 -322
  308. package/src/tools/animation.ts +671 -461
  309. package/src/tools/assets.ts +353 -289
  310. package/src/tools/audio.ts +323 -766
  311. package/src/tools/base-tool.ts +52 -0
  312. package/src/tools/behavior-tree.ts +45 -0
  313. package/src/tools/blueprint/helpers.ts +189 -0
  314. package/src/tools/blueprint.ts +787 -965
  315. package/src/tools/consolidated-tool-definitions.ts +993 -515
  316. package/src/tools/consolidated-tool-handlers.ts +272 -1139
  317. package/src/tools/debug.ts +292 -187
  318. package/src/tools/dynamic-handler-registry.ts +151 -0
  319. package/src/tools/editor.ts +309 -246
  320. package/src/tools/engine.ts +14 -3
  321. package/src/tools/environment.ts +287 -0
  322. package/src/tools/foliage.ts +314 -379
  323. package/src/tools/handlers/actor-handlers.ts +271 -0
  324. package/src/tools/handlers/animation-handlers.ts +237 -0
  325. package/src/tools/handlers/argument-helper.ts +142 -0
  326. package/src/tools/handlers/asset-handlers.ts +532 -0
  327. package/src/tools/handlers/audio-handlers.ts +194 -0
  328. package/src/tools/handlers/blueprint-handlers.ts +380 -0
  329. package/src/tools/handlers/common-handlers.ts +87 -0
  330. package/src/tools/handlers/editor-handlers.ts +123 -0
  331. package/src/tools/handlers/effect-handlers.ts +220 -0
  332. package/src/tools/handlers/environment-handlers.ts +183 -0
  333. package/src/tools/handlers/graph-handlers.ts +116 -0
  334. package/src/tools/handlers/input-handlers.ts +28 -0
  335. package/src/tools/handlers/inspect-handlers.ts +450 -0
  336. package/src/tools/handlers/level-handlers.ts +252 -0
  337. package/src/tools/handlers/lighting-handlers.ts +147 -0
  338. package/src/tools/handlers/performance-handlers.ts +132 -0
  339. package/src/tools/handlers/pipeline-handlers.ts +127 -0
  340. package/src/tools/handlers/sequence-handlers.ts +415 -0
  341. package/src/tools/handlers/system-handlers.ts +564 -0
  342. package/src/tools/input.ts +101 -0
  343. package/src/tools/introspection.ts +493 -584
  344. package/src/tools/landscape.ts +394 -489
  345. package/src/tools/level.ts +752 -694
  346. package/src/tools/lighting.ts +583 -984
  347. package/src/tools/logs.ts +9 -57
  348. package/src/tools/materials.ts +231 -121
  349. package/src/tools/niagara.ts +293 -168
  350. package/src/tools/performance.ts +320 -168
  351. package/src/tools/physics.ts +268 -613
  352. package/src/tools/property-dictionary.ts +98 -0
  353. package/src/tools/sequence.ts +255 -815
  354. package/src/tools/tool-definition-utils.ts +35 -0
  355. package/src/tools/ui.ts +207 -283
  356. package/src/types/env.ts +0 -10
  357. package/src/types/tool-interfaces.ts +250 -0
  358. package/src/types/tool-types.ts +243 -21
  359. package/src/unreal-bridge.ts +460 -1550
  360. package/src/utils/command-validator.ts +75 -0
  361. package/src/utils/elicitation.ts +10 -7
  362. package/src/utils/error-handler.ts +14 -90
  363. package/src/utils/ini-reader.ts +86 -0
  364. package/src/utils/logger.ts +8 -3
  365. package/src/utils/normalize.ts +60 -0
  366. package/src/utils/response-factory.ts +39 -0
  367. package/src/utils/response-validator.ts +176 -56
  368. package/src/utils/result-helpers.ts +21 -19
  369. package/src/utils/safe-json.ts +14 -11
  370. package/src/utils/unreal-command-queue.ts +152 -0
  371. package/src/utils/validation.ts +4 -1
  372. package/src/wasm/index.ts +838 -0
  373. package/test-server.mjs +100 -0
  374. package/tests/run-unreal-tool-tests.mjs +242 -14
  375. package/tests/test-animation.mjs +44 -0
  376. package/tests/test-asset-advanced.mjs +82 -0
  377. package/tests/test-asset-errors.mjs +35 -0
  378. package/tests/test-audio.mjs +219 -0
  379. package/tests/test-automation-timeouts.mjs +98 -0
  380. package/tests/test-behavior-tree.mjs +261 -0
  381. package/tests/test-blueprint-events.mjs +35 -0
  382. package/tests/test-blueprint-graph.mjs +79 -0
  383. package/tests/test-blueprint.mjs +577 -0
  384. package/tests/test-client-mode.mjs +86 -0
  385. package/tests/test-console-command.mjs +56 -0
  386. package/tests/test-control-actor.mjs +425 -0
  387. package/tests/test-control-editor.mjs +80 -0
  388. package/tests/test-extra-tools.mjs +38 -0
  389. package/tests/test-graphql.mjs +322 -0
  390. package/tests/test-inspect.mjs +72 -0
  391. package/tests/test-landscape.mjs +60 -0
  392. package/tests/test-manage-asset.mjs +438 -0
  393. package/tests/test-manage-level.mjs +70 -0
  394. package/tests/test-materials.mjs +356 -0
  395. package/tests/test-niagara.mjs +185 -0
  396. package/tests/test-no-inline-python.mjs +122 -0
  397. package/tests/test-plugin-handshake.mjs +82 -0
  398. package/tests/test-render.mjs +33 -0
  399. package/tests/test-runner.mjs +933 -0
  400. package/tests/test-search-assets.mjs +66 -0
  401. package/tests/test-sequence.mjs +68 -0
  402. package/tests/test-system.mjs +57 -0
  403. package/tests/test-wasm.mjs +193 -0
  404. package/tests/test-world-partition.mjs +215 -0
  405. package/tsconfig.json +3 -3
  406. package/wasm/Cargo.lock +363 -0
  407. package/wasm/Cargo.toml +42 -0
  408. package/wasm/LICENSE +21 -0
  409. package/wasm/README.md +253 -0
  410. package/wasm/src/dependency_resolver.rs +377 -0
  411. package/wasm/src/lib.rs +153 -0
  412. package/wasm/src/property_parser.rs +271 -0
  413. package/wasm/src/transform_math.rs +396 -0
  414. package/wasm/tests/integration.rs +109 -0
  415. package/.github/workflows/smithery-build.yml +0 -29
  416. package/dist/tools/build_environment_advanced.d.ts +0 -65
  417. package/dist/tools/build_environment_advanced.js +0 -633
  418. package/dist/tools/rc.d.ts +0 -110
  419. package/dist/tools/rc.js +0 -437
  420. package/dist/tools/visual.d.ts +0 -40
  421. package/dist/tools/visual.js +0 -282
  422. package/dist/utils/http.d.ts +0 -6
  423. package/dist/utils/http.js +0 -151
  424. package/dist/utils/python-output.d.ts +0 -18
  425. package/dist/utils/python-output.js +0 -290
  426. package/dist/utils/python.d.ts +0 -2
  427. package/dist/utils/python.js +0 -4
  428. package/dist/utils/stdio-redirect.d.ts +0 -2
  429. package/dist/utils/stdio-redirect.js +0 -20
  430. package/docs/unreal-tool-test-cases.md +0 -574
  431. package/smithery.yaml +0 -29
  432. package/src/tools/build_environment_advanced.ts +0 -732
  433. package/src/tools/rc.ts +0 -515
  434. package/src/tools/visual.ts +0 -281
  435. package/src/utils/http.ts +0 -187
  436. package/src/utils/python-output.ts +0 -351
  437. package/src/utils/python.ts +0 -3
  438. package/src/utils/stdio-redirect.ts +0 -18
@@ -1,35 +1,35 @@
1
1
  import { UnrealBridge } from '../unreal-bridge.js';
2
2
  export declare class LevelResources {
3
- private bridge;
3
+ private automationBridge;
4
4
  constructor(bridge: UnrealBridge);
5
5
  getCurrentLevel(): Promise<{
6
- success: boolean;
7
- name: string;
8
- path: string;
9
- error?: undefined;
10
- } | {
11
6
  success: boolean;
12
7
  error: string;
13
8
  name?: undefined;
14
9
  path?: undefined;
15
- }>;
16
- getLevelName(): Promise<{
10
+ } | {
17
11
  success: boolean;
12
+ name: string;
18
13
  path: string;
19
14
  error?: undefined;
20
- } | {
15
+ }>;
16
+ getLevelName(): Promise<{
21
17
  success: boolean;
22
18
  error: string;
23
19
  path?: undefined;
24
- }>;
25
- saveCurrentLevel(): Promise<{
20
+ } | {
26
21
  success: boolean;
27
- message: string;
22
+ path: string;
28
23
  error?: undefined;
29
- } | {
24
+ }>;
25
+ saveCurrentLevel(): Promise<{
30
26
  success: boolean;
31
27
  error: string;
32
28
  message?: undefined;
29
+ } | {
30
+ success: boolean;
31
+ message: string;
32
+ error?: undefined;
33
33
  }>;
34
34
  }
35
35
  //# sourceMappingURL=levels.d.ts.map
@@ -1,65 +1,56 @@
1
- import { coerceString, interpretStandardResult } from '../utils/result-helpers.js';
1
+ import { coerceString } from '../utils/result-helpers.js';
2
2
  export class LevelResources {
3
- bridge;
3
+ automationBridge;
4
4
  constructor(bridge) {
5
- this.bridge = bridge;
5
+ this.automationBridge = bridge.automationBridge;
6
6
  }
7
7
  async getCurrentLevel() {
8
- // Use UnrealEditorSubsystem instead of deprecated EditorLevelLibrary
9
8
  try {
10
- const py = '\nimport unreal, json\ntry:\n # Use UnrealEditorSubsystem instead of deprecated EditorLevelLibrary\n editor_subsys = unreal.get_editor_subsystem(unreal.UnrealEditorSubsystem)\n world = editor_subsys.get_editor_world()\n name = world.get_name() if world else \'None\'\n path = world.get_path_name() if world else \'None\'\n print(\'RESULT:\' + json.dumps({\'success\': True, \'name\': name, \'path\': path}))\nexcept Exception as e:\n print(\'RESULT:\' + json.dumps({\'success\': False, \'error\': str(e)}))\n'.trim();
11
- const resp = await this.bridge.executePython(py);
12
- const interpreted = interpretStandardResult(resp, {
13
- successMessage: 'Retrieved current level',
14
- failureMessage: 'Failed to get current level'
15
- });
16
- if (interpreted.success) {
9
+ if (!this.automationBridge || typeof this.automationBridge.sendAutomationRequest !== 'function') {
10
+ return { success: false, error: 'Automation bridge is not available' };
11
+ }
12
+ const resp = await this.automationBridge.sendAutomationRequest('get_level', { action: 'get_current' });
13
+ if (resp && resp.success !== false && resp.result) {
17
14
  return {
18
15
  success: true,
19
- name: coerceString(interpreted.payload.name) ?? coerceString(interpreted.payload.level_name) ?? 'None',
20
- path: coerceString(interpreted.payload.path) ?? 'None'
16
+ name: coerceString(resp.result.name) ?? 'None',
17
+ path: coerceString(resp.result.path) ?? 'None'
21
18
  };
22
19
  }
23
- return { success: false, error: interpreted.error ?? interpreted.message };
20
+ return { success: false, error: 'Failed to get current level' };
24
21
  }
25
22
  catch (err) {
26
23
  return { error: `Failed to get current level: ${err}`, success: false };
27
24
  }
28
25
  }
29
26
  async getLevelName() {
30
- // Return camera/world info via Python first
31
27
  try {
32
- const py = '\nimport unreal, json\ntry:\n # Use UnrealEditorSubsystem instead of deprecated EditorLevelLibrary\n editor_subsys = unreal.get_editor_subsystem(unreal.UnrealEditorSubsystem)\n world = editor_subsys.get_editor_world()\n path = world.get_path_name() if world else \'\'\n print(\'RESULT:\' + json.dumps({\'success\': True, \'path\': path}))\nexcept Exception as e:\n print(\'RESULT:\' + json.dumps({\'success\': False, \'error\': str(e)}))\n'.trim();
33
- const resp = await this.bridge.executePython(py);
34
- const interpreted = interpretStandardResult(resp, {
35
- successMessage: 'Retrieved level path',
36
- failureMessage: 'Failed to get level name'
37
- });
38
- if (interpreted.success) {
28
+ if (!this.automationBridge || typeof this.automationBridge.sendAutomationRequest !== 'function') {
29
+ return { success: false, error: 'Automation bridge is not available' };
30
+ }
31
+ const resp = await this.automationBridge.sendAutomationRequest('get_level', { action: 'get_name' });
32
+ if (resp && resp.success !== false && resp.result) {
39
33
  return {
40
34
  success: true,
41
- path: coerceString(interpreted.payload.path) ?? ''
35
+ path: coerceString(resp.result.path) ?? ''
42
36
  };
43
37
  }
44
- return { success: false, error: interpreted.error ?? interpreted.message };
38
+ return { success: false, error: 'Failed to get level name' };
45
39
  }
46
40
  catch (err) {
47
41
  return { error: `Failed to get level name: ${err}`, success: false };
48
42
  }
49
43
  }
50
44
  async saveCurrentLevel() {
51
- // Strict modern API: require LevelEditorSubsystem
52
45
  try {
53
- const py = '\nimport unreal, json\ntry:\n les = unreal.get_editor_subsystem(unreal.LevelEditorSubsystem)\n if not les:\n print(\'RESULT:\' + json.dumps({\'success\': False, \'error\': \'LevelEditorSubsystem not available\'}))\n else:\n les.save_current_level()\n print(\'RESULT:\' + json.dumps({\'success\': True}))\nexcept Exception as e:\n print(\'RESULT:\' + json.dumps({\'success\': False, \'error\': str(e)}))\n'.trim();
54
- const resp = await this.bridge.executePython(py);
55
- const interpreted = interpretStandardResult(resp, {
56
- successMessage: 'Level saved',
57
- failureMessage: 'Failed to save level'
58
- });
59
- if (interpreted.success) {
60
- return { success: true, message: interpreted.message };
46
+ if (!this.automationBridge || typeof this.automationBridge.sendAutomationRequest !== 'function') {
47
+ return { success: false, error: 'Automation bridge is not available' };
48
+ }
49
+ const resp = await this.automationBridge.sendAutomationRequest('save_level', {});
50
+ if (resp && resp.success !== false) {
51
+ return { success: true, message: 'Level saved' };
61
52
  }
62
- return { success: false, error: interpreted.error ?? interpreted.message };
53
+ return { success: false, error: 'Failed to save level' };
63
54
  }
64
55
  catch (err) {
65
56
  return { error: `Failed to save level: ${err}`, success: false };
@@ -0,0 +1,20 @@
1
+ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
2
+ import { UnrealBridge } from '../unreal-bridge.js';
3
+ import { AutomationBridge } from '../automation/index.js';
4
+ import { HealthMonitor } from '../services/health-monitor.js';
5
+ import { AssetResources } from '../resources/assets.js';
6
+ import { ActorResources } from '../resources/actors.js';
7
+ import { LevelResources } from '../resources/levels.js';
8
+ export declare class ResourceRegistry {
9
+ private server;
10
+ private bridge;
11
+ private automationBridge;
12
+ private assetResources;
13
+ private actorResources;
14
+ private levelResources;
15
+ private healthMonitor;
16
+ private ensureConnected;
17
+ constructor(server: Server, bridge: UnrealBridge, automationBridge: AutomationBridge, assetResources: AssetResources, actorResources: ActorResources, levelResources: LevelResources, healthMonitor: HealthMonitor, ensureConnected: () => Promise<boolean>);
18
+ register(): void;
19
+ }
20
+ //# sourceMappingURL=resource-registry.d.ts.map
@@ -0,0 +1,37 @@
1
+ import { ListResourcesRequestSchema } from '@modelcontextprotocol/sdk/types.js';
2
+ import { ResourceHandler } from '../handlers/resource-handlers.js';
3
+ export class ResourceRegistry {
4
+ server;
5
+ bridge;
6
+ automationBridge;
7
+ assetResources;
8
+ actorResources;
9
+ levelResources;
10
+ healthMonitor;
11
+ ensureConnected;
12
+ constructor(server, bridge, automationBridge, assetResources, actorResources, levelResources, healthMonitor, ensureConnected) {
13
+ this.server = server;
14
+ this.bridge = bridge;
15
+ this.automationBridge = automationBridge;
16
+ this.assetResources = assetResources;
17
+ this.actorResources = actorResources;
18
+ this.levelResources = levelResources;
19
+ this.healthMonitor = healthMonitor;
20
+ this.ensureConnected = ensureConnected;
21
+ }
22
+ register() {
23
+ this.server.setRequestHandler(ListResourcesRequestSchema, async () => {
24
+ return {
25
+ resources: [
26
+ { uri: 'ue://assets', name: 'Assets', description: 'Project assets', mimeType: 'application/json' },
27
+ { uri: 'ue://health', name: 'Health Status', description: 'Server health and performance metrics', mimeType: 'application/json' },
28
+ { uri: 'ue://automation-bridge', name: 'Automation Bridge', description: 'Automation bridge diagnostics and recent activity', mimeType: 'application/json' },
29
+ { uri: 'ue://version', name: 'Engine Version', description: 'Unreal Engine version and compatibility info', mimeType: 'application/json' }
30
+ ]
31
+ };
32
+ });
33
+ const resourceHandler = new ResourceHandler(this.server, this.bridge, this.automationBridge, this.assetResources, this.actorResources, this.levelResources, this.healthMonitor, this.ensureConnected);
34
+ resourceHandler.registerHandlers();
35
+ }
36
+ }
37
+ //# sourceMappingURL=resource-registry.js.map
@@ -0,0 +1,23 @@
1
+ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
2
+ import { UnrealBridge } from '../unreal-bridge.js';
3
+ import { AutomationBridge } from '../automation/index.js';
4
+ import { Logger } from '../utils/logger.js';
5
+ import { HealthMonitor } from '../services/health-monitor.js';
6
+ import { AssetResources } from '../resources/assets.js';
7
+ import { ActorResources } from '../resources/actors.js';
8
+ import { LevelResources } from '../resources/levels.js';
9
+ export declare class ToolRegistry {
10
+ private server;
11
+ private bridge;
12
+ private automationBridge;
13
+ private logger;
14
+ private healthMonitor;
15
+ private assetResources;
16
+ private actorResources;
17
+ private levelResources;
18
+ private ensureConnected;
19
+ private defaultElicitationTimeoutMs;
20
+ constructor(server: Server, bridge: UnrealBridge, automationBridge: AutomationBridge, logger: Logger, healthMonitor: HealthMonitor, assetResources: AssetResources, actorResources: ActorResources, levelResources: LevelResources, ensureConnected: () => Promise<boolean>);
21
+ register(): void;
22
+ }
23
+ //# sourceMappingURL=tool-registry.d.ts.map
@@ -0,0 +1,322 @@
1
+ import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
2
+ import { consolidatedToolDefinitions } from '../tools/consolidated-tool-definitions.js';
3
+ import { handleConsolidatedToolCall } from '../tools/consolidated-tool-handlers.js';
4
+ import { responseValidator } from '../utils/response-validator.js';
5
+ import { ErrorHandler } from '../utils/error-handler.js';
6
+ import { cleanObject } from '../utils/safe-json.js';
7
+ import { createElicitationHelper } from '../utils/elicitation.js';
8
+ import { ActorTools } from '../tools/actors.js';
9
+ import { AssetTools } from '../tools/assets.js';
10
+ import { EditorTools } from '../tools/editor.js';
11
+ import { MaterialTools } from '../tools/materials.js';
12
+ import { AnimationTools } from '../tools/animation.js';
13
+ import { PhysicsTools } from '../tools/physics.js';
14
+ import { NiagaraTools } from '../tools/niagara.js';
15
+ import { BlueprintTools } from '../tools/blueprint.js';
16
+ import { LevelTools } from '../tools/level.js';
17
+ import { LightingTools } from '../tools/lighting.js';
18
+ import { LandscapeTools } from '../tools/landscape.js';
19
+ import { FoliageTools } from '../tools/foliage.js';
20
+ import { EnvironmentTools } from '../tools/environment.js';
21
+ import { DebugVisualizationTools } from '../tools/debug.js';
22
+ import { PerformanceTools } from '../tools/performance.js';
23
+ import { AudioTools } from '../tools/audio.js';
24
+ import { UITools } from '../tools/ui.js';
25
+ import { SequenceTools } from '../tools/sequence.js';
26
+ import { IntrospectionTools } from '../tools/introspection.js';
27
+ import { EngineTools } from '../tools/engine.js';
28
+ import { BehaviorTreeTools } from '../tools/behavior-tree.js';
29
+ import { InputTools } from '../tools/input.js';
30
+ import { LogTools } from '../tools/logs.js';
31
+ import { getProjectSetting } from '../utils/ini-reader.js';
32
+ export class ToolRegistry {
33
+ server;
34
+ bridge;
35
+ automationBridge;
36
+ logger;
37
+ healthMonitor;
38
+ assetResources;
39
+ actorResources;
40
+ levelResources;
41
+ ensureConnected;
42
+ defaultElicitationTimeoutMs = 60000;
43
+ constructor(server, bridge, automationBridge, logger, healthMonitor, assetResources, actorResources, levelResources, ensureConnected) {
44
+ this.server = server;
45
+ this.bridge = bridge;
46
+ this.automationBridge = automationBridge;
47
+ this.logger = logger;
48
+ this.healthMonitor = healthMonitor;
49
+ this.assetResources = assetResources;
50
+ this.actorResources = actorResources;
51
+ this.levelResources = levelResources;
52
+ this.ensureConnected = ensureConnected;
53
+ }
54
+ register() {
55
+ const actorTools = new ActorTools(this.bridge);
56
+ const assetTools = new AssetTools(this.bridge);
57
+ const editorTools = new EditorTools(this.bridge);
58
+ const materialTools = new MaterialTools(this.bridge);
59
+ const animationTools = new AnimationTools(this.bridge);
60
+ const physicsTools = new PhysicsTools(this.bridge);
61
+ const niagaraTools = new NiagaraTools(this.bridge);
62
+ const blueprintTools = new BlueprintTools(this.bridge);
63
+ const levelTools = new LevelTools(this.bridge);
64
+ const lightingTools = new LightingTools(this.bridge);
65
+ const landscapeTools = new LandscapeTools(this.bridge);
66
+ const foliageTools = new FoliageTools(this.bridge);
67
+ const environmentTools = new EnvironmentTools(this.bridge);
68
+ const debugTools = new DebugVisualizationTools(this.bridge);
69
+ const performanceTools = new PerformanceTools(this.bridge);
70
+ const audioTools = new AudioTools(this.bridge);
71
+ const uiTools = new UITools(this.bridge);
72
+ const sequenceTools = new SequenceTools(this.bridge);
73
+ const introspectionTools = new IntrospectionTools(this.bridge);
74
+ const engineTools = new EngineTools(this.bridge);
75
+ const behaviorTreeTools = new BehaviorTreeTools(this.bridge);
76
+ const inputTools = new InputTools();
77
+ const logTools = new LogTools(this.bridge);
78
+ const toolsWithAutomation = [
79
+ materialTools, animationTools, physicsTools, niagaraTools,
80
+ lightingTools, landscapeTools, foliageTools, debugTools,
81
+ performanceTools, audioTools, uiTools, introspectionTools,
82
+ engineTools, environmentTools, inputTools
83
+ ];
84
+ toolsWithAutomation.forEach(t => t.setAutomationBridge(this.automationBridge));
85
+ const systemTools = {
86
+ executeConsoleCommand: (command) => this.bridge.executeConsoleCommand(command),
87
+ getProjectSettings: async (section) => {
88
+ const category = typeof section === 'string' && section.trim().length > 0 ? section.trim() : 'Project';
89
+ if (!this.automationBridge || !this.automationBridge.isConnected()) {
90
+ if (process.env.UE_PROJECT_PATH) {
91
+ try {
92
+ const settings = await getProjectSetting(process.env.UE_PROJECT_PATH, category, '');
93
+ return {
94
+ success: true,
95
+ section: category,
96
+ settings: settings || {},
97
+ source: 'disk'
98
+ };
99
+ }
100
+ catch (_diskErr) {
101
+ return { success: false, error: 'Automation bridge not connected and disk read failed', section: category };
102
+ }
103
+ }
104
+ return { success: false, error: 'Automation bridge not connected', section: category };
105
+ }
106
+ try {
107
+ const resp = await this.automationBridge.sendAutomationRequest('system_control', {
108
+ action: 'get_project_settings',
109
+ category
110
+ }, { timeoutMs: 30000 });
111
+ const rawError = (resp?.error || '').toString();
112
+ const msgLower = (resp?.message || '').toString().toLowerCase();
113
+ const isNotImplemented = rawError.toUpperCase() === 'NOT_IMPLEMENTED' || msgLower.includes('not implemented');
114
+ if (!resp || resp.success === false) {
115
+ if (isNotImplemented) {
116
+ if (process.env.UE_PROJECT_PATH) {
117
+ try {
118
+ const settings = await getProjectSetting(process.env.UE_PROJECT_PATH, category, '');
119
+ return {
120
+ success: true,
121
+ section: category,
122
+ settings: settings || {},
123
+ source: 'disk'
124
+ };
125
+ }
126
+ catch (_diskErr) {
127
+ }
128
+ }
129
+ return {
130
+ success: true,
131
+ section: category,
132
+ settings: {
133
+ category,
134
+ available: false,
135
+ note: 'Project settings are not exposed by the current runtime but validation can proceed.'
136
+ }
137
+ };
138
+ }
139
+ return {
140
+ success: false,
141
+ error: rawError || resp?.message || 'Failed to get project settings',
142
+ section: category,
143
+ settings: resp?.result
144
+ };
145
+ }
146
+ const result = resp.result && typeof resp.result === 'object' ? resp.result : {};
147
+ const settings = (result.settings && typeof result.settings === 'object') ? result.settings : result;
148
+ return {
149
+ success: true,
150
+ section: category,
151
+ settings
152
+ };
153
+ }
154
+ catch (e) {
155
+ if (process.env.UE_PROJECT_PATH) {
156
+ try {
157
+ const settings = await getProjectSetting(process.env.UE_PROJECT_PATH, category, '');
158
+ return {
159
+ success: true,
160
+ section: category,
161
+ settings: settings || {},
162
+ source: 'disk'
163
+ };
164
+ }
165
+ catch (_diskErr) {
166
+ }
167
+ }
168
+ return {
169
+ success: false,
170
+ error: `Failed to get project settings: ${e instanceof Error ? e.message : String(e)}`,
171
+ section: category
172
+ };
173
+ }
174
+ }
175
+ };
176
+ const elicitation = createElicitationHelper(this.server, this.logger);
177
+ this.server.setRequestHandler(ListToolsRequestSchema, async () => {
178
+ this.logger.info('Serving consolidated tools');
179
+ const sanitized = consolidatedToolDefinitions.map((t) => {
180
+ try {
181
+ const copy = JSON.parse(JSON.stringify(t));
182
+ delete copy.outputSchema;
183
+ return copy;
184
+ }
185
+ catch (_e) {
186
+ return t;
187
+ }
188
+ });
189
+ return { tools: sanitized };
190
+ });
191
+ this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
192
+ const { name } = request.params;
193
+ let args = request.params.arguments || {};
194
+ const startTime = Date.now();
195
+ const connected = await this.ensureConnected();
196
+ if (!connected) {
197
+ if (name === 'system_control' && args.action === 'get_project_settings') {
198
+ }
199
+ else if (name === 'manage_pipeline') {
200
+ }
201
+ else {
202
+ this.healthMonitor.trackPerformance(startTime, false);
203
+ return {
204
+ content: [{ type: 'text', text: `Cannot execute tool '${name}': Unreal Engine is not connected.` }],
205
+ isError: true
206
+ };
207
+ }
208
+ }
209
+ const tools = {
210
+ actorTools, assetTools, materialTools, editorTools, animationTools,
211
+ physicsTools, niagaraTools, blueprintTools, levelTools, lightingTools,
212
+ landscapeTools, foliageTools, environmentTools, debugTools, performanceTools,
213
+ audioTools, systemTools, uiTools, sequenceTools, introspectionTools,
214
+ engineTools, behaviorTreeTools, inputTools, logTools,
215
+ elicit: elicitation.elicit,
216
+ supportsElicitation: elicitation.supports,
217
+ elicitationTimeoutMs: this.defaultElicitationTimeoutMs,
218
+ assetResources: this.assetResources,
219
+ actorResources: this.actorResources,
220
+ levelResources: this.levelResources,
221
+ bridge: this.bridge,
222
+ automationBridge: this.automationBridge
223
+ };
224
+ try {
225
+ this.logger.debug(`Executing tool: ${name}`);
226
+ try {
227
+ const toolDef = consolidatedToolDefinitions.find(t => t.name === name);
228
+ const inputSchema = toolDef?.inputSchema;
229
+ const elicitFn = tools.elicit;
230
+ if (inputSchema && typeof elicitFn === 'function') {
231
+ const props = inputSchema.properties || {};
232
+ const required = Array.isArray(inputSchema.required) ? inputSchema.required : [];
233
+ const missing = required.filter((k) => {
234
+ const v = args[k];
235
+ if (v === undefined || v === null)
236
+ return true;
237
+ if (typeof v === 'string' && v.trim() === '')
238
+ return true;
239
+ return false;
240
+ });
241
+ const primitiveProps = {};
242
+ for (const k of missing) {
243
+ const p = props[k];
244
+ if (!p || typeof p !== 'object')
245
+ continue;
246
+ const t = (p.type || '').toString();
247
+ const isEnum = Array.isArray(p.enum);
248
+ if (t === 'string' || t === 'number' || t === 'integer' || t === 'boolean' || isEnum) {
249
+ primitiveProps[k] = {
250
+ type: t || (isEnum ? 'string' : undefined),
251
+ title: p.title,
252
+ description: p.description,
253
+ enum: p.enum,
254
+ enumNames: p.enumNames,
255
+ minimum: p.minimum,
256
+ maximum: p.maximum,
257
+ minLength: p.minLength,
258
+ maxLength: p.maxLength,
259
+ pattern: p.pattern,
260
+ format: p.format,
261
+ default: p.default
262
+ };
263
+ }
264
+ }
265
+ if (Object.keys(primitiveProps).length > 0) {
266
+ const elicitOptions = { fallback: async () => ({ ok: false, error: 'missing-params' }) };
267
+ if (typeof tools.elicitationTimeoutMs === 'number' && Number.isFinite(tools.elicitationTimeoutMs)) {
268
+ elicitOptions.timeoutMs = tools.elicitationTimeoutMs;
269
+ }
270
+ const elicitRes = await elicitFn(`Provide missing parameters for ${name}`, { type: 'object', properties: primitiveProps, required: Object.keys(primitiveProps) }, elicitOptions);
271
+ if (elicitRes && elicitRes.ok && elicitRes.value) {
272
+ args = { ...args, ...elicitRes.value };
273
+ }
274
+ }
275
+ }
276
+ }
277
+ catch (e) {
278
+ this.logger.debug('Generic elicitation prefill skipped', { err: e?.message || String(e) });
279
+ }
280
+ let result = await handleConsolidatedToolCall(name, args, tools);
281
+ this.logger.debug(`Tool ${name} returned result`);
282
+ result = cleanObject(result);
283
+ const explicitSuccess = typeof result?.success === 'boolean' ? Boolean(result.success) : undefined;
284
+ const wrappedResult = await responseValidator.wrapResponse(name, result);
285
+ let wrappedSuccess = undefined;
286
+ try {
287
+ const sc = wrappedResult.structuredContent;
288
+ if (sc && typeof sc.success === 'boolean')
289
+ wrappedSuccess = Boolean(sc.success);
290
+ }
291
+ catch { }
292
+ const isErrorResponse = Boolean(wrappedResult?.isError === true);
293
+ const tentative = explicitSuccess ?? wrappedSuccess;
294
+ const finalSuccess = tentative === true && !isErrorResponse;
295
+ this.healthMonitor.trackPerformance(startTime, finalSuccess);
296
+ const durationMs = Date.now() - startTime;
297
+ if (finalSuccess) {
298
+ this.logger.info(`Tool ${name} completed successfully in ${durationMs}ms`);
299
+ }
300
+ else {
301
+ this.logger.warn(`Tool ${name} completed with errors in ${durationMs}ms`);
302
+ }
303
+ const responsePreview = JSON.stringify(wrappedResult).substring(0, 100);
304
+ this.logger.debug(`Returning response to MCP client: ${responsePreview}...`);
305
+ return wrappedResult;
306
+ }
307
+ catch (error) {
308
+ this.healthMonitor.trackPerformance(startTime, false);
309
+ const errorResponse = ErrorHandler.createErrorResponse(error, name, { ...args, scope: `tool-call/${name}` });
310
+ this.logger.error(`Tool execution failed: ${name}`, errorResponse);
311
+ this.healthMonitor.recordError(errorResponse);
312
+ const sanitizedError = cleanObject(errorResponse);
313
+ try {
314
+ sanitizedError.isError = true;
315
+ }
316
+ catch { }
317
+ return responseValidator.wrapResponse(name, sanitizedError);
318
+ }
319
+ });
320
+ }
321
+ }
322
+ //# sourceMappingURL=tool-registry.js.map
@@ -0,0 +1,21 @@
1
+ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
2
+ import { UnrealBridge } from './unreal-bridge.js';
3
+ import { AutomationBridge } from './automation/index.js';
4
+ import { Logger } from './utils/logger.js';
5
+ import { HealthMonitor } from './services/health-monitor.js';
6
+ export declare class ServerSetup {
7
+ private server;
8
+ private bridge;
9
+ private automationBridge;
10
+ private logger;
11
+ private healthMonitor;
12
+ private assetResources;
13
+ private actorResources;
14
+ private levelResources;
15
+ constructor(server: Server, bridge: UnrealBridge, automationBridge: AutomationBridge, logger: Logger, healthMonitor: HealthMonitor);
16
+ setup(): Promise<void>;
17
+ private validateEnvironment;
18
+ private ensureConnectedOnDemand;
19
+ private registerPrompts;
20
+ }
21
+ //# sourceMappingURL=server-setup.d.ts.map