@seriousgaming/sdk-tools 1.4.0 → 1.6.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 (302) hide show
  1. package/dist/bundling/ui-bundler.d.ts +12 -0
  2. package/dist/cli-25RWY5BQ.js +41 -0
  3. package/dist/cli-272KBNJH.js +97 -0
  4. package/dist/cli-2BH7FX27.js +52 -0
  5. package/dist/cli-2GOFEW26.js +81 -0
  6. package/dist/cli-3E3MD5U4.js +21 -0
  7. package/dist/cli-3HE4AVZG.js +115 -0
  8. package/dist/cli-4AKVLEC4.js +1387 -0
  9. package/dist/cli-4BV45LBH.js +126 -0
  10. package/dist/cli-4LKXZQ2B.js +48 -0
  11. package/dist/cli-4UWFQNGF.js +54 -0
  12. package/dist/cli-4YB3ROVR.js +78 -0
  13. package/dist/cli-57RXC3HQ.js +36 -0
  14. package/dist/cli-5JEGTVTG.js +96 -0
  15. package/dist/cli-6AMT3BUO.js +97 -0
  16. package/dist/cli-6RRVEGFB.js +80 -0
  17. package/dist/cli-6WXLXJVX.js +36 -0
  18. package/dist/cli-7OGYADZ3.js +97 -0
  19. package/dist/cli-AK7OIPWY.js +229 -0
  20. package/dist/cli-B4TN6PJP.js +124 -0
  21. package/dist/cli-B6YHEKIJ.js +248 -0
  22. package/dist/cli-BPYMTOUL.js +89 -0
  23. package/dist/cli-BWX5E7TQ.js +23 -0
  24. package/dist/cli-BYJWFFCF.js +37 -0
  25. package/dist/cli-C3NVCKO6.js +43 -0
  26. package/dist/cli-C47GJATR.js +42 -0
  27. package/dist/cli-C5QOJJWX.js +46 -0
  28. package/dist/cli-C6TH5S7K.js +6417 -0
  29. package/dist/cli-DL2CVMRF.js +89 -0
  30. package/dist/cli-DMW2OQIJ.js +76 -0
  31. package/dist/cli-DZW3XD5F.js +143 -0
  32. package/dist/cli-E2NLWIFE.js +1331 -0
  33. package/dist/cli-E33CJRRQ.js +36 -0
  34. package/dist/cli-E6DJIMYD.js +142 -0
  35. package/dist/cli-EEFJKIGL.js +151 -0
  36. package/dist/cli-EVFS55WN.js +185 -0
  37. package/dist/cli-F2D4GGUA.js +549 -0
  38. package/dist/cli-FBTRTIZJ.js +226 -0
  39. package/dist/cli-FWFRKQNE.js +11 -0
  40. package/dist/cli-FYINNRML.js +760 -0
  41. package/dist/cli-G522CPRL.js +88 -0
  42. package/dist/cli-G6KELFSX.js +2847 -0
  43. package/dist/cli-G6UE5NL4.js +90 -0
  44. package/dist/cli-GBFM76BF.js +16 -0
  45. package/dist/cli-GDQ6ILJY.js +101 -0
  46. package/dist/cli-GFBGYFYD.js +50 -0
  47. package/dist/cli-GGPDQNM3.js +35 -0
  48. package/dist/cli-GTSGLN3Z.js +307 -0
  49. package/dist/cli-GUXKQMJ7.js +13641 -0
  50. package/dist/cli-GXD36NF2.js +60 -0
  51. package/dist/cli-HCRTYQQS.js +16 -0
  52. package/dist/cli-HYY64SUD.js +185 -0
  53. package/dist/cli-I355WTAF.js +463 -0
  54. package/dist/cli-IDKYF5XB.js +59 -0
  55. package/dist/cli-ILKCQNM6.js +8 -0
  56. package/dist/cli-IRZ5KB7D.js +36 -0
  57. package/dist/cli-IUS2YCD3.js +31 -0
  58. package/dist/cli-J4DKUUTK.js +138 -0
  59. package/dist/cli-JFU22EJ2.js +187 -0
  60. package/dist/cli-JMZLT65J.js +226 -0
  61. package/dist/cli-JZM7XTNV.js +89 -0
  62. package/dist/cli-K2B6WHKA.js +81 -0
  63. package/dist/cli-KL3756X6.js +126 -0
  64. package/dist/cli-KNOOKGYW.js +88 -0
  65. package/dist/cli-LFGRFIEO.js +226 -0
  66. package/dist/cli-LFM7GJHI.js +0 -0
  67. package/dist/cli-LMDJCHHD.js +304 -0
  68. package/dist/cli-LXYPE3L5.js +99 -0
  69. package/dist/cli-M6BCQRID.js +153 -0
  70. package/dist/cli-MBNMPVDC.js +367 -0
  71. package/dist/cli-MJUYJIEP.js +13 -0
  72. package/dist/cli-MMN4BPO4.js +145 -0
  73. package/dist/cli-MYJGMA6U.js +40 -0
  74. package/dist/cli-N6H6T2E2.js +616 -0
  75. package/dist/cli-O5KP4OVN.js +61 -0
  76. package/dist/cli-O6PWMJTZ.js +25 -0
  77. package/dist/cli-ORIG557O.js +141 -0
  78. package/dist/cli-PFFCNGHI.js +243 -0
  79. package/dist/cli-PNLYX6R6.js +131 -0
  80. package/dist/cli-PQBXVLEU.js +649 -0
  81. package/dist/cli-PTT5RGKO.js +62 -0
  82. package/dist/cli-Q2XJF5AS.js +127 -0
  83. package/dist/cli-QEVDDBNO.js +60 -0
  84. package/dist/cli-QEVE5HUM.js +167 -0
  85. package/dist/cli-QUIJCBYB.js +391 -0
  86. package/dist/cli-QUNIRH7A.js +57 -0
  87. package/dist/cli-QVASWX2A.js +187 -0
  88. package/dist/cli-QWQMPCL6.js +253 -0
  89. package/dist/cli-R4PCG5YX.js +131 -0
  90. package/dist/cli-RA673NGF.js +53 -0
  91. package/dist/cli-RN6IWTL2.js +36 -0
  92. package/dist/cli-ROT3DRKU.js +145 -0
  93. package/dist/cli-RZITKPJX.js +367 -0
  94. package/dist/cli-S5IVGDDD.js +32 -0
  95. package/dist/cli-S5QDONIQ.js +218 -0
  96. package/dist/cli-SIPDUBFL.js +36 -0
  97. package/dist/cli-SMFSZF2G.js +4009 -0
  98. package/dist/cli-SRHBXZCN.js +159 -0
  99. package/dist/cli-TCY5LJ7E.js +88 -0
  100. package/dist/cli-TDSQSCX4.js +131 -0
  101. package/dist/cli-TIDQ4WUE.js +257 -0
  102. package/dist/cli-TLLA6KAP.js +79 -0
  103. package/dist/cli-TPU4TUR6.js +132 -0
  104. package/dist/cli-U2UE7I7J.js +30 -0
  105. package/dist/cli-UELGBQG7.js +101 -0
  106. package/dist/cli-UHSZBKYO.js +97 -0
  107. package/dist/cli-UJ4UCL2Z.js +38 -0
  108. package/dist/cli-UKQYZYFK.js +31 -0
  109. package/dist/cli-UMFFURZ7.js +81 -0
  110. package/dist/cli-UNAJ2OTE.js +15 -0
  111. package/dist/cli-UNJ5X6BU.js +89 -0
  112. package/dist/cli-UTJU4IYG.js +117 -0
  113. package/dist/cli-V4GHRWOV.js +1837 -0
  114. package/dist/cli-VCI3CG36.js +73 -0
  115. package/dist/cli-VCKOC2EV.js +256 -0
  116. package/dist/cli-VL2P354N.js +46 -0
  117. package/dist/cli-WAE26SVW.js +72 -0
  118. package/dist/cli-WOGIAU2E.js +100 -0
  119. package/dist/cli-WU43JT4T.js +52 -0
  120. package/dist/cli-XCO2VQOH.js +122 -0
  121. package/dist/cli-XSVGKI3R.js +39 -0
  122. package/dist/cli-YOTGR3NB.js +82 -0
  123. package/dist/cli-YVVXUD2G.js +197 -0
  124. package/dist/cli-ZISJ36MM.js +89 -0
  125. package/dist/cli-ZTWOE3ZT.js +65 -0
  126. package/dist/cli-ZVSFYDPQ.js +205 -0
  127. package/dist/cli-ZWPYIXNI.js +68 -0
  128. package/dist/cli.js +171 -42385
  129. package/dist/client/build-surfaces.d.ts +33 -0
  130. package/dist/client/dev-server.d.ts +6 -0
  131. package/dist/client/index.d.ts +1 -0
  132. package/dist/client/playwright.d.ts +62 -0
  133. package/dist/client.js +339 -56
  134. package/dist/core/session.d.ts +15 -1
  135. package/dist/dev/console/assets/{index-BvB-LFQZ.js → index-CuMOOH9m.js} +21 -21
  136. package/dist/dev/console/index.html +1 -1
  137. package/dist/dev/public-origins.d.ts +61 -0
  138. package/dist/dev/shell.d.ts +51 -4
  139. package/dist/dev/surfaces.d.ts +7 -0
  140. package/dist/docs/ai-agents.md +5 -0
  141. package/dist/docs/api/index.md +14 -12
  142. package/dist/docs/api/sdk-tools-client.md +29 -0
  143. package/dist/docs/api/sdk-tools-playwright.md +104 -0
  144. package/dist/docs/changelog-0.x.md +2 -2
  145. package/dist/docs/changelog.md +56 -4
  146. package/dist/docs/cli-and-dev-server.md +79 -0
  147. package/dist/docs/cli-error-codes.md +39 -36
  148. package/dist/docs/cli-reference.md +93 -32
  149. package/dist/docs/environment-variables.md +16 -5
  150. package/dist/docs/guides/ai-facilitation.md +2 -0
  151. package/dist/docs/guides/capabilities.md +2 -0
  152. package/dist/docs/guides/designing-a-game.md +31 -4
  153. package/dist/docs/guides/designing-screens.md +133 -0
  154. package/dist/docs/guides/endpoints.md +2 -0
  155. package/dist/docs/guides/engine-testing.md +5 -1
  156. package/dist/docs/guides/engine.md +2 -0
  157. package/dist/docs/guides/file-handling.md +3 -1
  158. package/dist/docs/guides/games.md +3 -1
  159. package/dist/docs/guides/global-settings.md +2 -0
  160. package/dist/docs/guides/guide.md +2 -0
  161. package/dist/docs/guides/hooks.md +2 -0
  162. package/dist/docs/guides/index.md +9 -0
  163. package/dist/docs/guides/internationalization.md +2 -0
  164. package/dist/docs/guides/llm-integration.md +4 -2
  165. package/dist/docs/guides/multi-team-games.md +3 -1
  166. package/dist/docs/guides/patterns.md +2 -0
  167. package/dist/docs/guides/presentation.md +1 -1
  168. package/dist/docs/guides/production-constraints.md +2 -0
  169. package/dist/docs/guides/scenario-editor.md +2 -0
  170. package/dist/docs/guides/scenarios.md +6 -2
  171. package/dist/docs/guides/session-game-flow.md +365 -0
  172. package/dist/docs/guides/session-hooks.md +205 -0
  173. package/dist/docs/guides/session.md +27 -565
  174. package/dist/docs/guides/settings.md +2 -0
  175. package/dist/docs/guides/setup.md +3 -1
  176. package/dist/docs/guides/speech-generation.md +2 -0
  177. package/dist/docs/guides/starter-game.md +63 -23
  178. package/dist/docs/guides/testing.md +35 -18
  179. package/dist/docs/guides/tick-controller.md +3 -1
  180. package/dist/docs/guides/type-safety.md +2 -0
  181. package/dist/docs/guides/ui-files-and-llms.md +328 -0
  182. package/dist/docs/guides/ui-participants.md +281 -0
  183. package/dist/docs/guides/ui-styling.md +263 -0
  184. package/dist/docs/guides/ui-ticks.md +247 -0
  185. package/dist/docs/guides/ui.md +11 -1092
  186. package/dist/docs/guides/upgrading.md +2 -0
  187. package/dist/docs/guides/validators.md +2 -0
  188. package/dist/docs/guides/waiting-room.md +1 -1
  189. package/dist/docs/index.md +2 -1
  190. package/dist/docs/page-index.md +146 -0
  191. package/dist/docs/recipes/adapt-a-game-for-walkthroughs.md +1 -1
  192. package/dist/docs/recipes/adapt-ui-for-observers.md +1 -1
  193. package/dist/docs/recipes/create-presentation.md +11 -0
  194. package/dist/docs/recipes/create-scenario-editor.md +1 -0
  195. package/dist/docs/recipes/create-session-ui.md +2 -1
  196. package/dist/docs/recipes/create-setup.md +1 -0
  197. package/dist/docs/recipes/create-user-interface.md +1 -0
  198. package/dist/docs/recipes/create-waiting-room-ui.md +1 -0
  199. package/dist/docs/recipes/design-state-for-concurrent-writes.md +1 -1
  200. package/dist/docs/recipes/e2e-testing.md +19 -20
  201. package/dist/docs/recipes/fix-duplicate-packages.md +2 -2
  202. package/dist/docs/recipes/index.md +3 -0
  203. package/dist/docs/recipes/screenshot-a-surface.md +80 -0
  204. package/dist/docs/recipes/test-a-multi-role-game.md +1 -1
  205. package/dist/docs/recipes/use-request-tick.md +2 -2
  206. package/dist/execution/config-resolver.d.ts +4 -1
  207. package/dist/playwright.js +32232 -0
  208. package/dist/runtime/manifest-version.d.ts +1 -1
  209. package/dist/runtime.js +1 -1
  210. package/dist/templates/package/CLAUDE.md.template +14 -5
  211. package/dist/templates/package/DESIGN.md.liquid +39 -7
  212. package/dist/templates/package/README.md.liquid +1 -1
  213. package/dist/templates/package/claude/rules/workflow-create-user-interface.md +1 -1
  214. package/dist/templates/package/claude/rules/workflow-test-engine-or-ui.md +1 -1
  215. package/dist/templates/package/global-setup.ts.template +7 -18
  216. package/dist/templates/package/playwright.config.ts.liquid +8 -11
  217. package/dist/templates/package/pnpm-workspace.yaml.template +13 -0
  218. package/dist/templates/starter-game/capabilities/pacing/capability.sdk.json +18 -0
  219. package/dist/templates/starter-game/package.json +2 -0
  220. package/dist/templates/starter-game/playwright.config.ts +8 -11
  221. package/dist/templates/starter-game/presentation/defaults.ts +52 -0
  222. package/dist/templates/starter-game/presentation/index.html +20 -0
  223. package/dist/templates/starter-game/presentation/presentation.sdk.json +10 -0
  224. package/dist/templates/starter-game/presentation/src/App.tsx +55 -0
  225. package/dist/templates/starter-game/presentation/src/Band.tsx +40 -0
  226. package/dist/templates/starter-game/presentation/src/Slides.tsx +415 -0
  227. package/dist/templates/starter-game/presentation/src/WeatherIcon.tsx +21 -0
  228. package/dist/templates/starter-game/presentation/src/i18n.ts +88 -0
  229. package/dist/templates/starter-game/presentation/src/main.tsx +15 -0
  230. package/dist/templates/starter-game/presentation/src/stalls.test.ts +196 -0
  231. package/dist/templates/starter-game/presentation/src/stalls.ts +199 -0
  232. package/dist/templates/starter-game/presentation/types.ts +94 -0
  233. package/dist/templates/starter-game/seriousgaming.sdk.json +2 -1
  234. package/dist/templates/starter-game/session/defaults.ts +6 -0
  235. package/dist/templates/starter-game/session/index.html +1 -1
  236. package/dist/templates/starter-game/session/session.sdk.json +2 -2
  237. package/dist/templates/starter-game/session/src/App.test.tsx +436 -115
  238. package/dist/templates/starter-game/session/src/App.tsx +372 -222
  239. package/dist/templates/starter-game/session/src/JoinCodes.tsx +184 -0
  240. package/dist/templates/starter-game/session/src/ManagePanel.tsx +188 -0
  241. package/dist/templates/starter-game/session/src/Results.tsx +340 -0
  242. package/dist/templates/starter-game/session/src/SessionBar.tsx +179 -0
  243. package/dist/templates/starter-game/session/src/SessionPanels.tsx +105 -0
  244. package/dist/templates/starter-game/session/src/SidePanel.tsx +89 -0
  245. package/dist/templates/starter-game/session/src/StallCard.tsx +253 -0
  246. package/dist/templates/starter-game/session/src/TopBar.tsx +36 -0
  247. package/dist/templates/starter-game/session/src/i18n.ts +91 -24
  248. package/dist/templates/starter-game/session/src/status.ts +28 -0
  249. package/dist/templates/starter-game/session/types.ts +8 -2
  250. package/dist/templates/starter-game/shared/Awning.tsx +31 -0
  251. package/dist/templates/starter-game/shared/HostLogo.test.tsx +38 -0
  252. package/dist/templates/starter-game/shared/HostLogo.tsx +48 -0
  253. package/dist/templates/starter-game/shared/StallIcons.tsx +83 -0
  254. package/dist/templates/starter-game/shared/days.ts +11 -0
  255. package/dist/templates/starter-game/shared/format.test.ts +13 -0
  256. package/dist/templates/starter-game/{ui/src → shared}/format.ts +1 -1
  257. package/dist/templates/starter-game/testing/e2e/game.spec.ts +43 -9
  258. package/dist/templates/starter-game/testing/e2e/global-setup.ts +7 -18
  259. package/dist/templates/starter-game/ui/defaults.ts +3 -0
  260. package/dist/templates/starter-game/ui/src/App.test.tsx +197 -29
  261. package/dist/templates/starter-game/ui/src/App.tsx +176 -99
  262. package/dist/templates/starter-game/ui/src/DayBar.test.tsx +50 -7
  263. package/dist/templates/starter-game/ui/src/DayBar.tsx +96 -38
  264. package/dist/templates/starter-game/ui/src/DaysTable.tsx +69 -0
  265. package/dist/templates/starter-game/ui/src/FirstDay.tsx +37 -0
  266. package/dist/templates/starter-game/ui/src/Header.tsx +257 -0
  267. package/dist/templates/starter-game/ui/src/Lesson.tsx +63 -0
  268. package/dist/templates/starter-game/ui/src/MakeRow.tsx +98 -71
  269. package/dist/templates/starter-game/ui/src/Notices.tsx +59 -0
  270. package/dist/templates/starter-game/ui/src/PastDay.tsx +88 -0
  271. package/dist/templates/starter-game/ui/src/Section.tsx +26 -26
  272. package/dist/templates/starter-game/ui/src/ThemeToggle.tsx +25 -11
  273. package/dist/templates/starter-game/ui/src/TodayPanel.test.tsx +37 -33
  274. package/dist/templates/starter-game/ui/src/TodayPanel.tsx +66 -52
  275. package/dist/templates/starter-game/ui/src/WeatherCard.tsx +47 -0
  276. package/dist/templates/starter-game/ui/src/WeekOver.tsx +145 -0
  277. package/dist/templates/starter-game/ui/src/YesterdayPanel.tsx +65 -114
  278. package/dist/templates/starter-game/ui/src/days.ts +58 -0
  279. package/dist/templates/starter-game/ui/src/i18n.ts +86 -32
  280. package/dist/templates/starter-game/ui/src/test-helpers.ts +1 -0
  281. package/dist/templates/starter-game/ui/src/theme.ts +8 -8
  282. package/dist/templates/starter-game/ui/types.ts +6 -0
  283. package/dist/templates/starter-game/ui/ui.sdk.json +1 -1
  284. package/dist/templates/starter-game/validators/daylimit/defaults.ts +13 -0
  285. package/dist/templates/starter-game/validators/daylimit/logic/logic.test.ts +20 -0
  286. package/dist/templates/starter-game/validators/daylimit/logic/logic.ts +23 -0
  287. package/dist/templates/starter-game/validators/daylimit/types.ts +23 -0
  288. package/dist/templates/starter-game/validators/daylimit/validator.sdk.json +10 -0
  289. package/dist/templates/starter-game/waiting_room/src/App.test.tsx +83 -5
  290. package/dist/templates/starter-game/waiting_room/src/App.tsx +262 -119
  291. package/dist/templates/starter-game/waiting_room/src/i18n.ts +8 -4
  292. package/dist/utils/error-codes.d.ts +12 -0
  293. package/dist/utils/prompt.d.ts +5 -5
  294. package/dist/utils/resource-scan.d.ts +39 -0
  295. package/package.json +15 -4
  296. package/dist/templates/starter-game/session/src/Section.tsx +0 -37
  297. package/dist/templates/starter-game/session/src/TeamDoor.tsx +0 -96
  298. package/dist/templates/starter-game/session/src/format.ts +0 -8
  299. package/dist/templates/starter-game/ui/src/HistoryPanel.test.tsx +0 -74
  300. package/dist/templates/starter-game/ui/src/HistoryPanel.tsx +0 -120
  301. package/dist/templates/starter-game/ui/src/HostLogo.test.tsx +0 -25
  302. package/dist/templates/starter-game/ui/src/HostLogo.tsx +0 -38
@@ -0,0 +1,90 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ updateFacilitatorGuideFiles
4
+ } from "./cli-RA673NGF.js";
5
+ import {
6
+ resolvePatchedDefinition
7
+ } from "./cli-UJ4UCL2Z.js";
8
+ import "./cli-S5IVGDDD.js";
9
+ import {
10
+ readAuthoredBundle
11
+ } from "./cli-YVVXUD2G.js";
12
+ import {
13
+ resolveInputSource
14
+ } from "./cli-4UWFQNGF.js";
15
+ import {
16
+ loadPackageContext
17
+ } from "./cli-XSVGKI3R.js";
18
+ import "./cli-MBNMPVDC.js";
19
+ import "./cli-GFBGYFYD.js";
20
+ import {
21
+ operationError,
22
+ printOperationResult
23
+ } from "./cli-UELGBQG7.js";
24
+ import "./cli-4BV45LBH.js";
25
+ import "./cli-4AKVLEC4.js";
26
+ import "./cli-VCKOC2EV.js";
27
+ import "./cli-E2NLWIFE.js";
28
+ import "./cli-25RWY5BQ.js";
29
+ import "./cli-QWQMPCL6.js";
30
+ import {
31
+ validateSDKFacilitatorGuide
32
+ } from "./cli-SMFSZF2G.js";
33
+ import "./cli-F2D4GGUA.js";
34
+ import {
35
+ logger
36
+ } from "./cli-4YB3ROVR.js";
37
+ import {
38
+ CliError
39
+ } from "./cli-N6H6T2E2.js";
40
+
41
+ // cli/commands/resources/guide/update.ts
42
+ async function updateFacilitatorGuide(definitionInput, options) {
43
+ logger.info("\nUpdating facilitator guide...\n");
44
+ const identifier = "guide";
45
+ loadPackageContext(options.workingDir);
46
+ let jsonDefinition = null;
47
+ if (options.patch) {
48
+ jsonDefinition = resolvePatchedDefinition({
49
+ patch: options.patch,
50
+ workingDir: options.workingDir,
51
+ type: "guide",
52
+ identifier,
53
+ resourceLabel: "Facilitator guide"
54
+ });
55
+ } else {
56
+ const inputSource = await resolveInputSource(definitionInput, options.file);
57
+ if (inputSource.kind === "json") jsonDefinition = inputSource.json;
58
+ }
59
+ if (jsonDefinition) {
60
+ const guideInput = readAuthoredBundle({
61
+ json: jsonDefinition,
62
+ type: "guide",
63
+ command: "update",
64
+ validate: validateSDKFacilitatorGuide,
65
+ identifier
66
+ });
67
+ logger.info("Updating facilitator guide files...\n");
68
+ const result = updateFacilitatorGuideFiles({
69
+ packagePath: options.workingDir,
70
+ oldIdentifier: identifier,
71
+ newDefinition: guideInput.definition,
72
+ newIdentifier: guideInput.definition?.identifier
73
+ });
74
+ if (!result.success) {
75
+ throw operationError(result, "Failed to update facilitator guide files");
76
+ }
77
+ logger.success("Facilitator guide updated successfully!");
78
+ printOperationResult(result);
79
+ return;
80
+ }
81
+ throw new CliError(
82
+ "USAGE_MISSING_INPUT",
83
+ `JSON definition or --patch is required for facilitator guide updates.
84
+ Usage: sdk update facilitator-guide <id> '{"definition": {...}}'
85
+ or: sdk update facilitator-guide <id> --patch '[{"op":"replace","path":"/definition/locales/en/name","value":"New Name"}]'`
86
+ );
87
+ }
88
+ export {
89
+ updateFacilitatorGuide
90
+ };
@@ -0,0 +1,16 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ generateCommand
4
+ } from "./cli-4BV45LBH.js";
5
+ import "./cli-4AKVLEC4.js";
6
+ import "./cli-VCKOC2EV.js";
7
+ import "./cli-E2NLWIFE.js";
8
+ import "./cli-25RWY5BQ.js";
9
+ import "./cli-QWQMPCL6.js";
10
+ import "./cli-SMFSZF2G.js";
11
+ import "./cli-F2D4GGUA.js";
12
+ import "./cli-4YB3ROVR.js";
13
+ import "./cli-N6H6T2E2.js";
14
+ export {
15
+ generateCommand
16
+ };
@@ -0,0 +1,101 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ resolveSession
4
+ } from "./cli-GTSGLN3Z.js";
5
+ import "./cli-WU43JT4T.js";
6
+ import {
7
+ raiseIfRefused
8
+ } from "./cli-PFFCNGHI.js";
9
+ import "./cli-LFM7GJHI.js";
10
+ import {
11
+ saveSessionSettingsOverrides
12
+ } from "./cli-C6TH5S7K.js";
13
+ import "./cli-TDSQSCX4.js";
14
+ import {
15
+ readLockFile
16
+ } from "./cli-SRHBXZCN.js";
17
+ import "./cli-GUXKQMJ7.js";
18
+ import "./cli-4LKXZQ2B.js";
19
+ import "./cli-MMN4BPO4.js";
20
+ import {
21
+ resolveInputSource
22
+ } from "./cli-4UWFQNGF.js";
23
+ import "./cli-QUNIRH7A.js";
24
+ import "./cli-E2NLWIFE.js";
25
+ import "./cli-25RWY5BQ.js";
26
+ import "./cli-QWQMPCL6.js";
27
+ import {
28
+ loadConfig,
29
+ settingsSchemas,
30
+ validateSessionOverrides
31
+ } from "./cli-SMFSZF2G.js";
32
+ import "./cli-F2D4GGUA.js";
33
+ import "./cli-4YB3ROVR.js";
34
+ import {
35
+ CliError,
36
+ reportResult
37
+ } from "./cli-N6H6T2E2.js";
38
+
39
+ // cli/commands/configure.ts
40
+ import { resolve, join } from "path";
41
+ async function configureCommand(configJson, options) {
42
+ const packagePath = resolve(options.workingDir);
43
+ const sdkConfig = await loadConfig(join(packagePath, "seriousgaming.sdk.json"));
44
+ const source = await resolveInputSource(configJson, options.file);
45
+ if (source.kind === "none") {
46
+ throw new CliError(
47
+ "USAGE_MISSING_INPUT",
48
+ "Settings must be given as an argument, with --file, or on stdin",
49
+ { hint: `Usage: sdk configure '{"engine": {"BaseDemand": 150}}'` }
50
+ );
51
+ }
52
+ const configurationJson = source.json;
53
+ if (!configurationJson || configurationJson.trim().length === 0) {
54
+ throw new CliError("INPUT_INVALID", "Settings are empty");
55
+ }
56
+ let configuration;
57
+ try {
58
+ configuration = JSON.parse(configurationJson);
59
+ } catch (error) {
60
+ throw new CliError("INPUT_INVALID", `Invalid JSON: ${error.message}`);
61
+ }
62
+ const validationResult = validateSessionOverrides(configuration, settingsSchemas(sdkConfig));
63
+ if (!validationResult.valid) {
64
+ throw new CliError(
65
+ "INPUT_INVALID",
66
+ `Settings validation failed:
67
+ ${validationResult.errors}`
68
+ );
69
+ }
70
+ await saveSessionSettingsOverrides(packagePath, configuration);
71
+ const running = await readLockFile(packagePath);
72
+ const restarted = running ? await restartOnConfiguration(packagePath) : null;
73
+ const message = restarted ? `Settings saved, and the running session restarted on them at tick 0.` : "Settings saved. The next session starts on them.";
74
+ reportResult(
75
+ { message, restarted: restarted !== null, ...restarted },
76
+ () => console.log(`\u2713 ${message}`)
77
+ );
78
+ }
79
+ async function restartOnConfiguration(packagePath) {
80
+ const session = await resolveSession({ packagePath, autoStart: false });
81
+ try {
82
+ const state = await session.state();
83
+ raiseIfRefused(
84
+ await session.send({
85
+ type: "reinitialise",
86
+ teams: state.teams.length,
87
+ scenarioId: state.game.scenarioId,
88
+ locale: state.session.locale
89
+ })
90
+ );
91
+ if ((await session.state()).session.inSetup) {
92
+ raiseIfRefused(await session.send({ type: "play" }));
93
+ }
94
+ return { settings: (await session.state()).settings };
95
+ } finally {
96
+ await session.close();
97
+ }
98
+ }
99
+ export {
100
+ configureCommand
101
+ };
@@ -0,0 +1,50 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ getResourceMeta
4
+ } from "./cli-SMFSZF2G.js";
5
+
6
+ // cli/utils/resource-scan.ts
7
+ import { existsSync, readdirSync } from "fs";
8
+ import { join } from "path";
9
+ function bundlePath(meta, name) {
10
+ if (meta.slot) return `${meta.slot}/${meta.bundleFile}`;
11
+ return `${meta.pluralDir}/${name}/${meta.bundleFile}`;
12
+ }
13
+ function distPath(meta, identifier) {
14
+ if (meta.slot) return meta.slot;
15
+ return `${meta.pluralDir}/${identifier}`;
16
+ }
17
+ function resourceNames(packagePath, meta) {
18
+ if (meta.slot) {
19
+ return existsSync(join(packagePath, meta.slot, meta.bundleFile)) ? [meta.slot] : [];
20
+ }
21
+ const pluralPath = join(packagePath, meta.pluralDir);
22
+ if (!existsSync(pluralPath)) return [];
23
+ return readdirSync(pluralPath, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name).filter((name) => existsSync(join(pluralPath, name, meta.bundleFile))).sort();
24
+ }
25
+ function bundlePaths(packagePath, meta) {
26
+ if (meta.slot) {
27
+ const relPath = bundlePath(meta);
28
+ return existsSync(join(packagePath, relPath)) ? [relPath] : [];
29
+ }
30
+ return resourceNames(packagePath, meta).map((name) => bundlePath(meta, name));
31
+ }
32
+ function slotBundleFile(packagePath, type) {
33
+ const meta = getResourceMeta(type);
34
+ if (!meta.slot) throw new Error(`${meta.label} is not a slot resource`);
35
+ const bundleFile = join(packagePath, meta.slot, meta.bundleFile);
36
+ return existsSync(bundleFile) ? bundleFile : void 0;
37
+ }
38
+ function findBundleFile(packagePath, type, identifier) {
39
+ const meta = getResourceMeta(type);
40
+ if (meta.slot) return slotBundleFile(packagePath, type);
41
+ const bundleFile = join(packagePath, meta.pluralDir, identifier ?? "", meta.bundleFile);
42
+ return existsSync(bundleFile) ? bundleFile : void 0;
43
+ }
44
+
45
+ export {
46
+ distPath,
47
+ resourceNames,
48
+ bundlePaths,
49
+ findBundleFile
50
+ };
@@ -0,0 +1,35 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ resourceNames
4
+ } from "./cli-GFBGYFYD.js";
5
+ import {
6
+ checkbox
7
+ } from "./cli-ZTWOE3ZT.js";
8
+ import {
9
+ getResourceMeta
10
+ } from "./cli-SMFSZF2G.js";
11
+
12
+ // cli/utils/resource-discovery.ts
13
+ function loadResourceIdentifiers(workingDir, type) {
14
+ return resourceNames(workingDir, getResourceMeta(type));
15
+ }
16
+ async function promptForCapabilities(message, availableCapabilities, currentCapabilities = []) {
17
+ if (availableCapabilities.length === 0) {
18
+ console.log("No capabilities available in this package.");
19
+ return [];
20
+ }
21
+ return await checkbox({
22
+ message,
23
+ choices: availableCapabilities.map((cap) => ({
24
+ name: cap,
25
+ value: cap,
26
+ checked: currentCapabilities.includes(cap)
27
+ })),
28
+ pageSize: 15
29
+ });
30
+ }
31
+
32
+ export {
33
+ loadResourceIdentifiers,
34
+ promptForCapabilities
35
+ };
@@ -0,0 +1,307 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ stopLockedServer
4
+ } from "./cli-WU43JT4T.js";
5
+ import {
6
+ PENDING_CHANGES_HINT,
7
+ Session,
8
+ isQuery
9
+ } from "./cli-C6TH5S7K.js";
10
+ import {
11
+ loadEnvironmentConfig
12
+ } from "./cli-TDSQSCX4.js";
13
+ import {
14
+ readLockFile,
15
+ toolsIdentity
16
+ } from "./cli-SRHBXZCN.js";
17
+ import {
18
+ CliError,
19
+ JSON_ENV_VAR,
20
+ isErrorCode,
21
+ recordWarning
22
+ } from "./cli-N6H6T2E2.js";
23
+
24
+ // cli/client/session-client.ts
25
+ import { spawn } from "child_process";
26
+ import { dirname, join, resolve } from "path";
27
+ import { fileURLToPath } from "url";
28
+ var DEV_URL_ENV_VAR = "SERIOUSGAMING_DEV_URL";
29
+ async function resolveSession(options) {
30
+ const packagePath = resolve(options.packagePath);
31
+ const run = options.runKind ?? "session";
32
+ if (options.noServer) return startLocalSession(packagePath, options);
33
+ const named = process.env[DEV_URL_ENV_VAR]?.trim().replace(/\/+$/, "");
34
+ if (named) {
35
+ await relayNotices(named, run, {
36
+ hint: `${DEV_URL_ENV_VAR} names ${named}. Unset it to use this package's own dev server.`
37
+ });
38
+ return connect(named, run);
39
+ }
40
+ const running = await readLockFile(packagePath);
41
+ if (running) {
42
+ const mismatch = toolsMismatch(running);
43
+ if (mismatch === null) {
44
+ const url2 = `http://localhost:${running.port}`;
45
+ await relayNotices(url2, run);
46
+ return connect(url2, run);
47
+ }
48
+ if (!running.background || options.autoStart === false) {
49
+ throw new CliError(
50
+ "SESSION_STALE",
51
+ `The dev server running for this package (pid ${running.pid}) was started by different tools: ${mismatch}. Its answers may not match what is on disk.`,
52
+ {
53
+ hint: "Stop it with `sdk dev stop`, then start `sdk dev` again or rerun the command."
54
+ }
55
+ );
56
+ }
57
+ await stopLockedServer(packagePath, running);
58
+ const message = `The background dev server for this package was started by different tools (${mismatch}), so it was stopped and a fresh one started. Its session did not carry over.`;
59
+ recordWarning(message, "SESSION_RESTARTED");
60
+ console.error(`Warning: ${message}`);
61
+ }
62
+ if (options.autoStart === false) {
63
+ throw new CliError(
64
+ "NO_SESSION",
65
+ "No dev server is running for this package.\nStart one with `sdk dev`, or pass --no-server to run this command on its own."
66
+ );
67
+ }
68
+ const url = await startBackgroundServer(packagePath, options);
69
+ const session = connect(url, run);
70
+ if ((await session.state()).session.inSetup) {
71
+ await session.send({ type: "play" });
72
+ }
73
+ await relayNotices(url, run);
74
+ return session;
75
+ }
76
+ function toolsMismatch(lock) {
77
+ const mine = toolsIdentity();
78
+ if (lock.toolsVersion !== mine.version) {
79
+ return `version ${lock.toolsVersion ?? "unknown"}, where this CLI is ${mine.version}`;
80
+ }
81
+ if (lock.toolsPath !== mine.path) {
82
+ return `${lock.toolsPath ?? "an unknown install"}, where this CLI is ${mine.path}`;
83
+ }
84
+ return null;
85
+ }
86
+ async function relayNotices(url, run, unreachable) {
87
+ const query = run === "walkthrough" ? "?run=walkthrough" : "";
88
+ let notices = [];
89
+ try {
90
+ const response = await fetch(`${url}/api/session${query}`);
91
+ const body = await response.json();
92
+ notices = Array.isArray(body.warnings) ? body.warnings : [];
93
+ } catch (error) {
94
+ if (!unreachable) return;
95
+ throw new CliError(
96
+ "DEV_SERVER_UNREACHABLE",
97
+ `The dev server at ${url} did not answer: ${error instanceof Error ? error.message : String(error)}`,
98
+ { hint: unreachable.hint }
99
+ );
100
+ }
101
+ for (const notice of notices) {
102
+ recordWarning(notice.message, notice.code);
103
+ console.error(
104
+ notice.code === "SETTINGS_STALE" ? `Warning: ${notice.message}.
105
+ ${PENDING_CHANGES_HINT}` : `Warning: ${notice.message}`
106
+ );
107
+ }
108
+ }
109
+ function connectSession(url, run = "session") {
110
+ return connect(url, run);
111
+ }
112
+ function connect(url, run) {
113
+ const query = run === "walkthrough" ? "?run=walkthrough" : "";
114
+ return {
115
+ url,
116
+ ephemeral: false,
117
+ async send(command) {
118
+ const response = await reach(url, `${url}/api/command${query}`, {
119
+ method: "POST",
120
+ headers: { "Content-Type": "application/json" },
121
+ body: JSON.stringify(command)
122
+ });
123
+ if (!response.ok) {
124
+ const body = await response.json().catch(() => ({}));
125
+ const message = body.error ?? `The session refused the command (HTTP ${response.status})`;
126
+ throw response.status === 400 ? new CliError("DEV_SERVER_OUTDATED", message, { hint: OUTDATED_HINT }) : new CliError("SESSION_ERROR", message);
127
+ }
128
+ return await response.json();
129
+ },
130
+ async state() {
131
+ const response = await reach(url, `${url}/api/state${query}`);
132
+ if (!response.ok) {
133
+ throw new CliError(
134
+ "DEV_SERVER_OUTDATED",
135
+ `Could not read the session state (HTTP ${response.status})`,
136
+ { hint: OUTDATED_HINT }
137
+ );
138
+ }
139
+ return await response.json();
140
+ },
141
+ async close() {
142
+ }
143
+ };
144
+ }
145
+ var OUTDATED_HINT = "Restart the dev server: `sdk dev stop`, then run the command again.";
146
+ async function reach(url, input, init) {
147
+ try {
148
+ return await fetch(input, init);
149
+ } catch (error) {
150
+ throw new CliError(
151
+ "DEV_SERVER_UNREACHABLE",
152
+ `The dev server at ${url} did not answer: ${error instanceof Error ? error.message : String(error)}`,
153
+ {
154
+ hint: "If it has stopped, run `sdk dev stop` (or remove .seriousgaming-sdk/session.json), then try again."
155
+ }
156
+ );
157
+ }
158
+ }
159
+ async function startLocalSession(packagePath, options) {
160
+ const environment = loadEnvironmentConfig(packagePath);
161
+ const session = new Session({
162
+ packagePath,
163
+ ...options.runKind === void 0 ? {} : { runKind: options.runKind },
164
+ ...options.teams === void 0 ? {} : { teams: options.teams },
165
+ ...options.participants === void 0 ? {} : { participants: options.participants },
166
+ ...options.scenarioId === void 0 ? {} : { scenarioId: options.scenarioId },
167
+ ...options.locale === void 0 ? {} : { locale: options.locale },
168
+ ...environment.seriousGamingApiKey === void 0 ? {} : { seriousGamingApiKey: environment.seriousGamingApiKey },
169
+ ...environment.seriousGamingApiHost === void 0 ? {} : { seriousGamingApiHost: environment.seriousGamingApiHost },
170
+ ...environment.elevenLabsApiKey === void 0 ? {} : { elevenLabsApiKey: environment.elevenLabsApiKey }
171
+ });
172
+ try {
173
+ await session.start();
174
+ } catch (error) {
175
+ if (error instanceof CliError) throw error;
176
+ throw new CliError(
177
+ "SESSION_ERROR",
178
+ `The session could not start: ${error instanceof Error ? error.message : String(error)}`,
179
+ { cause: error }
180
+ );
181
+ }
182
+ if (session.inSetup) await session.submit({ type: "play" });
183
+ return {
184
+ url: null,
185
+ ephemeral: true,
186
+ async send(command) {
187
+ return isQuery(command) ? session.query(command) : session.submit(command);
188
+ },
189
+ async state() {
190
+ return session.project();
191
+ },
192
+ async close() {
193
+ await session.stop();
194
+ }
195
+ };
196
+ }
197
+ var START_TIMEOUT_MS = 12e4;
198
+ async function startBackgroundServer(packagePath, options) {
199
+ const entry = cliEntryPoint();
200
+ const args = [
201
+ ...entry.argv,
202
+ "dev",
203
+ "--no-open",
204
+ // So a failed start says why with a code, which this command reports
205
+ // as its own (an invalid package fails here with exit 3, not 5).
206
+ "--json",
207
+ // Recorded in its lock, so a later command from other tools may
208
+ // replace it rather than refusing.
209
+ "--background",
210
+ "-w",
211
+ packagePath,
212
+ ...options.teams === void 0 ? [] : ["--teams", String(options.teams)],
213
+ ...options.participants === void 0 ? [] : ["--participants", [options.participants].flat().join(",")],
214
+ ...typeof options.scenarioId === "string" ? ["--scenario", options.scenarioId] : []
215
+ ];
216
+ const environment = { ...process.env };
217
+ delete environment[JSON_ENV_VAR];
218
+ const child = spawn(entry.command, args, {
219
+ detached: true,
220
+ stdio: ["ignore", "pipe", "pipe"],
221
+ env: environment
222
+ });
223
+ let output = "";
224
+ let envelope = "";
225
+ child.stdout?.on("data", (chunk) => {
226
+ envelope += chunk.toString();
227
+ });
228
+ child.stderr?.on("data", (chunk) => {
229
+ output += chunk.toString();
230
+ });
231
+ let exited = null;
232
+ child.once("close", (code) => {
233
+ exited = { code };
234
+ });
235
+ const deadline = Date.now() + START_TIMEOUT_MS;
236
+ while (Date.now() < deadline) {
237
+ const lock = await readLockFile(packagePath, { unresponsive: "accept" });
238
+ if (lock) {
239
+ const url = `http://localhost:${lock.port}`;
240
+ if (await reachable(url)) {
241
+ child.stdout?.destroy();
242
+ child.stderr?.destroy();
243
+ child.unref();
244
+ announce(url);
245
+ return url;
246
+ }
247
+ }
248
+ if (exited) throw startFailure(envelope, output);
249
+ await pause(100);
250
+ }
251
+ child.kill();
252
+ throw new CliError(
253
+ "DEV_SERVER_START_FAILED",
254
+ "Timed out starting a dev server for this package.\nStart one yourself with `sdk dev`, or pass --no-server to run without one."
255
+ );
256
+ }
257
+ function startFailure(envelope, output) {
258
+ try {
259
+ const parsed = JSON.parse(envelope);
260
+ if (parsed.ok === false && isErrorCode(parsed.error.code)) {
261
+ return new CliError(
262
+ parsed.error.code,
263
+ `The dev server could not start: ${parsed.error.message}`,
264
+ {
265
+ ...parsed.error.hint === void 0 ? {} : { hint: parsed.error.hint },
266
+ ...parsed.error.details === void 0 ? {} : { details: parsed.error.details },
267
+ diagnostics: parsed.diagnostics
268
+ }
269
+ );
270
+ }
271
+ } catch {
272
+ }
273
+ return new CliError(
274
+ "DEV_SERVER_START_FAILED",
275
+ `The dev server could not start.
276
+
277
+ ${(output + envelope).trim() || "(it exited silently)"}`
278
+ );
279
+ }
280
+ function announce(url) {
281
+ console.error(
282
+ `No dev server was running, so this command started one at ${url}.
283
+ It stays up for the next command: stop it with \`sdk dev stop\`, or pass --no-server to run without one.
284
+ `
285
+ );
286
+ }
287
+ function cliEntryPoint() {
288
+ const here = dirname(fileURLToPath(import.meta.url));
289
+ const fromSource = here.includes(join("cli", "client"));
290
+ const loader = process.argv[1];
291
+ return fromSource ? { command: process.execPath, argv: [loader, resolve(here, "..", "cli.ts"), "--"] } : { command: process.execPath, argv: [loader] };
292
+ }
293
+ async function reachable(url) {
294
+ try {
295
+ return (await fetch(`${url}/api/state`)).ok;
296
+ } catch {
297
+ return false;
298
+ }
299
+ }
300
+ function pause(ms) {
301
+ return new Promise((resolve_) => setTimeout(resolve_, ms));
302
+ }
303
+
304
+ export {
305
+ resolveSession,
306
+ connectSession
307
+ };