@seriousgaming/sdk-tools 1.11.0 → 1.12.1

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 (192) hide show
  1. package/dist/agent/guidance.md +4 -0
  2. package/dist/{cli-F2D4GGUA.js → cli-2BKEIIA3.js} +66 -0
  3. package/dist/{cli-ZGCG6C22.js → cli-2QGTDHRX.js} +21 -21
  4. package/dist/{cli-SRXDLMXY.js → cli-2SDG3SZ7.js} +21 -21
  5. package/dist/{cli-DH35TZ2Q.js → cli-2VXP34R5.js} +2 -2
  6. package/dist/{cli-P3NUTOPK.js → cli-2W4B6PD5.js} +1 -1
  7. package/dist/{cli-WJVPSVF2.js → cli-2X7DKSXN.js} +24 -24
  8. package/dist/{cli-ATAJSIXH.js → cli-2ZP4N7HK.js} +19 -19
  9. package/dist/{cli-5O7XENQY.js → cli-3GJYZH4C.js} +5 -5
  10. package/dist/{cli-H6PP2MZT.js → cli-3GO3M2MX.js} +17 -13
  11. package/dist/{cli-HMDYG6PS.js → cli-3LDLUNME.js} +17 -17
  12. package/dist/{cli-BZOKZ7LP.js → cli-3WY6L2WP.js} +27 -27
  13. package/dist/{cli-REAM7LSC.js → cli-44MBABRD.js} +25 -25
  14. package/dist/{cli-5TTJWM2R.js → cli-4IO7MKLR.js} +20 -20
  15. package/dist/{cli-HNDFANQG.js → cli-4U2PY7W3.js} +1 -1
  16. package/dist/{cli-WQ7JBZNW.js → cli-4WI4LTBI.js} +2 -2
  17. package/dist/{cli-OTBCA54D.js → cli-55EIGGZK.js} +1 -1
  18. package/dist/{cli-FYPW25VD.js → cli-5AQV6FTL.js} +18 -18
  19. package/dist/{cli-RKPQLB7J.js → cli-5CW7BEU7.js} +3 -3
  20. package/dist/{cli-27TQVLVF.js → cli-5JUVHNZF.js} +12 -12
  21. package/dist/{cli-F3YJKP6D.js → cli-5KERL6HV.js} +9 -4
  22. package/dist/{cli-MSNSXVGF.js → cli-5KSA24NQ.js} +24 -24
  23. package/dist/{cli-5VZBFMCK.js → cli-5PIFO3EN.js} +8 -0
  24. package/dist/{cli-FT3X3D4P.js → cli-5QN2Z43X.js} +20 -20
  25. package/dist/cli-5XSPAA5X.js +69 -0
  26. package/dist/{cli-B2QAJ5RQ.js → cli-62KAYGXO.js} +20 -20
  27. package/dist/{cli-QPV3TYOM.js → cli-6IMV5ZZU.js} +26 -26
  28. package/dist/{cli-UULZSQBV.js → cli-6KWCIAN2.js} +764 -66
  29. package/dist/{cli-DQE7ITIR.js → cli-6NWETIX5.js} +20 -20
  30. package/dist/{cli-UVIURDZC.js → cli-7224T6HG.js} +20 -20
  31. package/dist/{cli-L7F4XKCB.js → cli-774W3MN5.js} +26 -26
  32. package/dist/cli-7BUD3VAD.js +16 -0
  33. package/dist/{cli-XNOAO6DY.js → cli-7KEP57S7.js} +12 -12
  34. package/dist/{cli-5UKWX3IU.js → cli-7OYFJMA6.js} +18 -18
  35. package/dist/{cli-WNHMJM3Z.js → cli-7ZNEDQ3G.js} +20 -20
  36. package/dist/{cli-5RRPUL6V.js → cli-AFK6OUID.js} +12 -12
  37. package/dist/{cli-6P6V2EHY.js → cli-AIYQFWXN.js} +25 -25
  38. package/dist/{cli-ERJNDBDH.js → cli-ARAAEWIQ.js} +2 -2
  39. package/dist/cli-AVQYV3N4.js +36 -0
  40. package/dist/{cli-TI2FOFPA.js → cli-B54Z6CXH.js} +16 -16
  41. package/dist/{cli-EEO5ZPAZ.js → cli-B5TC4MEL.js} +5 -5
  42. package/dist/{cli-5Z4D3F6Y.js → cli-BCXGOLU3.js} +3 -3
  43. package/dist/{cli-G2GLW5Z4.js → cli-BHAODVTZ.js} +1 -1
  44. package/dist/{cli-4F24FUW6.js → cli-BPS2JG74.js} +20 -20
  45. package/dist/{cli-W3RG2MRI.js → cli-BVO55SR2.js} +2 -2
  46. package/dist/{cli-R5SNTPND.js → cli-CFH3JZP5.js} +21 -21
  47. package/dist/{cli-Q7QSWNY2.js → cli-CTK2OIK6.js} +20 -20
  48. package/dist/{cli-ATWJCB2G.js → cli-CW5MV4VX.js} +4 -4
  49. package/dist/{cli-TCQJL2GY.js → cli-D5VOSJZ7.js} +1 -1
  50. package/dist/{cli-KIZTASLL.js → cli-DAEPMK7A.js} +5 -5
  51. package/dist/{cli-44CM2AH2.js → cli-DAHR7PKB.js} +1 -1
  52. package/dist/{cli-XW3JLRSA.js → cli-DWDSBTYL.js} +1 -1
  53. package/dist/cli-DYSDPGXW.js +95 -0
  54. package/dist/{cli-QEFYDXMH.js → cli-DZCLRZXJ.js} +1 -1
  55. package/dist/{cli-TEBV2OIW.js → cli-EG2VP7IV.js} +116 -27
  56. package/dist/{cli-77T4LJQF.js → cli-EJ47IE45.js} +24 -24
  57. package/dist/{cli-QDBYFITU.js → cli-EK4OSJHA.js} +2 -2
  58. package/dist/{cli-GO64NABP.js → cli-FCJHNXDA.js} +1 -1
  59. package/dist/{cli-ZNQBF4Z3.js → cli-FNESSE3L.js} +1 -1
  60. package/dist/{cli-D3S7NJZ3.js → cli-FTLH4WCE.js} +17 -17
  61. package/dist/{cli-JHLWBRXB.js → cli-FYV77YS2.js} +18 -18
  62. package/dist/cli-GMJX6Q4Q.js +36 -0
  63. package/dist/{cli-7JUNA74L.js → cli-GRBVNGDW.js} +1 -1
  64. package/dist/{cli-XKAIDYIE.js → cli-HAFCFY77.js} +33 -19
  65. package/dist/{cli-OXLOGXT3.js → cli-HCJLYI24.js} +3 -3
  66. package/dist/{cli-XOYUTNER.js → cli-HCXS5EXU.js} +25 -25
  67. package/dist/cli-HEUNNHDH.js +36 -0
  68. package/dist/{cli-G3TU6CP6.js → cli-HNUTIWDZ.js} +19 -19
  69. package/dist/{cli-JXQLHJO2.js → cli-HXT25ETJ.js} +244 -243
  70. package/dist/{cli-5EH4WTH4.js → cli-IGEL7UJQ.js} +5 -5
  71. package/dist/{cli-TLSTSZAC.js → cli-IO32YA5N.js} +26 -26
  72. package/dist/cli-IPTGZDBB.js +36 -0
  73. package/dist/{cli-OBLEROSC.js → cli-J25TYFKB.js} +19 -19
  74. package/dist/{cli-5ATO27Z4.js → cli-J7XYMEMX.js} +20 -20
  75. package/dist/{cli-X3TSTTYI.js → cli-JC5OJRID.js} +2 -2
  76. package/dist/{cli-25SJZI7N.js → cli-JD563OF4.js} +126 -27
  77. package/dist/{cli-VXLHOZSO.js → cli-JRJF2WHU.js} +20 -20
  78. package/dist/{cli-UQC46YSV.js → cli-JTFLIMIG.js} +3 -3
  79. package/dist/{cli-K4HSQWXC.js → cli-K2BSJ2PK.js} +2 -2
  80. package/dist/{cli-OM32UURE.js → cli-K4QTYMN2.js} +25 -25
  81. package/dist/{cli-BJFYGVJV.js → cli-KFJDD4C4.js} +20 -20
  82. package/dist/{cli-WW54THXN.js → cli-KVQ2JPVD.js} +1 -1
  83. package/dist/{cli-LHMRUJVN.js → cli-L6AHMW2Z.js} +1 -1
  84. package/dist/{cli-IKSLPAZN.js → cli-LCYUBCVY.js} +4 -4
  85. package/dist/{cli-HGCOEL5T.js → cli-LEWSCDH5.js} +4 -4
  86. package/dist/{cli-XJ7JESC2.js → cli-LI6G7GND.js} +27 -27
  87. package/dist/{cli-OMTHTWYJ.js → cli-LU2GCWIU.js} +21 -21
  88. package/dist/{cli-UEQMK4WX.js → cli-M3Z2KOEB.js} +1 -1
  89. package/dist/{cli-226ZJ72R.js → cli-M6E3E3I2.js} +170 -3
  90. package/dist/{cli-NKKCDO6K.js → cli-MCRPA4Z6.js} +20 -20
  91. package/dist/{cli-BQ36DV5C.js → cli-MI2DEDMA.js} +3 -3
  92. package/dist/{cli-6O7YCK2M.js → cli-MITZ6SE7.js} +3 -3
  93. package/dist/{cli-LPFSJ625.js → cli-MTIYD3BX.js} +26 -26
  94. package/dist/{cli-5M6KDNVX.js → cli-MTZUJGBK.js} +2 -2
  95. package/dist/{cli-GSOV26O5.js → cli-NCLMUXLC.js} +14 -14
  96. package/dist/{cli-X52TXCNF.js → cli-NLS3DKWH.js} +26 -26
  97. package/dist/{cli-AH6AMAIB.js → cli-NMDGS7IE.js} +1 -1
  98. package/dist/cli-O3DJO2CS.js +30 -0
  99. package/dist/{cli-BC67QHD5.js → cli-O47D5BFN.js} +2 -2
  100. package/dist/{cli-MDVC5ZNM.js → cli-OBRZ36VP.js} +14 -14
  101. package/dist/{cli-C32Q5E5I.js → cli-P6V3NSU4.js} +1 -1
  102. package/dist/{cli-RMD5WSUQ.js → cli-PAMQMTHK.js} +21 -21
  103. package/dist/{cli-WNBP3LOD.js → cli-PKTHOCT3.js} +26 -26
  104. package/dist/cli-QQ432JEN.js +36 -0
  105. package/dist/{cli-YYXAGJQR.js → cli-QVNDPTBU.js} +20 -20
  106. package/dist/{cli-KJA6GLZI.js → cli-R2DFD6ZZ.js} +15 -15
  107. package/dist/{cli-6BLVI2JM.js → cli-RMVJMOWU.js} +111 -7
  108. package/dist/{cli-X64BNBQH.js → cli-RVZH462G.js} +585 -8
  109. package/dist/{cli-6AMK3DYS.js → cli-SEEOQVUL.js} +12 -12
  110. package/dist/{cli-QTCTWYCM.js → cli-SO354HPI.js} +3 -3
  111. package/dist/{cli-RHL4B4H7.js → cli-T76HDH7F.js} +88 -4
  112. package/dist/{cli-ZJW6HQ6N.js → cli-TIS7DWRR.js} +7 -7
  113. package/dist/{cli-6JWDFCUV.js → cli-TY3B6XS7.js} +21 -21
  114. package/dist/{cli-4FJL3KQZ.js → cli-UKEZJFIT.js} +2 -2
  115. package/dist/cli-VQAMW4RF.js +95 -0
  116. package/dist/{cli-ATHATKI5.js → cli-W4LMRVZT.js} +78 -47
  117. package/dist/cli-W7I5KGIB.js +84 -0
  118. package/dist/{cli-S3NHXAJM.js → cli-WCFZNEK2.js} +18 -18
  119. package/dist/{cli-B3EFE7ZF.js → cli-WXGJFA4F.js} +1 -1
  120. package/dist/{cli-PNS4KWWC.js → cli-XCG33I77.js} +24 -24
  121. package/dist/{cli-DBMEH4Y5.js → cli-YHLSG5HB.js} +26 -26
  122. package/dist/cli-YNH5DTHY.js +36 -0
  123. package/dist/cli-YPMJWPDA.js +69 -0
  124. package/dist/{cli-PXQYY6KM.js → cli-YSXIR7EM.js} +0 -0
  125. package/dist/cli-ZPFWO4VW.js +85 -0
  126. package/dist/cli.js +53 -53
  127. package/dist/client.js +1951 -289
  128. package/dist/core/assessment-moves.d.ts +32 -0
  129. package/dist/core/assessment-reports.d.ts +38 -0
  130. package/dist/core/assessment-settings.d.ts +15 -0
  131. package/dist/core/benchmark-samples.d.ts +28 -0
  132. package/dist/core/session-host.d.ts +4 -0
  133. package/dist/core/session-roster.d.ts +6 -0
  134. package/dist/core/session-timers.d.ts +40 -0
  135. package/dist/core/session.d.ts +14 -1
  136. package/dist/core/tick-timer.d.ts +18 -0
  137. package/dist/dev/console/assets/{index-Ch6HHb2T.js → index-zd--5H1f.js} +26 -26
  138. package/dist/dev/console/index.html +1 -1
  139. package/dist/dev/shell.d.ts +21 -0
  140. package/dist/dev/view/commands.d.ts +3 -1
  141. package/dist/docs/api/index.md +1 -1
  142. package/dist/docs/api/sdk-commands.md +29 -0
  143. package/dist/docs/api/sdk-e2e.md +30 -0
  144. package/dist/docs/api/sdk-projection.md +5 -0
  145. package/dist/docs/api/sdk-tools-client.md +30 -0
  146. package/dist/docs/api/sdk-ui.md +7 -0
  147. package/dist/docs/api/sdk.md +834 -19
  148. package/dist/docs/changelog.md +34 -0
  149. package/dist/docs/cli-error-codes.md +5 -1
  150. package/dist/docs/cli-reference.md +76 -2
  151. package/dist/docs/concepts/index.md +2 -0
  152. package/dist/docs/concepts/terminology.md +12 -0
  153. package/dist/docs/guides/assessments.md +248 -0
  154. package/dist/docs/guides/benchmarks.md +241 -0
  155. package/dist/docs/guides/engine.md +8 -0
  156. package/dist/docs/guides/index.md +2 -0
  157. package/dist/docs/guides/presentation.md +11 -9
  158. package/dist/docs/guides/session-hooks.md +24 -22
  159. package/dist/docs/guides/tick-controller.md +22 -1
  160. package/dist/docs/guides/ui.md +24 -0
  161. package/dist/docs/guides/upgrading.md +21 -0
  162. package/dist/docs/page-index.md +16 -12
  163. package/dist/docs/recipes/create-assessment.md +124 -0
  164. package/dist/docs/recipes/create-benchmark.md +115 -0
  165. package/dist/docs/recipes/index.md +2 -0
  166. package/dist/execution/context-composition.d.ts +39 -4
  167. package/dist/execution/engine-state.d.ts +13 -0
  168. package/dist/execution/executor.d.ts +16 -0
  169. package/dist/execution/logic-result.d.ts +13 -2
  170. package/dist/help-examples.d.ts +12 -0
  171. package/dist/host/adapter.d.ts +24 -1
  172. package/dist/host/protocol.d.ts +115 -1
  173. package/dist/host.js +29 -1
  174. package/dist/playwright.js +1945 -283
  175. package/dist/runtime/index.d.ts +3 -1
  176. package/dist/runtime/manifest-version.d.ts +1 -1
  177. package/dist/runtime.js +298 -16
  178. package/dist/schema.json +189 -0
  179. package/dist/templating/resource-metadata.d.ts +1 -1
  180. package/dist/utils/error-codes.d.ts +9 -1
  181. package/dist/validation/assessment-validation.d.ts +34 -0
  182. package/dist/validation/benchmark-validation.d.ts +20 -0
  183. package/dist/validation/schema-validation.d.ts +4 -0
  184. package/package.json +3 -3
  185. package/dist/cli-27Z5T52R.js +0 -30
  186. package/dist/cli-3VLBFWHN.js +0 -36
  187. package/dist/cli-BINVO5R7.js +0 -36
  188. package/dist/cli-HLI5UEKX.js +0 -36
  189. package/dist/cli-OF36EA62.js +0 -36
  190. package/dist/cli-OVIJRBFI.js +0 -36
  191. package/dist/cli-UIYKPSIY.js +0 -36
  192. package/dist/cli-WZNIW6ZO.js +0 -16
@@ -5,7 +5,7 @@
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
6
  <link rel="icon" type="image/svg+xml" href="/assets/icon-CRaj5uhr.svg" />
7
7
  <title>Serious Gaming</title>
8
- <script type="module" crossorigin src="/assets/index-Ch6HHb2T.js"></script>
8
+ <script type="module" crossorigin src="/assets/index-zd--5H1f.js"></script>
9
9
  <link rel="stylesheet" crossorigin href="/assets/index-q6-lvlN3.css">
10
10
  </head>
11
11
  <body>
@@ -73,6 +73,8 @@ export interface ShellOptions extends SessionOptions, PublicOrigins {
73
73
  * worker's server would otherwise compile the same surfaces again.
74
74
  */
75
75
  builtSurfaces?: string;
76
+ /** How often each console and viewer socket is pinged. For tests. */
77
+ keepAliveMs?: number;
76
78
  }
77
79
  /**
78
80
  * Something the server could not apply live, kept until it no longer holds so
@@ -112,6 +114,8 @@ export declare class DevShell {
112
114
  private readonly socketRuns;
113
115
  /** The participant an operator page says it is showing, where it shows one. */
114
116
  private readonly socketPresence;
117
+ /** Console pages open, each of which keeps its run awake (§11.4a). */
118
+ private readonly consoleSockets;
115
119
  private readonly options;
116
120
  private brands;
117
121
  private server;
@@ -120,6 +124,9 @@ export declare class DevShell {
120
124
  /** One socket per viewer page, each carrying only what that page is owed. */
121
125
  private viewSockets;
122
126
  private readonly views;
127
+ private keepAlive;
128
+ /** Sockets pinged since they last answered one. */
129
+ private readonly unanswered;
123
130
  /** Teams processing a round, per run (§12.4.4); `-1` is the cohort. */
124
131
  private readonly processing;
125
132
  private vite;
@@ -273,6 +280,14 @@ export declare class DevShell {
273
280
  */
274
281
  private viteServerOptions;
275
282
  private attachSockets;
283
+ /**
284
+ * Ping every console and viewer socket, and drop one that left the last
285
+ * ping unanswered. A proxy in front of the server closes a connection
286
+ * that carries nothing for long enough (60s on an AWS load balancer), and
287
+ * an idle session sends nothing; a peer that vanished without closing is
288
+ * otherwise never noticed (#847).
289
+ */
290
+ private keepSocketsAlive;
276
291
  private receive;
277
292
  /** What one viewer page is owed, now. */
278
293
  private viewOf;
@@ -300,6 +315,12 @@ export declare class DevShell {
300
315
  * builds it.
301
316
  */
302
317
  private syncPresence;
318
+ /**
319
+ * Tell a run how many pages are open on it, console and viewer alike.
320
+ * Opening one is activity, and the dev server keeps a run with any open
321
+ * awake (§11.4a), which the specification leaves to the host.
322
+ */
323
+ private syncOpenSurfaces;
303
324
  private updateViews;
304
325
  /**
305
326
  * Act on a frame's request from a viewer page.
@@ -72,4 +72,6 @@ export declare function commandFor(message: {
72
72
  export declare function queryFor(message: {
73
73
  type: string;
74
74
  [key: string]: unknown;
75
- }, surface: MountableSurface, viewer: Viewer): QueryCommand | null;
75
+ }, surface: MountableSurface, viewer: Viewer, { sessionless }?: {
76
+ sessionless?: boolean;
77
+ }): QueryCommand | FrameRefusal | null;
@@ -6,7 +6,7 @@ Every type, function, hook and component your game imports, one page per entry p
6
6
 
7
7
  | Entry point | Exports |
8
8
  | ------------------------------------------------------------------ | -------------------------------------------------------------- |
9
- | [`@seriousgaming/sdk`](./sdk.md) | 12 functions, 3 classes, 1 constant, 100 interfaces, 49 types |
9
+ | [`@seriousgaming/sdk`](./sdk.md) | 20 functions, 3 classes, 9 constants, 115 interfaces, 64 types |
10
10
  | [`@seriousgaming/sdk/ui`](./sdk-ui.md) | 50 functions, 3 classes, 40 constants, 26 interfaces, 38 types |
11
11
  | [`@seriousgaming/sdk/ui/testing`](./sdk-ui-testing.md) | 14 functions, 6 types |
12
12
  | [`@seriousgaming/sdk/testing`](./sdk-testing.md) | 8 functions, 4 constants, 8 types |
@@ -195,6 +195,9 @@ type MutationCommand =
195
195
  type: 'advanceClock';
196
196
  byMs: number;
197
197
  }
198
+ | {
199
+ type: 'makeDormant';
200
+ }
198
201
  | {
199
202
  type: 'armFault';
200
203
  fault: FaultKind;
@@ -239,6 +242,16 @@ type QueryCommand =
239
242
  type: 'getAllTeamsParticipants';
240
243
  uiIdentifier?: string;
241
244
  } & Actor)
245
+ | {
246
+ type: 'getBenchmark';
247
+ identifier: string;
248
+ where: BenchmarkFilter[];
249
+ }
250
+ | ({
251
+ type: 'getAssessment';
252
+ identifier: string;
253
+ audience?: 'all' | 'own';
254
+ } & Actor)
242
255
  | {
243
256
  type: 'getEndpointAudit';
244
257
  }
@@ -275,6 +288,22 @@ type QueryResult =
275
288
  type: 'participants';
276
289
  participants: unknown[];
277
290
  }
291
+ | {
292
+ type: 'benchmark';
293
+ statistics: BenchmarkStatistics | null;
294
+ }
295
+ | {
296
+ type: 'benchmarkFailure';
297
+ error: string;
298
+ }
299
+ | {
300
+ type: 'assessment';
301
+ report: AssessmentReport;
302
+ }
303
+ | {
304
+ type: 'assessmentFailure';
305
+ error: string;
306
+ }
278
307
  | {
279
308
  type: 'endpointAudit';
280
309
  entries: EndpointAuditEntry[];
@@ -183,6 +183,7 @@ interface StateProjection {
183
183
  teams: ProjectedTeam[];
184
184
  shared: Record<string, Record<string, unknown>>;
185
185
  sharedState?: unknown;
186
+ sharedBenchmarks?: Record<string, Record<string, unknown>>;
186
187
  timer: TimerState | null;
187
188
  settings: ResolvedSettings;
188
189
  settingsWithoutSession: ResolvedSettings;
@@ -336,6 +337,9 @@ type MutationCommand =
336
337
  type: 'advanceClock';
337
338
  byMs: number;
338
339
  }
340
+ | {
341
+ type: 'makeDormant';
342
+ }
339
343
  | {
340
344
  type: 'armFault';
341
345
  fault: FaultKind;
@@ -397,6 +401,16 @@ type QueryCommand =
397
401
  type: 'getAllTeamsParticipants';
398
402
  uiIdentifier?: string;
399
403
  } & Actor)
404
+ | {
405
+ type: 'getBenchmark';
406
+ identifier: string;
407
+ where: BenchmarkFilter[];
408
+ }
409
+ | ({
410
+ type: 'getAssessment';
411
+ identifier: string;
412
+ audience?: 'all' | 'own';
413
+ } & Actor)
400
414
  | {
401
415
  type: 'getEndpointAudit';
402
416
  }
@@ -433,6 +447,22 @@ type QueryResult =
433
447
  type: 'participants';
434
448
  participants: unknown[];
435
449
  }
450
+ | {
451
+ type: 'benchmark';
452
+ statistics: BenchmarkStatistics | null;
453
+ }
454
+ | {
455
+ type: 'benchmarkFailure';
456
+ error: string;
457
+ }
458
+ | {
459
+ type: 'assessment';
460
+ report: AssessmentReport;
461
+ }
462
+ | {
463
+ type: 'assessmentFailure';
464
+ error: string;
465
+ }
436
466
  | {
437
467
  type: 'endpointAudit';
438
468
  entries: EndpointAuditEntry[];
@@ -92,6 +92,8 @@ interface ProjectedTeam extends TeamInfo {
92
92
  participants: Participant[];
93
93
  timer?: TimerState;
94
94
  state?: unknown;
95
+ benchmarks?: Record<string, Record<string, unknown>>;
96
+ assessments?: Record<string, unknown>;
95
97
  }
96
98
  ```
97
99
 
@@ -137,6 +139,7 @@ interface StateProjection {
137
139
  teams: ProjectedTeam[];
138
140
  shared: Record<string, Record<string, unknown>>;
139
141
  sharedState?: unknown;
142
+ sharedBenchmarks?: Record<string, Record<string, unknown>>;
140
143
  timer: TimerState | null;
141
144
  settings: ResolvedSettings;
142
145
  settingsWithoutSession: ResolvedSettings;
@@ -170,6 +173,8 @@ interface TimerState {
170
173
  pausedMs: number;
171
174
  extendedMs: number;
172
175
  scheduleStartedAt: number | null;
176
+ dormant?: boolean;
177
+ dormantAt?: number | null;
173
178
  }
174
179
  ```
175
180
 
@@ -229,6 +229,7 @@ interface StateProjection {
229
229
  teams: ProjectedTeam[];
230
230
  shared: Record<string, Record<string, unknown>>;
231
231
  sharedState?: unknown;
232
+ sharedBenchmarks?: Record<string, Record<string, unknown>>;
232
233
  timer: TimerState | null;
233
234
  settings: ResolvedSettings;
234
235
  settingsWithoutSession: ResolvedSettings;
@@ -485,6 +486,9 @@ type MutationCommand =
485
486
  type: 'advanceClock';
486
487
  byMs: number;
487
488
  }
489
+ | {
490
+ type: 'makeDormant';
491
+ }
488
492
  | {
489
493
  type: 'armFault';
490
494
  fault: FaultKind;
@@ -554,6 +558,16 @@ type QueryCommand =
554
558
  type: 'getAllTeamsParticipants';
555
559
  uiIdentifier?: string;
556
560
  } & Actor)
561
+ | {
562
+ type: 'getBenchmark';
563
+ identifier: string;
564
+ where: BenchmarkFilter[];
565
+ }
566
+ | ({
567
+ type: 'getAssessment';
568
+ identifier: string;
569
+ audience?: 'all' | 'own';
570
+ } & Actor)
557
571
  | {
558
572
  type: 'getEndpointAudit';
559
573
  }
@@ -590,6 +604,22 @@ type QueryResult =
590
604
  type: 'participants';
591
605
  participants: unknown[];
592
606
  }
607
+ | {
608
+ type: 'benchmark';
609
+ statistics: BenchmarkStatistics | null;
610
+ }
611
+ | {
612
+ type: 'benchmarkFailure';
613
+ error: string;
614
+ }
615
+ | {
616
+ type: 'assessment';
617
+ report: AssessmentReport;
618
+ }
619
+ | {
620
+ type: 'assessmentFailure';
621
+ error: string;
622
+ }
593
623
  | {
594
624
  type: 'endpointAudit';
595
625
  entries: EndpointAuditEntry[];
@@ -984,6 +984,11 @@ interface PresentationValue<TSettings, TTeamContext, TSharedContext> {
984
984
  getPastState: <T = Record<string, unknown>>(
985
985
  query: PastStateQuery<T>
986
986
  ) => Promise<PastStateEntry<T>[]>;
987
+ getBenchmark: (
988
+ identifier: string,
989
+ query?: BenchmarkQuery
990
+ ) => Promise<BenchmarkStatistics | null>;
991
+ getAssessment: (identifier: string) => Promise<AssessmentReport>;
987
992
  getAssetUrl: (reference: string) => string;
988
993
  }
989
994
  ```
@@ -1087,6 +1092,8 @@ interface TimerState {
1087
1092
  pausedMs: number;
1088
1093
  extendedMs: number;
1089
1094
  scheduleStartedAt: number | null;
1095
+ dormant?: boolean;
1096
+ dormantAt?: number | null;
1090
1097
  }
1091
1098
  ```
1092
1099