@seriousgaming/sdk-tools 1.7.0 → 1.8.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 (187) hide show
  1. package/dist/agent/guidance.md +1 -0
  2. package/dist/{cli-ZTZ5H55T.js → cli-27M4PX7O.js} +17 -17
  3. package/dist/{cli-2BH7FX27.js → cli-2FXZZLCL.js} +1 -1
  4. package/dist/{cli-HHPMAV4F.js → cli-2KDV2DYC.js} +3 -3
  5. package/dist/{cli-57V4ARER.js → cli-2QM63J3I.js} +1 -1
  6. package/dist/{cli-TFMNNVJ7.js → cli-32NRB2IT.js} +15 -15
  7. package/dist/{cli-JPAXKLVT.js → cli-3HBYH4VF.js} +11 -11
  8. package/dist/{cli-JR5AZLLK.js → cli-3HPAKEJJ.js} +2 -2
  9. package/dist/{cli-3PIJLSRQ.js → cli-3HZGJRQW.js} +11 -11
  10. package/dist/{cli-BOXXMDSX.js → cli-3OCKRPXI.js} +18 -18
  11. package/dist/{cli-4CHKF4DQ.js → cli-3OVXQJEW.js} +2 -2
  12. package/dist/{cli-4UWFQNGF.js → cli-3VV2JLHX.js} +1 -1
  13. package/dist/{cli-EJVAQCMQ.js → cli-42ZUP4X3.js} +114 -5
  14. package/dist/{cli-CV4JGVJR.js → cli-4B5OBHSY.js} +19 -19
  15. package/dist/{cli-2DQJACAH.js → cli-4EMNCU63.js} +17 -17
  16. package/dist/cli-5CG6BMCY.js +36 -0
  17. package/dist/{cli-VYR326C6.js → cli-5FRKWNVP.js} +19 -19
  18. package/dist/{cli-TDYKRXUA.js → cli-5P66N5G6.js} +17 -17
  19. package/dist/{cli-ZRPWZOCW.js → cli-5SYPXJCB.js} +20 -16
  20. package/dist/{cli-TJ3PLRHF.js → cli-66AHBZRZ.js} +15 -15
  21. package/dist/{cli-M7WEAIRF.js → cli-6AGWTGTO.js} +106 -28
  22. package/dist/{cli-WG36UJRK.js → cli-6BAZE75K.js} +18 -18
  23. package/dist/{cli-VPON5HGB.js → cli-6FVHRL3H.js} +19 -19
  24. package/dist/{cli-QVASWX2A.js → cli-6GDPO5VU.js} +2 -2
  25. package/dist/{cli-TPNQLYPC.js → cli-6NBER36P.js} +1 -1
  26. package/dist/{cli-LQ4VSM5R.js → cli-726NJARI.js} +0 -0
  27. package/dist/{cli-GHLILDH7.js → cli-72DRYVTT.js} +13 -13
  28. package/dist/{cli-MMN4BPO4.js → cli-7CW2BBJG.js} +1 -1
  29. package/dist/{cli-FP32D3T6.js → cli-7GJGFILU.js} +15 -15
  30. package/dist/{cli-HYEU3QS6.js → cli-7NCVUM5U.js} +3 -3
  31. package/dist/cli-7S4G4EKK.js +110 -0
  32. package/dist/{cli-J4DKUUTK.js → cli-7V6GUIIS.js} +2 -2
  33. package/dist/{cli-N6H6T2E2.js → cli-AEAFLZGY.js} +12 -0
  34. package/dist/{cli-C47GJATR.js → cli-AGYCXRPR.js} +3 -3
  35. package/dist/{cli-XSVGKI3R.js → cli-BC4KKNLA.js} +1 -1
  36. package/dist/cli-BQ3FHENQ.js +16 -0
  37. package/dist/{cli-CXCL7VRK.js → cli-BXCCODYD.js} +20 -20
  38. package/dist/cli-C2XDL4LD.js +30 -0
  39. package/dist/{cli-MJUYJIEP.js → cli-C45A5VX6.js} +3 -3
  40. package/dist/{cli-64AA7367.js → cli-C7YZNPWX.js} +11 -11
  41. package/dist/{cli-ZKG3OPZ6.js → cli-CAX4CQTC.js} +13 -13
  42. package/dist/{cli-YOTGR3NB.js → cli-CVOLMK3Z.js} +1 -1
  43. package/dist/{cli-PKQNOGBO.js → cli-D3CZRXVJ.js} +63 -17
  44. package/dist/{cli-4YB3ROVR.js → cli-DMKRP33X.js} +1 -1
  45. package/dist/{cli-FZ7QAZZP.js → cli-DPFN2LIZ.js} +15 -15
  46. package/dist/{cli-7TOLC62D.js → cli-DT756M3Z.js} +20 -20
  47. package/dist/{cli-TIDQ4WUE.js → cli-DXHPYN4N.js} +1 -1
  48. package/dist/{cli-OANH3BTQ.js → cli-E665NKUQ.js} +5 -5
  49. package/dist/{cli-DEBCP7UH.js → cli-EK7CGMGS.js} +17 -17
  50. package/dist/{cli-PIO7NWMH.js → cli-ESU3J563.js} +15 -15
  51. package/dist/{cli-6HB6HTC6.js → cli-F47ELAXM.js} +47 -47
  52. package/dist/{cli-JIZTQVL2.js → cli-FH4WBZHA.js} +14 -14
  53. package/dist/{cli-JRMHSMYT.js → cli-FHKRO6OU.js} +19 -19
  54. package/dist/{cli-ESA6YNPF.js → cli-FSEDPZR5.js} +19 -19
  55. package/dist/{cli-G5DQGZ2E.js → cli-FV45UZQP.js} +19 -19
  56. package/dist/{cli-XR2XSWQN.js → cli-G7FX7ZIU.js} +12 -12
  57. package/dist/{cli-X7E3637I.js → cli-GFONBOJT.js} +50 -26
  58. package/dist/{cli-C5QOJJWX.js → cli-GHIMH6JU.js} +1 -1
  59. package/dist/{cli-T4HWGMY4.js → cli-HC7L5DXV.js} +15 -15
  60. package/dist/{cli-WU43JT4T.js → cli-HJPNNORV.js} +2 -2
  61. package/dist/{cli-SOMIB4B4.js → cli-HMEZHQBC.js} +17 -17
  62. package/dist/{cli-TFZ53OA2.js → cli-HQUVSAHY.js} +18 -18
  63. package/dist/{cli-MYJGMA6U.js → cli-IC5FOT2J.js} +1 -1
  64. package/dist/{cli-VL2P354N.js → cli-IVZ7AHUJ.js} +3 -3
  65. package/dist/{cli-B6YHEKIJ.js → cli-J2OTL6JH.js} +5 -5
  66. package/dist/{cli-NEOLMC2P.js → cli-JA6UFTSX.js} +17 -17
  67. package/dist/{cli-Z5HWENER.js → cli-JOXCAGM7.js} +19 -19
  68. package/dist/{cli-NOQBWJQN.js → cli-JQ6I5GGE.js} +3 -3
  69. package/dist/{cli-TDSQSCX4.js → cli-K6M6YB67.js} +1 -1
  70. package/dist/{cli-MYJGGLC5.js → cli-KFVA7DT3.js} +3 -3
  71. package/dist/{cli-DHOWZCXT.js → cli-KH6FKM5A.js} +15 -15
  72. package/dist/{cli-4VZIJYKU.js → cli-KMT235FV.js} +2 -2
  73. package/dist/{cli-6ZSMW4HR.js → cli-KU4PG7ZA.js} +15 -15
  74. package/dist/{cli-ATI6OLJU.js → cli-L4DEEAMK.js} +17 -17
  75. package/dist/{cli-EDCAH2TC.js → cli-ME3JKMJL.js} +19 -19
  76. package/dist/{cli-R7RG2VMW.js → cli-MJ65PIYI.js} +15 -15
  77. package/dist/cli-MM2ROZWO.js +36 -0
  78. package/dist/{cli-RZITKPJX.js → cli-MN7X4UG2.js} +1 -1
  79. package/dist/{cli-LE5ICDAF.js → cli-MPU4FLA7.js} +4 -4
  80. package/dist/{cli-HCRTYQQS.js → cli-MPWTXNF6.js} +2 -2
  81. package/dist/{cli-NPPY557S.js → cli-N5K2KHPR.js} +15 -15
  82. package/dist/{cli-PVA52RC2.js → cli-NGOQWOQE.js} +15 -15
  83. package/dist/{cli-ZTWOE3ZT.js → cli-NU4SCD5D.js} +1 -1
  84. package/dist/{cli-UTM4QU67.js → cli-O3IMNLN2.js} +282 -96
  85. package/dist/{cli-MM3A4SPH.js → cli-OUFXSQOW.js} +7265 -4467
  86. package/dist/{cli-UBQCSUDH.js → cli-PEY6XZDE.js} +16 -16
  87. package/dist/{cli-HM7CD4VU.js → cli-PLW3TWJ7.js} +19 -19
  88. package/dist/{cli-LRQDF3ZO.js → cli-PO2ALWHP.js} +13 -13
  89. package/dist/{cli-IPP5FDCH.js → cli-PPEB3ENS.js} +18 -18
  90. package/dist/{cli-C3OERMIR.js → cli-PZ7G544B.js} +3 -3
  91. package/dist/{cli-GPAN6XK2.js → cli-Q5BKFFDL.js} +4 -4
  92. package/dist/{cli-MULKSLA4.js → cli-QAI6T5FL.js} +15 -15
  93. package/dist/{cli-JGFJWZFU.js → cli-QAVLRCQ5.js} +3 -3
  94. package/dist/{cli-OQG3Y4RU.js → cli-QDIH2G2P.js} +15 -15
  95. package/dist/cli-SN7D7HTX.js +36 -0
  96. package/dist/{cli-SWZY7L7K.js → cli-SOQJHK4Q.js} +6 -6
  97. package/dist/{cli-7RYIEKMB.js → cli-SPKPDXWD.js} +15 -15
  98. package/dist/{cli-WAZD75KE.js → cli-SWUAXVIJ.js} +15 -15
  99. package/dist/cli-TJNLXQJ5.js +36 -0
  100. package/dist/{cli-SX3ULO5P.js → cli-U2EWI6H5.js} +11 -11
  101. package/dist/{cli-FXY3DKPW.js → cli-UADUC4JD.js} +2 -2
  102. package/dist/{cli-FWFRKQNE.js → cli-UR63LFVK.js} +2 -2
  103. package/dist/{cli-YSPZZQCP.js → cli-UTHPCZYL.js} +2 -2
  104. package/dist/{cli-XTANOFQR.js → cli-UYV3BDPA.js} +3 -3
  105. package/dist/{cli-H3J3ICCQ.js → cli-UZCQL6YP.js} +3 -3
  106. package/dist/{cli-LQERHJFE.js → cli-V5K3CCYZ.js} +2 -2
  107. package/dist/cli-V7L3HEL4.js +36 -0
  108. package/dist/{cli-GEQUJF4L.js → cli-VBSF3R3L.js} +16 -16
  109. package/dist/{cli-FXWWYBYU.js → cli-VQ4OJ4KE.js} +18 -18
  110. package/dist/{cli-IUS2YCD3.js → cli-VTLFQHDO.js} +1 -1
  111. package/dist/{cli-SOFCTQAL.js → cli-W7XCTGQ7.js} +15 -15
  112. package/dist/{cli-GTWEGYSU.js → cli-W7Y7X3FX.js} +19 -19
  113. package/dist/cli-WWNTBK37.js +1973 -0
  114. package/dist/cli-XPJGW375.js +36 -0
  115. package/dist/{cli-SRHBXZCN.js → cli-Y33ULHYO.js} +1 -1
  116. package/dist/{cli-ZQ2Y3U7F.js → cli-YLYB4ITF.js} +13 -13
  117. package/dist/{cli-4XCQUM3E.js → cli-ZFY6TGU7.js} +4 -4
  118. package/dist/{cli-JRIIAZ33.js → cli-ZSKP2IRP.js} +53 -38
  119. package/dist/cli.js +52 -52
  120. package/dist/client.js +17518 -16558
  121. package/dist/core/save-scenario.d.ts +1 -0
  122. package/dist/core/session-start-gate.d.ts +25 -0
  123. package/dist/core/session.d.ts +4 -0
  124. package/dist/dev/console/assets/{index-CnXlPeLX.js → index-CVNjiRUh.js} +31 -27
  125. package/dist/dev/console/index.html +1 -1
  126. package/dist/docs/api/deck.md +1 -1
  127. package/dist/docs/api/index.md +1 -1
  128. package/dist/docs/api/sdk-e2e.md +7 -6
  129. package/dist/docs/api/sdk-projection.md +1 -0
  130. package/dist/docs/api/sdk-tools-client.md +3 -1
  131. package/dist/docs/api/sdk-tools-playwright.md +1 -8
  132. package/dist/docs/api/sdk-ui.md +40 -64
  133. package/dist/docs/api/sdk.md +10 -1
  134. package/dist/docs/changelog.md +15 -0
  135. package/dist/docs/cli-error-codes.md +7 -1
  136. package/dist/docs/cli-reference.md +3 -0
  137. package/dist/docs/concepts/index.md +1 -0
  138. package/dist/docs/guides/engine.md +5 -0
  139. package/dist/docs/guides/file-handling.md +4 -1
  140. package/dist/docs/guides/llm-integration.md +3 -2
  141. package/dist/docs/guides/multi-team-games.md +2 -0
  142. package/dist/docs/guides/patterns.md +5 -0
  143. package/dist/docs/guides/session.md +1 -1
  144. package/dist/docs/guides/settings.md +2 -0
  145. package/dist/docs/guides/setup.md +23 -2
  146. package/dist/docs/guides/speech-generation.md +1 -0
  147. package/dist/docs/guides/testing.md +2 -0
  148. package/dist/docs/guides/tick-controller.md +2 -0
  149. package/dist/docs/guides/type-safety.md +2 -1
  150. package/dist/docs/guides/ui-files-and-llms.md +3 -1
  151. package/dist/docs/guides/upgrading.md +4 -0
  152. package/dist/docs/guides/validators.md +27 -4
  153. package/dist/docs/guides/waiting-room.md +2 -0
  154. package/dist/docs/page-index.md +8 -6
  155. package/dist/docs/recipes/call-endpoint-from-ui.md +1 -0
  156. package/dist/docs/recipes/create-scenario-editor.md +2 -1
  157. package/dist/docs/recipes/create-setup.md +2 -1
  158. package/dist/docs/recipes/declare-api-uses.md +1 -0
  159. package/dist/docs/recipes/describe-setup-with-endpoint.md +69 -0
  160. package/dist/docs/recipes/index.md +3 -1
  161. package/dist/docs/recipes/share-logic-between-engine-and-ui.md +2 -2
  162. package/dist/docs/recipes/test-user-interface.md +1 -1
  163. package/dist/docs/recipes/validate-scenarios.md +9 -3
  164. package/dist/docs/recipes/write-setup-notes.md +58 -0
  165. package/dist/docs/troubleshooting.md +2 -1
  166. package/dist/execution/executor.d.ts +12 -0
  167. package/dist/execution/scenario-gates.d.ts +40 -0
  168. package/dist/host.js +1082 -467
  169. package/dist/playwright.js +17529 -16569
  170. package/dist/runtime/manifest-version.d.ts +1 -1
  171. package/dist/runtime.js +4 -2
  172. package/dist/setup/setup-notes.d.ts +42 -0
  173. package/dist/templates/package/package.json.liquid +15 -15
  174. package/dist/templates/starter-game/package.json +13 -13
  175. package/dist/utils/error-codes.d.ts +13 -1
  176. package/dist/validation/package-validation.d.ts +1 -1
  177. package/package.json +22 -23
  178. package/dist/cli-57C72YKJ.js +0 -36
  179. package/dist/cli-5G7TZHD3.js +0 -36
  180. package/dist/cli-7MBLH4M3.js +0 -36
  181. package/dist/cli-C6G65H6S.js +0 -256
  182. package/dist/cli-L5IG7MY2.js +0 -36
  183. package/dist/cli-SPGUVL6Z.js +0 -36
  184. package/dist/cli-UY4VDI7W.js +0 -30
  185. package/dist/cli-WM6SQJ6Q.js +0 -16
  186. package/dist/cli-ZBTFLZUL.js +0 -36
  187. package/dist/cli-ZF7IFB54.js +0 -4026
@@ -198,6 +198,7 @@ Every logic function is async, takes one args object, and returns what it writes
198
198
 
199
199
  ```typescript
200
200
  import type { InitializationFunction, RunFunction } from '@seriousgaming/sdk';
201
+
201
202
  import type { Context, Settings } from './types';
202
203
 
203
204
  export const Init: InitializationFunction<Context, Settings> = async ({ context, settings }) => ({
@@ -1,46 +1,46 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  resolvePatchedDefinition
4
- } from "./cli-4VZIJYKU.js";
4
+ } from "./cli-KMT235FV.js";
5
5
  import "./cli-S5IVGDDD.js";
6
6
  import {
7
7
  readAuthoredBundle
8
- } from "./cli-JR5AZLLK.js";
8
+ } from "./cli-3HPAKEJJ.js";
9
9
  import {
10
10
  resolveInputSource
11
- } from "./cli-4UWFQNGF.js";
11
+ } from "./cli-3VV2JLHX.js";
12
12
  import {
13
13
  updateWaitingRoomUserInterfaceFiles
14
- } from "./cli-LE5ICDAF.js";
15
- import "./cli-IUS2YCD3.js";
14
+ } from "./cli-MPU4FLA7.js";
15
+ import "./cli-VTLFQHDO.js";
16
16
  import "./cli-QUNIRH7A.js";
17
- import "./cli-YSPZZQCP.js";
17
+ import "./cli-UTHPCZYL.js";
18
18
  import {
19
19
  loadPackageContext
20
- } from "./cli-XSVGKI3R.js";
21
- import "./cli-FXY3DKPW.js";
22
- import "./cli-57V4ARER.js";
20
+ } from "./cli-BC4KKNLA.js";
21
+ import "./cli-UADUC4JD.js";
22
+ import "./cli-2QM63J3I.js";
23
23
  import {
24
24
  operationError,
25
25
  printOperationResult,
26
26
  regenerateTypes
27
- } from "./cli-JGFJWZFU.js";
28
- import "./cli-H3J3ICCQ.js";
29
- import "./cli-SWZY7L7K.js";
30
- import "./cli-C6G65H6S.js";
31
- import "./cli-UTM4QU67.js";
27
+ } from "./cli-QAVLRCQ5.js";
28
+ import "./cli-UZCQL6YP.js";
29
+ import "./cli-SOQJHK4Q.js";
30
+ import "./cli-7S4G4EKK.js";
31
+ import "./cli-O3IMNLN2.js";
32
32
  import "./cli-25RWY5BQ.js";
33
33
  import "./cli-QWQMPCL6.js";
34
34
  import {
35
35
  validateSDKWaitingRoomUserInterface
36
- } from "./cli-ZF7IFB54.js";
36
+ } from "./cli-OUFXSQOW.js";
37
37
  import "./cli-F2D4GGUA.js";
38
38
  import {
39
39
  logger
40
- } from "./cli-4YB3ROVR.js";
40
+ } from "./cli-DMKRP33X.js";
41
41
  import {
42
42
  CliError
43
- } from "./cli-N6H6T2E2.js";
43
+ } from "./cli-AEAFLZGY.js";
44
44
 
45
45
  // cli/commands/resources/waiting-room/update.ts
46
46
  async function updateWaitingRoomUserInterface(definitionInput, options) {
@@ -6,7 +6,7 @@ import {
6
6
  import {
7
7
  CliError,
8
8
  reportResult
9
- } from "./cli-N6H6T2E2.js";
9
+ } from "./cli-AEAFLZGY.js";
10
10
 
11
11
  // cli/commands/blob.ts
12
12
  import { existsSync } from "fs";
@@ -1,13 +1,13 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  loadConfig
4
- } from "./cli-ZF7IFB54.js";
4
+ } from "./cli-OUFXSQOW.js";
5
5
  import "./cli-F2D4GGUA.js";
6
- import "./cli-4YB3ROVR.js";
6
+ import "./cli-DMKRP33X.js";
7
7
  import {
8
8
  printJson,
9
9
  reportResult
10
- } from "./cli-N6H6T2E2.js";
10
+ } from "./cli-AEAFLZGY.js";
11
11
 
12
12
  // cli/commands/resolve.ts
13
13
  import { resolve } from "path";
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  getResourceMeta
4
- } from "./cli-ZF7IFB54.js";
4
+ } from "./cli-OUFXSQOW.js";
5
5
 
6
6
  // cli/utils/resource-scan.ts
7
7
  import { existsSync, readdirSync } from "fs";
@@ -2,36 +2,36 @@
2
2
  import {
3
3
  deletePresentationFiles,
4
4
  findPresentationReferences
5
- } from "./cli-LE5ICDAF.js";
6
- import "./cli-IUS2YCD3.js";
5
+ } from "./cli-MPU4FLA7.js";
6
+ import "./cli-VTLFQHDO.js";
7
7
  import "./cli-QUNIRH7A.js";
8
- import "./cli-YSPZZQCP.js";
8
+ import "./cli-UTHPCZYL.js";
9
9
  import {
10
10
  loadPackageContext
11
- } from "./cli-XSVGKI3R.js";
12
- import "./cli-FXY3DKPW.js";
13
- import "./cli-57V4ARER.js";
11
+ } from "./cli-BC4KKNLA.js";
12
+ import "./cli-UADUC4JD.js";
13
+ import "./cli-2QM63J3I.js";
14
14
  import {
15
15
  operationError,
16
16
  recordOperationResult
17
- } from "./cli-JGFJWZFU.js";
17
+ } from "./cli-QAVLRCQ5.js";
18
18
  import {
19
19
  confirmAction
20
- } from "./cli-ZTWOE3ZT.js";
20
+ } from "./cli-NU4SCD5D.js";
21
21
  import {
22
22
  generateCommand
23
- } from "./cli-H3J3ICCQ.js";
24
- import "./cli-SWZY7L7K.js";
25
- import "./cli-C6G65H6S.js";
26
- import "./cli-UTM4QU67.js";
23
+ } from "./cli-UZCQL6YP.js";
24
+ import "./cli-SOQJHK4Q.js";
25
+ import "./cli-7S4G4EKK.js";
26
+ import "./cli-O3IMNLN2.js";
27
27
  import "./cli-25RWY5BQ.js";
28
28
  import "./cli-QWQMPCL6.js";
29
- import "./cli-ZF7IFB54.js";
29
+ import "./cli-OUFXSQOW.js";
30
30
  import "./cli-F2D4GGUA.js";
31
31
  import {
32
32
  logger
33
- } from "./cli-4YB3ROVR.js";
34
- import "./cli-N6H6T2E2.js";
33
+ } from "./cli-DMKRP33X.js";
34
+ import "./cli-AEAFLZGY.js";
35
35
 
36
36
  // cli/commands/resources/presentation/delete.ts
37
37
  async function deletePresentation(options) {
@@ -1,25 +1,25 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  runResourceCommand
4
- } from "./cli-HYEU3QS6.js";
4
+ } from "./cli-7NCVUM5U.js";
5
5
  import {
6
6
  RESOURCE_DESCRIPTORS_BY_TYPE,
7
7
  supportedTypes
8
- } from "./cli-6HB6HTC6.js";
9
- import "./cli-JGFJWZFU.js";
10
- import "./cli-ZTWOE3ZT.js";
11
- import "./cli-H3J3ICCQ.js";
12
- import "./cli-SWZY7L7K.js";
13
- import "./cli-C6G65H6S.js";
14
- import "./cli-UTM4QU67.js";
8
+ } from "./cli-F47ELAXM.js";
9
+ import "./cli-QAVLRCQ5.js";
10
+ import "./cli-NU4SCD5D.js";
11
+ import "./cli-UZCQL6YP.js";
12
+ import "./cli-SOQJHK4Q.js";
13
+ import "./cli-7S4G4EKK.js";
14
+ import "./cli-O3IMNLN2.js";
15
15
  import "./cli-25RWY5BQ.js";
16
16
  import "./cli-QWQMPCL6.js";
17
- import "./cli-ZF7IFB54.js";
17
+ import "./cli-OUFXSQOW.js";
18
18
  import "./cli-F2D4GGUA.js";
19
- import "./cli-4YB3ROVR.js";
19
+ import "./cli-DMKRP33X.js";
20
20
  import {
21
21
  CliError
22
- } from "./cli-N6H6T2E2.js";
22
+ } from "./cli-AEAFLZGY.js";
23
23
 
24
24
  // cli/commands/delete.ts
25
25
  async function deleteCommand(resourceType, identifier, options) {
@@ -9,13 +9,13 @@ import {
9
9
  findResourceMeta,
10
10
  isNamelessInterface,
11
11
  removedFromBundle
12
- } from "./cli-ZF7IFB54.js";
12
+ } from "./cli-OUFXSQOW.js";
13
13
  import {
14
14
  resourceExample
15
15
  } from "./cli-F2D4GGUA.js";
16
16
  import {
17
17
  CliError
18
- } from "./cli-N6H6T2E2.js";
18
+ } from "./cli-AEAFLZGY.js";
19
19
 
20
20
  // cli/utils/validators.ts
21
21
  var PACKAGE_IDENTIFIER_PATTERN = /^[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)+$/;
@@ -1,25 +1,25 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  resolveSession
4
- } from "./cli-OANH3BTQ.js";
5
- import "./cli-WU43JT4T.js";
6
- import "./cli-EJVAQCMQ.js";
7
- import "./cli-TDSQSCX4.js";
8
- import "./cli-SRHBXZCN.js";
9
- import "./cli-MM3A4SPH.js";
4
+ } from "./cli-E665NKUQ.js";
5
+ import "./cli-HJPNNORV.js";
6
+ import "./cli-42ZUP4X3.js";
7
+ import "./cli-K6M6YB67.js";
8
+ import "./cli-Y33ULHYO.js";
9
+ import "./cli-WWNTBK37.js";
10
10
  import "./cli-4LKXZQ2B.js";
11
- import "./cli-MMN4BPO4.js";
11
+ import "./cli-7CW2BBJG.js";
12
12
  import "./cli-QUNIRH7A.js";
13
- import "./cli-UTM4QU67.js";
13
+ import "./cli-O3IMNLN2.js";
14
14
  import "./cli-25RWY5BQ.js";
15
15
  import "./cli-QWQMPCL6.js";
16
- import "./cli-ZF7IFB54.js";
16
+ import "./cli-OUFXSQOW.js";
17
17
  import "./cli-F2D4GGUA.js";
18
- import "./cli-4YB3ROVR.js";
18
+ import "./cli-DMKRP33X.js";
19
19
  import {
20
20
  CliError,
21
21
  reportResult
22
- } from "./cli-N6H6T2E2.js";
22
+ } from "./cli-AEAFLZGY.js";
23
23
 
24
24
  // cli/commands/endpoint-audit.ts
25
25
  function describe(entry) {
@@ -1,51 +1,51 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  promptForSchemaProperties
4
- } from "./cli-RZITKPJX.js";
4
+ } from "./cli-MN7X4UG2.js";
5
5
  import {
6
6
  readAuthoredBundle
7
- } from "./cli-JR5AZLLK.js";
7
+ } from "./cli-3HPAKEJJ.js";
8
8
  import {
9
9
  resolveInputSource
10
- } from "./cli-4UWFQNGF.js";
10
+ } from "./cli-3VV2JLHX.js";
11
11
  import {
12
12
  createCapabilityFiles
13
- } from "./cli-LE5ICDAF.js";
14
- import "./cli-IUS2YCD3.js";
13
+ } from "./cli-MPU4FLA7.js";
14
+ import "./cli-VTLFQHDO.js";
15
15
  import "./cli-QUNIRH7A.js";
16
- import "./cli-YSPZZQCP.js";
16
+ import "./cli-UTHPCZYL.js";
17
17
  import {
18
18
  loadPackageContext
19
- } from "./cli-XSVGKI3R.js";
19
+ } from "./cli-BC4KKNLA.js";
20
20
  import {
21
21
  presentFields
22
- } from "./cli-FXY3DKPW.js";
23
- import "./cli-57V4ARER.js";
22
+ } from "./cli-UADUC4JD.js";
23
+ import "./cli-2QM63J3I.js";
24
24
  import {
25
25
  BUILD_COMMAND,
26
26
  generateTypes,
27
27
  operationError,
28
28
  printOperationResult
29
- } from "./cli-JGFJWZFU.js";
29
+ } from "./cli-QAVLRCQ5.js";
30
30
  import {
31
31
  input
32
- } from "./cli-ZTWOE3ZT.js";
33
- import "./cli-H3J3ICCQ.js";
34
- import "./cli-SWZY7L7K.js";
35
- import "./cli-C6G65H6S.js";
36
- import "./cli-UTM4QU67.js";
32
+ } from "./cli-NU4SCD5D.js";
33
+ import "./cli-UZCQL6YP.js";
34
+ import "./cli-SOQJHK4Q.js";
35
+ import "./cli-7S4G4EKK.js";
36
+ import "./cli-O3IMNLN2.js";
37
37
  import "./cli-25RWY5BQ.js";
38
38
  import "./cli-QWQMPCL6.js";
39
39
  import {
40
40
  validateSDKCapability
41
- } from "./cli-ZF7IFB54.js";
41
+ } from "./cli-OUFXSQOW.js";
42
42
  import "./cli-F2D4GGUA.js";
43
43
  import {
44
44
  logger
45
- } from "./cli-4YB3ROVR.js";
45
+ } from "./cli-DMKRP33X.js";
46
46
  import {
47
47
  CliError
48
- } from "./cli-N6H6T2E2.js";
48
+ } from "./cli-AEAFLZGY.js";
49
49
 
50
50
  // cli/commands/resources/capability/new.ts
51
51
  var CAPABILITY_SCOPES = Object.keys({
@@ -1,10 +1,10 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  normalizeSettingsSchema
4
- } from "./cli-LE5ICDAF.js";
4
+ } from "./cli-MPU4FLA7.js";
5
5
  import {
6
6
  CliError
7
- } from "./cli-N6H6T2E2.js";
7
+ } from "./cli-AEAFLZGY.js";
8
8
 
9
9
  // cli/commands/resources/settings/defaults.ts
10
10
  function assertEveryPropertyHasDefault(schema) {
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  CliError
4
- } from "./cli-N6H6T2E2.js";
4
+ } from "./cli-AEAFLZGY.js";
5
5
 
6
6
  // cli/utils/input-source.ts
7
7
  import { readFileSync } from "fs";
@@ -4,7 +4,7 @@ import {
4
4
  isChapterEmpty,
5
5
  referenceLocale,
6
6
  resolveBlobInputs
7
- } from "./cli-MM3A4SPH.js";
7
+ } from "./cli-WWNTBK37.js";
8
8
  import {
9
9
  validateTickControllerResult
10
10
  } from "./cli-4LKXZQ2B.js";
@@ -19,15 +19,20 @@ import {
19
19
  LLMClient,
20
20
  LogicCalls,
21
21
  LogicLoader,
22
+ SESSION_VALIDATION,
22
23
  TtsClient,
23
24
  applyContextUpdate,
24
25
  carryLogicFailure,
25
26
  deepMergeContext,
27
+ describeScenarioProblems,
26
28
  logicErrorOf,
27
29
  logicFailureOf,
28
30
  markLogicFailure,
29
- resolveCapabilityScope
30
- } from "./cli-UTM4QU67.js";
31
+ partitionProblems,
32
+ resolveCapabilityScope,
33
+ runScenarioGates,
34
+ withOverrunRetry
35
+ } from "./cli-O3IMNLN2.js";
31
36
  import {
32
37
  deleteBlobs,
33
38
  describeBlob,
@@ -46,7 +51,7 @@ import {
46
51
  loadConfig,
47
52
  settingsSchemas,
48
53
  validateSessionOverrides
49
- } from "./cli-ZF7IFB54.js";
54
+ } from "./cli-OUFXSQOW.js";
50
55
 
51
56
  // cli/execution/configuration-builder.ts
52
57
  import { existsSync, readFileSync } from "fs";
@@ -190,6 +195,47 @@ var FakeClock = class {
190
195
  }
191
196
  };
192
197
 
198
+ // cli/core/session-start-gate.ts
199
+ async function gateSessionStart(options) {
200
+ const { config, scenario, overrides } = options;
201
+ if (!config || !(config.requires ?? []).includes(SESSION_VALIDATION)) return [];
202
+ if (!hasOverrides(overrides)) return [];
203
+ const judge = () => runScenarioGates({
204
+ packagePath: options.packagePath,
205
+ config,
206
+ scenarioSettings: scenario?.definition.settings ?? null,
207
+ sessionOverrides: overrides,
208
+ locale: options.locale,
209
+ ...options.boundMs === void 0 ? {} : { boundMs: options.boundMs },
210
+ // As the session resolves its files: its scenario's, and its own blobs.
211
+ files: { scenarioRoot: scenario?.rootDirectory ?? null, blobs: "all" }
212
+ });
213
+ const problems = await withOverrunRetry(judge);
214
+ const { blocking, warnings } = partitionProblems(problems);
215
+ const failed = blocking.filter((problem) => problem.failed === true);
216
+ if (failed.length > 0 && failed.every((problem) => problem.overran === true)) {
217
+ throw new DeniedError(
218
+ "The session cannot start: the game's own check of its settings did not finish in time, even when run again. A busy host can cause this, so try again; if it keeps happening, the check is too slow, which is a fault in the game rather than in the settings.\n" + describeScenarioProblems(failed).join("\n")
219
+ );
220
+ }
221
+ if (failed.length > 0) {
222
+ throw new DeniedError(
223
+ "The session cannot start: the game's own check of its settings failed, which is a fault in the game rather than in the settings, so changing them will not help.\n" + describeScenarioProblems(failed).join("\n")
224
+ );
225
+ }
226
+ if (blocking.length > 0) {
227
+ throw new DeniedError(
228
+ "The session cannot start: the game's check found a problem with its settings. Change these and try again:\n" + describeScenarioProblems(blocking).join("\n")
229
+ );
230
+ }
231
+ return describeScenarioProblems(warnings);
232
+ }
233
+ function hasOverrides(overrides) {
234
+ return Object.values(overrides ?? {}).some(
235
+ (values) => values !== null && typeof values === "object" && Object.keys(values).length > 0
236
+ );
237
+ }
238
+
193
239
  // cli/core/tick-timer.ts
194
240
  var FLOOR_MS = 3e4;
195
241
  var CEILING_MS = 7 * 24 * 60 * 60 * 1e3;
@@ -2653,6 +2699,31 @@ var GameExecutor = class {
2653
2699
  getActiveScenario() {
2654
2700
  return this.activeScenario;
2655
2701
  }
2702
+ /**
2703
+ * What `initialize(true, …, scenarioId)` would start a session on, read
2704
+ * without changing anything: the package on disk, the scenario it would
2705
+ * activate and the session-override layer it would load. So a start can be
2706
+ * judged (§15.8) before the running session is torn down, and a refusal
2707
+ * leaves it as it was.
2708
+ */
2709
+ async previewStart(scenarioId) {
2710
+ const config = await this.deps.loadConfig(join2(this.packagePath, "seriousgaming.sdk.json"));
2711
+ const scenarios = config.scenarios ?? [];
2712
+ const scenario = scenarioId === null ? null : scenarioId ? scenarios.find((s) => s.definition.identifier === scenarioId) ?? null : scenarios.find((s) => s.definition.default) ?? null;
2713
+ let overrides = {};
2714
+ const path2 = this.deps.configStore.getPath(this.packagePath);
2715
+ const recorded = this.deps.configStore.readScenario(this.packagePath);
2716
+ const stale = recorded !== void 0 && recorded !== (scenario?.definition.identifier ?? null);
2717
+ if (!this.inMemory && !stale && this.deps.fs.existsSync(path2)) {
2718
+ try {
2719
+ overrides = JSON.parse(
2720
+ await this.deps.fs.readFile(path2, "utf-8")
2721
+ );
2722
+ } catch {
2723
+ }
2724
+ }
2725
+ return { config, scenario, overrides };
2726
+ }
2656
2727
  /** The scenario `initialize` would activate for this id, without activating it. */
2657
2728
  findScenario(scenarioId) {
2658
2729
  return this.configResolver.resolveScenario(scenarioId);
@@ -5459,6 +5530,8 @@ var Session = class {
5459
5530
  started = false;
5460
5531
  /** True while the game's `setup` slot still owes us a Play (§8.3). */
5461
5532
  holdingAtSetup = false;
5533
+ /** The `Scenario` gate's warnings from the last start, for the mutation that caused it. */
5534
+ startWarnings = [];
5462
5535
  /** Edits on disk that apply only at the next initialisation (#640). */
5463
5536
  pending = NO_PENDING_CHANGES;
5464
5537
  /**
@@ -5574,6 +5647,7 @@ var Session = class {
5574
5647
  this.resolveMode();
5575
5648
  this.holdingAtSetup = this.hasSetup();
5576
5649
  if (!this.holdingAtSetup) {
5650
+ await this.gateStart();
5577
5651
  await this.buildInitialState();
5578
5652
  await this.roster.materialise();
5579
5653
  }
@@ -6018,10 +6092,17 @@ var Session = class {
6018
6092
  async apply(command) {
6019
6093
  try {
6020
6094
  const readsBefore = this.timers.readsBefore(command);
6095
+ this.startWarnings = [];
6021
6096
  const committedAtTick = await this.dispatch(command);
6022
6097
  await this.timers.retime(command, readsBefore);
6023
6098
  this.emitState(command.type);
6024
- return committedAtTick === void 0 ? { ok: true } : { ok: true, committedAtTick };
6099
+ const warnings = this.startWarnings;
6100
+ this.startWarnings = [];
6101
+ return {
6102
+ ok: true,
6103
+ ...committedAtTick === void 0 ? {} : { committedAtTick },
6104
+ ...warnings.length > 0 ? { warnings } : {}
6105
+ };
6025
6106
  } catch (error) {
6026
6107
  if (error instanceof RefusedError) {
6027
6108
  return withStale({ ok: false, outcome: error.outcome }, error);
@@ -6123,6 +6204,12 @@ var Session = class {
6123
6204
  if (this.runKind !== "walkthrough") {
6124
6205
  refuseTeamCountAtPlay(this.state.getTeamCount(), this.teamBounds());
6125
6206
  }
6207
+ try {
6208
+ await this.gateStart();
6209
+ } catch (error) {
6210
+ if (error instanceof DeniedError) this.report(error.message, "play");
6211
+ throw error;
6212
+ }
6126
6213
  this.holdingAtSetup = false;
6127
6214
  await this.buildInitialState();
6128
6215
  await this.roster.replayJoins();
@@ -6176,6 +6263,16 @@ var Session = class {
6176
6263
  if (refusal) throw new DeniedError(refusal);
6177
6264
  }
6178
6265
  }
6266
+ if (!this.hasSetup()) {
6267
+ const next = await this.executor.previewStart(command.scenarioId);
6268
+ this.startWarnings = await gateSessionStart({
6269
+ packagePath: this.options.packagePath,
6270
+ config: next.config,
6271
+ scenario: next.scenario,
6272
+ overrides: next.overrides,
6273
+ locale: command.locale ?? this.locale
6274
+ });
6275
+ }
6179
6276
  if (command.teams !== void 0) this.options = { ...this.options, teams: command.teams };
6180
6277
  this.options = { ...this.options, participants };
6181
6278
  if (command.locale !== void 0) this.locale = command.locale;
@@ -6410,6 +6507,16 @@ var Session = class {
6410
6507
  if (!locales) return "";
6411
6508
  return locales[this.locale]?.name ?? locales.en?.name ?? Object.values(locales)[0]?.name ?? "";
6412
6509
  }
6510
+ /** Refuse to enter play over the game's `Scenario` gate, keeping its warnings (§15.8). */
6511
+ async gateStart() {
6512
+ this.startWarnings = await gateSessionStart({
6513
+ packagePath: this.options.packagePath,
6514
+ config: this.executor.getConfig(),
6515
+ scenario: this.executor.getActiveScenario(),
6516
+ overrides: this.executor.getSessionOverrides(),
6517
+ locale: this.locale
6518
+ });
6519
+ }
6413
6520
  report(message, source, teamId) {
6414
6521
  this.errors.push(message);
6415
6522
  this.emit({ type: "error", message, source, ...teamId ? { teamId } : {} });
@@ -6436,8 +6543,10 @@ export {
6436
6543
  rebuildsWalkthrough,
6437
6544
  commandError,
6438
6545
  atomicWriteFile,
6546
+ readConfigurationScenario,
6439
6547
  saveSessionSettingsOverrides,
6440
6548
  FakeClock,
6549
+ gateSessionStart,
6441
6550
  IDLE_TIMER,
6442
6551
  REINITIALISED_ON_CHANGE,
6443
6552
  Session
@@ -1,53 +1,53 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  promptForSettings
4
- } from "./cli-C3OERMIR.js";
4
+ } from "./cli-PZ7G544B.js";
5
5
  import {
6
6
  loadResourceIdentifiers
7
- } from "./cli-XTANOFQR.js";
7
+ } from "./cli-UYV3BDPA.js";
8
8
  import {
9
9
  readAuthoredBundle
10
- } from "./cli-JR5AZLLK.js";
10
+ } from "./cli-3HPAKEJJ.js";
11
11
  import {
12
12
  resolveInputSource
13
- } from "./cli-4UWFQNGF.js";
13
+ } from "./cli-3VV2JLHX.js";
14
14
  import {
15
15
  createWaitingRoomUserInterfaceFiles
16
- } from "./cli-LE5ICDAF.js";
17
- import "./cli-IUS2YCD3.js";
16
+ } from "./cli-MPU4FLA7.js";
17
+ import "./cli-VTLFQHDO.js";
18
18
  import "./cli-QUNIRH7A.js";
19
- import "./cli-YSPZZQCP.js";
19
+ import "./cli-UTHPCZYL.js";
20
20
  import {
21
21
  loadPackageContext
22
- } from "./cli-XSVGKI3R.js";
22
+ } from "./cli-BC4KKNLA.js";
23
23
  import {
24
24
  presentFields
25
- } from "./cli-FXY3DKPW.js";
26
- import "./cli-57V4ARER.js";
25
+ } from "./cli-UADUC4JD.js";
26
+ import "./cli-2QM63J3I.js";
27
27
  import {
28
28
  BUILD_COMMAND,
29
29
  generateTypes,
30
30
  operationError,
31
31
  printOperationResult
32
- } from "./cli-JGFJWZFU.js";
32
+ } from "./cli-QAVLRCQ5.js";
33
33
  import {
34
34
  checkbox,
35
35
  input
36
- } from "./cli-ZTWOE3ZT.js";
37
- import "./cli-H3J3ICCQ.js";
38
- import "./cli-SWZY7L7K.js";
39
- import "./cli-C6G65H6S.js";
40
- import "./cli-UTM4QU67.js";
36
+ } from "./cli-NU4SCD5D.js";
37
+ import "./cli-UZCQL6YP.js";
38
+ import "./cli-SOQJHK4Q.js";
39
+ import "./cli-7S4G4EKK.js";
40
+ import "./cli-O3IMNLN2.js";
41
41
  import "./cli-25RWY5BQ.js";
42
42
  import "./cli-QWQMPCL6.js";
43
43
  import {
44
44
  validateSDKWaitingRoomUserInterface
45
- } from "./cli-ZF7IFB54.js";
45
+ } from "./cli-OUFXSQOW.js";
46
46
  import "./cli-F2D4GGUA.js";
47
47
  import {
48
48
  logger
49
- } from "./cli-4YB3ROVR.js";
50
- import "./cli-N6H6T2E2.js";
49
+ } from "./cli-DMKRP33X.js";
50
+ import "./cli-AEAFLZGY.js";
51
51
 
52
52
  // cli/commands/resources/waiting-room/new.ts
53
53
  async function createWaitingRoomUserInterface(definitionInput, options) {