castle-web-cli 0.4.239 → 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.
- package/dist/agent.js +5 -1
- package/dist/api.d.ts +20 -0
- package/dist/api.js +57 -0
- package/dist/bundle.d.ts +38 -1
- package/dist/bundle.js +309 -13
- package/dist/castle-host/host.js +163 -11
- package/dist/castleJson.d.ts +10 -0
- package/dist/castleJson.js +46 -2
- package/dist/check.js +5 -2
- package/dist/devSessionServer.js +4 -1
- package/dist/devSessionStorage.d.ts +1 -0
- package/dist/devSessionStorage.js +32 -7
- package/dist/importOrder.d.ts +2 -0
- package/dist/importOrder.js +29 -0
- package/dist/index.js +6 -3
- package/dist/init.js +24 -2
- package/dist/platformDoc.js +2 -1
- package/dist/playPagePolicy.js +5 -1
- package/dist/resetLeaderboards.d.ts +8 -1
- package/dist/resetLeaderboards.js +43 -8
- package/dist/save-deck.d.ts +32 -2
- package/dist/save-deck.js +240 -39
- package/kits/base/CLAUDE.md +1 -1
- package/kits/base/castle.json +1 -1
- package/kits/base/sdk/README.md +174 -6
- package/kits/base/sdk/analytics.d.ts +8 -0
- package/kits/base/sdk/analytics.js +92 -0
- package/kits/base/sdk/castle.d.ts +5 -1
- package/kits/base/sdk/castle.js +2 -0
- package/kits/base/sdk/commands.d.ts +48 -0
- package/kits/base/sdk/commands.js +1 -0
- package/kits/base/sdk/debugConsole.d.ts +17 -0
- package/kits/base/sdk/debugConsole.js +154 -0
- package/kits/base/sdk/experiments.js +24 -1
- package/kits/base/sdk/hostRetry.d.ts +7 -0
- package/kits/base/sdk/hostRetry.js +57 -0
- package/kits/base/sdk/hub.d.ts +20 -2
- package/kits/base/sdk/hub.js +99 -13
- package/kits/base/sdk/multiplayer.d.ts +2 -0
- package/kits/base/sdk/multiplayer.js +168 -26
- package/kits/base/sdk/reconnectBudget.d.ts +6 -0
- package/kits/base/sdk/reconnectBudget.js +41 -1
- package/kits/base/sdk/runtime.js +36 -19
- package/kits/base/sdk/server/hub.d.ts +19 -0
- package/kits/base/sdk/server/hub.js +12 -0
- package/kits/base/sdk/server/platformHandle.d.ts +1 -0
- package/kits/base/sdk/server/wrapper.d.ts +1 -1
- package/kits/base/sdk/server/wrapper.js +26 -1
- package/kits/base/sdk/transport.d.ts +2 -1
- package/kits/base/sdk/transport.js +35 -0
- package/kits/hub-game/CLAUDE.md +66 -19
- package/kits/hub-game/code/client/act.js +9 -6
- package/kits/hub-game/code/client/actCore.js +26 -6
- package/kits/hub-game/code/client/actGateLog.js +36 -0
- package/kits/hub-game/code/client/actionOverflow.js +29 -8
- package/kits/hub-game/code/client/actionRailSurface.js +186 -0
- package/kits/hub-game/code/client/actionRailTree.js +173 -0
- package/kits/hub-game/code/client/askSurface.js +85 -0
- package/kits/hub-game/code/client/askTree.js +51 -0
- package/kits/hub-game/code/client/attention.js +31 -6
- package/kits/hub-game/code/client/ballot.js +42 -5
- package/kits/hub-game/code/client/ballotSurface.js +115 -0
- package/kits/hub-game/code/client/ballotTree.js +180 -0
- package/kits/hub-game/code/client/catchingUp.js +19 -0
- package/kits/hub-game/code/client/celebrate.js +66 -0
- package/kits/hub-game/code/client/chrome.js +473 -53
- package/kits/hub-game/code/client/companion.js +93 -23
- package/kits/hub-game/code/client/companionDress.js +1 -1
- package/kits/hub-game/code/client/cornerSurface.js +106 -0
- package/kits/hub-game/code/client/cornerTree.js +83 -0
- package/kits/hub-game/code/client/decor.js +20 -11
- package/kits/hub-game/code/client/deviceStorage.js +121 -0
- package/kits/hub-game/code/client/disguise.js +23 -0
- package/kits/hub-game/code/client/disguiseDraw.js +87 -0
- package/kits/hub-game/code/client/dockSurface.js +206 -0
- package/kits/hub-game/code/client/dockTree.js +232 -0
- package/kits/hub-game/code/client/earned.js +29 -0
- package/kits/hub-game/code/client/emoteSurface.js +188 -0
- package/kits/hub-game/code/client/emoteTree.js +264 -0
- package/kits/hub-game/code/client/farAvatars.js +4 -3
- package/kits/hub-game/code/client/fpsTelemetry.js +3 -1
- package/kits/hub-game/code/client/grab.js +121 -50
- package/kits/hub-game/code/client/holdShow.js +19 -0
- package/kits/hub-game/code/client/hookLayer.js +96 -12
- package/kits/hub-game/code/client/hubControls.js +7 -1
- package/kits/hub-game/code/client/hudSurface.js +11 -3
- package/kits/hub-game/code/client/hudTree.js +7 -4
- package/kits/hub-game/code/client/idle.js +21 -3
- package/kits/hub-game/code/client/invites.js +24 -3
- package/kits/hub-game/code/client/keys.js +15 -0
- package/kits/hub-game/code/client/labelsNear.js +8 -1
- package/kits/hub-game/code/client/layoutCache.js +57 -8
- package/kits/hub-game/code/client/loadingCover.js +53 -4
- package/kits/hub-game/code/client/menuIcons.js +15 -0
- package/kits/hub-game/code/client/menuSurface.js +102 -0
- package/kits/hub-game/code/client/menuTree.js +135 -0
- package/kits/hub-game/code/client/modelLook.js +41 -0
- package/kits/hub-game/code/client/pickerSurface.js +152 -0
- package/kits/hub-game/code/client/pickerTree.js +163 -0
- package/kits/hub-game/code/client/pushVisit.js +4 -2
- package/kits/hub-game/code/client/quality.js +188 -29
- package/kits/hub-game/code/client/qualityEntry.js +10 -1
- package/kits/hub-game/code/client/quickChatSurface.js +222 -0
- package/kits/hub-game/code/client/quickChatTree.js +201 -0
- package/kits/hub-game/code/client/rehello.js +75 -0
- package/kits/hub-game/code/client/renderVisibility.js +17 -0
- package/kits/hub-game/code/client/replay.js +118 -0
- package/kits/hub-game/code/client/role.js +3 -0
- package/kits/hub-game/code/client/safeLayout.js +441 -56
- package/kits/hub-game/code/client/safeStyle.js +13 -10
- package/kits/hub-game/code/client/say.js +2 -0
- package/kits/hub-game/code/client/soundSurface.js +77 -0
- package/kits/hub-game/code/client/soundTree.js +74 -0
- package/kits/hub-game/code/client/soundscape.js +12 -9
- package/kits/hub-game/code/client/soundscapeCues.js +1 -1
- package/kits/hub-game/code/client/state.js +67 -1
- package/kits/hub-game/code/client/stuckSurface.js +76 -0
- package/kits/hub-game/code/client/stuckTree.js +67 -0
- package/kits/hub-game/code/client/talk.js +42 -12
- package/kits/hub-game/code/client/talkTree.js +4 -2
- package/kits/hub-game/code/client/textAskSurface.js +147 -0
- package/kits/hub-game/code/client/textAskTree.js +67 -0
- package/kits/hub-game/code/client/tiers.js +252 -27
- package/kits/hub-game/code/client/together.js +4 -1
- package/kits/hub-game/code/client/uiDom.js +86 -8
- package/kits/hub-game/code/client/uiTree.js +33 -4
- package/kits/hub-game/code/client/vehicle.js +72 -51
- package/kits/hub-game/code/client/weakestTier.js +75 -31
- package/kits/hub-game/code/client/wear.js +159 -5
- package/kits/hub-game/code/client/worldLabels.js +205 -25
- package/kits/hub-game/code/companionSpec.js +4 -2
- package/kits/hub-game/code/server/act.js +3 -0
- package/kits/hub-game/code/server/actGate.js +83 -0
- package/kits/hub-game/code/server/actions.js +71 -15
- package/kits/hub-game/code/server/actors.js +20 -5
- package/kits/hub-game/code/server/analytics.js +35 -3
- package/kits/hub-game/code/server/ask.js +39 -3
- package/kits/hub-game/code/server/ballot.js +167 -4
- package/kits/hub-game/code/server/celebrate.js +64 -0
- package/kits/hub-game/code/server/companion.js +17 -2
- package/kits/hub-game/code/server/decor.js +11 -2
- package/kits/hub-game/code/server/disguise.js +63 -0
- package/kits/hub-game/code/server/earned.js +6 -2
- package/kits/hub-game/code/server/friendBests.js +13 -4
- package/kits/hub-game/code/server/friendsAmong.js +67 -8
- package/kits/hub-game/code/server/grab.js +12 -2
- package/kits/hub-game/code/server/heldOffers.js +142 -0
- package/kits/hub-game/code/server/holdShow.js +98 -0
- package/kits/hub-game/code/server/hub.js +851 -45
- package/kits/hub-game/code/server/idle.js +110 -9
- package/kits/hub-game/code/server/index.js +9 -0
- package/kits/hub-game/code/server/labels.js +13 -3
- package/kits/hub-game/code/server/manifest.js +94 -6
- package/kits/hub-game/code/server/menu.js +26 -3
- package/kits/hub-game/code/server/npcs.js +55 -9
- package/kits/hub-game/code/server/observe.js +67 -6
- package/kits/hub-game/code/server/players.js +8 -1
- package/kits/hub-game/code/server/replay.js +135 -0
- package/kits/hub-game/code/server/storageLimit.js +4 -1
- package/kits/hub-game/code/server/townDay.js +74 -0
- package/kits/hub-game/code/server/vehicle.js +3 -0
- package/kits/hub-game/code/server/vis.js +26 -4
- package/kits/hub-game/code/server/wallet.js +677 -0
- package/kits/hub-game/code/server/wear.js +13 -3
- package/kits/hub-game/code/server/writerLease.js +191 -0
- package/kits/hub-game/code/shared/act.js +1 -1
- package/kits/hub-game/code/shared/expression.js +6 -0
- package/kits/hub-game/code/shared/replay.js +37 -0
- package/kits/hub-game/code/systems/hub.js +427 -54
- package/kits/hub-game/docs/analytics.md +16 -2
- package/kits/hub-game/docs/contract.md +942 -99
- package/kits/hub-game/docs/home-pieces.md +5 -6
- package/kits/hub-game/docs/observed-progress.md +49 -1
- package/kits/hub-game/docs/vehicle-preset.md +23 -0
- package/kits/hub-game/index.html +1 -0
- package/kits/hub-game/models/hats/baker-cap.pxmodel +3 -3
- package/kits/hub-game/models/hats/bat-clip.pxmodel +3 -3
- package/kits/hub-game/models/hats/beekeeper.pxmodel +3 -3
- package/kits/hub-game/models/hats/cap.pxmodel +3 -3
- package/kits/hub-game/models/hats/captain.pxmodel +3 -3
- package/kits/hub-game/models/hats/chef-toque.pxmodel +3 -3
- package/kits/hub-game/models/hats/crooked-top.pxmodel +3 -3
- package/kits/hub-game/models/hats/delivery-cap.pxmodel +3 -3
- package/kits/hub-game/models/hats/fire-helmet.pxmodel +3 -3
- package/kits/hub-game/models/hats/flower-crown.pxmodel +3 -3
- package/kits/hub-game/models/hats/foam-crown.pxmodel +3 -3
- package/kits/hub-game/models/hats/hard-hat.pxmodel +3 -3
- package/kits/hub-game/models/hats/lantern.pxmodel +3 -3
- package/kits/hub-game/models/hats/laurel.pxmodel +3 -3
- package/kits/hub-game/models/hats/lighthouse.pxmodel +3 -3
- package/kits/hub-game/models/hats/nurse-cap.pxmodel +3 -3
- package/kits/hub-game/models/hats/police-cap.pxmodel +3 -3
- package/kits/hub-game/models/hats/sailor.pxmodel +3 -3
- package/kits/hub-game/models/hats/souwester.pxmodel +3 -3
- package/kits/hub-game/models/hats/straw.pxmodel +3 -3
- package/kits/hub-game/models/hats/sunflower.pxmodel +3 -3
- package/kits/hub-game/models/hats/sweatband.pxmodel +3 -3
- package/kits/hub-game/models/hats/teacher-beret.pxmodel +3 -3
- package/kits/hub-game/models/hats/witch.pxmodel +3 -3
- package/kits/hub-game/models/hold-show/daisy.pxmodel +231 -0
- package/kits/hub-game/models/hold-show/moonflower.pxmodel +171 -0
- package/kits/hub-game/models/hold-show/rose.pxmodel +191 -0
- package/kits/hub-game/models/hold-show/square/daisy.pxmodel +233 -0
- package/kits/hub-game/models/hold-show/square/moonflower.pxmodel +173 -0
- package/kits/hub-game/models/hold-show/square/rose.pxmodel +193 -0
- package/kits/hub-game/models/hold-show/square/sunflower.pxmodel +313 -0
- package/kits/hub-game/models/hold-show/square/tulip.pxmodel +133 -0
- package/kits/hub-game/models/hold-show/sunflower.pxmodel +311 -0
- package/kits/hub-game/models/hold-show/tulip.pxmodel +131 -0
- package/kits/hub-game/package-lock.json +3 -3
- package/kits/hub-game/package.json +4 -3
- package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +1 -0
- package/kits/hub-game/scripts/fixtures/hud-surface.json +12 -12
- package/kits/hub-game/scripts/fixtures/talk-surface.json +8 -8
- package/kits/hub-game/scripts/gen-hats.mjs +1 -1
- package/kits/hub-game/scripts/gen-hold-show.mjs +27 -0
- package/kits/hub-game/scripts/pack.mjs +89 -23
- package/kits/hub-game/scripts/test-act-client.mjs +5 -0
- package/kits/hub-game/scripts/test-act-core.mjs +32 -0
- package/kits/hub-game/scripts/test-act-gate.mjs +186 -0
- package/kits/hub-game/scripts/test-action-rail-crowded-dom.mjs +7 -1
- package/kits/hub-game/scripts/test-action-rail-default-dom.mjs +102 -0
- package/kits/hub-game/scripts/test-action-rail-never-silent-dom.mjs +50 -0
- package/kits/hub-game/scripts/test-action-rail-surface.mjs +368 -0
- package/kits/hub-game/scripts/test-action-rail-town-jobs-dom.mjs +118 -0
- package/kits/hub-game/scripts/test-actions-client.mjs +5 -3
- package/kits/hub-game/scripts/test-actions.mjs +24 -0
- package/kits/hub-game/scripts/test-actors.mjs +19 -0
- package/kits/hub-game/scripts/test-again-corner-dom.mjs +59 -0
- package/kits/hub-game/scripts/test-analytics.mjs +79 -0
- package/kits/hub-game/scripts/test-arrival-pose-server.mjs +25 -8
- package/kits/hub-game/scripts/test-ask-client.mjs +9 -0
- package/kits/hub-game/scripts/test-ask-surface.mjs +188 -0
- package/kits/hub-game/scripts/test-attention.mjs +43 -1
- package/kits/hub-game/scripts/test-ballot-sheet-dom.mjs +71 -0
- package/kits/hub-game/scripts/test-ballot-surface.mjs +276 -0
- package/kits/hub-game/scripts/test-ballot.mjs +420 -3
- package/kits/hub-game/scripts/test-ban-join.mjs +1 -1
- package/kits/hub-game/scripts/test-celebrate-client.mjs +62 -0
- package/kits/hub-game/scripts/test-celebrate.mjs +116 -0
- package/kits/hub-game/scripts/test-chat.mjs +73 -0
- package/kits/hub-game/scripts/test-companion-client.mjs +203 -21
- package/kits/hub-game/scripts/test-companion.mjs +110 -3
- package/kits/hub-game/scripts/test-control-layout-dom.mjs +57 -10
- package/kits/hub-game/scripts/test-corner-surface.mjs +268 -0
- package/kits/hub-game/scripts/test-decor-client.mjs +59 -3
- package/kits/hub-game/scripts/test-decor.mjs +27 -0
- package/kits/hub-game/scripts/test-device-class.mjs +4 -1
- package/kits/hub-game/scripts/test-disguise-client.mjs +281 -0
- package/kits/hub-game/scripts/test-disguise.mjs +176 -0
- package/kits/hub-game/scripts/test-dock-surface.mjs +404 -0
- package/kits/hub-game/scripts/test-door-stay-client.mjs +602 -0
- package/kits/hub-game/scripts/test-door-stay.mjs +613 -0
- package/kits/hub-game/scripts/test-earned-client.mjs +119 -0
- package/kits/hub-game/scripts/test-emote-surface.mjs +616 -0
- package/kits/hub-game/scripts/test-fps-telemetry.mjs +39 -4
- package/kits/hub-game/scripts/test-friend-bests.mjs +38 -12
- package/kits/hub-game/scripts/test-ghost-click-dom.mjs +75 -0
- package/kits/hub-game/scripts/test-grab-client.mjs +29 -2
- package/kits/hub-game/scripts/test-grab-orbit.mjs +260 -11
- package/kits/hub-game/scripts/test-grab.mjs +10 -1
- package/kits/hub-game/scripts/test-hats.mjs +28 -0
- package/kits/hub-game/scripts/test-held-offers.mjs +394 -0
- package/kits/hub-game/scripts/test-high-only.mjs +3 -3
- package/kits/hub-game/scripts/test-hold-show-client.mjs +175 -0
- package/kits/hub-game/scripts/test-hold-show.mjs +355 -0
- package/kits/hub-game/scripts/test-hub-controls.mjs +3 -1
- package/kits/hub-game/scripts/test-hub-idle.mjs +348 -0
- package/kits/hub-game/scripts/test-hub-leaving.mjs +21 -0
- package/kits/hub-game/scripts/test-hub-ops.mjs +119 -0
- package/kits/hub-game/scripts/test-hub-trip.mjs +240 -4
- package/kits/hub-game/scripts/test-hud-clear.mjs +83 -0
- package/kits/hub-game/scripts/test-hud-rate.mjs +2 -1
- package/kits/hub-game/scripts/test-idle.mjs +160 -0
- package/kits/hub-game/scripts/test-invites-client.mjs +53 -0
- package/kits/hub-game/scripts/test-labels.mjs +11 -0
- package/kits/hub-game/scripts/test-landscape-layout.mjs +20 -0
- package/kits/hub-game/scripts/test-loading-cover.mjs +67 -1
- package/kits/hub-game/scripts/test-manifest.mjs +27 -0
- package/kits/hub-game/scripts/test-menu-client.mjs +54 -5
- package/kits/hub-game/scripts/test-menu-surface.mjs +236 -0
- package/kits/hub-game/scripts/test-npcs.mjs +128 -0
- package/kits/hub-game/scripts/test-observed.mjs +171 -3
- package/kits/hub-game/scripts/test-pack.mjs +166 -0
- package/kits/hub-game/scripts/test-picker-surface.mjs +321 -0
- package/kits/hub-game/scripts/test-placeat-server.mjs +395 -0
- package/kits/hub-game/scripts/test-placement-cache.mjs +1 -1
- package/kits/hub-game/scripts/test-pointer-clear-dom.mjs +82 -0
- package/kits/hub-game/scripts/test-progress-reset.mjs +184 -6
- package/kits/hub-game/scripts/test-push-visit.mjs +9 -0
- package/kits/hub-game/scripts/test-quality.mjs +312 -9
- package/kits/hub-game/scripts/test-quick-chat-surface.mjs +511 -0
- package/kits/hub-game/scripts/test-rehello.mjs +237 -0
- package/kits/hub-game/scripts/test-rejoin-yaw.mjs +138 -0
- package/kits/hub-game/scripts/test-relations-among.mjs +13 -7
- package/kits/hub-game/scripts/test-relations-refresh.mjs +90 -2
- package/kits/hub-game/scripts/test-replay-client.mjs +110 -0
- package/kits/hub-game/scripts/test-replay.mjs +178 -0
- package/kits/hub-game/scripts/test-resume-held.mjs +13 -0
- package/kits/hub-game/scripts/test-resume-pose-server.mjs +43 -5
- package/kits/hub-game/scripts/test-role-client.mjs +2 -1
- package/kits/hub-game/scripts/test-safe-act.mjs +233 -0
- package/kits/hub-game/scripts/test-safe-caption.mjs +364 -0
- package/kits/hub-game/scripts/test-safe-layout.mjs +79 -0
- package/kits/hub-game/scripts/test-safe-prompt.mjs +163 -0
- package/kits/hub-game/scripts/test-sound-surface.mjs +256 -0
- package/kits/hub-game/scripts/test-soundscape.mjs +85 -2
- package/kits/hub-game/scripts/test-stuck-surface.mjs +174 -0
- package/kits/hub-game/scripts/test-stuck.mjs +31 -0
- package/kits/hub-game/scripts/test-talk-surface.mjs +23 -6
- package/kits/hub-game/scripts/test-talk-walk-dom.mjs +123 -0
- package/kits/hub-game/scripts/test-text-ask-surface.mjs +273 -0
- package/kits/hub-game/scripts/test-tiers.mjs +453 -3
- package/kits/hub-game/scripts/test-toast-no-row-dom.mjs +71 -0
- package/kits/hub-game/scripts/test-together.mjs +11 -0
- package/kits/hub-game/scripts/test-town-day.mjs +90 -0
- package/kits/hub-game/scripts/test-try-on.mjs +39 -0
- package/kits/hub-game/scripts/test-ui-dom-dom.mjs +49 -2
- package/kits/hub-game/scripts/test-ui-tree.mjs +28 -0
- package/kits/hub-game/scripts/test-vehicle-client.mjs +68 -1
- package/kits/hub-game/scripts/test-vis.mjs +145 -0
- package/kits/hub-game/scripts/test-wallet.mjs +650 -0
- package/kits/hub-game/scripts/test-weakest-tier.mjs +135 -1
- package/kits/hub-game/scripts/test-world-labels.mjs +340 -0
- package/kits/hub-game/scripts/test-writer-lease-server.mjs +234 -0
- package/kits/hub-game/scripts/test-writer-lease.mjs +281 -0
- package/kits/hub-game/scripts/writer-storage-fixture.mjs +37 -0
- package/kits/hub-game/tools/hubScene/export.mjs +6 -5
- package/kits/hub-game/tools/hubScene/hubdata.mjs +10 -0
- package/kits/hub-game/tools/hubScene/test/export-fixture.mjs +36 -2
- package/kits/hub-game/tools/hubScene/validate-manifest.mjs +10 -2
- package/kits/multiplayer-3d/castle.json +5 -5
- package/kits/multiplayer-3d/code/client/resumeGate.js +49 -2
- package/kits/multiplayer-3d/code/server/ownership.js +25 -6
- package/kits/multiplayer-3d/code/server/world.js +19 -4
- package/kits/multiplayer-3d/code/systems/multiplayer.js +67 -11
- package/kits/multiplayer-3d/package-lock.json +1 -1
- package/kits/multiplayer-3d/package.json +2 -1
- package/kits/multiplayer-3d/scripts/test-ground-half.mjs +56 -0
- package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +54 -3
- package/kits/multiplayer-3d/scripts/test-owned-moves.mjs +190 -0
- package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +191 -5
- package/kits/multiplayer-3d/scripts/test-resync-reconnect.mjs +68 -0
- package/kits/physics-2d/castle.json +2 -2
- package/kits/physics-2d/engine/scene.js +10 -2
- package/kits/physics-3d/CLAUDE.md +14 -0
- package/kits/physics-3d/behaviors/Player.jsx +39 -3
- package/kits/physics-3d/castle.json +3 -3
- package/kits/physics-3d/docs/engine-model-cache.md +109 -0
- package/kits/physics-3d/docs/engine-player.md +76 -0
- package/kits/physics-3d/docs/engine-skip-work.md +16 -0
- package/kits/physics-3d/docs/pxmodel-format.md +5 -1
- package/kits/physics-3d/engine3d/gait.js +16 -8
- package/kits/physics-3d/engine3d/groundsize.js +23 -0
- package/kits/physics-3d/engine3d/kithooks.js +50 -0
- package/kits/physics-3d/engine3d/look.js +110 -17
- package/kits/physics-3d/engine3d/lookbake.js +19 -1
- package/kits/physics-3d/engine3d/materialpresets.js +3 -2
- package/kits/physics-3d/engine3d/modelcache.js +280 -0
- package/kits/physics-3d/engine3d/modelcachedigest.js +37 -0
- package/kits/physics-3d/engine3d/modelcachegate.js +69 -0
- package/kits/physics-3d/engine3d/modelrefs.js +13 -0
- package/kits/physics-3d/engine3d/optimize.js +20 -9
- package/kits/physics-3d/engine3d/playerRun.js +26 -1
- package/kits/physics-3d/engine3d/pxmodel.js +7 -3
- package/kits/physics-3d/engine3d/templatecache.js +722 -0
- package/kits/physics-3d/engine3d/world3d.js +211 -17
- package/kits/physics-3d/package-lock.json +1 -1
- package/kits/physics-3d/package.json +2 -1
- package/kits/physics-3d/play/behaviors/Player.js +43 -3
- package/kits/physics-3d/scripts/render.mjs +56 -8
- package/kits/physics-3d/scripts/template-cache-fixtures.mjs +37 -0
- package/kits/physics-3d/scripts/template-cache-v1-bytes.json +49 -0
- package/kits/physics-3d/scripts/test-gait.mjs +53 -9
- package/kits/physics-3d/scripts/test-ground-half.mjs +120 -0
- package/kits/physics-3d/scripts/test-model-cache.mjs +600 -0
- package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1 -0
- package/kits/physics-3d/scripts/test-sleeping-models.mjs +384 -0
- package/kits/physics-3d/scripts/test-template-cache-minified.mjs +106 -0
- package/kits/physics-3d/scripts/test-template-cache.mjs +519 -0
- package/kits/physics-3d/scripts/test-wall-slide.mjs +272 -0
- package/kits/physics-3d/systems/physics3d.js +51 -2
- package/kits/real-time/castle.json +2 -2
- package/kits/real-time/code/client/connection.js +3 -0
- package/package.json +2 -2
- package/vendor/three/examples/jsm/libs/fflate.module.js +2672 -0
package/dist/playPagePolicy.js
CHANGED
|
@@ -12,13 +12,17 @@ const CONTENT_PACK_HOSTS = 'https://hosted.castle.games';
|
|
|
12
12
|
// `Access-Control-Allow-Origin: *`, so a fetch from the opaque srcdoc origin can read
|
|
13
13
|
// them. img-src, media-src and connect-src only: an asset is data, never script.
|
|
14
14
|
export const CASTLE_ASSET_HOSTS = 'https://castle.imgix.net https://image.castle.xyz https://audio.castle.xyz';
|
|
15
|
+
// A published deck's audio and video, which save-deck stores there instead of
|
|
16
|
+
// inlining it (bundle.ts ExternalMedia). Path-scoped and media-src only: a fetch
|
|
17
|
+
// for decodeAudioData is already covered by CONTENT_PACK_HOSTS in connect-src.
|
|
18
|
+
const MEDIA_ASSET_SRC = 'https://hosted.castle.games/cauldron-assets/';
|
|
15
19
|
const DECK_CSP = [
|
|
16
20
|
"default-src 'self' data: blob:",
|
|
17
21
|
`script-src 'self' 'unsafe-inline' 'unsafe-eval' 'wasm-unsafe-eval' data: blob: ${CDN_HOSTS}`,
|
|
18
22
|
"style-src 'self' 'unsafe-inline' data: blob: https://fonts.googleapis.com",
|
|
19
23
|
"font-src 'self' data: blob: https://fonts.gstatic.com",
|
|
20
24
|
`img-src 'self' data: blob: ${CASTLE_ASSET_HOSTS}`,
|
|
21
|
-
`media-src 'self' data: blob: ${CASTLE_ASSET_HOSTS}`,
|
|
25
|
+
`media-src 'self' data: blob: ${CASTLE_ASSET_HOSTS} ${MEDIA_ASSET_SRC}`,
|
|
22
26
|
`connect-src 'self' data: blob: ${CDN_HOSTS} ${PLAY_HOSTS} ${CONTENT_PACK_HOSTS} ${CASTLE_ASSET_HOSTS}`,
|
|
23
27
|
"frame-src 'none'",
|
|
24
28
|
"child-src 'self' blob:",
|
|
@@ -1,11 +1,18 @@
|
|
|
1
1
|
export interface ResetLeaderboardsOptions {
|
|
2
2
|
deckId?: string;
|
|
3
3
|
yes: boolean;
|
|
4
|
+
undo?: boolean;
|
|
4
5
|
}
|
|
6
|
+
export declare const NOT_WEB_DECK = "DECK_DATA_RESET_NOT_WEB_DECK";
|
|
7
|
+
export declare function needsClassicClear(err: unknown): boolean;
|
|
5
8
|
export interface ResetLeaderboardsDeps {
|
|
6
9
|
signedIn: boolean;
|
|
7
10
|
deckTitle(deckId: string): Promise<string | null>;
|
|
8
|
-
|
|
11
|
+
resetDeckLeaderboards(deckId: string): Promise<{
|
|
12
|
+
undoUntil: string | null;
|
|
13
|
+
}>;
|
|
14
|
+
undoDeckLeaderboardsReset(deckId: string): Promise<void>;
|
|
15
|
+
clearClassicLeaderboards(deckId: string): Promise<void>;
|
|
9
16
|
interactive: boolean;
|
|
10
17
|
confirm(question: string): Promise<boolean>;
|
|
11
18
|
log(line: string): void;
|
|
@@ -1,11 +1,25 @@
|
|
|
1
1
|
// `castle-web reset-leaderboards` -- clears every leaderboard on a deck, for its
|
|
2
|
-
// creator.
|
|
3
|
-
//
|
|
4
|
-
// undo
|
|
5
|
-
//
|
|
2
|
+
// creator. For a Cauldron deck it sends Ghost's resetCauldronDeckLeaderboards, which
|
|
3
|
+
// starts the Store boards and the classic leaderboards over from empty and can be
|
|
4
|
+
// undone for a day with `--undo`; the players' saved data is untouched. A classic
|
|
5
|
+
// deck (Ghost refuses it with DECK_DATA_RESET_NOT_WEB_DECK) falls back to
|
|
6
|
+
// clearDeckLeaderboards, the classic editor's "Reset all leaderboards", which has no
|
|
7
|
+
// undo.
|
|
6
8
|
//
|
|
7
|
-
// This command is for a signed-in creator at a terminal.
|
|
8
|
-
//
|
|
9
|
+
// This command is for a signed-in creator at a terminal. Neither mutation is in the
|
|
10
|
+
// cloud sandbox's GraphQL allowlist, so the deck agent cannot send them.
|
|
11
|
+
// Ghost's refusal of a classic deck, from the Cauldron reset.
|
|
12
|
+
export const NOT_WEB_DECK = 'DECK_DATA_RESET_NOT_WEB_DECK';
|
|
13
|
+
// Whether the Cauldron reset cannot run here and the classic clear should: a classic
|
|
14
|
+
// deck, or a Ghost from before resetCauldronDeckLeaderboards existed (so this CLI can
|
|
15
|
+
// publish ahead of the server). The classic clear has no undo and leaves Store boards.
|
|
16
|
+
export function needsClassicClear(err) {
|
|
17
|
+
const failure = err;
|
|
18
|
+
if (failure?.extensions?.code === NOT_WEB_DECK)
|
|
19
|
+
return true;
|
|
20
|
+
// Ghost's GraphQL Yoga reports an unknown field with this message and no code.
|
|
21
|
+
return String(failure?.message).includes('Cannot query field "resetCauldronDeckLeaderboards"');
|
|
22
|
+
}
|
|
9
23
|
export async function resetLeaderboards(options, deps) {
|
|
10
24
|
const deckId = options.deckId;
|
|
11
25
|
if (!deckId) {
|
|
@@ -18,18 +32,39 @@ export async function resetLeaderboards(options, deps) {
|
|
|
18
32
|
// still decides whether the deck exists and is this user's.
|
|
19
33
|
const title = await deps.deckTitle(deckId);
|
|
20
34
|
const named = title ? `"${title}" (${deckId})` : `deck ${deckId}`;
|
|
35
|
+
if (options.undo) {
|
|
36
|
+
await deps.undoDeckLeaderboardsReset(deckId);
|
|
37
|
+
deps.log(`Put back the leaderboards of ${named} as they were before the last reset.`);
|
|
38
|
+
return;
|
|
39
|
+
}
|
|
21
40
|
if (!options.yes) {
|
|
22
41
|
if (!deps.interactive) {
|
|
23
42
|
throw new Error(`Not resetting the leaderboards of ${named}: there is no terminal to confirm on. Pass --yes to reset anyway.`);
|
|
24
43
|
}
|
|
25
|
-
const question = `Reset every leaderboard on ${named}? All of its scores are cleared
|
|
44
|
+
const question = `Reset every leaderboard on ${named}? All of its scores are cleared; players' saved data is kept. [y/N] `;
|
|
26
45
|
if (!(await deps.confirm(question))) {
|
|
27
46
|
deps.log('Nothing was reset.');
|
|
28
47
|
return;
|
|
29
48
|
}
|
|
30
49
|
}
|
|
31
|
-
|
|
50
|
+
let undoUntil;
|
|
51
|
+
try {
|
|
52
|
+
({ undoUntil } = await deps.resetDeckLeaderboards(deckId));
|
|
53
|
+
}
|
|
54
|
+
catch (err) {
|
|
55
|
+
if (!needsClassicClear(err)) {
|
|
56
|
+
throw err;
|
|
57
|
+
}
|
|
58
|
+
await deps.clearClassicLeaderboards(deckId);
|
|
59
|
+
deps.log(`Reset the classic leaderboards on ${named} for good: there is no undo here.`);
|
|
60
|
+
return;
|
|
61
|
+
}
|
|
32
62
|
deps.log(`Reset every leaderboard on ${named}. They start empty from the next score.`);
|
|
63
|
+
if (undoUntil) {
|
|
64
|
+
// Names the deck: --undo skips the prompt, and run from another deck's directory
|
|
65
|
+
// the bare command would undo that deck instead.
|
|
66
|
+
deps.log(`Changed your mind? \`castle-web reset-leaderboards --deck-id ${deckId} --undo\` puts the scores back until ${undoUntil}.`);
|
|
67
|
+
}
|
|
33
68
|
}
|
|
34
69
|
// The answer to the confirmation question: only a y or yes resets.
|
|
35
70
|
export function isYes(answer) {
|
package/dist/save-deck.d.ts
CHANGED
|
@@ -1,12 +1,13 @@
|
|
|
1
1
|
import * as api from './api.js';
|
|
2
|
-
import { type BundleChunk } from './bundle.js';
|
|
2
|
+
import { type BundleChunk, type ExternalMediaAsset } from './bundle.js';
|
|
3
3
|
import { type ExperimentConfig } from './castleJson.js';
|
|
4
4
|
import { type SavePrecondition } from './webSourceSync.js';
|
|
5
5
|
export { DeckTooLargeError, MAX_SCENE_DATA_BYTES, MAX_SOURCE_ARCHIVE_BYTES, sceneTooLargeMessage, sourceTooLargeMessage, } from './saveFailure.js';
|
|
6
6
|
export declare const SOURCE_ARCHIVE_EXCLUDES: string[];
|
|
7
7
|
export declare const SAVE_STAGE_TELEMETRY_PREFIX = "CASTLE_SAVE_TELEMETRY ";
|
|
8
8
|
export declare const SAVE_COVER_SELECTION_TELEMETRY_PREFIX = "CASTLE_SAVE_COVER_SELECTION ";
|
|
9
|
-
export
|
|
9
|
+
export declare const SAVE_ASSET_INLINE_TELEMETRY_PREFIX = "CASTLE_SAVE_ASSET_INLINE ";
|
|
10
|
+
export type SaveStage = 'bundle' | 'cover' | 'chunk_upload' | 'asset_upload' | 'scene_upload_config' | 'scene_upload' | 'content_publish' | 'server_publish' | 'source_archive' | 'source_upload_config' | 'source_upload' | 'source_commit';
|
|
10
11
|
export declare function runTar(args: string[], opts?: {
|
|
11
12
|
capture?: boolean;
|
|
12
13
|
}): Promise<string>;
|
|
@@ -50,6 +51,35 @@ export declare function uploadBundleChunks(deckId: string, chunks: BundleChunk[]
|
|
|
50
51
|
skipped: number;
|
|
51
52
|
bytesUploaded: number;
|
|
52
53
|
}>;
|
|
54
|
+
export declare const MAX_MEDIA_ASSET_BYTES: number;
|
|
55
|
+
export interface MediaUploadResult {
|
|
56
|
+
uploaded: number;
|
|
57
|
+
skipped: number;
|
|
58
|
+
bytesUploaded: number;
|
|
59
|
+
/** The URLs this upload stored (not the ones already there), to check are served. */
|
|
60
|
+
storedUrls: string[];
|
|
61
|
+
/** Assets Ghost refused, with its code: the page must be built with these inline. */
|
|
62
|
+
refused: {
|
|
63
|
+
asset: ExternalMediaAsset;
|
|
64
|
+
code: string;
|
|
65
|
+
}[];
|
|
66
|
+
}
|
|
67
|
+
export declare const ASSET_SERVED_RETRY_MS: number[];
|
|
68
|
+
/** True once every URL is served through the CDN, trying again after each wait. Exported for the tests. */
|
|
69
|
+
export declare function assetsServed(urls: string[], retryMs?: number[]): Promise<boolean>;
|
|
70
|
+
/**
|
|
71
|
+
* Puts every media asset the page names at its URL, as uploadBundleChunks does
|
|
72
|
+
* chunks: one already there (HEAD 200) is skipped, any other uploaded and
|
|
73
|
+
* stored, and the first that cannot be stored fails the save before the page
|
|
74
|
+
* is published -- except one Ghost refuses (ASSET_REFUSED), which is reported
|
|
75
|
+
* in `refused` for the caller to inline. Null when this Ghost has no asset
|
|
76
|
+
* store: the caller builds the page with its media inline instead.
|
|
77
|
+
* Exported for the tests.
|
|
78
|
+
*/
|
|
79
|
+
export declare function uploadMediaAssets(deckId: string, assets: ExternalMediaAsset[], { busyRetryMs }?: {
|
|
80
|
+
busyRetryMs?: number[];
|
|
81
|
+
}): Promise<MediaUploadResult | null>;
|
|
82
|
+
export type AssetInlineReason = 'no_store' | 'cdn_not_serving' | 'refused';
|
|
53
83
|
export type SaveVisibility = 'unlisted' | 'private';
|
|
54
84
|
export interface SaveDeckOptions {
|
|
55
85
|
title?: string;
|
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
|
-
|
|
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
|
|
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
|
|
406
|
-
// same upload is stored again after a wait, these waits, then the
|
|
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) !==
|
|
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
|
|
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
|
-
|
|
458
|
-
|
|
459
|
-
|
|
460
|
-
|
|
461
|
-
|
|
462
|
-
|
|
463
|
-
|
|
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
|
-
|
|
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
|
-
|
|
468
|
-
|
|
469
|
-
|
|
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 +=
|
|
474
|
-
|
|
475
|
-
|
|
476
|
-
|
|
477
|
-
|
|
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 {
|
|
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,
|
package/kits/base/CLAUDE.md
CHANGED
|
@@ -14,7 +14,7 @@ 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
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").
|