geyser-sdk 0.1.0b4__tar.gz

geyser_sdk-0.1.0b4/.gitignore

@@ -0,0 +1,24 @@
+.venv/
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+dist/
+build/
+.geyser/
+.release-build/
+.release-python/
+release-standalone/
+release-assets/
+*.tar.gz
+*.whl
+*.sig
+*.crt
+*.pem
+*.key
+coverage.xml
+site/

geyser_sdk-0.1.0b4/PKG-INFO

@@ -0,0 +1,44 @@
+Metadata-Version: 2.5
+Name: geyser-sdk
+Version: 0.1.0b4
+Summary: Typed Python SDK and deterministic emulator for the public Geyser developer API
+Project-URL: Homepage, https://geyserlabs.ai/developers
+Project-URL: Documentation, https://docs.geyserlabs.ai
+Project-URL: Repository, https://github.com/geyserlabs/geyser-open
+Project-URL: Issues, https://github.com/geyserlabs/geyser-open/issues
+Project-URL: Security, https://github.com/geyserlabs/geyser-open/security/policy
+Author-email: Geyser Labs <security@geyserlabs.ai>
+License-Expression: MIT
+Keywords: agents,durable,emulator,geyser,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: httpx<1,>=0.28
+Requires-Dist: jsonschema<5,>=4.23
+Requires-Dist: pydantic<3,>=2.10
+Provides-Extra: test
+Requires-Dist: pytest-asyncio<2,>=0.24; extra == 'test'
+Requires-Dist: pytest<10,>=8; extra == 'test'
+Requires-Dist: respx<1,>=0.22; extra == 'test'
+Description-Content-Type: text/markdown
+
+# geyser-sdk
+
+Typed sync/async clients and a deterministic, credential-free local emulator
+for Geyser's public `/api/v1` developer contract.
+
+```python
+from geyser_sdk import GeyserClient
+
+with GeyserClient("https://api.geyserlabs.ai", access_token="...") as geyser:
+    for run in geyser.runs.iter():
+        print(run.id, run.state)
+```
+
+Tokens are always explicit. The package never reads an ambient Agent key,
+provider credential, or browser session.

geyser_sdk-0.1.0b4/README.md

@@ -0,0 +1,15 @@
+# geyser-sdk
+
+Typed sync/async clients and a deterministic, credential-free local emulator
+for Geyser's public `/api/v1` developer contract.
+
+```python
+from geyser_sdk import GeyserClient
+
+with GeyserClient("https://api.geyserlabs.ai", access_token="...") as geyser:
+    for run in geyser.runs.iter():
+        print(run.id, run.state)
+```
+
+Tokens are always explicit. The package never reads an ambient Agent key,
+provider credential, or browser session.

geyser_sdk-0.1.0b4/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["hatchling>=1.27,<2"]
+build-backend = "hatchling.build"
+
+[project]
+name = "geyser-sdk"
+version = "0.1.0b4"
+description = "Typed Python SDK and deterministic emulator for the public Geyser developer API"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.11"
+authors = [{ name = "Geyser Labs", email = "security@geyserlabs.ai" }]
+keywords = ["agents", "durable", "sdk", "emulator", "geyser"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Typing :: Typed",
+]
+dependencies = [
+  "httpx>=0.28,<1",
+  "jsonschema>=4.23,<5",
+  "pydantic>=2.10,<3",
+]
+
+[project.optional-dependencies]
+test = [
+  "pytest>=8,<10",
+  "pytest-asyncio>=0.24,<2",
+  "respx>=0.22,<1",
+]
+
+[project.urls]
+Homepage = "https://geyserlabs.ai/developers"
+Documentation = "https://docs.geyserlabs.ai"
+Repository = "https://github.com/geyserlabs/geyser-open"
+Issues = "https://github.com/geyserlabs/geyser-open/issues"
+Security = "https://github.com/geyserlabs/geyser-open/security/policy"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/geyser_sdk"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/geyser_sdk", "tests", "README.md", "pyproject.toml"]

geyser_sdk-0.1.0b4/src/geyser_sdk/__init__.py

@@ -0,0 +1,49 @@
+"""Public, framework-neutral Geyser SDK."""
+
+from ._json import bytes_digest, canonical_bytes, digest
+from .client import AsyncGeyserClient, GeyserClient, TokenProvider
+from .emulator import EmulatorError, LocalEmulator
+from .errors import (
+    GeyserError,
+    Problem,
+    ProblemError,
+    ResponseValidationError,
+    TransportError,
+)
+from .models import *  # noqa: F403 - typed contract is the intentional public surface
+from .structured_outcomes import (
+    OutcomeContractError,
+    OutcomeValidationError,
+    checkpoint_value,
+    evidence_refs,
+    normalize_contract,
+    parse_candidate,
+    pydantic_output_type,
+    validate_outcome,
+)
+
+__version__ = "0.1.0b4"
+
+__all__ = [
+    "AsyncGeyserClient",
+    "EmulatorError",
+    "GeyserClient",
+    "GeyserError",
+    "LocalEmulator",
+    "OutcomeContractError",
+    "OutcomeValidationError",
+    "Problem",
+    "ProblemError",
+    "ResponseValidationError",
+    "TokenProvider",
+    "TransportError",
+    "bytes_digest",
+    "canonical_bytes",
+    "checkpoint_value",
+    "digest",
+    "evidence_refs",
+    "normalize_contract",
+    "parse_candidate",
+    "pydantic_output_type",
+    "validate_outcome",
+]

geyser_sdk-0.1.0b4/src/geyser_sdk/_json.py

@@ -0,0 +1,26 @@
+from __future__ import annotations
+
+import hashlib
+import json
+from typing import Any
+
+
+def canonical_bytes(value: Any) -> bytes:
+    try:
+        return json.dumps(
+            value,
+            sort_keys=True,
+            separators=(",", ":"),
+            ensure_ascii=False,
+            allow_nan=False,
+        ).encode("utf-8")
+    except (TypeError, ValueError) as exc:
+        raise ValueError("value must be finite JSON") from exc
+
+
+def digest(value: Any) -> str:
+    return "sha256:" + hashlib.sha256(canonical_bytes(value)).hexdigest()
+
+
+def bytes_digest(value: bytes) -> str:
+    return "sha256:" + hashlib.sha256(value).hexdigest()