castle-web-cli 0.4.233 → 0.4.235

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 (383) hide show
  1. package/dist/api.d.ts +11 -0
  2. package/dist/api.js +43 -0
  3. package/dist/bundle.d.ts +64 -0
  4. package/dist/bundle.js +558 -2
  5. package/dist/castle-host/host.d.ts +17 -2
  6. package/dist/castle-host/host.js +793 -36
  7. package/dist/castleJson.d.ts +20 -1
  8. package/dist/castleJson.js +44 -2
  9. package/dist/check.js +9 -2
  10. package/dist/chunkLoader.d.ts +3 -0
  11. package/dist/chunkLoader.js +111 -0
  12. package/dist/devParty.d.ts +26 -0
  13. package/dist/devParty.js +231 -0
  14. package/dist/devSaveStorage.js +4 -0
  15. package/dist/devSessionStorage.js +3 -1
  16. package/dist/devSocial.d.ts +24 -0
  17. package/dist/devSocial.js +70 -0
  18. package/dist/ide.d.ts +2 -0
  19. package/dist/ide.js +119 -15
  20. package/dist/index.js +8 -2
  21. package/dist/init.js +1 -1
  22. package/dist/save-deck.d.ts +20 -1
  23. package/dist/save-deck.js +141 -5
  24. package/dist/serve.js +29 -11
  25. package/dist/shell/assets/{index-BjOxR-lW.js → index-DulbYIJm.js} +97 -97
  26. package/dist/shell/index.html +1 -1
  27. package/dist/vitePlugins.d.ts +2 -1
  28. package/dist/vitePlugins.js +13 -0
  29. package/kits/base/castle.json +1 -1
  30. package/kits/base/sdk/README.md +266 -3
  31. package/kits/base/sdk/castle.d.ts +7 -3
  32. package/kits/base/sdk/castle.js +2 -0
  33. package/kits/base/sdk/commands.d.ts +162 -1
  34. package/kits/base/sdk/commands.js +3 -0
  35. package/kits/base/sdk/display.d.ts +3 -0
  36. package/kits/base/sdk/display.js +9 -3
  37. package/kits/base/sdk/hub.d.ts +33 -6
  38. package/kits/base/sdk/hub.js +68 -5
  39. package/kits/base/sdk/hubRejoin.d.ts +4 -0
  40. package/kits/base/sdk/hubRejoin.js +15 -0
  41. package/kits/base/sdk/multiplayer.d.ts +7 -1
  42. package/kits/base/sdk/multiplayer.js +147 -40
  43. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  44. package/kits/base/sdk/party.d.ts +23 -0
  45. package/kits/base/sdk/party.js +91 -0
  46. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  47. package/kits/base/sdk/reconnectBudget.js +96 -0
  48. package/kits/base/sdk/save.d.ts +38 -1
  49. package/kits/base/sdk/save.js +79 -6
  50. package/kits/base/sdk/server/hub.d.ts +31 -1
  51. package/kits/base/sdk/server/hub.js +50 -3
  52. package/kits/base/sdk/server/platformHandle.d.ts +13 -1
  53. package/kits/base/sdk/server/storage.d.ts +4 -0
  54. package/kits/base/sdk/server/storage.js +19 -3
  55. package/kits/base/sdk/server/wrapper.d.ts +7 -1
  56. package/kits/base/sdk/server/wrapper.js +10 -1
  57. package/kits/base/sdk/social.d.ts +9 -0
  58. package/kits/base/sdk/social.js +5 -0
  59. package/kits/hub-game/CLAUDE.md +123 -3
  60. package/kits/hub-game/README.md +63 -0
  61. package/kits/hub-game/castle.json +5 -5
  62. package/kits/hub-game/code/client/act.js +312 -0
  63. package/kits/hub-game/code/client/actionLayout.js +147 -0
  64. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  65. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  66. package/kits/hub-game/code/client/askSlot.js +117 -0
  67. package/kits/hub-game/code/client/avatar.js +4 -2
  68. package/kits/hub-game/code/client/avatarShare.js +2 -0
  69. package/kits/hub-game/code/client/backVisibility.js +13 -0
  70. package/kits/hub-game/code/client/ballot.js +15 -10
  71. package/kits/hub-game/code/client/build.js +16 -0
  72. package/kits/hub-game/code/client/chat.js +41 -5
  73. package/kits/hub-game/code/client/chatModeration.js +5 -0
  74. package/kits/hub-game/code/client/chrome.js +1148 -258
  75. package/kits/hub-game/code/client/crowdNames.js +241 -0
  76. package/kits/hub-game/code/client/decor.js +10 -4
  77. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  78. package/kits/hub-game/code/client/doorErrors.js +39 -0
  79. package/kits/hub-game/code/client/fall.js +18 -0
  80. package/kits/hub-game/code/client/farAvatars.js +233 -0
  81. package/kits/hub-game/code/client/firstJoin.js +9 -2
  82. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  83. package/kits/hub-game/code/client/frameBatch.js +5 -0
  84. package/kits/hub-game/code/client/grab.js +31 -11
  85. package/kits/hub-game/code/client/hookLayer.js +87 -8
  86. package/kits/hub-game/code/client/hudCopy.js +51 -0
  87. package/kits/hub-game/code/client/hudRate.js +20 -0
  88. package/kits/hub-game/code/client/idle.js +14 -2
  89. package/kits/hub-game/code/client/invites.js +231 -0
  90. package/kits/hub-game/code/client/joinError.js +9 -0
  91. package/kits/hub-game/code/client/labelsNear.js +31 -2
  92. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  93. package/kits/hub-game/code/client/layoutCache.js +264 -0
  94. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  95. package/kits/hub-game/code/client/loadingCover.js +148 -0
  96. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  97. package/kits/hub-game/code/client/menuRows.js +43 -0
  98. package/kits/hub-game/code/client/modelReady.js +7 -0
  99. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  100. package/kits/hub-game/code/client/padCues.js +112 -0
  101. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  102. package/kits/hub-game/code/client/padReadability.js +26 -0
  103. package/kits/hub-game/code/client/padRings.js +69 -0
  104. package/kits/hub-game/code/client/pushVisit.js +14 -0
  105. package/kits/hub-game/code/client/quality.js +205 -0
  106. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  107. package/kits/hub-game/code/client/safeLayout.js +338 -0
  108. package/kits/hub-game/code/client/safeStyle.js +42 -0
  109. package/kits/hub-game/code/client/say.js +12 -3
  110. package/kits/hub-game/code/client/shot.js +64 -10
  111. package/kits/hub-game/code/client/shotFit.js +56 -0
  112. package/kits/hub-game/code/client/signIn.js +28 -0
  113. package/kits/hub-game/code/client/state.js +53 -0
  114. package/kits/hub-game/code/client/talk.js +209 -45
  115. package/kits/hub-game/code/client/tiers.js +68 -66
  116. package/kits/hub-game/code/client/together.js +7 -2
  117. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  118. package/kits/hub-game/code/client/weakestTier.js +295 -0
  119. package/kits/hub-game/code/client/worldLabels.js +241 -0
  120. package/kits/hub-game/code/client/yours.js +10 -9
  121. package/kits/hub-game/code/npcDisplayText.js +55 -0
  122. package/kits/hub-game/code/server/act.js +124 -0
  123. package/kits/hub-game/code/server/actions.js +6 -1
  124. package/kits/hub-game/code/server/actors.js +2 -1
  125. package/kits/hub-game/code/server/analytics.js +83 -0
  126. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  127. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  128. package/kits/hub-game/code/server/companion.js +28 -3
  129. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  130. package/kits/hub-game/code/server/earned.js +22 -5
  131. package/kits/hub-game/code/server/frameBatch.js +183 -0
  132. package/kits/hub-game/code/server/friendsAmong.js +49 -9
  133. package/kits/hub-game/code/server/history.js +2 -0
  134. package/kits/hub-game/code/server/hub.js +1306 -95
  135. package/kits/hub-game/code/server/idle.js +30 -1
  136. package/kits/hub-game/code/server/index.js +26 -4
  137. package/kits/hub-game/code/server/invites.js +19 -0
  138. package/kits/hub-game/code/server/labels.js +9 -1
  139. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  140. package/kits/hub-game/code/server/manifest.js +211 -3
  141. package/kits/hub-game/code/server/menu.js +31 -3
  142. package/kits/hub-game/code/server/npcs.js +226 -64
  143. package/kits/hub-game/code/server/observe.js +408 -0
  144. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  145. package/kits/hub-game/code/server/players.js +9 -1
  146. package/kits/hub-game/code/server/resumePose.js +152 -0
  147. package/kits/hub-game/code/server/say.js +1 -1
  148. package/kits/hub-game/code/server/standing.js +4 -5
  149. package/kits/hub-game/code/server/storageLimit.js +187 -0
  150. package/kits/hub-game/code/server/vis.js +67 -5
  151. package/kits/hub-game/code/shared/act.js +35 -0
  152. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  153. package/kits/hub-game/code/shared/loadStages.js +12 -0
  154. package/kits/hub-game/code/shared/quality.js +74 -0
  155. package/kits/hub-game/code/shared/say.js +2 -0
  156. package/kits/hub-game/code/shared/shot.js +35 -1
  157. package/kits/hub-game/code/systems/hub.js +970 -169
  158. package/kits/hub-game/docs/analytics.md +279 -0
  159. package/kits/hub-game/docs/contract.md +1259 -42
  160. package/kits/hub-game/docs/home-pieces.md +9 -2
  161. package/kits/hub-game/docs/observed-progress.md +252 -0
  162. package/kits/hub-game/main.jsx +2 -0
  163. package/kits/hub-game/package-lock.json +10 -3
  164. package/kits/hub-game/package.json +6 -3
  165. package/kits/hub-game/play/player.js +142 -0
  166. package/kits/hub-game/play/registry.js +47 -0
  167. package/kits/hub-game/play.jsx +37 -0
  168. package/kits/hub-game/scripts/check.mjs +39 -5
  169. package/kits/hub-game/scripts/companion-follower-wire.json +1 -1
  170. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +11 -0
  171. package/kits/hub-game/scripts/fixtures/decor-keyless.json +5 -5
  172. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +3 -0
  173. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +19 -3
  174. package/kits/hub-game/scripts/fixtures/interest-legacy.json +3 -3
  175. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -1
  176. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  177. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  178. package/kits/hub-game/scripts/test-act.mjs +171 -0
  179. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  180. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  181. package/kits/hub-game/scripts/test-actions-client.mjs +367 -2
  182. package/kits/hub-game/scripts/test-actors.mjs +20 -7
  183. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  184. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  185. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  186. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  187. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  188. package/kits/hub-game/scripts/test-avatar-wire.mjs +49 -10
  189. package/kits/hub-game/scripts/test-avatar.mjs +44 -0
  190. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  191. package/kits/hub-game/scripts/test-ballot.mjs +11 -4
  192. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  193. package/kits/hub-game/scripts/test-build.mjs +20 -2
  194. package/kits/hub-game/scripts/test-chat.mjs +206 -5
  195. package/kits/hub-game/scripts/test-companion-chat.mjs +20 -2
  196. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  197. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  198. package/kits/hub-game/scripts/test-decor-client.mjs +45 -4
  199. package/kits/hub-game/scripts/test-decor.mjs +7 -0
  200. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  201. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  202. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  203. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  204. package/kits/hub-game/scripts/test-earned.mjs +33 -3
  205. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  206. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  207. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  208. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  209. package/kits/hub-game/scripts/test-grab-orbit.mjs +47 -4
  210. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  211. package/kits/hub-game/scripts/test-hub-ops.mjs +321 -2
  212. package/kits/hub-game/scripts/test-hub-trip.mjs +879 -11
  213. package/kits/hub-game/scripts/test-hud-clear.mjs +162 -59
  214. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  215. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  216. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  217. package/kits/hub-game/scripts/test-idle.mjs +66 -0
  218. package/kits/hub-game/scripts/test-interest-cells.mjs +20 -0
  219. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  220. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  221. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  222. package/kits/hub-game/scripts/test-labels.mjs +71 -3
  223. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  224. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  225. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  226. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  227. package/kits/hub-game/scripts/test-manifest.mjs +265 -0
  228. package/kits/hub-game/scripts/test-menu-client.mjs +105 -0
  229. package/kits/hub-game/scripts/test-menu.mjs +23 -0
  230. package/kits/hub-game/scripts/test-npcs.mjs +917 -10
  231. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  232. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  233. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  234. package/kits/hub-game/scripts/test-picker.mjs +234 -7
  235. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  236. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  237. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  238. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  239. package/kits/hub-game/scripts/test-rehello.mjs +699 -5
  240. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  241. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  242. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  243. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  244. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  245. package/kits/hub-game/scripts/test-say.mjs +1 -1
  246. package/kits/hub-game/scripts/test-shot.mjs +145 -0
  247. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  248. package/kits/hub-game/scripts/test-soundscape.mjs +22 -17
  249. package/kits/hub-game/scripts/test-standing.mjs +35 -2
  250. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  251. package/kits/hub-game/scripts/test-stuck.mjs +5 -4
  252. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  253. package/kits/hub-game/scripts/test-tiers-render.mjs +86 -13
  254. package/kits/hub-game/scripts/test-tiers.mjs +7 -8
  255. package/kits/hub-game/scripts/test-vis.mjs +433 -6
  256. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  257. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  258. package/kits/hub-game/scripts/test-yours-chrome.mjs +50 -6
  259. package/kits/hub-game/scripts/test-yours.mjs +39 -8
  260. package/kits/multiplayer-3d/castle.json +5 -5
  261. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  262. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  263. package/kits/multiplayer-3d/code/systems/multiplayer.js +369 -30
  264. package/kits/multiplayer-3d/package-lock.json +8 -1
  265. package/kits/multiplayer-3d/package.json +2 -1
  266. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  267. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  268. package/kits/physics-2d/CLAUDE.md +10 -1
  269. package/kits/physics-2d/castle.json +2 -2
  270. package/kits/physics-2d/engine/frozenActors.js +233 -0
  271. package/kits/physics-2d/engine/scene.js +87 -5
  272. package/kits/physics-2d/eslint.config.js +1 -1
  273. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  274. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  275. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  276. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  277. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  278. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  279. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  280. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  281. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  282. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  283. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  284. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  285. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  286. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  287. package/kits/physics-3d/CLAUDE.md +25 -1651
  288. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  289. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  290. package/kits/physics-3d/behaviors/Player.jsx +35 -18
  291. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  292. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  293. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  294. package/kits/physics-3d/castle.json +3 -3
  295. package/kits/physics-3d/docs/engine-camera.md +542 -0
  296. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  297. package/kits/physics-3d/docs/engine-load.md +149 -0
  298. package/kits/physics-3d/docs/engine-look.md +114 -0
  299. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  300. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  301. package/kits/physics-3d/docs/engine-sky.md +198 -0
  302. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  303. package/kits/physics-3d/docs/engine-view.md +37 -0
  304. package/kits/physics-3d/docs/pxmodel-format.md +1 -1
  305. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  306. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -333
  307. package/kits/physics-3d/engine3d/actornode.js +1 -0
  308. package/kits/physics-3d/engine3d/branches.js +3 -13
  309. package/kits/physics-3d/engine3d/cage.js +2 -7
  310. package/kits/physics-3d/engine3d/cageops.js +2 -17
  311. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  312. package/kits/physics-3d/engine3d/framecap.js +4 -1
  313. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  314. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  315. package/kits/physics-3d/engine3d/gait.js +8 -0
  316. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  317. package/kits/physics-3d/engine3d/look.js +7 -0
  318. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  319. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  320. package/kits/physics-3d/engine3d/modelready.js +16 -0
  321. package/kits/physics-3d/engine3d/motion.js +3 -3
  322. package/kits/physics-3d/engine3d/nearshadows.js +77 -10
  323. package/kits/physics-3d/engine3d/orbitinput.js +59 -25
  324. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  325. package/kits/physics-3d/engine3d/paths.js +1 -9
  326. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  327. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  328. package/kits/physics-3d/engine3d/pxmodel.js +3 -3
  329. package/kits/physics-3d/engine3d/rapier.js +27 -0
  330. package/kits/physics-3d/engine3d/scatter.js +1 -11
  331. package/kits/physics-3d/engine3d/shadowfade.js +23 -15
  332. package/kits/physics-3d/engine3d/sky.js +1 -1
  333. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  334. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  335. package/kits/physics-3d/engine3d/sweep.js +1 -25
  336. package/kits/physics-3d/engine3d/world3d.js +468 -18
  337. package/kits/physics-3d/eslint.config.js +2 -1
  338. package/kits/physics-3d/main.jsx +6 -3
  339. package/kits/physics-3d/package-lock.json +7 -0
  340. package/kits/physics-3d/package.json +5 -1
  341. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  342. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  343. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  344. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  345. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  346. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  347. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  348. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  349. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  350. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  351. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  352. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  353. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  354. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  355. package/kits/physics-3d/scripts/test-camera-orbit.mjs +52 -4
  356. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  357. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  358. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +6 -3
  359. package/kits/physics-3d/scripts/test-frame-cap.mjs +1 -1
  360. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  361. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  362. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  363. package/kits/physics-3d/scripts/test-look-bake.mjs +1 -1
  364. package/kits/physics-3d/scripts/test-near-shadows.mjs +2 -2
  365. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +88 -7
  366. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +40 -3
  367. package/kits/physics-3d/scripts/test-orbit-shot.mjs +75 -1
  368. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  369. package/kits/physics-3d/scripts/test-sky.mjs +1 -1
  370. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  371. package/kits/physics-3d/scripts/test-static-actors.mjs +3 -1
  372. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  373. package/kits/physics-3d/scripts/test-static-scenery.mjs +5 -2
  374. package/kits/physics-3d/scripts/test-steady-hover.mjs +5 -2
  375. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  376. package/kits/physics-3d/systems/physics3d.js +37 -4
  377. package/kits/real-time/castle.json +2 -2
  378. package/kits/real-time/code/client/connection.js +33 -10
  379. package/kits/real-time/code/client/gameHooks.js +2 -0
  380. package/kits/real-time/code/client/joinOverlay.js +9 -4
  381. package/kits/real-time/code/server/session.js +6 -4
  382. package/kits/real-time/package-lock.json +1 -1
  383. package/package.json +2 -2
@@ -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
  /**
@@ -241,12 +249,14 @@ function encodeChange(change, server) {
241
249
  ...(remove === undefined ? {} : { remove }),
242
250
  };
243
251
  }
244
- function encodeCheck(check, server) {
252
+ function encodeCheck(check, server, conditional = false) {
245
253
  const target = validateSaveTarget(check.target, server);
254
+ if (conditional && check.expectedRevision === undefined)
255
+ invalid("Every conditional check needs an expected revision.");
246
256
  if (check.expectedRevision === undefined && check.writer === undefined) {
247
257
  invalid("A check needs an expected revision or a writer.");
248
258
  }
249
- if (check.expectedRevision !== undefined) {
259
+ if (check.expectedRevision !== undefined && !(conditional && check.expectedRevision === null)) {
250
260
  checkText(check.expectedRevision, "expected revision");
251
261
  }
252
262
  if (check.writer !== undefined)
@@ -259,7 +269,7 @@ function encodeCheck(check, server) {
259
269
  ...(check.writer === undefined ? {} : { writer: check.writer }),
260
270
  };
261
271
  }
262
- function encodeTransaction(input, server) {
272
+ function encodeTransaction(input, server, conditional = false) {
263
273
  const changes = checkList(input.changes, "changes").map((change) => encodeChange(change, server));
264
274
  const keys = changes.map((change) => saveTargetKey(change.target));
265
275
  if (new Set(keys).size !== keys.length) {
@@ -268,14 +278,35 @@ function encodeTransaction(input, server) {
268
278
  return {
269
279
  operationId: input.operationId,
270
280
  expectedAccess: checkText(input.expectedAccess, "expected access"),
281
+ ...(input.resetFences === undefined
282
+ ? {}
283
+ : { resetFences: encodeResetFences(input.resetFences, server && conditional) }),
271
284
  ...(input.checks === undefined
272
285
  ? {}
273
286
  : {
274
- checks: checkList(input.checks, "checks").map((check) => encodeCheck(check, server)),
287
+ checks: checkList(input.checks, "checks").map((check) => encodeCheck(check, server, conditional)),
275
288
  }),
276
289
  changes,
277
290
  };
278
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
+ }
279
310
  /** Validates and copies a request; the result is what goes on the wire. */
280
311
  export function encodeSaveInput(verb, input, server = false) {
281
312
  if (!input || typeof input !== "object" || Array.isArray(input)) {
@@ -283,12 +314,26 @@ export function encodeSaveInput(verb, input, server = false) {
283
314
  }
284
315
  if (verb === "snapshot")
285
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
+ }
286
325
  checkText(input.operationId, "operation id", MAX_KEY_BYTES);
287
326
  if (verb === "operation")
288
327
  return { operationId: input.operationId };
289
- 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
+ }
290
335
  return {
291
- ...encodeTransaction(input, server),
336
+ ...encodeTransaction(input, server, verb === "conditionalWrite"),
292
337
  };
293
338
  }
294
339
  if (input.expectedAccess !== undefined) {
@@ -423,6 +468,34 @@ export function createSaveApi(call, server = false) {
423
468
  }
424
469
  }
425
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
+ },
426
499
  async snapshot(input) {
427
500
  return decodeSnapshot(await send("snapshot", { ...input }), input.targets);
428
501
  },
@@ -184,8 +184,34 @@ export interface MultiplayerHubResultsRead {
184
184
  * and for a deck that declares no hub block.
185
185
  */
186
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>;
187
211
  /** The owner user id, only in an owner door instance. */
188
212
  readonly owner?: string;
213
+ /** Host-pinned inclusive reconnect grace for this hub place, in milliseconds. */
214
+ readonly reconnectWindowMs?: number;
189
215
  readonly place: string | null;
190
216
  readonly title: string | null;
191
217
  readonly result: MultiplayerHubResultShape | null;
@@ -236,9 +262,13 @@ export interface MultiplayerServerHub {
236
262
  /**
237
263
  * The connected player's mutual friends and follows in either direction among
238
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.
239
266
  * These relations belong to this player only; never send them to another client.
240
267
  */
241
- relationsAmong(playerId: string, userIds: readonly string[]): Promise<{
268
+ relationsAmong(playerId: string, userIds: readonly string[], options?: {
269
+ strict: true;
270
+ }): Promise<{
271
+ validated?: true;
242
272
  friends: string[];
243
273
  follows: string[];
244
274
  followedBy: string[];
@@ -46,6 +46,11 @@ function unavailable(op, what) {
46
46
  operation: `session.hub.${op}`,
47
47
  });
48
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
+ }
49
54
  export function createServerHub(platformHandle, arrivals, hiddenPair = () => false) {
50
55
  const pinned = platformHandle.hub;
51
56
  if (!pinned ||
@@ -72,17 +77,35 @@ export function createServerHub(platformHandle, arrivals, hiddenPair = () => fal
72
77
  }
73
78
  return parsed;
74
79
  };
75
- 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
+ },
76
88
  place: typeof pinned.place === "string" ? pinned.place : null,
77
89
  title: typeof pinned.title === "string" ? pinned.title : null,
78
90
  result: pinned.result ?? null,
79
91
  ...(typeof pinned.owner === "string" && pinned.owner.length > 0 ? { owner: pinned.owner } : {}),
92
+ ...reconnectMetadata(pinned),
80
93
  arrival(playerId) {
81
94
  return arrivals.get(playerId) ?? null;
82
95
  },
83
96
  hiddenPair(playerIdA, playerIdB) {
84
97
  return hiddenPair(playerIdA, playerIdB);
85
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
+ },
86
109
  async friendsAmong(playerId, userIds) {
87
110
  const json = JSON.stringify({ playerId, userIds: [...userIds] });
88
111
  const raw = typeof platformHandle.hubFriendsAmong === "function"
@@ -91,7 +114,7 @@ export function createServerHub(platformHandle, arrivals, hiddenPair = () => fal
91
114
  const answer = JSON.parse(raw ?? "null");
92
115
  return Array.isArray(answer?.userIds) ? answer.userIds : [];
93
116
  },
94
- async relationsAmong(playerId, userIds) {
117
+ async relationsAmong(playerId, userIds, options = undefined) {
95
118
  const asked = new Set(userIds);
96
119
  const json = JSON.stringify({ playerId, userIds: [...userIds] });
97
120
  let raw;
@@ -102,10 +125,14 @@ export function createServerHub(platformHandle, arrivals, hiddenPair = () => fal
102
125
  raw = await platformHandle.storage?.("hubFriendsAmong", json);
103
126
  }
104
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
+ }
105
131
  const list = (value) => Array.isArray(value)
106
132
  ? value.filter((id) => typeof id === "string" && asked.has(id))
107
133
  : [];
108
134
  return {
135
+ ...(options?.strict === true ? { validated: true } : {}),
109
136
  friends: list(answer?.userIds),
110
137
  follows: list(answer?.follows),
111
138
  followedBy: list(answer?.followedBy),
@@ -191,5 +218,25 @@ export function createServerHub(platformHandle, arrivals, hiddenPair = () => fal
191
218
  players: (read.players ?? {}),
192
219
  };
193
220
  },
194
- });
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
+ } };
195
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;
@@ -66,11 +68,16 @@ export interface PlatformHandle {
66
68
  storage?(op: string, argsJson: string): Promise<string>;
67
69
  /** False when the host cannot broker storage, so a call can fail at once. */
68
70
  readonly storageEnabled?: boolean;
71
+ readonly hubTextArchiveEnabled?: boolean;
69
72
  /** Persistent-world checkpoint broker. The host stamps the hidden world binding. */
70
73
  worldCheckpointRead?(): Promise<string>;
71
74
  worldCheckpointCommit?(argsJson: string): Promise<string>;
72
75
  /** `tools` is the turn's place tools, passed only when non-empty. */
73
- worldCharacterSend?(grantId: string, tools?: readonly PlatformPlaceTool[]): Promise<string>;
76
+ worldCharacterSend?(grantId: string, tools?: readonly PlatformPlaceTool[], hubTextArchive?: {
77
+ npcId: string;
78
+ conversationId?: string;
79
+ input: string;
80
+ }): Promise<string>;
74
81
  worldCharacterCommand?(grantId: string): Promise<string>;
75
82
  worldCharacterRead?(grantId: string): Promise<string>;
76
83
  worldCharacterRuntimeCreate?(argsJson: string): Promise<string>;
@@ -92,6 +99,7 @@ export interface PlatformHandle {
92
99
  hubResultsRead?(argsJson: string): Promise<string>;
93
100
  /** Friends among candidates (hub contract v1.36); older images use storage. */
94
101
  hubFriendsAmong?(argsJson: string): Promise<string>;
102
+ hubPushVisit?(argsJson: string): Promise<string>;
95
103
  /** Absent on a runtime older than wearables (contract v1.4). */
96
104
  hubWear?(argsJson: string): Promise<string>;
97
105
  /** Absent on a runtime older than earned items (contract v1.53). */
@@ -113,7 +121,11 @@ export interface PlatformHubResultShape {
113
121
  stats: Record<string, "number" | "string">;
114
122
  }
115
123
  export interface PlatformHubPlace {
124
+ push?: {
125
+ version: 1;
126
+ };
116
127
  owner?: string;
128
+ reconnectWindowMs?: number;
117
129
  place?: string;
118
130
  title?: string | null;
119
131
  result?: PlatformHubResultShape | null;
@@ -51,6 +51,8 @@ export interface ServerStorageBoard {
51
51
  */
52
52
  export interface ServerPlaythrough {
53
53
  readonly generation: number;
54
+ /** Present only after an administrator reset this player's deck progress. */
55
+ readonly resetGeneration?: number;
54
56
  /** Explicit narrative changes for this same player and generation. */
55
57
  readonly characters: ServerPlaythroughCharacters;
56
58
  get<T extends Json = Json>(keys: string[]): Promise<Record<string, T>>;
@@ -265,6 +267,8 @@ export interface ServerCharacterHistoryOptions {
265
267
  cursor?: string | null;
266
268
  }
267
269
  export interface ServerStorage extends SaveApi {
270
+ /** Reads the authoritative progress-reset generation, including never-reset zero. */
271
+ resetGeneration(userId: string): Promise<number>;
268
272
  /** Shared by everyone playing the deck, and owned by this server. */
269
273
  readonly deck: ServerStorageScope;
270
274
  /** One player's public data. Readable by anyone; writable by them or by this server. */
@@ -76,6 +76,14 @@ export function createServerStorage(platformHandle) {
76
76
  }, true);
77
77
  return {
78
78
  ...saveApi,
79
+ async resetGeneration(userId) {
80
+ const subject = assertUserId(userId, "session.storage.resetGeneration");
81
+ const value = await call("resetGeneration", { subject });
82
+ if (!Number.isInteger(value) || value < 0 || value > MAX_GENERATION) {
83
+ throw storageError("CAULDRON_STORAGE_INVALID_RESPONSE", "The platform returned an invalid progress reset generation.", "session.storage.resetGeneration");
84
+ }
85
+ return value;
86
+ },
79
87
  deck: createScope(call, "DECK", null, saveApi),
80
88
  user(userId) {
81
89
  // A bad id poisons the scope rather than throwing here, so the failure arrives
@@ -100,11 +108,11 @@ export function createServerStorage(platformHandle) {
100
108
  async playthrough(userId) {
101
109
  const subject = assertUserId(userId, "session.storage.playthrough");
102
110
  const opened = await call("playthroughOpen", { subject });
103
- return createPlaythrough(call, subject, assertGeneration(opened?.generation));
111
+ return createPlaythrough(call, subject, assertGeneration(opened?.generation), optionalResetGeneration(opened?.resetGeneration));
104
112
  },
105
113
  };
106
114
  }
107
- function createPlaythrough(call, subject, generation) {
115
+ function createPlaythrough(call, subject, generation, resetGeneration) {
108
116
  const characters = Object.freeze({
109
117
  async send(input) {
110
118
  const characterId = assertNarrativeId(input?.characterId, "characterId");
@@ -220,6 +228,7 @@ function createPlaythrough(call, subject, generation) {
220
228
  });
221
229
  return Object.freeze({
222
230
  generation,
231
+ ...(resetGeneration === undefined ? {} : { resetGeneration }),
223
232
  characters,
224
233
  async get(keys) {
225
234
  const entries = await call("playthroughGet", { subject, generation, keys: assertKeys(keys, "session.storage.playthrough.get") });
@@ -242,7 +251,7 @@ function createPlaythrough(call, subject, generation) {
242
251
  generation,
243
252
  operationId: assertOperationId(operationId),
244
253
  });
245
- return createPlaythrough(call, subject, assertGeneration(reset?.generation));
254
+ return createPlaythrough(call, subject, assertGeneration(reset?.generation), resetGeneration);
246
255
  },
247
256
  });
248
257
  }
@@ -417,6 +426,13 @@ function assertGeneration(value) {
417
426
  }
418
427
  return value;
419
428
  }
429
+ function optionalResetGeneration(value) {
430
+ if (value === undefined || value === null)
431
+ return undefined;
432
+ if (Number.isSafeInteger(value) && value >= 1 && value <= MAX_GENERATION)
433
+ return value;
434
+ throw storageError("CAULDRON_STORAGE_INVALID_RESPONSE", "The platform returned an invalid progress reset generation.", "session.storage.playthrough");
435
+ }
420
436
  function assertOperationId(value) {
421
437
  if (typeof value !== "string" ||
422
438
  value.length === 0 ||
@@ -7,7 +7,7 @@ export type { MultiplayerSessionMode, PlatformHandle, PlatformSessionConfig, Pla
7
7
  export { createSaveCoordinator } from "../saveCoordinator";
8
8
  export type { CoordinatedChange, CoordinatedSave, SaveCoordinator, SaveStatus, } from "../saveCoordinator";
9
9
  export { SaveError } from "../save";
10
- export type { SaveApi, SaveBucketApi, SaveBucketRead, SaveChange, SaveCheck, SaveClaimed, SaveClaimInput, SaveErrorEnvelope, SaveInitial, SaveInitializeInput, SaveOpened, SaveOperation, SaveReadTarget, SaveReceipt, SaveRevision, SaveRows, SaveScope, SaveSelection, SaveSnapshot, SaveTarget, SaveTransactionInput, SaveWriter, } from "../save";
10
+ export type { SaveApi, SaveBucketApi, SaveBucketRead, SaveChange, SaveCheck, SaveConditionalCheck, SaveConditionalWriteInput, SaveResetFence, SaveClaimed, SaveClaimInput, SaveErrorEnvelope, SaveInitial, SaveInitializeInput, SaveOpened, SaveOperation, SaveReadTarget, SaveReceipt, SaveRecentOperationsInput, SaveRecentOperationsPage, SaveRevision, SaveRows, SaveScope, SaveSelection, SaveSnapshot, SaveTarget, SaveTransactionInput, SaveWriter, } from "../save";
11
11
  export type { MultiplayerHubArrival, MultiplayerHubBoard, MultiplayerHubOutcome, MultiplayerHubPadUpdateInput, MultiplayerHubPadUpdateResult, MultiplayerHubPlayerResults, MultiplayerHubRecord, MultiplayerHubReportReceipt, MultiplayerHubResultInput, MultiplayerHubResultRow, MultiplayerHubResultShape, MultiplayerHubResultsRead, MultiplayerHubResultsReadInput, MultiplayerHubWearable, MultiplayerHubWearReceipt, MultiplayerHubEarnedClass, MultiplayerHubEarnedItem, MultiplayerHubHomeClass, MultiplayerHubHomeItem, MultiplayerHubUnlockReceipt, MultiplayerHubUnlocksRead, MultiplayerHubWearEarnedReceipt, MultiplayerServerHub, } from "./hub";
12
12
  export type { CharacterActionNotice, CharacterGameStateOperation, CharacterGameStateResult, CharacterKnowledgeDeliveryOperation, CharacterKnowledgeDeliveryResult, CharacterKnowledgeSource, CompleteCharacterBeatInput, DeliverCharacterKnowledgeInput, RecordCharacterEventInput, SetCharacterGameStateInput, ShareCharacterClaimInput, ServerStorage, ServerStorageBoard, ServerStorageBoardScore, ServerStorageListEntry, ServerStorageListOptions, ServerStorageListPage, ServerPlaythrough, ServerPlaythroughCharacters, ServerCharacterHistoryOptions, ServerStorageScope, ServerTownStorage, } from "./storage";
13
13
  export interface MultiplayerServerPlayer extends PlayerIdentity {
@@ -288,6 +288,12 @@ export interface MultiplayerWorldCharacterTurn {
288
288
  export type MultiplayerPlaceTool = PlatformPlaceTool;
289
289
  export interface MultiplayerWorldCharacterSendOptions {
290
290
  tools?: readonly MultiplayerPlaceTool[];
291
+ /** Private host-brokered transcript metadata, not player-selected. */
292
+ hubTextArchive?: {
293
+ npcId: string;
294
+ conversationId?: string;
295
+ input: string;
296
+ };
291
297
  }
292
298
  /** One place-tool use by a character during a turn this place admitted. */
293
299
  export interface MultiplayerWorldCharacterToolRequest {
@@ -1,3 +1,4 @@
1
+ import { CastleError } from "../errors";
1
2
  import { isBinaryPayload, toUint8Array, } from "../multiplayerProtocol";
2
3
  import { encodeStorageValue, storageError } from "../storageJson";
3
4
  import { createServerStorage } from "./storage";
@@ -1193,6 +1194,11 @@ function assertPlatformWorldCharacterRead(value) {
1193
1194
  // carrying anything beyond the grant); otherwise this is exactly the tool-less send.
1194
1195
  function sendWorldCharacterTurn(platformHandle, grantId, options) {
1195
1196
  const tools = options?.tools;
1197
+ if (options?.hubTextArchive !== undefined) {
1198
+ if (platformHandle.hubTextArchiveEnabled !== true)
1199
+ return Promise.reject(new CastleError({ code: 'CAULDRON_HUB_UNAVAILABLE', message: 'This host cannot archive NPC transcripts.', operation: 'worldCharacter.send' }));
1200
+ return platformHandle.worldCharacterSend(grantId, Array.isArray(tools) && typeof platformHandle.worldCharacterToolResult === "function" ? tools : undefined, options.hubTextArchive);
1201
+ }
1196
1202
  return Array.isArray(tools) && tools.length > 0 &&
1197
1203
  typeof platformHandle.worldCharacterToolResult === "function"
1198
1204
  ? platformHandle.worldCharacterSend(grantId, tools)
@@ -1419,10 +1425,11 @@ function joinedPlayer(connId, identity) {
1419
1425
  delete player.hiddenUserIds;
1420
1426
  // A/B arms arrive beside the player; one a host put on it stays off it too.
1421
1427
  delete player.experimentVariants;
1428
+ Object.defineProperty(player, "under13", { value: identity.under13 === true, enumerable: false });
1422
1429
  return player;
1423
1430
  }
1424
1431
  const legacy = connId;
1425
- return {
1432
+ const player = {
1426
1433
  playerId: legacy.playerId,
1427
1434
  userId: legacy.userId,
1428
1435
  username: legacy.username,
@@ -1430,6 +1437,8 @@ function joinedPlayer(connId, identity) {
1430
1437
  participantId: legacy.scopedUserId ?? legacy.userId,
1431
1438
  ...(legacy.scopedUserId ? { scopedUserId: legacy.scopedUserId } : {}),
1432
1439
  };
1440
+ Object.defineProperty(player, "under13", { value: legacy.under13 === true, enumerable: false });
1441
+ return player;
1433
1442
  }
1434
1443
  function parseHandleMessage(text) {
1435
1444
  if (typeof text !== "string")
@@ -0,0 +1,9 @@
1
+ import type { SocialFriend, SocialPresence } from './commands';
2
+ export type { SocialFriend, SocialPresence } from './commands';
3
+ export interface CastleSocialApi {
4
+ /** The signed-in player's mutual Castle follows, at most 20. */
5
+ friends(): Promise<SocialFriend[]>;
6
+ /** Mutual friends playing this deck now. Poll to refresh; v1 has no event. */
7
+ presence(): Promise<SocialPresence[]>;
8
+ }
9
+ export declare const Social: CastleSocialApi;
@@ -0,0 +1,5 @@
1
+ import { hostRequest } from './transport';
2
+ export const Social = {
3
+ friends: () => hostRequest('social.friends', {}),
4
+ presence: () => hostRequest('social.presence', {}),
5
+ };