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
@@ -20,7 +20,10 @@ function fields(value, required, optional = []) {
20
20
  }
21
21
  function check(spec) {
22
22
  if (spec === null) {return null;}
23
- const s = fields(spec, ['title', 'sections'], ['note', 'readOnly', 'face']);
23
+ const s = fields(spec, ['title', 'sections'], ['note', 'readOnly', 'face', 'presentation', 'footer']);
24
+ if (Object.hasOwn(s, 'presentation')) {need(s.presentation === 'rows', 'presentation must be rows');}
25
+ const rows = s.presentation === 'rows';
26
+ if (Object.hasOwn(s, 'footer')) {need(rows && Array.isArray(s.footer), 'footer requires rows and an array');}
24
27
  need(validPrivateText(s.title, 32), 'title must be 1..32 code points');
25
28
  if (Object.hasOwn(s, 'note')) {need(validPrivateText(s.note, 80), 'note must be 1..80 code points');}
26
29
  if (Object.hasOwn(s, 'readOnly')) {need(typeof s.readOnly === 'boolean', 'readOnly must be boolean');}
@@ -42,7 +45,17 @@ function check(spec) {
42
45
  need(count <= 48, 'items must be an array of 0..48 items');
43
46
  out.items = [];
44
47
  for (let item = 0; item < count; item++) {
45
- const i = fields(items[item], ['id', 'label'], ['color', 'icon', 'on']);
48
+ const i = fields(items[item], ['id', 'label'], ['color', 'icon', 'on', 'columns', 'readOnly']);
49
+ if (Object.hasOwn(i, 'columns')) {
50
+ const columns = i.columns;
51
+ need(rows && Array.isArray(columns) && columns.length === 3, 'columns require rows and exactly three texts');
52
+ i.columns = [0, 1, 2].map((index) => {
53
+ const text = columns[index];
54
+ need(validPrivateText(text, 24), 'column text must be 1..24 code points');
55
+ return text;
56
+ });
57
+ }
58
+ if (Object.hasOwn(i, 'readOnly')) {need(rows && typeof i.readOnly === 'boolean', 'item readOnly requires rows and a boolean');}
46
59
  need(typeof i.id === 'string' && ID.exec(i.id)?.[0] === i.id && i.id !== 'close', 'invalid or reserved item id');
47
60
  need(!ids.has(i.id) && ids.size < 48, 'at most 48 unique items across the menu');
48
61
  ids.add(i.id);
@@ -54,6 +67,20 @@ function check(spec) {
54
67
  }
55
68
  s.sections.push(out);
56
69
  }
70
+ if (s.footer) {
71
+ const footer = s.footer, count = footer.length;
72
+ need(count <= 4, 'at most four footer actions');
73
+ s.footer = [];
74
+ for (let index = 0; index < count; index++) {
75
+ const item = footer[index];
76
+ const i = fields(item, ['id', 'label'], []);
77
+ need(typeof i.id === 'string' && ID.exec(i.id)?.[0] === i.id && i.id !== 'close', 'invalid or reserved footer id');
78
+ need(!ids.has(i.id) && ids.size < 48, 'at most 48 unique items across the menu');
79
+ ids.add(i.id);
80
+ need(validPrivateText(i.label, 16), 'footer label must be 1..16 code points');
81
+ s.footer.push(i);
82
+ }
83
+ }
57
84
  return s;
58
85
  }
59
86
  const present = (h, p) => h.session?.players.some((row) => row.playerId === p) && h.sim?.players.has(p);
@@ -104,7 +131,8 @@ export function message(h, p, data) {
104
131
  if (!pickKeys(data)) { return; }
105
132
  const d = fields(data, ['k', 'id', 'n']), state = current(h, p);
106
133
  if (d.k !== 'hub-menu-pick' || !Number.isSafeInteger(d.n) || d.n !== state.n || d.n !== state.sentN || !state.spec) {return;}
107
- if (d.id !== 'close' && (state.spec.readOnly || !state.spec.sections.some((s) => s.items.some((i) => i.id === d.id)))) {return;}
134
+ const item = d.id === 'close' ? null : [...state.spec.sections.flatMap((s) => s.items), ...(state.spec.footer ?? [])].find((i) => i.id === d.id);
135
+ if (d.id !== 'close' && (state.spec.readOnly || !item || item.readOnly)) {return;}
108
136
  // Close is a notification; the place decides whether to call menu(null).
109
137
  const failed = () => {
110
138
  if (!h.menuFailed) { h.menuFailed = true; console.warn('[hub] menu hook failed'); }
@@ -34,6 +34,7 @@
34
34
  // message can neither start nor aim it.
35
35
 
36
36
  import { EMOTES } from './idle.js';
37
+ import { npcDisplayText } from '../npcDisplayText.js';
37
38
  import { warnOnce } from './actors.js';
38
39
  import { readNpcTurnsAtOnce } from './manifest.js';
39
40
 
@@ -83,6 +84,8 @@ const TURNS_KEPT = 128;
83
84
  // After a reply the world's public projection is read every this long, for
84
85
  // this long, to see whether the character chose to follow someone.
85
86
  const FOLLOW_POLL_MS = 2000;
87
+ // A failing public read backs off by doubling, to this.
88
+ const FOLLOW_POLL_MAX_MS = 300_000;
86
89
  const FOLLOW_WATCH_MS = 60_000;
87
90
  // The place's notes for a turn (`npcContext`): at most NOTES_MAX characters,
88
91
  // read for the body's speaker every NOTES_EVERY_MS, and any of the last
@@ -414,6 +417,13 @@ function handleOf(h, n, npc) {
414
417
  get busy() {
415
418
  return !npc.owner && (conversations(npc).length >= (npc.turnsAtOnce ?? 1) || npc.walk !== null || npc.following !== null);
416
419
  },
420
+ ...(h.firstVisit ? {
421
+ open(playerId) {
422
+ if (!h.players.get(playerId)?.arrived || talkingOf(npc, playerId) || fullFor(npc, playerId) || distanceTo(h, npc, playerId) > npc.talkRange) {return false;}
423
+ open(h, n, playerId, npc.id);
424
+ return Boolean(talkingOf(npc, playerId));
425
+ },
426
+ } : {}),
417
427
  say(text, options = {}) {
418
428
  if (npc.owner) {
419
429
  return;
@@ -587,6 +597,25 @@ function sessionCharacters(h) {
587
597
  return h.session?.characters ?? h.session?.world?.characters ?? null;
588
598
  }
589
599
 
600
+ const CHILD_ASKS = ['What can I do here?', 'Tell me about yourself.', 'Where should I go next?'];
601
+
602
+ function under13(h, playerId) {
603
+ return h.session?.players?.find?.((p) => p.playerId === playerId)?.under13 === true;
604
+ }
605
+
606
+ function choicesOnly(h, playerId) {
607
+ return h.place.under13Choices === true && under13(h, playerId);
608
+ }
609
+
610
+ // v1.142: bundle chips apply in every place, independently of legacy choices.
611
+ function childAsks(h, npc, playerId) {
612
+ if (!under13(h, playerId) || !hasMind(h, npc)) {
613
+ return null;
614
+ }
615
+ const asks = h.characterBundle?.characters?.find((c) => c.id === npc.character)?.childAsks;
616
+ return Array.isArray(asks) && asks.length ? asks : null;
617
+ }
618
+
590
619
  function open(h, n, playerId, npcId) {
591
620
  const npc = h.place.companionChat && typeof npcId === 'string' && npcId.startsWith('companion:')
592
621
  ? virtualForOpen(h, n, playerId, npcId) : n.bodies.get(npcId);
@@ -596,7 +625,7 @@ function open(h, n, playerId, npcId) {
596
625
  }
597
626
  if (fullFor(npc, playerId)) {
598
627
  h.ctx.send(playerId, { k: 'hub-npc', npc: npcId, open: false, why: 'busy' });
599
- line(h, npc, playerId, 'busy');
628
+ line(h, n, npc, playerId, 'busy');
600
629
  return;
601
630
  }
602
631
  const talking = { playerId, at: h.sim.timeMs, conversation: ++npc.conversation, accountKey: metKey(h, playerId), body: h.sim.players.get(playerId), said: false };
@@ -608,15 +637,25 @@ function open(h, n, playerId, npcId) {
608
637
  npc.speakers.set(playerId, state);
609
638
  }
610
639
  state.talking = talking;
640
+ h.ctx.track?.(playerId, 'npc_chat_count', { subject: 9, value: 1 });
611
641
  // A new conversation can ask again for what an earlier one finished.
612
642
  const participant = n.participants.get(playerId);
613
643
  if (participant) {
614
644
  npc.followDone.delete(participant);
615
645
  }
616
646
  const mind = hasMind(h, npc);
617
- const greeting = mind && !npc.owner ? greetingOf(h, n, playerId, npc.character) : null;
647
+ const bundled = childAsks(h, npc, playerId);
648
+ const greeting = !bundled && mind && !npc.owner ? greetingOf(h, n, playerId, npc.character) : null;
649
+ const placed = openingOf(h, n, npc, playerId, greeting, talking.conversation);
650
+ // v1.148: an under-13 speaker taps the place's own authored asks (its
651
+ // answers, never a mind turn) ahead of any bundle chips.
652
+ const taps = mind && under13(h, playerId) && placed?.authored ? placed.asks : null;
653
+ const child = taps ? null : bundled;
654
+ state.taps = taps;
618
655
  // v1.46: a mind speaks first even where the place gives it no words.
619
- let opening = openingOf(h, n, npc, playerId, greeting, talking.conversation) ?? (mind ? { text: `Hi, I'm ${npc.name.split(',')[0].trim()}! Ask me anything.`, asks: [...DEFAULT_ASKS], more: [...DEFAULT_MORE] } : null);
656
+ let opening = child
657
+ ? { text: `Tap a question to talk with ${npc.name.split(',')[0].trim()}.` }
658
+ : placed ?? (mind ? { text: `Hi, I'm ${npc.name.split(',')[0].trim()}! Ask me anything.`, asks: [...DEFAULT_ASKS], more: [...DEFAULT_MORE] } : null);
620
659
  // v1.47: memory changes this speaker's first words, never the questions.
621
660
  if (greeting) {
622
661
  opening = { ...opening, text: greeting };
@@ -625,30 +664,47 @@ function open(h, n, playerId, npcId) {
625
664
  if (!conversationOf(h, npc, playerId, talking)) {
626
665
  return;
627
666
  }
628
- h.ctx.send(playerId, {
629
- k: 'hub-npc',
630
- npc: npcId,
631
- open: true,
632
- mind,
633
- character: mind ? npc.character : null,
634
- name: npc.name,
635
- // A client from before v1.17 named the players within `hearRange` as a
636
- // turn's listeners: zero has it name nobody.
637
- hearRange: 0,
638
- disclosure: 'participants',
639
- // A body without a mind or a place opening keeps its hello line.
640
- ...(opening ? { opening } : {}),
641
- });
642
- state.notes = null;
643
- state.opening = opening ? { playerId, text: opening.text } : null;
644
- if (!mind) {
645
- // An opening is the NPC's hello; without one, the place's or the kit's.
646
- if (!opening) {
647
- line(h, npc, playerId, 'hello');
667
+ const emit = () => {
668
+ if (!conversationOf(h, npc, playerId, talking)) {
669
+ return;
648
670
  }
649
- return;
671
+ h.ctx.send(playerId, {
672
+ k: 'hub-npc',
673
+ npc: npcId,
674
+ open: true,
675
+ mind,
676
+ character: mind ? npc.character : null,
677
+ name: npc.name,
678
+ // A client from before v1.17 named the players within `hearRange` as a
679
+ // turn's listeners: zero has it name nobody.
680
+ hearRange: 0,
681
+ disclosure: 'participants',
682
+ ...(child ? { choices: child.map(({ id, label }) => ({ id, label })) } : taps ? { choices: [...taps], authoredChoices: true } : choicesOnly(h, playerId) ? { choices: [...CHILD_ASKS] } : {}),
683
+ // A mind's under-13 speaker, by the trusted identity alone and in every
684
+ // place: their own panel may say why typing is off. Only to them.
685
+ ...(mind && under13(h, playerId) ? { ageOff: true } : {}),
686
+ // A body without a mind or a place opening keeps its hello line.
687
+ ...(opening ? { opening } : {}),
688
+ });
689
+ state.notes = null;
690
+ state.opening = opening ? { playerId, text: opening.text } : null;
691
+ if (!mind) {
692
+ // An opening is the NPC's hello; without one, the place's or the kit's.
693
+ if (!opening) {
694
+ line(h, n, npc, playerId, 'hello');
695
+ }
696
+ return;
697
+ }
698
+ issueNotes(h, npc, playerId);
699
+ };
700
+ if (!child && h.place.talkLog === true && typeof opening?.text === 'string' && opening.text) {
701
+ Promise.resolve().then(() => archiveTalk(h, npc, playerId, {
702
+ operationId: logOperation('opening', talking.conversation), conversationId: String(talking.conversation), reply: opening.text,
703
+ })).then(emit).catch(() => logRefused(h, n, npc, playerId));
704
+ } else {
705
+ emit();
650
706
  }
651
- issueNotes(h, npc, playerId);
707
+
652
708
  }
653
709
 
654
710
  // How this player is known to `met`: their account where they have one.
@@ -670,6 +726,7 @@ function clearTalk(npc, playerId) {
670
726
  state.talking = null;
671
727
  state.opening = null;
672
728
  state.notes = null;
729
+ state.taps = null;
673
730
  }
674
731
 
675
732
  // v1.47: copies of a greeting in the conversation belong to its account/body too.
@@ -705,7 +762,7 @@ function greetingOf(h, n, playerId, character) {
705
762
  function refreshOpening(h, n, npc, playerId) {
706
763
  const talking = conversationOf(h, npc, playerId);
707
764
  const state = speakerState(npc, playerId);
708
- if (!talking || talking.said || state.opening?.playerId !== playerId || !hasMind(h, npc)) {
765
+ if (childAsks(h, npc, playerId) || state?.taps || !talking || talking.said || state.opening?.playerId !== playerId || !hasMind(h, npc)) {
709
766
  return;
710
767
  }
711
768
  const text = greetingOf(h, n, playerId, npc.character);
@@ -713,9 +770,21 @@ function refreshOpening(h, n, npc, playerId) {
713
770
  return;
714
771
  }
715
772
  // v1.47: an approach read can finish after the panel showed its first words.
716
- state.opening.text = text;
717
- h.ctx.send(playerId, { k: 'hub-npc-opening', npc: npc.id, text });
718
- issueNotes(h, npc, playerId, { force: true });
773
+ const emit = () => {
774
+ if (!conversationOf(h, npc, playerId, talking) || talking.said) {
775
+ return;
776
+ }
777
+ state.opening.text = text;
778
+ h.ctx.send(playerId, { k: 'hub-npc-opening', npc: npc.id, text });
779
+ issueNotes(h, npc, playerId, { force: true });
780
+ };
781
+ if (h.place.talkLog === true) {
782
+ Promise.resolve().then(() => archiveTalk(h, npc, playerId, {
783
+ operationId: logOperation('opening-refresh', talking.conversation), conversationId: String(talking.conversation), reply: text,
784
+ })).then(emit).catch(() => logRefused(h, n, npc, playerId));
785
+ } else {
786
+ emit();
787
+ }
719
788
  }
720
789
 
721
790
  // The player said something to this NPC: they have met. Kept only where a
@@ -779,7 +848,8 @@ function openingOf(h, n, npc, playerId, greeting, conversation) {
779
848
  more.push(question);
780
849
  }
781
850
  }
782
- return { text, asks, ...(more.length ? { more } : {}) };
851
+ // v1.148: the place answers these asks itself (npcLine 'authored').
852
+ return { text, asks, ...(more.length ? { more } : {}), ...(said?.authored === true && asks.length ? { authored: true } : {}) };
783
853
  }
784
854
 
785
855
  // The place's notes for the character about this speaker now, framed as the
@@ -843,7 +913,7 @@ function issueNotes(h, npc, playerId, { force = false } = {}) {
843
913
  const talking = conversationOf(h, npc, playerId);
844
914
  const state = speakerState(npc, playerId);
845
915
  const now = h.sim.timeMs;
846
- if (!talking || !hasMind(h, npc)) {
916
+ if (!talking || !hasMind(h, npc) || childAsks(h, npc, playerId)) {
847
917
  return;
848
918
  }
849
919
  if (state.notes?.playerId !== playerId) {
@@ -923,8 +993,32 @@ function endTalk(h, n, npcId, playerId, why) {
923
993
  h.ctx.send(playerId, { k: 'hub-npc', npc: npcId, open: false, why });
924
994
  }
925
995
 
996
+ // No read API: identity/deck/place are stamped by the platform, not the client.
997
+ // Absent talkLog never calls storage or changes the synchronous delivery path.
998
+ // Ghost refuses archive writes for any player under 13, so none is attempted:
999
+ // a refusal would close their opening (and its 13+ line) as unavailable.
1000
+ function archiveTalk(h, npc, playerId, entry) {
1001
+ if (under13(h, playerId)) {return;}
1002
+ return h.session.hub.archiveText(playerId, {
1003
+ npcId: npc.id,
1004
+ ...(typeof npc.character === 'string' && npc.character ? { characterId: npc.character } : {}),
1005
+ ...entry,
1006
+ });
1007
+ }
1008
+
1009
+ function logRefused(h, n, npc, playerId) {
1010
+ console.warn('[hub] NPC transcript unavailable');
1011
+ endTalk(h, n, npc.id, playerId, 'unavailable');
1012
+ }
1013
+
1014
+ function logOperation(why, conversation) {
1015
+ return `${why}:${conversation ?? ''}:${Date.now()}:${Math.random().toString(36).slice(2)}`;
1016
+ }
1017
+
926
1018
  // The place's authored words for this moment (`npcLine`), or the kit's.
927
- function line(h, npc, playerId, why, text, op, rid, conversation) {
1019
+ function line(h, n, npc, playerId, why, text, op, rid, conversation, fallback = why) {
1020
+ // v1.148: authored taps lead bundle chips, so their answers are said.
1021
+ if (childAsks(h, npc, playerId) && !(why === 'authored' && speakerState(npc, playerId)?.taps)) {return;}
928
1022
  let said = null;
929
1023
  try {
930
1024
  said = h.hooks.npcLine?.(h.ctx, h.ctx.npc(npc.id), playerId, { why, text: text ?? null, ...(conversation !== undefined ? { conversation } : {}) }) ?? null;
@@ -932,15 +1026,30 @@ function line(h, npc, playerId, why, text, op, rid, conversation) {
932
1026
  console.warn(text !== undefined || npc.owner ? '[hub] npcLine failed' : `[hub] npcLine failed: ${err?.stack ?? err}`);
933
1027
  }
934
1028
  if (said === null || said === undefined) {
935
- said = DEFAULT_LINES[why]?.(npc.name, h.ctx.username(playerId)) ?? null;
936
- }
937
- if (said) {
938
- // The line may name the player (the kit's hello does): nobody a block
939
- // hides them from is ever sent it, a player who arrives later included.
940
- say(h, npc, said, { about: playerId, ...(npc.speakers && text !== undefined ? { to: [playerId] } : {}) });
941
- // `why` lets the speaker's panel say an answer was scripted, not the mind's.
942
- h.ctx.send(playerId, { k: 'hub-npc-line', npc: npc.id, text: String(said).slice(0, SPEECH_MAX), why, ...(op ? { op } : {}), ...(rid ? { rid } : {}) });
1029
+ said = DEFAULT_LINES[fallback]?.(npc.name, h.ctx.username(playerId)) ?? null;
1030
+ }
1031
+ const emit = () => {
1032
+ if (said) {
1033
+ // The line may name the player (the kit's hello does): nobody a block
1034
+ // hides them from is ever sent it, a player who arrives later included.
1035
+ say(h, npc, said, { about: playerId, ...(npc.speakers && text !== undefined ? { to: [playerId] } : {}) });
1036
+ // `why` lets the speaker's panel say an answer was scripted, not the mind's.
1037
+ h.ctx.send(playerId, { k: 'hub-npc-line', npc: npc.id, text: String(said).slice(0, SPEECH_MAX), why, ...(op ? { op } : {}), ...(rid ? { rid } : {}) });
1038
+ }
1039
+ };
1040
+ if (h.place.talkLog === true && (said || text !== undefined)) {
1041
+ const entry = { operationId: op ? `${op}:script:${why}` : rid ? `authored:${playerId}:${rid}` : logOperation(why, conversation),
1042
+ ...(conversation !== undefined ? { conversationId: String(conversation) } : {}),
1043
+ ...(text !== undefined ? { input: text } : {}),
1044
+ ...(said ? { reply: String(said).slice(0, SPEECH_MAX) } : {}),
1045
+ };
1046
+ return Promise.resolve().then(() => archiveTalk(h, npc, playerId, entry)).then(() => {
1047
+ if (h.sim.players.has(playerId) && (conversation === undefined || talkingOf(npc, playerId)?.conversation === conversation)) {
1048
+ emit();
1049
+ }
1050
+ }).catch(() => logRefused(h, n, npc, playerId));
943
1051
  }
1052
+ emit();
944
1053
  }
945
1054
 
946
1055
  const DEFAULT_LINES = {
@@ -948,6 +1057,9 @@ const DEFAULT_LINES = {
948
1057
  busy: (name) => `${name} is talking with someone else.`,
949
1058
  budget: (name) => `${name} has a crowd to answer. Try again in a moment.`,
950
1059
  unavailable: (name) => `${name} doesn't catch that. Try again in a moment.`,
1060
+ // The kit's unavailable line when ghost refused this turn's characters
1061
+ // outright: it promises no retry. The hook still hears `unavailable`.
1062
+ refused: (name) => `${name} smiles and nods.`,
951
1063
  };
952
1064
 
953
1065
  // Words to a body with no mind here (the dev serve, a session the host brokers
@@ -962,16 +1074,27 @@ function authoredSay(h, n, playerId, npcId, text, rid) {
962
1074
  return;
963
1075
  }
964
1076
  const now = h.sim.timeMs;
965
- if (now - (n.saidAt.get(playerId) ?? -Infinity) < SAY_GAP_MS || hasMind(h, npc)) {
1077
+ // v1.148: a mind hears here only its under-13 speaker's authored taps.
1078
+ const taps = hasMind(h, npc) ? speakerState(npc, playerId)?.taps : null;
1079
+ if (now - (n.saidAt.get(playerId) ?? -Infinity) < SAY_GAP_MS || (hasMind(h, npc) && !taps?.includes(text.trim()))) {
966
1080
  return;
967
1081
  }
1082
+ if (taps) {
1083
+ text = text.trim();
1084
+ }
1085
+ if (!taps && choicesOnly(h, playerId)) {
1086
+ text = text.trim();
1087
+ if (!CHILD_ASKS.includes(text)) {
1088
+ return;
1089
+ }
1090
+ }
968
1091
  n.saidAt.set(playerId, now);
969
1092
  talking.said = true;
970
1093
  talking.at = now;
971
1094
  metNow(h, n, npc, playerId);
972
1095
  // v1.46: echo only this send's short request id, when its client gave one.
973
1096
  const requestId = typeof rid === 'string' && rid.length <= 64 ? rid : null;
974
- line(h, npc, playerId, 'authored', text.slice(0, INPUT_MAX), undefined, requestId, talking.conversation);
1097
+ line(h, n, npc, playerId, 'authored', text.slice(0, INPUT_MAX), undefined, requestId, talking.conversation);
975
1098
  }
976
1099
 
977
1100
  // A turn the host granted: the kit admits it only for the player this body is
@@ -997,7 +1120,7 @@ async function admitTurn(h, n, turn) {
997
1120
  }
998
1121
  if (npc.speakers && fullFor(npc, speaker)) {
999
1122
  turn.reject('HUB_NPC_BUSY');
1000
- line(h, npc, speaker, 'busy', undefined, turn.operationId);
1123
+ line(h, n, npc, speaker, 'busy', undefined, turn.operationId);
1001
1124
  return;
1002
1125
  }
1003
1126
  const talking = conversationOf(h, npc, speaker);
@@ -1016,30 +1139,63 @@ async function admitTurn(h, n, turn) {
1016
1139
  // turn already admitted: ghost replays it, so it neither waits behind
1017
1140
  // itself nor spends the budget twice.
1018
1141
  const key = `${speaker}:${turn.operationId}`;
1019
- const existing = n.turns.get(key) ?? (state.pending?.key === key ? state.pending : null);
1142
+ let existing = n.turns.get(key) ?? (state.pending?.key === key ? state.pending : null);
1020
1143
  // v1.47: a sent turn fixes the opening, even if its notes need a retry.
1021
1144
  if (typeof turn.input === 'string' && turn.input.trim()) {
1022
1145
  talking.said = true;
1023
1146
  }
1147
+ // v1.148: authored taps are answered by the place, never a mind turn.
1148
+ if (state?.taps) {
1149
+ turn.reject('HUB_NPC_CHOICE_REQUIRED');
1150
+ return;
1151
+ }
1152
+ const child = childAsks(h, npc, speaker);
1153
+ // Check raw bytes even on replay: no notes, whitespace or extra text.
1154
+ if (child && !child.some(({ id }) => turn.input === `choice:${id}`)) {
1155
+ turn.reject('HUB_NPC_CHOICE_REQUIRED');
1156
+ return;
1157
+ }
1024
1158
  // A replay was checked when it was first admitted; its notes may be gone.
1025
- const words = existing ? null : wordsOf(h, npc, speaker, turn.input);
1159
+ const words = existing ? null : child ? turn.input : wordsOf(h, npc, speaker, turn.input);
1026
1160
  if (!existing && words === null) {
1027
1161
  turn.reject('HUB_NPC_NOTES');
1028
1162
  // The client may have missed the newest: send them again for its retry.
1029
1163
  issueNotes(h, npc, speaker, { force: true });
1030
1164
  return;
1031
1165
  }
1166
+ if (!child && !existing && choicesOnly(h, speaker) && !CHILD_ASKS.includes(words)) {
1167
+ turn.reject('HUB_NPC_CHOICE_REQUIRED');
1168
+ return;
1169
+ }
1170
+ const archive = child || under13(h, speaker) ? undefined : existing?.archive ?? (h.place.talkLog === true && !existing
1171
+ ? { npcId: npc.id, conversationId: String(conversation), input: words } : undefined);
1172
+ if (archive && !existing) {
1173
+ try {
1174
+ await archiveTalk(h, npc, speaker, { operationId: turn.operationId, conversationId: archive.conversationId, input: words });
1175
+ } catch {
1176
+ turn.reject('HUB_NPC_LOG_UNAVAILABLE');
1177
+ return;
1178
+ }
1179
+ // This await may outlive a departure, replacement or conversation switch.
1180
+ if (!conversationOf(h, npc, speaker, talking)) {
1181
+ turn.reject('HUB_NPC_NOT_TALKING');
1182
+ return;
1183
+ }
1184
+ }
1185
+ if (!existing && state.pending?.key === key) {
1186
+ existing = state.pending;
1187
+ }
1032
1188
  if (!existing) {
1033
1189
  if (state.pending && !state.pending.delivered && h.sim.timeMs - state.pending.at < PENDING_MS) {
1034
1190
  turn.reject('HUB_NPC_BUSY');
1035
- line(h, npc, speaker, 'busy', undefined, turn.operationId);
1191
+ line(h, n, npc, speaker, 'busy', undefined, turn.operationId);
1036
1192
  return;
1037
1193
  }
1038
1194
  const now = Date.now();
1039
1195
  npc.recent = npc.recent.filter((at) => now - at < 60_000);
1040
1196
  if (npc.recent.length >= npcs.turnsPerMinute) {
1041
1197
  turn.reject('HUB_NPC_BUDGET');
1042
- line(h, npc, speaker, 'budget', undefined, turn.operationId);
1198
+ line(h, n, npc, speaker, 'budget', undefined, turn.operationId);
1043
1199
  return;
1044
1200
  }
1045
1201
  npc.recent.push(now);
@@ -1051,6 +1207,7 @@ async function admitTurn(h, n, turn) {
1051
1207
  speaker,
1052
1208
  at: h.sim.timeMs,
1053
1209
  delivered: false,
1210
+ ...(archive ? { archive } : {}),
1054
1211
  };
1055
1212
  // Only a new turn takes the body; a replay leaves whatever holds it.
1056
1213
  if (!existing) {
@@ -1058,12 +1215,12 @@ async function admitTurn(h, n, turn) {
1058
1215
  }
1059
1216
  // v1.66: the place's tools ride with a new turn; a replay keeps the first
1060
1217
  // admission's. Without `npcTools` this is the send as it always was.
1061
- if (!existing && typeof h.hooks.npcTools === 'function') {
1218
+ if (!child && !existing && typeof h.hooks.npcTools === 'function') {
1062
1219
  record.tools = placeTools(h, npc, speaker);
1063
1220
  }
1064
1221
  try {
1065
- if (record.tools) {
1066
- await turn.send({ tools: record.tools.list });
1222
+ if (!child && (record.tools || record.archive)) {
1223
+ await turn.send({ ...(record.tools ? { tools: record.tools.list } : {}), ...(record.archive ? { hubTextArchive: record.archive } : {}) });
1067
1224
  } else {
1068
1225
  await turn.send();
1069
1226
  }
@@ -1082,7 +1239,8 @@ async function admitTurn(h, n, turn) {
1082
1239
  ? 'budget'
1083
1240
  : 'unavailable';
1084
1241
  if (!npc.owner || recordOf(n, npc.id) === npc) {
1085
- line(h, npc, speaker, why, undefined, turn.operationId);
1242
+ const refused = why === 'unavailable' && /characters are unavailable/i.test(typeof err?.message === 'string' ? err.message : '');
1243
+ line(h, n, npc, speaker, why, undefined, turn.operationId, undefined, undefined, refused ? 'refused' : why);
1086
1244
  }
1087
1245
  throw err;
1088
1246
  }
@@ -1188,6 +1346,7 @@ async function answerTool(h, n, request) {
1188
1346
  !record?.tools ||
1189
1347
  record.speaker !== playerId ||
1190
1348
  !npc ||
1349
+ childAsks(h, npc, playerId) ||
1191
1350
  npc.character !== characterId ||
1192
1351
  !record.tools.names.has(name) ||
1193
1352
  record.tools.used ||
@@ -1291,13 +1450,20 @@ async function routeRead(h, n, request) {
1291
1450
  return;
1292
1451
  }
1293
1452
  const nearby = [...n.bodies.values()]
1294
- .filter((npc) => !npc.owner && npc.character === character && hasMind(h, npc) && h.sim.bodies.get(npc.id) === npc.body && !fullFor(npc, speaker))
1453
+ .filter((npc) => !childAsks(h, npc, speaker) && !npc.owner && npc.character === character && hasMind(h, npc) && h.sim.bodies.get(npc.id) === npc.body && !fullFor(npc, speaker))
1295
1454
  .map((npc) => ({ npc, d: distanceTo(h, npc, speaker) }))
1296
1455
  // The Chat prompt's range plus 2 m allows for movement during the read.
1297
1456
  .filter(({ npc, d }) => d <= npc.talkRange + 2)
1298
1457
  .sort((a, b) => a.d - b.d || a.npc.id.localeCompare(b.npc.id));
1299
1458
  if (nearby.length) {
1300
- say(h, nearby[0].npc, text, { to: [speaker], about: speaker });
1459
+ const npc = nearby[0].npc;
1460
+ if (h.place.talkLog === true) {
1461
+ await archiveTalk(h, npc, speaker, { operationId: logOperation('walk-greeting'), reply: text });
1462
+ if (h.sim?.players.get(speaker) !== body || userIdOf(h, speaker) !== userId) {
1463
+ return;
1464
+ }
1465
+ }
1466
+ say(h, npc, npcDisplayText(text), { to: [speaker], about: speaker });
1301
1467
  }
1302
1468
  return;
1303
1469
  }
@@ -1318,7 +1484,7 @@ async function routeRead(h, n, request) {
1318
1484
  state.pending = null;
1319
1485
  }
1320
1486
  if (typeof result.response === 'string' && result.response.trim() && h.sim?.players.has(turn.speaker)) {
1321
- say(h, npc, unquote(result.response), { to: [turn.speaker], about: turn.speaker });
1487
+ say(h, npc, npcDisplayText(result.response), { to: [turn.speaker], about: turn.speaker });
1322
1488
  }
1323
1489
  if (npc.owner) {
1324
1490
  return; // The owner reads the reply in the panel; no follow or public read.
@@ -1334,7 +1500,7 @@ function pollFollow(h, n) {
1334
1500
  const world = sessionCharacters(h);
1335
1501
  const now = h.sim?.timeMs ?? 0;
1336
1502
  const following = [...n.bodies.values()].some((npc) => npc.following && npc.followByToken);
1337
- const gap = Math.min(FOLLOW_POLL_MS * 2 ** n.inspectFailures, 60_000);
1503
+ const gap = Math.min(FOLLOW_POLL_MS * 2 ** n.inspectFailures, FOLLOW_POLL_MAX_MS);
1338
1504
  if (!world || n.polling || (now > n.watchUntil && !following) || now - n.polledAt < gap) {
1339
1505
  return;
1340
1506
  }
@@ -1352,8 +1518,11 @@ function pollFollow(h, n) {
1352
1518
  .catch((err) => {
1353
1519
  // Backed off, not given up: a transient failure must not stop a later
1354
1520
  // follow from being seen.
1355
- n.inspectFailures = Math.min(n.inspectFailures + 1, 5);
1356
- console.warn(`[hub] NPC follow could not read the world's public projection: ${err?.message ?? err}`);
1521
+ // Logged once per run of failures.
1522
+ if (!n.inspectFailures) {
1523
+ console.warn(`[hub] NPC follow could not read the world's public projection: ${err?.message ?? err}`);
1524
+ }
1525
+ n.inspectFailures = Math.min(n.inspectFailures + 1, Math.ceil(Math.log2(FOLLOW_POLL_MAX_MS / FOLLOW_POLL_MS)));
1357
1526
  })
1358
1527
  .finally(() => {
1359
1528
  n.polling = false;
@@ -1474,10 +1643,3 @@ function stepToward(npc, x, z, stopAt, dt) {
1474
1643
  const stride = Math.min(d - stopAt, WALK_MPS * dt);
1475
1644
  return { arrived: false, next: { x: p.x + (dx / d) * stride, y: p.y, z: p.z + (dz / d) * stride } };
1476
1645
  }
1477
-
1478
- // A model sometimes wraps its whole line in quotes; a speech bubble is quotes
1479
- // enough.
1480
- function unquote(text) {
1481
- const t = text.trim();
1482
- return t.length > 1 && /^["“]/.test(t) && /["”]$/.test(t) ? t.slice(1, -1).trim() : t;
1483
- }