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.
- package/dist/agent-failures.d.ts +8 -0
- package/dist/agent-failures.js +19 -2
- package/dist/agent-prompts.d.ts +1 -1
- package/dist/agent-prompts.js +10 -3
- package/dist/agent.d.ts +64 -3
- package/dist/agent.js +170 -81
- package/dist/api.d.ts +11 -0
- package/dist/api.js +43 -0
- package/dist/bundle.d.ts +64 -0
- package/dist/bundle.js +558 -2
- package/dist/castle-host/host.d.ts +18 -2
- package/dist/castle-host/host.js +844 -39
- package/dist/castleJson.d.ts +23 -2
- package/dist/castleJson.js +46 -2
- package/dist/check.d.ts +3 -1
- package/dist/check.js +20 -3
- package/dist/chunkLoader.d.ts +3 -0
- package/dist/chunkLoader.js +111 -0
- package/dist/devParty.d.ts +26 -0
- package/dist/devParty.js +231 -0
- package/dist/devSaveStorage.js +4 -0
- package/dist/devSessionStorage.js +50 -2
- package/dist/devSocial.d.ts +24 -0
- package/dist/devSocial.js +70 -0
- package/dist/ide.d.ts +2 -0
- package/dist/ide.js +119 -15
- package/dist/importPinMismatch.d.ts +22 -0
- package/dist/importPinMismatch.js +77 -0
- package/dist/importRegression.js +3 -15
- package/dist/imports.d.ts +10 -3
- package/dist/imports.js +88 -20
- package/dist/index.js +11 -4
- package/dist/init.js +1 -1
- package/dist/platformDoc.js +22 -0
- package/dist/routerFences.d.ts +5 -0
- package/dist/routerFences.js +12 -2
- package/dist/save-deck.d.ts +25 -1
- package/dist/save-deck.js +178 -9
- package/dist/serve.js +32 -11
- package/dist/shell/assets/{index-D2tWM896.js → index-DulbYIJm.js} +97 -97
- package/dist/shell/assets/index-MVLfNYd9.css +1 -0
- package/dist/shell/index.html +2 -2
- package/dist/taskSteer.d.ts +13 -0
- package/dist/taskSteer.js +22 -2
- package/dist/vitePlugins.d.ts +2 -1
- package/dist/vitePlugins.js +13 -0
- package/kits/base/castle.json +1 -1
- package/kits/base/package-lock.json +1 -1
- package/kits/base/sdk/README.md +339 -5
- package/kits/base/sdk/avatar.d.ts +6 -2
- package/kits/base/sdk/avatar.js +12 -4
- package/kits/base/sdk/castle.d.ts +7 -3
- package/kits/base/sdk/castle.js +2 -0
- package/kits/base/sdk/commands.d.ts +176 -1
- package/kits/base/sdk/commands.js +3 -0
- package/kits/base/sdk/display.d.ts +3 -0
- package/kits/base/sdk/display.js +9 -3
- package/kits/base/sdk/hub.d.ts +37 -6
- package/kits/base/sdk/hub.js +63 -4
- package/kits/base/sdk/multiplayer.d.ts +7 -1
- package/kits/base/sdk/multiplayer.js +148 -32
- package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
- package/kits/base/sdk/party.d.ts +23 -0
- package/kits/base/sdk/party.js +91 -0
- package/kits/base/sdk/reconnectBudget.d.ts +23 -0
- package/kits/base/sdk/reconnectBudget.js +96 -0
- package/kits/base/sdk/save.d.ts +38 -1
- package/kits/base/sdk/save.js +81 -7
- package/kits/base/sdk/server/hub.d.ts +117 -0
- package/kits/base/sdk/server/hub.js +119 -2
- package/kits/base/sdk/server/platformHandle.d.ts +43 -1
- package/kits/base/sdk/server/storage.d.ts +17 -0
- package/kits/base/sdk/server/storage.js +65 -3
- package/kits/base/sdk/server/wrapper.d.ts +43 -6
- package/kits/base/sdk/server/wrapper.js +93 -9
- package/kits/base/sdk/social.d.ts +9 -0
- package/kits/base/sdk/social.js +5 -0
- package/kits/hub-game/CLAUDE.md +451 -13
- package/kits/hub-game/README.md +63 -0
- package/kits/hub-game/blueprints/avatar-10.scene +28 -0
- package/kits/hub-game/blueprints/avatar-11.scene +28 -0
- package/kits/hub-game/blueprints/avatar-12.scene +28 -0
- package/kits/hub-game/blueprints/avatar-13.scene +28 -0
- package/kits/hub-game/blueprints/avatar-14.scene +28 -0
- package/kits/hub-game/blueprints/avatar-15.scene +28 -0
- package/kits/hub-game/blueprints/avatar-4.scene +28 -0
- package/kits/hub-game/blueprints/avatar-5.scene +28 -0
- package/kits/hub-game/blueprints/avatar-6.scene +28 -0
- package/kits/hub-game/blueprints/avatar-7.scene +28 -0
- package/kits/hub-game/blueprints/avatar-8.scene +28 -0
- package/kits/hub-game/blueprints/avatar-9.scene +28 -0
- package/kits/hub-game/castle.json +5 -5
- package/kits/hub-game/code/client/act.js +312 -0
- package/kits/hub-game/code/client/actionLayout.js +147 -0
- package/kits/hub-game/code/client/actionOverflow.js +556 -0
- package/kits/hub-game/code/client/actorBudget.js +47 -0
- package/kits/hub-game/code/client/arrivalCamera.js +50 -0
- package/kits/hub-game/code/client/askSlot.js +117 -0
- package/kits/hub-game/code/client/attention.js +11 -2
- package/kits/hub-game/code/client/avatar.js +311 -35
- package/kits/hub-game/code/client/avatarCap.js +228 -0
- package/kits/hub-game/code/client/avatarColors.js +70 -0
- package/kits/hub-game/code/client/avatarFaces.js +21 -0
- package/kits/hub-game/code/client/avatarShare.js +253 -0
- package/kits/hub-game/code/client/backVisibility.js +13 -0
- package/kits/hub-game/code/client/ballot.js +472 -0
- package/kits/hub-game/code/client/build.js +38 -0
- package/kits/hub-game/code/client/chat.js +41 -5
- package/kits/hub-game/code/client/chatModeration.js +5 -0
- package/kits/hub-game/code/client/chrome.js +2144 -160
- package/kits/hub-game/code/client/companion.js +716 -0
- package/kits/hub-game/code/client/companionDress.js +99 -0
- package/kits/hub-game/code/client/crowdNames.js +241 -0
- package/kits/hub-game/code/client/decor.js +515 -0
- package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
- package/kits/hub-game/code/client/doorErrors.js +39 -0
- package/kits/hub-game/code/client/earned.js +131 -0
- package/kits/hub-game/code/client/emoteBubble.js +75 -0
- package/kits/hub-game/code/client/fall.js +18 -0
- package/kits/hub-game/code/client/farAvatars.js +233 -0
- package/kits/hub-game/code/client/firstJoin.js +9 -2
- package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
- package/kits/hub-game/code/client/frameBatch.js +5 -0
- package/kits/hub-game/code/client/grab.js +368 -29
- package/kits/hub-game/code/client/hookLayer.js +385 -20
- package/kits/hub-game/code/client/hudCopy.js +51 -0
- package/kits/hub-game/code/client/hudRate.js +20 -0
- package/kits/hub-game/code/client/idle.js +177 -24
- package/kits/hub-game/code/client/interestCap.js +81 -0
- package/kits/hub-game/code/client/invites.js +231 -0
- package/kits/hub-game/code/client/joinError.js +9 -0
- package/kits/hub-game/code/client/keys.js +36 -0
- package/kits/hub-game/code/client/labelsNear.js +234 -0
- package/kits/hub-game/code/client/landscapeLayout.js +17 -0
- package/kits/hub-game/code/client/layoutCache.js +264 -0
- package/kits/hub-game/code/client/loadTelemetry.js +20 -0
- package/kits/hub-game/code/client/loadingCover.js +148 -0
- package/kits/hub-game/code/client/loadingEntry.js +8 -0
- package/kits/hub-game/code/client/menuIcons.js +34 -0
- package/kits/hub-game/code/client/menuRows.js +43 -0
- package/kits/hub-game/code/client/modelReady.js +7 -0
- package/kits/hub-game/code/client/pack.js +6 -2
- package/kits/hub-game/code/client/packFormat.js +3 -3
- package/kits/hub-game/code/client/padCueArrival.js +23 -0
- package/kits/hub-game/code/client/padCues.js +112 -0
- package/kits/hub-game/code/client/padOccupancy.js +88 -0
- package/kits/hub-game/code/client/padReadability.js +26 -0
- package/kits/hub-game/code/client/padRings.js +69 -0
- package/kits/hub-game/code/client/pushVisit.js +14 -0
- package/kits/hub-game/code/client/quality.js +205 -0
- package/kits/hub-game/code/client/qualityEntry.js +55 -0
- package/kits/hub-game/code/client/rehello.js +167 -0
- package/kits/hub-game/code/client/safeLayout.js +338 -0
- package/kits/hub-game/code/client/safeStyle.js +42 -0
- package/kits/hub-game/code/client/say.js +12 -3
- package/kits/hub-game/code/client/shot.js +146 -0
- package/kits/hub-game/code/client/shotFit.js +56 -0
- package/kits/hub-game/code/client/signIn.js +28 -0
- package/kits/hub-game/code/client/sound.js +63 -8
- package/kits/hub-game/code/client/soundscape.js +1151 -0
- package/kits/hub-game/code/client/soundscapeActions.js +99 -0
- package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
- package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
- package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
- package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
- package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
- package/kits/hub-game/code/client/soundscapeCues.js +362 -0
- package/kits/hub-game/code/client/soundscapeMap.js +181 -0
- package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
- package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
- package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
- package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
- package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
- package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
- package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
- package/kits/hub-game/code/client/soundscapeUi.js +211 -0
- package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
- package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
- package/kits/hub-game/code/client/spin.js +101 -0
- package/kits/hub-game/code/client/state.js +162 -1
- package/kits/hub-game/code/client/stuck.js +259 -0
- package/kits/hub-game/code/client/talk.js +714 -59
- package/kits/hub-game/code/client/tiers.js +543 -52
- package/kits/hub-game/code/client/toastBand.js +37 -0
- package/kits/hub-game/code/client/together.js +39 -2
- package/kits/hub-game/code/client/visibility.js +43 -0
- package/kits/hub-game/code/client/weakestLookBake.js +92 -0
- package/kits/hub-game/code/client/weakestTier.js +295 -0
- package/kits/hub-game/code/client/wear.js +461 -170
- package/kits/hub-game/code/client/worldLabels.js +241 -0
- package/kits/hub-game/code/client/yours.js +200 -0
- package/kits/hub-game/code/companionSpec.js +45 -0
- package/kits/hub-game/code/npcDisplayText.js +55 -0
- package/kits/hub-game/code/privateText.js +7 -0
- package/kits/hub-game/code/server/act.js +124 -0
- package/kits/hub-game/code/server/actions.js +138 -0
- package/kits/hub-game/code/server/actors.js +11 -2
- package/kits/hub-game/code/server/analytics.js +83 -0
- package/kits/hub-game/code/server/anonymousEntry.js +49 -0
- package/kits/hub-game/code/server/arrivalPose.js +36 -0
- package/kits/hub-game/code/server/ask.js +155 -0
- package/kits/hub-game/code/server/ballot.js +539 -0
- package/kits/hub-game/code/server/cells.js +100 -0
- package/kits/hub-game/code/server/companion.js +107 -0
- package/kits/hub-game/code/server/cues.js +70 -0
- package/kits/hub-game/code/server/decor.js +269 -0
- package/kits/hub-game/code/server/doorAnalytics.js +52 -0
- package/kits/hub-game/code/server/earned.js +478 -0
- package/kits/hub-game/code/server/frameBatch.js +183 -0
- package/kits/hub-game/code/server/friendBests.js +166 -0
- package/kits/hub-game/code/server/friendsAmong.js +272 -0
- package/kits/hub-game/code/server/history.js +7 -0
- package/kits/hub-game/code/server/hub.js +2510 -95
- package/kits/hub-game/code/server/idle.js +60 -12
- package/kits/hub-game/code/server/index.js +28 -6
- package/kits/hub-game/code/server/invites.js +19 -0
- package/kits/hub-game/code/server/labels.js +36 -2
- package/kits/hub-game/code/server/loadAbandon.js +106 -0
- package/kits/hub-game/code/server/manifest.js +586 -7
- package/kits/hub-game/code/server/menu.js +161 -0
- package/kits/hub-game/code/server/npcs.js +1025 -113
- package/kits/hub-game/code/server/observe.js +408 -0
- package/kits/hub-game/code/server/padOccupancy.js +85 -0
- package/kits/hub-game/code/server/party.js +2 -2
- package/kits/hub-game/code/server/players.js +30 -0
- package/kits/hub-game/code/server/resumePose.js +152 -0
- package/kits/hub-game/code/server/say.js +1 -1
- package/kits/hub-game/code/server/shot.js +110 -0
- package/kits/hub-game/code/server/standing.js +123 -0
- package/kits/hub-game/code/server/storageLimit.js +187 -0
- package/kits/hub-game/code/server/vis.js +175 -0
- package/kits/hub-game/code/server/wear.js +12 -0
- package/kits/hub-game/code/server/yours.js +59 -0
- package/kits/hub-game/code/shared/act.js +35 -0
- package/kits/hub-game/code/shared/cues.js +9 -0
- package/kits/hub-game/code/shared/danceIdle.js +28 -0
- package/kits/hub-game/code/shared/decor.js +41 -0
- package/kits/hub-game/code/shared/loadStages.js +12 -0
- package/kits/hub-game/code/shared/quality.js +74 -0
- package/kits/hub-game/code/shared/say.js +2 -0
- package/kits/hub-game/code/shared/shot.js +53 -0
- package/kits/hub-game/code/shared/spin.js +57 -0
- package/kits/hub-game/code/systems/hub.js +1753 -202
- package/kits/hub-game/docs/analytics.md +279 -0
- package/kits/hub-game/docs/content-pack.md +1 -1
- package/kits/hub-game/docs/contract.md +3475 -77
- package/kits/hub-game/docs/home-pieces.md +71 -0
- package/kits/hub-game/docs/observed-progress.md +252 -0
- package/kits/hub-game/main.jsx +2 -0
- package/kits/hub-game/models/avatar-10.pxmodel +28 -0
- package/kits/hub-game/models/avatar-11.pxmodel +28 -0
- package/kits/hub-game/models/avatar-12.pxmodel +27 -0
- package/kits/hub-game/models/avatar-13.pxmodel +24 -0
- package/kits/hub-game/models/avatar-14.pxmodel +29 -0
- package/kits/hub-game/models/avatar-15.pxmodel +24 -0
- package/kits/hub-game/models/avatar-4.pxmodel +29 -0
- package/kits/hub-game/models/avatar-5.pxmodel +27 -0
- package/kits/hub-game/models/avatar-6.pxmodel +26 -0
- package/kits/hub-game/models/avatar-7.pxmodel +25 -0
- package/kits/hub-game/models/avatar-8.pxmodel +24 -0
- package/kits/hub-game/models/avatar-9.pxmodel +30 -0
- package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
- package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
- package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
- package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
- package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
- package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
- package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
- package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
- package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
- package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
- package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
- package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
- package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
- package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
- package/kits/hub-game/models/hats/cap.pxmodel +162 -0
- package/kits/hub-game/models/hats/captain.pxmodel +178 -0
- package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
- package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
- package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
- package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
- package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
- package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
- package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
- package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
- package/kits/hub-game/models/hats/straw.pxmodel +139 -0
- package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
- package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
- package/kits/hub-game/models/hats/witch.pxmodel +147 -0
- package/kits/hub-game/package-lock.json +10 -1
- package/kits/hub-game/package.json +6 -2
- package/kits/hub-game/play/player.js +142 -0
- package/kits/hub-game/play/registry.js +47 -0
- package/kits/hub-game/play.jsx +37 -0
- package/kits/hub-game/scripts/check.mjs +117 -16
- package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
- package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +132 -0
- package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
- package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +26 -0
- package/kits/hub-game/scripts/fixtures/fake-dom.mjs +123 -0
- package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
- package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
- package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
- package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
- package/kits/hub-game/scripts/gen-earned.mjs +285 -0
- package/kits/hub-game/scripts/gen-hats.mjs +827 -0
- package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
- package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
- package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
- package/kits/hub-game/scripts/test-act-client.mjs +186 -0
- package/kits/hub-game/scripts/test-act.mjs +171 -0
- package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
- package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
- package/kits/hub-game/scripts/test-actions-client.mjs +853 -0
- package/kits/hub-game/scripts/test-actions.mjs +298 -0
- package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
- package/kits/hub-game/scripts/test-actors.mjs +38 -23
- package/kits/hub-game/scripts/test-analytics.mjs +76 -0
- package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
- package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
- package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
- package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
- package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
- package/kits/hub-game/scripts/test-ask.mjs +269 -0
- package/kits/hub-game/scripts/test-attention.mjs +10 -1
- package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
- package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
- package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
- package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
- package/kits/hub-game/scripts/test-avatar-wire.mjs +792 -0
- package/kits/hub-game/scripts/test-avatar.mjs +584 -7
- package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
- package/kits/hub-game/scripts/test-ballot.mjs +1008 -0
- package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
- package/kits/hub-game/scripts/test-build.mjs +49 -0
- package/kits/hub-game/scripts/test-cells.mjs +71 -0
- package/kits/hub-game/scripts/test-chat.mjs +863 -0
- package/kits/hub-game/scripts/test-classic.mjs +2 -0
- package/kits/hub-game/scripts/test-companion-chat.mjs +216 -0
- package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
- package/kits/hub-game/scripts/test-companion.mjs +259 -0
- package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
- package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
- package/kits/hub-game/scripts/test-decor-client.mjs +344 -0
- package/kits/hub-game/scripts/test-decor.mjs +464 -0
- package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
- package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
- package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
- package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
- package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
- package/kits/hub-game/scripts/test-earned.mjs +1224 -0
- package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
- package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
- package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
- package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
- package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
- package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
- package/kits/hub-game/scripts/test-grab-orbit.mjs +961 -0
- package/kits/hub-game/scripts/test-grab.mjs +7 -0
- package/kits/hub-game/scripts/test-hats.mjs +422 -168
- package/kits/hub-game/scripts/test-high-only.mjs +170 -0
- package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
- package/kits/hub-game/scripts/test-hub-ops.mjs +758 -2
- package/kits/hub-game/scripts/test-hub-trip.mjs +1594 -12
- package/kits/hub-game/scripts/test-hud-clear.mjs +484 -57
- package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
- package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
- package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
- package/kits/hub-game/scripts/test-idle.mjs +427 -1
- package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
- package/kits/hub-game/scripts/test-interest-cells.mjs +513 -0
- package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
- package/kits/hub-game/scripts/test-interest.mjs +15 -0
- package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
- package/kits/hub-game/scripts/test-invites.mjs +109 -0
- package/kits/hub-game/scripts/test-keys.mjs +46 -1
- package/kits/hub-game/scripts/test-labels.mjs +664 -0
- package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
- package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
- package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
- package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
- package/kits/hub-game/scripts/test-manifest.mjs +472 -0
- package/kits/hub-game/scripts/test-menu-client.mjs +585 -0
- package/kits/hub-game/scripts/test-menu.mjs +319 -0
- package/kits/hub-game/scripts/test-npcs.mjs +2528 -13
- package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
- package/kits/hub-game/scripts/test-observed.mjs +745 -0
- package/kits/hub-game/scripts/test-pack.mjs +7 -0
- package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
- package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
- package/kits/hub-game/scripts/test-picker.mjs +541 -0
- package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
- package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
- package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
- package/kits/hub-game/scripts/test-quality.mjs +385 -0
- package/kits/hub-game/scripts/test-rehello.mjs +1733 -0
- package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
- package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
- package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
- package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
- package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
- package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
- package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
- package/kits/hub-game/scripts/test-say.mjs +1 -1
- package/kits/hub-game/scripts/test-shot.mjs +901 -0
- package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
- package/kits/hub-game/scripts/test-soundscape.mjs +5437 -0
- package/kits/hub-game/scripts/test-spin.mjs +314 -0
- package/kits/hub-game/scripts/test-standing.mjs +449 -0
- package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
- package/kits/hub-game/scripts/test-stuck.mjs +1904 -0
- package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
- package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
- package/kits/hub-game/scripts/test-tiers-render.mjs +412 -0
- package/kits/hub-game/scripts/test-tiers.mjs +476 -2
- package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
- package/kits/hub-game/scripts/test-try-on.mjs +22 -22
- package/kits/hub-game/scripts/test-vis.mjs +770 -0
- package/kits/hub-game/scripts/test-visibility.mjs +134 -0
- package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
- package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
- package/kits/hub-game/scripts/test-yours-chrome.mjs +210 -0
- package/kits/hub-game/scripts/test-yours.mjs +403 -0
- package/kits/multiplayer-3d/CLAUDE.md +50 -0
- package/kits/multiplayer-3d/castle.json +5 -5
- package/kits/multiplayer-3d/code/client/avatars.js +7 -0
- package/kits/multiplayer-3d/code/client/gait.js +65 -0
- package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
- package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
- package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
- package/kits/multiplayer-3d/code/options.js +5 -0
- package/kits/multiplayer-3d/code/server/ownership.js +10 -2
- package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
- package/kits/multiplayer-3d/code/server/world.js +7 -0
- package/kits/multiplayer-3d/code/systems/multiplayer.js +443 -34
- package/kits/multiplayer-3d/package-lock.json +8 -1
- package/kits/multiplayer-3d/package.json +3 -1
- package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
- package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
- package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
- package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
- package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
- package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
- package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
- package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
- package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
- package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
- package/kits/physics-2d/CLAUDE.md +19 -1
- package/kits/physics-2d/castle.json +2 -2
- package/kits/physics-2d/engine/frozenActors.js +233 -0
- package/kits/physics-2d/engine/scene.js +337 -3
- package/kits/physics-2d/engine/skyKey.js +129 -0
- package/kits/physics-2d/engine/stillClock.js +106 -0
- package/kits/physics-2d/engine/updateBudget.js +21 -0
- package/kits/physics-2d/eslint.config.js +1 -1
- package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
- package/kits/physics-2d/play/behaviors/Camera.js +40 -0
- package/kits/physics-2d/play/behaviors/Collider.js +122 -0
- package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
- package/kits/physics-2d/play/behaviors/Goal.js +46 -0
- package/kits/physics-2d/play/behaviors/Joints.js +126 -0
- package/kits/physics-2d/play/behaviors/Layout.js +71 -0
- package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
- package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
- package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
- package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
- package/kits/physics-2d/play/behaviors/Style.js +209 -0
- package/kits/physics-2d/play/behaviors/Text.js +85 -0
- package/kits/physics-2d/play/behaviors/Video.js +93 -0
- package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
- package/kits/physics-3d/CLAUDE.md +42 -529
- package/kits/physics-3d/behaviors/Body.jsx +3 -0
- package/kits/physics-3d/behaviors/Model.jsx +3 -0
- package/kits/physics-3d/behaviors/Player.jsx +661 -87
- package/kits/physics-3d/behaviors/Shape.jsx +3 -0
- package/kits/physics-3d/behaviors/Solid.jsx +3 -0
- package/kits/physics-3d/behaviors/Transform.jsx +3 -0
- package/kits/physics-3d/castle.json +3 -3
- package/kits/physics-3d/docs/engine-camera.md +542 -0
- package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
- package/kits/physics-3d/docs/engine-load.md +149 -0
- package/kits/physics-3d/docs/engine-look.md +114 -0
- package/kits/physics-3d/docs/engine-shadows.md +372 -0
- package/kits/physics-3d/docs/engine-skip-work.md +187 -0
- package/kits/physics-3d/docs/engine-sky.md +198 -0
- package/kits/physics-3d/docs/engine-static-actors.md +226 -0
- package/kits/physics-3d/docs/engine-view.md +37 -0
- package/kits/physics-3d/docs/pxmodel-format.md +9 -1
- package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
- package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -277
- package/kits/physics-3d/engine3d/actornode.js +87 -0
- package/kits/physics-3d/engine3d/animationBudget.js +23 -0
- package/kits/physics-3d/engine3d/branches.js +3 -13
- package/kits/physics-3d/engine3d/cage.js +2 -7
- package/kits/physics-3d/engine3d/cageops.js +2 -17
- package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
- package/kits/physics-3d/engine3d/editorWorld.js +6 -0
- package/kits/physics-3d/engine3d/emptynodes.js +232 -0
- package/kits/physics-3d/engine3d/framecap.js +99 -0
- package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
- package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
- package/kits/physics-3d/engine3d/gait.js +126 -0
- package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
- package/kits/physics-3d/engine3d/kithooks.js +47 -0
- package/kits/physics-3d/engine3d/look.js +514 -48
- package/kits/physics-3d/engine3d/lookbake.js +208 -0
- package/kits/physics-3d/engine3d/materialpresets.js +2 -0
- package/kits/physics-3d/engine3d/modelFiles.js +3 -17
- package/kits/physics-3d/engine3d/modelMath.js +49 -0
- package/kits/physics-3d/engine3d/modelready.js +16 -0
- package/kits/physics-3d/engine3d/motion.js +39 -10
- package/kits/physics-3d/engine3d/nearshadows.js +106 -21
- package/kits/physics-3d/engine3d/optimize.js +9 -5
- package/kits/physics-3d/engine3d/orbitinput.js +522 -10
- package/kits/physics-3d/engine3d/orbitlens.js +48 -0
- package/kits/physics-3d/engine3d/ownmodel.js +213 -0
- package/kits/physics-3d/engine3d/partgeometry.js +1 -16
- package/kits/physics-3d/engine3d/paths.js +1 -9
- package/kits/physics-3d/engine3d/playTimings.js +50 -0
- package/kits/physics-3d/engine3d/playerRun.js +372 -0
- package/kits/physics-3d/engine3d/pxmodel.js +42 -11
- package/kits/physics-3d/engine3d/rapier.js +27 -0
- package/kits/physics-3d/engine3d/scatter.js +1 -11
- package/kits/physics-3d/engine3d/shadowfade.js +890 -0
- package/kits/physics-3d/engine3d/sky.js +547 -0
- package/kits/physics-3d/engine3d/skylife.js +306 -0
- package/kits/physics-3d/engine3d/squarefirst.js +177 -0
- package/kits/physics-3d/engine3d/stillshadows.js +399 -0
- package/kits/physics-3d/engine3d/sweep.js +1 -25
- package/kits/physics-3d/engine3d/unchanged.js +11 -0
- package/kits/physics-3d/engine3d/viewrange.js +52 -0
- package/kits/physics-3d/engine3d/world3d.js +1253 -76
- package/kits/physics-3d/eslint.config.js +2 -1
- package/kits/physics-3d/main.jsx +10 -2
- package/kits/physics-3d/package-lock.json +7 -0
- package/kits/physics-3d/package.json +5 -1
- package/kits/physics-3d/play/behaviors/Body.js +31 -0
- package/kits/physics-3d/play/behaviors/Door.js +37 -0
- package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
- package/kits/physics-3d/play/behaviors/Model.js +23 -0
- package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
- package/kits/physics-3d/play/behaviors/Player.js +1204 -0
- package/kits/physics-3d/play/behaviors/Shape.js +47 -0
- package/kits/physics-3d/play/behaviors/Solid.js +16 -0
- package/kits/physics-3d/play/behaviors/Transform.js +29 -0
- package/kits/physics-3d/pnpm-lock.yaml +8 -0
- package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
- package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
- package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
- package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
- package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
- package/kits/physics-3d/scripts/test-camera-orbit.mjs +2613 -82
- package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +2 -2
- package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
- package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +438 -0
- package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
- package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
- package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
- package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
- package/kits/physics-3d/scripts/test-gait.mjs +387 -0
- package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
- package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
- package/kits/physics-3d/scripts/test-near-shadows.mjs +5 -2
- package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +2001 -0
- package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +582 -0
- package/kits/physics-3d/scripts/test-orbit-shot.mjs +657 -0
- package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
- package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
- package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
- package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
- package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
- package/kits/physics-3d/scripts/test-static-actors.mjs +10 -1
- package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
- package/kits/physics-3d/scripts/test-static-scenery.mjs +2174 -0
- package/kits/physics-3d/scripts/test-steady-hover.mjs +7 -2
- package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
- package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
- package/kits/physics-3d/systems/physics3d.js +419 -9
- package/kits/real-time/castle.json +2 -2
- package/kits/real-time/code/client/connection.js +33 -10
- package/kits/real-time/code/client/gameHooks.js +2 -0
- package/kits/real-time/code/client/joinOverlay.js +9 -4
- package/kits/real-time/code/server/gameHooks.js +7 -0
- package/kits/real-time/code/server/session.js +102 -22
- package/kits/real-time/package-lock.json +1 -1
- package/package.json +2 -2
- package/dist/shell/assets/index-Cf61cNfT.css +0 -1
package/kits/base/sdk/save.js
CHANGED
|
@@ -7,6 +7,10 @@ export class SaveError extends CastleError {
|
|
|
7
7
|
receipt;
|
|
8
8
|
retryAfterMs;
|
|
9
9
|
target;
|
|
10
|
+
current;
|
|
11
|
+
playerId;
|
|
12
|
+
expectedResetGeneration;
|
|
13
|
+
resetGeneration;
|
|
10
14
|
constructor(envelope) {
|
|
11
15
|
super({
|
|
12
16
|
code: envelope.code,
|
|
@@ -20,6 +24,10 @@ export class SaveError extends CastleError {
|
|
|
20
24
|
this.receipt = envelope.receipt;
|
|
21
25
|
this.retryAfterMs = envelope.retryAfterMs;
|
|
22
26
|
this.target = envelope.target;
|
|
27
|
+
this.current = envelope.current;
|
|
28
|
+
this.playerId = envelope.playerId;
|
|
29
|
+
this.expectedResetGeneration = envelope.expectedResetGeneration;
|
|
30
|
+
this.resetGeneration = envelope.resetGeneration;
|
|
23
31
|
}
|
|
24
32
|
}
|
|
25
33
|
/**
|
|
@@ -60,7 +68,8 @@ const MAX_SUBJECT_BYTES = 256;
|
|
|
60
68
|
const MAX_VALUE_BYTES = 256 * 1024;
|
|
61
69
|
const encoder = new TextEncoder();
|
|
62
70
|
const byteLength = (text) => encoder.encode(text).length;
|
|
63
|
-
|
|
71
|
+
// Unicode mode consumes valid pairs together; avoid lookbehind for Safari < 16.4.
|
|
72
|
+
const LONE_SURROGATE = /[\uD800-\uDFFF]/u;
|
|
64
73
|
function invalid(message) {
|
|
65
74
|
throw new SaveError({
|
|
66
75
|
code: "CAULDRON_STORAGE_INVALID_ARGUMENT",
|
|
@@ -240,12 +249,14 @@ function encodeChange(change, server) {
|
|
|
240
249
|
...(remove === undefined ? {} : { remove }),
|
|
241
250
|
};
|
|
242
251
|
}
|
|
243
|
-
function encodeCheck(check, server) {
|
|
252
|
+
function encodeCheck(check, server, conditional = false) {
|
|
244
253
|
const target = validateSaveTarget(check.target, server);
|
|
254
|
+
if (conditional && check.expectedRevision === undefined)
|
|
255
|
+
invalid("Every conditional check needs an expected revision.");
|
|
245
256
|
if (check.expectedRevision === undefined && check.writer === undefined) {
|
|
246
257
|
invalid("A check needs an expected revision or a writer.");
|
|
247
258
|
}
|
|
248
|
-
if (check.expectedRevision !== undefined) {
|
|
259
|
+
if (check.expectedRevision !== undefined && !(conditional && check.expectedRevision === null)) {
|
|
249
260
|
checkText(check.expectedRevision, "expected revision");
|
|
250
261
|
}
|
|
251
262
|
if (check.writer !== undefined)
|
|
@@ -258,7 +269,7 @@ function encodeCheck(check, server) {
|
|
|
258
269
|
...(check.writer === undefined ? {} : { writer: check.writer }),
|
|
259
270
|
};
|
|
260
271
|
}
|
|
261
|
-
function encodeTransaction(input, server) {
|
|
272
|
+
function encodeTransaction(input, server, conditional = false) {
|
|
262
273
|
const changes = checkList(input.changes, "changes").map((change) => encodeChange(change, server));
|
|
263
274
|
const keys = changes.map((change) => saveTargetKey(change.target));
|
|
264
275
|
if (new Set(keys).size !== keys.length) {
|
|
@@ -267,14 +278,35 @@ function encodeTransaction(input, server) {
|
|
|
267
278
|
return {
|
|
268
279
|
operationId: input.operationId,
|
|
269
280
|
expectedAccess: checkText(input.expectedAccess, "expected access"),
|
|
281
|
+
...(input.resetFences === undefined
|
|
282
|
+
? {}
|
|
283
|
+
: { resetFences: encodeResetFences(input.resetFences, server && conditional) }),
|
|
270
284
|
...(input.checks === undefined
|
|
271
285
|
? {}
|
|
272
286
|
: {
|
|
273
|
-
checks: checkList(input.checks, "checks").map((check) => encodeCheck(check, server)),
|
|
287
|
+
checks: checkList(input.checks, "checks").map((check) => encodeCheck(check, server, conditional)),
|
|
274
288
|
}),
|
|
275
289
|
changes,
|
|
276
290
|
};
|
|
277
291
|
}
|
|
292
|
+
function encodeResetFences(value, allowed) {
|
|
293
|
+
if (!allowed || !Array.isArray(value) || value.length < 1 || value.length > 2)
|
|
294
|
+
invalid("resetFences requires one or two players on a server conditional write.");
|
|
295
|
+
const seen = new Set();
|
|
296
|
+
return value.map((entry) => {
|
|
297
|
+
if (!entry || typeof entry !== "object" || Array.isArray(entry) ||
|
|
298
|
+
Reflect.ownKeys(entry).length !== 2 ||
|
|
299
|
+
!Object.hasOwn(entry, "playerId") || !Object.hasOwn(entry, "resetGeneration"))
|
|
300
|
+
invalid("Invalid reset fence.");
|
|
301
|
+
const fence = entry;
|
|
302
|
+
if (typeof fence.playerId !== "string" || !/^[1-9][0-9]{0,19}$/.test(fence.playerId) ||
|
|
303
|
+
seen.has(fence.playerId) || !Number.isInteger(fence.resetGeneration) ||
|
|
304
|
+
fence.resetGeneration < 0 || fence.resetGeneration > 2147483647)
|
|
305
|
+
invalid("Invalid reset fence player or generation.");
|
|
306
|
+
seen.add(fence.playerId);
|
|
307
|
+
return { playerId: fence.playerId, resetGeneration: fence.resetGeneration };
|
|
308
|
+
});
|
|
309
|
+
}
|
|
278
310
|
/** Validates and copies a request; the result is what goes on the wire. */
|
|
279
311
|
export function encodeSaveInput(verb, input, server = false) {
|
|
280
312
|
if (!input || typeof input !== "object" || Array.isArray(input)) {
|
|
@@ -282,12 +314,26 @@ export function encodeSaveInput(verb, input, server = false) {
|
|
|
282
314
|
}
|
|
283
315
|
if (verb === "snapshot")
|
|
284
316
|
return { targets: encodeReads(input.targets, server) };
|
|
317
|
+
if (verb === "recentOperations") {
|
|
318
|
+
const limit = input.limit ?? 16;
|
|
319
|
+
if (!Number.isInteger(limit) || limit < 1 || limit > 32)
|
|
320
|
+
invalid("Recovery limit must be 1 to 32.");
|
|
321
|
+
if (input.cursor !== undefined)
|
|
322
|
+
checkText(input.cursor, "recovery cursor", 2048);
|
|
323
|
+
return { limit, ...(input.cursor === undefined ? {} : { cursor: input.cursor }) };
|
|
324
|
+
}
|
|
285
325
|
checkText(input.operationId, "operation id", MAX_KEY_BYTES);
|
|
286
326
|
if (verb === "operation")
|
|
287
327
|
return { operationId: input.operationId };
|
|
288
|
-
if (verb === "transaction") {
|
|
328
|
+
if (verb === "transaction" || verb === "conditionalWrite") {
|
|
329
|
+
if (verb === "conditionalWrite") {
|
|
330
|
+
const changes = input.changes;
|
|
331
|
+
const checks = input.checks ?? [];
|
|
332
|
+
if (!Array.isArray(changes) || !changes.length || changes.length + checks.length > 8)
|
|
333
|
+
invalid("Conditional writes require 1 to 8 targets.");
|
|
334
|
+
}
|
|
289
335
|
return {
|
|
290
|
-
...encodeTransaction(input, server),
|
|
336
|
+
...encodeTransaction(input, server, verb === "conditionalWrite"),
|
|
291
337
|
};
|
|
292
338
|
}
|
|
293
339
|
if (input.expectedAccess !== undefined) {
|
|
@@ -422,6 +468,34 @@ export function createSaveApi(call, server = false) {
|
|
|
422
468
|
}
|
|
423
469
|
}
|
|
424
470
|
return {
|
|
471
|
+
async conditionalWrite(input) {
|
|
472
|
+
const result = await send("conditionalWrite", { ...input });
|
|
473
|
+
return decodeReceipt(result, input.operationId, input.changes.map((change) => change.target));
|
|
474
|
+
},
|
|
475
|
+
async recentOperations(input = {}) {
|
|
476
|
+
const page = (await send("recentOperations", {
|
|
477
|
+
...input,
|
|
478
|
+
}));
|
|
479
|
+
if (!page ||
|
|
480
|
+
!Array.isArray(page.operations) ||
|
|
481
|
+
page.operations.length > (input.limit ?? 16) ||
|
|
482
|
+
(page.cursor !== null && typeof page.cursor !== "string"))
|
|
483
|
+
invalidResponse();
|
|
484
|
+
return {
|
|
485
|
+
operations: page.operations.map((operation) => {
|
|
486
|
+
if (!operation ||
|
|
487
|
+
typeof operation.operationId !== "string" ||
|
|
488
|
+
typeof operation.committedAt !== "string")
|
|
489
|
+
invalidResponse();
|
|
490
|
+
return {
|
|
491
|
+
operationId: operation.operationId,
|
|
492
|
+
committedAt: operation.committedAt,
|
|
493
|
+
receipt: decodeReceipt(operation.receipt, operation.operationId, []),
|
|
494
|
+
};
|
|
495
|
+
}),
|
|
496
|
+
cursor: page.cursor,
|
|
497
|
+
};
|
|
498
|
+
},
|
|
425
499
|
async snapshot(input) {
|
|
426
500
|
return decodeSnapshot(await send("snapshot", { ...input }), input.targets);
|
|
427
501
|
},
|
|
@@ -64,6 +64,52 @@ export interface MultiplayerHubWearReceipt {
|
|
|
64
64
|
/** What the player now wears; null when cleared. */
|
|
65
65
|
wearable: MultiplayerHubWearable | null;
|
|
66
66
|
}
|
|
67
|
+
/** The classes of earned item a hub game may give (contract v1.53). */
|
|
68
|
+
export type MultiplayerHubEarnedClass = "badge" | "pin" | "belt" | "sash" | "held";
|
|
69
|
+
/** The home classes a hub game may give (contract v1.70/v1.73), never worn. */
|
|
70
|
+
export type MultiplayerHubHomeClass = "furniture" | "deed" | "pet";
|
|
71
|
+
/**
|
|
72
|
+
* An earned item: something a hub game gave a player for a stated deed, declared
|
|
73
|
+
* in that game's castle.json `hub.unlocks` and kept by Castle per account. It has
|
|
74
|
+
* no rarity. `deckId` is the game that declared it; `id` and `shape` match
|
|
75
|
+
* /^[a-z][a-z0-9-]{0,23}$/, `color` is '#rrggbb'.
|
|
76
|
+
*/
|
|
77
|
+
export interface MultiplayerHubEarnedItem {
|
|
78
|
+
deckId: string;
|
|
79
|
+
id: string;
|
|
80
|
+
class: MultiplayerHubEarnedClass;
|
|
81
|
+
shape: string;
|
|
82
|
+
name: string;
|
|
83
|
+
deed: string;
|
|
84
|
+
color: string;
|
|
85
|
+
}
|
|
86
|
+
/** A furniture piece, area deed or adopted pet owned for the house, never shown on an avatar. */
|
|
87
|
+
export interface MultiplayerHubHomeItem {
|
|
88
|
+
deckId: string;
|
|
89
|
+
id: string;
|
|
90
|
+
class: MultiplayerHubHomeClass;
|
|
91
|
+
piece: string;
|
|
92
|
+
name: string;
|
|
93
|
+
deed: string;
|
|
94
|
+
color: string;
|
|
95
|
+
}
|
|
96
|
+
export interface MultiplayerHubUnlockReceipt {
|
|
97
|
+
unlocked: true;
|
|
98
|
+
/** True when this call gave the player the item for the first time. */
|
|
99
|
+
isNew: boolean;
|
|
100
|
+
/** What the player now shows in the earned slot (never a home item); null when none. */
|
|
101
|
+
earned: MultiplayerHubEarnedItem | null;
|
|
102
|
+
}
|
|
103
|
+
export interface MultiplayerHubWearEarnedReceipt {
|
|
104
|
+
/** What the player now shows in the earned slot; null when cleared. */
|
|
105
|
+
earned: MultiplayerHubEarnedItem | null;
|
|
106
|
+
}
|
|
107
|
+
export interface MultiplayerHubUnlocksRead {
|
|
108
|
+
/** Each player's owned wearable and home items, by user id. */
|
|
109
|
+
players: Record<string, {
|
|
110
|
+
owned: (MultiplayerHubEarnedItem | MultiplayerHubHomeItem)[];
|
|
111
|
+
}>;
|
|
112
|
+
}
|
|
67
113
|
export interface MultiplayerHubPadUpdateInput {
|
|
68
114
|
/** A pad door of this place, from ghost's door table. */
|
|
69
115
|
doorId: string;
|
|
@@ -91,8 +137,12 @@ export interface MultiplayerHubPlayerResults {
|
|
|
91
137
|
records: MultiplayerHubRecord[];
|
|
92
138
|
/** The player's platform avatar, chosen or default; null when ghost has none to say. */
|
|
93
139
|
avatar: number | null;
|
|
140
|
+
/** Account-wide door hearts, oldest first; absent on older ghosts. */
|
|
141
|
+
hearts?: string[];
|
|
94
142
|
/** The player's wearable; null when none. Absent from a ghost older than wearables. */
|
|
95
143
|
wearable?: MultiplayerHubWearable | null;
|
|
144
|
+
/** The earned item the player shows (contract v1.53); absent when none. */
|
|
145
|
+
earned?: MultiplayerHubEarnedItem;
|
|
96
146
|
}
|
|
97
147
|
export interface MultiplayerHubBoard {
|
|
98
148
|
toDeckId: string;
|
|
@@ -134,6 +184,34 @@ export interface MultiplayerHubResultsRead {
|
|
|
134
184
|
* and for a deck that declares no hub block.
|
|
135
185
|
*/
|
|
136
186
|
export interface MultiplayerServerHub {
|
|
187
|
+
/** Present only for an enabled place on a capable runtime. Reports visits; Ghost owns comeback delivery. */
|
|
188
|
+
readonly push?: {
|
|
189
|
+
visit(playerId: string, visit: {
|
|
190
|
+
userId: string;
|
|
191
|
+
timezone: string;
|
|
192
|
+
}): Promise<boolean>;
|
|
193
|
+
};
|
|
194
|
+
/** Durably appends NPC words to a private platform archive. No read operation. */
|
|
195
|
+
archiveText(playerId: string, entry: {
|
|
196
|
+
npcId: string;
|
|
197
|
+
characterId?: string;
|
|
198
|
+
conversationId?: string;
|
|
199
|
+
operationId: string;
|
|
200
|
+
input?: string;
|
|
201
|
+
reply?: string;
|
|
202
|
+
}): Promise<void>;
|
|
203
|
+
/** Numeric hub telemetry; unavailable/refused delivery returns false, never blocks play. */
|
|
204
|
+
track(playerId: string, event: {
|
|
205
|
+
kind: number;
|
|
206
|
+
subject?: number;
|
|
207
|
+
value?: number;
|
|
208
|
+
result?: number;
|
|
209
|
+
flags?: number;
|
|
210
|
+
}): Promise<boolean>;
|
|
211
|
+
/** The owner user id, only in an owner door instance. */
|
|
212
|
+
readonly owner?: string;
|
|
213
|
+
/** Host-pinned inclusive reconnect grace for this hub place, in milliseconds. */
|
|
214
|
+
readonly reconnectWindowMs?: number;
|
|
137
215
|
readonly place: string | null;
|
|
138
216
|
readonly title: string | null;
|
|
139
217
|
readonly result: MultiplayerHubResultShape | null;
|
|
@@ -156,6 +234,45 @@ export interface MultiplayerServerHub {
|
|
|
156
234
|
* without it).
|
|
157
235
|
*/
|
|
158
236
|
wear(playerId: string, wearable: MultiplayerHubWearable | null): Promise<MultiplayerHubWearReceipt>;
|
|
237
|
+
/**
|
|
238
|
+
* Gives a signed-in player one of this deck's declared earned items (castle.json
|
|
239
|
+
* `hub.unlocks`), by its id. Castle takes it only from a curated hub place, for a
|
|
240
|
+
* declared id; a first wearable unlock is also shown. Home items are never worn.
|
|
241
|
+
* Rejects with a `CAULDRON_HUB_*` code
|
|
242
|
+
* (`CAULDRON_HUB_UNAVAILABLE` on a runtime without it).
|
|
243
|
+
*/
|
|
244
|
+
unlock(playerId: string, itemId: string): Promise<MultiplayerHubUnlockReceipt>;
|
|
245
|
+
/**
|
|
246
|
+
* Chooses which owned earned item a signed-in player shows, or none with null.
|
|
247
|
+
* Castle takes it only from the town; home items are refused.
|
|
248
|
+
* Rejects with a `CAULDRON_HUB_*` code
|
|
249
|
+
* (`CAULDRON_HUB_UNAVAILABLE` on a runtime without it).
|
|
250
|
+
*/
|
|
251
|
+
wearEarned(playerId: string, earned: {
|
|
252
|
+
deckId: string;
|
|
253
|
+
id: string;
|
|
254
|
+
} | null): Promise<MultiplayerHubWearEarnedReceipt>;
|
|
255
|
+
/**
|
|
256
|
+
* The earned items players here own, by user id. Rejects with a `CAULDRON_HUB_*`
|
|
257
|
+
* code (`CAULDRON_HUB_UNAVAILABLE` on a runtime without it).
|
|
258
|
+
*/
|
|
259
|
+
readUnlocks(userIds: readonly string[]): Promise<MultiplayerHubUnlocksRead>;
|
|
260
|
+
/** The connected player's friends among these candidates; platform refusals reject. */
|
|
261
|
+
friendsAmong(playerId: string, userIds: readonly string[]): Promise<string[]>;
|
|
262
|
+
/**
|
|
263
|
+
* The connected player's mutual friends and follows in either direction among
|
|
264
|
+
* these candidates, in one host read. Missing lists are empty; refusals reject.
|
|
265
|
+
* Optional strict mode rejects malformed raw lists and marks the result validated.
|
|
266
|
+
* These relations belong to this player only; never send them to another client.
|
|
267
|
+
*/
|
|
268
|
+
relationsAmong(playerId: string, userIds: readonly string[], options?: {
|
|
269
|
+
strict: true;
|
|
270
|
+
}): Promise<{
|
|
271
|
+
validated?: true;
|
|
272
|
+
friends: string[];
|
|
273
|
+
follows: string[];
|
|
274
|
+
followedBy: string[];
|
|
275
|
+
}>;
|
|
159
276
|
/**
|
|
160
277
|
* Whether a block hides these two players from each other: either one blocked
|
|
161
278
|
* the other, in either direction. Symmetric. The block lists themselves stay
|
|
@@ -39,6 +39,18 @@ function hubHiddenUserIds(raw) {
|
|
|
39
39
|
}
|
|
40
40
|
return ids.size > 0 ? ids : null;
|
|
41
41
|
}
|
|
42
|
+
function unavailable(op, what) {
|
|
43
|
+
return new CastleError({
|
|
44
|
+
code: "CAULDRON_HUB_UNAVAILABLE",
|
|
45
|
+
message: `This host's runtime cannot ${what}.`,
|
|
46
|
+
operation: `session.hub.${op}`,
|
|
47
|
+
});
|
|
48
|
+
}
|
|
49
|
+
function reconnectMetadata(pinned) {
|
|
50
|
+
const value = pinned.reconnectWindowMs;
|
|
51
|
+
return pinned.result === null && typeof value === "number" && Number.isInteger(value) && value > 0 && value <= 180_000
|
|
52
|
+
? { reconnectWindowMs: value } : {};
|
|
53
|
+
}
|
|
42
54
|
export function createServerHub(platformHandle, arrivals, hiddenPair = () => false) {
|
|
43
55
|
const pinned = platformHandle.hub;
|
|
44
56
|
if (!pinned ||
|
|
@@ -65,16 +77,67 @@ export function createServerHub(platformHandle, arrivals, hiddenPair = () => fal
|
|
|
65
77
|
}
|
|
66
78
|
return parsed;
|
|
67
79
|
};
|
|
68
|
-
|
|
80
|
+
const hub = {
|
|
81
|
+
...pushCapability(platformHandle),
|
|
82
|
+
async archiveText(playerId, entry) {
|
|
83
|
+
if (platformHandle.hubTextArchiveEnabled !== true || typeof platformHandle.storage !== "function")
|
|
84
|
+
throw unavailable("archiveText", "archive NPC transcripts");
|
|
85
|
+
if (JSON.parse(await platformHandle.storage("hubTextArchive", JSON.stringify({ ...entry, playerId })))?.recorded !== true)
|
|
86
|
+
throw unavailable("archiveText", "archive NPC transcripts");
|
|
87
|
+
},
|
|
69
88
|
place: typeof pinned.place === "string" ? pinned.place : null,
|
|
70
89
|
title: typeof pinned.title === "string" ? pinned.title : null,
|
|
71
90
|
result: pinned.result ?? null,
|
|
91
|
+
...(typeof pinned.owner === "string" && pinned.owner.length > 0 ? { owner: pinned.owner } : {}),
|
|
92
|
+
...reconnectMetadata(pinned),
|
|
72
93
|
arrival(playerId) {
|
|
73
94
|
return arrivals.get(playerId) ?? null;
|
|
74
95
|
},
|
|
75
96
|
hiddenPair(playerIdA, playerIdB) {
|
|
76
97
|
return hiddenPair(playerIdA, playerIdB);
|
|
77
98
|
},
|
|
99
|
+
async track(playerId, event) {
|
|
100
|
+
try {
|
|
101
|
+
const json = JSON.stringify({ ...event, playerId });
|
|
102
|
+
const raw = await platformHandle.storage?.("hubTrack", json);
|
|
103
|
+
return JSON.parse(raw ?? "null")?.recorded === true;
|
|
104
|
+
}
|
|
105
|
+
catch {
|
|
106
|
+
return false;
|
|
107
|
+
}
|
|
108
|
+
},
|
|
109
|
+
async friendsAmong(playerId, userIds) {
|
|
110
|
+
const json = JSON.stringify({ playerId, userIds: [...userIds] });
|
|
111
|
+
const raw = typeof platformHandle.hubFriendsAmong === "function"
|
|
112
|
+
? await platformHandle.hubFriendsAmong(json)
|
|
113
|
+
: await platformHandle.storage?.("hubFriendsAmong", json);
|
|
114
|
+
const answer = JSON.parse(raw ?? "null");
|
|
115
|
+
return Array.isArray(answer?.userIds) ? answer.userIds : [];
|
|
116
|
+
},
|
|
117
|
+
async relationsAmong(playerId, userIds, options = undefined) {
|
|
118
|
+
const asked = new Set(userIds);
|
|
119
|
+
const json = JSON.stringify({ playerId, userIds: [...userIds] });
|
|
120
|
+
let raw;
|
|
121
|
+
if (typeof platformHandle.hubFriendsAmong === "function") {
|
|
122
|
+
raw = await platformHandle.hubFriendsAmong(json);
|
|
123
|
+
}
|
|
124
|
+
else {
|
|
125
|
+
raw = await platformHandle.storage?.("hubFriendsAmong", json);
|
|
126
|
+
}
|
|
127
|
+
const answer = JSON.parse(raw ?? "null");
|
|
128
|
+
if (options?.strict === true && (!answer || ["userIds", "follows", "followedBy"].some((key) => !Array.isArray(answer[key]) || answer[key].length > 100 || answer[key].some((id) => typeof id !== "string" || !/^\d{1,20}$/.test(id) || !asked.has(id))))) {
|
|
129
|
+
throw new CastleError({ code: "CAULDRON_HUB_INVALID_RESPONSE", message: "The platform returned an invalid friends response.", operation: "session.hub.relationsAmong" });
|
|
130
|
+
}
|
|
131
|
+
const list = (value) => Array.isArray(value)
|
|
132
|
+
? value.filter((id) => typeof id === "string" && asked.has(id))
|
|
133
|
+
: [];
|
|
134
|
+
return {
|
|
135
|
+
...(options?.strict === true ? { validated: true } : {}),
|
|
136
|
+
friends: list(answer?.userIds),
|
|
137
|
+
follows: list(answer?.follows),
|
|
138
|
+
followedBy: list(answer?.followedBy),
|
|
139
|
+
};
|
|
140
|
+
},
|
|
78
141
|
async reportResult(playerId, result) {
|
|
79
142
|
const { place, outcome, score, stats } = result ?? {};
|
|
80
143
|
return (await call("hubResult", {
|
|
@@ -121,5 +184,59 @@ export function createServerHub(platformHandle, arrivals, hiddenPair = () => fal
|
|
|
121
184
|
wearable: (receipt.wearable ?? null),
|
|
122
185
|
};
|
|
123
186
|
},
|
|
124
|
-
|
|
187
|
+
async unlock(playerId, itemId) {
|
|
188
|
+
if (typeof platformHandle.hubUnlock !== "function") {
|
|
189
|
+
throw unavailable("hubUnlock", "give earned items");
|
|
190
|
+
}
|
|
191
|
+
const receipt = await call("hubUnlock", { playerId, itemId });
|
|
192
|
+
return {
|
|
193
|
+
unlocked: true,
|
|
194
|
+
isNew: receipt.isNew === true,
|
|
195
|
+
earned: (receipt.earned ?? null),
|
|
196
|
+
};
|
|
197
|
+
},
|
|
198
|
+
async wearEarned(playerId, earned) {
|
|
199
|
+
if (typeof platformHandle.hubWearEarned !== "function") {
|
|
200
|
+
throw unavailable("hubWearEarned", "choose earned items");
|
|
201
|
+
}
|
|
202
|
+
const receipt = await call("hubWearEarned", {
|
|
203
|
+
playerId,
|
|
204
|
+
earned: earned === null || earned === undefined
|
|
205
|
+
? null
|
|
206
|
+
: { deckId: earned.deckId, id: earned.id },
|
|
207
|
+
});
|
|
208
|
+
return {
|
|
209
|
+
earned: (receipt.earned ?? null),
|
|
210
|
+
};
|
|
211
|
+
},
|
|
212
|
+
async readUnlocks(userIds) {
|
|
213
|
+
if (typeof platformHandle.hubUnlocksRead !== "function") {
|
|
214
|
+
throw unavailable("hubUnlocksRead", "read earned items");
|
|
215
|
+
}
|
|
216
|
+
const read = await call("hubUnlocksRead", { userIds: [...(userIds ?? [])] });
|
|
217
|
+
return {
|
|
218
|
+
players: (read.players ?? {}),
|
|
219
|
+
};
|
|
220
|
+
},
|
|
221
|
+
};
|
|
222
|
+
// Preserve the enumerable API shape and diagnostic serialization of existing
|
|
223
|
+
// places. Opted-in kits call this method explicitly; it adds no wire field.
|
|
224
|
+
Object.defineProperty(hub, "track", { enumerable: false });
|
|
225
|
+
Object.defineProperty(hub, "archiveText", { enumerable: false });
|
|
226
|
+
return Object.freeze(hub);
|
|
227
|
+
}
|
|
228
|
+
async function pushVisitCall(call, playerId, args) {
|
|
229
|
+
try {
|
|
230
|
+
return JSON.parse(await call(JSON.stringify({ ...args, playerId })))?.accepted === true;
|
|
231
|
+
}
|
|
232
|
+
catch {
|
|
233
|
+
return false;
|
|
234
|
+
}
|
|
235
|
+
}
|
|
236
|
+
function pushCapability(handle) {
|
|
237
|
+
if (handle.hub?.push?.version !== 1 || typeof handle.hubPushVisit !== "function")
|
|
238
|
+
return {};
|
|
239
|
+
return { push: {
|
|
240
|
+
visit: (playerId, visit) => pushVisitCall((raw) => handle.hubPushVisit(raw), playerId, visit),
|
|
241
|
+
} };
|
|
125
242
|
}
|
|
@@ -6,6 +6,8 @@ export interface PlayerIdentity {
|
|
|
6
6
|
username: string;
|
|
7
7
|
isAnonymous: boolean;
|
|
8
8
|
scopedUserId?: string;
|
|
9
|
+
/** Trusted hub age boundary; omitted by older hosts. Never client supplied. */
|
|
10
|
+
under13?: boolean;
|
|
9
11
|
}
|
|
10
12
|
export interface PlatformSessionConfig {
|
|
11
13
|
readonly sessionId: string;
|
|
@@ -53,6 +55,7 @@ export interface PlatformHandle {
|
|
|
53
55
|
on(event: "worldCharacterTurn", callback: (request: PlatformWorldCharacterTurn) => unknown): void;
|
|
54
56
|
on(event: "worldCharacterCommand", callback: (request: PlatformWorldCharacterCommand) => unknown): void;
|
|
55
57
|
on(event: "worldCharacterRead", callback: (request: PlatformWorldCharacterRead) => unknown): void;
|
|
58
|
+
on(event: "worldCharacterTool", callback: (request: PlatformWorldCharacterTool) => unknown): void;
|
|
56
59
|
/**
|
|
57
60
|
* Deck storage. Strings in and strings out, like the rest of this handle, so a
|
|
58
61
|
* runtime other than the Node shim can implement it without knowing what storage is.
|
|
@@ -65,15 +68,26 @@ export interface PlatformHandle {
|
|
|
65
68
|
storage?(op: string, argsJson: string): Promise<string>;
|
|
66
69
|
/** False when the host cannot broker storage, so a call can fail at once. */
|
|
67
70
|
readonly storageEnabled?: boolean;
|
|
71
|
+
readonly hubTextArchiveEnabled?: boolean;
|
|
68
72
|
/** Persistent-world checkpoint broker. The host stamps the hidden world binding. */
|
|
69
73
|
worldCheckpointRead?(): Promise<string>;
|
|
70
74
|
worldCheckpointCommit?(argsJson: string): Promise<string>;
|
|
71
|
-
|
|
75
|
+
/** `tools` is the turn's place tools, passed only when non-empty. */
|
|
76
|
+
worldCharacterSend?(grantId: string, tools?: readonly PlatformPlaceTool[], hubTextArchive?: {
|
|
77
|
+
npcId: string;
|
|
78
|
+
conversationId?: string;
|
|
79
|
+
input: string;
|
|
80
|
+
}): Promise<string>;
|
|
72
81
|
worldCharacterCommand?(grantId: string): Promise<string>;
|
|
73
82
|
worldCharacterRead?(grantId: string): Promise<string>;
|
|
74
83
|
worldCharacterRuntimeCreate?(argsJson: string): Promise<string>;
|
|
75
84
|
worldCharacterRuntimeList?(): Promise<string>;
|
|
76
85
|
worldCharacterReject?(grantId: string, code?: string): void;
|
|
86
|
+
/**
|
|
87
|
+
* Answers a `worldCharacterTool` event with at most 1 KiB of UTF-8. Present only
|
|
88
|
+
* when the host serves place tools, which is also what lets a send declare them.
|
|
89
|
+
*/
|
|
90
|
+
worldCharacterToolResult?(requestId: string, result: string): Promise<string>;
|
|
77
91
|
/**
|
|
78
92
|
* The hub place this session runs, as ghost pinned it from the published
|
|
79
93
|
* castle.json `hub` block. Present only when the host services the hub ops
|
|
@@ -83,8 +97,17 @@ export interface PlatformHandle {
|
|
|
83
97
|
hubResult?(argsJson: string): Promise<string>;
|
|
84
98
|
hubPadUpdate?(argsJson: string): Promise<string>;
|
|
85
99
|
hubResultsRead?(argsJson: string): Promise<string>;
|
|
100
|
+
/** Friends among candidates (hub contract v1.36); older images use storage. */
|
|
101
|
+
hubFriendsAmong?(argsJson: string): Promise<string>;
|
|
102
|
+
hubPushVisit?(argsJson: string): Promise<string>;
|
|
86
103
|
/** Absent on a runtime older than wearables (contract v1.4). */
|
|
87
104
|
hubWear?(argsJson: string): Promise<string>;
|
|
105
|
+
/** Absent on a runtime older than earned items (contract v1.53). */
|
|
106
|
+
hubUnlock?(argsJson: string): Promise<string>;
|
|
107
|
+
/** Absent on a runtime older than earned items (contract v1.53). */
|
|
108
|
+
hubWearEarned?(argsJson: string): Promise<string>;
|
|
109
|
+
/** Absent on a runtime older than earned items (contract v1.53). */
|
|
110
|
+
hubUnlocksRead?(argsJson: string): Promise<string>;
|
|
88
111
|
readonly config: PlatformSessionConfig;
|
|
89
112
|
}
|
|
90
113
|
export interface PlatformHubResultShape {
|
|
@@ -98,6 +121,11 @@ export interface PlatformHubResultShape {
|
|
|
98
121
|
stats: Record<string, "number" | "string">;
|
|
99
122
|
}
|
|
100
123
|
export interface PlatformHubPlace {
|
|
124
|
+
push?: {
|
|
125
|
+
version: 1;
|
|
126
|
+
};
|
|
127
|
+
owner?: string;
|
|
128
|
+
reconnectWindowMs?: number;
|
|
101
129
|
place?: string;
|
|
102
130
|
title?: string | null;
|
|
103
131
|
result?: PlatformHubResultShape | null;
|
|
@@ -124,6 +152,20 @@ export interface PlatformWorldCharacterRead {
|
|
|
124
152
|
};
|
|
125
153
|
query: unknown;
|
|
126
154
|
}
|
|
155
|
+
/** A lookup a place declares for one character turn. */
|
|
156
|
+
export interface PlatformPlaceTool {
|
|
157
|
+
name: string;
|
|
158
|
+
description: string;
|
|
159
|
+
input_schema: Record<string, unknown>;
|
|
160
|
+
}
|
|
161
|
+
export interface PlatformWorldCharacterTool {
|
|
162
|
+
requestId: string;
|
|
163
|
+
operationId: string;
|
|
164
|
+
characterId: string;
|
|
165
|
+
playerId: string;
|
|
166
|
+
name: string;
|
|
167
|
+
input: Record<string, unknown>;
|
|
168
|
+
}
|
|
127
169
|
export interface PlatformWorldCharacterTurn {
|
|
128
170
|
grantId: string;
|
|
129
171
|
requestId: string;
|
|
@@ -23,6 +23,12 @@ export interface ServerStorageScope extends SaveBucketApi {
|
|
|
23
23
|
increment(key: string, delta?: number): Promise<number>;
|
|
24
24
|
list<T extends Json = Json>(options?: ServerStorageListOptions): Promise<ServerStorageListPage<T>>;
|
|
25
25
|
}
|
|
26
|
+
export interface ServerTownStorage {
|
|
27
|
+
get<T extends Json = Json>(keys: string[]): Promise<Record<string, T>>;
|
|
28
|
+
set(values: Record<string, Json>): Promise<void>;
|
|
29
|
+
remove(keys: string[]): Promise<void>;
|
|
30
|
+
increment(key: string, delta?: number): Promise<number>;
|
|
31
|
+
}
|
|
26
32
|
export interface ServerStorageBoardScore {
|
|
27
33
|
subject: string;
|
|
28
34
|
score: number;
|
|
@@ -45,6 +51,8 @@ export interface ServerStorageBoard {
|
|
|
45
51
|
*/
|
|
46
52
|
export interface ServerPlaythrough {
|
|
47
53
|
readonly generation: number;
|
|
54
|
+
/** Present only after an administrator reset this player's deck progress. */
|
|
55
|
+
readonly resetGeneration?: number;
|
|
48
56
|
/** Explicit narrative changes for this same player and generation. */
|
|
49
57
|
readonly characters: ServerPlaythroughCharacters;
|
|
50
58
|
get<T extends Json = Json>(keys: string[]): Promise<Record<string, T>>;
|
|
@@ -259,10 +267,19 @@ export interface ServerCharacterHistoryOptions {
|
|
|
259
267
|
cursor?: string | null;
|
|
260
268
|
}
|
|
261
269
|
export interface ServerStorage extends SaveApi {
|
|
270
|
+
/** Reads the authoritative progress-reset generation, including never-reset zero. */
|
|
271
|
+
resetGeneration(userId: string): Promise<number>;
|
|
262
272
|
/** Shared by everyone playing the deck, and owned by this server. */
|
|
263
273
|
readonly deck: ServerStorageScope;
|
|
264
274
|
/** One player's public data. Readable by anyone; writable by them or by this server. */
|
|
265
275
|
user(userId: string): ServerStorageScope;
|
|
276
|
+
/**
|
|
277
|
+
* The door deck's source town's deck-scope rows, for one player in this session.
|
|
278
|
+
* Only a door deck's server may call it; a town gets CAULDRON_HUB_NO_TOWN.
|
|
279
|
+
* In an owner house, only the owner's rows are accessible. Quota counts against
|
|
280
|
+
* the town. Each key must be tokens|spent|own|hat|chirp, then userId, as its first two segments.
|
|
281
|
+
*/
|
|
282
|
+
town(userId: string): ServerTownStorage;
|
|
266
283
|
board(name: string): ServerStorageBoard;
|
|
267
284
|
/** Opens one player's experimental, generation-bound game namespace. */
|
|
268
285
|
playthrough(userId: string): Promise<ServerPlaythrough>;
|