unreal-engine-mcp-server 0.4.7 → 0.5.1

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 (454) 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-config.yml +51 -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 +27 -0
  19. package/.github/workflows/labeler.yml +17 -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 +13 -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 +338 -31
  29. package/CONTRIBUTING.md +140 -0
  30. package/GEMINI.md +115 -0
  31. package/Public/Plugin_setup_guide.mp4 +0 -0
  32. package/README.md +189 -128
  33. package/claude_desktop_config_example.json +7 -6
  34. package/dist/automation/bridge.d.ts +50 -0
  35. package/dist/automation/bridge.js +452 -0
  36. package/dist/automation/connection-manager.d.ts +23 -0
  37. package/dist/automation/connection-manager.js +107 -0
  38. package/dist/automation/handshake.d.ts +11 -0
  39. package/dist/automation/handshake.js +89 -0
  40. package/dist/automation/index.d.ts +3 -0
  41. package/dist/automation/index.js +3 -0
  42. package/dist/automation/message-handler.d.ts +12 -0
  43. package/dist/automation/message-handler.js +149 -0
  44. package/dist/automation/request-tracker.d.ts +25 -0
  45. package/dist/automation/request-tracker.js +98 -0
  46. package/dist/automation/types.d.ts +130 -0
  47. package/dist/automation/types.js +2 -0
  48. package/dist/cli.js +32 -5
  49. package/dist/config.d.ts +26 -0
  50. package/dist/config.js +59 -0
  51. package/dist/constants.d.ts +16 -0
  52. package/dist/constants.js +16 -0
  53. package/dist/graphql/loaders.d.ts +64 -0
  54. package/dist/graphql/loaders.js +117 -0
  55. package/dist/graphql/resolvers.d.ts +268 -0
  56. package/dist/graphql/resolvers.js +746 -0
  57. package/dist/graphql/schema.d.ts +5 -0
  58. package/dist/graphql/schema.js +437 -0
  59. package/dist/graphql/server.d.ts +26 -0
  60. package/dist/graphql/server.js +117 -0
  61. package/dist/graphql/types.d.ts +9 -0
  62. package/dist/graphql/types.js +2 -0
  63. package/dist/handlers/resource-handlers.d.ts +20 -0
  64. package/dist/handlers/resource-handlers.js +180 -0
  65. package/dist/index.d.ts +33 -18
  66. package/dist/index.js +130 -619
  67. package/dist/resources/actors.d.ts +17 -12
  68. package/dist/resources/actors.js +56 -76
  69. package/dist/resources/assets.d.ts +6 -14
  70. package/dist/resources/assets.js +115 -147
  71. package/dist/resources/levels.d.ts +13 -13
  72. package/dist/resources/levels.js +25 -34
  73. package/dist/server/resource-registry.d.ts +20 -0
  74. package/dist/server/resource-registry.js +37 -0
  75. package/dist/server/tool-registry.d.ts +23 -0
  76. package/dist/server/tool-registry.js +322 -0
  77. package/dist/server-setup.d.ts +20 -0
  78. package/dist/server-setup.js +71 -0
  79. package/dist/services/health-monitor.d.ts +34 -0
  80. package/dist/services/health-monitor.js +105 -0
  81. package/dist/services/metrics-server.d.ts +11 -0
  82. package/dist/services/metrics-server.js +105 -0
  83. package/dist/tools/actors.d.ts +163 -9
  84. package/dist/tools/actors.js +356 -311
  85. package/dist/tools/animation.d.ts +135 -4
  86. package/dist/tools/animation.js +510 -411
  87. package/dist/tools/assets.d.ts +75 -29
  88. package/dist/tools/assets.js +265 -284
  89. package/dist/tools/audio.d.ts +102 -42
  90. package/dist/tools/audio.js +272 -685
  91. package/dist/tools/base-tool.d.ts +17 -0
  92. package/dist/tools/base-tool.js +46 -0
  93. package/dist/tools/behavior-tree.d.ts +94 -0
  94. package/dist/tools/behavior-tree.js +39 -0
  95. package/dist/tools/blueprint.d.ts +208 -126
  96. package/dist/tools/blueprint.js +685 -832
  97. package/dist/tools/consolidated-tool-definitions.d.ts +5462 -1781
  98. package/dist/tools/consolidated-tool-definitions.js +829 -496
  99. package/dist/tools/consolidated-tool-handlers.d.ts +2 -1
  100. package/dist/tools/consolidated-tool-handlers.js +198 -1027
  101. package/dist/tools/debug.d.ts +143 -85
  102. package/dist/tools/debug.js +234 -180
  103. package/dist/tools/dynamic-handler-registry.d.ts +13 -0
  104. package/dist/tools/dynamic-handler-registry.js +23 -0
  105. package/dist/tools/editor.d.ts +30 -83
  106. package/dist/tools/editor.js +247 -244
  107. package/dist/tools/engine.d.ts +10 -4
  108. package/dist/tools/engine.js +13 -5
  109. package/dist/tools/environment.d.ts +30 -0
  110. package/dist/tools/environment.js +267 -0
  111. package/dist/tools/foliage.d.ts +65 -99
  112. package/dist/tools/foliage.js +221 -331
  113. package/dist/tools/handlers/actor-handlers.d.ts +3 -0
  114. package/dist/tools/handlers/actor-handlers.js +227 -0
  115. package/dist/tools/handlers/animation-handlers.d.ts +3 -0
  116. package/dist/tools/handlers/animation-handlers.js +185 -0
  117. package/dist/tools/handlers/argument-helper.d.ts +16 -0
  118. package/dist/tools/handlers/argument-helper.js +80 -0
  119. package/dist/tools/handlers/asset-handlers.d.ts +3 -0
  120. package/dist/tools/handlers/asset-handlers.js +496 -0
  121. package/dist/tools/handlers/audio-handlers.d.ts +3 -0
  122. package/dist/tools/handlers/audio-handlers.js +166 -0
  123. package/dist/tools/handlers/blueprint-handlers.d.ts +4 -0
  124. package/dist/tools/handlers/blueprint-handlers.js +358 -0
  125. package/dist/tools/handlers/common-handlers.d.ts +14 -0
  126. package/dist/tools/handlers/common-handlers.js +56 -0
  127. package/dist/tools/handlers/editor-handlers.d.ts +3 -0
  128. package/dist/tools/handlers/editor-handlers.js +119 -0
  129. package/dist/tools/handlers/effect-handlers.d.ts +3 -0
  130. package/dist/tools/handlers/effect-handlers.js +171 -0
  131. package/dist/tools/handlers/environment-handlers.d.ts +3 -0
  132. package/dist/tools/handlers/environment-handlers.js +170 -0
  133. package/dist/tools/handlers/graph-handlers.d.ts +3 -0
  134. package/dist/tools/handlers/graph-handlers.js +90 -0
  135. package/dist/tools/handlers/input-handlers.d.ts +3 -0
  136. package/dist/tools/handlers/input-handlers.js +21 -0
  137. package/dist/tools/handlers/inspect-handlers.d.ts +3 -0
  138. package/dist/tools/handlers/inspect-handlers.js +383 -0
  139. package/dist/tools/handlers/level-handlers.d.ts +3 -0
  140. package/dist/tools/handlers/level-handlers.js +237 -0
  141. package/dist/tools/handlers/lighting-handlers.d.ts +3 -0
  142. package/dist/tools/handlers/lighting-handlers.js +144 -0
  143. package/dist/tools/handlers/performance-handlers.d.ts +3 -0
  144. package/dist/tools/handlers/performance-handlers.js +130 -0
  145. package/dist/tools/handlers/pipeline-handlers.d.ts +3 -0
  146. package/dist/tools/handlers/pipeline-handlers.js +110 -0
  147. package/dist/tools/handlers/sequence-handlers.d.ts +3 -0
  148. package/dist/tools/handlers/sequence-handlers.js +376 -0
  149. package/dist/tools/handlers/system-handlers.d.ts +4 -0
  150. package/dist/tools/handlers/system-handlers.js +506 -0
  151. package/dist/tools/input.d.ts +19 -0
  152. package/dist/tools/input.js +89 -0
  153. package/dist/tools/introspection.d.ts +103 -40
  154. package/dist/tools/introspection.js +425 -568
  155. package/dist/tools/landscape.d.ts +54 -93
  156. package/dist/tools/landscape.js +284 -409
  157. package/dist/tools/level.d.ts +66 -27
  158. package/dist/tools/level.js +647 -675
  159. package/dist/tools/lighting.d.ts +77 -38
  160. package/dist/tools/lighting.js +445 -943
  161. package/dist/tools/logs.d.ts +3 -3
  162. package/dist/tools/logs.js +5 -57
  163. package/dist/tools/materials.d.ts +91 -24
  164. package/dist/tools/materials.js +194 -118
  165. package/dist/tools/niagara.d.ts +149 -39
  166. package/dist/tools/niagara.js +267 -182
  167. package/dist/tools/performance.d.ts +27 -13
  168. package/dist/tools/performance.js +203 -122
  169. package/dist/tools/physics.d.ts +32 -77
  170. package/dist/tools/physics.js +175 -582
  171. package/dist/tools/property-dictionary.d.ts +13 -0
  172. package/dist/tools/property-dictionary.js +82 -0
  173. package/dist/tools/sequence.d.ts +85 -60
  174. package/dist/tools/sequence.js +208 -747
  175. package/dist/tools/tool-definition-utils.d.ts +59 -0
  176. package/dist/tools/tool-definition-utils.js +35 -0
  177. package/dist/tools/ui.d.ts +64 -34
  178. package/dist/tools/ui.js +134 -214
  179. package/dist/types/automation-responses.d.ts +115 -0
  180. package/dist/types/automation-responses.js +2 -0
  181. package/dist/types/env.d.ts +0 -3
  182. package/dist/types/env.js +0 -7
  183. package/dist/types/responses.d.ts +249 -0
  184. package/dist/types/responses.js +2 -0
  185. package/dist/types/tool-interfaces.d.ts +898 -0
  186. package/dist/types/tool-interfaces.js +2 -0
  187. package/dist/types/tool-types.d.ts +183 -19
  188. package/dist/types/tool-types.js +0 -4
  189. package/dist/unreal-bridge.d.ts +24 -131
  190. package/dist/unreal-bridge.js +364 -1506
  191. package/dist/utils/command-validator.d.ts +9 -0
  192. package/dist/utils/command-validator.js +68 -0
  193. package/dist/utils/elicitation.d.ts +1 -1
  194. package/dist/utils/elicitation.js +12 -15
  195. package/dist/utils/error-handler.d.ts +2 -51
  196. package/dist/utils/error-handler.js +11 -87
  197. package/dist/utils/ini-reader.d.ts +3 -0
  198. package/dist/utils/ini-reader.js +69 -0
  199. package/dist/utils/logger.js +9 -6
  200. package/dist/utils/normalize.d.ts +3 -0
  201. package/dist/utils/normalize.js +56 -0
  202. package/dist/utils/path-security.d.ts +2 -0
  203. package/dist/utils/path-security.js +24 -0
  204. package/dist/utils/response-factory.d.ts +7 -0
  205. package/dist/utils/response-factory.js +27 -0
  206. package/dist/utils/response-validator.d.ts +3 -24
  207. package/dist/utils/response-validator.js +130 -81
  208. package/dist/utils/result-helpers.d.ts +4 -5
  209. package/dist/utils/result-helpers.js +15 -16
  210. package/dist/utils/safe-json.js +5 -11
  211. package/dist/utils/unreal-command-queue.d.ts +24 -0
  212. package/dist/utils/unreal-command-queue.js +120 -0
  213. package/dist/utils/validation.d.ts +0 -40
  214. package/dist/utils/validation.js +1 -78
  215. package/dist/wasm/index.d.ts +70 -0
  216. package/dist/wasm/index.js +535 -0
  217. package/docs/GraphQL-API.md +888 -0
  218. package/docs/Migration-Guide-v0.5.0.md +684 -0
  219. package/docs/Roadmap.md +53 -0
  220. package/docs/WebAssembly-Integration.md +628 -0
  221. package/docs/editor-plugin-extension.md +370 -0
  222. package/docs/handler-mapping.md +242 -0
  223. package/docs/native-automation-progress.md +128 -0
  224. package/docs/testing-guide.md +423 -0
  225. package/mcp-config-example.json +6 -6
  226. package/package.json +67 -28
  227. package/plugins/McpAutomationBridge/Config/FilterPlugin.ini +8 -0
  228. package/plugins/McpAutomationBridge/McpAutomationBridge.uplugin +64 -0
  229. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/McpAutomationBridge.Build.cs +189 -0
  230. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeGlobals.cpp +22 -0
  231. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeGlobals.h +30 -0
  232. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeHelpers.h +1983 -0
  233. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeModule.cpp +72 -0
  234. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeSettings.cpp +46 -0
  235. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeSubsystem.cpp +581 -0
  236. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_AnimationHandlers.cpp +2394 -0
  237. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_AssetQueryHandlers.cpp +300 -0
  238. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_AssetWorkflowHandlers.cpp +2807 -0
  239. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_AudioHandlers.cpp +1087 -0
  240. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BehaviorTreeHandlers.cpp +488 -0
  241. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintCreationHandlers.cpp +643 -0
  242. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintCreationHandlers.h +31 -0
  243. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintGraphHandlers.cpp +1184 -0
  244. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintHandlers.cpp +5652 -0
  245. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintHandlers_List.cpp +152 -0
  246. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_ControlHandlers.cpp +2614 -0
  247. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_DebugHandlers.cpp +42 -0
  248. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_EditorFunctionHandlers.cpp +1237 -0
  249. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_EffectHandlers.cpp +1701 -0
  250. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_EnvironmentHandlers.cpp +2145 -0
  251. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_FoliageHandlers.cpp +954 -0
  252. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_InputHandlers.cpp +209 -0
  253. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_InsightsHandlers.cpp +41 -0
  254. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_LandscapeHandlers.cpp +1164 -0
  255. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_LevelHandlers.cpp +762 -0
  256. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_LightingHandlers.cpp +634 -0
  257. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_LogHandlers.cpp +136 -0
  258. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_MaterialGraphHandlers.cpp +494 -0
  259. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_NiagaraGraphHandlers.cpp +278 -0
  260. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_NiagaraHandlers.cpp +625 -0
  261. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_PerformanceHandlers.cpp +401 -0
  262. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_PipelineHandlers.cpp +67 -0
  263. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_ProcessRequest.cpp +735 -0
  264. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_PropertyHandlers.cpp +2634 -0
  265. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_RenderHandlers.cpp +189 -0
  266. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_SCSHandlers.cpp +917 -0
  267. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_SCSHandlers.h +39 -0
  268. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_SequenceHandlers.cpp +2670 -0
  269. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_SequencerHandlers.cpp +519 -0
  270. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_TestHandlers.cpp +38 -0
  271. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_UiHandlers.cpp +668 -0
  272. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_WorldPartitionHandlers.cpp +346 -0
  273. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpBridgeWebSocket.cpp +1330 -0
  274. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpBridgeWebSocket.h +149 -0
  275. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpConnectionManager.cpp +783 -0
  276. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Public/McpAutomationBridgeSettings.h +115 -0
  277. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Public/McpAutomationBridgeSubsystem.h +796 -0
  278. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Public/McpConnectionManager.h +117 -0
  279. package/scripts/check-unreal-connection.mjs +19 -0
  280. package/scripts/clean-tmp.js +23 -0
  281. package/scripts/patch-wasm.js +26 -0
  282. package/scripts/run-all-tests.mjs +136 -0
  283. package/scripts/smoke-test.ts +94 -0
  284. package/scripts/sync-mcp-plugin.js +143 -0
  285. package/scripts/test-no-plugin-alternates.mjs +113 -0
  286. package/scripts/validate-server.js +46 -0
  287. package/scripts/verify-automation-bridge.js +200 -0
  288. package/server.json +58 -21
  289. package/src/automation/bridge.ts +558 -0
  290. package/src/automation/connection-manager.ts +130 -0
  291. package/src/automation/handshake.ts +99 -0
  292. package/src/automation/index.ts +2 -0
  293. package/src/automation/message-handler.ts +167 -0
  294. package/src/automation/request-tracker.ts +123 -0
  295. package/src/automation/types.ts +107 -0
  296. package/src/cli.ts +33 -6
  297. package/src/config.ts +73 -0
  298. package/src/constants.ts +19 -0
  299. package/src/graphql/loaders.ts +244 -0
  300. package/src/graphql/resolvers.ts +1008 -0
  301. package/src/graphql/schema.ts +452 -0
  302. package/src/graphql/server.ts +156 -0
  303. package/src/graphql/types.ts +10 -0
  304. package/src/handlers/resource-handlers.ts +186 -0
  305. package/src/index.ts +166 -664
  306. package/src/resources/actors.ts +58 -76
  307. package/src/resources/assets.ts +148 -134
  308. package/src/resources/levels.ts +28 -33
  309. package/src/server/resource-registry.ts +47 -0
  310. package/src/server/tool-registry.ts +354 -0
  311. package/src/server-setup.ts +114 -0
  312. package/src/services/health-monitor.ts +132 -0
  313. package/src/services/metrics-server.ts +142 -0
  314. package/src/tools/actors.ts +426 -323
  315. package/src/tools/animation.ts +672 -461
  316. package/src/tools/assets.ts +364 -289
  317. package/src/tools/audio.ts +323 -766
  318. package/src/tools/base-tool.ts +52 -0
  319. package/src/tools/behavior-tree.ts +45 -0
  320. package/src/tools/blueprint.ts +792 -970
  321. package/src/tools/consolidated-tool-definitions.ts +993 -515
  322. package/src/tools/consolidated-tool-handlers.ts +258 -1146
  323. package/src/tools/debug.ts +292 -187
  324. package/src/tools/dynamic-handler-registry.ts +33 -0
  325. package/src/tools/editor.ts +329 -253
  326. package/src/tools/engine.ts +14 -3
  327. package/src/tools/environment.ts +281 -0
  328. package/src/tools/foliage.ts +330 -392
  329. package/src/tools/handlers/actor-handlers.ts +265 -0
  330. package/src/tools/handlers/animation-handlers.ts +237 -0
  331. package/src/tools/handlers/argument-helper.ts +142 -0
  332. package/src/tools/handlers/asset-handlers.ts +532 -0
  333. package/src/tools/handlers/audio-handlers.ts +194 -0
  334. package/src/tools/handlers/blueprint-handlers.ts +380 -0
  335. package/src/tools/handlers/common-handlers.ts +87 -0
  336. package/src/tools/handlers/editor-handlers.ts +123 -0
  337. package/src/tools/handlers/effect-handlers.ts +220 -0
  338. package/src/tools/handlers/environment-handlers.ts +183 -0
  339. package/src/tools/handlers/graph-handlers.ts +116 -0
  340. package/src/tools/handlers/input-handlers.ts +28 -0
  341. package/src/tools/handlers/inspect-handlers.ts +450 -0
  342. package/src/tools/handlers/level-handlers.ts +252 -0
  343. package/src/tools/handlers/lighting-handlers.ts +147 -0
  344. package/src/tools/handlers/performance-handlers.ts +132 -0
  345. package/src/tools/handlers/pipeline-handlers.ts +127 -0
  346. package/src/tools/handlers/sequence-handlers.ts +415 -0
  347. package/src/tools/handlers/system-handlers.ts +564 -0
  348. package/src/tools/input.ts +101 -0
  349. package/src/tools/introspection.ts +493 -584
  350. package/src/tools/landscape.ts +418 -507
  351. package/src/tools/level.ts +786 -708
  352. package/src/tools/lighting.ts +588 -984
  353. package/src/tools/logs.ts +9 -57
  354. package/src/tools/materials.ts +237 -121
  355. package/src/tools/niagara.ts +335 -168
  356. package/src/tools/performance.ts +320 -169
  357. package/src/tools/physics.ts +274 -613
  358. package/src/tools/property-dictionary.ts +98 -0
  359. package/src/tools/sequence.ts +276 -820
  360. package/src/tools/tool-definition-utils.ts +35 -0
  361. package/src/tools/ui.ts +205 -283
  362. package/src/types/automation-responses.ts +119 -0
  363. package/src/types/env.ts +0 -10
  364. package/src/types/responses.ts +355 -0
  365. package/src/types/tool-interfaces.ts +250 -0
  366. package/src/types/tool-types.ts +243 -21
  367. package/src/unreal-bridge.ts +460 -1550
  368. package/src/utils/command-validator.ts +76 -0
  369. package/src/utils/elicitation.ts +10 -7
  370. package/src/utils/error-handler.ts +14 -90
  371. package/src/utils/ini-reader.ts +86 -0
  372. package/src/utils/logger.ts +8 -3
  373. package/src/utils/normalize.test.ts +162 -0
  374. package/src/utils/normalize.ts +60 -0
  375. package/src/utils/path-security.ts +43 -0
  376. package/src/utils/response-factory.ts +44 -0
  377. package/src/utils/response-validator.ts +176 -56
  378. package/src/utils/result-helpers.ts +21 -19
  379. package/src/utils/safe-json.test.ts +90 -0
  380. package/src/utils/safe-json.ts +14 -11
  381. package/src/utils/unreal-command-queue.ts +152 -0
  382. package/src/utils/validation.test.ts +184 -0
  383. package/src/utils/validation.ts +4 -1
  384. package/src/wasm/index.ts +838 -0
  385. package/test-server.mjs +100 -0
  386. package/tests/run-unreal-tool-tests.mjs +242 -14
  387. package/tests/test-animation.mjs +369 -0
  388. package/tests/test-asset-advanced.mjs +82 -0
  389. package/tests/test-asset-errors.mjs +35 -0
  390. package/tests/test-asset-graph.mjs +311 -0
  391. package/tests/test-audio.mjs +417 -0
  392. package/tests/test-automation-timeouts.mjs +98 -0
  393. package/tests/test-behavior-tree.mjs +444 -0
  394. package/tests/test-blueprint-graph.mjs +410 -0
  395. package/tests/test-blueprint.mjs +577 -0
  396. package/tests/test-client-mode.mjs +86 -0
  397. package/tests/test-console-command.mjs +56 -0
  398. package/tests/test-control-actor.mjs +425 -0
  399. package/tests/test-control-editor.mjs +112 -0
  400. package/tests/test-graphql.mjs +372 -0
  401. package/tests/test-input.mjs +349 -0
  402. package/tests/test-inspect.mjs +302 -0
  403. package/tests/test-landscape.mjs +316 -0
  404. package/tests/test-lighting.mjs +428 -0
  405. package/tests/test-manage-asset.mjs +438 -0
  406. package/tests/test-manage-level.mjs +89 -0
  407. package/tests/test-materials.mjs +356 -0
  408. package/tests/test-niagara.mjs +185 -0
  409. package/tests/test-no-inline-python.mjs +122 -0
  410. package/tests/test-performance.mjs +539 -0
  411. package/tests/test-plugin-handshake.mjs +82 -0
  412. package/tests/test-runner.mjs +933 -0
  413. package/tests/test-sequence.mjs +104 -0
  414. package/tests/test-system.mjs +96 -0
  415. package/tests/test-wasm.mjs +283 -0
  416. package/tests/test-world-partition.mjs +215 -0
  417. package/tsconfig.json +3 -3
  418. package/vitest.config.ts +35 -0
  419. package/wasm/Cargo.lock +363 -0
  420. package/wasm/Cargo.toml +42 -0
  421. package/wasm/LICENSE +21 -0
  422. package/wasm/README.md +253 -0
  423. package/wasm/src/dependency_resolver.rs +377 -0
  424. package/wasm/src/lib.rs +153 -0
  425. package/wasm/src/property_parser.rs +271 -0
  426. package/wasm/src/transform_math.rs +396 -0
  427. package/wasm/tests/integration.rs +109 -0
  428. package/.github/workflows/smithery-build.yml +0 -29
  429. package/dist/prompts/index.d.ts +0 -21
  430. package/dist/prompts/index.js +0 -217
  431. package/dist/tools/build_environment_advanced.d.ts +0 -65
  432. package/dist/tools/build_environment_advanced.js +0 -633
  433. package/dist/tools/rc.d.ts +0 -110
  434. package/dist/tools/rc.js +0 -437
  435. package/dist/tools/visual.d.ts +0 -40
  436. package/dist/tools/visual.js +0 -282
  437. package/dist/utils/http.d.ts +0 -6
  438. package/dist/utils/http.js +0 -151
  439. package/dist/utils/python-output.d.ts +0 -18
  440. package/dist/utils/python-output.js +0 -290
  441. package/dist/utils/python.d.ts +0 -2
  442. package/dist/utils/python.js +0 -4
  443. package/dist/utils/stdio-redirect.d.ts +0 -2
  444. package/dist/utils/stdio-redirect.js +0 -20
  445. package/docs/unreal-tool-test-cases.md +0 -574
  446. package/smithery.yaml +0 -29
  447. package/src/prompts/index.ts +0 -249
  448. package/src/tools/build_environment_advanced.ts +0 -732
  449. package/src/tools/rc.ts +0 -515
  450. package/src/tools/visual.ts +0 -281
  451. package/src/utils/http.ts +0 -187
  452. package/src/utils/python-output.ts +0 -351
  453. package/src/utils/python.ts +0 -3
  454. package/src/utils/stdio-redirect.ts +0 -18
@@ -0,0 +1,89 @@
1
+ import { WebSocket } from 'ws';
2
+ import { Logger } from '../utils/logger.js';
3
+ import { EventEmitter } from 'node:events';
4
+ export class HandshakeHandler extends EventEmitter {
5
+ capabilityToken;
6
+ log = new Logger('HandshakeHandler');
7
+ DEFAULT_HANDSHAKE_TIMEOUT_MS = 5000;
8
+ constructor(capabilityToken) {
9
+ super();
10
+ this.capabilityToken = capabilityToken;
11
+ }
12
+ initiateHandshake(socket, timeoutMs = this.DEFAULT_HANDSHAKE_TIMEOUT_MS) {
13
+ return new Promise((resolve, reject) => {
14
+ let handshakeComplete = false;
15
+ const timeout = setTimeout(() => {
16
+ if (!handshakeComplete) {
17
+ this.log.warn('Automation bridge client handshake timed out');
18
+ socket.close(4002, 'Handshake timeout');
19
+ reject(new Error('Handshake timeout'));
20
+ }
21
+ }, timeoutMs);
22
+ const onMessage = (data) => {
23
+ let parsed;
24
+ const text = typeof data === 'string' ? data : data.toString('utf8');
25
+ try {
26
+ parsed = JSON.parse(text);
27
+ }
28
+ catch (error) {
29
+ this.log.error('Received non-JSON automation message during handshake', error);
30
+ socket.close(4003, 'Invalid JSON payload');
31
+ cleanup();
32
+ reject(new Error('Invalid JSON payload'));
33
+ return;
34
+ }
35
+ if (parsed.type === 'bridge_ack') {
36
+ handshakeComplete = true;
37
+ cleanup();
38
+ const metadata = this.sanitizeHandshakeMetadata(parsed);
39
+ resolve(metadata);
40
+ }
41
+ else {
42
+ this.log.warn(`Expected bridge_ack handshake, received ${parsed.type}`);
43
+ socket.close(4004, 'Handshake expected bridge_ack');
44
+ cleanup();
45
+ reject(new Error(`Handshake expected bridge_ack, got ${parsed.type}`));
46
+ }
47
+ };
48
+ const onError = (error) => {
49
+ cleanup();
50
+ reject(error);
51
+ };
52
+ const onClose = () => {
53
+ cleanup();
54
+ reject(new Error('Socket closed during handshake'));
55
+ };
56
+ const cleanup = () => {
57
+ clearTimeout(timeout);
58
+ socket.off('message', onMessage);
59
+ socket.off('error', onError);
60
+ socket.off('close', onClose);
61
+ };
62
+ socket.on('message', onMessage);
63
+ socket.on('error', onError);
64
+ socket.on('close', onClose);
65
+ setTimeout(() => {
66
+ if (socket.readyState === WebSocket.OPEN) {
67
+ const helloPayload = {
68
+ type: 'bridge_hello',
69
+ capabilityToken: this.capabilityToken || undefined
70
+ };
71
+ this.log.debug(`Sending bridge_hello (delayed): ${JSON.stringify(helloPayload)}`);
72
+ socket.send(JSON.stringify(helloPayload));
73
+ }
74
+ else {
75
+ this.log.warn('Socket closed before bridge_hello could be sent');
76
+ }
77
+ }, 500);
78
+ });
79
+ }
80
+ sanitizeHandshakeMetadata(payload) {
81
+ const sanitized = { ...payload };
82
+ delete sanitized.type;
83
+ if ('capabilityToken' in sanitized) {
84
+ sanitized.capabilityToken = 'REDACTED';
85
+ }
86
+ return sanitized;
87
+ }
88
+ }
89
+ //# sourceMappingURL=handshake.js.map
@@ -0,0 +1,3 @@
1
+ export { AutomationBridge } from './bridge.js';
2
+ export * from './types.js';
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,3 @@
1
+ export { AutomationBridge } from './bridge.js';
2
+ export * from './types.js';
3
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1,12 @@
1
+ import { AutomationBridgeMessage } from './types.js';
2
+ import { RequestTracker } from './request-tracker.js';
3
+ export declare class MessageHandler {
4
+ private requestTracker;
5
+ private log;
6
+ constructor(requestTracker: RequestTracker);
7
+ handleMessage(message: AutomationBridgeMessage): void;
8
+ private handleAutomationResponse;
9
+ private handleAutomationEvent;
10
+ private enforceActionMatch;
11
+ }
12
+ //# sourceMappingURL=message-handler.d.ts.map
@@ -0,0 +1,149 @@
1
+ import { Logger } from '../utils/logger.js';
2
+ function FStringSafe(val) {
3
+ try {
4
+ if (val === undefined || val === null)
5
+ return '';
6
+ if (typeof val === 'string')
7
+ return val;
8
+ return JSON.stringify(val);
9
+ }
10
+ catch {
11
+ try {
12
+ return String(val);
13
+ }
14
+ catch {
15
+ return '';
16
+ }
17
+ }
18
+ }
19
+ export class MessageHandler {
20
+ requestTracker;
21
+ log = new Logger('MessageHandler');
22
+ constructor(requestTracker) {
23
+ this.requestTracker = requestTracker;
24
+ }
25
+ handleMessage(message) {
26
+ switch (message.type) {
27
+ case 'automation_response':
28
+ this.handleAutomationResponse(message);
29
+ break;
30
+ case 'bridge_ping':
31
+ break;
32
+ case 'bridge_pong':
33
+ break;
34
+ case 'bridge_goodbye':
35
+ this.log.info('Automation bridge client initiated shutdown.', message);
36
+ break;
37
+ case 'automation_event':
38
+ this.handleAutomationEvent(message);
39
+ break;
40
+ default:
41
+ this.log.debug('Received automation bridge message with no handler', message);
42
+ break;
43
+ }
44
+ }
45
+ handleAutomationResponse(response) {
46
+ const requestId = response.requestId;
47
+ if (!requestId) {
48
+ this.log.warn('Received automation_response without requestId');
49
+ return;
50
+ }
51
+ const pending = this.requestTracker.getPendingRequest(requestId);
52
+ if (!pending) {
53
+ this.log.debug(`No pending automation request found for requestId=${requestId}`);
54
+ return;
55
+ }
56
+ const enforcedResponse = this.enforceActionMatch(response, pending.action);
57
+ if (pending.waitForEvent) {
58
+ if (!pending.initialResponse) {
59
+ pending.initialResponse = enforcedResponse;
60
+ if (enforcedResponse.success === false) {
61
+ this.requestTracker.resolveRequest(requestId, enforcedResponse);
62
+ return;
63
+ }
64
+ const result = enforcedResponse.result;
65
+ if (result && result.saved === true) {
66
+ this.requestTracker.resolveRequest(requestId, enforcedResponse);
67
+ return;
68
+ }
69
+ const eventTimeoutMs = pending.eventTimeoutMs || 30000;
70
+ pending.eventTimeout = setTimeout(() => {
71
+ this.requestTracker.rejectRequest(requestId, new Error(`Timed out waiting for completion event for ${pending.action}`));
72
+ }, eventTimeoutMs);
73
+ this.log.debug(`Received initial response for ${pending.action}, waiting for completion event...`);
74
+ }
75
+ else {
76
+ this.requestTracker.resolveRequest(requestId, enforcedResponse);
77
+ }
78
+ }
79
+ else {
80
+ this.requestTracker.resolveRequest(requestId, enforcedResponse);
81
+ }
82
+ }
83
+ handleAutomationEvent(message) {
84
+ const evt = message;
85
+ const reqId = typeof evt.requestId === 'string' ? evt.requestId : undefined;
86
+ if (reqId) {
87
+ const pending = this.requestTracker.getPendingRequest(reqId);
88
+ if (pending) {
89
+ try {
90
+ const baseSuccess = (pending.initialResponse && typeof pending.initialResponse.success === 'boolean') ? pending.initialResponse.success : undefined;
91
+ const evtSuccess = (evt.result && typeof evt.result.success === 'boolean') ? !!evt.result.success : undefined;
92
+ const synthetic = {
93
+ type: 'automation_response',
94
+ requestId: reqId,
95
+ success: evtSuccess !== undefined ? evtSuccess : (baseSuccess !== undefined ? baseSuccess : undefined),
96
+ message: typeof evt.result?.message === 'string' ? evt.result.message : (typeof evt.message === 'string' ? evt.message : FStringSafe(evt.event)),
97
+ error: typeof evt.result?.error === 'string' ? evt.result.error : undefined,
98
+ result: evt.result ?? evt.payload ?? undefined
99
+ };
100
+ this.log.info(`automation_event resolved pending request ${reqId} (event=${String(evt.event || '')})`);
101
+ this.requestTracker.resolveRequest(reqId, synthetic);
102
+ }
103
+ catch (e) {
104
+ this.log.warn(`Failed to resolve pending automation request from automation_event ${reqId}: ${String(e)}`);
105
+ }
106
+ return;
107
+ }
108
+ }
109
+ this.log.debug('Received automation_event (no pending request):', message);
110
+ }
111
+ enforceActionMatch(response, expectedAction) {
112
+ try {
113
+ const expected = (expectedAction || '').toString().toLowerCase();
114
+ const echoed = (() => {
115
+ const r = response;
116
+ const candidate = (typeof r.action === 'string' && r.action) || (typeof r.result?.action === 'string' && r.result.action);
117
+ return candidate;
118
+ })();
119
+ if (expected && echoed && typeof echoed === 'string') {
120
+ const got = echoed.toLowerCase();
121
+ const consolidatedToolActions = new Set([
122
+ 'animation_physics',
123
+ 'create_effect',
124
+ 'build_environment',
125
+ 'system_control',
126
+ 'manage_ui'
127
+ ]);
128
+ if (consolidatedToolActions.has(expected) && got !== expected) {
129
+ return response;
130
+ }
131
+ const startsEitherWay = got.startsWith(expected) || expected.startsWith(got);
132
+ if (!startsEitherWay) {
133
+ const mutated = { ...response };
134
+ mutated.success = false;
135
+ if (!mutated.error)
136
+ mutated.error = 'ACTION_PREFIX_MISMATCH';
137
+ const msgBase = typeof mutated.message === 'string' ? mutated.message + ' ' : '';
138
+ mutated.message = `${msgBase}Response action mismatch (expected~='${expected}', got='${echoed}')`;
139
+ return mutated;
140
+ }
141
+ }
142
+ }
143
+ catch (e) {
144
+ this.log.debug('enforceActionMatch check skipped', e);
145
+ }
146
+ return response;
147
+ }
148
+ }
149
+ //# sourceMappingURL=message-handler.js.map
@@ -0,0 +1,25 @@
1
+ import { PendingRequest, AutomationBridgeResponseMessage } from './types.js';
2
+ export declare class RequestTracker {
3
+ private maxPendingRequests;
4
+ private pendingRequests;
5
+ private coalescedRequests;
6
+ constructor(maxPendingRequests: number);
7
+ createRequest(action: string, payload: Record<string, unknown>, timeoutMs: number): {
8
+ requestId: string;
9
+ promise: Promise<AutomationBridgeResponseMessage>;
10
+ };
11
+ getPendingRequest(requestId: string): PendingRequest | undefined;
12
+ resolveRequest(requestId: string, response: AutomationBridgeResponseMessage): void;
13
+ rejectRequest(requestId: string, error: Error): void;
14
+ rejectAll(error: Error): void;
15
+ getPendingCount(): number;
16
+ getPendingDetails(): Array<{
17
+ requestId: string;
18
+ action: string;
19
+ ageMs: number;
20
+ }>;
21
+ getCoalescedRequest(key: string): Promise<AutomationBridgeResponseMessage> | undefined;
22
+ setCoalescedRequest(key: string, promise: Promise<AutomationBridgeResponseMessage>): void;
23
+ createCoalesceKey(action: string, payload: Record<string, unknown>): string;
24
+ }
25
+ //# sourceMappingURL=request-tracker.d.ts.map
@@ -0,0 +1,98 @@
1
+ import { randomUUID, createHash } from 'node:crypto';
2
+ const WAIT_FOR_EVENT_ACTIONS = new Set([]);
3
+ export class RequestTracker {
4
+ maxPendingRequests;
5
+ pendingRequests = new Map();
6
+ coalescedRequests = new Map();
7
+ constructor(maxPendingRequests) {
8
+ this.maxPendingRequests = maxPendingRequests;
9
+ }
10
+ createRequest(action, payload, timeoutMs) {
11
+ if (this.pendingRequests.size >= this.maxPendingRequests) {
12
+ throw new Error(`Max pending requests limit reached (${this.maxPendingRequests})`);
13
+ }
14
+ const requestId = randomUUID();
15
+ const waitForEvent = WAIT_FOR_EVENT_ACTIONS.has(action);
16
+ const promise = new Promise((resolve, reject) => {
17
+ const timeout = setTimeout(() => {
18
+ if (this.pendingRequests.has(requestId)) {
19
+ this.pendingRequests.delete(requestId);
20
+ reject(new Error(`Request ${requestId} timed out after ${timeoutMs}ms`));
21
+ }
22
+ }, timeoutMs);
23
+ this.pendingRequests.set(requestId, {
24
+ resolve,
25
+ reject,
26
+ timeout,
27
+ action,
28
+ payload,
29
+ requestedAt: new Date(),
30
+ waitForEvent,
31
+ eventTimeoutMs: timeoutMs
32
+ });
33
+ });
34
+ return { requestId, promise };
35
+ }
36
+ getPendingRequest(requestId) {
37
+ return this.pendingRequests.get(requestId);
38
+ }
39
+ resolveRequest(requestId, response) {
40
+ const pending = this.pendingRequests.get(requestId);
41
+ if (pending) {
42
+ clearTimeout(pending.timeout);
43
+ if (pending.eventTimeout)
44
+ clearTimeout(pending.eventTimeout);
45
+ this.pendingRequests.delete(requestId);
46
+ pending.resolve(response);
47
+ }
48
+ }
49
+ rejectRequest(requestId, error) {
50
+ const pending = this.pendingRequests.get(requestId);
51
+ if (pending) {
52
+ clearTimeout(pending.timeout);
53
+ if (pending.eventTimeout)
54
+ clearTimeout(pending.eventTimeout);
55
+ this.pendingRequests.delete(requestId);
56
+ pending.reject(error);
57
+ }
58
+ }
59
+ rejectAll(error) {
60
+ for (const [, pending] of this.pendingRequests) {
61
+ clearTimeout(pending.timeout);
62
+ if (pending.eventTimeout)
63
+ clearTimeout(pending.eventTimeout);
64
+ pending.reject(error);
65
+ }
66
+ this.pendingRequests.clear();
67
+ }
68
+ getPendingCount() {
69
+ return this.pendingRequests.size;
70
+ }
71
+ getPendingDetails() {
72
+ const now = Date.now();
73
+ return Array.from(this.pendingRequests.entries()).map(([id, pending]) => ({
74
+ requestId: id,
75
+ action: pending.action,
76
+ ageMs: Math.max(0, now - pending.requestedAt.getTime())
77
+ }));
78
+ }
79
+ getCoalescedRequest(key) {
80
+ return this.coalescedRequests.get(key);
81
+ }
82
+ setCoalescedRequest(key, promise) {
83
+ this.coalescedRequests.set(key, promise);
84
+ promise.finally(() => {
85
+ if (this.coalescedRequests.get(key) === promise) {
86
+ this.coalescedRequests.delete(key);
87
+ }
88
+ });
89
+ }
90
+ createCoalesceKey(action, payload) {
91
+ const readOnlyActions = ['list', 'get_', 'exists', 'search', 'find'];
92
+ if (!readOnlyActions.some(a => action.startsWith(a)))
93
+ return '';
94
+ const stablePayload = JSON.stringify(payload, Object.keys(payload).sort());
95
+ return `${action}:${createHash('md5').update(stablePayload).digest('hex')}`;
96
+ }
97
+ }
98
+ //# sourceMappingURL=request-tracker.js.map
@@ -0,0 +1,130 @@
1
+ import { WebSocket } from 'ws';
2
+ export interface AutomationBridgeOptions {
3
+ host?: string;
4
+ port?: number;
5
+ ports?: number[];
6
+ protocols?: string[];
7
+ capabilityToken?: string;
8
+ enabled?: boolean;
9
+ serverName?: string;
10
+ serverVersion?: string;
11
+ heartbeatIntervalMs?: number;
12
+ maxPendingRequests?: number;
13
+ maxConcurrentConnections?: number;
14
+ clientMode?: boolean;
15
+ clientHost?: string;
16
+ clientPort?: number;
17
+ serverLegacyEnabled?: boolean;
18
+ }
19
+ export interface AutomationBridgeMessage {
20
+ type: string;
21
+ [key: string]: unknown;
22
+ }
23
+ export interface AutomationBridgeResponseMessage extends AutomationBridgeMessage {
24
+ requestId: string;
25
+ success?: boolean;
26
+ message?: string;
27
+ error?: string;
28
+ result?: unknown;
29
+ }
30
+ export interface AutomationBridgeStatus {
31
+ enabled: boolean;
32
+ host: string;
33
+ port: number;
34
+ configuredPorts: number[];
35
+ listeningPorts: number[];
36
+ connected: boolean;
37
+ connectedAt: string | null;
38
+ activePort: number | null;
39
+ negotiatedProtocol: string | null;
40
+ supportedProtocols: string[];
41
+ supportedOpcodes: string[];
42
+ expectedResponseOpcodes: string[];
43
+ capabilityTokenRequired: boolean;
44
+ lastHandshakeAt: string | null;
45
+ lastHandshakeMetadata: Record<string, unknown> | null;
46
+ lastHandshakeAck: Record<string, unknown> | null;
47
+ lastHandshakeFailure: {
48
+ reason: string;
49
+ at: string;
50
+ } | null;
51
+ lastDisconnect: {
52
+ code: number;
53
+ reason: string;
54
+ at: string;
55
+ } | null;
56
+ lastError: {
57
+ message: string;
58
+ at: string;
59
+ } | null;
60
+ lastMessageAt: string | null;
61
+ lastRequestSentAt: string | null;
62
+ pendingRequests: number;
63
+ pendingRequestDetails: Array<{
64
+ requestId: string;
65
+ action: string;
66
+ ageMs: number;
67
+ }>;
68
+ connections: Array<{
69
+ connectionId: string;
70
+ sessionId: string | null;
71
+ remoteAddress: string | null;
72
+ remotePort: number | null;
73
+ port: number;
74
+ connectedAt: string;
75
+ protocol: string | null;
76
+ readyState: number;
77
+ isPrimary: boolean;
78
+ }>;
79
+ webSocketListening: boolean;
80
+ serverLegacyEnabled: boolean;
81
+ serverName: string;
82
+ serverVersion: string;
83
+ maxConcurrentConnections: number;
84
+ maxPendingRequests: number;
85
+ heartbeatIntervalMs: number;
86
+ }
87
+ export interface PendingRequest {
88
+ resolve: (value: AutomationBridgeResponseMessage) => void;
89
+ reject: (reason: Error) => void;
90
+ timeout: NodeJS.Timeout;
91
+ action: string;
92
+ payload: Record<string, unknown>;
93
+ requestedAt: Date;
94
+ waitForEvent?: boolean;
95
+ eventTimeout?: NodeJS.Timeout | undefined;
96
+ eventTimeoutMs?: number | undefined;
97
+ initialResponse?: AutomationBridgeResponseMessage | undefined;
98
+ }
99
+ export interface SocketInfo {
100
+ connectionId: string;
101
+ port: number;
102
+ connectedAt: Date;
103
+ protocol?: string;
104
+ sessionId?: string;
105
+ remoteAddress?: string;
106
+ remotePort?: number;
107
+ }
108
+ export type AutomationBridgeEvents = {
109
+ connected: (info: {
110
+ socket: WebSocket;
111
+ metadata: Record<string, unknown>;
112
+ port: number;
113
+ protocol: string | null;
114
+ }) => void;
115
+ disconnected: (info: {
116
+ code: number;
117
+ reason: string;
118
+ port: number;
119
+ protocol: string | null;
120
+ }) => void;
121
+ message: (message: AutomationBridgeMessage) => void;
122
+ error: (error: Error & {
123
+ port?: number;
124
+ }) => void;
125
+ handshakeFailed: (info: {
126
+ reason: string;
127
+ port: number;
128
+ }) => void;
129
+ };
130
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
package/dist/cli.js CHANGED
@@ -1,7 +1,34 @@
1
1
  #!/usr/bin/env node
2
- import { startStdioServer } from './index.js';
3
- startStdioServer().catch((err) => {
4
- console.error('Failed to start server:', err);
5
- process.exit(1);
6
- });
2
+ (async () => {
3
+ try {
4
+ const m = await import('./index.js');
5
+ if (m && typeof m.startStdioServer === 'function') {
6
+ await m.startStdioServer();
7
+ }
8
+ else {
9
+ throw new Error('startStdioServer not exported from index.js');
10
+ }
11
+ }
12
+ catch (err) {
13
+ if (err && ((err.code === 'ERR_MODULE_NOT_FOUND') || String(err).includes('Unable to resolve'))) {
14
+ try {
15
+ const tsModuleSpecifier = new URL('./index.ts', import.meta.url).href;
16
+ const m2 = await import(tsModuleSpecifier);
17
+ if (m2 && typeof m2.startStdioServer === 'function') {
18
+ await m2.startStdioServer();
19
+ }
20
+ else {
21
+ throw new Error('startStdioServer not exported from index.ts');
22
+ }
23
+ }
24
+ catch (err2) {
25
+ console.error('Failed to start server (fallback to TypeScript failed):', err2);
26
+ process.exit(1);
27
+ }
28
+ }
29
+ console.error('Failed to start server:', err);
30
+ process.exit(1);
31
+ }
32
+ })();
33
+ export {};
7
34
  //# sourceMappingURL=cli.js.map
@@ -0,0 +1,26 @@
1
+ import { z } from 'zod';
2
+ export declare const EnvSchema: z.ZodObject<{
3
+ NODE_ENV: z.ZodDefault<z.ZodEnum<{
4
+ development: "development";
5
+ production: "production";
6
+ test: "test";
7
+ }>>;
8
+ LOG_LEVEL: z.ZodDefault<z.ZodEnum<{
9
+ debug: "debug";
10
+ info: "info";
11
+ warn: "warn";
12
+ error: "error";
13
+ }>>;
14
+ MCP_ROUTE_STDOUT_LOGS: z.ZodPipe<z.ZodTransform<boolean, unknown>, z.ZodDefault<z.ZodBoolean>>;
15
+ UE_PROJECT_PATH: z.ZodOptional<z.ZodString>;
16
+ UE_EDITOR_EXE: z.ZodOptional<z.ZodString>;
17
+ MCP_AUTOMATION_PORT: z.ZodPipe<z.ZodTransform<number, unknown>, z.ZodDefault<z.ZodNumber>>;
18
+ MCP_AUTOMATION_HOST: z.ZodDefault<z.ZodString>;
19
+ MCP_AUTOMATION_CLIENT_MODE: z.ZodPipe<z.ZodTransform<boolean, unknown>, z.ZodDefault<z.ZodBoolean>>;
20
+ MCP_CONNECTION_TIMEOUT_MS: z.ZodPipe<z.ZodTransform<number, unknown>, z.ZodDefault<z.ZodNumber>>;
21
+ MCP_REQUEST_TIMEOUT_MS: z.ZodPipe<z.ZodTransform<number, unknown>, z.ZodDefault<z.ZodNumber>>;
22
+ }, z.core.$strip>;
23
+ export type Config = z.infer<typeof EnvSchema>;
24
+ declare let config: Config;
25
+ export { config };
26
+ //# sourceMappingURL=config.d.ts.map
package/dist/config.js ADDED
@@ -0,0 +1,59 @@
1
+ import { z } from 'zod';
2
+ import { Logger } from './utils/logger.js';
3
+ import dotenv from 'dotenv';
4
+ const originalWrite = process.stdout.write;
5
+ process.stdout.write = function () { return true; };
6
+ try {
7
+ dotenv.config();
8
+ }
9
+ finally {
10
+ process.stdout.write = originalWrite;
11
+ }
12
+ const log = new Logger('Config');
13
+ const stringToBoolean = (val) => {
14
+ if (typeof val === 'boolean')
15
+ return val;
16
+ if (typeof val === 'string') {
17
+ const lower = val.toLowerCase().trim();
18
+ return lower === 'true' || lower === '1' || lower === 'on';
19
+ }
20
+ return false;
21
+ };
22
+ const stringToNumber = (val, defaultVal) => {
23
+ if (typeof val === 'number')
24
+ return val;
25
+ if (typeof val === 'string') {
26
+ const parsed = parseInt(val, 10);
27
+ return isNaN(parsed) ? defaultVal : parsed;
28
+ }
29
+ return defaultVal;
30
+ };
31
+ export const EnvSchema = z.object({
32
+ NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),
33
+ LOG_LEVEL: z.enum(['debug', 'info', 'warn', 'error']).default('debug'),
34
+ MCP_ROUTE_STDOUT_LOGS: z.preprocess(stringToBoolean, z.boolean().default(true)),
35
+ UE_PROJECT_PATH: z.string().optional(),
36
+ UE_EDITOR_EXE: z.string().optional(),
37
+ MCP_AUTOMATION_PORT: z.preprocess((v) => stringToNumber(v, 8091), z.number().default(8091)),
38
+ MCP_AUTOMATION_HOST: z.string().default('127.0.0.1'),
39
+ MCP_AUTOMATION_CLIENT_MODE: z.preprocess(stringToBoolean, z.boolean().default(false)),
40
+ MCP_CONNECTION_TIMEOUT_MS: z.preprocess((v) => stringToNumber(v, 5000), z.number().default(5000)),
41
+ MCP_REQUEST_TIMEOUT_MS: z.preprocess((v) => stringToNumber(v, 30000), z.number().default(30000)),
42
+ });
43
+ let config;
44
+ try {
45
+ config = EnvSchema.parse(process.env);
46
+ log.debug('Configuration loaded successfully');
47
+ }
48
+ catch (error) {
49
+ if (error instanceof z.ZodError) {
50
+ log.error('❌ Invalid configuration:', error.format());
51
+ log.warn('⚠️ Falling back to safe defaults.');
52
+ config = EnvSchema.parse({});
53
+ }
54
+ else {
55
+ throw error;
56
+ }
57
+ }
58
+ export { config };
59
+ //# sourceMappingURL=config.js.map
@@ -0,0 +1,16 @@
1
+ export declare const DEFAULT_AUTOMATION_HOST = "127.0.0.1";
2
+ export declare const DEFAULT_AUTOMATION_PORT = 8090;
3
+ export declare const DEFAULT_AUTOMATION_PORTS: number[];
4
+ export declare const DEFAULT_NEGOTIATED_PROTOCOLS: string[];
5
+ export declare const DEFAULT_HEARTBEAT_INTERVAL_MS = 10000;
6
+ export declare const DEFAULT_HANDSHAKE_TIMEOUT_MS = 5000;
7
+ export declare const DEFAULT_MAX_PENDING_REQUESTS = 25;
8
+ export declare const DEFAULT_TIME_OF_DAY = 9;
9
+ export declare const DEFAULT_SUN_INTENSITY = 10000;
10
+ export declare const DEFAULT_SKYLIGHT_INTENSITY = 1;
11
+ export declare const DEFAULT_SCREENSHOT_RESOLUTION = "1920x1080";
12
+ export declare const DEFAULT_OPERATION_TIMEOUT_MS = 30000;
13
+ export declare const DEFAULT_ASSET_OP_TIMEOUT_MS = 60000;
14
+ export declare const EXTENDED_ASSET_OP_TIMEOUT_MS = 120000;
15
+ export declare const LONG_RUNNING_OP_TIMEOUT_MS = 300000;
16
+ //# sourceMappingURL=constants.d.ts.map
@@ -0,0 +1,16 @@
1
+ export const DEFAULT_AUTOMATION_HOST = '127.0.0.1';
2
+ export const DEFAULT_AUTOMATION_PORT = 8090;
3
+ export const DEFAULT_AUTOMATION_PORTS = [8090, 8091];
4
+ export const DEFAULT_NEGOTIATED_PROTOCOLS = ['mcp-automation'];
5
+ export const DEFAULT_HEARTBEAT_INTERVAL_MS = 10000;
6
+ export const DEFAULT_HANDSHAKE_TIMEOUT_MS = 5000;
7
+ export const DEFAULT_MAX_PENDING_REQUESTS = 25;
8
+ export const DEFAULT_TIME_OF_DAY = 9;
9
+ export const DEFAULT_SUN_INTENSITY = 10000;
10
+ export const DEFAULT_SKYLIGHT_INTENSITY = 1;
11
+ export const DEFAULT_SCREENSHOT_RESOLUTION = '1920x1080';
12
+ export const DEFAULT_OPERATION_TIMEOUT_MS = 30000;
13
+ export const DEFAULT_ASSET_OP_TIMEOUT_MS = 60000;
14
+ export const EXTENDED_ASSET_OP_TIMEOUT_MS = 120000;
15
+ export const LONG_RUNNING_OP_TIMEOUT_MS = 300000;
16
+ //# sourceMappingURL=constants.js.map