@seriousgaming/sdk-tools 1.6.1 → 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 (202) hide show
  1. package/dist/agent/guidance.md +1 -0
  2. package/dist/{cli-2NU2LPEE.js → cli-27M4PX7O.js} +17 -17
  3. package/dist/{cli-2BH7FX27.js → cli-2FXZZLCL.js} +1 -1
  4. package/dist/{cli-5ACDPCXI.js → cli-2KDV2DYC.js} +3 -3
  5. package/dist/{cli-OXAUOWCN.js → cli-2QM63J3I.js} +1 -1
  6. package/dist/{cli-HW53ICZC.js → cli-32NRB2IT.js} +15 -15
  7. package/dist/{cli-45OCBG53.js → cli-3HBYH4VF.js} +11 -11
  8. package/dist/{cli-4VFZHLDG.js → cli-3HPAKEJJ.js} +2 -2
  9. package/dist/{cli-R2MUZQE2.js → cli-3HZGJRQW.js} +11 -11
  10. package/dist/{cli-PGCIHPU7.js → cli-3OCKRPXI.js} +18 -18
  11. package/dist/{cli-64AB62PM.js → cli-3OVXQJEW.js} +2 -2
  12. package/dist/{cli-4UWFQNGF.js → cli-3VV2JLHX.js} +1 -1
  13. package/dist/{cli-XSLNH5PR.js → cli-42ZUP4X3.js} +141 -5
  14. package/dist/{cli-ZJFQ7EEA.js → cli-4B5OBHSY.js} +19 -19
  15. package/dist/{cli-7A6MKCUJ.js → cli-4EMNCU63.js} +27 -19
  16. package/dist/cli-5CG6BMCY.js +36 -0
  17. package/dist/{cli-XZCJIKIV.js → cli-5FRKWNVP.js} +19 -19
  18. package/dist/{cli-Y3DDNMPX.js → cli-5P66N5G6.js} +17 -17
  19. package/dist/{cli-6VNKQ3OX.js → cli-5SYPXJCB.js} +28 -16
  20. package/dist/{cli-G6CANSPL.js → cli-66AHBZRZ.js} +15 -15
  21. package/dist/{cli-BJMS3VX3.js → cli-6AGWTGTO.js} +106 -28
  22. package/dist/{cli-TTMBBEJC.js → cli-6BAZE75K.js} +18 -18
  23. package/dist/{cli-GFNDW2DL.js → cli-6FVHRL3H.js} +19 -19
  24. package/dist/{cli-QVASWX2A.js → cli-6GDPO5VU.js} +2 -2
  25. package/dist/{cli-7XLHO2FE.js → cli-6NBER36P.js} +1 -1
  26. package/dist/{cli-FQRVFGN6.js → cli-726NJARI.js} +0 -0
  27. package/dist/{cli-CD5CIJZI.js → cli-72DRYVTT.js} +13 -13
  28. package/dist/{cli-MMN4BPO4.js → cli-7CW2BBJG.js} +1 -1
  29. package/dist/{cli-XAT25PRU.js → cli-7GJGFILU.js} +15 -15
  30. package/dist/{cli-HFX3YPUL.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-KGM6RRQW.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-DOXRQ3S5.js → cli-C7YZNPWX.js} +11 -11
  41. package/dist/{cli-HOE3WLFH.js → cli-CAX4CQTC.js} +13 -13
  42. package/dist/{cli-YOTGR3NB.js → cli-CVOLMK3Z.js} +1 -1
  43. package/dist/{cli-ILFDANBR.js → cli-D3CZRXVJ.js} +63 -17
  44. package/dist/{cli-4YB3ROVR.js → cli-DMKRP33X.js} +1 -1
  45. package/dist/{cli-Y3O5F4JN.js → cli-DPFN2LIZ.js} +15 -15
  46. package/dist/{cli-6UTPHWRQ.js → cli-DT756M3Z.js} +20 -20
  47. package/dist/{cli-TIDQ4WUE.js → cli-DXHPYN4N.js} +1 -1
  48. package/dist/{cli-6K3VQQUS.js → cli-E665NKUQ.js} +5 -5
  49. package/dist/{cli-O5ABH2WK.js → cli-EK7CGMGS.js} +17 -17
  50. package/dist/{cli-6QB2VFPY.js → cli-ESU3J563.js} +15 -15
  51. package/dist/{cli-VPRRICZA.js → cli-F47ELAXM.js} +47 -47
  52. package/dist/{cli-RLEGRWFM.js → cli-FH4WBZHA.js} +14 -14
  53. package/dist/{cli-3D3ZXWOV.js → cli-FHKRO6OU.js} +19 -19
  54. package/dist/{cli-JZCLIT3O.js → cli-FSEDPZR5.js} +19 -19
  55. package/dist/{cli-XOTNXEJA.js → cli-FV45UZQP.js} +19 -19
  56. package/dist/{cli-AV2FYC5G.js → cli-G7FX7ZIU.js} +12 -12
  57. package/dist/{cli-IP4RXGHM.js → cli-GFONBOJT.js} +129 -38
  58. package/dist/{cli-C5QOJJWX.js → cli-GHIMH6JU.js} +1 -1
  59. package/dist/{cli-IDVUHGKG.js → cli-HC7L5DXV.js} +15 -15
  60. package/dist/{cli-WU43JT4T.js → cli-HJPNNORV.js} +2 -2
  61. package/dist/{cli-QY5NZAR7.js → cli-HMEZHQBC.js} +17 -17
  62. package/dist/{cli-JZOZOEZM.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-Z56ZIVA6.js → cli-JA6UFTSX.js} +17 -17
  67. package/dist/{cli-MJV47HKI.js → cli-JOXCAGM7.js} +19 -19
  68. package/dist/{cli-ZBN5KAIB.js → cli-JQ6I5GGE.js} +3 -3
  69. package/dist/{cli-TDSQSCX4.js → cli-K6M6YB67.js} +1 -1
  70. package/dist/{cli-C6ZLPK2U.js → cli-KFVA7DT3.js} +3 -3
  71. package/dist/{cli-KOGRWFN7.js → cli-KH6FKM5A.js} +15 -15
  72. package/dist/{cli-5IAW3LIF.js → cli-KMT235FV.js} +2 -2
  73. package/dist/{cli-ZDUADFBY.js → cli-KU4PG7ZA.js} +15 -15
  74. package/dist/{cli-N45DREM4.js → cli-L4DEEAMK.js} +17 -17
  75. package/dist/{cli-MU5LB43S.js → cli-ME3JKMJL.js} +19 -19
  76. package/dist/{cli-C3CMJSNL.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-4SIWLHQO.js → cli-MPU4FLA7.js} +4 -4
  80. package/dist/{cli-HCRTYQQS.js → cli-MPWTXNF6.js} +2 -2
  81. package/dist/{cli-EVI36HEM.js → cli-N5K2KHPR.js} +15 -15
  82. package/dist/{cli-RSW6EBBD.js → cli-NGOQWOQE.js} +15 -15
  83. package/dist/{cli-ZTWOE3ZT.js → cli-NU4SCD5D.js} +1 -1
  84. package/dist/{cli-BYCHKSSH.js → cli-O3IMNLN2.js} +282 -96
  85. package/dist/{cli-KGT5L7VZ.js → cli-OUFXSQOW.js} +7265 -4467
  86. package/dist/{cli-DFBTZEBX.js → cli-PEY6XZDE.js} +16 -16
  87. package/dist/{cli-QUSCIUOM.js → cli-PLW3TWJ7.js} +19 -19
  88. package/dist/{cli-JVI24FI6.js → cli-PO2ALWHP.js} +13 -13
  89. package/dist/{cli-3BRC32CP.js → cli-PPEB3ENS.js} +18 -18
  90. package/dist/{cli-ZDOTXEKL.js → cli-PZ7G544B.js} +3 -3
  91. package/dist/{cli-L7VYSXQK.js → cli-Q5BKFFDL.js} +4 -4
  92. package/dist/{cli-3ZKWV3PN.js → cli-QAI6T5FL.js} +15 -15
  93. package/dist/{cli-KSGB2ZLK.js → cli-QAVLRCQ5.js} +3 -3
  94. package/dist/{cli-VDBW23SS.js → cli-QDIH2G2P.js} +15 -15
  95. package/dist/cli-SN7D7HTX.js +36 -0
  96. package/dist/{cli-IEMKI7J7.js → cli-SOQJHK4Q.js} +6 -6
  97. package/dist/{cli-4PXNOJQX.js → cli-SPKPDXWD.js} +15 -15
  98. package/dist/{cli-MOPSZ3CS.js → cli-SWUAXVIJ.js} +15 -15
  99. package/dist/cli-TJNLXQJ5.js +36 -0
  100. package/dist/{cli-BUQI5UU4.js → cli-U2EWI6H5.js} +11 -11
  101. package/dist/{cli-TT36JCU5.js → cli-UADUC4JD.js} +2 -2
  102. package/dist/{cli-FWFRKQNE.js → cli-UR63LFVK.js} +2 -2
  103. package/dist/{cli-J4UBELKF.js → cli-UTHPCZYL.js} +2 -2
  104. package/dist/{cli-Q6ZBZYK2.js → cli-UYV3BDPA.js} +3 -3
  105. package/dist/{cli-LQOHATY2.js → cli-UZCQL6YP.js} +3 -3
  106. package/dist/{cli-HKORECAG.js → cli-V5K3CCYZ.js} +2 -2
  107. package/dist/cli-V7L3HEL4.js +36 -0
  108. package/dist/{cli-HSIHDN6K.js → cli-VBSF3R3L.js} +16 -16
  109. package/dist/{cli-NROTDF5Y.js → cli-VQ4OJ4KE.js} +18 -18
  110. package/dist/{cli-IUS2YCD3.js → cli-VTLFQHDO.js} +1 -1
  111. package/dist/{cli-JJSWBW4H.js → cli-W7XCTGQ7.js} +15 -15
  112. package/dist/{cli-UZZFNXRX.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-TTKICM5P.js → cli-YLYB4ITF.js} +13 -13
  117. package/dist/{cli-72XDEFU3.js → cli-ZFY6TGU7.js} +4 -4
  118. package/dist/{cli-6SGCYEEC.js → cli-ZSKP2IRP.js} +53 -38
  119. package/dist/cli.js +53 -51
  120. package/dist/client.js +17699 -16630
  121. package/dist/core/game-settings.d.ts +5 -3
  122. package/dist/core/save-scenario.d.ts +1 -0
  123. package/dist/core/session-roster.d.ts +10 -0
  124. package/dist/core/session-start-gate.d.ts +25 -0
  125. package/dist/core/session.d.ts +4 -0
  126. package/dist/dev/console/assets/index-CVNjiRUh.js +208 -0
  127. package/dist/dev/console/index.html +1 -1
  128. package/dist/dev/routes.d.ts +5 -2
  129. package/dist/dev/shell.d.ts +9 -1
  130. package/dist/dev/view/batch.d.ts +11 -1
  131. package/dist/dev/view/route.d.ts +18 -1
  132. package/dist/dev/view/view.d.ts +9 -0
  133. package/dist/docs/api/deck.md +1 -1
  134. package/dist/docs/api/index.md +2 -2
  135. package/dist/docs/api/sdk-commands.md +4 -0
  136. package/dist/docs/api/sdk-e2e.md +12 -6
  137. package/dist/docs/api/sdk-projection.md +1 -0
  138. package/dist/docs/api/sdk-tools-client.md +7 -1
  139. package/dist/docs/api/sdk-tools-playwright.md +1 -8
  140. package/dist/docs/api/sdk-ui-testing.md +1 -0
  141. package/dist/docs/api/sdk-ui.md +67 -63
  142. package/dist/docs/api/sdk.md +12 -1
  143. package/dist/docs/changelog.md +26 -0
  144. package/dist/docs/cli-and-dev-server.md +4 -0
  145. package/dist/docs/cli-error-codes.md +7 -1
  146. package/dist/docs/cli-reference.md +20 -2
  147. package/dist/docs/concepts/index.md +1 -0
  148. package/dist/docs/guides/engine.md +5 -0
  149. package/dist/docs/guides/file-handling.md +4 -1
  150. package/dist/docs/guides/llm-integration.md +3 -2
  151. package/dist/docs/guides/multi-team-games.md +2 -0
  152. package/dist/docs/guides/patterns.md +5 -0
  153. package/dist/docs/guides/presentation.md +11 -10
  154. package/dist/docs/guides/session-hooks.md +16 -0
  155. package/dist/docs/guides/session.md +1 -1
  156. package/dist/docs/guides/settings.md +6 -2
  157. package/dist/docs/guides/setup.md +23 -2
  158. package/dist/docs/guides/speech-generation.md +1 -0
  159. package/dist/docs/guides/testing.md +2 -0
  160. package/dist/docs/guides/tick-controller.md +2 -0
  161. package/dist/docs/guides/type-safety.md +2 -1
  162. package/dist/docs/guides/ui-files-and-llms.md +3 -1
  163. package/dist/docs/guides/upgrading.md +16 -0
  164. package/dist/docs/guides/validators.md +27 -4
  165. package/dist/docs/guides/waiting-room.md +2 -0
  166. package/dist/docs/page-index.md +12 -10
  167. package/dist/docs/recipes/call-endpoint-from-ui.md +1 -0
  168. package/dist/docs/recipes/create-scenario-editor.md +2 -1
  169. package/dist/docs/recipes/create-setup.md +2 -1
  170. package/dist/docs/recipes/declare-api-uses.md +1 -0
  171. package/dist/docs/recipes/describe-setup-with-endpoint.md +69 -0
  172. package/dist/docs/recipes/index.md +3 -1
  173. package/dist/docs/recipes/share-logic-between-engine-and-ui.md +2 -2
  174. package/dist/docs/recipes/test-user-interface.md +1 -1
  175. package/dist/docs/recipes/validate-scenarios.md +9 -3
  176. package/dist/docs/recipes/write-setup-notes.md +58 -0
  177. package/dist/docs/troubleshooting.md +2 -1
  178. package/dist/execution/executor.d.ts +12 -0
  179. package/dist/execution/scenario-gates.d.ts +40 -0
  180. package/dist/host/protocol.d.ts +10 -1
  181. package/dist/host.js +1083 -467
  182. package/dist/playwright.js +17760 -16691
  183. package/dist/runtime/manifest-version.d.ts +1 -1
  184. package/dist/runtime.js +4 -2
  185. package/dist/schema.json +10 -1
  186. package/dist/setup/setup-notes.d.ts +42 -0
  187. package/dist/templates/package/package.json.liquid +15 -15
  188. package/dist/templates/starter-game/package.json +13 -13
  189. package/dist/utils/error-codes.d.ts +13 -1
  190. package/dist/validation/package-validation.d.ts +1 -1
  191. package/package.json +22 -23
  192. package/dist/cli-2GZYGRVL.js +0 -36
  193. package/dist/cli-5SM367K7.js +0 -30
  194. package/dist/cli-DDJYUKQG.js +0 -36
  195. package/dist/cli-LK3V4RI5.js +0 -36
  196. package/dist/cli-N24OHSAN.js +0 -36
  197. package/dist/cli-OMWC75CC.js +0 -256
  198. package/dist/cli-RCIWBCXD.js +0 -36
  199. package/dist/cli-UMEBPAZQ.js +0 -16
  200. package/dist/cli-VQ6HVQW4.js +0 -4010
  201. package/dist/cli-WR3NOY74.js +0 -36
  202. package/dist/dev/console/assets/index-CuMOOH9m.js +0 -204
@@ -4,12 +4,12 @@ import {
4
4
  } from "./cli-BWX5E7TQ.js";
5
5
  import {
6
6
  validatePackage
7
- } from "./cli-BJMS3VX3.js";
7
+ } from "./cli-6AGWTGTO.js";
8
8
  import {
9
9
  PackageScenarioError,
10
10
  createPackageScenario,
11
11
  deletePackageScenario
12
- } from "./cli-FQRVFGN6.js";
12
+ } from "./cli-726NJARI.js";
13
13
  import {
14
14
  PENDING_CHANGES_HINT,
15
15
  REINITIALISED_ON_CHANGE,
@@ -20,22 +20,25 @@ import {
20
20
  isQuery,
21
21
  pendingHeadline,
22
22
  rebuildsWalkthrough
23
- } from "./cli-XSLNH5PR.js";
23
+ } from "./cli-42ZUP4X3.js";
24
24
  import {
25
25
  newInstanceId,
26
26
  removeLockFile,
27
27
  writeLockFile
28
- } from "./cli-SRHBXZCN.js";
28
+ } from "./cli-Y33ULHYO.js";
29
29
  import {
30
30
  hmrClientTarget,
31
31
  publicAssetOrigin,
32
32
  publicHmrOrigin,
33
33
  publicHostnames
34
- } from "./cli-YOTGR3NB.js";
34
+ } from "./cli-CVOLMK3Z.js";
35
35
  import {
36
36
  describeScenarioProblems,
37
- runScenarioGates
38
- } from "./cli-OMWC75CC.js";
37
+ onlyOverran,
38
+ partitionProblems,
39
+ runScenarioGates,
40
+ withOverrunRetry
41
+ } from "./cli-O3IMNLN2.js";
39
42
  import {
40
43
  mediaTypeOf,
41
44
  readBlob,
@@ -47,16 +50,17 @@ import {
47
50
  createAjv,
48
51
  errorMessage,
49
52
  gameSettingsOf,
53
+ readSetupNotes,
50
54
  settingsSchemas,
51
55
  withoutLockedDefaults
52
- } from "./cli-VQ6HVQW4.js";
56
+ } from "./cli-OUFXSQOW.js";
53
57
  import {
54
58
  logger
55
- } from "./cli-4YB3ROVR.js";
59
+ } from "./cli-DMKRP33X.js";
56
60
  import {
57
61
  CliError,
58
62
  diagnosticLocation
59
- } from "./cli-N6H6T2E2.js";
63
+ } from "./cli-AEAFLZGY.js";
60
64
 
61
65
  // cli/dev/view/route.ts
62
66
  var PATTERNS = [
@@ -66,6 +70,7 @@ var PATTERNS = [
66
70
  [/^\/team\/(\d+)\/observe\/?$/, (m) => ({ kind: "observer", teamIndex: index(m[1]) })],
67
71
  [/^\/team\/(\d+)\/join\/?$/, (m) => ({ kind: "join", teamIndex: index(m[1]) })],
68
72
  [/^\/team\/(\d+)\/waiting-room\/?$/, (m) => ({ kind: "waiting-room", teamIndex: index(m[1]) })],
73
+ [/^\/join\/?$/, () => ({ kind: "session-join" })],
69
74
  [/^\/setup\/?$/, () => ({ kind: "setup" })],
70
75
  [/^\/scenario-editor\/?$/, () => ({ kind: "scenario-editor" })],
71
76
  [/^\/guide\/?$/, () => ({ kind: "guide" })],
@@ -82,6 +87,10 @@ function player(team, participant) {
82
87
  function index(team) {
83
88
  return Math.max(0, Number(team) - 1);
84
89
  }
90
+ var LOCAL_ORIGINS_FLAG = "local-origins";
91
+ function wantsLocalOrigins(search) {
92
+ return new URLSearchParams(search).has(LOCAL_ORIGINS_FLAG);
93
+ }
85
94
  function parseRoute(pathname, search) {
86
95
  const query = new URLSearchParams(search);
87
96
  const bare = query.has("bare");
@@ -104,7 +113,7 @@ function parseRoute(pathname, search) {
104
113
  }
105
114
  function routeHref(route) {
106
115
  const team = (route.teamIndex ?? 0) + 1;
107
- const path = route.run === "walkthrough" ? "/walkthrough" : route.kind === "player" ? `/team/${team}/player/${route.participant ?? 1}` : route.kind === "observer" ? `/team/${team}/observe` : route.kind === "join" ? `/team/${team}/join` : route.kind === "waiting-room" ? `/team/${team}/waiting-room` : route.kind === "console" ? "/" : `/${route.kind}`;
116
+ const path = route.run === "walkthrough" ? "/walkthrough" : route.kind === "player" ? `/team/${team}/player/${route.participant ?? 1}` : route.kind === "observer" ? `/team/${team}/observe` : route.kind === "join" ? `/team/${team}/join` : route.kind === "session-join" ? "/join" : route.kind === "waiting-room" ? `/team/${team}/waiting-room` : route.kind === "console" ? "/" : `/${route.kind}`;
108
117
  const query = new URLSearchParams();
109
118
  if (route.scenario !== void 0) query.set("scenario", route.scenario);
110
119
  if (route.preview) query.set("preview", "");
@@ -810,23 +819,34 @@ async function saveSessionScenario(session, packagePath, request) {
810
819
  throw new SaveScenarioError("denied", refusals.join("\n"));
811
820
  }
812
821
  const config = session.packageConfiguration();
822
+ let warnings = [];
813
823
  if (config) {
814
- const problems = await runScenarioGates({
815
- packagePath,
816
- config,
817
- scenarioSettings: settings,
818
- locale: projection.session.locale,
819
- // Its files as a session on it would find them: a draft's in the
820
- // scenario it was opened on and the blobs it can read, the
821
- // session's in its scenario and every blob it holds (§6.12, §15.8).
822
- files: {
823
- scenarioRoot: source?.rootDirectory ?? null,
824
- blobs: request.draft === true ? "draft" : "all"
825
- }
826
- });
827
- if (problems.length > 0) {
828
- throw new SaveScenarioError("denied", describeScenarioProblems(problems).join("\n"));
824
+ const problems = await withOverrunRetry(
825
+ () => runScenarioGates({
826
+ packagePath,
827
+ config,
828
+ scenarioSettings: settings,
829
+ locale: projection.session.locale,
830
+ // Its files as a session on it would find them: a draft's in the
831
+ // scenario it was opened on and the blobs it can read, the
832
+ // session's in its scenario and every blob it holds (§6.12, §15.8).
833
+ files: {
834
+ scenarioRoot: source?.rootDirectory ?? null,
835
+ blobs: request.draft === true ? "draft" : "all"
836
+ }
837
+ })
838
+ );
839
+ const { blocking, warnings: warned } = partitionProblems(problems);
840
+ if (onlyOverran(blocking)) {
841
+ throw new SaveScenarioError(
842
+ "denied",
843
+ "The scenario was not saved: the game's own check of it 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 scenario.\n" + describeScenarioProblems(blocking).join("\n")
844
+ );
829
845
  }
846
+ if (blocking.length > 0) {
847
+ throw new SaveScenarioError("denied", describeScenarioProblems(blocking).join("\n"));
848
+ }
849
+ warnings = describeScenarioProblems(warned);
830
850
  }
831
851
  const result = await createPackageScenario({
832
852
  packagePath,
@@ -842,7 +862,7 @@ async function saveSessionScenario(session, packagePath, request) {
842
862
  });
843
863
  await session.reloadScenarios();
844
864
  if (draft) session.scenarioDraftSaved(request.identifier);
845
- return { identifier: result.identifier };
865
+ return { identifier: result.identifier, ...warnings.length > 0 ? { warnings } : {} };
846
866
  }
847
867
 
848
868
  // cli/dev/surfaces.ts
@@ -1104,6 +1124,7 @@ function sessionBatch({
1104
1124
  participants: participantList(state)
1105
1125
  },
1106
1126
  { type: "setTeamLinks", payload: teamLinks(state, origin) },
1127
+ { type: "setSessionJoinLink", payload: sessionJoinLink(state, origin) },
1107
1128
  { type: "setWalkthroughLink", payload: walkthroughLink(origin) },
1108
1129
  { type: "setRunKind", runKind: state.session.runKind },
1109
1130
  { type: "setScenarioName", scenarioName: state.game.scenarioName },
@@ -1146,7 +1167,8 @@ function presentationBatch({
1146
1167
  teamId,
1147
1168
  joinUrl: joinUrl2
1148
1169
  })),
1149
- joinPin: null
1170
+ joinPin: null,
1171
+ sessionJoinLink: sessionJoinLink(state, origin)
1150
1172
  }
1151
1173
  }
1152
1174
  },
@@ -1188,6 +1210,11 @@ function teamLinks(state, origin) {
1188
1210
  observeUrl: `${origin}/team/${team.index + 1}/observe`
1189
1211
  }));
1190
1212
  }
1213
+ function sessionJoinLink(state, origin) {
1214
+ if (state.session.runKind === "walkthrough") return null;
1215
+ if (!gameSettingsOf(state.settings).teams.sessionJoin) return null;
1216
+ return { joinUrl: `${origin}/join?bare` };
1217
+ }
1191
1218
  function teamConfiguration(state) {
1192
1219
  return {
1193
1220
  mode: state.session.mode,
@@ -1226,13 +1253,18 @@ function sessionData(state, surface) {
1226
1253
  function runOf(req) {
1227
1254
  return req.query.run === "walkthrough" ? "walkthrough" : "session";
1228
1255
  }
1256
+ function localOrigins(req, res) {
1257
+ if (req.query[LOCAL_ORIGINS_FLAG] === void 0) return false;
1258
+ res.setHeader("Cache-Control", "no-store");
1259
+ return true;
1260
+ }
1229
1261
  function registerRoutes(app, deps) {
1230
1262
  const { session, packagePath, runFor } = deps;
1231
1263
  app.get("/api/state", async (req, res) => {
1232
1264
  res.json((await runFor(runOf(req))).project());
1233
1265
  });
1234
1266
  app.get("/api/surfaces", (req, res) => {
1235
- const origin = deps.assetOrigin(req.headers.host);
1267
+ const origin = deps.assetOrigin(req.headers.host, localOrigins(req, res));
1236
1268
  res.json(
1237
1269
  mountableSurfaces(session.packageConfiguration()).map((mountable) => ({
1238
1270
  ...mountable,
@@ -1297,7 +1329,7 @@ function registerRoutes(app, deps) {
1297
1329
  });
1298
1330
  });
1299
1331
  app.get("/api/brands", (req, res) => {
1300
- const assetOrigin = deps.assetOrigin(req.headers.host);
1332
+ const assetOrigin = deps.assetOrigin(req.headers.host, localOrigins(req, res));
1301
1333
  res.json({ brands: deps.brands().map((brand) => summarise(brand, assetOrigin)) });
1302
1334
  });
1303
1335
  app.get("/api/locales", (_req, res) => {
@@ -1393,6 +1425,15 @@ function registerRoutes(app, deps) {
1393
1425
  })
1394
1426
  });
1395
1427
  });
1428
+ app.get("/api/setup/notes", (req, res) => {
1429
+ const config = session.packageConfiguration();
1430
+ const setup = config?.setup;
1431
+ const locale = typeof req.query.locale === "string" && req.query.locale !== "" ? req.query.locale : session.project().session.locale;
1432
+ const root = setup ? isAbsolute3(setup.rootDirectory) ? setup.rootDirectory : resolve2(packagePath, setup.rootDirectory) : null;
1433
+ res.json({
1434
+ notes: root ? readSetupNotes(root, locale, config?.game?.definition.supportedLocales ?? []) : null
1435
+ });
1436
+ });
1396
1437
  app.get("/api/guide/content/:locale/:chapter", async (req, res) => {
1397
1438
  const guide = session.guide();
1398
1439
  if (!guide) {
@@ -1811,6 +1852,7 @@ var VIEW_ROUTES = /* @__PURE__ */ new Set([
1811
1852
  "observer",
1812
1853
  "waiting-room",
1813
1854
  "join",
1855
+ "session-join",
1814
1856
  "setup"
1815
1857
  ]);
1816
1858
  function isViewRoute(route) {
@@ -1825,6 +1867,12 @@ function resolveView(state, route, surfaces) {
1825
1867
  if (!inSetup && effective.kind === "setup") {
1826
1868
  return { status: "closed", configurable };
1827
1869
  }
1870
+ if (effective.kind === "session-join") {
1871
+ return {
1872
+ status: "session-join",
1873
+ offered: state.session.runKind !== "walkthrough" && gameSettingsOf(state.settings).teams.sessionJoin
1874
+ };
1875
+ }
1828
1876
  if (effective.kind === "join") {
1829
1877
  const team = state.teams.find((candidate) => candidate.index === effective.teamIndex);
1830
1878
  if (!team) return { status: "join", team: null };
@@ -1896,7 +1944,7 @@ var REINITIALISING_CAUSES = /* @__PURE__ */ new Set([
1896
1944
  "selectScenario",
1897
1945
  REINITIALISED_ON_CHANGE
1898
1946
  ]);
1899
- var CONSOLE_ROUTE = /^\/(?:$|team\/\d+(?:\/(?:player(?:\/\d+)?|observe|join|waiting-room))?\/?$|walkthrough\/?$|setup\/?$|scenario-editor\/?$|guide\/?$|print\/?$|presentation\/?$)/;
1947
+ var CONSOLE_ROUTE = /^\/(?:$|team\/\d+(?:\/(?:player(?:\/\d+)?|observe|join|waiting-room))?\/?$|join\/?$|walkthrough\/?$|setup\/?$|scenario-editor\/?$|guide\/?$|print\/?$|presentation\/?$)/;
1900
1948
  var DELEGATED_FEATURES = [
1901
1949
  "clipboard-write",
1902
1950
  "autoplay",
@@ -2191,9 +2239,12 @@ var DevShell = class {
2191
2239
  * public one where given, else the same host on the asset port. A browser
2192
2240
  * on another machine reached us by an address `localhost` would not
2193
2241
  * resolve to on its side.
2242
+ *
2243
+ * `local` skips the public one, for a client that has said it runs here
2244
+ * (`?local-origins`): it may not reach the proxy in front of us at all.
2194
2245
  */
2195
- assetOrigin(host) {
2196
- const configured = this.publicAssetUrl;
2246
+ assetOrigin(host, local = false) {
2247
+ const configured = local ? null : this.publicAssetUrl;
2197
2248
  if (configured) return configured;
2198
2249
  const name = (host ?? "localhost").replace(/:\d+$/, "") || "localhost";
2199
2250
  return `http://${name}:${this.assetPort}`;
@@ -2307,7 +2358,7 @@ var DevShell = class {
2307
2358
  settleWalkthroughReset: (command) => this.settleWalkthroughReset(command),
2308
2359
  packagePath: this.options.packagePath,
2309
2360
  vitePort: () => this.vitePort,
2310
- assetOrigin: (host) => this.assetOrigin(host),
2361
+ assetOrigin: (host, local) => this.assetOrigin(host, local),
2311
2362
  instanceId: this.instanceId,
2312
2363
  notices: (run) => this.notices(run),
2313
2364
  brands: () => this.currentBrands()
@@ -2325,10 +2376,12 @@ ${MISSING_CONSOLE_MESSAGE}
2325
2376
  res.status(503).type("text/plain").send(MISSING_CONSOLE_MESSAGE);
2326
2377
  return;
2327
2378
  }
2379
+ const local = wantsLocalOrigins(req.url.split("?")[1] ?? "");
2328
2380
  res.setHeader(
2329
2381
  "Permissions-Policy",
2330
- delegatedFeatures(this.assetOrigin(req.headers.host))
2382
+ delegatedFeatures(this.assetOrigin(req.headers.host, local))
2331
2383
  );
2384
+ if (local) res.setHeader("Cache-Control", "no-store");
2332
2385
  res.sendFile("index.html", { root: console_.path });
2333
2386
  });
2334
2387
  this.app.use(express2.static(console_.path));
@@ -2528,7 +2581,11 @@ Install the package's dependencies to serve its surfaces.
2528
2581
  socket.close(4e3, "Not a viewer page");
2529
2582
  return;
2530
2583
  }
2531
- this.views.set(socket, { route, host: request.headers.host });
2584
+ this.views.set(socket, {
2585
+ route,
2586
+ host: request.headers.host,
2587
+ localOrigins: wantsLocalOrigins(location.search)
2588
+ });
2532
2589
  void this.sendView(socket).then(() => this.syncPresence(route.run));
2533
2590
  socket.on("message", (raw) => void this.receiveView(socket, raw));
2534
2591
  socket.on("close", () => {
@@ -2588,7 +2645,10 @@ Install the package's dependencies to serve its surfaces.
2588
2645
  // -----------------------------------------------------------------------
2589
2646
  /** What one viewer page is owed, now. */
2590
2647
  viewOf(session, view, state = session.project()) {
2591
- const origin = this.assetOrigin(view.host);
2648
+ if (view.joined !== void 0) {
2649
+ return { page: { status: "redirect", href: view.joined }, messages: [] };
2650
+ }
2651
+ const origin = this.assetOrigin(view.host, view.localOrigins);
2592
2652
  const surfaces = mountableSurfaces(session.packageConfiguration()).map(
2593
2653
  (surface) => ({ ...surface, origin })
2594
2654
  );
@@ -2729,7 +2789,9 @@ Install the package's dependencies to serve its surfaces.
2729
2789
  try {
2730
2790
  const session = await this.runFor(view.route.run);
2731
2791
  const { page } = this.viewOf(session, view);
2732
- if (page.status === "surface") {
2792
+ if (page.status === "session-join" && frameMessage.type === "joinSession") {
2793
+ result = await this.joinThroughSessionLink(session, view, socket, frameMessage);
2794
+ } else if (page.status === "surface") {
2733
2795
  const command = queryFor(frameMessage, page.surface, page.viewer) ?? commandFor(frameMessage, page.surface, page.viewer);
2734
2796
  if (isFrameRefusal(command)) {
2735
2797
  result = { ok: false, outcome: { kind: "denied", message: command.refused } };
@@ -2745,6 +2807,34 @@ Install the package's dependencies to serve its surfaces.
2745
2807
  }
2746
2808
  if (requestId) send(socket, { type: "result", requestId, result });
2747
2809
  }
2810
+ /**
2811
+ * Join from the session link's page (§13.4): the session places the
2812
+ * newcomer, and the page is sent on to the participant it made.
2813
+ */
2814
+ async joinThroughSessionLink(session, view, socket, message) {
2815
+ const before = new Set(
2816
+ session.project().teams.flatMap((t) => t.participants.map((p) => p.id))
2817
+ );
2818
+ const name = typeof message.name === "string" ? message.name : void 0;
2819
+ const result = await session.submit({
2820
+ type: "joinSession",
2821
+ ...name === void 0 ? {} : { name }
2822
+ });
2823
+ if (!result.ok) return result;
2824
+ for (const team of session.project().teams) {
2825
+ const position = team.participants.findIndex((p) => !before.has(p.id));
2826
+ if (position === -1) continue;
2827
+ view.joined = routeHref({
2828
+ kind: "player",
2829
+ teamIndex: team.index,
2830
+ participant: position + 1,
2831
+ bare: true
2832
+ });
2833
+ await this.sendView(socket, session);
2834
+ break;
2835
+ }
2836
+ return result;
2837
+ }
2748
2838
  broadcast(event, run) {
2749
2839
  let payload = null;
2750
2840
  this.sockets?.clients.forEach((client) => {
@@ -2842,6 +2932,7 @@ function hmrConnectSources(host, vitePort) {
2842
2932
  }
2843
2933
 
2844
2934
  export {
2935
+ LOCAL_ORIGINS_FLAG,
2845
2936
  parseRoute,
2846
2937
  DevShell
2847
2938
  };
@@ -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/dev/default-port.ts
7
7
  var DEV_PORT_ENV_VAR = "SERIOUSGAMING_DEV_PORT";
@@ -1,11 +1,11 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  guessMimeType
4
- } from "./cli-2BH7FX27.js";
4
+ } from "./cli-2FXZZLCL.js";
5
5
  import {
6
6
  resolveSession
7
- } from "./cli-6K3VQQUS.js";
8
- import "./cli-WU43JT4T.js";
7
+ } from "./cli-E665NKUQ.js";
8
+ import "./cli-HJPNNORV.js";
9
9
  import {
10
10
  blobLinks
11
11
  } from "./cli-BWX5E7TQ.js";
@@ -17,31 +17,31 @@ import {
17
17
  staleError,
18
18
  staleOf,
19
19
  teamIndexFromArgument
20
- } from "./cli-L7VYSXQK.js";
21
- import "./cli-FQRVFGN6.js";
22
- import "./cli-XSLNH5PR.js";
23
- import "./cli-TDSQSCX4.js";
24
- import "./cli-SRHBXZCN.js";
25
- import "./cli-KGT5L7VZ.js";
20
+ } from "./cli-Q5BKFFDL.js";
21
+ import "./cli-726NJARI.js";
22
+ import "./cli-42ZUP4X3.js";
23
+ import "./cli-K6M6YB67.js";
24
+ import "./cli-Y33ULHYO.js";
25
+ import "./cli-WWNTBK37.js";
26
26
  import "./cli-4LKXZQ2B.js";
27
- import "./cli-MMN4BPO4.js";
27
+ import "./cli-7CW2BBJG.js";
28
28
  import {
29
29
  resolveInputSource
30
- } from "./cli-4UWFQNGF.js";
30
+ } from "./cli-3VV2JLHX.js";
31
31
  import "./cli-QUNIRH7A.js";
32
32
  import {
33
33
  logicErrorOf
34
- } from "./cli-BYCHKSSH.js";
34
+ } from "./cli-O3IMNLN2.js";
35
35
  import "./cli-25RWY5BQ.js";
36
36
  import {
37
37
  readBlob
38
38
  } from "./cli-QWQMPCL6.js";
39
- import "./cli-VQ6HVQW4.js";
39
+ import "./cli-OUFXSQOW.js";
40
40
  import "./cli-F2D4GGUA.js";
41
- import "./cli-4YB3ROVR.js";
41
+ import "./cli-DMKRP33X.js";
42
42
  import {
43
43
  CliError
44
- } from "./cli-N6H6T2E2.js";
44
+ } from "./cli-AEAFLZGY.js";
45
45
 
46
46
  // cli/commands/endpoint-call.ts
47
47
  import { existsSync } from "fs";
@@ -3,10 +3,10 @@ import {
3
3
  isAlive,
4
4
  lockOnDisk,
5
5
  removeLockFile
6
- } from "./cli-SRHBXZCN.js";
6
+ } from "./cli-Y33ULHYO.js";
7
7
  import {
8
8
  CliError
9
- } from "./cli-N6H6T2E2.js";
9
+ } from "./cli-AEAFLZGY.js";
10
10
 
11
11
  // cli/dev/stop-server.ts
12
12
  var GRACE_MS = 5e3;
@@ -1,46 +1,46 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  resolvePatchedDefinition
4
- } from "./cli-5IAW3LIF.js";
4
+ } from "./cli-KMT235FV.js";
5
5
  import "./cli-S5IVGDDD.js";
6
6
  import {
7
7
  readAuthoredBundle
8
- } from "./cli-4VFZHLDG.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
  updateSessionUserInterfaceFiles
14
- } from "./cli-4SIWLHQO.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-J4UBELKF.js";
17
+ import "./cli-UTHPCZYL.js";
18
18
  import {
19
19
  loadPackageContext
20
- } from "./cli-XSVGKI3R.js";
21
- import "./cli-TT36JCU5.js";
22
- import "./cli-OXAUOWCN.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-KSGB2ZLK.js";
28
- import "./cli-LQOHATY2.js";
29
- import "./cli-IEMKI7J7.js";
30
- import "./cli-OMWC75CC.js";
31
- import "./cli-BYCHKSSH.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
  validateSDKSessionUserInterface
36
- } from "./cli-VQ6HVQW4.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/session/update.ts
46
46
  async function updateSessionUserInterface(definitionInput, options) {
@@ -1,52 +1,52 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  resolvePatchedDefinition
4
- } from "./cli-5IAW3LIF.js";
4
+ } from "./cli-KMT235FV.js";
5
5
  import "./cli-S5IVGDDD.js";
6
6
  import {
7
7
  getResourceIdentifierError,
8
8
  readAuthoredBundle
9
- } from "./cli-4VFZHLDG.js";
9
+ } from "./cli-3HPAKEJJ.js";
10
10
  import {
11
11
  resolveInputSource
12
- } from "./cli-4UWFQNGF.js";
12
+ } from "./cli-3VV2JLHX.js";
13
13
  import {
14
14
  updateEndpointFiles
15
- } from "./cli-4SIWLHQO.js";
16
- import "./cli-IUS2YCD3.js";
15
+ } from "./cli-MPU4FLA7.js";
16
+ import "./cli-VTLFQHDO.js";
17
17
  import "./cli-QUNIRH7A.js";
18
- import "./cli-J4UBELKF.js";
18
+ import "./cli-UTHPCZYL.js";
19
19
  import {
20
20
  loadPackageContext
21
- } from "./cli-XSVGKI3R.js";
22
- import "./cli-TT36JCU5.js";
21
+ } from "./cli-BC4KKNLA.js";
22
+ import "./cli-UADUC4JD.js";
23
23
  import {
24
24
  findBundleFile
25
- } from "./cli-OXAUOWCN.js";
25
+ } from "./cli-2QM63J3I.js";
26
26
  import {
27
27
  operationError,
28
28
  printOperationResult,
29
29
  regenerateTypes
30
- } from "./cli-KSGB2ZLK.js";
30
+ } from "./cli-QAVLRCQ5.js";
31
31
  import {
32
32
  input
33
- } from "./cli-ZTWOE3ZT.js";
34
- import "./cli-LQOHATY2.js";
35
- import "./cli-IEMKI7J7.js";
36
- import "./cli-OMWC75CC.js";
37
- import "./cli-BYCHKSSH.js";
33
+ } from "./cli-NU4SCD5D.js";
34
+ import "./cli-UZCQL6YP.js";
35
+ import "./cli-SOQJHK4Q.js";
36
+ import "./cli-7S4G4EKK.js";
37
+ import "./cli-O3IMNLN2.js";
38
38
  import "./cli-25RWY5BQ.js";
39
39
  import "./cli-QWQMPCL6.js";
40
40
  import {
41
41
  validateSDKEndpoint
42
- } from "./cli-VQ6HVQW4.js";
42
+ } from "./cli-OUFXSQOW.js";
43
43
  import "./cli-F2D4GGUA.js";
44
44
  import {
45
45
  logger
46
- } from "./cli-4YB3ROVR.js";
46
+ } from "./cli-DMKRP33X.js";
47
47
  import {
48
48
  CliError
49
- } from "./cli-N6H6T2E2.js";
49
+ } from "./cli-AEAFLZGY.js";
50
50
 
51
51
  // cli/commands/resources/endpoint/update.ts
52
52
  import { readFileSync } from "fs";
@@ -5,7 +5,7 @@ import {
5
5
  import {
6
6
  CliError,
7
7
  reportResult
8
- } from "./cli-N6H6T2E2.js";
8
+ } from "./cli-AEAFLZGY.js";
9
9
 
10
10
  // cli/commands/docs-export.ts
11
11
  import { cpSync, existsSync } from "fs";
@@ -6,13 +6,13 @@ import {
6
6
  resolveGlobalSettingsPath,
7
7
  saveGlobalSettings,
8
8
  setGlobalSetting
9
- } from "./cli-MMN4BPO4.js";
9
+ } from "./cli-7CW2BBJG.js";
10
10
  import {
11
11
  logger
12
- } from "./cli-4YB3ROVR.js";
12
+ } from "./cli-DMKRP33X.js";
13
13
  import {
14
14
  reportResult
15
- } from "./cli-N6H6T2E2.js";
15
+ } from "./cli-AEAFLZGY.js";
16
16
 
17
17
  // cli/commands/config.ts
18
18
  async function configPathCommand() {
@@ -1,11 +1,11 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  bundlePackage
4
- } from "./cli-J4DKUUTK.js";
4
+ } from "./cli-7V6GUIIS.js";
5
5
  import {
6
6
  loadEnvironmentConfig
7
- } from "./cli-TDSQSCX4.js";
8
- import "./cli-MMN4BPO4.js";
7
+ } from "./cli-K6M6YB67.js";
8
+ import "./cli-7CW2BBJG.js";
9
9
  import {
10
10
  DEFAULT_PLATFORM_HOST,
11
11
  formatPlatformErrors,
@@ -13,11 +13,11 @@ import {
13
13
  } from "./cli-25RWY5BQ.js";
14
14
  import {
15
15
  logger
16
- } from "./cli-4YB3ROVR.js";
16
+ } from "./cli-DMKRP33X.js";
17
17
  import {
18
18
  CliError,
19
19
  reportResult
20
- } from "./cli-N6H6T2E2.js";
20
+ } from "./cli-AEAFLZGY.js";
21
21
 
22
22
  // cli/commands/package-publish.ts
23
23
  import { existsSync, readFileSync, statSync } from "fs";