castle-web-cli 0.4.238 → 0.4.240

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 (404) hide show
  1. package/dist/agent.js +5 -1
  2. package/dist/api.d.ts +20 -0
  3. package/dist/api.js +57 -0
  4. package/dist/bundle.d.ts +38 -1
  5. package/dist/bundle.js +309 -13
  6. package/dist/castle-host/host.js +218 -11
  7. package/dist/castleJson.d.ts +10 -0
  8. package/dist/castleJson.js +46 -2
  9. package/dist/check.js +5 -2
  10. package/dist/devSessionServer.js +4 -1
  11. package/dist/devSessionStorage.d.ts +1 -0
  12. package/dist/devSessionStorage.js +32 -7
  13. package/dist/importOrder.d.ts +2 -0
  14. package/dist/importOrder.js +29 -0
  15. package/dist/index.js +22 -3
  16. package/dist/init.js +24 -2
  17. package/dist/multiplayerDoc.d.ts +1 -1
  18. package/dist/multiplayerDoc.js +9 -0
  19. package/dist/platformDoc.js +4 -2
  20. package/dist/playPagePolicy.d.ts +1 -0
  21. package/dist/playPagePolicy.js +12 -3
  22. package/dist/resetLeaderboards.d.ts +8 -1
  23. package/dist/resetLeaderboards.js +43 -8
  24. package/dist/roomLogs.d.ts +39 -0
  25. package/dist/roomLogs.js +166 -0
  26. package/dist/save-deck.d.ts +32 -2
  27. package/dist/save-deck.js +240 -39
  28. package/kits/base/CLAUDE.md +2 -1
  29. package/kits/base/castle.json +1 -1
  30. package/kits/base/sdk/README.md +240 -8
  31. package/kits/base/sdk/analytics.d.ts +8 -0
  32. package/kits/base/sdk/analytics.js +92 -0
  33. package/kits/base/sdk/castle.d.ts +8 -2
  34. package/kits/base/sdk/castle.js +3 -0
  35. package/kits/base/sdk/commands.d.ts +79 -0
  36. package/kits/base/sdk/commands.js +1 -0
  37. package/kits/base/sdk/debugConsole.d.ts +17 -0
  38. package/kits/base/sdk/debugConsole.js +154 -0
  39. package/kits/base/sdk/experiments.js +24 -1
  40. package/kits/base/sdk/hostRetry.d.ts +7 -0
  41. package/kits/base/sdk/hostRetry.js +57 -0
  42. package/kits/base/sdk/hub.d.ts +20 -2
  43. package/kits/base/sdk/hub.js +99 -13
  44. package/kits/base/sdk/multiplayer.d.ts +2 -0
  45. package/kits/base/sdk/multiplayer.js +198 -26
  46. package/kits/base/sdk/reconnectBudget.d.ts +6 -0
  47. package/kits/base/sdk/reconnectBudget.js +41 -1
  48. package/kits/base/sdk/rooms.d.ts +11 -0
  49. package/kits/base/sdk/rooms.js +22 -0
  50. package/kits/base/sdk/runtime.js +36 -19
  51. package/kits/base/sdk/server/hub.d.ts +19 -0
  52. package/kits/base/sdk/server/hub.js +12 -0
  53. package/kits/base/sdk/server/platformHandle.d.ts +1 -0
  54. package/kits/base/sdk/server/wrapper.d.ts +1 -1
  55. package/kits/base/sdk/server/wrapper.js +26 -1
  56. package/kits/base/sdk/store.d.ts +8 -2
  57. package/kits/base/sdk/store.js +5 -1
  58. package/kits/base/sdk/transport.d.ts +2 -1
  59. package/kits/base/sdk/transport.js +35 -0
  60. package/kits/hub-game/CLAUDE.md +66 -19
  61. package/kits/hub-game/castle.json +4 -4
  62. package/kits/hub-game/code/client/act.js +9 -6
  63. package/kits/hub-game/code/client/actCore.js +26 -6
  64. package/kits/hub-game/code/client/actGateLog.js +36 -0
  65. package/kits/hub-game/code/client/actionOverflow.js +29 -8
  66. package/kits/hub-game/code/client/actionRailSurface.js +186 -0
  67. package/kits/hub-game/code/client/actionRailTree.js +173 -0
  68. package/kits/hub-game/code/client/askSurface.js +85 -0
  69. package/kits/hub-game/code/client/askTree.js +51 -0
  70. package/kits/hub-game/code/client/attention.js +31 -6
  71. package/kits/hub-game/code/client/ballot.js +42 -5
  72. package/kits/hub-game/code/client/ballotSurface.js +115 -0
  73. package/kits/hub-game/code/client/ballotTree.js +180 -0
  74. package/kits/hub-game/code/client/catchingUp.js +19 -0
  75. package/kits/hub-game/code/client/celebrate.js +66 -0
  76. package/kits/hub-game/code/client/chrome.js +474 -53
  77. package/kits/hub-game/code/client/companion.js +93 -23
  78. package/kits/hub-game/code/client/companionDress.js +1 -1
  79. package/kits/hub-game/code/client/cornerSurface.js +106 -0
  80. package/kits/hub-game/code/client/cornerTree.js +83 -0
  81. package/kits/hub-game/code/client/decor.js +20 -11
  82. package/kits/hub-game/code/client/deviceStorage.js +121 -0
  83. package/kits/hub-game/code/client/disguise.js +23 -0
  84. package/kits/hub-game/code/client/disguiseDraw.js +87 -0
  85. package/kits/hub-game/code/client/dockSurface.js +206 -0
  86. package/kits/hub-game/code/client/dockTree.js +232 -0
  87. package/kits/hub-game/code/client/earned.js +29 -0
  88. package/kits/hub-game/code/client/emoteSurface.js +188 -0
  89. package/kits/hub-game/code/client/emoteTree.js +264 -0
  90. package/kits/hub-game/code/client/farAvatars.js +4 -3
  91. package/kits/hub-game/code/client/fpsTelemetry.js +3 -1
  92. package/kits/hub-game/code/client/grab.js +121 -50
  93. package/kits/hub-game/code/client/holdShow.js +19 -0
  94. package/kits/hub-game/code/client/hookLayer.js +96 -12
  95. package/kits/hub-game/code/client/hubControls.js +7 -1
  96. package/kits/hub-game/code/client/hudSurface.js +11 -3
  97. package/kits/hub-game/code/client/hudTree.js +7 -4
  98. package/kits/hub-game/code/client/idle.js +21 -3
  99. package/kits/hub-game/code/client/invites.js +24 -3
  100. package/kits/hub-game/code/client/keys.js +15 -0
  101. package/kits/hub-game/code/client/labelsNear.js +8 -1
  102. package/kits/hub-game/code/client/layoutCache.js +57 -8
  103. package/kits/hub-game/code/client/loadingCover.js +53 -4
  104. package/kits/hub-game/code/client/menuIcons.js +15 -0
  105. package/kits/hub-game/code/client/menuRows.js +8 -2
  106. package/kits/hub-game/code/client/menuSurface.js +102 -0
  107. package/kits/hub-game/code/client/menuTree.js +135 -0
  108. package/kits/hub-game/code/client/modelLook.js +41 -0
  109. package/kits/hub-game/code/client/pickerSurface.js +152 -0
  110. package/kits/hub-game/code/client/pickerTree.js +163 -0
  111. package/kits/hub-game/code/client/pushVisit.js +4 -2
  112. package/kits/hub-game/code/client/quality.js +188 -29
  113. package/kits/hub-game/code/client/qualityEntry.js +10 -1
  114. package/kits/hub-game/code/client/quickChatSurface.js +222 -0
  115. package/kits/hub-game/code/client/quickChatTree.js +201 -0
  116. package/kits/hub-game/code/client/rehello.js +75 -0
  117. package/kits/hub-game/code/client/renderVisibility.js +17 -0
  118. package/kits/hub-game/code/client/replay.js +118 -0
  119. package/kits/hub-game/code/client/role.js +3 -0
  120. package/kits/hub-game/code/client/safeLayout.js +441 -56
  121. package/kits/hub-game/code/client/safeStyle.js +13 -10
  122. package/kits/hub-game/code/client/say.js +2 -0
  123. package/kits/hub-game/code/client/soundSurface.js +77 -0
  124. package/kits/hub-game/code/client/soundTree.js +74 -0
  125. package/kits/hub-game/code/client/soundscape.js +12 -9
  126. package/kits/hub-game/code/client/soundscapeCues.js +1 -1
  127. package/kits/hub-game/code/client/state.js +67 -1
  128. package/kits/hub-game/code/client/stuckSurface.js +76 -0
  129. package/kits/hub-game/code/client/stuckTree.js +67 -0
  130. package/kits/hub-game/code/client/talk.js +42 -12
  131. package/kits/hub-game/code/client/talkTree.js +4 -2
  132. package/kits/hub-game/code/client/textAskSurface.js +147 -0
  133. package/kits/hub-game/code/client/textAskTree.js +67 -0
  134. package/kits/hub-game/code/client/tiers.js +252 -27
  135. package/kits/hub-game/code/client/together.js +4 -1
  136. package/kits/hub-game/code/client/uiDom.js +86 -8
  137. package/kits/hub-game/code/client/uiTree.js +33 -4
  138. package/kits/hub-game/code/client/vehicle.js +75 -52
  139. package/kits/hub-game/code/client/weakestTier.js +75 -31
  140. package/kits/hub-game/code/client/wear.js +159 -5
  141. package/kits/hub-game/code/client/worldLabels.js +215 -26
  142. package/kits/hub-game/code/companionSpec.js +4 -2
  143. package/kits/hub-game/code/server/act.js +3 -0
  144. package/kits/hub-game/code/server/actGate.js +83 -0
  145. package/kits/hub-game/code/server/actions.js +71 -15
  146. package/kits/hub-game/code/server/actors.js +20 -5
  147. package/kits/hub-game/code/server/analytics.js +40 -15
  148. package/kits/hub-game/code/server/ask.js +39 -3
  149. package/kits/hub-game/code/server/ballot.js +167 -4
  150. package/kits/hub-game/code/server/celebrate.js +64 -0
  151. package/kits/hub-game/code/server/companion.js +17 -2
  152. package/kits/hub-game/code/server/decor.js +11 -2
  153. package/kits/hub-game/code/server/disguise.js +63 -0
  154. package/kits/hub-game/code/server/doorAnalytics.js +2 -5
  155. package/kits/hub-game/code/server/earned.js +6 -2
  156. package/kits/hub-game/code/server/friendBests.js +13 -4
  157. package/kits/hub-game/code/server/friendsAmong.js +67 -8
  158. package/kits/hub-game/code/server/grab.js +12 -2
  159. package/kits/hub-game/code/server/heldOffers.js +142 -0
  160. package/kits/hub-game/code/server/holdShow.js +98 -0
  161. package/kits/hub-game/code/server/hub.js +854 -45
  162. package/kits/hub-game/code/server/idle.js +110 -9
  163. package/kits/hub-game/code/server/index.js +9 -0
  164. package/kits/hub-game/code/server/labels.js +13 -3
  165. package/kits/hub-game/code/server/loadAbandon.js +2 -5
  166. package/kits/hub-game/code/server/manifest.js +94 -6
  167. package/kits/hub-game/code/server/menu.js +26 -3
  168. package/kits/hub-game/code/server/npcs.js +55 -9
  169. package/kits/hub-game/code/server/observe.js +67 -6
  170. package/kits/hub-game/code/server/players.js +8 -1
  171. package/kits/hub-game/code/server/replay.js +135 -0
  172. package/kits/hub-game/code/server/storageLimit.js +4 -1
  173. package/kits/hub-game/code/server/townDay.js +74 -0
  174. package/kits/hub-game/code/server/trackQueue.js +29 -0
  175. package/kits/hub-game/code/server/vehicle.js +3 -0
  176. package/kits/hub-game/code/server/vis.js +26 -4
  177. package/kits/hub-game/code/server/wallet.js +677 -0
  178. package/kits/hub-game/code/server/wear.js +13 -3
  179. package/kits/hub-game/code/server/writerLease.js +191 -0
  180. package/kits/hub-game/code/shared/act.js +1 -1
  181. package/kits/hub-game/code/shared/expression.js +6 -0
  182. package/kits/hub-game/code/shared/replay.js +37 -0
  183. package/kits/hub-game/code/systems/hub.js +437 -57
  184. package/kits/hub-game/docs/analytics.md +20 -3
  185. package/kits/hub-game/docs/contract.md +942 -99
  186. package/kits/hub-game/docs/home-pieces.md +5 -6
  187. package/kits/hub-game/docs/observed-progress.md +49 -1
  188. package/kits/hub-game/docs/vehicle-preset.md +23 -0
  189. package/kits/hub-game/index.html +1 -0
  190. package/kits/hub-game/models/hats/baker-cap.pxmodel +3 -3
  191. package/kits/hub-game/models/hats/bat-clip.pxmodel +3 -3
  192. package/kits/hub-game/models/hats/beekeeper.pxmodel +3 -3
  193. package/kits/hub-game/models/hats/cap.pxmodel +3 -3
  194. package/kits/hub-game/models/hats/captain.pxmodel +3 -3
  195. package/kits/hub-game/models/hats/chef-toque.pxmodel +3 -3
  196. package/kits/hub-game/models/hats/crooked-top.pxmodel +3 -3
  197. package/kits/hub-game/models/hats/delivery-cap.pxmodel +3 -3
  198. package/kits/hub-game/models/hats/fire-helmet.pxmodel +3 -3
  199. package/kits/hub-game/models/hats/flower-crown.pxmodel +3 -3
  200. package/kits/hub-game/models/hats/foam-crown.pxmodel +3 -3
  201. package/kits/hub-game/models/hats/hard-hat.pxmodel +3 -3
  202. package/kits/hub-game/models/hats/lantern.pxmodel +3 -3
  203. package/kits/hub-game/models/hats/laurel.pxmodel +3 -3
  204. package/kits/hub-game/models/hats/lighthouse.pxmodel +3 -3
  205. package/kits/hub-game/models/hats/nurse-cap.pxmodel +3 -3
  206. package/kits/hub-game/models/hats/police-cap.pxmodel +3 -3
  207. package/kits/hub-game/models/hats/sailor.pxmodel +3 -3
  208. package/kits/hub-game/models/hats/souwester.pxmodel +3 -3
  209. package/kits/hub-game/models/hats/straw.pxmodel +3 -3
  210. package/kits/hub-game/models/hats/sunflower.pxmodel +3 -3
  211. package/kits/hub-game/models/hats/sweatband.pxmodel +3 -3
  212. package/kits/hub-game/models/hats/teacher-beret.pxmodel +3 -3
  213. package/kits/hub-game/models/hats/witch.pxmodel +3 -3
  214. package/kits/hub-game/models/hold-show/daisy.pxmodel +231 -0
  215. package/kits/hub-game/models/hold-show/moonflower.pxmodel +171 -0
  216. package/kits/hub-game/models/hold-show/rose.pxmodel +191 -0
  217. package/kits/hub-game/models/hold-show/square/daisy.pxmodel +233 -0
  218. package/kits/hub-game/models/hold-show/square/moonflower.pxmodel +173 -0
  219. package/kits/hub-game/models/hold-show/square/rose.pxmodel +193 -0
  220. package/kits/hub-game/models/hold-show/square/sunflower.pxmodel +313 -0
  221. package/kits/hub-game/models/hold-show/square/tulip.pxmodel +133 -0
  222. package/kits/hub-game/models/hold-show/sunflower.pxmodel +311 -0
  223. package/kits/hub-game/models/hold-show/tulip.pxmodel +131 -0
  224. package/kits/hub-game/package-lock.json +3 -3
  225. package/kits/hub-game/package.json +4 -3
  226. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +1 -0
  227. package/kits/hub-game/scripts/fixtures/hud-surface.json +12 -12
  228. package/kits/hub-game/scripts/fixtures/talk-surface.json +8 -8
  229. package/kits/hub-game/scripts/gen-hats.mjs +1 -1
  230. package/kits/hub-game/scripts/gen-hold-show.mjs +27 -0
  231. package/kits/hub-game/scripts/pack.mjs +89 -23
  232. package/kits/hub-game/scripts/test-act-client.mjs +5 -0
  233. package/kits/hub-game/scripts/test-act-core.mjs +32 -0
  234. package/kits/hub-game/scripts/test-act-gate.mjs +186 -0
  235. package/kits/hub-game/scripts/test-action-rail-crowded-dom.mjs +7 -1
  236. package/kits/hub-game/scripts/test-action-rail-default-dom.mjs +102 -0
  237. package/kits/hub-game/scripts/test-action-rail-never-silent-dom.mjs +50 -0
  238. package/kits/hub-game/scripts/test-action-rail-surface.mjs +368 -0
  239. package/kits/hub-game/scripts/test-action-rail-town-jobs-dom.mjs +118 -0
  240. package/kits/hub-game/scripts/test-actions-client.mjs +5 -3
  241. package/kits/hub-game/scripts/test-actions.mjs +24 -0
  242. package/kits/hub-game/scripts/test-actors.mjs +19 -0
  243. package/kits/hub-game/scripts/test-again-corner-dom.mjs +59 -0
  244. package/kits/hub-game/scripts/test-analytics.mjs +80 -1
  245. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +25 -8
  246. package/kits/hub-game/scripts/test-ask-client.mjs +9 -0
  247. package/kits/hub-game/scripts/test-ask-surface.mjs +188 -0
  248. package/kits/hub-game/scripts/test-attention.mjs +43 -1
  249. package/kits/hub-game/scripts/test-ballot-sheet-dom.mjs +71 -0
  250. package/kits/hub-game/scripts/test-ballot-surface.mjs +276 -0
  251. package/kits/hub-game/scripts/test-ballot.mjs +420 -3
  252. package/kits/hub-game/scripts/test-ban-join.mjs +1 -1
  253. package/kits/hub-game/scripts/test-celebrate-client.mjs +62 -0
  254. package/kits/hub-game/scripts/test-celebrate.mjs +116 -0
  255. package/kits/hub-game/scripts/test-chat.mjs +73 -0
  256. package/kits/hub-game/scripts/test-companion-client.mjs +203 -21
  257. package/kits/hub-game/scripts/test-companion.mjs +110 -3
  258. package/kits/hub-game/scripts/test-control-layout-dom.mjs +57 -10
  259. package/kits/hub-game/scripts/test-corner-surface.mjs +268 -0
  260. package/kits/hub-game/scripts/test-decor-client.mjs +59 -3
  261. package/kits/hub-game/scripts/test-decor.mjs +27 -0
  262. package/kits/hub-game/scripts/test-device-class.mjs +4 -1
  263. package/kits/hub-game/scripts/test-disguise-client.mjs +281 -0
  264. package/kits/hub-game/scripts/test-disguise.mjs +176 -0
  265. package/kits/hub-game/scripts/test-dock-surface.mjs +404 -0
  266. package/kits/hub-game/scripts/test-door-analytics.mjs +1 -1
  267. package/kits/hub-game/scripts/test-door-stay-client.mjs +602 -0
  268. package/kits/hub-game/scripts/test-door-stay.mjs +613 -0
  269. package/kits/hub-game/scripts/test-earned-client.mjs +119 -0
  270. package/kits/hub-game/scripts/test-emote-surface.mjs +616 -0
  271. package/kits/hub-game/scripts/test-fps-telemetry.mjs +39 -4
  272. package/kits/hub-game/scripts/test-friend-bests.mjs +38 -12
  273. package/kits/hub-game/scripts/test-ghost-click-dom.mjs +75 -0
  274. package/kits/hub-game/scripts/test-grab-client.mjs +29 -2
  275. package/kits/hub-game/scripts/test-grab-orbit.mjs +260 -11
  276. package/kits/hub-game/scripts/test-grab.mjs +10 -1
  277. package/kits/hub-game/scripts/test-hats.mjs +28 -0
  278. package/kits/hub-game/scripts/test-held-offers.mjs +394 -0
  279. package/kits/hub-game/scripts/test-high-only.mjs +3 -3
  280. package/kits/hub-game/scripts/test-hold-show-client.mjs +175 -0
  281. package/kits/hub-game/scripts/test-hold-show.mjs +355 -0
  282. package/kits/hub-game/scripts/test-hub-controls.mjs +3 -1
  283. package/kits/hub-game/scripts/test-hub-idle.mjs +348 -0
  284. package/kits/hub-game/scripts/test-hub-leaving.mjs +21 -0
  285. package/kits/hub-game/scripts/test-hub-ops.mjs +147 -0
  286. package/kits/hub-game/scripts/test-hub-trip.mjs +260 -5
  287. package/kits/hub-game/scripts/test-hud-clear.mjs +83 -0
  288. package/kits/hub-game/scripts/test-hud-rate.mjs +2 -1
  289. package/kits/hub-game/scripts/test-idle.mjs +160 -0
  290. package/kits/hub-game/scripts/test-invites-client.mjs +53 -0
  291. package/kits/hub-game/scripts/test-labels.mjs +11 -0
  292. package/kits/hub-game/scripts/test-landscape-layout.mjs +20 -0
  293. package/kits/hub-game/scripts/test-load-abandon.mjs +2 -2
  294. package/kits/hub-game/scripts/test-loading-cover.mjs +67 -1
  295. package/kits/hub-game/scripts/test-manifest.mjs +27 -0
  296. package/kits/hub-game/scripts/test-menu-client.mjs +55 -6
  297. package/kits/hub-game/scripts/test-menu-surface.mjs +236 -0
  298. package/kits/hub-game/scripts/test-npcs.mjs +128 -0
  299. package/kits/hub-game/scripts/test-observed.mjs +171 -3
  300. package/kits/hub-game/scripts/test-pack.mjs +166 -0
  301. package/kits/hub-game/scripts/test-picker-surface.mjs +321 -0
  302. package/kits/hub-game/scripts/test-placeat-server.mjs +395 -0
  303. package/kits/hub-game/scripts/test-placement-cache.mjs +1 -1
  304. package/kits/hub-game/scripts/test-pointer-clear-dom.mjs +82 -0
  305. package/kits/hub-game/scripts/test-progress-reset.mjs +184 -6
  306. package/kits/hub-game/scripts/test-push-visit.mjs +9 -0
  307. package/kits/hub-game/scripts/test-quality.mjs +312 -9
  308. package/kits/hub-game/scripts/test-quick-chat-surface.mjs +511 -0
  309. package/kits/hub-game/scripts/test-rehello.mjs +237 -0
  310. package/kits/hub-game/scripts/test-rejoin-yaw.mjs +138 -0
  311. package/kits/hub-game/scripts/test-relations-among.mjs +13 -7
  312. package/kits/hub-game/scripts/test-relations-refresh.mjs +90 -2
  313. package/kits/hub-game/scripts/test-replay-client.mjs +110 -0
  314. package/kits/hub-game/scripts/test-replay.mjs +178 -0
  315. package/kits/hub-game/scripts/test-resume-held.mjs +13 -0
  316. package/kits/hub-game/scripts/test-resume-pose-server.mjs +43 -5
  317. package/kits/hub-game/scripts/test-resync.mjs +13 -0
  318. package/kits/hub-game/scripts/test-role-client.mjs +10 -3
  319. package/kits/hub-game/scripts/test-safe-act.mjs +233 -0
  320. package/kits/hub-game/scripts/test-safe-caption.mjs +364 -0
  321. package/kits/hub-game/scripts/test-safe-layout.mjs +79 -0
  322. package/kits/hub-game/scripts/test-safe-prompt.mjs +163 -0
  323. package/kits/hub-game/scripts/test-sound-surface.mjs +256 -0
  324. package/kits/hub-game/scripts/test-soundscape.mjs +85 -2
  325. package/kits/hub-game/scripts/test-stuck-surface.mjs +174 -0
  326. package/kits/hub-game/scripts/test-stuck.mjs +31 -0
  327. package/kits/hub-game/scripts/test-talk-surface.mjs +23 -6
  328. package/kits/hub-game/scripts/test-talk-walk-dom.mjs +123 -0
  329. package/kits/hub-game/scripts/test-text-ask-surface.mjs +273 -0
  330. package/kits/hub-game/scripts/test-tiers.mjs +453 -3
  331. package/kits/hub-game/scripts/test-toast-no-row-dom.mjs +71 -0
  332. package/kits/hub-game/scripts/test-together.mjs +11 -0
  333. package/kits/hub-game/scripts/test-town-day.mjs +90 -0
  334. package/kits/hub-game/scripts/test-track-queue.mjs +64 -0
  335. package/kits/hub-game/scripts/test-try-on.mjs +39 -0
  336. package/kits/hub-game/scripts/test-ui-dom-dom.mjs +49 -2
  337. package/kits/hub-game/scripts/test-ui-tree.mjs +28 -0
  338. package/kits/hub-game/scripts/test-vehicle-client.mjs +77 -1
  339. package/kits/hub-game/scripts/test-vis.mjs +145 -0
  340. package/kits/hub-game/scripts/test-wallet.mjs +650 -0
  341. package/kits/hub-game/scripts/test-weakest-tier.mjs +135 -1
  342. package/kits/hub-game/scripts/test-world-labels.mjs +380 -0
  343. package/kits/hub-game/scripts/test-writer-lease-server.mjs +234 -0
  344. package/kits/hub-game/scripts/test-writer-lease.mjs +281 -0
  345. package/kits/hub-game/scripts/writer-storage-fixture.mjs +37 -0
  346. package/kits/hub-game/tools/hubScene/export.mjs +6 -5
  347. package/kits/hub-game/tools/hubScene/hubdata.mjs +10 -0
  348. package/kits/hub-game/tools/hubScene/test/export-fixture.mjs +48 -2
  349. package/kits/hub-game/tools/hubScene/validate-manifest.mjs +21 -3
  350. package/kits/multiplayer-3d/castle.json +5 -5
  351. package/kits/multiplayer-3d/code/client/resumeGate.js +49 -2
  352. package/kits/multiplayer-3d/code/server/ownership.js +25 -6
  353. package/kits/multiplayer-3d/code/server/world.js +19 -4
  354. package/kits/multiplayer-3d/code/systems/multiplayer.js +67 -11
  355. package/kits/multiplayer-3d/package-lock.json +1 -1
  356. package/kits/multiplayer-3d/package.json +2 -1
  357. package/kits/multiplayer-3d/scripts/test-ground-half.mjs +56 -0
  358. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +54 -3
  359. package/kits/multiplayer-3d/scripts/test-owned-moves.mjs +190 -0
  360. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +191 -5
  361. package/kits/multiplayer-3d/scripts/test-resync-reconnect.mjs +68 -0
  362. package/kits/physics-2d/castle.json +2 -2
  363. package/kits/physics-2d/engine/scene.js +10 -2
  364. package/kits/physics-3d/CLAUDE.md +14 -0
  365. package/kits/physics-3d/behaviors/Player.jsx +39 -3
  366. package/kits/physics-3d/castle.json +3 -3
  367. package/kits/physics-3d/docs/engine-model-cache.md +109 -0
  368. package/kits/physics-3d/docs/engine-player.md +76 -0
  369. package/kits/physics-3d/docs/engine-skip-work.md +16 -0
  370. package/kits/physics-3d/docs/pxmodel-format.md +5 -1
  371. package/kits/physics-3d/engine3d/gait.js +16 -8
  372. package/kits/physics-3d/engine3d/groundsize.js +23 -0
  373. package/kits/physics-3d/engine3d/kithooks.js +50 -0
  374. package/kits/physics-3d/engine3d/look.js +110 -17
  375. package/kits/physics-3d/engine3d/lookbake.js +19 -1
  376. package/kits/physics-3d/engine3d/materialpresets.js +3 -2
  377. package/kits/physics-3d/engine3d/modelcache.js +280 -0
  378. package/kits/physics-3d/engine3d/modelcachedigest.js +37 -0
  379. package/kits/physics-3d/engine3d/modelcachegate.js +69 -0
  380. package/kits/physics-3d/engine3d/modelrefs.js +13 -0
  381. package/kits/physics-3d/engine3d/optimize.js +20 -9
  382. package/kits/physics-3d/engine3d/playerRun.js +26 -1
  383. package/kits/physics-3d/engine3d/pxmodel.js +7 -3
  384. package/kits/physics-3d/engine3d/templatecache.js +722 -0
  385. package/kits/physics-3d/engine3d/world3d.js +211 -17
  386. package/kits/physics-3d/package-lock.json +1 -1
  387. package/kits/physics-3d/package.json +2 -1
  388. package/kits/physics-3d/play/behaviors/Player.js +43 -3
  389. package/kits/physics-3d/scripts/render.mjs +56 -8
  390. package/kits/physics-3d/scripts/template-cache-fixtures.mjs +37 -0
  391. package/kits/physics-3d/scripts/template-cache-v1-bytes.json +49 -0
  392. package/kits/physics-3d/scripts/test-gait.mjs +53 -9
  393. package/kits/physics-3d/scripts/test-ground-half.mjs +120 -0
  394. package/kits/physics-3d/scripts/test-model-cache.mjs +600 -0
  395. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1 -0
  396. package/kits/physics-3d/scripts/test-sleeping-models.mjs +384 -0
  397. package/kits/physics-3d/scripts/test-template-cache-minified.mjs +106 -0
  398. package/kits/physics-3d/scripts/test-template-cache.mjs +519 -0
  399. package/kits/physics-3d/scripts/test-wall-slide.mjs +272 -0
  400. package/kits/physics-3d/systems/physics3d.js +51 -2
  401. package/kits/real-time/castle.json +2 -2
  402. package/kits/real-time/code/client/connection.js +3 -0
  403. package/package.json +2 -2
  404. package/vendor/three/examples/jsm/libs/fflate.module.js +2672 -0
package/dist/save-deck.js CHANGED
@@ -5,7 +5,7 @@ import { spawn } from 'child_process';
5
5
  import { nanoid } from 'nanoid';
6
6
  import * as api from './api.js';
7
7
  import * as config from './config.js';
8
- import { bundleProject, bundleProjectChunked } from './bundle.js';
8
+ import { bundleProject, bundleProjectChunked, ExternalMedia, } from './bundle.js';
9
9
  import { resolveBundleChunks, resolveServerConfig, serverBundleConfig, validateExperiments, } from './castleJson.js';
10
10
  import { importChecksFailedMessage, runImportChecks } from './importCheckHook.js';
11
11
  import { selectSaveCover } from './saveCover.js';
@@ -32,6 +32,9 @@ export const SOURCE_ARCHIVE_EXCLUDES = ['node_modules', 'dist', '.castle', '.git
32
32
  // independently deployable.
33
33
  export const SAVE_STAGE_TELEMETRY_PREFIX = 'CASTLE_SAVE_TELEMETRY ';
34
34
  export const SAVE_COVER_SELECTION_TELEMETRY_PREFIX = 'CASTLE_SAVE_COVER_SELECTION ';
35
+ // One record per save whose media stayed inline when the build had named it by URL, so central
36
+ // logs can count what the console line alone only tells the person saving. Opt-in like the rest.
37
+ export const SAVE_ASSET_INLINE_TELEMETRY_PREFIX = 'CASTLE_SAVE_ASSET_INLINE ';
35
38
  // Long enough to move a payload at either cap over a slow uplink (100 MB at ~3 Mbit/s).
36
39
  const LARGE_UPLOAD_TIMEOUT_MS = 300_000;
37
40
  let failedStage = null;
@@ -154,7 +157,11 @@ export async function downloadSourceArchive(source, namePrefix, log = console.lo
154
157
  }
155
158
  async function uploadPresignedFile(uploadConfig, file, contentType, timeoutMs, label) {
156
159
  const formData = new FormData();
157
- formData.append('Content-Type', contentType);
160
+ // Once: a grant that names the type itself (an audio asset's does, and S3
161
+ // holds the upload to it exactly) refuses a second Content-Type field.
162
+ if (!Object.keys(uploadConfig.postFields).some((key) => key.toLowerCase() === 'content-type')) {
163
+ formData.append('Content-Type', contentType);
164
+ }
158
165
  for (const [key, value] of Object.entries(uploadConfig.postFields)) {
159
166
  formData.append(key, String(value));
160
167
  }
@@ -389,7 +396,7 @@ export const MAX_BUNDLE_CHUNK_BYTES = 8 * 1024 * 1024;
389
396
  // Ghost stores at most two chunks at once per app process (Amendment 2 of the
390
397
  // chunk contract); more in flight only buys CAULDRON_BUNDLE_CHUNK_BUSY retries.
391
398
  const CHUNK_UPLOAD_CONCURRENCY = 2;
392
- async function chunkAlreadyStored(url) {
399
+ async function alreadyStored(url) {
393
400
  try {
394
401
  const res = await fetch(url, { method: 'HEAD', signal: AbortSignal.timeout(15_000) });
395
402
  return res.status === 200;
@@ -402,34 +409,26 @@ async function chunkAlreadyStored(url) {
402
409
  // Ghost spends an upload grant before it reads the upload, so a grant that
403
410
  // turned out invalid can only be retried from a new upload config.
404
411
  const UPLOAD_GRANT_INVALID = 'CAULDRON_SERVER_BUNDLE_UPLOAD_GRANT_INVALID';
405
- // Ghost is storing as many chunks as it will at once. Nothing was spent: the
406
- // same upload is stored again after a wait, these waits, then the save fails.
412
+ // Ghost is storing as many chunks (or assets) as it will at once. Nothing was
413
+ // spent: the same upload is stored again after a wait, these waits, then the
414
+ // save fails.
407
415
  const CHUNK_BUSY = 'CAULDRON_BUNDLE_CHUNK_BUSY';
416
+ const ASSET_BUSY = 'CAULDRON_ASSET_BUSY';
408
417
  export const CHUNK_BUSY_RETRY_MS = [500, 1000, 2000, 4000];
409
418
  const errorCode = (e) => e?.extensions?.code;
410
- async function storeWhenNotBusy(store, retryMs) {
419
+ async function storeWhenNotBusy(store, retryMs, busyCode) {
411
420
  for (let attempt = 0;; attempt++) {
412
421
  try {
413
422
  return await store();
414
423
  }
415
424
  catch (e) {
416
- if (errorCode(e) !== CHUNK_BUSY || attempt >= retryMs.length)
425
+ if (errorCode(e) !== busyCode || attempt >= retryMs.length)
417
426
  throw e;
418
427
  await new Promise((resolve) => setTimeout(resolve, retryMs[attempt]));
419
428
  }
420
429
  }
421
430
  }
422
- async function storeBundleChunk(deckId, chunk, busyRetryMs) {
423
- const contentType = chunk.kind === 'wasm' ? 'application/wasm' : 'application/javascript';
424
- const attempt = async () => {
425
- const config = await api.createCauldronBundleChunkUploadConfig(deckId);
426
- // FormData wants a Blob; copy so it does not share the Buffer's pool.
427
- const view = new Uint8Array(chunk.bytes.byteLength);
428
- view.set(chunk.bytes);
429
- await uploadPresignedFile(config, new Blob([view], { type: contentType }), contentType, LARGE_UPLOAD_TIMEOUT_MS, `Chunk upload (${chunk.name})`);
430
- const kind = chunk.kind === 'wasm' ? 'WASM' : 'JS';
431
- return storeWhenNotBusy(() => api.storeCauldronBundleChunk(deckId, config.uploadId, chunk.sha256, kind), busyRetryMs);
432
- };
431
+ async function againIfGrantInvalid(attempt) {
433
432
  try {
434
433
  return await attempt();
435
434
  }
@@ -439,6 +438,38 @@ async function storeBundleChunk(deckId, chunk, busyRetryMs) {
439
438
  return attempt();
440
439
  }
441
440
  }
441
+ // FormData wants a Blob; copy so it does not share the Buffer's pool.
442
+ function blobOf(bytes, contentType) {
443
+ const view = new Uint8Array(bytes.byteLength);
444
+ view.set(bytes);
445
+ return new Blob([view], { type: contentType });
446
+ }
447
+ /**
448
+ * Runs `each` over `items`, at most `limit` at once. The first failure is
449
+ * thrown, and once one has failed no worker takes a new item.
450
+ */
451
+ async function forEachAtMost(items, limit, each) {
452
+ const queue = [...items];
453
+ let failed = false;
454
+ const worker = async () => {
455
+ for (let item = queue.shift(); item !== undefined && !failed; item = queue.shift())
456
+ await each(item);
457
+ };
458
+ const guarded = () => worker().catch((e) => {
459
+ failed = true;
460
+ throw e;
461
+ });
462
+ await Promise.all(Array.from({ length: Math.min(limit, items.length) }, guarded));
463
+ }
464
+ async function storeBundleChunk(deckId, chunk, busyRetryMs) {
465
+ const contentType = chunk.kind === 'wasm' ? 'application/wasm' : 'application/javascript';
466
+ return againIfGrantInvalid(async () => {
467
+ const config = await api.createCauldronBundleChunkUploadConfig(deckId);
468
+ await uploadPresignedFile(config, blobOf(chunk.bytes, contentType), contentType, LARGE_UPLOAD_TIMEOUT_MS, `Chunk upload (${chunk.name})`);
469
+ const kind = chunk.kind === 'wasm' ? 'WASM' : 'JS';
470
+ return storeWhenNotBusy(() => api.storeCauldronBundleChunk(deckId, config.uploadId, chunk.sha256, kind), busyRetryMs, CHUNK_BUSY);
471
+ });
472
+ }
442
473
  /**
443
474
  * Puts every chunk at its content-addressed URL: a chunk already there (HEAD
444
475
  * 200) is skipped, any other is uploaded and stored. Throws on the first chunk
@@ -454,30 +485,131 @@ export async function uploadBundleChunks(deckId, chunks, baseUrl = BUNDLE_CHUNK_
454
485
  }
455
486
  }
456
487
  const result = { uploaded: 0, skipped: 0, bytesUploaded: 0 };
457
- const queue = [...chunks];
458
- // The first failure fails the save: the other workers take no new chunk.
459
- let failed = false;
460
- const worker = async () => {
461
- for (let chunk = queue.shift(); chunk && !failed; chunk = queue.shift()) {
462
- const url = `${baseUrl}${chunk.fileName}`;
463
- if (await chunkAlreadyStored(url)) {
488
+ await forEachAtMost(chunks, CHUNK_UPLOAD_CONCURRENCY, async (chunk) => {
489
+ const url = `${baseUrl}${chunk.fileName}`;
490
+ if (await alreadyStored(url)) {
491
+ result.skipped++;
492
+ return;
493
+ }
494
+ const stored = await storeBundleChunk(deckId, chunk, busyRetryMs);
495
+ if (stored?.sha256 !== chunk.sha256 || stored.url !== url) {
496
+ throw new Error(`Chunk ${chunk.name} was stored as ${stored?.url ?? 'nothing'} (sha256 ${stored?.sha256 ?? 'none'}), ` +
497
+ `not ${url}. Nothing was published.`);
498
+ }
499
+ result.uploaded++;
500
+ result.bytesUploaded += chunk.bytes.byteLength;
501
+ });
502
+ return result;
503
+ }
504
+ // Ghost's per-asset cap.
505
+ export const MAX_MEDIA_ASSET_BYTES = 50 * 1024 * 1024;
506
+ // Ghost stores at most two assets at once per app process, counted apart from chunks.
507
+ const ASSET_UPLOAD_CONCURRENCY = 2;
508
+ // A file Ghost will not store (a type it does not take, not the file its type
509
+ // says, or too big): it stays inline, and the rest of the save goes on. So do
510
+ // files past the user's hourly asset-upload limit (RATE_LIMIT_EXCEEDED): once
511
+ // Ghost answers that, no further file is offered this save, and every one not
512
+ // already stored stays inline.
513
+ const ASSET_INVALID = 'CAULDRON_ASSET_INVALID';
514
+ const ASSET_TOO_LARGE = 'CAULDRON_ASSET_TOO_LARGE';
515
+ const ASSET_RATE_LIMITED = 'RATE_LIMIT_EXCEEDED';
516
+ const ASSET_REFUSED = new Set([ASSET_INVALID, ASSET_TOO_LARGE, ASSET_RATE_LIMITED]);
517
+ /** Raised inside a worker when this Ghost has no asset store; the upload answers null. */
518
+ class AssetsUnsupported extends Error {
519
+ }
520
+ async function storeMediaAsset(deckId, asset, busyRetryMs) {
521
+ return againIfGrantInvalid(async () => {
522
+ const config = await api.createCauldronAssetUploadConfig(deckId, asset.contentType);
523
+ if (!config)
524
+ throw new AssetsUnsupported();
525
+ await uploadPresignedFile(config, blobOf(asset.bytes, asset.contentType), asset.contentType, LARGE_UPLOAD_TIMEOUT_MS, `Media upload (${asset.sha256.slice(0, 12)})`);
526
+ const stored = await storeWhenNotBusy(() => api.storeCauldronAsset(deckId, config.uploadId, asset.sha256, asset.contentType), busyRetryMs, ASSET_BUSY);
527
+ if (!stored)
528
+ throw new AssetsUnsupported();
529
+ return stored;
530
+ });
531
+ }
532
+ // Stored is not yet served: the CDN in front of the store may not cover the
533
+ // asset prefix (seen live: every asset URL answered 403), or may lag the
534
+ // write. Each newly stored asset is fetched once through the CDN, these waits
535
+ // apart, before a page naming it is published.
536
+ export const ASSET_SERVED_RETRY_MS = [1000, 2000];
537
+ async function assetServed(url) {
538
+ try {
539
+ const res = await fetch(url, { headers: { Range: 'bytes=0-0' }, signal: AbortSignal.timeout(15_000) });
540
+ await res.body?.cancel();
541
+ return res.status === 200 || res.status === 206;
542
+ }
543
+ catch {
544
+ return false;
545
+ }
546
+ }
547
+ /** True once every URL is served through the CDN, trying again after each wait. Exported for the tests. */
548
+ export async function assetsServed(urls, retryMs = ASSET_SERVED_RETRY_MS) {
549
+ let pending = urls;
550
+ for (let attempt = 0;; attempt++) {
551
+ const served = await Promise.all(pending.map(assetServed));
552
+ pending = pending.filter((_, i) => !served[i]);
553
+ if (pending.length === 0)
554
+ return true;
555
+ if (attempt >= retryMs.length)
556
+ return false;
557
+ await new Promise((resolve) => setTimeout(resolve, retryMs[attempt]));
558
+ }
559
+ }
560
+ /**
561
+ * Puts every media asset the page names at its URL, as uploadBundleChunks does
562
+ * chunks: one already there (HEAD 200) is skipped, any other uploaded and
563
+ * stored, and the first that cannot be stored fails the save before the page
564
+ * is published -- except one Ghost refuses (ASSET_REFUSED), which is reported
565
+ * in `refused` for the caller to inline. Null when this Ghost has no asset
566
+ * store: the caller builds the page with its media inline instead.
567
+ * Exported for the tests.
568
+ */
569
+ export async function uploadMediaAssets(deckId, assets, { busyRetryMs = CHUNK_BUSY_RETRY_MS } = {}) {
570
+ const result = { uploaded: 0, skipped: 0, bytesUploaded: 0, storedUrls: [], refused: [] };
571
+ let rateLimited = false;
572
+ try {
573
+ await forEachAtMost(assets, ASSET_UPLOAD_CONCURRENCY, async (asset) => {
574
+ if (asset.bytes.byteLength > MAX_MEDIA_ASSET_BYTES) {
575
+ result.refused.push({ asset, code: ASSET_TOO_LARGE });
576
+ return;
577
+ }
578
+ if (await alreadyStored(asset.url)) {
464
579
  result.skipped++;
465
- continue;
580
+ return;
581
+ }
582
+ if (rateLimited) {
583
+ result.refused.push({ asset, code: ASSET_RATE_LIMITED });
584
+ return;
585
+ }
586
+ let stored;
587
+ try {
588
+ stored = await storeMediaAsset(deckId, asset, busyRetryMs);
589
+ }
590
+ catch (e) {
591
+ const code = errorCode(e);
592
+ if (!code || !ASSET_REFUSED.has(code))
593
+ throw e;
594
+ if (code === ASSET_RATE_LIMITED)
595
+ rateLimited = true;
596
+ result.refused.push({ asset, code });
597
+ return;
466
598
  }
467
- const stored = await storeBundleChunk(deckId, chunk, busyRetryMs);
468
- if (stored?.sha256 !== chunk.sha256 || stored.url !== url) {
469
- throw new Error(`Chunk ${chunk.name} was stored as ${stored?.url ?? 'nothing'} (sha256 ${stored?.sha256 ?? 'none'}), ` +
470
- `not ${url}. Nothing was published.`);
599
+ if (stored?.sha256 !== asset.sha256 || stored.url !== asset.url) {
600
+ throw new Error(`A media file was stored as ${stored?.url ?? 'nothing'} (sha256 ${stored?.sha256 ?? 'none'}), ` +
601
+ `not ${asset.url}. Nothing was published.`);
471
602
  }
472
603
  result.uploaded++;
473
- result.bytesUploaded += chunk.bytes.byteLength;
474
- }
475
- };
476
- const guarded = () => worker().catch((e) => {
477
- failed = true;
604
+ result.bytesUploaded += asset.bytes.byteLength;
605
+ result.storedUrls.push(asset.url);
606
+ });
607
+ }
608
+ catch (e) {
609
+ if (e instanceof AssetsUnsupported)
610
+ return null;
478
611
  throw e;
479
- });
480
- await Promise.all(Array.from({ length: Math.min(CHUNK_UPLOAD_CONCURRENCY, chunks.length) }, guarded));
612
+ }
481
613
  return result;
482
614
  }
483
615
  function reportChunks(page) {
@@ -493,6 +625,67 @@ async function storeChunks(deckId, chunks) {
493
625
  const stored = await traceSaveStage('chunk_upload', () => uploadBundleChunks(deckId, chunks), (value) => ({ bytes: value.bytesUploaded }));
494
626
  console.log(`Chunks stored: ${stored.uploaded} uploaded, ${stored.skipped} already there.`);
495
627
  }
628
+ function emitAssetInline(reason, inlined) {
629
+ if (process.env.CASTLE_SAVE_STAGE_TELEMETRY !== '1')
630
+ return;
631
+ console.log(`${SAVE_ASSET_INLINE_TELEMETRY_PREFIX}${JSON.stringify({
632
+ event: 'castle_web_save_asset_inline',
633
+ reason,
634
+ files: inlined.length,
635
+ bytes: inlined.reduce((sum, a) => sum + a.bytes.byteLength, 0),
636
+ })}`);
637
+ }
638
+ // Stores the media a page names by URL, and answers the page to publish: that
639
+ // page (which carries the CORS shim the build put in), the deck built again with a file
640
+ // Ghost refused left inline, or -- when this Ghost has no asset store, or its
641
+ // CDN does not serve what was stored -- the deck built again with all its
642
+ // media inline, exactly as a save did before.
643
+ async function storeExternalMedia(deckId, projectDir, html, externalMedia) {
644
+ const exclude = new Set();
645
+ // Files Ghost refused in earlier rounds, already inline in `html`.
646
+ const refused = [];
647
+ const reportRefused = () => {
648
+ if (refused.length > 0)
649
+ emitAssetInline('refused', refused);
650
+ };
651
+ for (;;) {
652
+ const assets = externalMedia.assetsIn(html);
653
+ if (assets.length === 0) {
654
+ reportRefused();
655
+ return html;
656
+ }
657
+ const stored = await traceSaveStage('asset_upload', () => uploadMediaAssets(deckId, assets), (value) => ({ bytes: value?.bytesUploaded ?? 0 }));
658
+ const inline = (line) => {
659
+ console.log(line);
660
+ return traceSaveStage('bundle', () => bundleProject(projectDir), (value) => ({ bytes: Buffer.byteLength(value) }));
661
+ };
662
+ if (!stored) {
663
+ emitAssetInline('no_store', [...refused, ...assets]);
664
+ return inline('Castle cannot serve media files by URL yet; bundling them inline.');
665
+ }
666
+ // One already there answered 200 to its HEAD, through the same CDN.
667
+ if (!(await assetsServed(stored.storedUrls))) {
668
+ emitAssetInline('cdn_not_serving', [...refused, ...assets]);
669
+ return inline("Castle's CDN is not serving uploaded media yet; keeping media inline.");
670
+ }
671
+ if (stored.refused.length === 0) {
672
+ const mb = assets.reduce((sum, a) => sum + a.bytes.byteLength, 0) / 1024 / 1024;
673
+ console.log(`Media: ${assets.length} file${assets.length === 1 ? '' : 's'} (${mb.toFixed(1)}MB) served from Castle's CDN ` +
674
+ `instead of inlined (${stored.uploaded} uploaded, ${stored.skipped} already there).`);
675
+ reportRefused();
676
+ return html;
677
+ }
678
+ // Each round inlines at least one more file, so this ends.
679
+ for (const { asset, code } of stored.refused) {
680
+ exclude.add(asset.sha256);
681
+ refused.push(asset);
682
+ console.log(`Media file ${asset.source} stays inline: Castle refused to store it (${code}).`);
683
+ }
684
+ const rebuilt = new ExternalMedia(undefined, exclude);
685
+ html = await traceSaveStage('bundle', () => bundleProject(projectDir, { externalMedia: rebuilt }), (value) => ({ bytes: Buffer.byteLength(value) }));
686
+ externalMedia = rebuilt;
687
+ }
688
+ }
496
689
  // Checked before anything is bundled or published, like the experiments block.
497
690
  function checkedBundleChunks(castleJson, opts) {
498
691
  try {
@@ -672,19 +865,27 @@ async function saveDeckAfterValidation(dir, opts, projectDir, visibility) {
672
865
  }
673
866
  }
674
867
  console.log('Bundling...');
868
+ // Media is named by its CDN URL in the single file (bundle.ts
869
+ // ExternalMedia). Ghost grants asset uploads only for a deck that exists, so
870
+ // a new deck's first save keeps its media inline, as before.
871
+ const externalMedia = !chunked && existingDeckId ? new ExternalMedia() : null;
675
872
  // The imports' `onCheck`s run inside the bundle stage, after the bundle and
676
873
  // before anything is uploaded: a deck its kit refuses is a deck that did not
677
874
  // build, as far as publishing is concerned (and as castle-www's failed_at
678
875
  // reports it).
679
876
  const built = await traceSaveStage('bundle', async () => {
680
877
  const page = chunked ? await bundleProjectChunked(projectDir) : null;
681
- const html = page ? page.renderHtml(BUNDLE_CHUNK_BASE_URL) : await bundleProject(projectDir);
878
+ const html = page ? page.renderHtml(BUNDLE_CHUNK_BASE_URL) : await bundleProject(projectDir, { externalMedia });
682
879
  const { errors } = await runImportChecks(projectDir);
683
880
  if (errors.length > 0)
684
881
  throw new Error(importChecksFailedMessage(errors));
685
882
  return { html, page, pack: await buildContentPack(projectDir) };
686
883
  }, (value) => ({ bytes: Buffer.byteLength(value.html) }));
687
- const { html: bundle, page: chunkedPage, pack } = built;
884
+ const { page: chunkedPage, pack } = built;
885
+ // Every media file the page names is stored before anything is published.
886
+ const bundle = externalMedia && existingDeckId
887
+ ? await storeExternalMedia(existingDeckId, projectDir, built.html, externalMedia)
888
+ : built.html;
688
889
  if (pack)
689
890
  console.log(`Content pack: ${pack.summary ?? `${pack.bytes.byteLength} bytes`} (${pack.sha256.slice(0, 12)}).`);
690
891
  // In chunked mode this is the page alone: the chunks load as separate,
@@ -14,9 +14,10 @@ that framework provides. This one is true either way.
14
14
 
15
15
  <!-- Injected into Castle's create assistant every turn; keep this compact and factual. -->
16
16
 
17
- - `import { setup, initCard } from 'castle-web-sdk'`. Call `setup()` first, once; `initCard()` returns the element to render into (a React tree mounted at `#root` needs no `initCard`). Castle services — `Store`, `Leaderboard`, `Time`, `User`, `Haptics`, `Pass`, `Snapshot`, `Portal`, `Multiplayer`, `Lifecycle` — come from the same package. `Store` is how a deck saves anything; the older `Storage`/`SharedStorage` still work but should not be used in new decks; the full reference is `imports/castle.base/sdk/README.md`.
17
+ - `import { setup, initCard } from 'castle-web-sdk'`. Call `setup()` first, once; `initCard()` returns the element to render into (a React tree mounted at `#root` needs no `initCard`). Castle services — `Store`, `Leaderboard`, `Analytics`, `Time`, `User`, `Haptics`, `Pass`, `Snapshot`, `Portal`, `Multiplayer`, `Lifecycle` — come from the same package. `Store` is how a deck saves anything; the older `Storage`/`SharedStorage` still work but should not be used in new decks; the full reference is `imports/castle.base/sdk/README.md`.
18
18
  - `Agent.chat({ messages, tools?, toolChoice?, model?, maxTokens?, reasoning?, onDelta?, signal? })` gets one chat completion from a language model (OpenAI message and tool format, default model `meta/muse-spark-1.3-contributor`; any OpenRouter model id with a per-token price) through Castle's deck-agent service, paid from the player's daily play allowance that characters share. `onDelta` streams text and reasoning pieces and each finished tool call; `signal` cancels; `reasoning: { effort: 'minimal' | 'low' | 'medium' | 'high' }` sets how hard the model thinks, and minimal answers soonest. It resolves with the whole `message`: the deck runs any `tool_calls` itself, appends the message unchanged (it can carry the model's `reasoning_details`) and the `tool` results, and calls again. Castle admins and players given access only: other players get `refused`; a player whose allowance for the day is spent gets `allowance_exhausted` (it resets at midnight UTC).
19
19
  - `Decks.mine({ limit? })` and `Decks.saved({ limit? })` list decks a portal can lead to (the player's published decks; their bookmarks and playlists) as `{ deckId, title, creator, coverUrl }`, with `coverUrl` a `data:` url. Use them to offer a portal destination picker. Admin only: other players get a `PERMISSION_DENIED` error.
20
+ - `Rooms.list()` returns this deck's public multiplayer rooms as `{ total, rooms: [{ sessionId, routeId?, slot?, players, maxPlayers }] }`, counted about every 10 s, so a lobby needs no per-room player count in `Store`. The deck's owner and Castle admins always get a list and other players only as far as Castle has rolled presence out; a player under 13 or kept out of multiplayer, a player outside that rollout, and an app built before the call get `null` ("not available", not "no rooms").
20
21
  - What each service cannot do is in that README beside the service: `Store` / `Storage` size caps (no media in storage), the Castle app build a command needs (older builds reject it with `UNKNOWN_COMMAND`), no clipboard command, no call that sets the deck's cover. Read it before telling someone a service can or cannot do something.
21
22
  - The SDK is a file of this import, not an npm package: `castle-web-sdk` resolves here. Nothing needs installing, and nothing in a deck's `package.json` names it.
22
23
  - Vite serves and bundles the deck: ES modules, JSX, JSON, CSS and npm packages all work with no build step of your own — don't add one.
@@ -82,7 +82,7 @@
82
82
  "title": "base",
83
83
  "deckId": "yRcmH4_aYllE",
84
84
  "cardId": "zkFdingmIm3m",
85
- "publishedVersion": "2026-10-21T18:36:51.857Z",
85
+ "publishedVersion": "2026-11-15T00:40:25.157Z",
86
86
  "provides": [
87
87
  "castle-web-sdk"
88
88
  ]