castle-web-cli 0.4.256 → 0.4.257
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 +1 -0
- package/dist/agent-failures.js +9 -0
- package/dist/agent.d.ts +3 -0
- package/dist/agent.js +43 -10
- package/dist/devSessionChild.js +8 -1
- package/dist/devSessionServer.d.ts +7 -0
- package/dist/devSessionServer.js +12 -5
- package/dist/hostFeatureCheck.d.ts +23 -0
- package/dist/hostFeatureCheck.js +70 -0
- package/dist/init.js +1 -1
- package/dist/platformDoc.d.ts +1 -0
- package/dist/platformDoc.js +19 -3
- package/dist/retryNotice.d.ts +3 -0
- package/dist/retryNotice.js +39 -0
- package/dist/save-deck.js +2 -0
- package/dist/shell/assets/index-CO225dl5.js +454 -0
- package/dist/shell/assets/{index-MVLfNYd9.css → index-D_8-R2mm.css} +1 -1
- package/dist/shell/index.html +2 -2
- package/kits/base/castle.json +1 -1
- package/kits/base/sdk/README.md +14 -0
- package/kits/base/sdk/server/platformHandle.d.ts +2 -0
- package/kits/base/sdk/server/wrapper.d.ts +4 -0
- package/kits/base/sdk/server/wrapper.js +29 -1
- package/kits/turn-based/castle.json +1 -1
- package/package.json +2 -2
- package/dist/shell/assets/index-Bec6LpAv.js +0 -454
package/kits/base/castle.json
CHANGED
package/kits/base/sdk/README.md
CHANGED
|
@@ -155,6 +155,20 @@ is. `session.place` is the hub place the host started the session for (see
|
|
|
155
155
|
[`session.hub`](#sessionhub)), and `null` otherwise. It is never taken from a
|
|
156
156
|
client.
|
|
157
157
|
|
|
158
|
+
### `session.sessionSecret` and `session.assets.read`
|
|
159
|
+
|
|
160
|
+
Both are available in `onStart`. `session.sessionSecret` is the host-provided
|
|
161
|
+
signing key for this session, or `undefined` when the host supplies no key.
|
|
162
|
+
The key is read-only and omitted from object inspection, spread, and default JSON
|
|
163
|
+
serialization. Code that names the property, by reading it or by passing it in a
|
|
164
|
+
`JSON.stringify` property list, gets the key. Read it directly through `session.sessionSecret`.
|
|
165
|
+
Keep the key server-side and out of messages, logs, and storage.
|
|
166
|
+
|
|
167
|
+
`await session.assets.read(name)` returns the exact bytes of a mounted session
|
|
168
|
+
asset as a `Uint8Array`, or `null` if the name is absent. On older runtimes
|
|
169
|
+
without session asset support, the promise rejects with an unavailable error.
|
|
170
|
+
`session.assets` is omitted from object keys, spread, and JSON serialization.
|
|
171
|
+
|
|
158
172
|
### `session.storage`
|
|
159
173
|
|
|
160
174
|
A session ends when its last player leaves, and its memory goes with it.
|
|
@@ -41,6 +41,8 @@ export interface PlatformWorldTimeConfig {
|
|
|
41
41
|
advance: "wallClock";
|
|
42
42
|
}
|
|
43
43
|
export interface PlatformHandle {
|
|
44
|
+
readonly sessionSecret?: string;
|
|
45
|
+
readAsset?(name: string): Promise<Uint8Array | null>;
|
|
44
46
|
send(connId: string, text: string): void;
|
|
45
47
|
broadcast(text: string): void;
|
|
46
48
|
sendBinary?(connId: string, bytes: Uint8Array | ArrayBuffer): void;
|
|
@@ -22,6 +22,10 @@ export interface MultiplayerServerSession {
|
|
|
22
22
|
readonly sessionId: string;
|
|
23
23
|
readonly deckId: string;
|
|
24
24
|
readonly mode: MultiplayerSessionMode;
|
|
25
|
+
readonly sessionSecret?: string;
|
|
26
|
+
readonly assets: {
|
|
27
|
+
read(name: string): Promise<Uint8Array | null>;
|
|
28
|
+
};
|
|
25
29
|
/**
|
|
26
30
|
* The place the host started this session for (a hub door's destination, or
|
|
27
31
|
* the hub place ghost pinned the session to), or null when the host stamped
|
|
@@ -247,7 +247,7 @@ function createAuthorSession(platformHandle, players, arrivals, hidden, variants
|
|
|
247
247
|
return Boolean(hidden.get(a)?.has(userB) || hidden.get(b)?.has(userA));
|
|
248
248
|
});
|
|
249
249
|
const world = createServerWorld(platformHandle);
|
|
250
|
-
|
|
250
|
+
const session = {
|
|
251
251
|
get players() {
|
|
252
252
|
return Array.from(players.values());
|
|
253
253
|
},
|
|
@@ -257,6 +257,14 @@ function createAuthorSession(platformHandle, players, arrivals, hidden, variants
|
|
|
257
257
|
place: typeof platformHandle.config.place === "string"
|
|
258
258
|
? platformHandle.config.place
|
|
259
259
|
: hub?.place ?? null,
|
|
260
|
+
assets: {
|
|
261
|
+
async read(name) {
|
|
262
|
+
if (typeof platformHandle.readAsset !== "function") {
|
|
263
|
+
throw new TypeError("This Castle runtime does not support session assets yet.");
|
|
264
|
+
}
|
|
265
|
+
return platformHandle.readAsset(name);
|
|
266
|
+
},
|
|
267
|
+
},
|
|
260
268
|
storage: createServerStorage(platformHandle),
|
|
261
269
|
world,
|
|
262
270
|
characters: world?.characters ?? createPlaceCharacters(platformHandle),
|
|
@@ -308,6 +316,26 @@ function createAuthorSession(platformHandle, players, arrivals, hidden, variants
|
|
|
308
316
|
platformHandle.disconnect(playerId, reason ?? 1000);
|
|
309
317
|
},
|
|
310
318
|
};
|
|
319
|
+
Object.defineProperty(session, "assets", { enumerable: false });
|
|
320
|
+
// Inspectors can invoke getters. Keep the key in a closure off the inspected target.
|
|
321
|
+
const sessionSecret = platformHandle.sessionSecret;
|
|
322
|
+
return new Proxy(session, {
|
|
323
|
+
get(target, property, receiver) {
|
|
324
|
+
if (property === "sessionSecret")
|
|
325
|
+
return sessionSecret;
|
|
326
|
+
return Reflect.get(target, property, receiver);
|
|
327
|
+
},
|
|
328
|
+
set(target, property, value, receiver) {
|
|
329
|
+
if (property === "sessionSecret")
|
|
330
|
+
return false;
|
|
331
|
+
return Reflect.set(target, property, value, receiver);
|
|
332
|
+
},
|
|
333
|
+
defineProperty(target, property, descriptor) {
|
|
334
|
+
if (property === "sessionSecret")
|
|
335
|
+
return false;
|
|
336
|
+
return Reflect.defineProperty(target, property, descriptor);
|
|
337
|
+
},
|
|
338
|
+
});
|
|
311
339
|
}
|
|
312
340
|
const WORLD_OPERATION_ID_MAX_BYTES = 128;
|
|
313
341
|
const WORLD_OPERATION_ID_MAX_CHARACTERS = 120;
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
"autoUpdateWhenImported": true,
|
|
19
19
|
"deckId": "K6-Xs7dCoMVi",
|
|
20
20
|
"cardId": "Kh_08IYATpC3",
|
|
21
|
-
"publishedVersion": "2026-
|
|
21
|
+
"publishedVersion": "2026-11-20T01:08:45.103Z",
|
|
22
22
|
"server": {
|
|
23
23
|
"main": "code/server/index.js",
|
|
24
24
|
"maxPlayers": 8,
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "castle-web-cli",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.257",
|
|
4
4
|
"repository": {
|
|
5
5
|
"type": "git",
|
|
6
6
|
"url": "git+https://github.com/castle-xyz/castle-experimental-web.git"
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
"scripts": {
|
|
13
13
|
"build": "rm -rf dist && tsc && chmod +x dist/index.js && vite build && vite build -c vite.cover-bridge.config.ts && cp -R src/castle-host dist/castle-host && chmod -R u+w kits 2>/dev/null; rm -rf kits && cp -R ../kits kits && chmod -R u+w kits && rm -rf kits/*/imports && node ../scripts/vendor-three.mjs",
|
|
14
14
|
"dev": "tsc --watch",
|
|
15
|
-
"check": "node ../scripts/sync-shared.mjs --check && node ../scripts/tests/icon-registry.mjs && node ../scripts/tests/sandbox-graphql-fields.mjs && node ../scripts/tests/kit-package-json.mjs && node ../scripts/tests/kit-catalog.mjs && node ../scripts/tests/import-order.mjs && node ../scripts/tests/import-deck-ref.mjs && node ../scripts/tests/restore-pinned-import.mjs && node ../scripts/tests/hub-server-config.mjs && node ../scripts/tests/server-invites-config.mjs && node ../scripts/tests/save-failure-reason.mjs && node ../scripts/tests/save-drop-guard.mjs && node ../scripts/tests/flow-draft-status.mjs && node ../scripts/tests/router-fences.mjs && node ../scripts/tests/held-tasks.mjs && node ../scripts/tests/task-archive.mjs && node ../scripts/tests/held-task-prompts.mjs && node ../scripts/tests/router-stops.mjs && node ../scripts/tests/task-steer.mjs && node ../scripts/tests/task-steer-store.mjs && node ../scripts/tests/task-steer-line.mjs && node ../scripts/tests/router-task-endings.mjs && node ../scripts/tests/router-task-report.mjs && node ../scripts/tests/task-resume.mjs && node ../scripts/tests/task-model-request.mjs && node ../scripts/tests/plan-answered-questions.mjs && node ../scripts/tests/plan-no-standing-nudge.mjs && node ../scripts/tests/sdk-readme-limits.mjs && node ../scripts/tests/task-account.mjs && node ../scripts/tests/effort-support.mjs && node ../scripts/tests/cli-login-pkce.mjs && node ../scripts/tests/publish-timeout.mjs && node ../scripts/tests/bundle-latin1.mjs && eslint . && jscpd && tsc --noEmit && tsc --noEmit -p src/shell/tsconfig.json"
|
|
15
|
+
"check": "node ../scripts/sync-shared.mjs --check && node ../scripts/tests/icon-registry.mjs && node ../scripts/tests/sandbox-graphql-fields.mjs && node ../scripts/tests/kit-package-json.mjs && node ../scripts/tests/kit-catalog.mjs && node ../scripts/tests/import-order.mjs && node ../scripts/tests/import-deck-ref.mjs && node ../scripts/tests/restore-pinned-import.mjs && node ../scripts/tests/hub-server-config.mjs && node ../scripts/tests/server-invites-config.mjs && node ../scripts/tests/save-failure-reason.mjs && node ../scripts/tests/save-drop-guard.mjs && node ../scripts/tests/flow-draft-status.mjs && node ../scripts/tests/router-fences.mjs && node ../scripts/tests/held-tasks.mjs && node ../scripts/tests/task-archive.mjs && node ../scripts/tests/held-task-prompts.mjs && node ../scripts/tests/router-stops.mjs && node ../scripts/tests/task-steer.mjs && node ../scripts/tests/agent-retry-activity.mjs && node ../scripts/tests/task-steer-store.mjs && node ../scripts/tests/task-steer-line.mjs && node ../scripts/tests/router-task-endings.mjs && node ../scripts/tests/router-task-report.mjs && node ../scripts/tests/task-resume.mjs && node ../scripts/tests/task-model-request.mjs && node ../scripts/tests/plan-answered-questions.mjs && node ../scripts/tests/plan-no-standing-nudge.mjs && node ../scripts/tests/sdk-readme-limits.mjs && node ../scripts/tests/task-account.mjs && node ../scripts/tests/effort-support.mjs && node ../scripts/tests/cli-login-pkce.mjs && node ../scripts/tests/publish-timeout.mjs && node ../scripts/tests/release-plan.mjs && node ../scripts/tests/bundle-latin1.mjs && eslint . && jscpd && tsc --noEmit && tsc --noEmit -p src/shell/tsconfig.json"
|
|
16
16
|
},
|
|
17
17
|
"jscpd": {
|
|
18
18
|
"path": [
|