crowdypy 0.6.0.dev1__tar.gz → 0.7.0.dev1__tar.gz

{crowdypy-0.6.0.dev1 → crowdypy-0.7.0.dev1}/MIGRATION.md

@@ -3,6 +3,27 @@
 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.7.0
+
+CrowdyJS 18.6.0 and CrowdyCPP 0.59.0. Additive.
+
+- **The input log.** An app with replay logging on has every client input the realtime
+  servers accept recorded. `client.input_log.sessions(app_id, *, first=, after=, filter=)`
+  lists the app's recorded sessions, newest first (`edges`, `pageInfo`, `totalCount`; a
+  session is one game token's inputs), and `client.input_log.messages(app_id, game_token_id,
+  *, first=, after=, filter=)` reads one session's inputs, oldest first. `body` is the client
+  message in base64 without its authentication tail (`decode_base64` gives the bytes), and
+  `sizeBytes` is what stored input logs are billed on. Keep paging while
+  `pageInfo.hasNextPage` is true: a page can be short, or empty, when it reached the server's
+  time or scan limit. Both are game plane (the app-scoped client). A player reads their own
+  sessions, and a holder of `manage_apps` reads every one; without it, listing another
+  user's sessions is `FORBIDDEN` and reading another user's session is `NOT_FOUND`. Both
+  answer `INPUT_LOG_UNAVAILABLE` on a deployment without input logging, and `messages` also
+  answers it, retryable with the same cursor, when the log cannot be read right now.
+- **`replayLoggingEnabled`** is selected on every app read. Turning it on with
+  `client.apps.update` is refused with `INPUT_LOG_FUNDS_NEEDED` unless the org's wallet has a
+  spendable balance or the org is exempt from billing.
+
 ## 0.6.0
 
 CrowdyJS 18.5.0 and CrowdyCPP 0.58.0. Additive.

{crowdypy-0.6.0.dev1 → crowdypy-0.7.0.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crowdypy
-Version: 0.6.0.dev1
+Version: 0.7.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,12 @@ 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.7.0: the input log (CrowdyJS 18.6.0, CrowdyCPP 0.59.0).**
+- `client.input_log.sessions(app_id)` and `messages(app_id, game_token_id)` read the client
+  inputs recorded for an app with replay logging on (`replayLoggingEnabled`, now on every app
+  read and set with `client.apps.update`). A player reads their own; `manage_apps` reads every
+  session. Keep paging while `pageInfo.hasNextPage` is true: a messages page can be short.
+
 **v0.6.0: distance-limited channel messages and the terms gate (CrowdyJS 18.5.0, CrowdyCPP 0.58.0).**
 - `client.udp.send_ranged_channel_message(..., chunk=, max_distance=)` publishes to a channel
   but reaches only the members whose own actor is within `max_distance` chunks of `chunk`,

{crowdypy-0.6.0.dev1 → crowdypy-0.7.0.dev1}/README.md

@@ -11,6 +11,12 @@ 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.7.0: the input log (CrowdyJS 18.6.0, CrowdyCPP 0.59.0).**
+- `client.input_log.sessions(app_id)` and `messages(app_id, game_token_id)` read the client
+  inputs recorded for an app with replay logging on (`replayLoggingEnabled`, now on every app
+  read and set with `client.apps.update`). A player reads their own; `manage_apps` reads every
+  session. Keep paging while `pageInfo.hasNextPage` is true: a messages page can be short.
+
 **v0.6.0: distance-limited channel messages and the terms gate (CrowdyJS 18.5.0, CrowdyCPP 0.58.0).**
 - `client.udp.send_ranged_channel_message(..., chunk=, max_distance=)` publishes to a channel
   but reaches only the members whose own actor is within `max_distance` chunks of `chunk`,

{crowdypy-0.6.0.dev1 → crowdypy-0.7.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.6.0`
+- CrowdyPy `0.7.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.6.0.dev1 → crowdypy-0.7.0.dev1}/docs/e2e-coverage.md

@@ -18,6 +18,7 @@ Unconfigured, every suite skips, so `pytest` in CI records skips, not live passe
 | `CROWDY_E2E_STUDIO_GRID_ID` | no | a grid in the app that the owner controls (Studio suite) |
 | `CROWDY_E2E_SLOW=1` | no | long-running suites |
 | `CROWDY_E2E_THROWAWAY_OWNER=1` | no | the open-grid suite registers a throwaway owner, org and app (archived afterwards) |
+| `CROWDY_E2E_PROVISIONING_TOKEN` | dev and test | dev and test are staff-only, so a new derived player is refused (`TIER_ACCESS_REQUIRED`) unless `register` carries a provisioning token covering its address. Use the `harness` token (Secrets Manager `infra-cp/<tier>/loadtest/provisioning-token-harness`, `token` key) with `CROWDY_E2E_EMAIL=crowdy-e2e@test.invalid`. Sent on `register` only; other tiers ignore it |
 
 ```bash
 pytest tests/e2e -q
@@ -54,6 +55,7 @@ player once and signs it in for the later suites.
 | 2026-10-01 | dev tier, app `96701660793088` | `crowdypy 0.4.1.dev1` from PyPI (`pip install crowdypy` in a clean Python 3.12; the first version published by trusted publishing) | 8 passed; Studio skipped |
 | 2026-10-01 | dev tier, app `96701660793088`; the open-grid suite in its own throwaway org and app (`CROWDY_E2E_THROWAWAY_OWNER=1`) | `crowdypy 0.5.0.dev1` from PyPI (`pip install crowdypy` in a clean Python 3.12) | 10 passed; Studio skipped |
 | 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 |
 
 ## Not covered here
 

{crowdypy-0.6.0.dev1 → crowdypy-0.7.0.dev1}/docs/parity-matrix.md

@@ -4,17 +4,17 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 
 ## Target
 
-- CrowdyJS: `18.5.0` at `ae249cbe5661c5d14394994f66083d2731fab7e0`
-- CrowdyCPP (native core): `0.58.0` at `cae2f4af8a7af79cec12b612213b738c41969b1d`
+- CrowdyJS: `18.6.0` at `ca9fbb549ed5fa614e0084d962020410061b9c8c`
+- CrowdyCPP (native core): `0.59.0` at `3f2787d412c9eee9a5f2ce8fad06bdc8941cb8a1`
 - schema.gql identical to CrowdyJS's: yes
 - Gate mode: strict portable parity (every portable gap is release-blocking)
 
 ## Summary
 
-- Covered: 1019
+- Covered: 1024
 - Portable gap: 0
 - Native equivalent: 40
-- Browser exclusion: 95
+- Browser exclusion: 110
 - Deprecated roots: 2
 - Unclassified: 0
 
@@ -26,6 +26,7 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `mutation.actorHeartbeat` | covered |
 | `mutation.addChannelMember` | covered |
 | `mutation.addTeamMember` | covered |
+| `mutation.addTierAccessRule` | browser exclusion — super-admin or operator only; the SDK wraps nothing for platform roles (tooling calls it directly) |
 | `mutation.admitAppCode` | covered |
 | `mutation.archiveAccessTier` | covered |
 | `mutation.archiveApp` | covered |
@@ -64,6 +65,7 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `mutation.createPortalAuthorizationCode` | covered |
 | `mutation.createTeam` | covered |
 | `mutation.createTeamRole` | covered |
+| `mutation.createTierAccessProvisioningToken` | browser exclusion — super-admin or operator only; the SDK wraps nothing for platform roles (tooling calls it directly) |
 | `mutation.creditOrgWallet` | browser exclusion — super-admin or operator only; the SDK wraps nothing for platform roles (tooling calls it directly) |
 | `mutation.crowdyStudioCommonPublish` | covered |
 | `mutation.crowdyStudioGitHubBind` | covered |
@@ -94,6 +96,7 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `mutation.deleteTeamRole` | covered |
 | `mutation.deleteUserAppState` | covered |
 | `mutation.disconnectUdpProxy` | native equivalent — client.udp sends and receives this over CrowdyCPP's native UDP connection; the GraphQL UDP proxy exists because a page cannot open a UDP socket |
+| `mutation.endTierAccessSessions` | browser exclusion — super-admin or operator only; the SDK wraps nothing for platform roles (tooling calls it directly) |
 | `mutation.exchangePortalCode` | covered |
 | `mutation.execActivateVersion` | covered |
 | `mutation.execBuild` | covered |
@@ -124,6 +127,7 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `mutation.grantAppAccess` | covered |
 | `mutation.grantGridPermissions` | covered |
 | `mutation.grantMyAppAccess` | covered |
+| `mutation.grantTierAccessByPattern` | browser exclusion — super-admin or operator only; the SDK wraps nothing for platform roles (tooling calls it directly) |
 | `mutation.inviteOrgMember` | covered |
 | `mutation.issueGridClaimInvite` | covered |
 | `mutation.joinChannel` | covered |
@@ -159,6 +163,8 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `mutation.revokeGridPermissions` | covered |
 | `mutation.revokeGroupFromGrid` | covered |
 | `mutation.revokeOrgToken` | covered |
+| `mutation.revokeTierAccessProvisioningToken` | browser exclusion — super-admin or operator only; the SDK wraps nothing for platform roles (tooling calls it directly) |
+| `mutation.revokeTierAccessRule` | browser exclusion — super-admin or operator only; the SDK wraps nothing for platform roles (tooling calls it directly) |
 | `mutation.rollbackVoxelUpdates` | covered |
 | `mutation.runSharedUsageBillingTick` | browser exclusion — operator-only billing control; not a game-client surface |
 | `mutation.sendActorUpdate` | native equivalent — client.udp sends and receives this over CrowdyCPP's native UDP connection; the GraphQL UDP proxy exists because a page cannot open a UDP socket |
@@ -201,6 +207,8 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `mutation.setSuperAdmin` | browser exclusion — super-admin or operator only; the SDK wraps nothing for platform roles (tooling calls it directly) |
 | `mutation.setTeamMemberRoles` | covered |
 | `mutation.setTeamPolicy` | covered |
+| `mutation.setTierAccessMode` | browser exclusion — super-admin or operator only; the SDK wraps nothing for platform roles (tooling calls it directly) |
+| `mutation.setUserTierAccess` | browser exclusion — super-admin or operator only; the SDK wraps nothing for platform roles (tooling calls it directly) |
 | `mutation.setupSharedPaymentMethod` | covered |
 | `mutation.socialLoginComplete` | covered |
 | `mutation.socialLoginStart` | covered |
@@ -342,6 +350,8 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `query.hostedGame` | browser exclusion — catalog of browser games hosted on Crowdy Games; a Python client is not one of them |
 | `query.hostedGamePublishes` | browser exclusion — catalog of browser games hosted on Crowdy Games; a Python client is not one of them |
 | `query.hostedGames` | browser exclusion — catalog of browser games hosted on Crowdy Games; a Python client is not one of them |
+| `query.inputLogMessages` | covered |
+| `query.inputLogSessions` | covered |
 | `query.listVoxelUpdatesByDistance` | covered |
 | `query.listVoxels` | covered |
 | `query.me` | covered |
@@ -360,6 +370,7 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `query.myOrganizations` | covered |
 | `query.myPropertyTokens` | deprecated |
 | `query.myTeams` | covered |
+| `query.myTierAccess` | browser exclusion — the dev/test staff-only gate as sign-in pages show it; CrowdyJS wraps neither |
 | `query.nearbyGridPermissions` | covered |
 | `query.nearbyGrids` | covered |
 | `query.orgAutoBilling` | covered |
@@ -398,11 +409,17 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `query.teamPolicy` | covered |
 | `query.teamRoles` | covered |
 | `query.teams` | covered |
+| `query.tierAccessInventory` | browser exclusion — super-admin or operator only; the SDK wraps nothing for platform roles (tooling calls it directly) |
+| `query.tierAccessPolicy` | browser exclusion — the dev/test staff-only gate as sign-in pages show it; CrowdyJS wraps neither |
+| `query.tierAccessProvisioningTokens` | browser exclusion — super-admin or operator only; the SDK wraps nothing for platform roles (tooling calls it directly) |
+| `query.tierAccessRules` | browser exclusion — super-admin or operator only; the SDK wraps nothing for platform roles (tooling calls it directly) |
+| `query.tierAccessSettings` | browser exclusion — super-admin or operator only; the SDK wraps nothing for platform roles (tooling calls it directly) |
 | `query.udpProxyConnectionStatus` | native equivalent — client.udp sends and receives this over CrowdyCPP's native UDP connection; the GraphQL UDP proxy exists because a page cannot open a UDP socket |
 | `query.user` | covered |
 | `query.userAppState` | covered |
 | `query.userAppStates` | covered |
 | `query.userAvatars` | covered |
+| `query.userTierAccess` | browser exclusion — super-admin or operator only; the SDK wraps nothing for platform roles (tooling calls it directly) |
 | `query.usersConnection` | browser exclusion — super-admin or operator only; the SDK wraps nothing for platform roles (tooling calls it directly) |
 | `query.usersPaginated` | browser exclusion — super-admin or operator only; the SDK wraps nothing for platform roles (tooling calls it directly) |
 | `query.versionInfo` | covered |
@@ -452,6 +469,7 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `HostAPI -> HostAPI` | covered |
 | `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 |
 | `LocalActorStore -> LocalActorStore` | covered |
 | `MarketplaceAPI -> MarketplaceAPI` | covered |
 | `OrganizationsAPI -> OrganizationsAPI` | covered |
@@ -816,6 +834,8 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `HostTracker.hostUserId` | covered |
 | `HostTracker.isHost` | covered |
 | `HostTracker.onHostChanged` | covered |
+| `InputLogAPI.messages` | covered |
+| `InputLogAPI.sessions` | covered |
 | `LocalActorStore.chunk` | covered |
 | `LocalActorStore.join` | covered |
 | `LocalActorStore.lastAck` | covered |

{crowdypy-0.6.0.dev1 → crowdypy-0.7.0.dev1}/operations/apps/App.graphql

@@ -9,6 +9,7 @@ query App($appId: BigInt!) {
     status
     metadata
     wildernessWritesOpen
+    replayLoggingEnabled
     splitMode
     deploymentTarget
     reservedUdpBytesPerSec

{crowdypy-0.6.0.dev1 → crowdypy-0.7.0.dev1}/operations/apps/AppBySlug.graphql

@@ -9,6 +9,7 @@ query AppBySlug($orgSlug: String!, $appSlug: String!) {
     status
     metadata
     wildernessWritesOpen
+    replayLoggingEnabled
     splitMode
     gameApiUrl
     createdAt

{crowdypy-0.6.0.dev1 → crowdypy-0.7.0.dev1}/operations/apps/AppsForOrg.graphql

@@ -9,6 +9,7 @@ query AppsForOrg($orgSlug: String!) {
     status
     metadata
     wildernessWritesOpen
+    replayLoggingEnabled
     splitMode
     gameApiUrl
     createdAt

{crowdypy-0.6.0.dev1 → crowdypy-0.7.0.dev1}/operations/apps/CreateApp.graphql

@@ -9,6 +9,7 @@ mutation CreateApp($input: CreateAppInput!) {
     status
     metadata
     wildernessWritesOpen
+    replayLoggingEnabled
     createdAt
   }
 }

{crowdypy-0.6.0.dev1 → crowdypy-0.7.0.dev1}/operations/apps/MyApps.graphql

@@ -9,6 +9,7 @@ query MyApps {
     status
     metadata
     wildernessWritesOpen
+    replayLoggingEnabled
     splitMode
     gameApiUrl
     createdAt

{crowdypy-0.6.0.dev1 → crowdypy-0.7.0.dev1}/operations/apps/UpdateApp.graphql

@@ -9,6 +9,7 @@ mutation UpdateApp($appId: BigInt!, $input: UpdateAppInput!) {
     status
     metadata
     wildernessWritesOpen
+    replayLoggingEnabled
     updatedAt
   }
 }

crowdypy-0.7.0.dev1/operations/inputLog/InputLogMessages.graphql

@@ -0,0 +1,43 @@
+query InputLogMessages(
+  $appId: BigInt!
+  $gameTokenId: BigInt!
+  $first: Int
+  $after: String
+  $filter: InputLogMessageFilter
+) {
+  inputLogMessages(
+    appId: $appId
+    gameTokenId: $gameTokenId
+    first: $first
+    after: $after
+    filter: $filter
+  ) {
+    edges {
+      cursor
+      node {
+        receivedAt
+        receivedAtMicros
+        userId
+        gameTokenId
+        messageType
+        seq
+        fromBundle
+        signed
+        sizeBytes
+        body
+        chunkX
+        chunkY
+        chunkZ
+        actorUuid
+        channelId
+      }
+    }
+    pageInfo {
+      hasNextPage
+      hasPreviousPage
+      startCursor
+      endCursor
+    }
+    totalCount
+  }
+}

crowdypy-0.7.0.dev1/operations/inputLog/InputLogSessions.graphql

@@ -0,0 +1,32 @@
+query InputLogSessions(
+  $appId: BigInt!
+  $first: Int
+  $after: String
+  $filter: InputLogSessionFilter
+) {
+  inputLogSessions(appId: $appId, first: $first, after: $after, filter: $filter) {
+    edges {
+      cursor
+      node {
+        appId
+        gameTokenId
+        userId
+        datacenter
+        startedAt
+        lastSeenAt
+        endedAt
+        endReason
+        messageCount
+        byteCount
+        messageTypes
+      }
+    }
+    pageInfo {
+      hasNextPage
+      hasPreviousPage
+      startCursor
+      endCursor
+    }
+    totalCount
+  }
+}

{crowdypy-0.6.0.dev1 → crowdypy-0.7.0.dev1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "scikit_build_core.build"
 
 [project]
 name = "crowdypy"
-version = "0.6.0.dev1"
+version = "0.7.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"
@@ -117,20 +117,20 @@ environment = { OPENSSL_ROOT_DIR = "C:/vcpkg/installed/x64-windows-static-md" }
 # --------------------------------------------------------------------------------------
 
 [tool.crowdypy.crowdyjs]
-version = "18.5.0"
-commit = "ae249cbe5661c5d14394994f66083d2731fab7e0"
+version = "18.6.0"
+commit = "ca9fbb549ed5fa614e0084d962020410061b9c8c"
 
 [tool.crowdypy.crowdycpp]
-version = "0.58.0"
-tag = "dev/v0.58.0"
-commit = "cae2f4af8a7af79cec12b612213b738c41969b1d"
-tree-sha256 = "18db491aa66a14e209437b296d1bdd002746ebb811c5f39309a93b7bbb9d98d2"
+version = "0.59.0"
+tag = "dev/v0.59.0"
+commit = "3f2787d412c9eee9a5f2ce8fad06bdc8941cb8a1"
+tree-sha256 = "84c3f10e6747535b0483490a1cecf2ab9242a1f726ae265770cad86d1b1ebd64"
 
 # 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.
 [tool.crowdypy.graphql]
-schema-sha256 = "29d59267d8bf5a0497b272ac22b5edfb702c4872087b0cffaa1542a81c917834"
-operations-sha256 = "d5e0c505589ea26ecc3398b12f02ad7bd786457f7010ad87dcb8af2ea9366c77"
+schema-sha256 = "37865a07e4cde0703fa5c165b25ed309272f02ab96aed8d46439a2afc044f95b"
+operations-sha256 = "3ec8d65ebc668fa33baca555797a837b78de3e0a1eef1ff3b77b7a5db098d424"
 
 # The SDL the docs site publishes. scripts/schema_drift.py compares the snapshot against it
 # on a schedule; nothing on the per-commit path reads the network.