@quenty/studio-bridge 0.22.1 → 0.24.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 (231) hide show
  1. package/CHANGELOG.md +25 -0
  2. package/README.md +36 -8
  3. package/dist/src/bridge/bridge-connection.d.ts.map +1 -1
  4. package/dist/src/bridge/bridge-connection.js +1 -0
  5. package/dist/src/bridge/bridge-connection.js.map +1 -1
  6. package/dist/src/bridge/bridge-session.d.ts +11 -16
  7. package/dist/src/bridge/bridge-session.d.ts.map +1 -1
  8. package/dist/src/bridge/bridge-session.js +37 -29
  9. package/dist/src/bridge/bridge-session.js.map +1 -1
  10. package/dist/src/bridge/bridge-session.test.js +35 -0
  11. package/dist/src/bridge/bridge-session.test.js.map +1 -1
  12. package/dist/src/bridge/internal/bridge-host.d.ts +2 -0
  13. package/dist/src/bridge/internal/bridge-host.d.ts.map +1 -1
  14. package/dist/src/bridge/internal/bridge-host.js +1 -0
  15. package/dist/src/bridge/internal/bridge-host.js.map +1 -1
  16. package/dist/src/bridge/internal/host-protocol.d.ts.map +1 -1
  17. package/dist/src/bridge/internal/host-protocol.js +23 -10
  18. package/dist/src/bridge/internal/host-protocol.js.map +1 -1
  19. package/dist/src/bridge/types.d.ts +5 -2
  20. package/dist/src/bridge/types.d.ts.map +1 -1
  21. package/dist/src/bridge/types.js.map +1 -1
  22. package/dist/src/commands/console/exec/exec.d.ts +13 -3
  23. package/dist/src/commands/console/exec/exec.d.ts.map +1 -1
  24. package/dist/src/commands/console/exec/exec.js +82 -7
  25. package/dist/src/commands/console/exec/exec.js.map +1 -1
  26. package/dist/src/commands/console/exec/exec.test.js +63 -1
  27. package/dist/src/commands/console/exec/exec.test.js.map +1 -1
  28. package/dist/src/commands/framework/action-loader.test.js +1 -1
  29. package/dist/src/commands/framework/action-loader.test.js.map +1 -1
  30. package/dist/src/commands/playtest/player/playtest-players.d.ts.map +1 -1
  31. package/dist/src/commands/playtest/player/playtest-players.js +15 -93
  32. package/dist/src/commands/playtest/player/playtest-players.js.map +1 -1
  33. package/dist/src/commands/playtest/player/playtest-players.test.js +34 -21
  34. package/dist/src/commands/playtest/player/playtest-players.test.js.map +1 -1
  35. package/dist/src/commands/playtest/playtest-sessions.d.ts +19 -3
  36. package/dist/src/commands/playtest/playtest-sessions.d.ts.map +1 -1
  37. package/dist/src/commands/playtest/playtest-sessions.js +54 -74
  38. package/dist/src/commands/playtest/playtest-sessions.js.map +1 -1
  39. package/dist/src/commands/playtest/playtest-sessions.test.js +74 -8
  40. package/dist/src/commands/playtest/playtest-sessions.test.js.map +1 -1
  41. package/dist/src/commands/playtest/run/run.d.ts +9 -7
  42. package/dist/src/commands/playtest/run/run.d.ts.map +1 -1
  43. package/dist/src/commands/playtest/run/run.js +33 -38
  44. package/dist/src/commands/playtest/run/run.js.map +1 -1
  45. package/dist/src/commands/process/close/close.d.ts +4 -0
  46. package/dist/src/commands/process/close/close.d.ts.map +1 -1
  47. package/dist/src/commands/process/close/close.js +54 -4
  48. package/dist/src/commands/process/close/close.js.map +1 -1
  49. package/dist/src/commands/process/close/close.test.js +36 -3
  50. package/dist/src/commands/process/close/close.test.js.map +1 -1
  51. package/dist/src/commands/process/info/info.d.ts +15 -2
  52. package/dist/src/commands/process/info/info.d.ts.map +1 -1
  53. package/dist/src/commands/process/info/info.js +44 -4
  54. package/dist/src/commands/process/info/info.js.map +1 -1
  55. package/dist/src/commands/process/info/info.test.js +48 -0
  56. package/dist/src/commands/process/info/info.test.js.map +1 -1
  57. package/dist/src/commands/process/launch/launch.d.ts.map +1 -1
  58. package/dist/src/commands/process/launch/launch.js +22 -3
  59. package/dist/src/commands/process/launch/launch.js.map +1 -1
  60. package/dist/src/commands/process/launch/launch.test.js +27 -5
  61. package/dist/src/commands/process/launch/launch.test.js.map +1 -1
  62. package/dist/src/commands/process/list/list.d.ts +49 -6
  63. package/dist/src/commands/process/list/list.d.ts.map +1 -1
  64. package/dist/src/commands/process/list/list.js +185 -18
  65. package/dist/src/commands/process/list/list.js.map +1 -1
  66. package/dist/src/commands/process/list/list.test.js +92 -1
  67. package/dist/src/commands/process/list/list.test.js.map +1 -1
  68. package/dist/src/commands/process/run/run.d.ts +1 -1
  69. package/dist/src/commands/process/run/run.d.ts.map +1 -1
  70. package/dist/src/commands/process/run/run.js +3 -3
  71. package/dist/src/commands/process/run/run.js.map +1 -1
  72. package/dist/src/docker/docker-delegator.js +1 -1
  73. package/dist/src/docker/docker-delegator.js.map +1 -1
  74. package/dist/src/docker/docker-delegator.test.js +1 -1
  75. package/dist/src/docker/docker-delegator.test.js.map +1 -1
  76. package/dist/src/plugin/playtest-bridge.d.ts +36 -0
  77. package/dist/src/plugin/playtest-bridge.d.ts.map +1 -0
  78. package/dist/src/plugin/playtest-bridge.js +65 -0
  79. package/dist/src/plugin/playtest-bridge.js.map +1 -0
  80. package/dist/src/plugin/playtest-bridge.test.d.ts +2 -0
  81. package/dist/src/plugin/playtest-bridge.test.d.ts.map +1 -0
  82. package/dist/src/plugin/playtest-bridge.test.js +35 -0
  83. package/dist/src/plugin/playtest-bridge.test.js.map +1 -0
  84. package/dist/src/process/studio-launch-registry.d.ts +14 -0
  85. package/dist/src/process/studio-launch-registry.d.ts.map +1 -0
  86. package/dist/src/process/studio-launch-registry.js +37 -0
  87. package/dist/src/process/studio-launch-registry.js.map +1 -0
  88. package/dist/src/process/studio-launch-registry.test.d.ts +2 -0
  89. package/dist/src/process/studio-launch-registry.test.d.ts.map +1 -0
  90. package/dist/src/process/studio-launch-registry.test.js +38 -0
  91. package/dist/src/process/studio-launch-registry.test.js.map +1 -0
  92. package/dist/src/process/studio-process-closer.d.ts +3 -1
  93. package/dist/src/process/studio-process-closer.d.ts.map +1 -1
  94. package/dist/src/process/studio-process-closer.js +29 -11
  95. package/dist/src/process/studio-process-closer.js.map +1 -1
  96. package/dist/src/process/studio-process-identity.d.ts +10 -0
  97. package/dist/src/process/studio-process-identity.d.ts.map +1 -0
  98. package/dist/src/process/studio-process-identity.js +63 -0
  99. package/dist/src/process/studio-process-identity.js.map +1 -0
  100. package/dist/src/process/studio-process-identity.test.d.ts +2 -0
  101. package/dist/src/process/studio-process-identity.test.d.ts.map +1 -0
  102. package/dist/src/process/studio-process-identity.test.js +30 -0
  103. package/dist/src/process/studio-process-identity.test.js.map +1 -0
  104. package/dist/src/roblox-mcp/index.d.ts +3 -0
  105. package/dist/src/roblox-mcp/index.d.ts.map +1 -0
  106. package/dist/src/roblox-mcp/index.js +3 -0
  107. package/dist/src/roblox-mcp/index.js.map +1 -0
  108. package/dist/src/roblox-mcp/mcp/mcp-stdio-client.d.ts +60 -0
  109. package/dist/src/roblox-mcp/mcp/mcp-stdio-client.d.ts.map +1 -0
  110. package/dist/src/roblox-mcp/mcp/mcp-stdio-client.js +171 -0
  111. package/dist/src/roblox-mcp/mcp/mcp-stdio-client.js.map +1 -0
  112. package/dist/src/roblox-mcp/mcp/mcp-stdio-client.test.d.ts +2 -0
  113. package/dist/src/roblox-mcp/mcp/mcp-stdio-client.test.d.ts.map +1 -0
  114. package/dist/src/roblox-mcp/mcp/mcp-stdio-client.test.js +104 -0
  115. package/dist/src/roblox-mcp/mcp/mcp-stdio-client.test.js.map +1 -0
  116. package/dist/src/roblox-mcp/mcp/repair-list-result.d.ts +2 -0
  117. package/dist/src/roblox-mcp/mcp/repair-list-result.d.ts.map +1 -0
  118. package/dist/src/roblox-mcp/mcp/repair-list-result.js +22 -0
  119. package/dist/src/roblox-mcp/mcp/repair-list-result.js.map +1 -0
  120. package/dist/src/roblox-mcp/mcp/repair-list-result.test.d.ts +2 -0
  121. package/dist/src/roblox-mcp/mcp/repair-list-result.test.d.ts.map +1 -0
  122. package/dist/src/roblox-mcp/mcp/repair-list-result.test.js +42 -0
  123. package/dist/src/roblox-mcp/mcp/repair-list-result.test.js.map +1 -0
  124. package/dist/src/roblox-mcp/roblox-studio-mcp.d.ts +34 -0
  125. package/dist/src/roblox-mcp/roblox-studio-mcp.d.ts.map +1 -0
  126. package/dist/src/roblox-mcp/roblox-studio-mcp.js +190 -0
  127. package/dist/src/roblox-mcp/roblox-studio-mcp.js.map +1 -0
  128. package/dist/src/roblox-mcp/roblox-studio-mcp.test.d.ts +2 -0
  129. package/dist/src/roblox-mcp/roblox-studio-mcp.test.d.ts.map +1 -0
  130. package/dist/src/roblox-mcp/roblox-studio-mcp.test.js +123 -0
  131. package/dist/src/roblox-mcp/roblox-studio-mcp.test.js.map +1 -0
  132. package/dist/src/roblox-mcp/studio/studio-session.d.ts +39 -0
  133. package/dist/src/roblox-mcp/studio/studio-session.d.ts.map +1 -0
  134. package/dist/src/roblox-mcp/studio/studio-session.js +175 -0
  135. package/dist/src/roblox-mcp/studio/studio-session.js.map +1 -0
  136. package/dist/src/roblox-mcp/studio/studio-session.test.d.ts +2 -0
  137. package/dist/src/roblox-mcp/studio/studio-session.test.d.ts.map +1 -0
  138. package/dist/src/roblox-mcp/studio/studio-session.test.js +213 -0
  139. package/dist/src/roblox-mcp/studio/studio-session.test.js.map +1 -0
  140. package/dist/src/roblox-mcp/studio-mcp-locator.d.ts +19 -0
  141. package/dist/src/roblox-mcp/studio-mcp-locator.d.ts.map +1 -0
  142. package/dist/src/roblox-mcp/studio-mcp-locator.js +121 -0
  143. package/dist/src/roblox-mcp/studio-mcp-locator.js.map +1 -0
  144. package/dist/src/roblox-mcp/studio-mcp-locator.test.d.ts +2 -0
  145. package/dist/src/roblox-mcp/studio-mcp-locator.test.d.ts.map +1 -0
  146. package/dist/src/roblox-mcp/studio-mcp-locator.test.js +107 -0
  147. package/dist/src/roblox-mcp/studio-mcp-locator.test.js.map +1 -0
  148. package/dist/src/roblox-mcp/studio-mcp-snapshot.d.ts +23 -0
  149. package/dist/src/roblox-mcp/studio-mcp-snapshot.d.ts.map +1 -0
  150. package/dist/src/roblox-mcp/studio-mcp-snapshot.js +65 -0
  151. package/dist/src/roblox-mcp/studio-mcp-snapshot.js.map +1 -0
  152. package/dist/src/roblox-mcp/studio-mcp-snapshot.test.d.ts +2 -0
  153. package/dist/src/roblox-mcp/studio-mcp-snapshot.test.d.ts.map +1 -0
  154. package/dist/src/roblox-mcp/studio-mcp-snapshot.test.js +81 -0
  155. package/dist/src/roblox-mcp/studio-mcp-snapshot.test.js.map +1 -0
  156. package/dist/src/roblox-mcp/test/fake-mcp-server.d.ts +27 -0
  157. package/dist/src/roblox-mcp/test/fake-mcp-server.d.ts.map +1 -0
  158. package/dist/src/roblox-mcp/test/fake-mcp-server.js +55 -0
  159. package/dist/src/roblox-mcp/test/fake-mcp-server.js.map +1 -0
  160. package/dist/src/server/web-socket-protocol.d.ts +50 -15
  161. package/dist/src/server/web-socket-protocol.d.ts.map +1 -1
  162. package/dist/src/server/web-socket-protocol.js +63 -13
  163. package/dist/src/server/web-socket-protocol.js.map +1 -1
  164. package/dist/tsconfig.tsbuildinfo +1 -1
  165. package/docs/playtest-bridge.md +21 -0
  166. package/package.json +5 -5
  167. package/src/bridge/bridge-connection.ts +1 -0
  168. package/src/bridge/bridge-session.test.ts +51 -0
  169. package/src/bridge/bridge-session.ts +66 -47
  170. package/src/bridge/internal/bridge-host.ts +3 -0
  171. package/src/bridge/internal/host-protocol.ts +22 -9
  172. package/src/bridge/types.ts +5 -0
  173. package/src/commands/console/exec/exec.test.ts +94 -0
  174. package/src/commands/console/exec/exec.ts +130 -16
  175. package/src/commands/console/exec/execute.lua +147 -5
  176. package/src/commands/console/exec/execute.spec.lua +22 -2
  177. package/src/commands/framework/action-loader.test.ts +1 -1
  178. package/src/commands/playtest/player/playtest-players.lua +127 -0
  179. package/src/commands/playtest/player/playtest-players.spec.lua +48 -0
  180. package/src/commands/playtest/player/playtest-players.test.ts +40 -21
  181. package/src/commands/playtest/player/playtest-players.ts +30 -110
  182. package/src/commands/playtest/playtest-sessions.test.ts +116 -14
  183. package/src/commands/playtest/playtest-sessions.ts +77 -88
  184. package/src/commands/playtest/run/run.ts +44 -58
  185. package/src/commands/playtest/start/start-playtest.lua +105 -6
  186. package/src/commands/process/close/close.test.ts +52 -3
  187. package/src/commands/process/close/close.ts +78 -4
  188. package/src/commands/process/info/info.test.ts +76 -0
  189. package/src/commands/process/info/info.ts +74 -6
  190. package/src/commands/process/launch/launch.test.ts +33 -5
  191. package/src/commands/process/launch/launch.ts +41 -3
  192. package/src/commands/process/list/list.test.ts +130 -1
  193. package/src/commands/process/list/list.ts +290 -22
  194. package/src/commands/process/run/run.ts +4 -4
  195. package/src/docker/docker-delegator.test.ts +1 -1
  196. package/src/docker/docker-delegator.ts +1 -1
  197. package/src/plugin/playtest-bridge.test.ts +53 -0
  198. package/src/plugin/playtest-bridge.ts +98 -0
  199. package/src/process/studio-launch-registry.test.ts +56 -0
  200. package/src/process/studio-launch-registry.ts +63 -0
  201. package/src/process/studio-process-closer.ts +36 -11
  202. package/src/process/studio-process-identity.test.ts +45 -0
  203. package/src/process/studio-process-identity.ts +90 -0
  204. package/src/roblox-mcp/index.ts +17 -0
  205. package/src/roblox-mcp/mcp/mcp-stdio-client.test.ts +148 -0
  206. package/src/roblox-mcp/mcp/mcp-stdio-client.ts +270 -0
  207. package/src/roblox-mcp/mcp/repair-list-result.test.ts +52 -0
  208. package/src/roblox-mcp/mcp/repair-list-result.ts +23 -0
  209. package/src/roblox-mcp/roblox-studio-mcp.test.ts +168 -0
  210. package/src/roblox-mcp/roblox-studio-mcp.ts +330 -0
  211. package/src/roblox-mcp/studio/studio-session.test.ts +284 -0
  212. package/src/roblox-mcp/studio/studio-session.ts +279 -0
  213. package/src/roblox-mcp/studio-mcp-locator.test.ts +186 -0
  214. package/src/roblox-mcp/studio-mcp-locator.ts +180 -0
  215. package/src/roblox-mcp/studio-mcp-snapshot.test.ts +113 -0
  216. package/src/roblox-mcp/studio-mcp-snapshot.ts +104 -0
  217. package/src/roblox-mcp/test/fake-mcp-server.ts +74 -0
  218. package/src/server/web-socket-protocol.ts +119 -29
  219. package/templates/studio-bridge-plugin/playtest/StudioBridgePlaytest.client.lua +32 -0
  220. package/templates/studio-bridge-plugin/playtest/StudioBridgePlaytest.server.lua +40 -0
  221. package/templates/studio-bridge-plugin/src/Shared/ActionRouter.lua +25 -3
  222. package/templates/studio-bridge-plugin/src/Shared/PrecompiledSources.lua +47 -0
  223. package/templates/studio-bridge-plugin/src/Shared/PrecompiledSources.spec.lua +57 -0
  224. package/templates/studio-bridge-plugin/src/Shared/StudioBridgeClient.lua +357 -0
  225. package/templates/studio-bridge-plugin/src/Shared/StudioBridgeSessionUtils.lua +29 -3
  226. package/templates/studio-bridge-plugin/src/Shared/StudioBridgeSessionUtils.spec.lua +35 -2
  227. package/templates/studio-bridge-plugin/src/StudioBridgePlugin.server.lua +16 -292
  228. package/src/commands/playtest/run/playtest-runner.luau +0 -264
  229. package/src/commands/playtest/run/playtest-runner.spec.lua +0 -71
  230. package/src/commands/playtest/run/run-playtest-script.lua +0 -139
  231. package/src/commands/playtest/run/run-playtest-script.spec.lua +0 -43
@@ -0,0 +1,213 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import { McpStdioClient } from '../mcp/mcp-stdio-client.js';
3
+ import { createFakeMcpServer, toolText } from '../test/fake-mcp-server.js';
4
+ import { cleanToolError, matchStudiosAsync, resolveStudio, runLuauAsync, } from './studio-session.js';
5
+ async function startAsync(studios) {
6
+ const server = createFakeMcpServer((method, params) => {
7
+ if (method === 'initialize') {
8
+ return { result: { protocolVersion: '2025-06-18', capabilities: {} } };
9
+ }
10
+ if (params?.name === 'list_roblox_studios') {
11
+ return toolText(JSON.stringify({
12
+ studios: studios.map(({ id, name }) => ({ id, name })),
13
+ }));
14
+ }
15
+ if (params?.name === 'execute_luau') {
16
+ const studio = studios.find((s) => s.id === params.arguments.studio_id);
17
+ if (params.arguments.datamodel_type !== 'Edit') {
18
+ return toolText(`${params.arguments.datamodel_type} datamodel is not available in Edit mode`, true);
19
+ }
20
+ return studio
21
+ ? toolText(`${studio.uptime ?? 0},${studio.placeId},${studio.gameId}`)
22
+ : toolText('not connected', true);
23
+ }
24
+ return undefined;
25
+ });
26
+ const client = await McpStdioClient.startAsync('StudioMCP.exe', {
27
+ spawnProcess: () => server.child,
28
+ });
29
+ return { server, client };
30
+ }
31
+ function session(overrides) {
32
+ return {
33
+ sessionId: 'place1-aaaa-edit',
34
+ instanceId: 'place1-aaaa',
35
+ placeName: 'Place1',
36
+ state: 'Edit',
37
+ pluginVersion: '1',
38
+ capabilities: [],
39
+ connectedAt: new Date(0),
40
+ origin: 'user',
41
+ context: 'edit',
42
+ placeId: 0,
43
+ gameId: 0,
44
+ ...overrides,
45
+ };
46
+ }
47
+ const luauCalls = (server) => server.requests.filter((r) => r.params?.name === 'execute_luau').length;
48
+ describe('matchStudiosAsync', () => {
49
+ it('matches a uniquely named Studio to its session without running anything', async () => {
50
+ const { server, client } = await startAsync([
51
+ { id: 'mcp-1', name: 'Place1', placeId: 0, gameId: 0 },
52
+ ]);
53
+ const [studio] = await matchStudiosAsync(client, [session({})], [{ pid: 7, windowTitle: 'Place1 - Roblox Studio' }]);
54
+ expect(studio).toMatchObject({
55
+ studioId: 'mcp-1',
56
+ sessionId: 'place1-aaaa-edit',
57
+ instanceId: 'place1-aaaa',
58
+ pid: 7,
59
+ });
60
+ expect(luauCalls(server)).toBe(0);
61
+ await client.closeAsync();
62
+ });
63
+ it('tells same-named Studios apart by place id', async () => {
64
+ const { client } = await startAsync([
65
+ { id: 'mcp-1', name: 'Game', placeId: 111, gameId: 1 },
66
+ { id: 'mcp-2', name: 'Game', placeId: 222, gameId: 2 },
67
+ ]);
68
+ const studios = await matchStudiosAsync(client, [
69
+ session({
70
+ sessionId: 'a-edit',
71
+ instanceId: 'a',
72
+ placeName: 'Game',
73
+ placeId: 222,
74
+ }),
75
+ session({
76
+ sessionId: 'b-edit',
77
+ instanceId: 'b',
78
+ placeName: 'Game',
79
+ placeId: 111,
80
+ }),
81
+ ]);
82
+ expect(studios.map((s) => [s.studioId, s.sessionId])).toEqual([
83
+ ['mcp-1', 'b-edit'],
84
+ ['mcp-2', 'a-edit'],
85
+ ]);
86
+ await client.closeAsync();
87
+ });
88
+ it('leaves two unsaved places with the same name unmatched rather than guess', async () => {
89
+ const { client } = await startAsync([
90
+ { id: 'mcp-1', name: 'Place1', placeId: 0, gameId: 0 },
91
+ { id: 'mcp-2', name: 'Place1', placeId: 0, gameId: 0 },
92
+ ]);
93
+ const studios = await matchStudiosAsync(client, [
94
+ session({ sessionId: 'a-edit' }),
95
+ session({ sessionId: 'b-edit' }),
96
+ ]);
97
+ expect(studios.every((s) => s.sessionId === undefined)).toBe(true);
98
+ await client.closeAsync();
99
+ });
100
+ it('reads place ids for a Studio the bridge has no session for', async () => {
101
+ const { client } = await startAsync([
102
+ { id: 'mcp-1', name: 'Hub', placeId: 333, gameId: 3 },
103
+ ]);
104
+ const [studio] = await matchStudiosAsync(client, []);
105
+ expect(studio).toMatchObject({
106
+ studioId: 'mcp-1',
107
+ placeId: 333,
108
+ gameId: 3,
109
+ });
110
+ expect(studio.sessionId).toBeUndefined();
111
+ await client.closeAsync();
112
+ });
113
+ });
114
+ describe('cleanToolError', () => {
115
+ it("drops the Assistant's own frames from an execute_luau error", () => {
116
+ expect(cleanToolError('sabuiltin_Assistant.rbxm.Assistant.Packages._Index.AssistantUI.AssistantUI.Tools.ExecuteLuauTool:125: sabuiltin_Assistant.rbxm.Assistant.Packages._Index.AssistantUI.AssistantUI.Util.CommandExecution:54: AssistantCommand:1: boom')).toBe('boom');
117
+ });
118
+ it('leaves other errors alone', () => {
119
+ expect(cleanToolError('Server datamodel is not available in Edit mode')).toBe('Server datamodel is not available in Edit mode');
120
+ });
121
+ });
122
+ describe('resolveStudio', () => {
123
+ const studios = [
124
+ {
125
+ studioId: '1268b6c6-aaaa',
126
+ placeName: 'Place1',
127
+ sessionId: 'place1-3d83-edit',
128
+ instanceId: 'place1-3d83',
129
+ pid: 10,
130
+ },
131
+ { studioId: '99f00000-bbbb', placeName: 'Hub' },
132
+ ];
133
+ it('picks the only Studio without a target', () => {
134
+ expect(resolveStudio([studios[1]]).studioId).toBe('99f00000-bbbb');
135
+ });
136
+ it('asks for --target when several are open', () => {
137
+ expect(() => resolveStudio(studios)).toThrow('Pick one with --target');
138
+ });
139
+ it.each([
140
+ ['a bridge session id', 'place1-3d83-edit'],
141
+ ['a bridge instance id', 'place1-3d83'],
142
+ ['an instance id prefix', 'place1'],
143
+ ['an MCP studio id prefix', '1268b6c6'],
144
+ ['a pid', '10'],
145
+ ])('resolves %s', (_label, target) => {
146
+ expect(resolveStudio(studios, target).studioId).toBe('1268b6c6-aaaa');
147
+ });
148
+ it('resolves a place name for a Studio the bridge has no session for', () => {
149
+ expect(resolveStudio(studios, 'hub').studioId).toBe('99f00000-bbbb');
150
+ });
151
+ it('names the open Studios when nothing matches', () => {
152
+ expect(() => resolveStudio(studios, 'nope')).toThrow("No Studio matches 'nope'");
153
+ });
154
+ });
155
+ describe('runLuauAsync', () => {
156
+ it('maps a bridge context to the MCP data model and reports its error', async () => {
157
+ const { server, client } = await startAsync([
158
+ { id: 'mcp-1', name: 'Place1', placeId: 0, gameId: 0 },
159
+ ]);
160
+ const result = await runLuauAsync(client, 'mcp-1', 'return 1', 'server');
161
+ expect(server.requests.at(-1)?.params.arguments.datamodel_type).toBe('Server');
162
+ expect(result).toEqual({
163
+ success: false,
164
+ error: 'Server datamodel is not available in Edit mode',
165
+ });
166
+ await client.closeAsync();
167
+ });
168
+ });
169
+ describe('matchStudiosAsync by uptime', () => {
170
+ it('tells same-named unsaved Studios apart by how long each has run', async () => {
171
+ const now = Date.now();
172
+ const { client } = await startAsync([
173
+ { id: 'mcp-old', name: 'Place1', placeId: 0, gameId: 0, uptime: 300 },
174
+ { id: 'mcp-new', name: 'Place1', placeId: 0, gameId: 0, uptime: 290 },
175
+ ]);
176
+ const windows = [
177
+ {
178
+ pid: 70,
179
+ windowTitle: 'Place1 - Roblox Studio',
180
+ startedAt: now - 300_000,
181
+ },
182
+ {
183
+ pid: 80,
184
+ windowTitle: 'Place1 - Roblox Studio',
185
+ startedAt: now - 290_000,
186
+ },
187
+ ];
188
+ const studios = await matchStudiosAsync(client, [
189
+ session({ sessionId: 'a-edit', instanceId: 'a' }),
190
+ session({ sessionId: 'b-edit', instanceId: 'b' }),
191
+ ], windows, {
192
+ sessionPids: new Map([
193
+ ['a', 80],
194
+ ['b', 70],
195
+ ]),
196
+ });
197
+ expect(studios.map((s) => [s.studioId, s.pid, s.sessionId])).toEqual([
198
+ ['mcp-old', 70, 'b-edit'],
199
+ ['mcp-new', 80, 'a-edit'],
200
+ ]);
201
+ await client.closeAsync();
202
+ });
203
+ it('never gives one session to two Studios', async () => {
204
+ const { client } = await startAsync([
205
+ { id: 'mcp-1', name: 'Place1', placeId: 0, gameId: 0 },
206
+ { id: 'mcp-2', name: 'Place1', placeId: 0, gameId: 0 },
207
+ ]);
208
+ const studios = await matchStudiosAsync(client, [session({})]);
209
+ expect(studios.filter((s) => s.sessionId).length).toBe(0);
210
+ await client.closeAsync();
211
+ });
212
+ });
213
+ //# sourceMappingURL=studio-session.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"studio-session.test.js","sourceRoot":"","sources":["../../../../src/roblox-mcp/studio/studio-session.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ export declare class StudioMcpUnsupportedError extends Error {
2
+ }
3
+ export interface StudioMcpLaunch {
4
+ command: string;
5
+ args: string[];
6
+ env?: Record<string, string>;
7
+ }
8
+ export interface StudioMcpLocatorOptions {
9
+ platform?: NodeJS.Platform;
10
+ localAppData?: string;
11
+ readContentFolderAsync?: () => Promise<string | undefined>;
12
+ macCandidates?: string[];
13
+ linuxStudioDir?: string;
14
+ linuxEnv?: Record<string, string>;
15
+ }
16
+ export declare function findStudioMcpLaunchAsync(options?: StudioMcpLocatorOptions): Promise<StudioMcpLaunch>;
17
+ export declare function readStudioContentFolderAsync(): Promise<string | undefined>;
18
+ export declare function parseContentFolder(regOutput: string): string | undefined;
19
+ //# sourceMappingURL=studio-mcp-locator.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"studio-mcp-locator.d.ts","sourceRoot":"","sources":["../../../src/roblox-mcp/studio-mcp-locator.ts"],"names":[],"mappings":"AAQA,qBAAa,yBAA0B,SAAQ,KAAK;CAAG;AAEvD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sBAAsB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC3D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,eAAe,CAAC,CAc1B;AAED,wBAAsB,4BAA4B,IAAI,OAAO,CAC3D,MAAM,GAAG,SAAS,CACnB,CAOA;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGxE"}
@@ -0,0 +1,121 @@
1
+ import * as fs from 'fs/promises';
2
+ import * as os from 'os';
3
+ import * as path from 'path';
4
+ import { execa } from 'execa';
5
+ const STUDIO_EXE = 'RobloxStudioBeta.exe';
6
+ const MCP_EXE = 'StudioMCP.exe';
7
+ export class StudioMcpUnsupportedError extends Error {
8
+ }
9
+ export async function findStudioMcpLaunchAsync(options = {}) {
10
+ const platform = options.platform ?? process.platform;
11
+ if (platform === 'win32') {
12
+ return { command: await _findWindowsAsync(options), args: [] };
13
+ }
14
+ if (platform === 'darwin') {
15
+ return { command: await _findMacAsync(options), args: [] };
16
+ }
17
+ if (platform === 'linux') {
18
+ return _findLinuxAsync(options);
19
+ }
20
+ throw new StudioMcpUnsupportedError(`Studio's MCP server is not available on ${platform}`);
21
+ }
22
+ export async function readStudioContentFolderAsync() {
23
+ const { stdout } = await execa('reg', ['query', 'HKCU\\Software\\Roblox\\RobloxStudio', '/v', 'ContentFolder'], { reject: false });
24
+ return parseContentFolder(stdout);
25
+ }
26
+ export function parseContentFolder(regOutput) {
27
+ const match = /ContentFolder\s+REG_(?:EXPAND_)?SZ\s+(.+)$/m.exec(regOutput);
28
+ return match?.[1].trim() || undefined;
29
+ }
30
+ async function _findWindowsAsync(options) {
31
+ const readContentFolderAsync = options.readContentFolderAsync ?? readStudioContentFolderAsync;
32
+ const contentFolder = await readContentFolderAsync();
33
+ if (contentFolder) {
34
+ const versionDir = path.resolve(contentFolder, '..');
35
+ if (await _isStudioVersionDirAsync(versionDir)) {
36
+ return path.join(versionDir, MCP_EXE);
37
+ }
38
+ }
39
+ const localAppData = options.localAppData ?? process.env.LOCALAPPDATA;
40
+ if (!localAppData) {
41
+ throw new Error('LOCALAPPDATA is not set, so Studio cannot be found');
42
+ }
43
+ const versionsDir = path.join(localAppData, 'Roblox', 'Versions');
44
+ for (const versionDir of await _listVersionDirsNewestFirstAsync(versionsDir)) {
45
+ if (await _isStudioVersionDirAsync(versionDir)) {
46
+ return path.join(versionDir, MCP_EXE);
47
+ }
48
+ }
49
+ throw new Error(`No ${MCP_EXE} found next to ${STUDIO_EXE} under ${versionsDir}. Is Roblox Studio installed and up to date?`);
50
+ }
51
+ async function _findMacAsync(options) {
52
+ const candidates = options.macCandidates ?? [
53
+ '/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP',
54
+ path.join(os.homedir(), 'Applications/RobloxStudio.app/Contents/MacOS/StudioMCP'),
55
+ ];
56
+ for (const candidate of candidates) {
57
+ if (await _isFileAsync(candidate)) {
58
+ return candidate;
59
+ }
60
+ }
61
+ throw new Error(`No StudioMCP found in Roblox Studio's app bundle (${candidates.join(', ')})`);
62
+ }
63
+ async function _findLinuxAsync(options) {
64
+ let studioDir = options.linuxStudioDir;
65
+ let env = options.linuxEnv;
66
+ if (studioDir === undefined) {
67
+ const { resolveLinuxConfig } = await import('../linux/linux-config.js');
68
+ const { buildWineEnv } = await import('../linux/linux-wine-env.js');
69
+ const config = resolveLinuxConfig();
70
+ studioDir = config.studioDir;
71
+ env ??= buildWineEnv(config);
72
+ }
73
+ const exe = path.join(studioDir, MCP_EXE);
74
+ if (!(await _isFileAsync(exe))) {
75
+ throw new Error(`No ${MCP_EXE} in ${studioDir}. Run "studio-bridge linux setup" with a Studio that ships it.`);
76
+ }
77
+ return { command: 'wine', args: [exe], env };
78
+ }
79
+ async function _isStudioVersionDirAsync(dir) {
80
+ const [hasStudio, hasMcp] = await Promise.all([
81
+ _isFileAsync(path.join(dir, STUDIO_EXE)),
82
+ _isFileAsync(path.join(dir, MCP_EXE)),
83
+ ]);
84
+ return hasStudio && hasMcp;
85
+ }
86
+ async function _listVersionDirsNewestFirstAsync(versionsDir) {
87
+ let entries;
88
+ try {
89
+ entries = await fs.readdir(versionsDir);
90
+ }
91
+ catch {
92
+ return [];
93
+ }
94
+ const dirs = await Promise.all(entries
95
+ .filter((entry) => entry.startsWith('version-'))
96
+ .map(async (entry) => {
97
+ const dir = path.join(versionsDir, entry);
98
+ try {
99
+ const stat = await fs.stat(dir);
100
+ return stat.isDirectory()
101
+ ? { dir, mtimeMs: stat.mtimeMs }
102
+ : undefined;
103
+ }
104
+ catch {
105
+ return undefined;
106
+ }
107
+ }));
108
+ return dirs
109
+ .filter((d) => d !== undefined)
110
+ .sort((a, b) => b.mtimeMs - a.mtimeMs)
111
+ .map((d) => d.dir);
112
+ }
113
+ async function _isFileAsync(file) {
114
+ try {
115
+ return (await fs.stat(file)).isFile();
116
+ }
117
+ catch {
118
+ return false;
119
+ }
120
+ }
121
+ //# sourceMappingURL=studio-mcp-locator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"studio-mcp-locator.js","sourceRoot":"","sources":["../../../src/roblox-mcp/studio-mcp-locator.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=studio-mcp-locator.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"studio-mcp-locator.test.d.ts","sourceRoot":"","sources":["../../../src/roblox-mcp/studio-mcp-locator.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,107 @@
1
+ import * as fs from 'fs/promises';
2
+ import * as os from 'os';
3
+ import * as path from 'path';
4
+ import { afterEach, beforeEach, describe, expect, it } from 'vitest';
5
+ import { findStudioMcpLaunchAsync, parseContentFolder, } from './studio-mcp-locator.js';
6
+ describe('findStudioMcpLaunchAsync', () => {
7
+ let localAppData;
8
+ let versionsDir;
9
+ beforeEach(async () => {
10
+ localAppData = await fs.mkdtemp(path.join(os.tmpdir(), 'studio-mcp-'));
11
+ versionsDir = path.join(localAppData, 'Roblox', 'Versions');
12
+ await fs.mkdir(versionsDir, { recursive: true });
13
+ });
14
+ afterEach(async () => {
15
+ await fs.rm(localAppData, { recursive: true, force: true });
16
+ });
17
+ async function makeVersionAsync(name, files, mtime) {
18
+ const dir = path.join(versionsDir, name);
19
+ await fs.mkdir(path.join(dir, 'content'), { recursive: true });
20
+ for (const file of files) {
21
+ await fs.writeFile(path.join(dir, file), '');
22
+ }
23
+ await fs.utimes(dir, mtime, mtime);
24
+ return dir;
25
+ }
26
+ it('uses the version folder the registry content folder is in', async () => {
27
+ const dir = await makeVersionAsync('version-current', ['RobloxStudioBeta.exe', 'StudioMCP.exe'], new Date(2026, 0, 1));
28
+ await makeVersionAsync('version-newer', ['RobloxStudioBeta.exe', 'StudioMCP.exe'], new Date(2026, 5, 1));
29
+ const { command: found } = await findStudioMcpLaunchAsync({
30
+ platform: 'win32',
31
+ localAppData,
32
+ readContentFolderAsync: async () => path.join(dir, 'content') + path.sep,
33
+ });
34
+ expect(found).toBe(path.join(dir, 'StudioMCP.exe'));
35
+ });
36
+ it('skips a registry folder that only holds a lingering StudioMCP.exe', async () => {
37
+ const stale = await makeVersionAsync('version-stale', ['StudioMCP.exe'], new Date(2026, 5, 1));
38
+ const current = await makeVersionAsync('version-current', ['RobloxStudioBeta.exe', 'StudioMCP.exe'], new Date(2026, 0, 1));
39
+ const { command: found } = await findStudioMcpLaunchAsync({
40
+ platform: 'win32',
41
+ localAppData,
42
+ readContentFolderAsync: async () => path.join(stale, 'content'),
43
+ });
44
+ expect(found).toBe(path.join(current, 'StudioMCP.exe'));
45
+ });
46
+ it('falls back to the newest folder holding both executables', async () => {
47
+ await makeVersionAsync('version-old', ['RobloxStudioBeta.exe', 'StudioMCP.exe'], new Date(2026, 0, 1));
48
+ const newest = await makeVersionAsync('version-new', ['RobloxStudioBeta.exe', 'StudioMCP.exe'], new Date(2026, 3, 1));
49
+ await makeVersionAsync('version-newest-stale', ['StudioMCP.exe'], new Date(2026, 6, 1));
50
+ const { command: found } = await findStudioMcpLaunchAsync({
51
+ platform: 'win32',
52
+ localAppData,
53
+ readContentFolderAsync: async () => undefined,
54
+ });
55
+ expect(found).toBe(path.join(newest, 'StudioMCP.exe'));
56
+ });
57
+ it('says so when no folder holds both executables', async () => {
58
+ await makeVersionAsync('version-stale', ['StudioMCP.exe'], new Date(2026, 0, 1));
59
+ await expect(findStudioMcpLaunchAsync({
60
+ platform: 'win32',
61
+ localAppData,
62
+ readContentFolderAsync: async () => undefined,
63
+ })).rejects.toThrow('No StudioMCP.exe found next to RobloxStudioBeta.exe');
64
+ });
65
+ it('finds StudioMCP in the macOS app bundle', async () => {
66
+ const exe = path.join(localAppData, 'StudioMCP');
67
+ await fs.writeFile(exe, '');
68
+ const launch = await findStudioMcpLaunchAsync({
69
+ platform: 'darwin',
70
+ macCandidates: [path.join(localAppData, 'missing'), exe],
71
+ });
72
+ expect(launch).toEqual({ command: exe, args: [] });
73
+ });
74
+ it('runs the Linux StudioMCP.exe under wine with its environment', async () => {
75
+ await fs.writeFile(path.join(localAppData, 'StudioMCP.exe'), '');
76
+ const env = { WINEPREFIX: '/wine' };
77
+ const launch = await findStudioMcpLaunchAsync({
78
+ platform: 'linux',
79
+ linuxStudioDir: localAppData,
80
+ linuxEnv: env,
81
+ });
82
+ expect(launch).toEqual({
83
+ command: 'wine',
84
+ args: [path.join(localAppData, 'StudioMCP.exe')],
85
+ env,
86
+ });
87
+ });
88
+ it('says so when the Linux Studio has no StudioMCP.exe', async () => {
89
+ await expect(findStudioMcpLaunchAsync({
90
+ platform: 'linux',
91
+ linuxStudioDir: localAppData,
92
+ linuxEnv: {},
93
+ })).rejects.toThrow('No StudioMCP.exe in');
94
+ });
95
+ it('refuses a platform Studio does not run on', async () => {
96
+ await expect(findStudioMcpLaunchAsync({ platform: 'freebsd' })).rejects.toThrow('not available on freebsd');
97
+ });
98
+ });
99
+ describe('parseContentFolder', () => {
100
+ it('reads the value out of reg query output', () => {
101
+ expect(parseContentFolder('\r\nHKEY_CURRENT_USER\\Software\\Roblox\\RobloxStudio\r\n ContentFolder REG_SZ C:\\Users\\a b\\AppData\\Local\\Roblox\\Versions\\version-1\\content\\\r\n\r\n')).toBe('C:\\Users\\a b\\AppData\\Local\\Roblox\\Versions\\version-1\\content\\');
102
+ });
103
+ it('returns undefined when the value is missing', () => {
104
+ expect(parseContentFolder('ERROR: The system was unable to find the specified registry key or value.')).toBeUndefined();
105
+ });
106
+ });
107
+ //# sourceMappingURL=studio-mcp-locator.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"studio-mcp-locator.test.js","sourceRoot":"","sources":["../../../src/roblox-mcp/studio-mcp-locator.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ import type { SessionInfo } from '../bridge/types.js';
2
+ import type { StudioWindow } from './studio/studio-session.js';
3
+ import { type StudioMcpFailure, type StudioMcpOptions, type StudioMcpResult, type StudioMcpTarget } from './roblox-studio-mcp.js';
4
+ export interface StudioMcpSnapshot {
5
+ status: 'ok' | StudioMcpFailure;
6
+ studios: StudioMcpTarget[];
7
+ message?: string;
8
+ checkedAt: number;
9
+ latencyMs: number;
10
+ lastOkAt?: number;
11
+ settled?: boolean;
12
+ }
13
+ export interface StudioMcpSnapshotOptions {
14
+ sessions?: SessionInfo[];
15
+ sessionPids?: Map<string, number>;
16
+ windows?: StudioWindow[];
17
+ maxWaitMs?: number;
18
+ maxAgeMs?: number;
19
+ listAsync?: (options: StudioMcpOptions) => Promise<StudioMcpResult<StudioMcpTarget[]>>;
20
+ }
21
+ export declare function getStudioMcpSnapshotAsync(options?: StudioMcpSnapshotOptions): Promise<StudioMcpSnapshot | undefined>;
22
+ export declare function resetStudioMcpSnapshot(): void;
23
+ //# sourceMappingURL=studio-mcp-snapshot.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"studio-mcp-snapshot.d.ts","sourceRoot":"","sources":["../../../src/roblox-mcp/studio-mcp-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,IAAI,GAAG,gBAAgB,CAAC;IAChC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,CACV,OAAO,EAAE,gBAAgB,KACtB,OAAO,CAAC,eAAe,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;CAClD;AAQD,wBAAsB,yBAAyB,CAC7C,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAuBxC;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C"}
@@ -0,0 +1,65 @@
1
+ import { tryListStudiosAsync, } from './roblox-studio-mcp.js';
2
+ const DEFAULT_MAX_WAIT_MS = 3000;
3
+ const DEFAULT_MAX_AGE_MS = 5000;
4
+ let _cached;
5
+ let _inFlight;
6
+ export async function getStudioMcpSnapshotAsync(options = {}) {
7
+ const maxWaitMs = options.maxWaitMs ?? DEFAULT_MAX_WAIT_MS;
8
+ const maxAgeMs = options.maxAgeMs ?? DEFAULT_MAX_AGE_MS;
9
+ if (_cached && Date.now() - _cached.checkedAt < maxAgeMs) {
10
+ return _cached;
11
+ }
12
+ _inFlight ??= _refreshAsync(options, maxWaitMs).finally(() => {
13
+ _inFlight = undefined;
14
+ });
15
+ if (_cached) {
16
+ return _cached;
17
+ }
18
+ let timer;
19
+ const gaveUp = new Promise((resolve) => {
20
+ timer = setTimeout(() => resolve(undefined), maxWaitMs + 250);
21
+ });
22
+ try {
23
+ return await Promise.race([_inFlight, gaveUp]);
24
+ }
25
+ finally {
26
+ clearTimeout(timer);
27
+ }
28
+ }
29
+ export function resetStudioMcpSnapshot() {
30
+ _cached = undefined;
31
+ _inFlight = undefined;
32
+ }
33
+ async function _refreshAsync(options, timeoutMs) {
34
+ const startedAt = Date.now();
35
+ const result = await (options.listAsync ?? tryListStudiosAsync)({
36
+ sessions: options.sessions,
37
+ sessionPids: options.sessionPids,
38
+ ...(options.windows
39
+ ? { listWindowsAsync: async () => options.windows }
40
+ : {}),
41
+ timeoutMs,
42
+ readPlaceIds: false,
43
+ });
44
+ const checkedAt = Date.now();
45
+ const snapshot = result.success
46
+ ? {
47
+ status: 'ok',
48
+ studios: result.value,
49
+ settled: result.settled !== false,
50
+ checkedAt,
51
+ latencyMs: checkedAt - startedAt,
52
+ lastOkAt: checkedAt,
53
+ }
54
+ : {
55
+ status: result.reason,
56
+ studios: [],
57
+ message: result.message,
58
+ checkedAt,
59
+ latencyMs: checkedAt - startedAt,
60
+ lastOkAt: _cached?.lastOkAt,
61
+ };
62
+ _cached = snapshot;
63
+ return snapshot;
64
+ }
65
+ //# sourceMappingURL=studio-mcp-snapshot.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"studio-mcp-snapshot.js","sourceRoot":"","sources":["../../../src/roblox-mcp/studio-mcp-snapshot.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,mBAAmB,GAKpB,MAAM,wBAAwB,CAAC;AAuBhC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACjC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC,IAAI,OAAsC,CAAC;AAC3C,IAAI,SAAiD,CAAC;AAEtD,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,UAAoC,EAAE;IAEtC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,mBAAmB,CAAC;IAC3D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,kBAAkB,CAAC;IACxD,IAAI,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,GAAG,QAAQ,EAAE,CAAC;QACzD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,SAAS,KAAK,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;QAC3D,SAAS,GAAG,SAAS,CAAC;IACxB,CAAC,CAAC,CAAC;IACH,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,KAAiC,CAAC;IACtC,MAAM,MAAM,GAAG,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,EAAE;QAChD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,GAAG,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IACH,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,GAAG,SAAS,CAAC;IACpB,SAAS,GAAG,SAAS,CAAC;AACxB,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,OAAiC,EACjC,SAAiB;IAEjB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,mBAAmB,CAAC,CAAC;QAC9D,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,GAAG,CAAC,OAAO,CAAC,OAAO;YACjB,CAAC,CAAC,EAAE,gBAAgB,EAAE,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,OAAQ,EAAE;YACpD,CAAC,CAAC,EAAE,CAAC;QACP,SAAS;QACT,YAAY,EAAE,KAAK;KACpB,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAsB,MAAM,CAAC,OAAO;QAChD,CAAC,CAAC;YACE,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,MAAM,CAAC,KAAK;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO,KAAK,KAAK;YACjC,SAAS;YACT,SAAS,EAAE,SAAS,GAAG,SAAS;YAChC,QAAQ,EAAE,SAAS;SACpB;QACH,CAAC,CAAC;YACE,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS;YACT,SAAS,EAAE,SAAS,GAAG,SAAS;YAChC,QAAQ,EAAE,OAAO,EAAE,QAAQ;SAC5B,CAAC;IACN,OAAO,GAAG,QAAQ,CAAC;IACnB,OAAO,QAAQ,CAAC;AAClB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=studio-mcp-snapshot.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"studio-mcp-snapshot.test.d.ts","sourceRoot":"","sources":["../../../src/roblox-mcp/studio-mcp-snapshot.test.ts"],"names":[],"mappings":""}