crowdypy 0.11.0.dev1__tar.gz → 0.12.0.dev1__tar.gz

{crowdypy-0.11.0.dev1 → crowdypy-0.12.0.dev1}/AGENTS.md

@@ -85,7 +85,11 @@ release re-reads the published wheel.
 
 ## Gates
 
-CI (`.github/workflows/ci.yml`) runs all of these; run them before pushing:
+CI (`.github/workflows/ci.yml`) runs all of these; run them before pushing. CI's `mypy` runs
+without the project installed (`uv sync --group dev --no-install-project`), so it follows
+imports into the generated `_sync/` and checks it too; an editable install hides that, so
+reproduce CI's run in a venv of its own (`UV_PROJECT_ENVIRONMENT=/tmp/lint uv sync --frozen
+--group dev --no-install-project`, then `uv run --no-sync mypy` with the same variable).
 
 ```bash
 ruff check . && ruff format --check . && mypy
@@ -134,6 +138,22 @@ re-run takes the next N (`scripts/ci/resolve_pypi_version.py` reads what PyPI al
 Merging a PR from the command line: `gh pr merge` fails its preflight on this org, so use
 `gh api -X PUT repos/CrowdedKingdoms/CrowdyPy/pulls/<n>/merge -f merge_method=merge`.
 
+## The Game Kit
+
+`src/crowdypy/kit/` is the client half of `ckx_sdk::kit`, ported from CrowdyJS `src/kit/` (the
+parity gate reads `src/kit/modules/` too since 0.12.0): one `KitRuntime` per kit, mirrors
+(`mirror.py`), the typed modules (`modules/`), `topology.py` and `realtime.py`. It is async source
+like the rest of the client, so `scripts/unasync.py` generates the blocking kit, and it may use no
+asyncio beyond `asyncio.sleep`. **A push or reconnect handler never waits on a call.** The
+blocking `ExecConnection` runs them on its reader thread, so a call made there would wait on a
+reply only that thread can read: a mirror starts its resync with `run_detached`, which unasync
+maps to `run_in_thread` (`run_soon` would become `run_now`, inline). Periodic work (a queue's
+`watch`, a spectator's `run`) is a loop the game starts beside itself. The protocol is held to
+ck-exec's golden record, `tests/fixtures/kit-protocol.json`, copied from CrowdyJS at the pin
+(`test_fixture_provenance.py` and the vendored CrowdyCPP copy hold it):
+`tests/unit/test_kit_protocol.py` replays each starter's script through a gateway that answers
+only the next recorded step, with both clients.
+
 ## Performance rules for the native binding
 
 The replication system saturates the local network stack, so the binding

{crowdypy-0.11.0.dev1 → crowdypy-0.12.0.dev1}/MIGRATION.md

@@ -3,6 +3,48 @@
 CrowdyPy is pre-1.0. Within a minor line, patch releases keep source compatibility; each
 new minor may change the API. Read the section for every minor you skip.
 
+## 0.12.0
+
+CrowdyJS 18.11.0 and CrowdyCPP 0.64.0. Additive. The kit's typed clients drive the ck-exec
+starter hubs, whose server half is `ckx_sdk::kit` (ckx-sdk 0.10.0): the tier's compute toolchain
+must carry it (dev's v1.12.0 does) and the app must run the starters (`kit.topology.deploy`).
+
+- **The modules.** `kit.world` (`conditions` and `nodes` mirrored; `state`, `harvest`, and
+  `schedule` / `cancel` for developers), `kit.matchmaking.queue(name)` (`join(rating, party=...,
+  leader=...)`, `leave`, `accept`, `decline`, `status`, `configure`, `place`, `watch` / `unwatch`,
+  `on_matched`), `kit.sessions.open(key)` (`watch`, `join`, `ready`, `start_game`, `act`,
+  `configure`, `current_turn`, `is_my_turn`, `state` mirrored), `kit.npcs.area(key)` /
+  `area_at(x, z)` (`mobs`, `npcs`, `pets`, `attack`, `talk`, `adopt`, `rename`, `summon`,
+  `dismiss`, `release`, `my_pets`), `kit.topology` (`pack`, `types`, `plan(select,
+  overrides=...)`, `deploy`; `kit_manifest_problems`), `kit.spectate.observe(uuid, chunk)` (a
+  heartbeat to `run()` beside the game), `kit.emotes` (`send`, `parse`: client event 101 with
+  `{"emote", "targetUuid"}`) and `kit.shards`. Replies are the hub's msgpack as Python values:
+  snake_case keys as the hub sends them, and a hub's integer-keyed maps (a session's `scores`) keep
+  integer keys.
+- **Refusals.** A hub's `kit:<code>:` refusal raises `KitError` (a `CrowdyExecError` with status
+  `AppError`): branch on `code`, show `text`. `KitError.from_error` and `kit_error_code` read one
+  out of any exec error.
+- **The runtime.** `kit.runtime` (`KitRuntime`) is one exec connection for every module, opened
+  on first use: as the player with an app token, or as a developer with `developer=True`. It paces
+  what it sends to `call_budget` (100) a `budget_window_ms` (10 s), holds as long as a `Busy` "rate
+  limited" refusal says, sends a call again when it did not run (`Busy`, `RateLimited`) or when it
+  carries an action id and its outcome is unknown (`DeadlineExceeded`, `Unavailable`, `Moved`), at
+  most `retries` (2) times, and refuses a 257th subscription with code `limit`. `call(...,
+  action=True)` sends a fresh `action_id` the hub answers once.
+- **Mirrors.** `HubState`, `CollectionMirror` (`list`, `member`), `PrivateState` (read with a
+  caller-scoped call, again on a `changed` that names the player) and `WritableKitStore`. A mirror
+  takes a new snapshot on another epoch, a gap in a collection's `seq`, and a reconnect. In the
+  blocking client the resync a push or a reconnect starts runs on a thread of its own
+  (`run_detached`), because those handlers run on the connection's reader thread.
+- **Realtime.** `decode_kit_actor_state` and `kit_actor_lanes` for the actors hubs show,
+  `KIT_EVENT_TYPES`, `parse_kit_server_event`; `crowdypy.kit.wire` adds events 99 (encounter), 100
+  (possession) and 101 (emote) with their parsers and `EVENT_APP_FIRST` (1000).
+- **Exec reconnects** wait half their backoff plus up to as much again at random, in both
+  connections, so the players of a host that went away do not all dial at once.
+- `tests/fixtures/kit-protocol.json` is ck-exec's golden record of the starters (by way of
+  CrowdyJS); `tests/unit/test_kit_protocol.py` replays it through a gateway that answers only the
+  next recorded step, with both clients. The parity gate reads CrowdyJS `src/kit/modules/` too.
+
 ## 0.11.0
 
 CrowdyJS 18.10.0 and CrowdyCPP 0.63.0. Additive.

{crowdypy-0.11.0.dev1 → crowdypy-0.12.0.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crowdypy
-Version: 0.11.0.dev1
+Version: 0.12.0.dev1
 Summary: Official Python SDK for Crowded Kingdoms: typed GraphQL clients and a native UDP replication core
 Keywords: crowded-kingdoms,multiplayer,replication,graphql,sdk,udp
 Author: Crowded Kingdoms
@@ -51,6 +51,17 @@ CrowdyPy follows the [CrowdyJS](https://github.com/CrowdedKingdoms/CrowdyJS) API
 client, bound with [nanobind](https://github.com/wjakob/nanobind) and shipped inside the
 wheel. Python never touches a datagram.
 
+**v0.12.0: the Game Kit on ck-exec (CrowdyJS 18.11.0, CrowdyCPP 0.64.0).** `client.kit(app_id)`
+gains typed clients for the ck-exec starter hubs, the client half of the game kit whose server
+half is `ckx_sdk::kit`: `kit.world` (conditions and resource nodes mirrored, harvests, liveops for
+developers), `kit.matchmaking.queue(name)` (parties matched whole), `kit.sessions.open(key)` (lobby
+to result), `kit.npcs.area(key)` (mobs, NPCs, players' pets), `kit.topology` (compose, check, build
+and deploy the starters), and `kit.spectate`, `kit.emotes` and `kit.shards`. They share one exec
+connection (`kit.runtime`) that paces calls under the gateway's limit, resends only what is safe
+and mirrors topics with resync on gaps, epochs and reconnects; a hub's refusal is a `KitError`
+with its `code`. Both clients have it: the blocking one runs a mirror's resync beside the
+connection's reader thread. Exec reconnects wait with jitter. See [MIGRATION.md](MIGRATION.md).
+
 **v0.11.0: access that ends ends for good, and channel and team bans (CrowdyJS 18.10.0, CrowdyCPP
 0.63.0).** A host's `4403` close (ck-exec 0.16: the player was suspended, revoked, signed out or
 blocked) is final: `ExecConnection.on_access_ended` hears the reason, the call in flight fails
@@ -300,6 +311,33 @@ cannot hold (a type outside 0-255, a position outside 0-15) is kept in the chunk
 applied a second time. A game with other addressing reads every edit from
 `session.on("voxel_update", ...)`, which includes those echoes.
 
+## Game Kit
+
+`client.kit(app_id)` drives the ck-exec starter hubs (the server half is `ckx_sdk::kit`), with
+the same modules as CrowdyJS's `client.kit(appId)`:
+
+```python
+kit = game.kit(app_id)
+await kit.world.conditions.start()  # mirrored: time of day, weather, liveops modifiers
+queue = kit.matchmaking.queue("ranked")
+queue.on_matched(lambda session: print("matched into", session))
+await queue.join(1200)
+watching = asyncio.create_task(queue.watch())  # asks while the player waits
+try:
+    await kit.npcs.area_at(12, -3).attack(4)
+except KitError as e:
+    if e.code == "cooldown":
+        ...
+```
+
+`kit.world`, `kit.matchmaking`, `kit.sessions`, `kit.npcs` and `kit.topology` (compose, check,
+build and deploy the starters) share one exec connection (`kit.runtime`): it paces calls under the
+gateway's 120 per 10 s, sends a call again only when that is safe (it did not run, or it carries
+an `action_id` the hub answers once), and its mirrors (`HubState`, `CollectionMirror`,
+`PrivateState`) take a new snapshot after a gap, another epoch or a reconnect. `kit.spectate`,
+`kit.emotes` and `kit.shards` are the client conventions, and `kit.social` the parties, guilds and
+chat rooms. The blocking client's kit is the same, with blocking calls.
+
 ## Crowdy Studio
 
 ```python

{crowdypy-0.11.0.dev1 → crowdypy-0.12.0.dev1}/README.md

@@ -11,6 +11,17 @@ CrowdyPy follows the [CrowdyJS](https://github.com/CrowdedKingdoms/CrowdyJS) API
 client, bound with [nanobind](https://github.com/wjakob/nanobind) and shipped inside the
 wheel. Python never touches a datagram.
 
+**v0.12.0: the Game Kit on ck-exec (CrowdyJS 18.11.0, CrowdyCPP 0.64.0).** `client.kit(app_id)`
+gains typed clients for the ck-exec starter hubs, the client half of the game kit whose server
+half is `ckx_sdk::kit`: `kit.world` (conditions and resource nodes mirrored, harvests, liveops for
+developers), `kit.matchmaking.queue(name)` (parties matched whole), `kit.sessions.open(key)` (lobby
+to result), `kit.npcs.area(key)` (mobs, NPCs, players' pets), `kit.topology` (compose, check, build
+and deploy the starters), and `kit.spectate`, `kit.emotes` and `kit.shards`. They share one exec
+connection (`kit.runtime`) that paces calls under the gateway's limit, resends only what is safe
+and mirrors topics with resync on gaps, epochs and reconnects; a hub's refusal is a `KitError`
+with its `code`. Both clients have it: the blocking one runs a mirror's resync beside the
+connection's reader thread. Exec reconnects wait with jitter. See [MIGRATION.md](MIGRATION.md).
+
 **v0.11.0: access that ends ends for good, and channel and team bans (CrowdyJS 18.10.0, CrowdyCPP
 0.63.0).** A host's `4403` close (ck-exec 0.16: the player was suspended, revoked, signed out or
 blocked) is final: `ExecConnection.on_access_ended` hears the reason, the call in flight fails
@@ -260,6 +271,33 @@ cannot hold (a type outside 0-255, a position outside 0-15) is kept in the chunk
 applied a second time. A game with other addressing reads every edit from
 `session.on("voxel_update", ...)`, which includes those echoes.
 
+## Game Kit
+
+`client.kit(app_id)` drives the ck-exec starter hubs (the server half is `ckx_sdk::kit`), with
+the same modules as CrowdyJS's `client.kit(appId)`:
+
+```python
+kit = game.kit(app_id)
+await kit.world.conditions.start()  # mirrored: time of day, weather, liveops modifiers
+queue = kit.matchmaking.queue("ranked")
+queue.on_matched(lambda session: print("matched into", session))
+await queue.join(1200)
+watching = asyncio.create_task(queue.watch())  # asks while the player waits
+try:
+    await kit.npcs.area_at(12, -3).attack(4)
+except KitError as e:
+    if e.code == "cooldown":
+        ...
+```
+
+`kit.world`, `kit.matchmaking`, `kit.sessions`, `kit.npcs` and `kit.topology` (compose, check,
+build and deploy the starters) share one exec connection (`kit.runtime`): it paces calls under the
+gateway's 120 per 10 s, sends a call again only when that is safe (it did not run, or it carries
+an `action_id` the hub answers once), and its mirrors (`HubState`, `CollectionMirror`,
+`PrivateState`) take a new snapshot after a gap, another epoch or a reconnect. `kit.spectate`,
+`kit.emotes` and `kit.shards` are the client conventions, and `kit.social` the parties, guilds and
+chat rooms. The blocking client's kit is the same, with blocking calls.
+
 ## Crowdy Studio
 
 ```python

{crowdypy-0.11.0.dev1 → crowdypy-0.12.0.dev1}/docs/compatibility.md

@@ -5,7 +5,7 @@ are in `pyproject.toml` (`[project].version`, `[tool.crowdypy.crowdyjs]`,
 `[tool.crowdypy.crowdycpp]`); `tests/unit/test_release_versions.py` refuses this page when
 its version disagrees.
 
-- CrowdyPy `0.11.0`
+- CrowdyPy `0.12.0`
 - API surface: CrowdyJS (the pinned version and commit in `pyproject.toml`); the generated
   `docs/parity-matrix.md` lists every covered method, every native equivalent and every
   browser exclusion with its reason. The gate is strict: there are no portable gaps, and a

{crowdypy-0.11.0.dev1 → crowdypy-0.12.0.dev1}/docs/e2e-coverage.md

@@ -58,6 +58,7 @@ player once and signs it in for the later suites.
 | 2026-10-08 | local stack: ck-api at the distance-limited channel branch (off `dev`), two replication servers serving message type 32, the 3-node Citus lab | 0.6.0 (branch) | identity, ranged channel, replication, world and world data suites: 10 passed |
 | 2026-10-09 | dev tier, app `96701660793088`, after replication server v0.35.0 and ck-api v2.38.0 reached dev | `crowdypy 0.6.0.dev1` from PyPI (installed into a clean Python 3.12 with uv) | identity (incl. the terms gate), ranged channel, replication, world and world data suites: 10 passed |
 | 2026-10-13 | dev tier (ck-api v2.42.0), app `96701660793088`, the `harness` provisioning token with `CROWDY_E2E_EMAIL=crowdy-e2e-py@test.invalid` | 0.10.0 (branch, vendoring CrowdyCPP `dev/v0.62.0`) | identity (the terms-gate case now registers with the token and no consents), input log, ranged channel, replication, world and world data suites: 12 passed; open grid (needs `CROWDY_E2E_THROWAWAY_OWNER=1`) and Studio skipped |
+| 2026-10-14 | dev tier (ck-api v2.44.1, replication server v0.39.0), app `96701660793088`, the `harness` provisioning token | 0.11.0 (`dev` at `586fc40`, vendoring CrowdyCPP 0.63.0) | identity, input log, ranged channel, replication, world and world data suites: 12 passed; open grid (needs `CROWDY_E2E_THROWAWAY_OWNER=1`) and Studio skipped |
 
 ## Not covered here
 
@@ -73,6 +74,7 @@ These CrowdyCPP suites have no CrowdyPy counterpart yet; the reason is in each r
 | `e2e_soak_two_clients`, `e2e_permission_refresh` | long-running; slated for `CROWDY_E2E_SLOW=1` suites |
 | `e2e_host_election`, `e2e_durable_stores`, `e2e_chunk_store_live` | the World Stores' host, save and chunk persistence run over GraphQL timers covered by unit suites against fakes; live coverage needs a dedicated app (chunk write-back closes the wilderness) |
 | `e2e_cross_app`, `e2e_cross_tenant`, `e2e_malicious_input` | platform isolation properties the CrowdyCPP suites already exercise against the same API |
+| `e2e_bans_blocks` | 0.11.0's `channels.ban` / `teams.ban`, `account_blocked_of` and `group_member_banned_of` send the documents CrowdyCPP's suite exercises live, and the unit suites check them against a mocked API; an account block needs the tier operator's credentials. The tier round trip and the nightly identity probe run the same bans and blocks on each tier |
 
 0.8.0's additions (channel audio, the echo of your own voxel edit, `APP_PAUSED`, access
 suspension, player profiles, `exec.restart_type`) have no live suite yet, in CrowdyPy or in

{crowdypy-0.11.0.dev1 → crowdypy-0.12.0.dev1}/docs/parity-matrix.md

@@ -4,16 +4,16 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 
 ## Target
 
-- CrowdyJS: `18.10.0` at `b3e2de96ae738d272488ca06ab6de2c792aef14f`
-- CrowdyCPP (native core): `0.63.0` at `8682d39ab9cd368996eb35b76e6dfb10b43b7d62`
+- CrowdyJS: `18.11.0` at `5167437788a8ea683d2fde6d3bafa2639feaa45e`
+- CrowdyCPP (native core): `0.64.0` at `78ac8396d4bd0b3bfdd271c867f480e471488095`
 - schema.gql identical to CrowdyJS's: yes
 - Gate mode: strict portable parity (every portable gap is release-blocking)
 
 ## Summary
 
-- Covered: 1080
+- Covered: 1146
 - Portable gap: 0
-- Native equivalent: 42
+- Native equivalent: 44
 - Browser exclusion: 113
 - Deprecated roots: 2
 - Unclassified: 0
@@ -462,6 +462,7 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `ChannelsAPI -> ChannelsAPI` | covered |
 | `ChunkStore -> ChunkStore` | covered |
 | `ChunksAPI -> ChunksAPI` | covered |
+| `CollectionMirror -> CollectionMirror` | covered |
 | `CrowdyClient -> AsyncCrowdyClient` | covered |
 | `CrowdyStudioAPI -> CrowdyStudioAPI` | covered |
 | `CrowdyStudioController -> CrowdyStudioController` | covered |
@@ -472,11 +473,14 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `CrowdyStudioTextHud -> (none)` | browser exclusion — HUD layer renders text-only player presentation into game-owned DOM |
 | `DiscoveryDomain -> DiscoveryDomain` | covered |
 | `EmbeddedHost -> (none)` | browser exclusion — iframe/postMessage bridge to the first-party shell page; there is no frame around a Python client |
+| `EmotesKit -> EmotesKit` | covered |
 | `ErrorStore -> ErrorStore` | covered |
 | `EventRouter -> EventRouter` | covered |
 | `ExecAPI -> ExecAPI` | covered |
 | `ExecConnection -> ExecConnection` | covered |
 | `GameAppsAPI -> GameAppsAPI` | covered |
+| `GameKitClient -> GameKitClient` | covered |
+| `GameSessionHandle -> GameSessionHandle` | covered |
 | `GraphQLClient -> AsyncGraphQLClient` | covered |
 | `GridScope -> GridScope` | covered |
 | `GridsAPI -> GridsAPI` | covered |
@@ -484,20 +488,32 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `HostTracker -> HostTracker` | covered |
 | `HostingAPI -> (none)` | browser exclusion — wrapper over the Crowdy Games hosting roots, which publish browser bundles; no Python client publishes one (CrowdyCPP classifies it the same way) |
 | `InputLogAPI -> InputLogAPI` | covered |
+| `KitError -> KitError` | covered |
+| `KitRuntime -> KitRuntime` | covered |
+| `KitTopology -> KitTopology` | covered |
 | `LocalActorStore -> LocalActorStore` | covered |
 | `MarketplaceAPI -> MarketplaceAPI` | covered |
+| `MatchQueue -> MatchQueue` | covered |
+| `MatchmakingKit -> MatchmakingKit` | covered |
+| `NpcArea -> NpcArea` | covered |
+| `NpcsKit -> NpcsKit` | covered |
 | `OrganizationsAPI -> OrganizationsAPI` | covered |
 | `PaymentsAPI -> PaymentsAPI` | covered |
 | `PlatformAPI -> PlatformAPI` | covered |
 | `PlayerWalletAPI -> PlayerWalletAPI` | covered |
 | `PortalAPI -> PortalAPI` | covered |
+| `PrivateState -> PrivateState` | covered |
 | `QuotasAPI -> QuotasAPI` | covered |
 | `RemoteActorLane -> RemoteActorLane` | covered |
 | `RemoteActorStore -> RemoteActorStore` | covered |
 | `SaveStateStore -> SaveStateStore` | covered |
 | `ServerStatusAPI -> ServerStatusAPI` | covered |
+| `SessionsKit -> SessionsKit` | covered |
+| `ShardKit -> ShardKit` | covered |
 | `SharedEnvironmentAPI -> SharedEnvironmentAPI` | covered |
 | `SocialKit -> SocialKit` | covered |
+| `SpectateKit -> SpectateKit` | covered |
+| `SpectatorHeartbeat -> SpectatorHeartbeat` | covered |
 | `StateAPI -> StateAPI` | covered |
 | `StudioLayoutController -> StudioLayoutController` | covered |
 | `TeamsAPI -> TeamsAPI` | covered |
@@ -512,7 +528,9 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `WorkerMessageReader -> (none)` | browser exclusion — binds vscode-jsonrpc to browser Web Worker messaging |
 | `WorkerMessageWriter -> (none)` | browser exclusion — binds vscode-jsonrpc to browser Web Worker messaging |
 | `WorldClient -> WorldClient` | covered |
+| `WorldKit -> WorldKit` | covered |
 | `WorldSessionCore -> WorldSessionCore` | covered |
+| `WritableKitStore -> WritableKitStore` | covered |
 
 ## Methods
 
@@ -667,6 +685,8 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `ChunksAPI.updateLods` | covered |
 | `ChunksAPI.updateState` | covered |
 | `ChunksAPI.voxelList` | covered |
+| `CollectionMirror.list` | covered |
+| `CollectionMirror.member` | covered |
 | `CrowdyClient.close` | native equivalent — AsyncCrowdyClient.aclose(), the asyncio spelling; the blocking CrowdyClient has close() |
 | `CrowdyClient.getToken` | covered |
 | `CrowdyClient.graphqlEndpoint` | covered |
@@ -745,6 +765,8 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `CrowdyStudioGitHubTransport.unbind` | covered |
 | `DiscoveryDomain.app` | covered |
 | `DiscoveryDomain.apps` | covered |
+| `EmotesKit.parse` | covered |
+| `EmotesKit.send` | covered |
 | `ErrorStore.clear` | covered |
 | `ErrorStore.last` | covered |
 | `ErrorStore.lastFor` | covered |
@@ -826,6 +848,25 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `GameAppsAPI.setPermissionLimits` | covered |
 | `GameAppsAPI.transferOwnership` | covered |
 | `GameAppsAPI.userPermissions` | covered |
+| `GameKitClient.close` | covered |
+| `GameKitClient.emotes` | covered |
+| `GameKitClient.matchmaking` | covered |
+| `GameKitClient.npcs` | covered |
+| `GameKitClient.sessions` | covered |
+| `GameKitClient.shards` | covered |
+| `GameKitClient.spectate` | covered |
+| `GameKitClient.topology` | covered |
+| `GameKitClient.world` | covered |
+| `GameSessionHandle.act` | covered |
+| `GameSessionHandle.configure` | covered |
+| `GameSessionHandle.currentTurn` | covered |
+| `GameSessionHandle.isMyTurn` | covered |
+| `GameSessionHandle.join` | covered |
+| `GameSessionHandle.leave` | covered |
+| `GameSessionHandle.ready` | covered |
+| `GameSessionHandle.startGame` | covered |
+| `GameSessionHandle.unwatch` | covered |
+| `GameSessionHandle.watch` | covered |
 | `GraphQLClient.endpoint` | covered |
 | `GraphQLClient.getEndpoint` | covered |
 | `GraphQLClient.query` | covered |
@@ -858,6 +899,19 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `HostTracker.onHostChanged` | covered |
 | `InputLogAPI.messages` | covered |
 | `InputLogAPI.sessions` | covered |
+| `KitError.from` | native equivalent — KitError.from_error(error): `from` is a Python keyword |
+| `KitRuntime.call` | covered |
+| `KitRuntime.close` | covered |
+| `KitRuntime.connection` | covered |
+| `KitRuntime.onAccessEnded` | covered |
+| `KitRuntime.onReconnect` | covered |
+| `KitRuntime.playerId` | covered |
+| `KitRuntime.subscribe` | covered |
+| `KitRuntime.subscriptions` | covered |
+| `KitTopology.deploy` | covered |
+| `KitTopology.pack` | covered |
+| `KitTopology.plan` | covered |
+| `KitTopology.types` | covered |
 | `LocalActorStore.chunk` | covered |
 | `LocalActorStore.join` | covered |
 | `LocalActorStore.lastAck` | covered |
@@ -883,6 +937,33 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `MarketplaceAPI.setGridClaimPolicy` | covered |
 | `MarketplaceAPI.setListingStatus` | covered |
 | `MarketplaceAPI.transferListing` | covered |
+| `MatchQueue.accept` | covered |
+| `MatchQueue.configure` | covered |
+| `MatchQueue.decline` | covered |
+| `MatchQueue.join` | covered |
+| `MatchQueue.leave` | covered |
+| `MatchQueue.onMatched` | covered |
+| `MatchQueue.place` | covered |
+| `MatchQueue.status` | covered |
+| `MatchQueue.unwatch` | covered |
+| `MatchQueue.watch` | covered |
+| `MatchmakingKit.queue` | covered |
+| `NpcArea.adopt` | covered |
+| `NpcArea.attack` | covered |
+| `NpcArea.dismiss` | covered |
+| `NpcArea.mobs` | covered |
+| `NpcArea.myPets` | covered |
+| `NpcArea.npcs` | covered |
+| `NpcArea.pets` | covered |
+| `NpcArea.release` | covered |
+| `NpcArea.rename` | covered |
+| `NpcArea.summon` | covered |
+| `NpcArea.talk` | covered |
+| `NpcArea.unwatch` | covered |
+| `NpcArea.watch` | covered |
+| `NpcsKit.area` | covered |
+| `NpcsKit.areaAt` | covered |
+| `NpcsKit.keyAt` | covered |
 | `OrganizationsAPI.bySlug` | covered |
 | `OrganizationsAPI.create` | covered |
 | `OrganizationsAPI.createRole` | covered |
@@ -935,6 +1016,11 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `PortalAPI.revokeAppAuthorization` | covered |
 | `PortalAPI.setAppClientSettings` | covered |
 | `PortalAPI.signIn` | browser exclusion — hosted sign-in navigates the browser to Studio /authorize (ck-api v1.88.0); a a Python client client sends no Origin header, signs in with auth().login and mints directly |
+| `PrivateState.get` | covered |
+| `PrivateState.refresh` | covered |
+| `PrivateState.start` | covered |
+| `PrivateState.stop` | covered |
+| `PrivateState.subscribe` | covered |
 | `QuotasAPI.effective` | covered |
 | `QuotasAPI.forApp` | covered |
 | `QuotasAPI.forOrg` | covered |
@@ -975,6 +1061,9 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `ServerStatusAPI.listAll` | covered |
 | `ServerStatusAPI.serverWithLeastClients` | covered |
 | `ServerStatusAPI.versionInfo` | covered |
+| `SessionsKit.open` | covered |
+| `ShardKit.around` | covered |
+| `ShardKit.key` | covered |
 | `SharedEnvironmentAPI.appRuntimeState` | covered |
 | `SharedEnvironmentAPI.appSubscription` | covered |
 | `SharedEnvironmentAPI.autoBilling` | covered |
@@ -1005,6 +1094,10 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `SocialKit.party.join` | covered |
 | `SocialKit.party.leave` | covered |
 | `SocialKit.party.members` | covered |
+| `SpectateKit.observe` | covered |
+| `SpectatorHeartbeat.error` | covered |
+| `SpectatorHeartbeat.moveTo` | covered |
+| `SpectatorHeartbeat.stop` | covered |
 | `StateAPI.delete` | covered |
 | `StateAPI.getAll` | covered |
 | `StateAPI.getOne` | covered |
@@ -1079,11 +1172,18 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `VoxelsAPI.update` | covered |
 | `WorldClient.actor` | covered |
 | `WorldClient.subscribe` | covered |
+| `WorldKit.cancel` | covered |
+| `WorldKit.harvest` | covered |
+| `WorldKit.schedule` | covered |
+| `WorldKit.state` | covered |
 | `WorldSessionCore.dispose` | covered |
 | `WorldSessionCore.on` | covered |
 | `WorldSessionCore.onDispose` | covered |
 | `WorldSessionCore.setSendTracker` | covered |
 | `WorldSessionCore.trackSend` | covered |
+| `WritableKitStore.get` | covered |
+| `WritableKitStore.set` | covered |
+| `WritableKitStore.subscribe` | covered |
 
 ## Package exports
 
@@ -1119,33 +1219,18 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `CrowdyTimeoutError` | covered |
 | `CrowdyUserCodeFaultError` | covered |
 | `EMBEDDED_HOST_PROTOCOL_VERSION` | browser exclusion — iframe/postMessage bridge to the first-party shell page; there is no frame around a Python client |
-| `EVENT_ABILITY` | covered |
-| `EVENT_CONTACT_DAMAGE` | covered |
-| `EVENT_CONTROL_POINT` | covered |
-| `EVENT_MOVEMENT_VIOLATION` | covered |
-| `EVENT_PROPOSAL` | covered |
-| `EVENT_RACE_TIMING` | covered |
-| `EVENT_SCORE` | covered |
-| `EVENT_TURN` | covered |
-| `EVENT_WEATHER` | covered |
-| `EVENT_ZONE_CHANGE` | covered |
 | `EXEC_CLIENT_ABI_IMPORTS` | covered |
 | `EXEC_CLIENT_ABI_VERSION` | covered |
 | `EXEC_CLIENT_HOST_CALLS` | browser exclusion — page-side broker for player WASM in the browser glue Web Worker (worker lifecycle, host-call allowlists, rate caps, watchdogs) |
 | `EXEC_CLOSE_ACCESS_ENDED` | covered |
 | `EXEC_STATUSES` | covered |
 | `ExecModScope` | covered |
-| `FLAG_GROUNDED` | covered |
-| `FLAG_MOB` | covered |
-| `FLAG_NPC` | covered |
-| `FLAG_RESERVED3` | covered |
 | `GLUE_HOST_CALL_REQUEST_MAX_BYTES` | browser exclusion — glue that instantiates player WASM inside the browser Web Worker (CLIENT ABI imports, ck_fuel, watchdog) |
 | `GLUE_HOST_FUNCTIONS` | browser exclusion — glue that instantiates player WASM inside the browser Web Worker (CLIENT ABI imports, ck_fuel, watchdog) |
 | `GLUE_INVOKE_REPLY_MAX_BYTES` | browser exclusion — glue that instantiates player WASM inside the browser Web Worker (CLIENT ABI imports, ck_fuel, watchdog) |
 | `GLUE_LOG_MAX_BYTES` | browser exclusion — glue that instantiates player WASM inside the browser Web Worker (CLIENT ABI imports, ck_fuel, watchdog) |
 | `GLUE_STATE_MAX_BYTES` | browser exclusion — glue that instantiates player WASM inside the browser Web Worker (CLIENT ABI imports, ck_fuel, watchdog) |
 | `GROUP_MEMBER_BANNED_CODE` | covered |
-| `GameKitClient` | covered |
 | `GlueRuntime` | browser exclusion — glue that instantiates player WASM inside the browser Web Worker (CLIENT ABI imports, ck_fuel, watchdog) |
 | `GraphQLTransport` | native equivalent — pass an httpx.AsyncClient / httpx.Client as http_client= (transport, proxies, HTTP/2, timeouts) |
 | `GridScopeError` | covered |
@@ -1157,7 +1242,6 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `PLAYER_CODE_LOG_LINES_PER_SECOND` | browser exclusion — page-side broker for player WASM in the browser glue Web Worker (worker lifecycle, host-call allowlists, rate caps, watchdogs) |
 | `PLAYER_CODE_LOG_MAX_CHARS` | browser exclusion — page-side broker for player WASM in the browser glue Web Worker (worker lifecycle, host-call allowlists, rate caps, watchdogs) |
 | `PLAYER_PROFILES_MAX` | covered |
-| `POSE_BYTES` | covered |
 | `PlayerCodeBroker` | browser exclusion — page-side broker for player WASM in the browser glue Web Worker (worker lifecycle, host-call allowlists, rate caps, watchdogs) |
 | `PortalConsentRequiredError` | covered |
 | `RELAY_MAX_BUNDLE_MEMBERS` | native equivalent — the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.MAX_BUNDLE_MEMBERS |
@@ -1200,21 +1284,18 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `createMintRediscover` | covered |
 | `createSignContext` | native equivalent — the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.encode_long_spatial / spatial_hmac take the token directly |
 | `decodeBase64` | covered |
-| `decodeEnginePose` | covered |
 | `decodeExecFrame` | covered |
 | `decodeVoicePacket` | covered |
 | `defaultClientGridEventBus` | browser exclusion — page-local event bus between CLIENT mods running in this browser's glue workers |
 | `defaultHostedSignInUrl` | covered |
 | `encodeBase64` | covered |
-| `encodeEnginePose` | covered |
 | `encodeExecFrame` | covered |
 | `encodeVoiceHeader` | covered |
 | `encodeVoicePacket` | covered |
-| `engineLanes` | covered |
-| `enginePoseCodec` | covered |
 | `execGatewayRefusal` | covered |
 | `execModType` | covered |
 | `execStatus` | covered |
+| `execWireIntegers` | native equivalent — msgspec writes a Python int as a msgpack integer of its width, so there is no float for a hub's integer field to refuse; @msgpack/msgpack writes a JS number of 2^32 or more as a float without it |
 | `fragmentFrame` | covered |
 | `generateCrowdyUuid` | covered |
 | `generatePkcePair` | covered |
@@ -1234,24 +1315,11 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `moveFromError` | covered |
 | `moveFromErrors` | covered |
 | `packMessageBundle` | native equivalent — the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.bundle |
-| `parseAbilityEvent` | covered |
-| `parseContactDamage` | covered |
-| `parseControlPointEvent` | covered |
-| `parseEngineEvent` | covered |
 | `parseFuelBudget` | browser exclusion — glue that instantiates player WASM inside the browser Web Worker (CLIENT ABI imports, ck_fuel, watchdog) |
-| `parseMovementViolation` | covered |
-| `parseProposalEvent` | covered |
-| `parseRaceTimingEvent` | covered |
 | `parseRelayFrame` | native equivalent — the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.parse_datagram (a relay frame is one datagram) |
-| `parseScoreEvent` | covered |
-| `parseTurnEvent` | covered |
 | `parseVideoFragmentHeader` | covered |
-| `parseWeatherEvent` | covered |
-| `parseZoneChangeEvent` | covered |
 | `payloadBytesOf` | native equivalent — connection.stats(): CrowdyCPP's counters (datagrams, messages and bytes, by message type) |
 | `playerFaultOf` | covered |
-| `poseSuffix` | covered |
-| `runOptimisticAction` | covered |
 | `runWithWatchdog` | browser exclusion — glue that instantiates player WASM inside the browser Web Worker (CLIENT ABI imports, ck_fuel, watchdog) |
 | `serializeActorUpdate` | native equivalent — the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.encode_long_spatial with the message type |
 | `serializeAudioPacket` | native equivalent — the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.encode_long_spatial with the message type |

{crowdypy-0.11.0.dev1 → crowdypy-0.12.0.dev1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "scikit_build_core.build"
 
 [project]
 name = "crowdypy"
-version = "0.11.0.dev1"
+version = "0.12.0.dev1"
 description = "Official Python SDK for Crowded Kingdoms: typed GraphQL clients and a native UDP replication core"
 readme = "README.md"
 license = "MIT AND Apache-2.0"
@@ -119,14 +119,14 @@ environment = { OPENSSL_ROOT_DIR = "C:/vcpkg/installed/x64-windows-static-md" }
 # --------------------------------------------------------------------------------------
 
 [tool.crowdypy.crowdyjs]
-version = "18.10.0"
-commit = "b3e2de96ae738d272488ca06ab6de2c792aef14f"
+version = "18.11.0"
+commit = "5167437788a8ea683d2fde6d3bafa2639feaa45e"
 
 [tool.crowdypy.crowdycpp]
-version = "0.63.0"
-tag = "dev/v0.63.0"
-commit = "8682d39ab9cd368996eb35b76e6dfb10b43b7d62"
-tree-sha256 = "318b0db6138c877a666261fe71d1fc8bb2a644f333f3c927487f435371856c87"
+version = "0.64.0"
+tag = "dev/v0.64.0"
+commit = "78ac8396d4bd0b3bfdd271c867f480e471488095"
+tree-sha256 = "db5facc1d3ad24f049623916e71a1020d9f6cdb79bc8fa9df091f926f67aa053"
 
 # schema.gql and operations/ are CrowdyJS's, copied from the commit pinned above by
 # scripts/schema_sync.py, which records these hashes and re-derives them in CI.

{crowdypy-0.11.0.dev1 → crowdypy-0.12.0.dev1}/scripts/unasync.py

@@ -7,8 +7,8 @@
 The async modules are the source of truth: ``graphql.py``, ``client.py``,
 ``rediscover.py``, ``grid_scope.py``, ``world.py``, ``stores.py``, ``domains/`` and
 ``kit/``. A token-level rewrite (formatting is preserved) drops ``async``/``await``, maps
-the async names to their blocking twins and points imports of those modules at
-``crowdypy._sync``. ``asyncio.sleep`` becomes ``time.sleep``; any other use of asyncio in a
+the async names to their blocking twins, unwraps ``Awaitable[X]`` to ``X`` and points imports
+of those modules at ``crowdypy._sync``. ``asyncio.sleep`` becomes ``time.sleep``; any other use of asyncio in a
 source module is refused, because it would have no blocking equivalent.
 """
 
@@ -54,6 +54,7 @@ NAMES = {
     "AsyncReplicationConnection": "ReplicationConnection",
     "AsyncExecConnection": "ExecConnection",
     "run_soon": "run_now",
+    "run_detached": "run_in_thread",
     "AsyncClient": "Client",
     "aclose": "close",
     "__aenter__": "__enter__",
@@ -105,6 +106,14 @@ def transform(source: str, rel: str) -> str:
             ):
                 raise SystemExit(f"unasync: {rel}:{tok.start[0]} uses asyncio beyond asyncio.sleep")
             edits.append((pos(tok.start), pos(tok.end), "time"))
+        elif tok.type == tokenize.NAME and tok.string == "Awaitable" and nxt and nxt.string == "[":
+            depth = 0
+            for close in tokens[i + 1 :]:
+                depth += {"[": 1, "]": -1}.get(close.string, 0) if close.type == tokenize.OP else 0
+                if depth == 0:
+                    break
+            edits.append((pos(tok.start), pos(nxt.end), ""))
+            edits.append((pos(close.start), pos(close.end), ""))
         elif tok.type == tokenize.NAME and tok.string in NAMES:
             edits.append((pos(tok.start), pos(tok.end), NAMES[tok.string]))
         elif (

{crowdypy-0.11.0.dev1 → crowdypy-0.12.0.dev1}/src/crowdypy/_concurrency.py

@@ -14,7 +14,14 @@ import threading
 from collections.abc import Awaitable, Callable
 from typing import Any
 
-__all__ = ["AsyncSingleFlight", "SingleFlight", "run_now", "run_soon"]
+__all__ = [
+    "AsyncSingleFlight",
+    "SingleFlight",
+    "run_detached",
+    "run_in_thread",
+    "run_now",
+    "run_soon",
+]
 
 
 class AsyncSingleFlight[T]:
@@ -127,3 +134,20 @@ def run_now(job: Callable[[], Any]) -> None:
         job()
     except Exception:
         _logger.exception("background job failed")
+
+
+def run_detached(job: Callable[[], Awaitable[Any]]) -> None:
+    """Start ``job`` without waiting for it, from a callback that must not wait: a push or a
+    reconnect handler. A failure is logged.
+
+    In the async client this is :func:`run_soon`. scripts/unasync.py maps it to
+    :func:`run_in_thread`, because the blocking client runs those handlers on a connection's
+    reader thread, and a call made there would wait on a reply only that thread can read.
+    """
+    run_soon(job)
+
+
+def run_in_thread(job: Callable[[], Any]) -> None:
+    """Run ``job`` on a daemon thread; a failure is logged (the blocking twin of
+    :func:`run_detached`)."""
+    threading.Thread(target=run_now, args=(job,), name="crowdypy-kit", daemon=True).start()