crowdypy 0.14.2.dev1__tar.gz → 0.15.0.dev1__tar.gz

{crowdypy-0.14.2.dev1 → crowdypy-0.15.0.dev1}/MIGRATION.md

@@ -3,6 +3,19 @@
 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.15.0
+
+CrowdyJS 18.15.0 and CrowdyCPP 0.67.4. Additive.
+
+- **`chunks.set_voxel(..., optimistic=False)`**, CrowdyJS's `setVoxel({ optimistic: false })`:
+  nothing changes locally and nothing is queued for write-back; the edit is applied when the
+  server's echo of it arrives, so the cache holds only what the server accepted. The default
+  (`True`) is the edit as before. The native core carries the flag since CrowdyCPP 0.67.4
+  (`ChunkStore::setVoxel(..., optimistic)`).
+- **`client.udp.send_generic_spatial(chunk, uuid, payload)`**: an app-defined spatial message
+  (opcode 140) that the actors near `chunk` receive as `generic_spatial`; CrowdyJS 18.15.0's
+  `udp.sendGenericSpatial`. The replication connection had `send_generic_spatial` already.
+
 ## 0.14.2
 
 CrowdyJS 18.14.0 and CrowdyCPP 0.67.3. No breaking change. `PlayerWalletAPI.charges()` is

{crowdypy-0.14.2.dev1 → crowdypy-0.15.0.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crowdypy
-Version: 0.14.2.dev1
+Version: 0.15.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,8 @@ 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.15.0: a voxel edit that waits for the server, and opcode 140 from `client.udp`.** `chunks.set_voxel(..., optimistic=False)` changes nothing locally until the server's echo of the edit arrives; `client.udp.send_generic_spatial` sends an app-defined spatial message. CrowdyJS 18.15.0 and CrowdyCPP 0.67.4. See [MIGRATION.md](MIGRATION.md).
+
 **v0.14.2: CrowdyJS 18.14.0 and CrowdyCPP 0.67.3.** `player_wallet.charges()` is deprecated: read `transactions()`, whose `usage_debit` entries are the usage charges.
 
 **v0.14.1: the exec socket names a paused app and a switched-off app or type.** `AppPaused`, `AppDisabled`, and `TypeDisabled`. Still CrowdyJS 18.13.0 and CrowdyCPP 0.66.0.
@@ -326,7 +328,8 @@ states = pose.decode_many(snapshot.state_offsets, snapshot.state_data)  # numpy,
 `session.chunks` is a helper for 16x16x16 chunks with one byte per voxel. An edit that grid
 cannot hold (a type outside 0-255, a position outside 0-15) is kept in the chunk's
 `overlay()`, and `voxel_type_at` reads it first. The echo of your own `set_voxel` is not
-applied a second time. A game with other addressing reads every edit from
+applied a second time; with `optimistic=False` the edit is applied only when that echo arrives,
+and nothing is queued for write-back. A game with other addressing reads every edit from
 `session.on("voxel_update", ...)`, which includes those echoes.
 
 ## Game Kit

{crowdypy-0.14.2.dev1 → crowdypy-0.15.0.dev1}/README.md

@@ -11,6 +11,8 @@ 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.15.0: a voxel edit that waits for the server, and opcode 140 from `client.udp`.** `chunks.set_voxel(..., optimistic=False)` changes nothing locally until the server's echo of the edit arrives; `client.udp.send_generic_spatial` sends an app-defined spatial message. CrowdyJS 18.15.0 and CrowdyCPP 0.67.4. See [MIGRATION.md](MIGRATION.md).
+
 **v0.14.2: CrowdyJS 18.14.0 and CrowdyCPP 0.67.3.** `player_wallet.charges()` is deprecated: read `transactions()`, whose `usage_debit` entries are the usage charges.
 
 **v0.14.1: the exec socket names a paused app and a switched-off app or type.** `AppPaused`, `AppDisabled`, and `TypeDisabled`. Still CrowdyJS 18.13.0 and CrowdyCPP 0.66.0.
@@ -286,7 +288,8 @@ states = pose.decode_many(snapshot.state_offsets, snapshot.state_data)  # numpy,
 `session.chunks` is a helper for 16x16x16 chunks with one byte per voxel. An edit that grid
 cannot hold (a type outside 0-255, a position outside 0-15) is kept in the chunk's
 `overlay()`, and `voxel_type_at` reads it first. The echo of your own `set_voxel` is not
-applied a second time. A game with other addressing reads every edit from
+applied a second time; with `optimistic=False` the edit is applied only when that echo arrives,
+and nothing is queued for write-back. A game with other addressing reads every edit from
 `session.on("voxel_update", ...)`, which includes those echoes.
 
 ## Game Kit

{crowdypy-0.14.2.dev1 → crowdypy-0.15.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.14.2`
+- CrowdyPy `0.15.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.14.2.dev1 → crowdypy-0.15.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.14.0` at `9abcdf86c2b0440f113c8b7f15bd38fb23f51117`
-- CrowdyCPP (native core): `0.67.3` at `f09fc0b174b90e739f7128400792d5679e621b9b`
+- CrowdyJS: `18.15.0` at `e21b61e79a1a509b81826fc8db2282c107b2e0ea`
+- CrowdyCPP (native core): `0.67.4` at `830a700b99223555c7d687d5471825701f3dbdf8`
 - schema.gql identical to CrowdyJS's: yes
 - Gate mode: strict portable parity (every portable gap is release-blocking)
 
 ## Summary
 
-- Covered: 1352
+- Covered: 1353
 - Portable gap: 0
-- Native equivalent: 44
+- Native equivalent: 46
 - Browser exclusion: 113
 - Deprecated roots: 2
 - Unclassified: 0
@@ -1342,6 +1342,7 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `UdpAPI.sendChannelMessage` | covered |
 | `UdpAPI.sendClientEvent` | covered |
 | `UdpAPI.sendClientEventAndWait` | covered |
+| `UdpAPI.sendGenericSpatial` | covered |
 | `UdpAPI.sendRangedChannelMessage` | covered |
 | `UdpAPI.sendSingleActorMessage` | covered |
 | `UdpAPI.sendTextPacket` | covered |
@@ -1431,6 +1432,7 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `EXEC_CLOSE_ACCESS_ENDED` | covered |
 | `EXEC_STATUSES` | covered |
 | `ExecModScope` | covered |
+| `GENERIC_SPATIAL_MAX_PAYLOAD_BYTES` | native equivalent — the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.MAX_LONG_SPATIAL_PAYLOAD |
 | `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) |
@@ -1532,6 +1534,7 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `serializeChannelAudio` | native equivalent — the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.encode_channel_audio |
 | `serializeChannelMessage` | native equivalent — the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.encode_channel_message with the message type |
 | `serializeClientEvent` | native equivalent — the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.encode_long_spatial with the message type |
+| `serializeGenericSpatial` | native equivalent — the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.encode_long_spatial with the message type |
 | `serializeRangedChannelMessage` | native equivalent — the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.encode_ranged_channel_message |
 | `serializeSingleActorMessage` | native equivalent — the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.encode_long_spatial with the message type |
 | `serializeTextPacket` | native equivalent — the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.encode_long_spatial with the message type |

{crowdypy-0.14.2.dev1 → crowdypy-0.15.0.dev1}/native/session_binding.cpp

@@ -518,7 +518,7 @@ class PySession {
   }
 
   int setVoxel(std::int64_t x, std::int64_t y, std::int64_t z, int vx, int vy, int vz,
-               int voxelType, nb::handle state) {
+               int voxelType, nb::handle state, bool optimistic) {
     BufferView body(state);
     const std::int16_t type = i16_arg(voxelType, "voxel type");
     Result<std::uint8_t> result = Errc::InvalidArgument;
@@ -526,7 +526,8 @@ class PySession {
       nb::gil_scoped_release release;
       std::lock_guard lock(conn_.consumerMutex());
       auto& s = live();
-      result = s.chunks().setVoxel(coord_of(x, y, z), vx, vy, vz, type, body.bytes(), s.actorUuid());
+      result = s.chunks().setVoxel(coord_of(x, y, z), vx, vy, vz, type, body.bytes(), s.actorUuid(),
+                                   optimistic);
       if (result.ok()) s.errors().recordSend(result.value(), session::SendKind::VoxelUpdate, s.actorUuid());
     }
     return sent(result, "setVoxel");
@@ -798,7 +799,8 @@ void register_session(nb::module_& m) {
       .def("voxel_state_at", &PySession::voxelStateAt, nb::arg("x"), nb::arg("y"), nb::arg("z"),
            nb::arg("vx"), nb::arg("vy"), nb::arg("vz"))
       .def("set_voxel", &PySession::setVoxel, nb::arg("x"), nb::arg("y"), nb::arg("z"),
-           nb::arg("vx"), nb::arg("vy"), nb::arg("vz"), nb::arg("voxel_type"), nb::arg("state"))
+           nb::arg("vx"), nb::arg("vy"), nb::arg("vz"), nb::arg("voxel_type"), nb::arg("state"),
+           nb::arg("optimistic") = true)
       .def("seed", &PySession::seed, nb::arg("x"), nb::arg("y"), nb::arg("z"), nb::arg("voxels"))
       .def("hydrate", &PySession::hydrate, nb::arg("x"), nb::arg("y"), nb::arg("z"),
            nb::arg("voxels"), nb::arg("entries"))

{crowdypy-0.14.2.dev1 → crowdypy-0.15.0.dev1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "scikit_build_core.build"
 
 [project]
 name = "crowdypy"
-version = "0.14.2.dev1"
+version = "0.15.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.14.0"
-commit = "9abcdf86c2b0440f113c8b7f15bd38fb23f51117"
+version = "18.15.0"
+commit = "e21b61e79a1a509b81826fc8db2282c107b2e0ea"
 
 [tool.crowdypy.crowdycpp]
-version = "0.67.3"
-tag = "dev/v0.67.3"
-commit = "f09fc0b174b90e739f7128400792d5679e621b9b"
-tree-sha256 = "f0456195cc0948d96f8d7d987f2742722218c35ce60bbe9a34dfa3b9e6303541"
+version = "0.67.4"
+tag = "dev/v0.67.4"
+commit = "830a700b99223555c7d687d5471825701f3dbdf8"
+tree-sha256 = "8f1857cc216193cf861bce48b7df975a2e0e93563d45736c4fb2584fcd26d009"
 
 # 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.14.2.dev1 → crowdypy-0.15.0.dev1}/src/crowdypy/_sync/domains/udp.py

@@ -365,6 +365,23 @@ class UdpAPI:
         connection.flush_sends()
         return connection.wait_for_sequence(sequence, uuid, timeout)
 
+    def send_generic_spatial(
+        self,
+        chunk: Sequence[int],
+        uuid: str,
+        payload: Any,
+        *,
+        distance: int = 8,
+        decay: int = DecayRate.NONE,
+    ) -> int:
+        """An app-defined spatial message (opcode 140): the server fans it out to the actors
+        near ``chunk`` without reading ``payload`` (at most ``wire.MAX_LONG_SPATIAL_PAYLOAD``,
+        1,123 bytes), and they receive it as ``generic_spatial``. CrowdyJS's
+        ``udp.sendGenericSpatial`` (18.15.0) and CrowdyCPP's ``Connection::sendGenericSpatial``."""
+        return self._live().send_generic_spatial(
+            chunk, uuid, payload, distance=distance, decay=decay
+        )
+
     def send_single_actor_message(self, chunk: Sequence[int], uuid: str, payload: Any) -> int:
         """A direct message to one actor: ``chunk`` and ``uuid`` address the TARGET. Not echoed."""
         return self._live().send_single_actor_message(chunk, uuid, payload)

{crowdypy-0.14.2.dev1 → crowdypy-0.15.0.dev1}/src/crowdypy/_sync/stores.py

@@ -739,6 +739,8 @@ class ChunkStore:
         z: int,
         voxel_type: int,
         state: Any = None,
+        *,
+        optimistic: bool = True,
     ) -> int:
         """Apply an edit locally, replicate it, and queue the chunk for write-back. Returns
         the send's sequence number.
@@ -746,15 +748,23 @@ class ChunkStore:
         The position and type are the app's signed 16-bit values; one the dense grid cannot
         hold is kept in the :meth:`overlay`. The encoded state is at most 1,024 bytes. Raises
         ``ValueError`` for anything else, before anything changes or is sent. The server's
-        echo of the edit is not applied again."""
+        echo of the edit is not applied again.
+
+        ``optimistic=False`` (CrowdyJS's ``optimistic: false``) changes nothing locally and
+        queues nothing for write-back: the edit is applied when the server's echo of it
+        arrives, so the cache holds only what the server accepted."""
         coord = _coord(chunk)
         encoded = self._voxel_codec.encode(state) if state is not None else b""
         assert_voxel_edit((x, y, z), voxel_type, encoded)
-        sequence: int = self._session._native.set_voxel(*coord, x, y, z, voxel_type, encoded)
+        sequence: int = self._session._native.set_voxel(
+            *coord, x, y, z, voxel_type, encoded, optimistic
+        )
         self._session.track_send(
             {"kind": "voxelUpdate", "sequence": sequence, "sent_at": _now_ms(),
              "uuid": self._session.actor_uuid, "detail": {"chunk": coord, "x": x, "y": y, "z": z}}
         )  # fmt: skip
+        if not optimistic:
+            return sequence
         meta = self._entry(coord)
         if meta.load_state in ("loading", "missing"):
             meta.load_state = "seeded"

{crowdypy-0.14.2.dev1 → crowdypy-0.15.0.dev1}/src/crowdypy/_version.py

@@ -1,3 +1,3 @@
 """The CrowdyPy release this source tree builds."""
 
-__version__ = "0.14.2"
+__version__ = "0.15.0"

{crowdypy-0.14.2.dev1 → crowdypy-0.15.0.dev1}/src/crowdypy/domains/udp.py

@@ -371,6 +371,23 @@ class UdpAPI:
         connection.flush_sends()
         return await connection.wait_for_sequence(sequence, uuid, timeout)
 
+    async def send_generic_spatial(
+        self,
+        chunk: Sequence[int],
+        uuid: str,
+        payload: Any,
+        *,
+        distance: int = 8,
+        decay: int = DecayRate.NONE,
+    ) -> int:
+        """An app-defined spatial message (opcode 140): the server fans it out to the actors
+        near ``chunk`` without reading ``payload`` (at most ``wire.MAX_LONG_SPATIAL_PAYLOAD``,
+        1,123 bytes), and they receive it as ``generic_spatial``. CrowdyJS's
+        ``udp.sendGenericSpatial`` (18.15.0) and CrowdyCPP's ``Connection::sendGenericSpatial``."""
+        return self._live().send_generic_spatial(
+            chunk, uuid, payload, distance=distance, decay=decay
+        )
+
     async def send_single_actor_message(self, chunk: Sequence[int], uuid: str, payload: Any) -> int:
         """A direct message to one actor: ``chunk`` and ``uuid`` address the TARGET. Not echoed."""
         return self._live().send_single_actor_message(chunk, uuid, payload)

{crowdypy-0.14.2.dev1 → crowdypy-0.15.0.dev1}/src/crowdypy/player_host/schemas.v1.json

@@ -1,7 +1,7 @@
 {
   "crowdyJs": {
-    "version": "18.14.0",
-    "commit": "9abcdf86c2b0440f113c8b7f15bd38fb23f51117"
+    "version": "18.15.0",
+    "commit": "e21b61e79a1a509b81826fc8db2282c107b2e0ea"
   },
   "schemas": {
     "GAME_COMMAND_RESULT_SCHEMA_V1": {

{crowdypy-0.14.2.dev1 → crowdypy-0.15.0.dev1}/src/crowdypy/stores.py

@@ -851,6 +851,8 @@ class ChunkStore:
         z: int,
         voxel_type: int,
         state: Any = None,
+        *,
+        optimistic: bool = True,
     ) -> int:
         """Apply an edit locally, replicate it, and queue the chunk for write-back. Returns
         the send's sequence number.
@@ -858,15 +860,23 @@ class ChunkStore:
         The position and type are the app's signed 16-bit values; one the dense grid cannot
         hold is kept in the :meth:`overlay`. The encoded state is at most 1,024 bytes. Raises
         ``ValueError`` for anything else, before anything changes or is sent. The server's
-        echo of the edit is not applied again."""
+        echo of the edit is not applied again.
+
+        ``optimistic=False`` (CrowdyJS's ``optimistic: false``) changes nothing locally and
+        queues nothing for write-back: the edit is applied when the server's echo of it
+        arrives, so the cache holds only what the server accepted."""
         coord = _coord(chunk)
         encoded = self._voxel_codec.encode(state) if state is not None else b""
         assert_voxel_edit((x, y, z), voxel_type, encoded)
-        sequence: int = self._session._native.set_voxel(*coord, x, y, z, voxel_type, encoded)
+        sequence: int = self._session._native.set_voxel(
+            *coord, x, y, z, voxel_type, encoded, optimistic
+        )
         self._session.track_send(
             {"kind": "voxelUpdate", "sequence": sequence, "sent_at": _now_ms(),
              "uuid": self._session.actor_uuid, "detail": {"chunk": coord, "x": x, "y": y, "z": z}}
         )  # fmt: skip
+        if not optimistic:
+            return sequence
         meta = self._entry(coord)
         if meta.load_state in ("loading", "missing"):
             meta.load_state = "seeded"

{crowdypy-0.14.2.dev1 → crowdypy-0.15.0.dev1}/tests/fixtures/player-host.v1.json

@@ -1,8 +1,8 @@
 {
   "fixtureVersion": 1,
   "crowdyJs": {
-    "version": "18.14.0",
-    "commit": "9abcdf86c2b0440f113c8b7f15bd38fb23f51117"
+    "version": "18.15.0",
+    "commit": "e21b61e79a1a509b81826fc8db2282c107b2e0ea"
   },
   "errorCodes": [
     "AGENT_DISABLED",

{crowdypy-0.14.2.dev1 → crowdypy-0.15.0.dev1}/tests/unit/test_world_session.py

@@ -417,6 +417,27 @@ def test_the_echo_of_your_own_edit_is_applied_once(chunk: Any) -> None:
     assert session.chunks.voxel_type_at(at, 1, 2, 3) == 8
 
 
+def test_an_edit_that_is_not_optimistic_waits_for_its_echo(chunk: Any) -> None:
+    server, connection, session, seen = chunk
+    at = (0, 0, 0)
+    session.chunks.seed(at, bytes(4096), write_back=False)
+    changed: list[Any] = []
+    session.chunks.on_chunk_changed(changed.append)
+    sequence = session.chunks.set_voxel(at, 1, 2, 3, 9, optimistic=False)
+    sent = server.recv()
+    assert wire.parse_voxel_payload(sent.payload) == (1, 2, 3, 9, b"")
+    session.tick()
+    assert changed == [], "nothing changes before the echo"
+    assert session.chunks.voxel_type_at(at, 1, 2, 3) == 0
+    assert session.chunks.pending_write_backs == 0
+
+    voxel(server, ME, (1, 2, 3), 9, sequence)
+    pump_until(session, connection, lambda: len(seen) == 1)
+    tick_until(session, lambda: len(changed) == 1)
+    assert session.chunks.voxel_type_at(at, 1, 2, 3) == 9
+    assert session.chunks.pending_write_backs == 0, "the echo is the server's, not a local edit"
+
+
 def test_a_wide_local_edit_is_kept_in_the_overlay_and_sent_as_it_is(chunk: Any) -> None:
     server, connection, session, seen = chunk
     at = (0, 0, 0)

{crowdypy-0.14.2.dev1 → crowdypy-0.15.0.dev1}/tools/parity/classifications.toml

@@ -139,6 +139,7 @@ GraphQLClient = "AsyncGraphQLClient"
 
 # --- native-equivalent
 "BUNDLE_HEADER_BYTES" = { kind = "native-equivalent", reason = "the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.bundle() / split_datagram(), which own the bundle layout" }
+"GENERIC_SPATIAL_MAX_PAYLOAD_BYTES" = { kind = "native-equivalent", reason = "the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.MAX_LONG_SPATIAL_PAYLOAD" }
 "BUNDLE_LENGTH_PREFIX_BYTES" = { kind = "native-equivalent", reason = "the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.bundle() / split_datagram(), which own the bundle layout" }
 "execWireIntegers" = { kind = "native-equivalent", reason = "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" }
 "BrowserLocalStorageTokenStore" = { kind = "native-equivalent", reason = "token persistence is TokenStore / SessionStore; the localStorage backing is browser-only, and FileTokenStore mirrors its session / app key split" }
@@ -161,6 +162,7 @@ GraphQLClient = "AsyncGraphQLClient"
 "serializeChannelAudio" = { kind = "native-equivalent", reason = "the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.encode_channel_audio" }
 "serializeChannelMessage" = { kind = "native-equivalent", reason = "the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.encode_channel_message with the message type" }
 "serializeClientEvent" = { kind = "native-equivalent", reason = "the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.encode_long_spatial with the message type" }
+"serializeGenericSpatial" = { kind = "native-equivalent", reason = "the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.encode_long_spatial with the message type" }
 "serializeRangedChannelMessage" = { kind = "native-equivalent", reason = "the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.encode_ranged_channel_message" }
 "serializeSingleActorMessage" = { kind = "native-equivalent", reason = "the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.encode_long_spatial with the message type" }
 "serializeTextPacket" = { kind = "native-equivalent", reason = "the same codec, CrowdyCPP's, through crowdypy.wire: crowdypy.wire.encode_long_spatial with the message type" }

{crowdypy-0.14.2.dev1 → crowdypy-0.15.0.dev1}/uv.lock

@@ -103,7 +103,7 @@ wheels = [
 
 [[package]]
 name = "crowdypy"
-version = "0.14.2"
+version = "0.15.0"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },

{crowdypy-0.14.2.dev1 → crowdypy-0.15.0.dev1}/vendor/CrowdyCPP/CMakeLists.txt

@@ -1,5 +1,5 @@
 cmake_minimum_required(VERSION 3.22)
-project(CrowdyCPP VERSION 0.67.3 LANGUAGES C CXX)
+project(CrowdyCPP VERSION 0.67.4 LANGUAGES C CXX)
 
 set(CMAKE_CXX_STANDARD 20)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)

{crowdypy-0.14.2.dev1 → crowdypy-0.15.0.dev1}/vendor/CrowdyCPP/PROVENANCE.md

@@ -5,4 +5,4 @@ pins under `[tool.crowdypy.crowdycpp]`. It is written by
 `scripts/vendor_crowdycpp.py` and checked in CI by re-deriving it from that commit.
 Do not edit it: change CrowdyCPP, release it on the same tier, and re-vendor.
 
-Vendored from `dev/v0.67.3` (`f09fc0b174b90e739f7128400792d5679e621b9b`).
+Vendored from `dev/v0.67.4` (`830a700b99223555c7d687d5471825701f3dbdf8`).

{crowdypy-0.14.2.dev1 → crowdypy-0.15.0.dev1}/vendor/CrowdyCPP/include/crowdy/session/chunk_store.hpp

@@ -328,19 +328,23 @@ class ChunkStore {
   /// The server delivers every accepted edit back to its sender (Buddy v0.37.0);
   /// ingest() matches that echo to this edit (sender uuid + sequence + voxel) and
   /// does not apply it again, so a local edit fires onChunkChanged once.
+  ///
+  /// `optimistic` false (CrowdyJS `setVoxel({ optimistic: false })`, 0.67.4) changes
+  /// nothing locally and marks nothing for write-back: the edit is applied when its echo
+  /// arrives, so the cache shows only what the server accepted.
   Result<std::uint8_t> setVoxel(const ChunkCoord& coord, int x, int y, int z,
                                 std::int16_t voxelType, Bytes voxelState,
-                                const core::ActorUuid& uuid) {
+                                const core::ActorUuid& uuid, bool optimistic = true) {
     if (!fitsInt16(x) || !fitsInt16(y) || !fitsInt16(z)) return Errc::InvalidArgument;
     if (voxelState.size() > wire::voxel::kMaxStateSize) return Errc::InvalidArgument;
-    applyLocal(coord, x, y, z, voxelType, voxelState);
+    if (optimistic) applyLocal(coord, x, y, z, voxelType, voxelState);
     auto seq = conn_.sendVoxelUpdate(coord, uuid, static_cast<std::int16_t>(x),
                                      static_cast<std::int16_t>(y), static_cast<std::int16_t>(z),
                                      voxelType, voxelState, options_.voxelSendDistance);
     if (seq.ok()) {
       rememberEdit(coord, voxelKey(static_cast<std::int16_t>(x), static_cast<std::int16_t>(y),
                                    static_cast<std::int16_t>(z)),
-                   PendingEdit{uuid, seq.value(), nowMs(), false});
+                   PendingEdit{uuid, seq.value(), nowMs(), /*stale=*/!optimistic});
     }
     return seq;
   }

{crowdypy-0.14.2.dev1 → crowdypy-0.15.0.dev1}/vendor/CrowdyCPP/package.json

@@ -1,12 +1,12 @@
 {
   "name": "crowdycpp-maintainer-tools",
-  "version": "0.67.3",
+  "version": "0.67.4",
   "private": true,
   "type": "module",
   "description": "Offline parity and schema maintenance tools for CrowdyCPP",
   "crowdyjsParityTarget": {
-    "version": "18.14.0",
-    "commit": "9abcdf86c2b0440f113c8b7f15bd38fb23f51117"
+    "version": "18.15.0",
+    "commit": "e21b61e79a1a509b81826fc8db2282c107b2e0ea"
   },
   "scripts": {
     "codegen": "node scripts/codegen.mjs",
@@ -29,8 +29,8 @@
   },
   "publishedSchemaSnapshot": {
     "url": "https://docs.crowdedkingdoms.com/schema/game-api.graphql",
-    "sourceBlob": "3e465b261b718cdafc6a23a7a4d40e83c95c8b9f",
+    "sourceBlob": "ad8c0dea9e2f3eea8185901274294514931500fc",
     "snapshotSha256": "d46a770eff50f8ef6584f5ed937e8347d6f7121da7337469b8d99213fc9a7281",
-    "syncedAt": "2026-10-20T04:26:56.289Z"
+    "syncedAt": "2026-10-20T07:30:56.926Z"
   }
 }

{crowdypy-0.14.2.dev1 → crowdypy-0.15.0.dev1}/vendor/CrowdyCPP/tools/parity/fixtures/crowdy-studio-diagnostics.v1.json

@@ -1,8 +1,8 @@
 {
   "contractVersion": "crowdy.studio-diagnostics/1",
   "crowdyJs": {
-    "version": "18.14.0",
-    "commit": "9abcdf86c2b0440f113c8b7f15bd38fb23f51117"
+    "version": "18.15.0",
+    "commit": "e21b61e79a1a509b81826fc8db2282c107b2e0ea"
   },
   "cases": [
     {

{crowdypy-0.14.2.dev1 → crowdypy-0.15.0.dev1}/vendor/CrowdyCPP/tools/parity/fixtures/crowdyjs-studio-layout.v1.json

@@ -1,8 +1,8 @@
 {
   "fixtureVersion": 1,
   "crowdyJs": {
-    "version": "18.14.0",
-    "commit": "9abcdf86c2b0440f113c8b7f15bd38fb23f51117"
+    "version": "18.15.0",
+    "commit": "e21b61e79a1a509b81826fc8db2282c107b2e0ea"
   },
   "storageKey": "ck:crowdy-studio:layout:v1",
   "paneIds": [