castle-web-cli 0.4.232 → 0.4.234

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 (587) hide show
  1. package/dist/agent-failures.d.ts +8 -0
  2. package/dist/agent-failures.js +19 -2
  3. package/dist/agent-prompts.d.ts +1 -1
  4. package/dist/agent-prompts.js +10 -3
  5. package/dist/agent.d.ts +64 -3
  6. package/dist/agent.js +170 -81
  7. package/dist/api.d.ts +11 -0
  8. package/dist/api.js +43 -0
  9. package/dist/bundle.d.ts +64 -0
  10. package/dist/bundle.js +558 -2
  11. package/dist/castle-host/host.d.ts +18 -2
  12. package/dist/castle-host/host.js +844 -39
  13. package/dist/castleJson.d.ts +23 -2
  14. package/dist/castleJson.js +46 -2
  15. package/dist/check.d.ts +3 -1
  16. package/dist/check.js +20 -3
  17. package/dist/chunkLoader.d.ts +3 -0
  18. package/dist/chunkLoader.js +111 -0
  19. package/dist/devParty.d.ts +26 -0
  20. package/dist/devParty.js +231 -0
  21. package/dist/devSaveStorage.js +4 -0
  22. package/dist/devSessionStorage.js +50 -2
  23. package/dist/devSocial.d.ts +24 -0
  24. package/dist/devSocial.js +70 -0
  25. package/dist/ide.d.ts +2 -0
  26. package/dist/ide.js +119 -15
  27. package/dist/importPinMismatch.d.ts +22 -0
  28. package/dist/importPinMismatch.js +77 -0
  29. package/dist/importRegression.js +3 -15
  30. package/dist/imports.d.ts +10 -3
  31. package/dist/imports.js +88 -20
  32. package/dist/index.js +11 -4
  33. package/dist/init.js +1 -1
  34. package/dist/platformDoc.js +22 -0
  35. package/dist/routerFences.d.ts +5 -0
  36. package/dist/routerFences.js +12 -2
  37. package/dist/save-deck.d.ts +25 -1
  38. package/dist/save-deck.js +178 -9
  39. package/dist/serve.js +32 -11
  40. package/dist/shell/assets/{index-D2tWM896.js → index-DulbYIJm.js} +97 -97
  41. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  42. package/dist/shell/index.html +2 -2
  43. package/dist/taskSteer.d.ts +13 -0
  44. package/dist/taskSteer.js +22 -2
  45. package/dist/vitePlugins.d.ts +2 -1
  46. package/dist/vitePlugins.js +13 -0
  47. package/kits/base/castle.json +1 -1
  48. package/kits/base/package-lock.json +1 -1
  49. package/kits/base/sdk/README.md +339 -5
  50. package/kits/base/sdk/avatar.d.ts +6 -2
  51. package/kits/base/sdk/avatar.js +12 -4
  52. package/kits/base/sdk/castle.d.ts +7 -3
  53. package/kits/base/sdk/castle.js +2 -0
  54. package/kits/base/sdk/commands.d.ts +176 -1
  55. package/kits/base/sdk/commands.js +3 -0
  56. package/kits/base/sdk/display.d.ts +3 -0
  57. package/kits/base/sdk/display.js +9 -3
  58. package/kits/base/sdk/hub.d.ts +37 -6
  59. package/kits/base/sdk/hub.js +63 -4
  60. package/kits/base/sdk/multiplayer.d.ts +7 -1
  61. package/kits/base/sdk/multiplayer.js +148 -32
  62. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  63. package/kits/base/sdk/party.d.ts +23 -0
  64. package/kits/base/sdk/party.js +91 -0
  65. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  66. package/kits/base/sdk/reconnectBudget.js +96 -0
  67. package/kits/base/sdk/save.d.ts +38 -1
  68. package/kits/base/sdk/save.js +81 -7
  69. package/kits/base/sdk/server/hub.d.ts +117 -0
  70. package/kits/base/sdk/server/hub.js +119 -2
  71. package/kits/base/sdk/server/platformHandle.d.ts +43 -1
  72. package/kits/base/sdk/server/storage.d.ts +17 -0
  73. package/kits/base/sdk/server/storage.js +65 -3
  74. package/kits/base/sdk/server/wrapper.d.ts +43 -6
  75. package/kits/base/sdk/server/wrapper.js +93 -9
  76. package/kits/base/sdk/social.d.ts +9 -0
  77. package/kits/base/sdk/social.js +5 -0
  78. package/kits/hub-game/CLAUDE.md +451 -13
  79. package/kits/hub-game/README.md +63 -0
  80. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  81. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  82. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  83. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  84. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  85. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  86. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  87. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  88. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  89. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  90. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  91. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  92. package/kits/hub-game/castle.json +5 -5
  93. package/kits/hub-game/code/client/act.js +312 -0
  94. package/kits/hub-game/code/client/actionLayout.js +147 -0
  95. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  96. package/kits/hub-game/code/client/actorBudget.js +47 -0
  97. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  98. package/kits/hub-game/code/client/askSlot.js +117 -0
  99. package/kits/hub-game/code/client/attention.js +11 -2
  100. package/kits/hub-game/code/client/avatar.js +311 -35
  101. package/kits/hub-game/code/client/avatarCap.js +228 -0
  102. package/kits/hub-game/code/client/avatarColors.js +70 -0
  103. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  104. package/kits/hub-game/code/client/avatarShare.js +253 -0
  105. package/kits/hub-game/code/client/backVisibility.js +13 -0
  106. package/kits/hub-game/code/client/ballot.js +472 -0
  107. package/kits/hub-game/code/client/build.js +38 -0
  108. package/kits/hub-game/code/client/chat.js +41 -5
  109. package/kits/hub-game/code/client/chatModeration.js +5 -0
  110. package/kits/hub-game/code/client/chrome.js +2144 -160
  111. package/kits/hub-game/code/client/companion.js +716 -0
  112. package/kits/hub-game/code/client/companionDress.js +99 -0
  113. package/kits/hub-game/code/client/crowdNames.js +241 -0
  114. package/kits/hub-game/code/client/decor.js +515 -0
  115. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  116. package/kits/hub-game/code/client/doorErrors.js +39 -0
  117. package/kits/hub-game/code/client/earned.js +131 -0
  118. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  119. package/kits/hub-game/code/client/fall.js +18 -0
  120. package/kits/hub-game/code/client/farAvatars.js +233 -0
  121. package/kits/hub-game/code/client/firstJoin.js +9 -2
  122. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  123. package/kits/hub-game/code/client/frameBatch.js +5 -0
  124. package/kits/hub-game/code/client/grab.js +368 -29
  125. package/kits/hub-game/code/client/hookLayer.js +385 -20
  126. package/kits/hub-game/code/client/hudCopy.js +51 -0
  127. package/kits/hub-game/code/client/hudRate.js +20 -0
  128. package/kits/hub-game/code/client/idle.js +177 -24
  129. package/kits/hub-game/code/client/interestCap.js +81 -0
  130. package/kits/hub-game/code/client/invites.js +231 -0
  131. package/kits/hub-game/code/client/joinError.js +9 -0
  132. package/kits/hub-game/code/client/keys.js +36 -0
  133. package/kits/hub-game/code/client/labelsNear.js +234 -0
  134. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  135. package/kits/hub-game/code/client/layoutCache.js +264 -0
  136. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  137. package/kits/hub-game/code/client/loadingCover.js +148 -0
  138. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  139. package/kits/hub-game/code/client/menuIcons.js +34 -0
  140. package/kits/hub-game/code/client/menuRows.js +43 -0
  141. package/kits/hub-game/code/client/modelReady.js +7 -0
  142. package/kits/hub-game/code/client/pack.js +6 -2
  143. package/kits/hub-game/code/client/packFormat.js +3 -3
  144. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  145. package/kits/hub-game/code/client/padCues.js +112 -0
  146. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  147. package/kits/hub-game/code/client/padReadability.js +26 -0
  148. package/kits/hub-game/code/client/padRings.js +69 -0
  149. package/kits/hub-game/code/client/pushVisit.js +14 -0
  150. package/kits/hub-game/code/client/quality.js +205 -0
  151. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  152. package/kits/hub-game/code/client/rehello.js +167 -0
  153. package/kits/hub-game/code/client/safeLayout.js +338 -0
  154. package/kits/hub-game/code/client/safeStyle.js +42 -0
  155. package/kits/hub-game/code/client/say.js +12 -3
  156. package/kits/hub-game/code/client/shot.js +146 -0
  157. package/kits/hub-game/code/client/shotFit.js +56 -0
  158. package/kits/hub-game/code/client/signIn.js +28 -0
  159. package/kits/hub-game/code/client/sound.js +63 -8
  160. package/kits/hub-game/code/client/soundscape.js +1151 -0
  161. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  162. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  163. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  164. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  165. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  166. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  167. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  168. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  169. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  170. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  171. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  172. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  173. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  174. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  175. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  176. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  177. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  178. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  179. package/kits/hub-game/code/client/spin.js +101 -0
  180. package/kits/hub-game/code/client/state.js +162 -1
  181. package/kits/hub-game/code/client/stuck.js +259 -0
  182. package/kits/hub-game/code/client/talk.js +714 -59
  183. package/kits/hub-game/code/client/tiers.js +543 -52
  184. package/kits/hub-game/code/client/toastBand.js +37 -0
  185. package/kits/hub-game/code/client/together.js +39 -2
  186. package/kits/hub-game/code/client/visibility.js +43 -0
  187. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  188. package/kits/hub-game/code/client/weakestTier.js +295 -0
  189. package/kits/hub-game/code/client/wear.js +461 -170
  190. package/kits/hub-game/code/client/worldLabels.js +241 -0
  191. package/kits/hub-game/code/client/yours.js +200 -0
  192. package/kits/hub-game/code/companionSpec.js +45 -0
  193. package/kits/hub-game/code/npcDisplayText.js +55 -0
  194. package/kits/hub-game/code/privateText.js +7 -0
  195. package/kits/hub-game/code/server/act.js +124 -0
  196. package/kits/hub-game/code/server/actions.js +138 -0
  197. package/kits/hub-game/code/server/actors.js +11 -2
  198. package/kits/hub-game/code/server/analytics.js +83 -0
  199. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  200. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  201. package/kits/hub-game/code/server/ask.js +155 -0
  202. package/kits/hub-game/code/server/ballot.js +539 -0
  203. package/kits/hub-game/code/server/cells.js +100 -0
  204. package/kits/hub-game/code/server/companion.js +107 -0
  205. package/kits/hub-game/code/server/cues.js +70 -0
  206. package/kits/hub-game/code/server/decor.js +269 -0
  207. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  208. package/kits/hub-game/code/server/earned.js +478 -0
  209. package/kits/hub-game/code/server/frameBatch.js +183 -0
  210. package/kits/hub-game/code/server/friendBests.js +166 -0
  211. package/kits/hub-game/code/server/friendsAmong.js +272 -0
  212. package/kits/hub-game/code/server/history.js +7 -0
  213. package/kits/hub-game/code/server/hub.js +2510 -95
  214. package/kits/hub-game/code/server/idle.js +60 -12
  215. package/kits/hub-game/code/server/index.js +28 -6
  216. package/kits/hub-game/code/server/invites.js +19 -0
  217. package/kits/hub-game/code/server/labels.js +36 -2
  218. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  219. package/kits/hub-game/code/server/manifest.js +586 -7
  220. package/kits/hub-game/code/server/menu.js +161 -0
  221. package/kits/hub-game/code/server/npcs.js +1025 -113
  222. package/kits/hub-game/code/server/observe.js +408 -0
  223. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  224. package/kits/hub-game/code/server/party.js +2 -2
  225. package/kits/hub-game/code/server/players.js +30 -0
  226. package/kits/hub-game/code/server/resumePose.js +152 -0
  227. package/kits/hub-game/code/server/say.js +1 -1
  228. package/kits/hub-game/code/server/shot.js +110 -0
  229. package/kits/hub-game/code/server/standing.js +123 -0
  230. package/kits/hub-game/code/server/storageLimit.js +187 -0
  231. package/kits/hub-game/code/server/vis.js +175 -0
  232. package/kits/hub-game/code/server/wear.js +12 -0
  233. package/kits/hub-game/code/server/yours.js +59 -0
  234. package/kits/hub-game/code/shared/act.js +35 -0
  235. package/kits/hub-game/code/shared/cues.js +9 -0
  236. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  237. package/kits/hub-game/code/shared/decor.js +41 -0
  238. package/kits/hub-game/code/shared/loadStages.js +12 -0
  239. package/kits/hub-game/code/shared/quality.js +74 -0
  240. package/kits/hub-game/code/shared/say.js +2 -0
  241. package/kits/hub-game/code/shared/shot.js +53 -0
  242. package/kits/hub-game/code/shared/spin.js +57 -0
  243. package/kits/hub-game/code/systems/hub.js +1753 -202
  244. package/kits/hub-game/docs/analytics.md +279 -0
  245. package/kits/hub-game/docs/content-pack.md +1 -1
  246. package/kits/hub-game/docs/contract.md +3475 -77
  247. package/kits/hub-game/docs/home-pieces.md +71 -0
  248. package/kits/hub-game/docs/observed-progress.md +252 -0
  249. package/kits/hub-game/main.jsx +2 -0
  250. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  251. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  252. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  253. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  254. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  255. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  256. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  257. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  258. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  259. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  260. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  261. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  262. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  263. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  264. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  265. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  266. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  267. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  268. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  269. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  270. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  271. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  272. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  273. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  274. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  275. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  276. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  277. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  278. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  279. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  280. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  281. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  282. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  283. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  284. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  285. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  286. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  287. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  288. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  289. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  290. package/kits/hub-game/package-lock.json +10 -1
  291. package/kits/hub-game/package.json +6 -2
  292. package/kits/hub-game/play/player.js +142 -0
  293. package/kits/hub-game/play/registry.js +47 -0
  294. package/kits/hub-game/play.jsx +37 -0
  295. package/kits/hub-game/scripts/check.mjs +117 -16
  296. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  297. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +132 -0
  298. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  299. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +26 -0
  300. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +123 -0
  301. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  302. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  303. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  304. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  305. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  306. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  307. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  308. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  309. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  310. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  311. package/kits/hub-game/scripts/test-act.mjs +171 -0
  312. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  313. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  314. package/kits/hub-game/scripts/test-actions-client.mjs +853 -0
  315. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  316. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  317. package/kits/hub-game/scripts/test-actors.mjs +38 -23
  318. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  319. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  320. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  321. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  322. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  323. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  324. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  325. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  326. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  327. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  328. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  329. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  330. package/kits/hub-game/scripts/test-avatar-wire.mjs +792 -0
  331. package/kits/hub-game/scripts/test-avatar.mjs +584 -7
  332. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  333. package/kits/hub-game/scripts/test-ballot.mjs +1008 -0
  334. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  335. package/kits/hub-game/scripts/test-build.mjs +49 -0
  336. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  337. package/kits/hub-game/scripts/test-chat.mjs +863 -0
  338. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  339. package/kits/hub-game/scripts/test-companion-chat.mjs +216 -0
  340. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  341. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  342. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  343. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  344. package/kits/hub-game/scripts/test-decor-client.mjs +344 -0
  345. package/kits/hub-game/scripts/test-decor.mjs +464 -0
  346. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  347. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  348. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  349. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  350. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  351. package/kits/hub-game/scripts/test-earned.mjs +1224 -0
  352. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  353. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  354. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  355. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  356. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  357. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  358. package/kits/hub-game/scripts/test-grab-orbit.mjs +961 -0
  359. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  360. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  361. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  362. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  363. package/kits/hub-game/scripts/test-hub-ops.mjs +758 -2
  364. package/kits/hub-game/scripts/test-hub-trip.mjs +1594 -12
  365. package/kits/hub-game/scripts/test-hud-clear.mjs +484 -57
  366. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  367. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  368. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  369. package/kits/hub-game/scripts/test-idle.mjs +427 -1
  370. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  371. package/kits/hub-game/scripts/test-interest-cells.mjs +513 -0
  372. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  373. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  374. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  375. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  376. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  377. package/kits/hub-game/scripts/test-labels.mjs +664 -0
  378. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  379. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  380. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  381. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  382. package/kits/hub-game/scripts/test-manifest.mjs +472 -0
  383. package/kits/hub-game/scripts/test-menu-client.mjs +585 -0
  384. package/kits/hub-game/scripts/test-menu.mjs +319 -0
  385. package/kits/hub-game/scripts/test-npcs.mjs +2528 -13
  386. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  387. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  388. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  389. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  390. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  391. package/kits/hub-game/scripts/test-picker.mjs +541 -0
  392. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  393. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  394. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  395. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  396. package/kits/hub-game/scripts/test-rehello.mjs +1733 -0
  397. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  398. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  399. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  400. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  401. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  402. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  403. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  404. package/kits/hub-game/scripts/test-say.mjs +1 -1
  405. package/kits/hub-game/scripts/test-shot.mjs +901 -0
  406. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  407. package/kits/hub-game/scripts/test-soundscape.mjs +5437 -0
  408. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  409. package/kits/hub-game/scripts/test-standing.mjs +449 -0
  410. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  411. package/kits/hub-game/scripts/test-stuck.mjs +1904 -0
  412. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  413. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  414. package/kits/hub-game/scripts/test-tiers-render.mjs +412 -0
  415. package/kits/hub-game/scripts/test-tiers.mjs +476 -2
  416. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  417. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  418. package/kits/hub-game/scripts/test-vis.mjs +770 -0
  419. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  420. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  421. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  422. package/kits/hub-game/scripts/test-yours-chrome.mjs +210 -0
  423. package/kits/hub-game/scripts/test-yours.mjs +403 -0
  424. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  425. package/kits/multiplayer-3d/castle.json +5 -5
  426. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  427. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  428. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  429. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  430. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  431. package/kits/multiplayer-3d/code/options.js +5 -0
  432. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  433. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  434. package/kits/multiplayer-3d/code/server/world.js +7 -0
  435. package/kits/multiplayer-3d/code/systems/multiplayer.js +443 -34
  436. package/kits/multiplayer-3d/package-lock.json +8 -1
  437. package/kits/multiplayer-3d/package.json +3 -1
  438. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  439. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  440. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  441. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  442. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  443. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  444. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  445. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  446. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  447. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  448. package/kits/physics-2d/CLAUDE.md +19 -1
  449. package/kits/physics-2d/castle.json +2 -2
  450. package/kits/physics-2d/engine/frozenActors.js +233 -0
  451. package/kits/physics-2d/engine/scene.js +337 -3
  452. package/kits/physics-2d/engine/skyKey.js +129 -0
  453. package/kits/physics-2d/engine/stillClock.js +106 -0
  454. package/kits/physics-2d/engine/updateBudget.js +21 -0
  455. package/kits/physics-2d/eslint.config.js +1 -1
  456. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  457. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  458. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  459. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  460. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  461. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  462. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  463. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  464. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  465. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  466. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  467. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  468. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  469. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  470. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  471. package/kits/physics-3d/CLAUDE.md +42 -529
  472. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  473. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  474. package/kits/physics-3d/behaviors/Player.jsx +661 -87
  475. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  476. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  477. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  478. package/kits/physics-3d/castle.json +3 -3
  479. package/kits/physics-3d/docs/engine-camera.md +542 -0
  480. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  481. package/kits/physics-3d/docs/engine-load.md +149 -0
  482. package/kits/physics-3d/docs/engine-look.md +114 -0
  483. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  484. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  485. package/kits/physics-3d/docs/engine-sky.md +198 -0
  486. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  487. package/kits/physics-3d/docs/engine-view.md +37 -0
  488. package/kits/physics-3d/docs/pxmodel-format.md +9 -1
  489. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  490. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -277
  491. package/kits/physics-3d/engine3d/actornode.js +87 -0
  492. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  493. package/kits/physics-3d/engine3d/branches.js +3 -13
  494. package/kits/physics-3d/engine3d/cage.js +2 -7
  495. package/kits/physics-3d/engine3d/cageops.js +2 -17
  496. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  497. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  498. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  499. package/kits/physics-3d/engine3d/framecap.js +99 -0
  500. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  501. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  502. package/kits/physics-3d/engine3d/gait.js +126 -0
  503. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  504. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  505. package/kits/physics-3d/engine3d/look.js +514 -48
  506. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  507. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  508. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  509. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  510. package/kits/physics-3d/engine3d/modelready.js +16 -0
  511. package/kits/physics-3d/engine3d/motion.js +39 -10
  512. package/kits/physics-3d/engine3d/nearshadows.js +106 -21
  513. package/kits/physics-3d/engine3d/optimize.js +9 -5
  514. package/kits/physics-3d/engine3d/orbitinput.js +522 -10
  515. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  516. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  517. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  518. package/kits/physics-3d/engine3d/paths.js +1 -9
  519. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  520. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  521. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  522. package/kits/physics-3d/engine3d/rapier.js +27 -0
  523. package/kits/physics-3d/engine3d/scatter.js +1 -11
  524. package/kits/physics-3d/engine3d/shadowfade.js +890 -0
  525. package/kits/physics-3d/engine3d/sky.js +547 -0
  526. package/kits/physics-3d/engine3d/skylife.js +306 -0
  527. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  528. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  529. package/kits/physics-3d/engine3d/sweep.js +1 -25
  530. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  531. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  532. package/kits/physics-3d/engine3d/world3d.js +1253 -76
  533. package/kits/physics-3d/eslint.config.js +2 -1
  534. package/kits/physics-3d/main.jsx +10 -2
  535. package/kits/physics-3d/package-lock.json +7 -0
  536. package/kits/physics-3d/package.json +5 -1
  537. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  538. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  539. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  540. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  541. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  542. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  543. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  544. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  545. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  546. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  547. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  548. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  549. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  550. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  551. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  552. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2613 -82
  553. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +2 -2
  554. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  555. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +438 -0
  556. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  557. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  558. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  559. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  560. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  561. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  562. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  563. package/kits/physics-3d/scripts/test-near-shadows.mjs +5 -2
  564. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +2001 -0
  565. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +582 -0
  566. package/kits/physics-3d/scripts/test-orbit-shot.mjs +657 -0
  567. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  568. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  569. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  570. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  571. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  572. package/kits/physics-3d/scripts/test-static-actors.mjs +10 -1
  573. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  574. package/kits/physics-3d/scripts/test-static-scenery.mjs +2174 -0
  575. package/kits/physics-3d/scripts/test-steady-hover.mjs +7 -2
  576. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  577. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  578. package/kits/physics-3d/systems/physics3d.js +419 -9
  579. package/kits/real-time/castle.json +2 -2
  580. package/kits/real-time/code/client/connection.js +33 -10
  581. package/kits/real-time/code/client/gameHooks.js +2 -0
  582. package/kits/real-time/code/client/joinOverlay.js +9 -4
  583. package/kits/real-time/code/server/gameHooks.js +7 -0
  584. package/kits/real-time/code/server/session.js +102 -22
  585. package/kits/real-time/package-lock.json +1 -1
  586. package/package.json +2 -2
  587. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -2,11 +2,19 @@ import { CastleError } from "./errors";
2
2
  import { BINARY_MESSAGE_TAG, isBinaryPayload, MAX_CLIENT_FRAME_BYTES, toUint8Array, } from "./multiplayerProtocol";
3
3
  import { hostRequest } from "./transport";
4
4
  import { MultiplayerVoiceImpl } from "./multiplayerVoice";
5
+ import { ReconnectBudget } from "./reconnectBudget";
5
6
  const KEEPALIVE_INTERVAL_MS = 25_000;
6
7
  const HELLO_TIMEOUT_MS = 10_000;
7
8
  const RECONNECT_BUDGET_MS = 30_000;
8
9
  const RECONNECT_DELAYS_MS = [500, 1_000, 2_000, 4_000, 8_000];
9
10
  const INVALID_DEV_RECONNECT_CLOSE_CODE = 4003;
11
+ // The play proxy closes a handshake it refuses with a reason (cauldron-game-server
12
+ // shared/src/constants.ts). The host that owns the session rejecting the credential is
13
+ // final. "Session ended" is ghost's routing verdict, which a host drain or a ghost
14
+ // error can also produce, so it takes two in a row before the session is given up on.
15
+ const PROXY_CREDENTIAL_REJECTED_CLOSE_CODE = 4401;
16
+ const PROXY_SESSION_ENDED_CLOSE_CODE = 4404;
17
+ const SESSION_ENDED_CONFIRMATIONS = 2;
10
18
  // The host may spend the full 15-second grant window waiting for author admission,
11
19
  // then up to 10 seconds on the fenced control-plane request. Keep the client above
12
20
  // that complete lifecycle so it cannot discard a valid durable receipt.
@@ -39,13 +47,17 @@ async function join(options) {
39
47
  const request = hub
40
48
  ? { command: "hub", nonce: hub.nonce }
41
49
  : { command: "multiplayer.getSession", params: joinParams(options) };
50
+ const pongTimeoutMs = options.pongTimeoutMs ?? 0;
51
+ if (!Number.isFinite(pongTimeoutMs) || pongTimeoutMs < 0 || pongTimeoutMs > 2_147_483_647) {
52
+ throw new RangeError("pongTimeoutMs must be between 0 and 2147483647 milliseconds");
53
+ }
42
54
  latestJoinAttempt += 1;
43
55
  cancelPendingDestinationJoin();
44
56
  activeConnection?.leave();
45
57
  const connection = new MultiplayerConnectionImpl(request, () => {
46
58
  if (activeConnection === connection)
47
59
  activeConnection = null;
48
- });
60
+ }, null, pongTimeoutMs);
49
61
  activeConnection = connection;
50
62
  await connection.start(hub ?? undefined);
51
63
  // The host moves its place (and every place-scoped command with it) when the
@@ -176,9 +188,12 @@ class MultiplayerConnectionImpl {
176
188
  request;
177
189
  onClosed;
178
190
  destinationAudience;
191
+ pongTimeoutMs;
179
192
  currentState = "acquiring";
180
193
  currentPlayerId = "";
181
194
  currentSessionId = "";
195
+ currentServerBundleSha256 = null;
196
+ currentServerBundleId = null;
182
197
  solo = false;
183
198
  currentSoloReason = null;
184
199
  baseUrl = "";
@@ -187,8 +202,11 @@ class MultiplayerConnectionImpl {
187
202
  socket = null;
188
203
  socketAttempt = 0;
189
204
  keepalive = null;
205
+ pongExtensionUsed = false;
206
+ pongDeadline = null;
190
207
  reAcquisitionUsed = false;
191
208
  recovering = false;
209
+ reconnectBudget = null;
192
210
  hubSettled = false;
193
211
  hubCommit = Promise.resolve(true);
194
212
  roster = null;
@@ -212,10 +230,11 @@ class MultiplayerConnectionImpl {
212
230
  players: () => this.roster?.players ?? [],
213
231
  isSolo: () => this.solo,
214
232
  });
215
- constructor(request, onClosed, destinationAudience = null) {
233
+ constructor(request, onClosed, destinationAudience = null, pongTimeoutMs = 0) {
216
234
  this.request = request;
217
235
  this.onClosed = onClosed;
218
236
  this.destinationAudience = destinationAudience;
237
+ this.pongTimeoutMs = pongTimeoutMs;
219
238
  }
220
239
  get state() {
221
240
  return this.currentState;
@@ -226,6 +245,12 @@ class MultiplayerConnectionImpl {
226
245
  get sessionId() {
227
246
  return this.currentSessionId;
228
247
  }
248
+ get serverBundleSha256() {
249
+ return this.currentState === "connected" && !this.solo ? this.currentServerBundleSha256 : null;
250
+ }
251
+ get serverBundleId() {
252
+ return this.currentState === "connected" && !this.solo ? this.currentServerBundleId : null;
253
+ }
229
254
  get isSolo() {
230
255
  return this.solo;
231
256
  }
@@ -434,28 +459,39 @@ class MultiplayerConnectionImpl {
434
459
  await this.openSocket("nonce", result.nonce);
435
460
  }
436
461
  async restoreDevReconnect(token) {
437
- const startedAt = Date.now();
462
+ this.assertOpen();
463
+ const budget = this.reconnectBudget = new ReconnectBudget();
438
464
  let attempt = 0;
439
- while (true) {
440
- this.assertOpen();
441
- try {
442
- await this.openSocket("reconnect", token);
443
- return true;
444
- }
445
- catch (error) {
446
- if (error instanceof SocketClosedError &&
447
- error.code === INVALID_DEV_RECONNECT_CLOSE_CODE) {
448
- clearDevReconnectToken(this.devReconnectStorageKey, token);
449
- return false;
465
+ try {
466
+ while (true) {
467
+ await budget.waitUntilActive();
468
+ this.assertOpen();
469
+ try {
470
+ budget.noteAttempt();
471
+ await this.openSocket("reconnect", token);
472
+ return true;
473
+ }
474
+ catch (error) {
475
+ await budget.waitUntilActive();
476
+ this.assertOpen();
477
+ if (error instanceof SocketClosedError &&
478
+ error.code === INVALID_DEV_RECONNECT_CLOSE_CODE) {
479
+ clearDevReconnectToken(this.devReconnectStorageKey, token);
480
+ return false;
481
+ }
482
+ // A 503 during a server rebuild, network failure, or hello timeout
483
+ // does not prove the credential expired. Retain it if retries run out.
484
+ if (budget.exhausted(RECONNECT_BUDGET_MS))
485
+ throw error;
486
+ const delay = RECONNECT_DELAYS_MS[Math.min(attempt++, RECONNECT_DELAYS_MS.length - 1)];
487
+ await pause(delay);
450
488
  }
451
- // A 503 during a server rebuild, network failure, or hello timeout
452
- // does not prove the credential expired. Retain it if retries run out.
453
- if (Date.now() - startedAt >= RECONNECT_BUDGET_MS)
454
- throw error;
455
- const delay = RECONNECT_DELAYS_MS[Math.min(attempt++, RECONNECT_DELAYS_MS.length - 1)];
456
- await pause(delay);
457
489
  }
458
490
  }
491
+ finally {
492
+ budget.dispose();
493
+ this.reconnectBudget = null;
494
+ }
459
495
  }
460
496
  connectSolo(result) {
461
497
  this.solo = true;
@@ -546,6 +582,10 @@ class MultiplayerConnectionImpl {
546
582
  acceptHello(frame) {
547
583
  this.currentPlayerId = frame.playerId;
548
584
  this.currentSessionId = frame.sessionId;
585
+ // Diagnostics never decide whether a hello is accepted. Missing or malformed
586
+ // metadata clears the previous host's identity on every reconnect.
587
+ this.currentServerBundleSha256 = typeof frame.serverBundleSha256 === "string" && /^[0-9a-f]{64}$/.test(frame.serverBundleSha256) ? frame.serverBundleSha256 : null;
588
+ this.currentServerBundleId = typeof frame.serverBundleId === "string" && /^[A-Za-z0-9_-]{10}$/.test(frame.serverBundleId) ? frame.serverBundleId : null;
549
589
  this.reconnectToken = frame.reconnectToken;
550
590
  this.sharedCharactersSupported = frame.capabilities?.sharedCharactersV1 === true;
551
591
  if (this.devReconnectStorageKey)
@@ -580,6 +620,8 @@ class MultiplayerConnectionImpl {
580
620
  this.acceptHello(frame);
581
621
  break;
582
622
  case "pong":
623
+ this.pongExtensionUsed = false;
624
+ this.clearPongDeadline();
583
625
  break;
584
626
  }
585
627
  }
@@ -621,22 +663,48 @@ class MultiplayerConnectionImpl {
621
663
  });
622
664
  }
623
665
  async recover() {
624
- const startedAt = Date.now();
666
+ this.assertOpen();
667
+ const budget = this.reconnectBudget = new ReconnectBudget();
625
668
  let attempt = 0;
626
- while (Date.now() - startedAt < RECONNECT_BUDGET_MS) {
627
- const delay = RECONNECT_DELAYS_MS[Math.min(attempt, RECONNECT_DELAYS_MS.length - 1)];
628
- attempt += 1;
629
- await pause(delay);
630
- this.assertOpen();
631
- try {
632
- await this.openSocket("reconnect", this.reconnectToken);
633
- return;
634
- }
635
- catch (error) {
636
- if (error instanceof SocketClosedError && error.code === 1008)
669
+ let sessionEndedCloses = 0;
670
+ try {
671
+ while (true) {
672
+ await budget.waitUntilActive();
673
+ this.assertOpen();
674
+ // A stall that spends the budget still leaves one try with the token,
675
+ // which keeps the player's identity while the host holds its lineage.
676
+ if (budget.exhausted(RECONNECT_BUDGET_MS))
637
677
  break;
678
+ const delay = RECONNECT_DELAYS_MS[Math.min(attempt, RECONNECT_DELAYS_MS.length - 1)];
679
+ attempt += 1;
680
+ await pause(delay);
681
+ await budget.waitUntilActive();
682
+ this.assertOpen();
683
+ try {
684
+ budget.noteAttempt();
685
+ await this.openSocket("reconnect", this.reconnectToken);
686
+ return;
687
+ }
688
+ catch (error) {
689
+ await budget.waitUntilActive();
690
+ this.assertOpen();
691
+ const code = error instanceof SocketClosedError ? error.code : null;
692
+ if (code === 1008 || code === PROXY_CREDENTIAL_REJECTED_CLOSE_CODE)
693
+ break;
694
+ // Retrying a session that is gone only spends the budget; ask for a fresh join.
695
+ // Any other failure in between means the two refusals were not in a row.
696
+ sessionEndedCloses = code === PROXY_SESSION_ENDED_CLOSE_CODE
697
+ ? sessionEndedCloses + 1
698
+ : 0;
699
+ if (sessionEndedCloses >= SESSION_ENDED_CONFIRMATIONS)
700
+ break;
701
+ }
638
702
  }
639
703
  }
704
+ finally {
705
+ budget.dispose();
706
+ this.reconnectBudget = null;
707
+ }
640
708
  await this.reacquireOnce();
641
709
  }
642
710
  async reacquireOnce() {
@@ -660,10 +728,14 @@ class MultiplayerConnectionImpl {
660
728
  }
661
729
  startKeepalive() {
662
730
  this.stopKeepalive();
731
+ this.pongExtensionUsed = false;
663
732
  this.keepalive = setInterval(() => {
664
733
  if (this.socket?.readyState === WebSocket.OPEN) {
734
+ if (this.pongDeadline !== null)
735
+ return;
665
736
  try {
666
737
  this.socket.send('{"t":"ping"}');
738
+ this.expectPong(this.socket);
667
739
  }
668
740
  catch {
669
741
  closeSocket(this.socket, 1000, "keepalive failed");
@@ -672,11 +744,46 @@ class MultiplayerConnectionImpl {
672
744
  }, KEEPALIVE_INTERVAL_MS);
673
745
  }
674
746
  stopKeepalive() {
747
+ this.clearPongDeadline();
675
748
  if (this.keepalive === null)
676
749
  return;
677
750
  clearInterval(this.keepalive);
678
751
  this.keepalive = null;
679
752
  }
753
+ clearPongDeadline() {
754
+ if (this.pongDeadline === null)
755
+ return;
756
+ clearTimeout(this.pongDeadline);
757
+ this.pongDeadline = null;
758
+ }
759
+ expectPong(socket) {
760
+ if (!this.pongTimeoutMs)
761
+ return;
762
+ const due = Date.now() + this.pongTimeoutMs;
763
+ this.pongDeadline = setTimeout(() => {
764
+ this.pongDeadline = null;
765
+ if (this.socket !== socket || this.currentState !== "connected")
766
+ return;
767
+ // A suspended page can run an overdue timer before queued socket events.
768
+ // Verify liveness with a fresh ping instead of condemning that socket.
769
+ if (!this.pongExtensionUsed && Date.now() - due > 1_000 && socket.readyState === WebSocket.OPEN) {
770
+ this.pongExtensionUsed = true;
771
+ try {
772
+ socket.send('{"t":"ping"}');
773
+ this.expectPong(socket);
774
+ return;
775
+ }
776
+ catch { /* Fall through to recovery if the fresh probe cannot send. */ }
777
+ }
778
+ // A half-open transport may never emit close. Fence its queued callbacks
779
+ // and enter recovery directly rather than waiting for that close event.
780
+ this.socketAttempt += 1;
781
+ this.socket = null;
782
+ this.stopKeepalive();
783
+ closeSocket(socket, 1000, "pong timeout");
784
+ this.beginRecovery();
785
+ }, this.pongTimeoutMs);
786
+ }
680
787
  transition(state, metadata) {
681
788
  if (this.currentState === "closed" || this.currentState === state)
682
789
  return;
@@ -694,6 +801,7 @@ class MultiplayerConnectionImpl {
694
801
  (metadata.type === "left" || metadata.type === "bye" || metadata.type === "replaced"))
695
802
  clearDevReconnectToken(this.devReconnectStorageKey, this.reconnectToken);
696
803
  this.stopKeepalive();
804
+ this.reconnectBudget?.dispose();
697
805
  this.rejectPendingCharacterRequests("MULTIPLAYER_CONNECTION_CLOSED", "The multiplayer connection closed before the shared character request completed.");
698
806
  const socket = this.socket;
699
807
  this.socket = null;
@@ -1211,5 +1319,13 @@ function multiplayerError(code, message, operation = "Multiplayer.join") {
1211
1319
  function asCastleError(error) {
1212
1320
  if (error instanceof CastleError)
1213
1321
  return error;
1322
+ if (error instanceof SocketClosedError) {
1323
+ return new CastleError({
1324
+ code: "MULTIPLAYER_CONNECTION_FAILED",
1325
+ message: error.message,
1326
+ operation: "Multiplayer.join",
1327
+ extensions: { closeCode: error.code },
1328
+ });
1329
+ }
1214
1330
  return multiplayerError("MULTIPLAYER_CONNECTION_FAILED", error instanceof Error ? error.message : "The multiplayer connection failed.");
1215
1331
  }
@@ -14,6 +14,8 @@ export interface SessionPlayer extends PlayerIdentity {
14
14
  playerId: string;
15
15
  }
16
16
  export interface ClientHelloFrame {
17
+ serverBundleSha256?: string;
18
+ serverBundleId?: string;
17
19
  t: "hello";
18
20
  playerId: string;
19
21
  reconnectToken: string;
@@ -0,0 +1,23 @@
1
+ import type { PartyMember, PartyMessage, PartyMessagesResult, PartySummary } from './commands';
2
+ export type { PartyMember, PartyMessage, PartyMessagesResult, PartyStatus, PartySummary, } from './commands';
3
+ export interface CastlePartyApi {
4
+ /** The party this play was launched with, or null when it has none. */
5
+ current(): Promise<PartySummary | null>;
6
+ /** Create a party containing these users and the signed-in player. */
7
+ create(userIds: string[]): Promise<PartySummary>;
8
+ invite(partyId: string, userIds: string[]): Promise<{
9
+ ok: true;
10
+ }>;
11
+ respond(partyId: string, accept: boolean): Promise<{
12
+ ok: true;
13
+ }>;
14
+ members(partyId: string): Promise<PartyMember[]>;
15
+ leave(partyId: string): Promise<{
16
+ ok: true;
17
+ }>;
18
+ /** Newest first. Pass `cursor` to load older history. */
19
+ messages(partyId: string, cursor?: string): Promise<PartyMessagesResult>;
20
+ /** Send plain text; the host trims it to Castle's 1,000-character limit. */
21
+ say(partyId: string, text: string): Promise<PartyMessage>;
22
+ }
23
+ export declare const Party: CastlePartyApi;
@@ -0,0 +1,91 @@
1
+ import { CastleError } from './errors';
2
+ import { hostRequest } from './transport';
3
+ export const Party = {
4
+ current,
5
+ create,
6
+ invite,
7
+ respond,
8
+ members,
9
+ leave,
10
+ messages,
11
+ say,
12
+ };
13
+ const ID_MAX = 128;
14
+ const CURSOR_MAX = 512;
15
+ const PARTY_USERS_MAX = 32;
16
+ function id(value, field, operation) {
17
+ return boundedText(value, field, operation, ID_MAX);
18
+ }
19
+ function boundedText(value, field, operation, max) {
20
+ if (typeof value === 'string' &&
21
+ value.length > 0 &&
22
+ value.length <= max &&
23
+ !value.includes('\0')) {
24
+ return value;
25
+ }
26
+ throw new CastleError({
27
+ code: 'INVALID_ARGUMENT',
28
+ message: `${operation} requires a valid ${field}.`,
29
+ operation,
30
+ });
31
+ }
32
+ function ids(value, operation) {
33
+ if (!Array.isArray(value) || value.length > PARTY_USERS_MAX) {
34
+ throw new CastleError({
35
+ code: 'INVALID_ARGUMENT',
36
+ message: `${operation} requires at most ${PARTY_USERS_MAX} user ids.`,
37
+ operation,
38
+ });
39
+ }
40
+ return value.map((value) => id(value, 'userId', operation));
41
+ }
42
+ async function current() {
43
+ return hostRequest('party.current', {});
44
+ }
45
+ async function create(userIds) {
46
+ return hostRequest('party.create', { userIds: ids(userIds, 'Party.create') });
47
+ }
48
+ async function invite(partyId, userIds) {
49
+ return hostRequest('party.invite', {
50
+ partyId: id(partyId, 'partyId', 'Party.invite'),
51
+ userIds: ids(userIds, 'Party.invite'),
52
+ });
53
+ }
54
+ async function respond(partyId, accept) {
55
+ if (typeof accept !== 'boolean') {
56
+ throw new CastleError({
57
+ code: 'INVALID_ARGUMENT',
58
+ message: 'Party.respond requires accept to be a boolean.',
59
+ operation: 'Party.respond',
60
+ });
61
+ }
62
+ return hostRequest('party.respond', {
63
+ partyId: id(partyId, 'partyId', 'Party.respond'),
64
+ accept,
65
+ });
66
+ }
67
+ async function members(partyId) {
68
+ return hostRequest('party.members', { partyId: id(partyId, 'partyId', 'Party.members') });
69
+ }
70
+ async function leave(partyId) {
71
+ return hostRequest('party.leave', { partyId: id(partyId, 'partyId', 'Party.leave') });
72
+ }
73
+ async function messages(partyId, cursor) {
74
+ const params = {
75
+ partyId: id(partyId, 'partyId', 'Party.messages'),
76
+ };
77
+ if (cursor !== undefined) {
78
+ params.cursor = boundedText(cursor, 'cursor', 'Party.messages', CURSOR_MAX);
79
+ }
80
+ return hostRequest('party.messages', params);
81
+ }
82
+ async function say(partyId, text) {
83
+ if (typeof text !== 'string' || text.length === 0) {
84
+ throw new CastleError({
85
+ code: 'INVALID_ARGUMENT',
86
+ message: 'Party.say requires text.',
87
+ operation: 'Party.say',
88
+ });
89
+ }
90
+ return hostRequest('party.say', { partyId: id(partyId, 'partyId', 'Party.say'), text });
91
+ }
@@ -0,0 +1,23 @@
1
+ export declare class ReconnectBudget {
2
+ private elapsed;
3
+ private lastSeen;
4
+ private heartbeat;
5
+ private wokeSinceAttempt;
6
+ private gapGraceUsed;
7
+ private frozen;
8
+ private disposed;
9
+ private readonly waiters;
10
+ private readonly page;
11
+ constructor();
12
+ get elapsedMs(): number;
13
+ noteAttempt(): void;
14
+ exhausted(limitMs: number): boolean;
15
+ waitUntilActive(): Promise<void>;
16
+ dispose(): void;
17
+ private readonly freeze;
18
+ private readonly resume;
19
+ private readonly update;
20
+ private readonly observe;
21
+ private stop;
22
+ private wakeWaiters;
23
+ }
@@ -0,0 +1,96 @@
1
+ // Recovery gets foreground time to retry. A phone can suspend JavaScript for
2
+ // minutes, so a wall-clock deadline would already be spent when it returns.
3
+ // Not every suspension is announced (a debugger pause, a native app pausing
4
+ // its web view while the document stays visible), so active time accrues in
5
+ // heartbeat steps and a gap longer than one step counts only that step.
6
+ const HEARTBEAT_MS = 1_000;
7
+ const MAX_STEP_MS = 2_000;
8
+ export class ReconnectBudget {
9
+ elapsed = 0;
10
+ lastSeen = null;
11
+ heartbeat = null;
12
+ // Set on every return to the foreground, announced or not; cleared by an attempt.
13
+ wokeSinceAttempt = false;
14
+ // A detected gap earns that try once per outage: a slow phone dropping
15
+ // frames for minutes would otherwise renew it forever.
16
+ gapGraceUsed = false;
17
+ frozen = false;
18
+ disposed = false;
19
+ waiters = new Set();
20
+ page = typeof document === "undefined" ? null : document;
21
+ constructor() {
22
+ this.page?.addEventListener("visibilitychange", this.update);
23
+ this.page?.addEventListener("freeze", this.freeze);
24
+ this.page?.addEventListener("resume", this.resume);
25
+ this.update();
26
+ }
27
+ get elapsedMs() {
28
+ this.observe();
29
+ return this.elapsed;
30
+ }
31
+ noteAttempt() {
32
+ this.wokeSinceAttempt = false;
33
+ }
34
+ // Spent only once an attempt has run since the page last came back, so a
35
+ // stall at the edge of the budget still gets one try with what it holds.
36
+ exhausted(limitMs) {
37
+ return this.elapsedMs >= limitMs && !this.wokeSinceAttempt;
38
+ }
39
+ waitUntilActive() {
40
+ if (this.disposed || this.lastSeen !== null)
41
+ return Promise.resolve();
42
+ return new Promise((resolve) => this.waiters.add(resolve));
43
+ }
44
+ dispose() {
45
+ this.disposed = true;
46
+ this.stop();
47
+ this.page?.removeEventListener("visibilitychange", this.update);
48
+ this.page?.removeEventListener("freeze", this.freeze);
49
+ this.page?.removeEventListener("resume", this.resume);
50
+ this.wakeWaiters();
51
+ }
52
+ freeze = () => {
53
+ this.frozen = true;
54
+ this.update();
55
+ };
56
+ resume = () => {
57
+ this.frozen = false;
58
+ this.update();
59
+ };
60
+ update = () => {
61
+ const active = !this.disposed && !this.frozen && this.page?.visibilityState !== "hidden";
62
+ if (active && this.lastSeen === null) {
63
+ this.lastSeen = Date.now();
64
+ this.heartbeat = setInterval(this.observe, HEARTBEAT_MS);
65
+ this.wokeSinceAttempt = true;
66
+ this.wakeWaiters();
67
+ }
68
+ else if (!active && this.lastSeen !== null) {
69
+ this.stop();
70
+ }
71
+ };
72
+ observe = () => {
73
+ if (this.lastSeen === null)
74
+ return;
75
+ const now = Date.now();
76
+ const gap = now - this.lastSeen;
77
+ if (gap > MAX_STEP_MS && !this.gapGraceUsed) {
78
+ this.gapGraceUsed = true;
79
+ this.wokeSinceAttempt = true;
80
+ }
81
+ this.elapsed += Math.min(Math.max(gap, 0), MAX_STEP_MS);
82
+ this.lastSeen = now;
83
+ };
84
+ stop() {
85
+ this.observe();
86
+ this.lastSeen = null;
87
+ if (this.heartbeat !== null)
88
+ clearInterval(this.heartbeat);
89
+ this.heartbeat = null;
90
+ }
91
+ wakeWaiters() {
92
+ for (const resolve of this.waiters)
93
+ resolve();
94
+ this.waiters.clear();
95
+ }
96
+ }
@@ -63,6 +63,19 @@ export interface SaveTransactionInput {
63
63
  checks?: SaveCheck[];
64
64
  changes: SaveChange[];
65
65
  }
66
+ export interface SaveConditionalCheck extends Omit<SaveCheck, "expectedRevision"> {
67
+ /** Null checks absence without creating the target. */
68
+ expectedRevision: SaveRevision | null;
69
+ }
70
+ export interface SaveConditionalWriteInput extends Omit<SaveTransactionInput, "checks"> {
71
+ checks?: SaveConditionalCheck[];
72
+ /** Session servers only: atomically fence each affected player's progress reset. */
73
+ resetFences?: SaveResetFence[];
74
+ }
75
+ export interface SaveResetFence {
76
+ playerId: string;
77
+ resetGeneration: number;
78
+ }
66
79
  export interface SaveInitial {
67
80
  target: SaveTarget;
68
81
  rows: SaveRows;
@@ -95,8 +108,24 @@ export type SaveOperation = {
95
108
  } | {
96
109
  state: "unknown";
97
110
  };
98
- export type SaveVerb = "snapshot" | "transaction" | "claim" | "initialize" | "operation";
111
+ export interface SaveRecentOperationsInput {
112
+ limit?: number;
113
+ cursor?: string;
114
+ }
115
+ export interface SaveRecentOperationsPage {
116
+ operations: {
117
+ operationId: string;
118
+ committedAt: string;
119
+ receipt: SaveReceipt;
120
+ }[];
121
+ cursor: string | null;
122
+ }
123
+ export type SaveVerb = "snapshot" | "transaction" | "claim" | "initialize" | "operation" | "conditionalWrite" | "recentOperations";
99
124
  export interface SaveApi {
125
+ /** Gated atomic revision check and write, up to eight targets and two players. */
126
+ conditionalWrite(input: SaveConditionalWriteInput): Promise<SaveReceipt>;
127
+ /** Gated caller-scoped receipt discovery after losing local operation IDs. */
128
+ recentOperations(input?: SaveRecentOperationsInput): Promise<SaveRecentOperationsPage>;
100
129
  snapshot(input: {
101
130
  targets: SaveReadTarget[];
102
131
  }): Promise<SaveSnapshot>;
@@ -156,6 +185,10 @@ export interface SaveErrorEnvelope {
156
185
  receipt?: SaveReceipt;
157
186
  retryAfterMs?: number;
158
187
  target?: SaveTarget;
188
+ current?: SaveSnapshot;
189
+ playerId?: string;
190
+ expectedResetGeneration?: number;
191
+ resetGeneration?: number;
159
192
  [detail: string]: unknown;
160
193
  }
161
194
  export declare class SaveError extends CastleError {
@@ -165,6 +198,10 @@ export declare class SaveError extends CastleError {
165
198
  readonly receipt?: SaveReceipt;
166
199
  readonly retryAfterMs?: number;
167
200
  readonly target?: SaveTarget;
201
+ readonly current?: SaveSnapshot;
202
+ readonly playerId?: string;
203
+ readonly expectedResetGeneration?: number;
204
+ readonly resetGeneration?: number;
168
205
  constructor(envelope: SaveErrorEnvelope);
169
206
  }
170
207
  /**