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
@@ -7,6 +7,10 @@ export class SaveError extends CastleError {
7
7
  receipt;
8
8
  retryAfterMs;
9
9
  target;
10
+ current;
11
+ playerId;
12
+ expectedResetGeneration;
13
+ resetGeneration;
10
14
  constructor(envelope) {
11
15
  super({
12
16
  code: envelope.code,
@@ -20,6 +24,10 @@ export class SaveError extends CastleError {
20
24
  this.receipt = envelope.receipt;
21
25
  this.retryAfterMs = envelope.retryAfterMs;
22
26
  this.target = envelope.target;
27
+ this.current = envelope.current;
28
+ this.playerId = envelope.playerId;
29
+ this.expectedResetGeneration = envelope.expectedResetGeneration;
30
+ this.resetGeneration = envelope.resetGeneration;
23
31
  }
24
32
  }
25
33
  /**
@@ -60,7 +68,8 @@ const MAX_SUBJECT_BYTES = 256;
60
68
  const MAX_VALUE_BYTES = 256 * 1024;
61
69
  const encoder = new TextEncoder();
62
70
  const byteLength = (text) => encoder.encode(text).length;
63
- const LONE_SURROGATE = /[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/;
71
+ // Unicode mode consumes valid pairs together; avoid lookbehind for Safari < 16.4.
72
+ const LONE_SURROGATE = /[\uD800-\uDFFF]/u;
64
73
  function invalid(message) {
65
74
  throw new SaveError({
66
75
  code: "CAULDRON_STORAGE_INVALID_ARGUMENT",
@@ -240,12 +249,14 @@ function encodeChange(change, server) {
240
249
  ...(remove === undefined ? {} : { remove }),
241
250
  };
242
251
  }
243
- function encodeCheck(check, server) {
252
+ function encodeCheck(check, server, conditional = false) {
244
253
  const target = validateSaveTarget(check.target, server);
254
+ if (conditional && check.expectedRevision === undefined)
255
+ invalid("Every conditional check needs an expected revision.");
245
256
  if (check.expectedRevision === undefined && check.writer === undefined) {
246
257
  invalid("A check needs an expected revision or a writer.");
247
258
  }
248
- if (check.expectedRevision !== undefined) {
259
+ if (check.expectedRevision !== undefined && !(conditional && check.expectedRevision === null)) {
249
260
  checkText(check.expectedRevision, "expected revision");
250
261
  }
251
262
  if (check.writer !== undefined)
@@ -258,7 +269,7 @@ function encodeCheck(check, server) {
258
269
  ...(check.writer === undefined ? {} : { writer: check.writer }),
259
270
  };
260
271
  }
261
- function encodeTransaction(input, server) {
272
+ function encodeTransaction(input, server, conditional = false) {
262
273
  const changes = checkList(input.changes, "changes").map((change) => encodeChange(change, server));
263
274
  const keys = changes.map((change) => saveTargetKey(change.target));
264
275
  if (new Set(keys).size !== keys.length) {
@@ -267,14 +278,35 @@ function encodeTransaction(input, server) {
267
278
  return {
268
279
  operationId: input.operationId,
269
280
  expectedAccess: checkText(input.expectedAccess, "expected access"),
281
+ ...(input.resetFences === undefined
282
+ ? {}
283
+ : { resetFences: encodeResetFences(input.resetFences, server && conditional) }),
270
284
  ...(input.checks === undefined
271
285
  ? {}
272
286
  : {
273
- checks: checkList(input.checks, "checks").map((check) => encodeCheck(check, server)),
287
+ checks: checkList(input.checks, "checks").map((check) => encodeCheck(check, server, conditional)),
274
288
  }),
275
289
  changes,
276
290
  };
277
291
  }
292
+ function encodeResetFences(value, allowed) {
293
+ if (!allowed || !Array.isArray(value) || value.length < 1 || value.length > 2)
294
+ invalid("resetFences requires one or two players on a server conditional write.");
295
+ const seen = new Set();
296
+ return value.map((entry) => {
297
+ if (!entry || typeof entry !== "object" || Array.isArray(entry) ||
298
+ Reflect.ownKeys(entry).length !== 2 ||
299
+ !Object.hasOwn(entry, "playerId") || !Object.hasOwn(entry, "resetGeneration"))
300
+ invalid("Invalid reset fence.");
301
+ const fence = entry;
302
+ if (typeof fence.playerId !== "string" || !/^[1-9][0-9]{0,19}$/.test(fence.playerId) ||
303
+ seen.has(fence.playerId) || !Number.isInteger(fence.resetGeneration) ||
304
+ fence.resetGeneration < 0 || fence.resetGeneration > 2147483647)
305
+ invalid("Invalid reset fence player or generation.");
306
+ seen.add(fence.playerId);
307
+ return { playerId: fence.playerId, resetGeneration: fence.resetGeneration };
308
+ });
309
+ }
278
310
  /** Validates and copies a request; the result is what goes on the wire. */
279
311
  export function encodeSaveInput(verb, input, server = false) {
280
312
  if (!input || typeof input !== "object" || Array.isArray(input)) {
@@ -282,12 +314,26 @@ export function encodeSaveInput(verb, input, server = false) {
282
314
  }
283
315
  if (verb === "snapshot")
284
316
  return { targets: encodeReads(input.targets, server) };
317
+ if (verb === "recentOperations") {
318
+ const limit = input.limit ?? 16;
319
+ if (!Number.isInteger(limit) || limit < 1 || limit > 32)
320
+ invalid("Recovery limit must be 1 to 32.");
321
+ if (input.cursor !== undefined)
322
+ checkText(input.cursor, "recovery cursor", 2048);
323
+ return { limit, ...(input.cursor === undefined ? {} : { cursor: input.cursor }) };
324
+ }
285
325
  checkText(input.operationId, "operation id", MAX_KEY_BYTES);
286
326
  if (verb === "operation")
287
327
  return { operationId: input.operationId };
288
- if (verb === "transaction") {
328
+ if (verb === "transaction" || verb === "conditionalWrite") {
329
+ if (verb === "conditionalWrite") {
330
+ const changes = input.changes;
331
+ const checks = input.checks ?? [];
332
+ if (!Array.isArray(changes) || !changes.length || changes.length + checks.length > 8)
333
+ invalid("Conditional writes require 1 to 8 targets.");
334
+ }
289
335
  return {
290
- ...encodeTransaction(input, server),
336
+ ...encodeTransaction(input, server, verb === "conditionalWrite"),
291
337
  };
292
338
  }
293
339
  if (input.expectedAccess !== undefined) {
@@ -422,6 +468,34 @@ export function createSaveApi(call, server = false) {
422
468
  }
423
469
  }
424
470
  return {
471
+ async conditionalWrite(input) {
472
+ const result = await send("conditionalWrite", { ...input });
473
+ return decodeReceipt(result, input.operationId, input.changes.map((change) => change.target));
474
+ },
475
+ async recentOperations(input = {}) {
476
+ const page = (await send("recentOperations", {
477
+ ...input,
478
+ }));
479
+ if (!page ||
480
+ !Array.isArray(page.operations) ||
481
+ page.operations.length > (input.limit ?? 16) ||
482
+ (page.cursor !== null && typeof page.cursor !== "string"))
483
+ invalidResponse();
484
+ return {
485
+ operations: page.operations.map((operation) => {
486
+ if (!operation ||
487
+ typeof operation.operationId !== "string" ||
488
+ typeof operation.committedAt !== "string")
489
+ invalidResponse();
490
+ return {
491
+ operationId: operation.operationId,
492
+ committedAt: operation.committedAt,
493
+ receipt: decodeReceipt(operation.receipt, operation.operationId, []),
494
+ };
495
+ }),
496
+ cursor: page.cursor,
497
+ };
498
+ },
425
499
  async snapshot(input) {
426
500
  return decodeSnapshot(await send("snapshot", { ...input }), input.targets);
427
501
  },
@@ -64,6 +64,52 @@ export interface MultiplayerHubWearReceipt {
64
64
  /** What the player now wears; null when cleared. */
65
65
  wearable: MultiplayerHubWearable | null;
66
66
  }
67
+ /** The classes of earned item a hub game may give (contract v1.53). */
68
+ export type MultiplayerHubEarnedClass = "badge" | "pin" | "belt" | "sash" | "held";
69
+ /** The home classes a hub game may give (contract v1.70/v1.73), never worn. */
70
+ export type MultiplayerHubHomeClass = "furniture" | "deed" | "pet";
71
+ /**
72
+ * An earned item: something a hub game gave a player for a stated deed, declared
73
+ * in that game's castle.json `hub.unlocks` and kept by Castle per account. It has
74
+ * no rarity. `deckId` is the game that declared it; `id` and `shape` match
75
+ * /^[a-z][a-z0-9-]{0,23}$/, `color` is '#rrggbb'.
76
+ */
77
+ export interface MultiplayerHubEarnedItem {
78
+ deckId: string;
79
+ id: string;
80
+ class: MultiplayerHubEarnedClass;
81
+ shape: string;
82
+ name: string;
83
+ deed: string;
84
+ color: string;
85
+ }
86
+ /** A furniture piece, area deed or adopted pet owned for the house, never shown on an avatar. */
87
+ export interface MultiplayerHubHomeItem {
88
+ deckId: string;
89
+ id: string;
90
+ class: MultiplayerHubHomeClass;
91
+ piece: string;
92
+ name: string;
93
+ deed: string;
94
+ color: string;
95
+ }
96
+ export interface MultiplayerHubUnlockReceipt {
97
+ unlocked: true;
98
+ /** True when this call gave the player the item for the first time. */
99
+ isNew: boolean;
100
+ /** What the player now shows in the earned slot (never a home item); null when none. */
101
+ earned: MultiplayerHubEarnedItem | null;
102
+ }
103
+ export interface MultiplayerHubWearEarnedReceipt {
104
+ /** What the player now shows in the earned slot; null when cleared. */
105
+ earned: MultiplayerHubEarnedItem | null;
106
+ }
107
+ export interface MultiplayerHubUnlocksRead {
108
+ /** Each player's owned wearable and home items, by user id. */
109
+ players: Record<string, {
110
+ owned: (MultiplayerHubEarnedItem | MultiplayerHubHomeItem)[];
111
+ }>;
112
+ }
67
113
  export interface MultiplayerHubPadUpdateInput {
68
114
  /** A pad door of this place, from ghost's door table. */
69
115
  doorId: string;
@@ -91,8 +137,12 @@ export interface MultiplayerHubPlayerResults {
91
137
  records: MultiplayerHubRecord[];
92
138
  /** The player's platform avatar, chosen or default; null when ghost has none to say. */
93
139
  avatar: number | null;
140
+ /** Account-wide door hearts, oldest first; absent on older ghosts. */
141
+ hearts?: string[];
94
142
  /** The player's wearable; null when none. Absent from a ghost older than wearables. */
95
143
  wearable?: MultiplayerHubWearable | null;
144
+ /** The earned item the player shows (contract v1.53); absent when none. */
145
+ earned?: MultiplayerHubEarnedItem;
96
146
  }
97
147
  export interface MultiplayerHubBoard {
98
148
  toDeckId: string;
@@ -134,6 +184,34 @@ export interface MultiplayerHubResultsRead {
134
184
  * and for a deck that declares no hub block.
135
185
  */
136
186
  export interface MultiplayerServerHub {
187
+ /** Present only for an enabled place on a capable runtime. Reports visits; Ghost owns comeback delivery. */
188
+ readonly push?: {
189
+ visit(playerId: string, visit: {
190
+ userId: string;
191
+ timezone: string;
192
+ }): Promise<boolean>;
193
+ };
194
+ /** Durably appends NPC words to a private platform archive. No read operation. */
195
+ archiveText(playerId: string, entry: {
196
+ npcId: string;
197
+ characterId?: string;
198
+ conversationId?: string;
199
+ operationId: string;
200
+ input?: string;
201
+ reply?: string;
202
+ }): Promise<void>;
203
+ /** Numeric hub telemetry; unavailable/refused delivery returns false, never blocks play. */
204
+ track(playerId: string, event: {
205
+ kind: number;
206
+ subject?: number;
207
+ value?: number;
208
+ result?: number;
209
+ flags?: number;
210
+ }): Promise<boolean>;
211
+ /** The owner user id, only in an owner door instance. */
212
+ readonly owner?: string;
213
+ /** Host-pinned inclusive reconnect grace for this hub place, in milliseconds. */
214
+ readonly reconnectWindowMs?: number;
137
215
  readonly place: string | null;
138
216
  readonly title: string | null;
139
217
  readonly result: MultiplayerHubResultShape | null;
@@ -156,6 +234,45 @@ export interface MultiplayerServerHub {
156
234
  * without it).
157
235
  */
158
236
  wear(playerId: string, wearable: MultiplayerHubWearable | null): Promise<MultiplayerHubWearReceipt>;
237
+ /**
238
+ * Gives a signed-in player one of this deck's declared earned items (castle.json
239
+ * `hub.unlocks`), by its id. Castle takes it only from a curated hub place, for a
240
+ * declared id; a first wearable unlock is also shown. Home items are never worn.
241
+ * Rejects with a `CAULDRON_HUB_*` code
242
+ * (`CAULDRON_HUB_UNAVAILABLE` on a runtime without it).
243
+ */
244
+ unlock(playerId: string, itemId: string): Promise<MultiplayerHubUnlockReceipt>;
245
+ /**
246
+ * Chooses which owned earned item a signed-in player shows, or none with null.
247
+ * Castle takes it only from the town; home items are refused.
248
+ * Rejects with a `CAULDRON_HUB_*` code
249
+ * (`CAULDRON_HUB_UNAVAILABLE` on a runtime without it).
250
+ */
251
+ wearEarned(playerId: string, earned: {
252
+ deckId: string;
253
+ id: string;
254
+ } | null): Promise<MultiplayerHubWearEarnedReceipt>;
255
+ /**
256
+ * The earned items players here own, by user id. Rejects with a `CAULDRON_HUB_*`
257
+ * code (`CAULDRON_HUB_UNAVAILABLE` on a runtime without it).
258
+ */
259
+ readUnlocks(userIds: readonly string[]): Promise<MultiplayerHubUnlocksRead>;
260
+ /** The connected player's friends among these candidates; platform refusals reject. */
261
+ friendsAmong(playerId: string, userIds: readonly string[]): Promise<string[]>;
262
+ /**
263
+ * The connected player's mutual friends and follows in either direction among
264
+ * these candidates, in one host read. Missing lists are empty; refusals reject.
265
+ * Optional strict mode rejects malformed raw lists and marks the result validated.
266
+ * These relations belong to this player only; never send them to another client.
267
+ */
268
+ relationsAmong(playerId: string, userIds: readonly string[], options?: {
269
+ strict: true;
270
+ }): Promise<{
271
+ validated?: true;
272
+ friends: string[];
273
+ follows: string[];
274
+ followedBy: string[];
275
+ }>;
159
276
  /**
160
277
  * Whether a block hides these two players from each other: either one blocked
161
278
  * the other, in either direction. Symmetric. The block lists themselves stay
@@ -39,6 +39,18 @@ function hubHiddenUserIds(raw) {
39
39
  }
40
40
  return ids.size > 0 ? ids : null;
41
41
  }
42
+ function unavailable(op, what) {
43
+ return new CastleError({
44
+ code: "CAULDRON_HUB_UNAVAILABLE",
45
+ message: `This host's runtime cannot ${what}.`,
46
+ operation: `session.hub.${op}`,
47
+ });
48
+ }
49
+ function reconnectMetadata(pinned) {
50
+ const value = pinned.reconnectWindowMs;
51
+ return pinned.result === null && typeof value === "number" && Number.isInteger(value) && value > 0 && value <= 180_000
52
+ ? { reconnectWindowMs: value } : {};
53
+ }
42
54
  export function createServerHub(platformHandle, arrivals, hiddenPair = () => false) {
43
55
  const pinned = platformHandle.hub;
44
56
  if (!pinned ||
@@ -65,16 +77,67 @@ export function createServerHub(platformHandle, arrivals, hiddenPair = () => fal
65
77
  }
66
78
  return parsed;
67
79
  };
68
- return Object.freeze({
80
+ const hub = {
81
+ ...pushCapability(platformHandle),
82
+ async archiveText(playerId, entry) {
83
+ if (platformHandle.hubTextArchiveEnabled !== true || typeof platformHandle.storage !== "function")
84
+ throw unavailable("archiveText", "archive NPC transcripts");
85
+ if (JSON.parse(await platformHandle.storage("hubTextArchive", JSON.stringify({ ...entry, playerId })))?.recorded !== true)
86
+ throw unavailable("archiveText", "archive NPC transcripts");
87
+ },
69
88
  place: typeof pinned.place === "string" ? pinned.place : null,
70
89
  title: typeof pinned.title === "string" ? pinned.title : null,
71
90
  result: pinned.result ?? null,
91
+ ...(typeof pinned.owner === "string" && pinned.owner.length > 0 ? { owner: pinned.owner } : {}),
92
+ ...reconnectMetadata(pinned),
72
93
  arrival(playerId) {
73
94
  return arrivals.get(playerId) ?? null;
74
95
  },
75
96
  hiddenPair(playerIdA, playerIdB) {
76
97
  return hiddenPair(playerIdA, playerIdB);
77
98
  },
99
+ async track(playerId, event) {
100
+ try {
101
+ const json = JSON.stringify({ ...event, playerId });
102
+ const raw = await platformHandle.storage?.("hubTrack", json);
103
+ return JSON.parse(raw ?? "null")?.recorded === true;
104
+ }
105
+ catch {
106
+ return false;
107
+ }
108
+ },
109
+ async friendsAmong(playerId, userIds) {
110
+ const json = JSON.stringify({ playerId, userIds: [...userIds] });
111
+ const raw = typeof platformHandle.hubFriendsAmong === "function"
112
+ ? await platformHandle.hubFriendsAmong(json)
113
+ : await platformHandle.storage?.("hubFriendsAmong", json);
114
+ const answer = JSON.parse(raw ?? "null");
115
+ return Array.isArray(answer?.userIds) ? answer.userIds : [];
116
+ },
117
+ async relationsAmong(playerId, userIds, options = undefined) {
118
+ const asked = new Set(userIds);
119
+ const json = JSON.stringify({ playerId, userIds: [...userIds] });
120
+ let raw;
121
+ if (typeof platformHandle.hubFriendsAmong === "function") {
122
+ raw = await platformHandle.hubFriendsAmong(json);
123
+ }
124
+ else {
125
+ raw = await platformHandle.storage?.("hubFriendsAmong", json);
126
+ }
127
+ const answer = JSON.parse(raw ?? "null");
128
+ if (options?.strict === true && (!answer || ["userIds", "follows", "followedBy"].some((key) => !Array.isArray(answer[key]) || answer[key].length > 100 || answer[key].some((id) => typeof id !== "string" || !/^\d{1,20}$/.test(id) || !asked.has(id))))) {
129
+ throw new CastleError({ code: "CAULDRON_HUB_INVALID_RESPONSE", message: "The platform returned an invalid friends response.", operation: "session.hub.relationsAmong" });
130
+ }
131
+ const list = (value) => Array.isArray(value)
132
+ ? value.filter((id) => typeof id === "string" && asked.has(id))
133
+ : [];
134
+ return {
135
+ ...(options?.strict === true ? { validated: true } : {}),
136
+ friends: list(answer?.userIds),
137
+ follows: list(answer?.follows),
138
+ followedBy: list(answer?.followedBy),
139
+ };
140
+ },
78
141
  async reportResult(playerId, result) {
79
142
  const { place, outcome, score, stats } = result ?? {};
80
143
  return (await call("hubResult", {
@@ -121,5 +184,59 @@ export function createServerHub(platformHandle, arrivals, hiddenPair = () => fal
121
184
  wearable: (receipt.wearable ?? null),
122
185
  };
123
186
  },
124
- });
187
+ async unlock(playerId, itemId) {
188
+ if (typeof platformHandle.hubUnlock !== "function") {
189
+ throw unavailable("hubUnlock", "give earned items");
190
+ }
191
+ const receipt = await call("hubUnlock", { playerId, itemId });
192
+ return {
193
+ unlocked: true,
194
+ isNew: receipt.isNew === true,
195
+ earned: (receipt.earned ?? null),
196
+ };
197
+ },
198
+ async wearEarned(playerId, earned) {
199
+ if (typeof platformHandle.hubWearEarned !== "function") {
200
+ throw unavailable("hubWearEarned", "choose earned items");
201
+ }
202
+ const receipt = await call("hubWearEarned", {
203
+ playerId,
204
+ earned: earned === null || earned === undefined
205
+ ? null
206
+ : { deckId: earned.deckId, id: earned.id },
207
+ });
208
+ return {
209
+ earned: (receipt.earned ?? null),
210
+ };
211
+ },
212
+ async readUnlocks(userIds) {
213
+ if (typeof platformHandle.hubUnlocksRead !== "function") {
214
+ throw unavailable("hubUnlocksRead", "read earned items");
215
+ }
216
+ const read = await call("hubUnlocksRead", { userIds: [...(userIds ?? [])] });
217
+ return {
218
+ players: (read.players ?? {}),
219
+ };
220
+ },
221
+ };
222
+ // Preserve the enumerable API shape and diagnostic serialization of existing
223
+ // places. Opted-in kits call this method explicitly; it adds no wire field.
224
+ Object.defineProperty(hub, "track", { enumerable: false });
225
+ Object.defineProperty(hub, "archiveText", { enumerable: false });
226
+ return Object.freeze(hub);
227
+ }
228
+ async function pushVisitCall(call, playerId, args) {
229
+ try {
230
+ return JSON.parse(await call(JSON.stringify({ ...args, playerId })))?.accepted === true;
231
+ }
232
+ catch {
233
+ return false;
234
+ }
235
+ }
236
+ function pushCapability(handle) {
237
+ if (handle.hub?.push?.version !== 1 || typeof handle.hubPushVisit !== "function")
238
+ return {};
239
+ return { push: {
240
+ visit: (playerId, visit) => pushVisitCall((raw) => handle.hubPushVisit(raw), playerId, visit),
241
+ } };
125
242
  }
@@ -6,6 +6,8 @@ export interface PlayerIdentity {
6
6
  username: string;
7
7
  isAnonymous: boolean;
8
8
  scopedUserId?: string;
9
+ /** Trusted hub age boundary; omitted by older hosts. Never client supplied. */
10
+ under13?: boolean;
9
11
  }
10
12
  export interface PlatformSessionConfig {
11
13
  readonly sessionId: string;
@@ -53,6 +55,7 @@ export interface PlatformHandle {
53
55
  on(event: "worldCharacterTurn", callback: (request: PlatformWorldCharacterTurn) => unknown): void;
54
56
  on(event: "worldCharacterCommand", callback: (request: PlatformWorldCharacterCommand) => unknown): void;
55
57
  on(event: "worldCharacterRead", callback: (request: PlatformWorldCharacterRead) => unknown): void;
58
+ on(event: "worldCharacterTool", callback: (request: PlatformWorldCharacterTool) => unknown): void;
56
59
  /**
57
60
  * Deck storage. Strings in and strings out, like the rest of this handle, so a
58
61
  * runtime other than the Node shim can implement it without knowing what storage is.
@@ -65,15 +68,26 @@ export interface PlatformHandle {
65
68
  storage?(op: string, argsJson: string): Promise<string>;
66
69
  /** False when the host cannot broker storage, so a call can fail at once. */
67
70
  readonly storageEnabled?: boolean;
71
+ readonly hubTextArchiveEnabled?: boolean;
68
72
  /** Persistent-world checkpoint broker. The host stamps the hidden world binding. */
69
73
  worldCheckpointRead?(): Promise<string>;
70
74
  worldCheckpointCommit?(argsJson: string): Promise<string>;
71
- worldCharacterSend?(grantId: string): Promise<string>;
75
+ /** `tools` is the turn's place tools, passed only when non-empty. */
76
+ worldCharacterSend?(grantId: string, tools?: readonly PlatformPlaceTool[], hubTextArchive?: {
77
+ npcId: string;
78
+ conversationId?: string;
79
+ input: string;
80
+ }): Promise<string>;
72
81
  worldCharacterCommand?(grantId: string): Promise<string>;
73
82
  worldCharacterRead?(grantId: string): Promise<string>;
74
83
  worldCharacterRuntimeCreate?(argsJson: string): Promise<string>;
75
84
  worldCharacterRuntimeList?(): Promise<string>;
76
85
  worldCharacterReject?(grantId: string, code?: string): void;
86
+ /**
87
+ * Answers a `worldCharacterTool` event with at most 1 KiB of UTF-8. Present only
88
+ * when the host serves place tools, which is also what lets a send declare them.
89
+ */
90
+ worldCharacterToolResult?(requestId: string, result: string): Promise<string>;
77
91
  /**
78
92
  * The hub place this session runs, as ghost pinned it from the published
79
93
  * castle.json `hub` block. Present only when the host services the hub ops
@@ -83,8 +97,17 @@ export interface PlatformHandle {
83
97
  hubResult?(argsJson: string): Promise<string>;
84
98
  hubPadUpdate?(argsJson: string): Promise<string>;
85
99
  hubResultsRead?(argsJson: string): Promise<string>;
100
+ /** Friends among candidates (hub contract v1.36); older images use storage. */
101
+ hubFriendsAmong?(argsJson: string): Promise<string>;
102
+ hubPushVisit?(argsJson: string): Promise<string>;
86
103
  /** Absent on a runtime older than wearables (contract v1.4). */
87
104
  hubWear?(argsJson: string): Promise<string>;
105
+ /** Absent on a runtime older than earned items (contract v1.53). */
106
+ hubUnlock?(argsJson: string): Promise<string>;
107
+ /** Absent on a runtime older than earned items (contract v1.53). */
108
+ hubWearEarned?(argsJson: string): Promise<string>;
109
+ /** Absent on a runtime older than earned items (contract v1.53). */
110
+ hubUnlocksRead?(argsJson: string): Promise<string>;
88
111
  readonly config: PlatformSessionConfig;
89
112
  }
90
113
  export interface PlatformHubResultShape {
@@ -98,6 +121,11 @@ export interface PlatformHubResultShape {
98
121
  stats: Record<string, "number" | "string">;
99
122
  }
100
123
  export interface PlatformHubPlace {
124
+ push?: {
125
+ version: 1;
126
+ };
127
+ owner?: string;
128
+ reconnectWindowMs?: number;
101
129
  place?: string;
102
130
  title?: string | null;
103
131
  result?: PlatformHubResultShape | null;
@@ -124,6 +152,20 @@ export interface PlatformWorldCharacterRead {
124
152
  };
125
153
  query: unknown;
126
154
  }
155
+ /** A lookup a place declares for one character turn. */
156
+ export interface PlatformPlaceTool {
157
+ name: string;
158
+ description: string;
159
+ input_schema: Record<string, unknown>;
160
+ }
161
+ export interface PlatformWorldCharacterTool {
162
+ requestId: string;
163
+ operationId: string;
164
+ characterId: string;
165
+ playerId: string;
166
+ name: string;
167
+ input: Record<string, unknown>;
168
+ }
127
169
  export interface PlatformWorldCharacterTurn {
128
170
  grantId: string;
129
171
  requestId: string;
@@ -23,6 +23,12 @@ export interface ServerStorageScope extends SaveBucketApi {
23
23
  increment(key: string, delta?: number): Promise<number>;
24
24
  list<T extends Json = Json>(options?: ServerStorageListOptions): Promise<ServerStorageListPage<T>>;
25
25
  }
26
+ export interface ServerTownStorage {
27
+ get<T extends Json = Json>(keys: string[]): Promise<Record<string, T>>;
28
+ set(values: Record<string, Json>): Promise<void>;
29
+ remove(keys: string[]): Promise<void>;
30
+ increment(key: string, delta?: number): Promise<number>;
31
+ }
26
32
  export interface ServerStorageBoardScore {
27
33
  subject: string;
28
34
  score: number;
@@ -45,6 +51,8 @@ export interface ServerStorageBoard {
45
51
  */
46
52
  export interface ServerPlaythrough {
47
53
  readonly generation: number;
54
+ /** Present only after an administrator reset this player's deck progress. */
55
+ readonly resetGeneration?: number;
48
56
  /** Explicit narrative changes for this same player and generation. */
49
57
  readonly characters: ServerPlaythroughCharacters;
50
58
  get<T extends Json = Json>(keys: string[]): Promise<Record<string, T>>;
@@ -259,10 +267,19 @@ export interface ServerCharacterHistoryOptions {
259
267
  cursor?: string | null;
260
268
  }
261
269
  export interface ServerStorage extends SaveApi {
270
+ /** Reads the authoritative progress-reset generation, including never-reset zero. */
271
+ resetGeneration(userId: string): Promise<number>;
262
272
  /** Shared by everyone playing the deck, and owned by this server. */
263
273
  readonly deck: ServerStorageScope;
264
274
  /** One player's public data. Readable by anyone; writable by them or by this server. */
265
275
  user(userId: string): ServerStorageScope;
276
+ /**
277
+ * The door deck's source town's deck-scope rows, for one player in this session.
278
+ * Only a door deck's server may call it; a town gets CAULDRON_HUB_NO_TOWN.
279
+ * In an owner house, only the owner's rows are accessible. Quota counts against
280
+ * the town. Each key must be tokens|spent|own|hat|chirp, then userId, as its first two segments.
281
+ */
282
+ town(userId: string): ServerTownStorage;
266
283
  board(name: string): ServerStorageBoard;
267
284
  /** Opens one player's experimental, generation-bound game namespace. */
268
285
  playthrough(userId: string): Promise<ServerPlaythrough>;