@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,367 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ confirm,
4
+ input,
5
+ select
6
+ } from "./cli-ZTWOE3ZT.js";
7
+
8
+ // cli/prompts/validators.ts
9
+ var PASCAL_CASE_PATTERN = /^[A-Z][a-zA-Z0-9]*$/;
10
+ function validatePropertyName(name, existingNames) {
11
+ if (!name.trim()) {
12
+ return "Property name is required";
13
+ }
14
+ if (!PASCAL_CASE_PATTERN.test(name.trim())) {
15
+ return "Property name must be in PascalCase (start with uppercase letter, no spaces or special characters)";
16
+ }
17
+ if (existingNames.includes(name.trim())) {
18
+ return "A property with this name already exists";
19
+ }
20
+ return true;
21
+ }
22
+ function validateNumberValue(value, constraints) {
23
+ if (isNaN(Number(value))) {
24
+ return "Value must be a valid number";
25
+ }
26
+ const numValue = Number(value);
27
+ if (constraints?.min !== void 0 && numValue < constraints.min) {
28
+ return `Value must be greater than or equal to ${constraints.min}`;
29
+ }
30
+ if (constraints?.max !== void 0 && numValue > constraints.max) {
31
+ return `Value must be less than or equal to ${constraints.max}`;
32
+ }
33
+ return true;
34
+ }
35
+ function validateMaximumValue(maximum, minimum) {
36
+ const baseValidation = validateNumberValue(maximum);
37
+ if (baseValidation !== true) {
38
+ return baseValidation;
39
+ }
40
+ if (minimum !== void 0 && Number(maximum) < minimum) {
41
+ return "Maximum must be greater than or equal to minimum";
42
+ }
43
+ return true;
44
+ }
45
+
46
+ // cli/prompts/schema-builder.ts
47
+ async function promptNumberProperties(currentDefaults) {
48
+ const defaultValue = await input({
49
+ message: "Default value (number):",
50
+ default: currentDefaults?.default !== void 0 ? String(currentDefaults.default) : "0",
51
+ validate: (value) => validateNumberValue(value)
52
+ });
53
+ const defaults = {
54
+ default: Number(defaultValue)
55
+ };
56
+ const currentHasMin = currentDefaults?.minimum !== void 0;
57
+ const hasMinimum = await confirm({
58
+ message: "Add minimum value constraint?",
59
+ default: currentHasMin
60
+ });
61
+ if (hasMinimum) {
62
+ const minimum = await input({
63
+ message: "Minimum value:",
64
+ default: currentHasMin ? String(currentDefaults.minimum) : "",
65
+ validate: (value) => validateNumberValue(value)
66
+ });
67
+ defaults.minimum = Number(minimum);
68
+ }
69
+ const currentHasMax = currentDefaults?.maximum !== void 0;
70
+ const hasMaximum = await confirm({
71
+ message: "Add maximum value constraint?",
72
+ default: currentHasMax
73
+ });
74
+ if (hasMaximum) {
75
+ const maximum = await input({
76
+ message: "Maximum value:",
77
+ default: currentHasMax ? String(currentDefaults.maximum) : "",
78
+ validate: (value) => validateMaximumValue(value, defaults.minimum)
79
+ });
80
+ defaults.maximum = Number(maximum);
81
+ }
82
+ return defaults;
83
+ }
84
+ async function promptStringProperties(currentDefaults) {
85
+ const defaultValue = await input({
86
+ message: "Default value (string):",
87
+ default: currentDefaults?.default ?? ""
88
+ });
89
+ return { default: defaultValue };
90
+ }
91
+ async function promptBooleanProperties(currentDefaults) {
92
+ const defaultValue = await confirm({
93
+ message: "Default value:",
94
+ default: currentDefaults?.default ?? false
95
+ });
96
+ return { default: defaultValue };
97
+ }
98
+ var CONTEXT_COPY = {
99
+ variable: {
100
+ label: "Variable",
101
+ singular: "variable",
102
+ plural: "variables",
103
+ intro: "Variables define the state this capability holds."
104
+ },
105
+ setting: {
106
+ label: "Setting",
107
+ singular: "setting",
108
+ plural: "settings",
109
+ intro: "Settings are the values a game plays with, which scenarios can override."
110
+ },
111
+ property: { label: "Property", singular: "property", plural: "properties" }
112
+ };
113
+ async function promptForSchemaProperty(options) {
114
+ const contextLabel = CONTEXT_COPY[options.context || "variable"].label;
115
+ const propertyName = await input({
116
+ message: `${contextLabel} name (PascalCase, e.g., "Price", "TotalCost"):`,
117
+ validate: (value) => validatePropertyName(value, options.existingNames)
118
+ });
119
+ const propertyType = await select({
120
+ message: `${contextLabel} type:`,
121
+ choices: [
122
+ { name: "Number", value: "number" },
123
+ { name: "String", value: "string" },
124
+ { name: "Boolean", value: "boolean" }
125
+ ]
126
+ });
127
+ const propertyDescription = await input({
128
+ message: `${contextLabel} description:`,
129
+ validate: (value) => {
130
+ if (!value.trim()) {
131
+ return "Description is required";
132
+ }
133
+ return true;
134
+ }
135
+ });
136
+ const propertySchema = {
137
+ type: propertyType,
138
+ description: propertyDescription
139
+ };
140
+ if (propertyType === "number") {
141
+ const numberDefaults = await promptNumberProperties();
142
+ propertySchema.default = numberDefaults.default;
143
+ if (numberDefaults.minimum !== void 0) {
144
+ propertySchema.minimum = numberDefaults.minimum;
145
+ }
146
+ if (numberDefaults.maximum !== void 0) {
147
+ propertySchema.maximum = numberDefaults.maximum;
148
+ }
149
+ } else if (propertyType === "string") {
150
+ const stringDefaults = await promptStringProperties();
151
+ propertySchema.default = stringDefaults.default;
152
+ } else if (propertyType === "boolean") {
153
+ const booleanDefaults = await promptBooleanProperties();
154
+ propertySchema.default = booleanDefaults.default;
155
+ }
156
+ return {
157
+ name: propertyName.trim(),
158
+ schema: propertySchema
159
+ };
160
+ }
161
+ async function promptForSchemaProperties(options = {}) {
162
+ const context = options.context || "variable";
163
+ const copy = CONTEXT_COPY[context];
164
+ const properties = {
165
+ ...options.existingProperties
166
+ };
167
+ const existingNames = Object.keys(properties);
168
+ if (existingNames.length === 0) {
169
+ console.log(`Now let's add ${copy.plural}.`);
170
+ if (copy.intro) console.log(`${copy.intro}
171
+ `);
172
+ }
173
+ let addingProperties = true;
174
+ while (addingProperties) {
175
+ const result = await promptForSchemaProperty({
176
+ existingNames: Object.keys(properties),
177
+ context
178
+ });
179
+ if (result) {
180
+ properties[result.name] = result.schema;
181
+ console.log(`
182
+ \u2713 Added ${copy.singular}: ${result.name} (${result.schema.type})
183
+ `);
184
+ }
185
+ if (options.minProperties !== void 0 && Object.keys(properties).length < options.minProperties) {
186
+ console.log(`At least ${options.minProperties} ${copy.plural} required.
187
+ `);
188
+ continue;
189
+ }
190
+ addingProperties = await confirm({
191
+ message: `Add another ${copy.singular}?`,
192
+ default: Object.keys(properties).length === 0
193
+ });
194
+ if (addingProperties) {
195
+ console.log("");
196
+ }
197
+ }
198
+ return properties;
199
+ }
200
+ async function editSchemaProperty(name, currentSchema) {
201
+ const modifiedChanges = [];
202
+ const newDescription = await input({
203
+ message: "Property description:",
204
+ default: currentSchema.description || "",
205
+ validate: (value) => {
206
+ if (!value.trim()) {
207
+ return "Description is required";
208
+ }
209
+ return true;
210
+ }
211
+ });
212
+ const editedSchema = {
213
+ type: currentSchema.type,
214
+ description: newDescription
215
+ };
216
+ if (newDescription !== currentSchema.description) {
217
+ modifiedChanges.push("description");
218
+ }
219
+ if (currentSchema.type === "number") {
220
+ const numberDefaults = await promptNumberProperties({
221
+ default: currentSchema.default,
222
+ minimum: currentSchema.minimum,
223
+ maximum: currentSchema.maximum
224
+ });
225
+ editedSchema.default = numberDefaults.default;
226
+ if (numberDefaults.default !== currentSchema.default) {
227
+ modifiedChanges.push("default");
228
+ }
229
+ if (numberDefaults.minimum !== void 0) {
230
+ editedSchema.minimum = numberDefaults.minimum;
231
+ if (numberDefaults.minimum !== currentSchema.minimum) {
232
+ modifiedChanges.push("minimum");
233
+ }
234
+ } else if (currentSchema.minimum !== void 0) {
235
+ modifiedChanges.push("minimum removed");
236
+ }
237
+ if (numberDefaults.maximum !== void 0) {
238
+ editedSchema.maximum = numberDefaults.maximum;
239
+ if (numberDefaults.maximum !== currentSchema.maximum) {
240
+ modifiedChanges.push("maximum");
241
+ }
242
+ } else if (currentSchema.maximum !== void 0) {
243
+ modifiedChanges.push("maximum removed");
244
+ }
245
+ } else if (currentSchema.type === "string") {
246
+ const stringDefaults = await promptStringProperties({
247
+ default: currentSchema.default
248
+ });
249
+ editedSchema.default = stringDefaults.default;
250
+ if (stringDefaults.default !== currentSchema.default) {
251
+ modifiedChanges.push("default");
252
+ }
253
+ } else if (currentSchema.type === "boolean") {
254
+ const booleanDefaults = await promptBooleanProperties({
255
+ default: currentSchema.default
256
+ });
257
+ editedSchema.default = booleanDefaults.default;
258
+ if (booleanDefaults.default !== currentSchema.default) {
259
+ modifiedChanges.push("default");
260
+ }
261
+ }
262
+ if (modifiedChanges.length > 0) {
263
+ return {
264
+ action: "edit",
265
+ schema: editedSchema,
266
+ changes: modifiedChanges
267
+ };
268
+ } else {
269
+ return {
270
+ action: "keep",
271
+ schema: currentSchema,
272
+ changes: []
273
+ };
274
+ }
275
+ }
276
+ async function reviewSchemaProperties(existingProperties, options = {}) {
277
+ const newProperties = {};
278
+ const changes = {
279
+ kept: [],
280
+ modified: [],
281
+ deleted: [],
282
+ added: []
283
+ };
284
+ const existingEntries = Object.entries(existingProperties);
285
+ if (existingEntries.length > 0) {
286
+ console.log("Let's review your existing properties.\n");
287
+ for (const [propName, propSchema] of existingEntries) {
288
+ console.log(`Property: ${propName}`);
289
+ console.log(` Type: ${propSchema.type}`);
290
+ console.log(` Description: ${propSchema.description || "(none)"}`);
291
+ if (propSchema.default !== void 0) {
292
+ console.log(` Default: ${propSchema.default}`);
293
+ }
294
+ if (propSchema.minimum !== void 0) {
295
+ console.log(` Minimum: ${propSchema.minimum}`);
296
+ }
297
+ if (propSchema.maximum !== void 0) {
298
+ console.log(` Maximum: ${propSchema.maximum}`);
299
+ }
300
+ console.log("");
301
+ const actionChoices = [
302
+ { name: "Keep unchanged", value: "keep" },
303
+ { name: "Edit", value: "edit" }
304
+ ];
305
+ if (options.allowDelete) {
306
+ actionChoices.push({ name: "Delete", value: "delete" });
307
+ }
308
+ const action = await select({
309
+ message: `What do you want to do with "${propName}"?`,
310
+ choices: actionChoices
311
+ });
312
+ if (action === "keep") {
313
+ newProperties[propName] = propSchema;
314
+ changes.kept.push(propName);
315
+ console.log(`\u2713 Keeping ${propName} unchanged
316
+ `);
317
+ } else if (action === "delete") {
318
+ changes.deleted.push(propName);
319
+ console.log(`\u2713 Will delete ${propName}
320
+ `);
321
+ } else {
322
+ const result = await editSchemaProperty(propName, propSchema);
323
+ newProperties[propName] = result.schema;
324
+ if (result.changes && result.changes.length > 0) {
325
+ changes.modified.push({
326
+ name: propName,
327
+ changes: result.changes.join(", ")
328
+ });
329
+ console.log(`\u2713 Modified ${propName} (${result.changes.join(", ")})
330
+ `);
331
+ } else {
332
+ changes.kept.push(propName);
333
+ console.log(`\u2713 No changes to ${propName}
334
+ `);
335
+ }
336
+ }
337
+ }
338
+ }
339
+ if (options.allowAdd) {
340
+ const addNew = await confirm({
341
+ message: "Add new properties?",
342
+ default: false
343
+ });
344
+ if (addNew) {
345
+ console.log("");
346
+ const newProps = await promptForSchemaProperties({
347
+ existingProperties: newProperties,
348
+ context: options.context
349
+ });
350
+ for (const propName of Object.keys(newProps)) {
351
+ if (!newProperties[propName]) {
352
+ changes.added.push(propName);
353
+ }
354
+ newProperties[propName] = newProps[propName];
355
+ }
356
+ }
357
+ }
358
+ return {
359
+ properties: newProperties,
360
+ changes
361
+ };
362
+ }
363
+
364
+ export {
365
+ promptForSchemaProperties,
366
+ reviewSchemaProperties
367
+ };
@@ -0,0 +1,32 @@
1
+ #!/usr/bin/env node
2
+
3
+ // cli/utils/json-patch.ts
4
+ import * as rfc6902 from "rfc6902";
5
+ function applyJsonPatch(obj, operations) {
6
+ let result = structuredClone(obj);
7
+ const realmSafeOperations = structuredClone(operations);
8
+ try {
9
+ const errors = rfc6902.applyPatch(result, realmSafeOperations);
10
+ if (errors && errors.length > 0) {
11
+ const actualErrors = errors.filter((e) => e !== null);
12
+ if (actualErrors.length > 0) {
13
+ const errorMessages = actualErrors.map((e) => e?.message || String(e)).join("; ");
14
+ throw new Error(`Patch failed: ${errorMessages}`);
15
+ }
16
+ }
17
+ return result;
18
+ } catch (error) {
19
+ const message = error.message;
20
+ if (message.includes("out of range")) {
21
+ throw new Error("Array index out of range");
22
+ }
23
+ if (message.includes("undefined") || message.includes("Cannot read")) {
24
+ throw new Error("Path does not exist");
25
+ }
26
+ throw error;
27
+ }
28
+ }
29
+
30
+ export {
31
+ applyJsonPatch
32
+ };
@@ -0,0 +1,218 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ guessMimeType
4
+ } from "./cli-2BH7FX27.js";
5
+ import {
6
+ resolveSession
7
+ } from "./cli-GTSGLN3Z.js";
8
+ import "./cli-WU43JT4T.js";
9
+ import {
10
+ blobLinks
11
+ } from "./cli-BWX5E7TQ.js";
12
+ import {
13
+ OUTCOME_CODES,
14
+ emit,
15
+ environmentHint,
16
+ logicDiagnostic,
17
+ staleError,
18
+ staleOf,
19
+ teamIndexFromArgument
20
+ } from "./cli-PFFCNGHI.js";
21
+ import "./cli-LFM7GJHI.js";
22
+ import "./cli-C6TH5S7K.js";
23
+ import "./cli-TDSQSCX4.js";
24
+ import "./cli-SRHBXZCN.js";
25
+ import "./cli-GUXKQMJ7.js";
26
+ import "./cli-4LKXZQ2B.js";
27
+ import "./cli-MMN4BPO4.js";
28
+ import {
29
+ resolveInputSource
30
+ } from "./cli-4UWFQNGF.js";
31
+ import "./cli-QUNIRH7A.js";
32
+ import {
33
+ logicErrorOf
34
+ } from "./cli-E2NLWIFE.js";
35
+ import "./cli-25RWY5BQ.js";
36
+ import {
37
+ readBlob
38
+ } from "./cli-QWQMPCL6.js";
39
+ import "./cli-SMFSZF2G.js";
40
+ import "./cli-F2D4GGUA.js";
41
+ import "./cli-4YB3ROVR.js";
42
+ import {
43
+ CliError
44
+ } from "./cli-N6H6T2E2.js";
45
+
46
+ // cli/commands/endpoint-call.ts
47
+ import { existsSync } from "fs";
48
+ import { mkdir, readFile, writeFile } from "fs/promises";
49
+ import { basename, join, resolve } from "path";
50
+ function describeStep(step) {
51
+ switch (step.kind) {
52
+ case "capabilities":
53
+ return "its write";
54
+ case "teams":
55
+ return `its write to team "${step.teamId}"`;
56
+ case "action":
57
+ return `action ${step.index} ("${step.type}")`;
58
+ }
59
+ }
60
+ function describeEndpointFailure(identifier, failure) {
61
+ const { outcome, applied, failedStep } = failure;
62
+ const message = "message" in outcome && outcome.message ? `: ${outcome.message}` : "";
63
+ const lines = [`Endpoint "${identifier}" failed (${outcome.kind})${message}`];
64
+ lines.push(
65
+ applied.length === 0 ? "Nothing was applied." : `Applied before the failure: ${applied.map(describeStep).join(", ")}`
66
+ );
67
+ if (failedStep) lines.push(`Failed at: ${describeStep(failedStep)}`);
68
+ return lines.join("\n");
69
+ }
70
+ var ENDPOINT_CODES = {
71
+ "invalid-request": "INVALID_REQUEST",
72
+ "handler-error": "HANDLER_ERROR",
73
+ "invalid-response": "INVALID_RESPONSE"
74
+ };
75
+ function endpointFailureCode(failure) {
76
+ const kind = failure.outcome.kind;
77
+ return kind in ENDPOINT_CODES ? ENDPOINT_CODES[kind] : OUTCOME_CODES[kind];
78
+ }
79
+ function parsePrincipal(value) {
80
+ const [kind, id, ...rest] = value.split(":");
81
+ if (!kind || !id) {
82
+ throw new CliError(
83
+ "USAGE_BAD_FLAG",
84
+ `--principal takes kind:id or kind:id:name, e.g. agent:claude-7:Claude (got "${value}")`
85
+ );
86
+ }
87
+ return { kind, id, ...rest.length > 0 ? { name: rest.join(":") } : {} };
88
+ }
89
+ async function attachFiles(request, attachments, workingDir) {
90
+ if (attachments.length === 0) return request;
91
+ if (typeof request !== "object" || request === null || Array.isArray(request)) {
92
+ throw new CliError("INPUT_INVALID", "--attach needs the request to be a JSON object");
93
+ }
94
+ const result = structuredClone(request);
95
+ for (const attachment of attachments) {
96
+ const split = attachment.indexOf("=");
97
+ if (split <= 0) {
98
+ throw new CliError("USAGE_BAD_FLAG", `--attach takes field=path (got "${attachment}")`);
99
+ }
100
+ const field = attachment.slice(0, split);
101
+ const path = resolve(workingDir, attachment.slice(split + 1));
102
+ if (!existsSync(path))
103
+ throw new CliError("FILE_NOT_FOUND", `--attach: file not found: ${path}`);
104
+ const name = basename(path);
105
+ const uri = `data:${guessMimeType(name)};name=${encodeURIComponent(name)};base64,` + (await readFile(path)).toString("base64");
106
+ const keys = field.split(".");
107
+ let target = result;
108
+ for (const key of keys.slice(0, -1)) {
109
+ const next = target[key];
110
+ target[key] = typeof next === "object" && next !== null ? next : {};
111
+ target = target[key];
112
+ }
113
+ target[keys[keys.length - 1]] = uri;
114
+ }
115
+ return result;
116
+ }
117
+ async function saveBlobs(response, dir, workingDir) {
118
+ const references = Object.keys(blobLinks(response, (id) => id));
119
+ if (references.length === 0) {
120
+ console.error("The response names no blobs to save.");
121
+ return;
122
+ }
123
+ const target = resolve(workingDir, dir);
124
+ await mkdir(target, { recursive: true });
125
+ const taken = /* @__PURE__ */ new Set();
126
+ for (const reference of references) {
127
+ const blob = await readBlob(workingDir, reference.slice("blob:".length));
128
+ let name = basename(blob.name) || "blob";
129
+ for (let n = 2; taken.has(name); n += 1) name = `${n}-${basename(blob.name)}`;
130
+ taken.add(name);
131
+ await writeFile(join(target, name), blob.data);
132
+ console.error(`Saved ${reference} to ${join(target, name)}`);
133
+ }
134
+ }
135
+ async function endpointCallCommand(identifier, options) {
136
+ const source = await resolveInputSource(options.request, options.file);
137
+ let request = {};
138
+ if (source.kind === "json") {
139
+ try {
140
+ request = JSON.parse(source.json);
141
+ } catch (error) {
142
+ throw new CliError(
143
+ "INPUT_INVALID",
144
+ `The request is not valid JSON
145
+ ` + (error instanceof Error ? error.message : "Unknown error")
146
+ );
147
+ }
148
+ }
149
+ if (options.principal !== void 0 && !options.external) {
150
+ throw new CliError(
151
+ "USAGE_BAD_FLAG",
152
+ "--principal stands in for the identity a platform vouches for on a call from outside the game, so it needs --external"
153
+ );
154
+ }
155
+ const principal = options.principal === void 0 ? void 0 : parsePrincipal(options.principal);
156
+ if (options.draft !== void 0 && options.team !== void 0) {
157
+ throw new CliError(
158
+ "USAGE_BAD_FLAG",
159
+ "--team names a team in the session, and a scenario draft has none, so it cannot go with --draft"
160
+ );
161
+ }
162
+ const scenarioId = options.draft === void 0 || options.draft === false ? void 0 : options.draft === true ? null : options.draft;
163
+ request = await attachFiles(request, options.attach ?? [], options.workingDir);
164
+ const session = await resolveSession({
165
+ packagePath: options.workingDir,
166
+ ...options.walkthrough ? { runKind: "walkthrough" } : {},
167
+ ...options.server === false ? { noServer: true } : {}
168
+ });
169
+ try {
170
+ const state = await session.state();
171
+ const teamIndex = teamIndexFromArgument(state, options.team);
172
+ const result = await session.send({
173
+ type: "callEndpoint",
174
+ endpointIdentifier: identifier,
175
+ request,
176
+ // Unless it stands in for an outside caller, the caller is the
177
+ // terminal, not a surface, so it names none (§6.12).
178
+ ...options.external ? { external: true } : {},
179
+ ...principal ? { principal } : {},
180
+ ...teamIndex === void 0 ? {} : { teamIndex },
181
+ ...scenarioId === void 0 ? {} : { scenarioId }
182
+ });
183
+ if ("type" in result && result.type === "endpointFailure") {
184
+ const stale = staleOf(result);
185
+ if (stale) throw staleError(stale);
186
+ const logicError = logicErrorOf(result);
187
+ throw new CliError(
188
+ logicError?.errorCode ?? endpointFailureCode(result.failure),
189
+ describeEndpointFailure(identifier, result.failure),
190
+ {
191
+ ...environmentHint(logicError),
192
+ details: { ...result.failure },
193
+ diagnostics: logicError ? [logicDiagnostic(logicError)] : []
194
+ }
195
+ );
196
+ }
197
+ if (!("type" in result) || result.type !== "endpoint") {
198
+ throw new CliError(
199
+ "DEV_SERVER_OUTDATED",
200
+ `Endpoint "${identifier}" returned no response`
201
+ );
202
+ }
203
+ emit(result.response);
204
+ for (const [reference, url] of Object.entries(result.blobs ?? {})) {
205
+ console.error(`${reference} ${url}`);
206
+ }
207
+ if (options.saveBlobs !== void 0) {
208
+ await saveBlobs(result.response, options.saveBlobs, options.workingDir);
209
+ }
210
+ } finally {
211
+ await session.close();
212
+ }
213
+ }
214
+ export {
215
+ describeEndpointFailure,
216
+ endpointCallCommand,
217
+ endpointFailureCode
218
+ };
@@ -0,0 +1,36 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ deleteSettingsEditor
4
+ } from "./cli-AK7OIPWY.js";
5
+ import "./cli-GGPDQNM3.js";
6
+ import "./cli-UJ4UCL2Z.js";
7
+ import "./cli-S5IVGDDD.js";
8
+ import "./cli-YVVXUD2G.js";
9
+ import "./cli-4UWFQNGF.js";
10
+ import "./cli-FYINNRML.js";
11
+ import "./cli-IUS2YCD3.js";
12
+ import "./cli-QUNIRH7A.js";
13
+ import "./cli-BYJWFFCF.js";
14
+ import "./cli-XSVGKI3R.js";
15
+ import "./cli-MBNMPVDC.js";
16
+ import "./cli-GFBGYFYD.js";
17
+ import "./cli-UELGBQG7.js";
18
+ import "./cli-ZTWOE3ZT.js";
19
+ import "./cli-4BV45LBH.js";
20
+ import "./cli-4AKVLEC4.js";
21
+ import "./cli-VCKOC2EV.js";
22
+ import "./cli-E2NLWIFE.js";
23
+ import "./cli-25RWY5BQ.js";
24
+ import "./cli-QWQMPCL6.js";
25
+ import "./cli-SMFSZF2G.js";
26
+ import "./cli-F2D4GGUA.js";
27
+ import "./cli-4YB3ROVR.js";
28
+ import "./cli-N6H6T2E2.js";
29
+
30
+ // cli/commands/resources/scenario-editor/delete.ts
31
+ function deleteScenarioEditor(options) {
32
+ return deleteSettingsEditor("scenario_editor", options);
33
+ }
34
+ export {
35
+ deleteScenarioEditor
36
+ };