@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
@@ -22,4 +22,5 @@ export declare class SaveScenarioError extends Error {
22
22
  /** Throws a {@link SaveScenarioError} for a save refused before anything is written. */
23
23
  export declare function saveSessionScenario(session: Session, packagePath: string, request: SaveScenarioRequest): Promise<{
24
24
  identifier: string;
25
+ warnings?: string[];
25
26
  }>;
@@ -0,0 +1,25 @@
1
+ /**
2
+ * The `Scenario` gate run as a session starts (§15.8, `session-validation`).
3
+ *
4
+ * A package scenario passed the gate at build, so a session on one that
5
+ * nobody has changed has nothing new to judge. Once a session-scoped source
6
+ * has changed something, the combination is new, and the game's own rules
7
+ * decide whether it may start. The dev server saves custom scenarios as
8
+ * package scenarios (§6.7.2), so an empty session layer is the whole test here.
9
+ */
10
+ import type { ResolvedPackageManifest, SDKScenario } from '@seriousgaming/sdk';
11
+ import type { SessionSettingsOverrides } from '../execution/types';
12
+ /**
13
+ * Refuse a session start the game's gate refuses, and return its warnings.
14
+ * A gate that fails is reported apart from the problems it finds: only a fix
15
+ * to the game clears it, so changing settings will not.
16
+ */
17
+ export declare function gateSessionStart(options: {
18
+ packagePath: string;
19
+ config: ResolvedPackageManifest | null;
20
+ scenario: SDKScenario | null;
21
+ overrides: SessionSettingsOverrides | null;
22
+ locale: string;
23
+ /** Each gate's bound; the runtime's own when absent. */
24
+ boundMs?: number;
25
+ }): Promise<string[]>;
@@ -137,6 +137,8 @@ export declare class Session {
137
137
  private started;
138
138
  /** True while the game's `setup` slot still owes us a Play (§8.3). */
139
139
  private holdingAtSetup;
140
+ /** The `Scenario` gate's warnings from the last start, for the mutation that caused it. */
141
+ private startWarnings;
140
142
  /** Edits on disk that apply only at the next initialisation (#640). */
141
143
  private pending;
142
144
  /**
@@ -401,6 +403,8 @@ export declare class Session {
401
403
  * facilitator.
402
404
  */
403
405
  private gameName;
406
+ /** Refuse to enter play over the game's `Scenario` gate, keeping its warnings (§15.8). */
407
+ private gateStart;
404
408
  private report;
405
409
  private emitState;
406
410
  private emit;