castle-web-cli 0.4.231 → 0.4.233

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 (368) hide show
  1. package/dist/agent-failures.d.ts +8 -0
  2. package/dist/agent-failures.js +19 -2
  3. package/dist/agent-prompts.d.ts +1 -1
  4. package/dist/agent-prompts.js +10 -3
  5. package/dist/agent.d.ts +64 -3
  6. package/dist/agent.js +170 -81
  7. package/dist/castle-host/host.d.ts +1 -0
  8. package/dist/castle-host/host.js +51 -3
  9. package/dist/castleJson.d.ts +4 -2
  10. package/dist/castleJson.js +2 -0
  11. package/dist/check.d.ts +3 -1
  12. package/dist/check.js +11 -1
  13. package/dist/devSessionStorage.js +47 -1
  14. package/dist/importPinMismatch.d.ts +22 -0
  15. package/dist/importPinMismatch.js +77 -0
  16. package/dist/importRegression.js +3 -15
  17. package/dist/imports.d.ts +10 -3
  18. package/dist/imports.js +88 -20
  19. package/dist/index.js +5 -4
  20. package/dist/init.js +1 -1
  21. package/dist/platformDoc.js +22 -0
  22. package/dist/routerFences.d.ts +5 -0
  23. package/dist/routerFences.js +12 -2
  24. package/dist/save-deck.d.ts +5 -0
  25. package/dist/save-deck.js +37 -4
  26. package/dist/serve.js +3 -0
  27. package/dist/serverBundle.js +5 -3
  28. package/dist/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
  29. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  30. package/dist/shell/index.html +2 -2
  31. package/dist/taskSteer.d.ts +13 -0
  32. package/dist/taskSteer.js +22 -2
  33. package/kits/base/castle.json +1 -1
  34. package/kits/base/package-lock.json +1 -1
  35. package/kits/base/sdk/README.md +79 -2
  36. package/kits/base/sdk/avatar.d.ts +6 -2
  37. package/kits/base/sdk/avatar.js +12 -4
  38. package/kits/base/sdk/castle.d.ts +1 -1
  39. package/kits/base/sdk/commands.d.ts +14 -0
  40. package/kits/base/sdk/hub.d.ts +6 -2
  41. package/kits/base/sdk/hub.js +13 -0
  42. package/kits/base/sdk/multiplayer.js +17 -1
  43. package/kits/base/sdk/save.js +2 -1
  44. package/kits/base/sdk/server/hub.d.ts +87 -0
  45. package/kits/base/sdk/server/hub.js +70 -0
  46. package/kits/base/sdk/server/platformHandle.d.ts +31 -1
  47. package/kits/base/sdk/server/storage.d.ts +13 -0
  48. package/kits/base/sdk/server/storage.js +46 -0
  49. package/kits/base/sdk/server/wrapper.d.ts +36 -5
  50. package/kits/base/sdk/server/wrapper.js +83 -8
  51. package/kits/hub-game/CLAUDE.md +352 -12
  52. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  53. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  54. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  55. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  56. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  57. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  58. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  59. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  60. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  61. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  62. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  63. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  64. package/kits/hub-game/code/client/actorBudget.js +47 -0
  65. package/kits/hub-game/code/client/attention.js +11 -2
  66. package/kits/hub-game/code/client/avatar.js +345 -32
  67. package/kits/hub-game/code/client/avatarCap.js +228 -0
  68. package/kits/hub-game/code/client/avatarColors.js +70 -0
  69. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  70. package/kits/hub-game/code/client/avatarShare.js +251 -0
  71. package/kits/hub-game/code/client/ballot.js +467 -0
  72. package/kits/hub-game/code/client/build.js +22 -0
  73. package/kits/hub-game/code/client/chat.js +12 -0
  74. package/kits/hub-game/code/client/chrome.js +1334 -50
  75. package/kits/hub-game/code/client/companion.js +716 -0
  76. package/kits/hub-game/code/client/companionDress.js +99 -0
  77. package/kits/hub-game/code/client/decor.js +509 -0
  78. package/kits/hub-game/code/client/earned.js +131 -0
  79. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  80. package/kits/hub-game/code/client/grab.js +363 -20
  81. package/kits/hub-game/code/client/hats.js +26 -0
  82. package/kits/hub-game/code/client/hookLayer.js +328 -15
  83. package/kits/hub-game/code/client/hudClear.js +126 -0
  84. package/kits/hub-game/code/client/idle.js +163 -22
  85. package/kits/hub-game/code/client/interestCap.js +81 -0
  86. package/kits/hub-game/code/client/keys.js +36 -0
  87. package/kits/hub-game/code/client/labelsNear.js +205 -0
  88. package/kits/hub-game/code/client/menuIcons.js +34 -0
  89. package/kits/hub-game/code/client/pack.js +6 -2
  90. package/kits/hub-game/code/client/packFormat.js +3 -3
  91. package/kits/hub-game/code/client/rehello.js +167 -0
  92. package/kits/hub-game/code/client/shot.js +92 -0
  93. package/kits/hub-game/code/client/sound.js +63 -8
  94. package/kits/hub-game/code/client/soundscape.js +1151 -0
  95. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  96. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  97. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  98. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  99. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  100. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  101. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  102. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  103. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  104. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  105. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  106. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  107. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  108. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  109. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  110. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  111. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  112. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  113. package/kits/hub-game/code/client/spin.js +101 -0
  114. package/kits/hub-game/code/client/state.js +131 -1
  115. package/kits/hub-game/code/client/stuck.js +259 -0
  116. package/kits/hub-game/code/client/talk.js +538 -47
  117. package/kits/hub-game/code/client/tiers.js +541 -27
  118. package/kits/hub-game/code/client/toastBand.js +37 -0
  119. package/kits/hub-game/code/client/together.js +98 -1
  120. package/kits/hub-game/code/client/visibility.js +43 -0
  121. package/kits/hub-game/code/client/wear.js +470 -97
  122. package/kits/hub-game/code/client/yours.js +199 -0
  123. package/kits/hub-game/code/companionSpec.js +45 -0
  124. package/kits/hub-game/code/privateText.js +7 -0
  125. package/kits/hub-game/code/server/actions.js +133 -0
  126. package/kits/hub-game/code/server/actors.js +14 -1
  127. package/kits/hub-game/code/server/ask.js +155 -0
  128. package/kits/hub-game/code/server/ballot.js +539 -0
  129. package/kits/hub-game/code/server/cells.js +100 -0
  130. package/kits/hub-game/code/server/companion.js +82 -0
  131. package/kits/hub-game/code/server/cues.js +70 -0
  132. package/kits/hub-game/code/server/decor.js +269 -0
  133. package/kits/hub-game/code/server/earned.js +461 -0
  134. package/kits/hub-game/code/server/friendBests.js +166 -0
  135. package/kits/hub-game/code/server/friendsAmong.js +232 -0
  136. package/kits/hub-game/code/server/grab.js +296 -11
  137. package/kits/hub-game/code/server/history.js +5 -0
  138. package/kits/hub-game/code/server/hub.js +1317 -52
  139. package/kits/hub-game/code/server/idle.js +30 -11
  140. package/kits/hub-game/code/server/index.js +2 -2
  141. package/kits/hub-game/code/server/labels.js +28 -2
  142. package/kits/hub-game/code/server/manifest.js +424 -8
  143. package/kits/hub-game/code/server/menu.js +133 -0
  144. package/kits/hub-game/code/server/npcs.js +830 -80
  145. package/kits/hub-game/code/server/party.js +13 -2
  146. package/kits/hub-game/code/server/players.js +22 -0
  147. package/kits/hub-game/code/server/say.js +8 -2
  148. package/kits/hub-game/code/server/shot.js +110 -0
  149. package/kits/hub-game/code/server/standing.js +124 -0
  150. package/kits/hub-game/code/server/vis.js +113 -0
  151. package/kits/hub-game/code/server/wear.js +128 -11
  152. package/kits/hub-game/code/server/yours.js +59 -0
  153. package/kits/hub-game/code/shared/cues.js +9 -0
  154. package/kits/hub-game/code/shared/decor.js +41 -0
  155. package/kits/hub-game/code/shared/shot.js +19 -0
  156. package/kits/hub-game/code/shared/spin.js +57 -0
  157. package/kits/hub-game/code/systems/hub.js +1083 -85
  158. package/kits/hub-game/docs/content-pack.md +1 -1
  159. package/kits/hub-game/docs/contract.md +2440 -61
  160. package/kits/hub-game/docs/home-pieces.md +64 -0
  161. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  162. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  163. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  164. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  165. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  166. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  167. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  168. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  169. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  170. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  171. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  172. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  173. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  174. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  175. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  176. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  177. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  178. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  179. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  180. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  181. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  182. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  183. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  184. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  185. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  186. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  187. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  188. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  189. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  190. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  191. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  192. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  193. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  194. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  195. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  196. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  197. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  198. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  199. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  200. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  201. package/kits/hub-game/package-lock.json +2 -0
  202. package/kits/hub-game/package.json +2 -1
  203. package/kits/hub-game/scripts/check.mjs +78 -11
  204. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  205. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
  206. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  207. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
  208. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -0
  209. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  210. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  211. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  212. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  213. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  214. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  215. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  216. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  217. package/kits/hub-game/scripts/test-actions-client.mjs +488 -0
  218. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  219. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  220. package/kits/hub-game/scripts/test-actors.mjs +19 -17
  221. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  222. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  223. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  224. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  225. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  226. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  227. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  228. package/kits/hub-game/scripts/test-avatar-wire.mjs +753 -0
  229. package/kits/hub-game/scripts/test-avatar.mjs +540 -7
  230. package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
  231. package/kits/hub-game/scripts/test-build.mjs +31 -0
  232. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  233. package/kits/hub-game/scripts/test-chat.mjs +694 -0
  234. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  235. package/kits/hub-game/scripts/test-companion-chat.mjs +198 -0
  236. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  237. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  238. package/kits/hub-game/scripts/test-decor-client.mjs +303 -0
  239. package/kits/hub-game/scripts/test-decor.mjs +457 -0
  240. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  241. package/kits/hub-game/scripts/test-earned.mjs +1194 -0
  242. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  243. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  244. package/kits/hub-game/scripts/test-grab-client.mjs +186 -3
  245. package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
  246. package/kits/hub-game/scripts/test-grab.mjs +864 -3
  247. package/kits/hub-game/scripts/test-hats.mjs +483 -0
  248. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  249. package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
  250. package/kits/hub-game/scripts/test-hub-trip.mjs +1228 -1
  251. package/kits/hub-game/scripts/test-hud-clear.mjs +1000 -0
  252. package/kits/hub-game/scripts/test-idle.mjs +361 -1
  253. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  254. package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
  255. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  256. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  257. package/kits/hub-game/scripts/test-labels.mjs +596 -0
  258. package/kits/hub-game/scripts/test-manifest.mjs +282 -0
  259. package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
  260. package/kits/hub-game/scripts/test-menu.mjs +296 -0
  261. package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
  262. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  263. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  264. package/kits/hub-game/scripts/test-party.mjs +22 -1
  265. package/kits/hub-game/scripts/test-picker.mjs +314 -0
  266. package/kits/hub-game/scripts/test-rehello.mjs +1039 -0
  267. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  268. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  269. package/kits/hub-game/scripts/test-say.mjs +59 -2
  270. package/kits/hub-game/scripts/test-shot.mjs +756 -0
  271. package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
  272. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  273. package/kits/hub-game/scripts/test-standing.mjs +416 -0
  274. package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
  275. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  276. package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
  277. package/kits/hub-game/scripts/test-tiers.mjs +666 -3
  278. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  279. package/kits/hub-game/scripts/test-try-on.mjs +940 -0
  280. package/kits/hub-game/scripts/test-vis.mjs +343 -0
  281. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  282. package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
  283. package/kits/hub-game/scripts/test-yours.mjs +372 -0
  284. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  285. package/kits/multiplayer-3d/castle.json +5 -5
  286. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  287. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  288. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  289. package/kits/multiplayer-3d/code/options.js +5 -0
  290. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  291. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  292. package/kits/multiplayer-3d/code/server/world.js +7 -0
  293. package/kits/multiplayer-3d/code/systems/multiplayer.js +74 -4
  294. package/kits/multiplayer-3d/package.json +2 -1
  295. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  296. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  297. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  298. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  299. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  300. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  301. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  302. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  303. package/kits/physics-2d/CLAUDE.md +9 -0
  304. package/kits/physics-2d/castle.json +2 -2
  305. package/kits/physics-2d/engine/scene.js +288 -1
  306. package/kits/physics-2d/engine/skyKey.js +129 -0
  307. package/kits/physics-2d/engine/stillClock.js +106 -0
  308. package/kits/physics-2d/engine/updateBudget.js +21 -0
  309. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +370 -1
  310. package/kits/physics-3d/CLAUDE.md +1391 -0
  311. package/kits/physics-3d/behaviors/Player.jsx +921 -3
  312. package/kits/physics-3d/castle.json +3 -3
  313. package/kits/physics-3d/docs/pxmodel-format.md +12 -0
  314. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +98 -10
  315. package/kits/physics-3d/engine3d/actornode.js +86 -0
  316. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  317. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  318. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  319. package/kits/physics-3d/engine3d/framecap.js +96 -0
  320. package/kits/physics-3d/engine3d/gait.js +118 -0
  321. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  322. package/kits/physics-3d/engine3d/look.js +507 -48
  323. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  324. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  325. package/kits/physics-3d/engine3d/motion.js +39 -10
  326. package/kits/physics-3d/engine3d/nearshadows.js +37 -19
  327. package/kits/physics-3d/engine3d/optimize.js +58 -5
  328. package/kits/physics-3d/engine3d/orbitinput.js +755 -0
  329. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  330. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  331. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  332. package/kits/physics-3d/engine3d/shadowfade.js +882 -0
  333. package/kits/physics-3d/engine3d/sky.js +547 -0
  334. package/kits/physics-3d/engine3d/skylife.js +306 -0
  335. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  336. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  337. package/kits/physics-3d/engine3d/world3d.js +870 -87
  338. package/kits/physics-3d/main.jsx +5 -0
  339. package/kits/physics-3d/package.json +1 -1
  340. package/kits/physics-3d/scripts/Player.before-orbit.mjs +310 -0
  341. package/kits/physics-3d/scripts/Scene3DPlayer.before-orbit.jsx +337 -0
  342. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  343. package/kits/physics-3d/scripts/test-camera-follow.mjs +12 -2
  344. package/kits/physics-3d/scripts/test-camera-orbit.mjs +4588 -0
  345. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +787 -0
  346. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
  347. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  348. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  349. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  350. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  351. package/kits/physics-3d/scripts/test-near-shadows.mjs +3 -0
  352. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
  353. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
  354. package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
  355. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  356. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  357. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  358. package/kits/physics-3d/scripts/test-static-actors.mjs +13 -1
  359. package/kits/physics-3d/scripts/test-static-passes.mjs +1 -1
  360. package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
  361. package/kits/physics-3d/scripts/test-steady-hover.mjs +635 -0
  362. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  363. package/kits/physics-3d/systems/physics3d.js +474 -12
  364. package/kits/real-time/castle.json +2 -2
  365. package/kits/real-time/code/server/gameHooks.js +7 -0
  366. package/kits/real-time/code/server/session.js +97 -19
  367. package/package.json +2 -2
  368. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -23,6 +23,8 @@ register(
23
23
  'data:text/javascript,' +
24
24
  encodeURIComponent(`
25
25
  export async function resolve(specifier, context, next) {
26
+ if (['pxmodel', 'optimize', 'look', 'lookbake'].some((m) => specifier === '@imports/castle.physics-3d/engine3d/' + m)) return { url: ${JSON.stringify(new URL('./fixtures/engine-models-stub.mjs', import.meta.url).href)}, shortCircuit: true };
27
+ if (specifier === '@imports/castle.physics-3d/engine3d/orbitlens.js') return { url: ${JSON.stringify(new URL('../../physics-3d/engine3d/orbitlens.js', import.meta.url).href)}, shortCircuit: true };
26
28
  if (specifier === '@imports/castle.multiplayer-3d/code/server/sceneBodies.js') {
27
29
  return { url: ${url(sceneStub)}, shortCircuit: true };
28
30
  }
@@ -0,0 +1,198 @@
1
+ // v1.71: virtual companion privacy over the real hub and NPC paths.
2
+ import assert from 'node:assert/strict';
3
+ import { register } from 'node:module';
4
+ import { readFileSync } from 'node:fs';
5
+ register(`data:text/javascript,${encodeURIComponent(`
6
+ export async function resolve(specifier, context, next) {
7
+ if (specifier === '@imports/castle.multiplayer-3d/code/server/sceneBodies.js') return { url: 'data:text/javascript,export const readScene = () => globalThis.__companionChatActors;', shortCircuit: true };
8
+ if (context.parentURL?.includes('/kits/base/sdk/') && specifier.startsWith('.') && !specifier.endsWith('.js')) return next(specifier + '.js', context);
9
+ return next(specifier, context);
10
+ }
11
+ `)}`);
12
+ const { layer } = await import('../code/server/hub.js');
13
+ const { makeNpcs } = await import('../code/server/npcs.js');
14
+ const { readManifest, publicPlace } = await import('../code/server/manifest.js');
15
+ const declaration = { chat: { character: 'companion', name: 'Chirp' } };
16
+ const bundle = { characters: [{ id: 'companion' }, { id: 'greeter' }], conversation: { version: 1, authority: 'server', maxListeners: 0 } };
17
+ const players = [{ playerId: 'p1', userId: '101', username: 'Ada' }, { playerId: 'p2', userId: '102', username: 'Bo' }];
18
+ const json = (companion = declaration, extra = {}) => ({ server: { maxPlayers: 8 }, characterBundle: bundle, hub: { contract: 1, title: 'Town', npcs: { turnsPerMinute: 1 }, companion, ...extra } });
19
+ const secret = (kind, owner = 'p1') => `private:${kind}:${owner}`;
20
+ let passed = 0;
21
+ async function test(name, fn) { await fn(); passed++; console.log(`ok: ${name}`); }
22
+ function turn(playerId, operationId, options = {}) {
23
+ return { speaker: { playerId }, operationId, characterId: 'companion', input: 'question', audience: { disclosure: 'participants', characterIds: [], players: [] }, rejected: null, sent: false,
24
+ reject(code) { this.rejected = code; }, async send(args) { this.sent = true; this.args = args; }, ...options };
25
+ }
26
+ function read(playerId, query, result) {
27
+ return { speaker: { playerId }, query, reject(code) { throw new Error(code); }, async read() { return result; } };
28
+ }
29
+ function npcRig({ chat = true, mind = true, opening = true } = {}) {
30
+ const sent = [], labels = [], hooksCalled = [];
31
+ const h = { actors: [], sim: { timeMs: 0, bodies: new Map(), players: new Map(players.map((p, i) => [p.playerId, { at: { x: i * 100, y: 1, z: 0 } }])) }, players: new Map(players.map((p) => [p.playerId, { arrived: true, ended: false }])), session: { players, characters: mind ? { publicInspect() { throw new Error('virtual followed'); } } : null }, place: { companion: true, npcs: { turnsPerMinute: 1 }, ...(chat ? { companionChat: declaration.chat } : {}) }, hooks: {} };
32
+ const hook = (kind, value) => (_ctx, npc, owner) => { hooksCalled.push([kind, npc, owner]); return typeof value === 'function' ? value(npc, owner) : value; };
33
+ h.hooks = {
34
+ ...(opening ? { npcOpening: hook('opening', (_npc, owner) => ({ text: secret('opening', owner), asks: ['Where next?'] })) } : {}),
35
+ npcContext: hook('context', (_npc, owner) => secret('notes', owner)),
36
+ npcLine: (_ctx, npc, owner, info) => { hooksCalled.push(['line', npc, owner]); return secret(info.why, owner); },
37
+ npcHeard: hook('heard'),
38
+ npcTools: hook('tools', [{ name: 'whereIs', description: 'Find a place', input_schema: { type: 'object' } }]),
39
+ npcTool: hook('tool', (_npc, owner) => ({ text: secret('tool', owner) })),
40
+ npcReact() { throw new Error('virtual reacted'); },
41
+ };
42
+ h.ctx = { send: (id, msg) => sent.push([id, structuredClone(msg)]), npc: (id) => h.npcs.handle(id), username: (id) => id };
43
+ h.npcLabel = (...args) => labels.push(args);
44
+ h.npcs = makeNpcs(h); h.npcs.ready();
45
+ const message = (id, k, data = {}) => h.npcs.message({ playerId: id }, { k, npc: `companion:${id}`, ...data });
46
+ const prefix = (owner = 'p1') => sent.findLast(([id, msg]) => id === owner && msg.k === 'hub-npc-notes')?.[1].prefix ?? '';
47
+ const tick = (ms = 100) => { h.sim.timeMs += ms; h.npcs.place(ms / 1000); };
48
+ const privateOnly = () => {
49
+ assert.deepEqual(labels, []);
50
+ for (const [id, msg] of sent.filter(([, msg]) => msg.open || ['hub-npc-opening', 'hub-npc-line', 'hub-npc-notes'].includes(msg.k))) assert.equal(msg.npc, `companion:${id}`);
51
+ for (const [id, msg] of sent) {
52
+ if (JSON.stringify(msg).includes('private:')) {
53
+ assert.equal(msg.npc, `companion:${id}`);
54
+ assert(!JSON.stringify(msg).includes(`:p${id === 'p1' ? '2' : '1'}`));
55
+ }
56
+ }
57
+ };
58
+ return { h, sent, labels, hooksCalled, npcs: h.npcs, message, prefix, tick, privateOnly };
59
+ }
60
+ await test('manifest object validates nesting, bundle id, name and mind configuration', () => {
61
+ const ok = readManifest(json()); assert.deepEqual(ok.errors, []);
62
+ const place = ok.manifest.places.main;
63
+ assert.equal(place.companion, true); assert.deepEqual(place.companionChat, declaration.chat);
64
+ assert.deepEqual(publicPlace('main', place).companionChat, { name: 'Chirp' });
65
+ for (const companion of [{ other: true, ...declaration }, { chat: { ...declaration.chat, extra: true } }, {}, { chat: null }, { chat: [] }, { chat: { character: '', name: 'Chirp' } }, { chat: { character: 'absent', name: 'Chirp' } }, { chat: { character: 'companion', name: '' } }, { chat: { character: 'companion', name: ' ' } }, ...['x'.repeat(25), 'a\nb', 'a\u0085b'].map((name) => ({ chat: { character: 'companion', name } }))]) {
66
+ assert(readManifest(json(companion)).errors.some((e) => e.includes('.companion')), JSON.stringify(companion));
67
+ }
68
+ for (const character of ['x'.repeat(101), '😀'.repeat(33), 'bad\0id', '\ud800']) {
69
+ const invalid = json({ chat: { character, name: 'Chirp' } }); invalid.characterBundle = { ...bundle, characters: [{ id: character }] };
70
+ assert(readManifest(invalid).errors.some((e) => e.includes('.companion.chat.character')));
71
+ }
72
+ const unusual = 'friendly_bird-1.0'; const valid = json({ chat: { character: unusual, name: 'Chirp' } }); valid.characterBundle = { ...bundle, characters: [{ id: unusual }] };
73
+ assert.deepEqual(readManifest(valid).errors, []);
74
+ assert(readManifest(json(declaration, { npcs: undefined })).errors.some((e) => e.includes('mind slot')));
75
+ assert.equal(readManifest(json({ chat: { character: 'companion', name: '😀'.repeat(24) } })).errors.length, 0);
76
+ const named = readManifest(json(true, { places: { garden: { title: 'Garden', scene: 'scenes/garden.scene', npcs: {}, companion: declaration } } }));
77
+ assert.deepEqual(named.errors, []); assert.deepEqual(named.manifest.places.garden.companionChat, declaration.chat);
78
+ assert(!Object.hasOwn(named.manifest.places.main, 'companionChat'));
79
+ });
80
+ await test('owner-only lazy open; foreign, malformed, absent-chat and not-arrived all look unknown', () => {
81
+ const r = npcRig();
82
+ assert.equal(r.npcs.handle('companion:p1'), null);
83
+ const refused = (id, npc) => { r.message(id, 'hub-npc-open', { npc }); const [target, result] = r.sent.at(-1); assert.equal(target, id); return { ...result, npc: '<id>' }; };
84
+ const unknown = refused('p2', 'unknown');
85
+ for (const npc of ['companion:p1', 'companion:', 'companion:p2:extra', 'companion:p2\0', {}, null]) assert.deepEqual(refused('p2', npc), unknown);
86
+ r.h.players.get('p1').arrived = false; assert.deepEqual(refused('p1', 'companion:p1'), unknown); assert.equal(r.npcs.handle('companion:p1'), null);
87
+ r.h.players.get('p1').arrived = true; r.message('p1', 'hub-npc-open');
88
+ assert(r.sent.some(([id, msg]) => id === 'p1' && msg.open === true));
89
+ assert.deepEqual(refused('p2', 'companion:p1'), unknown);
90
+ assert.equal(r.npcs.handle('companion:p1').talkingTo, 'p1');
91
+ const noChat = npcRig({ chat: false }); noChat.message('p1', 'hub-npc-open');
92
+ assert.deepEqual({ ...noChat.sent.at(-1)[1], npc: '<id>' }, unknown);
93
+ assert.equal(noChat.npcs.handle('companion:p1'), null); r.privateOnly();
94
+ });
95
+ await test('hook handle follows owner position; no body, public list, labels, movement, reactions or greetings', async () => {
96
+ const r = npcRig(); r.message('p1', 'hub-npc-open'); const npc = r.npcs.handle('companion:p1');
97
+ assert.deepEqual(npc.props, { role: 'companion', name: 'Chirp', character: 'companion' }); assert.equal(npc.owner, 'p1'); assert.equal(npc.busy, false); assert.deepEqual(r.npcs.list(), []);
98
+ r.h.sim.players.get('p1').at = { x: 500, y: 2, z: 400 }; assert.deepEqual(npc.at, { x: 500, y: 2, z: 400 });
99
+ npc.say(secret('say'), { to: ['p2'] }); npc.face('p2'); npc.walkTo({ x: 1, z: 2 }); npc.home(); npc.follow('p2'); npc.stop();
100
+ assert.equal(npc.walking, false); assert.equal(npc.following, null); r.npcs.react('p1', 'wave'); r.tick();
101
+ assert.deepEqual(r.npcs.emoteFields(), {});
102
+ await r.npcs.onRead(read('p1', { type: 'inspect' }, { participantId: 'u1', characters: [{ characterId: 'companion', privateState: { nextGreeting: { text: secret('greeting') } } }] }));
103
+ assert(!r.sent.some(([, msg]) => msg.k === 'hub-npc-opening'));
104
+ r.privateOnly();
105
+ for (const [, handle, owner] of r.hooksCalled) { assert.equal(handle.id, `companion:${owner}`); assert.equal(handle.busy, false); }
106
+ });
107
+ await test('authored opening, hello, scripted answer and no-op say have no public speech path', () => {
108
+ for (const opening of [true, false]) {
109
+ const r = npcRig({ mind: false, opening }); r.message('p1', 'hub-npc-open');
110
+ r.message('p2', 'hub-npc-say', { npc: 'companion:p1', text: 'intruder' });
111
+ r.message('p1', 'hub-npc-say', { text: secret('input'), rid: 'rid' });
112
+ assert(r.sent.some(([id, msg]) => id === 'p1' && msg.k === 'hub-npc-line' && msg.text === secret('authored') && msg.rid === 'rid'));
113
+ assert(r.sent.every(([id]) => id === 'p1'));
114
+ assert(r.sent.some(([, msg]) => opening ? msg.opening?.text === secret('opening') : msg.text === secret('hello')));
115
+ r.privateOnly();
116
+ }
117
+ });
118
+ await test('same character, per-owner pending/budget, notes, heard and one tool lookup; mind replies stay private', async () => {
119
+ const r = npcRig(); for (const id of ['p1', 'p2']) r.message(id, 'hub-npc-open');
120
+ const a = turn('p1', 'a', { input: r.prefix() + secret('input') }); await r.npcs.onTurn(a); assert(a.sent);
121
+ const busy = turn('p1', 'busy', { input: r.prefix() + 'next' }); await r.npcs.onTurn(busy); assert.equal(busy.rejected, 'HUB_NPC_BUSY');
122
+ const b = turn('p2', 'b', { input: r.prefix('p2') + 'other' }); await r.npcs.onTurn(b); assert(b.sent);
123
+ const tool = { operationId: 'a', characterId: 'companion', playerId: 'p1', name: 'whereIs', input: {} };
124
+ assert.deepEqual(await r.npcs.onTool({ ...tool, playerId: 'p2' }), { error: 'not available' });
125
+ assert.deepEqual(await r.npcs.onTool(tool), { text: secret('tool') }); assert.deepEqual(await r.npcs.onTool(tool), { error: 'not available' });
126
+ await r.npcs.onRead(read('p2', { type: 'status', operationId: 'a' }, { status: 'completed', response: secret('mind') }));
127
+ const stillBusy = turn('p1', 'still-busy', { input: r.prefix() + 'next' }); await r.npcs.onTurn(stillBusy); assert.equal(stillBusy.rejected, 'HUB_NPC_BUSY');
128
+ await r.npcs.onRead(read('p1', { type: 'status', operationId: 'a' }, { status: 'completed', response: secret('mind') }));
129
+ const budget = turn('p1', 'budget', { input: r.prefix() + 'next' }); await r.npcs.onTurn(budget); assert.equal(budget.rejected, 'HUB_NPC_BUDGET');
130
+ assert(r.sent.some(([id, msg]) => id === 'p1' && msg.text === secret('busy'))); assert(r.sent.some(([id, msg]) => id === 'p1' && msg.text === secret('budget')));
131
+ assert.deepEqual(r.hooksCalled.filter(([kind]) => kind === 'heard').map(([, npc, id]) => [npc.id, id]), [['companion:p1', 'p1'], ['companion:p2', 'p2']]);
132
+ r.privateOnly();
133
+ });
134
+ await test('ghost busy/budget/unavailable refusals target the owner', async () => {
135
+ for (const [code, why] of [['CAULDRON_SHARED_CHARACTER_BUSY', 'busy'], ['CAULDRON_SHARED_CHARACTER_BUDGET', 'budget'], ['OTHER', 'unavailable']]) {
136
+ const r = npcRig(); r.message('p1', 'hub-npc-open');
137
+ const t = turn('p1', code, { input: r.prefix() + 'question', async send() { throw Object.assign(new Error(), { code }); } });
138
+ await assert.rejects(r.npcs.onTurn(t)); assert.equal(r.sent.at(-1)[1].text, secret(why)); assert(r.sent.every(([id]) => id === 'p1')); r.privateOnly();
139
+ }
140
+ });
141
+ await test('idle/gone end; leave/prune drop record, met, turns and in-flight admission', async () => {
142
+ const r = npcRig(); r.message('p1', 'hub-npc-open'); r.tick(90001); assert.equal(r.sent.at(-1)[1].why, 'idle');
143
+ r.message('p1', 'hub-npc-open'); const t = turn('p1', 'late', { input: r.prefix() + 'question' }); let finish;
144
+ t.send = () => new Promise((resolve) => { finish = resolve; }); const pending = r.npcs.onTurn(t);
145
+ r.npcs.leave('p1'); assert.equal(r.npcs.handle('companion:p1'), null); assert.equal(r.npcs.metCount('companion:p1'), 0);
146
+ finish(); await pending; const count = r.sent.length;
147
+ await r.npcs.onRead(read('p1', { type: 'status', operationId: 'late' }, { status: 'completed', response: secret('late') })); assert.equal(r.sent.length, count);
148
+ r.message('p1', 'hub-npc-open'); r.h.sim.players.delete('p1'); r.tick(); assert.equal(r.npcs.handle('companion:p1'), null); assert.equal(r.sent.at(-1)[1].why, 'left'); r.privateOnly();
149
+ });
150
+ function hubRig(companion = declaration, implementation = layer, mind = true) {
151
+ const sent = []; let hub;
152
+ globalThis.__companionChatActors = [{ id: 'player', components: { Player: {}, Transform: { x: 0, y: 1, z: 0 } } }];
153
+ const hooks = { ready(ctx) { hub = ctx; }, npcOpening(_ctx, _npc, id) { return secret('opening', id); }, npcLine(_ctx, _npc, id, info) { return secret(info.why, id); } };
154
+ const server = implementation(json(companion), hooks, {}, () => true, () => null, null, { createBody() { return { setEnabled() {}, setNextKinematicTranslation() {}, setNextKinematicRotation() {} }; } });
155
+ const session = { sessionId: 'dev', players: [...players], characters: mind ? {} : null, send(id, msg) { sent.push([id, structuredClone(msg)]); }, broadcast(msg) { sent.push(['all', structuredClone(msg)]); } };
156
+ const world = { timeMs: 0, scenePath: 'scenes/main.scene', objects: new Map(), bodies: new Map(), players: new Map(players.map((p) => [p.playerId, { at: { x: 0, y: 1, z: 0 }, facing: 0, body: { setTranslation() {} } }])) };
157
+ server.sceneFor(session); server.ready(world);
158
+ const say = (id, msg) => server.message(session, { playerId: id }, msg);
159
+ for (const p of players) say(p.playerId, { k: 'hub-hello', avatar: 0, party: 2 }); server.place(world);
160
+ const tick = () => { world.timeMs += 250; server.place(world); server.step(world, []); };
161
+ return { server, session, world, hub, sent, say, tick };
162
+ }
163
+ await test('real hub snapshot/delta/labels carry no virtual words; leave forgets the handle', () => {
164
+ const r = hubRig(declaration, layer, false); r.hub.companion('p1', { look: 'bird' }); r.tick(); r.server.delta(); r.sent.length = 0;
165
+ r.say('p1', { k: 'hub-npc-open', npc: 'companion:p1' }); r.say('p1', { k: 'hub-npc-say', npc: 'companion:p1', text: secret('input') });
166
+ assert(r.sent.every(([id]) => id === 'p1')); assert.deepEqual(r.hub.npcs(), []);
167
+ for (const state of [r.server.join(), r.server.delta()]) { const wire = JSON.stringify(state); assert(!wire.includes('private:')); assert(!wire.includes('companion:p1')); }
168
+ r.session.players = [players[1]]; r.world.players.delete('p1'); r.tick(); assert.equal(r.hub.npc('companion:p1'), null);
169
+ });
170
+ await test('real hub mind open, pending refusal and host status reply send only to the owner', async () => {
171
+ const r = hubRig(); r.hub.companion('p1', { look: 'bird' }); r.tick(); r.server.delta(); r.sent.length = 0;
172
+ r.say('p1', { k: 'hub-npc-open', npc: 'companion:p1' });
173
+ const t = turn('p1', 'mind'); await r.server.worldCharacters.onWorldCharacterTurn(r.session, t); assert(t.sent);
174
+ const busy = turn('p1', 'busy'); await r.server.worldCharacters.onWorldCharacterTurn(r.session, busy); assert.equal(busy.rejected, 'HUB_NPC_BUSY');
175
+ const status = read('p1', { type: 'status', operationId: 'mind' }, { status: 'completed', response: secret('mind') });
176
+ // The host returns a read on its requesting speaker's connection, as in
177
+ // production. The kit must neither broadcast nor add a label for that reply.
178
+ const hostRead = status.read.bind(status);
179
+ status.read = async () => { const answer = await hostRead(); r.session.send(status.speaker.playerId, { k: 'test-host-status', ...answer }); return answer; };
180
+ await r.server.worldCharacters.onWorldCharacterRead(r.session, status);
181
+ const budget = turn('p1', 'budget'); await r.server.worldCharacters.onWorldCharacterTurn(r.session, budget); assert.equal(budget.rejected, 'HUB_NPC_BUDGET');
182
+ assert(r.sent.every(([id]) => id === 'p1')); assert(r.sent.some(([, msg]) => msg.response === secret('mind')));
183
+ assert(r.sent.some(([, msg]) => msg.text === secret('busy'))); assert(r.sent.some(([, msg]) => msg.text === secret('budget')));
184
+ for (const state of [r.server.join(), r.server.delta()]) assert(!JSON.stringify(state).includes('private:'));
185
+ });
186
+ await test('follower-only true is byte-identical to the captured wire before this task', () => {
187
+ const trace = (implementation, dress) => {
188
+ const r = hubRig(true, implementation); const states = [r.server.join(), r.server.delta()];
189
+ r.hub.companion('p1', { look: 'bird', say: 'Follow me', ...(dress ? { dress } : {}) }); r.tick(); states.push(r.server.join(), r.server.delta());
190
+ r.say('p1', { k: 'hub-npc-open', npc: 'companion:p1' }); r.say('p1', { k: 'hub-npc-say', npc: 'companion:p1', text: 'question' }); r.tick(); states.push(r.server.join(), r.server.delta());
191
+ assert.equal(r.hub.npc('companion:p1'), null);
192
+ return JSON.stringify({ sent: r.sent, states });
193
+ };
194
+ // Captured with the pre-chat npcs.js from HEAD, after the follower half.
195
+ const captured = readFileSync(new URL('./companion-follower-wire.json', import.meta.url), 'utf8').trim();
196
+ for (const dress of [undefined, {}, { species: 'songbird' }]) { assert.equal(trace(layer, dress), captured); }
197
+ });
198
+ console.log(`${passed} companion chat tests passed`);