castle-web-cli 0.4.232 → 0.4.234

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (587) hide show
  1. package/dist/agent-failures.d.ts +8 -0
  2. package/dist/agent-failures.js +19 -2
  3. package/dist/agent-prompts.d.ts +1 -1
  4. package/dist/agent-prompts.js +10 -3
  5. package/dist/agent.d.ts +64 -3
  6. package/dist/agent.js +170 -81
  7. package/dist/api.d.ts +11 -0
  8. package/dist/api.js +43 -0
  9. package/dist/bundle.d.ts +64 -0
  10. package/dist/bundle.js +558 -2
  11. package/dist/castle-host/host.d.ts +18 -2
  12. package/dist/castle-host/host.js +844 -39
  13. package/dist/castleJson.d.ts +23 -2
  14. package/dist/castleJson.js +46 -2
  15. package/dist/check.d.ts +3 -1
  16. package/dist/check.js +20 -3
  17. package/dist/chunkLoader.d.ts +3 -0
  18. package/dist/chunkLoader.js +111 -0
  19. package/dist/devParty.d.ts +26 -0
  20. package/dist/devParty.js +231 -0
  21. package/dist/devSaveStorage.js +4 -0
  22. package/dist/devSessionStorage.js +50 -2
  23. package/dist/devSocial.d.ts +24 -0
  24. package/dist/devSocial.js +70 -0
  25. package/dist/ide.d.ts +2 -0
  26. package/dist/ide.js +119 -15
  27. package/dist/importPinMismatch.d.ts +22 -0
  28. package/dist/importPinMismatch.js +77 -0
  29. package/dist/importRegression.js +3 -15
  30. package/dist/imports.d.ts +10 -3
  31. package/dist/imports.js +88 -20
  32. package/dist/index.js +11 -4
  33. package/dist/init.js +1 -1
  34. package/dist/platformDoc.js +22 -0
  35. package/dist/routerFences.d.ts +5 -0
  36. package/dist/routerFences.js +12 -2
  37. package/dist/save-deck.d.ts +25 -1
  38. package/dist/save-deck.js +178 -9
  39. package/dist/serve.js +32 -11
  40. package/dist/shell/assets/{index-D2tWM896.js → index-DulbYIJm.js} +97 -97
  41. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  42. package/dist/shell/index.html +2 -2
  43. package/dist/taskSteer.d.ts +13 -0
  44. package/dist/taskSteer.js +22 -2
  45. package/dist/vitePlugins.d.ts +2 -1
  46. package/dist/vitePlugins.js +13 -0
  47. package/kits/base/castle.json +1 -1
  48. package/kits/base/package-lock.json +1 -1
  49. package/kits/base/sdk/README.md +339 -5
  50. package/kits/base/sdk/avatar.d.ts +6 -2
  51. package/kits/base/sdk/avatar.js +12 -4
  52. package/kits/base/sdk/castle.d.ts +7 -3
  53. package/kits/base/sdk/castle.js +2 -0
  54. package/kits/base/sdk/commands.d.ts +176 -1
  55. package/kits/base/sdk/commands.js +3 -0
  56. package/kits/base/sdk/display.d.ts +3 -0
  57. package/kits/base/sdk/display.js +9 -3
  58. package/kits/base/sdk/hub.d.ts +37 -6
  59. package/kits/base/sdk/hub.js +63 -4
  60. package/kits/base/sdk/multiplayer.d.ts +7 -1
  61. package/kits/base/sdk/multiplayer.js +148 -32
  62. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  63. package/kits/base/sdk/party.d.ts +23 -0
  64. package/kits/base/sdk/party.js +91 -0
  65. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  66. package/kits/base/sdk/reconnectBudget.js +96 -0
  67. package/kits/base/sdk/save.d.ts +38 -1
  68. package/kits/base/sdk/save.js +81 -7
  69. package/kits/base/sdk/server/hub.d.ts +117 -0
  70. package/kits/base/sdk/server/hub.js +119 -2
  71. package/kits/base/sdk/server/platformHandle.d.ts +43 -1
  72. package/kits/base/sdk/server/storage.d.ts +17 -0
  73. package/kits/base/sdk/server/storage.js +65 -3
  74. package/kits/base/sdk/server/wrapper.d.ts +43 -6
  75. package/kits/base/sdk/server/wrapper.js +93 -9
  76. package/kits/base/sdk/social.d.ts +9 -0
  77. package/kits/base/sdk/social.js +5 -0
  78. package/kits/hub-game/CLAUDE.md +451 -13
  79. package/kits/hub-game/README.md +63 -0
  80. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  81. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  82. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  83. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  84. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  85. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  86. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  87. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  88. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  89. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  90. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  91. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  92. package/kits/hub-game/castle.json +5 -5
  93. package/kits/hub-game/code/client/act.js +312 -0
  94. package/kits/hub-game/code/client/actionLayout.js +147 -0
  95. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  96. package/kits/hub-game/code/client/actorBudget.js +47 -0
  97. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  98. package/kits/hub-game/code/client/askSlot.js +117 -0
  99. package/kits/hub-game/code/client/attention.js +11 -2
  100. package/kits/hub-game/code/client/avatar.js +311 -35
  101. package/kits/hub-game/code/client/avatarCap.js +228 -0
  102. package/kits/hub-game/code/client/avatarColors.js +70 -0
  103. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  104. package/kits/hub-game/code/client/avatarShare.js +253 -0
  105. package/kits/hub-game/code/client/backVisibility.js +13 -0
  106. package/kits/hub-game/code/client/ballot.js +472 -0
  107. package/kits/hub-game/code/client/build.js +38 -0
  108. package/kits/hub-game/code/client/chat.js +41 -5
  109. package/kits/hub-game/code/client/chatModeration.js +5 -0
  110. package/kits/hub-game/code/client/chrome.js +2144 -160
  111. package/kits/hub-game/code/client/companion.js +716 -0
  112. package/kits/hub-game/code/client/companionDress.js +99 -0
  113. package/kits/hub-game/code/client/crowdNames.js +241 -0
  114. package/kits/hub-game/code/client/decor.js +515 -0
  115. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  116. package/kits/hub-game/code/client/doorErrors.js +39 -0
  117. package/kits/hub-game/code/client/earned.js +131 -0
  118. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  119. package/kits/hub-game/code/client/fall.js +18 -0
  120. package/kits/hub-game/code/client/farAvatars.js +233 -0
  121. package/kits/hub-game/code/client/firstJoin.js +9 -2
  122. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  123. package/kits/hub-game/code/client/frameBatch.js +5 -0
  124. package/kits/hub-game/code/client/grab.js +368 -29
  125. package/kits/hub-game/code/client/hookLayer.js +385 -20
  126. package/kits/hub-game/code/client/hudCopy.js +51 -0
  127. package/kits/hub-game/code/client/hudRate.js +20 -0
  128. package/kits/hub-game/code/client/idle.js +177 -24
  129. package/kits/hub-game/code/client/interestCap.js +81 -0
  130. package/kits/hub-game/code/client/invites.js +231 -0
  131. package/kits/hub-game/code/client/joinError.js +9 -0
  132. package/kits/hub-game/code/client/keys.js +36 -0
  133. package/kits/hub-game/code/client/labelsNear.js +234 -0
  134. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  135. package/kits/hub-game/code/client/layoutCache.js +264 -0
  136. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  137. package/kits/hub-game/code/client/loadingCover.js +148 -0
  138. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  139. package/kits/hub-game/code/client/menuIcons.js +34 -0
  140. package/kits/hub-game/code/client/menuRows.js +43 -0
  141. package/kits/hub-game/code/client/modelReady.js +7 -0
  142. package/kits/hub-game/code/client/pack.js +6 -2
  143. package/kits/hub-game/code/client/packFormat.js +3 -3
  144. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  145. package/kits/hub-game/code/client/padCues.js +112 -0
  146. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  147. package/kits/hub-game/code/client/padReadability.js +26 -0
  148. package/kits/hub-game/code/client/padRings.js +69 -0
  149. package/kits/hub-game/code/client/pushVisit.js +14 -0
  150. package/kits/hub-game/code/client/quality.js +205 -0
  151. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  152. package/kits/hub-game/code/client/rehello.js +167 -0
  153. package/kits/hub-game/code/client/safeLayout.js +338 -0
  154. package/kits/hub-game/code/client/safeStyle.js +42 -0
  155. package/kits/hub-game/code/client/say.js +12 -3
  156. package/kits/hub-game/code/client/shot.js +146 -0
  157. package/kits/hub-game/code/client/shotFit.js +56 -0
  158. package/kits/hub-game/code/client/signIn.js +28 -0
  159. package/kits/hub-game/code/client/sound.js +63 -8
  160. package/kits/hub-game/code/client/soundscape.js +1151 -0
  161. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  162. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  163. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  164. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  165. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  166. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  167. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  168. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  169. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  170. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  171. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  172. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  173. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  174. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  175. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  176. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  177. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  178. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  179. package/kits/hub-game/code/client/spin.js +101 -0
  180. package/kits/hub-game/code/client/state.js +162 -1
  181. package/kits/hub-game/code/client/stuck.js +259 -0
  182. package/kits/hub-game/code/client/talk.js +714 -59
  183. package/kits/hub-game/code/client/tiers.js +543 -52
  184. package/kits/hub-game/code/client/toastBand.js +37 -0
  185. package/kits/hub-game/code/client/together.js +39 -2
  186. package/kits/hub-game/code/client/visibility.js +43 -0
  187. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  188. package/kits/hub-game/code/client/weakestTier.js +295 -0
  189. package/kits/hub-game/code/client/wear.js +461 -170
  190. package/kits/hub-game/code/client/worldLabels.js +241 -0
  191. package/kits/hub-game/code/client/yours.js +200 -0
  192. package/kits/hub-game/code/companionSpec.js +45 -0
  193. package/kits/hub-game/code/npcDisplayText.js +55 -0
  194. package/kits/hub-game/code/privateText.js +7 -0
  195. package/kits/hub-game/code/server/act.js +124 -0
  196. package/kits/hub-game/code/server/actions.js +138 -0
  197. package/kits/hub-game/code/server/actors.js +11 -2
  198. package/kits/hub-game/code/server/analytics.js +83 -0
  199. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  200. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  201. package/kits/hub-game/code/server/ask.js +155 -0
  202. package/kits/hub-game/code/server/ballot.js +539 -0
  203. package/kits/hub-game/code/server/cells.js +100 -0
  204. package/kits/hub-game/code/server/companion.js +107 -0
  205. package/kits/hub-game/code/server/cues.js +70 -0
  206. package/kits/hub-game/code/server/decor.js +269 -0
  207. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  208. package/kits/hub-game/code/server/earned.js +478 -0
  209. package/kits/hub-game/code/server/frameBatch.js +183 -0
  210. package/kits/hub-game/code/server/friendBests.js +166 -0
  211. package/kits/hub-game/code/server/friendsAmong.js +272 -0
  212. package/kits/hub-game/code/server/history.js +7 -0
  213. package/kits/hub-game/code/server/hub.js +2510 -95
  214. package/kits/hub-game/code/server/idle.js +60 -12
  215. package/kits/hub-game/code/server/index.js +28 -6
  216. package/kits/hub-game/code/server/invites.js +19 -0
  217. package/kits/hub-game/code/server/labels.js +36 -2
  218. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  219. package/kits/hub-game/code/server/manifest.js +586 -7
  220. package/kits/hub-game/code/server/menu.js +161 -0
  221. package/kits/hub-game/code/server/npcs.js +1025 -113
  222. package/kits/hub-game/code/server/observe.js +408 -0
  223. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  224. package/kits/hub-game/code/server/party.js +2 -2
  225. package/kits/hub-game/code/server/players.js +30 -0
  226. package/kits/hub-game/code/server/resumePose.js +152 -0
  227. package/kits/hub-game/code/server/say.js +1 -1
  228. package/kits/hub-game/code/server/shot.js +110 -0
  229. package/kits/hub-game/code/server/standing.js +123 -0
  230. package/kits/hub-game/code/server/storageLimit.js +187 -0
  231. package/kits/hub-game/code/server/vis.js +175 -0
  232. package/kits/hub-game/code/server/wear.js +12 -0
  233. package/kits/hub-game/code/server/yours.js +59 -0
  234. package/kits/hub-game/code/shared/act.js +35 -0
  235. package/kits/hub-game/code/shared/cues.js +9 -0
  236. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  237. package/kits/hub-game/code/shared/decor.js +41 -0
  238. package/kits/hub-game/code/shared/loadStages.js +12 -0
  239. package/kits/hub-game/code/shared/quality.js +74 -0
  240. package/kits/hub-game/code/shared/say.js +2 -0
  241. package/kits/hub-game/code/shared/shot.js +53 -0
  242. package/kits/hub-game/code/shared/spin.js +57 -0
  243. package/kits/hub-game/code/systems/hub.js +1753 -202
  244. package/kits/hub-game/docs/analytics.md +279 -0
  245. package/kits/hub-game/docs/content-pack.md +1 -1
  246. package/kits/hub-game/docs/contract.md +3475 -77
  247. package/kits/hub-game/docs/home-pieces.md +71 -0
  248. package/kits/hub-game/docs/observed-progress.md +252 -0
  249. package/kits/hub-game/main.jsx +2 -0
  250. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  251. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  252. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  253. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  254. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  255. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  256. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  257. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  258. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  259. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  260. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  261. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  262. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  263. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  264. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  265. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  266. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  267. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  268. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  269. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  270. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  271. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  272. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  273. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  274. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  275. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  276. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  277. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  278. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  279. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  280. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  281. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  282. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  283. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  284. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  285. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  286. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  287. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  288. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  289. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  290. package/kits/hub-game/package-lock.json +10 -1
  291. package/kits/hub-game/package.json +6 -2
  292. package/kits/hub-game/play/player.js +142 -0
  293. package/kits/hub-game/play/registry.js +47 -0
  294. package/kits/hub-game/play.jsx +37 -0
  295. package/kits/hub-game/scripts/check.mjs +117 -16
  296. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  297. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +132 -0
  298. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  299. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +26 -0
  300. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +123 -0
  301. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  302. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  303. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  304. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  305. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  306. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  307. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  308. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  309. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  310. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  311. package/kits/hub-game/scripts/test-act.mjs +171 -0
  312. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  313. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  314. package/kits/hub-game/scripts/test-actions-client.mjs +853 -0
  315. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  316. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  317. package/kits/hub-game/scripts/test-actors.mjs +38 -23
  318. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  319. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  320. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  321. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  322. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  323. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  324. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  325. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  326. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  327. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  328. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  329. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  330. package/kits/hub-game/scripts/test-avatar-wire.mjs +792 -0
  331. package/kits/hub-game/scripts/test-avatar.mjs +584 -7
  332. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  333. package/kits/hub-game/scripts/test-ballot.mjs +1008 -0
  334. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  335. package/kits/hub-game/scripts/test-build.mjs +49 -0
  336. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  337. package/kits/hub-game/scripts/test-chat.mjs +863 -0
  338. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  339. package/kits/hub-game/scripts/test-companion-chat.mjs +216 -0
  340. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  341. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  342. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  343. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  344. package/kits/hub-game/scripts/test-decor-client.mjs +344 -0
  345. package/kits/hub-game/scripts/test-decor.mjs +464 -0
  346. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  347. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  348. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  349. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  350. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  351. package/kits/hub-game/scripts/test-earned.mjs +1224 -0
  352. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  353. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  354. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  355. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  356. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  357. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  358. package/kits/hub-game/scripts/test-grab-orbit.mjs +961 -0
  359. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  360. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  361. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  362. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  363. package/kits/hub-game/scripts/test-hub-ops.mjs +758 -2
  364. package/kits/hub-game/scripts/test-hub-trip.mjs +1594 -12
  365. package/kits/hub-game/scripts/test-hud-clear.mjs +484 -57
  366. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  367. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  368. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  369. package/kits/hub-game/scripts/test-idle.mjs +427 -1
  370. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  371. package/kits/hub-game/scripts/test-interest-cells.mjs +513 -0
  372. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  373. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  374. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  375. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  376. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  377. package/kits/hub-game/scripts/test-labels.mjs +664 -0
  378. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  379. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  380. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  381. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  382. package/kits/hub-game/scripts/test-manifest.mjs +472 -0
  383. package/kits/hub-game/scripts/test-menu-client.mjs +585 -0
  384. package/kits/hub-game/scripts/test-menu.mjs +319 -0
  385. package/kits/hub-game/scripts/test-npcs.mjs +2528 -13
  386. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  387. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  388. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  389. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  390. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  391. package/kits/hub-game/scripts/test-picker.mjs +541 -0
  392. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  393. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  394. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  395. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  396. package/kits/hub-game/scripts/test-rehello.mjs +1733 -0
  397. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  398. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  399. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  400. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  401. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  402. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  403. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  404. package/kits/hub-game/scripts/test-say.mjs +1 -1
  405. package/kits/hub-game/scripts/test-shot.mjs +901 -0
  406. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  407. package/kits/hub-game/scripts/test-soundscape.mjs +5437 -0
  408. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  409. package/kits/hub-game/scripts/test-standing.mjs +449 -0
  410. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  411. package/kits/hub-game/scripts/test-stuck.mjs +1904 -0
  412. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  413. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  414. package/kits/hub-game/scripts/test-tiers-render.mjs +412 -0
  415. package/kits/hub-game/scripts/test-tiers.mjs +476 -2
  416. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  417. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  418. package/kits/hub-game/scripts/test-vis.mjs +770 -0
  419. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  420. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  421. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  422. package/kits/hub-game/scripts/test-yours-chrome.mjs +210 -0
  423. package/kits/hub-game/scripts/test-yours.mjs +403 -0
  424. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  425. package/kits/multiplayer-3d/castle.json +5 -5
  426. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  427. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  428. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  429. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  430. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  431. package/kits/multiplayer-3d/code/options.js +5 -0
  432. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  433. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  434. package/kits/multiplayer-3d/code/server/world.js +7 -0
  435. package/kits/multiplayer-3d/code/systems/multiplayer.js +443 -34
  436. package/kits/multiplayer-3d/package-lock.json +8 -1
  437. package/kits/multiplayer-3d/package.json +3 -1
  438. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  439. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  440. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  441. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  442. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  443. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  444. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  445. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  446. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  447. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  448. package/kits/physics-2d/CLAUDE.md +19 -1
  449. package/kits/physics-2d/castle.json +2 -2
  450. package/kits/physics-2d/engine/frozenActors.js +233 -0
  451. package/kits/physics-2d/engine/scene.js +337 -3
  452. package/kits/physics-2d/engine/skyKey.js +129 -0
  453. package/kits/physics-2d/engine/stillClock.js +106 -0
  454. package/kits/physics-2d/engine/updateBudget.js +21 -0
  455. package/kits/physics-2d/eslint.config.js +1 -1
  456. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  457. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  458. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  459. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  460. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  461. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  462. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  463. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  464. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  465. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  466. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  467. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  468. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  469. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  470. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  471. package/kits/physics-3d/CLAUDE.md +42 -529
  472. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  473. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  474. package/kits/physics-3d/behaviors/Player.jsx +661 -87
  475. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  476. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  477. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  478. package/kits/physics-3d/castle.json +3 -3
  479. package/kits/physics-3d/docs/engine-camera.md +542 -0
  480. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  481. package/kits/physics-3d/docs/engine-load.md +149 -0
  482. package/kits/physics-3d/docs/engine-look.md +114 -0
  483. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  484. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  485. package/kits/physics-3d/docs/engine-sky.md +198 -0
  486. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  487. package/kits/physics-3d/docs/engine-view.md +37 -0
  488. package/kits/physics-3d/docs/pxmodel-format.md +9 -1
  489. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  490. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -277
  491. package/kits/physics-3d/engine3d/actornode.js +87 -0
  492. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  493. package/kits/physics-3d/engine3d/branches.js +3 -13
  494. package/kits/physics-3d/engine3d/cage.js +2 -7
  495. package/kits/physics-3d/engine3d/cageops.js +2 -17
  496. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  497. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  498. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  499. package/kits/physics-3d/engine3d/framecap.js +99 -0
  500. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  501. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  502. package/kits/physics-3d/engine3d/gait.js +126 -0
  503. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  504. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  505. package/kits/physics-3d/engine3d/look.js +514 -48
  506. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  507. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  508. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  509. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  510. package/kits/physics-3d/engine3d/modelready.js +16 -0
  511. package/kits/physics-3d/engine3d/motion.js +39 -10
  512. package/kits/physics-3d/engine3d/nearshadows.js +106 -21
  513. package/kits/physics-3d/engine3d/optimize.js +9 -5
  514. package/kits/physics-3d/engine3d/orbitinput.js +522 -10
  515. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  516. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  517. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  518. package/kits/physics-3d/engine3d/paths.js +1 -9
  519. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  520. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  521. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  522. package/kits/physics-3d/engine3d/rapier.js +27 -0
  523. package/kits/physics-3d/engine3d/scatter.js +1 -11
  524. package/kits/physics-3d/engine3d/shadowfade.js +890 -0
  525. package/kits/physics-3d/engine3d/sky.js +547 -0
  526. package/kits/physics-3d/engine3d/skylife.js +306 -0
  527. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  528. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  529. package/kits/physics-3d/engine3d/sweep.js +1 -25
  530. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  531. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  532. package/kits/physics-3d/engine3d/world3d.js +1253 -76
  533. package/kits/physics-3d/eslint.config.js +2 -1
  534. package/kits/physics-3d/main.jsx +10 -2
  535. package/kits/physics-3d/package-lock.json +7 -0
  536. package/kits/physics-3d/package.json +5 -1
  537. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  538. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  539. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  540. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  541. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  542. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  543. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  544. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  545. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  546. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  547. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  548. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  549. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  550. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  551. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  552. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2613 -82
  553. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +2 -2
  554. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  555. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +438 -0
  556. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  557. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  558. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  559. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  560. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  561. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  562. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  563. package/kits/physics-3d/scripts/test-near-shadows.mjs +5 -2
  564. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +2001 -0
  565. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +582 -0
  566. package/kits/physics-3d/scripts/test-orbit-shot.mjs +657 -0
  567. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  568. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  569. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  570. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  571. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  572. package/kits/physics-3d/scripts/test-static-actors.mjs +10 -1
  573. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  574. package/kits/physics-3d/scripts/test-static-scenery.mjs +2174 -0
  575. package/kits/physics-3d/scripts/test-steady-hover.mjs +7 -2
  576. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  577. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  578. package/kits/physics-3d/systems/physics3d.js +419 -9
  579. package/kits/real-time/castle.json +2 -2
  580. package/kits/real-time/code/client/connection.js +33 -10
  581. package/kits/real-time/code/client/gameHooks.js +2 -0
  582. package/kits/real-time/code/client/joinOverlay.js +9 -4
  583. package/kits/real-time/code/server/gameHooks.js +7 -0
  584. package/kits/real-time/code/server/session.js +102 -22
  585. package/kits/real-time/package-lock.json +1 -1
  586. package/package.json +2 -2
  587. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -1,6 +1,6 @@
1
1
  // Talking to a place's NPCs (contract §13), drawn by the hub chrome because a
2
2
  // Tier 0 game has no client code of its own. Near a `HubNpc` actor the player
3
- // gets a Talk button; the place's server decides whether the conversation
3
+ // gets a Chat or Talk button; the place's server decides whether the conversation
4
4
  // opens (one player per NPC at a time) and whether it goes to the character's
5
5
  // mind or to the place's authored lines.
6
6
  //
@@ -15,7 +15,13 @@
15
15
  // ahead of the player's words; the server admits only notes it issued, and the
16
16
  // player sees only their own words.
17
17
 
18
+ import { mindDue, talkActors } from './quality.js';
18
19
  import { hub } from './state.js';
20
+ import { npcDisplayText } from '../npcDisplayText.js';
21
+
22
+ // Product's words, exactly: a mind an under-13 speaker cannot type to (the
23
+ // server says so, `ageOff`; the client never infers an age).
24
+ export const under13Talk = (name) => `Talking with ${name} is for players 13 and up`;
19
25
 
20
26
  const TALK_RANGE_M = 3.5;
21
27
  const POLL_MS = 1200;
@@ -23,6 +29,18 @@ const POLL_LIMIT_MS = 90_000;
23
29
  const INPUT_MAX = 280;
24
30
  // A turn refused for stale notes is sent again once, with the newest.
25
31
  const NOTES_RETRY_MS = 400;
32
+ // The server silently drops authored words inside its 900 ms cooldown.
33
+ const AUTHORED_GAP_MS = 900;
34
+ const AUTHORED_WAIT_MS = 1200;
35
+ const ATTACH_WAIT_MS = 8000;
36
+ const INTERRUPTED_MS = 1800;
37
+ const INTERRUPTED_LINE = 'Lost the thread there. Tap to talk again.';
38
+ // A failed character read (inspect, greeting, status) holds the next inspect
39
+ // and greeting reads back, doubling to the cap; a turn's status poll gives up
40
+ // after this many failures.
41
+ export const READ_RETRY_MS = 5000;
42
+ const READ_RETRY_MAX_MS = 300_000;
43
+ const STATUS_FAILURES_MAX = 2;
26
44
  // Lines the place said because the mind was not answering, and how the panel
27
45
  // says so.
28
46
  const SCRIPTED = {
@@ -30,11 +48,11 @@ const SCRIPTED = {
30
48
  budget: 'has a crowd to answer',
31
49
  unavailable: "can't answer right now",
32
50
  };
33
-
34
- // The server strips a reply's wrapping quotes the same way for its bubble.
35
- const unquote = (text) => {
36
- const t = text.trim();
37
- return t.length > 1 && /^["“]/.test(t) && /["”]$/.test(t) ? t.slice(1, -1).trim() : t;
51
+ const REFUSAL_WHY = {
52
+ HUB_NPC_BUSY: 'busy',
53
+ HUB_NPC_BUDGET: 'budget',
54
+ CAULDRON_SHARED_CHARACTER_BUSY: 'busy',
55
+ CAULDRON_SHARED_CHARACTER_BUDGET: 'budget',
38
56
  };
39
57
 
40
58
  const newId = () => globalThis.crypto?.randomUUID?.() ?? `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 12)}`;
@@ -42,13 +60,29 @@ const newId = () => globalThis.crypto?.randomUUID?.() ?? `${Date.now().toString(
42
60
  export function makeTalk(chrome) {
43
61
  const t = {
44
62
  chrome,
45
- // { npc, name, mind, character, prefix } while a panel is open
63
+ // { npc, name, mind, character, prefix, canType, questions, sent } while open
46
64
  open: null,
47
65
  asking: null,
48
66
  net: null,
49
- // the nets whose participant this player has registered with an inspect read
67
+ // v1.46: only a successful inspect remembers permission to type.
50
68
  inspected: new WeakSet(),
69
+ // v1.47: approach starts one read; a refusal retries on a later open,
70
+ // once the read backoff has passed.
71
+ approached: new WeakSet(),
72
+ // This session's read backoff, logged failures, in-flight inspect
73
+ // (`session.inspecting`) and whether its last inspect was refused
74
+ // (`session.refused`); reset() starts anew.
75
+ session: {},
76
+ readFailures: 0,
77
+ readWait: null,
78
+ logged: new Set(),
79
+ // v1.76: ids only, consumed on approach or on opening that character.
80
+ hooks: new Map(),
81
+ greeted: new Set(),
51
82
  waiting: false,
83
+ saidAt: -Infinity,
84
+ drafts: new Map(),
85
+ abandonedOpens: new Set(),
52
86
  };
53
87
  chrome.onTalk({
54
88
  open: () => ask(t),
@@ -57,32 +91,189 @@ export function makeTalk(chrome) {
57
91
  });
58
92
  return {
59
93
  frame: (scene, mp, idle) => frame(t, scene, mp, idle),
94
+ openCompanion(scene) {
95
+ const companion = companionNpc(scene);
96
+ if (companion && !t.open && t.net === scene.multiplayer?.net) {
97
+ ask(t, companion);
98
+ }
99
+ },
100
+ prepare(id) {
101
+ if (t.asking || t.open || !t.net) {return;}
102
+ t.asking = id;
103
+ t.abandonedOpens.delete(id);
104
+ dropHook(t, id);
105
+ },
60
106
  typing: () => t.open !== null && chrome.talkFocused(),
61
107
  talking: () => t.open !== null,
108
+ talkingToCompanion: () => Boolean(hub.place?.companionChat && t.open?.npc === `companion:${t.net?.selfId?.()}`),
62
109
  // The NPC this player is talking with: its words are in the panel.
63
110
  talkingWith: () => t.open?.npc ?? null,
111
+ // A second WORLD under the same id restores the body, not its chat.
112
+ // Never replay a turn whose admission is unknown: only NOT_TALKING
113
+ // proves the server did not send it to the mind.
114
+ resume() {
115
+ if (t.open && !t.open.interrupted) {
116
+ t.open.needsAttach = true;
117
+ if (childChoices(t.open) && t.waiting) {
118
+ // A restored WORLD cannot settle the old connection's request.
119
+ // Invalidate its continuations; attach afresh without replaying it.
120
+ t.open.operationId = null;
121
+ t.open.recoveryOperationId = null;
122
+ t.open.pendingText = null;
123
+ t.waiting = false;
124
+ t.chrome.talkWaiting(false);
125
+ }
126
+ if (!t.waiting) {
127
+ void reattach(t, t.open);
128
+ }
129
+ }
130
+ },
131
+ // The same connection under another player id is another session, and the
132
+ // new one has no conversation with this player: words typed into the old
133
+ // panel would be refused there and never answered.
134
+ reset: () => reset(t),
64
135
  };
65
136
  }
66
137
 
138
+ // Whatever was being said belongs to the session it was said in.
139
+ function reset(t) {
140
+ // So do reads: another player id on the same net registers itself afresh.
141
+ if (t.net) {
142
+ t.inspected.delete(t.net);
143
+ t.approached.delete(t.net);
144
+ }
145
+ t.session = {};
146
+ clearTimeout(t.readWait);
147
+ t.readWait = null;
148
+ t.readFailures = 0;
149
+ t.logged.clear();
150
+ clearAuthored(t.open);
151
+ if (t.open?.attachment) {
152
+ t.abandonedOpens.add(t.open.npc);
153
+ }
154
+ cancelAttach(t.open);
155
+ cancelNotesWait(t.open);
156
+ clearTimeout(t.open?.closeTimer);
157
+ clearTimeout(t.open?.interruptionTimer);
158
+ t.open = null;
159
+ t.asking = null;
160
+ t.waiting = false;
161
+ t.saidAt = -Infinity;
162
+ t.hooks.clear();
163
+ t.greeted.clear();
164
+ t.drafts.clear();
165
+ t.near = null;
166
+ t.preferred = null;
167
+ t.chrome.closeTalk();
168
+ }
169
+
67
170
  function frame(t, scene, mp, idle) {
68
171
  const net = mp.net;
69
172
  if (net !== t.net) {
70
173
  // A session switch ends whatever was being said in the old one.
71
174
  t.net = net;
72
- t.open = null;
73
- t.asking = null;
74
- t.waiting = false;
75
- t.chrome.closeTalk();
175
+ reset(t);
76
176
  }
177
+ // The server sends panel events only to their speaker. A body may have
178
+ // other conversations; its ambient labels never open or close this panel.
77
179
  for (const msg of hub.npcEvents.splice(0)) {
78
- if (msg.k === 'hub-npc') {
180
+ if (msg.k === 'hub-npc-preferred') {
181
+ t.preferred = typeof msg.npc === 'string' ? msg.npc : null;
182
+ } else if (msg.k === 'hub-npc-hooks') {
183
+ for (const hook of Array.isArray(msg.hooks) ? msg.hooks : []) {
184
+ if (typeof hook?.npc === 'string' && typeof hook.character === 'string' && hook.character && !t.greeted.has(hook.character)) {
185
+ t.hooks.set(hook.npc, hook.character);
186
+ }
187
+ }
188
+ if (t.open) {
189
+ dropHook(t, t.open.npc, t.open.character);
190
+ }
191
+ } else if (msg.k === 'hub-npc') {
192
+ if (msg.open && t.abandonedOpens.has(msg.npc) && t.asking !== msg.npc) {
193
+ t.net.send({ k: 'hub-npc-end', npc: msg.npc });
194
+ continue;
195
+ }
196
+ if (t.open?.npc === msg.npc && t.open.interrupted) {
197
+ continue;
198
+ }
79
199
  if (msg.open) {
80
- t.open = { npc: msg.npc, name: msg.name, mind: Boolean(msg.mind), character: msg.character ?? null, prefix: null };
81
- t.chrome.openTalk(msg.name);
200
+ if (t.open?.npc === msg.npc && t.open.attachment) {
201
+ const open = t.open;
202
+ // Recovery cannot send private mind input down an authored/public
203
+ // path, or give an already-typed question to a different character.
204
+ if (open.mind !== Boolean(msg.mind) || open.character !== (msg.character ?? null)) {
205
+ interrupted(t, open);
206
+ continue;
207
+ }
208
+ open.prefix = null;
209
+ open.ageOff = msg.ageOff === true;
210
+ if (msg.choices !== undefined || open.choices !== undefined) {
211
+ open.choices = msg.choices === undefined ? undefined : choicesOf(msg.choices);
212
+ open.authoredChoices = msg.authoredChoices === true;
213
+ t.chrome.talkTyping(open.canType && open.choices === undefined);
214
+ }
215
+ open.questions = [...questionsOf(msg.opening?.asks), ...questionsOf(msg.opening?.more)];
216
+ delete open.persistentAsks;
217
+ delete open.withdrawnAsks;
218
+ open.needsAttach = false;
219
+ // A refused turn already counts this as its sole retry. An idle
220
+ // reconnect's open instead belongs to the next queued question.
221
+ open.reattached = !open.operationId;
222
+ t.asking = null;
223
+ open.attachment.opened = true;
224
+ // A body that required notes before the drop is not usable until
225
+ // its new notes arrive, even when the open is in an earlier frame.
226
+ // A prior no-note conversation uses bare words; the server sends
227
+ // no notes in that case.
228
+ if (!open.attachment.needsNotes) {
229
+ cancelAttach(open, true);
230
+ }
231
+ refill(t);
232
+ continue;
233
+ }
234
+ dropHook(t, msg.npc, msg.character);
235
+ clearAuthored(t.open);
236
+ cancelNotesWait(t.open);
237
+ t.waiting = false;
238
+ t.open = {
239
+ npc: msg.npc, name: msg.name, mind: Boolean(msg.mind), character: msg.character ?? null, prefix: null,
240
+ canType: !msg.mind || t.inspected.has(net),
241
+ ageOff: msg.ageOff === true,
242
+ ...(Array.isArray(msg.choices) ? { choices: choicesOf(msg.choices), authoredChoices: msg.authoredChoices === true } : {}),
243
+ questions: [...questionsOf(msg.opening?.asks), ...questionsOf(msg.opening?.more)],
244
+ sent: new Set(),
245
+ };
246
+ t.chrome.openTalk(msg.name, { mind: t.open.mind, canType: t.open.canType && t.open.choices === undefined });
247
+ if (t.drafts.has(msg.npc)) {
248
+ t.chrome.talkDraft?.(t.drafts.get(msg.npc));
249
+ t.drafts.delete(msg.npc);
250
+ }
251
+ // v1.37: the NPC speaks first -- the place's own words, here at once,
252
+ // and what a player might ask it, each a tap away.
253
+ const first = childChoices(t.open) ? `Tap a question to talk with ${String(msg.name ?? '').split(',')[0].trim()}.`
254
+ : typeof msg.opening?.text === 'string' ? msg.opening.text : '';
255
+ if (first) {
256
+ t.chrome.talkLine('them', npcDisplayText(first));
257
+ }
258
+ refill(t);
82
259
  if (t.open.mind) {
83
260
  registerParticipant(t, net);
84
261
  }
85
262
  } else if (!t.open || t.open.npc === msg.npc) {
263
+ if (t.open?.attachment) {
264
+ // These end the old conversation, never refuse an open. They may
265
+ // have been queued just before a NOT_TALKING receipt or reconnect.
266
+ if (['left', 'idle', 'end'].includes(msg.why)) {
267
+ continue;
268
+ }
269
+ t.open.interrupted = true;
270
+ t.open.interruptionWhy = msg.why;
271
+ cancelAttach(t.open);
272
+ t.asking = null;
273
+ continue;
274
+ }
275
+ clearAuthored(t.open);
276
+ cancelNotesWait(t.open);
86
277
  t.open = null;
87
278
  t.waiting = false;
88
279
  t.chrome.closeTalk();
@@ -90,144 +281,608 @@ function frame(t, scene, mp, idle) {
90
281
  if (t.asking === msg.npc) {
91
282
  t.asking = null;
92
283
  }
284
+ } else if (msg.k === 'hub-npc-opening' && t.open?.npc === msg.npc) {
285
+ if (childChoices(t.open)) {continue;}
286
+ // v1.47: a late greeting changes the first line only before we speak.
287
+ if (!t.open.sent.size && typeof msg.text === 'string' && msg.text) {
288
+ t.chrome.talkOpening?.(npcDisplayText(msg.text));
289
+ }
93
290
  } else if (msg.k === 'hub-npc-line' && t.open?.npc === msg.npc) {
291
+ if (childChoices(t.open)) {continue;}
292
+ if (t.open.interrupted) {
293
+ if (SCRIPTED[msg.why]) {
294
+ t.open.interruptionLine = msg.text;
295
+ }
296
+ continue;
297
+ }
94
298
  // With a mind, a line the place said instead is marked as scripted.
95
299
  const scripted = t.open.mind ? SCRIPTED[msg.why] : null;
96
- t.chrome.talkLine('them', msg.text, scripted ? `Scripted reply: ${t.open.name} ${scripted}` : null);
97
- t.waiting = false;
300
+ t.chrome.talkLine('them', npcDisplayText(msg.text), scripted ? `Scripted reply: ${t.open.name} ${scripted}` : null);
301
+ if (scripted && msg.op && msg.op === t.open.recoveryOperationId) {
302
+ // The line itself proves a recovery turn was refused. Cleanup must
303
+ // not depend on whether the request's rejection has arrived yet.
304
+ t.open.interruptionLine = msg.text;
305
+ t.open.interruptionShown = true;
306
+ interrupted(t, t.open);
307
+ continue;
308
+ }
309
+ if ((!t.open.mind || authoredTaps(t.open)) && t.open.authored && msg.why === 'authored' && (msg.rid === undefined || msg.rid === t.open.authored.rid)) {
310
+ finishAuthored(t, t.open, true);
311
+ } else if (t.open.mind && msg.op && msg.op === t.open.operationId) {
312
+ t.open.operationId = null;
313
+ t.waiting = false;
314
+ refill(t);
315
+ } else if (!t.open.operationId && !t.open.authored && !t.open.attachment) {
316
+ t.waiting = false;
317
+ refill(t);
318
+ }
98
319
  } else if (msg.k === 'hub-npc-notes' && t.open?.npc === msg.npc) {
320
+ if (childChoices(t.open)) {continue;}
99
321
  t.open.prefix = typeof msg.prefix === 'string' ? msg.prefix : null;
322
+ t.open.notesVersion = (t.open.notesVersion ?? 0) + 1;
323
+ if (msg.persistentAsks !== undefined || t.open.persistentAsks !== undefined) {
324
+ const previous = t.open.persistentAsks ?? [];
325
+ const persistent = questionsOf(msg.persistentAsks);
326
+ const withdrawn = t.open.withdrawnAsks ??= new Set();
327
+ for (const ask of previous) {
328
+ if (!persistent.includes(ask)) {
329
+ withdrawn.add(ask);
330
+ }
331
+ }
332
+ for (const ask of persistent) {
333
+ withdrawn.delete(ask);
334
+ }
335
+ t.open.persistentAsks = persistent;
336
+ if (!t.waiting && (previous.length !== persistent.length || previous.some((ask, i) => ask !== persistent[i]))) {
337
+ refill(t, t.suggestions);
338
+ }
339
+ }
340
+ if (t.open.attachment?.opened) {
341
+ cancelAttach(t.open, true);
342
+ }
343
+ cancelNotesWait(t.open, true);
344
+ }
345
+ }
346
+ if (t.open?.interrupted) {
347
+ const open = t.open;
348
+ // Close and scripted line are separate packets; allow the place's line
349
+ // to arrive on the next frame before choosing the fixed fallback.
350
+ if (open.interruptionLine || !SCRIPTED[open.interruptionWhy]) {
351
+ interrupted(t, open);
352
+ } else if (!open.interruptionTimer && !open.closeTimer) {
353
+ open.interruptionTimer = setTimeout(() => interrupted(t, open), 250);
100
354
  }
101
355
  }
102
356
  t.chrome.talkWaiting(t.waiting);
357
+ syncHint(t);
103
358
 
104
- const near = idle && net && !t.open ? nearestNpc(scene) : null;
359
+ const near = idle && net && !t.open ? nearestNpc(scene, t.preferred, t.open?.npc) : null;
105
360
  t.near = near;
106
- t.chrome.talkPrompt(near ? near.name : null);
361
+ t.chrome.talkPrompt(near ? near.name : null, near?.mind ?? false);
362
+ if (net && (near?.mind || companionNpc(scene)) && !t.approached.has(net)) {
363
+ t.approached.add(net);
364
+ registerParticipant(t, net);
365
+ }
366
+ const character = near && !t.asking ? t.hooks.get(near.id) : null;
367
+ if (character) {
368
+ dropHook(t, near.id, character);
369
+ if (!t.readWait) {
370
+ void walkGreeting(t, net, character);
371
+ }
372
+ }
373
+ }
374
+
375
+ function dropHook(t, npc, character = t.hooks.get(npc)) {
376
+ t.hooks.delete(npc);
377
+ if (character) {
378
+ t.greeted.add(character);
379
+ for (const [id, mind] of t.hooks) {
380
+ if (mind === character) {
381
+ t.hooks.delete(id);
382
+ }
383
+ }
384
+ }
385
+ }
386
+
387
+ async function walkGreeting(t, net, character) {
388
+ const session = t.session;
389
+ try {
390
+ await net.characters.readCharacters({ requestId: newId(), query: { type: 'status', operationId: `greeting:${character}` } });
391
+ } catch (err) {
392
+ // One attempt per hook; error details might contain private words.
393
+ readFailed(t, session, 'greeting read', err, false);
394
+ }
395
+ }
396
+
397
+ // A failed read backs this session's next inspect and greeting off, and is
398
+ // logged once per kind and code.
399
+ function readFailed(t, session, what, err, detail = true) {
400
+ if (t.session !== session) {
401
+ return;
402
+ }
403
+ const code = typeof err?.code === 'string' ? err.code : 'error';
404
+ if (!t.logged.has(`${what}:${code}`)) {
405
+ t.logged.add(`${what}:${code}`);
406
+ console.log(detail ? `[hub] NPC ${what} failed: ${code}` : `[hub] NPC ${what} failed`);
407
+ }
408
+ t.readFailures++;
409
+ clearTimeout(t.readWait);
410
+ t.readWait = setTimeout(() => {
411
+ if (t.session === session) {
412
+ t.readWait = null;
413
+ }
414
+ }, Math.min(READ_RETRY_MS * 2 ** (t.readFailures - 1), READ_RETRY_MAX_MS));
415
+ }
416
+
417
+ // v1.46: the next questions, without anything this player already sent.
418
+ function questionsOf(value) {
419
+ return Array.isArray(value) ? value.filter((ask) => typeof ask === 'string').map((ask) => ask.trim().slice(0, INPUT_MAX)).filter(Boolean) : [];
107
420
  }
108
421
 
109
- function nearestNpc(scene) {
422
+ // v1.142: object choices are authored bundle chips, never model suggestions.
423
+ function choicesOf(value) {
424
+ if (Array.isArray(value) && value.length && value.every((ask) => typeof ask?.id === 'string' && ask.id && typeof ask.label === 'string' && ask.label)) {
425
+ return value.slice(0, 4).map(({ id, label }) => ({ id, label }));
426
+ }
427
+ return questionsOf(value).slice(0, 5);
428
+ }
429
+
430
+ function childChoices(open) {
431
+ return typeof open?.choices?.[0]?.id === 'string';
432
+ }
433
+
434
+ // v1.148: a mind's place asks for a speaker under 13, answered by the place.
435
+ function authoredTaps(open) {
436
+ return open?.authoredChoices === true && Array.isArray(open.choices) && !childChoices(open);
437
+ }
438
+
439
+ function refill(t, suggestions) {
440
+ if (childChoices(t.open)) {
441
+ t.suggestions = undefined;
442
+ t.chrome.talkAsks?.(t.open.canType ? t.open.choices : [], (ask) => send(t, ask));
443
+ return;
444
+ }
445
+ // Notes may change the offers between replies; keep that reply's source.
446
+ t.suggestions = suggestions;
447
+ const open = t.open;
448
+ const source = Array.isArray(suggestions) && suggestions.every((ask) => typeof ask === 'string') ? questionsOf(suggestions) : open?.questions ?? [];
449
+ let asks = open?.canType ? [...new Set(source)].filter((ask) => !open.sent.has(ask)).slice(0, 3) : [];
450
+ if (open?.canType && open.persistentAsks !== undefined) {
451
+ const persistent = open.persistentAsks;
452
+ asks = [...new Set([...persistent, ...source])].filter((ask) => persistent.includes(ask) || (!open.withdrawnAsks.has(ask) && !open.sent.has(ask))).slice(0, 3);
453
+ }
454
+ if (open?.choices !== undefined) {
455
+ asks = open.canType || authoredTaps(open) ? open.choices : [];
456
+ }
457
+ t.chrome.talkAsks?.(asks, (ask) => send(t, ask));
458
+ }
459
+
460
+ function nearestNpc(scene, preferred, talking) {
110
461
  const local = scene.actorWith('Player')?.components.Transform;
111
462
  if (!local) {
112
463
  return null;
113
464
  }
114
465
  let best = null;
115
- for (const actor of scene.getActors()) {
466
+ let choice = null;
467
+ for (const actor of talkActors(scene)) {
116
468
  const props = actor.components?.HubNpc;
117
469
  const at = actor.components?.Transform;
118
470
  if (!props || !at) {
119
471
  continue;
120
472
  }
473
+ if (!mindDue(scene, actor, local, talking, performance.now())) {continue;}
121
474
  const d = Math.hypot(at.x - local.x, at.z - local.z);
122
475
  const range = typeof props.talkRange === 'number' ? props.talkRange : TALK_RANGE_M;
123
- if (d <= range && (!best || d < best.d)) {
124
- best = { id: actor.id, name: typeof props.name === 'string' && props.name ? props.name : actor.id, d };
476
+ if (d <= range && (!best || d < best.d || actor.id === preferred)) {
477
+ best = { id: actor.id, name: typeof props.name === 'string' && props.name ? props.name : actor.id, mind: typeof props.character === 'string' && Boolean(props.character), character: props.character, d };
478
+ if (actor.id === preferred) {
479
+ choice = best;
480
+ }
125
481
  }
126
482
  }
127
- return best;
483
+ return choice ?? best;
484
+ }
485
+
486
+ function companionNpc(scene) {
487
+ if (!hub.place?.companionChat) {
488
+ return null;
489
+ }
490
+ const playerId = scene.multiplayer?.net?.selfId?.();
491
+ return playerId && hub.companion?.c && scene.actorWith('Player')
492
+ ? { id: `companion:${playerId}`, name: hub.place.companionChat.name, mind: true } : null;
128
493
  }
129
494
 
130
- function ask(t) {
131
- if (!t.near || !t.net || t.asking) {
495
+ function ask(t, near = t.near) {
496
+ if (!near || !t.net || t.asking) {
132
497
  return;
133
498
  }
134
- t.asking = t.near.id;
135
- t.net.send({ k: 'hub-npc-open', npc: t.near.id });
499
+ t.asking = near.id;
500
+ t.abandonedOpens.delete(near.id);
501
+ dropHook(t, near.id, near.character ?? t.hooks.get(near.id));
502
+ t.net.send({ k: 'hub-npc-open', npc: near.id });
136
503
  }
137
504
 
138
505
  function end(t) {
139
506
  if (t.open && t.net) {
140
507
  t.net.send({ k: 'hub-npc-end', npc: t.open.npc });
141
508
  }
509
+ clearAuthored(t.open);
510
+ if (t.open?.attachment) {
511
+ t.abandonedOpens.add(t.open.npc);
512
+ }
513
+ cancelAttach(t.open);
514
+ cancelNotesWait(t.open);
515
+ clearTimeout(t.open?.closeTimer);
516
+ clearTimeout(t.open?.interruptionTimer);
142
517
  t.open = null;
518
+ t.asking = null;
143
519
  t.waiting = false;
144
520
  t.chrome.closeTalk();
145
521
  }
146
522
 
523
+ function cancelAttach(open, attached = false) {
524
+ const attachment = open?.attachment;
525
+ if (attachment) {
526
+ clearTimeout(attachment.timer);
527
+ open.attachment = null;
528
+ attachment.resolve(attached);
529
+ }
530
+ }
531
+
532
+ function reattach(t, open) {
533
+ if (t.open !== open || open.interrupted || !t.net) {
534
+ return Promise.resolve(false);
535
+ }
536
+ if (open.attachment) {
537
+ return open.attachment.promise;
538
+ }
539
+ const attachment = { needsNotes: open.mind && open.prefix !== null, opened: false };
540
+ attachment.promise = new Promise((resolve) => { attachment.resolve = resolve; });
541
+ open.attachment = attachment;
542
+ t.asking = open.npc;
543
+ attachment.timer = setTimeout(() => {
544
+ if (t.open === open && open.attachment === attachment) {
545
+ interrupted(t, open);
546
+ }
547
+ }, ATTACH_WAIT_MS);
548
+ t.net.send({ k: 'hub-npc-open', npc: open.npc });
549
+ return attachment.promise;
550
+ }
551
+
552
+ function cancelNotesWait(open, ready = false) {
553
+ if (open?.notesWait) {
554
+ clearTimeout(open.notesWait.timer);
555
+ open.notesWait.resolve(ready);
556
+ open.notesWait = null;
557
+ }
558
+ }
559
+
560
+ function waitForNotes(t, open, version) {
561
+ if (t.open !== open || open.interrupted) {
562
+ return Promise.resolve(false);
563
+ }
564
+ if ((open.notesVersion ?? 0) > version) {
565
+ return Promise.resolve(true);
566
+ }
567
+ const wait = {};
568
+ wait.promise = new Promise((resolve) => { wait.resolve = resolve; });
569
+ open.notesWait = wait;
570
+ wait.timer = setTimeout(() => {
571
+ if (t.open === open && open.notesWait === wait) {
572
+ interrupted(t, open);
573
+ }
574
+ }, ATTACH_WAIT_MS);
575
+ return wait.promise;
576
+ }
577
+
578
+ function interrupted(t, open) {
579
+ if (t.open !== open || open.closeTimer) {
580
+ return;
581
+ }
582
+ open.interrupted = true;
583
+ clearTimeout(open.interruptionTimer);
584
+ if (open.attachment) {
585
+ t.abandonedOpens.add(open.npc);
586
+ }
587
+ cancelAttach(open);
588
+ cancelNotesWait(open);
589
+ clearAuthored(open);
590
+ open.operationId = null;
591
+ t.asking = null;
592
+ t.waiting = false;
593
+ t.chrome.talkWaiting(false);
594
+ t.chrome.talkAsks?.([], null);
595
+ if (!open.interruptionShown) {
596
+ t.chrome.talkLine('them', open.interruptionLine || INTERRUPTED_LINE);
597
+ open.interruptionShown = true;
598
+ }
599
+ const draft = open.pendingText || t.chrome.talkDraft?.();
600
+ if (draft) {
601
+ t.drafts.set(open.npc, draft);
602
+ t.chrome.talkDraft?.(draft);
603
+ open.sent.delete(draft);
604
+ }
605
+ t.chrome.talkTyping?.(false);
606
+ open.closeTimer = setTimeout(() => {
607
+ if (t.open === open) {
608
+ end(t);
609
+ }
610
+ }, INTERRUPTED_MS);
611
+ }
612
+
613
+ function clearAuthored(open) {
614
+ if (open?.authored) {
615
+ clearTimeout(open.authored.timer);
616
+ open.authored = null;
617
+ }
618
+ }
619
+
620
+ function finishAuthored(t, open, replied) {
621
+ if (t.open !== open || !open.authored) {
622
+ return;
623
+ }
624
+ if (replied) {
625
+ open.sent.add(open.authored.text);
626
+ open.pendingText = null;
627
+ // v1.148: the place took its choice; the next open brings the next ones.
628
+ if (authoredTaps(open)) {
629
+ open.choices = [];
630
+ }
631
+ }
632
+ clearAuthored(open);
633
+ t.waiting = false;
634
+ t.chrome.talkWaiting(false);
635
+ refill(t);
636
+ }
637
+
638
+ // A mind whose inspect was refused leaves no field: to a speaker the server
639
+ // says is under 13 (`ageOff`), the panel says why, under the opening, in the
640
+ // placeholder's short name, except where the place gives them choices (the
641
+ // refusal is not the age rule there). A guest is over 13 like anyone else and
642
+ // gets no line of their own. Not while the first inspect is still out, never
643
+ // for anyone else or a body without a mind, and gone once an inspect succeeds.
644
+ function syncHint(t) {
645
+ const open = t.open;
646
+ const show = Boolean(open?.mind && !open.canType && t.session.refused && open.ageOff === true && open.choices === undefined);
647
+ t.chrome.talkHint?.(show ? under13Talk(String(open.name ?? '').split(',')[0].trim()) : null);
648
+ }
649
+
147
650
  // The world learns which player here is which participant from that player's
148
651
  // own read; the place needs it to tell who a character chose to follow.
149
- function registerParticipant(t, net) {
652
+ async function registerParticipant(t, net) {
150
653
  const characters = net?.characters;
151
- if (!characters || t.inspected.has(net)) {
654
+ const session = t.session;
655
+ if (!characters || t.inspected.has(net) || session.inspecting || t.readWait) {
152
656
  return;
153
657
  }
154
- t.inspected.add(net);
155
- characters.readCharacters({ requestId: newId(), query: { type: 'inspect' } }).catch((err) => {
156
- console.log(`[hub] NPC inspect failed: ${err?.code ?? err?.message ?? err}`);
157
- });
658
+ session.inspecting = true;
659
+ try {
660
+ await characters.readCharacters({ requestId: newId(), query: { type: 'inspect' } });
661
+ if (t.session !== session) {
662
+ return;
663
+ }
664
+ t.inspected.add(net);
665
+ session.refused = false;
666
+ t.readFailures = 0;
667
+ clearTimeout(t.readWait);
668
+ t.readWait = null;
669
+ if (t.net === net && t.open?.mind) {
670
+ t.open.canType = true;
671
+ t.chrome.talkTyping(t.open.choices === undefined);
672
+ refill(t);
673
+ }
674
+ syncHint(t);
675
+ } catch (err) {
676
+ if (t.session === session) {
677
+ session.refused = true;
678
+ }
679
+ readFailed(t, session, 'inspect', err);
680
+ syncHint(t);
681
+ } finally {
682
+ session.inspecting = false;
683
+ }
158
684
  }
159
685
 
160
686
  function send(t, raw) {
161
- const text = String(raw ?? '').trim().slice(0, INPUT_MAX);
162
687
  const open = t.open;
163
- if (!text || !open || t.waiting || !t.net) {
688
+ const choice = childChoices(open) ? open.choices.find((ask) => ask.id === raw?.id) : null;
689
+ const text = choice ? `choice:${choice.id}` : String(raw ?? '').trim().slice(0, INPUT_MAX);
690
+ if (!text || !(open?.canType || authoredTaps(open)) || open.interrupted || t.waiting || !t.net) {
164
691
  return;
165
692
  }
166
- t.chrome.talkLine('me', text);
167
- if (!open.mind) {
168
- t.net.send({ k: 'hub-npc-say', npc: open.npc, text });
693
+ if (open.choices !== undefined && (childChoices(open) ? !choice : !open.choices.includes(text))) {
169
694
  return;
170
695
  }
696
+ if ((!open.mind || authoredTaps(open)) && performance.now() - t.saidAt < AUTHORED_GAP_MS) {
697
+ return;
698
+ }
699
+ t.chrome.talkAsks?.([], null);
700
+ t.chrome.talkLine('me', choice?.label ?? text);
171
701
  t.waiting = true;
172
- void turn(t, open, text);
702
+ open.pendingText = text;
703
+ t.chrome.talkWaiting(true);
704
+ // A tap keeps the path it was made on, across a reattach's new open.
705
+ const authored = authoredTaps(open);
706
+ if (open.needsAttach || open.attachment) {
707
+ void reattach(t, open).then((attached) => {
708
+ if (attached && t.open === open) {
709
+ dispatch(t, open, text, true, authored);
710
+ }
711
+ });
712
+ return;
713
+ }
714
+ dispatch(t, open, text, false, authored);
715
+ }
716
+
717
+ function dispatch(t, open, text, reattached = false, authored = authoredTaps(open)) {
718
+ reattached ||= open.reattached === true;
719
+ open.reattached = false;
720
+ // v1.148: an authored tap is never a mind turn; one the new open no longer
721
+ // offers is dropped.
722
+ if (authored && !(authoredTaps(open) && open.choices.includes(text))) {
723
+ open.pendingText = null;
724
+ t.waiting = false;
725
+ t.chrome.talkWaiting(false);
726
+ refill(t);
727
+ return;
728
+ }
729
+ if (!open.mind || authored) {
730
+ t.saidAt = performance.now();
731
+ // A reply to an earlier send must not acknowledge this question.
732
+ const rid = newId();
733
+ open.authored = { text, rid, timer: setTimeout(() => finishAuthored(t, open, false), AUTHORED_WAIT_MS) };
734
+ t.net.send({ k: 'hub-npc-say', npc: open.npc, text, rid });
735
+ return;
736
+ }
737
+ open.sent.add(text);
738
+ void turn(t, open, text, reattached);
173
739
  }
174
740
 
175
- async function turn(t, open, text) {
741
+ async function turn(t, open, text, attachRetried = false) {
742
+ const session = t.session;
176
743
  const net = t.net;
177
744
  const characters = net?.characters;
178
745
  let operationId = null;
746
+ let requests = 0;
747
+ let notesVersion = 0;
748
+ // A scripted line may end this wait and let the player send again.
749
+ const active = () => t.open === open && t.net === net && open.operationId === operationId;
179
750
  const request = () => {
180
- operationId = newId();
751
+ requests++;
752
+ notesVersion = open.notesVersion ?? 0;
753
+ open.operationId = operationId = newId();
754
+ open.recoveryOperationId = attachRetried ? operationId : null;
181
755
  return characters.requestCharacterTurn({
182
756
  requestId: newId(),
183
757
  operationId,
184
758
  characterId: open.character,
185
- input: `${open.prefix ?? ''}${text}`,
759
+ input: childChoices(open) ? text : `${open.prefix ?? ''}${text}`,
186
760
  // Nobody else hears a player's conversation with a character.
187
761
  audience: { disclosure: 'participants', playerIds: [], characterIds: [] },
188
762
  });
189
763
  };
764
+ let notesRetried = false;
190
765
  try {
191
- try {
192
- await request();
193
- } catch (err) {
194
- // The notes changed under the words (a pad filled): once more, with the
195
- // newest the server sent.
196
- if (err?.code !== 'HUB_NPC_NOTES' || t.open !== open) {
197
- throw err;
766
+ while (true) {
767
+ try {
768
+ await request();
769
+ if (open.recoveryOperationId === operationId) {
770
+ open.recoveryOperationId = null;
771
+ }
772
+ if (active()) {
773
+ open.pendingText = null;
774
+ }
775
+ break;
776
+ } catch (err) {
777
+ if (err?.code === 'HUB_NPC_NOT_TALKING' && active() && !attachRetried && requests < 2) {
778
+ attachRetried = true;
779
+ if (!(await reattach(t, open)) || !active()) {
780
+ return;
781
+ }
782
+ continue;
783
+ }
784
+ // The notes changed under the words (a pad filled): once more, with
785
+ // the newest the server sent.
786
+ if (childChoices(open) || err?.code !== 'HUB_NPC_NOTES' || !active() || notesRetried || requests >= 2) {
787
+ throw err;
788
+ }
789
+ notesRetried = true;
790
+ if (attachRetried) {
791
+ if (!(await waitForNotes(t, open, notesVersion))) {
792
+ return;
793
+ }
794
+ } else {
795
+ await new Promise((resolve) => setTimeout(resolve, NOTES_RETRY_MS));
796
+ }
797
+ if (!active()) {
798
+ return;
799
+ }
198
800
  }
199
- await new Promise((resolve) => setTimeout(resolve, NOTES_RETRY_MS));
200
- await request();
201
801
  }
202
802
  } catch (err) {
203
803
  // A refusal (busy, over budget, too far) comes with the place's own line,
204
804
  // which ends the wait; this only covers a refusal that brought none.
205
- console.log(`[hub] NPC turn refused: ${err?.code ?? err?.message ?? err}`);
805
+ const code = typeof err?.code === 'string' ? err.code : 'error';
806
+ if (t.session === session && !t.logged.has(`turn:${code}`)) {
807
+ t.logged.add(`turn:${code}`);
808
+ console.log(`[hub] NPC turn refused: ${code}`);
809
+ }
810
+ if (!active()) {return;}
811
+ if (childChoices(open) && attachRetried) {
812
+ // Children never receive the separate scripted refusal packet.
813
+ t.chrome.talkLine('them', INTERRUPTED_LINE);
814
+ open.needsAttach = err?.code === 'HUB_NPC_NOT_TALKING';
815
+ }
816
+ // The server holds no conversation for this panel (it ended there, or the
817
+ // session never had one) and sends no line with that: a panel left open
818
+ // would take more words and answer none. Closed, the talk button is back.
819
+ if (!childChoices(open) && (err?.code === 'HUB_NPC_NOT_TALKING' || attachRetried)) {
820
+ const why = REFUSAL_WHY[err?.code];
821
+ if (why) {
822
+ // A rejection may precede its separate scripted-line packet. Keep
823
+ // the pending words and allow that line the same grace as an open
824
+ // refusal; neither packet order can leave the panel accepting words.
825
+ open.interrupted = true;
826
+ open.interruptionWhy = why;
827
+ open.interruptionTimer = setTimeout(() => interrupted(t, open), 250);
828
+ } else {
829
+ interrupted(t, open);
830
+ }
831
+ return;
832
+ }
833
+ if (open.interrupted) {
834
+ return;
835
+ }
206
836
  setTimeout(() => {
207
- if (t.open === open) {
837
+ if (active()) {
838
+ open.operationId = null;
208
839
  t.waiting = false;
840
+ if (childChoices(open)) {
841
+ open.recoveryOperationId = null;
842
+ open.pendingText = null;
843
+ t.chrome.talkWaiting(false);
844
+ refill(t);
845
+ }
209
846
  }
210
847
  }, 1500);
211
848
  return;
212
849
  }
213
850
  const started = performance.now();
214
- while (t.open === open && t.net === net && performance.now() - started < POLL_LIMIT_MS) {
851
+ let failures = 0;
852
+ while (active() && performance.now() - started < POLL_LIMIT_MS) {
215
853
  await new Promise((resolve) => setTimeout(resolve, POLL_MS));
854
+ if (!active()) {
855
+ return;
856
+ }
216
857
  let status = null;
217
858
  try {
218
859
  status = await characters.readCharacters({ requestId: newId(), query: { type: 'status', operationId } });
219
860
  } catch (err) {
220
- console.log(`[hub] NPC status read failed: ${err?.code ?? err?.message ?? err}`);
861
+ readFailed(t, session, 'status read', err);
862
+ if (++failures >= STATUS_FAILURES_MAX) {
863
+ break;
864
+ }
221
865
  continue;
222
866
  }
867
+ if (!active()) {
868
+ return;
869
+ }
223
870
  if (status?.status === 'completed' || status?.status === 'interrupted') {
224
- if (t.open === open && typeof status.response === 'string' && status.response) {
225
- t.chrome.talkLine('them', unquote(status.response));
871
+ const reply = typeof status.response === 'string' ? status.response : status.response?.text;
872
+ if (typeof reply === 'string' && reply) {
873
+ t.chrome.talkLine('them', npcDisplayText(reply));
226
874
  }
875
+ const suggestions = Array.isArray(status.suggestions) && status.suggestions.every((ask) => typeof ask === 'string') ? status.suggestions : status.response?.suggestions;
876
+ if (!childChoices(open)) {refill(t, suggestions);}
227
877
  break;
228
878
  }
229
879
  }
230
- if (t.open === open) {
880
+ if (active()) {
881
+ open.operationId = null;
231
882
  t.waiting = false;
883
+ if (childChoices(open)) {
884
+ t.chrome.talkWaiting(false);
885
+ refill(t);
886
+ }
232
887
  }
233
888
  }