crowdypy 0.8.0.dev1__tar.gz → 0.9.1.dev1__tar.gz

{crowdypy-0.8.0.dev1 → crowdypy-0.9.1.dev1}/MIGRATION.md

@@ -3,6 +3,29 @@
 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.9.1
+
+A patch release with the same API as 0.9.0, the same CrowdyJS (18.8.0) and CrowdyCPP (0.61.0) pins.
+
+- **`client.input_log` sends a session filter's `userId` as a string**, the decimal string every
+  id is on the wire. An `int` used to go out as a JSON number.
+- **Its docstrings say when a read is retryable.** From the Game API release after v2.40.2,
+  `InputLogAPI.messages` answers `INPUT_LOG_TEMPORARILY_UNAVAILABLE` when the log cannot be read
+  right now and `INPUT_LOG_RATE_LIMITED` while another read of yours is running; both carry
+  `extensions.retryable`, so retry with the same cursor after a short back-off.
+
+## 0.9.0
+
+CrowdyJS 18.8.0 and CrowdyCPP 0.61.0. Additive, with one floor: the build documents select
+`ExecBuild.sdkVersion`, so `exec.build`, `build_status`, `wait_for_build`, `mod_build`,
+`mod_client_build`, `mod_build_status` and `wait_for_mod_build` need ck-api v2.40.2 (an older
+one refuses the selection).
+
+- **`ExecBuild.sdk_version`**: the version of `ckx-sdk` the platform compiled the build against
+  (`crowdy-client-sdk` for a CLIENT half), from the toolchain of the API instance that ran it. The
+  platform points a crate at its own copy of the SDK whatever version the crate names, so this,
+  not your manifest, says what your code was checked against. `None` until the build starts.
+
 ## 0.8.0
 
 CrowdyJS 18.7.0 and CrowdyCPP 0.60.0. Additive, with reads that change for values they used to

{crowdypy-0.8.0.dev1 → crowdypy-0.9.1.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crowdypy
-Version: 0.8.0.dev1
+Version: 0.9.1.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,9 @@ 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.9.1: the input log's session filter sends `userId` as a string, and its reads document when
+to retry.** See the 0.9.1 bullet below; 0.9.0 added the SDK a build compiled against.
+
 **v0.8.0: voice, channel audio, wide voxels, and pause and access refusals (CrowdyJS 18.7.0, CrowdyCPP 0.60.0).**
 - Voice: `crowdypy.media`'s voice helpers (an optional 10-byte header per codec frame,
   `VoicePacketizer`, `VoiceJitterBuffer`), and `client.udp.send_channel_audio()` with the
@@ -63,6 +66,9 @@ wheel. Python never touches a datagram.
   carry, and `app_paused_of`, `access_refusal_of` and `actor_exists_of` read the new refusals.
 - New calls: `users.player_profile(s)`, `app_access.suspend` and `unsuspend`, and
   `exec.restart_type`.
+- 0.9.0: every build (`exec.build`, `build_status`, `wait_for_build` and the mod builds) carries
+  `sdk_version`, the `ckx-sdk` (CLIENT half: `crowdy-client-sdk`) version the platform compiled it
+  against, whatever the crate names. It needs ck-api v2.40.2, since the build documents select it.
 - 0.8.0 needs the ck-api release after v2.39.0, since the token mutations select
   `runtimeGate`. Channel audio and the voxel echo need replication server v0.37.0.
 - 0.7.0 brought the input log (`client.input_log.sessions()` and `messages()`, and

{crowdypy-0.8.0.dev1 → crowdypy-0.9.1.dev1}/README.md

@@ -11,6 +11,9 @@ 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.9.1: the input log's session filter sends `userId` as a string, and its reads document when
+to retry.** See the 0.9.1 bullet below; 0.9.0 added the SDK a build compiled against.
+
 **v0.8.0: voice, channel audio, wide voxels, and pause and access refusals (CrowdyJS 18.7.0, CrowdyCPP 0.60.0).**
 - Voice: `crowdypy.media`'s voice helpers (an optional 10-byte header per codec frame,
   `VoicePacketizer`, `VoiceJitterBuffer`), and `client.udp.send_channel_audio()` with the
@@ -23,6 +26,9 @@ wheel. Python never touches a datagram.
   carry, and `app_paused_of`, `access_refusal_of` and `actor_exists_of` read the new refusals.
 - New calls: `users.player_profile(s)`, `app_access.suspend` and `unsuspend`, and
   `exec.restart_type`.
+- 0.9.0: every build (`exec.build`, `build_status`, `wait_for_build` and the mod builds) carries
+  `sdk_version`, the `ckx-sdk` (CLIENT half: `crowdy-client-sdk`) version the platform compiled it
+  against, whatever the crate names. It needs ck-api v2.40.2, since the build documents select it.
 - 0.8.0 needs the ck-api release after v2.39.0, since the token mutations select
   `runtimeGate`. Channel audio and the voxel echo need replication server v0.37.0.
 - 0.7.0 brought the input log (`client.input_log.sessions()` and `messages()`, and

{crowdypy-0.8.0.dev1 → crowdypy-0.9.1.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.8.0`
+- CrowdyPy `0.9.1`
 - 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
@@ -41,6 +41,10 @@ requirement names one exactly, the same way a caret never matches an npm prerele
 - `auth.record_player_consents` and `auth.player_legal_acceptance` need ck-api v2.35.0; an
   older API answers them with a GraphQL validation error. From v2.35.0 a gameplay token
   waits for both consents (`LEGAL_ACCEPTANCE_REQUIRED`).
+- The input log (`client.input_log`, 0.7.0) needs ck-api v2.39.0 or later: every app read selects
+  `replayLoggingEnabled`, which an older API refuses with a GraphQL validation error. The retryable
+  `INPUT_LOG_TEMPORARILY_UNAVAILABLE` / `INPUT_LOG_RATE_LIMITED` and the `logging_off` / `shutdown`
+  end reasons come with the ck-api release after v2.40.2.
 - `udp.send_ranged_channel_message` needs a replication server that serves message type 32
   (CHANNEL_MESSAGE_RANGED_REQUEST); one that does not delivers nothing.
 - 0.8.0 selects `runtimeGate` on every token mutation (`portal.mint_app_token`,

{crowdypy-0.8.0.dev1 → crowdypy-0.9.1.dev1}/docs/parity-matrix.md

@@ -4,8 +4,8 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 
 ## Target
 
-- CrowdyJS: `18.7.0` at `1ff76217bf396325f3c2774ca4d89644ab4ce352`
-- CrowdyCPP (native core): `0.60.0` at `995e34ffaab9ecf0ca6c17a59707cc0ed4a88086`
+- CrowdyJS: `18.8.0` at `d7b755abe73bd9e157673325cbfcfb3975f71cc3`
+- CrowdyCPP (native core): `0.61.0` at `72f4a154a8defde1f99d6dfd983cb6629c26d233`
 - schema.gql identical to CrowdyJS's: yes
 - Gate mode: strict portable parity (every portable gap is release-blocking)
 

{crowdypy-0.8.0.dev1 → crowdypy-0.9.1.dev1}/operations/exec/Exec.graphql

@@ -152,6 +152,7 @@ fragment ExecBuildFields on ExecBuild {
   status
   kind
   log
+  sdkVersion
   createdAt
   startedAt
   finishedAt

{crowdypy-0.8.0.dev1 → crowdypy-0.9.1.dev1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "scikit_build_core.build"
 
 [project]
 name = "crowdypy"
-version = "0.8.0.dev1"
+version = "0.9.1.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,20 +119,20 @@ environment = { OPENSSL_ROOT_DIR = "C:/vcpkg/installed/x64-windows-static-md" }
 # --------------------------------------------------------------------------------------
 
 [tool.crowdypy.crowdyjs]
-version = "18.7.0"
-commit = "1ff76217bf396325f3c2774ca4d89644ab4ce352"
+version = "18.8.0"
+commit = "d7b755abe73bd9e157673325cbfcfb3975f71cc3"
 
 [tool.crowdypy.crowdycpp]
-version = "0.60.0"
-tag = "dev/v0.60.0"
-commit = "995e34ffaab9ecf0ca6c17a59707cc0ed4a88086"
-tree-sha256 = "cee4e9d4db822b6f6ae06d5fd257ba354ee94d3100a345dd5048d37c14ea7cc9"
+version = "0.61.0"
+tag = "dev/v0.61.0"
+commit = "72f4a154a8defde1f99d6dfd983cb6629c26d233"
+tree-sha256 = "559bbbcc37455ae020abdf7e128cb84e05bead6e8f52b4f4a8e4293a6f1f0a18"
 
 # 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 = "d2e735887acea223a7ce95e009cb17a894a3954012b939ce05e5ccf5693dedcd"
-operations-sha256 = "15ab08f0f194e6355b3dcb28eb7d3a0a4ac9f064af457b054a60e4b403e6519e"
+schema-sha256 = "61f99f99fc80be9de388e7295faa247fe508cc0d2f7d2b832a2709ed76c464b2"
+operations-sha256 = "e9e0ad2ac5f585815d3f3b2b2f3b4443736f9ae602905fbe82b236b7cc4bfd66"
 
 # 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.

{crowdypy-0.8.0.dev1 → crowdypy-0.9.1.dev1}/schema.gql

@@ -5936,9 +5936,13 @@ type ExecBuild {
   """
   kind: String!
   """
-  The compiler’s output once the build finishes, at most 64 KB (the end is kept).
+  The compiler’s output once the build finishes, at most 64 KB (the end is kept). Its first line names the toolchain the build ran with.
   """
   log: String
+  """
+  The SDK version the build compiled against, from the toolchain of the API instance that ran it: `ckx-sdk` for a ck-exec build, `crowdy-client-sdk` for a CLIENT half. A crate’s own version requirement for the SDK is not what decides this. Null until the build starts, and for builds from before it was recorded.
+  """
+  sdkVersion: String
   """When the build was requested."""
   createdAt: DateTime!
   """When it started compiling."""

{crowdypy-0.8.0.dev1 → crowdypy-0.9.1.dev1}/scripts/ci/check_content_policy.py

@@ -41,7 +41,6 @@ DENYLIST = (
     "dev-run-buddy",
 )
 SKIP_DIRS = {
-    ".git": "object store; holds every historical revision by construction",
     ".venv": "the developer's virtualenv; third-party code",
     "build": "CMake build trees, regenerated per build",
     "node_modules": "third-party dependencies",
@@ -76,6 +75,11 @@ def tree() -> Iterator[tuple[str, bytes]]:
         current = stack.pop()
         for entry in sorted(current.iterdir()):
             rel = entry.relative_to(ROOT).as_posix()
+            if entry.name == ".git":
+                # A clone's object store, which holds every historical revision by
+                # construction, or a worktree's pointer file, which names the checkout's own
+                # path. Neither is ever packaged.
+                continue
             if entry.is_dir():
                 if entry.name not in SKIP_DIRS:
                     stack.append(entry)

{crowdypy-0.8.0.dev1 → crowdypy-0.9.1.dev1}/scripts/ci/check_pin_tiers.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Both pins name commits promoted to THIS branch's tier of their repositories.
+"""Both pins name published releases, promoted to THIS branch's tier of their repositories.
 
     python scripts/ci/check_pin_tiers.py --crowdyjs <checkout> --crowdycpp <checkout> --tier dev
     python scripts/ci/check_pin_tiers.py --crowdyjs <checkout> --crowdycpp <checkout> --from-ref
@@ -10,6 +10,11 @@ CrowdyPy's ``dev`` may pin only CrowdyJS and CrowdyCPP commits reachable from th
 branch head: a promotion merges forward, so one commit satisfies every tier once it has
 travelled the ladder, and pinning a head would make an unrelated landing turn this red.
 The checkouts need full history (``fetch-depth: 0``).
+
+And released: each pinned commit must be the target of a ``<tier>/v<version>`` tag of its
+repository for the pinned version (any tier's, for the same ladder reason). Reachability
+alone let 0.7.0 pin CrowdyJS ``ca9fbb5`` as 18.6.0 while ``dev/v18.6.0`` is ``7662d0b0``.
+That half needs no tier, so it runs on every ref.
 """
 
 from __future__ import annotations
@@ -43,6 +48,55 @@ def _from_ref() -> str | None:
     return _tier_of(branch) if branch and branch != "HEAD" else None
 
 
+def parse_tag_refs(text: str) -> dict[str, str]:
+    """``git ls-remote --tags`` output: tag name -> the commit it points at (an annotated tag's
+    peeled ``^{}`` line wins over the tag object's own sha)."""
+    out: dict[str, str] = {}
+    for line in text.splitlines():
+        parts = line.strip().split()
+        if len(parts) != 2 or len(parts[0]) != 40 or not parts[1].startswith("refs/tags/"):
+            continue
+        sha, ref = parts
+        name = ref.removeprefix("refs/tags/")
+        if name.endswith("^{}"):
+            out[name.removesuffix("^{}")] = sha
+        else:
+            out.setdefault(name, sha)
+    return out
+
+
+def tag_verdict(commit: str, version: str, tags: dict[str, str]) -> tuple[bool, str]:
+    """Whether ``commit`` is a published ``version``: the target of a ``<tier>/v<version>`` tag."""
+    named = [f"{tier}/v{version}" for tier in TIERS]
+    matching = [name for name in named if tags.get(name) == commit]
+    if matching:
+        return True, f"{commit[:12]} is {', '.join(matching)}"
+    elsewhere = [f"{name} is {tags[name][:12]}" for name in named if name in tags]
+    if elsewhere:
+        return False, f"{commit[:12]} is not a published {version}: {', '.join(elsewhere)}"
+    return False, f"{commit[:12]} is not a published {version}: no {' / '.join(named)} tag exists"
+
+
+def tagged(repo: Path, commit: str, version: str) -> tuple[bool, str]:
+    listed = subprocess.run(
+        [
+            "git",
+            "-C",
+            str(repo),
+            "ls-remote",
+            "--tags",
+            "origin",
+            *[f"refs/tags/{tier}/v{version}*" for tier in TIERS],
+        ],
+        capture_output=True,
+        text=True,
+        check=False,
+    )
+    if listed.returncode != 0:
+        return False, f"cannot list the tags of {repo}: {listed.stderr.strip()[:200]}"
+    return tag_verdict(commit, version, parse_tag_refs(listed.stdout))
+
+
 def reachable(repo: Path, commit: str, tier: str) -> tuple[bool, str]:
     fetched = subprocess.run(
         [
@@ -93,23 +147,38 @@ def main(argv: list[str] | None = None) -> int:
     group.add_argument("--from-ref", action="store_true")
     args = parser.parse_args(argv)
     tier = args.tier or _from_ref()
-    if tier is None:
-        print(
-            "check_pin_tiers: this ref carries no tier, so the comparison was SKIPPED (a PR into dev/test/prod is judged by that base)"
-        )
-        return 0
     pins = tomllib.loads((ROOT / "pyproject.toml").read_text(encoding="utf-8"))["tool"]["crowdypy"]
     failed = False
+    unreleased = False
     for name, repo, pin in (
         ("CrowdyJS", args.crowdyjs, pins["crowdyjs"]),
         ("CrowdyCPP", args.crowdycpp, pins["crowdycpp"]),
     ):
+        ok, detail = tagged(repo, pin["commit"], pin["version"])
+        unreleased |= not ok
+        print(
+            f"check_pin_tiers: {name} {pin['version']}: {detail}",
+            file=sys.stdout if ok else sys.stderr,
+        )
+        if tier is None:
+            continue
         ok, detail = reachable(repo, pin["commit"], tier)
         failed |= not ok
         print(
             f"check_pin_tiers: {name} {pin['version']}: {detail}",
             file=sys.stdout if ok else sys.stderr,
         )
+    if unreleased:
+        print(
+            "check_pin_tiers: pin the commit a release tag points at (CrowdyJS's, then CrowdyCPP's).",
+            file=sys.stderr,
+        )
+        return 1
+    if tier is None:
+        print(
+            "check_pin_tiers: this ref carries no tier, so the reachability comparison was SKIPPED (a PR into dev/test/prod is judged by that base)"
+        )
+        return 0
     if failed:
         print(
             f"check_pin_tiers: a CrowdyPy {tier} branch may pin only commits promoted to {tier}. "

{crowdypy-0.8.0.dev1 → crowdypy-0.9.1.dev1}/src/crowdypy/_generated/enums.py

@@ -1,6 +1,6 @@
 """GENERATED by scripts/codegen.py from schema.gql. Do not edit.
 
-schema.gql sha256: d2e735887acea223a7ce95e009cb17a894a3954012b939ce05e5ccf5693dedcd
+schema.gql sha256: 61f99f99fc80be9de388e7295faa247fe508cc0d2f7d2b832a2709ed76c464b2
 """
 
 from enum import StrEnum

{crowdypy-0.8.0.dev1 → crowdypy-0.9.1.dev1}/src/crowdypy/_generated/inputs.py

@@ -4,7 +4,7 @@ Every GraphQL input object as a msgspec Struct. Attributes are snake_case and en
 under their GraphQL names; an attribute left at UNSET is omitted from the request,
 which is how the API tells 'not provided' from an explicit null.
 
-schema.gql sha256: d2e735887acea223a7ce95e009cb17a894a3954012b939ce05e5ccf5693dedcd
+schema.gql sha256: 61f99f99fc80be9de388e7295faa247fe508cc0d2f7d2b832a2709ed76c464b2
 """
 
 from __future__ import annotations

{crowdypy-0.8.0.dev1 → crowdypy-0.9.1.dev1}/src/crowdypy/_generated/operations.py

@@ -1,7 +1,7 @@
 """GENERATED by scripts/codegen.py from schema.gql and operations/. Do not edit.
 
-schema.gql sha256: d2e735887acea223a7ce95e009cb17a894a3954012b939ce05e5ccf5693dedcd
-operations/ sha256: 15ab08f0f194e6355b3dcb28eb7d3a0a4ac9f064af457b054a60e4b403e6519e
+schema.gql sha256: 61f99f99fc80be9de388e7295faa247fe508cc0d2f7d2b832a2709ed76c464b2
+operations/ sha256: e9e0ad2ac5f585815d3f3b2b2f3b4443736f9ae602905fbe82b236b7cc4bfd66
 """
 
 from crowdypy._operation import Operation
@@ -692,7 +692,7 @@ EXEC_BUILD = Operation(
     name='ExecBuild',
     kind='mutation',
     root_fields=('execBuild',),
-    document='mutation ExecBuild($input: ExecBuildInput!) {\n  execBuild(input: $input) {\n    ...ExecBuildFields\n  }\n}\n\nfragment ExecBuildFields on ExecBuild {\n  buildId\n  status\n  kind\n  log\n  createdAt\n  startedAt\n  finishedAt\n  artifacts {\n    crate\n    digest\n    sizeBytes\n    capabilitySummaryJson\n    capabilityHash\n    tickIntervalMs\n  }\n}',
+    document='mutation ExecBuild($input: ExecBuildInput!) {\n  execBuild(input: $input) {\n    ...ExecBuildFields\n  }\n}\n\nfragment ExecBuildFields on ExecBuild {\n  buildId\n  status\n  kind\n  log\n  sdkVersion\n  createdAt\n  startedAt\n  finishedAt\n  artifacts {\n    crate\n    digest\n    sizeBytes\n    capabilitySummaryJson\n    capabilityHash\n    tickIntervalMs\n  }\n}',
 )
 
 # exec/Exec.graphql
@@ -700,7 +700,7 @@ EXEC_BUILD_STATUS = Operation(
     name='ExecBuildStatus',
     kind='query',
     root_fields=('execBuildStatus',),
-    document='query ExecBuildStatus($appId: BigInt!, $buildId: String!) {\n  execBuildStatus(appId: $appId, buildId: $buildId) {\n    ...ExecBuildFields\n  }\n}\n\nfragment ExecBuildFields on ExecBuild {\n  buildId\n  status\n  kind\n  log\n  createdAt\n  startedAt\n  finishedAt\n  artifacts {\n    crate\n    digest\n    sizeBytes\n    capabilitySummaryJson\n    capabilityHash\n    tickIntervalMs\n  }\n}',
+    document='query ExecBuildStatus($appId: BigInt!, $buildId: String!) {\n  execBuildStatus(appId: $appId, buildId: $buildId) {\n    ...ExecBuildFields\n  }\n}\n\nfragment ExecBuildFields on ExecBuild {\n  buildId\n  status\n  kind\n  log\n  sdkVersion\n  createdAt\n  startedAt\n  finishedAt\n  artifacts {\n    crate\n    digest\n    sizeBytes\n    capabilitySummaryJson\n    capabilityHash\n    tickIntervalMs\n  }\n}',
 )
 
 # exec/Exec.graphql
@@ -772,7 +772,7 @@ EXEC_MOD_BUILD = Operation(
     name='ExecModBuild',
     kind='mutation',
     root_fields=('execModBuild',),
-    document='mutation ExecModBuild($appId: BigInt!, $crate: ExecBuildCrateInput!) {\n  execModBuild(appId: $appId, crate: $crate) {\n    ...ExecBuildFields\n  }\n}\n\nfragment ExecBuildFields on ExecBuild {\n  buildId\n  status\n  kind\n  log\n  createdAt\n  startedAt\n  finishedAt\n  artifacts {\n    crate\n    digest\n    sizeBytes\n    capabilitySummaryJson\n    capabilityHash\n    tickIntervalMs\n  }\n}',
+    document='mutation ExecModBuild($appId: BigInt!, $crate: ExecBuildCrateInput!) {\n  execModBuild(appId: $appId, crate: $crate) {\n    ...ExecBuildFields\n  }\n}\n\nfragment ExecBuildFields on ExecBuild {\n  buildId\n  status\n  kind\n  log\n  sdkVersion\n  createdAt\n  startedAt\n  finishedAt\n  artifacts {\n    crate\n    digest\n    sizeBytes\n    capabilitySummaryJson\n    capabilityHash\n    tickIntervalMs\n  }\n}',
 )
 
 # exec/Exec.graphql
@@ -780,7 +780,7 @@ EXEC_MOD_BUILD_STATUS = Operation(
     name='ExecModBuildStatus',
     kind='query',
     root_fields=('execModBuildStatus',),
-    document='query ExecModBuildStatus($appId: BigInt!, $buildId: String!) {\n  execModBuildStatus(appId: $appId, buildId: $buildId) {\n    ...ExecBuildFields\n  }\n}\n\nfragment ExecBuildFields on ExecBuild {\n  buildId\n  status\n  kind\n  log\n  createdAt\n  startedAt\n  finishedAt\n  artifacts {\n    crate\n    digest\n    sizeBytes\n    capabilitySummaryJson\n    capabilityHash\n    tickIntervalMs\n  }\n}',
+    document='query ExecModBuildStatus($appId: BigInt!, $buildId: String!) {\n  execModBuildStatus(appId: $appId, buildId: $buildId) {\n    ...ExecBuildFields\n  }\n}\n\nfragment ExecBuildFields on ExecBuild {\n  buildId\n  status\n  kind\n  log\n  sdkVersion\n  createdAt\n  startedAt\n  finishedAt\n  artifacts {\n    crate\n    digest\n    sizeBytes\n    capabilitySummaryJson\n    capabilityHash\n    tickIntervalMs\n  }\n}',
 )
 
 # exec/Exec.graphql
@@ -796,7 +796,7 @@ EXEC_MOD_CLIENT_BUILD = Operation(
     name='ExecModClientBuild',
     kind='mutation',
     root_fields=('execModClientBuild',),
-    document='mutation ExecModClientBuild($appId: BigInt!, $crate: ExecBuildCrateInput!) {\n  execModClientBuild(appId: $appId, crate: $crate) {\n    ...ExecBuildFields\n  }\n}\n\nfragment ExecBuildFields on ExecBuild {\n  buildId\n  status\n  kind\n  log\n  createdAt\n  startedAt\n  finishedAt\n  artifacts {\n    crate\n    digest\n    sizeBytes\n    capabilitySummaryJson\n    capabilityHash\n    tickIntervalMs\n  }\n}',
+    document='mutation ExecModClientBuild($appId: BigInt!, $crate: ExecBuildCrateInput!) {\n  execModClientBuild(appId: $appId, crate: $crate) {\n    ...ExecBuildFields\n  }\n}\n\nfragment ExecBuildFields on ExecBuild {\n  buildId\n  status\n  kind\n  log\n  sdkVersion\n  createdAt\n  startedAt\n  finishedAt\n  artifacts {\n    crate\n    digest\n    sizeBytes\n    capabilitySummaryJson\n    capabilityHash\n    tickIntervalMs\n  }\n}',
 )
 
 # exec/Exec.graphql

crowdypy-0.9.1.dev1/src/crowdypy/_sync/domains/input_log.py

@@ -0,0 +1,113 @@
+# GENERATED by scripts/unasync.py from src/crowdypy/domains/input_log.py. Do not edit.
+"""The input log (``client.input_log``): recorded client inputs of an app with replay logging on.
+
+An app with replay logging on (``App.replayLoggingEnabled``, set with ``client.apps.update``)
+has every client input the realtime servers accept recorded. These calls read them back on
+the app-scoped client for the app; an identity session token is refused. A player reads only
+the sessions and inputs they sent; a holder of ``manage_apps`` on the app reads every session.
+Inputs are kept for the input log's published retention (up to about an hour longer), so an old
+session can still be listed after its inputs are gone. Both answer ``INPUT_LOG_UNAVAILABLE`` on a
+deployment without input logging. From the Game API release after v2.40.2,
+:meth:`InputLogAPI.messages` answers ``INPUT_LOG_TEMPORARILY_UNAVAILABLE`` when the log cannot be
+read right now and ``INPUT_LOG_RATE_LIMITED`` while another read of yours is running (one per user,
+two per app): both carry ``extensions.retryable``, so retry with the same cursor after a short
+back-off. Earlier Game APIs answer ``INPUT_LOG_UNAVAILABLE``, or an empty page, instead.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any
+
+import msgspec
+
+from crowdypy._generated import inputs
+from crowdypy._generated import operations as ops
+from crowdypy._sync.domains._base import Domain, omit_none
+from crowdypy.utils import bigint
+
+__all__ = ["InputLogAPI"]
+
+
+def _session_filter(
+    filter: inputs.InputLogSessionFilter | Mapping[str, Any] | None,
+) -> inputs.InputLogSessionFilter | Mapping[str, Any] | None:
+    """``userId`` as the decimal string every id is on the wire: an int went out as a JSON
+    number, safe at today's ids and unlike every other id the SDK sends."""
+    if isinstance(filter, inputs.InputLogSessionFilter):
+        # Typed str, so an int here is a caller past the type hints: exactly the case to mend.
+        user_id: Any = filter.user_id
+        if isinstance(user_id, int) and not isinstance(user_id, bool):
+            return msgspec.structs.replace(filter, user_id=bigint(user_id))
+        return filter
+    if isinstance(filter, Mapping) and isinstance(filter.get("userId"), int):
+        return {**filter, "userId": bigint(filter["userId"])}
+    return filter
+
+
+class InputLogAPI(Domain):
+    def sessions(
+        self,
+        app_id: str | int,
+        *,
+        first: int | None = None,
+        after: str | None = None,
+        filter: inputs.InputLogSessionFilter | Mapping[str, Any] | None = None,
+    ) -> dict[str, Any]:
+        """An app's recorded sessions, newest first: ``edges { cursor node }``, ``pageInfo``,
+        ``totalCount``. A session is one game token's inputs.
+
+        ``filter`` takes ``userId`` (another user's needs ``manage_apps``, else ``FORBIDDEN``;
+        an int is sent as its decimal string), ``from`` / ``to`` and ``messageType``. Page with
+        ``first`` (default 50, max 200) and the previous page's ``pageInfo.endCursor`` as
+        ``after``. A node's ``endReason`` is ``expired``, ``revoked``, ``reconnect`` or
+        ``released`` as the client saw it, ``logging_off`` or ``shutdown`` from the Game API
+        release after v2.40.2, ``unrecorded``, or null while the session may still run.
+        """
+        result: dict[str, Any] = self._request(
+            ops.INPUT_LOG_SESSIONS,
+            omit_none(
+                {
+                    "appId": bigint(app_id),
+                    "first": first,
+                    "after": after,
+                    "filter": _session_filter(filter),
+                }
+            ),
+        )
+        return result
+
+    def messages(
+        self,
+        app_id: str | int,
+        game_token_id: str | int,
+        *,
+        first: int | None = None,
+        after: str | None = None,
+        filter: inputs.InputLogMessageFilter | Mapping[str, Any] | None = None,
+    ) -> dict[str, Any]:
+        """One session's recorded inputs (``game_token_id`` from :meth:`sessions`), oldest first.
+
+        ``body`` is the client message in base64 (``decode_base64`` gives the bytes), from its
+        type byte up to its authentication tail, which is not recorded; ``sizeBytes`` is what
+        stored input logs are billed on. Spatial inputs carry their chunk and actor, channel
+        inputs their channel. **Keep paging while ``pageInfo.hasNextPage`` is true**, not while
+        ``endCursor`` is set: a page can be short, or empty, when it reached the server's time or
+        scan limit; keep the previous cursor if one comes back null. ``filter`` takes ``from`` /
+        ``to`` and ``messageTypes`` (at most 64). Another user's session answers ``NOT_FOUND``
+        without ``manage_apps``; a malformed cursor, or (from the Game API release after v2.40.2)
+        one from another session, ``BAD_USER_INPUT``.
+        """
+        result: dict[str, Any] = self._request(
+            ops.INPUT_LOG_MESSAGES,
+            omit_none(
+                {
+                    "appId": bigint(app_id),
+                    "gameTokenId": bigint(game_token_id),
+                    "first": first,
+                    "after": after,
+                    "filter": filter,
+                }
+            ),
+        )
+        return result

{crowdypy-0.8.0.dev1 → crowdypy-0.9.1.dev1}/src/crowdypy/_version.py

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

{crowdypy-0.8.0.dev1 → crowdypy-0.9.1.dev1}/src/crowdypy/domains/exec.py

@@ -337,13 +337,16 @@ class ExecBuild(msgspec.Struct, rename="camel", frozen=True, kw_only=True):
     """A build, its log and one module per crate.
 
     ``status`` is ``queued``, ``building``, ``succeeded`` or ``failed``; ``kind`` is ``exec``
-    for ck-exec modules and ``client`` for the CLIENT half of a mod.
+    for ck-exec modules and ``client`` for the CLIENT half of a mod. ``sdk_version`` is the
+    ``ckx-sdk`` version the platform compiled against (``crowdy-client-sdk``'s for a CLIENT
+    half), whatever version the crate names; ``None`` until the build starts (ck-api v2.40.2).
     """
 
     build_id: str
     status: str
     kind: str
     log: str | None = None
+    sdk_version: str | None = None
     created_at: str
     started_at: str | None = None
     finished_at: str | None = None

crowdypy-0.9.1.dev1/src/crowdypy/domains/input_log.py

@@ -0,0 +1,112 @@
+"""The input log (``client.input_log``): recorded client inputs of an app with replay logging on.
+
+An app with replay logging on (``App.replayLoggingEnabled``, set with ``client.apps.update``)
+has every client input the realtime servers accept recorded. These calls read them back on
+the app-scoped client for the app; an identity session token is refused. A player reads only
+the sessions and inputs they sent; a holder of ``manage_apps`` on the app reads every session.
+Inputs are kept for the input log's published retention (up to about an hour longer), so an old
+session can still be listed after its inputs are gone. Both answer ``INPUT_LOG_UNAVAILABLE`` on a
+deployment without input logging. From the Game API release after v2.40.2,
+:meth:`InputLogAPI.messages` answers ``INPUT_LOG_TEMPORARILY_UNAVAILABLE`` when the log cannot be
+read right now and ``INPUT_LOG_RATE_LIMITED`` while another read of yours is running (one per user,
+two per app): both carry ``extensions.retryable``, so retry with the same cursor after a short
+back-off. Earlier Game APIs answer ``INPUT_LOG_UNAVAILABLE``, or an empty page, instead.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any
+
+import msgspec
+
+from crowdypy._generated import inputs
+from crowdypy._generated import operations as ops
+from crowdypy.domains._base import Domain, omit_none
+from crowdypy.utils import bigint
+
+__all__ = ["InputLogAPI"]
+
+
+def _session_filter(
+    filter: inputs.InputLogSessionFilter | Mapping[str, Any] | None,
+) -> inputs.InputLogSessionFilter | Mapping[str, Any] | None:
+    """``userId`` as the decimal string every id is on the wire: an int went out as a JSON
+    number, safe at today's ids and unlike every other id the SDK sends."""
+    if isinstance(filter, inputs.InputLogSessionFilter):
+        # Typed str, so an int here is a caller past the type hints: exactly the case to mend.
+        user_id: Any = filter.user_id
+        if isinstance(user_id, int) and not isinstance(user_id, bool):
+            return msgspec.structs.replace(filter, user_id=bigint(user_id))
+        return filter
+    if isinstance(filter, Mapping) and isinstance(filter.get("userId"), int):
+        return {**filter, "userId": bigint(filter["userId"])}
+    return filter
+
+
+class InputLogAPI(Domain):
+    async def sessions(
+        self,
+        app_id: str | int,
+        *,
+        first: int | None = None,
+        after: str | None = None,
+        filter: inputs.InputLogSessionFilter | Mapping[str, Any] | None = None,
+    ) -> dict[str, Any]:
+        """An app's recorded sessions, newest first: ``edges { cursor node }``, ``pageInfo``,
+        ``totalCount``. A session is one game token's inputs.
+
+        ``filter`` takes ``userId`` (another user's needs ``manage_apps``, else ``FORBIDDEN``;
+        an int is sent as its decimal string), ``from`` / ``to`` and ``messageType``. Page with
+        ``first`` (default 50, max 200) and the previous page's ``pageInfo.endCursor`` as
+        ``after``. A node's ``endReason`` is ``expired``, ``revoked``, ``reconnect`` or
+        ``released`` as the client saw it, ``logging_off`` or ``shutdown`` from the Game API
+        release after v2.40.2, ``unrecorded``, or null while the session may still run.
+        """
+        result: dict[str, Any] = await self._request(
+            ops.INPUT_LOG_SESSIONS,
+            omit_none(
+                {
+                    "appId": bigint(app_id),
+                    "first": first,
+                    "after": after,
+                    "filter": _session_filter(filter),
+                }
+            ),
+        )
+        return result
+
+    async def messages(
+        self,
+        app_id: str | int,
+        game_token_id: str | int,
+        *,
+        first: int | None = None,
+        after: str | None = None,
+        filter: inputs.InputLogMessageFilter | Mapping[str, Any] | None = None,
+    ) -> dict[str, Any]:
+        """One session's recorded inputs (``game_token_id`` from :meth:`sessions`), oldest first.
+
+        ``body`` is the client message in base64 (``decode_base64`` gives the bytes), from its
+        type byte up to its authentication tail, which is not recorded; ``sizeBytes`` is what
+        stored input logs are billed on. Spatial inputs carry their chunk and actor, channel
+        inputs their channel. **Keep paging while ``pageInfo.hasNextPage`` is true**, not while
+        ``endCursor`` is set: a page can be short, or empty, when it reached the server's time or
+        scan limit; keep the previous cursor if one comes back null. ``filter`` takes ``from`` /
+        ``to`` and ``messageTypes`` (at most 64). Another user's session answers ``NOT_FOUND``
+        without ``manage_apps``; a malformed cursor, or (from the Game API release after v2.40.2)
+        one from another session, ``BAD_USER_INPUT``.
+        """
+        result: dict[str, Any] = await self._request(
+            ops.INPUT_LOG_MESSAGES,
+            omit_none(
+                {
+                    "appId": bigint(app_id),
+                    "gameTokenId": bigint(game_token_id),
+                    "first": first,
+                    "after": after,
+                    "filter": filter,
+                }
+            ),
+        )
+        return result

{crowdypy-0.8.0.dev1 → crowdypy-0.9.1.dev1}/src/crowdypy/player_host/schemas.v1.json

@@ -1,7 +1,7 @@
 {
   "crowdyJs": {
-    "version": "18.7.0",
-    "commit": "1ff76217bf396325f3c2774ca4d89644ab4ce352"
+    "version": "18.8.0",
+    "commit": "d7b755abe73bd9e157673325cbfcfb3975f71cc3"
   },
   "schemas": {
     "GAME_COMMAND_RESULT_SCHEMA_V1": {