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
package/dist/agent.js CHANGED
@@ -31,7 +31,7 @@ import { nanoid } from 'nanoid';
31
31
  import { WebSocketServer } from 'ws';
32
32
  import { rawDataToString } from './rawData.js';
33
33
  import { extractDirectives, meansAll, closedPrefLines, parsePrefLines, parseTaskFenceBody, resolveTargets, taskFenceRegex, } from './routerFences.js';
34
- import { isPendingSteer, newTaskSteer, normalizeSteers, replayedUuid, steerBoardNote, steerMessageText, streamUserLine, } from './taskSteer.js';
34
+ import { followUpDirective, isPendingSteer, newTaskSteer, normalizeSteers, replayedUuid, steerBoardNote, steerMessageText, streamUserLine, } from './taskSteer.js';
35
35
  import { carriesStopNotes, recentStops, stopNotes, } from './routerStops.js';
36
36
  import { badTaskEndingsSince, platformInterruptionReason, ROUTER_STOPPED_RESULT, withTimeoutReport, } from './routerTaskEndings.js';
37
37
  import { HANDOFF_MAX_CHARS, HANDOFF_MAX_LIST, noDeckFiles, quotableTaskText, routerPromptTask, summarizeTaskResult, } from './routerTaskReport.js';
@@ -42,7 +42,7 @@ import { readGitIncomingNote, removeGitIncoming } from './gitIncoming.js';
42
42
  import { applyPlanOps, buildRouterPromptParts, buildTaskPrompt, parsePlanOps, userTurnInstruction, CLAUDE_TASK_SYSTEM_REMINDER, modelTaskAddendum, isMuseModel, } from './agent-prompts.js';
43
43
  import { readCastleJson } from './castleJson.js';
44
44
  import { checkOpenrouterKey, checkOpenrouterModel, primeOpenrouterCatalog, } from './openrouter-catalog.js';
45
- import { classifyProviderError, failureCopy, failureLabel, routerTaskError, setReaderTimeZone, } from './agent-failures.js';
45
+ import { classifyProviderError, failureCopy, failureLabel, routerTaskError, routerTurnRetryable, routerTurnErrorText, setReaderTimeZone, } from './agent-failures.js';
46
46
  import { castleCreditsExhausted, createBudgetRefreshRetry, createRefreshQueue, fetchAiCredits, fetchBudget, freeRolesFor, freeTierForRoles, meteringHeaders, modelIsFree, newAgentSessionId, spendableMicros, withCustomHeaders, } from './metering.js';
47
47
  import { anthropicKeyHelperCommand, resolveAnthropicAuth, userKey, ANTHROPIC_CREDENTIAL_ENV, ANTHROPIC_PROXY_ENV, CASTLE_USER_KEYS_PATH, } from './byo-auth.js';
48
48
  import { accountsSnapshot, loginProviderFor, watchCredentials, writeCredential, } from './byo-accounts.js';
@@ -505,7 +505,7 @@ export const RESUME_MAX_AGE_MS = 12 * 60 * 60_000;
505
505
  // How long a killed run's stdout may take to drain before its timeout settles
506
506
  // anyway (runAgentCli).
507
507
  const TIMEOUT_DRAIN_MS = 5_000;
508
- const MAX_TASK_ATTEMPTS = 3;
508
+ export const MAX_TASK_ATTEMPTS = 3;
509
509
  // Cap on task agents running at once -- keeps us under e2b / provider rate
510
510
  // limits. Over-cap tasks stay queued ('waiting') and start, earliest-created
511
511
  // first, as running ones finish. Conservative default; override via env.
@@ -1474,6 +1474,8 @@ function runAgentCli(opts) {
1474
1474
  settle({
1475
1475
  ok,
1476
1476
  finalText: state.finalText || state.accumulated,
1477
+ finalTextFromResult: state.finalTextFromResult,
1478
+ streamedChars: state.accumulated.length,
1477
1479
  error: ok ? undefined : 'agent run timed out',
1478
1480
  usage: state.usage,
1479
1481
  stats: state.stats,
@@ -1587,6 +1589,7 @@ function runAgentCli(opts) {
1587
1589
  ok,
1588
1590
  finalText: state.finalText || state.accumulated,
1589
1591
  finalTextFromResult: state.finalTextFromResult,
1592
+ streamedChars: state.accumulated.length,
1590
1593
  usage: state.usage,
1591
1594
  stats: state.stats,
1592
1595
  sessionId: state.sessionId,
@@ -2349,6 +2352,7 @@ function claudeSessionIdOf(taskDir) {
2349
2352
  return undefined;
2350
2353
  }
2351
2354
  const RESUME_TASK_PROMPT = 'The workspace restarted while you were working on this task and your run was cut off. Check what you already changed on disk, then finish the task and report exactly as the original instructions say.';
2355
+ const RESUME_AFTER_FLAP_PROMPT = 'Your last request to the model was refused by a temporary provider error and your run was cut off. Check what you already changed on disk, then finish the task and report exactly as the original instructions say.';
2352
2356
  const FRESH_AFTER_INTERRUPTION_PREFIX = 'A previous run was cut off and part of the work may already be on disk, so check before redoing it.';
2353
2357
  const WRAP_UP_PROMPT = 'You ran out of time and were stopped. Make no more changes. In a few sentences say what is done, what is left, and whether the deck is in a working state.';
2354
2358
  function missingResumeSession(result) {
@@ -2606,6 +2610,8 @@ async function runTaskAgentIn(ctx, task) {
2606
2610
  };
2607
2611
  const resuming = task.interruptedFrom === 'running' && (task.resumeCount ?? 0) > 0;
2608
2612
  let resumeSessionId = resuming ? claudeSessionIdOf(dir) : undefined;
2613
+ let resumePrompt = RESUME_TASK_PROMPT;
2614
+ let restartedAfterMissingSession = false;
2609
2615
  const freshPrompt = resuming ? `${FRESH_AFTER_INTERRUPTION_PREFIX}\n\n${taskPrompt}` : taskPrompt;
2610
2616
  for (let attempt = 1; attempt <= MAX_TASK_ATTEMPTS; attempt++) {
2611
2617
  // A resumed session already holds the messages it was given; a fresh
@@ -2615,7 +2621,7 @@ async function runTaskAgentIn(ctx, task) {
2615
2621
  promptUuid: randomUUID(),
2616
2622
  resend: (steer) => (resumed ? isPendingSteer(steer) : steer.state !== 'undelivered'),
2617
2623
  });
2618
- result = await runOnce(resumed ? RESUME_TASK_PROMPT : freshPrompt, {
2624
+ result = await runOnce(resumed ? resumePrompt : freshPrompt, {
2619
2625
  timeoutMs: TASK_TIMEOUT_MS,
2620
2626
  stdin,
2621
2627
  resumeSessionId,
@@ -2625,13 +2631,26 @@ async function runTaskAgentIn(ctx, task) {
2625
2631
  return result;
2626
2632
  if (resumeSessionId && missingResumeSession(result)) {
2627
2633
  resumeSessionId = undefined;
2628
- // The fresh run gets a full set of attempts, even when the missing
2629
- // session only surfaced after resume crashes had used some up.
2630
- attempt = 0;
2634
+ // The first missing session gets a full fresh budget even after resume
2635
+ // crashes; resetting again would let flaps with missing sessions loop forever.
2636
+ if (!restartedAfterMissingSession) {
2637
+ restartedAfterMissingSession = true;
2638
+ attempt = 0;
2639
+ }
2631
2640
  continue;
2632
2641
  }
2633
2642
  if (result.timedOut)
2634
2643
  return finishTimedOut(result);
2644
+ if (result.failure?.upstreamFlap && attempt < MAX_TASK_ATTEMPTS) {
2645
+ resumeSessionId = result.sessionId ?? claudeSessionIdOf(dir);
2646
+ if (resumeSessionId) {
2647
+ resumePrompt = RESUME_AFTER_FLAP_PROMPT;
2648
+ ctx.onRetry(attempt + 1);
2649
+ if (await waitBeforeTaskRetry(attempt, ctx.stopRequested, task.id))
2650
+ return result;
2651
+ continue;
2652
+ }
2653
+ }
2635
2654
  if (!result.crashed)
2636
2655
  return resumeForLateSteers(ctx, task, result, runOnce);
2637
2656
  // A crash normally means "the process died, try again" -- but a claude CLI
@@ -2675,8 +2694,8 @@ async function resumeForLateSteers(ctx, task, first, runOnce) {
2675
2694
  }
2676
2695
  // One resume of `sessionId` carrying the oldest pending message. Every message
2677
2696
  // it did not finish a turn on is still pending when it ends, so a retry -- for
2678
- // any end but a provider's error result or a config failure -- carries them
2679
- // all again.
2697
+ // any end but a provider's error result (except lookup flaps) or a config
2698
+ // failure -- carries them all again.
2680
2699
  async function resumeOnce(ctx, task, sessionId, runOnce) {
2681
2700
  let next = { ok: false, finalText: '', error: 'not run' };
2682
2701
  for (let attempt = 1; attempt <= MAX_TASK_ATTEMPTS; attempt++) {
@@ -2691,7 +2710,7 @@ async function resumeOnce(ctx, task, sessionId, runOnce) {
2691
2710
  });
2692
2711
  next = await runOnce(steerMessageText(lead.text), { timeoutMs: TASK_TIMEOUT_MS, stdin, resumeSessionId: sessionId });
2693
2712
  logAgentUsage(`task ${task.id} resume`, next.usage);
2694
- const final = next.ok || next.resultError || next.timedOut || next.failure?.kind === 'config';
2713
+ const final = next.ok || (next.resultError && !next.failure?.upstreamFlap) || next.timedOut || next.failure?.kind === 'config';
2695
2714
  if (final || ctx.stopRequested.has(task.id))
2696
2715
  return next;
2697
2716
  if (attempt < MAX_TASK_ATTEMPTS && (await waitBeforeTaskRetry(attempt, ctx.stopRequested, task.id)))
@@ -2722,6 +2741,27 @@ function heldForFromReply(messageId, text) {
2722
2741
  chips,
2723
2742
  };
2724
2743
  }
2744
+ function releaseHeldTask(task, answer, touch, maybeStart) {
2745
+ if (task.status !== 'held')
2746
+ return false;
2747
+ task.answer = answer;
2748
+ task.prompt += `\n\nThe user answered: ${answer}`;
2749
+ task.status = 'waiting';
2750
+ touch(task);
2751
+ maybeStart(task);
2752
+ return true;
2753
+ }
2754
+ function answerHeldTasks(tasks, directives, touch, maybeStart) {
2755
+ const released = [];
2756
+ for (const { target, answer } of directives) {
2757
+ for (const id of resolveTargets(tasks, [target])) {
2758
+ const task = tasks.get(id);
2759
+ if (task && releaseHeldTask(task, answer, touch, maybeStart))
2760
+ released.push(id);
2761
+ }
2762
+ }
2763
+ return released;
2764
+ }
2725
2765
  function releaseHeldTasks(tasks, answer, touch, maybeStart) {
2726
2766
  const trimmed = answer.trim();
2727
2767
  if (!trimmed)
@@ -2731,12 +2771,8 @@ function releaseHeldTasks(tasks, answer, touch, maybeStart) {
2731
2771
  for (const task of sorted) {
2732
2772
  if (task.status !== 'held' || !task.heldFor?.chips.includes(trimmed))
2733
2773
  continue;
2734
- task.answer = trimmed;
2735
- task.prompt += `\n\nThe user answered: ${trimmed}`;
2736
- task.status = 'waiting';
2737
- touch(task);
2738
- maybeStart(task);
2739
- released.push(task.id);
2774
+ if (releaseHeldTask(task, trimmed, touch, maybeStart))
2775
+ released.push(task.id);
2740
2776
  }
2741
2777
  return released;
2742
2778
  }
@@ -2928,30 +2964,59 @@ function startTask(ctx, task) {
2928
2964
  ctx.rescheduleAll();
2929
2965
  });
2930
2966
  }
2931
- function sendToTasks(store, directives, originMessageId) {
2967
+ function activeSuccessor(tasks, task) {
2968
+ const visited = new Set();
2969
+ while (!visited.has(task.id)) {
2970
+ visited.add(task.id);
2971
+ const successor = [...(task.steers ?? [])].reverse()
2972
+ .map((steer) => steer.sentOnAs ? tasks.get(steer.sentOnAs) : undefined)
2973
+ .find((candidate) => candidate !== undefined);
2974
+ if (!successor || visited.has(successor.id))
2975
+ return undefined;
2976
+ if (!isTerminal(successor.status) && successor.status !== 'blocked')
2977
+ return successor;
2978
+ if (successor.status !== 'done')
2979
+ return undefined;
2980
+ task = successor;
2981
+ }
2982
+ return undefined;
2983
+ }
2984
+ function sendToTasks(store, directives, originMessageId, opts = {}) {
2932
2985
  const unsent = [];
2933
2986
  for (const directive of directives) {
2934
2987
  const [id] = resolveTargets(store.tasks, [directive.target]);
2935
- const task = id ? store.tasks.get(id) : undefined;
2988
+ let task = id ? store.tasks.get(id) : undefined;
2936
2989
  if (!task) {
2937
2990
  unsent.push(directive.target);
2938
2991
  continue;
2939
2992
  }
2940
- sendToTask(task, directive.text, originMessageId, store.steerChannels.get(task.id));
2941
- store.onFeed(task, '[message sent to this task]');
2993
+ if (task.status === 'done')
2994
+ task = activeSuccessor(store.tasks, task) ?? task;
2995
+ const steer = sendToTask(task, directive.text, originMessageId, store.steerChannels.get(task.id), store.spawn, opts);
2996
+ store.onFeed(task, steer.sentOnAs
2997
+ ? '[the task had already finished; message sent on as a new task]'
2998
+ : '[message sent to this task]');
2942
2999
  store.touch(task);
2943
3000
  }
2944
3001
  return unsent;
2945
3002
  }
2946
3003
  // A waiting or held task gets the message with its prompt when it starts, and a
2947
3004
  // running one as soon as its stdin is up. A running task whose stdin already
2948
- // closed holds it for a resume (resumeForLateSteers). Anything else cannot take
2949
- // a message, and the board says so on the router's next turn.
2950
- function sendToTask(task, text, originMessageId, channel) {
3005
+ // closed holds it for a resume (resumeForLateSteers). A done task gets a new
3006
+ // follow-up task; other terminal or blocked tasks cannot take a message, and
3007
+ // the board says so on the router's next turn.
3008
+ function sendToTask(task, text, originMessageId, channel, spawn, opts = {}) {
2951
3009
  const steer = newTaskSteer(text, nowIso(), originMessageId);
2952
3010
  task.steers = [...(task.steers ?? []), steer];
2953
3011
  if (task.status === 'waiting' || task.status === 'held')
2954
3012
  return steer;
3013
+ if (task.status === 'done') {
3014
+ steer.state = 'undelivered';
3015
+ steer.reason = 'the task had already finished';
3016
+ if (opts.followUp !== false)
3017
+ steer.sentOnAs = spawn(followUpDirective(task, text), originMessageId ?? '');
3018
+ return steer;
3019
+ }
2955
3020
  if (task.status !== 'running' || !channel) {
2956
3021
  steer.state = 'undelivered';
2957
3022
  steer.reason =
@@ -3259,10 +3324,11 @@ export function createTaskStore(opts) {
3259
3324
  touch,
3260
3325
  spawnFromDirective,
3261
3326
  releaseHeld,
3327
+ answerHeld: (directives) => answerHeldTasks(tasks, directives, touch, maybeStart),
3262
3328
  acknowledge,
3263
3329
  checkOff,
3264
3330
  stop,
3265
- send: (directives, originMessageId) => sendToTasks({ tasks, steerChannels, onFeed: opts.onFeed, touch }, directives, originMessageId),
3331
+ send: (directives, originMessageId, sendOpts) => sendToTasks({ tasks, steerChannels, onFeed: opts.onFeed, touch, spawn: spawnFromDirective }, directives, originMessageId, sendOpts),
3266
3332
  pendingDurables,
3267
3333
  clearPendingDurables,
3268
3334
  shutdown,
@@ -3492,6 +3558,9 @@ function asClientTask(task, signPath) {
3492
3558
  errorCopy: task.errorCopy,
3493
3559
  errorDetail: task.errorDetail,
3494
3560
  playtestFrames: (task.playtestFrames ?? []).map((rel) => clientUrl(`${AGENT_PLAYTEST_PREFIX}${task.id}/${path.basename(rel)}`, signPath)),
3561
+ steers: task.steers?.length
3562
+ ? task.steers.map(({ id, text, state, at, reason, sentOnAs }) => ({ id, text, state, at, reason, sentOnAs }))
3563
+ : undefined,
3495
3564
  };
3496
3565
  }
3497
3566
  function clientUrl(reqPath, signPath) {
@@ -3860,6 +3929,64 @@ function spawnCompletedTaskFences(ctx, message, midStream, raw) {
3860
3929
  taskIds: message.taskIds,
3861
3930
  });
3862
3931
  }
3932
+ export function settleReplyDirectives(ctx, message, extracted, opts) {
3933
+ const { cleaned, directives, checkoffs, stops, answers, prefs, sends, plan } = extracted;
3934
+ const { ok, stale, spawnedTitles } = opts;
3935
+ if (ok && checkoffs.length > 0)
3936
+ ctx.taskStore.checkOff(checkoffs);
3937
+ if (ok && sends.length > 0) {
3938
+ const unsent = ctx.taskStore.send(sends, message.id, { followUp: !stale });
3939
+ if (unsent.length > 0)
3940
+ message.unsent = unsent;
3941
+ }
3942
+ if (ok && stops.length > 0) {
3943
+ const notes = stopNotes(ctx.taskStore.stop(stops));
3944
+ if (notes.length > 0)
3945
+ message.stopped = notes;
3946
+ }
3947
+ if (ok && !stale && answers.length > 0)
3948
+ ctx.taskStore.answerHeld(answers);
3949
+ if (ok) {
3950
+ const pref = parsePrefLines(prefs).playtest;
3951
+ if (pref && setPlaytestPref(ctx.deckDir, pref)) {
3952
+ ctx.broadcast(deckPrefsFrame(ctx.deckDir));
3953
+ }
3954
+ }
3955
+ // Settle-time only, unlike task fences: nothing is waiting on the file,
3956
+ // and a half-streamed op line is a line that says something else.
3957
+ if (ok && plan) {
3958
+ const written = applyPlanFence(ctx.deckDir, plan, planOpSources(ctx.taskStore, ctx.log.messages));
3959
+ if (written === 'written')
3960
+ message.planUpdated = true;
3961
+ // Any fence that became ops is the router's answer to the pending
3962
+ // nominations, including one whose ops all no-oped -- it looked and
3963
+ // passed. A fence that never parsed decided nothing, so they stay
3964
+ // pending for the turn that redoes it.
3965
+ if (written !== 'dropped')
3966
+ ctx.taskStore.clearPendingDurables();
3967
+ }
3968
+ // Drop directives from stale turns, any whose title matches a task
3969
+ // already in flight (two runs reacting to the same ask), and any
3970
+ // already spawned mid-stream by spawnCompletedTaskFences above --
3971
+ // otherwise the settle-time full-text parse would launch a second
3972
+ // copy of the same fence.
3973
+ const inFlight = new Set(ctx.taskStore
3974
+ .sorted()
3975
+ .filter((t) => t.status === 'held' || t.status === 'running' || t.status === 'waiting')
3976
+ .map((t) => t.title.toLowerCase()));
3977
+ // A failed reply may have died before its chips, and a held row with
3978
+ // none can never be released by a tap. Everything after that fence goes
3979
+ // with it: a later one may wait on it, and without the row it would
3980
+ // start at once.
3981
+ const firstHold = directives.findIndex((d) => d.hold);
3982
+ const settled = ok || firstHold < 0 ? directives : directives.slice(0, firstHold);
3983
+ const toSpawn = stale
3984
+ ? []
3985
+ : settled.filter((d) => !inFlight.has(d.title.toLowerCase()) &&
3986
+ !spawnedTitles.has(d.title.toLowerCase()));
3987
+ const newlySpawnedIds = toSpawn.map((d) => ctx.taskStore.spawnFromDirective(d, message.id, cleaned));
3988
+ return newlySpawnedIds;
3989
+ }
3863
3990
  // One router turn: stream a reply message, then spawn the directives it
3864
3991
  // emitted (unless a newer user message superseded this turn).
3865
3992
  function runRouterTurnIn(ctx, instruction) {
@@ -3940,61 +4067,16 @@ function runRouterTurnIn(ctx, instruction) {
3940
4067
  settleInterruptedTurn(ctx, message);
3941
4068
  return;
3942
4069
  }
3943
- const { cleaned, directives, checkoffs, stops, prefs, sends, plan } = extractDirectives(result.finalText, {
4070
+ const extracted = extractDirectives(result.finalText, {
3944
4071
  sends: TASK_STEER_ENABLED,
3945
4072
  });
3946
- if (result.ok && checkoffs.length > 0)
3947
- ctx.taskStore.checkOff(checkoffs);
3948
- if (result.ok && sends.length > 0) {
3949
- const unsent = ctx.taskStore.send(sends, message.id);
3950
- if (unsent.length > 0)
3951
- message.unsent = unsent;
3952
- }
3953
- if (result.ok && stops.length > 0) {
3954
- const notes = stopNotes(ctx.taskStore.stop(stops));
3955
- if (notes.length > 0)
3956
- message.stopped = notes;
3957
- }
3958
- if (result.ok) {
3959
- const pref = parsePrefLines(prefs).playtest;
3960
- if (pref && setPlaytestPref(ctx.deckDir, pref)) {
3961
- ctx.broadcast(deckPrefsFrame(ctx.deckDir));
3962
- }
3963
- }
3964
- // Settle-time only, unlike task fences: nothing is waiting on the file,
3965
- // and a half-streamed op line is a line that says something else.
3966
- if (result.ok && plan) {
3967
- const written = applyPlanFence(ctx.deckDir, plan, planOpSources(ctx.taskStore, ctx.log.messages));
3968
- if (written === 'written')
3969
- message.planUpdated = true;
3970
- // Any fence that became ops is the router's answer to the pending
3971
- // nominations, including one whose ops all no-oped -- it looked and
3972
- // passed. A fence that never parsed decided nothing, so they stay
3973
- // pending for the turn that redoes it.
3974
- if (written !== 'dropped')
3975
- ctx.taskStore.clearPendingDurables();
3976
- }
3977
- // Drop directives from stale turns, any whose title matches a task
3978
- // already in flight (two runs reacting to the same ask), and any
3979
- // already spawned mid-stream by spawnCompletedTaskFences above --
3980
- // otherwise the settle-time full-text parse would launch a second
3981
- // copy of the same fence.
4073
+ const { cleaned } = extracted;
3982
4074
  const stale = epoch !== ctx.currentEpoch();
3983
- const inFlight = new Set(ctx.taskStore
3984
- .sorted()
3985
- .filter((t) => t.status === 'held' || t.status === 'running' || t.status === 'waiting')
3986
- .map((t) => t.title.toLowerCase()));
3987
- // A failed reply may have died before its chips, and a held row with
3988
- // none can never be released by a tap. Everything after that fence goes
3989
- // with it: a later one may wait on it, and without the row it would
3990
- // start at once.
3991
- const firstHold = directives.findIndex((d) => d.hold);
3992
- const settled = result.ok || firstHold < 0 ? directives : directives.slice(0, firstHold);
3993
- const toSpawn = stale
3994
- ? []
3995
- : settled.filter((d) => !inFlight.has(d.title.toLowerCase()) &&
3996
- !midStream.spawnedTitles.has(d.title.toLowerCase()));
3997
- const newlySpawnedIds = toSpawn.map((d) => ctx.taskStore.spawnFromDirective(d, message.id, cleaned));
4075
+ const newlySpawnedIds = settleReplyDirectives(ctx, message, extracted, {
4076
+ ok: result.ok,
4077
+ stale,
4078
+ spawnedTitles: midStream.spawnedTitles,
4079
+ });
3998
4080
  const taskIds = [...(message.taskIds ?? []), ...newlySpawnedIds];
3999
4081
  if (result.ok) {
4000
4082
  message.text = cleaned;
@@ -4007,22 +4089,29 @@ function runRouterTurnIn(ctx, instruction) {
4007
4089
  // would answer the same instruction twice (and could re-spawn
4008
4090
  // near-duplicate tasks past the title dedup). Spawn failures are
4009
4091
  // persistent (the CLI itself won't launch) and timeouts are too
4010
- // expensive to repeat blind, so only "exit" crashes retry.
4092
+ // expensive to repeat blind, so only "exit" crashes and upstream
4093
+ // model lookup flaps retry.
4011
4094
  //
4012
4095
  // "config" and "no-work" are deterministic -- the same slug, key, or
4013
4096
  // model would fail again identically, so a retry is pure latency in
4014
4097
  // front of the same message. "transient" is excluded too, but for a
4015
4098
  // different reason: it has ALREADY been retried at the transport
4016
4099
  // layer (3 backed-off connects), and a turn-level retry on top just
4017
- // doubles the wait with the composer frozen.
4018
- const salvaged = cleaned !== '' || taskIds.length > 0;
4019
- retryable = failure.kind === 'exit' && !salvaged;
4100
+ // doubles the wait with the composer frozen. Lookup flaps are the
4101
+ // exception because a 400 is never retried at the transport layer.
4102
+ const textIsProviderError = result.resultError === true && result.finalTextFromResult === true;
4103
+ retryable = routerTurnRetryable(failure, {
4104
+ text: cleaned,
4105
+ textIsProviderError,
4106
+ streamedChars: result.streamedChars ?? 0,
4107
+ spawnedTasks: taskIds.length > 0,
4108
+ });
4020
4109
  const copy = failureCopy({
4021
4110
  failure,
4022
4111
  spawnedTasks: taskIds.length > 0,
4023
4112
  willRetry: retryable && ctx.canAutoRetry(),
4024
4113
  });
4025
- message.text = cleaned ? `${cleaned}\n\n${copy}` : copy;
4114
+ message.text = routerTurnErrorText(cleaned, textIsProviderError, copy);
4026
4115
  message.status = 'error';
4027
4116
  message.errorDetail = failure.detail || result.error || 'unknown failure';
4028
4117
  errorVerbose = failure.verbose;
package/dist/api.d.ts CHANGED
@@ -210,6 +210,17 @@ export declare function saveCauldronServerBundle(deckId: string, uploadId: strin
210
210
  * packs yet (the field is not in its schema). Anything else is thrown.
211
211
  */
212
212
  export declare function createCauldronContentPackUploadConfig(deckId: string): Promise<CauldronServerBundleUploadConfig | null>;
213
+ export declare const BUNDLE_CHUNKS_UNSUPPORTED_MESSAGE: string;
214
+ /** A presigned upload for one bundle chunk. */
215
+ export declare function createCauldronBundleChunkUploadConfig(deckId: string): Promise<CauldronServerBundleUploadConfig>;
216
+ export interface CauldronBundleChunk {
217
+ sha256: string;
218
+ url: string;
219
+ }
220
+ /** What a stored chunk is: a classic script (`<sha256>.js`) or a wasm module (`<sha256>.wasm`). */
221
+ export type CauldronBundleChunkKind = 'JS' | 'WASM';
222
+ /** Stores an uploaded chunk at its content-addressed URL once Ghost has checked its hash. */
223
+ export declare function storeCauldronBundleChunk(deckId: string, uploadId: string, sha256: string, kind?: CauldronBundleChunkKind): Promise<CauldronBundleChunk>;
213
224
  /**
214
225
  * Sets, or with null clears, the A/B experiments a deck runs (castle.json
215
226
  * `experiments`, already validated). Returns false when this Ghost predates
package/dist/api.js CHANGED
@@ -332,6 +332,49 @@ export async function createCauldronContentPackUploadConfig(deckId) {
332
332
  handleAPIError(data);
333
333
  return pickData(data, 'createCauldronContentPackUploadConfig');
334
334
  }
335
+ // A classic chunked bundle (castle.json `bundle.chunks`) is a page whose
336
+ // scripts live at content-addressed URLs. Unlike a content pack there is no
337
+ // falling back: a page published without its chunks does not run, so a Ghost
338
+ // that cannot store them fails the save, before anything is published.
339
+ export const BUNDLE_CHUNKS_UNSUPPORTED_MESSAGE = 'This Castle server cannot host chunked bundles yet. Nothing was published. ' +
340
+ 'Save without --chunked-bundle (and without "bundle": { "chunks": "classic" } in castle.json) ' +
341
+ 'to publish the usual single-file bundle.';
342
+ function throwIfChunksUnsupported(data, field) {
343
+ const first = data?.errors?.[0];
344
+ if (first && new RegExp(`Cannot query field "${field}"`).test(first.message ?? '')) {
345
+ throw new Error(BUNDLE_CHUNKS_UNSUPPORTED_MESSAGE);
346
+ }
347
+ }
348
+ /** A presigned upload for one bundle chunk. */
349
+ export async function createCauldronBundleChunkUploadConfig(deckId) {
350
+ const data = await graphql(`mutation($deckId: ID!) {
351
+ createCauldronBundleChunkUploadConfig(deckId: $deckId) {
352
+ deckId uploadId postUrl postFields
353
+ }
354
+ }`, { deckId });
355
+ throwIfChunksUnsupported(data, 'createCauldronBundleChunkUploadConfig');
356
+ handleAPIError(data);
357
+ return pickData(data, 'createCauldronBundleChunkUploadConfig');
358
+ }
359
+ /** Stores an uploaded chunk at its content-addressed URL once Ghost has checked its hash. */
360
+ export async function storeCauldronBundleChunk(deckId, uploadId, sha256, kind = 'JS') {
361
+ // `kind` is sent only for wasm: JS is Ghost's default, and a script chunk's
362
+ // call stays the one every Ghost with chunks understands.
363
+ const data = kind === 'JS'
364
+ ? await graphql(`mutation($deckId: ID!, $uploadId: String!, $sha256: String!) {
365
+ storeCauldronBundleChunk(deckId: $deckId, uploadId: $uploadId, sha256: $sha256) {
366
+ sha256 url
367
+ }
368
+ }`, { deckId, uploadId, sha256 }, { timeoutMs: 60_000 })
369
+ : await graphql(`mutation($deckId: ID!, $uploadId: String!, $sha256: String!, $kind: CauldronBundleChunkKind) {
370
+ storeCauldronBundleChunk(deckId: $deckId, uploadId: $uploadId, sha256: $sha256, kind: $kind) {
371
+ sha256 url
372
+ }
373
+ }`, { deckId, uploadId, sha256, kind }, { timeoutMs: 60_000 });
374
+ throwIfChunksUnsupported(data, 'storeCauldronBundleChunk');
375
+ handleAPIError(data);
376
+ return pickData(data, 'storeCauldronBundleChunk');
377
+ }
335
378
  /**
336
379
  * Sets, or with null clears, the A/B experiments a deck runs (castle.json
337
380
  * `experiments`, already validated). Returns false when this Ghost predates
package/dist/bundle.d.ts CHANGED
@@ -1 +1,65 @@
1
+ import { type Plugin } from 'vite';
1
2
  export declare function bundleProject(dir: string): Promise<string>;
3
+ /** Above this a chunk risks being too big for WebView's code cache (~4-5 MB). */
4
+ export declare const CHUNK_WARN_BYTES: number;
5
+ export interface BundleChunk {
6
+ /** A classic script, or a WebAssembly module some script fetches. */
7
+ kind: 'js' | 'wasm';
8
+ /** The name the loader's map knows it by (`index-AbC123.js`, `rapier3d-compat-<hash12>.wasm`). */
9
+ name: string;
10
+ /** Lowercase hex SHA-256 of `bytes`. */
11
+ sha256: string;
12
+ /** `<sha256>.js` or `<sha256>.wasm`: where the chunk lives under a chunk base URL. */
13
+ fileName: string;
14
+ /** Exactly the bytes to serve: the wrapped classic script, or the wasm module. */
15
+ bytes: Buffer;
16
+ /** In the entry's static import closure (a `<script defer>` tag); false for a lazy chunk or wasm. */
17
+ initial: boolean;
18
+ }
19
+ export interface ChunkedBundle {
20
+ chunks: BundleChunk[];
21
+ /** The page, with every chunk at `<baseUrl><sha256>.js`. */
22
+ renderHtml(baseUrl: string): string;
23
+ /** One line per script chunk over CHUNK_WARN_BYTES, or Rapier wasm left inline. */
24
+ warnings: string[];
25
+ }
26
+ export declare function wrapChunk(name: string, code: string): string;
27
+ /**
28
+ * Turns a rolldown CJS chunk into one the chunk loader runs, working on the
29
+ * parsed chunk so code inside a string or comment is never touched:
30
+ *
31
+ * - `import()` of another chunk becomes a loader call that fetches it (and its
32
+ * static deps) as classic scripts. Throws when a require of a chunk outside
33
+ * `staticImports` is left over -- a dynamic import in a form this does not
34
+ * recognize, which would require a chunk nobody loaded.
35
+ * - The chunk's export definitions, which rolldown writes at its end, move to
36
+ * its start as getters. Chunks can require each other in a cycle (the entry
37
+ * and a chunk it shares code with), and under `strictExecutionOrder` a chunk
38
+ * runs its modules before reaching its end: a chunk in the cycle that calls
39
+ * back into this one must find the exports there already, as ES modules'
40
+ * live bindings would be.
41
+ *
42
+ * Also returns the `__castleUrl("<name>")` names the chunk uses.
43
+ */
44
+ export declare function rewriteChunkCalls(name: string, code: string, staticImports: string[]): {
45
+ code: string;
46
+ urls: string[];
47
+ };
48
+ export declare function importMetaPlugin(): Plugin;
49
+ /**
50
+ * Chunked mode only: moves a Rapier compat package's inline wasm out of its JS
51
+ * into `wasm` (name -> bytes), and points the package's init at the loader's
52
+ * URL for it. A compat module with no inline wasm in the recognized form is
53
+ * left as it is and named in `missed`.
54
+ */
55
+ export declare function rapierWasmPlugin(wasm: Map<string, Buffer>, missed: string[]): Plugin;
56
+ export declare function sha256Hex(bytes: string | Buffer): string;
57
+ export declare function bundleProjectChunked(dir: string): Promise<ChunkedBundle>;
58
+ /**
59
+ * `castle-web bundle-chunks`: the chunked page and its chunks written to
60
+ * `outDir` (`index.html` and `<sha256>.js` files), the page naming each chunk at
61
+ * `<baseUrl><sha256>.js`. The default `./` serves from the same directory, so
62
+ * any static file server on it can play the deck (a phone on the LAN, say).
63
+ */
64
+ export declare function writeChunkedBundle(dir: string, outDir: string, baseUrl?: string): Promise<ChunkedBundle>;
65
+ export declare function bundleChunksCommand(dir: string, out: string | undefined, baseUrl?: string): Promise<void>;